stratal 0.0.1

package/dist/i18n/validation/validation.context.d.ts

@@ -0,0 +1,34 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { ErrorMapContext } from './validation.types';
+/**
+ * AsyncLocalStorage for storing request-scoped ErrorMapContext
+ * Allows error map to access I18nService without passing through function calls
+ */
+export declare const errorMapContextStorage: AsyncLocalStorage<ErrorMapContext>;
+/**
+ * Backend error map that accesses I18nService from AsyncLocalStorage
+ * Must be initialized in router middleware after locale detection
+ */
+export declare const backendErrorMap: import("zod").ZodErrorMap<import("zod/v4/core").$ZodIssue>;
+/**
+ * Runs a function within an error map context
+ * Used by router middleware to provide I18nService to validation
+ *
+ * @example
+ * ```typescript
+ * router.use('*', async (c, next) => {
+ *   const i18nService = c.get('i18nService')
+ *   const locale = c.get('locale')
+ *
+ *   return runWithErrorMapContext(
+ *     {
+ *       t: (key, params) => i18nService.t(key, params),
+ *       locale,
+ *     },
+ *     () => next()
+ *   )
+ * })
+ * ```
+ */
+export declare function runWithErrorMapContext<T>(context: ErrorMapContext, fn: () => T): T;
+//# sourceMappingURL=validation.context.d.ts.map

package/dist/i18n/validation/validation.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.context.d.ts","sourceRoot":"","sources":["../../../src/i18n/validation/validation.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGzD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,oCAA2C,CAAA;AAS9E;;;GAGG;AACH,eAAO,MAAM,eAAe,4DAAyC,CAAA;AAErE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH"}

package/dist/i18n/validation/validation.context.js

@@ -0,0 +1,42 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { createI18nErrorMap } from './validation.error-map';
+/**
+ * AsyncLocalStorage for storing request-scoped ErrorMapContext
+ * Allows error map to access I18nService without passing through function calls
+ */
+export const errorMapContextStorage = new AsyncLocalStorage();
+/**
+ * Gets the current error map context from AsyncLocalStorage
+ */
+function getErrorMapContext() {
+    return errorMapContextStorage.getStore();
+}
+/**
+ * Backend error map that accesses I18nService from AsyncLocalStorage
+ * Must be initialized in router middleware after locale detection
+ */
+export const backendErrorMap = createI18nErrorMap(getErrorMapContext);
+/**
+ * Runs a function within an error map context
+ * Used by router middleware to provide I18nService to validation
+ *
+ * @example
+ * ```typescript
+ * router.use('*', async (c, next) => {
+ *   const i18nService = c.get('i18nService')
+ *   const locale = c.get('locale')
+ *
+ *   return runWithErrorMapContext(
+ *     {
+ *       t: (key, params) => i18nService.t(key, params),
+ *       locale,
+ *     },
+ *     () => next()
+ *   )
+ * })
+ * ```
+ */
+export function runWithErrorMapContext(context, fn) {
+    return errorMapContextStorage.run(context, fn);
+}
+//# sourceMappingURL=validation.context.js.map

package/dist/i18n/validation/validation.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.context.js","sourceRoot":"","sources":["../../../src/i18n/validation/validation.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,iBAAiB,EAAmB,CAAA;AAE9E;;GAEG;AACH,SAAS,kBAAkB;IACzB,OAAO,sBAAsB,CAAC,QAAQ,EAAE,CAAA;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,CAAA;AAErE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwB,EACxB,EAAW;IAEX,OAAO,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AAChD,CAAC"}

package/dist/i18n/validation/validation.error-map.d.ts

@@ -0,0 +1,8 @@
+import type { $ZodErrorMap } from 'zod/v4/core';
+import type { ErrorMapContext } from './validation.types';
+/**
+ * Creates a Zod error map that uses i18n for translation
+ * Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)
+ */
+export declare function createI18nErrorMap(getContext: () => ErrorMapContext | undefined): $ZodErrorMap;
+//# sourceMappingURL=validation.error-map.d.ts.map

package/dist/i18n/validation/validation.error-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.error-map.d.ts","sourceRoot":"","sources":["../../../src/i18n/validation/validation.error-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAUb,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAqKzD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,SAAS,GAAG,YAAY,CAoB9F"}

package/dist/i18n/validation/validation.error-map.js

