stratal 0.0.1

package/dist/config/config.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.js","sourceRoot":"","sources":["../../src/config/config.module.ts"],"names":[],"mappings":";;;;;;;AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,qBAAqB,EAAgB,MAAM,gBAAgB,CAAA;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAwBzD,wCAAwC;AACxC,IAAI,aAAa,GAA+B,IAAI,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAWI,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAA4B;QACzC,aAAa,GAAG,OAAO,CAAA;QAEvB,MAAM,SAAS,GAAe,EAAE,CAAA;QAEhC,oDAAoD;QACpD,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACrC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAA;QACxC,CAAC;QAED,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,SAAS;SACV,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAsB;QACjC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAU,SAAS,CAAC,aAAa,CAAC,CAAA;QACvE,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAgB,aAAa,CAAC,aAAa,CAAC,CAAA;QAE3F,0CAA0C;QAC1C,MAAM,YAAY,GAA4B,EAAE,CAAA;QAEhD,KAAK,MAAM,SAAS,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;YAC3C,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC5D,CAAC;QAED,8BAA8B;QAC9B,IAAI,aAAa,CAAC,cAAc,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;YACnE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,qBAAqB,CAC7B,iCAAiC,EACjC,MAAM,CAAC,KAAK,CACb,CAAA;YACH,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,aAAa,CAAC,UAAU,CAAC,YAA4B,CAAC,CAAA;QAEtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;YAC/C,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;SACvD,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AA5DY,YAAY;IAVxB,MAAM,CAAC;QACN,SAAS,EAAE;YACT,0EAA0E;YAC1E;gBACE,OAAO,EAAE,aAAa,CAAC,aAAa;gBACpC,QAAQ,EAAE,aAAa;gBACvB,KAAK,EAAE,KAAK,CAAC,SAAS;aACvB;SACF;KACF,CAAC;GACW,YAAY,CA4DxB"}

package/dist/config/config.tokens.d.ts

@@ -0,0 +1,4 @@
+export declare const CONFIG_TOKENS: {
+    readonly ConfigService: symbol;
+};
+//# sourceMappingURL=config.tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.tokens.d.ts","sourceRoot":"","sources":["../../src/config/config.tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;CAEhB,CAAA"}

package/dist/config/config.tokens.js

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

package/dist/config/config.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.tokens.js","sourceRoot":"","sources":["../../src/config/config.tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;CACjC,CAAA"}

package/dist/config/config.types.d.ts

@@ -0,0 +1,68 @@
+import type { z } from '../i18n/validation';
+export declare class ConfigValidationError extends Error {
+    readonly errors: z.ZodError;
+    constructor(message: string, errors: z.ZodError);
+}
+/**
+ * Configuration that can be augmented by applications
+ * Apps should augment this interface with their AppConfig type using module augmentation
+ *
+ * @example
+ * ```typescript
+ * // In your app (e.g., apps/backend/src/config/types.ts)
+ * declare module 'stratal' {
+ *   interface ModuleConfig {
+ *     database: { url: string; maxConnections: number }
+ *     email: { provider: string; from: { name: string; email: string } }
+ *   }
+ * }
+ * ```
+ */
+export interface ModuleConfig {
+}
+/**
+ * Generate all valid dot-notation paths from a config object type
+ * @example ConfigPath<{ database: { url: string } }> = 'database' | 'database.url'
+ */
+export type ConfigPath<T> = {
+    [K in keyof T & string]: T[K] extends Record<string, unknown> ? K | `${K}.${ConfigPath<T[K]>}` : K;
+}[keyof T & string];
+/**
+ * Get the value type at a dot-notation path
+ * @example ConfigPathValue<{ database: { url: string } }, 'database.url'> = string
+ */
+export type ConfigPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? T[K] extends Record<string, unknown> ? ConfigPathValue<T[K], Rest> : never : never : P extends keyof T ? T[P] : never;
+/**
+ * ConfigService interface with dot notation support
+ */
+export interface IConfigService<T extends object = ModuleConfig> {
+    /**
+     * Initialize the config service with validated configuration
+     * Should be called once during application startup
+     */
+    initialize(config: T): void;
+    /**
+     * Get config value using dot notation
+     * @example config.get('database.url')
+     */
+    get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P>;
+    /**
+     * Set config value at runtime (for tenant overrides)
+     * @example config.set('email.from.name', 'School Name')
+     */
+    set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void;
+    /**
+     * Reset config to original value
+     * @param path - Optional path to reset (resets entire config if omitted)
+     */
+    reset(path?: ConfigPath<T>): void;
+    /**
+     * Get entire config object
+     */
+    all(): Readonly<T>;
+    /**
+     * Check if a config path exists
+     */
+    has(path: ConfigPath<T>): boolean;
+}
+//# sourceMappingURL=config.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../src/config/config.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAE3C,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,MAAM,EAAE,CAAC,CAAC,QAAQ;gBADlC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,CAAC,CAAC,QAAQ;CAKrC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;CAAI;AAEjC;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3D,CAAC,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAC9B,CAAC;CACJ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAA;AAEnB;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GACnF,CAAC,SAAS,MAAM,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAC3B,KAAK,GACL,KAAK,GACL,CAAC,SAAS,MAAM,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC,GACJ,KAAK,CAAA;AAET;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,YAAY;IAC7D;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAA;IAE3B;;;OAGG;IACH,GAAG,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE5D;;;OAGG;IACH,GAAG,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;IAEzE;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAEjC;;OAEG;IACH,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAA;IAElB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAA;CAClC"}

