@forinda/kickjs 2.2.3 → 2.2.4

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 (55) hide show
  1. package/dist/{application-CrlnuJQI.mjs → application-CLkVCFWJ.mjs} +5 -5
  2. package/dist/{application-CrlnuJQI.mjs.map → application-CLkVCFWJ.mjs.map} +1 -1
  3. package/dist/{bootstrap-Zww8CPRP.mjs → bootstrap-cTXpK1QK.mjs} +6 -6
  4. package/dist/{bootstrap-Zww8CPRP.mjs.map → bootstrap-cTXpK1QK.mjs.map} +1 -1
  5. package/dist/{chunk-DkuVAWq_.mjs → chunk-DnmL-75g.mjs} +1 -1
  6. package/dist/config/index.d.mts +1 -1
  7. package/dist/config/index.mjs +3 -3
  8. package/dist/{config-BszyH8VL.mjs → config-Cc29Xd0g.mjs} +3 -3
  9. package/dist/{config-BszyH8VL.mjs.map → config-Cc29Xd0g.mjs.map} +1 -1
  10. package/dist/{container-CnP8G9tl.mjs → container-CMuZkVRS.mjs} +3 -3
  11. package/dist/{container-CnP8G9tl.mjs.map → container-CMuZkVRS.mjs.map} +1 -1
  12. package/dist/core/adapter.mjs +1 -1
  13. package/dist/core/app-module.mjs +1 -1
  14. package/dist/core/cache.mjs +1 -1
  15. package/dist/core/container.mjs +2 -2
  16. package/dist/core/cron.mjs +2 -2
  17. package/dist/core/decorators.mjs +3 -3
  18. package/dist/core/errors.mjs +1 -1
  19. package/dist/core/interfaces.mjs +1 -1
  20. package/dist/core/logger.mjs +1 -1
  21. package/dist/core/path.mjs +1 -1
  22. package/dist/core/plugin.mjs +1 -1
  23. package/dist/core/reactivity.mjs +1 -1
  24. package/dist/{core-CBy6sBw_.mjs → core-D-167yQ4.mjs} +4 -4
  25. package/dist/{core-CBy6sBw_.mjs.map → core-D-167yQ4.mjs.map} +1 -1
  26. package/dist/{env-CtsOktU_.mjs → env-C9zCAyMW.mjs} +24 -8
  27. package/dist/env-C9zCAyMW.mjs.map +1 -0
  28. package/dist/http/application.mjs +2 -2
  29. package/dist/http/bootstrap.mjs +2 -2
  30. package/dist/http/context.mjs +2 -2
  31. package/dist/http/middleware/cors.mjs +1 -1
  32. package/dist/http/middleware/csrf.mjs +1 -1
  33. package/dist/http/middleware/error-handler.mjs +2 -2
  34. package/dist/http/middleware/helmet.mjs +1 -1
  35. package/dist/http/middleware/rate-limit.mjs +1 -1
  36. package/dist/http/middleware/request-id.mjs +1 -1
  37. package/dist/http/middleware/request-logger.mjs +2 -2
  38. package/dist/http/middleware/session.mjs +1 -1
  39. package/dist/http/middleware/spa.mjs +3 -3
  40. package/dist/http/middleware/upload.mjs +1 -1
  41. package/dist/http/middleware/validate.mjs +1 -1
  42. package/dist/http/middleware/views.mjs +2 -2
  43. package/dist/http/query/index.mjs +2 -2
  44. package/dist/http/router-builder.mjs +4 -4
  45. package/dist/{index-Cmq_UBmJ.d.mts → index-DNVfGjF9.d.mts} +28 -11
  46. package/dist/index-DNVfGjF9.d.mts.map +1 -0
  47. package/dist/index.d.mts +1 -1
  48. package/dist/index.mjs +9 -9
  49. package/dist/{metadata-UdEcgIBJ.mjs → metadata-DaP_5Q0Y.mjs} +2 -2
  50. package/dist/{metadata-UdEcgIBJ.mjs.map → metadata-DaP_5Q0Y.mjs.map} +1 -1
  51. package/dist/{query-BhHetB5I.mjs → query-CnxrNfxU.mjs} +2 -2
  52. package/dist/{query-BhHetB5I.mjs.map → query-CnxrNfxU.mjs.map} +1 -1
  53. package/package.json +1 -1
  54. package/dist/env-CtsOktU_.mjs.map +0 -1
  55. package/dist/index-Cmq_UBmJ.d.mts.map +0 -1
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
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-CnP8G9tl.mjs";
11
+ import { n as tokenName, t as Container } from "../container-CMuZkVRS.mjs";
12
12
  export { Container, tokenName };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
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-UdEcgIBJ.mjs";
11
+ import { c as pushClassMeta, t as getClassMeta } from "../metadata-DaP_5Q0Y.mjs";
12
12
  //#region src/core/cron.ts
