@forinda/kickjs 2.2.1 → 2.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/{adapter-wuoBNkNs.d.mts → adapter-A1E1XBhE.d.mts} +3 -3
  2. package/dist/{adapter-wuoBNkNs.d.mts.map → adapter-A1E1XBhE.d.mts.map} +1 -1
  3. package/dist/{app-module-DOBmxARW.d.mts → app-module-Cotu9TIC.d.mts} +2 -2
  4. package/dist/{app-module-DOBmxARW.d.mts.map → app-module-Cotu9TIC.d.mts.map} +1 -1
  5. package/dist/{application-cYhTEy84.mjs → application-CrlnuJQI.mjs} +5 -5
  6. package/dist/{application-cYhTEy84.mjs.map → application-CrlnuJQI.mjs.map} +1 -1
  7. package/dist/{bootstrap-8_iBHhWp.mjs → bootstrap-Zww8CPRP.mjs} +8 -8
  8. package/dist/bootstrap-Zww8CPRP.mjs.map +1 -0
  9. package/dist/{cache-PufEhr0n.d.mts → cache-CcTzzNdr.d.mts} +1 -1
  10. package/dist/{cache-PufEhr0n.d.mts.map → cache-CcTzzNdr.d.mts.map} +1 -1
  11. package/dist/{chunk-Djztpsb3.mjs → chunk-DkuVAWq_.mjs} +1 -1
  12. package/dist/config/index.d.mts +3 -0
  13. package/dist/config/index.mjs +13 -0
  14. package/dist/config-BszyH8VL.mjs +135 -0
  15. package/dist/config-BszyH8VL.mjs.map +1 -0
  16. package/dist/{container-CcgV8eHL.d.mts → container-BJb34faa.d.mts} +2 -2
  17. package/dist/{container-CcgV8eHL.d.mts.map → container-BJb34faa.d.mts.map} +1 -1
  18. package/dist/{container-BKiJzakw.mjs → container-CnP8G9tl.mjs} +3 -3
  19. package/dist/{container-BKiJzakw.mjs.map → container-CnP8G9tl.mjs.map} +1 -1
  20. package/dist/core/adapter.d.mts +1 -1
  21. package/dist/core/adapter.mjs +1 -1
  22. package/dist/core/app-module.d.mts +1 -1
  23. package/dist/core/app-module.mjs +1 -1
  24. package/dist/core/cache.d.mts +1 -1
  25. package/dist/core/cache.mjs +1 -1
  26. package/dist/core/container.d.mts +1 -1
  27. package/dist/core/container.mjs +2 -2
  28. package/dist/core/cron.d.mts +1 -1
  29. package/dist/core/cron.mjs +2 -2
  30. package/dist/core/decorators.d.mts +1 -1
  31. package/dist/core/decorators.mjs +3 -3
  32. package/dist/core/errors.d.mts +1 -1
  33. package/dist/core/errors.mjs +1 -1
  34. package/dist/core/interfaces.d.mts +1 -1
  35. package/dist/core/interfaces.mjs +1 -1
  36. package/dist/core/logger.d.mts +1 -1
  37. package/dist/core/logger.mjs +1 -1
  38. package/dist/core/path.d.mts +1 -1
  39. package/dist/core/path.mjs +1 -1
  40. package/dist/core/plugin.d.mts +1 -1
  41. package/dist/core/plugin.mjs +1 -1
  42. package/dist/core/reactivity.d.mts +1 -1
  43. package/dist/core/reactivity.mjs +1 -1
  44. package/dist/{core-CXHuViXn.mjs → core-CBy6sBw_.mjs} +4 -4
  45. package/dist/{core-CXHuViXn.mjs.map → core-CBy6sBw_.mjs.map} +1 -1
  46. package/dist/{cron-C29iHvHT.d.mts → cron-H-IyLcOr.d.mts} +1 -1
  47. package/dist/{cron-C29iHvHT.d.mts.map → cron-H-IyLcOr.d.mts.map} +1 -1
  48. package/dist/{decorators-D3lBlmud.d.mts → decorators-C9_SN7ge.d.mts} +2 -2
  49. package/dist/{decorators-D3lBlmud.d.mts.map → decorators-C9_SN7ge.d.mts.map} +1 -1
  50. package/dist/env-CtsOktU_.mjs +111 -0
  51. package/dist/env-CtsOktU_.mjs.map +1 -0
  52. package/dist/{errors-BZUdxtjC.d.mts → errors-BX7Zosvv.d.mts} +1 -1
  53. package/dist/{errors-BZUdxtjC.d.mts.map → errors-BX7Zosvv.d.mts.map} +1 -1
  54. package/dist/http/application.d.mts +4 -4
  55. package/dist/http/application.mjs +2 -2
  56. package/dist/http/bootstrap.mjs +2 -2
  57. package/dist/http/context.d.mts +1 -1
  58. package/dist/http/context.mjs +2 -2
  59. package/dist/http/middleware/cors.mjs +1 -1
  60. package/dist/http/middleware/csrf.mjs +1 -1
  61. package/dist/http/middleware/error-handler.mjs +2 -2
  62. package/dist/http/middleware/helmet.mjs +1 -1
  63. package/dist/http/middleware/rate-limit.mjs +1 -1
  64. package/dist/http/middleware/request-id.mjs +1 -1
  65. package/dist/http/middleware/request-logger.mjs +2 -2
  66. package/dist/http/middleware/session.mjs +1 -1
  67. package/dist/http/middleware/spa.d.mts +1 -1
  68. package/dist/http/middleware/spa.mjs +3 -3
  69. package/dist/http/middleware/upload.d.mts +1 -1
  70. package/dist/http/middleware/upload.mjs +1 -1
  71. package/dist/http/middleware/validate.mjs +1 -1
  72. package/dist/http/middleware/views.d.mts +1 -1
  73. package/dist/http/middleware/views.mjs +2 -2
  74. package/dist/http/query/index.d.mts +1 -1
  75. package/dist/http/query/index.mjs +2 -2
  76. package/dist/http/router-builder.mjs +4 -4
  77. package/dist/{index-4VM4dUJf.d.mts → index-BGnxOrN2.d.mts} +1 -1
  78. package/dist/{index-4VM4dUJf.d.mts.map → index-BGnxOrN2.d.mts.map} +1 -1
  79. package/dist/index-Cmq_UBmJ.d.mts +228 -0
  80. package/dist/index-Cmq_UBmJ.d.mts.map +1 -0
  81. package/dist/{index-rnK23QBD.d.mts → index-Co7a3Zat.d.mts} +1 -1
  82. package/dist/{index-rnK23QBD.d.mts.map → index-Co7a3Zat.d.mts.map} +1 -1
  83. package/dist/index.d.mts +16 -15
  84. package/dist/index.d.mts.map +1 -1
  85. package/dist/index.mjs +10 -8
  86. package/dist/index.mjs.map +1 -1
  87. package/dist/{interfaces-D5ohYl6D.d.mts → interfaces-DXjE8Re1.d.mts} +1 -1
  88. package/dist/{interfaces-D5ohYl6D.d.mts.map → interfaces-DXjE8Re1.d.mts.map} +1 -1
  89. package/dist/{logger-BLdfUF5b.d.mts → logger-CW6FHtvU.d.mts} +1 -1
  90. package/dist/{logger-BLdfUF5b.d.mts.map → logger-CW6FHtvU.d.mts.map} +1 -1
  91. package/dist/{metadata-D5L3_cdl.mjs → metadata-UdEcgIBJ.mjs} +2 -2
  92. package/dist/{metadata-D5L3_cdl.mjs.map → metadata-UdEcgIBJ.mjs.map} +1 -1
  93. package/dist/{path-Dq5V-i-x.d.mts → path-B4JcbwKX.d.mts} +1 -1
  94. package/dist/path-B4JcbwKX.d.mts.map +1 -0
  95. package/dist/{plugin-D20muJwC.d.mts → plugin-DcDVlPTI.d.mts} +4 -4
  96. package/dist/{plugin-D20muJwC.d.mts.map → plugin-DcDVlPTI.d.mts.map} +1 -1
  97. package/dist/{query-BSIApo6Y.mjs → query-BhHetB5I.mjs} +2 -2
  98. package/dist/{query-BSIApo6Y.mjs.map → query-BhHetB5I.mjs.map} +1 -1
  99. package/dist/{reactivity-CMAQh0gi.d.mts → reactivity-I8nDlg4c.d.mts} +1 -1
  100. package/dist/{reactivity-CMAQh0gi.d.mts.map → reactivity-I8nDlg4c.d.mts.map} +1 -1
  101. package/package.json +13 -2
  102. package/dist/bootstrap-8_iBHhWp.mjs.map +0 -1
  103. package/dist/path-Dq5V-i-x.d.mts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"container-BKiJzakw.mjs","names":[],"sources":["../src/core/token.ts","../src/core/container.ts"],"sourcesContent":["/**\n * Collision-safe injection tokens with phantom type parameters.\n *\n * `createToken<T>(name)` is the recommended way to declare any DI token\n * that isn't a class. Each call returns a unique frozen object — even if\n * two files write `createToken<X>('Logger')`, they produce two distinct\n * references that the container treats as different tokens. Collisions\n * become impossible by construction, not by convention.\n *\n * The phantom type parameter `T` lets `container.resolve(token)` infer\n * the correct return type without any codegen.\n *\n * ## Hardening layers\n *\n * KickJS has four DI token kinds, listed from safest to riskiest:\n *\n * 1. **Class identity** — `container.resolve(UserService)`. Reference\n * equality, never collides. Type-safe via `Constructor<T>` overload.\n * 2. **`createToken<T>(name)`** — frozen object identity, never collides.\n * Type-safe via the `InjectionToken<T>` overload.\n * 3. **Symbol** — `Symbol('foo')` is unique per call but `Symbol.for('foo')`\n * is interned and CAN collide. Discouraged.\n * 4. **Raw string `@Inject('foo')`** — high collision risk, untyped.\n * Reserved for legacy code and runtime-computed token names.\n *\n * Prefer (1) and (2). Use (4) only when you have to.\n *\n * @example\n * ```ts\n * // src/tokens.ts\n * export const DATABASE_URL = createToken<string>('config.database.url')\n * export const FEATURE_FLAGS = createToken<FeatureFlags>('app.features')\n *\n * // bootstrap\n * container.registerInstance(DATABASE_URL, process.env.DATABASE_URL!)\n *\n * // anywhere else\n * const url = container.resolve(DATABASE_URL) // typed as `string`\n * ```\n *\n * @module @forinda/kickjs/core/token\n */\n\n/**\n * Symbol marker stamped on every InjectionToken so the container can\n * detect them at runtime regardless of which package created them.\n *\n * Uses `Symbol.for()` so cross-package isolation (different copies of\n * `@forinda/kickjs` loaded under different module identities) still\n * shares the same marker.\n */\nexport const INJECTION_TOKEN: unique symbol = Symbol.for('@kickjs/InjectionToken') as never\n\n/**\n * A type-safe DI token. Each `createToken()` call returns a unique frozen\n * object identified by reference, not by the `name` string. Two\n * `createToken<X>('foo')` calls in different files produce two distinct\n * tokens that the container treats independently.\n *\n * The phantom `_type` parameter is never assigned at runtime — it exists\n * solely to thread the type through `container.resolve(token)`.\n */\nexport interface InjectionToken<T> {\n readonly [INJECTION_TOKEN]: true\n /** Descriptive name used in error messages, logs, and devtools */\n readonly name: string\n /** Phantom — never assigned at runtime */\n readonly _type?: T\n}\n\n/**\n * Create a collision-safe injection token.\n *\n * The returned token is a frozen object identified by reference, not by\n * the `name` string. The `name` is used only for error messages, logs,\n * and debugging.\n */\nexport function createToken<T>(name: string): InjectionToken<T> {\n return Object.freeze({\n [INJECTION_TOKEN]: true as const,\n name,\n })\n}\n\n/** Type guard — returns `true` if `value` is an InjectionToken */\nexport function isInjectionToken(value: unknown): value is InjectionToken<unknown> {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as Record<symbol, unknown>)[INJECTION_TOKEN] === true\n )\n}\n","import 'reflect-metadata'\nimport {\n Constructor,\n Scope,\n METADATA,\n type ClassKind,\n type PostConstructStatus,\n} from './interfaces'\nimport { createLogger } from './logger'\nimport {\n getClassMeta,\n getClassMetaOrUndefined,\n getMetaMap,\n getMetaRecord,\n getMethodMetaOrUndefined,\n} from './metadata'\nimport { isInjectionToken, type InjectionToken } from './token'\n\nconst log = createLogger('Container')\n\n/** Internal registration entry that tracks how a dependency should be resolved */\ninterface Registration {\n target: Constructor\n scope: Scope\n instance?: any\n factory?: () => any\n // Observability fields\n kind: ClassKind\n resolveCount: number\n lastResolvedAt?: number\n firstResolvedAt?: number\n resolveDurationMs?: number\n postConstructStatus: PostConstructStatus\n dependencies: string[]\n}\n\n/** Create a Registration with observability defaults */\nfunction createReg(\n fields: Partial<Registration> & Pick<Registration, 'target' | 'scope'>,\n): Registration {\n return {\n kind: 'unknown',\n resolveCount: 0,\n postConstructStatus: 'skipped',\n dependencies: [],\n ...fields,\n }\n}\n\n/** Format a token for display in error messages */\nexport function tokenName(token: any): string {\n if (typeof token === 'symbol') return token.toString()\n if (isInjectionToken(token)) return token.name\n return token?.name || String(token)\n}\n\n// ── Persistent Store ────────────────────────────────────────────────────\n// globalThis-based storage that survives BOTH Container.reset() AND Vite's\n// ssrLoadModule() re-evaluation. When Vite re-evaluates a module, the\n// Container class gets a new identity (new statics). But globalThis persists.\n//\n// This is how DB connections, Redis clients, WsAdapter instances, and any\n// other stateful bindings survive HMR without being dropped.\n//\n// Pattern from: React Router (globalThis for state), Vinxi (globalThis.app)\n\n// ── Change Event System ─────────────────────────────────────────────────\n// Batched (50ms debounce) so `kick g module` creating 10+ files emits ONE\n// notification, not 10. Any adapter can subscribe: Swagger, DevTools, WS, etc.\n\n/** A single container change event */\nexport interface ContainerChangeEvent {\n token: string\n event: 'registered' | 'resolved' | 'invalidated'\n kind?: ClassKind\n timestamp: number\n}\n\n/** Listener that receives batched change events */\nexport type ContainerChangeListener = (changes: ContainerChangeEvent[]) => void\n\n/**\n * Type-safe registry of string DI tokens. Augmented by `kick typegen` —\n * the generated `.kickjs/types/registry.d.ts` adds entries like:\n *\n * ```ts\n * declare module '@forinda/kickjs' {\n * interface KickJsRegistry {\n * UserService: import('../../src/modules/users/user.service').UserService\n * }\n * }\n * ```\n *\n * Once typegen has run, `container.resolve('UserService')` returns the\n * correct type instead of `any`. Class-token resolution\n * (`container.resolve(UserService)`) is already type-safe via the\n * `Constructor<T>` overload and does not need typegen.\n */\nexport interface KickJsRegistry {}\n\ninterface PersistentStore {\n factories: Array<{ token: any; factory: () => any; scope: Scope }>\n instances: Array<{ token: any; instance: any }>\n /** Resolved instances keyed by string name — survives class identity changes */\n resolvedInstances: Map<string, any>\n}\n\nfunction getPersistentStore(): PersistentStore {\n if (!(globalThis as any).__kickjs_persistent) {\n ;(globalThis as any).__kickjs_persistent = {\n factories: [],\n instances: [],\n resolvedInstances: new Map(),\n } satisfies PersistentStore\n }\n return (globalThis as any).__kickjs_persistent\n}\n\n/**\n * Inversion-of-Control (IoC) container that manages dependency registration,\n * resolution, and lifecycle. Implements the Singleton pattern so all parts of\n * the application share a single container instance.\n *\n * Supports constructor injection, property injection (@Autowired),\n * factory registrations, and lifecycle hooks (@PostConstruct).\n *\n * Persistent state (DB connections, Redis, etc.) is stored on globalThis so\n * it survives both Container.reset() and Vite module re-evaluation.\n */\nexport class Container {\n private static instance: Container\n private registrations = new Map<any, Registration>()\n private resolving = new Set<any>()\n\n // ── Reactive change tracking ──────────────────────────────────────\n private changeListeners = new Set<ContainerChangeListener>()\n private pendingChanges: ContainerChangeEvent[] = []\n private notifyTimer: ReturnType<typeof setTimeout> | null = null\n private static readonly DEBOUNCE_MS = 50\n\n /** Callback set by the decorators module to flush pending registrations */\n static _onReady: ((container: Container) => void) | null = null\n /** Callback invoked on reset so decorators can update their container reference */\n static _onReset: ((container: Container) => void) | null = null\n /**\n * Environment resolver for @Value decorator. Set by @forinda/kickjs-config\n * to return Zod-validated, type-coerced env values instead of raw process.env strings.\n */\n static _envResolver: ((key: string) => any) | null = null\n /**\n * Request store provider for REQUEST-scoped DI. Set by @forinda/kickjs-http\n * to return the current request's AsyncLocalStorage store.\n * Returns { instances: Map, values: Map } or null if outside a request.\n */\n static _requestStoreProvider:\n | (() => { instances: Map<any, any>; values: Map<any, any> } | null)\n | null = null\n\n static getInstance(): Container {\n if (!Container.instance) {\n Container.instance = new Container()\n }\n // Flush any decorator registrations that queued before the container existed\n if (Container._onReady) {\n Container._onReady(Container.instance)\n Container._onReady = null\n }\n return Container.instance\n }\n\n /**\n * Resets the container by replacing the singleton with a fresh instance.\n * Persistent registrations (DB, Redis, etc.) are replayed from globalThis\n * so they survive both reset() and Vite module re-evaluation.\n */\n static reset(): void {\n Container.instance = new Container()\n // Notify decorators so they update their container reference\n Container._onReset?.(Container.instance)\n // Replay persistent registrations from globalThis store\n const store = getPersistentStore()\n for (const { token, factory, scope } of store.factories) {\n if (!Container.instance.has(token)) {\n // Check if we have a previously resolved instance for this token\n const name = tokenName(token)\n const existing = store.resolvedInstances.get(name)\n Container.instance.registrations.set(\n token,\n createReg({\n target: Object as any,\n scope,\n factory,\n kind: 'factory',\n instance: existing, // Reuse resolved instance if available\n resolveCount: existing ? 1 : 0,\n postConstructStatus: existing ? 'completed' : 'skipped',\n }),\n )\n }\n }\n for (const { token, instance } of store.instances) {\n if (!Container.instance.has(token)) {\n Container.instance.registrations.set(\n token,\n createReg({\n target: instance.constructor,\n scope: Scope.SINGLETON,\n instance,\n kind: 'instance',\n postConstructStatus: 'completed',\n resolveCount: 1,\n }),\n )\n }\n }\n }\n\n /**\n * Create an isolated container instance (not the global singleton).\n * Useful for concurrent tests that must not share DI state.\n *\n * @example\n * ```ts\n * const container = Container.create()\n * container.register(UserService, UserService)\n * const svc = container.resolve(UserService)\n * ```\n */\n static create(): Container {\n return new Container()\n }\n\n /** Register a class constructor under the given token */\n register(token: any, target: Constructor, scope: Scope = Scope.SINGLETON): void {\n const kind = getClassMeta<ClassKind>(METADATA.CLASS_KIND, target, 'unknown')\n const dependencies = this.extractDependencies(target)\n const reg = createReg({ target, scope, kind, dependencies })\n this.registrations.set(token, reg)\n // Store a name-based fallback so HMR class re-creation (new identity)\n // can still resolve by the original class name.\n if (typeof token === 'function' && token.name) {\n this.registrations.set(`__hmr__${token.name}`, reg)\n }\n this.emit(tokenName(token), 'registered', kind)\n }\n\n /** Register a factory function under the given token */\n registerFactory(token: any, factory: () => any, scope: Scope = Scope.SINGLETON): void {\n const store = getPersistentStore()\n const name = tokenName(token)\n // Check if we already have a resolved instance from a previous HMR cycle.\n // Only reuse if the factory hasn't changed (same reference). When a new\n // factory is provided (e.g. swapping implementations), clear the stale\n // instance so the new factory runs on next resolve.\n const existingEntry = store.factories.find((r) => tokenName(r.token) === name)\n const factoryUnchanged = existingEntry?.factory === factory\n const existingInstance = factoryUnchanged ? store.resolvedInstances.get(name) : undefined\n\n // Clear stale resolved instance when factory changes\n if (!factoryUnchanged) {\n store.resolvedInstances.delete(name)\n }\n\n this.registrations.set(\n token,\n createReg({\n target: Object as any,\n scope,\n factory,\n kind: 'factory',\n instance: existingInstance,\n resolveCount: existingInstance ? 1 : 0,\n postConstructStatus: existingInstance ? 'completed' : 'skipped',\n }),\n )\n // Track in globalThis for persistence across HMR + module re-evaluation\n const idx = store.factories.findIndex((r) => tokenName(r.token) === name)\n if (idx >= 0) {\n store.factories[idx] = { token, factory, scope }\n } else {\n store.factories.push({ token, factory, scope })\n }\n this.emit(name, 'registered', 'factory')\n }\n\n /** Register a pre-constructed singleton instance */\n registerInstance(token: any, instance: any): void {\n const store = getPersistentStore()\n const name = tokenName(token)\n\n this.registrations.set(\n token,\n createReg({\n target: instance.constructor,\n scope: Scope.SINGLETON,\n instance,\n kind: 'instance',\n postConstructStatus: 'completed',\n resolveCount: 1,\n firstResolvedAt: Date.now(),\n lastResolvedAt: Date.now(),\n }),\n )\n // Track in globalThis for persistence across HMR + module re-evaluation\n store.resolvedInstances.set(name, instance)\n const idx = store.instances.findIndex((r) => tokenName(r.token) === name)\n if (idx >= 0) {\n store.instances[idx] = { token, instance }\n } else {\n store.instances.push({ token, instance })\n }\n this.emit(name, 'registered', 'instance')\n }\n\n /** Check if a binding exists for the given token */\n has(token: any): boolean {\n return this.registrations.has(token)\n }\n\n /** Return a snapshot of all registered tokens with their scope and instantiation status */\n getRegistrations(): Array<{\n token: string\n scope: string\n kind: ClassKind\n instantiated: boolean\n resolveCount: number\n lastResolvedAt?: number\n firstResolvedAt?: number\n resolveDurationMs?: number\n postConstructStatus: PostConstructStatus\n dependencies: string[]\n }> {\n const entries: Array<ReturnType<Container['getRegistrations']>[number]> = []\n for (const [token, reg] of this.registrations) {\n entries.push({\n token: tokenName(token),\n scope: reg.scope,\n kind: reg.kind,\n // Singletons check cached instance; transients check resolveCount\n instantiated:\n reg.scope === Scope.SINGLETON ? reg.instance !== undefined : reg.resolveCount > 0,\n resolveCount: reg.resolveCount,\n lastResolvedAt: reg.lastResolvedAt,\n firstResolvedAt: reg.firstResolvedAt,\n resolveDurationMs: reg.resolveDurationMs,\n postConstructStatus: reg.postConstructStatus,\n dependencies: reg.dependencies,\n })\n }\n return entries\n }\n\n /**\n * Resolve a dependency by its token.\n *\n * Four overloads, in order of preference:\n * - **`InjectionToken<T>`** (from `createToken<T>(name)`) → returns `T`.\n * Collision-safe by construction; no codegen required.\n * - **Class constructor** → returns an instance of that class. Always\n * type-safe; no codegen required.\n * - **String token in `KickJsRegistry`** (populated by `kick typegen`) →\n * returns the augmented type.\n * - **Anything else** → returns `any`. Use this only for legacy code or\n * string tokens that haven't been registered with typegen yet.\n */\n resolve<T>(token: InjectionToken<T>): T\n resolve<T>(token: Constructor<T>): T\n resolve<K extends keyof KickJsRegistry & string>(token: K): KickJsRegistry[K]\n resolve<T = any>(token: any): T\n resolve<T = any>(token: any): T {\n let reg = this.registrations.get(token)\n // HMR fallback: when Vite re-evaluates a module, decorated classes get new\n // identity. Try resolving by class name if the primary token lookup fails.\n if (!reg && typeof token === 'function' && token.name) {\n reg = this.registrations.get(`__hmr__${token.name}`)\n }\n if (!reg) {\n throw new Error(`No binding found for: ${tokenName(token)}`)\n }\n\n if (reg.scope === Scope.SINGLETON && reg.instance !== undefined) {\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n return reg.instance\n }\n\n // REQUEST scope: one instance per HTTP request, cached in AsyncLocalStorage\n if (reg.scope === Scope.REQUEST) {\n if (!Container._requestStoreProvider) {\n throw new Error(\n `Cannot resolve REQUEST-scoped \"${tokenName(token)}\": no request store provider configured. ` +\n `Ensure requestScopeMiddleware() is in your middleware pipeline.`,\n )\n }\n const store = Container._requestStoreProvider()\n if (!store) {\n throw new Error(\n `Cannot resolve REQUEST-scoped \"${tokenName(token)}\" outside an HTTP request context.`,\n )\n }\n // Check for pre-registered request values (user, tenant, etc.)\n if (store.values.has(token)) {\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n return store.values.get(token) as T\n }\n // Check per-request instance cache\n if (store.instances.has(token)) {\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n return store.instances.get(token) as T\n }\n // Create instance and cache for this request only\n const start = performance.now()\n const instance = this.createInstance(reg)\n reg.resolveDurationMs = performance.now() - start\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n if (!reg.firstResolvedAt) reg.firstResolvedAt = Date.now()\n store.instances.set(token, instance)\n return instance as T\n }\n\n if (reg.factory) {\n const start = performance.now()\n const instance = reg.factory()\n reg.resolveDurationMs = performance.now() - start\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n if (!reg.firstResolvedAt) reg.firstResolvedAt = Date.now()\n if (reg.scope === Scope.SINGLETON) {\n reg.instance = instance\n // Persist resolved factory instances so they survive module re-evaluation\n getPersistentStore().resolvedInstances.set(tokenName(token), instance)\n }\n return instance\n }\n\n if (this.resolving.has(token)) {\n const chain = [...this.resolving].map(tokenName)\n chain.push(tokenName(token))\n throw new Error(`Circular dependency detected: ${chain.join(' -> ')}`)\n }\n this.resolving.add(token)\n\n try {\n const start = performance.now()\n const instance = this.createInstance(reg)\n reg.resolveDurationMs = performance.now() - start\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n if (!reg.firstResolvedAt) reg.firstResolvedAt = Date.now()\n if (reg.scope === Scope.SINGLETON) {\n reg.instance = instance\n }\n return instance\n } finally {\n this.resolving.delete(token)\n }\n }\n\n /** Lifecycle hook called during Application.setup() after module registration */\n bootstrap(): void {\n // Reserved for future use — adapters and modules register via\n // container.register(), registerFactory(), and registerInstance().\n }\n\n // ── Reactive Change API ─────────────────────────────────────────────\n\n /**\n * Subscribe to container changes. Returns an unsubscribe function.\n *\n * Changes are batched (50ms debounce) so bulk operations like\n * `kick g module` creating 10+ files emit ONE batch, not 10 events.\n *\n * Any adapter can subscribe:\n * - SwaggerAdapter: re-build spec when controllers change\n * - DevToolsAdapter: push SSE events to dashboard\n * - WsAdapter: re-discover namespaces when controllers change\n * - OtelAdapter: emit tracing spans for DI resolution\n * - Custom user adapters\n *\n * @example\n * ```ts\n * const unsub = container.onChange((changes) => {\n * for (const c of changes) {\n * console.log(`${c.event}: ${c.token} (${c.kind})`)\n * }\n * })\n * // later:\n * unsub()\n * ```\n */\n onChange(callback: ContainerChangeListener): () => void {\n this.changeListeners.add(callback)\n return () => this.changeListeners.delete(callback)\n }\n\n /**\n * Invalidate a specific registration. Clears the cached instance so the\n * next resolve() creates a fresh one. Also invalidates dependents\n * (anything that injected this token) by walking the dependency graph.\n *\n * Called by the Vite HMR plugin when a module file changes.\n * Skips persistent registrations (DB connections, etc.).\n */\n invalidate(token: any): void {\n const name = tokenName(token)\n // Try both the token itself and the HMR fallback name\n const reg = this.registrations.get(token) ?? this.registrations.get(`__hmr__${name}`)\n if (!reg) return\n\n // Don't invalidate persistent registrations (DB, Redis, etc.)\n const store = getPersistentStore()\n if (store.resolvedInstances.has(name)) return\n\n // Clear cached instance — next resolve() will re-create\n reg.instance = undefined\n reg.resolveCount = 0\n reg.postConstructStatus = 'skipped'\n this.emit(name, 'invalidated', reg.kind)\n\n // Walk dependency graph — invalidate anything that injected this token\n for (const [depToken, depReg] of this.registrations) {\n if (depReg.dependencies.includes(name)) {\n this.invalidate(depToken)\n }\n }\n }\n\n /** Batch-emit a change event (debounced, flushed after 50ms of quiet) */\n private emit(token: string, event: ContainerChangeEvent['event'], kind?: ClassKind): void {\n this.pendingChanges.push({ token, event, kind, timestamp: Date.now() })\n\n if (this.notifyTimer) clearTimeout(this.notifyTimer)\n this.notifyTimer = setTimeout(() => {\n const batch = this.pendingChanges.splice(0)\n if (batch.length === 0) return\n for (const listener of this.changeListeners) {\n try {\n listener(batch)\n } catch {\n // Don't let one broken listener break others\n }\n }\n }, Container.DEBOUNCE_MS)\n }\n\n /** Flush pending change events immediately (useful in tests) */\n flushChanges(): void {\n if (this.notifyTimer) {\n clearTimeout(this.notifyTimer)\n this.notifyTimer = null\n }\n const batch = this.pendingChanges.splice(0)\n if (batch.length === 0) return\n for (const listener of this.changeListeners) {\n try {\n listener(batch)\n } catch {\n // Don't let one broken listener break others\n }\n }\n }\n\n private createInstance(reg: Registration): any {\n const paramTypes = getClassMeta<Constructor[]>(METADATA.PARAM_TYPES, reg.target, [])\n\n const args = paramTypes.map((paramType, index) => {\n // Check for @Inject token override on constructor parameter\n const injectTokens = getMetaRecord<any>(METADATA.INJECT, reg.target)\n const token = injectTokens[index] || paramType\n // Scope validation: SINGLETON cannot inject REQUEST-scoped dependencies\n if (reg.scope === Scope.SINGLETON) {\n const depReg = this.registrations.get(token)\n if (depReg && depReg.scope === Scope.REQUEST) {\n throw new Error(\n `Cannot inject REQUEST-scoped \"${tokenName(token)}\" into SINGLETON \"${tokenName(reg.target)}\". ` +\n `Singletons outlive requests. Use TRANSIENT or REQUEST scope for the parent.`,\n )\n }\n }\n return this.resolve(token)\n })\n\n const instance = new reg.target(...args)\n\n // Property injection via @Autowired\n this.injectProperties(instance, reg.target)\n\n // @PostConstruct lifecycle hook\n const postConstruct = getClassMetaOrUndefined<string | symbol>(\n METADATA.POST_CONSTRUCT,\n reg.target.prototype,\n )\n if (postConstruct && typeof instance[postConstruct] === 'function') {\n try {\n const result = instance[postConstruct]()\n if (result && typeof result.then === 'function') {\n reg.postConstructStatus = 'pending'\n ;(result as Promise<void>)\n .then(() => {\n reg.postConstructStatus = 'completed'\n })\n .catch(() => {\n reg.postConstructStatus = 'failed'\n })\n log.warn(\n `@PostConstruct on ${tokenName(reg.target)}.${String(postConstruct)}() returned a Promise ` +\n `but the container is synchronous. The async operation will not be awaited.`,\n )\n } else {\n reg.postConstructStatus = 'completed'\n }\n } catch (err) {\n reg.postConstructStatus = 'failed'\n log.error(\n err,\n `@PostConstruct on ${tokenName(reg.target)}.${String(postConstruct)}() threw an error`,\n )\n }\n }\n\n return instance\n }\n\n /** Extract dependency token names from constructor metadata */\n private extractDependencies(target: Constructor): string[] {\n const paramTypes = getClassMeta<Constructor[]>(METADATA.PARAM_TYPES, target, [])\n const injectTokens = getMetaRecord<any>(METADATA.INJECT, target)\n return paramTypes.map((type, index) => {\n const token = injectTokens[index] || type\n return tokenName(token)\n })\n }\n\n private injectProperties(instance: any, target: Constructor): void {\n // @Autowired — lazy DI property injection\n const autowiredProps = getMetaMap<string, any>(METADATA.AUTOWIRED, target.prototype)\n\n for (const [prop, token] of autowiredProps) {\n const resolvedToken =\n token || getMethodMetaOrUndefined(METADATA.PROPERTY_TYPE, target.prototype, prop)\n if (resolvedToken) {\n Object.defineProperty(instance, prop, {\n get: () => this.resolve(resolvedToken),\n enumerable: true,\n configurable: true,\n })\n }\n }\n\n // @Value — lazy environment variable injection\n const valueProps = getMetaMap<string, { envKey: string; defaultValue?: any }>(\n METADATA.VALUE,\n target.prototype,\n )\n\n for (const [prop, config] of valueProps) {\n Object.defineProperty(instance, prop, {\n get() {\n // Use the registered env resolver if available (set by @forinda/kickjs-config)\n // This returns Zod-validated, type-coerced values (e.g. PORT as number)\n if (Container._envResolver) {\n const val = Container._envResolver(config.envKey)\n if (val !== undefined) return val\n }\n\n // Fallback to raw process.env for apps not using @forinda/kickjs-config\n const val = process.env[config.envKey]\n if (val !== undefined) return val\n if (config.defaultValue !== undefined) return config.defaultValue\n throw new Error(\n `@Value('${config.envKey}'): Environment variable \"${config.envKey}\" is not set and no default was provided.`,\n )\n },\n enumerable: true,\n configurable: true,\n })\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,kBAAiC,OAAO,IAAI,yBAAyB;;;;;;;;AA0BlF,SAAgB,YAAe,MAAiC;AAC9D,QAAO,OAAO,OAAO;GAClB,kBAAkB;EACnB;EACD,CAAC;;;AAIJ,SAAgB,iBAAiB,OAAkD;AACjF,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,qBAAqB;;;;ACvE5D,MAAM,MAAM,aAAa,YAAY;;AAmBrC,SAAS,UACP,QACc;AACd,QAAO;EACL,MAAM;EACN,cAAc;EACd,qBAAqB;EACrB,cAAc,EAAE;EAChB,GAAG;EACJ;;;AAIH,SAAgB,UAAU,OAAoB;AAC5C,KAAI,OAAO,UAAU,SAAU,QAAO,MAAM,UAAU;AACtD,KAAI,iBAAiB,MAAM,CAAE,QAAO,MAAM;AAC1C,QAAO,OAAO,QAAQ,OAAO,MAAM;;AAsDrC,SAAS,qBAAsC;AAC7C,KAAI,CAAE,WAAmB,oBACrB,YAAmB,sBAAsB;EACzC,WAAW,EAAE;EACb,WAAW,EAAE;EACb,mCAAmB,IAAI,KAAK;EAC7B;AAEH,QAAQ,WAAmB;;;;;;;;;;;;;AAc7B,IAAa,YAAb,MAAa,UAAU;CACrB,OAAe;CACf,gCAAwB,IAAI,KAAwB;CACpD,4BAAoB,IAAI,KAAU;CAGlC,kCAA0B,IAAI,KAA8B;CAC5D,iBAAiD,EAAE;CACnD,cAA4D;CAC5D,OAAwB,cAAc;;CAGtC,OAAO,WAAoD;;CAE3D,OAAO,WAAoD;;;;;CAK3D,OAAO,eAA8C;;;;;;CAMrD,OAAO,wBAEI;CAEX,OAAO,cAAyB;AAC9B,MAAI,CAAC,UAAU,SACb,WAAU,WAAW,IAAI,WAAW;AAGtC,MAAI,UAAU,UAAU;AACtB,aAAU,SAAS,UAAU,SAAS;AACtC,aAAU,WAAW;;AAEvB,SAAO,UAAU;;;;;;;CAQnB,OAAO,QAAc;AACnB,YAAU,WAAW,IAAI,WAAW;AAEpC,YAAU,WAAW,UAAU,SAAS;EAExC,MAAM,QAAQ,oBAAoB;AAClC,OAAK,MAAM,EAAE,OAAO,SAAS,WAAW,MAAM,UAC5C,KAAI,CAAC,UAAU,SAAS,IAAI,MAAM,EAAE;GAElC,MAAM,OAAO,UAAU,MAAM;GAC7B,MAAM,WAAW,MAAM,kBAAkB,IAAI,KAAK;AAClD,aAAU,SAAS,cAAc,IAC/B,OACA,UAAU;IACR,QAAQ;IACR;IACA;IACA,MAAM;IACN,UAAU;IACV,cAAc,WAAW,IAAI;IAC7B,qBAAqB,WAAW,cAAc;IAC/C,CAAC,CACH;;AAGL,OAAK,MAAM,EAAE,OAAO,cAAc,MAAM,UACtC,KAAI,CAAC,UAAU,SAAS,IAAI,MAAM,CAChC,WAAU,SAAS,cAAc,IAC/B,OACA,UAAU;GACR,QAAQ,SAAS;GACjB,OAAO,MAAM;GACb;GACA,MAAM;GACN,qBAAqB;GACrB,cAAc;GACf,CAAC,CACH;;;;;;;;;;;;;CAgBP,OAAO,SAAoB;AACzB,SAAO,IAAI,WAAW;;;CAIxB,SAAS,OAAY,QAAqB,QAAe,MAAM,WAAiB;EAC9E,MAAM,OAAO,aAAwB,SAAS,YAAY,QAAQ,UAAU;EAE5E,MAAM,MAAM,UAAU;GAAE;GAAQ;GAAO;GAAM,cADxB,KAAK,oBAAoB,OAAO;GACM,CAAC;AAC5D,OAAK,cAAc,IAAI,OAAO,IAAI;AAGlC,MAAI,OAAO,UAAU,cAAc,MAAM,KACvC,MAAK,cAAc,IAAI,UAAU,MAAM,QAAQ,IAAI;AAErD,OAAK,KAAK,UAAU,MAAM,EAAE,cAAc,KAAK;;;CAIjD,gBAAgB,OAAY,SAAoB,QAAe,MAAM,WAAiB;EACpF,MAAM,QAAQ,oBAAoB;EAClC,MAAM,OAAO,UAAU,MAAM;EAM7B,MAAM,mBADgB,MAAM,UAAU,MAAM,MAAM,UAAU,EAAE,MAAM,KAAK,KAAK,EACtC,YAAY;EACpD,MAAM,mBAAmB,mBAAmB,MAAM,kBAAkB,IAAI,KAAK,GAAG,KAAA;AAGhF,MAAI,CAAC,iBACH,OAAM,kBAAkB,OAAO,KAAK;AAGtC,OAAK,cAAc,IACjB,OACA,UAAU;GACR,QAAQ;GACR;GACA;GACA,MAAM;GACN,UAAU;GACV,cAAc,mBAAmB,IAAI;GACrC,qBAAqB,mBAAmB,cAAc;GACvD,CAAC,CACH;EAED,MAAM,MAAM,MAAM,UAAU,WAAW,MAAM,UAAU,EAAE,MAAM,KAAK,KAAK;AACzE,MAAI,OAAO,EACT,OAAM,UAAU,OAAO;GAAE;GAAO;GAAS;GAAO;MAEhD,OAAM,UAAU,KAAK;GAAE;GAAO;GAAS;GAAO,CAAC;AAEjD,OAAK,KAAK,MAAM,cAAc,UAAU;;;CAI1C,iBAAiB,OAAY,UAAqB;EAChD,MAAM,QAAQ,oBAAoB;EAClC,MAAM,OAAO,UAAU,MAAM;AAE7B,OAAK,cAAc,IACjB,OACA,UAAU;GACR,QAAQ,SAAS;GACjB,OAAO,MAAM;GACb;GACA,MAAM;GACN,qBAAqB;GACrB,cAAc;GACd,iBAAiB,KAAK,KAAK;GAC3B,gBAAgB,KAAK,KAAK;GAC3B,CAAC,CACH;AAED,QAAM,kBAAkB,IAAI,MAAM,SAAS;EAC3C,MAAM,MAAM,MAAM,UAAU,WAAW,MAAM,UAAU,EAAE,MAAM,KAAK,KAAK;AACzE,MAAI,OAAO,EACT,OAAM,UAAU,OAAO;GAAE;GAAO;GAAU;MAE1C,OAAM,UAAU,KAAK;GAAE;GAAO;GAAU,CAAC;AAE3C,OAAK,KAAK,MAAM,cAAc,WAAW;;;CAI3C,IAAI,OAAqB;AACvB,SAAO,KAAK,cAAc,IAAI,MAAM;;;CAItC,mBAWG;EACD,MAAM,UAAoE,EAAE;AAC5E,OAAK,MAAM,CAAC,OAAO,QAAQ,KAAK,cAC9B,SAAQ,KAAK;GACX,OAAO,UAAU,MAAM;GACvB,OAAO,IAAI;GACX,MAAM,IAAI;GAEV,cACE,IAAI,UAAU,MAAM,YAAY,IAAI,aAAa,KAAA,IAAY,IAAI,eAAe;GAClF,cAAc,IAAI;GAClB,gBAAgB,IAAI;GACpB,iBAAiB,IAAI;GACrB,mBAAmB,IAAI;GACvB,qBAAqB,IAAI;GACzB,cAAc,IAAI;GACnB,CAAC;AAEJ,SAAO;;CAoBT,QAAiB,OAAe;EAC9B,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM;AAGvC,MAAI,CAAC,OAAO,OAAO,UAAU,cAAc,MAAM,KAC/C,OAAM,KAAK,cAAc,IAAI,UAAU,MAAM,OAAO;AAEtD,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,yBAAyB,UAAU,MAAM,GAAG;AAG9D,MAAI,IAAI,UAAU,MAAM,aAAa,IAAI,aAAa,KAAA,GAAW;AAC/D,OAAI;AACJ,OAAI,iBAAiB,KAAK,KAAK;AAC/B,UAAO,IAAI;;AAIb,MAAI,IAAI,UAAU,MAAM,SAAS;AAC/B,OAAI,CAAC,UAAU,sBACb,OAAM,IAAI,MACR,kCAAkC,UAAU,MAAM,CAAC,0GAEpD;GAEH,MAAM,QAAQ,UAAU,uBAAuB;AAC/C,OAAI,CAAC,MACH,OAAM,IAAI,MACR,kCAAkC,UAAU,MAAM,CAAC,oCACpD;AAGH,OAAI,MAAM,OAAO,IAAI,MAAM,EAAE;AAC3B,QAAI;AACJ,QAAI,iBAAiB,KAAK,KAAK;AAC/B,WAAO,MAAM,OAAO,IAAI,MAAM;;AAGhC,OAAI,MAAM,UAAU,IAAI,MAAM,EAAE;AAC9B,QAAI;AACJ,QAAI,iBAAiB,KAAK,KAAK;AAC/B,WAAO,MAAM,UAAU,IAAI,MAAM;;GAGnC,MAAM,QAAQ,YAAY,KAAK;GAC/B,MAAM,WAAW,KAAK,eAAe,IAAI;AACzC,OAAI,oBAAoB,YAAY,KAAK,GAAG;AAC5C,OAAI;AACJ,OAAI,iBAAiB,KAAK,KAAK;AAC/B,OAAI,CAAC,IAAI,gBAAiB,KAAI,kBAAkB,KAAK,KAAK;AAC1D,SAAM,UAAU,IAAI,OAAO,SAAS;AACpC,UAAO;;AAGT,MAAI,IAAI,SAAS;GACf,MAAM,QAAQ,YAAY,KAAK;GAC/B,MAAM,WAAW,IAAI,SAAS;AAC9B,OAAI,oBAAoB,YAAY,KAAK,GAAG;AAC5C,OAAI;AACJ,OAAI,iBAAiB,KAAK,KAAK;AAC/B,OAAI,CAAC,IAAI,gBAAiB,KAAI,kBAAkB,KAAK,KAAK;AAC1D,OAAI,IAAI,UAAU,MAAM,WAAW;AACjC,QAAI,WAAW;AAEf,wBAAoB,CAAC,kBAAkB,IAAI,UAAU,MAAM,EAAE,SAAS;;AAExE,UAAO;;AAGT,MAAI,KAAK,UAAU,IAAI,MAAM,EAAE;GAC7B,MAAM,QAAQ,CAAC,GAAG,KAAK,UAAU,CAAC,IAAI,UAAU;AAChD,SAAM,KAAK,UAAU,MAAM,CAAC;AAC5B,SAAM,IAAI,MAAM,iCAAiC,MAAM,KAAK,OAAO,GAAG;;AAExE,OAAK,UAAU,IAAI,MAAM;AAEzB,MAAI;GACF,MAAM,QAAQ,YAAY,KAAK;GAC/B,MAAM,WAAW,KAAK,eAAe,IAAI;AACzC,OAAI,oBAAoB,YAAY,KAAK,GAAG;AAC5C,OAAI;AACJ,OAAI,iBAAiB,KAAK,KAAK;AAC/B,OAAI,CAAC,IAAI,gBAAiB,KAAI,kBAAkB,KAAK,KAAK;AAC1D,OAAI,IAAI,UAAU,MAAM,UACtB,KAAI,WAAW;AAEjB,UAAO;YACC;AACR,QAAK,UAAU,OAAO,MAAM;;;;CAKhC,YAAkB;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,SAAS,UAA+C;AACtD,OAAK,gBAAgB,IAAI,SAAS;AAClC,eAAa,KAAK,gBAAgB,OAAO,SAAS;;;;;;;;;;CAWpD,WAAW,OAAkB;EAC3B,MAAM,OAAO,UAAU,MAAM;EAE7B,MAAM,MAAM,KAAK,cAAc,IAAI,MAAM,IAAI,KAAK,cAAc,IAAI,UAAU,OAAO;AACrF,MAAI,CAAC,IAAK;AAIV,MADc,oBAAoB,CACxB,kBAAkB,IAAI,KAAK,CAAE;AAGvC,MAAI,WAAW,KAAA;AACf,MAAI,eAAe;AACnB,MAAI,sBAAsB;AAC1B,OAAK,KAAK,MAAM,eAAe,IAAI,KAAK;AAGxC,OAAK,MAAM,CAAC,UAAU,WAAW,KAAK,cACpC,KAAI,OAAO,aAAa,SAAS,KAAK,CACpC,MAAK,WAAW,SAAS;;;CAM/B,KAAa,OAAe,OAAsC,MAAwB;AACxF,OAAK,eAAe,KAAK;GAAE;GAAO;GAAO;GAAM,WAAW,KAAK,KAAK;GAAE,CAAC;AAEvE,MAAI,KAAK,YAAa,cAAa,KAAK,YAAY;AACpD,OAAK,cAAc,iBAAiB;GAClC,MAAM,QAAQ,KAAK,eAAe,OAAO,EAAE;AAC3C,OAAI,MAAM,WAAW,EAAG;AACxB,QAAK,MAAM,YAAY,KAAK,gBAC1B,KAAI;AACF,aAAS,MAAM;WACT;KAIT,UAAU,YAAY;;;CAI3B,eAAqB;AACnB,MAAI,KAAK,aAAa;AACpB,gBAAa,KAAK,YAAY;AAC9B,QAAK,cAAc;;EAErB,MAAM,QAAQ,KAAK,eAAe,OAAO,EAAE;AAC3C,MAAI,MAAM,WAAW,EAAG;AACxB,OAAK,MAAM,YAAY,KAAK,gBAC1B,KAAI;AACF,YAAS,MAAM;UACT;;CAMZ,eAAuB,KAAwB;EAG7C,MAAM,OAFa,aAA4B,SAAS,aAAa,IAAI,QAAQ,EAAE,CAAC,CAE5D,KAAK,WAAW,UAAU;GAGhD,MAAM,QADe,cAAmB,SAAS,QAAQ,IAAI,OAAO,CACzC,UAAU;AAErC,OAAI,IAAI,UAAU,MAAM,WAAW;IACjC,MAAM,SAAS,KAAK,cAAc,IAAI,MAAM;AAC5C,QAAI,UAAU,OAAO,UAAU,MAAM,QACnC,OAAM,IAAI,MACR,iCAAiC,UAAU,MAAM,CAAC,oBAAoB,UAAU,IAAI,OAAO,CAAC,gFAE7F;;AAGL,UAAO,KAAK,QAAQ,MAAM;IAC1B;EAEF,MAAM,WAAW,IAAI,IAAI,OAAO,GAAG,KAAK;AAGxC,OAAK,iBAAiB,UAAU,IAAI,OAAO;EAG3C,MAAM,gBAAgB,wBACpB,SAAS,gBACT,IAAI,OAAO,UACZ;AACD,MAAI,iBAAiB,OAAO,SAAS,mBAAmB,WACtD,KAAI;GACF,MAAM,SAAS,SAAS,gBAAgB;AACxC,OAAI,UAAU,OAAO,OAAO,SAAS,YAAY;AAC/C,QAAI,sBAAsB;AACxB,WACC,WAAW;AACV,SAAI,sBAAsB;MAC1B,CACD,YAAY;AACX,SAAI,sBAAsB;MAC1B;AACJ,QAAI,KACF,qBAAqB,UAAU,IAAI,OAAO,CAAC,GAAG,OAAO,cAAc,CAAC,kGAErE;SAED,KAAI,sBAAsB;WAErB,KAAK;AACZ,OAAI,sBAAsB;AAC1B,OAAI,MACF,KACA,qBAAqB,UAAU,IAAI,OAAO,CAAC,GAAG,OAAO,cAAc,CAAC,mBACrE;;AAIL,SAAO;;;CAIT,oBAA4B,QAA+B;EACzD,MAAM,aAAa,aAA4B,SAAS,aAAa,QAAQ,EAAE,CAAC;EAChF,MAAM,eAAe,cAAmB,SAAS,QAAQ,OAAO;AAChE,SAAO,WAAW,KAAK,MAAM,UAAU;AAErC,UAAO,UADO,aAAa,UAAU,KACd;IACvB;;CAGJ,iBAAyB,UAAe,QAA2B;EAEjE,MAAM,iBAAiB,WAAwB,SAAS,WAAW,OAAO,UAAU;AAEpF,OAAK,MAAM,CAAC,MAAM,UAAU,gBAAgB;GAC1C,MAAM,gBACJ,SAAS,yBAAyB,SAAS,eAAe,OAAO,WAAW,KAAK;AACnF,OAAI,cACF,QAAO,eAAe,UAAU,MAAM;IACpC,WAAW,KAAK,QAAQ,cAAc;IACtC,YAAY;IACZ,cAAc;IACf,CAAC;;EAKN,MAAM,aAAa,WACjB,SAAS,OACT,OAAO,UACR;AAED,OAAK,MAAM,CAAC,MAAM,WAAW,WAC3B,QAAO,eAAe,UAAU,MAAM;GACpC,MAAM;AAGJ,QAAI,UAAU,cAAc;KAC1B,MAAM,MAAM,UAAU,aAAa,OAAO,OAAO;AACjD,SAAI,QAAQ,KAAA,EAAW,QAAO;;IAIhC,MAAM,MAAM,QAAQ,IAAI,OAAO;AAC/B,QAAI,QAAQ,KAAA,EAAW,QAAO;AAC9B,QAAI,OAAO,iBAAiB,KAAA,EAAW,QAAO,OAAO;AACrD,UAAM,IAAI,MACR,WAAW,OAAO,OAAO,4BAA4B,OAAO,OAAO,2CACpE;;GAEH,YAAY;GACZ,cAAc;GACf,CAAC"}