@@ -0,0 +1,158 @@
+/**
+ * Type guards for narrowing Zod v4 issue types
+ */
+function isInvalidType(issue) {
+    return issue.code === 'invalid_type';
+}
+function isTooBig(issue) {
+    return issue.code === 'too_big';
+}
+function isTooSmall(issue) {
+    return issue.code === 'too_small';
+}
+function isInvalidFormat(issue) {
+    return issue.code === 'invalid_format';
+}
+function isNotMultipleOf(issue) {
+    return issue.code === 'not_multiple_of';
+}
+function isUnrecognizedKeys(issue) {
+    return issue.code === 'unrecognized_keys';
+}
+function isInvalidUnion(issue) {
+    return issue.code === 'invalid_union';
+}
+function isInvalidKey(issue) {
+    return issue.code === 'invalid_key';
+}
+/**
+ * Maps Zod issue codes to zodI18n message keys
+ * Adapted for Zod v4's simpler issue code system
+ */
+function getMessageKey(issue) {
+    if (isInvalidType(issue)) {
+        if (issue.input === undefined) {
+            return 'zodI18n.errors.required';
+        }
+        return 'zodI18n.errors.invalid_type';
+    }
+    if (isTooSmall(issue)) {
+        const typeKey = issue.origin || 'string';
+        const exactKey = issue.exact
+            ? 'exact'
+            : issue.inclusive
+                ? 'inclusive'
+                : 'not_inclusive';
+        return `zodI18n.errors.too_small.${typeKey}.${exactKey}`;
+    }
+    if (isTooBig(issue)) {
+        const typeKey = issue.origin || 'string';
+        const exactKey = issue.exact
+            ? 'exact'
+            : issue.inclusive
+                ? 'inclusive'
+                : 'not_inclusive';
+        return `zodI18n.errors.too_big.${typeKey}.${exactKey}`;
+    }
+    if (isInvalidFormat(issue)) {
+        // Map v4's format to v3-style validation keys
+        return `zodI18n.errors.invalid_string.${issue.format}`;
+    }
+    if (isNotMultipleOf(issue)) {
+        return 'zodI18n.errors.not_multiple_of';
+    }
+    if (isUnrecognizedKeys(issue)) {
+        return 'zodI18n.errors.unrecognized_keys';
+    }
+    if (isInvalidUnion(issue)) {
+        return 'zodI18n.errors.invalid_union';
+    }
+    if (isInvalidKey(issue)) {
+        // v4: Replaces invalid_enum_value, invalid_literal
+        return 'zodI18n.errors.invalid_enum_value';
+    }
+    // invalid_element, invalid_value, or unknown codes
+    return 'zodI18n.errors.custom.default';
+}
+/**
+ * Extracts interpolation parameters from Zod issue
+ * Uses proper type narrowing for v4
+ */
+function getMessageParams(issue) {
+    const params = {};
+    if (isInvalidType(issue)) {
+        params.expected = issue.expected;
+        params.received = String(issue.input);
+        return params;
+    }
+    if (isUnrecognizedKeys(issue)) {
+        params.keys = issue.keys.join(', ');
+        return params;
+    }
+    if (isInvalidKey(issue)) {
+        // v4: For enums and records
+        // Since v4 doesn't have options field, we'll use generic message
+        return params;
+    }
+    if (isInvalidFormat(issue)) {
+        params.validation = issue.format;
+        // Check for specific string format issues with additional fields
+        if ('prefix' in issue) {
+            params.startsWith = issue.prefix;
+        }
+        if ('suffix' in issue) {
+            params.endsWith = issue.suffix;
+        }
+        if ('includes' in issue) {
+            params.includes = issue.includes;
+        }
+        if (issue.pattern) {
+            params.pattern = issue.pattern;
+        }
+        return params;
+    }
+    if (isTooSmall(issue)) {
+        params.minimum = issue.minimum;
+        params.type = issue.origin;
+        if (issue.origin === 'date') {
+            params.minimum = new Date(Number(issue.minimum)).toLocaleDateString();
+        }
+        return params;
+    }
+    if (isTooBig(issue)) {
+        params.maximum = issue.maximum;
+        params.type = issue.origin;
+        if (issue.origin === 'date') {
+            params.maximum = new Date(Number(issue.maximum)).toLocaleDateString();
+        }
+        return params;
+    }
+    if (isNotMultipleOf(issue)) {
+        params.multipleOf = issue.divisor;
+        return params;
+    }
+    return params;
+}
+/**
+ * Creates a Zod error map that uses i18n for translation
+ * Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)
+ */
+export function createI18nErrorMap(getContext) {
+    return (issue) => {
+        // Get message key and params for this issue
+        const messageKey = getMessageKey(issue);
+        const messageParams = getMessageParams(issue);
+        // Get translation context
+        const context = getContext();
+        if (!context) {
+            // Fallback: Use English messages directly
+            // This handles config validation at startup, tests, etc.
+            return { message: 'Invalid input' };
+        }
+        // Normal flow: Use context-aware i18n (respects user locale)
+        return {
+            message: context.t(messageKey, messageParams),
+        };
+    };
+}
+//# sourceMappingURL=validation.error-map.js.map

