@sentzunhat/zacatl 0.0.13 → 0.0.20

package/build/localization/intl.js

@@ -0,0 +1,120 @@
+import i18next from "i18next";
+import { FilesystemAdapter } from "./adapters";
+export const createI18n = (adapter, config) => {
+    const finalAdapter = adapter ??
+        new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            throw new Error("Async adapter.init() not supported in createI18n(); use createI18nAsync() instead");
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    i18nInstance.init({
+        lng: finalConfig.defaultLanguage,
+        fallbackLng: finalConfig.fallbackLanguage,
+        ns: [finalConfig.defaultNamespace],
+        defaultNS: finalConfig.defaultNamespace,
+        interpolation: {
+            escapeValue: false,
+        },
+        resources: loadInitialResources(finalAdapter, finalConfig),
+        ...finalConfig.i18nextOptions,
+    }, (err) => {
+        if (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new Error(`i18n initialization failed: ${errorMessage}`);
+        }
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+export const createI18nAsync = async (adapter, config) => {
+    const finalAdapter = adapter ??
+        new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            await result;
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    await new Promise((resolve, reject) => {
+        i18nInstance.init({
+            lng: finalConfig.defaultLanguage,
+            fallbackLng: finalConfig.fallbackLanguage,
+            ns: [finalConfig.defaultNamespace],
+            defaultNS: finalConfig.defaultNamespace,
+            interpolation: {
+                escapeValue: false,
+            },
+            resources: loadInitialResources(finalAdapter, finalConfig),
+            ...finalConfig.i18nextOptions,
+        }, (err) => {
+            if (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                reject(new Error(`i18n initialization failed: ${errorMessage}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+let globalI18nInstance = null;
+export const setGlobalI18n = (instance) => {
+    globalI18nInstance = instance;
+};
+export const getI18nOrThrow = () => {
+    if (!globalI18nInstance) {
+        throw new Error("i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.");
+    }
+    return globalI18nInstance;
+};
+const loadInitialResources = (adapter, config) => {
+    const resources = {};
+    for (const lang of config.supportedLanguages ?? []) {
+        const res = adapter.loadResources(lang, config.defaultNamespace ?? "translation");
+        if (res) {
+            resources[lang] = {
+                [config.defaultNamespace ?? "translation"]: res,
+            };
+        }
+    }
+    return resources;
+};
+const createI18nInstanceWrapper = (i18nInstance, _adapter, config) => {
+    const inst = i18nInstance;
+    return {
+        t: (key, options) => inst.t(key, options),
+        getLanguage: () => inst.language,
+        setLanguage: async (language) => {
+            await inst.changeLanguage(language);
+        },
+        getSupportedLanguages: () => config.supportedLanguages ?? ["en"],
+        getI18next: () => i18nInstance,
+        addResources: (language, namespace, resources) => {
+            inst.addResourceBundle(language, namespace, resources, true, true);
+        },
+        getResources: (language, namespace) => {
+            const lang = language ?? inst.language;
+            const ns = namespace ?? config.defaultNamespace ?? "translation";
+            return inst.getResourceBundle(lang, ns) ?? null;
+        },
+    };
+};
+//# sourceMappingURL=intl.js.map

package/build/localization/intl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.js","sourceRoot":"./src/","sources":["localization/intl.ts"],"names":[],"mappings":"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","sourcesContent":["import i18next from \"i18next\";\nimport type { I18nAdapter, I18nConfig, I18nInstance } from \"./types\";\nimport { FilesystemAdapter } from \"./adapters\";\n\n/**\n * Create a new i18n instance with optional adapter and configuration.\n * Follows the same factory pattern as createLogger().\n *\n * @param adapter - I18nAdapter implementation (defaults to FilesystemAdapter('./src/localization/locales'))\n * @param config - I18n configuration options\n * @returns Configured I18nInstance\n *\n * @example\n * // With default filesystem adapter\n * const i18n = createI18n();\n *\n * @example\n * // With custom adapter\n * import { MemoryAdapter } from './adapters';\n * const i18n = createI18n(new MemoryAdapter({\n *   en: { translation: { greeting: 'Hello' } }\n * }));\n *\n * @example\n * // With configuration\n * const i18n = createI18n(undefined, {\n *   defaultLanguage: 'en',\n *   supportedLanguages: ['en', 'es'],\n *   i18nextOptions: { ns: ['translation', 'errors'] }\n * });\n */\nexport const createI18n = (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): I18nInstance => {\n  const finalAdapter =\n    adapter ??\n    new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      throw new Error(\n        \"Async adapter.init() not supported in createI18n(); use createI18nAsync() instead\",\n      );\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  i18nInstance.init(\n    {\n      lng: finalConfig.defaultLanguage,\n      fallbackLng: finalConfig.fallbackLanguage,\n      ns: [finalConfig.defaultNamespace],\n      defaultNS: finalConfig.defaultNamespace,\n      interpolation: {\n        escapeValue: false, // React/TypeScript handles escaping\n      },\n      resources: loadInitialResources(finalAdapter, finalConfig),\n      ...finalConfig.i18nextOptions,\n    } as Record<string, unknown>,\n    (err: unknown) => {\n      if (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        throw new Error(`i18n initialization failed: ${errorMessage}`);\n      }\n    },\n  );\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Create a new async i18n instance.\n * Use this if your adapter.init() returns a Promise.\n *\n * @param adapter - I18nAdapter implementation\n * @param config - I18n configuration options\n * @returns Promise<I18nInstance>\n */\nexport const createI18nAsync = async (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): Promise<I18nInstance> => {\n  const finalAdapter =\n    adapter ??\n    new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      await result;\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  await new Promise<void>((resolve, reject) => {\n    i18nInstance.init(\n      {\n        lng: finalConfig.defaultLanguage,\n        fallbackLng: finalConfig.fallbackLanguage,\n        ns: [finalConfig.defaultNamespace],\n        defaultNS: finalConfig.defaultNamespace,\n        interpolation: {\n          escapeValue: false,\n        },\n        resources: loadInitialResources(finalAdapter, finalConfig),\n        ...finalConfig.i18nextOptions,\n      } as Record<string, unknown>,\n      (err: unknown) => {\n        if (err) {\n          const errorMessage = err instanceof Error ? err.message : String(err);\n          reject(new Error(`i18n initialization failed: ${errorMessage}`));\n        } else {\n          resolve();\n        }\n      },\n    );\n  });\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Get or throw error if not initialized.\n * Used internally; not part of public API.\n */\nlet globalI18nInstance: I18nInstance | null = null;\n\nexport const setGlobalI18n = (instance: I18nInstance): void => {\n  globalI18nInstance = instance;\n};\n\nexport const getI18nOrThrow = (): I18nInstance => {\n  if (!globalI18nInstance) {\n    throw new Error(\n      \"i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.\",\n    );\n  }\n  return globalI18nInstance;\n};\n\n/**\n * Internal: Load initial resources from adapter.\n */\nconst loadInitialResources = (\n  adapter: I18nAdapter,\n  config: I18nConfig,\n): Record<string, Record<string, unknown>> => {\n  const resources: Record<string, Record<string, unknown>> = {};\n\n  for (const lang of config.supportedLanguages ?? []) {\n    const res = adapter.loadResources(\n      lang,\n      config.defaultNamespace ?? \"translation\",\n    );\n    if (res) {\n      resources[lang] = {\n        [config.defaultNamespace ?? \"translation\"]: res,\n      };\n    }\n  }\n\n  return resources;\n};\n\n/**\n * Internal: Create the I18nInstance wrapper.\n */\nconst createI18nInstanceWrapper = (\n  i18nInstance: unknown,\n  _adapter: I18nAdapter,\n  config: I18nConfig,\n): I18nInstance => {\n  const inst = i18nInstance as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  return {\n    t: (key: string, options?: Record<string, unknown>) =>\n      inst.t(key, options) as string,\n\n    getLanguage: () => inst.language,\n\n    setLanguage: async (language: string) => {\n      await inst.changeLanguage(language);\n    },\n\n    getSupportedLanguages: () => config.supportedLanguages ?? [\"en\"],\n\n    getI18next: () => i18nInstance,\n\n    addResources: (\n      language: string,\n      namespace: string,\n      resources: Record<string, unknown>,\n    ) => {\n      inst.addResourceBundle(language, namespace, resources, true, true);\n    },\n\n    getResources: (language?: string, namespace?: string) => {\n      const lang = language ?? inst.language;\n      const ns = namespace ?? config.defaultNamespace ?? \"translation\";\n      return inst.getResourceBundle(lang, ns) ?? null;\n    },\n  };\n};\n"]}

package/build/localization/localization.d.ts

@@ -0,0 +1,6 @@
+import type { I18nAdapter, I18nConfig, I18nInstance } from "./types";
+export declare const createI18n: (adapter?: I18nAdapter, config?: I18nConfig) => I18nInstance;
+export declare const createI18nAsync: (adapter?: I18nAdapter, config?: I18nConfig) => Promise<I18nInstance>;
+export declare const setGlobalI18n: (instance: I18nInstance) => void;
+export declare const getI18nOrThrow: () => I18nInstance;
+//# sourceMappingURL=localization.d.ts.map

package/build/localization/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"./src/","sources":["localization/localization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BrE,eAAO,MAAM,UAAU,GACrB,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,YA6CF,CAAC;AAUF,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,SAAS,UAAU,KAClB,OAAO,CAAC,YAAY,CA+CtB,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,UAAU,YAAY,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,YAOjC,CAAC"}

package/build/localization/localization.js

@@ -0,0 +1,120 @@
+import i18next from "i18next";
+import { FilesystemAdapter } from "./adapters";
+export const createI18n = (adapter, config) => {
+    const finalAdapter = adapter ??
+        new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            throw new Error("Async adapter.init() not supported in createI18n(); use createI18nAsync() instead");
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    i18nInstance.init({
+        lng: finalConfig.defaultLanguage,
+        fallbackLng: finalConfig.fallbackLanguage,
+        ns: [finalConfig.defaultNamespace],
+        defaultNS: finalConfig.defaultNamespace,
+        interpolation: {
+            escapeValue: false,
+        },
+        resources: loadInitialResources(finalAdapter, finalConfig),
+        ...finalConfig.i18nextOptions,
+    }, (err) => {
+        if (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new Error(`i18n initialization failed: ${errorMessage}`);
+        }
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+export const createI18nAsync = async (adapter, config) => {
+    const finalAdapter = adapter ??
+        new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);
+    const finalConfig = {
+        defaultLanguage: "en",
+        fallbackLanguage: "en",
+        supportedLanguages: ["en", "es"],
+        defaultNamespace: "translation",
+        ...config,
+    };
+    if (finalAdapter.init) {
+        const result = finalAdapter.init();
+        if (result instanceof Promise) {
+            await result;
+        }
+    }
+    const i18nInstance = i18next.createInstance();
+    await new Promise((resolve, reject) => {
+        i18nInstance.init({
+            lng: finalConfig.defaultLanguage,
+            fallbackLng: finalConfig.fallbackLanguage,
+            ns: [finalConfig.defaultNamespace],
+            defaultNS: finalConfig.defaultNamespace,
+            interpolation: {
+                escapeValue: false,
+            },
+            resources: loadInitialResources(finalAdapter, finalConfig),
+            ...finalConfig.i18nextOptions,
+        }, (err) => {
+            if (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                reject(new Error(`i18n initialization failed: ${errorMessage}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+    return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);
+};
+let globalI18nInstance = null;
+export const setGlobalI18n = (instance) => {
+    globalI18nInstance = instance;
+};
+export const getI18nOrThrow = () => {
+    if (!globalI18nInstance) {
+        throw new Error("i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.");
+    }
+    return globalI18nInstance;
+};
+const loadInitialResources = (adapter, config) => {
+    const resources = {};
+    for (const lang of config.supportedLanguages ?? []) {
+        const res = adapter.loadResources(lang, config.defaultNamespace ?? "translation");
+        if (res) {
+            resources[lang] = {
+                [config.defaultNamespace ?? "translation"]: res,
+            };
+        }
+    }
+    return resources;
+};
+const createI18nInstanceWrapper = (i18nInstance, _adapter, config) => {
+    const inst = i18nInstance;
+    return {
+        t: (key, options) => inst.t(key, options),
+        getLanguage: () => inst.language,
+        setLanguage: async (language) => {
+            await inst.changeLanguage(language);
+        },
+        getSupportedLanguages: () => config.supportedLanguages ?? ["en"],
+        getI18next: () => i18nInstance,
+        addResources: (language, namespace, resources) => {
+            inst.addResourceBundle(language, namespace, resources, true, true);
+        },
+        getResources: (language, namespace) => {
+            const lang = language ?? inst.language;
+            const ns = namespace ?? config.defaultNamespace ?? "translation";
+            return inst.getResourceBundle(lang, ns) ?? null;
+        },
+    };
+};
+//# sourceMappingURL=localization.js.map

package/build/localization/localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.js","sourceRoot":"./src/","sources":["localization/localization.ts"],"names":[],"mappings":"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","sourcesContent":["import i18next from \"i18next\";\nimport type { I18nAdapter, I18nConfig, I18nInstance } from \"./types\";\nimport { FilesystemAdapter } from \"./adapters\";\n\n/**\n * Create a new i18n instance with optional adapter and configuration.\n * Follows the same factory pattern as createLogger().\n *\n * @param adapter - I18nAdapter implementation (defaults to FilesystemAdapter('./src/localization/locales'))\n * @param config - I18n configuration options\n * @returns Configured I18nInstance\n *\n * @example\n * // With default filesystem adapter\n * const i18n = createI18n();\n *\n * @example\n * // With custom adapter\n * import { MemoryAdapter } from './adapters';\n * const i18n = createI18n(new MemoryAdapter({\n *   en: { translation: { greeting: 'Hello' } }\n * }));\n *\n * @example\n * // With configuration\n * const i18n = createI18n(undefined, {\n *   defaultLanguage: 'en',\n *   supportedLanguages: ['en', 'es'],\n *   i18nextOptions: { ns: ['translation', 'errors'] }\n * });\n */\nexport const createI18n = (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): I18nInstance => {\n  const finalAdapter =\n    adapter ??\n    new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      throw new Error(\n        \"Async adapter.init() not supported in createI18n(); use createI18nAsync() instead\",\n      );\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  i18nInstance.init(\n    {\n      lng: finalConfig.defaultLanguage,\n      fallbackLng: finalConfig.fallbackLanguage,\n      ns: [finalConfig.defaultNamespace],\n      defaultNS: finalConfig.defaultNamespace,\n      interpolation: {\n        escapeValue: false, // React/TypeScript handles escaping\n      },\n      resources: loadInitialResources(finalAdapter, finalConfig),\n      ...finalConfig.i18nextOptions,\n    } as Record<string, unknown>,\n    (err: unknown) => {\n      if (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        throw new Error(`i18n initialization failed: ${errorMessage}`);\n      }\n    },\n  );\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Create a new async i18n instance.\n * Use this if your adapter.init() returns a Promise.\n *\n * @param adapter - I18nAdapter implementation\n * @param config - I18n configuration options\n * @returns Promise<I18nInstance>\n */\nexport const createI18nAsync = async (\n  adapter?: I18nAdapter,\n  config?: I18nConfig,\n): Promise<I18nInstance> => {\n  const finalAdapter =\n    adapter ??\n    new FilesystemAdapter(`${process.cwd()}/src/localization/locales`);\n  const finalConfig: I18nConfig = {\n    defaultLanguage: \"en\",\n    fallbackLanguage: \"en\",\n    supportedLanguages: [\"en\", \"es\"],\n    defaultNamespace: \"translation\",\n    ...config,\n  };\n\n  // Initialize adapter\n  if (finalAdapter.init) {\n    const result = finalAdapter.init();\n    if (result instanceof Promise) {\n      await result;\n    }\n  }\n\n  // Configure i18next\n  const i18nInstance = i18next.createInstance();\n  await new Promise<void>((resolve, reject) => {\n    i18nInstance.init(\n      {\n        lng: finalConfig.defaultLanguage,\n        fallbackLng: finalConfig.fallbackLanguage,\n        ns: [finalConfig.defaultNamespace],\n        defaultNS: finalConfig.defaultNamespace,\n        interpolation: {\n          escapeValue: false,\n        },\n        resources: loadInitialResources(finalAdapter, finalConfig),\n        ...finalConfig.i18nextOptions,\n      } as Record<string, unknown>,\n      (err: unknown) => {\n        if (err) {\n          const errorMessage = err instanceof Error ? err.message : String(err);\n          reject(new Error(`i18n initialization failed: ${errorMessage}`));\n        } else {\n          resolve();\n        }\n      },\n    );\n  });\n\n  return createI18nInstanceWrapper(i18nInstance, finalAdapter, finalConfig);\n};\n\n/**\n * Get or throw error if not initialized.\n * Used internally; not part of public API.\n */\nlet globalI18nInstance: I18nInstance | null = null;\n\nexport const setGlobalI18n = (instance: I18nInstance): void => {\n  globalI18nInstance = instance;\n};\n\nexport const getI18nOrThrow = (): I18nInstance => {\n  if (!globalI18nInstance) {\n    throw new Error(\n      \"i18n not initialized. Call setGlobalI18n() first or use createI18n() to create an instance.\",\n    );\n  }\n  return globalI18nInstance;\n};\n\n/**\n * Internal: Load initial resources from adapter.\n */\nconst loadInitialResources = (\n  adapter: I18nAdapter,\n  config: I18nConfig,\n): Record<string, Record<string, unknown>> => {\n  const resources: Record<string, Record<string, unknown>> = {};\n\n  for (const lang of config.supportedLanguages ?? []) {\n    const res = adapter.loadResources(\n      lang,\n      config.defaultNamespace ?? \"translation\",\n    );\n    if (res) {\n      resources[lang] = {\n        [config.defaultNamespace ?? \"translation\"]: res,\n      };\n    }\n  }\n\n  return resources;\n};\n\n/**\n * Internal: Create the I18nInstance wrapper.\n */\nconst createI18nInstanceWrapper = (\n  i18nInstance: unknown,\n  _adapter: I18nAdapter,\n  config: I18nConfig,\n): I18nInstance => {\n  const inst = i18nInstance as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  return {\n    t: (key: string, options?: Record<string, unknown>) =>\n      inst.t(key, options) as string,\n\n    getLanguage: () => inst.language,\n\n    setLanguage: async (language: string) => {\n      await inst.changeLanguage(language);\n    },\n\n    getSupportedLanguages: () => config.supportedLanguages ?? [\"en\"],\n\n    getI18next: () => i18nInstance,\n\n    addResources: (\n      language: string,\n      namespace: string,\n      resources: Record<string, unknown>,\n    ) => {\n      inst.addResourceBundle(language, namespace, resources, true, true);\n    },\n\n    getResources: (language?: string, namespace?: string) => {\n      const lang = language ?? inst.language;\n      const ns = namespace ?? config.defaultNamespace ?? \"translation\";\n      return inst.getResourceBundle(lang, ns) ?? null;\n    },\n  };\n};\n"]}

package/build/localization/types.d.ts

@@ -0,0 +1,22 @@
+export interface I18nAdapter {
+    init?(config?: Record<string, unknown>): Promise<void> | void;
+    loadResources(language: string, namespace: string): Promise<Record<string, unknown> | null> | Record<string, unknown> | null;
+    saveResources?(language: string, namespace: string, resources: Record<string, unknown>): Promise<void> | void;
+}
+export interface I18nConfig {
+    defaultLanguage?: string;
+    fallbackLanguage?: string;
+    supportedLanguages?: string[];
+    defaultNamespace?: string;
+    i18nextOptions?: Record<string, unknown>;
+}
+export interface I18nInstance {
+    t(key: string, options?: Record<string, unknown>): string;
+    getLanguage(): string;
+    setLanguage(language: string): Promise<void>;
+    getSupportedLanguages(): string[];
+    getI18next(): unknown;
+    addResources(language: string, namespace: string, resources: Record<string, unknown>): void;
+    getResources(language?: string, namespace?: string): Record<string, unknown> | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"./src/","sources":["localization/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAI1B,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAM9D,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAK5E,aAAa,CAAC,CACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzB;AAKD,MAAM,WAAW,UAAU;IAKzB,eAAe,CAAC,EAAE,MAAM,CAAC;IAMzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAM1B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAM9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAMD,MAAM,WAAW,YAAY;IAI3B,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAK1D,WAAW,IAAI,MAAM,CAAC;IAKtB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK7C,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAKlC,UAAU,IAAI,OAAO,CAAC;IAKtB,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAAC;IAKR,YAAY,CACV,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnC"}

package/build/localization/types.js

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

package/build/localization/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"./src/","sources":["localization/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * I18n adapter interface for pluggable i18n backends.\n * Implementations define where translations are loaded from (filesystem, API, memory, etc.).\n */\nexport interface I18nAdapter {\n  /**\n   * Initialize the adapter with optional configuration.\n   */\n  init?(config?: Record<string, unknown>): Promise<void> | void;\n\n  /**\n   * Load translations for a specific language and namespace.\n   * Returns the loaded resources object.\n   */\n  loadResources(\n    language: string,\n    namespace: string,\n  ): Promise<Record<string, unknown> | null> | Record<string, unknown> | null;\n\n  /**\n   * Optional: Save translations (useful for some backends).\n   */\n  saveResources?(\n    language: string,\n    namespace: string,\n    resources: Record<string, unknown>,\n  ): Promise<void> | void;\n}\n\n/**\n * I18n configuration options.\n */\nexport interface I18nConfig {\n  /**\n   * Default language for translations.\n   * @default 'en'\n   */\n  defaultLanguage?: string;\n\n  /**\n   * Fallback language if translation not found.\n   * @default 'en'\n   */\n  fallbackLanguage?: string;\n\n  /**\n   * List of supported languages.\n   * @default ['en']\n   */\n  supportedLanguages?: string[];\n\n  /**\n   * Default namespace for translations.\n   * @default 'translation'\n   */\n  defaultNamespace?: string;\n\n  /**\n   * Additional i18next options to merge with defaults.\n   */\n  i18nextOptions?: Record<string, unknown>;\n}\n\n/**\n * I18n instance returned by createI18n().\n * Provides translation, language switching, and management methods.\n */\nexport interface I18nInstance {\n  /**\n   * Translate a key with optional interpolation.\n   */\n  t(key: string, options?: Record<string, unknown>): string;\n\n  /**\n   * Get the current language.\n   */\n  getLanguage(): string;\n\n  /**\n   * Change the current language.\n   */\n  setLanguage(language: string): Promise<void>;\n\n  /**\n   * Get all supported languages.\n   */\n  getSupportedLanguages(): string[];\n\n  /**\n   * Get the raw i18next instance for advanced usage.\n   */\n  getI18next(): unknown;\n\n  /**\n   * Add resources programmatically.\n   */\n  addResources(\n    language: string,\n    namespace: string,\n    resources: Record<string, unknown>,\n  ): void;\n\n  /**\n   * Get resource bundles for a language/namespace.\n   */\n  getResources(\n    language?: string,\n    namespace?: string,\n  ): Record<string, unknown> | null;\n}\n"]}

package/build/localization/validation.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const I18nConfigSchema: z.ZodObject<{
+    defaultLanguage: z.ZodDefault<z.ZodString>;
+    fallbackLanguage: z.ZodDefault<z.ZodString>;
+    supportedLanguages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    defaultNamespace: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const validateI18nConfig: (config: unknown) => ReturnType<typeof I18nConfigSchema.parse>;
+export declare const safeValidateI18nConfig: (config: unknown) => {
+    success: true;
+    data: z.infer<typeof I18nConfigSchema>;
+} | {
+    success: false;
+    errors: z.ZodError;
+};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"./src/","sources":["localization/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,gBAAgB;;;;;iBAW3B,CAAC;AAMH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,OAAO,KACd,UAAU,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAE1C,CAAC;AAMF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,OAAO,KAEb;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;CAAE,GACzD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAA;CAKvC,CAAC"}

package/build/localization/validation.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export const I18nConfigSchema = z.object({
+    defaultLanguage: z.string().default("en").describe("Default language code"),
+    fallbackLanguage: z.string().default("en").describe("Fallback language code"),
+    supportedLanguages: z
+        .array(z.string())
+        .default(["en"])
+        .describe("List of supported language codes"),
+    defaultNamespace: z
+        .string()
+        .default("translation")
+        .describe("Default translation namespace"),
+});
+export const validateI18nConfig = (config) => {
+    return I18nConfigSchema.parse(config);
+};
+export const safeValidateI18nConfig = (config) => {
+    const result = I18nConfigSchema.safeParse(config);
+    return result.success
+        ? { success: true, data: result.data }
+        : { success: false, errors: result.error };
+};
+//# sourceMappingURL=validation.js.map

package/build/localization/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"./src/","sources":["localization/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC7E,kBAAkB,EAAE,CAAC;SAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;SACf,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAe,EAC4B,EAAE;IAC7C,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAe,EAG0B,EAAE;IAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACtC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAC/C,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\n/**\n * Zod schema for validating i18n configuration.\n * Ensures all required language files and namespaces are present.\n */\nexport const I18nConfigSchema = z.object({\n  defaultLanguage: z.string().default(\"en\").describe(\"Default language code\"),\n  fallbackLanguage: z.string().default(\"en\").describe(\"Fallback language code\"),\n  supportedLanguages: z\n    .array(z.string())\n    .default([\"en\"])\n    .describe(\"List of supported language codes\"),\n  defaultNamespace: z\n    .string()\n    .default(\"translation\")\n    .describe(\"Default translation namespace\"),\n});\n\n/**\n * Validate a configuration object against the I18n schema.\n * Throws ZodError if validation fails.\n */\nexport const validateI18nConfig = (\n  config: unknown,\n): ReturnType<typeof I18nConfigSchema.parse> => {\n  return I18nConfigSchema.parse(config);\n};\n\n/**\n * Safe version of validateI18nConfig.\n * Returns { success: true, data } or { success: false, errors }.\n */\nexport const safeValidateI18nConfig = (\n  config: unknown,\n):\n  | { success: true; data: z.infer<typeof I18nConfigSchema> }\n  | { success: false; errors: z.ZodError } => {\n  const result = I18nConfigSchema.safeParse(config);\n  return result.success\n    ? { success: true, data: result.data }\n    : { success: false, errors: result.error };\n};\n"]}

package/build/logs/adapters/console-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { LoggerAdapter, LoggerInput } from "../types";
+export declare class ConsoleLoggerAdapter implements LoggerAdapter {
+    private readonly enableColors;
+    private readonly enableTimestamps;
+    constructor(options?: {
+        colors?: boolean;
+        timestamps?: boolean;
+    });
+    private formatMessage;
+    private colorize;
+    log(message: string, input?: LoggerInput): void;
+    info(message: string, input?: LoggerInput): void;
+    trace(message: string, input?: LoggerInput): void;
+    warn(message: string, input?: LoggerInput): void;
+    error(message: string, input?: LoggerInput): void;
+    fatal(message: string, input?: LoggerInput): void;
+}
+//# sourceMappingURL=console-adapter.d.ts.map

package/build/logs/adapters/console-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-adapter.d.ts","sourceRoot":"./src/","sources":["logs/adapters/console-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM3D,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAE/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAKhE,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,QAAQ;IAehB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAKhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAKjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAKhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAKjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;CAIlD"}

package/build/logs/adapters/console-adapter.js

@@ -0,0 +1,65 @@
+export class ConsoleLoggerAdapter {
+    enableColors;
+    enableTimestamps;
+    constructor(options) {
+        this.enableColors = options?.colors ?? true;
+        this.enableTimestamps = options?.timestamps ?? true;
+    }
+    formatMessage(level, message, input) {
+        const timestamp = this.enableTimestamps
+            ? `[${new Date().toISOString()}]`
+            : "";
+        const levelTag = `[${level.toUpperCase()}]`;
+        let output = `${timestamp} ${levelTag} ${message}`;
+        if (input) {
+            const structured = {};
+            if (input.data !== undefined) {
+                structured["data"] = input.data;
+            }
+            if (input.details !== undefined) {
+                structured["details"] = input.details;
+            }
+            if (Object.keys(structured).length > 0) {
+                output += ` ${JSON.stringify(structured)}`;
+            }
+        }
+        return output;
+    }
+    colorize(text, color) {
+        if (!this.enableColors)
+            return text;
+        const colors = {
+            reset: "\x1b[0m",
+            red: "\x1b[31m",
+            yellow: "\x1b[33m",
+            blue: "\x1b[34m",
+            gray: "\x1b[90m",
+            magenta: "\x1b[35m",
+        };
+        return `${colors[color] || ""}${text}${colors["reset"]}`;
+    }
+    log(message, input) {
+        this.info(message, input);
+    }
+    info(message, input) {
+        const formatted = this.formatMessage("info", message, input);
+        console.log(this.colorize(formatted, "blue"));
+    }
+    trace(message, input) {
+        const formatted = this.formatMessage("trace", message, input);
+        console.log(this.colorize(formatted, "gray"));
+    }
+    warn(message, input) {
+        const formatted = this.formatMessage("warn", message, input);
+        console.warn(this.colorize(formatted, "yellow"));
+    }
+    error(message, input) {
+        const formatted = this.formatMessage("error", message, input);
+        console.error(this.colorize(formatted, "red"));
+    }
+    fatal(message, input) {
+        const formatted = this.formatMessage("fatal", message, input);
+        console.error(this.colorize(formatted, "magenta"));
+    }
+}
+//# sourceMappingURL=console-adapter.js.map

package/build/logs/adapters/console-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-adapter.js","sourceRoot":"./src/","sources":["logs/adapters/console-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LoggerAdapter, LoggerInput } from \"../types\";\n\n/**\n * Lightweight console-based logger adapter for CLI, desktop apps,\n * and environments where structured logging is not needed.\n */\nexport class ConsoleLoggerAdapter implements LoggerAdapter {\n  private readonly enableColors: boolean;\n  private readonly enableTimestamps: boolean;\n\n  constructor(options?: { colors?: boolean; timestamps?: boolean }) {\n    this.enableColors = options?.colors ?? true;\n    this.enableTimestamps = options?.timestamps ?? true;\n  }\n\n  private formatMessage(\n    level: string,\n    message: string,\n    input?: LoggerInput,\n  ): string {\n    const timestamp = this.enableTimestamps\n      ? `[${new Date().toISOString()}]`\n      : \"\";\n    const levelTag = `[${level.toUpperCase()}]`;\n\n    let output = `${timestamp} ${levelTag} ${message}`;\n\n    if (input) {\n      const structured: Record<string, unknown> = {};\n\n      if (input.data !== undefined) {\n        structured[\"data\"] = input.data;\n      }\n\n      if (input.details !== undefined) {\n        structured[\"details\"] = input.details;\n      }\n\n      if (Object.keys(structured).length > 0) {\n        output += ` ${JSON.stringify(structured)}`;\n      }\n    }\n\n    return output;\n  }\n\n  private colorize(text: string, color: string): string {\n    if (!this.enableColors) return text;\n\n    const colors: Record<string, string> = {\n      reset: \"\\x1b[0m\",\n      red: \"\\x1b[31m\",\n      yellow: \"\\x1b[33m\",\n      blue: \"\\x1b[34m\",\n      gray: \"\\x1b[90m\",\n      magenta: \"\\x1b[35m\",\n    };\n\n    return `${colors[color] || \"\"}${text}${colors[\"reset\"]}`;\n  }\n\n  log(message: string, input?: LoggerInput): void {\n    this.info(message, input);\n  }\n\n  info(message: string, input?: LoggerInput): void {\n    const formatted = this.formatMessage(\"info\", message, input);\n    console.log(this.colorize(formatted, \"blue\"));\n  }\n\n  trace(message: string, input?: LoggerInput): void {\n    const formatted = this.formatMessage(\"trace\", message, input);\n    console.log(this.colorize(formatted, \"gray\"));\n  }\n\n  warn(message: string, input?: LoggerInput): void {\n    const formatted = this.formatMessage(\"warn\", message, input);\n    console.warn(this.colorize(formatted, \"yellow\"));\n  }\n\n  error(message: string, input?: LoggerInput): void {\n    const formatted = this.formatMessage(\"error\", message, input);\n    console.error(this.colorize(formatted, \"red\"));\n  }\n\n  fatal(message: string, input?: LoggerInput): void {\n    const formatted = this.formatMessage(\"fatal\", message, input);\n    console.error(this.colorize(formatted, \"magenta\"));\n  }\n}\n"]}

package/build/logs/adapters/pino-adapter.d.ts

@@ -0,0 +1,14 @@
+import pino from "pino";
+import type { LoggerAdapter, LoggerInput } from "../types";
+export declare class PinoLoggerAdapter implements LoggerAdapter {
+    private readonly pinoLogger;
+    constructor(config?: pino.LoggerOptions, destination?: pino.DestinationStream);
+    getPinoInstance(): pino.BaseLogger;
+    log(message: string, input?: LoggerInput): void;
+    info(message: string, input?: LoggerInput): void;
+    trace(message: string, input?: LoggerInput): void;
+    warn(message: string, input?: LoggerInput): void;
+    error(message: string, input?: LoggerInput): void;
+    fatal(message: string, input?: LoggerInput): void;
+}
+//# sourceMappingURL=pino-adapter.d.ts.map

package/build/logs/adapters/pino-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-adapter.d.ts","sourceRoot":"./src/","sources":["logs/adapters/pino-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM3D,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;gBAG3C,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAC3B,WAAW,CAAC,EAAE,IAAI,CAAC,iBAAiB;IAQtC,eAAe,IAAI,IAAI,CAAC,UAAU;IAIlC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAOhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAOjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAOhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IAOjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;CAMlD"}

package/build/logs/adapters/pino-adapter.js

@@ -0,0 +1,30 @@
+import pino from "pino";
+import { createPinoConfig } from "../config";
+export class PinoLoggerAdapter {
+    pinoLogger;
+    constructor(config, destination) {
+        this.pinoLogger = pino(config ?? createPinoConfig(), destination);
+    }
+    getPinoInstance() {
+        return this.pinoLogger;
+    }
+    log(message, input) {
+        this.info(message, input);
+    }
+    info(message, input) {
+        this.pinoLogger.info({ data: input?.data, details: input?.details }, message);
+    }
+    trace(message, input) {
+        this.pinoLogger.trace({ data: input?.data, details: input?.details }, message);
+    }
+    warn(message, input) {
+        this.pinoLogger.warn({ data: input?.data, details: input?.details }, message);
+    }
+    error(message, input) {
+        this.pinoLogger.error({ data: input?.data, details: input?.details }, message);
+    }
+    fatal(message, input) {
+        this.pinoLogger.fatal({ data: input?.data, details: input?.details }, message);
+    }
+}
+//# sourceMappingURL=pino-adapter.js.map

package/build/logs/adapters/pino-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-adapter.js","sourceRoot":"./src/","sources":["logs/adapters/pino-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAO7C,MAAM,OAAO,iBAAiB;IACX,UAAU,CAAkB;IAE7C,YACE,MAA2B,EAC3B,WAAoC;QAEpC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,EAAE,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;IAKD,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,KAAmB;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,KAAmB;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAClB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAC9C,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAmB;QACxC,IAAI,CAAC,UAAU,CAAC,KAAK,CACnB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAC9C,OAAO,CACR,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,KAAmB;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAClB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAC9C,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAmB;QACxC,IAAI,CAAC,UAAU,CAAC,KAAK,CACnB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAC9C,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAmB;QACxC,IAAI,CAAC,UAAU,CAAC,KAAK,CACnB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAC9C,OAAO,CACR,CAAC;IACJ,CAAC;CACF","sourcesContent":["import pino from \"pino\";\n\nimport { createPinoConfig } from \"../config\";\nimport type { LoggerAdapter, LoggerInput } from \"../types\";\n\n/**\n * Pino-based logger adapter for production microservices\n * providing structured, high-performance logging.\n */\nexport class PinoLoggerAdapter implements LoggerAdapter {\n  private readonly pinoLogger: pino.BaseLogger;\n\n  constructor(\n    config?: pino.LoggerOptions,\n    destination?: pino.DestinationStream,\n  ) {\n    this.pinoLogger = pino(config ?? createPinoConfig(), destination);\n  }\n\n  /**\n   * Get the underlying Pino logger instance for advanced usage\n   */\n  getPinoInstance(): pino.BaseLogger {\n    return this.pinoLogger;\n  }\n\n  log(message: string, input?: LoggerInput): void {\n    this.info(message, input);\n  }\n\n  info(message: string, input?: LoggerInput): void {\n    this.pinoLogger.info(\n      { data: input?.data, details: input?.details },\n      message,\n    );\n  }\n\n  trace(message: string, input?: LoggerInput): void {\n    this.pinoLogger.trace(\n      { data: input?.data, details: input?.details },\n      message,\n    );\n  }\n\n  warn(message: string, input?: LoggerInput): void {\n    this.pinoLogger.warn(\n      { data: input?.data, details: input?.details },\n      message,\n    );\n  }\n\n  error(message: string, input?: LoggerInput): void {\n    this.pinoLogger.error(\n      { data: input?.data, details: input?.details },\n      message,\n    );\n  }\n\n  fatal(message: string, input?: LoggerInput): void {\n    this.pinoLogger.fatal(\n      { data: input?.data, details: input?.details },\n      message,\n    );\n  }\n}\n"]}

package/build/logs/config.d.ts

@@ -0,0 +1,9 @@
+import type pino from "pino";
+export interface PinoConfigOptions {
+    env?: string;
+    serviceName?: string;
+    appVersion?: string;
+    appEnv?: string;
+}
+export declare const createPinoConfig: (options?: PinoConfigOptions) => pino.LoggerOptions;
+//# sourceMappingURL=config.d.ts.map

package/build/logs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"./src/","sources":["logs/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD,eAAO,MAAM,gBAAgB,GAC3B,UAAU,iBAAiB,KAC1B,IAAI,CAAC,aAoCP,CAAC"}

package/build/logs/config.js

@@ -0,0 +1,34 @@
+export const createPinoConfig = (options) => {
+    const env = options?.env ?? process.env["NODE_ENV"] ?? "development";
+    const isPretty = env !== "production";
+    const transport = isPretty
+        ? {
+            target: "pino-pretty",
+            options: {
+                colorize: true,
+            },
+        }
+        : undefined;
+    return {
+        level: process.env["LOG_LEVEL"] ?? "info",
+        ...(transport ? { transport } : {}),
+        formatters: {
+            bindings: (bindings) => {
+                return {
+                    pid: bindings["pid"],
+                    service: options?.serviceName ?? process.env["SERVICE_NAME"] ?? "zacatl",
+                    environment: env,
+                    app: {
+                        version: options?.appVersion ?? process.env["APP_VERSION"] ?? "0.0.0",
+                        environment: options?.appEnv ?? process.env["APP_ENV"] ?? env,
+                    },
+                    host: bindings["hostname"],
+                };
+            },
+            level: (label) => {
+                return { level: label.toLowerCase() };
+            },
+        },
+    };
+};
+//# sourceMappingURL=config.js.map

package/build/logs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"./src/","sources":["logs/config.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAA2B,EACP,EAAE;IACtB,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC;IACrE,MAAM,QAAQ,GAAG,GAAG,KAAK,YAAY,CAAC;IAEtC,MAAM,SAAS,GAAG,QAAQ;QACxB,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;aACf;SACF;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM;QACzC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,UAAU,EAAE;YACV,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACrB,OAAO;oBACL,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;oBACpB,OAAO,EACL,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,QAAQ;oBACjE,WAAW,EAAE,GAAG;oBAChB,GAAG,EAAE;wBACH,OAAO,EACL,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO;wBAC9D,WAAW,EAAE,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG;qBAC9D;oBACD,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC;iBAC3B,CAAC;YACJ,CAAC;YACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;gBACf,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,CAAC;SACF;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import type pino from \"pino\";\n\nexport interface PinoConfigOptions {\n  env?: string;\n  serviceName?: string;\n  appVersion?: string;\n  appEnv?: string;\n}\n\n/**\n * Default Pino logger configuration with sensible fallbacks.\n * - Uses pino-pretty in non-production environments for readability\n * - Emits structured JSON in production\n */\nexport const createPinoConfig = (\n  options?: PinoConfigOptions,\n): pino.LoggerOptions => {\n  const env = options?.env ?? process.env[\"NODE_ENV\"] ?? \"development\";\n  const isPretty = env !== \"production\";\n\n  const transport = isPretty\n    ? {\n        target: \"pino-pretty\",\n        options: {\n          colorize: true,\n        },\n      }\n    : undefined;\n\n  return {\n    level: process.env[\"LOG_LEVEL\"] ?? \"info\",\n    ...(transport ? { transport } : {}),\n    formatters: {\n      bindings: (bindings) => {\n        return {\n          pid: bindings[\"pid\"],\n          service:\n            options?.serviceName ?? process.env[\"SERVICE_NAME\"] ?? \"zacatl\",\n          environment: env,\n          app: {\n            version:\n              options?.appVersion ?? process.env[\"APP_VERSION\"] ?? \"0.0.0\",\n            environment: options?.appEnv ?? process.env[\"APP_ENV\"] ?? env,\n          },\n          host: bindings[\"hostname\"],\n        };\n      },\n      level: (label) => {\n        return { level: label.toLowerCase() };\n      },\n    },\n  };\n};\n"]}

package/build/logs/index.d.ts

@@ -0,0 +1,6 @@
+export { logger, createLogger } from "./logger";
+export type { Logger, LoggerAdapter, LoggerInput, LoggerAdapterType, PinoLoggerConfig, } from "./types";
+export { createPinoConfig, type PinoConfigOptions } from "./config";
+export { ConsoleLoggerAdapter } from "./adapters/console-adapter";
+export { PinoLoggerAdapter } from "./adapters/pino-adapter";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["logs/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}