package/dist/config/config.types.js

@@ -0,0 +1,9 @@
+export class ConfigValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'ConfigValidationError';
+    }
+}
+//# sourceMappingURL=config.types.js.map

package/dist/config/config.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.js","sourceRoot":"","sources":["../../src/config/config.types.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAG5B;IAFlB,YACE,OAAe,EACC,MAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,WAAM,GAAN,MAAM,CAAY;QAGlC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF"}

package/dist/config/errors/config-not-initialized.error.d.ts

@@ -0,0 +1,12 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ConfigNotInitializedError
+ *
+ * Thrown when attempting to access ConfigService before it has been initialized.
+ * This typically indicates that ConfigModule's onInitialize hook hasn't run yet,
+ * or the module wasn't registered properly.
+ */
+export declare class ConfigNotInitializedError extends ApplicationError {
+    constructor();
+}
+//# sourceMappingURL=config-not-initialized.error.d.ts.map

package/dist/config/errors/config-not-initialized.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-not-initialized.error.d.ts","sourceRoot":"","sources":["../../../src/config/errors/config-not-initialized.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;;CAO9D"}

package/dist/config/errors/config-not-initialized.error.js

@@ -0,0 +1,15 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ConfigNotInitializedError
+ *
+ * Thrown when attempting to access ConfigService before it has been initialized.
+ * This typically indicates that ConfigModule's onInitialize hook hasn't run yet,
+ * or the module wasn't registered properly.
+ */
+export class ConfigNotInitializedError extends ApplicationError {
+    constructor() {
+        super('errors.configNotInitialized', ERROR_CODES.SYSTEM.CONFIG_NOT_INITIALIZED);
+    }
+}
+//# sourceMappingURL=config-not-initialized.error.js.map

package/dist/config/errors/config-not-initialized.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-not-initialized.error.js","sourceRoot":"","sources":["../../../src/config/errors/config-not-initialized.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC7D;QACE,KAAK,CACH,6BAA6B,EAC7B,WAAW,CAAC,MAAM,CAAC,sBAAsB,CAC1C,CAAA;IACH,CAAC;CACF"}

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

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

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

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

