@forinda/kickjs 5.3.0 → 5.5.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 (122) hide show
  1. package/dist/{adapter-C1w_xt08.d.mts → adapter-0r2uRCD3.d.mts} +2 -2
  2. package/dist/{adapter-C1w_xt08.d.mts.map → adapter-0r2uRCD3.d.mts.map} +1 -1
  3. package/dist/app-module-CzlIIjO3.d.mts +92 -0
  4. package/dist/app-module-CzlIIjO3.d.mts.map +1 -0
  5. package/dist/{application-BTRI4aBd.d.mts → application-CaEYca9E.d.mts} +34 -7
  6. package/dist/application-CaEYca9E.d.mts.map +1 -0
  7. package/dist/application-Zt956jNS.mjs +12 -0
  8. package/dist/application-Zt956jNS.mjs.map +1 -0
  9. package/dist/bootstrap-CmFQq1ar.mjs +12 -0
  10. package/dist/{bootstrap-kPcmbbWe.mjs.map → bootstrap-CmFQq1ar.mjs.map} +1 -1
  11. package/dist/{bootstrap-B4YrBipl.d.mts → bootstrap-Db8k2-21.d.mts} +2 -2
  12. package/dist/{bootstrap-B4YrBipl.d.mts.map → bootstrap-Db8k2-21.d.mts.map} +1 -1
  13. package/dist/config/index.mjs +2 -4
  14. package/dist/config-DDz5LuWw.mjs +12 -0
  15. package/dist/{config-DxEREQmR.mjs.map → config-DDz5LuWw.mjs.map} +1 -1
  16. package/dist/container-DrioVLNv.mjs +12 -0
  17. package/dist/{container-SMnB5yeT.mjs.map → container-DrioVLNv.mjs.map} +1 -1
  18. package/dist/context-B4BeGq1B.mjs +12 -0
  19. package/dist/context-B4BeGq1B.mjs.map +1 -0
  20. package/dist/{context-Ymvv-85x.d.mts → context-BAdAV-zO.d.mts} +48 -11
  21. package/dist/context-BAdAV-zO.d.mts.map +1 -0
  22. package/dist/{context-decorator-Bca_BoRK.d.mts → context-decorator-BgdDd-6X.d.mts} +19 -4
  23. package/dist/{context-decorator-Bca_BoRK.d.mts.map → context-decorator-BgdDd-6X.d.mts.map} +1 -1
  24. package/dist/core/adapter.d.mts +1 -1
  25. package/dist/core/adapter.mjs +2 -2
  26. package/dist/core/app-module.d.mts +2 -2
  27. package/dist/core/app-module.mjs +2 -2
  28. package/dist/core/cache.mjs +2 -103
  29. package/dist/core/cache.mjs.map +1 -1
  30. package/dist/core/container.mjs +2 -3
  31. package/dist/core/cron.mjs +2 -32
  32. package/dist/core/cron.mjs.map +1 -1
  33. package/dist/core/decorators.mjs +2 -285
  34. package/dist/core/decorators.mjs.map +1 -1
  35. package/dist/core/errors.mjs +2 -110
  36. package/dist/core/errors.mjs.map +1 -1
  37. package/dist/core/interfaces.mjs +2 -53
  38. package/dist/core/interfaces.mjs.map +1 -1
  39. package/dist/core/logger.mjs +2 -207
  40. package/dist/core/logger.mjs.map +1 -1
  41. package/dist/core/path.mjs +2 -35
  42. package/dist/core/path.mjs.map +1 -1
  43. package/dist/core/plugin.d.mts +1 -1
  44. package/dist/core/plugin.mjs +2 -2
  45. package/dist/core/reactivity.mjs +2 -179
  46. package/dist/core/reactivity.mjs.map +1 -1
  47. package/dist/core-MvABl8Cl.mjs +13 -0
  48. package/dist/core-MvABl8Cl.mjs.map +1 -0
  49. package/dist/env-CObTuGZ3.mjs +12 -0
  50. package/dist/{env-C4Yr6nN8.mjs.map → env-CObTuGZ3.mjs.map} +1 -1
  51. package/dist/http/application.d.mts +1 -1
  52. package/dist/http/application.mjs +2 -3
  53. package/dist/http/bootstrap.d.mts +1 -1
  54. package/dist/http/bootstrap.mjs +2 -3
  55. package/dist/http/context.d.mts +2 -2
  56. package/dist/http/context.mjs +2 -3
  57. package/dist/http/middleware/cors.mjs +2 -73
  58. package/dist/http/middleware/cors.mjs.map +1 -1
  59. package/dist/http/middleware/csrf.mjs +2 -62
  60. package/dist/http/middleware/csrf.mjs.map +1 -1
  61. package/dist/http/middleware/error-handler.mjs +2 -54
  62. package/dist/http/middleware/error-handler.mjs.map +1 -1
  63. package/dist/http/middleware/helmet.mjs +2 -41
  64. package/dist/http/middleware/helmet.mjs.map +1 -1
  65. package/dist/http/middleware/rate-limit.mjs +2 -91
  66. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  67. package/dist/http/middleware/request-id.mjs +2 -25
  68. package/dist/http/middleware/request-id.mjs.map +1 -1
  69. package/dist/http/middleware/request-logger.mjs +2 -39
  70. package/dist/http/middleware/request-logger.mjs.map +1 -1
  71. package/dist/http/middleware/session.mjs +2 -167
  72. package/dist/http/middleware/session.mjs.map +1 -1
  73. package/dist/http/middleware/spa.d.mts +1 -1
  74. package/dist/http/middleware/spa.mjs +2 -98
  75. package/dist/http/middleware/spa.mjs.map +1 -1
  76. package/dist/http/middleware/upload.mjs +2 -181
  77. package/dist/http/middleware/upload.mjs.map +1 -1
  78. package/dist/http/middleware/validate.mjs +2 -68
  79. package/dist/http/middleware/validate.mjs.map +1 -1
  80. package/dist/http/middleware/views.d.mts +1 -1
  81. package/dist/http/middleware/views.mjs +2 -56
  82. package/dist/http/middleware/views.mjs.map +1 -1
  83. package/dist/http/query/index.mjs +2 -3
  84. package/dist/http/router-builder.d.mts +1 -1
  85. package/dist/http/router-builder.mjs +2 -105
  86. package/dist/http/router-builder.mjs.map +1 -1
  87. package/dist/{index-DvZfBNIf.d.mts → index-D-Wb23e6.d.mts} +264 -86
  88. package/dist/index-D-Wb23e6.d.mts.map +1 -0
  89. package/dist/index.d.mts +12 -12
  90. package/dist/index.mjs +2 -171
  91. package/dist/index.mjs.map +1 -1
  92. package/dist/metadata-WTmSU6Sf.mjs +12 -0
  93. package/dist/{metadata-CdYaU-XM.mjs.map → metadata-WTmSU6Sf.mjs.map} +1 -1
  94. package/dist/{plugin-DF8Xfv9Z.d.mts → plugin-JMkG7soG.d.mts} +102 -8
  95. package/dist/plugin-JMkG7soG.d.mts.map +1 -0
  96. package/dist/query-BmO0aBf6.mjs +12 -0
  97. package/dist/{query-nAYUgagU.mjs.map → query-BmO0aBf6.mjs.map} +1 -1
  98. package/dist/{router-builder-C7sXk_FG.d.mts → router-builder-CaQ629tw.d.mts} +2 -2
  99. package/dist/{router-builder-C7sXk_FG.d.mts.map → router-builder-CaQ629tw.d.mts.map} +1 -1
  100. package/dist/{spa-e4FIS2RB.d.mts → spa-CreyQc4N.d.mts} +2 -2
  101. package/dist/{spa-e4FIS2RB.d.mts.map → spa-CreyQc4N.d.mts.map} +1 -1
  102. package/dist/{views-DkNp9JJs.d.mts → views-1e3jQr5C.d.mts} +4 -4
  103. package/dist/{views-DkNp9JJs.d.mts.map → views-1e3jQr5C.d.mts.map} +1 -1
  104. package/package.json +2 -2
  105. package/dist/app-module-D6zL_V5S.d.mts +0 -50
  106. package/dist/app-module-D6zL_V5S.d.mts.map +0 -1
  107. package/dist/application-BTRI4aBd.d.mts.map +0 -1
  108. package/dist/application-Cna_2gex.mjs +0 -574
  109. package/dist/application-Cna_2gex.mjs.map +0 -1
  110. package/dist/bootstrap-kPcmbbWe.mjs +0 -195
  111. package/dist/config-DxEREQmR.mjs +0 -135
  112. package/dist/container-SMnB5yeT.mjs +0 -897
  113. package/dist/context-B0B3WQft.mjs +0 -348
  114. package/dist/context-B0B3WQft.mjs.map +0 -1
  115. package/dist/context-Ymvv-85x.d.mts.map +0 -1
  116. package/dist/core--a4XflX7.mjs +0 -820
  117. package/dist/core--a4XflX7.mjs.map +0 -1
  118. package/dist/env-C4Yr6nN8.mjs +0 -137
  119. package/dist/index-DvZfBNIf.d.mts.map +0 -1
  120. package/dist/metadata-CdYaU-XM.mjs +0 -76
  121. package/dist/plugin-DF8Xfv9Z.d.mts.map +0 -1
  122. package/dist/query-nAYUgagU.mjs +0 -164