1
+ {"version":3,"file":"container-CnP8G9tl.mjs","names":[],"sources":["../src/core/token.ts","../src/core/container.ts"],"sourcesContent":["/**\n * Collision-safe injection tokens with phantom type parameters.\n *\n * `createToken<T>(name)` is the recommended way to declare any DI token\n * that isn't a class. Each call returns a unique frozen object — even if\n * two files write `createToken<X>('Logger')`, they produce two distinct\n * references that the container treats as different tokens. Collisions\n * become impossible by construction, not by convention.\n *\n * The phantom type parameter `T` lets `container.resolve(token)` infer\n * the correct return type without any codegen.\n *\n * ## Hardening layers\n *\n * KickJS has four DI token kinds, listed from safest to riskiest:\n *\n * 1. **Class identity** — `container.resolve(UserService)`. Reference\n * equality, never collides. Type-safe via `Constructor<T>` overload.\n * 2. **`createToken<T>(name)`** — frozen object identity, never collides.\n * Type-safe via the `InjectionToken<T>` overload.\n * 3. **Symbol** — `Symbol('foo')` is unique per call but `Symbol.for('foo')`\n * is interned and CAN collide. Discouraged.\n * 4. **Raw string `@Inject('foo')`** — high collision risk, untyped.\n * Reserved for legacy code and runtime-computed token names.\n *\n * Prefer (1) and (2). Use (4) only when you have to.\n *\n * @example\n * ```ts\n * // src/tokens.ts\n * export const DATABASE_URL = createToken<string>('config.database.url')\n * export const FEATURE_FLAGS = createToken<FeatureFlags>('app.features')\n *\n * // bootstrap\n * container.registerInstance(DATABASE_URL, process.env.DATABASE_URL!)\n *\n * // anywhere else\n * const url = container.resolve(DATABASE_URL) // typed as `string`\n * ```\n *\n * @module @forinda/kickjs/core/token\n */\n\n/**\n * Symbol marker stamped on every InjectionToken so the container can\n * detect them at runtime regardless of which package created them.\n *\n * Uses `Symbol.for()` so cross-package isolation (different copies of\n * `@forinda/kickjs` loaded under different module identities) still\n * shares the same marker.\n */\nexport const INJECTION_TOKEN: unique symbol = Symbol.for('@kickjs/InjectionToken') as never\n\n/**\n * A type-safe DI token. Each `createToken()` call returns a unique frozen\n * object identified by reference, not by the `name` string. Two\n * `createToken<X>('foo')` calls in different files produce two distinct\n * tokens that the container treats independently.\n *\n * The phantom `_type` parameter is never assigned at runtime — it exists\n * solely to thread the type through `container.resolve(token)`.\n */\nexport interface InjectionToken<T> {\n readonly [INJECTION_TOKEN]: true\n /** Descriptive name used in error messages, logs, and devtools */\n readonly name: string\n /** Phantom — never assigned at runtime */\n readonly _type?: T\n}\n\n/**\n * Create a collision-safe injection token.\n *\n * The returned token is a frozen object identified by reference, not by\n * the `name` string. The `name` is used only for error messages, logs,\n * and debugging.\n */\nexport function createToken<T>(name: string): InjectionToken<T> {\n return Object.freeze({\n [INJECTION_TOKEN]: true as const,\n name,\n })\n}\n\n/** Type guard — returns `true` if `value` is an InjectionToken */\nexport function isInjectionToken(value: unknown): value is InjectionToken<unknown> {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as Record<symbol, unknown>)[INJECTION_TOKEN] === true\n )\n}\n","import 'reflect-metadata'\nimport {\n Constructor,\n Scope,\n METADATA,\n type ClassKind,\n type PostConstructStatus,\n} from './interfaces'\nimport { createLogger } from './logger'\nimport {\n getClassMeta,\n getClassMetaOrUndefined,\n getMetaMap,\n getMetaRecord,\n getMethodMetaOrUndefined,\n} from './metadata'\nimport { isInjectionToken, type InjectionToken } from './token'\n\nconst log = createLogger('Container')\n\n/** Internal registration entry that tracks how a dependency should be resolved */\ninterface Registration {\n target: Constructor\n scope: Scope\n instance?: any\n factory?: () => any\n // Observability fields\n kind: ClassKind\n resolveCount: number\n lastResolvedAt?: number\n firstResolvedAt?: number\n resolveDurationMs?: number\n postConstructStatus: PostConstructStatus\n dependencies: string[]\n}\n\n/** Create a Registration with observability defaults */\nfunction createReg(\n fields: Partial<Registration> & Pick<Registration, 'target' | 'scope'>,\n): Registration {\n return {\n kind: 'unknown',\n resolveCount: 0,\n postConstructStatus: 'skipped',\n dependencies: [],\n ...fields,\n }\n}\n\n/** Format a token for display in error messages */\nexport function tokenName(token: any): string {\n if (typeof token === 'symbol') return token.toString()\n if (isInjectionToken(token)) return token.name\n return token?.name || String(token)\n}\n\n// ── Persistent Store ────────────────────────────────────────────────────\n// globalThis-based storage that survives BOTH Container.reset() AND Vite's\n// ssrLoadModule() re-evaluation. When Vite re-evaluates a module, the\n// Container class gets a new identity (new statics). But globalThis persists.\n//\n// This is how DB connections, Redis clients, WsAdapter instances, and any\n// other stateful bindings survive HMR without being dropped.\n//\n// Pattern from: React Router (globalThis for state), Vinxi (globalThis.app)\n\n// ── Change Event System ─────────────────────────────────────────────────\n// Batched (50ms debounce) so `kick g module` creating 10+ files emits ONE\n// notification, not 10. Any adapter can subscribe: Swagger, DevTools, WS, etc.\n\n/** A single container change event */\nexport interface ContainerChangeEvent {\n token: string\n event: 'registered' | 'resolved' | 'invalidated'\n kind?: ClassKind\n timestamp: number\n}\n\n/** Listener that receives batched change events */\nexport type ContainerChangeListener = (changes: ContainerChangeEvent[]) => void\n\n/**\n * Type-safe registry of string DI tokens. Augmented by `kick typegen` —\n * the generated `.kickjs/types/registry.d.ts` adds entries like:\n *\n * ```ts\n * declare module '@forinda/kickjs' {\n * interface KickJsRegistry {\n * UserService: import('../../src/modules/users/user.service').UserService\n * }\n * }\n * ```\n *\n * Once typegen has run, `container.resolve('UserService')` returns the\n * correct type instead of `any`. Class-token resolution\n * (`container.resolve(UserService)`) is already type-safe via the\n * `Constructor<T>` overload and does not need typegen.\n */\nexport interface KickJsRegistry {}\n\ninterface PersistentStore {\n factories: Array<{ token: any; factory: () => any; scope: Scope }>\n instances: Array<{ token: any; instance: any }>\n /** Resolved instances keyed by string name — survives class identity changes */\n resolvedInstances: Map<string, any>\n}\n\nfunction getPersistentStore(): PersistentStore {\n if (!(globalThis as any).__kickjs_persistent) {\n ;(globalThis as any).__kickjs_persistent = {\n factories: [],\n instances: [],\n resolvedInstances: new Map(),\n } satisfies PersistentStore\n }\n return (globalThis as any).__kickjs_persistent\n}\n\n/**\n * Inversion-of-Control (IoC) container that manages dependency registration,\n * resolution, and lifecycle. Implements the Singleton pattern so all parts of\n * the application share a single container instance.\n *\n * Supports constructor injection, property injection (@Autowired),\n * factory registrations, and lifecycle hooks (@PostConstruct).\n *\n * Persistent state (DB connections, Redis, etc.) is stored on globalThis so\n * it survives both Container.reset() and Vite module re-evaluation.\n */\nexport class Container {\n private static instance: Container\n private registrations = new Map<any, Registration>()\n private resolving = new Set<any>()\n\n // ── Reactive change tracking ──────────────────────────────────────\n private changeListeners = new Set<ContainerChangeListener>()\n private pendingChanges: ContainerChangeEvent[] = []\n private notifyTimer: ReturnType<typeof setTimeout> | null = null\n private static readonly DEBOUNCE_MS = 50\n\n /** Callback set by the decorators module to flush pending registrations */\n static _onReady: ((container: Container) => void) | null = null\n /** Callback invoked on reset so decorators can update their container reference */\n static _onReset: ((container: Container) => void) | null = null\n /**\n * Environment resolver for @Value decorator. Set by @forinda/kickjs-config\n * to return Zod-validated, type-coerced env values instead of raw process.env strings.\n */\n static _envResolver: ((key: string) => any) | null = null\n /**\n * Request store provider for REQUEST-scoped DI. Set by @forinda/kickjs-http\n * to return the current request's AsyncLocalStorage store.\n * Returns { instances: Map, values: Map } or null if outside a request.\n */\n static _requestStoreProvider:\n | (() => { instances: Map<any, any>; values: Map<any, any> } | null)\n | null = null\n\n static getInstance(): Container {\n if (!Container.instance) {\n Container.instance = new Container()\n }\n // Flush any decorator registrations that queued before the container existed\n if (Container._onReady) {\n Container._onReady(Container.instance)\n Container._onReady = null\n }\n return Container.instance\n }\n\n /**\n * Resets the container by replacing the singleton with a fresh instance.\n * Persistent registrations (DB, Redis, etc.) are replayed from globalThis\n * so they survive both reset() and Vite module re-evaluation.\n */\n static reset(): void {\n Container.instance = new Container()\n // Notify decorators so they update their container reference\n Container._onReset?.(Container.instance)\n // Replay persistent registrations from globalThis store\n const store = getPersistentStore()\n for (const { token, factory, scope } of store.factories) {\n if (!Container.instance.has(token)) {\n // Check if we have a previously resolved instance for this token\n const name = tokenName(token)\n const existing = store.resolvedInstances.get(name)\n Container.instance.registrations.set(\n token,\n createReg({\n target: Object as any,\n scope,\n factory,\n kind: 'factory',\n instance: existing, // Reuse resolved instance if available\n resolveCount: existing ? 1 : 0,\n postConstructStatus: existing ? 'completed' : 'skipped',\n }),\n )\n }\n }\n for (const { token, instance } of store.instances) {\n if (!Container.instance.has(token)) {\n Container.instance.registrations.set(\n token,\n createReg({\n target: instance.constructor,\n scope: Scope.SINGLETON,\n instance,\n kind: 'instance',\n postConstructStatus: 'completed',\n resolveCount: 1,\n }),\n )\n }\n }\n }\n\n /**\n * Create an isolated container instance (not the global singleton).\n * Useful for concurrent tests that must not share DI state.\n *\n * @example\n * ```ts\n * const container = Container.create()\n * container.register(UserService, UserService)\n * const svc = container.resolve(UserService)\n * ```\n */\n static create(): Container {\n return new Container()\n }\n\n /** Register a class constructor under the given token */\n register(token: any, target: Constructor, scope: Scope = Scope.SINGLETON): void {\n const kind = getClassMeta<ClassKind>(METADATA.CLASS_KIND, target, 'unknown')\n const dependencies = this.extractDependencies(target)\n const reg = createReg({ target, scope, kind, dependencies })\n this.registrations.set(token, reg)\n // Store a name-based fallback so HMR class re-creation (new identity)\n // can still resolve by the original class name.\n if (typeof token === 'function' && token.name) {\n this.registrations.set(`__hmr__${token.name}`, reg)\n }\n this.emit(tokenName(token), 'registered', kind)\n }\n\n /** Register a factory function under the given token */\n registerFactory(token: any, factory: () => any, scope: Scope = Scope.SINGLETON): void {\n const store = getPersistentStore()\n const name = tokenName(token)\n // Check if we already have a resolved instance from a previous HMR cycle.\n // Only reuse if the factory hasn't changed (same reference). When a new\n // factory is provided (e.g. swapping implementations), clear the stale\n // instance so the new factory runs on next resolve.\n const existingEntry = store.factories.find((r) => tokenName(r.token) === name)\n const factoryUnchanged = existingEntry?.factory === factory\n const existingInstance = factoryUnchanged ? store.resolvedInstances.get(name) : undefined\n\n // Clear stale resolved instance when factory changes\n if (!factoryUnchanged) {\n store.resolvedInstances.delete(name)\n }\n\n this.registrations.set(\n token,\n createReg({\n target: Object as any,\n scope,\n factory,\n kind: 'factory',\n instance: existingInstance,\n resolveCount: existingInstance ? 1 : 0,\n postConstructStatus: existingInstance ? 'completed' : 'skipped',\n }),\n )\n // Track in globalThis for persistence across HMR + module re-evaluation\n const idx = store.factories.findIndex((r) => tokenName(r.token) === name)\n if (idx >= 0) {\n store.factories[idx] = { token, factory, scope }\n } else {\n store.factories.push({ token, factory, scope })\n }\n this.emit(name, 'registered', 'factory')\n }\n\n /** Register a pre-constructed singleton instance */\n registerInstance(token: any, instance: any): void {\n const store = getPersistentStore()\n const name = tokenName(token)\n\n this.registrations.set(\n token,\n createReg({\n target: instance.constructor,\n scope: Scope.SINGLETON,\n instance,\n kind: 'instance',\n postConstructStatus: 'completed',\n resolveCount: 1,\n firstResolvedAt: Date.now(),\n lastResolvedAt: Date.now(),\n }),\n )\n // Track in globalThis for persistence across HMR + module re-evaluation\n store.resolvedInstances.set(name, instance)\n const idx = store.instances.findIndex((r) => tokenName(r.token) === name)\n if (idx >= 0) {\n store.instances[idx] = { token, instance }\n } else {\n store.instances.push({ token, instance })\n }\n this.emit(name, 'registered', 'instance')\n }\n\n /** Check if a binding exists for the given token */\n has(token: any): boolean {\n return this.registrations.has(token)\n }\n\n /** Return a snapshot of all registered tokens with their scope and instantiation status */\n getRegistrations(): Array<{\n token: string\n scope: string\n kind: ClassKind\n instantiated: boolean\n resolveCount: number\n lastResolvedAt?: number\n firstResolvedAt?: number\n resolveDurationMs?: number\n postConstructStatus: PostConstructStatus\n dependencies: string[]\n }> {\n const entries: Array<ReturnType<Container['getRegistrations']>[number]> = []\n for (const [token, reg] of this.registrations) {\n entries.push({\n token: tokenName(token),\n scope: reg.scope,\n kind: reg.kind,\n // Singletons check cached instance; transients check resolveCount\n instantiated:\n reg.scope === Scope.SINGLETON ? reg.instance !== undefined : reg.resolveCount > 0,\n resolveCount: reg.resolveCount,\n lastResolvedAt: reg.lastResolvedAt,\n firstResolvedAt: reg.firstResolvedAt,\n resolveDurationMs: reg.resolveDurationMs,\n postConstructStatus: reg.postConstructStatus,\n dependencies: reg.dependencies,\n })\n }\n return entries\n }\n\n /**\n * Resolve a dependency by its token.\n *\n * Four overloads, in order of preference:\n * - **`InjectionToken<T>`** (from `createToken<T>(name)`) → returns `T`.\n * Collision-safe by construction; no codegen required.\n * - **Class constructor** → returns an instance of that class. Always\n * type-safe; no codegen required.\n * - **String token in `KickJsRegistry`** (populated by `kick typegen`) →\n * returns the augmented type.\n * - **Anything else** → returns `any`. Use this only for legacy code or\n * string tokens that haven't been registered with typegen yet.\n */\n resolve<T>(token: InjectionToken<T>): T\n resolve<T>(token: Constructor<T>): T\n resolve<K extends keyof KickJsRegistry & string>(token: K): KickJsRegistry[K]\n resolve<T = any>(token: any): T\n resolve<T = any>(token: any): T {\n let reg = this.registrations.get(token)\n // HMR fallback: when Vite re-evaluates a module, decorated classes get new\n // identity. Try resolving by class name if the primary token lookup fails.\n if (!reg && typeof token === 'function' && token.name) {\n reg = this.registrations.get(`__hmr__${token.name}`)\n }\n if (!reg) {\n throw new Error(`No binding found for: ${tokenName(token)}`)\n }\n\n if (reg.scope === Scope.SINGLETON && reg.instance !== undefined) {\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n return reg.instance\n }\n\n // REQUEST scope: one instance per HTTP request, cached in AsyncLocalStorage\n if (reg.scope === Scope.REQUEST) {\n if (!Container._requestStoreProvider) {\n throw new Error(\n `Cannot resolve REQUEST-scoped \"${tokenName(token)}\": no request store provider configured. ` +\n `Ensure requestScopeMiddleware() is in your middleware pipeline.`,\n )\n }\n const store = Container._requestStoreProvider()\n if (!store) {\n throw new Error(\n `Cannot resolve REQUEST-scoped \"${tokenName(token)}\" outside an HTTP request context.`,\n )\n }\n // Check for pre-registered request values (user, tenant, etc.)\n if (store.values.has(token)) {\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n return store.values.get(token) as T\n }\n // Check per-request instance cache\n if (store.instances.has(token)) {\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n return store.instances.get(token) as T\n }\n // Create instance and cache for this request only\n const start = performance.now()\n const instance = this.createInstance(reg)\n reg.resolveDurationMs = performance.now() - start\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n if (!reg.firstResolvedAt) reg.firstResolvedAt = Date.now()\n store.instances.set(token, instance)\n return instance as T\n }\n\n if (reg.factory) {\n const start = performance.now()\n const instance = reg.factory()\n reg.resolveDurationMs = performance.now() - start\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n if (!reg.firstResolvedAt) reg.firstResolvedAt = Date.now()\n if (reg.scope === Scope.SINGLETON) {\n reg.instance = instance\n // Persist resolved factory instances so they survive module re-evaluation\n getPersistentStore().resolvedInstances.set(tokenName(token), instance)\n }\n return instance\n }\n\n if (this.resolving.has(token)) {\n const chain = [...this.resolving].map(tokenName)\n chain.push(tokenName(token))\n throw new Error(`Circular dependency detected: ${chain.join(' -> ')}`)\n }\n this.resolving.add(token)\n\n try {\n const start = performance.now()\n const instance = this.createInstance(reg)\n reg.resolveDurationMs = performance.now() - start\n reg.resolveCount++\n reg.lastResolvedAt = Date.now()\n if (!reg.firstResolvedAt) reg.firstResolvedAt = Date.now()\n if (reg.scope === Scope.SINGLETON) {\n reg.instance = instance\n }\n return instance\n } finally {\n this.resolving.delete(token)\n }\n }\n\n /** Lifecycle hook called during Application.setup() after module registration */\n bootstrap(): void {\n // Reserved for future use — adapters and modules register via\n // container.register(), registerFactory(), and registerInstance().\n }\n\n // ── Reactive Change API ─────────────────────────────────────────────\n\n /**\n * Subscribe to container changes. Returns an unsubscribe function.\n *\n * Changes are batched (50ms debounce) so bulk operations like\n * `kick g module` creating 10+ files emit ONE batch, not 10 events.\n *\n * Any adapter can subscribe:\n * - SwaggerAdapter: re-build spec when controllers change\n * - DevToolsAdapter: push SSE events to dashboard\n * - WsAdapter: re-discover namespaces when controllers change\n * - OtelAdapter: emit tracing spans for DI resolution\n * - Custom user adapters\n *\n * @example\n * ```ts\n * const unsub = container.onChange((changes) => {\n * for (const c of changes) {\n * console.log(`${c.event}: ${c.token} (${c.kind})`)\n * }\n * })\n * // later:\n * unsub()\n * ```\n */\n onChange(callback: ContainerChangeListener): () => void {\n this.changeListeners.add(callback)\n return () => this.changeListeners.delete(callback)\n }\n\n /**\n * Invalidate a specific registration. Clears the cached instance so the\n * next resolve() creates a fresh one. Also invalidates dependents\n * (anything that injected this token) by walking the dependency graph.\n *\n * Called by the Vite HMR plugin when a module file changes.\n * Skips persistent registrations (DB connections, etc.).\n */\n invalidate(token: any): void {\n const name = tokenName(token)\n // Try both the token itself and the HMR fallback name\n const reg = this.registrations.get(token) ?? this.registrations.get(`__hmr__${name}`)\n if (!reg) return\n\n // Don't invalidate persistent registrations (DB, Redis, etc.)\n const store = getPersistentStore()\n if (store.resolvedInstances.has(name)) return\n\n // Clear cached instance — next resolve() will re-create\n reg.instance = undefined\n reg.resolveCount = 0\n reg.postConstructStatus = 'skipped'\n this.emit(name, 'invalidated', reg.kind)\n\n // Walk dependency graph — invalidate anything that injected this token\n for (const [depToken, depReg] of this.registrations) {\n if (depReg.dependencies.includes(name)) {\n this.invalidate(depToken)\n }\n }\n }\n\n /** Batch-emit a change event (debounced, flushed after 50ms of quiet) */\n private emit(token: string, event: ContainerChangeEvent['event'], kind?: ClassKind): void {\n this.pendingChanges.push({ token, event, kind, timestamp: Date.now() })\n\n if (this.notifyTimer) clearTimeout(this.notifyTimer)\n this.notifyTimer = setTimeout(() => {\n const batch = this.pendingChanges.splice(0)\n if (batch.length === 0) return\n for (const listener of this.changeListeners) {\n try {\n listener(batch)\n } catch {\n // Don't let one broken listener break others\n }\n }\n }, Container.DEBOUNCE_MS)\n }\n\n /** Flush pending change events immediately (useful in tests) */\n flushChanges(): void {\n if (this.notifyTimer) {\n clearTimeout(this.notifyTimer)\n this.notifyTimer = null\n }\n const batch = this.pendingChanges.splice(0)\n if (batch.length === 0) return\n for (const listener of this.changeListeners) {\n try {\n listener(batch)\n } catch {\n // Don't let one broken listener break others\n }\n }\n }\n\n private createInstance(reg: Registration): any {\n const paramTypes = getClassMeta<Constructor[]>(METADATA.PARAM_TYPES, reg.target, [])\n\n const args = paramTypes.map((paramType, index) => {\n // Check for @Inject token override on constructor parameter\n const injectTokens = getMetaRecord<any>(METADATA.INJECT, reg.target)\n const token = injectTokens[index] || paramType\n // Scope validation: SINGLETON cannot inject REQUEST-scoped dependencies\n if (reg.scope === Scope.SINGLETON) {\n const depReg = this.registrations.get(token)\n if (depReg && depReg.scope === Scope.REQUEST) {\n throw new Error(\n `Cannot inject REQUEST-scoped \"${tokenName(token)}\" into SINGLETON \"${tokenName(reg.target)}\". ` +\n `Singletons outlive requests. Use TRANSIENT or REQUEST scope for the parent.`,\n )\n }\n }\n return this.resolve(token)\n })\n\n const instance = new reg.target(...args)\n\n // Property injection via @Autowired\n this.injectProperties(instance, reg.target)\n\n // @PostConstruct lifecycle hook\n const postConstruct = getClassMetaOrUndefined<string | symbol>(\n METADATA.POST_CONSTRUCT,\n reg.target.prototype,\n )\n if (postConstruct && typeof instance[postConstruct] === 'function') {\n try {\n const result = instance[postConstruct]()\n if (result && typeof result.then === 'function') {\n reg.postConstructStatus = 'pending'\n ;(result as Promise<void>)\n .then(() => {\n reg.postConstructStatus = 'completed'\n })\n .catch(() => {\n reg.postConstructStatus = 'failed'\n })\n log.warn(\n `@PostConstruct on ${tokenName(reg.target)}.${String(postConstruct)}() returned a Promise ` +\n `but the container is synchronous. The async operation will not be awaited.`,\n )\n } else {\n reg.postConstructStatus = 'completed'\n }\n } catch (err) {\n reg.postConstructStatus = 'failed'\n log.error(\n err,\n `@PostConstruct on ${tokenName(reg.target)}.${String(postConstruct)}() threw an error`,\n )\n }\n }\n\n return instance\n }\n\n /** Extract dependency token names from constructor metadata */\n private extractDependencies(target: Constructor): string[] {\n const paramTypes = getClassMeta<Constructor[]>(METADATA.PARAM_TYPES, target, [])\n const injectTokens = getMetaRecord<any>(METADATA.INJECT, target)\n return paramTypes.map((type, index) => {\n const token = injectTokens[index] || type\n return tokenName(token)\n })\n }\n\n private injectProperties(instance: any, target: Constructor): void {\n // @Autowired — lazy DI property injection\n const autowiredProps = getMetaMap<string, any>(METADATA.AUTOWIRED, target.prototype)\n\n for (const [prop, token] of autowiredProps) {\n const resolvedToken =\n token || getMethodMetaOrUndefined(METADATA.PROPERTY_TYPE, target.prototype, prop)\n if (resolvedToken) {\n Object.defineProperty(instance, prop, {\n get: () => this.resolve(resolvedToken),\n enumerable: true,\n configurable: true,\n })\n }\n }\n\n // @Value — lazy environment variable injection\n const valueProps = getMetaMap<string, { envKey: string; defaultValue?: any }>(\n METADATA.VALUE,\n target.prototype,\n )\n\n for (const [prop, config] of valueProps) {\n Object.defineProperty(instance, prop, {\n get() {\n // Use the registered env resolver if available (set by @forinda/kickjs-config)\n // This returns Zod-validated, type-coerced values (e.g. PORT as number)\n if (Container._envResolver) {\n const val = Container._envResolver(config.envKey)\n if (val !== undefined) return val\n }\n\n // Fallback to raw process.env for apps not using @forinda/kickjs-config\n const val = process.env[config.envKey]\n if (val !== undefined) return val\n if (config.defaultValue !== undefined) return config.defaultValue\n throw new Error(\n `@Value('${config.envKey}'): Environment variable \"${config.envKey}\" is not set and no default was provided.`,\n )\n },\n enumerable: true,\n configurable: true,\n })\n }\n }\n}\n"],"mappings":"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"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "../adapter-wuoBNkNs.mjs";
2
+ import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "../adapter-A1E1XBhE.mjs";
3
3
  export { AdapterContext, AdapterMiddleware, AppAdapter, AppAdapterClass, MiddlewarePhase };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "../app-module-DOBmxARW.mjs";
2
+ import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "../app-module-Cotu9TIC.mjs";
3
3
  export { AppModule, AppModuleClass, ModuleRoutes };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider, t as CACHEABLE_META } from "../cache-PufEhr0n.mjs";
