@forinda/kickjs 3.1.2 → 3.2.0

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 (124) hide show
  1. package/dist/{adapter-DjL8ql5d.d.mts → adapter-DLEHb0K6.d.mts} +14 -3
  2. package/dist/adapter-DLEHb0K6.d.mts.map +1 -0
  3. package/dist/{app-module-Cotu9TIC.d.mts → app-module-ERR9jhow.d.mts} +12 -2
  4. package/dist/app-module-ERR9jhow.d.mts.map +1 -0
  5. package/dist/{application-M8SEljFB.mjs → application-x8CXLOlv.mjs} +92 -22
  6. package/dist/application-x8CXLOlv.mjs.map +1 -0
  7. package/dist/{bootstrap-DdAhHgVG.mjs → bootstrap-CYnxozL_.mjs} +6 -6
  8. package/dist/{bootstrap-DdAhHgVG.mjs.map → bootstrap-CYnxozL_.mjs.map} +1 -1
  9. package/dist/{cache-CcTzzNdr.d.mts → cache-V91BNTIM.d.mts} +1 -1
  10. package/dist/{cache-CcTzzNdr.d.mts.map → cache-V91BNTIM.d.mts.map} +1 -1
  11. package/dist/{chunk-BfOl01nR.mjs → chunk-Bt-rz0Tp.mjs} +1 -1
  12. package/dist/config/index.d.mts +1 -1
  13. package/dist/config/index.mjs +3 -3
  14. package/dist/{config-rspGiIN-.mjs → config-aWxKLk4A.mjs} +3 -3
  15. package/dist/{config-rspGiIN-.mjs.map → config-aWxKLk4A.mjs.map} +1 -1
  16. package/dist/{container-BQ-X3dXH.mjs → container-Dnk43k54.mjs} +3 -3
  17. package/dist/{container-BQ-X3dXH.mjs.map → container-Dnk43k54.mjs.map} +1 -1
  18. package/dist/{container-BJb34faa.d.mts → container-fIS1uLx-.d.mts} +2 -2
  19. package/dist/{container-BJb34faa.d.mts.map → container-fIS1uLx-.d.mts.map} +1 -1
  20. package/dist/context-OktlOQBQ.mjs +327 -0
  21. package/dist/context-OktlOQBQ.mjs.map +1 -0
  22. package/dist/context-decorator-GA8-hDLe.d.mts +111 -0
  23. package/dist/context-decorator-GA8-hDLe.d.mts.map +1 -0
  24. package/dist/core/adapter.d.mts +1 -1
  25. package/dist/core/adapter.mjs +1 -1
  26. package/dist/core/app-module.d.mts +1 -1
  27. package/dist/core/app-module.mjs +1 -1
  28. package/dist/core/cache.d.mts +1 -1
  29. package/dist/core/cache.mjs +1 -1
  30. package/dist/core/container.d.mts +1 -1
  31. package/dist/core/container.mjs +2 -2
  32. package/dist/core/cron.d.mts +1 -1
  33. package/dist/core/cron.mjs +2 -2
  34. package/dist/core/decorators.d.mts +1 -1
  35. package/dist/core/decorators.mjs +3 -3
  36. package/dist/core/errors.d.mts +1 -1
  37. package/dist/core/errors.mjs +1 -1
  38. package/dist/core/interfaces.d.mts +1 -1
  39. package/dist/core/interfaces.mjs +3 -1
  40. package/dist/core/interfaces.mjs.map +1 -1
  41. package/dist/core/logger.d.mts +1 -1
  42. package/dist/core/logger.mjs +1 -1
  43. package/dist/core/path.d.mts +1 -1
  44. package/dist/core/path.mjs +1 -1
  45. package/dist/core/plugin.d.mts +1 -1
  46. package/dist/core/plugin.mjs +1 -1
  47. package/dist/core/reactivity.d.mts +1 -1
  48. package/dist/core/reactivity.mjs +1 -1
  49. package/dist/core-DANnH5-e.mjs +435 -0
  50. package/dist/core-DANnH5-e.mjs.map +1 -0
  51. package/dist/{cron-H-IyLcOr.d.mts → cron-CfsPdi7R.d.mts} +1 -1
  52. package/dist/{cron-H-IyLcOr.d.mts.map → cron-CfsPdi7R.d.mts.map} +1 -1
  53. package/dist/{decorators-C9_SN7ge.d.mts → decorators-H42oPg0m.d.mts} +2 -2
  54. package/dist/{decorators-C9_SN7ge.d.mts.map → decorators-H42oPg0m.d.mts.map} +1 -1
  55. package/dist/{env-C_0nE69f.mjs → env-Cs8Wt8A_.mjs} +4 -4
  56. package/dist/{env-C_0nE69f.mjs.map → env-Cs8Wt8A_.mjs.map} +1 -1
  57. package/dist/{errors-BOUCRl-p.d.mts → errors-D_CWI7Bl.d.mts} +1 -1
  58. package/dist/{errors-BOUCRl-p.d.mts.map → errors-D_CWI7Bl.d.mts.map} +1 -1
  59. package/dist/execution-context-Dl2CKqSo.d.mts +57 -0
  60. package/dist/execution-context-Dl2CKqSo.d.mts.map +1 -0
  61. package/dist/http/application.d.mts +60 -6
  62. package/dist/http/application.d.mts.map +1 -1
  63. package/dist/http/application.mjs +2 -2
  64. package/dist/http/bootstrap.mjs +2 -2
  65. package/dist/http/context.d.mts +21 -32
  66. package/dist/http/context.d.mts.map +1 -1
  67. package/dist/http/context.mjs +2 -271
  68. package/dist/http/middleware/cors.mjs +1 -1
  69. package/dist/http/middleware/csrf.mjs +1 -1
  70. package/dist/http/middleware/error-handler.mjs +2 -2
  71. package/dist/http/middleware/helmet.mjs +1 -1
  72. package/dist/http/middleware/rate-limit.mjs +1 -1
  73. package/dist/http/middleware/request-id.mjs +1 -1
  74. package/dist/http/middleware/request-logger.mjs +2 -2
  75. package/dist/http/middleware/session.mjs +1 -1
  76. package/dist/http/middleware/spa.d.mts +1 -1
  77. package/dist/http/middleware/spa.mjs +3 -3
  78. package/dist/http/middleware/upload.d.mts +1 -1
  79. package/dist/http/middleware/upload.mjs +1 -1
  80. package/dist/http/middleware/validate.d.mts.map +1 -1
  81. package/dist/http/middleware/validate.mjs +22 -4
  82. package/dist/http/middleware/validate.mjs.map +1 -1
  83. package/dist/http/middleware/views.d.mts +1 -1
  84. package/dist/http/middleware/views.mjs +2 -2
  85. package/dist/http/query/index.d.mts +1 -1
  86. package/dist/http/query/index.mjs +2 -2
  87. package/dist/http/router-builder.d.mts +14 -2
  88. package/dist/http/router-builder.d.mts.map +1 -1
  89. package/dist/http/router-builder.mjs +59 -7
  90. package/dist/http/router-builder.mjs.map +1 -1
  91. package/dist/index-BQM9pJrV.d.mts +275 -0
  92. package/dist/index-BQM9pJrV.d.mts.map +1 -0
  93. package/dist/{index-DNVfGjF9.d.mts → index-Cf-MGrqT.d.mts} +2 -2
  94. package/dist/{index-DNVfGjF9.d.mts.map → index-Cf-MGrqT.d.mts.map} +1 -1
  95. package/dist/{index-Co7a3Zat.d.mts → index-RNK41JPE.d.mts} +1 -1
  96. package/dist/{index-Co7a3Zat.d.mts.map → index-RNK41JPE.d.mts.map} +1 -1
  97. package/dist/index.d.mts +38 -19
  98. package/dist/index.d.mts.map +1 -1
  99. package/dist/index.mjs +11 -11
  100. package/dist/{interfaces-DXjE8Re1.d.mts → interfaces-CwcdqfNq.d.mts} +3 -1
  101. package/dist/{interfaces-DXjE8Re1.d.mts.map → interfaces-CwcdqfNq.d.mts.map} +1 -1
  102. package/dist/{logger-CW6FHtvU.d.mts → logger-GK8yT0BD.d.mts} +1 -1
  103. package/dist/{logger-CW6FHtvU.d.mts.map → logger-GK8yT0BD.d.mts.map} +1 -1
  104. package/dist/{metadata-Dp3Ozdr5.mjs → metadata-BFuoSEX6.mjs} +2 -2
  105. package/dist/{metadata-Dp3Ozdr5.mjs.map → metadata-BFuoSEX6.mjs.map} +1 -1
  106. package/dist/{path-B4JcbwKX.d.mts → path-Bj3vZMUY.d.mts} +1 -1
  107. package/dist/path-Bj3vZMUY.d.mts.map +1 -0
  108. package/dist/{plugin-Cvacmm7N.d.mts → plugin-3rKA0Loy.d.mts} +36 -4
  109. package/dist/plugin-3rKA0Loy.d.mts.map +1 -0
  110. package/dist/{query-o6_fDG4v.mjs → query-BcYEjYyX.mjs} +2 -2
  111. package/dist/{query-o6_fDG4v.mjs.map → query-BcYEjYyX.mjs.map} +1 -1
  112. package/dist/{reactivity-I8nDlg4c.d.mts → reactivity-CczHu3R-.d.mts} +1 -1
  113. package/dist/{reactivity-I8nDlg4c.d.mts.map → reactivity-CczHu3R-.d.mts.map} +1 -1
  114. package/package.json +1 -1
  115. package/dist/adapter-DjL8ql5d.d.mts.map +0 -1
  116. package/dist/app-module-Cotu9TIC.d.mts.map +0 -1
  117. package/dist/application-M8SEljFB.mjs.map +0 -1
  118. package/dist/core-NDLlQziD.mjs +0 -121
  119. package/dist/core-NDLlQziD.mjs.map +0 -1
  120. package/dist/http/context.mjs.map +0 -1
  121. package/dist/index-CwqjAF6I.d.mts +0 -112
  122. package/dist/index-CwqjAF6I.d.mts.map +0 -1
  123. package/dist/path-B4JcbwKX.d.mts.map +0 -1
  124. package/dist/plugin-Cvacmm7N.d.mts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"index-Co7a3Zat.d.mts","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"mappings":";;;KACY,cAAA;AAAA,cAaC,gBAAA,EAAgB,GAAA;AAAA,UAcZ,UAAA;EACf,KAAA;EACA,QAAA,EAAU,cAAA;EACV,KAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,SAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;AARF;UAgBiB,WAAA;EACf,OAAA,EAAS,UAAA;EACT,IAAA,EAAM,QAAA;EACN,UAAA,EAAY,gBAAA;EACZ,MAAA;AAAA;;;;;;;;AAJF;KAeY,QAAA,iBACM,gBAAA,oEAEd,OAAA,0BAAiC,CAAA,4BACjC,CAAA,kBACE,CAAA,YAEF,OAAA;EAAkB,OAAA;AAAA,IAChB,CAAA,8BACQ,CAAA;;;;;;;;;;;;AATd;;;;;;UA8BiB,gBAAA,iBACC,gBAAA,sBACR,WAAA;EACR,OAAA,EAAS,KAAA,CAAM,UAAA;IAAe,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;EAC9C,IAAA,EAAM,KAAA,CAAM,QAAA;IAAa,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;AAAA;;;;;;;;;;;KAa/B,gBAAA,GAAmB,sBAAA,GAAyB,sBAAA;AAAA,UAEvC,sBAAA;EACf,UAAA;EACA,QAAA;EACA,UAAA;AAAA;;;;;UAOe,sBAAA;EACf,OAAA,EAAS,MAAA;EACT,QAAA,GAAW,MAAA;EACX,aAAA;EAAA,CACC,GAAA;AAAA;;UAIc,iBAAA;EACf,IAAA,EAAM,CAAA;EACN,IAAA;IACE,IAAA;IACA,KAAA;IACA,KAAA;IACA,UAAA;IACA,OAAA;IACA,OAAA;EAAA;AAAA;;;;;;;;AA5BJ;;;;;AAEA;;;;;;;;;AAUA;;UA2CiB,mBAAA;EAzCE;EAAA,SA2CR,IAAA;EA5CA;;;;;EAmDT,KAAA,CAAM,MAAA,EAAQ,WAAA,EAAa,MAAA,EAAQ,OAAA,GAAU,OAAA;AAAA;;;AA/K/C;AAAA,iBCmBgB,YAAA,CACd,WAAA,iCACA,aAAA,cACC,UAAA;;iBA8Ba,SAAA,CACd,SAAA,iCACA,aAAA,cACC,QAAA;;iBA0Ba,eAAA,CAAgB,MAAA;EAC9B,IAAA;EACA,KAAA;AAAA,IACE,gBAAA;;iBAkBY,gBAAA,CAAiB,CAAA;;;;;;;;;;ADrEjC;;;;;AAKA;;;;;;;;;AAWA;;;;;iBC+GgB,UAAA,iBAA2B,gBAAA,yBAAA,CACzC,KAAA,EAAO,MAAA,eACP,WAAA,GAAc,OAAA,GACb,gBAAA,CAAiB,OAAA;;iBAaJ,gBAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,WAAA,IACf,MAAA"}