13
13
  const CRON_META = Symbol("kick:cron");
14
14
  /**
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
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-UdEcgIBJ.mjs";
13
- import { t as Container } from "../container-CnP8G9tl.mjs";
12
+ import { c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, l as pushMethodMeta, p as setMethodMeta, u as setClassMeta } from "../metadata-DaP_5Q0Y.mjs";
13
+ import { t as Container } from "../container-CMuZkVRS.mjs";
14
14
  import "reflect-metadata";
15
15
  //#region src/core/decorators.ts
16
16
  const pendingRegistrations = [];
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
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-UdEcgIBJ.mjs";
14
- import "./container-CnP8G9tl.mjs";
13
+ import "./metadata-DaP_5Q0Y.mjs";
14
+ import "./container-CMuZkVRS.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-CBy6sBw_.mjs.map
121
+ //# sourceMappingURL=core-D-167yQ4.mjs.map
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"core-D-167yQ4.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,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,8 +8,8 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { t as __require } from "./chunk-DkuVAWq_.mjs";
12
- import { t as Container } from "./container-CnP8G9tl.mjs";
11
+ import { t as __require } from "./chunk-DnmL-75g.mjs";
12
+ import { t as Container } from "./container-CMuZkVRS.mjs";
13
13
  import { z } from "zod";
14
14
  //#region src/config/env.ts
15
15
  /**
@@ -90,17 +90,33 @@ function getEnv(key, schema) {
90
90
  return (schema ? loadEnv(schema) : loadEnv())[key];
91
91
  }
92
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.
93
+ * Reload env from `process.env`. Re-reads `.env` via dotenv (if
94
+ * installed), then re-parses the result against the **same** schema
95
+ * the project registered at startup. Called during HMR rebuild and by
96
+ * `envWatchPlugin` to pick up `.env` file changes mid-session.
97
+ *
98
+ * Crucially, this preserves the registered schema. Wiping it would
99
+ * silently downgrade `ConfigService` and `@Value()` back to the base
100
+ * schema on the next read, so every user-defined key would start
101
+ * resolving as `undefined` after the first `.env` save — which was the
102
+ * original "config disappears in dev" bug.
103
+ *
104
+ * If you need to fully forget the schema (e.g. tests that swap schemas
105
+ * between cases), call {@link resetEnvCache} instead.
95
106
  */
96
107
  function reloadEnv() {
97
108
  try {
98
109
  __require("dotenv").config({ override: true });
99
110
  } catch {}
100
111
  cachedEnv = null;
101
- cachedSchema = null;
112
+ if (cachedSchema) loadEnv(cachedSchema);
102
113
  }
