stratal 0.0.1

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

@@ -0,0 +1,14 @@
+import { ERROR_CODES } from '../../errors';
+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 class CachePutError extends ApplicationError {
+    constructor(key) {
+        super('errors.cache.putFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key });
+    }
+}
+//# sourceMappingURL=cache-put.error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-put.error.js","sourceRoot":"","sources":["../../../src/cache/errors/cache-put.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/index.d.ts

@@ -0,0 +1,5 @@
+export * from './cache-get.error';
+export * from './cache-put.error';
+export * from './cache-delete.error';
+export * from './cache-list.error';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA"}

package/dist/cache/errors/index.js

@@ -0,0 +1,5 @@
+export * from './cache-get.error';
+export * from './cache-put.error';
+export * from './cache-delete.error';
+export * from './cache-list.error';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA"}

package/dist/cache/index.d.ts

@@ -0,0 +1,5 @@
+export * from './cache.module';
+export * from './cache.tokens';
+export * from './errors';
+export * from './services';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA"}

package/dist/cache/index.js

@@ -0,0 +1,5 @@
+export * from './cache.module';
+export * from './cache.tokens';
+export * from './errors';
+export * from './services';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA"}

package/dist/cache/services/cache.service.d.ts

@@ -0,0 +1,152 @@
+import { type StratalEnv } from '../../env';
+import { type LoggerService } from '../../logger';
+/**
+ * Cache Service
+ *
+ * Type-safe wrapper around Cloudflare KV namespaces for caching operations.
+ *
+ * **Features:**
+ * - Mirrors all KVNamespace methods with full type safety
+ * - Supports multiple KV bindings via `withBinding()`
+ * - Automatic error handling with logging
+ * - Security: Raw errors are logged, not exposed to users
+ *
+ * **Usage:**
+ * ```typescript
+ * class MyService {
+ *   private readonly uploadsCache: CacheService
+ *
+ *   constructor(
+ *     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,
+ *     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env
+ *   ) {
+ *     // Initialize specialized caches in constructor
+ *     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)
+ *   }
+ *
+ *   async cacheData(key: string, value: string) {
+ *     await this.cache.put(key, value, { expirationTtl: 3600 })
+ *     await this.uploadsCache.put(`upload:${key}`, value)
+ *   }
+ * }
+ * ```
+ *
+ * @see https://developers.cloudflare.com/kv/api/
+ */
+export declare class CacheService {
+    private readonly env;
+    private readonly logger;
+    private kv;
+    constructor(env: StratalEnv, logger: LoggerService);
+    /**
+     * Set the KV namespace binding
+     *
+     * Used internally by `withBinding()` to configure different KV instances.
+     *
+     * @param kv - KV namespace to use
+     */
+    setKV(kv: KVNamespace): void;
+    /**
+     * Create a new CacheService instance with a different KV binding
+     *
+     * **Pattern:** Returns a new instance (immutable)
+     *
+     * **Best Practice:** Initialize specialized caches as class properties in constructor
+     *
+     * @example
+     * ```typescript
+     * class MyService {
+     *   private readonly uploadsCache: CacheService
+     *   private readonly systemCache: CacheService
+     *
+     *   constructor(
+     *     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,
+     *     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env
+     *   ) {
+     *     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)
+     *     this.systemCache = this.cache.withBinding(this.env.SYSTEM_CONFIG_KV)
+     *   }
+     * }
+     * ```
+     *
+     * @param kv - KV namespace to use
+     * @returns New CacheService instance with the specified binding
+     */
+    withBinding(kv: KVNamespace): CacheService;
+    /**
+     * Get a value from cache
+     *
+     * @param key - Cache key
+     * @param typeOrOptions - Type string or options object (defaults to 'text')
+     * @returns Value in specified type, or null if not found
+     * @throws {CacheGetError} If operation fails
+     */
+    get(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<string | null>;
+    get<ExpectedValue = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<ExpectedValue | null>;
+    get(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<ArrayBuffer | null>;
+    get(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<ReadableStream | null>;
+    /**
+     * Get a value with metadata from cache
+     *
+     * @param key - Cache key
+     * @param typeOrOptions - Type string or options object (defaults to 'text')
+     * @returns Object with value, metadata, and cacheStatus
+     * @throws {CacheGetError} If operation fails
+     */
+    getWithMetadata<Metadata = unknown>(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<KVNamespaceGetWithMetadataResult<string, Metadata>>;
+    getWithMetadata<ExpectedValue = unknown, Metadata = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<KVNamespaceGetWithMetadataResult<ExpectedValue, Metadata>>;
+    getWithMetadata<Metadata = unknown>(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<KVNamespaceGetWithMetadataResult<ArrayBuffer, Metadata>>;
+    getWithMetadata<Metadata = unknown>(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<KVNamespaceGetWithMetadataResult<ReadableStream, Metadata>>;
+    /**
+     * Store a value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to store (string, ArrayBuffer, ArrayBufferView, or ReadableStream)
+     * @param options - Put options (expiration, expirationTtl, metadata)
+     * @throws {CachePutError} If operation fails
+     *
+     * @example
+     * ```typescript
+     * // Simple put
+     * await cache.put('key', 'value')
+     *
+     * // With TTL
+     * await cache.put('key', 'value', { expirationTtl: 3600 })
+     *
+     * // With metadata
+     * await cache.put('key', 'value', { metadata: { created: Date.now() } })
+     * ```
+     */
+    put(key: string, value: string | ArrayBuffer | ArrayBufferView | ReadableStream, options?: KVNamespacePutOptions): Promise<void>;
+    /**
+     * Delete a value from cache
+     *
+     * @param key - Cache key to delete
+     * @throws {CacheDeleteError} If operation fails
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List keys in cache
+     *
+     * @param options - List options (limit, prefix, cursor)
+     * @returns List result with keys and pagination info
+     * @throws {CacheListError} If operation fails
+     *
+     * @example
+     * ```typescript
+     * // List all keys
+     * const result = await cache.list()
+     *
+     * // List with prefix
+     * const result = await cache.list({ prefix: 'user:' })
+     *
+     * // Paginated list
+     * const result = await cache.list({ limit: 100 })
+     * if (!result.list_complete) {
+     *   const nextPage = await cache.list({ cursor: result.cursor })
+     * }
+     * ```
+     */
+    list<Metadata = unknown>(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult<Metadata>>;
+}
+//# sourceMappingURL=cache.service.d.ts.map

package/dist/cache/services/cache.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.service.d.ts","sourceRoot":"","sources":["../../../src/cache/services/cache.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAShE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBACa,YAAY;IAIY,OAAO,CAAC,QAAQ,CAAC,GAAG;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ9D,OAAO,CAAC,EAAE,CAAa;gBAG6B,GAAG,EAAE,UAAU,EACX,MAAM,EAAE,aAAa;IAK7E;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,YAAY;IAQ1C;;;;;;;OAOG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAChG,GAAG,CAAC,aAAa,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAC/H,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,qBAAqB,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAClH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0BjH;;;;;;;OAOG;IACG,eAAe,CAAC,QAAQ,GAAG,OAAO,EACtC,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,GACrD,OAAO,CAAC,gCAAgC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,eAAe,CAAC,aAAa,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAC/D,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,GACpD,OAAO,CAAC,gCAAgC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC/D,eAAe,CAAC,QAAQ,GAAG,OAAO,EACtC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,GAAG,qBAAqB,CAAC,aAAa,CAAC,GAClE,OAAO,CAAC,gCAAgC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7D,eAAe,CAAC,QAAQ,GAAG,OAAO,EACtC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,GACxD,OAAO,CAAC,gCAAgC,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IA+BtE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,EAC9D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,IAAI,CAAC,QAAQ,GAAG,OAAO,EAC3B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;CAQ5C"}

package/dist/cache/services/cache.service.js

@@ -0,0 +1,223 @@
+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); }
+};
+var CacheService_1;
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { DI_TOKENS } from '../../di/tokens';
+import { LOGGER_TOKENS } from '../../logger';
+import { CACHE_TOKENS } from '../cache.tokens';
+import { CacheDeleteError, CacheGetError, CacheListError, CachePutError, } from '../errors';
+/**
+ * Cache Service
+ *
+ * Type-safe wrapper around Cloudflare KV namespaces for caching operations.
+ *
+ * **Features:**
+ * - Mirrors all KVNamespace methods with full type safety
+ * - Supports multiple KV bindings via `withBinding()`
+ * - Automatic error handling with logging
+ * - Security: Raw errors are logged, not exposed to users
+ *
+ * **Usage:**
+ * ```typescript
+ * class MyService {
+ *   private readonly uploadsCache: CacheService
+ *
+ *   constructor(
+ *     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,
+ *     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env
+ *   ) {
+ *     // Initialize specialized caches in constructor
+ *     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)
+ *   }
+ *
+ *   async cacheData(key: string, value: string) {
+ *     await this.cache.put(key, value, { expirationTtl: 3600 })
+ *     await this.uploadsCache.put(`upload:${key}`, value)
+ *   }
+ * }
+ * ```
+ *
+ * @see https://developers.cloudflare.com/kv/api/
+ */
+let CacheService = CacheService_1 = class CacheService {
+    env;
+    logger;
+    kv;
+    constructor(env, logger) {
+        this.env = env;
+        this.logger = logger;
+        this.kv = env.CACHE;
+    }
+    /**
+     * Set the KV namespace binding
+     *
+     * Used internally by `withBinding()` to configure different KV instances.
+     *
+     * @param kv - KV namespace to use
+     */
+    setKV(kv) {
+        this.kv = kv;
+    }
+    /**
+     * Create a new CacheService instance with a different KV binding
+     *
+     * **Pattern:** Returns a new instance (immutable)
+     *
+     * **Best Practice:** Initialize specialized caches as class properties in constructor
+     *
+     * @example
+     * ```typescript
+     * class MyService {
+     *   private readonly uploadsCache: CacheService
+     *   private readonly systemCache: CacheService
+     *
+     *   constructor(
+     *     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,
+     *     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env
+     *   ) {
+     *     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)
+     *     this.systemCache = this.cache.withBinding(this.env.SYSTEM_CONFIG_KV)
+     *   }
+     * }
+     * ```
+     *
+     * @param kv - KV namespace to use
+     * @returns New CacheService instance with the specified binding
+     */
+    withBinding(kv) {
+        const instance = new CacheService_1(this.env, this.logger);
+        instance.setKV(kv);
+        return instance;
+    }
+    async get(key, typeOrOptions) {
+        try {
+            if (typeof typeOrOptions === 'string') {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API
+                return await this.kv.get(key, typeOrOptions);
+            }
+            if (typeOrOptions) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API
+                return await this.kv.get(key, typeOrOptions);
+            }
+            return await this.kv.get(key);
+        }
+        catch (error) {
+            this.logger.error('Cache get operation failed', { key, error });
+            throw new CacheGetError(key);
+        }
+    }
+    async getWithMetadata(key, typeOrOptions) {
+        try {
+            if (typeof typeOrOptions === 'string') {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API
+                return await this.kv.getWithMetadata(key, typeOrOptions);
+            }
+            if (typeOrOptions) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API
+                return await this.kv.getWithMetadata(key, typeOrOptions);
+            }
+            return await this.kv.getWithMetadata(key);
+        }
+        catch (error) {
+            this.logger.error('Cache getWithMetadata operation failed', { key, error });
+            throw new CacheGetError(key);
+        }
+    }
+    // ==================== PUT METHOD ====================
+    /**
+     * Store a value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to store (string, ArrayBuffer, ArrayBufferView, or ReadableStream)
+     * @param options - Put options (expiration, expirationTtl, metadata)
+     * @throws {CachePutError} If operation fails
+     *
+     * @example
+     * ```typescript
+     * // Simple put
+     * await cache.put('key', 'value')
+     *
+     * // With TTL
+     * await cache.put('key', 'value', { expirationTtl: 3600 })
+     *
+     * // With metadata
+     * await cache.put('key', 'value', { metadata: { created: Date.now() } })
+     * ```
+     */
+    async put(key, value, options) {
+        try {
+            await this.kv.put(key, value, options);
+        }
+        catch (error) {
+            this.logger.error('Cache put operation failed', { key, error });
+            throw new CachePutError(key);
+        }
+    }
+    // ==================== DELETE METHODS ====================
+    /**
+     * Delete a value from cache
+     *
+     * @param key - Cache key to delete
+     * @throws {CacheDeleteError} If operation fails
+     */
+    async delete(key) {
+        try {
+            await this.kv.delete(key);
+        }
+        catch (error) {
+            this.logger.error('Cache delete operation failed', { key, error });
+            throw new CacheDeleteError(key);
+        }
+    }
+    // ==================== LIST METHOD ====================
+    /**
+     * List keys in cache
+     *
+     * @param options - List options (limit, prefix, cursor)
+     * @returns List result with keys and pagination info
+     * @throws {CacheListError} If operation fails
+     *
+     * @example
+     * ```typescript
+     * // List all keys
+     * const result = await cache.list()
+     *
+     * // List with prefix
+     * const result = await cache.list({ prefix: 'user:' })
+     *
+     * // Paginated list
+     * const result = await cache.list({ limit: 100 })
+     * if (!result.list_complete) {
+     *   const nextPage = await cache.list({ cursor: result.cursor })
+     * }
+     * ```
+     */
+    async list(options) {
+        try {
+            return await this.kv.list(options);
+        }
+        catch (error) {
+            this.logger.error('Cache list operation failed', { options, error });
+            throw new CacheListError();
+        }
+    }
+};
+CacheService = CacheService_1 = __decorate([
+    Transient(CACHE_TOKENS.CacheService),
+    __param(0, inject(DI_TOKENS.CloudflareEnv)),
+    __param(1, inject(LOGGER_TOKENS.LoggerService)),
+    __metadata("design:paramtypes", [Object, Function])
+], CacheService);
+export { CacheService };
+//# sourceMappingURL=cache.service.js.map

package/dist/cache/services/cache.service.js.map

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

package/dist/cache/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './cache.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/services/index.d.ts.map

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

package/dist/cache/services/index.js

@@ -0,0 +1,2 @@
+export * from './cache.service';
+//# sourceMappingURL=index.js.map

package/dist/cache/services/index.js.map

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

package/dist/config/config.module.d.ts

@@ -0,0 +1,79 @@
+import type { z } from '../i18n/validation';
+import type { DynamicModule, ModuleContext, OnInitialize } from '../module/types';
+import type { ConfigNamespace } from './register-as';
+/**
+ * Any config namespace - uses structural typing for flexibility
+ */
+export type AnyConfigNamespace = ConfigNamespace<string, any, object>;
+/**
+ * Options for ConfigModule.forRoot
+ */
+export interface ConfigModuleOptions {
+    /**
+     * Array of config namespaces created via registerAs()
+     */
+    load: AnyConfigNamespace[];
+    /**
+     * Optional Zod schema for validating the merged config
+     * Validates the entire config object after all namespaces are merged
+     */
+    validateSchema?: z.ZodType<object>;
+}
+/**
+ * ConfigModule
+ *
+ * Provides configuration management with namespace support.
+ * Uses registerAs() to create typed config namespaces that can be injected.
+ *
+ * @example
+ * ```typescript
+ * // Define config namespaces
+ * const databaseConfig = registerAs('database', (env) => ({
+ *   url: env.DATABASE_URL,
+ *   maxConnections: 10
+ * }))
+ *
+ * const emailConfig = registerAs('email', (env) => ({
+ *   provider: env.EMAIL_PROVIDER,
+ *   from: { name: 'App', email: 'noreply@example.com' }
+ * }))
+ *
+ * // Register in module
+ * @Module({
+ *   imports: [
+ *     ConfigModule.forRoot({
+ *       load: [databaseConfig, emailConfig],
+ *       validateSchema: AppConfigSchema
+ *     })
+ *   ]
+ * })
+ * export class AppModule {}
+ *
+ * // Inject config
+ * constructor(
+ *   @inject(CONFIG_TOKENS.ConfigService) private config: IConfigService,
+ *   @inject(databaseConfig.KEY) private dbConfig: DatabaseConfig
+ * ) {
+ *   // Use dot notation
+ *   const url = this.config.get('database.url')
+ *
+ *   // Or inject namespace directly
+ *   const url = this.dbConfig.url
+ * }
+ * ```
+ */
+export declare class ConfigModule implements OnInitialize {
+    /**
+     * Configure ConfigModule with namespace loaders
+     *
+     * @param options - Configuration options
+     * @returns Dynamic module with config infrastructure
+     */
+    static forRoot(options: ConfigModuleOptions): DynamicModule;
+    /**
+     * Initialize config service with merged namespaces
+     * Called after all providers are registered
+     */
+    onInitialize(context: ModuleContext): void;
+}
+//# sourceMappingURL=config.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../../src/config/config.module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAI3C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAY,MAAM,iBAAiB,CAAA;AAG3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;AAErE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,kBAAkB,EAAE,CAAA;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;CACnC;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAUa,YAAa,YAAW,YAAY;IAC/C;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IAgB3D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;CAiC3C"}

package/dist/config/config.module.js

@@ -0,0 +1,120 @@
+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 ConfigModule_1;
+import { DI_TOKENS } from '../di/tokens';
+import { Scope } from '../di/types';
+import { Module } from '../module';
+import { CONFIG_TOKENS } from './config.tokens';
+import { ConfigValidationError } from './config.types';
+import { ConfigService } from './services/config.service';
+// Store options for use in onInitialize
+let moduleOptions = null;
+/**
+ * ConfigModule
+ *
+ * Provides configuration management with namespace support.
+ * Uses registerAs() to create typed config namespaces that can be injected.
+ *
+ * @example
+ * ```typescript
+ * // Define config namespaces
+ * const databaseConfig = registerAs('database', (env) => ({
+ *   url: env.DATABASE_URL,
+ *   maxConnections: 10
+ * }))
+ *
+ * const emailConfig = registerAs('email', (env) => ({
+ *   provider: env.EMAIL_PROVIDER,
+ *   from: { name: 'App', email: 'noreply@example.com' }
+ * }))
+ *
+ * // Register in module
+ * @Module({
+ *   imports: [
+ *     ConfigModule.forRoot({
+ *       load: [databaseConfig, emailConfig],
+ *       validateSchema: AppConfigSchema
+ *     })
+ *   ]
+ * })
+ * export class AppModule {}
+ *
+ * // Inject config
+ * constructor(
+ *   @inject(CONFIG_TOKENS.ConfigService) private config: IConfigService,
+ *   @inject(databaseConfig.KEY) private dbConfig: DatabaseConfig
+ * ) {
+ *   // Use dot notation
+ *   const url = this.config.get('database.url')
+ *
+ *   // Or inject namespace directly
+ *   const url = this.dbConfig.url
+ * }
+ * ```
+ */
+let ConfigModule = ConfigModule_1 = class ConfigModule {
+    /**
+     * Configure ConfigModule with namespace loaders
+     *
+     * @param options - Configuration options
+     * @returns Dynamic module with config infrastructure
+     */
+    static forRoot(options) {
+        moduleOptions = options;
+        const providers = [];
+        // Register each namespace config using asProvider()
+        for (const namespace of options.load) {
+            providers.push(namespace.asProvider());
+        }
+        return {
+            module: ConfigModule_1,
+            providers,
+        };
+    }
+    /**
+     * Initialize config service with merged namespaces
+     * Called after all providers are registered
+     */
+    onInitialize(context) {
+        if (!moduleOptions) {
+            throw new Error('ConfigModule.forRoot() was not called');
+        }
+        const env = context.container.resolve(DI_TOKENS.CloudflareEnv);
+        const configService = context.container.resolve(CONFIG_TOKENS.ConfigService);
+        // Build merged config from all namespaces
+        const mergedConfig = {};
+        for (const namespace of moduleOptions.load) {
+            mergedConfig[namespace.namespace] = namespace.factory(env);
+        }
+        // Validate if schema provided
+        if (moduleOptions.validateSchema) {
+            const result = moduleOptions.validateSchema.safeParse(mergedConfig);
+            if (!result.success) {
+                throw new ConfigValidationError('Configuration validation failed', result.error);
+            }
+        }
+        // Initialize ConfigService with merged config
+        configService.initialize(mergedConfig);
+        context.logger.debug('ConfigModule initialized', {
+            namespaces: moduleOptions.load.map((n) => n.namespace),
+        });
+    }
+};
+ConfigModule = ConfigModule_1 = __decorate([
+    Module({
+        providers: [
+            // Register the main ConfigService as Singleton so initialization persists
+            {
+                provide: CONFIG_TOKENS.ConfigService,
+                useClass: ConfigService,
+                scope: Scope.Singleton,
+            },
+        ],
+    })
+], ConfigModule);
+export { ConfigModule };
+//# sourceMappingURL=config.module.js.map