package/dist/i18n/validation/validation.error-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.error-map.js","sourceRoot":"","sources":["../../../src/i18n/validation/validation.error-map.ts"],"names":[],"mappings":"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"}

package/dist/i18n/validation/validation.types.d.ts

@@ -0,0 +1,44 @@
+import type { $ZodIssueCustom } from 'zod/v4/core';
+import type { MessageKeys } from '../i18n.types';
+/**
+ * Context provided to error map for locale-aware translation
+ */
+export interface ErrorMapContext {
+    /**
+     * Translate a message key with optional parameters
+     */
+    t: (key: MessageKeys, params?: Record<string, unknown>) => string;
+    /**
+     * Current locale code (e.g., 'en', 'fr')
+     */
+    locale: string;
+}
+/**
+ * Function that provides the current translation context
+ * Used by error maps to access request-scoped or application-wide i18n
+ */
+export type LocaleProvider = () => ErrorMapContext | undefined;
+/**
+ * Custom error metadata for withI18n helper
+ */
+export interface I18nErrorMetadata {
+    /**
+     * Message key for translation
+     */
+    key: MessageKeys;
+    /**
+     * Parameters for message interpolation
+     */
+    params?: Record<string, unknown>;
+}
+/**
+ * Zod custom issue with i18n metadata
+ * Uses Zod v4 native $ZodIssueCustom type
+ */
+export type ZodCustomIssue = $ZodIssueCustom & {
+    params?: {
+        i18n?: I18nErrorMetadata;
+        [key: string]: unknown;
+    };
+};
+//# sourceMappingURL=validation.types.d.ts.map

package/dist/i18n/validation/validation.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.types.d.ts","sourceRoot":"","sources":["../../../src/i18n/validation/validation.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;IAEjE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,eAAe,GAAG,SAAS,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,WAAW,CAAA;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,iBAAiB,CAAA;QACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF,CAAA"}

package/dist/i18n/validation/validation.types.js

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

package/dist/i18n/validation/validation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.types.js","sourceRoot":"","sources":["../../../src/i18n/validation/validation.types.ts"],"names":[],"mappings":""}

package/dist/i18n/validation/with-i18n.d.ts

@@ -0,0 +1,29 @@
+import type { MessageKeys } from '../i18n.types';
+/**
+ * Type-safe helper for creating custom Zod error messages with i18n support (Backend)
+ *
+ * Usage with .refine():
+ * ```typescript
+ * const schema = z.string().refine(
+ *   (val) => val.length > 5,
+ *   withI18n('validation.minLength', { min: 5 })
+ * )
+ * ```
+ *
+ * Usage with built-in validators:
+ * ```typescript
+ * const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))
+ * const schema = z.string().email(withI18n('validation.email'))
+ * ```
+ *
+ * Note: This is the backend version using AsyncLocalStorage.
+ * For frontend, use withI18nFrontend from the frontend validation module
+ *
+ * @param key - Message key from shared i18n messages (type-safe via MessageKeys)
+ * @param params - Optional interpolation parameters for the message
+ * @returns Zod error configuration object with translated message
+ */
+export declare function withI18n(key: MessageKeys, params?: Record<string, unknown>): {
+    error: () => string;
+};
+//# sourceMappingURL=with-i18n.d.ts.map

package/dist/i18n/validation/with-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-i18n.d.ts","sourceRoot":"","sources":["../../../src/i18n/validation/with-i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,CAezB"}

package/dist/i18n/validation/with-i18n.js