package/dist/config/errors/index.js

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

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

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

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+export { CONFIG_TOKENS } from './config.tokens';
+export { ConfigModule, type ConfigModuleOptions } from './config.module';
+export { registerAs, type ConfigNamespace, type InferConfigType } from './register-as';
+export type { ConfigPath, ConfigPathValue, IConfigService, ModuleConfig } from './config.types';
+export { ConfigValidationError } from './config.types';
+export { ConfigService } from './services/config.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAGxE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAGtF,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,9 @@
+export { CONFIG_TOKENS } from './config.tokens';
+// Export ConfigModule
+export { ConfigModule } from './config.module';
+// Export registerAs
+export { registerAs } from './register-as';
+export { ConfigValidationError } from './config.types';
+// Export services (for testing or advanced use cases)
+export { ConfigService } from './services/config.service';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAA4B,MAAM,iBAAiB,CAAA;AAExE,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAA8C,MAAM,eAAe,CAAA;AAItF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,sDAAsD;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/config/register-as.d.ts

@@ -0,0 +1,62 @@
+import type { InjectionToken } from 'tsyringe';
+import type { FactoryProvider } from '../module/types';
+/**
+ * Configuration namespace registration result
+ */
+export interface ConfigNamespace<TKey extends string, TEnv, TConfig extends object> {
+    /** Auto-derived injection token (e.g., 'database' -> Symbol('CONFIG:database')) */
+    readonly KEY: InjectionToken<TConfig>;
+    /** The namespace key */
+    readonly namespace: TKey;
+    /** The factory function that receives env and returns config */
+    readonly factory: (env: TEnv) => TConfig;
+    /**
+     * Returns a provider configuration for use in module registration
+     * Automatically injects DI_TOKENS.CloudflareEnv
+     */
+    asProvider(): FactoryProvider<TConfig>;
+}
+/**
+ * Create a namespaced configuration factory
+ * Similar to NestJS registerAs
+ *
+ * @param namespace - Configuration namespace (e.g., 'database', 'email')
+ * @param factory - Factory function receiving env and returning config object
+ * @returns ConfigNamespace with token, factory, and asProvider() method
+ *
+ * @example
+ * ```typescript
+ * // apps/backend/src/config/database.config.ts
+ * export const databaseConfig = registerAs('database', (env: Env) => ({
+ *   url: env.DATABASE_URL,
+ *   maxConnections: parseInt(env.DATABASE_MAX_CONNECTIONS || '10'),
+ * }))
+ *
+ * // Auto-generates: databaseConfig.KEY = Symbol('CONFIG:database')
+ *
+ * // Usage in module:
+ * // Option 1: Manual provider
+ * {
+ *   provide: databaseConfig.KEY,
+ *   useFactory: databaseConfig.factory,
+ *   inject: [DI_TOKENS.CloudflareEnv]
+ * }
+ *
+ * // Option 2: asProvider() helper
+ * databaseConfig.asProvider()
+ * // Returns: { provide: databaseConfig.KEY, useFactory: ..., inject: [DI_TOKENS.CloudflareEnv] }
+ * ```
+ */
+export declare function registerAs<TKey extends string, TEnv, TConfig extends object>(namespace: TKey, factory: (env: TEnv) => TConfig): ConfigNamespace<TKey, TEnv, TConfig>;
+/**
+ * Helper to derive config type from registerAs result
+ *
+ * @example
+ * ```typescript
+ * const databaseConfig = registerAs('database', (env) => ({ url: env.DATABASE_URL }))
+ * type DatabaseConfig = InferConfigType<typeof databaseConfig>
+ * // { url: string }
+ * ```
+ */
+export type InferConfigType<T> = T extends ConfigNamespace<string, unknown, infer C> ? C : never;
+//# sourceMappingURL=register-as.d.ts.map

package/dist/config/register-as.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-as.d.ts","sourceRoot":"","sources":["../../src/config/register-as.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,OAAO,SAAS,MAAM;IAChF,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IACrC,wBAAwB;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAA;IACxC;;;OAGG;IACH,UAAU,IAAI,eAAe,CAAC,OAAO,CAAC,CAAA;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,OAAO,SAAS,MAAM,EAC1E,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,GAC9B,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAetC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA"}

package/dist/config/register-as.js

