@sentzunhat/zacatl 0.0.13 → 0.0.20

package/build/configuration/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"./src/","sources":["configuration/legacy.ts"],"names":[],"mappings":"AAOA,KAAK,WAAW,GAAG;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,MAAM,MAAM,WAAW,KAAG,CAE7D,CAAC"}

package/build/configuration/legacy.js

@@ -0,0 +1,5 @@
+import config from "config";
+export const getConfigOrThrow = (name) => {
+    return config.get(name);
+};
+//# sourceMappingURL=legacy.js.map

package/build/configuration/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"./src/","sources":["configuration/legacy.ts"],"names":[],"mappings":"AAKA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAgB5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAI,IAAuB,EAAK,EAAE;IAChE,OAAO,MAAM,CAAC,GAAG,CAAI,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC","sourcesContent":["/**\n * Legacy configuration wrapper for node-config\n * @deprecated Use loadConfig() with explicit file paths instead\n */\n\nimport config from \"config\";\n\ntype ConfigInput = {\n  SERVICE_NAME: string;\n  NODE_ENV: string;\n  APP_VERSION: string;\n  APP_ENV: string;\n  CONNECTION_STRING: string;\n};\n\n/**\n * Get configuration value from node-config\n * @deprecated Use loadConfig() or loadConfigFromPaths() instead\n * @param name - Configuration key\n * @returns Configuration value\n */\nexport const getConfigOrThrow = <T>(name: keyof ConfigInput): T => {\n  return config.get<T>(name);\n};\n"]}

package/build/configuration/loader-factory.d.ts

@@ -0,0 +1,2 @@
+export { getLoader, loadConfig, loadConfigFromPaths } from "./loader";
+//# sourceMappingURL=loader-factory.d.ts.map

package/build/configuration/loader-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-factory.d.ts","sourceRoot":"./src/","sources":["configuration/loader-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/build/configuration/loader-factory.js

@@ -0,0 +1,2 @@
+export { getLoader, loadConfig, loadConfigFromPaths } from "./loader";
+//# sourceMappingURL=loader-factory.js.map

package/build/configuration/loader-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-factory.js","sourceRoot":"./src/","sources":["configuration/loader-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { getLoader, loadConfig, loadConfigFromPaths } from \"./loader\";\n"]}

package/build/configuration/loader.d.ts

@@ -0,0 +1,9 @@
+import type { ZodSchema } from "zod";
+import type { ConfigLoader, ConfigFormat, LoadedConfig } from "./types";
+export declare const getLoader: <T = unknown>(format: ConfigFormat) => ConfigLoader<T>;
+export declare const loadConfig: <T = unknown>(filePath: string, format: ConfigFormat, schema?: ZodSchema<T>) => LoadedConfig<T>;
+export declare const loadConfigFromPaths: <T = unknown>(paths: Array<{
+    path: string;
+    format: ConfigFormat;
+}>, schema?: ZodSchema<T>) => LoadedConfig<T>;
+//# sourceMappingURL=loader.d.ts.map

package/build/configuration/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"./src/","sources":["configuration/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOxE,eAAO,MAAM,SAAS,GAAI,CAAC,GAAG,OAAO,EACnC,QAAQ,YAAY,KACnB,YAAY,CAAC,CAAC,CAUhB,CAAC;AASF,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,OAAO,EACpC,UAAU,MAAM,EAChB,QAAQ,YAAY,EACpB,SAAS,SAAS,CAAC,CAAC,CAAC,KACpB,YAAY,CAAC,CAAC,CAehB,CAAC;AAMF,eAAO,MAAM,mBAAmB,GAAI,CAAC,GAAG,OAAO,EAC7C,OAAO,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,EACpD,SAAS,SAAS,CAAC,CAAC,CAAC,KACpB,YAAY,CAAC,CAAC,CAShB,CAAC"}

package/build/configuration/loader.js

@@ -0,0 +1,38 @@
+import { existsSync } from "fs";
+import { JSONLoader } from "./loaders/json-loader";
+import { YAMLLoader } from "./loaders/yaml-loader";
+import { validateConfig } from "./validation";
+export const getLoader = (format) => {
+    switch (format) {
+        case "json":
+            return new JSONLoader();
+        case "yaml":
+        case "yml":
+            return new YAMLLoader();
+        default:
+            throw new Error(`Unsupported config format: ${format}`);
+    }
+};
+export const loadConfig = (filePath, format, schema) => {
+    if (!existsSync(filePath)) {
+        throw new Error(`Config file not found: ${filePath}`);
+    }
+    const loader = getLoader(format);
+    const rawData = loader.load(filePath);
+    const data = schema ? validateConfig(rawData, schema) : rawData;
+    return {
+        data,
+        filePath,
+        format,
+    };
+};
+export const loadConfigFromPaths = (paths, schema) => {
+    for (const { path, format } of paths) {
+        if (existsSync(path)) {
+            return loadConfig(path, format, schema);
+        }
+    }
+    const pathsList = paths.map((p) => `${p.path} (${p.format})`).join(", ");
+    throw new Error(`No config file found in any of these paths: ${pathsList}`);
+};
+//# sourceMappingURL=loader.js.map

