@forinda/kickjs 2.0.1 → 2.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 (238) hide show
  1. package/README.md +63 -20
  2. package/dist/adapter-wuoBNkNs.d.mts +122 -0
  3. package/dist/adapter-wuoBNkNs.d.mts.map +1 -0
  4. package/dist/app-module-DOBmxARW.d.mts +40 -0
  5. package/dist/app-module-DOBmxARW.d.mts.map +1 -0
  6. package/dist/application-C5Q720a2.mjs +449 -0
  7. package/dist/application-C5Q720a2.mjs.map +1 -0
  8. package/dist/bootstrap-dEN6SjBl.mjs +205 -0
  9. package/dist/bootstrap-dEN6SjBl.mjs.map +1 -0
  10. package/dist/{core/cache.d.ts → cache-PufEhr0n.d.mts} +33 -31
  11. package/dist/cache-PufEhr0n.d.mts.map +1 -0
  12. package/dist/chunk-C9tIbwLT.mjs +15 -0
  13. package/dist/container-B7jFEbPE.mjs +496 -0
  14. package/dist/container-B7jFEbPE.mjs.map +1 -0
  15. package/dist/container-CcgV8eHL.d.mts +253 -0
  16. package/dist/container-CcgV8eHL.d.mts.map +1 -0
  17. package/dist/core/adapter.d.mts +3 -0
  18. package/dist/core/adapter.mjs +11 -0
  19. package/dist/core/app-module.d.mts +3 -0
  20. package/dist/core/app-module.mjs +11 -0
  21. package/dist/core/cache.d.mts +3 -0
  22. package/dist/core/cache.mjs +113 -0
  23. package/dist/core/cache.mjs.map +1 -0
  24. package/dist/core/container.d.mts +3 -0
  25. package/dist/core/container.mjs +12 -0
  26. package/dist/core/cron.d.mts +3 -0
  27. package/dist/core/cron.mjs +42 -0
  28. package/dist/core/cron.mjs.map +1 -0
  29. package/dist/core/decorators.d.mts +3 -0
  30. package/dist/core/decorators.mjs +219 -0
  31. package/dist/core/decorators.mjs.map +1 -0
  32. package/dist/core/errors.d.mts +3 -0
  33. package/dist/core/errors.mjs +97 -0
  34. package/dist/core/errors.mjs.map +1 -0
  35. package/dist/core/interfaces.d.mts +3 -0
  36. package/dist/core/interfaces.mjs +44 -0
  37. package/dist/core/interfaces.mjs.map +1 -0
  38. package/dist/core/logger.d.mts +3 -0
  39. package/dist/core/logger.mjs +217 -0
  40. package/dist/core/logger.mjs.map +1 -0
  41. package/dist/core/path.d.mts +3 -0
  42. package/dist/core/path.mjs +45 -0
  43. package/dist/core/path.mjs.map +1 -0
  44. package/dist/core/plugin.d.mts +3 -0
  45. package/dist/core/plugin.mjs +11 -0
  46. package/dist/core/reactivity.d.mts +3 -0
  47. package/dist/core/reactivity.mjs +189 -0
  48. package/dist/core/reactivity.mjs.map +1 -0
  49. package/dist/core-CMgIoRvg.mjs +121 -0
  50. package/dist/core-CMgIoRvg.mjs.map +1 -0
  51. package/dist/{core/cron.d.ts → cron-C29iHvHT.d.mts} +16 -14
  52. package/dist/cron-C29iHvHT.d.mts.map +1 -0
  53. package/dist/decorators-D3lBlmud.d.mts +204 -0
  54. package/dist/decorators-D3lBlmud.d.mts.map +1 -0
  55. package/dist/errors-BZUdxtjC.d.mts +68 -0
  56. package/dist/errors-BZUdxtjC.d.mts.map +1 -0
  57. package/dist/http/application.d.mts +220 -0
  58. package/dist/http/application.d.mts.map +1 -0
  59. package/dist/http/application.mjs +12 -0
  60. package/dist/http/bootstrap.d.mts +43 -0
  61. package/dist/http/bootstrap.d.mts.map +1 -0
  62. package/dist/http/bootstrap.mjs +12 -0
  63. package/dist/http/context.d.mts +190 -0
  64. package/dist/http/context.d.mts.map +1 -0
  65. package/dist/http/context.mjs +225 -0
  66. package/dist/http/context.mjs.map +1 -0
  67. package/dist/http/middleware/cors.d.mts +48 -0
  68. package/dist/http/middleware/cors.d.mts.map +1 -0
  69. package/dist/http/middleware/cors.mjs +83 -0
  70. package/dist/http/middleware/cors.mjs.map +1 -0
  71. package/dist/http/middleware/csrf.d.mts +52 -0
  72. package/dist/http/middleware/csrf.d.mts.map +1 -0
  73. package/dist/http/middleware/csrf.mjs +72 -0
  74. package/dist/http/middleware/csrf.mjs.map +1 -0
  75. package/dist/http/middleware/error-handler.d.mts +11 -0
  76. package/dist/http/middleware/error-handler.d.mts.map +1 -0
  77. package/dist/http/middleware/error-handler.mjs +52 -0
  78. package/dist/http/middleware/error-handler.mjs.map +1 -0
  79. package/dist/http/middleware/helmet.d.mts +41 -0
  80. package/dist/http/middleware/helmet.d.mts.map +1 -0
  81. package/dist/http/middleware/helmet.mjs +51 -0
  82. package/dist/http/middleware/helmet.mjs.map +1 -0
  83. package/dist/http/middleware/rate-limit.d.mts +56 -0
  84. package/dist/http/middleware/rate-limit.d.mts.map +1 -0
  85. package/dist/http/middleware/rate-limit.mjs +101 -0
  86. package/dist/http/middleware/rate-limit.mjs.map +1 -0
  87. package/dist/http/middleware/request-id.d.mts +10 -0
  88. package/dist/http/middleware/request-id.d.mts.map +1 -0
  89. package/dist/http/middleware/request-id.mjs +26 -0
  90. package/dist/http/middleware/request-id.mjs.map +1 -0
  91. package/dist/http/middleware/request-logger.d.mts +32 -0
  92. package/dist/http/middleware/request-logger.d.mts.map +1 -0
  93. package/dist/http/middleware/request-logger.mjs +49 -0
  94. package/dist/http/middleware/request-logger.mjs.map +1 -0
  95. package/dist/http/middleware/session.d.mts +67 -0
  96. package/dist/http/middleware/session.d.mts.map +1 -0
  97. package/dist/http/middleware/session.mjs +152 -0
  98. package/dist/http/middleware/session.mjs.map +1 -0
  99. package/dist/http/middleware/spa.d.mts +101 -0
  100. package/dist/http/middleware/spa.d.mts.map +1 -0
  101. package/dist/http/middleware/spa.mjs +108 -0
  102. package/dist/http/middleware/spa.mjs.map +1 -0
  103. package/dist/http/middleware/{upload.d.ts → upload.d.mts} +21 -17
  104. package/dist/http/middleware/upload.d.mts.map +1 -0
  105. package/dist/http/middleware/upload.mjs +191 -0
  106. package/dist/http/middleware/upload.mjs.map +1 -0
  107. package/dist/http/middleware/validate.d.mts +18 -0
  108. package/dist/http/middleware/validate.d.mts.map +1 -0
  109. package/dist/http/middleware/validate.mjs +62 -0
  110. package/dist/http/middleware/validate.mjs.map +1 -0
  111. package/dist/http/middleware/views.d.mts +62 -0
  112. package/dist/http/middleware/views.d.mts.map +1 -0
  113. package/dist/http/middleware/views.mjs +65 -0
  114. package/dist/http/middleware/views.mjs.map +1 -0
  115. package/dist/http/query/index.d.mts +3 -0
  116. package/dist/http/query/index.mjs +12 -0
  117. package/dist/http/{router-builder.d.ts → router-builder.d.mts} +9 -5
  118. package/dist/http/router-builder.d.mts.map +1 -0
  119. package/dist/http/router-builder.mjs +67 -0
  120. package/dist/http/router-builder.mjs.map +1 -0
  121. package/dist/index-4VM4dUJf.d.mts +107 -0
  122. package/dist/index-4VM4dUJf.d.mts.map +1 -0
  123. package/dist/index-rnK23QBD.d.mts +184 -0
  124. package/dist/index-rnK23QBD.d.mts.map +1 -0
  125. package/dist/index.d.mts +133 -0
  126. package/dist/index.d.mts.map +1 -0
  127. package/dist/index.mjs +126 -0
  128. package/dist/index.mjs.map +1 -0
  129. package/dist/interfaces-D5ohYl6D.d.mts +52 -0
  130. package/dist/interfaces-D5ohYl6D.d.mts.map +1 -0
  131. package/dist/logger-BLdfUF5b.d.mts +119 -0
  132. package/dist/logger-BLdfUF5b.d.mts.map +1 -0
  133. package/dist/metadata-BqXgNTOf.mjs +76 -0
  134. package/dist/metadata-BqXgNTOf.mjs.map +1 -0
  135. package/dist/{core/path.d.ts → path-Dq5V-i-x.d.mts} +7 -3
  136. package/dist/path-Dq5V-i-x.d.mts.map +1 -0
  137. package/dist/plugin-D20muJwC.d.mts +95 -0
  138. package/dist/plugin-D20muJwC.d.mts.map +1 -0
  139. package/dist/query-vljPDFaZ.mjs +164 -0
  140. package/dist/query-vljPDFaZ.mjs.map +1 -0
  141. package/dist/{core/reactivity.d.ts → reactivity-CMAQh0gi.d.mts} +21 -20
  142. package/dist/reactivity-CMAQh0gi.d.mts.map +1 -0
  143. package/package.json +73 -43
  144. package/dist/chunk-DVVP7zzD.js +0 -7
  145. package/dist/core/adapter.d.ts +0 -109
  146. package/dist/core/adapter.d.ts.map +0 -1
  147. package/dist/core/adapter.js +0 -0
  148. package/dist/core/app-module.d.ts +0 -28
  149. package/dist/core/app-module.d.ts.map +0 -1
  150. package/dist/core/app-module.js +0 -0
  151. package/dist/core/cache.d.ts.map +0 -1
  152. package/dist/core/cache.js +0 -57
  153. package/dist/core/container.d.ts +0 -63
  154. package/dist/core/container.d.ts.map +0 -1
  155. package/dist/core/container.js +0 -117
  156. package/dist/core/cron.d.ts.map +0 -1
  157. package/dist/core/cron.js +0 -22
  158. package/dist/core/decorators.d.ts +0 -153
  159. package/dist/core/decorators.d.ts.map +0 -1
  160. package/dist/core/decorators.js +0 -141
  161. package/dist/core/errors.d.ts +0 -64
  162. package/dist/core/errors.d.ts.map +0 -1
  163. package/dist/core/errors.js +0 -67
  164. package/dist/core/index.d.ts +0 -14
  165. package/dist/core/index.d.ts.map +0 -1
  166. package/dist/core/interfaces.d.ts +0 -44
  167. package/dist/core/interfaces.d.ts.map +0 -1
  168. package/dist/core/interfaces.js +0 -25
  169. package/dist/core/logger.d.ts +0 -43
  170. package/dist/core/logger.d.ts.map +0 -1
  171. package/dist/core/logger.js +0 -54
  172. package/dist/core/path.d.ts.map +0 -1
  173. package/dist/core/path.js +0 -12
  174. package/dist/core/plugin.d.ts +0 -90
  175. package/dist/core/plugin.d.ts.map +0 -1
  176. package/dist/core/plugin.js +0 -0
  177. package/dist/core/reactivity.d.ts.map +0 -1
  178. package/dist/core/reactivity.js +0 -101
  179. package/dist/core-B6Okew3W.js +0 -7
  180. package/dist/http/application.d.ts +0 -103
  181. package/dist/http/application.d.ts.map +0 -1
  182. package/dist/http/application.js +0 -167
  183. package/dist/http/bootstrap.d.ts +0 -22
  184. package/dist/http/bootstrap.d.ts.map +0 -1
  185. package/dist/http/bootstrap.js +0 -40
  186. package/dist/http/context.d.ts +0 -129
  187. package/dist/http/context.d.ts.map +0 -1
  188. package/dist/http/context.js +0 -115
  189. package/dist/http/index.d.ts +0 -16
  190. package/dist/http/index.d.ts.map +0 -1
  191. package/dist/http/middleware/cors.d.ts +0 -43
  192. package/dist/http/middleware/cors.d.ts.map +0 -1
  193. package/dist/http/middleware/cors.js +0 -31
  194. package/dist/http/middleware/csrf.d.ts +0 -47
  195. package/dist/http/middleware/csrf.d.ts.map +0 -1
  196. package/dist/http/middleware/csrf.js +0 -25
  197. package/dist/http/middleware/error-handler.d.ts +0 -6
  198. package/dist/http/middleware/error-handler.d.ts.map +0 -1
  199. package/dist/http/middleware/error-handler.js +0 -37
  200. package/dist/http/middleware/helmet.d.ts +0 -36
  201. package/dist/http/middleware/helmet.d.ts.map +0 -1
  202. package/dist/http/middleware/helmet.js +0 -20
  203. package/dist/http/middleware/rate-limit.d.ts +0 -51
  204. package/dist/http/middleware/rate-limit.d.ts.map +0 -1
  205. package/dist/http/middleware/rate-limit.js +0 -46
  206. package/dist/http/middleware/request-id.d.ts +0 -5
  207. package/dist/http/middleware/request-id.d.ts.map +0 -1
  208. package/dist/http/middleware/request-id.js +0 -12
  209. package/dist/http/middleware/request-logger.d.ts +0 -27
  210. package/dist/http/middleware/request-logger.d.ts.map +0 -1
  211. package/dist/http/middleware/request-logger.js +0 -16
  212. package/dist/http/middleware/session.d.ts +0 -62
  213. package/dist/http/middleware/session.d.ts.map +0 -1
  214. package/dist/http/middleware/session.js +0 -76
  215. package/dist/http/middleware/spa.d.ts +0 -93
  216. package/dist/http/middleware/spa.d.ts.map +0 -1
  217. package/dist/http/middleware/spa.js +0 -52
  218. package/dist/http/middleware/upload.d.ts.map +0 -1
  219. package/dist/http/middleware/upload.js +0 -119
  220. package/dist/http/middleware/validate.d.ts +0 -13
  221. package/dist/http/middleware/validate.d.ts.map +0 -1
  222. package/dist/http/middleware/validate.js +0 -45
  223. package/dist/http/middleware/views.d.ts +0 -56
  224. package/dist/http/middleware/views.d.ts.map +0 -1
  225. package/dist/http/middleware/views.js +0 -18
  226. package/dist/http/query/index.d.ts +0 -4
  227. package/dist/http/query/index.d.ts.map +0 -1
  228. package/dist/http/query/index.js +0 -10
  229. package/dist/http/query/parse-query.d.ts +0 -44
  230. package/dist/http/query/parse-query.d.ts.map +0 -1
  231. package/dist/http/query/types.d.ts +0 -100
  232. package/dist/http/query/types.d.ts.map +0 -1
  233. package/dist/http/router-builder.d.ts.map +0 -1
  234. package/dist/http/router-builder.js +0 -37
  235. package/dist/index.d.ts +0 -25
  236. package/dist/index.d.ts.map +0 -1
  237. package/dist/index.js +0 -103
  238. package/dist/query-Bym31XRp.js +0 -88
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.mjs","names":[],"sources":["../../src/core/logger.ts"],"sourcesContent":["import pino from 'pino'\n\nconst isDev = process.env.NODE_ENV !== 'production'\n\n/** Root pino logger instance */\nexport const rootLogger = pino({\n level: process.env.LOG_LEVEL || 'info',\n ...(isDev\n ? {\n transport: {\n target: 'pino-pretty',\n options: {\n colorize: true,\n translateTime: 'SYS:HH:MM:ss.l',\n singleLine: true,\n ignore: 'pid,hostname,component',\n messageFormat: '{if component}[{component}] {end}{msg}',\n },\n },\n }\n : {}),\n})\n\n// ── LoggerProvider interface ───────────────────────────────────────────\n\n/**\n * Pluggable logger backend.\n *\n * Implement this interface to replace the default pino-based logging\n * with any logging library (winston, bunyan, console, etc.).\n */\nexport interface LoggerProvider {\n info(msg: string, ...args: any[]): void\n warn(msg: string, ...args: any[]): void\n error(msg: string, ...args: any[]): void\n debug(msg: string, ...args: any[]): void\n trace?(msg: string, ...args: any[]): void\n fatal?(msg: string, ...args: any[]): void\n /** Return a child provider scoped to the given component name */\n child(bindings: { component: string }): LoggerProvider\n}\n\n// ── PinoLoggerProvider (default) ───────────────────────────────────────\n\n/** Default provider that delegates to the root pino instance */\nclass PinoLoggerProvider implements LoggerProvider {\n private log: pino.Logger\n\n constructor(pinoInstance?: pino.Logger) {\n this.log = pinoInstance ?? rootLogger\n }\n\n info(msg: string, ...args: any[]) {\n this.log.info(msg, ...args)\n }\n warn(msg: string, ...args: any[]) {\n this.log.warn(msg, ...args)\n }\n error(msg: string, ...args: any[]) {\n this.log.error(msg, ...args)\n }\n debug(msg: string, ...args: any[]) {\n this.log.debug(msg, ...args)\n }\n trace(msg: string, ...args: any[]) {\n this.log.trace(msg, ...args)\n }\n fatal(msg: string, ...args: any[]) {\n this.log.fatal(msg, ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new PinoLoggerProvider(this.log.child(bindings))\n }\n}\n\n// ── ConsoleLoggerProvider ──────────────────────────────────────────────\n\n/**\n * Built-in fallback provider that uses `console.*` methods.\n * Useful for environments where pino is unavailable or undesired.\n */\nexport class ConsoleLoggerProvider implements LoggerProvider {\n private prefix: string\n\n constructor(prefix?: string) {\n this.prefix = prefix ?? ''\n }\n\n private fmt(msg: string): string {\n return this.prefix ? `[${this.prefix}] ${msg}` : msg\n }\n\n info(msg: string, ...args: any[]) {\n console.log(this.fmt(msg), ...args)\n }\n warn(msg: string, ...args: any[]) {\n console.warn(this.fmt(msg), ...args)\n }\n error(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n debug(msg: string, ...args: any[]) {\n console.debug(this.fmt(msg), ...args)\n }\n trace(msg: string, ...args: any[]) {\n console.trace(this.fmt(msg), ...args)\n }\n fatal(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new ConsoleLoggerProvider(bindings.component)\n }\n}\n\n// ── Active provider ────────────────────────────────────────────────────\n\nlet activeProvider: LoggerProvider = new PinoLoggerProvider()\n\n/** Cache of named loggers to avoid creating duplicates */\nconst loggerCache = new Map<string, Logger>()\n\n/**\n * Named logger with component context.\n *\n * @example\n * ```ts\n * // Static factory — preferred\n * const log = Logger.for('UserService')\n * log.info('User created')\n * // Output: [UserService] User created\n *\n * // Shorthand function\n * const log = createLogger('OrderService')\n *\n * // Pluggable backend\n * Logger.setProvider(new ConsoleLoggerProvider())\n *\n * // Injectable — auto-named from class\n * class MyService {\n * @Autowired() private logger!: Logger\n * // or inject a named one:\n * private log = Logger.for('MyService')\n * }\n * ```\n */\nexport class Logger {\n private _provider: LoggerProvider\n private _providerVersion: number\n private _name?: string\n\n /**\n * Optional context provider for request-scoped log enrichment.\n * Set by the HTTP package to inject requestId from AsyncLocalStorage.\n * Returns extra fields to merge into every log call, or null if outside a request.\n */\n static _contextProvider: (() => Record<string, any> | null) | null = null\n\n /** Incremented on every setProvider/resetProvider so instances know to refresh */\n private static _providerVersion = 0\n\n constructor(name?: string) {\n this._name = name\n this._providerVersion = Logger._providerVersion\n this._provider = name ? activeProvider.child({ component: name }) : activeProvider\n }\n\n /** Re-derive the provider if setProvider() was called since construction/last access */\n private get provider(): LoggerProvider {\n if (this._providerVersion !== Logger._providerVersion) {\n this._providerVersion = Logger._providerVersion\n this._provider = this._name ? activeProvider.child({ component: this._name }) : activeProvider\n }\n return this._provider\n }\n\n /**\n * Replace the logging backend for **all** Logger instances created after\n * this call. Clears the logger cache so subsequent `Logger.for()` calls\n * pick up the new provider.\n *\n * @example\n * ```ts\n * Logger.setProvider(new ConsoleLoggerProvider())\n * ```\n */\n static setProvider(provider: LoggerProvider): void {\n activeProvider = provider\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Return the currently active provider (useful for testing) */\n static getProvider(): LoggerProvider {\n return activeProvider\n }\n\n /**\n * Reset the provider back to the default pino-based implementation.\n * Primarily intended for test teardown.\n */\n static resetProvider(): void {\n activeProvider = new PinoLoggerProvider()\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Create or retrieve a cached named logger */\n static for(name: string): Logger {\n let cached = loggerCache.get(name)\n if (!cached) {\n cached = new Logger(name)\n loggerCache.set(name, cached)\n }\n return cached\n }\n\n /** Create a child logger with a sub-component name */\n child(name: string): Logger {\n return new Logger(name)\n }\n\n /** Get request context (requestId, etc.) if inside a request */\n private ctx(): Record<string, any> | undefined {\n return Logger._contextProvider?.() ?? undefined\n }\n\n info(msg: string, ...args: any[]) {\n this.provider.info(msg, ...args)\n }\n\n warn(msg: string, ...args: any[]) {\n this.provider.warn(msg, ...args)\n }\n\n error(msgOrObj: any, msg?: string, ...args: any[]) {\n if (typeof msgOrObj === 'string') {\n this.provider.error(msgOrObj)\n } else if (msg) {\n this.provider.error(msg, ...args)\n } else {\n this.provider.error(String(msgOrObj))\n }\n }\n\n debug(msg: string, ...args: any[]) {\n this.provider.debug(msg, ...args)\n }\n\n trace(msg: string, ...args: any[]) {\n this.provider.trace ? this.provider.trace(msg, ...args) : this.provider.debug(msg, ...args)\n }\n\n fatal(msg: string, ...args: any[]) {\n this.provider.fatal ? this.provider.fatal(msg, ...args) : this.provider.error(msg, ...args)\n }\n}\n\n/** Shorthand for Logger.for(name) */\nexport function createLogger(name: string): Logger {\n return Logger.for(name)\n}\n\n/** @deprecated Use rootLogger instead */\nexport const logger = rootLogger\n"],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+
2
+ import { n as normalizePath, t as joinPaths } from "../path-Dq5V-i-x.mjs";
3
+ export { joinPaths, normalizePath };
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @forinda/kickjs v2.2.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ //#region src/core/path.ts
12
+ /**
13
+ * Normalize a URL path segment:
14
+ * - '/' or '' or undefined → ''
15
+ * - Ensures leading '/' if non-empty
16
+ * - Strips trailing '/'
17
+ * - Collapses consecutive '//' into single '/'
18
+ */
19
+ function normalizePath(path) {
20
+ let p = path?.trim() || "";
21
+ if (p === "/") return "";
22
+ if (p && !p.startsWith("/")) p = `/${p}`;
23
+ p = p.replace(/\/+$/, "");
24
+ p = p.replace(/\/\/+/g, "/");
25
+ return p;
26
+ }
27
+ /**
28
+ * Join path segments into a single normalized path.
29
+ * Handles leading/trailing slashes and prevents double slashes.
30
+ *
31
+ * @example
32
+ * joinPaths('/api/v1', '/users') // '/api/v1/users'
33
+ * joinPaths('/api/v1/', '/users') // '/api/v1/users'
34
+ * joinPaths('/api/v1', '/') // '/api/v1'
35
+ * joinPaths('/api/v1', '') // '/api/v1'
36
+ * joinPaths('/api/v1', 'users') // '/api/v1/users'
37
+ */
38
+ function joinPaths(...segments) {
39
+ const normalized = ("/" + segments.map((s) => s?.trim() || "").filter(Boolean).join("/")).replace(/\/\/+/g, "/");
40
+ return normalized === "/" ? "/" : normalized.replace(/\/+$/, "");
41
+ }
42
+ //#endregion
43
+ export { joinPaths, normalizePath };
44
+
45
+ //# sourceMappingURL=path.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"path.mjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["/**\n * Normalize a URL path segment:\n * - '/' or '' or undefined → ''\n * - Ensures leading '/' if non-empty\n * - Strips trailing '/'\n * - Collapses consecutive '//' into single '/'\n */\nexport function normalizePath(path?: string): string {\n let p = path?.trim() || ''\n if (p === '/') return ''\n if (p && !p.startsWith('/')) p = `/${p}`\n // Strip trailing slash\n p = p.replace(/\\/+$/, '')\n // Collapse double slashes\n p = p.replace(/\\/\\/+/g, '/')\n return p\n}\n\n/**\n * Join path segments into a single normalized path.\n * Handles leading/trailing slashes and prevents double slashes.\n *\n * @example\n * joinPaths('/api/v1', '/users') // '/api/v1/users'\n * joinPaths('/api/v1/', '/users') // '/api/v1/users'\n * joinPaths('/api/v1', '/') // '/api/v1'\n * joinPaths('/api/v1', '') // '/api/v1'\n * joinPaths('/api/v1', 'users') // '/api/v1/users'\n */\nexport function joinPaths(...segments: (string | undefined)[]): string {\n const joined = segments\n .map((s) => s?.trim() || '')\n .filter(Boolean)\n .join('/')\n // Ensure leading slash, collapse doubles\n const normalized = ('/' + joined).replace(/\\/\\/+/g, '/')\n // Strip trailing slash (unless it's just '/')\n return normalized === '/' ? '/' : normalized.replace(/\\/+$/, '')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAOA,SAAgB,cAAc,MAAuB;CACnD,IAAI,IAAI,MAAM,MAAM,IAAI;AACxB,KAAI,MAAM,IAAK,QAAO;AACtB,KAAI,KAAK,CAAC,EAAE,WAAW,IAAI,CAAE,KAAI,IAAI;AAErC,KAAI,EAAE,QAAQ,QAAQ,GAAG;AAEzB,KAAI,EAAE,QAAQ,UAAU,IAAI;AAC5B,QAAO;;;;;;;;;;;;;AAcT,SAAgB,UAAU,GAAG,UAA0C;CAMrE,MAAM,cAAc,MALL,SACZ,KAAK,MAAM,GAAG,MAAM,IAAI,GAAG,CAC3B,OAAO,QAAQ,CACf,KAAK,IAAI,EAEsB,QAAQ,UAAU,IAAI;AAExD,QAAO,eAAe,MAAM,MAAM,WAAW,QAAQ,QAAQ,GAAG"}
@@ -0,0 +1,3 @@
1
+
2
+ import { t as KickPlugin } from "../plugin-D20muJwC.mjs";
3
+ export { KickPlugin };
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @forinda/kickjs v2.2.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ export {};
@@ -0,0 +1,3 @@
1
+
2
+ import { a as isRef, c as toRefs, i as computed, l as unref, n as Ref, o as reactive, r as WatchOptions, s as ref, t as ComputedRef, u as watch } from "../reactivity-CMAQh0gi.mjs";
3
+ export { ComputedRef, Ref, WatchOptions, computed, isRef, reactive, ref, toRefs, unref, watch };
@@ -0,0 +1,189 @@
1
+ /**
2
+ * @forinda/kickjs v2.2.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ //#region src/core/reactivity.ts
12
+ let activeEffect = null;
13
+ const targetMap = /* @__PURE__ */ new WeakMap();
14
+ function track(target, key) {
15
+ if (!activeEffect) return;
16
+ let depsMap = targetMap.get(target);
17
+ if (!depsMap) {
18
+ depsMap = /* @__PURE__ */ new Map();
19
+ targetMap.set(target, depsMap);
20
+ }
21
+ let deps = depsMap.get(key);
22
+ if (!deps) {
23
+ deps = /* @__PURE__ */ new Set();
24
+ depsMap.set(key, deps);
25
+ }
26
+ deps.add(activeEffect);
27
+ }
28
+ function trigger(target, key) {
29
+ const depsMap = targetMap.get(target);
30
+ if (!depsMap) return;
31
+ const deps = depsMap.get(key);
32
+ if (!deps) return;
33
+ for (const effect of deps) effect();
34
+ }
35
+ /**
36
+ * Create a reactive reference. Reading `.value` tracks the dependency,
37
+ * writing `.value` triggers watchers and computed recalculations.
38
+ *
39
+ * @example
40
+ * ```ts
41
+ * const count = ref(0)
42
+ * count.value++ // triggers watchers
43
+ * ```
44
+ */
45
+ function ref(initialValue) {
46
+ const subscribers = /* @__PURE__ */ new Set();
47
+ const wrapper = { _value: initialValue };
48
+ return {
49
+ get value() {
50
+ track(wrapper, "_value");
51
+ return wrapper._value;
52
+ },
53
+ set value(newValue) {
54
+ const oldValue = wrapper._value;
55
+ if (Object.is(oldValue, newValue)) return;
56
+ wrapper._value = newValue;
57
+ trigger(wrapper, "_value");
58
+ for (const fn of subscribers) fn(newValue, oldValue);
59
+ },
60
+ subscribe(fn) {
61
+ subscribers.add(fn);
62
+ return () => subscribers.delete(fn);
63
+ }
64
+ };
65
+ }
66
+ /**
67
+ * Create a computed value that auto-recalculates when its reactive
68
+ * dependencies change. Cached until a dependency triggers.
69
+ *
70
+ * @example
71
+ * ```ts
72
+ * const count = ref(0)
73
+ * const doubled = computed(() => count.value * 2)
74
+ * count.value = 5
75
+ * console.log(doubled.value) // 10
76
+ * ```
77
+ */
78
+ function computed(getter) {
79
+ let cached;
80
+ let dirty = true;
81
+ const wrapper = { _value: void 0 };
82
+ const effect = () => {
83
+ dirty = true;
84
+ trigger(wrapper, "_value");
85
+ };
86
+ return { get value() {
87
+ track(wrapper, "_value");
88
+ if (dirty) {
89
+ const prev = activeEffect;
90
+ activeEffect = effect;
91
+ try {
92
+ cached = getter();
93
+ } finally {
94
+ activeEffect = prev;
95
+ }
96
+ wrapper._value = cached;
97
+ dirty = false;
98
+ }
99
+ return cached;
100
+ } };
101
+ }
102
+ /**
103
+ * Watch a reactive source and run a callback when it changes.
104
+ * Returns a stop function to unsubscribe.
105
+ *
106
+ * @example
107
+ * ```ts
108
+ * const count = ref(0)
109
+ * const stop = watch(count, (newVal, oldVal) => {
110
+ * console.log(`Changed from ${oldVal} to ${newVal}`)
111
+ * })
112
+ * count.value = 1 // logs: "Changed from 0 to 1"
113
+ * stop() // no more callbacks
114
+ * ```
115
+ */
116
+ function watch(source, callback, options) {
117
+ let oldValue;
118
+ let stopped = false;
119
+ const getter = typeof source === "function" ? source : () => source.value;
120
+ const job = () => {
121
+ if (stopped) return;
122
+ const newValue = getter();
123
+ if (!Object.is(newValue, oldValue)) {
124
+ callback(newValue, oldValue);
125
+ oldValue = newValue;
126
+ }
127
+ };
128
+ const prev = activeEffect;
129
+ activeEffect = job;
130
+ try {
131
+ oldValue = getter();
132
+ } finally {
133
+ activeEffect = prev;
134
+ }
135
+ if (options?.immediate) callback(oldValue, void 0);
136
+ return () => {
137
+ stopped = true;
138
+ };
139
+ }
140
+ /**
141
+ * Create a deeply reactive proxy around a plain object. Property reads
142
+ * are tracked, property writes trigger watchers and computed recalculations.
143
+ *
144
+ * @example
145
+ * ```ts
146
+ * const state = reactive({ users: 0, errors: 0 })
147
+ * const errorRate = computed(() =>
148
+ * state.users > 0 ? state.errors / state.users : 0
149
+ * )
150
+ * state.users = 100
151
+ * state.errors = 5
152
+ * console.log(errorRate.value) // 0.05
153
+ * ```
154
+ */
155
+ function reactive(target) {
156
+ return new Proxy(target, {
157
+ get(obj, key, receiver) {
158
+ const value = Reflect.get(obj, key, receiver);
159
+ if (typeof key === "symbol") return value;
160
+ track(obj, key);
161
+ if (value !== null && typeof value === "object" && !Array.isArray(value)) return reactive(value);
162
+ return value;
163
+ },
164
+ set(obj, key, value, receiver) {
165
+ const oldValue = Reflect.get(obj, key, receiver);
166
+ const result = Reflect.set(obj, key, value, receiver);
167
+ if (!Object.is(oldValue, value) && typeof key !== "symbol") trigger(obj, key);
168
+ return result;
169
+ }
170
+ });
171
+ }
172
+ /** Check if a value is a Ref */
173
+ function isRef(value) {
174
+ return value !== null && typeof value === "object" && "subscribe" in value && "value" in value;
175
+ }
176
+ /** Unwrap a ref or return the value as-is */
177
+ function unref(value) {
178
+ return isRef(value) ? value.value : value;
179
+ }
180
+ /** Convert all properties of an object to refs */
181
+ function toRefs(obj) {
182
+ const result = {};
183
+ for (const key in obj) result[key] = ref(obj[key]);
184
+ return result;
185
+ }
186
+ //#endregion
187
+ export { computed, isRef, reactive, ref, toRefs, unref, watch };
188
+
189
+ //# sourceMappingURL=reactivity.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reactivity.mjs","names":[],"sources":["../../src/core/reactivity.ts"],"sourcesContent":["/**\n * Lightweight reactivity system inspired by Vue 3's composition API.\n * Provides ref(), computed(), watch(), and reactive() for observable\n * backend state — config, metrics, health, circuit breakers.\n */\n\n// ── Dependency Tracking ─────────────────────────────────────────────────\n\ntype Effect = () => void\nlet activeEffect: Effect | null = null\nconst targetMap = new WeakMap<object, Map<string | symbol, Set<Effect>>>()\n\nfunction track(target: object, key: string | symbol): void {\n if (!activeEffect) return\n let depsMap = targetMap.get(target)\n if (!depsMap) {\n depsMap = new Map()\n targetMap.set(target, depsMap)\n }\n let deps = depsMap.get(key)\n if (!deps) {\n deps = new Set()\n depsMap.set(key, deps)\n }\n deps.add(activeEffect)\n}\n\nfunction trigger(target: object, key: string | symbol): void {\n const depsMap = targetMap.get(target)\n if (!depsMap) return\n const deps = depsMap.get(key)\n if (!deps) return\n for (const effect of deps) {\n effect()\n }\n}\n\n// ── ref() ────────────────────────────────────────────────────────────────\n\nexport interface Ref<T = any> {\n value: T\n /** Subscribe to changes. Returns unsubscribe function. */\n subscribe(fn: (newValue: T, oldValue: T) => void): () => void\n}\n\n/**\n * Create a reactive reference. Reading `.value` tracks the dependency,\n * writing `.value` triggers watchers and computed recalculations.\n *\n * @example\n * ```ts\n * const count = ref(0)\n * count.value++ // triggers watchers\n * ```\n */\nexport function ref<T>(initialValue: T): Ref<T> {\n const subscribers = new Set<(newValue: T, oldValue: T) => void>()\n const wrapper = { _value: initialValue }\n\n return {\n get value(): T {\n track(wrapper, '_value')\n return wrapper._value\n },\n set value(newValue: T) {\n const oldValue = wrapper._value\n if (Object.is(oldValue, newValue)) return\n wrapper._value = newValue\n trigger(wrapper, '_value')\n for (const fn of subscribers) {\n fn(newValue, oldValue)\n }\n },\n subscribe(fn: (newValue: T, oldValue: T) => void): () => void {\n subscribers.add(fn)\n return () => subscribers.delete(fn)\n },\n }\n}\n\n// ── computed() ───────────────────────────────────────────────────────────\n\nexport interface ComputedRef<T = any> {\n readonly value: T\n}\n\n/**\n * Create a computed value that auto-recalculates when its reactive\n * dependencies change. Cached until a dependency triggers.\n *\n * @example\n * ```ts\n * const count = ref(0)\n * const doubled = computed(() => count.value * 2)\n * count.value = 5\n * console.log(doubled.value) // 10\n * ```\n */\nexport function computed<T>(getter: () => T): ComputedRef<T> {\n let cached: T\n let dirty = true\n const wrapper = { _value: undefined as T }\n\n const effect: Effect = () => {\n dirty = true\n trigger(wrapper, '_value')\n }\n\n return {\n get value(): T {\n track(wrapper, '_value')\n if (dirty) {\n const prev = activeEffect\n activeEffect = effect\n try {\n cached = getter()\n } finally {\n activeEffect = prev\n }\n wrapper._value = cached\n dirty = false\n }\n return cached\n },\n }\n}\n\n// ── watch() ──────────────────────────────────────────────────────────────\n\nexport interface WatchOptions {\n /** Run the callback immediately with the current value (default: false) */\n immediate?: boolean\n}\n\ntype WatchSource<T> = Ref<T> | ComputedRef<T> | (() => T)\n\n/**\n * Watch a reactive source and run a callback when it changes.\n * Returns a stop function to unsubscribe.\n *\n * @example\n * ```ts\n * const count = ref(0)\n * const stop = watch(count, (newVal, oldVal) => {\n * console.log(`Changed from ${oldVal} to ${newVal}`)\n * })\n * count.value = 1 // logs: \"Changed from 0 to 1\"\n * stop() // no more callbacks\n * ```\n */\nexport function watch<T>(\n source: WatchSource<T>,\n callback: (newValue: T, oldValue: T) => void,\n options?: WatchOptions,\n): () => void {\n let oldValue: T\n let stopped = false\n\n const getter = typeof source === 'function' ? source : () => source.value\n\n const job: Effect = () => {\n if (stopped) return\n const newValue = getter()\n if (!Object.is(newValue, oldValue)) {\n callback(newValue, oldValue)\n oldValue = newValue\n }\n }\n\n // Initial run to establish tracking\n const prev = activeEffect\n activeEffect = job\n try {\n oldValue = getter()\n } finally {\n activeEffect = prev\n }\n\n if (options?.immediate) {\n callback(oldValue, undefined as T)\n }\n\n return () => {\n stopped = true\n }\n}\n\n// ── reactive() ───────────────────────────────────────────────────────────\n\n/**\n * Create a deeply reactive proxy around a plain object. Property reads\n * are tracked, property writes trigger watchers and computed recalculations.\n *\n * @example\n * ```ts\n * const state = reactive({ users: 0, errors: 0 })\n * const errorRate = computed(() =>\n * state.users > 0 ? state.errors / state.users : 0\n * )\n * state.users = 100\n * state.errors = 5\n * console.log(errorRate.value) // 0.05\n * ```\n */\nexport function reactive<T extends Record<string, any>>(target: T): T {\n return new Proxy(target, {\n get(obj, key, receiver) {\n const value = Reflect.get(obj, key, receiver)\n if (typeof key === 'symbol') return value\n track(obj, key)\n // Deep reactivity for nested objects\n if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n return reactive(value)\n }\n return value\n },\n set(obj, key, value, receiver) {\n const oldValue = Reflect.get(obj, key, receiver)\n const result = Reflect.set(obj, key, value, receiver)\n if (!Object.is(oldValue, value) && typeof key !== 'symbol') {\n trigger(obj, key)\n }\n return result\n },\n })\n}\n\n// ── Utility ──────────────────────────────────────────────────────────────\n\n/** Check if a value is a Ref */\nexport function isRef(value: any): value is Ref {\n return value !== null && typeof value === 'object' && 'subscribe' in value && 'value' in value\n}\n\n/** Unwrap a ref or return the value as-is */\nexport function unref<T>(value: Ref<T> | T): T {\n return isRef(value) ? value.value : value\n}\n\n/** Convert all properties of an object to refs */\nexport function toRefs<T extends Record<string, any>>(obj: T): { [K in keyof T]: Ref<T[K]> } {\n const result = {} as any\n for (const key in obj) {\n result[key] = ref(obj[key])\n }\n return result\n}\n"],"mappings":"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"}
@@ -0,0 +1,121 @@
1
+ /**
2
+ * @forinda/kickjs v2.2.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ import "./core/interfaces.mjs";
12
+ import "./core/logger.mjs";
13
+ import "./metadata-BqXgNTOf.mjs";
14
+ import "./container-B7jFEbPE.mjs";
15
+ import "./core/decorators.mjs";
16
+ import "./core/cron.mjs";
17
+ import "./core/cache.mjs";
18
+ import "reflect-metadata";
19
+ //#region src/core/circuit-breaker.ts
20
+ /**
21
+ * Error thrown when the circuit is open and calls are being rejected.
22
+ */
23
+ var CircuitOpenError = class extends Error {
24
+ constructor(breakerName) {
25
+ super(`Circuit breaker "${breakerName}" is open — request rejected`);
26
+ this.breakerName = breakerName;
27
+ this.name = "CircuitOpenError";
28
+ }
29
+ };
30
+ var CircuitBreaker = class {
31
+ state = "closed";
32
+ failures = 0;
33
+ successes = 0;
34
+ halfOpenAttempts = 0;
35
+ lastFailure;
36
+ openedAt;
37
+ failureThreshold;
38
+ resetTimeout;
39
+ halfOpenMax;
40
+ constructor(name, options) {
41
+ this.name = name;
42
+ this.failureThreshold = options.failureThreshold;
43
+ this.resetTimeout = options.resetTimeout;
44
+ this.halfOpenMax = options.halfOpenMax ?? 1;
45
+ }
46
+ /**
47
+ * Execute an async function through the circuit breaker.
48
+ * Throws `CircuitOpenError` if the circuit is open.
49
+ */
50
+ async execute(fn) {
51
+ this.maybeTransitionToHalfOpen();
52
+ if (this.state === "open") throw new CircuitOpenError(this.name);
53
+ if (this.state === "half_open" && this.halfOpenAttempts >= this.halfOpenMax) throw new CircuitOpenError(this.name);
54
+ if (this.state === "half_open") this.halfOpenAttempts++;
55
+ try {
56
+ const result = await fn();
57
+ this.onSuccess();
58
+ return result;
59
+ } catch (error) {
60
+ this.onFailure();
61
+ throw error;
62
+ }
63
+ }
64
+ /** Returns the current circuit state. */
65
+ getState() {
66
+ this.maybeTransitionToHalfOpen();
67
+ return this.state;
68
+ }
69
+ /** Returns current statistics. */
70
+ getStats() {
71
+ this.maybeTransitionToHalfOpen();
72
+ return {
73
+ failures: this.failures,
74
+ successes: this.successes,
75
+ state: this.state,
76
+ ...this.lastFailure ? { lastFailure: this.lastFailure } : {}
77
+ };
78
+ }
79
+ /** Manually reset the circuit breaker to CLOSED state. */
80
+ reset() {
81
+ this.state = "closed";
82
+ this.failures = 0;
83
+ this.successes = 0;
84
+ this.halfOpenAttempts = 0;
85
+ this.lastFailure = void 0;
86
+ this.openedAt = void 0;
87
+ }
88
+ onSuccess() {
89
+ if (this.state === "half_open") {
90
+ this.state = "closed";
91
+ this.failures = 0;
92
+ this.halfOpenAttempts = 0;
93
+ this.openedAt = void 0;
94
+ }
95
+ this.successes++;
96
+ }
97
+ onFailure() {
98
+ this.failures++;
99
+ this.lastFailure = /* @__PURE__ */ new Date();
100
+ if (this.state === "half_open") {
101
+ this.state = "open";
102
+ this.openedAt = Date.now();
103
+ this.halfOpenAttempts = 0;
104
+ } else if (this.state === "closed" && this.failures >= this.failureThreshold) {
105
+ this.state = "open";
106
+ this.openedAt = Date.now();
107
+ }
108
+ }
109
+ maybeTransitionToHalfOpen() {
110
+ if (this.state === "open" && this.openedAt != null) {
111
+ if (Date.now() - this.openedAt >= this.resetTimeout) {
112
+ this.state = "half_open";
113
+ this.halfOpenAttempts = 0;
114
+ }
115
+ }
116
+ }
117
+ };
118
+ //#endregion
119
+ export { CircuitOpenError as n, CircuitBreaker as t };
120
+
121
+ //# sourceMappingURL=core-CMgIoRvg.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core-CMgIoRvg.mjs","names":[],"sources":["../src/core/circuit-breaker.ts"],"sourcesContent":["/**\n * Circuit Breaker pattern for external service calls.\n *\n * Protects your application from cascading failures when downstream\n * services are unhealthy by short-circuiting requests after a\n * configurable failure threshold.\n *\n * @example\n * ```ts\n * const breaker = new CircuitBreaker('payment-api', {\n * failureThreshold: 5,\n * resetTimeout: 30_000,\n * })\n *\n * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))\n * ```\n */\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half_open'\n\nexport interface CircuitBreakerOptions {\n /** Number of consecutive failures before the circuit opens. */\n failureThreshold: number\n /** Milliseconds to wait before transitioning from OPEN to HALF_OPEN. */\n resetTimeout: number\n /** Max requests allowed in HALF_OPEN state before deciding (default 1). */\n halfOpenMax?: number\n}\n\nexport interface CircuitBreakerStats {\n failures: number\n successes: number\n state: CircuitBreakerState\n lastFailure?: Date\n}\n\n/**\n * Error thrown when the circuit is open and calls are being rejected.\n */\nexport class CircuitOpenError extends Error {\n constructor(public readonly breakerName: string) {\n super(`Circuit breaker \"${breakerName}\" is open — request rejected`)\n this.name = 'CircuitOpenError'\n }\n}\n\nexport class CircuitBreaker {\n private state: CircuitBreakerState = 'closed'\n private failures = 0\n private successes = 0\n private halfOpenAttempts = 0\n private lastFailure?: Date\n private openedAt?: number\n\n private readonly failureThreshold: number\n private readonly resetTimeout: number\n private readonly halfOpenMax: number\n\n constructor(\n public readonly name: string,\n options: CircuitBreakerOptions,\n ) {\n this.failureThreshold = options.failureThreshold\n this.resetTimeout = options.resetTimeout\n this.halfOpenMax = options.halfOpenMax ?? 1\n }\n\n /**\n * Execute an async function through the circuit breaker.\n * Throws `CircuitOpenError` if the circuit is open.\n */\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n this.maybeTransitionToHalfOpen()\n\n if (this.state === 'open') {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open' && this.halfOpenAttempts >= this.halfOpenMax) {\n throw new CircuitOpenError(this.name)\n }\n\n if (this.state === 'half_open') {\n this.halfOpenAttempts++\n }\n\n try {\n const result = await fn()\n this.onSuccess()\n return result\n } catch (error) {\n this.onFailure()\n throw error\n }\n }\n\n /** Returns the current circuit state. */\n getState(): CircuitBreakerState {\n this.maybeTransitionToHalfOpen()\n return this.state\n }\n\n /** Returns current statistics. */\n getStats(): CircuitBreakerStats {\n this.maybeTransitionToHalfOpen()\n return {\n failures: this.failures,\n successes: this.successes,\n state: this.state,\n ...(this.lastFailure ? { lastFailure: this.lastFailure } : {}),\n }\n }\n\n /** Manually reset the circuit breaker to CLOSED state. */\n reset(): void {\n this.state = 'closed'\n this.failures = 0\n this.successes = 0\n this.halfOpenAttempts = 0\n this.lastFailure = undefined\n this.openedAt = undefined\n }\n\n private onSuccess(): void {\n if (this.state === 'half_open') {\n // Recovery confirmed — close the circuit\n this.state = 'closed'\n this.failures = 0\n this.halfOpenAttempts = 0\n this.openedAt = undefined\n }\n this.successes++\n }\n\n private onFailure(): void {\n this.failures++\n this.lastFailure = new Date()\n\n if (this.state === 'half_open') {\n // Recovery failed — re-open\n this.state = 'open'\n this.openedAt = Date.now()\n this.halfOpenAttempts = 0\n } else if (this.state === 'closed' && this.failures >= this.failureThreshold) {\n this.state = 'open'\n this.openedAt = Date.now()\n }\n }\n\n private maybeTransitionToHalfOpen(): void {\n if (this.state === 'open' && this.openedAt != null) {\n if (Date.now() - this.openedAt >= this.resetTimeout) {\n this.state = 'half_open'\n this.halfOpenAttempts = 0\n }\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,aAAqC;AAC/C,QAAM,oBAAoB,YAAY,8BAA8B;AAD1C,OAAA,cAAA;AAE1B,OAAK,OAAO;;;AAIhB,IAAa,iBAAb,MAA4B;CAC1B,QAAqC;CACrC,WAAmB;CACnB,YAAoB;CACpB,mBAA2B;CAC3B;CACA;CAEA;CACA;CACA;CAEA,YACE,MACA,SACA;AAFgB,OAAA,OAAA;AAGhB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,eAAe,QAAQ;AAC5B,OAAK,cAAc,QAAQ,eAAe;;;;;;CAO5C,MAAM,QAAW,IAAkC;AACjD,OAAK,2BAA2B;AAEhC,MAAI,KAAK,UAAU,OACjB,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,eAAe,KAAK,oBAAoB,KAAK,YAC9D,OAAM,IAAI,iBAAiB,KAAK,KAAK;AAGvC,MAAI,KAAK,UAAU,YACjB,MAAK;AAGP,MAAI;GACF,MAAM,SAAS,MAAM,IAAI;AACzB,QAAK,WAAW;AAChB,UAAO;WACA,OAAO;AACd,QAAK,WAAW;AAChB,SAAM;;;;CAKV,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO,KAAK;;;CAId,WAAgC;AAC9B,OAAK,2BAA2B;AAChC,SAAO;GACL,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;GAC9D;;;CAIH,QAAc;AACZ,OAAK,QAAQ;AACb,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,mBAAmB;AACxB,OAAK,cAAc,KAAA;AACnB,OAAK,WAAW,KAAA;;CAGlB,YAA0B;AACxB,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW;AAChB,QAAK,mBAAmB;AACxB,QAAK,WAAW,KAAA;;AAElB,OAAK;;CAGP,YAA0B;AACxB,OAAK;AACL,OAAK,8BAAc,IAAI,MAAM;AAE7B,MAAI,KAAK,UAAU,aAAa;AAE9B,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;AAC1B,QAAK,mBAAmB;aACf,KAAK,UAAU,YAAY,KAAK,YAAY,KAAK,kBAAkB;AAC5E,QAAK,QAAQ;AACb,QAAK,WAAW,KAAK,KAAK;;;CAI9B,4BAA0C;AACxC,MAAI,KAAK,UAAU,UAAU,KAAK,YAAY;OACxC,KAAK,KAAK,GAAG,KAAK,YAAY,KAAK,cAAc;AACnD,SAAK,QAAQ;AACb,SAAK,mBAAmB"}
@@ -1,11 +1,12 @@
1
- import 'reflect-metadata';
1
+
2
+ //#region src/core/cron.d.ts
2
3
  declare const CRON_META: unique symbol;