2
+ import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider, t as CACHEABLE_META } from "../cache-CcTzzNdr.mjs";
3
3
  export { CACHEABLE_META, CacheEvict, CacheOptions, CacheProvider, Cacheable, MemoryCacheProvider, getCacheProvider, setCacheProvider };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as tokenName, i as KickJsRegistry, n as ContainerChangeEvent, r as ContainerChangeListener, t as Container } from "../container-CcgV8eHL.mjs";
2
+ import { a as tokenName, i as KickJsRegistry, n as ContainerChangeEvent, r as ContainerChangeListener, t as Container } from "../container-BJb34faa.mjs";
3
3
  export { Container, ContainerChangeEvent, ContainerChangeListener, KickJsRegistry, tokenName };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { n as tokenName, t as Container } from "../container-BKiJzakw.mjs";
11
+ import { n as tokenName, t as Container } from "../container-CnP8G9tl.mjs";
12
12
  export { Container, tokenName };
@@ -1,3 +1,3 @@
1
1
 
2
- import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "../cron-C29iHvHT.mjs";
2
+ import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "../cron-H-IyLcOr.mjs";
3
3
  export { CRON_META, Cron, CronJobMeta, getCronJobs };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { c as pushClassMeta, t as getClassMeta } from "../metadata-D5L3_cdl.mjs";