package/build/configuration/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"./src/","sources":["configuration/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,MAAoB,EACH,EAAE;IACnB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,UAAU,EAAK,CAAC;QAC7B,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,IAAI,UAAU,EAAK,CAAC;QAC7B;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC,CAAC;AASF,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,MAAoB,EACpB,MAAqB,EACJ,EAAE;IACnB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAI,MAAM,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEtC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAE,OAAa,CAAC;IAEvE,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAoD,EACpD,MAAqB,EACJ,EAAE;IACnB,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,UAAU,CAAI,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,IAAI,KAAK,CAAC,+CAA+C,SAAS,EAAE,CAAC,CAAC;AAC9E,CAAC,CAAC","sourcesContent":["import { existsSync } from \"fs\";\nimport type { ZodSchema } from \"zod\";\nimport { JSONLoader } from \"./loaders/json-loader\";\nimport { YAMLLoader } from \"./loaders/yaml-loader\";\nimport type { ConfigLoader, ConfigFormat, LoadedConfig } from \"./types\";\nimport { validateConfig } from \"./validation\";\n\n/**\n * Get loader for a specific format (explicit selection)\n * Similar to ORM adapter pattern - you choose which format to use\n */\nexport const getLoader = <T = unknown>(\n  format: ConfigFormat,\n): ConfigLoader<T> => {\n  switch (format) {\n    case \"json\":\n      return new JSONLoader<T>();\n    case \"yaml\":\n    case \"yml\":\n      return new YAMLLoader<T>();\n    default:\n      throw new Error(`Unsupported config format: ${format}`);\n  }\n};\n\n/**\n * Load configuration with explicit format selection\n * @param filePath - Path to config file\n * @param format - Config format ('json', 'yaml', or 'yml')\n * @param schema - Optional Zod schema for validation\n * @returns Loaded configuration with metadata\n */\nexport const loadConfig = <T = unknown>(\n  filePath: string,\n  format: ConfigFormat,\n  schema?: ZodSchema<T>,\n): LoadedConfig<T> => {\n  if (!existsSync(filePath)) {\n    throw new Error(`Config file not found: ${filePath}`);\n  }\n\n  const loader = getLoader<T>(format);\n  const rawData = loader.load(filePath);\n\n  const data = schema ? validateConfig(rawData, schema) : (rawData as T);\n\n  return {\n    data,\n    filePath,\n    format,\n  };\n};\n\n/**\n * Try to load config from multiple paths with explicit format\n * Returns first found config or throws if none exist\n */\nexport const loadConfigFromPaths = <T = unknown>(\n  paths: Array<{ path: string; format: ConfigFormat }>,\n  schema?: ZodSchema<T>,\n): LoadedConfig<T> => {\n  for (const { path, format } of paths) {\n    if (existsSync(path)) {\n      return loadConfig<T>(path, format, schema);\n    }\n  }\n\n  const pathsList = paths.map((p) => `${p.path} (${p.format})`).join(\", \");\n  throw new Error(`No config file found in any of these paths: ${pathsList}`);\n};\n"]}

package/build/configuration/loaders/index.d.ts

@@ -0,0 +1,3 @@
+export { JSONLoader, createJSONLoader } from "./json-loader";
+export { YAMLLoader, createYAMLLoader } from "./yaml-loader";
+//# sourceMappingURL=index.d.ts.map

package/build/configuration/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["configuration/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/build/configuration/loaders/index.js

@@ -0,0 +1,3 @@
+export { JSONLoader, createJSONLoader } from "./json-loader";
+export { YAMLLoader, createYAMLLoader } from "./yaml-loader";
+//# sourceMappingURL=index.js.map

package/build/configuration/loaders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["configuration/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { JSONLoader, createJSONLoader } from \"./json-loader\";\nexport { YAMLLoader, createYAMLLoader } from \"./yaml-loader\";\n"]}

package/build/configuration/loaders/json-loader.d.ts