@@ -0,0 +1,48 @@
+import { DI_TOKENS } from '../di/tokens';
+/**
+ * Create a namespaced configuration factory
+ * Similar to NestJS registerAs
+ *
+ * @param namespace - Configuration namespace (e.g., 'database', 'email')
+ * @param factory - Factory function receiving env and returning config object
+ * @returns ConfigNamespace with token, factory, and asProvider() method
+ *
+ * @example
+ * ```typescript
+ * // apps/backend/src/config/database.config.ts
+ * export const databaseConfig = registerAs('database', (env: Env) => ({
+ *   url: env.DATABASE_URL,
+ *   maxConnections: parseInt(env.DATABASE_MAX_CONNECTIONS || '10'),
+ * }))
+ *
+ * // Auto-generates: databaseConfig.KEY = Symbol('CONFIG:database')
+ *
+ * // Usage in module:
+ * // Option 1: Manual provider
+ * {
+ *   provide: databaseConfig.KEY,
+ *   useFactory: databaseConfig.factory,
+ *   inject: [DI_TOKENS.CloudflareEnv]
+ * }
+ *
+ * // Option 2: asProvider() helper
+ * databaseConfig.asProvider()
+ * // Returns: { provide: databaseConfig.KEY, useFactory: ..., inject: [DI_TOKENS.CloudflareEnv] }
+ * ```
+ */
+export function registerAs(namespace, factory) {
+    const KEY = Symbol.for(`CONFIG:${namespace}`);
+    return {
+        KEY,
+        namespace,
+        factory,
+        asProvider() {
+            return {
+                provide: KEY,
+                useFactory: factory,
+                inject: [DI_TOKENS.CloudflareEnv],
+            };
+        },
+    };
+}
+//# sourceMappingURL=register-as.js.map

package/dist/config/register-as.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-as.js","sourceRoot":"","sources":["../../src/config/register-as.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAoBxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,UAAU,CACxB,SAAe,EACf,OAA+B;IAE/B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,SAAS,EAAE,CAA4B,CAAA;IAExE,OAAO;QACL,GAAG;QACH,SAAS;QACT,OAAO;QACP,UAAU;YACR,OAAO;gBACL,OAAO,EAAE,GAAG;gBACZ,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC;aAClC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,58 @@
+import type { ConfigPath, ConfigPathValue, IConfigService, ModuleConfig } from '../config.types';
+/**
+ * ConfigService with dot notation support for get/set operations
+ *
+ * Supports runtime overrides via set() - useful for tenant-specific config.
+ * Use reset() to restore original values.
+ *
+ * @example
+ * ```typescript
+ * // Get with dot notation
+ * const url = config.get('database.url')
+ * const fromName = config.get('email.from.name')
+ *
+ * // Set at runtime (e.g., in middleware for tenant override)
+ * config.set('email.from.name', tenant.schoolName)
+ *
+ * // Reset to original
+ * config.reset('email.from.name') // reset specific path
+ * config.reset() // reset entire config
+ * ```
+ */
+export declare class ConfigService<T extends object = ModuleConfig> implements IConfigService<T> {
+    private originalConfig;
+    private currentConfig;
+    /**
+     * Initialize the config service with validated configuration
+     * Called by ConfigModule during initialization
+     */
+    initialize(config: T): void;
+    /**
+     * Get config value using dot notation
+     * @example config.get('database.url')
+     */
+    get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P>;
+    /**
+     * Set config value at runtime (for tenant overrides)
+     * @example config.set('email.from.name', 'School Name')
+     */
+    set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void;
+    /**
+     * Reset config to original value
+     * @param path - Optional path to reset (resets entire config if omitted)
+     */
+    reset(path?: ConfigPath<T>): void;
+    /**
+     * Get entire config object
+     */
+    all(): Readonly<T>;
+    /**
+     * Check if a config path exists
+     */
+    has(path: ConfigPath<T>): boolean;
+    private getByPath;
+    private setByPath;
+    private ensureInitialized;
+    private deepClone;
+}
+//# sourceMappingURL=config.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../../src/config/services/config.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGhG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,YAAY,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,aAAa,CAAe;IAEpC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAK3B;;;OAGG;IACH,GAAG,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAK5D;;;OAGG;IACH,GAAG,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAKzE;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAUjC;;OAEG;IACH,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;IAKlB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO;IAKjC,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,SAAS;CAMlB"}

