stratal 0.0.13 → 0.0.15

package/dist/config/index.d.mts

@@ -0,0 +1,273 @@
+import { dt as OnInitialize, it as DynamicModule, lt as ModuleContext, ot as FactoryProvider } from "../index-D69rxo8H.mjs";
+import { o as z } from "../index-CpAN9ENH.mjs";
+import { InjectionToken } from "tsyringe";
+
+//#region src/config/config.tokens.d.ts
+declare const CONFIG_TOKENS: {
+  readonly ConfigService: symbol;
+};
+//#endregion
+//#region src/config/register-as.d.ts
+/**
+ * Configuration namespace registration result
+ */
+interface ConfigNamespace<TKey extends string, TEnv, TConfig extends object> {
+  /** Auto-derived injection token (e.g., 'database' -> Symbol('stratal: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('stratal: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] }
+ * ```
+ */
+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 }
+ * ```
+ */
+type InferConfigType<T> = T extends ConfigNamespace<string, unknown, infer C> ? C : never;
+//#endregion
+//#region src/config/config.module.d.ts
+/**
+ * Any config namespace - uses structural typing for flexibility
+ */
+type AnyConfigNamespace = ConfigNamespace<string, any, object>;
+/**
+ * Options for ConfigModule.forRoot
+ */
+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
+ * }
+ * ```
+ */
+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;
+}
+//#endregion
+//#region src/config/config.types.d.ts
+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 } }
+ *   }
+ * }
+ * ```
+ */
+interface ModuleConfig {}
+/**
+ * Generate all valid dot-notation paths from a config object type
+ * @example ConfigPath<{ database: { url: string } }> = 'database' | 'database.url'
+ */
+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
+ */
+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
+ */
+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 runtime overrides)
+   * @example config.set('email.from.name', 'Custom 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;
+}
+//#endregion
+//#region src/config/services/config.service.d.ts
+/**
+ * ConfigService with dot notation support for get/set operations
+ *
+ * Supports runtime overrides via set() - useful for request-specific config overrides.
+ * 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 runtime override)
+ * config.set('email.from.name', 'Custom Name')
+ *
+ * // Reset to original
+ * config.reset('email.from.name') // reset specific path
+ * config.reset() // reset entire config
+ * ```
+ */
+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 runtime overrides)
+   * @example config.set('email.from.name', 'Custom 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 isDangerousKey;
+  private ensureInitialized;
+  private deepClone;
+}
+//#endregion
+export { CONFIG_TOKENS, ConfigModule, type ConfigModuleOptions, type ConfigNamespace, type ConfigPath, type ConfigPathValue, ConfigService, ConfigValidationError, type IConfigService, type InferConfigType, type ModuleConfig, registerAs };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/config/config.tokens.ts","../../src/config/register-as.ts","../../src/config/config.module.ts","../../src/config/config.types.ts","../../src/config/services/config.service.ts"],"mappings":";;;;;cAAa,aAAA;EAAA,SAEH,aAAA;AAAA;;;;;;UCKO,eAAA;EDLP;EAAA,SCOC,GAAA,EAAK,cAAA,CAAe,OAAA;EDPrB;EAAA,SCSC,SAAA,EAAW,IAAA;;WAEX,OAAA,GAAU,GAAA,EAAK,IAAA,KAAS,OAAA;;AANnC;;;EAWE,UAAA,IAAc,eAAA,CAAgB,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAkChC;;;;;;;iBAAgB,UAAA,mDAAA,CACd,SAAA,EAAW,IAAA,EACX,OAAA,GAAU,GAAA,EAAK,IAAA,KAAS,OAAA,GACvB,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,OAAA;;;;;;;;;;;KA2BnB,eAAA,MAAqB,CAAA,SAAU,eAAA,6BAA4C,CAAA;;;;;ADlFvF;KEeY,kBAAA,GAAqB,eAAA;;;;UAKhB,mBAAA;;;ADbjB;ECiBE,IAAA,EAAM,kBAAA;EDjBwB;;;;ECuB9B,cAAA,GAAiB,CAAA,CAAE,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;ADsBrB;;;;;;;;;;;;;;;;;;;;;;cCqCa,YAAA,YAAwB,YAAA;EDlCZ;;;;AA2BzB;;EA3ByB,OCyChB,OAAA,CAAQ,OAAA,EAAS,mBAAA,GAAsB,aAAA;EDdU;;;;ECkCxD,YAAA,CAAa,OAAA,EAAS,aAAA;AAAA;;;cClHX,qBAAA,SAA8B,KAAA;EAAA,SAGvB,MAAA,EAAQ,CAAA,CAAE,QAAA;cAD1B,OAAA,UACgB,MAAA,EAAQ,CAAA,CAAE,QAAA;AAAA;AHL9B;;;;;;;;ACOA;;;;;;;ADPA,UG2BiB,YAAA;;;;;KAML,UAAA,oBACE,CAAA,YAAa,CAAA,CAAE,CAAA,UAAW,MAAA,oBACpC,CAAA,MAAO,CAAA,IAAK,UAAA,CAAW,CAAA,CAAE,CAAA,OACzB,CAAA,SACI,CAAA;;;;;KAMI,eAAA,wBAAuC,CAAA,sCAC/C,CAAA,eAAgB,CAAA,GAChB,CAAA,CAAE,CAAA,UAAW,MAAA,oBACb,eAAA,CAAgB,CAAA,CAAE,CAAA,GAAI,IAAA,oBAGtB,CAAA,eAAgB,CAAA,GAChB,CAAA,CAAE,CAAA;;;;UAMW,cAAA,oBAAkC,YAAA;EFtCnC;;;;EE2Cd,UAAA,CAAW,MAAA,EAAQ,CAAA;EFTK;;;;EEexB,GAAA,WAAc,UAAA,CAAW,CAAA,GAAI,IAAA,EAAM,CAAA,GAAI,eAAA,CAAgB,CAAA,EAAG,CAAA;EFZzC;;;;EEkBjB,GAAA,WAAc,UAAA,CAAW,CAAA,GAAI,IAAA,EAAM,CAAA,EAAG,KAAA,EAAO,eAAA,CAAgB,CAAA,EAAG,CAAA;EFlBhD;;;;EEwBhB,KAAA,CAAM,IAAA,GAAO,UAAA,CAAW,CAAA;EF1BxB;;;EE+BA,GAAA,IAAO,QAAA,CAAS,CAAA;EF9BhB;;;EEmCA,GAAA,CAAI,IAAA,EAAM,UAAA,CAAW,CAAA;AAAA;;;;;;;AHzFvB;;;;;;;;ACOA;;;;;;;;cGmBa,aAAA,oBAAiC,YAAA,aAAyB,cAAA,CAAe,CAAA;EAAA,QAC5E,cAAA;EAAA,QACA,aAAA;EHVqB;;;;EGgB7B,UAAA,CAAW,MAAA,EAAQ,CAAA;EHzBL;;;;EGkCd,GAAA,WAAc,UAAA,CAAW,CAAA,EAAA,CAAI,IAAA,EAAM,CAAA,GAAI,eAAA,CAAgB,CAAA,EAAG,CAAA;EH9BlC;;;;EGuCxB,GAAA,WAAc,UAAA,CAAW,CAAA,EAAA,CAAI,IAAA,EAAM,CAAA,EAAG,KAAA,EAAO,eAAA,CAAgB,CAAA,EAAG,CAAA;EHlClC;;;AAkChC;EGSE,KAAA,CAAM,IAAA,GAAO,UAAA,CAAW,CAAA;EHTA;;;EGsBxB,GAAA,CAAA,GAAO,QAAA,CAAS,CAAA;EHnBC;;;EG2BjB,GAAA,CAAI,IAAA,EAAM,UAAA,CAAW,CAAA;EAAA,QAKb,SAAA;EAAA,QAWA,SAAA;EAAA,QAwBA,cAAA;EAAA,QAIA,iBAAA;EAAA,QAMA,SAAA;AAAA"}