@@ -0,0 +1,8 @@
+import type { ConfigLoader, ConfigFormat } from "../types";
+export declare class JSONLoader<T = unknown> implements ConfigLoader<T> {
+    readonly extensions: readonly ConfigFormat[];
+    load(filePath: string): T;
+    parse(content: string): T;
+}
+export declare const createJSONLoader: <T = unknown>() => JSONLoader<T>;
+//# sourceMappingURL=json-loader.d.ts.map

package/build/configuration/loaders/json-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-loader.d.ts","sourceRoot":"./src/","sources":["configuration/loaders/json-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAM3D,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAqB;IAEjE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC;IAMzB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC;CAQ1B;AAKD,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,OAAK,UAAU,CAAC,CAAC,CACxC,CAAC"}

package/build/configuration/loaders/json-loader.js

@@ -0,0 +1,18 @@
+import { readFileSync } from "fs";
+import { resolve } from "path";
+export class JSONLoader {
+    extensions = ["json"];
+    load(filePath) {
+        const resolvedPath = resolve(filePath);
+        const content = readFileSync(resolvedPath, "utf-8");
+        return this.parse(content);
+    }
+    parse(content) {
+        const cleanContent = content
+            .replace(/\/\*[\s\S]*?\*\//g, "")
+            .replace(/\/\/.*/g, "");
+        return JSON.parse(cleanContent);
+    }
+}
+export const createJSONLoader = () => new JSONLoader();
+//# sourceMappingURL=json-loader.js.map

package/build/configuration/loaders/json-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-loader.js","sourceRoot":"./src/","sources":["configuration/loaders/json-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAO/B,MAAM,OAAO,UAAU;IACZ,UAAU,GAA4B,CAAC,MAAM,CAAU,CAAC;IAEjE,IAAI,CAAC,QAAgB;QACnB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAe;QAEnB,MAAM,YAAY,GAAG,OAAO;aACzB,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;aAChC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAE1B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAM,CAAC;IACvC,CAAC;CACF;AAKD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAA+B,EAAE,CAC/D,IAAI,UAAU,EAAK,CAAC","sourcesContent":["import { readFileSync } from \"fs\";\nimport { resolve } from \"path\";\nimport type { ConfigLoader, ConfigFormat } from \"../types\";\n\n/**\n * JSON configuration file loader\n * Supports standard JSON files with comments stripped\n */\nexport class JSONLoader<T = unknown> implements ConfigLoader<T> {\n  readonly extensions: readonly ConfigFormat[] = [\"json\"] as const;\n\n  load(filePath: string): T {\n    const resolvedPath = resolve(filePath);\n    const content = readFileSync(resolvedPath, \"utf-8\");\n    return this.parse(content);\n  }\n\n  parse(content: string): T {\n    // Remove comments (// and /* */) for JSONC support\n    const cleanContent = content\n      .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\") // Remove /* */ comments\n      .replace(/\\/\\/.*/g, \"\"); // Remove // comments\n\n    return JSON.parse(cleanContent) as T;\n  }\n}\n\n/**\n * Factory function to create a JSON loader instance\n */\nexport const createJSONLoader = <T = unknown>(): JSONLoader<T> =>\n  new JSONLoader<T>();\n"]}

package/build/configuration/loaders/yaml-loader.d.ts

@@ -0,0 +1,8 @@
+import type { ConfigLoader, ConfigFormat } from "../types";
+export declare class YAMLLoader<T = unknown> implements ConfigLoader<T> {
+    readonly extensions: readonly ConfigFormat[];
+    load(filePath: string): T;
+    parse(content: string): T;
+}
+export declare const createYAMLLoader: <T = unknown>() => YAMLLoader<T>;
+//# sourceMappingURL=yaml-loader.d.ts.map

package/build/configuration/loaders/yaml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.d.ts","sourceRoot":"./src/","sources":["configuration/loaders/yaml-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAM3D,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAA4B;IAExE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC;IAMzB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC;CAO1B;AAKD,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,OAAK,UAAU,CAAC,CAAC,CACxC,CAAC"}

package/build/configuration/loaders/yaml-loader.js

@@ -0,0 +1,20 @@
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import { load } from "js-yaml";
+export class YAMLLoader {
+    extensions = ["yaml", "yml"];
+    load(filePath) {
+        const resolvedPath = resolve(filePath);
+        const content = readFileSync(resolvedPath, "utf-8");
+        return this.parse(content);
+    }
+    parse(content) {
+        const result = load(content);
+        if (result === null || result === undefined) {
+            throw new Error("YAML file is empty or invalid");
+        }
+        return result;
+    }
+}
+export const createYAMLLoader = () => new YAMLLoader();
+//# sourceMappingURL=yaml-loader.js.map