11
+ import { c as pushClassMeta, t as getClassMeta } from "../metadata-UdEcgIBJ.mjs";
12
12
  //#region src/core/cron.ts
13
13
  const CRON_META = Symbol("kick:cron");
14
14
  /**
@@ -1,3 +1,3 @@
1
1
 
2
- import { C as Put, D as Value, E as Service, O as normalizeApiQueryParamsConfig, S as PostConstruct, T as RouteDefinition, _ as Injectable, a as Builder, b as Patch, c as Controller, d as EnvKey, f as FileTypeFilter, g as Inject, h as Get, i as BaseUploadOptions, l as Delete, m as FileUploadConfig, n as ApiQueryParamsConfig, o as ColumnApiQueryParamsConfig, p as FileUpload, r as Autowired, s as Component, t as ApiQueryParams, u as Env, v as Middleware, w as Repository, x as Post, y as MiddlewareHandler } from "../decorators-D3lBlmud.mjs";
2
+ import { C as Put, D as Value, E as Service, O as normalizeApiQueryParamsConfig, S as PostConstruct, T as RouteDefinition, _ as Injectable, a as Builder, b as Patch, c as Controller, d as EnvKey, f as FileTypeFilter, g as Inject, h as Get, i as BaseUploadOptions, l as Delete, m as FileUploadConfig, n as ApiQueryParamsConfig, o as ColumnApiQueryParamsConfig, p as FileUpload, r as Autowired, s as Component, t as ApiQueryParams, u as Env, v as Middleware, w as Repository, x as Post, y as MiddlewareHandler } from "../decorators-C9_SN7ge.mjs";
3
3
  export { ApiQueryParams, ApiQueryParamsConfig, Autowired, BaseUploadOptions, Builder, ColumnApiQueryParamsConfig, Component, Controller, Delete, Env, EnvKey, FileTypeFilter, FileUpload, FileUploadConfig, Get, Inject, Injectable, Middleware, MiddlewareHandler, Patch, Post, PostConstruct, Put, Repository, RouteDefinition, Service, Value, normalizeApiQueryParamsConfig };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,8 +9,8 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { METADATA, Scope } from "./interfaces.mjs";
12
- import { c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, l as pushMethodMeta, p as setMethodMeta, u as setClassMeta } from "../metadata-D5L3_cdl.mjs";
13
- import { t as Container } from "../container-BKiJzakw.mjs";
12
+ import { c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, l as pushMethodMeta, p as setMethodMeta, u as setClassMeta } from "../metadata-UdEcgIBJ.mjs";
13
+ import { t as Container } from "../container-CnP8G9tl.mjs";
14
14
  import "reflect-metadata";
15
15
  //#region src/core/decorators.ts
16
16
  const pendingRegistrations = [];
@@ -1,3 +1,3 @@
1
1
 
2
- import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "../errors-BZUdxtjC.mjs";
2
+ import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "../errors-BX7Zosvv.mjs";
3
3
  export { HttpException, HttpStatus, HttpStatusCode, ValidationError };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as METADATA, c as Scope, i as Constructor, l as ServiceOptions, n as BuilderOf, o as MaybePromise, r as ClassKind, s as PostConstructStatus, t as Buildable } from "../interfaces-D5ohYl6D.mjs";
2
+ import { a as METADATA, c as Scope, i as Constructor, l as ServiceOptions, n as BuilderOf, o as MaybePromise, r as ClassKind, s as PostConstructStatus, t as Buildable } from "../interfaces-DXjE8Re1.mjs";
3
3
  export { Buildable, BuilderOf, ClassKind, Constructor, METADATA, MaybePromise, PostConstructStatus, Scope, ServiceOptions };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "../logger-BLdfUF5b.mjs";
2
+ import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "../logger-CW6FHtvU.mjs";
3
3
  export { ConsoleLoggerProvider, Logger, LoggerProvider, createLogger, logger, rootLogger };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { n as normalizePath, t as joinPaths } from "../path-Dq5V-i-x.mjs";
2
+ import { n as normalizePath, t as joinPaths } from "../path-B4JcbwKX.mjs";
3
3
  export { joinPaths, normalizePath };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { t as KickPlugin } from "../plugin-D20muJwC.mjs";
2
+ import { t as KickPlugin } from "../plugin-DcDVlPTI.mjs";
3
3
  export { KickPlugin };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as isRef, c as toRefs, i as computed, l as unref, n as Ref, o as reactive, r as WatchOptions, s as ref, t as ComputedRef, u as watch } from "../reactivity-CMAQh0gi.mjs";
2
+ import { a as isRef, c as toRefs, i as computed, l as unref, n as Ref, o as reactive, r as WatchOptions, s as ref, t as ComputedRef, u as watch } from "../reactivity-I8nDlg4c.mjs";
3
3
  export { ComputedRef, Ref, WatchOptions, computed, isRef, reactive, ref, toRefs, unref, watch };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.1
2
+ * @forinda/kickjs v2.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -10,8 +10,8 @@
10
10
  */