package/dist/config/services/config.service.js

@@ -0,0 +1,123 @@
+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 { Transient } from '../../di/decorators';
+import { CONFIG_TOKENS } from '../config.tokens';
+import { ConfigNotInitializedError } from '../errors';
+/**
+ * ConfigService with dot notation support for get/set operations
+ *
+ * Supports runtime overrides via set() - useful for tenant-specific config.
+ * Use reset() to restore original values.
+ *
+ * @example
+ * ```typescript
+ * // Get with dot notation
+ * const url = config.get('database.url')
+ * const fromName = config.get('email.from.name')
+ *
+ * // Set at runtime (e.g., in middleware for tenant override)
+ * config.set('email.from.name', tenant.schoolName)
+ *
+ * // Reset to original
+ * config.reset('email.from.name') // reset specific path
+ * config.reset() // reset entire config
+ * ```
+ */
+let ConfigService = class ConfigService {
+    originalConfig;
+    currentConfig;
+    /**
+     * Initialize the config service with validated configuration
+     * Called by ConfigModule during initialization
+     */
+    initialize(config) {
+        this.originalConfig = this.deepClone(config);
+        this.currentConfig = this.deepClone(config);
+    }
+    /**
+     * Get config value using dot notation
+     * @example config.get('database.url')
+     */
+    get(path) {
+        this.ensureInitialized();
+        return this.getByPath(this.currentConfig, path);
+    }
+    /**
+     * Set config value at runtime (for tenant overrides)
+     * @example config.set('email.from.name', 'School Name')
+     */
+    set(path, value) {
+        this.ensureInitialized();
+        this.setByPath(this.currentConfig, path, value);
+    }
+    /**
+     * Reset config to original value
+     * @param path - Optional path to reset (resets entire config if omitted)
+     */
+    reset(path) {
+        this.ensureInitialized();
+        if (path) {
+            const originalValue = this.getByPath(this.originalConfig, path);
+            this.setByPath(this.currentConfig, path, this.deepClone(originalValue));
+        }
+        else {
+            this.currentConfig = this.deepClone(this.originalConfig);
+        }
+    }
+    /**
+     * Get entire config object
+     */
+    all() {
+        this.ensureInitialized();
+        return this.currentConfig;
+    }
+    /**
+     * Check if a config path exists
+     */
+    has(path) {
+        this.ensureInitialized();
+        return this.getByPath(this.currentConfig, path) !== undefined;
+    }
+    getByPath(obj, path) {
+        const keys = path.split('.');
+        let current = obj;
+        for (const key of keys) {
+            if (current === null || current === undefined)
+                return undefined;
+            current = current[key];
+        }
+        return current;
+    }
+    setByPath(obj, path, value) {
+        const keys = path.split('.');
+        let current = obj;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!(key in current) || typeof current[key] !== 'object' || current[key] === null) {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        current[keys[keys.length - 1]] = value;
+    }
+    ensureInitialized() {
+        if (!this.currentConfig) {
+            throw new ConfigNotInitializedError();
+        }
+    }
+    deepClone(obj) {
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        return JSON.parse(JSON.stringify(obj));
+    }
+};
+ConfigService = __decorate([
+    Transient(CONFIG_TOKENS.ConfigService)
+], ConfigService);
+export { ConfigService };
+//# sourceMappingURL=config.service.js.map

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

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

