stratal 0.0.1

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

@@ -0,0 +1,178 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { DI_TOKENS } from '../../di';
+import { Transient } from '../../di/decorators';
+import { isApplicationError } from '../../errors';
+import { I18N_TOKENS } from '../../i18n/i18n.tokens';
+import { LOGGER_TOKENS } from '../../logger';
+import { InternalError } from './internal-error';
+/**
+ * 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.
+ */
+let GlobalErrorHandler = class GlobalErrorHandler {
+    logger;
+    i18n;
+    env;
+    environment;
+    constructor(logger, i18n, env) {
+        this.logger = logger;
+        this.i18n = i18n;
+        this.env = env;
+        this.environment = this.env.ENVIRONMENT;
+    }
+    /**
+     * Handle an error, log it, and serialize for response
+     *
+     * @param error - The error to handle
+     * @returns Serialized ErrorResponse for RPC transmission
+     */
+    handle(error) {
+        // Check if it's an ApplicationError
+        if (isApplicationError(error)) {
+            this.log(error);
+            // Translate message
+            // Works in: HTTP requests, Queue processing (i18n available via request container)
+            // Falls back in: RPC/Startup (i18n might not be available)
+            const translatedMessage = this.translateError(error);
+            return error.toErrorResponse(this.environment, translatedMessage);
+        }
+        // Unexpected error - wrap in InternalError
+        this.logUnexpectedError(error);
+        const internalError = new InternalError({
+            originalError: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        });
+        const translatedMessage = this.translateError(internalError);
+        return internalError.toErrorResponse(this.environment, translatedMessage);
+    }
+    /**
+     * 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
+     */
+    translateError(error) {
+        // Cast metadata to MessageParams (assuming values are string | number)
+        const params = error.metadata;
+        return this.i18n.t(error.message, params);
+    }
+    /**
+     * Log an ApplicationError with appropriate severity
+     */
+    log(error) {
+        const severity = this.getSeverity(error.code);
+        const logData = {
+            code: error.code,
+            message: this.translateError(error),
+            timestamp: error.timestamp,
+            metadata: error.metadata,
+            name: error.name,
+        };
+        switch (severity) {
+            case 'error':
+                this.logger.error('[ApplicationError]', logData);
+                break;
+            case 'warn':
+                this.logger.warn('[ApplicationError]', logData);
+                break;
+            case 'info':
+                this.logger.info('[ApplicationError]', logData);
+                break;
+        }
+    }
+    /**
+     * Log an unexpected error
+     */
+    logUnexpectedError(error) {
+        this.logger.error('[UnexpectedError]', {
+            error: error instanceof Error ? {
+                message: error.message,
+                stack: error.stack,
+                name: error.name,
+            } : String(error),
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Determine log severity based on error code
+     */
+    getSeverity(code) {
+        // System errors (9000+) are critical
+        if (code >= 9000)
+            return 'error';
+        // Database errors (2000-2999) are errors
+        if (code >= 2000 && code < 3000)
+            return 'error';
+        // Business logic errors (5000-5999) are warnings
+        if (code >= 5000 && code < 6000)
+            return 'warn';
+        // Validation errors (1000-1999) are info
+        if (code >= 1000 && code < 2000)
+            return 'info';
+        // Auth/Resource errors (3000-4999) are warnings
+        if (code >= 3000 && code < 5000)
+            return 'warn';
+        // Default to error
+        return 'error';
+    }
+};
+GlobalErrorHandler = __decorate([
+    Transient(),
+    __param(0, inject(LOGGER_TOKENS.LoggerService)),
+    __param(1, inject(I18N_TOKENS.I18nService)),
+    __param(2, inject(DI_TOKENS.CloudflareEnv)),
+    __metadata("design:paramtypes", [Function, Object, Object])
+], GlobalErrorHandler);
+export { GlobalErrorHandler };
+//# sourceMappingURL=global-error-handler.js.map

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

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

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

@@ -0,0 +1,6 @@
+export { ApplicationError, ERROR_CODES, getHttpStatus } from '../../errors';
+export type { ErrorCode } from '../../errors';
+export * from './error-response';
+export * from './global-error-handler';
+export * from './internal-error';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC3E,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA"}

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

@@ -0,0 +1,5 @@
+export { ApplicationError, ERROR_CODES, getHttpStatus } from '../../errors';
+export * from './error-response';
+export * from './global-error-handler';
+export * from './internal-error';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE3E,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA"}

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

@@ -0,0 +1,16 @@
+import { ApplicationError } from '.';
+/**
+ * InternalError
+ *
+ * Represents an unexpected internal server error.
+ * Used to wrap unknown errors that don't fit into specific error categories.
+ *
+ * This error is thrown when:
+ * - An unexpected exception occurs
+ * - An error type is not recognized
+ * - A system-level failure happens
+ */
+export declare class InternalError extends ApplicationError {
+    constructor(metadata?: Record<string, unknown>);
+}
+//# sourceMappingURL=internal-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/internal-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,GAAG,CAAA;AAEpC;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO/C"}

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

@@ -0,0 +1,19 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '.';
+/**
+ * InternalError
+ *
+ * Represents an unexpected internal server error.
+ * Used to wrap unknown errors that don't fit into specific error categories.
+ *
+ * This error is thrown when:
+ * - An unexpected exception occurs
+ * - An error type is not recognized
+ * - A system-level failure happens
+ */
+export class InternalError extends ApplicationError {
+    constructor(metadata) {
+        super('errors.internalError', ERROR_CODES.SYSTEM.INTERNAL_ERROR, metadata);
+    }
+}
+//# sourceMappingURL=internal-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal-error.js","sourceRoot":"","sources":["../../../src/infrastructure/error-handler/internal-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,GAAG,CAAA;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAc,SAAQ,gBAAgB;IACjD,YAAY,QAAkC;QAC5C,KAAK,CACH,sBAAsB,EACtB,WAAW,CAAC,MAAM,CAAC,cAAc,EACjC,QAAQ,CACT,CAAA;IACH,CAAC;CACF"}

package/dist/infrastructure/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './request-container-not-initialized.error';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAA"}

package/dist/infrastructure/errors/index.js

@@ -0,0 +1,2 @@
+export * from './request-container-not-initialized.error';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAA"}

package/dist/infrastructure/errors/request-container-not-initialized.error.d.ts

@@ -0,0 +1,12 @@
+import { ApplicationError } from '../error-handler';
+/**
+ * RequestContainerNotInitializedError
+ *
+ * Thrown when attempting to access the request-scoped container before it has been initialized.
+ * This typically indicates that the RouterService middleware hasn't run yet,
+ * or the router context is being accessed outside of a request lifecycle.
+ */
+export declare class RequestContainerNotInitializedError extends ApplicationError {
+    constructor();
+}
+//# sourceMappingURL=request-container-not-initialized.error.d.ts.map

package/dist/infrastructure/errors/request-container-not-initialized.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-container-not-initialized.error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/errors/request-container-not-initialized.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;;;GAMG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;;CAOxE"}

package/dist/infrastructure/errors/request-container-not-initialized.error.js

@@ -0,0 +1,15 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../error-handler';
+/**
+ * RequestContainerNotInitializedError
+ *
+ * Thrown when attempting to access the request-scoped container before it has been initialized.
+ * This typically indicates that the RouterService middleware hasn't run yet,
+ * or the router context is being accessed outside of a request lifecycle.
+ */
+export class RequestContainerNotInitializedError extends ApplicationError {
+    constructor() {
+        super('errors.requestContainerNotInitialized', ERROR_CODES.SYSTEM.REQUEST_CONTAINER_NOT_INITIALIZED);
+    }
+}
+//# sourceMappingURL=request-container-not-initialized.error.js.map

package/dist/infrastructure/errors/request-container-not-initialized.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-container-not-initialized.error.js","sourceRoot":"","sources":["../../../src/infrastructure/errors/request-container-not-initialized.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,OAAO,mCAAoC,SAAQ,gBAAgB;IACvE;QACE,KAAK,CACH,uCAAuC,EACvC,WAAW,CAAC,MAAM,CAAC,iCAAiC,CACrD,CAAA;IACH,CAAC;CACF"}

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,3 @@
+export * from './error-handler';
+export * from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA"}

package/dist/infrastructure/index.js

@@ -0,0 +1,3 @@
+export * from './error-handler';
+export * from './errors';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA"}

package/dist/logger/contracts/index.d.ts

@@ -0,0 +1,4 @@
+export * from './log-level';
+export * from './log-context';
+export * from './log-entry';
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/dist/logger/contracts/index.js

@@ -0,0 +1,4 @@
+export * from './log-level';
+export * from './log-context';
+export * from './log-entry';
+//# sourceMappingURL=index.js.map

package/dist/logger/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/dist/logger/contracts/log-context.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Structured metadata attached to log entries
+ * Supports arbitrary key-value pairs for context enrichment
+ */
+export type LogContext = Record<string, unknown>;
+/**
+ * Internal context automatically added by LoggerService
+ * Contains tenant info, request metadata, etc.
+ */
+export interface InternalLogContext extends LogContext {
+    tenantId?: string;
+    domain?: string;
+    userId?: string;
+    timestamp: number;
+}
+//# sourceMappingURL=log-context.d.ts.map

package/dist/logger/contracts/log-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-context.d.ts","sourceRoot":"","sources":["../../../src/logger/contracts/log-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/logger/contracts/log-context.js

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

package/dist/logger/contracts/log-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-context.js","sourceRoot":"","sources":["../../../src/logger/contracts/log-context.ts"],"names":[],"mappings":""}

package/dist/logger/contracts/log-entry.d.ts

@@ -0,0 +1,17 @@
+import type { LogLevel } from './log-level';
+import type { InternalLogContext } from './log-context';
+/**
+ * Complete log entry structure passed to transports
+ * Combines message, level, and enriched context
+ */
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    context: InternalLogContext;
+    error?: {
+        message: string;
+        stack?: string;
+        name?: string;
+    };
+}
+//# sourceMappingURL=log-entry.d.ts.map

package/dist/logger/contracts/log-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-entry.d.ts","sourceRoot":"","sources":["../../../src/logger/contracts/log-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,kBAAkB,CAAA;IAC3B,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF"}

package/dist/logger/contracts/log-entry.js

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

package/dist/logger/contracts/log-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-entry.js","sourceRoot":"","sources":["../../../src/logger/contracts/log-entry.ts"],"names":[],"mappings":""}

package/dist/logger/contracts/log-level.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Log severity levels
+ * Ordered from least to most severe
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Map log levels to numeric priorities (for filtering)
+ * Higher numbers = more severe = higher priority
+ */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+//# sourceMappingURL=log-level.d.ts.map

package/dist/logger/contracts/log-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.d.ts","sourceRoot":"","sources":["../../../src/logger/contracts/log-level.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAKvD,CAAA"}

package/dist/logger/contracts/log-level.js

@@ -0,0 +1,22 @@
+/**
+ * Log severity levels
+ * Ordered from least to most severe
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Map log levels to numeric priorities (for filtering)
+ * Higher numbers = more severe = higher priority
+ */
+export const LOG_LEVEL_PRIORITY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARN]: 2,
+    [LogLevel.ERROR]: 3,
+};
+//# sourceMappingURL=log-level.js.map