@@ -0,0 +1,40 @@
+import { errorMapContextStorage } from './validation.context';
+/**
+ * Type-safe helper for creating custom Zod error messages with i18n support (Backend)
+ *
+ * Usage with .refine():
+ * ```typescript
+ * const schema = z.string().refine(
+ *   (val) => val.length > 5,
+ *   withI18n('validation.minLength', { min: 5 })
+ * )
+ * ```
+ *
+ * Usage with built-in validators:
+ * ```typescript
+ * const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))
+ * const schema = z.string().email(withI18n('validation.email'))
+ * ```
+ *
+ * Note: This is the backend version using AsyncLocalStorage.
+ * For frontend, use withI18nFrontend from the frontend validation module
+ *
+ * @param key - Message key from shared i18n messages (type-safe via MessageKeys)
+ * @param params - Optional interpolation parameters for the message
+ * @returns Zod error configuration object with translated message
+ */
+export function withI18n(key, params) {
+    return {
+        error: () => {
+            // Get i18n context from AsyncLocalStorage (backend)
+            // This is set by the router middleware before validation
+            const context = errorMapContextStorage.getStore();
+            // Translate using context if available, otherwise fallback to generic message
+            const message = context
+                ? context.t(key, params)
+                : 'Invalid input';
+            return message;
+        },
+    };
+}
+//# sourceMappingURL=with-i18n.js.map

package/dist/i18n/validation/with-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-i18n.js","sourceRoot":"","sources":["../../../src/i18n/validation/with-i18n.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAgB,EAChB,MAAgC;IAEhC,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,oDAAoD;YACpD,yDAAyD;YACzD,MAAM,OAAO,GAAG,sBAAsB,CAAC,QAAQ,EAAE,CAAA;YAEjD,8EAA8E;YAC9E,MAAM,OAAO,GAAG,OAAO;gBACrB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAqD,CAAC;gBACvE,CAAC,CAAC,eAAe,CAAA;YAEnB,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import './polyfills';
+export * from './application';
+export * from './cache';
+export * from './config';
+export * from './cron';
+export * from './di';
+export * from './email';
+export * from './env';
+export * from './errors';
+export * from './i18n';
+export * from './infrastructure';
+export * from './logger';
+export * from './middleware';
+export * from './module';
+export * from './openapi';
+export * from './queue';
+export * from './router';
+export * from './guards';
+export * from './storage';
+export * from './types';
+export * from './worker';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,CAAA;AAEpB,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,MAAM,CAAA;AACpB,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+// Polyfills must be imported first, before any other modules
+import './polyfills';
+export * from './application';
+export * from './cache';
+export * from './config';
+export * from './cron';
+export * from './di';
+export * from './email';
+export * from './env';
+export * from './errors';
+export * from './i18n';
+export * from './infrastructure';
+export * from './logger';
+export * from './middleware';
+export * from './module';
+export * from './openapi';
+export * from './queue';
+export * from './router';
+export * from './guards';
+export * from './storage';
+export * from './types';
+export * from './worker';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,aAAa,CAAA;AAEpB,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,MAAM,CAAA;AACpB,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/infrastructure/error-handler/error-response.d.ts

@@ -0,0 +1,32 @@
+export type Environment = 'development' | 'staging' | 'production';
+export interface ErrorResponse {
+    /**
+     * Numeric error code for identification and escalation
+     * See error-codes.ts for the complete registry
+     */
+    code: number;
+    /**
+     * Human-readable error message
+     * Fixed per error type, not customizable
+     */
+    message: string;
+    /**
+     * ISO timestamp when the error occurred
+     */
+    timestamp: string;
+    /**
+     * Additional structured data about the error
+     * Only included in development environment
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Stack trace for debugging
+     * Only included in development environment
+     */
+    stack?: string;
+}
+/**
+ * Type guard to check if an object is an ErrorResponse
+ */
+export declare function isErrorResponse(obj: unknown): obj is ErrorResponse;
+//# sourceMappingURL=error-response.d.ts.map

package/dist/infrastructure/error-handler/error-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-response.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/error-response.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAA;AAElE,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAWlE"}

package/dist/infrastructure/error-handler/error-response.js