package/dist/cron/cron-job.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Interface for cron jobs that can be registered by modules
+ *
+ * Cron jobs are executed when Cloudflare triggers match their schedule.
+ * Jobs are registered via the module's getCronJobs() method.
+ *
+ * @example
+ * ```typescript
+ * @Transient()
+ * export class TenantCleanupJob implements CronJob {
+ *   readonly schedule = '0 2 * * *' // Daily at 2 AM UTC
+ *
+ *   constructor(
+ *     @inject(DI_TOKENS.Logger) private logger: Logger,
+ *     @inject(TENANTS_TOKENS.TenantsService) private tenantsService: TenantsService
+ *   ) {}
+ *
+ *   async execute(controller: ScheduledController): Promise<void> {
+ *     this.logger.info('Running tenant cleanup')
+ *     await this.tenantsService.cleanupInactiveTenants()
+ *   }
+ *
+ *   async onError(error: Error): Promise<void> {
+ *     this.logger.error('Tenant cleanup failed', { error: error.message })
+ *   }
+ * }
+ * ```
+ */
+export interface CronJob {
+    /**
+     * Cron expression that triggers this job
+     *
+     * Must match a cron trigger defined in wrangler.jsonc
+     * @example '0 2 * * *' // Daily at 2 AM UTC
+     * @example '* /15 * * * *' // Every 15 minutes
+     */
+    readonly schedule: string;
+    /**
+     * Execute the cron job
+     *
+     * @param controller - Cloudflare ScheduledController with scheduledTime and cron
+     * @throws ApplicationError for expected errors
+     */
+    execute(controller: ScheduledController): Promise<void>;
+    /**
+     * Optional error handler for job execution failures
+     *
+     * If not provided, errors are logged via GlobalErrorHandler
+     *
+     * @param error - Error that occurred during execution
+     * @param controller - Cloudflare ScheduledController
+     */
+    onError?(error: Error, controller: ScheduledController): Promise<void>;
+}
+//# sourceMappingURL=cron-job.d.ts.map

package/dist/cron/cron-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-job.d.ts","sourceRoot":"","sources":["../../src/cron/cron-job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,OAAO;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvD;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtE"}

package/dist/cron/cron-job.js

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

package/dist/cron/cron-job.js.map

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

package/dist/cron/cron-manager.d.ts

@@ -0,0 +1,60 @@
+import type { CronJob } from './cron-job';
+/**
+ * Manages cron job registration and execution
+ *
+ * CronManager is a singleton service that:
+ * - Registers cron jobs from modules
+ * - Routes scheduled events to matching jobs
+ * - Handles errors during job execution
+ *
+ * Jobs are grouped by their cron expression, allowing multiple jobs
+ * to run on the same schedule.
+ */
+export declare class CronManager {
+    /**
+     * Map of cron expressions to jobs
+     * Key: Cron expression (e.g., '0 2 * * *')
+     * Value: Array of jobs matching that expression
+     */
+    private jobs;
+    /**
+     * Register a cron job
+     *
+     * Jobs with the same schedule are grouped together and executed
+     * sequentially when the trigger fires.
+     *
+     * @param job - CronJob instance to register
+     */
+    registerJob(job: CronJob): void;
+    /**
+     * Execute all jobs matching the triggered cron expression
+     *
+     * Jobs are executed sequentially. If a job fails:
+     * - Its onError() hook is called (if defined)
+     * - Execution continues with the next job
+     * - Errors are collected and logged
+     *
+     * @param controller - Cloudflare ScheduledController
+     */
+    executeScheduled(controller: ScheduledController): Promise<void>;
+    /**
+     * Get all registered jobs for a specific cron expression
+     *
+     * @param schedule - Cron expression
+     * @returns Array of jobs for that schedule, or empty array if none
+     */
+    getJobsForSchedule(schedule: string): CronJob[];
+    /**
+     * Get all registered cron expressions
+     *
+     * @returns Array of unique cron expressions
+     */
+    getAllSchedules(): string[];
+    /**
+     * Get total number of registered jobs across all schedules
+     *
+     * @returns Total job count
+     */
+    getTotalJobCount(): number;
+}
+//# sourceMappingURL=cron-manager.d.ts.map

package/dist/cron/cron-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-manager.d.ts","sourceRoot":"","sources":["../../src/cron/cron-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC;;;;;;;;;;GAUG;AACH,qBACa,WAAW;IACvB;;;;OAIG;IACH,OAAO,CAAC,IAAI,CAA+B;IAE3C;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAM/B;;;;;;;;;OASG;IACG,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CtE;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE;IAI/C;;;;OAIG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;CAO1B"}