stratal 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Stratal Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# stratal
+
+A modular Cloudflare Workers framework with dependency injection, queue-based events, and type-safe configuration.
+
+For full documentation and examples, see the [main README](../../README.md).
+
+## Installation
+
+```bash
+npm install stratal
+# or
+yarn add stratal
+```
+
+### Optional dependencies
+
+Stratal keeps heavy integrations optional. Install only what you need:
+
+```bash
+# Storage (S3-compatible)
+npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner
+
+# Email (Resend provider)
+npm install resend react react-dom @react-email/components
+
+# Email (SMTP provider)
+npm install nodemailer
+
+# File uploads (TUS protocol)
+npm install @tus/server
+```
+
+## Sub-path Exports
+
+Import specific modules for better tree-shaking:
+
+```typescript
+import { Application } from 'stratal'           // Core
+import { Container } from 'stratal/di'           // DI container
+import { RouterService } from 'stratal/router'   // Routing
+import { z } from 'stratal/validation'            // Zod + OpenAPI
+import { ApplicationError } from 'stratal/errors' // Error types
+import { I18nModule } from 'stratal/i18n'         // Internationalization
+import { CacheModule } from 'stratal/cache'       // Caching
+import { LoggerService } from 'stratal/logger'    // Logging
+```
+
+## License
+
+MIT

package/dist/application.d.ts

@@ -0,0 +1,118 @@
+import 'reflect-metadata';
+import { Container } from './di/container';
+import { type StratalEnv } from './env';
+import { LogLevel } from './logger';
+import type { DynamicModule, ModuleClass } from './module/types';
+import { type RouterContext } from './router';
+export interface ApplicationConfig {
+    /** Root application module */
+    module: ModuleClass | DynamicModule;
+    /** Logging configuration. Defaults: level=INFO, formatter='json' */
+    logging?: {
+        level?: LogLevel;
+        formatter?: 'json' | 'pretty';
+    };
+}
+/**
+ * Application
+ *
+ * Main application class managing the two-tier container hierarchy:
+ * - Global Container: All services (singletons via tsyringe native)
+ * - Request Container: Child of global, context-enriched instances per request
+ *
+ * **Architecture:**
+ * ```
+ * Container (manages global container internally)
+ *        ↓
+ *   All services registered via container.register()
+ *   (auto-detects scope from decorators)
+ *        ↓
+ * Request Container (child, per request)
+ *        ↓
+ *   Context-enriched instances via
+ *   container.runInRequestScope() or container.createRequestScope()
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const app = new Application(env, ctx, config)
+ * await app.initialize()
+ *
+ * // Access container via getter
+ * const service = app.container.resolve(MY_TOKEN)
+ *
+ * // Handle HTTP request (via RouterService middleware)
+ * // Handle queue batch
+ * await app.handleQueue(batch, 'my-queue')
+ * ```
+ */
+export declare class Application {
+    readonly env: StratalEnv;
+    readonly ctx: ExecutionContext;
+    private readonly appConfig;
+    /**
+     * Unified Container - manages all DI operations
+     * Use app.container to access registration and resolution methods
+     */
+    private _container;
+    private moduleRegistry;
+    private consumerRegistry;
+    private cronManager;
+    private initialized;
+    constructor(env: StratalEnv, ctx: ExecutionContext, appConfig: ApplicationConfig);
+    /**
+     * Get the Container instance
+     *
+     * Use for service registration and resolution:
+     * - app.container.register(ServiceClass)
+     * - app.container.resolve(TOKEN)
+     * - app.container.runInRequestScope(ctx, callback)
+     */
+    get container(): Container;
+    initialize(): Promise<void>;
+    /**
+     * Resolve a service from the container
+     *
+     * @param token - DI token for the service
+     * @returns Resolved service instance
+     */
+    resolve<T>(token: symbol): T;
+    /**
+     * Handle queue batch processing
+     *
+     * Creates a request scope with mock RouterContext and processes the batch.
+     * Queue name is passed for logging purposes; routing is by message type.
+     */
+    handleQueue(batch: MessageBatch, queueName: string): Promise<void>;
+    /**
+     * Handle scheduled cron trigger
+     */
+    handleScheduled(controller: ScheduledController): Promise<void>;
+    /**
+     * Create mock RouterContext for queue/cron/seeder processing
+     *
+     * Use this when you need to create a request scope outside of HTTP context.
+     *
+     * @param locale - Locale for i18n (default: 'en')
+     * @returns Mock RouterContext suitable for runInRequestScope
+     */
+    createMockRouterContext(locale?: string): RouterContext;
+    shutdown(): Promise<void>;
+    private registerRoutes;
+    private registerQueueConsumers;
+    private registerCronJobs;
+    /**
+     * Register LoggerService and dependencies
+     */
+    private registerLoggerService;
+    /**
+     * Register core services with explicit scope
+     *
+     * Scope is specified at registration time:
+     * - Singleton: Single instance shared globally
+     * - Request: New instance per request (container-scoped)
+     * - Transient: New instance per resolution (default)
+     */
+    private registerCoreServices;
+}
+//# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAMzB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAA;AAGvC,OAAO,EAAiE,QAAQ,EAAmB,MAAM,UAAU,CAAA;AAEnH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAMhE,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AAG7F,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,MAAM,EAAE,WAAW,GAAG,aAAa,CAAA;IACnC,oEAAoE;IACpE,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,QAAQ,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAC9B,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,WAAW;IAapB,QAAQ,CAAC,GAAG,EAAE,UAAU;IACxB,QAAQ,CAAC,GAAG,EAAE,gBAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAd5B;;;OAGG;IACH,OAAO,CAAC,UAAU,CAAW;IAE7B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAQ;gBAGhB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,gBAAgB,EACb,SAAS,EAAE,iBAAiB;IAwB/C;;;;;;;OAOG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCjC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC;IAU5B;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxE;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAerE;;;;;;;OAOG;IACH,uBAAuB,CAAC,MAAM,SAAO,GAAG,aAAa;IAQ/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CAO7B"}