package/build/configuration/loaders/yaml-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.js","sourceRoot":"./src/","sources":["configuration/loaders/yaml-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAO/B,MAAM,OAAO,UAAU;IACZ,UAAU,GAA4B,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;IAExE,IAAI,CAAC,QAAgB;QACnB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;CACF;AAKD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAA+B,EAAE,CAC/D,IAAI,UAAU,EAAK,CAAC","sourcesContent":["import { readFileSync } from \"fs\";\nimport { resolve } from \"path\";\nimport { load } from \"js-yaml\";\nimport type { ConfigLoader, ConfigFormat } from \"../types\";\n\n/**\n * YAML configuration file loader\n * Supports both .yaml and .yml extensions\n */\nexport class YAMLLoader<T = unknown> implements ConfigLoader<T> {\n  readonly extensions: readonly ConfigFormat[] = [\"yaml\", \"yml\"] as const;\n\n  load(filePath: string): T {\n    const resolvedPath = resolve(filePath);\n    const content = readFileSync(resolvedPath, \"utf-8\");\n    return this.parse(content);\n  }\n\n  parse(content: string): T {\n    const result = load(content);\n    if (result === null || result === undefined) {\n      throw new Error(\"YAML file is empty or invalid\");\n    }\n    return result as T;\n  }\n}\n\n/**\n * Factory function to create a YAML loader instance\n */\nexport const createYAMLLoader = <T = unknown>(): YAMLLoader<T> =>\n  new YAMLLoader<T>();\n"]}

package/build/configuration/types.d.ts

@@ -0,0 +1,12 @@
+export type ConfigFormat = "json" | "yaml" | "yml";
+export interface ConfigLoader<T = unknown> {
+    load(filePath: string): T;
+    parse(content: string): T;
+    readonly extensions: readonly ConfigFormat[];
+}
+export interface LoadedConfig<T = unknown> {
+    data: T;
+    filePath: string;
+    format: ConfigFormat;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/configuration/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"./src/","sources":["configuration/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IAMvC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;IAO1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;IAK1B,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB"}

package/build/configuration/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/configuration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"./src/","sources":["configuration/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configuration loader types and interfaces\n */\n\nexport type ConfigFormat = \"json\" | \"yaml\" | \"yml\";\n\nexport interface ConfigLoader<T = unknown> {\n  /**\n   * Load configuration from a file path\n   * @param filePath - Absolute or relative path to config file\n   * @returns Parsed configuration object\n   */\n  load(filePath: string): T;\n\n  /**\n   * Load configuration from a string\n   * @param content - Raw configuration content\n   * @returns Parsed configuration object\n   */\n  parse(content: string): T;\n\n  /**\n   * Supported file extensions for this loader\n   */\n  readonly extensions: readonly ConfigFormat[];\n}\n\nexport interface LoadedConfig<T = unknown> {\n  data: T;\n  filePath: string;\n  format: ConfigFormat;\n}\n"]}

package/build/configuration/validation.d.ts

@@ -0,0 +1,14 @@
+import type { ZodSchema } from "zod";
+import type { LoadedConfig } from "./types";
+export declare const validateConfig: <T>(data: unknown, schema: ZodSchema<T>) => T;
+export declare const validateLoadedConfig: <T>(loaded: LoadedConfig<unknown>, schema: ZodSchema<T>) => LoadedConfig<T>;
+export declare const safeValidateConfig: <T>(data: unknown, schema: ZodSchema<T>) => {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: {
+        issues: unknown[];
+    };
+};
+//# sourceMappingURL=validation.d.ts.map

package/build/configuration/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"./src/","sources":["configuration/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ5C,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,MAAM,OAAO,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC,KAAG,CAEvE,CAAC;AAMF,eAAO,MAAM,oBAAoB,GAAI,CAAC,EACpC,QAAQ,YAAY,CAAC,OAAO,CAAC,EAC7B,QAAQ,SAAS,CAAC,CAAC,CAAC,KACnB,YAAY,CAAC,CAAC,CAQhB,CAAC;AAKF,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,MAAM,OAAO,EACb,QAAQ,SAAS,CAAC,CAAC,CAAC,KAElB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;CAWjD,CAAC"}

package/build/configuration/validation.js

@@ -0,0 +1,22 @@
+export const validateConfig = (data, schema) => {
+    return schema.parse(data);
+};
+export const validateLoadedConfig = (loaded, schema) => {
+    const validatedData = validateConfig(loaded.data, schema);
+    return {
+        data: validatedData,
+        filePath: loaded.filePath,
+        format: loaded.format,
+    };
+};
+export const safeValidateConfig = (data, schema) => {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return {
+        success: false,
+        error: { issues: result.error.issues },
+    };
+};
+//# sourceMappingURL=validation.js.map