package/dist/logger/contracts/log-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.js","sourceRoot":"","sources":["../../../src/logger/contracts/log-level.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;CACpB,CAAA"}

package/dist/logger/formatters/formatter.interface.d.ts

@@ -0,0 +1,14 @@
+import type { LogEntry } from '../contracts';
+/**
+ * Formatter contract
+ * Transforms LogEntry into string representation for transport output
+ */
+export interface ILogFormatter {
+    /**
+     * Format log entry into string
+     * @param entry - Complete log entry with context
+     * @returns Formatted string ready for transport
+     */
+    format(entry: LogEntry): string;
+}
+//# sourceMappingURL=formatter.interface.d.ts.map

package/dist/logger/formatters/formatter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.interface.d.ts","sourceRoot":"","sources":["../../../src/logger/formatters/formatter.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAA;CAChC"}

package/dist/logger/formatters/formatter.interface.js

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

package/dist/logger/formatters/formatter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.interface.js","sourceRoot":"","sources":["../../../src/logger/formatters/formatter.interface.ts"],"names":[],"mappings":""}

package/dist/logger/formatters/index.d.ts

@@ -0,0 +1,4 @@
+export * from './formatter.interface';
+export * from './json-formatter';
+export * from './pretty-formatter';
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/formatters/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA"}