1
+ {"version":3,"file":"index-RNK41JPE.d.mts","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"mappings":";;;KACY,cAAA;AAAA,cAaC,gBAAA,EAAgB,GAAA;AAAA,UAcZ,UAAA;EACf,KAAA;EACA,QAAA,EAAU,cAAA;EACV,KAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,SAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;AARF;UAgBiB,WAAA;EACf,OAAA,EAAS,UAAA;EACT,IAAA,EAAM,QAAA;EACN,UAAA,EAAY,gBAAA;EACZ,MAAA;AAAA;;;;;;;;AAJF;KAeY,QAAA,iBACM,gBAAA,oEAEd,OAAA,0BAAiC,CAAA,4BACjC,CAAA,kBACE,CAAA,YAEF,OAAA;EAAkB,OAAA;AAAA,IAChB,CAAA,8BACQ,CAAA;;;;;;;;;;;;AATd;;;;;;UA8BiB,gBAAA,iBACC,gBAAA,sBACR,WAAA;EACR,OAAA,EAAS,KAAA,CAAM,UAAA;IAAe,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;EAC9C,IAAA,EAAM,KAAA,CAAM,QAAA;IAAa,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;AAAA;;;;;;;;;;;KAa/B,gBAAA,GAAmB,sBAAA,GAAyB,sBAAA;AAAA,UAEvC,sBAAA;EACf,UAAA;EACA,QAAA;EACA,UAAA;AAAA;;;;;UAOe,sBAAA;EACf,OAAA,EAAS,MAAA;EACT,QAAA,GAAW,MAAA;EACX,aAAA;EAAA,CACC,GAAA;AAAA;;UAIc,iBAAA;EACf,IAAA,EAAM,CAAA;EACN,IAAA;IACE,IAAA;IACA,KAAA;IACA,KAAA;IACA,UAAA;IACA,OAAA;IACA,OAAA;EAAA;AAAA;;;;;;;;AA5BJ;;;;;AAEA;;;;;;;;;AAUA;;UA2CiB,mBAAA;EAzCE;EAAA,SA2CR,IAAA;EA5CA;;;;;EAmDT,KAAA,CAAM,MAAA,EAAQ,WAAA,EAAa,MAAA,EAAQ,OAAA,GAAU,OAAA;AAAA;;;AA/K/C;AAAA,iBCmBgB,YAAA,CACd,WAAA,iCACA,aAAA,cACC,UAAA;;iBA8Ba,SAAA,CACd,SAAA,iCACA,aAAA,cACC,QAAA;;iBA0Ba,eAAA,CAAgB,MAAA;EAC9B,IAAA;EACA,KAAA;AAAA,IACE,gBAAA;;iBAkBY,gBAAA,CAAiB,CAAA;;;;;;;;;;ADrEjC;;;;;AAKA;;;;;;;;;AAWA;;;;;iBC+GgB,UAAA,iBAA2B,gBAAA,yBAAA,CACzC,KAAA,EAAO,MAAA,eACP,WAAA,GAAc,OAAA,GACb,gBAAA,CAAiB,OAAA;;iBAaJ,gBAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,WAAA,IACf,MAAA"}
package/dist/index.d.mts CHANGED
@@ -1,21 +1,23 @@
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-DXjE8Re1.mjs";
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-DNVfGjF9.mjs";
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
- import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-DjL8ql5d.mjs";
7
- import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-Cotu9TIC.mjs";
8
- import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider } from "./cache-CcTzzNdr.mjs";
9
- import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-H-IyLcOr.mjs";
10
- import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-BOUCRl-p.mjs";
11
- import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-CW6FHtvU.mjs";
12
- import { n as normalizePath, t as joinPaths } from "./path-B4JcbwKX.mjs";
13
- import { t as KickPlugin } from "./plugin-Cvacmm7N.mjs";
14
- 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";
15
- import { _ as setInMetaRecord, a as CircuitOpenError, c as getMetaMap, d as getMethodMetaOrUndefined, f as hasClassMeta, g as setInMetaMap, h as setClassMeta, i as CircuitBreakerStats, l as getMetaRecord, m as pushMethodMeta, n as CircuitBreakerOptions, o as getClassMeta, p as pushClassMeta, r as CircuitBreakerState, s as getClassMetaOrUndefined, t as CircuitBreaker, u as getMethodMeta, v as setMethodMeta } from "./index-CwqjAF6I.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-CwcdqfNq.mjs";
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-H42oPg0m.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-Cf-MGrqT.mjs";
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-fIS1uLx-.mjs";
6
+ import { n as ExecutionContext, r as MetaValue, t as ContextMeta } from "./execution-context-Dl2CKqSo.mjs";
7
+ import { a as defineContextDecorator, i as ResolvedDeps, n as ContextDecoratorSpec, r as ContributorRegistration, t as ContextDecorator } from "./context-decorator-GA8-hDLe.mjs";
8
+ import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-DLEHb0K6.mjs";
9
+ import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-ERR9jhow.mjs";
10
+ import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider } from "./cache-V91BNTIM.mjs";
11
+ import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-CfsPdi7R.mjs";
12
+ import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-D_CWI7Bl.mjs";
13
+ import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-GK8yT0BD.mjs";
14
+ import { n as normalizePath, t as joinPaths } from "./path-Bj3vZMUY.mjs";
15
+ import { t as KickPlugin } from "./plugin-3rKA0Loy.mjs";
16
+ 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-CczHu3R-.mjs";
17
+ import { C as pushClassMeta, D as setInMetaRecord, E as setInMetaMap, O as setMethodMeta, S as hasClassMeta, T as setClassMeta, _ as getClassMetaOrUndefined, a as ContributorSource, b as getMethodMeta, c as ContributorCycleError, d as CircuitBreaker, f as CircuitBreakerOptions, g as getClassMeta, h as CircuitOpenError, i as ContributorPipeline, l as DuplicateContributorError, m as CircuitBreakerStats, n as runContributors, o as SourcedRegistration, p as CircuitBreakerState, r as BuildPipelineOptions, s as buildPipeline, t as RunContributorsOptions, u as MissingContributorError, v as getMetaMap, w as pushMethodMeta, x as getMethodMetaOrUndefined, y as getMetaRecord } from "./index-BQM9pJrV.mjs";
16
18
  import { Application, ApplicationOptions, MiddlewareEntry } from "./http/application.mjs";
17
19
  import { bootstrap } from "./http/bootstrap.mjs";
18
- import { _ as SortItem, a as parseSearchQuery, c as FILTER_OPERATORS, d as FilterOperator, f as PaginatedResponse, g as QueryFieldConfig, h as QueryBuilderAdapter, i as parseQuery, l as FieldsOf, m as ParsedQuery, n as parseFilters, o as parseSort, p as PaginationParams, r as parsePagination, t as buildQueryParams, u as FilterItem, y as TypedParsedQuery } from "./index-Co7a3Zat.mjs";
20
+ import { _ as SortItem, a as parseSearchQuery, c as FILTER_OPERATORS, d as FilterOperator, f as PaginatedResponse, g as QueryFieldConfig, h as QueryBuilderAdapter, i as parseQuery, l as FieldsOf, m as ParsedQuery, n as parseFilters, o as parseSort, p as PaginationParams, r as parsePagination, t as buildQueryParams, u as FilterItem, y as TypedParsedQuery } from "./index-RNK41JPE.mjs";
19
21
  import { Ctx, RequestContext, RouteShape } from "./http/context.mjs";
20
22
  import { CorsOptions, cors } from "./http/middleware/cors.mjs";
21
23
  import { CsrfOptions, csrf } from "./http/middleware/csrf.mjs";
@@ -54,10 +56,25 @@ declare function isClusterPrimary(): boolean;
54
56
  interface RequestStore {
55
57
  /** Unique request identifier */
56
58
  requestId: string;
57
- /** Per-request singleton cache for REQUEST-scoped services */
59
+ /**
60
+ * Per-request singleton cache for REQUEST-scoped services. Keys are
61
+ * heterogeneous (class constructors, `InjectionToken` objects, raw
62
+ * strings), so the map type stays `Map<any, any>`.
63
+ */
58
64
  instances: Map<any, any>;
59
- /** Per-request values set by middleware (auth user, tenant, etc.) */
60
- values: Map<any, any>;
65
+ /**
66
+ * Per-request key/value bag. Canonical backing store for
67
+ * `RequestContext.set/get` and the Context Contributor pipeline (#107)
68
+ * since Phase 3. Anything written here is visible to every concrete
69
+ * execution context constructed for the same request, regardless of
70
+ * which middleware/contributor wrote it.
71
+ *
72
+ * Keys are constrained to `string` per the locked decision in
73
+ * `architecture.md` §20.12 (#4); the value type is `unknown` because
74
+ * the concrete shape at each key is determined by the consumer's
75
+ * `ContextMeta` augmentation, not by the store itself.
76
+ */
77
+ values: Map<string, unknown>;
61
78
  }
62
79
  /** AsyncLocalStorage instance shared across the framework */
63
80
  declare const requestStore: AsyncLocalStorage<RequestStore>;
@@ -73,6 +90,8 @@ declare function getRequestStore(): RequestStore;
73
90
  * Enables REQUEST-scoped DI and automatic requestId propagation to logs.
74
91
  *
75
92
  * Should be mounted early in the middleware pipeline (before route handlers).
93
+ * `Application` mounts this automatically unless `contextStore: 'manual'` is set
94
+ * or the user already includes one in their middleware list.
76
95
  */
77
96
  declare function requestScopeMiddleware(): (req: Request, _res: Response, next: NextFunction) => void;
78
97
  //#endregion
@@ -130,5 +149,5 @@ declare function parseTraceparent(header: string): TraceContext | null;
130
149
  */
131
150
  declare function traceContext(options?: TraceContextOptions): (req: Request, res: Response, next: NextFunction) => void;
132
151
  //#endregion