package/dist/config/index.mjs

@@ -0,0 +1,239 @@
+import { S as ApplicationError, b as ERROR_CODES, s as Scope } from "../errors-CtCi1wn6.mjs";
+import { i as Transient, l as DI_TOKENS, t as __decorate } from "../decorate-D5j-d9_z.mjs";
+import "../logger-BR1-s1Um.mjs";
+import { r as Module } from "../module-BH7t7BGG.mjs";
+import "../events-CXl-o1Ad.mjs";
+import "../command-DG_u5ob2.mjs";
+import "../is-command-MZDCH-0T.mjs";
+import "../is-seeder-BN9Ej1r7.mjs";
+import "../middleware-iRhNjsPH.mjs";
+import "../router-context-BLn4PrRG.mjs";
+//#region src/config/config.tokens.ts
+const CONFIG_TOKENS = { ConfigService: Symbol.for("stratal:config:service") };
+//#endregion
+//#region src/config/errors/config-module-not-initialized.error.ts
+/**
+* Error thrown when ConfigModule's onInitialize runs but forRoot() was never called.
+*
+* This means the module was imported without calling ConfigModule.forRoot({ load: [...] }).
+*/
+var ConfigModuleNotInitializedError = class extends ApplicationError {
+	constructor() {
+		super("errors.configModuleNotInitialized", ERROR_CODES.SYSTEM.CONFIG_MODULE_NOT_INITIALIZED);
+	}
+};
+//#endregion
+//#region src/config/errors/config-not-initialized.error.ts
+/**
+* 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.
+*/
+var ConfigNotInitializedError = class extends ApplicationError {
+	constructor() {
+		super("errors.configNotInitialized", ERROR_CODES.SYSTEM.CONFIG_NOT_INITIALIZED);
+	}
+};
+//#endregion
+//#region src/config/config.types.ts
+var ConfigValidationError = class extends Error {
+	constructor(message, errors) {
+		super(message);
+		this.errors = errors;
+		this.name = "ConfigValidationError";
+	}
+};
+//#endregion
+//#region src/config/services/config.service.ts
+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 runtime overrides)
+	* @example config.set('email.from.name', 'Custom 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) !== void 0;
+	}
+	getByPath(obj, path) {
+		const keys = path.split(".");
+		let current = obj;
+		for (const key of keys) {
+			if (this.isDangerousKey(key)) return void 0;
+			if (current === null || current === void 0) return void 0;
+			current = current[key];
+		}
+		return current;
+	}
+	setByPath(obj, path, value) {
+		const keys = path.split(".");
+		if (keys.some((key) => this.isDangerousKey(key))) return;
+		let current = obj;
+		for (let i = 0; i < keys.length - 1; i++) {
+			const key = keys[i];
+			if (!Object.hasOwn(current, key) || typeof current[key] !== "object" || current[key] === null) Object.defineProperty(current, key, {
+				value: {},
+				writable: true,
+				enumerable: true,
+				configurable: true
+			});
+			current = current[key];
+		}
+		Object.defineProperty(current, keys[keys.length - 1], {
+			value,
+			writable: true,
+			enumerable: true,
+			configurable: true
+		});
+	}
+	isDangerousKey(key) {
+		return key === "__proto__" || key === "constructor" || key === "prototype";
+	}
+	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);
+//#endregion
+//#region src/config/config.module.ts
+var _ConfigModule;
+let moduleOptions = null;
+let ConfigModule = _ConfigModule = class ConfigModule {
+	/**
+	* Configure ConfigModule with namespace loaders
+	*
+	* @param options - Configuration options
+	* @returns Dynamic module with config infrastructure
+	*/
+	static forRoot(options) {
+		moduleOptions = options;
+		const providers = [];
+		for (const namespace of options.load) providers.push(namespace.asProvider());
+		return {
+			module: _ConfigModule,
+			providers
+		};
+	}
+	/**
+	* Initialize config service with merged namespaces
+	* Called after all providers are registered
+	*/
+	onInitialize(context) {
+		if (!moduleOptions) throw new ConfigModuleNotInitializedError();
+		const env = context.container.resolve(DI_TOKENS.CloudflareEnv);
+		const configService = context.container.resolve(CONFIG_TOKENS.ConfigService);
+		const mergedConfig = {};
+		for (const namespace of moduleOptions.load) mergedConfig[namespace.namespace] = namespace.factory(env);
+		if (moduleOptions.validateSchema) {
+			const result = moduleOptions.validateSchema.safeParse(mergedConfig);
+			if (!result.success) throw new ConfigValidationError("Configuration validation failed", result.error);
+		}
+		configService.initialize(mergedConfig);
+		context.logger.debug("ConfigModule initialized", { namespaces: moduleOptions.load.map((n) => n.namespace) });
+	}
+};
+ConfigModule = _ConfigModule = __decorate([Module({ providers: [{
+	provide: CONFIG_TOKENS.ConfigService,
+	useClass: ConfigService,
+	scope: Scope.Singleton
+}] })], ConfigModule);
+//#endregion
+//#region src/config/register-as.ts
+/**
+* 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('stratal: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] }
+* ```
+*/
+function registerAs(namespace, factory) {
+	const KEY = Symbol.for(`stratal:config:${namespace}`);
+	return {
+		KEY,
+		namespace,
+		factory,
+		asProvider() {
+			return {
+				provide: KEY,
+				useFactory: factory,
+				inject: [DI_TOKENS.CloudflareEnv]
+			};
+		}
+	};
+}
+//#endregion
+export { CONFIG_TOKENS, ConfigModule, ConfigService, ConfigValidationError, registerAs };
+
+//# sourceMappingURL=index.mjs.map

