http-response-kit 1.0.0 → 2.0.0

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/catalog.ts"],"names":[],"mappings":";;;;AAkCO,SAAS,mBACZ,OAAA,EACkC;AAClC,EAAA,MAAM,YAAY,EAAC;AAEnB,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAqB;AACtD,IAAA,MAAM,KAAA,GAAQ,QAAQ,GAAG,CAAA;AACzB,IAAA,SAAA,CAAU,GAAG,CAAA,GAAI,CAAC,OAAA,EAAkB,OAAA,GAA+C,EAAC,KAChF,IAAI,SAAA,CAAU,KAAA,CAAM,MAAA,EAAQ;AAAA,MACxB,GAAG,OAAA;AAAA,MACH,OAAA,EAAS,OAAA,IAAW,KAAA,CAAM,OAAA,IAAW,OAAA,CAAQ,OAAA;AAAA,MAC7C,SAAA,EAAW,OAAO,GAAG,CAAA;AAAA,MACrB,MAAA,EAAQ,OAAA,CAAQ,MAAA,IAAU,KAAA,CAAM,MAAA;AAAA,MAChC,QAAA,EAAU,OAAA,CAAQ,QAAA,IAAY,KAAA,CAAM;AAAA,KACvC,CAAA;AAAA,EACT;AAEA,EAAA,OAAO,SAAA;AACX","file":"index.mjs","sourcesContent":["/**\n * HTTP Response Kit - Domain Error Catalog\n *\n * Enterprises need stable, machine-readable application error codes\n * (e.g. \"USER_NOT_FOUND\", \"PLAN_LIMIT_REACHED\") that are independent from\n * HTTP status codes. A catalog turns a declarative map into typed factories.\n *\n * @module errors/catalog\n */\n\nimport type { CatalogEntry, HttpErrorOptions } from '../types';\nimport { HttpError } from './HttpError';\n\n/** A factory produced by {@link createErrorCatalog} */\nexport type CatalogFactory = (message?: string, options?: Omit<HttpErrorOptions, 'errorCode'>) => HttpError;\n\n/**\n * Create a typed catalog of domain errors.\n *\n * Each key becomes the stable `errorCode` (serialized as `error.code` in\n * responses and as the `code` extension in Problem Details).\n *\n * @example\n * ```ts\n * export const Errors = createErrorCatalog({\n *   USER_NOT_FOUND: { status: 404, message: 'User does not exist' },\n *   PLAN_LIMIT_REACHED: { status: 402, message: 'Upgrade your plan' },\n *   PAYMENT_GATEWAY_DOWN: { status: 502, expose: false },\n * });\n *\n * throw Errors.USER_NOT_FOUND();                    // default message\n * throw Errors.USER_NOT_FOUND('No user with id 42'); // override message\n * ```\n */\nexport function createErrorCatalog<T extends Record<string, CatalogEntry>>(\n    catalog: T\n): { [K in keyof T]: CatalogFactory } {\n    const factories = {} as { [K in keyof T]: CatalogFactory };\n\n    for (const key of Object.keys(catalog) as Array<keyof T>) {\n        const entry = catalog[key];\n        factories[key] = (message?: string, options: Omit<HttpErrorOptions, 'errorCode'> = {}) =>\n            new HttpError(entry.status, {\n                ...options,\n                message: message ?? entry.message ?? options.message,\n                errorCode: String(key),\n                expose: options.expose ?? entry.expose,\n                metadata: options.metadata ?? entry.metadata,\n            });\n    }\n\n    return factories;\n}\n"]}