@@ -1 +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 if (this.provider.trace) this.provider.trace(msg, ...args)\n else this.provider.debug(msg, ...args)\n }\n\n fatal(msg: string, ...args: any[]) {\n if (this.provider.fatal) this.provider.fatal(msg, ...args)\n else 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"],"mappings":"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"}
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 if (this.provider.trace) this.provider.trace(msg, ...args)\n else this.provider.debug(msg, ...args)\n }\n\n fatal(msg: string, ...args: any[]) {\n if (this.provider.fatal) this.provider.fatal(msg, ...args)\n else 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"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.5.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,38 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
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
-
11
+ function normalizePath(path){let p=path?.trim()||``;return p===`/`?``:(p&&!p.startsWith(`/`)&&(p=`/${p}`),p=p.replace(/\/+$/,``),p=p.replace(/\/\/+/g,`/`),p)}function joinPaths(...segments){let normalized=(`/`+segments.map(s=>s?.trim()||``).filter(Boolean).join(`/`)).replace(/\/\/+/g,`/`);return normalized===`/`?`/`:normalized.replace(/\/+$/,``)}export{joinPaths,normalizePath};
45
12
  //# sourceMappingURL=path.mjs.map
@@ -1 +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"}
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,KAAuB,CACnD,IAAI,EAAI,MAAM,MAAM,EAAI,GAOxB,OANI,IAAM,IAAY,IAClB,GAAK,CAAC,EAAE,WAAW,IAAI,GAAE,EAAI,IAAI,KAErC,EAAI,EAAE,QAAQ,OAAQ,GAAG,CAEzB,EAAI,EAAE,QAAQ,SAAU,IAAI,CACrB,GAcT,SAAgB,UAAU,GAAG,SAA0C,CAMrE,IAAM,YAAc,IALL,SACZ,IAAK,GAAM,GAAG,MAAM,EAAI,GAAG,CAC3B,OAAO,QAAQ,CACf,KAAK,IAEwB,EAAE,QAAQ,SAAU,IAAI,CAExD,OAAO,aAAe,IAAM,IAAM,WAAW,QAAQ,OAAQ,GAAG"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { t as KickPlugin } from "../plugin-DF8Xfv9Z.mjs";
2
+ import { t as KickPlugin } from "../plugin-JMkG7soG.mjs";
3
3
  export { KickPlugin };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.5.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,4 +8,4 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- export {};
11
+ export{};
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.5.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,182 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
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
-
11
+ let activeEffect=null;const targetMap=new WeakMap;function track(target,key){if(!activeEffect)return;let depsMap=targetMap.get(target);depsMap||(depsMap=new Map,targetMap.set(target,depsMap));let deps=depsMap.get(key);deps||(deps=new Set,depsMap.set(key,deps)),deps.add(activeEffect)}function trigger(target,key){let depsMap=targetMap.get(target);if(!depsMap)return;let deps=depsMap.get(key);if(deps)for(let effect of deps)effect()}function ref(initialValue){let subscribers=new Set,wrapper={_value:initialValue};return{get value(){return track(wrapper,`_value`),wrapper._value},set value(newValue){let oldValue=wrapper._value;if(!Object.is(oldValue,newValue)){wrapper._value=newValue,trigger(wrapper,`_value`);for(let fn of subscribers)fn(newValue,oldValue)}},subscribe(fn){return subscribers.add(fn),()=>subscribers.delete(fn)}}}function computed(getter){let cached,dirty=!0,wrapper={_value:void 0},effect=()=>{dirty=!0,trigger(wrapper,`_value`)};return{get value(){if(track(wrapper,`_value`),dirty){let prev=activeEffect;activeEffect=effect;try{cached=getter()}finally{activeEffect=prev}wrapper._value=cached,dirty=!1}return cached}}}function watch(source,callback,options){let oldValue,stopped=!1,getter=typeof source==`function`?source:()=>source.value,job=()=>{if(stopped)return;let newValue=getter();Object.is(newValue,oldValue)||(callback(newValue,oldValue),oldValue=newValue)},prev=activeEffect;activeEffect=job;try{oldValue=getter()}finally{activeEffect=prev}return options?.immediate&&callback(oldValue,void 0),()=>{stopped=!0}}function reactive(target){return new Proxy(target,{get(obj,key,receiver){let value=Reflect.get(obj,key,receiver);return typeof key==`symbol`?value:(track(obj,key),typeof value==`object`&&value&&!Array.isArray(value)?reactive(value):value)},set(obj,key,value,receiver){let oldValue=Reflect.get(obj,key,receiver),result=Reflect.set(obj,key,value,receiver);return!Object.is(oldValue,value)&&typeof key!=`symbol`&&trigger(obj,key),result}})}function isRef(value){return typeof value==`object`&&!!value&&`subscribe`in value&&`value`in value}function unref(value){return isRef(value)?value.value:value}function toRefs(obj){let result={};for(let key in obj)result[key]=ref(obj[key]);return result}export{computed,isRef,reactive,ref,toRefs,unref,watch};
189
12
  //# sourceMappingURL=reactivity.mjs.map
@@ -1 +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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"}
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,13 @@
1
+ /**
2
+ * @forinda/kickjs v5.5.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"./container-DrioVLNv.mjs";import{METADATA}from"./core/interfaces.mjs";import"./core/logger.mjs";import{c as pushClassMeta,l as pushMethodMeta}from"./metadata-WTmSU6Sf.mjs";import"./core/decorators.mjs";import"./core/cron.mjs";import"./core/cache.mjs";import"reflect-metadata";const mergeConfig$2=(defaults={},overrides={})=>({...defaults,...overrides}),composeName$2=(base,scope)=>`${base}:${scope}`;function defineModule(options){if(typeof options!=`object`||!options)throw TypeError(`defineModule: options must be an object literal. See architecture.md §21 for the spec shape.`);if(typeof options.name!=`string`||options.name.length===0){let got=typeof options.name==`string`?`""`:typeof options.name;throw TypeError(`defineModule: options.name must be a non-empty string (got ${got}). Module names appear in diagnostics and \`.scoped()\` namespacing — anonymous modules make cycle / missing-dep errors hard to localize.`)}if(typeof options.build!=`function`)throw TypeError(`defineModule(${options.name}): options.build is required and must be a function (got ${typeof options.build}). The build function returns the AppModule shape — register() / routes() / contributors() — wired with the resolved config.`);let buildSync=(instanceName,scoped,overrides)=>{let config=mergeConfig$2(options.defaults,overrides),built=options.build(config,{name:instanceName,scoped});return Object.defineProperty(built,`__moduleName`,{value:instanceName,enumerable:!1,writable:!1,configurable:!1}),built},factory=(config=>buildSync(options.name,!1,config));return factory.scoped=(scopeName,config)=>buildSync(composeName$2(options.name,scopeName),!0,config),Object.defineProperty(factory,`definition`,{value:Object.freeze({...options}),writable:!1,enumerable:!0,configurable:!1}),factory}var ModuleList=class extends Array{mount(module){return this.push(module),this}};function defineModules(...initial){let list=new ModuleList;for(let entry of initial)list.push(entry);return list}var MutableModuleRegistry=class{entries=[];mount(module){this.entries.push(module)}},CircuitOpenError=class extends Error{constructor(breakerName){super(`Circuit breaker "${breakerName}" is open — request rejected`),this.breakerName=breakerName,this.name=`CircuitOpenError`}},CircuitBreaker=class{state=`closed`;failures=0;successes=0;halfOpenAttempts=0;lastFailure;openedAt;failureThreshold;resetTimeout;halfOpenMax;constructor(name,options){this.name=name,this.failureThreshold=options.failureThreshold,this.resetTimeout=options.resetTimeout,this.halfOpenMax=options.halfOpenMax??1}async execute(fn){if(this.maybeTransitionToHalfOpen(),this.state===`open`||this.state===`half_open`&&this.halfOpenAttempts>=this.halfOpenMax)throw new CircuitOpenError(this.name);this.state===`half_open`&&this.halfOpenAttempts++;try{let result=await fn();return this.onSuccess(),result}catch(error){throw this.onFailure(),error}}getState(){return this.maybeTransitionToHalfOpen(),this.state}getStats(){return this.maybeTransitionToHalfOpen(),{failures:this.failures,successes:this.successes,state:this.state,...this.lastFailure?{lastFailure:this.lastFailure}:{}}}reset(){this.state=`closed`,this.failures=0,this.successes=0,this.halfOpenAttempts=0,this.lastFailure=void 0,this.openedAt=void 0}onSuccess(){this.state===`half_open`&&(this.state=`closed`,this.failures=0,this.halfOpenAttempts=0,this.openedAt=void 0),this.successes++}onFailure(){this.failures++,this.lastFailure=new Date,this.state===`half_open`?(this.state=`open`,this.openedAt=Date.now(),this.halfOpenAttempts=0):this.state===`closed`&&this.failures>=this.failureThreshold&&(this.state=`open`,this.openedAt=Date.now())}maybeTransitionToHalfOpen(){this.state===`open`&&this.openedAt!=null&&Date.now()-this.openedAt>=this.resetTimeout&&(this.state=`half_open`,this.halfOpenAttempts=0)}};function defineContextDecorator(spec){if(typeof spec!=`object`||!spec)throw TypeError(`defineContextDecorator: spec must be an object literal. See architecture.md §20.4 for the spec shape.`);if(typeof spec.key!=`string`||spec.key.length===0){let got=typeof spec.key==`string`?`""`:typeof spec.key;throw TypeError(`defineContextDecorator: spec.key must be a non-empty string (got ${got}). Pick a name that matches a key declared on \`ContextMeta\` (or one of the framework keys).`)}if(typeof spec.resolve!=`function`)throw TypeError(`defineContextDecorator(${spec.key}): spec.resolve is required and must be a function (got ${typeof spec.resolve}). Each contributor needs a resolver that produces the value to write into ctx.set(${JSON.stringify(spec.key)}, …).`);if(spec.onError!==void 0&&typeof spec.onError!=`function`)throw TypeError(`defineContextDecorator(${spec.key}): spec.onError must be a function when provided (got ${typeof spec.onError}).`);if(spec.dependsOn!==void 0&&!Array.isArray(spec.dependsOn))throw TypeError(`defineContextDecorator(${spec.key}): spec.dependsOn must be an array when provided (got ${typeof spec.dependsOn}).`);if(Array.isArray(spec.dependsOn)&&spec.dependsOn.some(dep=>typeof dep!=`string`||dep.length===0))throw TypeError(`defineContextDecorator(${spec.key}): spec.dependsOn entries must be non-empty strings.`);let definedAt=Error().stack,defaults=Object.freeze({...spec.paramDefaults??{}}),sharedDeps=Object.freeze({...spec.deps??{}}),sharedDependsOn=Object.freeze([...spec.dependsOn??[]]),sharedOptional=spec.optional??!1,buildRegistration=params=>{let frozenParams=Object.freeze({...params}),onError=spec.onError?(err,ctx)=>spec.onError(err,ctx,frozenParams):void 0;return Object.freeze({key:spec.key,deps:sharedDeps,dependsOn:sharedDependsOn,optional:sharedOptional,onError,resolve:(ctx,deps)=>spec.resolve(ctx,deps,frozenParams),definedAt})},defaultRegistration=buildRegistration({...defaults}),isDecoratorCall=args=>args.length===0?!1:args.length>=2||typeof args[0]==`function`,applyAsDecorator=(registration,target,propertyKey)=>{if(propertyKey===void 0)pushClassMeta(METADATA.CLASS_CONTRIBUTORS,target,registration);else{let constructor=target.constructor;pushMethodMeta(METADATA.METHOD_CONTRIBUTORS,constructor,String(propertyKey),registration)}},isPlainObject=value=>{let proto=Object.getPrototypeOf(value);return proto===Object.prototype||proto===null},mergeParams=override=>{if(override===void 0)return{...defaults};if(typeof override!=`object`||!override||Array.isArray(override)||!isPlainObject(override)){let got=override===null?`null`:Array.isArray(override)?`array`:typeof override==`object`?`instance of ${override.constructor?.name??`unknown class`}`:typeof override;throw TypeError(`defineContextDecorator(${spec.key}): factory call requires a plain object literal, got ${got}. Class instances and built-ins (Map, Date, etc) silently spread to empty objects — call the decorator with a spread object literal instead, e.g. \`MyDecorator({ ...someInstance })\`.`)}return{...defaults,...override}};function decoratorOrFactory(...args){if(isDecoratorCall(args)){let[target,propertyKey]=args;applyAsDecorator(defaultRegistration,target,propertyKey);return}let registration=buildRegistration(mergeParams(args[0]));return(target,propertyKey)=>{applyAsDecorator(registration,target,propertyKey)}}Object.defineProperty(decoratorOrFactory,`name`,{value:`ContextDecorator(${spec.key})`,writable:!1,enumerable:!1,configurable:!0});let decorator=Object.assign(decoratorOrFactory,{registration:defaultRegistration,with:params=>({registration:buildRegistration(mergeParams(params))})});return Object.freeze(decorator)}var MissingContributorError=class extends Error{key;dependent;route;dependentDefinedAt;constructor(key,dependent,route,dependentDefinedAt){let where=route?` on route ${route}`:``,declaredAt=formatDeclaredAt(dependentDefinedAt);super(`Missing context contributor '${key}' required by '${dependent}'${where}${declaredAt}`),this.name=`MissingContributorError`,this.key=key,this.dependent=dependent,this.route=route,this.dependentDefinedAt=dependentDefinedAt}};function formatDeclaredAt(stack){if(!stack)return``;let lines=stack.split(`
12
+ `);for(let line of lines){let trimmed=line.trim();if(trimmed.startsWith(`at `)&&!trimmed.includes(`context-decorator.`)&&!trimmed.includes(`context-errors.`))return`\n declared at ${trimmed.replace(/^at /,``)}`}return``}var ContributorCycleError=class extends Error{cycle;route;constructor(cycle,route){let where=route?` on route ${route}`:``;super(`Cycle in context contributors${where}: ${cycle.join(` → `)}`),this.name=`ContributorCycleError`,this.cycle=Object.freeze([...cycle]),this.route=route}},DuplicateContributorError=class extends Error{key;sources;constructor(key,sources){super(`Duplicate context contributor for key '${key}' at the same precedence level. Sources: ${sources.join(`, `)}`),this.name=`DuplicateContributorError`,this.key=key,this.sources=Object.freeze([...sources])}};const PRECEDENCE_ORDER=[`method`,`class`,`module`,`adapter`,`global`];function buildPipeline(sources,options={}){let route=options.route,bySource=new Map;for(let src of PRECEDENCE_ORDER)bySource.set(src,[]);for(let entry of sources)bySource.get(entry.source).push(entry);let winners=new Map;for(let src of PRECEDENCE_ORDER){let rows=bySource.get(src),keysAtThisLevel=new Map;for(let row of rows){let key=row.registration.key,existing=keysAtThisLevel.get(key)??[];existing.push(row),keysAtThisLevel.set(key,existing)}for(let[key,rowsForKey]of keysAtThisLevel){if(rowsForKey.length>1)throw new DuplicateContributorError(key,rowsForKey.map((r,i)=>r.label??`${src}#${i}`));winners.has(key)||winners.set(key,rowsForKey[0])}}let survivors=[...winners.values()].map(r=>r.registration),allKeys=new Set(survivors.map(r=>r.key));for(let reg of survivors)for(let dep of reg.dependsOn)if(!allKeys.has(dep))throw new MissingContributorError(dep,reg.key,route,reg.definedAt);let sorted=topoSort(survivors,route);return Object.freeze({contributors:Object.freeze(sorted),keys:allKeys})}function topoSort(registrations,route){let indegree=new Map,dependents=new Map,byKey=new Map;for(let reg of registrations)indegree.set(reg.key,reg.dependsOn.length),byKey.set(reg.key,reg);for(let reg of registrations)for(let dep of reg.dependsOn){let list=dependents.get(dep)??[];list.push(reg),dependents.set(dep,list)}let queue=[];for(let reg of registrations)indegree.get(reg.key)===0&&queue.push(reg);let sorted=[];for(;queue.length>0;){let node=queue.shift();sorted.push(node);for(let dependent of dependents.get(node.key)??[]){let next=(indegree.get(dependent.key)??0)-1;indegree.set(dependent.key,next),next===0&&queue.push(dependent)}}if(sorted.length!==registrations.length)throw new ContributorCycleError(reconstructCycle$1(registrations.filter(r=>(indegree.get(r.key)??0)>0),byKey),route);return sorted}function reconstructCycle$1(residual,byKey){let residualKeys=new Set(residual.map(r=>r.key)),start=residual[0].key,path=[start],seen=new Set([start]),cursor=start;for(;;){let nextDep=byKey.get(cursor).dependsOn.find(d=>residualKeys.has(d));if(nextDep===void 0)break;if(seen.has(nextDep)){let cycleStart=path.indexOf(nextDep);return[...path.slice(cycleStart),nextDep]}path.push(nextDep),seen.add(nextDep),cursor=nextDep}return path}async function runContributors(options){let{pipeline,ctx,container}=options;for(let reg of pipeline.contributors)await runOne(reg,ctx,container)}async function runOne(reg,ctx,container){let value;try{let deps=resolveDeps(reg,container);value=await reg.resolve(ctx,deps)}catch(err){if(reg.optional)return;if(reg.onError){let replacement=await reg.onError(err,ctx);if(replacement===void 0)return;ctx.set(reg.key,replacement);return}throw err}ctx.set(reg.key,value)}function resolveDeps(reg,container){let out={};for(let[key,token]of Object.entries(reg.deps))out[key]=container.resolve(token);return out}var DuplicateMountNameError=class extends Error{kind;mountName;constructor(kind,mountName){super(`Duplicate ${kind} name '${mountName}' — every ${kind} must declare a unique name`),this.name=`DuplicateMountNameError`,this.kind=kind,this.mountName=mountName}},MissingMountDepError=class extends Error{kind;missing;dependent;constructor(kind,missing,dependent){super(`Missing ${kind} dependency '${missing}' required by '${dependent}' — is the ${kind} installed and named correctly?`),this.name=`MissingMountDepError`,this.kind=kind,this.missing=missing,this.dependent=dependent}},MountCycleError=class extends Error{kind;cycle;constructor(kind,cycle){super(`Cycle in ${kind} dependsOn declarations: ${cycle.join(` → `)}`),this.name=`MountCycleError`,this.kind=kind,this.cycle=Object.freeze([...cycle])}};function mountSort(items,kind){let byName=new Map;for(let item of items){if(byName.has(item.name))throw new DuplicateMountNameError(kind,item.name);byName.set(item.name,item)}let indegree=new Map,dependents=new Map;for(let item of items)indegree.set(item.name,item.dependsOn?.length??0);for(let item of items)for(let dep of item.dependsOn??[]){if(!byName.has(dep))throw new MissingMountDepError(kind,dep,item.name);let list=dependents.get(dep)??[];list.push(item),dependents.set(dep,list)}let queue=[];for(let item of items)indegree.get(item.name)===0&&queue.push(item);let sorted=[];for(;queue.length>0;){let node=queue.shift();sorted.push(node);for(let dependent of dependents.get(node.name)??[]){let next=(indegree.get(dependent.name)??0)-1;indegree.set(dependent.name,next),next===0&&queue.push(dependent)}}if(sorted.length!==items.length)throw new MountCycleError(kind,reconstructCycle(items.filter(it=>(indegree.get(it.name)??0)>0),byName));return sorted}function reconstructCycle(residual,byName){let residualNames=new Set(residual.map(r=>r.name)),start=residual[0].name,path=[start],seen=new Set([start]),cursor=start;for(;;){let nextDep=byName.get(cursor).dependsOn?.find(d=>residualNames.has(d));if(nextDep===void 0)break;if(seen.has(nextDep)){let cycleStart=path.indexOf(nextDep);return[...path.slice(cycleStart),nextDep]}path.push(nextDep),seen.add(nextDep),cursor=nextDep}return path}const mergeConfig$1=(defaults={},overrides={})=>({...defaults,...overrides}),composeName$1=(base,scope)=>`${base}:${scope}`;function definePlugin(options){let buildSync=(instanceName,scoped,overrides)=>{let config=mergeConfig$1(options.defaults,overrides),built=options.build(config,{name:instanceName,scoped});return built.name=instanceName,built},buildAsync=(instanceName,opts)=>{let inner,ensureInner=async container=>{if(inner)return inner;let deps=(opts.inject??[]).map(tok=>container.resolve(tok));return inner=buildSync(instanceName,!1,await opts.useFactory(...deps)),inner};return{name:instanceName,async onReady(container){let built=await ensureInner(container);built.register?.(container),await built.onReady?.(container)},async shutdown(){await inner?.shutdown?.()}}},factory=(config=>buildSync(options.name,!1,config));return factory.scoped=(scopeName,config)=>buildSync(composeName$1(options.name,scopeName),!0,config),factory.async=opts=>buildAsync(options.name,opts),Object.defineProperty(factory,`definition`,{value:Object.freeze({...options})}),factory}const mergeConfig=(defaults={},overrides={})=>({...defaults,...overrides}),composeName=(base,scope)=>`${base}:${scope}`;function defineAdapter(options){let buildSync=(instanceName,scoped,overrides)=>{let config=mergeConfig(options.defaults,overrides),built=options.build(config,{name:instanceName,scoped});return built.name=instanceName,built},buildAsync=(instanceName,opts)=>{let inner;return{name:instanceName,async beforeStart(ctx){let deps=(opts.inject??[]).map(tok=>ctx.container.resolve(tok));inner=buildSync(instanceName,!1,await opts.useFactory(...deps)),await inner.beforeStart?.(ctx)},async afterStart(ctx){await inner?.afterStart?.(ctx)},async shutdown(){await inner?.shutdown?.()},async onHealthCheck(){return await inner?.onHealthCheck?.()??{name:instanceName,status:`up`}}}},factory=(config=>buildSync(options.name,!1,config));return factory.scoped=(scopeName,config)=>buildSync(composeName(options.name,scopeName),!0,config),factory.async=opts=>buildAsync(options.name,opts),Object.defineProperty(factory,`definition`,{value:Object.freeze({...options})}),factory}function defineAugmentation(name,meta){}export{ModuleList as _,MissingMountDepError as a,runContributors as c,DuplicateContributorError as d,MissingContributorError as f,MutableModuleRegistry as g,CircuitOpenError as h,DuplicateMountNameError as i,buildPipeline as l,CircuitBreaker as m,defineAdapter as n,MountCycleError as o,defineContextDecorator as p,definePlugin as r,mountSort as s,defineAugmentation as t,ContributorCycleError as u,defineModules as v,defineModule as y};
13
+ //# sourceMappingURL=core-MvABl8Cl.mjs.map