103
- /** Reset cached env (useful for testing) */
114
+ /**
115
+ * Fully reset the env cache, including the registered schema. Use this
116
+ * in tests that need to swap schemas between cases — `reloadEnv()`
117
+ * deliberately preserves the schema to avoid the "user keys vanish on
118
+ * `.env` reload" footgun.
119
+ */
104
120
  function resetEnvCache() {
105
121
  cachedEnv = null;
106
122
  cachedSchema = null;
@@ -108,4 +124,4 @@ function resetEnvCache() {
108
124
  //#endregion
109
125
  export { reloadEnv as a, loadEnv as i, defineEnv as n, resetEnvCache as o, getEnv as r, baseEnvSchema as t };
110
126
 
111
- //# sourceMappingURL=env-CtsOktU_.mjs.map
127
+ //# sourceMappingURL=env-C9zCAyMW.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-C9zCAyMW.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`.\n *\n * Stickiness matters because `ConfigService` and the `@Value()` decorator\n * both read through the no-arg form internally. Without it, resolving\n * either of them after a `loadEnv(extendedSchema)` call would silently\n * downgrade the env to the base shape and drop every user-defined key.\n *\n * To force a re-parse with a different schema, pass the new schema explicitly.\n * To start fresh, call `resetEnvCache()` (full reset) or `reloadEnv()`\n * (re-parse against the same schema after a `.env` file change).\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 `.env` via dotenv (if\n * installed), then re-parses the result against the **same** schema\n * the project registered at startup. Called during HMR rebuild and by\n * `envWatchPlugin` to pick up `.env` file changes mid-session.\n *\n * Crucially, this preserves the registered schema. Wiping it would\n * silently downgrade `ConfigService` and `@Value()` back to the base\n * schema on the next read, so every user-defined key would start\n * resolving as `undefined` after the first `.env` save — which was the\n * original \"config disappears in dev\" bug.\n *\n * If you need to fully forget the schema (e.g. tests that swap schemas\n * between cases), call {@link resetEnvCache} instead.\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 // Drop the parsed snapshot but keep the schema. Re-parse eagerly so\n // existing consumers (including ConfigService getters and @Value\n // resolvers that may already hold references to the env state) see\n // the new values on their very next read instead of having to\n // re-trigger any cache-population step.\n cachedEnv = null\n if (cachedSchema) {\n loadEnv(cachedSchema)\n }\n}\n\n/**\n * Fully reset the env cache, including the registered schema. Use this\n * in tests that need to swap schemas between cases — `reloadEnv()`\n * deliberately preserves the schema to avoid the \"user keys vanish on\n * `.env` reload\" footgun.\n */\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;;AA4B/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;;;;;;;;;;;;;;;;;AAkBb,SAAgB,YAAkB;AAEhC,KAAI;AAEF,YAAQ,SAAS,CAAC,OAAO,EAAE,UAAU,MAAM,CAAC;SACtC;AAUR,aAAY;AACZ,KAAI,aACF,SAAQ,aAAa;;;;;;;;AAUzB,SAAgB,gBAAsB;AACpC,aAAY;AACZ,gBAAe"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { t as Application } from "../application-CrlnuJQI.mjs";
11
+ import { t as Application } from "../application-CLkVCFWJ.mjs";
12
12
  export { Application };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { t as bootstrap } from "../bootstrap-Zww8CPRP.mjs";
11
+ import { t as bootstrap } from "../bootstrap-cTXpK1QK.mjs";
12
12
  export { bootstrap };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { i as parseQuery } from "../query-BhHetB5I.mjs";
11
+ import { i as parseQuery } from "../query-CnxrNfxU.mjs";
12
12
  //#region src/http/context.ts
13
13
  /**
14
14
  * Unified request/response abstraction passed to every controller method.
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -10,7 +10,7 @@
10
10
  */
11
11
  import { createLogger } from "../../core/logger.mjs";
12
12
  import { HttpException } from "../../core/errors.mjs";
13
- import "../../core-CBy6sBw_.mjs";
13
+ import "../../core-D-167yQ4.mjs";
14
14
  //#region src/http/middleware/error-handler.ts
15
15
  const log = createLogger("ErrorHandler");
16
16
  /** Catch-all for unmatched routes */
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,7 +9,7 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { createLogger } from "../../core/logger.mjs";
12
- import "../../core-CBy6sBw_.mjs";
12
+ import "../../core-D-167yQ4.mjs";
13
13
  //#region src/http/middleware/request-logger.ts
14
14
  /**
15
15
  * Middleware that logs every request with method, URL, status, duration, and request ID.
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,9 +8,9 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { t as __require } from "../../chunk-DkuVAWq_.mjs";
11
+ import { t as __require } from "../../chunk-DnmL-75g.mjs";
12
12
  import { Logger } from "../../core/logger.mjs";
13
- import "../../core-CBy6sBw_.mjs";
13
+ import "../../core-D-167yQ4.mjs";
14
14
  import { join, resolve } from "node:path";
15
15
  import { existsSync, readFileSync } from "node:fs";
16
16
  //#region src/http/middleware/spa.ts
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,7 +9,7 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { Logger } from "../../core/logger.mjs";
12
- import "../../core-CBy6sBw_.mjs";
12
+ import "../../core-D-167yQ4.mjs";
13
13
  import { resolve } from "node:path";
14
14
  //#region src/http/middleware/views.ts
15
15
  const log = Logger.for("ViewEngine");
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "../../query-BhHetB5I.mjs";
11
+ import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "../../query-CnxrNfxU.mjs";
12
12
  export { FILTER_OPERATORS, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,9 +9,9 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { METADATA } from "../core/interfaces.mjs";
12
- import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-UdEcgIBJ.mjs";
13
- import { t as Container } from "../container-CnP8G9tl.mjs";
14
- import "../core-CBy6sBw_.mjs";
12
+ import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-DaP_5Q0Y.mjs";
13
+ import { t as Container } from "../container-CMuZkVRS.mjs";
14
+ import "../core-D-167yQ4.mjs";
15
15
  import { RequestContext } from "./context.mjs";
16
16
  import { validate } from "./middleware/validate.mjs";
17
17
  import { buildUploadMiddleware } from "./middleware/upload.mjs";
@@ -48,20 +48,21 @@ declare const baseEnvSchema: z.ZodObject<{
48
48
  */
49
49
  declare function defineEnv<T extends z.ZodRawShape>(extend: (base: typeof baseEnvSchema) => z.ZodObject<T>): z.ZodObject<typeof baseEnvSchema.shape & T>;
50
50
  /**
51
- * Parse and validate process.env against a Zod schema. Caches result per schema.
51
+ * Parse and validate `process.env` against a Zod schema. Caches result per schema.
52
52
  *
53
53
  * **No-arg behaviour is sticky.** The first time `loadEnv(schema)` is called
54
54
  * with an extended schema, the cache holds that schema. Subsequent
55
55
  * `loadEnv()` calls (no arg) will reuse the cached extended schema rather
56
- * than falling back to `baseEnvSchema` and clobbering the env resolver.
56
+ * than falling back to `baseEnvSchema`.
57
57
  *
58
- * This matters because `ConfigService` (and the bare `Container._envResolver`)
59
- * call `loadEnv()` without an argument inside their constructors. Without
60
- * stickiness, instantiating `ConfigService` after a `loadEnv(extendedSchema)`
61
- * call would silently downgrade the env to the base shape.
58
+ * Stickiness matters because `ConfigService` and the `@Value()` decorator
59
+ * both read through the no-arg form internally. Without it, resolving
60
+ * either of them after a `loadEnv(extendedSchema)` call would silently
61
+ * downgrade the env to the base shape and drop every user-defined key.
62
62
  *
63
63
  * To force a re-parse with a different schema, pass the new schema explicitly.
64
- * To start fresh, call `resetEnvCache()` or `reloadEnv()`.
64
+ * To start fresh, call `resetEnvCache()` (full reset) or `reloadEnv()`
65
+ * (re-parse against the same schema after a `.env` file change).
65
66
  *
66
67
  * **Typing:**
67
68
  * - With an explicit schema → returns `z.infer<typeof schema>`.
@@ -95,11 +96,27 @@ declare function loadEnv(): [EnvKey] extends [never] ? Env : KickEnv;
95
96
  declare function getEnv<K extends EnvKey>(key: K): KickEnv[K];
96
97
  declare function getEnv<T extends z.ZodObject<any>, K extends string & keyof z.infer<T>>(key: K, schema: T): z.infer<T>[K];
97
98
  /**
98
- * Reload env from process.env (re-reads dotenv if installed, clears cache).
99
- * Called during HMR rebuild to pick up .env file changes.
99
+ * Reload env from `process.env`. Re-reads `.env` via dotenv (if
100
+ * installed), then re-parses the result against the **same** schema
101
+ * the project registered at startup. Called during HMR rebuild and by
102
+ * `envWatchPlugin` to pick up `.env` file changes mid-session.
103
+ *
104
+ * Crucially, this preserves the registered schema. Wiping it would
105
+ * silently downgrade `ConfigService` and `@Value()` back to the base
106
+ * schema on the next read, so every user-defined key would start
107
+ * resolving as `undefined` after the first `.env` save — which was the
108
+ * original "config disappears in dev" bug.
109
+ *
110
+ * If you need to fully forget the schema (e.g. tests that swap schemas
111
+ * between cases), call {@link resetEnvCache} instead.
100
112
  */
101
113
  declare function reloadEnv(): void;
102
- /** Reset cached env (useful for testing) */
114
+ /**
115
+ * Fully reset the env cache, including the registered schema. Use this
116
+ * in tests that need to swap schemas between cases — `reloadEnv()`
117
+ * deliberately preserves the schema to avoid the "user keys vanish on
118
+ * `.env` reload" footgun.
119
+ */
103
120
  declare function resetEnvCache(): void;
104
121
  type Env = z.infer<typeof baseEnvSchema>;
105
122
  //#endregion
@@ -225,4 +242,4 @@ declare function createConfigService<T extends z.ZodObject<any>>(schema: T): {
225
242
  };
226
243
  //#endregion
227
244
  export { baseEnvSchema as a, loadEnv as c, Env as i, reloadEnv as l, TypedConfigService as n, defineEnv as o, createConfigService as r, getEnv as s, ConfigService as t, resetEnvCache as u };
228
- //# sourceMappingURL=index-Cmq_UBmJ.d.mts.map
245
+ //# sourceMappingURL=index-DNVfGjF9.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-DNVfGjF9.d.mts","names":[],"sources":["../src/config/env.ts","../src/config/config-service.ts"],"mappings":";;;;;;;AA6BA;;cAAa,aAAA,EAAa,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyC1B;;;iBAAgB,SAAA,WAAoB,CAAA,CAAE,WAAA,CAAA,CACpC,MAAA,GAAS,IAAA,SAAa,aAAA,KAAkB,CAAA,CAAE,SAAA,CAAU,CAAA,IACnD,CAAA,CAAE,SAAA,QAAiB,aAAA,CAAc,KAAA,GAAQ,CAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA+B5B,OAAA,WAAkB,CAAA,CAAE,SAAA,MAAA,CAAgB,MAAA,EAAQ,CAAA,GAAI,CAAA,CAAE,KAAA,CAAM,CAAA;AAAA,iBACxD,OAAA,CAAA,IAAY,MAAA,oBAA0B,GAAA,GAAM,OAAA;;;;;;;;;;;;;;;;;;;AAA5D;;;iBAqCgB,MAAA,WAAiB,MAAA,CAAA,CAAQ,GAAA,EAAK,CAAA,GAAI,OAAA,CAAQ,CAAA;AAAA,iBAC1C,MAAA,WAAiB,CAAA,CAAE,SAAA,gCAAyC,CAAA,CAAE,KAAA,CAAM,CAAA,EAAA,CAClF,GAAA,EAAK,CAAA,EACL,MAAA,EAAQ,CAAA,GACP,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAA;;;;;;;;;AAJd;;;;;;;iBAyBgB,SAAA,CAAA;;;;;;;iBA2BA,aAAA,CAAA;AAAA,KAKJ,GAAA,GAAM,CAAA,CAAE,KAAA,QAAa,aAAA;;;;;AAzKjC;;;;;KCjBK,SAAA,sBAA+B,MAAA,oBAA0B,CAAA,GAAI,CAAA,GAAI,MAAA;;;;;;;KAQjE,WAAA,wBAAmC,CAAA,SAAU,MAAA,GAAS,OAAA,CAAQ,CAAA,IAAK,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;cA2B3D,aAAA;EDuBG;;;;;;;;;;;;;EAAA,YCTF,GAAA,CAAA;EDSwB;;;;;;;;;ECIpC,GAAA,2BAAA,CAA+B,GAAA,EAAK,SAAA,CAAU,CAAA,IAAK,WAAA,CAAY,CAAA,EAAG,CAAA;EDFhC;;;;AA+BpC;ECpBE,MAAA,CAAA,IAAW,MAAA,oBAA0B,QAAA,CAAS,MAAA,iBAAuB,QAAA,CAAS,OAAA;EDoBzD;ECfrB,MAAA,CAAA;EAMA,YAAA,CAAA;EAIA,aAAA,CAAA;EAIA,MAAA,CAAA;AAAA;;;;;UASe,kBAAA,cAAgC,MAAA;EAC/C,GAAA,0BAA6B,IAAA,EAAM,GAAA,EAAK,CAAA,GAAI,IAAA,CAAK,CAAA;EACjD,MAAA,IAAU,QAAA,CAAS,IAAA;EACnB,MAAA;EACA,YAAA;EACA,aAAA;EACA,MAAA;AAAA;;;;;;;;;;;;;ADwBF;;;;;;;;;;;;;;;;iBCOgB,mBAAA,WAA8B,CAAA,CAAE,SAAA,MAAA,CAAgB,MAAA,EAAQ,CAAA;EAAA,QAqC5D,kBAAA,CAAkB,CAAA,CAAA,IAAA,CAAA,MAAA,CAAA,CAAA;AAAA"}
package/dist/index.d.mts CHANGED
@@ -1,7 +1,7 @@
1
1
 
2
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
  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";
4
- import { a as baseEnvSchema, c as loadEnv, l as reloadEnv, n as TypedConfigService, o as defineEnv, r as createConfigService, s as getEnv, t as ConfigService, u as resetEnvCache } from "./index-Cmq_UBmJ.mjs";
4
+ import { a as baseEnvSchema, c as loadEnv, l as reloadEnv, n as TypedConfigService, o as defineEnv, r as createConfigService, s as getEnv, t as ConfigService, u as resetEnvCache } from "./index-DNVfGjF9.mjs";
5
5
  import { a as tokenName, c as createToken, i as KickJsRegistry, l as isInjectionToken, n as ContainerChangeEvent, o as INJECTION_TOKEN, r as ContainerChangeListener, s as InjectionToken, t as Container } from "./container-BJb34faa.mjs";
6
6
  import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-A1E1XBhE.mjs";
7
7
  import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-Cotu9TIC.mjs";
package/dist/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -10,21 +10,21 @@
10
10
  */
11
11
  import { METADATA, Scope } from "./core/interfaces.mjs";
12
12
  import { ConsoleLoggerProvider, Logger, createLogger, logger, rootLogger } from "./core/logger.mjs";
13
- import { a as getMethodMeta, c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, i as getMetaRecord, l as pushMethodMeta, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, p as setMethodMeta, r as getMetaMap, s as hasClassMeta, t as getClassMeta, u as setClassMeta } from "./metadata-UdEcgIBJ.mjs";
14
- import { a as isInjectionToken, i as createToken, n as tokenName, r as INJECTION_TOKEN, t as Container } from "./container-CnP8G9tl.mjs";
13
+ import { a as getMethodMeta, c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, i as getMetaRecord, l as pushMethodMeta, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, p as setMethodMeta, r as getMetaMap, s as hasClassMeta, t as getClassMeta, u as setClassMeta } from "./metadata-DaP_5Q0Y.mjs";
14
+ import { a as isInjectionToken, i as createToken, n as tokenName, r as INJECTION_TOKEN, t as Container } from "./container-CMuZkVRS.mjs";
15
15
  import { ApiQueryParams, Autowired, Builder, Component, Controller, Delete, FileUpload, Get, Inject, Injectable, Middleware, Patch, Post, PostConstruct, Put, Repository, Service, Value, normalizeApiQueryParamsConfig } from "./core/decorators.mjs";
16
16
  import { CRON_META, Cron, getCronJobs } from "./core/cron.mjs";
17
17
  import { CacheEvict, Cacheable, MemoryCacheProvider, getCacheProvider, setCacheProvider } from "./core/cache.mjs";
18
18
  import { HttpException, HttpStatus } from "./core/errors.mjs";
19
19
  import { joinPaths, normalizePath } from "./core/path.mjs";
20
- import { n as CircuitOpenError, t as CircuitBreaker } from "./core-CBy6sBw_.mjs";
20
+ import { n as CircuitOpenError, t as CircuitBreaker } from "./core-D-167yQ4.mjs";
21
21
  import { computed, isRef, reactive, ref, toRefs, unref, watch } from "./core/reactivity.mjs";
22
22
  import { REQUEST_ID_HEADER, requestId } from "./http/middleware/request-id.mjs";
23
23
  import { errorHandler, notFoundHandler } from "./http/middleware/error-handler.mjs";
24
- import { i as requestStore, n as requestScopeMiddleware, r as getRequestStore, t as Application } from "./application-CrlnuJQI.mjs";
25
- import { a as reloadEnv, i as loadEnv, n as defineEnv, o as resetEnvCache, r as getEnv, t as baseEnvSchema } from "./env-CtsOktU_.mjs";
26
- import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-Zww8CPRP.mjs";
27
- import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "./query-BhHetB5I.mjs";
24
+ import { i as requestStore, n as requestScopeMiddleware, r as getRequestStore, t as Application } from "./application-CLkVCFWJ.mjs";
25
+ import { a as reloadEnv, i as loadEnv, n as defineEnv, o as resetEnvCache, r as getEnv, t as baseEnvSchema } from "./env-C9zCAyMW.mjs";
26
+ import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-cTXpK1QK.mjs";
27
+ import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "./query-CnxrNfxU.mjs";
28
28
  import { RequestContext } from "./http/context.mjs";
29
29
  import { validate } from "./http/middleware/validate.mjs";
30
30
  import { buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload } from "./http/middleware/upload.mjs";
@@ -37,7 +37,7 @@ import { rateLimit } from "./http/middleware/rate-limit.mjs";
37
37
  import { session } from "./http/middleware/session.mjs";
38
38
  import { ViewAdapter } from "./http/middleware/views.mjs";
39
39
  import { SpaAdapter } from "./http/middleware/spa.mjs";
40
- import { n as createConfigService, t as ConfigService } from "./config-BszyH8VL.mjs";
40
+ import { n as createConfigService, t as ConfigService } from "./config-Cc29Xd0g.mjs";
41
41
  import crypto from "node:crypto";
42
42
  //#region src/http/middleware/trace-context.ts
43
43
  /**
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.2.3
2
+ * @forinda/kickjs v2.2.4
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -73,4 +73,4 @@ function getMetaRecord(key, target) {
73
73
  //#endregion
74
74
  export { getMethodMeta as a, pushClassMeta as c, setInMetaMap as d, setInMetaRecord as f, getMetaRecord as i, pushMethodMeta as l, getClassMetaOrUndefined as n, getMethodMetaOrUndefined as o, setMethodMeta as p, getMetaMap as r, hasClassMeta as s, getClassMeta as t, setClassMeta as u };
75
75
 
76
- //# sourceMappingURL=metadata-UdEcgIBJ.mjs.map
76
+ //# sourceMappingURL=metadata-DaP_5Q0Y.mjs.map