133
- export { AdapterContext, AdapterMiddleware, ApiQueryParams, ApiQueryParamsConfig, ApiQueryParamsConfig as QueryParamsConfig, AppAdapter, AppAdapterClass, AppModule, AppModuleClass, Application, type ApplicationOptions, Autowired, BaseUploadOptions, Buildable, Builder, BuilderOf, CRON_META, CacheEvict, CacheOptions, CacheProvider, Cacheable, CircuitBreaker, CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerStats, CircuitOpenError, ClassKind, type ClusterOptions, ColumnApiQueryParamsConfig, Component, ComputedRef, ConfigService, ConsoleLoggerProvider, Constructor, Container, ContainerChangeEvent, ContainerChangeListener, Controller, type CorsOptions, Cron, CronJobMeta, type CsrfOptions, type Ctx, Delete, Env, EnvKey, FILTER_OPERATORS, type FieldsOf, FileTypeFilter, FileUpload, FileUploadConfig, type FilterItem, type FilterOperator, Get, type HelmetOptions, HttpException, HttpStatus, HttpStatusCode, INJECTION_TOKEN, Inject, Injectable, InjectionToken, KickJsRegistry, KickPlugin, Logger, LoggerProvider, METADATA, MaybePromise, MemoryCacheProvider, Middleware, type MiddlewareEntry, MiddlewareHandler, MiddlewarePhase, ModuleRoutes, type PaginatedResponse, type PaginationParams, type ParsedQuery, Patch, Post, PostConstruct, PostConstructStatus, Put, type QueryBuilderAdapter, type QueryFieldConfig, REQUEST_ID_HEADER, type RateLimitOptions, type RateLimitStore, Ref, Repository, RequestContext, type RequestLoggerOptions, type RequestStore, RouteDefinition, type RouteShape, Scope, Service, ServiceOptions, type Session, type SessionData, type SessionOptions, type SessionStore, type SortItem, SpaAdapter, type SpaAdapterOptions, TRACEPARENT_HEADER, type TraceContext, type TraceContextOptions, type TypedConfigService, type TypedParsedQuery, type UploadOptions, ValidationError, Value, ViewAdapter, type ViewAdapterOptions, WatchOptions, baseEnvSchema, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createConfigService, createLogger, createToken, csrf, defineEnv, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getEnv, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, isRef, joinPaths, loadEnv, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, reloadEnv, requestId, requestLogger, requestScopeMiddleware, requestStore, resetEnvCache, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
152
+ export { AdapterContext, AdapterMiddleware, ApiQueryParams, ApiQueryParamsConfig, ApiQueryParamsConfig as QueryParamsConfig, AppAdapter, AppAdapterClass, AppModule, AppModuleClass, Application, type ApplicationOptions, Autowired, BaseUploadOptions, BuildPipelineOptions, Buildable, Builder, BuilderOf, CRON_META, CacheEvict, CacheOptions, CacheProvider, Cacheable, CircuitBreaker, CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerStats, CircuitOpenError, ClassKind, type ClusterOptions, ColumnApiQueryParamsConfig, Component, ComputedRef, ConfigService, ConsoleLoggerProvider, Constructor, Container, ContainerChangeEvent, ContainerChangeListener, ContextDecorator, ContextDecoratorSpec, ContextMeta, ContributorCycleError, ContributorPipeline, ContributorRegistration, ContributorSource, Controller, type CorsOptions, Cron, CronJobMeta, type CsrfOptions, type Ctx, Delete, DuplicateContributorError, Env, EnvKey, ExecutionContext, FILTER_OPERATORS, type FieldsOf, FileTypeFilter, FileUpload, FileUploadConfig, type FilterItem, type FilterOperator, Get, type HelmetOptions, HttpException, HttpStatus, HttpStatusCode, INJECTION_TOKEN, Inject, Injectable, InjectionToken, KickJsRegistry, KickPlugin, Logger, LoggerProvider, METADATA, MaybePromise, MemoryCacheProvider, MetaValue, Middleware, type MiddlewareEntry, MiddlewareHandler, MiddlewarePhase, MissingContributorError, ModuleRoutes, type PaginatedResponse, type PaginationParams, type ParsedQuery, Patch, Post, PostConstruct, PostConstructStatus, Put, type QueryBuilderAdapter, type QueryFieldConfig, REQUEST_ID_HEADER, type RateLimitOptions, type RateLimitStore, Ref, Repository, RequestContext, type RequestLoggerOptions, type RequestStore, ResolvedDeps, RouteDefinition, type RouteShape, RunContributorsOptions, Scope, Service, ServiceOptions, type Session, type SessionData, type SessionOptions, type SessionStore, type SortItem, SourcedRegistration, SpaAdapter, type SpaAdapterOptions, TRACEPARENT_HEADER, type TraceContext, type TraceContextOptions, type TypedConfigService, type TypedParsedQuery, type UploadOptions, ValidationError, Value, ViewAdapter, type ViewAdapterOptions, WatchOptions, baseEnvSchema, bootstrap, buildPipeline, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createConfigService, createLogger, createToken, csrf, defineContextDecorator, defineEnv, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getEnv, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, isRef, joinPaths, loadEnv, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, reloadEnv, requestId, requestLogger, requestScopeMiddleware, requestStore, resetEnvCache, resolveMimeTypes, rootLogger, runContributors, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
134
153
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/http/cluster.ts","../src/http/request-store.ts","../src/http/middleware/request-scope.ts","../src/http/middleware/trace-context.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAOiB,cAAA;;EAEf,OAAA;;EAEA,uBAAA;;EAEA,YAAA;;EAEA,WAAA;;EAEA,aAAA;AAAA;;iBAIc,gBAAA,CAAA;;;;UClBC,YAAA;;EAEf,SAAA;;EAEA,SAAA,EAAW,GAAA;;EAEX,MAAA,EAAQ,GAAA;AAAA;;cAIG,YAAA,EAAY,iBAAA,CAAA,YAAA;;;;;iBAMT,eAAA,CAAA,GAAmB,YAAA;;;;;;;;;iBCTnB,sBAAA,CAAA,IACN,GAAA,EAAK,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,YAAA;;;;;;;cCHjC,kBAAA;AAAA,UAKI,mBAAA;;;;;EAKf,iBAAA;AAAA;;;;UAMe,YAAA;;EAEf,OAAA;;EAEA,OAAA;;EAEA,YAAA;;EAEA,KAAA;AAAA;;;;;iBAqBc,gBAAA,CAAiB,MAAA,WAAiB,YAAA;;;;;AH9ClD;;;;;;;;;;;AAcA;;;;;;iBG0EgB,YAAA,CAAa,OAAA,GAAS,mBAAA,IAC5B,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/http/cluster.ts","../src/http/request-store.ts","../src/http/middleware/request-scope.ts","../src/http/middleware/trace-context.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAOiB,cAAA;;EAEf,OAAA;;EAEA,uBAAA;;EAEA,YAAA;;EAEA,WAAA;;EAEA,aAAA;AAAA;;iBAIc,gBAAA,CAAA;;;;UClBC,YAAA;;EAEf,SAAA;;;;;;EAMA,SAAA,EAAW,GAAA;;;;;;;;;;;;;EAaX,MAAA,EAAQ,GAAA;AAAA;;cAIG,YAAA,EAAY,iBAAA,CAAA,YAAA;;;;;iBAMT,eAAA,CAAA,GAAmB,YAAA;;;;;;;;;;;iBCRnB,sBAAA,CAAA,IAAsB,GAAA,EACnB,OAAA,EAAO,IAAA,EAAQ,QAAA,EAAQ,IAAA,EAAQ,YAAA;;;;;;;cCnBrC,kBAAA;AAAA,UAKI,mBAAA;;;;;EAKf,iBAAA;AAAA;;;;UAMe,YAAA;;EAEf,OAAA;;EAEA,OAAA;;EAEA,YAAA;;EAEA,KAAA;AAAA;;;;;iBAqBc,gBAAA,CAAiB,MAAA,WAAiB,YAAA;;;;;;;AH9ClD;;;;;;;;;;;AAcA;;;;iBG0EgB,YAAA,CAAa,OAAA,GAAS,mBAAA,IAC5B,GAAA,EAAK,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,IAAA,EAAM,YAAA"}
package/dist/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v3.1.2
2
+ * @forinda/kickjs v3.2.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -10,25 +10,25 @@
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-Dp3Ozdr5.mjs";
14
- import { a as isInjectionToken, i as createToken, n as tokenName, r as INJECTION_TOKEN, t as Container } from "./container-BQ-X3dXH.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-BFuoSEX6.mjs";
14
+ import { a as isInjectionToken, i as createToken, n as tokenName, r as INJECTION_TOKEN, t as Container } from "./container-Dnk43k54.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-NDLlQziD.mjs";
20
+ import { a as MissingContributorError, c as CircuitOpenError, i as DuplicateContributorError, n as buildPipeline, o as defineContextDecorator, r as ContributorCycleError, s as CircuitBreaker, t as runContributors } from "./core-DANnH5-e.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-M8SEljFB.mjs";
25
- import { a as reloadEnv, i as loadEnv, n as defineEnv, o as resetEnvCache, r as getEnv, t as baseEnvSchema } from "./env-C_0nE69f.mjs";
26
- import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-DdAhHgVG.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-o6_fDG4v.mjs";
28
- import { RequestContext } from "./http/context.mjs";
24
+ import { n as getRequestStore, r as requestStore, t as RequestContext } from "./context-OktlOQBQ.mjs";
25
+ import { n as requestScopeMiddleware, t as Application } from "./application-x8CXLOlv.mjs";
26
+ 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-BcYEjYyX.mjs";
29
27
  import { validate } from "./http/middleware/validate.mjs";
30
28
  import { buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload } from "./http/middleware/upload.mjs";
31
29
  import { buildRoutes, getControllerPath } from "./http/router-builder.mjs";
30
+ import { a as reloadEnv, i as loadEnv, n as defineEnv, o as resetEnvCache, r as getEnv, t as baseEnvSchema } from "./env-Cs8Wt8A_.mjs";
31
+ import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-CYnxozL_.mjs";
32
32
  import { csrf } from "./http/middleware/csrf.mjs";
33
33
  import { requestLogger } from "./http/middleware/request-logger.mjs";
34
34
  import { helmet } from "./http/middleware/helmet.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-rspGiIN-.mjs";
40
+ import { n as createConfigService, t as ConfigService } from "./config-aWxKLk4A.mjs";
41
41
  import crypto from "node:crypto";
42
42
  //#region src/http/middleware/trace-context.ts
43
43
  /**
@@ -123,6 +123,6 @@ function traceContext(options = {}) {
123
123
  };
124
124
  }
125
125
  //#endregion
126
- export { ApiQueryParams, Application, Autowired, Builder, CRON_META, CacheEvict, Cacheable, CircuitBreaker, CircuitOpenError, Component, ConfigService, ConsoleLoggerProvider, Container, Controller, Cron, Delete, FILTER_OPERATORS, FileUpload, Get, HttpException, HttpStatus, INJECTION_TOKEN, Inject, Injectable, Logger, METADATA, MemoryCacheProvider, Middleware, Patch, Post, PostConstruct, Put, REQUEST_ID_HEADER, Repository, RequestContext, Scope, Service, SpaAdapter, TRACEPARENT_HEADER, Value, ViewAdapter, baseEnvSchema, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createConfigService, createLogger, createToken, csrf, defineEnv, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getEnv, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, isRef, joinPaths, loadEnv, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, reloadEnv, requestId, requestLogger, requestScopeMiddleware, requestStore, resetEnvCache, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
126
+ export { ApiQueryParams, Application, Autowired, Builder, CRON_META, CacheEvict, Cacheable, CircuitBreaker, CircuitOpenError, Component, ConfigService, ConsoleLoggerProvider, Container, ContributorCycleError, Controller, Cron, Delete, DuplicateContributorError, FILTER_OPERATORS, FileUpload, Get, HttpException, HttpStatus, INJECTION_TOKEN, Inject, Injectable, Logger, METADATA, MemoryCacheProvider, Middleware, MissingContributorError, Patch, Post, PostConstruct, Put, REQUEST_ID_HEADER, Repository, RequestContext, Scope, Service, SpaAdapter, TRACEPARENT_HEADER, Value, ViewAdapter, baseEnvSchema, bootstrap, buildPipeline, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createConfigService, createLogger, createToken, csrf, defineContextDecorator, defineEnv, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getEnv, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, isRef, joinPaths, loadEnv, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, reloadEnv, requestId, requestLogger, requestScopeMiddleware, requestStore, resetEnvCache, resolveMimeTypes, rootLogger, runContributors, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
127
127
 
128
128
  //# sourceMappingURL=index.mjs.map
@@ -41,6 +41,8 @@ declare const METADATA: {
41
41
  readonly ROUTES: symbol;
42
42
  readonly CLASS_MIDDLEWARES: symbol;
43
43
  readonly METHOD_MIDDLEWARES: symbol;
44
+ readonly CLASS_CONTRIBUTORS: symbol;
45
+ readonly METHOD_CONTRIBUTORS: symbol;
44
46
  readonly FILE_UPLOAD: symbol;
45
47
  readonly VALUE: symbol;
46
48
  readonly PARAM_TYPES: "design:paramtypes";
@@ -49,4 +51,4 @@ declare const METADATA: {
49
51
  };
50
52
  //#endregion
51
53
  export { METADATA as a, Scope as c, Constructor as i, ServiceOptions as l, BuilderOf as n, MaybePromise as o, ClassKind as r, PostConstructStatus as s, Buildable as t };
52
- //# sourceMappingURL=interfaces-DXjE8Re1.d.mts.map
54
+ //# sourceMappingURL=interfaces-CwcdqfNq.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces-DXjE8Re1.d.mts","names":[],"sources":["../src/core/interfaces.ts"],"mappings":";;;aAGY,KAAA;EACV,SAAA;EACA,SAAA;;EAEA,OAAA;AAAA;;KAIU,WAAA,oBAA+B,IAAA,YAAgB,CAAA;;KAG/C,YAAA,aAAyB,CAAA,GAAI,OAAA,CAAQ,CAAA;AAHjD;AAAA,UAMiB,cAAA;EACf,KAAA,GAAQ,KAAA;AAAA;;KAIE,SAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,UAAW,QAAA,WAAmB,CAAA,MAAO,KAAA,EAAO,CAAA,CAAE,CAAA,MAAO,SAAA,CAAU,CAAA;EAC9E,KAAA,IAAS,CAAA;AAAA;;UAGE,SAAA;EACf,OAAA,IAAW,SAAA,CAAU,CAAA;AAAA;;KAIX,SAAA;;KAWA,mBAAA;;cAGC,QAAA;EAAA"}
1
+ {"version":3,"file":"interfaces-CwcdqfNq.d.mts","names":[],"sources":["../src/core/interfaces.ts"],"mappings":";;;aAGY,KAAA;EACV,SAAA;EACA,SAAA;;EAEA,OAAA;AAAA;;KAIU,WAAA,oBAA+B,IAAA,YAAgB,CAAA;;KAG/C,YAAA,aAAyB,CAAA,GAAI,OAAA,CAAQ,CAAA;AAHjD;AAAA,UAMiB,cAAA;EACf,KAAA,GAAQ,KAAA;AAAA;;KAIE,SAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,UAAW,QAAA,WAAmB,CAAA,MAAO,KAAA,EAAO,CAAA,CAAE,CAAA,MAAO,SAAA,CAAU,CAAA;EAC9E,KAAA,IAAS,CAAA;AAAA;;UAGE,SAAA;EACf,OAAA,IAAW,SAAA,CAAU,CAAA;AAAA;;KAIX,SAAA;;KAWA,mBAAA;;cAGC,QAAA;EAAA"}
@@ -116,4 +116,4 @@ declare function createLogger(name: string): Logger;
116
116
  declare const logger: pino.Logger<never, boolean>;
117
117
  //#endregion
118
118
  export { logger as a, createLogger as i, Logger as n, rootLogger as o, LoggerProvider as r, ConsoleLoggerProvider as t };
119
- //# sourceMappingURL=logger-CW6FHtvU.d.mts.map
119
+ //# sourceMappingURL=logger-GK8yT0BD.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"logger-CW6FHtvU.d.mts","names":[],"sources":["../src/core/logger.ts"],"mappings":";;;;;cAKa,UAAA,EAAU,IAAA,CAAA,MAAA;AAAvB;;;;;AA0BA;AA1BA,UA0BiB,cAAA;EACf,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,EAAO,GAAA,aAAgB,IAAA;EACvB,KAAA,EAAO,GAAA,aAAgB,IAAA;EAJlB;EAML,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;cA0C7B,qBAAA,YAAiC,cAAA;EAAA,QACpC,MAAA;cAEI,MAAA;EAAA,QAIJ,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cAoC7B,MAAA;EAAA,QACH,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,KAAA;EAvC8C;;AAoCxD;;;EApCwD,OA8C/C,gBAAA,SAAyB,MAAA;EA8BH;EAAA,eA3Bd,gBAAA;cAEH,IAAA;EAyDS;EAAA,YAlDT,QAAA,CAAA;EAkDe;;;;;;;;;;EAAA,OAhCpB,WAAA,CAAY,QAAA,EAAU,cAAA;EAAA;EAAA,OAOtB,WAAA,CAAA,GAAe,cAAA;EAAf;;;;EAAA,OAQA,aAAA,CAAA;EAOmB;EAAA,OAAnB,GAAA,CAAI,IAAA,WAAe,MAAA;EAUpB;EAAN,KAAA,CAAM,IAAA,WAAe,MAAA;EAKb;EAAA,QAAA,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,KAAA,CAAM,QAAA,OAAe,GAAA,cAAiB,IAAA;EAUtC,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;AAAA;;iBAMR,YAAA,CAAa,IAAA,WAAe,MAAA;;cAK/B,MAAA,EAAM,IAAA,CAAA,MAAA"}
1
+ {"version":3,"file":"logger-GK8yT0BD.d.mts","names":[],"sources":["../src/core/logger.ts"],"mappings":";;;;;cAKa,UAAA,EAAU,IAAA,CAAA,MAAA;AAAvB;;;;;AA0BA;AA1BA,UA0BiB,cAAA;EACf,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,EAAO,GAAA,aAAgB,IAAA;EACvB,KAAA,EAAO,GAAA,aAAgB,IAAA;EAJlB;EAML,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;cA0C7B,qBAAA,YAAiC,cAAA;EAAA,QACpC,MAAA;cAEI,MAAA;EAAA,QAIJ,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cAoC7B,MAAA;EAAA,QACH,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,KAAA;EAvC8C;;AAoCxD;;;EApCwD,OA8C/C,gBAAA,SAAyB,MAAA;EA8BH;EAAA,eA3Bd,gBAAA;cAEH,IAAA;EAyDS;EAAA,YAlDT,QAAA,CAAA;EAkDe;;;;;;;;;;EAAA,OAhCpB,WAAA,CAAY,QAAA,EAAU,cAAA;EAAA;EAAA,OAOtB,WAAA,CAAA,GAAe,cAAA;EAAf;;;;EAAA,OAQA,aAAA,CAAA;EAOmB;EAAA,OAAnB,GAAA,CAAI,IAAA,WAAe,MAAA;EAUpB;EAAN,KAAA,CAAM,IAAA,WAAe,MAAA;EAKb;EAAA,QAAA,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,KAAA,CAAM,QAAA,OAAe,GAAA,cAAiB,IAAA;EAUtC,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;AAAA;;iBAMR,YAAA,CAAa,IAAA,WAAe,MAAA;;cAK/B,MAAA,EAAM,IAAA,CAAA,MAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v3.1.2
2
+ * @forinda/kickjs v3.2.0
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-Dp3Ozdr5.mjs.map
76
+ //# sourceMappingURL=metadata-BFuoSEX6.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"metadata-Dp3Ozdr5.mjs","names":[],"sources":["../src/core/metadata.ts"],"sourcesContent":["import 'reflect-metadata'\nimport type { InjectionToken } from './token'\n\n/**\n * Typed utilities for reflect-metadata operations.\n *\n * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single\n * source of truth. If we later move to Stage 3 decorators or a WeakMap-based\n * store, only this file changes — all 24+ consumer files stay untouched.\n *\n * Keys may be symbols, strings, or `InjectionToken<T>` objects produced by\n * `createToken()`. Using `createToken` is the preferred pattern because the\n * token's phantom type flows through the helpers, enabling type-safe reads.\n */\n\ntype MetaKey = symbol | string | InjectionToken<unknown>\n\n// ── Setters ─────────────────────────────────────────────────────\n\n/** Set metadata on a class (or prototype for property decorators) */\nexport function setClassMeta<T>(key: MetaKey, value: T, target: object): void {\n Reflect.defineMetadata(key, value, target)\n}\n\n/** Set metadata on a specific method */\nexport function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void {\n Reflect.defineMetadata(key, value, target, method)\n}\n\n// ── Getters ─────────────────────────────────────────────────────\n\n/** Get metadata from a class, returning `fallback` if not set */\nexport function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T {\n return (Reflect.getMetadata(key, target) as T) ?? fallback\n}\n\n/** Get metadata from a specific method, returning `fallback` if not set */\nexport function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T {\n return (Reflect.getMetadata(key, target, method) as T) ?? fallback\n}\n\n/** Check if metadata exists on a class */\nexport function hasClassMeta(key: MetaKey, target: object): boolean {\n return Reflect.hasMetadata(key, target)\n}\n\n/** Get metadata from a class with no default (returns undefined if absent) */\nexport function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined {\n return Reflect.getMetadata(key, target) as T | undefined\n}\n\n/** Get metadata from a method with no default (returns undefined if absent) */\nexport function getMethodMetaOrUndefined<T>(\n key: MetaKey,\n target: object,\n method: string,\n): T | undefined {\n return Reflect.getMetadata(key, target, method) as T | undefined\n}\n\n// ── Accumulate: Arrays ──────────────────────────────────────────\n\n/** Append items to an array stored in class metadata */\nexport function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target)\n}\n\n/** Append items to an array stored in method metadata */\nexport function pushMethodMeta<T>(\n key: MetaKey,\n target: object,\n method: string,\n ...items: T[]\n): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target, method) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target, method)\n}\n\n// ── Accumulate: Maps ────────────────────────────────────────────\n\n/** Set a key/value in a Map stored in class metadata */\nexport function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void {\n const inherited: Map<K, V> | undefined = Reflect.getOwnMetadata(key, target)\n const map = inherited ? new Map(inherited) : new Map<K, V>()\n map.set(mapKey, mapValue)\n Reflect.defineMetadata(key, map, target)\n}\n\n/** Get a Map from class metadata (returns empty Map if absent) */\nexport function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V> {\n return Reflect.getMetadata(key, target) ?? new Map()\n}\n\n// ── Accumulate: Records ─────────────────────────────────────────\n\n/** Set a key/value in a Record stored in class metadata */\nexport function setInMetaRecord<V>(\n key: MetaKey,\n target: object,\n recKey: string | number,\n recValue: V,\n): void {\n const inherited: Record<string | number, V> | undefined = Reflect.getOwnMetadata(key, target)\n const rec = inherited ? { ...inherited } : {}\n rec[recKey] = recValue\n Reflect.defineMetadata(key, rec, target)\n}\n\n/** Get a Record from class metadata (returns empty object if absent) */\nexport function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V> {\n return Reflect.getMetadata(key, target) ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,aAAgB,KAAc,OAAU,QAAsB;AAC5E,SAAQ,eAAe,KAAK,OAAO,OAAO;;;AAI5C,SAAgB,cAAiB,KAAc,OAAU,QAAgB,QAAsB;AAC7F,SAAQ,eAAe,KAAK,OAAO,QAAQ,OAAO;;;AAMpD,SAAgB,aAAgB,KAAc,QAAgB,UAAgB;AAC5E,QAAQ,QAAQ,YAAY,KAAK,OAAO,IAAU;;;AAIpD,SAAgB,cAAiB,KAAc,QAAgB,QAAgB,UAAgB;AAC7F,QAAQ,QAAQ,YAAY,KAAK,QAAQ,OAAO,IAAU;;;AAI5D,SAAgB,aAAa,KAAc,QAAyB;AAClE,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,wBAA2B,KAAc,QAA+B;AACtF,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,yBACd,KACA,QACA,QACe;AACf,QAAO,QAAQ,YAAY,KAAK,QAAQ,OAAO;;;AAMjD,SAAgB,cAAiB,KAAc,QAAgB,GAAG,OAAkB;CAClF,MAAM,WAAgB,QAAQ,eAAe,KAAK,OAAO,IAAI,EAAE;AAC/D,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO;;;AAI9D,SAAgB,eACd,KACA,QACA,QACA,GAAG,OACG;CACN,MAAM,WAAgB,QAAQ,eAAe,KAAK,QAAQ,OAAO,IAAI,EAAE;AACvE,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,QAAQ,OAAO;;;AAMtE,SAAgB,aAAmB,KAAc,QAAgB,QAAW,UAAmB;CAC7F,MAAM,YAAmC,QAAQ,eAAe,KAAK,OAAO;CAC5E,MAAM,MAAM,YAAY,IAAI,IAAI,UAAU,mBAAG,IAAI,KAAW;AAC5D,KAAI,IAAI,QAAQ,SAAS;AACzB,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,WAAiB,KAAc,QAA2B;AACxE,QAAO,QAAQ,YAAY,KAAK,OAAO,oBAAI,IAAI,KAAK;;;AAMtD,SAAgB,gBACd,KACA,QACA,QACA,UACM;CACN,MAAM,YAAoD,QAAQ,eAAe,KAAK,OAAO;CAC7F,MAAM,MAAM,YAAY,EAAE,GAAG,WAAW,GAAG,EAAE;AAC7C,KAAI,UAAU;AACd,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,cAAiB,KAAc,QAA4C;AACzF,QAAO,QAAQ,YAAY,KAAK,OAAO,IAAI,EAAE"}
1
+ {"version":3,"file":"metadata-BFuoSEX6.mjs","names":[],"sources":["../src/core/metadata.ts"],"sourcesContent":["import 'reflect-metadata'\nimport type { InjectionToken } from './token'\n\n/**\n * Typed utilities for reflect-metadata operations.\n *\n * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single\n * source of truth. If we later move to Stage 3 decorators or a WeakMap-based\n * store, only this file changes — all 24+ consumer files stay untouched.\n *\n * Keys may be symbols, strings, or `InjectionToken<T>` objects produced by\n * `createToken()`. Using `createToken` is the preferred pattern because the\n * token's phantom type flows through the helpers, enabling type-safe reads.\n */\n\ntype MetaKey = symbol | string | InjectionToken<unknown>\n\n// ── Setters ─────────────────────────────────────────────────────\n\n/** Set metadata on a class (or prototype for property decorators) */\nexport function setClassMeta<T>(key: MetaKey, value: T, target: object): void {\n Reflect.defineMetadata(key, value, target)\n}\n\n/** Set metadata on a specific method */\nexport function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void {\n Reflect.defineMetadata(key, value, target, method)\n}\n\n// ── Getters ─────────────────────────────────────────────────────\n\n/** Get metadata from a class, returning `fallback` if not set */\nexport function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T {\n return (Reflect.getMetadata(key, target) as T) ?? fallback\n}\n\n/** Get metadata from a specific method, returning `fallback` if not set */\nexport function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T {\n return (Reflect.getMetadata(key, target, method) as T) ?? fallback\n}\n\n/** Check if metadata exists on a class */\nexport function hasClassMeta(key: MetaKey, target: object): boolean {\n return Reflect.hasMetadata(key, target)\n}\n\n/** Get metadata from a class with no default (returns undefined if absent) */\nexport function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined {\n return Reflect.getMetadata(key, target) as T | undefined\n}\n\n/** Get metadata from a method with no default (returns undefined if absent) */\nexport function getMethodMetaOrUndefined<T>(\n key: MetaKey,\n target: object,\n method: string,\n): T | undefined {\n return Reflect.getMetadata(key, target, method) as T | undefined\n}\n\n// ── Accumulate: Arrays ──────────────────────────────────────────\n\n/** Append items to an array stored in class metadata */\nexport function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target)\n}\n\n/** Append items to an array stored in method metadata */\nexport function pushMethodMeta<T>(\n key: MetaKey,\n target: object,\n method: string,\n ...items: T[]\n): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target, method) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target, method)\n}\n\n// ── Accumulate: Maps ────────────────────────────────────────────\n\n/** Set a key/value in a Map stored in class metadata */\nexport function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void {\n const inherited: Map<K, V> | undefined = Reflect.getOwnMetadata(key, target)\n const map = inherited ? new Map(inherited) : new Map<K, V>()\n map.set(mapKey, mapValue)\n Reflect.defineMetadata(key, map, target)\n}\n\n/** Get a Map from class metadata (returns empty Map if absent) */\nexport function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V> {\n return Reflect.getMetadata(key, target) ?? new Map()\n}\n\n// ── Accumulate: Records ─────────────────────────────────────────\n\n/** Set a key/value in a Record stored in class metadata */\nexport function setInMetaRecord<V>(\n key: MetaKey,\n target: object,\n recKey: string | number,\n recValue: V,\n): void {\n const inherited: Record<string | number, V> | undefined = Reflect.getOwnMetadata(key, target)\n const rec = inherited ? { ...inherited } : {}\n rec[recKey] = recValue\n Reflect.defineMetadata(key, rec, target)\n}\n\n/** Get a Record from class metadata (returns empty object if absent) */\nexport function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V> {\n return Reflect.getMetadata(key, target) ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,aAAgB,KAAc,OAAU,QAAsB;AAC5E,SAAQ,eAAe,KAAK,OAAO,OAAO;;;AAI5C,SAAgB,cAAiB,KAAc,OAAU,QAAgB,QAAsB;AAC7F,SAAQ,eAAe,KAAK,OAAO,QAAQ,OAAO;;;AAMpD,SAAgB,aAAgB,KAAc,QAAgB,UAAgB;AAC5E,QAAQ,QAAQ,YAAY,KAAK,OAAO,IAAU;;;AAIpD,SAAgB,cAAiB,KAAc,QAAgB,QAAgB,UAAgB;AAC7F,QAAQ,QAAQ,YAAY,KAAK,QAAQ,OAAO,IAAU;;;AAI5D,SAAgB,aAAa,KAAc,QAAyB;AAClE,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,wBAA2B,KAAc,QAA+B;AACtF,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,yBACd,KACA,QACA,QACe;AACf,QAAO,QAAQ,YAAY,KAAK,QAAQ,OAAO;;;AAMjD,SAAgB,cAAiB,KAAc,QAAgB,GAAG,OAAkB;CAClF,MAAM,WAAgB,QAAQ,eAAe,KAAK,OAAO,IAAI,EAAE;AAC/D,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO;;;AAI9D,SAAgB,eACd,KACA,QACA,QACA,GAAG,OACG;CACN,MAAM,WAAgB,QAAQ,eAAe,KAAK,QAAQ,OAAO,IAAI,EAAE;AACvE,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,QAAQ,OAAO;;;AAMtE,SAAgB,aAAmB,KAAc,QAAgB,QAAW,UAAmB;CAC7F,MAAM,YAAmC,QAAQ,eAAe,KAAK,OAAO;CAC5E,MAAM,MAAM,YAAY,IAAI,IAAI,UAAU,mBAAG,IAAI,KAAW;AAC5D,KAAI,IAAI,QAAQ,SAAS;AACzB,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,WAAiB,KAAc,QAA2B;AACxE,QAAO,QAAQ,YAAY,KAAK,OAAO,oBAAI,IAAI,KAAK;;;AAMtD,SAAgB,gBACd,KACA,QACA,QACA,UACM;CACN,MAAM,YAAoD,QAAQ,eAAe,KAAK,OAAO;CAC7F,MAAM,MAAM,YAAY,EAAE,GAAG,WAAW,GAAG,EAAE;AAC7C,KAAI,UAAU;AACd,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,cAAiB,KAAc,QAA4C;AACzF,QAAO,QAAQ,YAAY,KAAK,OAAO,IAAI,EAAE"}
@@ -22,4 +22,4 @@ declare function normalizePath(path?: string): string;
22
22
  declare function joinPaths(...segments: (string | undefined)[]): string;
23
23
  //#endregion
24
24
  export { normalizePath as n, joinPaths as t };
25
- //# sourceMappingURL=path-B4JcbwKX.d.mts.map
25
+ //# sourceMappingURL=path-Bj3vZMUY.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"path-Bj3vZMUY.d.mts","names":[],"sources":["../src/core/path.ts"],"mappings":";;;AAOA;;;;;AAsBA;iBAtBgB,aAAA,CAAc,IAAA;;;;;;;;;;;;iBAsBd,SAAA,CAAA,GAAa,QAAA"}
@@ -1,7 +1,8 @@
1
1
 
2
- import { t as Container } from "./container-BJb34faa.mjs";
3
- import { r as AppAdapter } from "./adapter-DjL8ql5d.mjs";
4
- import { n as AppModuleClass } from "./app-module-Cotu9TIC.mjs";
2
+ import { t as Container } from "./container-fIS1uLx-.mjs";
3
+ import { r as ContributorRegistration } from "./context-decorator-GA8-hDLe.mjs";
4
+ import { r as AppAdapter } from "./adapter-DLEHb0K6.mjs";
5
+ import { n as AppModuleClass } from "./app-module-ERR9jhow.mjs";
5
6
 
6
7
  //#region src/core/plugin.d.ts
7
8
  /**
@@ -79,6 +80,37 @@ interface KickPlugin {
79
80
  * Plugin middleware runs before user-defined middleware.
80
81
  */
81
82
  middleware?(): any[];
83
+ /**
84
+ * Return Context Contributors (#107) the plugin ships. Contributors
85
+ * returned here merge into the per-route pipeline at the **`'adapter'`
86
+ * precedence level** — same as those returned by adapters the plugin
87
+ * ships via {@link KickPlugin.adapters}, and for the same reason: a
88
+ * plugin is a cross-cutting bundle, narrower than the global default
89
+ * but broader than a per-module hook.
90
+ *
91
+ * Use when a plugin wants to ship a typed contributor without standing
92
+ * up an accompanying adapter. For full coverage of the precedence
93
+ * matrix (method > class > module > adapter > global) see
94
+ * `docs/guide/context-decorators.md`.
95
+ *
96
+ * @example
97
+ * ```ts
98
+ * import { defineContextDecorator, type KickPlugin } from '@forinda/kickjs'
99
+ *
100
+ * const LoadFlags = defineContextDecorator({
101
+ * key: 'flags',
102
+ * resolve: (ctx) => fetchFlags(ctx.requestId!),
103
+ * })
104
+ *
105
+ * export class FlagsPlugin implements KickPlugin {
106
+ * name = 'FlagsPlugin'
107
+ * contributors() {
108
+ * return [LoadFlags.registration]
109
+ * }
110
+ * }
111
+ * ```
112
+ */
113
+ contributors?(): ContributorRegistration[] | readonly ContributorRegistration[];
82
114
  /**
83
115
  * Called after the application has fully bootstrapped.
84
116
  * Use for post-startup logic like logging, health registration, etc.
@@ -92,4 +124,4 @@ interface KickPlugin {
92
124
  }
93
125
  //#endregion
94
126
  export { KickPlugin as t };
95
- //# sourceMappingURL=plugin-Cvacmm7N.d.mts.map
127
+ //# sourceMappingURL=plugin-3rKA0Loy.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-3rKA0Loy.d.mts","names":[],"sources":["../src/core/plugin.ts"],"mappings":";;;;;;;;;AAyDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAiB,UAAA;;EAEf,IAAA;;;;;EAMA,QAAA,EAAU,SAAA,EAAW,SAAA;;;;;EAMrB,OAAA,KAAY,cAAA;;;;;EAMZ,QAAA,KAAa,UAAA;;;;;EAMb,UAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCA,YAAA,KAAiB,uBAAA,cAAqC,uBAAA;;;;;EAMtD,OAAA,EAAS,SAAA,EAAW,SAAA,UAAmB,OAAA;;;;;EAMvC,QAAA,YAAoB,OAAA;AAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v3.1.2
2
+ * @forinda/kickjs v3.2.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -161,4 +161,4 @@ function buildQueryParams(parsed) {
161
161
  //#endregion
162
162
  export { parseSearchQuery as a, parseQuery as i, parseFilters as n, parseSort as o, parsePagination as r, FILTER_OPERATORS as s, buildQueryParams as t };
163
163
 
164
- //# sourceMappingURL=query-o6_fDG4v.mjs.map
164
+ //# sourceMappingURL=query-BcYEjYyX.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"query-o6_fDG4v.mjs","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"sourcesContent":["/** Supported filter operators for query string parsing */\nexport type FilterOperator =\n | 'eq'\n | 'neq'\n | 'gt'\n | 'gte'\n | 'lt'\n | 'lte'\n | 'between'\n | 'in'\n | 'contains'\n | 'starts'\n | 'ends'\n\nexport const FILTER_OPERATORS = new Set<string>([\n 'eq',\n 'neq',\n 'gt',\n 'gte',\n 'lt',\n 'lte',\n 'between',\n 'in',\n 'contains',\n 'starts',\n 'ends',\n])\n\nexport interface FilterItem {\n field: string\n operator: FilterOperator\n value: string\n}\n\nexport interface SortItem {\n field: string\n direction: 'asc' | 'desc'\n}\n\nexport interface PaginationParams {\n page: number\n limit: number\n offset: number\n}\n\n/**\n * The result of parsing a query string. ORM-agnostic — pass this to\n * a query builder adapter (Drizzle, Prisma, Sequelize, etc.) to produce\n * database-specific query objects.\n */\nexport interface ParsedQuery {\n filters: FilterItem[]\n sort: SortItem[]\n pagination: PaginationParams\n search: string\n}\n\n/**\n * Helper that extracts the literal field union from a `QueryFieldConfig`\n * key. When the user passes `{ filterable: ['status', 'category'] } as const`,\n * `FieldsOf<typeof config, 'filterable'>` resolves to `'status' | 'category'`.\n *\n * Without `as const`, the arrays widen to `string[]` and the union falls\n * back to `string`. This is the documented escape hatch.\n */\nexport type FieldsOf<\n TConfig extends QueryFieldConfig | undefined,\n K extends 'filterable' | 'sortable' | 'searchable',\n> = TConfig extends { readonly [P in K]: readonly (infer F)[] }\n ? F extends string\n ? F\n : string\n : TConfig extends { columns: infer C }\n ? K extends 'filterable'\n ? keyof C & string\n : string\n : string\n\n/**\n * Narrowed `ParsedQuery` whose `filters[].field` and `sort[].field`\n * unions are constrained to the literal whitelist passed to\n * `ctx.qs()` / `parseQuery()`. Extends `ParsedQuery`, so any function\n * accepting `ParsedQuery` accepts a `TypedParsedQuery<X>` automatically\n * (subtype assignment, no codegen, backward compatible).\n *\n * @example\n * ```ts\n * const parsed = ctx.qs({\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt'],\n * } as const)\n * parsed.filters[0]?.field // 'status' | 'priority'\n * parsed.sort[0]?.field // 'createdAt'\n * ```\n */\nexport interface TypedParsedQuery<\n TConfig extends QueryFieldConfig | undefined,\n> extends ParsedQuery {\n filters: Array<FilterItem & { field: FieldsOf<TConfig, 'filterable'> }>\n sort: Array<SortItem & { field: FieldsOf<TConfig, 'sortable'> }>\n}\n\n/**\n * Restrict which fields can be filtered, sorted, or searched.\n * Fields not in the allow-list are silently ignored.\n *\n * Accepts two forms:\n * 1. **String arrays** (standard): `{ filterable: ['name', 'status'], sortable: ['createdAt'] }`\n * 2. **Column-object maps** (Drizzle-style): `{ columns: { name: col, status: col }, sortable: { createdAt: col } }`\n *\n * When column-object maps are provided, `Object.keys()` is used to derive the field names.\n */\nexport type QueryFieldConfig = StringQueryFieldConfig | ColumnQueryFieldConfig\n\nexport interface StringQueryFieldConfig {\n filterable?: string[]\n sortable?: string[]\n searchable?: string[]\n}\n\n/**\n * Column-object-based field config (e.g., from DrizzleQueryParamsConfig).\n * Keys are the field names used in query strings; values are ORM column references.\n */\nexport interface ColumnQueryFieldConfig {\n columns: Record<string, any>\n sortable?: Record<string, any>\n searchColumns?: any[]\n [key: string]: any\n}\n\n/** Standardized paginated response shape */\nexport interface PaginatedResponse<T = any> {\n data: T[]\n meta: {\n page: number\n limit: number\n total: number\n totalPages: number\n hasNext: boolean\n hasPrev: boolean\n }\n}\n\n/**\n * Interface for ORM-specific query builder adapters.\n * Implement this to translate a `ParsedQuery` into your ORM's query format.\n *\n * @example\n * ```ts\n * // Drizzle adapter\n * class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryResult> {\n * build(parsed: ParsedQuery, config: DrizzleConfig): DrizzleQueryResult {\n * // Convert filters → Drizzle SQL conditions\n * // Convert sort → Drizzle orderBy\n * return { where, orderBy, limit, offset }\n * }\n * }\n *\n * // Prisma adapter\n * class PrismaQueryAdapter implements QueryBuilderAdapter<PrismaQueryResult> {\n * build(parsed: ParsedQuery, config: PrismaConfig): PrismaQueryResult {\n * return { where, orderBy, skip, take }\n * }\n * }\n * ```\n */\nexport interface QueryBuilderAdapter<TResult = any, TConfig = any> {\n /** Human-readable name for debugging */\n readonly name: string\n\n /**\n * Convert a ParsedQuery into an ORM-specific query object.\n * @param parsed - The ORM-agnostic parsed query\n * @param config - ORM-specific configuration (column maps, search columns, etc.)\n */\n build(parsed: ParsedQuery, config: TConfig): TResult\n}\n","import {\n FILTER_OPERATORS,\n type FilterItem,\n type FilterOperator,\n type SortItem,\n type PaginationParams,\n type ParsedQuery,\n type QueryFieldConfig,\n type StringQueryFieldConfig,\n type TypedParsedQuery,\n} from './types'\n\nconst MAX_SEARCH_LENGTH = 200\nconst DEFAULT_PAGE = 1\nconst DEFAULT_LIMIT = 20\nconst MAX_LIMIT = 100\n\n// ── Individual parsers ──────────────────────────────────────────────────\n\n/** Parse filter strings like \"status:eq:active\" into structured objects */\nexport function parseFilters(\n filterParam: string | string[] | undefined,\n allowedFields?: string[],\n): FilterItem[] {\n if (!filterParam) return []\n\n const items = Array.isArray(filterParam) ? filterParam : [filterParam]\n const results: FilterItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n\n for (const item of items) {\n // Split on first two colons only — value may contain colons (e.g. timestamps)\n const firstColon = item.indexOf(':')\n if (firstColon === -1) continue\n\n const secondColon = item.indexOf(':', firstColon + 1)\n if (secondColon === -1) continue\n\n const field = item.slice(0, firstColon)\n const operator = item.slice(firstColon + 1, secondColon)\n const value = item.slice(secondColon + 1)\n\n if (!field || !value) continue\n if (!FILTER_OPERATORS.has(operator)) continue\n if (allowed && !allowed.has(field)) continue\n\n results.push({ field, operator: operator as FilterOperator, value })\n }\n\n return results\n}\n\n/** Parse sort strings like \"firstName:asc\" into structured objects */\nexport function parseSort(\n sortParam: string | string[] | undefined,\n allowedFields?: string[],\n): SortItem[] {\n if (!sortParam) return []\n\n const items = Array.isArray(sortParam) ? sortParam : [sortParam]\n const results: SortItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n\n for (const item of items) {\n // Split on last colon so field names with colons work\n const lastColon = item.lastIndexOf(':')\n if (lastColon === -1) continue\n\n const field = item.slice(0, lastColon)\n const dir = item.slice(lastColon + 1).toLowerCase()\n\n if (!field) continue\n if (dir !== 'asc' && dir !== 'desc') continue\n if (allowed && !allowed.has(field)) continue\n\n results.push({ field, direction: dir })\n }\n\n return results\n}\n\n/** Parse page/limit into pagination with computed offset */\nexport function parsePagination(params: {\n page?: string | number\n limit?: string | number\n}): PaginationParams {\n let page =\n typeof params.page === 'string'\n ? Number.parseInt(params.page, 10)\n : (params.page ?? DEFAULT_PAGE)\n let limit =\n typeof params.limit === 'string'\n ? Number.parseInt(params.limit, 10)\n : (params.limit ?? DEFAULT_LIMIT)\n\n if (Number.isNaN(page) || page < 1) page = DEFAULT_PAGE\n if (Number.isNaN(limit) || limit < 1) limit = DEFAULT_LIMIT\n if (limit > MAX_LIMIT) limit = MAX_LIMIT\n\n return { page, limit, offset: (page - 1) * limit }\n}\n\n/** Sanitize and truncate search query */\nexport function parseSearchQuery(q: string | undefined): string {\n if (!q) return ''\n return q.trim().slice(0, MAX_SEARCH_LENGTH)\n}\n\n// ── Config normalizer ───────────────────────────────────────────────────\n\n/**\n * Normalize a QueryFieldConfig into the string-based form.\n * Detects column-object-based configs (DrizzleQueryParamsConfig) by checking\n * for a `columns` property and extracts `Object.keys()`.\n */\nfunction normalizeFieldConfig(config?: QueryFieldConfig): StringQueryFieldConfig | undefined {\n if (!config) return undefined\n\n // Column-object-based config (e.g., DrizzleQueryParamsConfig)\n if ('columns' in config && config.columns && typeof config.columns === 'object') {\n return {\n filterable: Object.keys(config.columns),\n sortable: config.sortable ? Object.keys(config.sortable) : undefined,\n searchable: undefined, // searchColumns are Column objects, not used for string filtering\n }\n }\n\n // Already string-based\n return config as StringQueryFieldConfig\n}\n\n// ── Combined parser ─────────────────────────────────────────────────────\n\n/**\n * Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.\n *\n * @param query - Raw query string object from `req.query` or Zod-validated object\n * @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).\n * Accepts both string-based configs (`{ filterable, sortable, searchable }`) and\n * column-object configs (`{ columns, sortable, searchColumns }`).\n *\n * @example\n * ```ts\n * // String-based config\n * const parsed = parseQuery(ctx.query, {\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt', 'title'],\n * })\n *\n * // Column-object config (DrizzleQueryParamsConfig)\n * const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)\n * ```\n *\n * Query string format:\n * - Filters: `?filter=field:operator:value` (repeatable)\n * - Sort: `?sort=field:asc|desc` (repeatable)\n * - Pagination: `?page=1&limit=20`\n * - Search: `?q=search+term`\n *\n * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends\n */\nexport function parseQuery<TConfig extends QueryFieldConfig | undefined = undefined>(\n query: Record<string, any>,\n fieldConfig?: TConfig,\n): TypedParsedQuery<TConfig> {\n const normalized = normalizeFieldConfig(fieldConfig)\n return {\n filters: parseFilters(query.filter, normalized?.filterable),\n sort: parseSort(query.sort, normalized?.sortable),\n pagination: parsePagination({ page: query.page, limit: query.limit }),\n search: parseSearchQuery(query.q),\n } as TypedParsedQuery<TConfig>\n}\n\n// ── Query URL builder (for client-side or testing) ──────────────────────\n\n/** Convert ParsedQuery back into query string parameters */\nexport function buildQueryParams(\n parsed: Partial<ParsedQuery>,\n): Record<string, string | string[] | number> {\n const params: Record<string, string | string[] | number> = {}\n\n if (parsed.filters?.length) {\n params.filter = parsed.filters.map((f) => `${f.field}:${f.operator}:${f.value}`)\n }\n\n if (parsed.sort?.length) {\n params.sort = parsed.sort.map((s) => `${s.field}:${s.direction}`)\n }\n\n if (parsed.pagination) {\n params.page = parsed.pagination.page\n params.limit = parsed.pagination.limit\n }\n\n if (parsed.search) {\n params.q = parsed.search\n }\n\n return params\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"query-BcYEjYyX.mjs","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"sourcesContent":["/** Supported filter operators for query string parsing */\nexport type FilterOperator =\n | 'eq'\n | 'neq'\n | 'gt'\n | 'gte'\n | 'lt'\n | 'lte'\n | 'between'\n | 'in'\n | 'contains'\n | 'starts'\n | 'ends'\n\nexport const FILTER_OPERATORS = new Set<string>([\n 'eq',\n 'neq',\n 'gt',\n 'gte',\n 'lt',\n 'lte',\n 'between',\n 'in',\n 'contains',\n 'starts',\n 'ends',\n])\n\nexport interface FilterItem {\n field: string\n operator: FilterOperator\n value: string\n}\n\nexport interface SortItem {\n field: string\n direction: 'asc' | 'desc'\n}\n\nexport interface PaginationParams {\n page: number\n limit: number\n offset: number\n}\n\n/**\n * The result of parsing a query string. ORM-agnostic — pass this to\n * a query builder adapter (Drizzle, Prisma, Sequelize, etc.) to produce\n * database-specific query objects.\n */\nexport interface ParsedQuery {\n filters: FilterItem[]\n sort: SortItem[]\n pagination: PaginationParams\n search: string\n}\n\n/**\n * Helper that extracts the literal field union from a `QueryFieldConfig`\n * key. When the user passes `{ filterable: ['status', 'category'] } as const`,\n * `FieldsOf<typeof config, 'filterable'>` resolves to `'status' | 'category'`.\n *\n * Without `as const`, the arrays widen to `string[]` and the union falls\n * back to `string`. This is the documented escape hatch.\n */\nexport type FieldsOf<\n TConfig extends QueryFieldConfig | undefined,\n K extends 'filterable' | 'sortable' | 'searchable',\n> = TConfig extends { readonly [P in K]: readonly (infer F)[] }\n ? F extends string\n ? F\n : string\n : TConfig extends { columns: infer C }\n ? K extends 'filterable'\n ? keyof C & string\n : string\n : string\n\n/**\n * Narrowed `ParsedQuery` whose `filters[].field` and `sort[].field`\n * unions are constrained to the literal whitelist passed to\n * `ctx.qs()` / `parseQuery()`. Extends `ParsedQuery`, so any function\n * accepting `ParsedQuery` accepts a `TypedParsedQuery<X>` automatically\n * (subtype assignment, no codegen, backward compatible).\n *\n * @example\n * ```ts\n * const parsed = ctx.qs({\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt'],\n * } as const)\n * parsed.filters[0]?.field // 'status' | 'priority'\n * parsed.sort[0]?.field // 'createdAt'\n * ```\n */\nexport interface TypedParsedQuery<\n TConfig extends QueryFieldConfig | undefined,\n> extends ParsedQuery {\n filters: Array<FilterItem & { field: FieldsOf<TConfig, 'filterable'> }>\n sort: Array<SortItem & { field: FieldsOf<TConfig, 'sortable'> }>\n}\n\n/**\n * Restrict which fields can be filtered, sorted, or searched.\n * Fields not in the allow-list are silently ignored.\n *\n * Accepts two forms:\n * 1. **String arrays** (standard): `{ filterable: ['name', 'status'], sortable: ['createdAt'] }`\n * 2. **Column-object maps** (Drizzle-style): `{ columns: { name: col, status: col }, sortable: { createdAt: col } }`\n *\n * When column-object maps are provided, `Object.keys()` is used to derive the field names.\n */\nexport type QueryFieldConfig = StringQueryFieldConfig | ColumnQueryFieldConfig\n\nexport interface StringQueryFieldConfig {\n filterable?: string[]\n sortable?: string[]\n searchable?: string[]\n}\n\n/**\n * Column-object-based field config (e.g., from DrizzleQueryParamsConfig).\n * Keys are the field names used in query strings; values are ORM column references.\n */\nexport interface ColumnQueryFieldConfig {\n columns: Record<string, any>\n sortable?: Record<string, any>\n searchColumns?: any[]\n [key: string]: any\n}\n\n/** Standardized paginated response shape */\nexport interface PaginatedResponse<T = any> {\n data: T[]\n meta: {\n page: number\n limit: number\n total: number\n totalPages: number\n hasNext: boolean\n hasPrev: boolean\n }\n}\n\n/**\n * Interface for ORM-specific query builder adapters.\n * Implement this to translate a `ParsedQuery` into your ORM's query format.\n *\n * @example\n * ```ts\n * // Drizzle adapter\n * class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryResult> {\n * build(parsed: ParsedQuery, config: DrizzleConfig): DrizzleQueryResult {\n * // Convert filters → Drizzle SQL conditions\n * // Convert sort → Drizzle orderBy\n * return { where, orderBy, limit, offset }\n * }\n * }\n *\n * // Prisma adapter\n * class PrismaQueryAdapter implements QueryBuilderAdapter<PrismaQueryResult> {\n * build(parsed: ParsedQuery, config: PrismaConfig): PrismaQueryResult {\n * return { where, orderBy, skip, take }\n * }\n * }\n * ```\n */\nexport interface QueryBuilderAdapter<TResult = any, TConfig = any> {\n /** Human-readable name for debugging */\n readonly name: string\n\n /**\n * Convert a ParsedQuery into an ORM-specific query object.\n * @param parsed - The ORM-agnostic parsed query\n * @param config - ORM-specific configuration (column maps, search columns, etc.)\n */\n build(parsed: ParsedQuery, config: TConfig): TResult\n}\n","import {\n FILTER_OPERATORS,\n type FilterItem,\n type FilterOperator,\n type SortItem,\n type PaginationParams,\n type ParsedQuery,\n type QueryFieldConfig,\n type StringQueryFieldConfig,\n type TypedParsedQuery,\n} from './types'\n\nconst MAX_SEARCH_LENGTH = 200\nconst DEFAULT_PAGE = 1\nconst DEFAULT_LIMIT = 20\nconst MAX_LIMIT = 100\n\n// ── Individual parsers ──────────────────────────────────────────────────\n\n/** Parse filter strings like \"status:eq:active\" into structured objects */\nexport function parseFilters(\n filterParam: string | string[] | undefined,\n allowedFields?: string[],\n): FilterItem[] {\n if (!filterParam) return []\n\n const items = Array.isArray(filterParam) ? filterParam : [filterParam]\n const results: FilterItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n\n for (const item of items) {\n // Split on first two colons only — value may contain colons (e.g. timestamps)\n const firstColon = item.indexOf(':')\n if (firstColon === -1) continue\n\n const secondColon = item.indexOf(':', firstColon + 1)\n if (secondColon === -1) continue\n\n const field = item.slice(0, firstColon)\n const operator = item.slice(firstColon + 1, secondColon)\n const value = item.slice(secondColon + 1)\n\n if (!field || !value) continue\n if (!FILTER_OPERATORS.has(operator)) continue\n if (allowed && !allowed.has(field)) continue\n\n results.push({ field, operator: operator as FilterOperator, value })\n }\n\n return results\n}\n\n/** Parse sort strings like \"firstName:asc\" into structured objects */\nexport function parseSort(\n sortParam: string | string[] | undefined,\n allowedFields?: string[],\n): SortItem[] {\n if (!sortParam) return []\n\n const items = Array.isArray(sortParam) ? sortParam : [sortParam]\n const results: SortItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n\n for (const item of items) {\n // Split on last colon so field names with colons work\n const lastColon = item.lastIndexOf(':')\n if (lastColon === -1) continue\n\n const field = item.slice(0, lastColon)\n const dir = item.slice(lastColon + 1).toLowerCase()\n\n if (!field) continue\n if (dir !== 'asc' && dir !== 'desc') continue\n if (allowed && !allowed.has(field)) continue\n\n results.push({ field, direction: dir })\n }\n\n return results\n}\n\n/** Parse page/limit into pagination with computed offset */\nexport function parsePagination(params: {\n page?: string | number\n limit?: string | number\n}): PaginationParams {\n let page =\n typeof params.page === 'string'\n ? Number.parseInt(params.page, 10)\n : (params.page ?? DEFAULT_PAGE)\n let limit =\n typeof params.limit === 'string'\n ? Number.parseInt(params.limit, 10)\n : (params.limit ?? DEFAULT_LIMIT)\n\n if (Number.isNaN(page) || page < 1) page = DEFAULT_PAGE\n if (Number.isNaN(limit) || limit < 1) limit = DEFAULT_LIMIT\n if (limit > MAX_LIMIT) limit = MAX_LIMIT\n\n return { page, limit, offset: (page - 1) * limit }\n}\n\n/** Sanitize and truncate search query */\nexport function parseSearchQuery(q: string | undefined): string {\n if (!q) return ''\n return q.trim().slice(0, MAX_SEARCH_LENGTH)\n}\n\n// ── Config normalizer ───────────────────────────────────────────────────\n\n/**\n * Normalize a QueryFieldConfig into the string-based form.\n * Detects column-object-based configs (DrizzleQueryParamsConfig) by checking\n * for a `columns` property and extracts `Object.keys()`.\n */\nfunction normalizeFieldConfig(config?: QueryFieldConfig): StringQueryFieldConfig | undefined {\n if (!config) return undefined\n\n // Column-object-based config (e.g., DrizzleQueryParamsConfig)\n if ('columns' in config && config.columns && typeof config.columns === 'object') {\n return {\n filterable: Object.keys(config.columns),\n sortable: config.sortable ? Object.keys(config.sortable) : undefined,\n searchable: undefined, // searchColumns are Column objects, not used for string filtering\n }\n }\n\n // Already string-based\n return config as StringQueryFieldConfig\n}\n\n// ── Combined parser ─────────────────────────────────────────────────────\n\n/**\n * Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.\n *\n * @param query - Raw query string object from `req.query` or Zod-validated object\n * @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).\n * Accepts both string-based configs (`{ filterable, sortable, searchable }`) and\n * column-object configs (`{ columns, sortable, searchColumns }`).\n *\n * @example\n * ```ts\n * // String-based config\n * const parsed = parseQuery(ctx.query, {\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt', 'title'],\n * })\n *\n * // Column-object config (DrizzleQueryParamsConfig)\n * const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)\n * ```\n *\n * Query string format:\n * - Filters: `?filter=field:operator:value` (repeatable)\n * - Sort: `?sort=field:asc|desc` (repeatable)\n * - Pagination: `?page=1&limit=20`\n * - Search: `?q=search+term`\n *\n * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends\n */\nexport function parseQuery<TConfig extends QueryFieldConfig | undefined = undefined>(\n query: Record<string, any>,\n fieldConfig?: TConfig,\n): TypedParsedQuery<TConfig> {\n const normalized = normalizeFieldConfig(fieldConfig)\n return {\n filters: parseFilters(query.filter, normalized?.filterable),\n sort: parseSort(query.sort, normalized?.sortable),\n pagination: parsePagination({ page: query.page, limit: query.limit }),\n search: parseSearchQuery(query.q),\n } as TypedParsedQuery<TConfig>\n}\n\n// ── Query URL builder (for client-side or testing) ──────────────────────\n\n/** Convert ParsedQuery back into query string parameters */\nexport function buildQueryParams(\n parsed: Partial<ParsedQuery>,\n): Record<string, string | string[] | number> {\n const params: Record<string, string | string[] | number> = {}\n\n if (parsed.filters?.length) {\n params.filter = parsed.filters.map((f) => `${f.field}:${f.operator}:${f.value}`)\n }\n\n if (parsed.sort?.length) {\n params.sort = parsed.sort.map((s) => `${s.field}:${s.direction}`)\n }\n\n if (parsed.pagination) {\n params.page = parsed.pagination.page\n params.limit = parsed.pagination.limit\n }\n\n if (parsed.search) {\n params.q = parsed.search\n }\n\n return params\n}\n"],"mappings":"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"}
@@ -81,4 +81,4 @@ declare function unref<T>(value: Ref<T> | T): T;
81
81
  declare function toRefs<T extends Record<string, any>>(obj: T): { [K in keyof T]: Ref<T[K]> };
82
82
  //#endregion
83
83
  export { isRef as a, toRefs as c, computed as i, unref as l, Ref as n, reactive as o, WatchOptions as r, ref as s, ComputedRef as t, watch as u };
84
- //# sourceMappingURL=reactivity-I8nDlg4c.d.mts.map
84
+ //# sourceMappingURL=reactivity-CczHu3R-.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"reactivity-I8nDlg4c.d.mts","names":[],"sources":["../src/core/reactivity.ts"],"mappings":";;;AAuCA;;;;UAAiB,GAAA;EACf,KAAA,EAAO,CAAA;EAEgC;EAAvC,SAAA,CAAU,EAAA,GAAK,QAAA,EAAU,CAAA,EAAG,QAAA,EAAU,CAAA;AAAA;;;;;;;;;;;iBAaxB,GAAA,GAAA,CAAO,YAAA,EAAc,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA,UA2B5B,WAAA;EAAA,SACN,KAAA,EAAO,CAAA;AAAA;;;;;;;;;;;;AADlB;iBAgBgB,QAAA,GAAA,CAAY,MAAA,QAAc,CAAA,GAAI,WAAA,CAAY,CAAA;AAAA,UA+BzC,YAAA;EA9CE;EAgDjB,SAAA;AAAA;AAAA,KAGG,WAAA,MAAiB,GAAA,CAAI,CAAA,IAAK,WAAA,CAAY,CAAA,WAAY,CAAA;;;AApCvD;;;;;;;;;;;;iBAoDgB,KAAA,GAAA,CACd,MAAA,EAAQ,WAAA,CAAY,CAAA,GACpB,QAAA,GAAW,QAAA,EAAU,CAAA,EAAG,QAAA,EAAU,CAAA,WAClC,OAAA,GAAU,YAAA;;;AAxBZ;;;;;AAGC;;;;;;;;iBAwEe,QAAA,WAAmB,MAAA,cAAA,CAAqB,MAAA,EAAQ,CAAA,GAAI,CAAA;;iBA0BpD,KAAA,CAAM,KAAA,QAAa,KAAA,IAAS,GAAA;;iBAK5B,KAAA,GAAA,CAAS,KAAA,EAAO,GAAA,CAAI,CAAA,IAAK,CAAA,GAAI,CAAA;;iBAK7B,MAAA,WAAiB,MAAA,cAAA,CAAqB,GAAA,EAAK,CAAA,iBAAkB,CAAA,GAAI,GAAA,CAAI,CAAA,CAAE,CAAA"}
1
+ {"version":3,"file":"reactivity-CczHu3R-.d.mts","names":[],"sources":["../src/core/reactivity.ts"],"mappings":";;;AAuCA;;;;UAAiB,GAAA;EACf,KAAA,EAAO,CAAA;EAEgC;EAAvC,SAAA,CAAU,EAAA,GAAK,QAAA,EAAU,CAAA,EAAG,QAAA,EAAU,CAAA;AAAA;;;;;;;;;;;iBAaxB,GAAA,GAAA,CAAO,YAAA,EAAc,CAAA,GAAI,GAAA,CAAI,CAAA;AAAA,UA2B5B,WAAA;EAAA,SACN,KAAA,EAAO,CAAA;AAAA;;;;;;;;;;;;AADlB;iBAgBgB,QAAA,GAAA,CAAY,MAAA,QAAc,CAAA,GAAI,WAAA,CAAY,CAAA;AAAA,UA+BzC,YAAA;EA9CE;EAgDjB,SAAA;AAAA;AAAA,KAGG,WAAA,MAAiB,GAAA,CAAI,CAAA,IAAK,WAAA,CAAY,CAAA,WAAY,CAAA;;;AApCvD;;;;;;;;;;;;iBAoDgB,KAAA,GAAA,CACd,MAAA,EAAQ,WAAA,CAAY,CAAA,GACpB,QAAA,GAAW,QAAA,EAAU,CAAA,EAAG,QAAA,EAAU,CAAA,WAClC,OAAA,GAAU,YAAA;;;AAxBZ;;;;;AAGC;;;;;;;;iBAwEe,QAAA,WAAmB,MAAA,cAAA,CAAqB,MAAA,EAAQ,CAAA,GAAI,CAAA;;iBA0BpD,KAAA,CAAM,KAAA,QAAa,KAAA,IAAS,GAAA;;iBAK5B,KAAA,GAAA,CAAS,KAAA,EAAO,GAAA,CAAI,CAAA,IAAK,CAAA,GAAI,CAAA;;iBAK7B,MAAA,WAAiB,MAAA,cAAA,CAAqB,GAAA,EAAK,CAAA,iBAAkB,CAAA,GAAI,GAAA,CAAI,CAAA,CAAE,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forinda/kickjs",
3
- "version": "3.1.2",
3
+ "version": "3.2.0",
4
4
  "description": "A production-grade, decorator-driven Node.js framework built on Express 5 and TypeScript.",
5
5
  "keywords": [
6
6
  "kickjs",
@@ -1 +0,0 @@
1
- {"version":3,"file":"adapter-DjL8ql5d.d.mts","names":[],"sources":["../src/core/adapter.ts"],"mappings":";;;;;;;;;AAaA;;;;;AAGA;KAHY,eAAA;;UAGK,iBAAA;EAEf;EAAA,OAAA;EAEQ;EAAR,KAAA,GAAQ,eAAA;EAEJ;EAAJ,IAAA;AAAA;;;;;;;;;;;;;;UAgBe,cAAA;EAQf;EANA,GAAA,EAAK,OAAA;EAQO;EANZ,SAAA,EAAW,SAAA;EAqCI;EAnCf,MAAA,GAAS,IAAA,CAAK,MAAA;;EAEd,GAAA;EA+CkB;EA7ClB,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+Be,UAAA;EAwDa;EAtD5B,IAAA;EAyDA;;;;EAnDA,UAAA,KAAe,iBAAA;EAuDU;;;;EAjDzB,WAAA,EAAa,GAAA,EAAK,cAAA,UAAwB,OAAA;;;;;EAM1C,YAAA,EAAc,eAAA,EAAiB,WAAA,EAAa,SAAA;;;;;;;;;;;;;EAc5C,WAAA,EAAa,GAAA,EAAK,cAAA,UAAwB,OAAA;;;;;;;;;;;;;;;EAgB1C,UAAA,EAAY,GAAA,EAAK,cAAA,UAAwB,OAAA;;;;;EAMzC,aAAA,KAAkB,OAAA;IAAU,IAAA;IAAc,MAAA;EAAA;;EAG1C,QAAA,KAAa,YAAA;AAAA;;KAIH,eAAA,aAA4B,UAAA"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"app-module-Cotu9TIC.d.mts","names":[],"sources":["../src/core/app-module.ts"],"mappings":";;;;;;AAMA;;UAAiB,YAAA;EAAY;EAE3B,IAAA;EAEA;EAAA,MAAA;EAIA;EAFA,OAAA;EAEU;EAAV,UAAA;AAAA;;;;;;;;;;;;UAce,SAAA;EAIsB;EAFrC,QAAA,EAAU,SAAA,EAAW,SAAA;EAMX;EAJV,MAAA,IAAU,YAAA,GAAe,YAAA;AAAA;;KAIf,cAAA,aAA2B,SAAA"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"application-M8SEljFB.mjs","names":[],"sources":["../src/http/request-store.ts","../src/http/middleware/request-scope.ts","../src/http/application.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\n/** Per-request storage for REQUEST-scoped DI and request context propagation */\nexport interface RequestStore {\n /** Unique request identifier */\n requestId: string\n /** Per-request singleton cache for REQUEST-scoped services */\n instances: Map<any, any>\n /** Per-request values set by middleware (auth user, tenant, etc.) */\n values: Map<any, any>\n}\n\n/** AsyncLocalStorage instance shared across the framework */\nexport const requestStore = new AsyncLocalStorage<RequestStore>()\n\n/**\n * Get the current request store. Throws if called outside a request context.\n * Used by the Container to resolve REQUEST-scoped dependencies.\n */\nexport function getRequestStore(): RequestStore {\n const store = requestStore.getStore()\n if (!store) {\n throw new Error(\n 'No active request context. REQUEST-scoped services can only be resolved during an HTTP request.',\n )\n }\n return store\n}\n","import crypto from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\nimport { requestStore, type RequestStore } from '../request-store'\n\n/**\n * Wraps each request in an AsyncLocalStorage context.\n * Enables REQUEST-scoped DI and automatic requestId propagation to logs.\n *\n * Should be mounted early in the middleware pipeline (before route handlers).\n */\nexport function requestScopeMiddleware() {\n return (req: Request, _res: Response, next: NextFunction) => {\n const requestIdHeader = req.headers['x-request-id']\n const requestId =\n (Array.isArray(requestIdHeader) ? requestIdHeader[0] : requestIdHeader) || crypto.randomUUID()\n const store: RequestStore = {\n requestId,\n instances: new Map(),\n values: new Map(),\n }\n requestStore.run(store, () => next())\n }\n}\n","import http from 'node:http'\nimport express, { type Express, type RequestHandler } from 'express'\nimport {\n Container,\n createLogger,\n Logger,\n normalizePath,\n METADATA,\n type AppModuleClass,\n type AppAdapter,\n type AdapterContext,\n type AdapterMiddleware,\n type KickPlugin,\n type RouteDefinition,\n} from '../core'\nimport { getClassMeta } from '../core/metadata'\nimport { requestId } from './middleware/request-id'\nimport { notFoundHandler, errorHandler } from './middleware/error-handler'\nimport { requestScopeMiddleware } from './middleware/request-scope'\nimport { requestStore, getRequestStore } from './request-store'\n\nconst log = createLogger('Application')\n\n/**\n * A middleware entry in the declarative pipeline.\n * Can be a bare handler or an object with path scoping.\n */\nexport type MiddlewareEntry = RequestHandler | { path: string; handler: RequestHandler }\n\nexport interface ApplicationOptions {\n /** Feature modules to load */\n modules: AppModuleClass[]\n /** Adapters that hook into the lifecycle (DB, Redis, Swagger, etc.) */\n adapters?: AppAdapter[]\n /** Server port (falls back to PORT env var, then 3000) */\n port?: number\n /** Global API prefix (default: '/api') */\n apiPrefix?: string\n /** Default API version (default: 1) — routes become /{prefix}/v{version}/{path} */\n defaultVersion?: number\n\n /**\n * Global middleware pipeline. Declared in order.\n * Replaces the hardcoded middleware stack — you control exactly what runs.\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * middleware: [\n * helmet(),\n * cors(),\n * compression(),\n * morgan('dev'),\n * express.json({ limit: '1mb' }),\n * ],\n * })\n * ```\n *\n * If omitted, a sensible default is applied:\n * requestId(), express.json({ limit: '100kb' })\n */\n middleware?: MiddlewareEntry[]\n\n /** Plugins that bundle modules, adapters, middleware, and DI bindings */\n plugins?: KickPlugin[]\n\n /** Express `trust proxy` setting */\n trustProxy?: boolean | number | string | ((ip: string, hopIndex: number) => boolean)\n /** Maximum JSON body size (only used when middleware is not provided) */\n jsonLimit?: string | number\n /**\n * Log route summary on startup. Default: true in dev, false in production.\n * Set to `true` to always log, `false` to always suppress.\n */\n logRoutesTable?: boolean\n /**\n * Maximum time (ms) to wait for graceful shutdown before forcing exit.\n * Default: 30000 (30 seconds). Set to 0 to disable forced exit.\n */\n shutdownTimeout?: number\n\n /**\n * Enable cluster mode for multi-core utilization.\n *\n * When enabled, the primary process forks worker processes that share the\n * same port via Node's built-in `cluster` module (OS load balancing).\n *\n * - `true` — use all available CPU cores\n * - `{ workers: N }` — use exactly N workers\n *\n * Workers are auto-restarted on crash. SIGTERM/SIGINT on the primary is\n * forwarded to all workers.\n *\n * @example\n * ```ts\n * bootstrap({ modules, cluster: true })\n * bootstrap({ modules, cluster: { workers: 4 } })\n * ```\n */\n cluster?: boolean | { workers?: number }\n\n /**\n * Custom 404 handler for unmatched routes. Receives the raw Express\n * `(req, res, next)` args. When omitted, the built-in handler returns\n * `{ message: 'Not Found' }` with status 404.\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * onNotFound: (req, res) => {\n * res.status(404).json({ error: 'Route not found', path: req.originalUrl })\n * },\n * })\n * ```\n */\n onNotFound?: (req: any, res: any, next: any) => void\n\n /**\n * Custom global error handler. Receives `(err, req, res, next)` — the\n * standard Express error-handling signature. When omitted, the built-in\n * handler formats ZodError, HttpException, and unexpected errors.\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * onError: (err, req, res, next) => {\n * logger.error(err)\n * res.status(err.status ?? 500).json({ error: err.message })\n * },\n * })\n * ```\n */\n onError?: (err: any, req: any, res: any, next: any) => void\n\n /**\n * Security defaults applied automatically unless opted out.\n *\n * When not specified, secure defaults are applied:\n * - Helmet security headers are auto-injected\n * - JSON body limit defaults to 1MB\n *\n * @example\n * ```ts\n * bootstrap({\n * modules,\n * security: {\n * helmet: false, // disable auto-helmet\n * },\n * })\n * ```\n */\n security?: {\n /** Auto-inject helmet security headers. Default: true */\n helmet?: boolean\n }\n}\n\n/**\n * The main application class. Wires together Express, the DI container,\n * feature modules, adapters, and the middleware pipeline.\n */\nexport class Application {\n private app: Express\n private container: Container\n private httpServer: http.Server | null = null\n private adapters: AppAdapter[]\n\n private plugins: KickPlugin[]\n\n /** Number of HTTP requests currently being processed */\n private _inFlightRequests = 0\n /** Whether the application is draining (shutting down gracefully) */\n private _draining = false\n /** Whether shutdown has already been initiated (prevents double-shutdown) */\n private _shutdownInitiated = false\n /** Resolvers waiting for in-flight requests to reach zero */\n private _drainResolvers: Array<() => void> = []\n\n constructor(private readonly options: ApplicationOptions) {\n this.app = express()\n this.container = Container.getInstance()\n this.plugins = options.plugins ?? []\n this.adapters = [\n // Plugin adapters first\n ...this.plugins.flatMap((p) => p.adapters?.() ?? []),\n ...(options.adapters ?? []),\n ]\n // Wire the request store provider so Container can resolve REQUEST-scoped deps\n Container._requestStoreProvider = () => requestStore.getStore() ?? null\n // Wire logger context provider so logs auto-include requestId\n Logger._contextProvider = () => {\n const store = requestStore.getStore()\n if (!store) return null\n const ctx: Record<string, any> = { requestId: store.requestId }\n const traceId = store.values.get('traceId')\n if (traceId) ctx.traceId = traceId\n const spanId = store.values.get('spanId')\n if (spanId) ctx.spanId = spanId\n return ctx\n }\n }\n\n /** Whether the application is currently draining in-flight requests */\n get isDraining(): boolean {\n return this._draining\n }\n\n /** Number of HTTP requests currently being processed */\n get inFlightRequests(): number {\n return this._inFlightRequests\n }\n\n /** Get the DI container instance */\n getContainer(): Container {\n return this.container\n }\n\n /**\n * Express request handler — delegates to the internal Express app.\n *\n * Used by the Vite dev-server plugin to route requests through KickJS:\n * ```ts\n * const mod = await ssrLoadModule('virtual:kickjs/app')\n * mod.app.handle(req, res, next)\n * ```\n *\n * Also works as a standard Node.js request handler for production:\n * ```ts\n * http.createServer(app.handle.bind(app))\n * ```\n */\n handle(req: http.IncomingMessage, res: http.ServerResponse, next?: (err?: any) => void): void {\n if (next) {\n this.app(req as any, res as any, next)\n } else {\n this.app(req as any, res as any)\n }\n }\n\n /**\n * Full setup pipeline:\n * 1. Adapter beforeMount hooks (early routes — docs, health)\n * 2. Adapter middleware (phase: beforeGlobal)\n * 3. Global middleware (user-declared or defaults)\n * 4. Adapter middleware (phase: afterGlobal)\n * 5. Module registration + DI bootstrap\n * 6. Adapter middleware (phase: beforeRoutes)\n * 7. Module route mounting\n * 8. Adapter middleware (phase: afterRoutes)\n * 9. Error handlers (notFound + global)\n * 10. Adapter beforeStart hooks\n */\n /** Build the adapter context object (shared across all hooks) */\n private adapterCtx(server?: any): AdapterContext {\n const env = process.env.NODE_ENV ?? 'development'\n return {\n app: this.app,\n container: this.container,\n server,\n env,\n isProduction: env === 'production',\n }\n }\n\n /** Call an adapter hook, awaiting async hooks and catching errors */\n private async callHook(\n hook: ((ctx: AdapterContext) => void | Promise<void>) | undefined,\n ctx: AdapterContext,\n ): Promise<void> {\n if (!hook) return\n try {\n const result = hook(ctx)\n if (result && typeof (result as Promise<void>).then === 'function') {\n await result\n }\n } catch (err) {\n log.error(err, 'Adapter hook failed')\n }\n }\n\n async setup(): Promise<void> {\n log.debug('Bootstrapping application...')\n\n // Collect adapter middleware by phase\n const adapterMw = this.collectAdapterMiddleware()\n\n // Expose the Application instance on the Express app for adapter discovery\n ;(this.app as any).__kickApp = this\n\n const ctx = this.adapterCtx()\n\n // ── 1. Adapter beforeMount hooks ──────────────────────────────────\n for (const adapter of this.adapters) {\n await this.callHook(adapter.beforeMount?.bind(adapter), ctx)\n }\n\n // ── 2. Hardened defaults ──────────────────────────────────────────\n this.app.disable('x-powered-by')\n this.app.set('trust proxy', this.options.trustProxy ?? false)\n\n // ── 2a. In-flight request tracking ──────────────────────────────\n this.app.use(this.requestTrackingMiddleware())\n\n // ── 2b. Health check endpoints (before middleware, at root) ──────\n this.mountHealthEndpoints()\n\n // ── 2c. Request scope (AsyncLocalStorage) ────────────────────────\n this.app.use(requestScopeMiddleware())\n\n // ── 3. Adapter middleware: beforeGlobal ───────────────────────────\n this.mountMiddlewareList(adapterMw.beforeGlobal)\n\n // ── 3b. Plugin registration ──────────────────────────────────────\n for (const plugin of this.plugins) {\n plugin.register?.(this.container)\n }\n\n // ── 3c. Plugin middleware ─────────────────────────────────────────\n for (const plugin of this.plugins) {\n try {\n const mw = plugin.middleware?.() ?? []\n for (const handler of mw) {\n this.app.use(handler)\n }\n } catch (err) {\n log.error(err, `Plugin middleware failed: ${(plugin as any).name ?? 'unknown'}`)\n }\n }\n\n // ── 4. Global middleware ─────────────────────────────────────────\n // Auto-inject helmet unless opted out\n const autoHelmet = this.options.security?.helmet !== false\n if (autoHelmet) {\n try {\n const { helmet: helmetFn } = await import('./middleware/helmet')\n this.app.use(helmetFn())\n } catch {\n // helmet middleware not available — skip silently\n }\n }\n\n if (this.options.middleware) {\n // User-declared pipeline — full control\n for (const entry of this.options.middleware) {\n this.mountMiddlewareEntry(entry)\n }\n } else {\n // Sensible defaults when no middleware declared\n this.app.use(requestId())\n this.app.use(express.json({ limit: this.options.jsonLimit ?? '1mb' }))\n }\n\n // ── 5. Adapter middleware: afterGlobal ────────────────────────────\n this.mountMiddlewareList(adapterMw.afterGlobal)\n\n // ── 6. Module registration + DI bootstrap ────────────────────────\n // Plugin modules first, then user modules\n const allModuleClasses = [\n ...this.plugins.flatMap((p) => p.modules?.() ?? []),\n ...this.options.modules,\n ]\n const modules = allModuleClasses.map((ModuleClass) => {\n const mod = new ModuleClass()\n // `register()` is optional — modules whose classes are entirely\n // decorator-managed (@Service, @Controller, @Repository) don't need it.\n mod.register?.(this.container)\n return mod\n })\n this.container.bootstrap()\n\n // ── 7. Adapter middleware: beforeRoutes ───────────────────────────\n this.mountMiddlewareList(adapterMw.beforeRoutes)\n\n // ── 8. Mount module routes with versioning ───────────────────────\n const apiPrefix = this.options.apiPrefix ?? '/api'\n const defaultVersion = this.options.defaultVersion ?? 1\n const shouldLogRoutes = this.options.logRoutesTable ?? process.env.NODE_ENV !== 'production'\n\n // Collect route metadata during mounting (avoids calling mod.routes() twice)\n const mountedRoutes: Array<{ controller: any; mountPath: string }> = []\n\n for (const mod of modules) {\n const result = mod.routes()\n if (!result) continue // Non-HTTP modules (queues, cron) may return null\n\n const routeSets = Array.isArray(result) ? result : [result]\n\n for (const route of routeSets) {\n const version = route.version ?? defaultVersion\n const mountPath = `${apiPrefix}/v${version}${normalizePath(route.path)}`\n this.app.use(mountPath, route.router)\n\n // Notify adapters (e.g. SwaggerAdapter for OpenAPI spec generation)\n if (route.controller) {\n for (const adapter of this.adapters) {\n try {\n adapter.onRouteMount?.(route.controller, mountPath)\n } catch (err) {\n log.error(err, `adapter.onRouteMount() failed for ${mountPath}`)\n }\n }\n if (shouldLogRoutes) {\n mountedRoutes.push({ controller: route.controller, mountPath })\n }\n }\n }\n }\n\n // ── 8b. Log route summary ─────────────────────────────────────────\n if (shouldLogRoutes && mountedRoutes.length > 0) {\n const methodOrder = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']\n const methodRank = (m: string) => {\n const i = methodOrder.indexOf(m)\n return i === -1 ? 99 : i\n }\n\n let totalRoutes = 0\n log.debug('Routes:')\n\n for (const { controller, mountPath } of mountedRoutes) {\n const defs: RouteDefinition[] = getClassMeta<RouteDefinition[]>(\n METADATA.ROUTES,\n controller,\n [],\n )\n if (defs.length === 0) continue\n\n const counts: Record<string, number> = {}\n for (const def of defs) {\n const m = def.method.toUpperCase()\n counts[m] = (counts[m] || 0) + 1\n }\n totalRoutes += defs.length\n\n const methods = Object.entries(counts)\n .sort(([a], [b]) => methodRank(a) - methodRank(b))\n .map(([m, n]) => `${n} ${m}`)\n .join(', ')\n const name = controller.name || 'Controller'\n log.debug(` ${name.padEnd(30)} ${mountPath.padEnd(25)} ${defs.length} routes (${methods})`)\n }\n\n log.debug(` Total: ${totalRoutes} routes`)\n }\n\n // ── 9. Adapter middleware: afterRoutes ────────────────────────────\n this.mountMiddlewareList(adapterMw.afterRoutes)\n\n // ── 10. Error handlers ───────────────────────────────────────────\n this.app.use(this.options.onNotFound ?? notFoundHandler())\n this.app.use(this.options.onError ?? errorHandler())\n\n // ── 11. Adapter beforeStart hooks ────────────────────────────────\n for (const adapter of this.adapters) {\n await this.callHook(adapter.beforeStart?.bind(adapter), ctx)\n }\n }\n\n /** Register modules and DI without starting the HTTP server (used by kick tinker) */\n async registerOnly(): Promise<void> {\n await this.setup()\n }\n\n /**\n * Start the HTTP server.\n *\n * In **dev mode** (Vite plugin active): reuses `globalThis.__kickjs_httpServer`\n * created by Vite. Adapters (WsAdapter, Socket.IO, etc.) receive the real\n * `http.Server` through `afterStart({ server })` — zero adapter changes needed.\n *\n * In **production**: creates its own `http.Server` and binds to the port.\n */\n async start(): Promise<void> {\n await this.setup()\n\n const g = globalThis as any\n\n if (g.__kickjs_httpServer) {\n // ── DEV MODE: Vite owns the http.Server ──────────────────────\n // Don't create a new server or listen — Vite is already listening.\n // Just wire up adapters with the Vite-created server.\n this.httpServer = g.__kickjs_httpServer\n log.debug('Attached to Vite dev server')\n\n for (const adapter of this.adapters) {\n const ctx = this.adapterCtx(this.httpServer!)\n await this.callHook(adapter.afterStart?.bind(adapter), ctx)\n }\n\n for (const plugin of this.plugins) {\n await plugin.onReady?.(this.container)\n }\n\n return\n }\n\n // ── PRODUCTION: Create and own the http.Server ─────────────────\n const port = this.options.port ?? parseInt(process.env.PORT || '3000', 10)\n this.httpServer = http.createServer(this.app)\n\n this.httpServer.on('error', (err: NodeJS.ErrnoException) => {\n if (err.code === 'EADDRINUSE') {\n log.error(\n `Port ${port} is already in use. Kill the existing process or use a different port:\\n` +\n ` PORT=${port + 1} kick dev\\n` +\n ` lsof -i :${port} # find what's using it\\n` +\n ` kill <PID> # stop it`,\n )\n process.exit(1)\n }\n throw err\n })\n\n // Wrap listen in a Promise so afterStart/onReady errors propagate\n await new Promise<void>((resolve, reject) => {\n this.httpServer!.listen(port, async () => {\n try {\n log.info(`Server running on http://localhost:${port}`)\n\n for (const adapter of this.adapters) {\n const afterCtx = this.adapterCtx(this.httpServer!)\n await this.callHook(adapter.afterStart?.bind(adapter), afterCtx)\n }\n\n // Plugin onReady hooks\n for (const plugin of this.plugins) {\n await plugin.onReady?.(this.container)\n }\n\n resolve()\n } catch (err) {\n reject(err)\n }\n })\n })\n }\n\n /** HMR rebuild: swap Express handler without restarting the server */\n async rebuild(): Promise<void> {\n // Build the new app fully before swapping — if setup() throws,\n // the old app keeps running so the server stays responsive.\n const prevApp = this.app\n const prevContainer = this.container\n\n try {\n Container.reset()\n this.container = Container.getInstance()\n this.app = express()\n await this.setup()\n } catch (err) {\n log.error(err, 'HMR rebuild failed, keeping previous app')\n // Restore previous state so the server stays responsive\n this.app = prevApp\n this.container = prevContainer\n return\n }\n\n if (this.httpServer) {\n this.httpServer.removeAllListeners('request')\n this.httpServer.on('request', this.app)\n log.debug('HMR: Express app rebuilt and swapped')\n }\n }\n\n /**\n * Graceful shutdown with request draining.\n *\n * 1. Stops accepting new connections (server.close())\n * 2. Waits for in-flight requests to complete (up to shutdownTimeout)\n * 3. Calls adapter.shutdown() for all registered adapters\n * 4. Force-closes after timeout\n *\n * Safe to call multiple times — subsequent calls return the same promise.\n */\n async shutdown(): Promise<void> {\n // Prevent double-shutdown — return immediately if already initiated\n if (this._shutdownInitiated) {\n log.debug('Shutdown already in progress, skipping duplicate call')\n return\n }\n this._shutdownInitiated = true\n this._draining = true\n\n log.debug('Shutting down — draining in-flight requests...')\n\n const timeoutMs = this.options.shutdownTimeout ?? 30_000\n let timer: ReturnType<typeof setTimeout> | undefined\n\n // Start a force-exit timer if timeout is configured\n const forceExitPromise =\n timeoutMs > 0\n ? new Promise<'timeout'>((resolve) => {\n timer = setTimeout(() => resolve('timeout'), timeoutMs)\n timer.unref()\n })\n : new Promise<never>(() => {}) // never resolves — no forced exit\n\n try {\n // Step 1: Stop accepting new connections.\n // server.close() prevents new connections. Its callback fires only when\n // ALL existing connections are fully closed, so we do NOT await it here —\n // we track request draining separately via the tracking middleware.\n if (this.httpServer) {\n this.httpServer.close(() => {})\n }\n\n // Step 2: Wait for in-flight requests to drain (or timeout)\n if (this._inFlightRequests > 0) {\n log.debug(`Waiting for ${this._inFlightRequests} in-flight request(s) to complete...`)\n const drainPromise = new Promise<'drained'>((resolve) => {\n this._drainResolvers.push(() => resolve('drained'))\n })\n\n const result = await Promise.race([drainPromise, forceExitPromise])\n if (result === 'timeout') {\n log.warn(\n `Shutdown timeout (${timeoutMs}ms) reached with ${this._inFlightRequests} request(s) still in-flight, forcing shutdown`,\n )\n } else {\n log.debug('All in-flight requests completed')\n }\n }\n\n // Step 3: Run all plugin + adapter shutdowns concurrently\n const results = await Promise.allSettled([\n ...this.plugins.map((plugin) => Promise.resolve(plugin.shutdown?.())),\n ...this.adapters.map((adapter) => Promise.resolve(adapter.shutdown?.())),\n ])\n for (const result of results) {\n if (result.status === 'rejected') {\n log.error({ err: result.reason }, 'Adapter shutdown failed')\n }\n }\n } finally {\n if (timer) clearTimeout(timer)\n }\n }\n\n getExpressApp(): Express {\n return this.app\n }\n\n /** Get registered adapters — used by DevToolsAdapter for peer discovery */\n getAdapters(): AppAdapter[] {\n return this.adapters\n }\n\n getHttpServer(): http.Server | null {\n return this.httpServer\n }\n\n // ── Internal helpers ────────────────────────────────────────────────\n\n private collectAdapterMiddleware() {\n const result = {\n beforeGlobal: [] as AdapterMiddleware[],\n afterGlobal: [] as AdapterMiddleware[],\n beforeRoutes: [] as AdapterMiddleware[],\n afterRoutes: [] as AdapterMiddleware[],\n }\n\n for (const adapter of this.adapters) {\n const entries = adapter.middleware?.() ?? []\n for (const entry of entries) {\n const phase = entry.phase ?? 'afterGlobal'\n result[phase].push(entry)\n }\n }\n\n return result\n }\n\n private mountMiddlewareList(entries: AdapterMiddleware[]): void {\n for (const entry of entries) {\n if (entry.path) {\n this.app.use(entry.path, entry.handler)\n } else {\n this.app.use(entry.handler)\n }\n }\n }\n\n private mountMiddlewareEntry(entry: MiddlewareEntry): void {\n if (typeof entry === 'function') {\n this.app.use(entry)\n } else {\n this.app.use(entry.path, entry.handler)\n }\n }\n\n /** Middleware that tracks in-flight requests for graceful draining */\n private requestTrackingMiddleware(): RequestHandler {\n return (_req, res, next) => {\n this._inFlightRequests++\n const onFinish = () => {\n res.removeListener('finish', onFinish)\n res.removeListener('close', onFinish)\n this._inFlightRequests--\n // If draining and no more in-flight requests, resolve all waiters\n if (this._draining && this._inFlightRequests === 0) {\n for (const resolve of this._drainResolvers) {\n resolve()\n }\n this._drainResolvers = []\n }\n }\n res.on('finish', onFinish)\n res.on('close', onFinish)\n next()\n }\n }\n\n /** Mount /health/live and /health/ready endpoints at the root (no API prefix) */\n private mountHealthEndpoints(): void {\n this.app.get('/health/live', (_req, res) => {\n if (this._draining) {\n res.status(503).json({ status: 'draining', uptime: process.uptime() })\n } else {\n res.json({ status: 'ok', uptime: process.uptime() })\n }\n })\n\n this.app.get('/health/ready', async (_req, res) => {\n if (this._draining) {\n res.status(503).json({ status: 'draining', checks: [] })\n return\n }\n const adaptersWithHealth = this.adapters.filter((a) => a.onHealthCheck)\n const checks = await Promise.allSettled(adaptersWithHealth.map((a) => a.onHealthCheck!()))\n const results = checks.map((c, i) => {\n if (c.status === 'fulfilled') return c.value\n return { name: adaptersWithHealth[i].name ?? 'unknown', status: 'down' as const }\n })\n const healthy = results.every((r) => r.status === 'up')\n res.status(healthy ? 200 : 503).json({\n status: healthy ? 'ready' : 'degraded',\n checks: results,\n })\n })\n }\n}\n"],"mappings":"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"}