package/build/configuration/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"./src/","sources":["configuration/validation.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,IAAa,EAAE,MAAoB,EAAK,EAAE;IAC1E,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAA6B,EAC7B,MAAoB,EACH,EAAE;IACnB,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC,CAAC;AAKF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAAa,EACb,MAAoB,EAG+B,EAAE;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;KACvC,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import type { ZodSchema } from \"zod\";\nimport type { LoadedConfig } from \"./types\";\n\n/**\n * Validate configuration data against a Zod schema\n * @param data - Raw configuration data\n * @param schema - Zod schema to validate against\n * @returns Validated and typed configuration\n */\nexport const validateConfig = <T>(data: unknown, schema: ZodSchema<T>): T => {\n  return schema.parse(data);\n};\n\n/**\n * Validate loaded configuration with a Zod schema\n * Returns validated data with preserved metadata\n */\nexport const validateLoadedConfig = <T>(\n  loaded: LoadedConfig<unknown>,\n  schema: ZodSchema<T>,\n): LoadedConfig<T> => {\n  const validatedData = validateConfig(loaded.data, schema);\n\n  return {\n    data: validatedData,\n    filePath: loaded.filePath,\n    format: loaded.format,\n  };\n};\n\n/**\n * Safe validation that returns success/error result\n */\nexport const safeValidateConfig = <T>(\n  data: unknown,\n  schema: ZodSchema<T>,\n):\n  | { success: true; data: T }\n  | { success: false; error: { issues: unknown[] } } => {\n  const result = schema.safeParse(data);\n\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n\n  return {\n    success: false,\n    error: { issues: result.error.issues },\n  };\n};\n"]}

package/build/configuration.d.ts

@@ -0,0 +1,2 @@
+export * from "./configuration/index";
+//# sourceMappingURL=configuration.d.ts.map

package/build/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"./src/","sources":["configuration.ts"],"names":[],"mappings":"AAMA,cAAc,uBAAuB,CAAC"}

package/build/configuration.js

@@ -0,0 +1,2 @@
+export * from "./configuration/index";
+//# sourceMappingURL=configuration.js.map

package/build/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"./src/","sources":["configuration.ts"],"names":[],"mappings":"AAMA,cAAc,uBAAuB,CAAC","sourcesContent":["/**\n * Configuration module\n * Re-exports from ./configuration for backward compatibility\n * @deprecated Import from \"./configuration/index\" directly\n */\n\nexport * from \"./configuration/index\";\n"]}

package/build/dependency-injection/container.d.ts

@@ -0,0 +1,9 @@
+import "reflect-metadata";
+import type { DependencyContainer, InjectionToken } from "tsyringe";
+export declare const getContainer: () => DependencyContainer;
+export declare const registerDependency: <T>(token: InjectionToken<T>, implementation: new (...args: unknown[]) => T) => void;
+export declare const registerSingleton: <T>(token: InjectionToken<T>, implementation: new (...args: unknown[]) => T) => void;
+export declare const registerValue: <T>(token: InjectionToken<T>, value: T) => void;
+export declare const resolveDependency: <T>(token: InjectionToken<T>) => T;
+export declare const clearContainer: () => void;
+//# sourceMappingURL=container.d.ts.map

package/build/dependency-injection/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"./src/","sources":["dependency-injection/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiCpE,eAAO,MAAM,YAAY,QAAO,mBAE/B,CAAC;AAQF,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAC5C,IAEF,CAAC;AAQF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAC5C,IAEF,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAG,IAErE,CAAC;AAQF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,KAAG,CAE/D,CAAC;AAKF,eAAO,MAAM,cAAc,QAAO,IAGjC,CAAC"}

package/build/dependency-injection/container.js

@@ -0,0 +1,22 @@
+import "reflect-metadata";
+import { container as tsyringeContainer } from "tsyringe";
+export const getContainer = () => {
+    return tsyringeContainer;
+};
+export const registerDependency = (token, implementation) => {
+    tsyringeContainer.register(token, { useClass: implementation });
+};
+export const registerSingleton = (token, implementation) => {
+    tsyringeContainer.registerSingleton(token, implementation);
+};
+export const registerValue = (token, value) => {
+    tsyringeContainer.register(token, { useValue: value });
+};
+export const resolveDependency = (token) => {
+    return tsyringeContainer.resolve(token);
+};
+export const clearContainer = () => {
+    tsyringeContainer.clearInstances();
+    tsyringeContainer.reset();
+};
+//# sourceMappingURL=container.js.map