11
11
  import "./core/interfaces.mjs";
12
12
  import "./core/logger.mjs";
13
- import "./metadata-D5L3_cdl.mjs";
14
- import "./container-BKiJzakw.mjs";
13
+ import "./metadata-UdEcgIBJ.mjs";
14
+ import "./container-CnP8G9tl.mjs";
15
15
  import "./core/decorators.mjs";
16
16
  import "./core/cron.mjs";
17
17
  import "./core/cache.mjs";
@@ -118,4 +118,4 @@ var CircuitBreaker = class {
118
118
  //#endregion
119
119
  export { CircuitOpenError as n, CircuitBreaker as t };
120
120
 
121
- //# sourceMappingURL=core-CXHuViXn.mjs.map
121
+ //# sourceMappingURL=core-CBy6sBw_.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"core-CXHuViXn.mjs","names":[],"sources":["../src/core/circuit-breaker.ts"],"sourcesContent":["/**\n * Circuit Breaker pattern for external service calls.\n *\n * Protects your application from cascading failures when downstream\n * services are unhealthy by short-circuiting requests after a\n * configurable failure threshold.\n *\n * @example\n * ```ts\n * const breaker = new CircuitBreaker('payment-api', {\n * failureThreshold: 5,\n * resetTimeout: 30_000,\n * })\n *\n * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))\n * ```\n */\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half_open'\n\nexport interface CircuitBreakerOptions {\n /** Number of consecutive failures before the circuit opens. */\n failureThreshold: number\n /** Milliseconds to wait before transitioning from OPEN to HALF_OPEN. */\n resetTimeout: number\n /** Max requests allowed in HALF_OPEN state before deciding (default 1). */\n halfOpenMax?: number\n}\n\nexport interface CircuitBreakerStats {\n failures: number\n successes: number\n state: CircuitBreakerState\n lastFailure?: Date\n}\n\n/**\n * Error thrown when the circuit is open and calls are being rejected.\n */\nexport class CircuitOpenError extends Error {\n constructor(public readonly breakerName: string) {\n super(`Circuit breaker \"${breakerName}\" is open — request rejected`)\n this.name = 'CircuitOpenError'\n }\n}\n\nexport class CircuitBreaker {\n private state: CircuitBreakerState = 'closed'\n private failures = 0\n private successes = 0\n private halfOpenAttempts = 0\n private lastFailure?: Date\n private openedAt?: number\n\n private readonly failureThreshold: number\n private readonly resetTimeout: number\n private readonly halfOpenMax: number\n\n constructor(\n public readonly name: string,\n options: CircuitBreakerOptions,\n ) {\n this.failureThreshold = options.failureThreshold\n this.resetTimeout = options.resetTimeout\n this.halfOpenMax = options.halfOpenMax ?? 1\n }\n\n /**\n * Execute an async function through the circuit breaker.\n * Throws `CircuitOpenError` if the circuit is open.\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.maybeTransitionToHalfOpen()\n\n if (this.state === 'open') {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open' && this.halfOpenAttempts >= this.halfOpenMax) {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open') {\n this.halfOpenAttempts++\n }\n\n try {\n const result = await fn()\n this.onSuccess()\n return result\n } catch (error) {\n this.onFailure()\n throw error\n }\n }\n\n /** Returns the current circuit state. */\n getState(): CircuitBreakerState {\n this.maybeTransitionToHalfOpen()\n return this.state\n }\n\n /** Returns current statistics. */\n getStats(): CircuitBreakerStats {\n this.maybeTransitionToHalfOpen()\n return {\n failures: this.failures,\n successes: this.successes,\n state: this.state,\n ...(this.lastFailure ? { lastFailure: this.lastFailure } : {}),\n }\n }\n\n /** Manually reset the circuit breaker to CLOSED state. */\n reset(): void {\n this.state = 'closed'\n this.failures = 0\n this.successes = 0\n this.halfOpenAttempts = 0\n this.lastFailure = undefined\n this.openedAt = undefined\n }\n\n private onSuccess(): void {\n if (this.state === 'half_open') {\n // Recovery confirmed — close the circuit\n this.state = 'closed'\n this.failures = 0\n this.halfOpenAttempts = 0\n this.openedAt = undefined\n }\n this.successes++\n }\n\n private onFailure(): void {\n this.failures++\n this.lastFailure = new Date()\n\n if (this.state === 'half_open') {\n // Recovery failed — re-open\n this.state = 'open'\n this.openedAt = Date.now()\n this.halfOpenAttempts = 0\n } else if (this.state === 'closed' && this.failures >= this.failureThreshold) {\n this.state = 'open'\n this.openedAt = Date.now()\n }\n }\n\n private maybeTransitionToHalfOpen(): void {\n if (this.state === 'open' && this.openedAt != null) {\n if (Date.now() - this.openedAt >= this.resetTimeout) {\n this.state = 'half_open'\n this.halfOpenAttempts = 0\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,aAAqC;AAC/C,QAAM,oBAAoB,YAAY,8BAA8B;AAD1C,OAAA,cAAA;AAE1B,OAAK,OAAO;;;AAIhB,IAAa,iBAAb,MAA4B;CAC1B,QAAqC;CACrC,WAAmB;CACnB,YAAoB;CACpB,mBAA2B;CAC3B;CACA;CAEA;CACA;CACA;CAEA,YACE,MACA,SACA;AAFgB,OAAA,OAAA;AAGhB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,eAAe,QAAQ;AAC5B,OAAK,cAAc,QAAQ,eAAe;;;;;;CAO5C,MAAM,QAAW,IAAkC;AACjD,OAAK,2BAA2B;AAEhC,MAAI,KAAK,UAAU,OACjB,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,eAAe,KAAK,oBAAoB,KAAK,YAC9D,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,YACjB,MAAK;AAGP,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;AACzB,QAAK,WAAW;AAChB,UAAO;WACA,OAAO;AACd,QAAK,WAAW;AAChB,SAAM;;;;CAKV,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO,KAAK;;;CAId,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO;GACL,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;GAC9D;;;CAIH,QAAc;AACZ,OAAK,QAAQ;AACb,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,mBAAmB;AACxB,OAAK,cAAc,KAAA;AACnB,OAAK,WAAW,KAAA;;CAGlB,YAA0B;AACxB,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW;AAChB,QAAK,mBAAmB;AACxB,QAAK,WAAW,KAAA;;AAElB,OAAK;;CAGP,YAA0B;AACxB,OAAK;AACL,OAAK,8BAAc,IAAI,MAAM;AAE7B,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;AAC1B,QAAK,mBAAmB;aACf,KAAK,UAAU,YAAY,KAAK,YAAY,KAAK,kBAAkB;AAC5E,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;;;CAI9B,4BAA0C;AACxC,MAAI,KAAK,UAAU,UAAU,KAAK,YAAY;OACxC,KAAK,KAAK,GAAG,KAAK,YAAY,KAAK,cAAc;AACnD,SAAK,QAAQ;AACb,SAAK,mBAAmB"}
1
+ {"version":3,"file":"core-CBy6sBw_.mjs","names":[],"sources":["../src/core/circuit-breaker.ts"],"sourcesContent":["/**\n * Circuit Breaker pattern for external service calls.\n *\n * Protects your application from cascading failures when downstream\n * services are unhealthy by short-circuiting requests after a\n * configurable failure threshold.\n *\n * @example\n * ```ts\n * const breaker = new CircuitBreaker('payment-api', {\n * failureThreshold: 5,\n * resetTimeout: 30_000,\n * })\n *\n * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))\n * ```\n */\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half_open'\n\nexport interface CircuitBreakerOptions {\n /** Number of consecutive failures before the circuit opens. */\n failureThreshold: number\n /** Milliseconds to wait before transitioning from OPEN to HALF_OPEN. */\n resetTimeout: number\n /** Max requests allowed in HALF_OPEN state before deciding (default 1). */\n halfOpenMax?: number\n}\n\nexport interface CircuitBreakerStats {\n failures: number\n successes: number\n state: CircuitBreakerState\n lastFailure?: Date\n}\n\n/**\n * Error thrown when the circuit is open and calls are being rejected.\n */\nexport class CircuitOpenError extends Error {\n constructor(public readonly breakerName: string) {\n super(`Circuit breaker \"${breakerName}\" is open — request rejected`)\n this.name = 'CircuitOpenError'\n }\n}\n\nexport class CircuitBreaker {\n private state: CircuitBreakerState = 'closed'\n private failures = 0\n private successes = 0\n private halfOpenAttempts = 0\n private lastFailure?: Date\n private openedAt?: number\n\n private readonly failureThreshold: number\n private readonly resetTimeout: number\n private readonly halfOpenMax: number\n\n constructor(\n public readonly name: string,\n options: CircuitBreakerOptions,\n ) {\n this.failureThreshold = options.failureThreshold\n this.resetTimeout = options.resetTimeout\n this.halfOpenMax = options.halfOpenMax ?? 1\n }\n\n /**\n * Execute an async function through the circuit breaker.\n * Throws `CircuitOpenError` if the circuit is open.\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.maybeTransitionToHalfOpen()\n\n if (this.state === 'open') {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open' && this.halfOpenAttempts >= this.halfOpenMax) {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open') {\n this.halfOpenAttempts++\n }\n\n try {\n const result = await fn()\n this.onSuccess()\n return result\n } catch (error) {\n this.onFailure()\n throw error\n }\n }\n\n /** Returns the current circuit state. */\n getState(): CircuitBreakerState {\n this.maybeTransitionToHalfOpen()\n return this.state\n }\n\n /** Returns current statistics. */\n getStats(): CircuitBreakerStats {\n this.maybeTransitionToHalfOpen()\n return {\n failures: this.failures,\n successes: this.successes,\n state: this.state,\n ...(this.lastFailure ? { lastFailure: this.lastFailure } : {}),\n }\n }\n\n /** Manually reset the circuit breaker to CLOSED state. */\n reset(): void {\n this.state = 'closed'\n this.failures = 0\n this.successes = 0\n this.halfOpenAttempts = 0\n this.lastFailure = undefined\n this.openedAt = undefined\n }\n\n private onSuccess(): void {\n if (this.state === 'half_open') {\n // Recovery confirmed — close the circuit\n this.state = 'closed'\n this.failures = 0\n this.halfOpenAttempts = 0\n this.openedAt = undefined\n }\n this.successes++\n }\n\n private onFailure(): void {\n this.failures++\n this.lastFailure = new Date()\n\n if (this.state === 'half_open') {\n // Recovery failed — re-open\n this.state = 'open'\n this.openedAt = Date.now()\n this.halfOpenAttempts = 0\n } else if (this.state === 'closed' && this.failures >= this.failureThreshold) {\n this.state = 'open'\n this.openedAt = Date.now()\n }\n }\n\n private maybeTransitionToHalfOpen(): void {\n if (this.state === 'open' && this.openedAt != null) {\n if (Date.now() - this.openedAt >= this.resetTimeout) {\n this.state = 'half_open'\n this.halfOpenAttempts = 0\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,aAAqC;AAC/C,QAAM,oBAAoB,YAAY,8BAA8B;AAD1C,OAAA,cAAA;AAE1B,OAAK,OAAO;;;AAIhB,IAAa,iBAAb,MAA4B;CAC1B,QAAqC;CACrC,WAAmB;CACnB,YAAoB;CACpB,mBAA2B;CAC3B;CACA;CAEA;CACA;CACA;CAEA,YACE,MACA,SACA;AAFgB,OAAA,OAAA;AAGhB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,eAAe,QAAQ;AAC5B,OAAK,cAAc,QAAQ,eAAe;;;;;;CAO5C,MAAM,QAAW,IAAkC;AACjD,OAAK,2BAA2B;AAEhC,MAAI,KAAK,UAAU,OACjB,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,eAAe,KAAK,oBAAoB,KAAK,YAC9D,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,YACjB,MAAK;AAGP,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;AACzB,QAAK,WAAW;AAChB,UAAO;WACA,OAAO;AACd,QAAK,WAAW;AAChB,SAAM;;;;CAKV,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO,KAAK;;;CAId,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO;GACL,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;GAC9D;;;CAIH,QAAc;AACZ,OAAK,QAAQ;AACb,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,mBAAmB;AACxB,OAAK,cAAc,KAAA;AACnB,OAAK,WAAW,KAAA;;CAGlB,YAA0B;AACxB,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW;AAChB,QAAK,mBAAmB;AACxB,QAAK,WAAW,KAAA;;AAElB,OAAK;;CAGP,YAA0B;AACxB,OAAK;AACL,OAAK,8BAAc,IAAI,MAAM;AAE7B,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;AAC1B,QAAK,mBAAmB;aACf,KAAK,UAAU,YAAY,KAAK,YAAY,KAAK,kBAAkB;AAC5E,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;;;CAI9B,4BAA0C;AACxC,MAAI,KAAK,UAAU,UAAU,KAAK,YAAY;OACxC,KAAK,KAAK,GAAG,KAAK,YAAY,KAAK,cAAc;AACnD,SAAK,QAAQ;AACb,SAAK,mBAAmB"}
@@ -27,4 +27,4 @@ declare function Cron(expression: string, options?: {
27
27
  declare function getCronJobs(target: any): CronJobMeta[];
28
28
  //#endregion
29
29
  export { getCronJobs as i, Cron as n, CronJobMeta as r, CRON_META as t };
30
- //# sourceMappingURL=cron-C29iHvHT.d.mts.map
30
+ //# sourceMappingURL=cron-H-IyLcOr.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"cron-C29iHvHT.d.mts","names":[],"sources":["../src/core/cron.ts"],"mappings":";;cAEM,SAAA;AAAA,UAEW,WAAA;EACf,UAAA;EACA,WAAA;EACA,WAAA;EACA,QAAA;EACA,SAAA;AAAA;;;;;;;;;;AAqBF;iBAAgB,IAAA,CACd,UAAA,UACA,OAAA;EAAY,WAAA;EAAsB,QAAA;EAAmB,SAAA;AAAA,IACpD,eAAA;;iBAaa,WAAA,CAAY,MAAA,QAAc,WAAA"}
1
+ {"version":3,"file":"cron-H-IyLcOr.d.mts","names":[],"sources":["../src/core/cron.ts"],"mappings":";;cAEM,SAAA;AAAA,UAEW,WAAA;EACf,UAAA;EACA,WAAA;EACA,WAAA;EACA,QAAA;EACA,SAAA;AAAA;;;;;;;;;;AAqBF;iBAAgB,IAAA,CACd,UAAA,UACA,OAAA;EAAY,WAAA;EAAsB,QAAA;EAAmB,SAAA;AAAA,IACpD,eAAA;;iBAaa,WAAA,CAAY,MAAA,QAAc,WAAA"}
@@ -1,5 +1,5 @@
1
1
 
2
- import { l as ServiceOptions } from "./interfaces-D5ohYl6D.mjs";
2
+ import { l as ServiceOptions } from "./interfaces-DXjE8Re1.mjs";
3
3
  //#region src/core/decorators.d.ts
4
4
  /** Mark a class as injectable with lifecycle scope */
5
5
  declare function Injectable(options?: ServiceOptions): ClassDecorator;
@@ -201,4 +201,4 @@ declare function FileUpload(config: FileUploadConfig): MethodDecorator;
201
201
  declare function Builder(target: any): void;
202
202
  //#endregion
203
203
  export { Put as C, Value as D, Service as E, normalizeApiQueryParamsConfig as O, PostConstruct as S, RouteDefinition as T, Injectable as _, Builder as a, Patch as b, Controller as c, EnvKey as d, FileTypeFilter as f, Inject as g, Get as h, BaseUploadOptions as i, Delete as l, FileUploadConfig as m, ApiQueryParamsConfig as n, ColumnApiQueryParamsConfig as o, FileUpload as p, Autowired as r, Component as s, ApiQueryParams as t, Env as u, Middleware as v, Repository as w, Post as x, MiddlewareHandler as y };
204
- //# sourceMappingURL=decorators-D3lBlmud.d.mts.map
204
+ //# sourceMappingURL=decorators-C9_SN7ge.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"decorators-D3lBlmud.d.mts","names":[],"sources":["../src/core/decorators.ts"],"mappings":";;;;iBA8EgB,UAAA,CAAW,OAAA,GAAU,cAAA,GAAiB,cAAA;AAAtD;AAAA,iBAQgB,OAAA,CAAQ,OAAA,GAAU,cAAA,GAAiB,cAAA;;iBAQnC,SAAA,CAAU,OAAA,GAAU,cAAA,GAAiB,cAAA;;iBAQrC,UAAA,CAAW,OAAA,GAAU,cAAA,GAAiB,cAAA;;;;AAhBtD;;;;;iBA+BgB,UAAA,CAAW,IAAA,YAAgB,cAAA;;iBAW3B,aAAA,CAAA,GAAiB,eAAA;;iBASjB,SAAA,CAAU,KAAA,SAAc,iBAAA;;;;;;;iBAYxB,MAAA,CAAO,KAAA,QAAa,kBAAA;;AA/CpC;;;;;;;;;AAeA;QAiDQ,MAAA;EAAA,UAEI,OAAA;AAAA;AAxCZ;AAAA,KA4CY,MAAA,SAAe,OAAA;;;;AAnC3B;;;;;AAYA;;;;;AAIC;;KAoCW,GAAA,WAAc,MAAA,GAAS,MAAA,IAAU,OAAA,CAAQ,CAAA;;;;AAjBrD;;;;;AAiBA;;;KAaK,QAAA,sBAA8B,MAAA,oBAA0B,CAAA,GAAI,CAAA,GAAI,MAAA;;;;;;;;;;;;;AAbd;;;iBA8BvC,KAAA,kBAAA,CACd,MAAA,EAAQ,QAAA,CAAS,CAAA,GACjB,YAAA,GAAe,CAAA,SAAU,MAAA,GAAS,OAAA,CAAQ,CAAA,cACzC,iBAAA;AAAA,UAQc,eAAA;EACf,MAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;IAhCY,yDAkCV,IAAA,QAlCyD;IAoCzD,KAAA,QApCiE;IAsCjE,MAAA,QAtCuE;IAwCvE,IAAA;EAAA;AAAA;AAAA,cAiBS,GAAA,GAAG,IAAA,WAZO,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAazD,IAAA,GAAI,IAAA,WAbM,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAczD,GAAA,GAAG,IAAA,WAdO,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAezD,MAAA,GAAM,IAAA,WAfI,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAgBzD,KAAA,GAAK,IAAA,WAhBK,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,UAoBrD,oBAAA;EA7Cd;EA+CD,UAAA;EA/CkB;EAiDlB,QAAA;EAnDQ;EAqDR,UAAA;AAAA;;;;;UAOe,0BAAA;EACf,OAAA,EAAS,MAAA;EACT,QAAA,GAAW,MAAA;EACX,aAAA;EAAA,CACC,GAAA;AAAA;;;;;iBAOa,6BAAA,CACd,MAAA,EAAQ,oBAAA,GAAuB,0BAAA,GAC9B,oBAAA;;;;;;;;AAlCH;;;;;;;;;;AACA;;;iBAkEgB,cAAA,CACd,MAAA,EAAQ,oBAAA,GAAuB,0BAAA,GAC9B,eAAA;;;;;;;AAnEH;;;;;;;;;KA2FY,iBAAA,gBAAiC,GAAA,EAAK,IAAA,EAAM,IAAA,wBAA4B,OAAA;AA1FpF;AAAA,iBA6FgB,UAAA,CAAA,GAAc,QAAA,EAAU,iBAAA,KAAsB,cAAA,GAAiB,eAAA;;;;;KAqBnE,cAAA,gBAA8B,QAAA,UAAkB,QAAA;;;;AAjH5D;UAuHiB,iBAAA;;EAEf,OAAA;EAzHgB;;;;;EA+HhB,YAAA,GAAe,cAAA;EA3HA;EA6Hf,aAAA,GAAgB,MAAA;AAAA;AAAA,UAGD,gBAAA,SAAyB,iBAAA;EACxC,IAAA;EA7HA;EA+HA,SAAA;EA7HU;EA+HV,QAAA;AAAA;;iBAIc,UAAA,CAAW,MAAA,EAAQ,gBAAA,GAAmB,eAAA;;iBAStC,OAAA,CAAQ,MAAA"}
1
+ {"version":3,"file":"decorators-C9_SN7ge.d.mts","names":[],"sources":["../src/core/decorators.ts"],"mappings":";;;;iBA8EgB,UAAA,CAAW,OAAA,GAAU,cAAA,GAAiB,cAAA;AAAtD;AAAA,iBAQgB,OAAA,CAAQ,OAAA,GAAU,cAAA,GAAiB,cAAA;;iBAQnC,SAAA,CAAU,OAAA,GAAU,cAAA,GAAiB,cAAA;;iBAQrC,UAAA,CAAW,OAAA,GAAU,cAAA,GAAiB,cAAA;;;;AAhBtD;;;;;iBA+BgB,UAAA,CAAW,IAAA,YAAgB,cAAA;;iBAW3B,aAAA,CAAA,GAAiB,eAAA;;iBASjB,SAAA,CAAU,KAAA,SAAc,iBAAA;;;;;;;iBAYxB,MAAA,CAAO,KAAA,QAAa,kBAAA;;AA/CpC;;;;;;;;;AAeA;QAiDQ,MAAA;EAAA,UAEI,OAAA;AAAA;AAxCZ;AAAA,KA4CY,MAAA,SAAe,OAAA;;;;AAnC3B;;;;;AAYA;;;;;AAIC;;KAoCW,GAAA,WAAc,MAAA,GAAS,MAAA,IAAU,OAAA,CAAQ,CAAA;;;;AAjBrD;;;;;AAiBA;;;KAaK,QAAA,sBAA8B,MAAA,oBAA0B,CAAA,GAAI,CAAA,GAAI,MAAA;;;;;;;;;;;;;AAbd;;;iBA8BvC,KAAA,kBAAA,CACd,MAAA,EAAQ,QAAA,CAAS,CAAA,GACjB,YAAA,GAAe,CAAA,SAAU,MAAA,GAAS,OAAA,CAAQ,CAAA,cACzC,iBAAA;AAAA,UAQc,eAAA;EACf,MAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;IAhCY,yDAkCV,IAAA,QAlCyD;IAoCzD,KAAA,QApCiE;IAsCjE,MAAA,QAtCuE;IAwCvE,IAAA;EAAA;AAAA;AAAA,cAiBS,GAAA,GAAG,IAAA,WAZO,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAazD,IAAA,GAAI,IAAA,WAbM,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAczD,GAAA,GAAG,IAAA,WAdO,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAezD,MAAA,GAAM,IAAA,WAfI,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,cAgBzD,KAAA,GAAK,IAAA,WAhBK,UAAA,GAAe,eAAA,mBAAgC,eAAA;AAAA,UAoBrD,oBAAA;EA7Cd;EA+CD,UAAA;EA/CkB;EAiDlB,QAAA;EAnDQ;EAqDR,UAAA;AAAA;;;;;UAOe,0BAAA;EACf,OAAA,EAAS,MAAA;EACT,QAAA,GAAW,MAAA;EACX,aAAA;EAAA,CACC,GAAA;AAAA;;;;;iBAOa,6BAAA,CACd,MAAA,EAAQ,oBAAA,GAAuB,0BAAA,GAC9B,oBAAA;;;;;;;;AAlCH;;;;;;;;;;AACA;;;iBAkEgB,cAAA,CACd,MAAA,EAAQ,oBAAA,GAAuB,0BAAA,GAC9B,eAAA;;;;;;;AAnEH;;;;;;;;;KA2FY,iBAAA,gBAAiC,GAAA,EAAK,IAAA,EAAM,IAAA,wBAA4B,OAAA;AA1FpF;AAAA,iBA6FgB,UAAA,CAAA,GAAc,QAAA,EAAU,iBAAA,KAAsB,cAAA,GAAiB,eAAA;;;;;KAqBnE,cAAA,gBAA8B,QAAA,UAAkB,QAAA;;;;AAjH5D;UAuHiB,iBAAA;;EAEf,OAAA;EAzHgB;;;;;EA+HhB,YAAA,GAAe,cAAA;EA3HA;EA6Hf,aAAA,GAAgB,MAAA;AAAA;AAAA,UAGD,gBAAA,SAAyB,iBAAA;EACxC,IAAA;EA7HA;EA+HA,SAAA;EA7HU;EA+HV,QAAA;AAAA;;iBAIc,UAAA,CAAW,MAAA,EAAQ,gBAAA,GAAmB,eAAA;;iBAStC,OAAA,CAAQ,MAAA"}
@@ -0,0 +1,111 @@
1
+ /**
2
+ * @forinda/kickjs v2.2.3
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ import { t as __require } from "./chunk-DkuVAWq_.mjs";
12
+ import { t as Container } from "./container-CnP8G9tl.mjs";
13
+ import { z } from "zod";
14
+ //#region src/config/env.ts
15
+ /**
16
+ * Lazily load `dotenv/config` if it is installed in the consumer app.
17
+ * `dotenv` is an **optional peer dependency** of `@forinda/kickjs` —
18
+ * apps that want `.env` file support install it themselves (the CLI
19
+ * generators add it to every scaffolded `package.json`). Apps that
20
+ * inject env via the shell, Docker, or a secret manager can skip it
21
+ * entirely and `process.env` is read as-is.
22
+ *
23
+ * This module-load side effect runs exactly once.
24
+ */
25
+ function tryLoadDotenv() {
26
+ try {
27
+ __require("dotenv/config");
28
+ } catch {}
29
+ }
30
+ tryLoadDotenv();
31
+ /**
32
+ * Base environment schema with common server variables.
33
+ * Users extend this with their own application-specific vars.
34
+ */
35
+ const baseEnvSchema = z.object({
36
+ PORT: z.coerce.number().default(3e3),
37
+ NODE_ENV: z.enum([
38
+ "development",
39
+ "production",
40
+ "test"
41
+ ]).default("development"),
42
+ LOG_LEVEL: z.string().default("info")
43
+ });
44
+ /** Cached env config to avoid re-parsing — keyed by schema reference */
45
+ let cachedEnv = null;
46
+ let cachedSchema = null;
47
+ /**
48
+ * Define a custom env schema. The base schema (`PORT`, `NODE_ENV`,
49
+ * `LOG_LEVEL`) is always merged in, so users never need to remember to
50
+ * extend it themselves — both styles below produce the same result and
51
+ * both surface the base keys in `KickEnv`.
52
+ *
53
+ * Returns a Zod schema that validates `process.env`.
54
+ *
55
+ * @example
56
+ * ```ts
57
+ * // Style A — return a fresh object; base fields are merged automatically
58
+ * export default defineEnv(() =>
59
+ * z.object({
60
+ * DATABASE_URL: z.string().url(),
61
+ * JWT_SECRET: z.string().min(32),
62
+ * })
63
+ * )
64
+ *
65
+ * // Style B — explicitly extend `base` (still works, identical result)
66
+ * export default defineEnv((base) =>
67
+ * base.extend({
68
+ * DATABASE_URL: z.string().url(),
69
+ * })
70
+ * )
71
+ * ```
72
+ *
73
+ * User-defined keys override base keys when they collide, so a project
74
+ * can re-type `PORT` or tighten `NODE_ENV` without losing the rest of
75
+ * the base shape.
76
+ */
77
+ function defineEnv(extend) {
78
+ const userSchema = extend(baseEnvSchema);
79
+ return baseEnvSchema.extend(userSchema.shape);
80
+ }
81
+ function loadEnv(schema) {
82
+ const s = schema ?? cachedSchema ?? baseEnvSchema;
83
+ if (cachedEnv && cachedSchema === s) return cachedEnv;
84
+ cachedSchema = s;
85
+ cachedEnv = s.parse(process.env);
86
+ Container._envResolver = (key) => cachedEnv?.[key];
87
+ return cachedEnv;
88
+ }
89
+ function getEnv(key, schema) {
90
+ return (schema ? loadEnv(schema) : loadEnv())[key];
91
+ }
92
+ /**
93
+ * Reload env from process.env (re-reads dotenv if installed, clears cache).
94
+ * Called during HMR rebuild to pick up .env file changes.
95
+ */
96
+ function reloadEnv() {
97
+ try {
98
+ __require("dotenv").config({ override: true });
99
+ } catch {}
100
+ cachedEnv = null;
101
+ cachedSchema = null;
102
+ }
103
+ /** Reset cached env (useful for testing) */
104
+ function resetEnvCache() {
105
+ cachedEnv = null;
106
+ cachedSchema = null;
107
+ }
108
+ //#endregion
109
+ export { reloadEnv as a, loadEnv as i, defineEnv as n, resetEnvCache as o, getEnv as r, baseEnvSchema as t };
110
+
111
+ //# sourceMappingURL=env-CtsOktU_.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-CtsOktU_.mjs","names":[],"sources":["../src/config/env.ts"],"sourcesContent":["import { z } from 'zod'\nimport { Container } from '../core/container'\nimport type { EnvKey } from '../core/decorators'\n\n/**\n * Lazily load `dotenv/config` if it is installed in the consumer app.\n * `dotenv` is an **optional peer dependency** of `@forinda/kickjs` —\n * apps that want `.env` file support install it themselves (the CLI\n * generators add it to every scaffolded `package.json`). Apps that\n * inject env via the shell, Docker, or a secret manager can skip it\n * entirely and `process.env` is read as-is.\n *\n * This module-load side effect runs exactly once.\n */\nfunction tryLoadDotenv(): void {\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n require('dotenv/config')\n } catch {\n // dotenv not installed — fall through, env vars must come from\n // the environment directly. This is a valid deployment style.\n }\n}\ntryLoadDotenv()\n\n/**\n * Base environment schema with common server variables.\n * Users extend this with their own application-specific vars.\n */\nexport const baseEnvSchema = z.object({\n // Server\n PORT: z.coerce.number().default(3000),\n NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),\n LOG_LEVEL: z.string().default('info'),\n})\n\n/** Cached env config to avoid re-parsing — keyed by schema reference */\nlet cachedEnv: any = null\nlet cachedSchema: any = null\n\n/**\n * Define a custom env schema. The base schema (`PORT`, `NODE_ENV`,\n * `LOG_LEVEL`) is always merged in, so users never need to remember to\n * extend it themselves — both styles below produce the same result and\n * both surface the base keys in `KickEnv`.\n *\n * Returns a Zod schema that validates `process.env`.\n *\n * @example\n * ```ts\n * // Style A — return a fresh object; base fields are merged automatically\n * export default defineEnv(() =>\n * z.object({\n * DATABASE_URL: z.string().url(),\n * JWT_SECRET: z.string().min(32),\n * })\n * )\n *\n * // Style B — explicitly extend `base` (still works, identical result)\n * export default defineEnv((base) =>\n * base.extend({\n * DATABASE_URL: z.string().url(),\n * })\n * )\n * ```\n *\n * User-defined keys override base keys when they collide, so a project\n * can re-type `PORT` or tighten `NODE_ENV` without losing the rest of\n * the base shape.\n */\nexport function defineEnv<T extends z.ZodRawShape>(\n extend: (base: typeof baseEnvSchema) => z.ZodObject<T>,\n): z.ZodObject<typeof baseEnvSchema.shape & T> {\n const userSchema = extend(baseEnvSchema)\n // Always merge the base in. `extend` lets the user's shape override\n // any colliding base keys, which preserves the escape hatch for\n // projects that want to re-type `PORT` etc.\n return baseEnvSchema.extend(userSchema.shape) as z.ZodObject<typeof baseEnvSchema.shape & T>\n}\n\n/**\n * Parse and validate process.env against a Zod schema. Caches result per schema.\n *\n * **No-arg behaviour is sticky.** The first time `loadEnv(schema)` is called\n * with an extended schema, the cache holds that schema. Subsequent\n * `loadEnv()` calls (no arg) will reuse the cached extended schema rather\n * than falling back to `baseEnvSchema` and clobbering the env resolver.\n *\n * This matters because `ConfigService` (and the bare `Container._envResolver`)\n * call `loadEnv()` without an argument inside their constructors. Without\n * stickiness, instantiating `ConfigService` after a `loadEnv(extendedSchema)`\n * call would silently downgrade the env to the base shape.\n *\n * To force a re-parse with a different schema, pass the new schema explicitly.\n * To start fresh, call `resetEnvCache()` or `reloadEnv()`.\n *\n * **Typing:**\n * - With an explicit schema → returns `z.infer<typeof schema>`.\n * - With no schema and `KickEnv` populated by typegen → returns\n * `KickEnv` (the project-wide typed env shape).\n * - With no schema and `KickEnv` empty → returns the base `Env`.\n */\nexport function loadEnv<T extends z.ZodObject<any>>(schema: T): z.infer<T>\nexport function loadEnv(): [EnvKey] extends [never] ? Env : KickEnv\nexport function loadEnv<T extends z.ZodObject<any>>(schema?: T): any {\n // Sticky: when called with no arg, prefer the most recently cached\n // schema over re-parsing with the base schema.\n const s = schema ?? cachedSchema ?? baseEnvSchema\n // Re-parse if schema changed or no cache yet\n if (cachedEnv && cachedSchema === s) return cachedEnv\n cachedSchema = s\n cachedEnv = s.parse(process.env)\n\n // Register env resolver so @Value() reads validated values\n Container._envResolver = (key: string) => cachedEnv?.[key]\n\n return cachedEnv\n}\n\n/**\n * Get a single typed environment variable value.\n *\n * Three forms:\n * - **No-arg, KickEnv populated** (`kick typegen` has run) → key is\n * constrained to known `KickEnv` keys; return type inferred from\n * the schema.\n * - **With explicit schema** → key constrained to that schema's keys;\n * return type is `z.infer<typeof schema>[K]`.\n * - **No-arg, KickEnv empty** → loose `string` key, `any` return.\n *\n * @example\n * ```ts\n * // After `kick typegen` (KickEnv populated):\n * const port = getEnv('PORT') // typed as number\n * const url = getEnv('DATABASE_URL') // typed as string\n *\n * // With an inline schema (legacy / one-off):\n * const dbUrl = getEnv('DATABASE_URL', envSchema)\n * ```\n */\nexport function getEnv<K extends EnvKey>(key: K): KickEnv[K]\nexport function getEnv<T extends z.ZodObject<any>, K extends string & keyof z.infer<T>>(\n key: K,\n schema: T,\n): z.infer<T>[K]\nexport function getEnv(key: string, schema?: z.ZodObject<any>): any {\n const env = schema ? loadEnv(schema) : (loadEnv() as Record<string, any>)\n return env[key]\n}\n\n/**\n * Reload env from process.env (re-reads dotenv if installed, clears cache).\n * Called during HMR rebuild to pick up .env file changes.\n */\nexport function reloadEnv(): void {\n // Re-read .env file into process.env if dotenv is installed.\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n require('dotenv').config({ override: true })\n } catch {\n // dotenv not installed — nothing to reload, env comes from the\n // environment directly.\n }\n\n // Clear the parse cache so next loadEnv() re-validates\n cachedEnv = null\n cachedSchema = null\n}\n\n/** Reset cached env (useful for testing) */\nexport function resetEnvCache(): void {\n cachedEnv = null\n cachedSchema = null\n}\n\nexport type Env = z.infer<typeof baseEnvSchema>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAcA,SAAS,gBAAsB;AAC7B,KAAI;AAEF,YAAQ,gBAAgB;SAClB;;AAKV,eAAe;;;;;AAMf,MAAa,gBAAgB,EAAE,OAAO;CAEpC,MAAM,EAAE,OAAO,QAAQ,CAAC,QAAQ,IAAK;CACrC,UAAU,EAAE,KAAK;EAAC;EAAe;EAAc;EAAO,CAAC,CAAC,QAAQ,cAAc;CAC9E,WAAW,EAAE,QAAQ,CAAC,QAAQ,OAAO;CACtC,CAAC;;AAGF,IAAI,YAAiB;AACrB,IAAI,eAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCxB,SAAgB,UACd,QAC6C;CAC7C,MAAM,aAAa,OAAO,cAAc;AAIxC,QAAO,cAAc,OAAO,WAAW,MAAM;;AA2B/C,SAAgB,QAAoC,QAAiB;CAGnE,MAAM,IAAI,UAAU,gBAAgB;AAEpC,KAAI,aAAa,iBAAiB,EAAG,QAAO;AAC5C,gBAAe;AACf,aAAY,EAAE,MAAM,QAAQ,IAAI;AAGhC,WAAU,gBAAgB,QAAgB,YAAY;AAEtD,QAAO;;AA6BT,SAAgB,OAAO,KAAa,QAAgC;AAElE,SADY,SAAS,QAAQ,OAAO,GAAI,SAAS,EACtC;;;;;;AAOb,SAAgB,YAAkB;AAEhC,KAAI;AAEF,YAAQ,SAAS,CAAC,OAAO,EAAE,UAAU,MAAM,CAAC;SACtC;AAMR,aAAY;AACZ,gBAAe;;;AAIjB,SAAgB,gBAAsB;AACpC,aAAY;AACZ,gBAAe"}