package/dist/application.js

@@ -0,0 +1,247 @@
+import 'reflect-metadata';
+import { container as tsyringeRootContainer } from 'tsyringe';
+import { CacheModule } from './cache';
+import { CronManager } from './cron/cron-manager';
+import { Container } from './di/container';
+import { DI_TOKENS } from './di/tokens';
+import { I18nModule } from './i18n/i18n.module';
+import { GlobalErrorHandler } from './infrastructure/error-handler';
+import { ConsoleTransport, JsonFormatter, LOGGER_TOKENS, LoggerService, LogLevel, PrettyFormatter } from './logger';
+import { ModuleRegistry } from './module/module-registry';
+import { OpenAPIModule } from './openapi';
+import { QueueModule } from './queue/queue.module';
+import { ROUTER_TOKENS, RouterService } from './router';
+/**
+ * Application
+ *
+ * Main application class managing the two-tier container hierarchy:
+ * - Global Container: All services (singletons via tsyringe native)
+ * - Request Container: Child of global, context-enriched instances per request
+ *
+ * **Architecture:**
+ * ```
+ * Container (manages global container internally)
+ *        ↓
+ *   All services registered via container.register()
+ *   (auto-detects scope from decorators)
+ *        ↓
+ * Request Container (child, per request)
+ *        ↓
+ *   Context-enriched instances via
+ *   container.runInRequestScope() or container.createRequestScope()
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const app = new Application(env, ctx, config)
+ * await app.initialize()
+ *
+ * // Access container via getter
+ * const service = app.container.resolve(MY_TOKEN)
+ *
+ * // Handle HTTP request (via RouterService middleware)
+ * // Handle queue batch
+ * await app.handleQueue(batch, 'my-queue')
+ * ```
+ */
+export class Application {
+    env;
+    ctx;
+    appConfig;
+    /**
+     * Unified Container - manages all DI operations
+     * Use app.container to access registration and resolution methods
+     */
+    _container;
+    moduleRegistry;
+    consumerRegistry;
+    cronManager;
+    initialized = false;
+    constructor(env, ctx, appConfig) {
+        this.env = env;
+        this.ctx = ctx;
+        this.appConfig = appConfig;
+        // Create unified Container with explicit child container
+        this._container = new Container({
+            env,
+            ctx,
+            container: tsyringeRootContainer.createChildContainer()
+        });
+        // Register Application instance
+        this._container.registerValue(DI_TOKENS.Application, this);
+        // Register core infrastructure inline
+        this.registerLoggerService();
+        this.registerCoreServices();
+        // Create ModuleRegistry with our Container
+        const logger = this._container.resolve(LOGGER_TOKENS.LoggerService);
+        this.moduleRegistry = new ModuleRegistry(this._container, logger);
+        // Register ModuleRegistry in container so modules can access it in onInitialize
+        this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry);
+    }
+    /**
+     * Get the Container instance
+     *
+     * Use for service registration and resolution:
+     * - app.container.register(ServiceClass)
+     * - app.container.resolve(TOKEN)
+     * - app.container.runInRequestScope(ctx, callback)
+     */
+    get container() {
+        return this._container;
+    }
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        // Phase 1: Register core infrastructure modules (internal)
+        this.moduleRegistry.registerAll([
+            I18nModule,
+            OpenAPIModule, // Before RouterService configuration
+            QueueModule, // Before EmailModule which uses queues
+            CacheModule,
+        ]);
+        // Phase 2: Register user's root module (traverses imports)
+        this.moduleRegistry.register(this.appConfig.module);
+        // Phase 3: Initialize all modules
+        await this.moduleRegistry.initialize();
+        // Phase 4: Resolve managers from container
+        this.consumerRegistry = this._container.resolve(DI_TOKENS.ConsumerRegistry);
+        this.cronManager = this._container.resolve(DI_TOKENS.Cron);
+        // Phase 5: Register RouterService
+        this._container.registerSingleton(ROUTER_TOKENS.RouterService, RouterService);
+        // Phase 6: Configure routes, queues, and cron jobs
+        this.registerRoutes();
+        this.registerQueueConsumers();
+        this.registerCronJobs();
+        this.initialized = true;
+    }
+    /**
+     * Resolve a service from the container
+     *
+     * @param token - DI token for the service
+     * @returns Resolved service instance
+     */
+    resolve(token) {
+        try {
+            return this._container.resolve(token);
+        }
+        catch (error) {
+            const errorHandler = this._container.resolve(DI_TOKENS.ErrorHandler);
+            const errorResponse = errorHandler.handle(error);
+            throw errorResponse;
+        }
+    }
+    /**
+     * Handle queue batch processing
+     *
+     * Creates a request scope with mock RouterContext and processes the batch.
+     * Queue name is passed for logging purposes; routing is by message type.
+     */
+    async handleQueue(batch, queueName) {
+        // Extract locale from first message in batch
+        const firstMessage = batch.messages[0]?.body;
+        const locale = firstMessage?.metadata?.locale ?? 'en';
+        // Create mock RouterContext for queue context
+        const mockRouterContext = this.createMockRouterContext(locale);
+        // Process batch within request scope
+        await this._container.runInRequestScope(mockRouterContext, async () => {
+            try {
+                const queueManager = this._container.resolve(DI_TOKENS.Queue);
+                await queueManager.processBatch(queueName, batch);
+            }
+            catch (error) {
+                const errorHandler = this._container.resolve(DI_TOKENS.ErrorHandler);
+                errorHandler.handle(error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Handle scheduled cron trigger
+     */
+    async handleScheduled(controller) {
+        const locale = 'en';
+        const mockRouterContext = this.createMockRouterContext(locale);
+        await this._container.runInRequestScope(mockRouterContext, async () => {
+            try {
+                await this.cronManager.executeScheduled(controller);
+            }
+            catch (error) {
+                const errorHandler = this._container.resolve(DI_TOKENS.ErrorHandler);
+                errorHandler.handle(error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Create mock RouterContext for queue/cron/seeder processing
+     *
+     * Use this when you need to create a request scope outside of HTTP context.
+     *
+     * @param locale - Locale for i18n (default: 'en')
+     * @returns Mock RouterContext suitable for runInRequestScope
+     */
+    createMockRouterContext(locale = 'en') {
+        return {
+            getLocale: () => locale,
+            setLocale: () => { },
+            getContainer: () => this._container,
+        };
+    }
+    async shutdown() {
+        await this.moduleRegistry.shutdown();
+        await this._container.dispose();
+    }
+    registerRoutes() {
+        const middlewareConfigs = this.moduleRegistry.getAllMiddlewareConfigs();
+        const controllers = this.moduleRegistry.getAllControllers();
+        const router = this._container.resolve(ROUTER_TOKENS.RouterService);
+        router.configure(middlewareConfigs, controllers);
+    }
+    registerQueueConsumers() {
+        for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {
+            const consumer = this._container.resolve(ConsumerClass);
+            this.consumerRegistry.register(consumer);
+        }
+    }
+    registerCronJobs() {
+        for (const JobClass of this.moduleRegistry.getAllJobs()) {
+            const job = this._container.resolve(JobClass);
+            this.cronManager.registerJob(job);
+        }
+    }
+    /**
+     * Register LoggerService and dependencies
+     */
+    registerLoggerService() {
+        // Get logging config with defaults
+        const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO;
+        const formatter = this.appConfig.logging?.formatter ?? 'json';
+        // Register log level for injection
+        this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel);
+        // Conditional formatter registration
+        this._container
+            .when(() => formatter === 'pretty')
+            .use(LOGGER_TOKENS.Formatter)
+            .give(PrettyFormatter)
+            .otherwise(JsonFormatter);
+        this._container.registerSingleton(LOGGER_TOKENS.ConsoleTransport, ConsoleTransport);
+        this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)]);
+        this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService);
+    }
+    /**
+     * Register core services with explicit scope
+     *
+     * Scope is specified at registration time:
+     * - Singleton: Single instance shared globally
+     * - Request: New instance per request (container-scoped)
+     * - Transient: New instance per resolution (default)
+     */
+    registerCoreServices() {
+        // Cron manager - singleton
+        this._container.registerSingleton(DI_TOKENS.Cron, CronManager);
+        // Error handler - transient (fresh instance each time with current I18n)
+        this._container.register(DI_TOKENS.ErrorHandler, GlobalErrorHandler);
+    }
+}
+//# sourceMappingURL=application.js.map

package/dist/application.js.map

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

package/dist/cache/cache.module.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cache Module
+ *
+ * Provides key-value caching capabilities using Cloudflare KV namespaces.
+ *
+ * **Features:**
+ * - Type-safe KV wrapper with full method coverage
+ * - Multiple KV binding support via `withBinding()`
+ * - Automatic error handling with security-focused logging
+ * - Singleton service for optimal performance
+ */
+export declare class CacheModule {
+}
+//# sourceMappingURL=cache.module.d.ts.map

package/dist/cache/cache.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.module.d.ts","sourceRoot":"","sources":["../../src/cache/cache.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,qBAMa,WAAW;CAAG"}

package/dist/cache/cache.module.js

@@ -0,0 +1,32 @@
+/**
+ * Cache Module
+ *
+ * Provides key-value caching capabilities using Cloudflare KV namespaces.
+ *
+ * **Features:**
+ * - Type-safe KV wrapper with full method coverage
+ * - Multiple KV binding support via `withBinding()`
+ * - Automatic error handling with security-focused logging
+ * - Singleton service for optimal performance
+ */
+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;
+};
+import { Module } from '../module';
+import { CACHE_TOKENS } from './cache.tokens';
+import { CacheService } from './services';
+let CacheModule = class CacheModule {
+};
+CacheModule = __decorate([
+    Module({
+        providers: [
+            // Singleton - CacheService has no request dependencies
+            { provide: CACHE_TOKENS.CacheService, useClass: CacheService },
+        ],
+    })
+], CacheModule);
+export { CacheModule };
+//# sourceMappingURL=cache.module.js.map

package/dist/cache/cache.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.module.js","sourceRoot":"","sources":["../../src/cache/cache.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;;;;;;;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAQlC,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,WAAW;IANvB,MAAM,CAAC;QACN,SAAS,EAAE;YACT,uDAAuD;YACvD,EAAE,OAAO,EAAE,YAAY,CAAC,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE;SAC/D;KACF,CAAC;GACW,WAAW,CAAG"}

package/dist/cache/cache.tokens.d.ts

@@ -0,0 +1,5 @@
+export declare const CACHE_TOKENS: {
+    readonly CacheService: symbol;
+};
+export type CacheToken = (typeof CACHE_TOKENS)[keyof typeof CACHE_TOKENS];
+//# sourceMappingURL=cache.tokens.d.ts.map

package/dist/cache/cache.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.tokens.d.ts","sourceRoot":"","sources":["../../src/cache/cache.tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;CAEf,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAA"}

package/dist/cache/cache.tokens.js

@@ -0,0 +1,4 @@
+export const CACHE_TOKENS = {
+    CacheService: Symbol.for('CacheService'),
+};
+//# sourceMappingURL=cache.tokens.js.map

package/dist/cache/cache.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.tokens.js","sourceRoot":"","sources":["../../src/cache/cache.tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;CAChC,CAAA"}

package/dist/cache/errors/cache-delete.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache delete operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ * Only the key is included in the user-facing error message.
+ */
+export declare class CacheDeleteError extends ApplicationError {
+    constructor(key: string);
+}
+//# sourceMappingURL=cache-delete.error.d.ts.map

package/dist/cache/errors/cache-delete.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-delete.error.d.ts","sourceRoot":"","sources":["../../../src/cache/errors/cache-delete.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,GAAG,EAAE,MAAM;CAGxB"}

package/dist/cache/errors/cache-delete.error.js

@@ -0,0 +1,14 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache delete operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ * Only the key is included in the user-facing error message.
+ */
+export class CacheDeleteError extends ApplicationError {
+    constructor(key) {
+        super('errors.cache.deleteFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key });
+    }
+}
+//# sourceMappingURL=cache-delete.error.js.map

package/dist/cache/errors/cache-delete.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-delete.error.js","sourceRoot":"","sources":["../../../src/cache/errors/cache-delete.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,YAAY,GAAW;QACrB,KAAK,CAAC,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IACtF,CAAC;CACF"}

package/dist/cache/errors/cache-get.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache get operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ * Only the key is included in the user-facing error message.
+ */
+export declare class CacheGetError extends ApplicationError {
+    constructor(key: string);
+}
+//# sourceMappingURL=cache-get.error.d.ts.map

package/dist/cache/errors/cache-get.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-get.error.d.ts","sourceRoot":"","sources":["../../../src/cache/errors/cache-get.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,GAAG,EAAE,MAAM;CAGxB"}

package/dist/cache/errors/cache-get.error.js

@@ -0,0 +1,14 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache get operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ * Only the key is included in the user-facing error message.
+ */
+export class CacheGetError extends ApplicationError {
+    constructor(key) {
+        super('errors.cache.getFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key });
+    }
+}
+//# sourceMappingURL=cache-get.error.js.map

package/dist/cache/errors/cache-get.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-get.error.js","sourceRoot":"","sources":["../../../src/cache/errors/cache-get.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,gBAAgB;IACjD,YAAY,GAAW;QACrB,KAAK,CAAC,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IACnF,CAAC;CACF"}

package/dist/cache/errors/cache-list.error.d.ts

@@ -0,0 +1,10 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache list operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ */
+export declare class CacheListError extends ApplicationError {
+    constructor();
+}
+//# sourceMappingURL=cache-list.error.d.ts.map

package/dist/cache/errors/cache-list.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-list.error.d.ts","sourceRoot":"","sources":["../../../src/cache/errors/cache-list.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;;CAInD"}

package/dist/cache/errors/cache-list.error.js

@@ -0,0 +1,13 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache list operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ */
+export class CacheListError extends ApplicationError {
+    constructor() {
+        super('errors.cache.listFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, {});
+    }
+}
+//# sourceMappingURL=cache-list.error.js.map

package/dist/cache/errors/cache-list.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-list.error.js","sourceRoot":"","sources":["../../../src/cache/errors/cache-list.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAClD;QACE,KAAK,CAAC,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAC/E,CAAC;CACF"}

package/dist/cache/errors/cache-put.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * Error thrown when a cache put operation fails
+ *
+ * Raw error details are logged via LoggerService for security.
+ * Only the key is included in the user-facing error message.
+ */
+export declare class CachePutError extends ApplicationError {
+    constructor(key: string);
+}
+//# sourceMappingURL=cache-put.error.d.ts.map

package/dist/cache/errors/cache-put.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-put.error.d.ts","sourceRoot":"","sources":["../../../src/cache/errors/cache-put.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,GAAG,EAAE,MAAM;CAGxB"}