package/build/dependency-injection/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"./src/","sources":["dependency-injection/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAkC1D,MAAM,CAAC,MAAM,YAAY,GAAG,GAAwB,EAAE;IACpD,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAwB,EACxB,cAA6C,EACvC,EAAE;IACR,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAwB,EACxB,cAA6C,EACvC,EAAE;IACR,iBAAiB,CAAC,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,KAAwB,EAAE,KAAQ,EAAQ,EAAE;IAC3E,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,KAAwB,EAAK,EAAE;IAClE,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC;AAKF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,iBAAiB,CAAC,cAAc,EAAE,CAAC;IACnC,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC","sourcesContent":["import \"reflect-metadata\";\nimport { container as tsyringeContainer } from \"tsyringe\";\nimport type { DependencyContainer, InjectionToken } from \"tsyringe\";\n\n/**\n * Standalone DI container decoupled from microservice architecture.\n * Automatically used by Service architecture - typically no manual registration needed.\n *\n * For advanced use cases, you can register dependencies manually:\n *\n * @example\n * ```typescript\n * import { registerDependency, resolveDependency } from '@sentzunhat/zacatl';\n *\n * // Manual registration (advanced use case)\n * class CustomService { ... }\n * registerDependency('CustomService', CustomService);\n *\n * // Resolve manually\n * const service = resolveDependency<CustomService>('CustomService');\n * ```\n *\n * Preferred approach (automatic registration through Service):\n * ```typescript\n * const service = new Service({\n *   architecture: {\n *     domain: { providers: [CustomService] }\n *   }\n * });\n * ```\n */\n\n/**\n * Get the global DI container instance\n */\nexport const getContainer = (): DependencyContainer => {\n  return tsyringeContainer;\n};\n\n/**\n * Register a dependency in the container\n *\n * @param token - Unique identifier for the dependency\n * @param implementation - Class or value to register\n */\nexport const registerDependency = <T>(\n  token: InjectionToken<T>,\n  implementation: new (...args: unknown[]) => T,\n): void => {\n  tsyringeContainer.register(token, { useClass: implementation });\n};\n\n/**\n * Register a singleton dependency (shared instance)\n *\n * @param token - Unique identifier for the dependency\n * @param implementation - Class to register as singleton\n */\nexport const registerSingleton = <T>(\n  token: InjectionToken<T>,\n  implementation: new (...args: unknown[]) => T,\n): void => {\n  tsyringeContainer.registerSingleton(token, implementation);\n};\n\n/**\n * Register a value (instance) in the container\n *\n * @param token - Unique identifier for the dependency\n * @param value - Instance to register\n */\nexport const registerValue = <T>(token: InjectionToken<T>, value: T): void => {\n  tsyringeContainer.register(token, { useValue: value });\n};\n\n/**\n * Resolve a dependency from the container\n *\n * @param token - Unique identifier for the dependency\n * @returns Resolved instance\n */\nexport const resolveDependency = <T>(token: InjectionToken<T>): T => {\n  return tsyringeContainer.resolve(token);\n};\n\n/**\n * Clear all registrations (useful for testing)\n */\nexport const clearContainer = (): void => {\n  tsyringeContainer.clearInstances();\n  tsyringeContainer.reset();\n};\n"]}

package/build/dependency-injection/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./container";
+//# sourceMappingURL=index.d.ts.map

package/build/dependency-injection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["dependency-injection/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/build/dependency-injection/index.js

@@ -0,0 +1,2 @@
+export * from "./container";
+//# sourceMappingURL=index.js.map

package/build/dependency-injection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["dependency-injection/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./container\";\n"]}

package/build/error/bad-request.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface BadRequestErrorArgs extends CustomErrorsArgs {
+}
+export declare class BadRequestError extends CustomError {
+    constructor({ message, reason, metadata, error }: BadRequestErrorArgs);
+}
+//# sourceMappingURL=bad-request.d.ts.map

package/build/error/bad-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bad-request.d.ts","sourceRoot":"./src/","sources":["error/bad-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;CAAG;AAEhE,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,mBAAmB;CAStE"}

package/build/error/bad-request.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class BadRequestError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 400,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=bad-request.js.map

