stratal 0.0.1

package/dist/env.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cloudflare Worker Environment Bindings
+ *
+ * This interface defines the base environment bindings required by Stratal.
+ * Use TypeScript module augmentation to add your own application-specific bindings.
+ *
+ * @example
+ * ```typescript
+ * declare module 'stratal' {
+ *   interface StratalEnv {
+ *     DATABASE: D1Database
+ *     NOTIFICATIONS_QUEUE: Queue
+ *   }
+ * }
+ * ```
+ */
+export interface StratalEnv {
+    ENVIRONMENT: string;
+    CACHE: KVNamespace;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/env.js

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

package/dist/env.js.map

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

package/dist/errors/application-error.d.ts

@@ -0,0 +1,80 @@
+import type { Environment, ErrorResponse } from '../infrastructure/error-handler/error-response';
+import type { MessageKeys } from '../i18n';
+import type { ErrorCode } from './error-codes';
+/**
+ * ApplicationError
+ *
+ * Abstract base class for all application errors.
+ * This class should never be used directly - always extend it to create specific error types.
+ *
+ * Features:
+ * - Type-safe error codes from ERROR_CODES registry
+ * - Type-safe message keys from i18n module
+ * - Localized message keys (translated by GlobalErrorHandler)
+ * - Structured metadata for logging and interpolation
+ * - Proper Error prototype chain
+ * - Automatic timestamp generation
+ * - Serialization for RPC transmission
+ *
+ * Message Localization:
+ * - Each error class defines a message key (e.g., 'errors.userNotFound')
+ * - Metadata provides interpolation parameters (e.g., { userId: '123' })
+ * - GlobalErrorHandler translates the message key using I18nService before sending response
+ * - This ensures errors are localized based on the user's locale (from X-Locale header)
+ */
+export declare abstract class ApplicationError extends Error {
+    /**
+     * Type-safe error code from ERROR_CODES registry
+     * See error-codes.ts for the complete registry
+     */
+    readonly code: ErrorCode;
+    /**
+     * ISO timestamp when the error was created
+     */
+    readonly timestamp: string;
+    /**
+     * Additional structured data about the error
+     * Used for:
+     * 1. Logging and debugging
+     * 2. Message interpolation (e.g., { userId: '123', email: 'user@example.com' })
+     */
+    readonly metadata?: Record<string, unknown>;
+    /**
+     * @param messageKey - Type-safe i18n message key (e.g., 'errors.userNotFound')
+     * @param code - Type-safe error code from ERROR_CODES registry
+     * @param metadata - Optional data for logging and interpolation
+     */
+    constructor(messageKey: MessageKeys, code: ErrorCode, metadata?: Record<string, unknown>);
+    /**
+     * Filter metadata to include only user-facing properties
+     *
+     * User-facing properties (validation/constraint errors):
+     * - issues: Validation errors from SchemaValidationError
+     * - fields: Constraint violation fields
+     * - field: Single field constraint/foreign key
+     *
+     * Internal properties (excluded from response):
+     * - path, method: Route debugging
+     * - controllerName, reason: Controller errors
+     * - details, etc.: Internal debugging info
+     *
+     * @param metadata - Raw metadata object
+     * @returns Filtered metadata with only whitelisted properties
+     */
+    private static filterMetadata;
+    /**
+     * Serialize error to ErrorResponse format for RPC transmission
+     *
+     * @param env - Environment (development | production)
+     * @param translatedMessage - Optional translated message (from GlobalErrorHandler)
+     * @returns ErrorResponse object suitable for JSON serialization
+     */
+    toErrorResponse(env: Environment, translatedMessage?: string): ErrorResponse;
+    /**
+     * JSON serialization (used by JSON.stringify)
+     * Defaults to development mode for backward compatibility
+     * Note: This will use the untranslated message key - use GlobalErrorHandler for proper localization
+     */
+    toJSON(): ErrorResponse;
+}
+//# sourceMappingURL=application-error.d.ts.map

package/dist/errors/application-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-error.d.ts","sourceRoot":"","sources":["../../src/errors/application-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAA;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,gBAAiB,SAAQ,KAAK;IAClD;;;OAGG;IACH,SAAgB,IAAI,EAAE,SAAS,CAAA;IAE/B;;OAEG;IACH,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC;;;;;OAKG;IACH,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElD;;;;OAIG;gBAED,UAAU,EAAE,WAAW,EACvB,IAAI,EAAE,SAAS,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBpC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAsB7B;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,aAAa;IAY5E;;;;OAIG;IACH,MAAM,IAAI,aAAa;CAGxB"}

package/dist/errors/application-error.js

@@ -0,0 +1,118 @@
+/**
+ * ApplicationError
+ *
+ * Abstract base class for all application errors.
+ * This class should never be used directly - always extend it to create specific error types.
+ *
+ * Features:
+ * - Type-safe error codes from ERROR_CODES registry
+ * - Type-safe message keys from i18n module
+ * - Localized message keys (translated by GlobalErrorHandler)
+ * - Structured metadata for logging and interpolation
+ * - Proper Error prototype chain
+ * - Automatic timestamp generation
+ * - Serialization for RPC transmission
+ *
+ * Message Localization:
+ * - Each error class defines a message key (e.g., 'errors.userNotFound')
+ * - Metadata provides interpolation parameters (e.g., { userId: '123' })
+ * - GlobalErrorHandler translates the message key using I18nService before sending response
+ * - This ensures errors are localized based on the user's locale (from X-Locale header)
+ */
+export class ApplicationError extends Error {
+    /**
+     * Type-safe error code from ERROR_CODES registry
+     * See error-codes.ts for the complete registry
+     */
+    code;
+    /**
+     * ISO timestamp when the error was created
+     */
+    timestamp;
+    /**
+     * Additional structured data about the error
+     * Used for:
+     * 1. Logging and debugging
+     * 2. Message interpolation (e.g., { userId: '123', email: 'user@example.com' })
+     */
+    metadata;
+    /**
+     * @param messageKey - Type-safe i18n message key (e.g., 'errors.userNotFound')
+     * @param code - Type-safe error code from ERROR_CODES registry
+     * @param metadata - Optional data for logging and interpolation
+     */
+    constructor(messageKey, code, metadata) {
+        // Pass message key as the Error message (will be replaced with translated message in GlobalErrorHandler)
+        super(messageKey);
+        // Maintains proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.timestamp = new Date().toISOString();
+        this.metadata = metadata;
+        // Capture stack trace, excluding constructor call from it
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- captureStackTrace is V8-specific, not always present
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Filter metadata to include only user-facing properties
+     *
+     * User-facing properties (validation/constraint errors):
+     * - issues: Validation errors from SchemaValidationError
+     * - fields: Constraint violation fields
+     * - field: Single field constraint/foreign key
+     *
+     * Internal properties (excluded from response):
+     * - path, method: Route debugging
+     * - controllerName, reason: Controller errors
+     * - details, etc.: Internal debugging info
+     *
+     * @param metadata - Raw metadata object
+     * @returns Filtered metadata with only whitelisted properties
+     */
+    static filterMetadata(metadata) {
+        if (!metadata)
+            return undefined;
+        // Whitelist of user-facing metadata properties
+        const whitelist = ['issues', 'fields', 'field'];
+        const filtered = {};
+        let hasUserFacingData = false;
+        for (const key of whitelist) {
+            if (key in metadata && metadata[key] !== undefined) {
+                filtered[key] = metadata[key];
+                hasUserFacingData = true;
+            }
+        }
+        // Only return metadata if there's actual user-facing data
+        return hasUserFacingData ? filtered : undefined;
+    }
+    /**
+     * Serialize error to ErrorResponse format for RPC transmission
+     *
+     * @param env - Environment (development | production)
+     * @param translatedMessage - Optional translated message (from GlobalErrorHandler)
+     * @returns ErrorResponse object suitable for JSON serialization
+     */
+    toErrorResponse(env, translatedMessage) {
+        return {
+            code: this.code,
+            message: translatedMessage ?? this.message, // Use translated message if provided, otherwise fallback to messageKey
+            timestamp: this.timestamp,
+            // Include filtered user-facing metadata in all environments
+            metadata: ApplicationError.filterMetadata(this.metadata),
+            // Stack trace only in development for debugging
+            stack: env === 'development' ? this.stack : undefined,
+        };
+    }
+    /**
+     * JSON serialization (used by JSON.stringify)
+     * Defaults to development mode for backward compatibility
+     * Note: This will use the untranslated message key - use GlobalErrorHandler for proper localization
+     */
+    toJSON() {
+        return this.toErrorResponse('development');
+    }
+}
+//# sourceMappingURL=application-error.js.map

package/dist/errors/application-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-error.js","sourceRoot":"","sources":["../../src/errors/application-error.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,KAAK;IAClD;;;OAGG;IACa,IAAI,CAAW;IAE/B;;OAEG;IACa,SAAS,CAAQ;IAEjC;;;;;OAKG;IACa,QAAQ,CAA0B;IAElD;;;;OAIG;IACH,YACE,UAAuB,EACvB,IAAe,EACf,QAAkC;QAElC,yGAAyG;QACzG,KAAK,CAAC,UAAU,CAAC,CAAA;QAEjB,yDAAyD;QACzD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAEjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAExB,0DAA0D;QAC1D,+HAA+H;QAC/H,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACK,MAAM,CAAC,cAAc,CAC3B,QAAkC;QAElC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAA;QAE/B,+CAA+C;QAC/C,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;QAE/C,MAAM,QAAQ,GAA4B,EAAE,CAAA;QAC5C,IAAI,iBAAiB,GAAG,KAAK,CAAA;QAE7B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBACnD,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;gBAC7B,iBAAiB,GAAG,IAAI,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,0DAA0D;QAC1D,OAAO,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;IACjD,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,GAAgB,EAAE,iBAA0B;QAC1D,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,iBAAiB,IAAI,IAAI,CAAC,OAAO,EAAE,uEAAuE;YACnH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,4DAA4D;YAC5D,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxD,gDAAgD;YAChD,KAAK,EAAE,GAAG,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACtD,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;IAC5C,CAAC;CACF"}

package/dist/errors/error-codes.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Centralized Error Code Registry
+ *
+ * Error codes are organized by category with specific ranges:
+ * - 1000-1999: Validation errors
+ * - 2000-2999: Database errors (generic)
+ * - 3000-3999: Authentication & Authorization
+ * - 4000-4999: Resource errors
+ * - 5000-5999: Domain-specific business logic (per module)
+ * - 9000-9999: System/Internal errors
+ *   - 9000-9099: Router errors
+ *   - 9100-9199: Configuration errors
+ *   - 9200-9299: Infrastructure errors
+ *   - 9300-9399: I18n errors
+ */
+export declare const ERROR_CODES: {
+    /**
+     * Database Errors (2000-2999)
+     * Generic database errors thrown by Prisma client extensions
+     */
+    readonly DATABASE: {
+        /** Generic database error */
+        readonly GENERIC: 2000;
+        /** Record not found in database */
+        readonly RECORD_NOT_FOUND: 2001;
+        /** Unique constraint violation */
+        readonly UNIQUE_CONSTRAINT: 2002;
+        /** Foreign key constraint violation */
+        readonly FOREIGN_KEY_CONSTRAINT: 2003;
+        /** Database connection failed */
+        readonly CONNECTION_FAILED: 2004;
+        /** Database timeout */
+        readonly TIMEOUT: 2005;
+        /** Null constraint violation */
+        readonly NULL_CONSTRAINT: 2006;
+        /** Too many database connections */
+        readonly TOO_MANY_CONNECTIONS: 2007;
+        /** Transaction conflict or deadlock */
+        readonly TRANSACTION_CONFLICT: 2008;
+    };
+    /**
+     * Authentication Errors (3000-3099)
+     * Authentication-related failures
+     */
+    readonly AUTH: {
+        /** Invalid credentials provided */
+        readonly INVALID_CREDENTIALS: 3000;
+        /** Session expired or invalid */
+        readonly SESSION_EXPIRED: 3001;
+        /** Account locked or disabled */
+        readonly ACCOUNT_LOCKED: 3002;
+        /** Invalid or expired token */
+        readonly INVALID_TOKEN: 3003;
+        /** Context not initialized */
+        readonly CONTEXT_NOT_INITIALIZED: 3004;
+        /** User not authenticated */
+        readonly USER_NOT_AUTHENTICATED: 3005;
+        /** Tenant context not set */
+        readonly TENANT_NOT_SET: 3006;
+        /** Email verification required before login */
+        readonly EMAIL_NOT_VERIFIED: 3007;
+        /** Password doesn't meet minimum length */
+        readonly PASSWORD_TOO_SHORT: 3008;
+        /** Password exceeds maximum length */
+        readonly PASSWORD_TOO_LONG: 3009;
+        /** Account with email already exists */
+        readonly ACCOUNT_ALREADY_EXISTS: 3010;
+        /** User creation failed */
+        readonly FAILED_TO_CREATE_USER: 3011;
+        /** Session creation failed */
+        readonly FAILED_TO_CREATE_SESSION: 3012;
+        /** User update failed */
+        readonly FAILED_TO_UPDATE_USER: 3013;
+        /** Social account already linked */
+        readonly SOCIAL_ACCOUNT_LINKED: 3014;
+        /** Last account cannot be unlinked */
+        readonly CANNOT_UNLINK_LAST_ACCOUNT: 3015;
+    };
+    /**
+     * Authorization Errors (3100-3199)
+     * Permission and access control failures
+     */
+    readonly AUTHZ: {
+        /** Insufficient permissions */
+        readonly FORBIDDEN: 3100;
+        /** Resource access denied */
+        readonly ACCESS_DENIED: 3101;
+        /** User lacks required role */
+        readonly INSUFFICIENT_PERMISSIONS: 3102;
+    };
+    /**
+     * Resource Errors (4000-4999)
+     * Generic resource-related errors
+     */
+    readonly RESOURCE: {
+        /** Generic resource not found */
+        readonly NOT_FOUND: 4000;
+        /** Route/endpoint not found */
+        readonly ROUTE_NOT_FOUND: 4004;
+        /** Resource conflict or duplicate */
+        readonly CONFLICT: 4100;
+        /** Resource already exists */
+        readonly ALREADY_EXISTS: 4101;
+    };
+    /**
+     * Validation Errors (1000-1999)
+     * Input validation failures
+     */
+    readonly VALIDATION: {
+        /** Generic validation error */
+        readonly GENERIC: 1000;
+        /** Required field missing */
+        readonly REQUIRED_FIELD: 1001;
+        /** Invalid format */
+        readonly INVALID_FORMAT: 1002;
+        /** Schema validation failed */
+        readonly SCHEMA_VALIDATION: 1003;
+        /** Request validation failed (OpenAPI, etc.) */
+        readonly REQUEST_VALIDATION: 1004;
+    };
+    /**
+     * Router Errors (9000-9099)
+     * Router and controller-related INTERNAL errors
+     */
+    readonly ROUTER: {
+        /** Controller registration error */
+        readonly CONTROLLER_REGISTRATION_ERROR: 9005;
+        /** Controller method not found */
+        readonly CONTROLLER_METHOD_NOT_FOUND: 9006;
+        /** OpenAPI route registration failed */
+        readonly OPENAPI_ROUTE_REGISTRATION: 9008;
+    };
+    /**
+     * I18n Errors (9300-9399)
+     * Internationalization and localization errors
+     */
+    readonly I18N: {
+        /** Translation key missing from all locales */
+        readonly TRANSLATION_MISSING: 9300;
+        /** Requested locale not supported */
+        readonly LOCALE_NOT_SUPPORTED: 9301;
+    };
+    /**
+     * System Errors (9000-9999)
+     * Internal system errors and unexpected failures
+     */
+    readonly SYSTEM: {
+        /** Internal server error */
+        readonly INTERNAL_ERROR: 9000;
+        /** Generic configuration error */
+        readonly CONFIGURATION_ERROR: 9100;
+        /** ConfigService not initialized */
+        readonly CONFIG_NOT_INITIALIZED: 9101;
+        /** Module already registered */
+        readonly MODULE_ALREADY_REGISTERED: 9102;
+        /** Circular module dependency detected */
+        readonly MODULE_CIRCULAR_DEPENDENCY: 9103;
+        /** Module dependency not found */
+        readonly MODULE_DEPENDENCY_NOT_FOUND: 9104;
+        /** Invalid error code range */
+        readonly INVALID_ERROR_CODE_RANGE: 9105;
+        /** Invalid module provider configuration */
+        readonly INVALID_MODULE_PROVIDER: 9106;
+        /** Generic infrastructure error */
+        readonly INFRASTRUCTURE_ERROR: 9200;
+        /** Execution context not initialized */
+        readonly EXECUTION_CONTEXT_NOT_INITIALIZED: 9201;
+        /** Request container not initialized */
+        readonly REQUEST_CONTAINER_NOT_INITIALIZED: 9202;
+        /** Queue binding not found */
+        readonly QUEUE_BINDING_NOT_FOUND: 9203;
+        /** Cron job execution failed */
+        readonly CRON_EXECUTION_FAILED: 9204;
+        /** Queue provider not supported */
+        readonly QUEUE_PROVIDER_NOT_SUPPORTED: 9205;
+    };
+};
+/**
+ * Recursively extract all leaf values from a nested object type
+ * Similar to DeepKeys but extracts values instead of keys
+ *
+ * Example:
+ *   { DATABASE: { GENERIC: 2000, NOT_FOUND: 2001 }, AUTH: { INVALID: 3000 } }
+ *   becomes
+ *   2000 | 2001 | 3000
+ */
+type DeepValues<T> = T extends object ? {
+    [K in keyof T]: DeepValues<T[K]>;
+}[keyof T] : T;
+/**
+ * Type helper to extract all error code values
+ * Union type of all numeric error codes defined in ERROR_CODES
+ *
+ * Type: 2000 | 2001 | 2002 | ... | 9203
+ */
+export type ErrorCode = DeepValues<typeof ERROR_CODES>;
+export {};
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/errors/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,WAAW;IACtB;;;OAGG;;QAED,6BAA6B;;QAE7B,mCAAmC;;QAEnC,kCAAkC;;QAElC,uCAAuC;;QAEvC,iCAAiC;;QAEjC,uBAAuB;;QAEvB,gCAAgC;;QAEhC,oCAAoC;;QAEpC,uCAAuC;;;IAIzC;;;OAGG;;QAED,mCAAmC;;QAEnC,iCAAiC;;QAEjC,iCAAiC;;QAEjC,+BAA+B;;QAE/B,8BAA8B;;QAE9B,6BAA6B;;QAE7B,6BAA6B;;QAE7B,+CAA+C;;QAE/C,2CAA2C;;QAE3C,sCAAsC;;QAEtC,wCAAwC;;QAExC,2BAA2B;;QAE3B,8BAA8B;;QAE9B,yBAAyB;;QAEzB,oCAAoC;;QAEpC,sCAAsC;;;IAIxC;;;OAGG;;QAED,+BAA+B;;QAE/B,6BAA6B;;QAE7B,+BAA+B;;;IAIjC;;;OAGG;;QAED,iCAAiC;;QAEjC,+BAA+B;;QAE/B,qCAAqC;;QAErC,8BAA8B;;;IAIhC;;;OAGG;;QAED,+BAA+B;;QAE/B,6BAA6B;;QAE7B,qBAAqB;;QAErB,+BAA+B;;QAE/B,gDAAgD;;;IAIlD;;;OAGG;;QAED,oCAAoC;;QAEpC,kCAAkC;;QAElC,wCAAwC;;;IAI1C;;;OAGG;;QAED,+CAA+C;;QAE/C,qCAAqC;;;IAIvC;;;OAGG;;QAED,4BAA4B;;QAI5B,kCAAkC;;QAElC,oCAAoC;;QAEpC,gCAAgC;;QAEhC,0CAA0C;;QAE1C,kCAAkC;;QAElC,+BAA+B;;QAE/B,4CAA4C;;QAI5C,mCAAmC;;QAEnC,wCAAwC;;QAExC,wCAAwC;;QAExC,8BAA8B;;QAE9B,gCAAgC;;QAEhC,mCAAmC;;;CAG7B,CAAA;AAEV;;;;;;;;GAQG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACjC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,GAC7C,CAAC,CAAA;AAEL;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/errors/error-codes.js

@@ -0,0 +1,180 @@
+/**
+ * Centralized Error Code Registry
+ *
+ * Error codes are organized by category with specific ranges:
+ * - 1000-1999: Validation errors
+ * - 2000-2999: Database errors (generic)
+ * - 3000-3999: Authentication & Authorization
+ * - 4000-4999: Resource errors
+ * - 5000-5999: Domain-specific business logic (per module)
+ * - 9000-9999: System/Internal errors
+ *   - 9000-9099: Router errors
+ *   - 9100-9199: Configuration errors
+ *   - 9200-9299: Infrastructure errors
+ *   - 9300-9399: I18n errors
+ */
+export const ERROR_CODES = {
+    /**
+     * Database Errors (2000-2999)
+     * Generic database errors thrown by Prisma client extensions
+     */
+    DATABASE: {
+        /** Generic database error */
+        GENERIC: 2000,
+        /** Record not found in database */
+        RECORD_NOT_FOUND: 2001,
+        /** Unique constraint violation */
+        UNIQUE_CONSTRAINT: 2002,
+        /** Foreign key constraint violation */
+        FOREIGN_KEY_CONSTRAINT: 2003,
+        /** Database connection failed */
+        CONNECTION_FAILED: 2004,
+        /** Database timeout */
+        TIMEOUT: 2005,
+        /** Null constraint violation */
+        NULL_CONSTRAINT: 2006,
+        /** Too many database connections */
+        TOO_MANY_CONNECTIONS: 2007,
+        /** Transaction conflict or deadlock */
+        TRANSACTION_CONFLICT: 2008,
+    },
+    /**
+     * Authentication Errors (3000-3099)
+     * Authentication-related failures
+     */
+    AUTH: {
+        /** Invalid credentials provided */
+        INVALID_CREDENTIALS: 3000,
+        /** Session expired or invalid */
+        SESSION_EXPIRED: 3001,
+        /** Account locked or disabled */
+        ACCOUNT_LOCKED: 3002,
+        /** Invalid or expired token */
+        INVALID_TOKEN: 3003,
+        /** Context not initialized */
+        CONTEXT_NOT_INITIALIZED: 3004,
+        /** User not authenticated */
+        USER_NOT_AUTHENTICATED: 3005,
+        /** Tenant context not set */
+        TENANT_NOT_SET: 3006,
+        /** Email verification required before login */
+        EMAIL_NOT_VERIFIED: 3007,
+        /** Password doesn't meet minimum length */
+        PASSWORD_TOO_SHORT: 3008,
+        /** Password exceeds maximum length */
+        PASSWORD_TOO_LONG: 3009,
+        /** Account with email already exists */
+        ACCOUNT_ALREADY_EXISTS: 3010,
+        /** User creation failed */
+        FAILED_TO_CREATE_USER: 3011,
+        /** Session creation failed */
+        FAILED_TO_CREATE_SESSION: 3012,
+        /** User update failed */
+        FAILED_TO_UPDATE_USER: 3013,
+        /** Social account already linked */
+        SOCIAL_ACCOUNT_LINKED: 3014,
+        /** Last account cannot be unlinked */
+        CANNOT_UNLINK_LAST_ACCOUNT: 3015,
+    },
+    /**
+     * Authorization Errors (3100-3199)
+     * Permission and access control failures
+     */
+    AUTHZ: {
+        /** Insufficient permissions */
+        FORBIDDEN: 3100,
+        /** Resource access denied */
+        ACCESS_DENIED: 3101,
+        /** User lacks required role */
+        INSUFFICIENT_PERMISSIONS: 3102,
+    },
+    /**
+     * Resource Errors (4000-4999)
+     * Generic resource-related errors
+     */
+    RESOURCE: {
+        /** Generic resource not found */
+        NOT_FOUND: 4000,
+        /** Route/endpoint not found */
+        ROUTE_NOT_FOUND: 4004,
+        /** Resource conflict or duplicate */
+        CONFLICT: 4100,
+        /** Resource already exists */
+        ALREADY_EXISTS: 4101,
+    },
+    /**
+     * Validation Errors (1000-1999)
+     * Input validation failures
+     */
+    VALIDATION: {
+        /** Generic validation error */
+        GENERIC: 1000,
+        /** Required field missing */
+        REQUIRED_FIELD: 1001,
+        /** Invalid format */
+        INVALID_FORMAT: 1002,
+        /** Schema validation failed */
+        SCHEMA_VALIDATION: 1003,
+        /** Request validation failed (OpenAPI, etc.) */
+        REQUEST_VALIDATION: 1004,
+    },
+    /**
+     * Router Errors (9000-9099)
+     * Router and controller-related INTERNAL errors
+     */
+    ROUTER: {
+        /** Controller registration error */
+        CONTROLLER_REGISTRATION_ERROR: 9005,
+        /** Controller method not found */
+        CONTROLLER_METHOD_NOT_FOUND: 9006,
+        /** OpenAPI route registration failed */
+        OPENAPI_ROUTE_REGISTRATION: 9008,
+    },
+    /**
+     * I18n Errors (9300-9399)
+     * Internationalization and localization errors
+     */
+    I18N: {
+        /** Translation key missing from all locales */
+        TRANSLATION_MISSING: 9300,
+        /** Requested locale not supported */
+        LOCALE_NOT_SUPPORTED: 9301,
+    },
+    /**
+     * System Errors (9000-9999)
+     * Internal system errors and unexpected failures
+     */
+    SYSTEM: {
+        /** Internal server error */
+        INTERNAL_ERROR: 9000,
+        // Configuration Errors (9100-9199)
+        /** Generic configuration error */
+        CONFIGURATION_ERROR: 9100,
+        /** ConfigService not initialized */
+        CONFIG_NOT_INITIALIZED: 9101,
+        /** Module already registered */
+        MODULE_ALREADY_REGISTERED: 9102,
+        /** Circular module dependency detected */
+        MODULE_CIRCULAR_DEPENDENCY: 9103,
+        /** Module dependency not found */
+        MODULE_DEPENDENCY_NOT_FOUND: 9104,
+        /** Invalid error code range */
+        INVALID_ERROR_CODE_RANGE: 9105,
+        /** Invalid module provider configuration */
+        INVALID_MODULE_PROVIDER: 9106,
+        // Infrastructure Errors (9200-9299)
+        /** Generic infrastructure error */
+        INFRASTRUCTURE_ERROR: 9200,
+        /** Execution context not initialized */
+        EXECUTION_CONTEXT_NOT_INITIALIZED: 9201,
+        /** Request container not initialized */
+        REQUEST_CONTAINER_NOT_INITIALIZED: 9202,
+        /** Queue binding not found */
+        QUEUE_BINDING_NOT_FOUND: 9203,
+        /** Cron job execution failed */
+        CRON_EXECUTION_FAILED: 9204,
+        /** Queue provider not supported */
+        QUEUE_PROVIDER_NOT_SUPPORTED: 9205,
+    },
+};
+//# sourceMappingURL=error-codes.js.map

package/dist/errors/error-codes.js.map

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

package/dist/errors/get-http-status.d.ts

@@ -0,0 +1,12 @@
+import type { ContentfulStatusCode } from 'hono/utils/http-status';
+/**
+ * Maps error codes to HTTP status codes
+ *
+ * This utility is used by the frontend to set appropriate HTTP status codes
+ * when returning errors from API routes.
+ *
+ * @param code - Numeric error code from ERROR_CODES registry
+ * @returns HTTP status code (200-599)
+ */
+export declare function getHttpStatus(code: number): ContentfulStatusCode;
+//# sourceMappingURL=get-http-status.d.ts.map

package/dist/errors/get-http-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-http-status.d.ts","sourceRoot":"","sources":["../../src/errors/get-http-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGlE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAwDhE"}