3
- export interface CronJobMeta {
4
- expression: string;
5
- handlerName: string;
6
- description?: string;
7
- timezone?: string;
8
- runOnInit?: boolean;
4
+ interface CronJobMeta {
5
+ expression: string;
6
+ handlerName: string;
7
+ description?: string;
8
+ timezone?: string;
9
+ runOnInit?: boolean;
9
10
  }
10
11
  /**
11
12
  * Schedule a method to run on a cron expression.
@@ -17,12 +18,13 @@ export interface CronJobMeta {
17
18
  * @param options.timezone - IANA timezone (e.g. 'America/New_York', 'UTC')
18
19
  * @param options.runOnInit - Run immediately on startup before first scheduled tick
19
20
  */
20
- export declare function Cron(expression: string, options?: {
21
- description?: string;
22
- timezone?: string;
23
- runOnInit?: boolean;
21
+ declare function Cron(expression: string, options?: {
22
+ description?: string;
23
+ timezone?: string;
24
+ runOnInit?: boolean;
24
25
  }): MethodDecorator;
25
26
  /** Read cron jobs registered on a class */
26
- export declare function getCronJobs(target: any): CronJobMeta[];
27
- export { CRON_META };
28
- //# sourceMappingURL=cron.d.ts.map
27
+ declare function getCronJobs(target: any): CronJobMeta[];
28
+ //#endregion
29
+ export { getCronJobs as i, Cron as n, CronJobMeta as r, CRON_META as t };
30
+ //# sourceMappingURL=cron-C29iHvHT.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cron-C29iHvHT.d.mts","names":[],"sources":["../src/core/cron.ts"],"mappings":";;cAEM,SAAA;AAAA,UAEW,WAAA;EACf,UAAA;EACA,WAAA;EACA,WAAA;EACA,QAAA;EACA,SAAA;AAAA;;;;;;;;;;AAqBF;iBAAgB,IAAA,CACd,UAAA,UACA,OAAA;EAAY,WAAA;EAAsB,QAAA;EAAmB,SAAA;AAAA,IACpD,eAAA;;iBAaa,WAAA,CAAY,MAAA,QAAc,WAAA"}