package/build/error/bad-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bad-request.js","sourceRoot":"./src/","sources":["error/bad-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAuB;QACnE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface BadRequestErrorArgs extends CustomErrorsArgs {}\n\nexport class BadRequestError extends CustomError {\n  constructor({ message, reason, metadata, error }: BadRequestErrorArgs) {\n    super({\n      message,\n      code: 400,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/error/bad-resource.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface BadResourceErrorArgs extends CustomErrorsArgs {
+}
+export declare class BadResourceError extends CustomError {
+    constructor({ message, reason, metadata, error }: BadResourceErrorArgs);
+}
+//# sourceMappingURL=bad-resource.d.ts.map

package/build/error/bad-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bad-resource.d.ts","sourceRoot":"./src/","sources":["error/bad-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;CAAG;AAEjE,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,oBAAoB;CASvE"}

package/build/error/bad-resource.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class BadResourceError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 400,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=bad-resource.js.map

package/build/error/bad-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bad-resource.js","sourceRoot":"./src/","sources":["error/bad-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAwB;QACpE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface BadResourceErrorArgs extends CustomErrorsArgs {}\n\nexport class BadResourceError extends CustomError {\n  constructor({ message, reason, metadata, error }: BadResourceErrorArgs) {\n    super({\n      message,\n      code: 400,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/error/custom.d.ts

@@ -0,0 +1,49 @@
+import { Optional } from "../optionals";
+export type HttpStatusCode = 200 | 201 | 204 | 400 | 401 | 403 | 404 | 422 | 500 | 502 | 503;
+export type StatusCodeString = "invalid";
+export type ErrorCode = Optional<HttpStatusCode | StatusCodeString>;
+export interface CustomErrorsArgs {
+    message: string;
+    reason?: Optional<string>;
+    metadata?: Optional<Record<string, unknown>>;
+    error?: Optional<Error>;
+}
+export interface CustomErrorArgs {
+    message: string;
+    code?: ErrorCode;
+    reason?: Optional<string>;
+    metadata?: Optional<Record<string, unknown>>;
+    error?: Optional<Error>;
+}
+export declare class CustomError extends Error {
+    readonly custom: boolean;
+    readonly code: ErrorCode;
+    readonly reason?: Optional<string>;
+    readonly metadata?: Optional<Record<string, unknown>>;
+    readonly error?: Optional<Error>;
+    readonly time: Date;
+    readonly id: string;
+    readonly correlationId: string;
+    constructor({ message, code, reason, metadata, error, correlationId, }: CustomErrorArgs & {
+        correlationId?: string;
+    });
+    toJSON(): {
+        name: string;
+        message: string;
+        code: ErrorCode;
+        reason: Optional<string>;
+        metadata: Optional<Record<string, unknown>>;
+        error: {
+            name: string;
+            message: string;
+            stack: string | undefined;
+        } | undefined;
+        time: string;
+        id: string;
+        correlationId: string;
+        stack: string | undefined;
+        custom: boolean;
+    };
+    toString(): string;
+}
+//# sourceMappingURL=custom.d.ts.map

package/build/error/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"./src/","sources":["error/custom.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,MAAM,cAAc,GACtB,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,GAAG,gBAAgB,CAAC,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;CACzB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,MAAM,EAAE,OAAO,CAAC;IAChC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAgB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,SAAgB,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,EACV,OAAO,EACP,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,KAAK,EACL,aAAa,GACd,EAAE,eAAe,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAiB/C,MAAM;;;;;;;;;;;;;;;;;IAsBU,QAAQ,IAAI,MAAM;CAmBnC"}

package/build/error/custom.js

@@ -0,0 +1,65 @@
+import { v4 as uuidv4 } from "uuid";
+export class CustomError extends Error {
+    custom;
+    code;
+    reason;
+    metadata;
+    error;
+    time;
+    id;
+    correlationId;
+    constructor({ message, code, reason, metadata, error, correlationId, }) {
+        super(message);
+        this.id = uuidv4();
+        this.correlationId = correlationId || this.id;
+        this.custom = true;
+        this.name = this.constructor.name;
+        this.code = code;
+        this.reason = reason;
+        this.metadata = metadata;
+        this.error = error;
+        this.time = new Date();
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            reason: this.reason,
+            metadata: this.metadata,
+            error: this.error
+                ? {
+                    name: this.error.name,
+                    message: this.error.message,
+                    stack: this.error.stack,
+                }
+                : undefined,
+            time: this.time.toISOString(),
+            id: this.id,
+            correlationId: this.correlationId,
+            stack: this.stack,
+            custom: this.custom,
+        };
+    }
+    toString() {
+        return (`[` +
+            this.time.toISOString() +
+            `] ` +
+            this.name +
+            `: ` +
+            this.message +
+            `\nCorrelationId: ` +
+            this.correlationId +
+            (this.code ? `\nCode: ` + this.code : "") +
+            (this.reason ? `\nReason: ` + this.reason : "") +
+            (this.metadata
+                ? `\nMetadata: ` + JSON.stringify(this.metadata, null, 2)
+                : "") +
+            (this.error ? `\nCaused by: ` + this.error.toString() : "") +
+            (this.stack ? `\nStack: ` + this.stack : ""));
+    }
+}
+//# sourceMappingURL=custom.js.map

package/build/error/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"./src/","sources":["error/custom.ts"],"names":[],"mappings":"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","sourcesContent":["import { v4 as uuidv4 } from \"uuid\";\nimport { Optional } from \"../optionals\";\n\nexport type HttpStatusCode =\n  | 200 // OK\n  | 201 // Created\n  | 204 // No Content\n  | 400 // Bad Request\n  | 401 // Unauthorized\n  | 403 // Forbidden\n  | 404 // Not Found\n  | 422 // Validation not met\n  | 500 // Internal Server Error\n  | 502 // Bad Gateway\n  | 503; // Service Unavailable;\n\nexport type StatusCodeString = \"invalid\";\n\nexport type ErrorCode = Optional<HttpStatusCode | StatusCodeString>;\n\nexport interface CustomErrorsArgs {\n  message: string;\n  reason?: Optional<string>;\n  metadata?: Optional<Record<string, unknown>>;\n  error?: Optional<Error>;\n}\n\nexport interface CustomErrorArgs {\n  message: string;\n  code?: ErrorCode;\n  reason?: Optional<string>;\n  metadata?: Optional<Record<string, unknown>>;\n  error?: Optional<Error>;\n}\n\nexport class CustomError extends Error {\n  public readonly custom: boolean;\n  public readonly code: ErrorCode;\n  public readonly reason?: Optional<string>;\n  public readonly metadata?: Optional<Record<string, unknown>>;\n  public readonly error?: Optional<Error>;\n  public readonly time: Date;\n  public readonly id: string;\n  public readonly correlationId: string;\n\n  constructor({\n    message,\n    code,\n    reason,\n    metadata,\n    error,\n    correlationId,\n  }: CustomErrorArgs & { correlationId?: string }) {\n    super(message);\n    this.id = uuidv4();\n    this.correlationId = correlationId || this.id;\n    this.custom = true;\n    this.name = this.constructor.name;\n    this.code = code;\n    this.reason = reason;\n    this.metadata = metadata;\n    this.error = error;\n    this.time = new Date();\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      reason: this.reason,\n      metadata: this.metadata,\n      error: this.error\n        ? {\n            name: this.error.name,\n            message: this.error.message,\n            stack: this.error.stack,\n          }\n        : undefined,\n      time: this.time.toISOString(),\n      id: this.id,\n      correlationId: this.correlationId,\n      stack: this.stack,\n      custom: this.custom,\n    };\n  }\n\n  public override toString(): string {\n    return (\n      `[` +\n      this.time.toISOString() +\n      `] ` +\n      this.name +\n      `: ` +\n      this.message +\n      `\\nCorrelationId: ` +\n      this.correlationId +\n      (this.code ? `\\nCode: ` + this.code : \"\") +\n      (this.reason ? `\\nReason: ` + this.reason : \"\") +\n      (this.metadata\n        ? `\\nMetadata: ` + JSON.stringify(this.metadata, null, 2)\n        : \"\") +\n      (this.error ? `\\nCaused by: ` + this.error.toString() : \"\") +\n      (this.stack ? `\\nStack: ` + this.stack : \"\")\n    );\n  }\n}\n"]}

package/build/error/forbidden.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface ForbiddenErrorArgs extends CustomErrorsArgs {
+}
+export declare class ForbiddenError extends CustomError {
+    constructor({ message, reason, metadata, error }: ForbiddenErrorArgs);
+}
+//# sourceMappingURL=forbidden.d.ts.map

package/build/error/forbidden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden.d.ts","sourceRoot":"./src/","sources":["error/forbidden.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;CAAG;AAE/D,qBAAa,cAAe,SAAQ,WAAW;gBACjC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,kBAAkB;CASrE"}

package/build/error/forbidden.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class ForbiddenError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 403,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=forbidden.js.map

package/build/error/forbidden.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden.js","sourceRoot":"./src/","sources":["error/forbidden.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAsB;QAClE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface ForbiddenErrorArgs extends CustomErrorsArgs {}\n\nexport class ForbiddenError extends CustomError {\n  constructor({ message, reason, metadata, error }: ForbiddenErrorArgs) {\n    super({\n      message,\n      code: 403,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/error/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./bad-request";
+export * from "./bad-resource";
+export * from "./custom";
+export * from "./forbidden";
+export * from "./internal-server";
+export * from "./not-found";
+export * from "./unauthorized";
+export * from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/build/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["error/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}