package/dist/logger/formatters/index.js

@@ -0,0 +1,4 @@
+export * from './formatter.interface';
+export * from './json-formatter';
+export * from './pretty-formatter';
+//# sourceMappingURL=index.js.map

package/dist/logger/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/formatters/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA"}

package/dist/logger/formatters/json-formatter.d.ts

@@ -0,0 +1,22 @@
+import type { LogEntry } from '../contracts';
+import type { ILogFormatter } from './formatter.interface';
+/**
+ * JSON Formatter
+ *
+ * Produces structured JSON logs for production environments.
+ * Optimized for log aggregation systems (Cloudflare Analytics, Datadog, etc.)
+ *
+ * Output format:
+ * {
+ *   "level": "info",
+ *   "message": "User logged in",
+ *   "timestamp": 1234567890,
+ *   "tenantId": "tenant_123",
+ *   "userId": "user_456",
+ *   "error": { "message": "...", "stack": "..." }
+ * }
+ */
+export declare class JsonFormatter implements ILogFormatter {
+    format(entry: LogEntry): string;
+}
+//# sourceMappingURL=json-formatter.d.ts.map

package/dist/logger/formatters/json-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-formatter.d.ts","sourceRoot":"","sources":["../../../src/logger/formatters/json-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;CAUhC"}