package/dist/config/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/config/config.tokens.ts","../../src/config/errors/config-module-not-initialized.error.ts","../../src/config/errors/config-not-initialized.error.ts","../../src/config/config.types.ts","../../src/config/services/config.service.ts","../../src/config/config.module.ts","../../src/config/register-as.ts"],"sourcesContent":["export const CONFIG_TOKENS = {\n\tConfigService: Symbol.for('stratal:config:service'),\n} as const\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when ConfigModule's onInitialize runs but forRoot() was never called.\n *\n * This means the module was imported without calling ConfigModule.forRoot({ load: [...] }).\n */\nexport class ConfigModuleNotInitializedError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.configModuleNotInitialized',\n      ERROR_CODES.SYSTEM.CONFIG_MODULE_NOT_INITIALIZED\n    )\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * ConfigNotInitializedError\n *\n * Thrown when attempting to access ConfigService before it has been initialized.\n * This typically indicates that ConfigModule's onInitialize hook hasn't run yet,\n * or the module wasn't registered properly.\n */\nexport class ConfigNotInitializedError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.configNotInitialized',\n      ERROR_CODES.SYSTEM.CONFIG_NOT_INITIALIZED\n    )\n  }\n}\n","import type { z } from '../i18n/validation'\n\nexport class ConfigValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly errors: z.ZodError\n  ) {\n    super(message)\n    this.name = 'ConfigValidationError'\n  }\n}\n\n/**\n * Configuration that can be augmented by applications\n * Apps should augment this interface with their AppConfig type using module augmentation\n *\n * @example\n * ```typescript\n * // In your app (e.g., apps/backend/src/config/types.ts)\n * declare module 'stratal' {\n *   interface ModuleConfig {\n *     database: { url: string; maxConnections: number }\n *     email: { provider: string; from: { name: string; email: string } }\n *   }\n * }\n * ```\n */\nexport interface ModuleConfig { }\n\n/**\n * Generate all valid dot-notation paths from a config object type\n * @example ConfigPath<{ database: { url: string } }> = 'database' | 'database.url'\n */\nexport type ConfigPath<T> = {\n  [K in keyof T & string]: T[K] extends Record<string, unknown>\n  ? K | `${K}.${ConfigPath<T[K]>}`\n  : K\n}[keyof T & string]\n\n/**\n * Get the value type at a dot-notation path\n * @example ConfigPathValue<{ database: { url: string } }, 'database.url'> = string\n */\nexport type ConfigPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}`\n  ? K extends keyof T\n  ? T[K] extends Record<string, unknown>\n  ? ConfigPathValue<T[K], Rest>\n  : never\n  : never\n  : P extends keyof T\n  ? T[P]\n  : never\n\n/**\n * ConfigService interface with dot notation support\n */\nexport interface IConfigService<T extends object = ModuleConfig> {\n  /**\n   * Initialize the config service with validated configuration\n   * Should be called once during application startup\n   */\n  initialize(config: T): void\n\n  /**\n   * Get config value using dot notation\n   * @example config.get('database.url')\n   */\n  get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P>\n\n  /**\n   * Set config value at runtime (for runtime overrides)\n   * @example config.set('email.from.name', 'Custom Name')\n   */\n  set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void\n\n  /**\n   * Reset config to original value\n   * @param path - Optional path to reset (resets entire config if omitted)\n   */\n  reset(path?: ConfigPath<T>): void\n\n  /**\n   * Get entire config object\n   */\n  all(): Readonly<T>\n\n  /**\n   * Check if a config path exists\n   */\n  has(path: ConfigPath<T>): boolean\n}\n","import { Transient } from '../../di/decorators'\nimport { CONFIG_TOKENS } from '../config.tokens'\nimport type { ConfigPath, ConfigPathValue, IConfigService, ModuleConfig } from '../config.types'\nimport { ConfigNotInitializedError } from '../errors'\n\n/**\n * ConfigService with dot notation support for get/set operations\n *\n * Supports runtime overrides via set() - useful for request-specific config overrides.\n * Use reset() to restore original values.\n *\n * @example\n * ```typescript\n * // Get with dot notation\n * const url = config.get('database.url')\n * const fromName = config.get('email.from.name')\n *\n * // Set at runtime (e.g., in middleware for runtime override)\n * config.set('email.from.name', 'Custom Name')\n *\n * // Reset to original\n * config.reset('email.from.name') // reset specific path\n * config.reset() // reset entire config\n * ```\n */\n@Transient(CONFIG_TOKENS.ConfigService)\nexport class ConfigService<T extends object = ModuleConfig> implements IConfigService<T> {\n  private originalConfig: T | undefined\n  private currentConfig: T | undefined\n\n  /**\n   * Initialize the config service with validated configuration\n   * Called by ConfigModule during initialization\n   */\n  initialize(config: T): void {\n    this.originalConfig = this.deepClone(config)\n    this.currentConfig = this.deepClone(config)\n  }\n\n  /**\n   * Get config value using dot notation\n   * @example config.get('database.url')\n   */\n  get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P> {\n    this.ensureInitialized()\n    return this.getByPath(this.currentConfig, path) as ConfigPathValue<T, P>\n  }\n\n  /**\n   * Set config value at runtime (for runtime overrides)\n   * @example config.set('email.from.name', 'Custom Name')\n   */\n  set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void {\n    this.ensureInitialized()\n    this.setByPath(this.currentConfig, path, value)\n  }\n\n  /**\n   * Reset config to original value\n   * @param path - Optional path to reset (resets entire config if omitted)\n   */\n  reset(path?: ConfigPath<T>): void {\n    this.ensureInitialized()\n    if (path) {\n      const originalValue = this.getByPath(this.originalConfig, path)\n      this.setByPath(this.currentConfig, path, this.deepClone(originalValue))\n    } else {\n      this.currentConfig = this.deepClone(this.originalConfig)\n    }\n  }\n\n  /**\n   * Get entire config object\n   */\n  all(): Readonly<T> {\n    this.ensureInitialized()\n    return this.currentConfig as Readonly<T>\n  }\n\n  /**\n   * Check if a config path exists\n   */\n  has(path: ConfigPath<T>): boolean {\n    this.ensureInitialized()\n    return this.getByPath(this.currentConfig, path) !== undefined\n  }\n\n  private getByPath(obj: unknown, path: string): unknown {\n    const keys = path.split('.')\n    let current = obj\n    for (const key of keys) {\n      if (this.isDangerousKey(key)) return undefined\n      if (current === null || current === undefined) return undefined\n      current = (current as Record<string, unknown>)[key]\n    }\n    return current\n  }\n\n  private setByPath(obj: unknown, path: string, value: unknown): void {\n    const keys = path.split('.')\n    if (keys.some((key) => this.isDangerousKey(key))) return\n    let current = obj as Record<string, unknown>\n    for (let i = 0; i < keys.length - 1; i++) {\n      const key = keys[i]\n      if (!Object.hasOwn(current, key) || typeof current[key] !== 'object' || current[key] === null) {\n        Object.defineProperty(current, key, {\n          value: {},\n          writable: true,\n          enumerable: true,\n          configurable: true,\n        })\n      }\n      current = current[key] as Record<string, unknown>\n    }\n    Object.defineProperty(current, keys[keys.length - 1], {\n      value,\n      writable: true,\n      enumerable: true,\n      configurable: true,\n    })\n  }\n\n  private isDangerousKey(key: string): boolean {\n    return key === '__proto__' || key === 'constructor' || key === 'prototype'\n  }\n\n  private ensureInitialized(): void {\n    if (!this.currentConfig) {\n      throw new ConfigNotInitializedError()\n    }\n  }\n\n  private deepClone<V>(obj: V): V {\n    if (obj === null || typeof obj !== 'object') {\n      return obj\n    }\n    return JSON.parse(JSON.stringify(obj)) as V\n  }\n}\n","import type { z } from '../i18n/validation'\nimport { ConfigModuleNotInitializedError } from './errors'\nimport { DI_TOKENS } from '../di/tokens'\nimport { Scope } from '../di/types'\nimport { Module } from '../module'\nimport type { DynamicModule, ModuleContext, OnInitialize, Provider } from '../module/types'\nimport { CONFIG_TOKENS } from './config.tokens'\nimport { ConfigValidationError, ModuleConfig } from './config.types'\nimport type { ConfigNamespace } from './register-as'\nimport { ConfigService } from './services/config.service'\n\n/**\n * Any config namespace - uses structural typing for flexibility\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyConfigNamespace = ConfigNamespace<string, any, object>\n\n/**\n * Options for ConfigModule.forRoot\n */\nexport interface ConfigModuleOptions {\n  /**\n   * Array of config namespaces created via registerAs()\n   */\n  load: AnyConfigNamespace[]\n\n  /**\n   * Optional Zod schema for validating the merged config\n   * Validates the entire config object after all namespaces are merged\n   */\n  validateSchema?: z.ZodType<object>\n}\n\n// Store options for use in onInitialize\nlet moduleOptions: ConfigModuleOptions | null = null\n\n/**\n * ConfigModule\n *\n * Provides configuration management with namespace support.\n * Uses registerAs() to create typed config namespaces that can be injected.\n *\n * @example\n * ```typescript\n * // Define config namespaces\n * const databaseConfig = registerAs('database', (env) => ({\n *   url: env.DATABASE_URL,\n *   maxConnections: 10\n * }))\n *\n * const emailConfig = registerAs('email', (env) => ({\n *   provider: env.EMAIL_PROVIDER,\n *   from: { name: 'App', email: 'noreply@example.com' }\n * }))\n *\n * // Register in module\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       load: [databaseConfig, emailConfig],\n *       validateSchema: AppConfigSchema\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // Inject config\n * constructor(\n *   @inject(CONFIG_TOKENS.ConfigService) private config: IConfigService,\n *   @inject(databaseConfig.KEY) private dbConfig: DatabaseConfig\n * ) {\n *   // Use dot notation\n *   const url = this.config.get('database.url')\n *\n *   // Or inject namespace directly\n *   const url = this.dbConfig.url\n * }\n * ```\n */\n@Module({\n  providers: [\n    // Register the main ConfigService as Singleton so initialization persists\n    {\n      provide: CONFIG_TOKENS.ConfigService,\n      useClass: ConfigService,\n      scope: Scope.Singleton,\n    },\n  ],\n})\nexport class ConfigModule implements OnInitialize {\n  /**\n   * Configure ConfigModule with namespace loaders\n   *\n   * @param options - Configuration options\n   * @returns Dynamic module with config infrastructure\n   */\n  static forRoot(options: ConfigModuleOptions): DynamicModule {\n    moduleOptions = options\n\n    const providers: Provider[] = []\n\n    // Register each namespace config using asProvider()\n    for (const namespace of options.load) {\n      providers.push(namespace.asProvider())\n    }\n\n    return {\n      module: ConfigModule,\n      providers,\n    }\n  }\n\n  /**\n   * Initialize config service with merged namespaces\n   * Called after all providers are registered\n   */\n  onInitialize(context: ModuleContext): void {\n    if (!moduleOptions) {\n      throw new ConfigModuleNotInitializedError()\n    }\n\n    const env = context.container.resolve<unknown>(DI_TOKENS.CloudflareEnv)\n    const configService = context.container.resolve<ConfigService>(CONFIG_TOKENS.ConfigService)\n\n    // Build merged config from all namespaces\n    const mergedConfig: Record<string, unknown> = {}\n\n    for (const namespace of moduleOptions.load) {\n      mergedConfig[namespace.namespace] = namespace.factory(env)\n    }\n\n    // Validate if schema provided\n    if (moduleOptions.validateSchema) {\n      const result = moduleOptions.validateSchema.safeParse(mergedConfig)\n      if (!result.success) {\n        throw new ConfigValidationError(\n          'Configuration validation failed',\n          result.error\n        )\n      }\n    }\n\n    // Initialize ConfigService with merged config\n    configService.initialize(mergedConfig as ModuleConfig)\n\n    context.logger.debug('ConfigModule initialized', {\n      namespaces: moduleOptions.load.map((n) => n.namespace),\n    })\n  }\n}\n","import type { InjectionToken } from 'tsyringe'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { FactoryProvider } from '../module/types'\n\n/**\n * Configuration namespace registration result\n */\nexport interface ConfigNamespace<TKey extends string, TEnv, TConfig extends object> {\n  /** Auto-derived injection token (e.g., 'database' -> Symbol('stratal:config:database')) */\n  readonly KEY: InjectionToken<TConfig>\n  /** The namespace key */\n  readonly namespace: TKey\n  /** The factory function that receives env and returns config */\n  readonly factory: (env: TEnv) => TConfig\n  /**\n   * Returns a provider configuration for use in module registration\n   * Automatically injects DI_TOKENS.CloudflareEnv\n   */\n  asProvider(): FactoryProvider<TConfig>\n}\n\n/**\n * Create a namespaced configuration factory\n * Similar to NestJS registerAs\n *\n * @param namespace - Configuration namespace (e.g., 'database', 'email')\n * @param factory - Factory function receiving env and returning config object\n * @returns ConfigNamespace with token, factory, and asProvider() method\n *\n * @example\n * ```typescript\n * // apps/backend/src/config/database.config.ts\n * export const databaseConfig = registerAs('database', (env: Env) => ({\n *   url: env.DATABASE_URL,\n *   maxConnections: parseInt(env.DATABASE_MAX_CONNECTIONS || '10'),\n * }))\n *\n * // Auto-generates: databaseConfig.KEY = Symbol('stratal:config:database')\n *\n * // Usage in module:\n * // Option 1: Manual provider\n * {\n *   provide: databaseConfig.KEY,\n *   useFactory: databaseConfig.factory,\n *   inject: [DI_TOKENS.CloudflareEnv]\n * }\n *\n * // Option 2: asProvider() helper\n * databaseConfig.asProvider()\n * // Returns: { provide: databaseConfig.KEY, useFactory: ..., inject: [DI_TOKENS.CloudflareEnv] }\n * ```\n */\nexport function registerAs<TKey extends string, TEnv, TConfig extends object>(\n  namespace: TKey,\n  factory: (env: TEnv) => TConfig\n): ConfigNamespace<TKey, TEnv, TConfig> {\n  const KEY = Symbol.for(`stratal:config:${namespace}`) as InjectionToken<TConfig>\n\n  return {\n    KEY,\n    namespace,\n    factory,\n    asProvider(): FactoryProvider<TConfig> {\n      return {\n        provide: KEY,\n        useFactory: factory,\n        inject: [DI_TOKENS.CloudflareEnv],\n      }\n    },\n  }\n}\n\n/**\n * Helper to derive config type from registerAs result\n *\n * @example\n * ```typescript\n * const databaseConfig = registerAs('database', (env) => ({ url: env.DATABASE_URL }))\n * type DatabaseConfig = InferConfigType<typeof databaseConfig>\n * // { url: string }\n * ```\n */\nexport type InferConfigType<T> = T extends ConfigNamespace<string, unknown, infer C> ? C : never\n"],"mappings":"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"}