@@ -0,0 +1,14 @@
+/**
+ * Type guard to check if an object is an ErrorResponse
+ */
+export function isErrorResponse(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'code' in obj &&
+        typeof obj.code === 'number' &&
+        'message' in obj &&
+        typeof obj.message === 'string' &&
+        'timestamp' in obj &&
+        typeof obj.timestamp === 'string');
+}
+//# sourceMappingURL=error-response.js.map

package/dist/infrastructure/error-handler/error-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-response.js","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/error-response.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACb,OAAQ,GAAqB,CAAC,IAAI,KAAK,QAAQ;QAC/C,SAAS,IAAI,GAAG;QAChB,OAAQ,GAAqB,CAAC,OAAO,KAAK,QAAQ;QAClD,WAAW,IAAI,GAAG;QAClB,OAAQ,GAAqB,CAAC,SAAS,KAAK,QAAQ,CACrD,CAAA;AACH,CAAC"}

package/dist/infrastructure/error-handler/global-error-handler.d.ts

@@ -0,0 +1,81 @@
+import type { ErrorResponse } from './error-response';
+import { type StratalEnv } from '../../env';
+import type { II18nService } from '../../i18n/i18n.types';
+import { type LoggerService } from '../../logger';
+/**
+ * GlobalErrorHandler
+ *
+ * Centralized error handler registered in the DI container.
+ * Responsible for:
+ * - Intercepting all errors in the application
+ * - Logging errors with appropriate severity via Logger service
+ * - Translating error message keys using I18nService (when available)
+ * - Serializing errors for RPC transmission
+ * - Wrapping unexpected errors in InternalError
+ *
+ * **Translation Availability by Context:**
+ *
+ * ✅ **HTTP Requests**: Errors are fully translated
+ *    - GlobalErrorHandler resolved from request container
+ *    - I18nService available via AsyncLocalStorage with user's locale
+ *    - Full translation with parameter interpolation
+ *
+ * ✅ **Queue Processing**: Errors are fully translated
+ *    - Error handling executes inside AsyncLocalStorage scope
+ *    - Locale extracted from queue message metadata
+ *    - Request container created with mock RouterContext
+ *    - I18nService available with correct locale
+ *
+ * ⚠️ **RPC/Startup**: Message keys returned as-is (i18n unavailable)
+ *    - No request context available during service binding or startup
+ *    - No locale information available
+ *    - Frontend can translate message keys using its own i18n if needed
+ *    - This is expected behavior, not a bug
+ *
+ * **Implementation Note:**
+ * The `isAvailable()` check exists to gracefully handle RPC/startup contexts
+ * where no request container exists. For HTTP and Queue contexts, i18n is
+ * always available thanks to AsyncLocalStorage scope propagation. This follows
+ * the "Laravel philosophy" - transparent dependency injection for request contexts,
+ * with explicit handling only for legitimate non-request edge cases.
+ */
+export declare class GlobalErrorHandler {
+    private readonly logger;
+    private readonly i18n;
+    private readonly env;
+    private readonly environment;
+    constructor(logger: LoggerService, i18n: II18nService, env: StratalEnv);
+    /**
+     * Handle an error, log it, and serialize for response
+     *
+     * @param error - The error to handle
+     * @returns Serialized ErrorResponse for RPC transmission
+     */
+    handle(error: unknown): ErrorResponse;
+    /**
+     * Translate error message key using I18nService
+     * Uses error metadata as interpolation parameters
+     *
+     * No try/catch - if translation fails, it's a bug that should fail loudly
+     *
+     * **Note**: This method is only called when isAvailable() returns true,
+     * so the service is guaranteed to be resolved.
+     *
+     * @param error - ApplicationError with messageKey and metadata
+     * @returns Translated message string
+     */
+    private translateError;
+    /**
+     * Log an ApplicationError with appropriate severity
+     */
+    private log;
+    /**
+     * Log an unexpected error
+     */
+    private logUnexpectedError;
+    /**
+     * Determine log severity based on error code
+     */
+    private getSeverity;
+}
+//# sourceMappingURL=global-error-handler.d.ts.map

package/dist/infrastructure/error-handler/global-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-error-handler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/global-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGlE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAK3C,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,uBAAuB,CAAA;AACtE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAQhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,kBAAkB;IAGU,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAEtD,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAEe,MAAM,EAAE,aAAa,EACzB,IAAI,EAAE,YAAY,EAEnD,GAAG,EAAE,UAAU;IAKlC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IA0BrC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,GAAG;IAwBX;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAmBpB"}