package/dist/logger/formatters/json-formatter.js

@@ -0,0 +1,28 @@
+/**
+ * JSON Formatter
+ *
+ * Produces structured JSON logs for production environments.
+ * Optimized for log aggregation systems (Cloudflare Analytics, Datadog, etc.)
+ *
+ * Output format:
+ * {
+ *   "level": "info",
+ *   "message": "User logged in",
+ *   "timestamp": 1234567890,
+ *   "tenantId": "tenant_123",
+ *   "userId": "user_456",
+ *   "error": { "message": "...", "stack": "..." }
+ * }
+ */
+export class JsonFormatter {
+    format(entry) {
+        const output = {
+            level: entry.level,
+            message: entry.message,
+            ...entry.context,
+            ...(entry.error && { error: entry.error }),
+        };
+        return JSON.stringify(output);
+    }
+}
+//# sourceMappingURL=json-formatter.js.map

package/dist/logger/formatters/json-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-formatter.js","sourceRoot":"","sources":["../../../src/logger/formatters/json-formatter.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,KAAe;QACpB,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,KAAK,CAAC,OAAO;YAChB,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;SAC3C,CAAA;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC/B,CAAC;CACF"}

package/dist/logger/formatters/pretty-formatter.d.ts

@@ -0,0 +1,19 @@
+import type { LogEntry } from '../contracts';
+import type { ILogFormatter } from './formatter.interface';
+/**
+ * Pretty Formatter
+ *
+ * Human-readable colored output for development environments.
+ * Uses ANSI color codes for terminal output.
+ *
+ * Output format:
+ * [2024-01-15 10:30:45] INFO: User logged in
+ *   tenantId: tenant_123
+ *   userId: user_456
+ */
+export declare class PrettyFormatter implements ILogFormatter {
+    private readonly colors;
+    private readonly reset;
+    format(entry: LogEntry): string;
+}
+//# sourceMappingURL=pretty-formatter.d.ts.map

package/dist/logger/formatters/pretty-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-formatter.d.ts","sourceRoot":"","sources":["../../../src/logger/formatters/pretty-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAKtB;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAElC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;CAyBhC"}

package/dist/logger/formatters/pretty-formatter.js

@@ -0,0 +1,42 @@
+import { LogLevel } from '../contracts';
+/**
+ * Pretty Formatter
+ *
+ * Human-readable colored output for development environments.
+ * Uses ANSI color codes for terminal output.
+ *
+ * Output format:
+ * [2024-01-15 10:30:45] INFO: User logged in
+ *   tenantId: tenant_123
+ *   userId: user_456
+ */
+export class PrettyFormatter {
+    colors = {
+        [LogLevel.DEBUG]: '\x1b[36m', // Cyan
+        [LogLevel.INFO]: '\x1b[32m', // Green
+        [LogLevel.WARN]: '\x1b[33m', // Yellow
+        [LogLevel.ERROR]: '\x1b[31m', // Red
+    };
+    reset = '\x1b[0m';
+    format(entry) {
+        const color = this.colors[entry.level];
+        const timestamp = new Date(entry.context.timestamp).toISOString();
+        const levelStr = entry.level.toUpperCase().padEnd(5);
+        let output = `${color}[${timestamp}] ${levelStr}${this.reset}: ${entry.message}`;
+        // Add context (exclude timestamp)
+        const { timestamp: _, ...contextWithoutTimestamp } = entry.context;
+        const contextEntries = Object.entries(contextWithoutTimestamp);
+        if (contextEntries.length > 0) {
+            output += '\n';
+            contextEntries.forEach(([key, value]) => {
+                output += `  ${key}: ${JSON.stringify(value)}\n`;
+            });
+        }
+        // Add error stack if present
+        if (entry.error?.stack) {
+            output += `\n${entry.error.stack}\n`;
+        }
+        return output.trimEnd();
+    }
+}
+//# sourceMappingURL=pretty-formatter.js.map