package/dist/cron/index.d.mts

@@ -0,0 +1,128 @@
+import { s as ApplicationError } from "../index-D69rxo8H.mjs";
+//#region src/cron/cron-job.d.ts
+/**
+ * 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 DataCleanupJob implements CronJob {
+ *   readonly schedule = '0 2 * * *' // Daily at 2 AM UTC
+ *
+ *   constructor(
+ *     @inject(LOGGER_TOKENS.LoggerService) private logger: LoggerService,
+ *   ) {}
+ *
+ *   async execute(controller: ScheduledController): Promise<void> {
+ *     this.logger.info('Running data cleanup')
+ *     await this.cleanupExpiredData()
+ *   }
+ *
+ *   async onError(error: Error): Promise<void> {
+ *     this.logger.error('Data cleanup failed', { error: error.message })
+ *   }
+ * }
+ * ```
+ */
+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>;
+}
+//#endregion
+//#region src/cron/cron-manager.d.ts
+/**
+ * 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.
+ */
+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;
+}
+//#endregion
+//#region src/cron/errors/cron-execution.error.d.ts
+/**
+ * Error thrown when one or more cron jobs fail execution
+ *
+ * This error aggregates failures from multiple jobs that share the same schedule.
+ */
+declare class CronExecutionError extends ApplicationError {
+  constructor(schedule: string, failedJobsCount: number, jobNames: string);
+}
+//#endregion
+export { CronExecutionError, type CronJob, CronManager };
+//# sourceMappingURL=index.d.mts.map