@forinda/kickjs 2.1.0 → 2.2.1

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 (104) hide show
  1. package/README.md +63 -20
  2. package/dist/{adapter-BqGjZCSm.d.mts → adapter-wuoBNkNs.d.mts} +3 -3
  3. package/dist/{adapter-BqGjZCSm.d.mts.map → adapter-wuoBNkNs.d.mts.map} +1 -1
  4. package/dist/{app-module-CcEbAVtB.d.mts → app-module-DOBmxARW.d.mts} +11 -4
  5. package/dist/app-module-DOBmxARW.d.mts.map +1 -0
  6. package/dist/{application-DNHj-_UL.mjs → application-cYhTEy84.mjs} +6 -6
  7. package/dist/application-cYhTEy84.mjs.map +1 -0
  8. package/dist/{bootstrap-DLEZaJ3b.mjs → bootstrap-8_iBHhWp.mjs} +6 -6
  9. package/dist/{bootstrap-DLEZaJ3b.mjs.map → bootstrap-8_iBHhWp.mjs.map} +1 -1
  10. package/dist/{cache-DJeMaGqb.d.mts → cache-PufEhr0n.d.mts} +1 -1
  11. package/dist/{cache-DJeMaGqb.d.mts.map → cache-PufEhr0n.d.mts.map} +1 -1
  12. package/dist/{chunk-C5Qp-JxE.mjs → chunk-Djztpsb3.mjs} +1 -1
  13. package/dist/container-BKiJzakw.mjs +496 -0
  14. package/dist/container-BKiJzakw.mjs.map +1 -0
  15. package/dist/{container-nBSIhyqV.d.mts → container-CcgV8eHL.d.mts} +116 -4
  16. package/dist/container-CcgV8eHL.d.mts.map +1 -0
  17. package/dist/core/adapter.d.mts +1 -1
  18. package/dist/core/adapter.mjs +1 -1
  19. package/dist/core/app-module.d.mts +1 -1
  20. package/dist/core/app-module.mjs +1 -1
  21. package/dist/core/cache.d.mts +1 -1
  22. package/dist/core/cache.mjs +1 -1
  23. package/dist/core/container.d.mts +2 -2
  24. package/dist/core/container.mjs +2 -416
  25. package/dist/core/cron.d.mts +1 -1
  26. package/dist/core/cron.mjs +2 -2
  27. package/dist/core/decorators.d.mts +2 -2
  28. package/dist/core/decorators.mjs +9 -3
  29. package/dist/core/decorators.mjs.map +1 -1
  30. package/dist/core/errors.d.mts +1 -1
  31. package/dist/core/errors.mjs +1 -1
  32. package/dist/core/interfaces.d.mts +1 -1
  33. package/dist/core/interfaces.mjs +1 -1
  34. package/dist/core/logger.d.mts +1 -1
  35. package/dist/core/logger.mjs +1 -1
  36. package/dist/core/path.d.mts +1 -1
  37. package/dist/core/path.mjs +1 -1
  38. package/dist/core/plugin.d.mts +1 -1
  39. package/dist/core/plugin.mjs +1 -1
  40. package/dist/core/reactivity.d.mts +1 -1
  41. package/dist/core/reactivity.mjs +1 -1
  42. package/dist/{core-BL_H8fEZ.mjs → core-CXHuViXn.mjs} +4 -4
  43. package/dist/{core-BL_H8fEZ.mjs.map → core-CXHuViXn.mjs.map} +1 -1
  44. package/dist/{cron-RKhH5TOd.d.mts → cron-C29iHvHT.d.mts} +1 -1
  45. package/dist/{cron-RKhH5TOd.d.mts.map → cron-C29iHvHT.d.mts.map} +1 -1
  46. package/dist/{decorators-CQ93ak6Z.d.mts → decorators-D3lBlmud.d.mts} +54 -4
  47. package/dist/decorators-D3lBlmud.d.mts.map +1 -0
  48. package/dist/{errors-te5Km00o.d.mts → errors-BZUdxtjC.d.mts} +1 -1
  49. package/dist/{errors-te5Km00o.d.mts.map → errors-BZUdxtjC.d.mts.map} +1 -1
  50. package/dist/http/application.d.mts +4 -4
  51. package/dist/http/application.d.mts.map +1 -1
  52. package/dist/http/application.mjs +2 -2
  53. package/dist/http/bootstrap.mjs +2 -2
  54. package/dist/http/context.d.mts +67 -8
  55. package/dist/http/context.d.mts.map +1 -1
  56. package/dist/http/context.mjs +10 -5
  57. package/dist/http/context.mjs.map +1 -1
  58. package/dist/http/middleware/cors.mjs +1 -1
  59. package/dist/http/middleware/csrf.mjs +1 -1
  60. package/dist/http/middleware/error-handler.mjs +2 -2
  61. package/dist/http/middleware/helmet.mjs +1 -1
  62. package/dist/http/middleware/rate-limit.mjs +1 -1
  63. package/dist/http/middleware/request-id.mjs +1 -1
  64. package/dist/http/middleware/request-logger.mjs +2 -2
  65. package/dist/http/middleware/session.mjs +1 -1
  66. package/dist/http/middleware/spa.d.mts +1 -1
  67. package/dist/http/middleware/spa.mjs +3 -3
  68. package/dist/http/middleware/upload.d.mts +1 -1
  69. package/dist/http/middleware/upload.mjs +1 -1
  70. package/dist/http/middleware/validate.mjs +1 -1
  71. package/dist/http/middleware/views.d.mts +1 -1
  72. package/dist/http/middleware/views.mjs +2 -2
  73. package/dist/http/query/index.d.mts +2 -2
  74. package/dist/http/query/index.mjs +2 -2
  75. package/dist/http/router-builder.mjs +4 -4
  76. package/dist/{index-C0gbnpSg.d.mts → index-4VM4dUJf.d.mts} +1 -1
  77. package/dist/{index-C0gbnpSg.d.mts.map → index-4VM4dUJf.d.mts.map} +1 -1
  78. package/dist/{index-Cls52etj.d.mts → index-rnK23QBD.d.mts} +39 -3
  79. package/dist/index-rnK23QBD.d.mts.map +1 -0
  80. package/dist/index.d.mts +16 -16
  81. package/dist/index.mjs +8 -8
  82. package/dist/{interfaces-D-48zotH.d.mts → interfaces-D5ohYl6D.d.mts} +1 -1
  83. package/dist/{interfaces-D-48zotH.d.mts.map → interfaces-D5ohYl6D.d.mts.map} +1 -1
  84. package/dist/{logger-Dzj-TF0t.d.mts → logger-BLdfUF5b.d.mts} +1 -1
  85. package/dist/{logger-Dzj-TF0t.d.mts.map → logger-BLdfUF5b.d.mts.map} +1 -1
  86. package/dist/{metadata-fmvikBA0.mjs → metadata-D5L3_cdl.mjs} +2 -2
  87. package/dist/{metadata-fmvikBA0.mjs.map → metadata-D5L3_cdl.mjs.map} +1 -1
  88. package/dist/{path-LmwfhfyH.d.mts → path-Dq5V-i-x.d.mts} +1 -1
  89. package/dist/path-Dq5V-i-x.d.mts.map +1 -0
  90. package/dist/{plugin-DIoPIpSm.d.mts → plugin-D20muJwC.d.mts} +4 -4
  91. package/dist/{plugin-DIoPIpSm.d.mts.map → plugin-D20muJwC.d.mts.map} +1 -1
  92. package/dist/{query-7cdHF6ry.mjs → query-BSIApo6Y.mjs} +6 -6
  93. package/dist/query-BSIApo6Y.mjs.map +1 -0
  94. package/dist/{reactivity-BbS-99ow.d.mts → reactivity-CMAQh0gi.d.mts} +1 -1
  95. package/dist/{reactivity-BbS-99ow.d.mts.map → reactivity-CMAQh0gi.d.mts.map} +1 -1
  96. package/package.json +16 -13
  97. package/dist/app-module-CcEbAVtB.d.mts.map +0 -1
  98. package/dist/application-DNHj-_UL.mjs.map +0 -1
  99. package/dist/container-nBSIhyqV.d.mts.map +0 -1
  100. package/dist/core/container.mjs.map +0 -1
  101. package/dist/decorators-CQ93ak6Z.d.mts.map +0 -1
  102. package/dist/index-Cls52etj.d.mts.map +0 -1
  103. package/dist/path-LmwfhfyH.d.mts.map +0 -1
  104. package/dist/query-7cdHF6ry.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"context.mjs","names":[],"sources":["../../src/http/context.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport {\n parseQuery,\n type ParsedQuery,\n type QueryFieldConfig,\n type PaginatedResponse,\n} from './query'\n\n/**\n * Unified request/response abstraction passed to every controller method.\n * Shields handlers from raw Express objects and provides convenience methods.\n */\nexport class RequestContext<TBody = any, TParams = any, TQuery = any> {\n constructor(\n public readonly req: Request,\n public readonly res: Response,\n public readonly next: NextFunction,\n ) {}\n\n /**\n * Per-request metadata map shared across all RequestContext instances\n * for the same request. Stored on `req` so middleware can pass data\n * to handlers via `ctx.set()` / `ctx.get()`.\n */\n private get metadata(): Map<string, any> {\n const r = this.req as any\n if (!r.__ctxMeta) r.__ctxMeta = new Map<string, any>()\n return r.__ctxMeta\n }\n\n // ── Request Data ────────────────────────────────────────────────────\n\n get body(): TBody {\n return this.req.body as TBody\n }\n\n get params(): TParams {\n return this.req.params as TParams\n }\n\n get query(): TQuery {\n return this.req.query as TQuery\n }\n\n get headers() {\n return this.req.headers\n }\n\n get requestId(): string | undefined {\n return (this.req as any).requestId ?? (this.req.headers['x-request-id'] as string | undefined)\n }\n\n /** Session data (requires session middleware) */\n get session(): any {\n return (this.req as any).session\n }\n\n // ── Query String Parsing ───────────────────────────────────────────\n\n /**\n * Parse the request query string into structured filters, sort, pagination, and search.\n * Pass the result to an ORM query builder adapter (Drizzle, Prisma, Sequelize, etc.).\n *\n * @param fieldConfig - Optional whitelist for filterable, sortable, and searchable fields\n *\n * @example\n * ```ts\n * @Get('/')\n * async list(ctx: RequestContext) {\n * const parsed = ctx.qs({\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt', 'title'],\n * })\n * const q = drizzleAdapter.build(parsed, { columns })\n * // ... use q.where, q.orderBy, q.limit, q.offset\n * }\n * ```\n */\n qs(fieldConfig?: QueryFieldConfig): ParsedQuery {\n return parseQuery(this.req.query as Record<string, any>, fieldConfig)\n }\n\n // ── File Uploads ────────────────────────────────────────────────────\n\n /** Single uploaded file (requires @FileUpload({ mode: 'single' })) */\n get file(): any {\n return (this.req as any).file\n }\n\n /** Array of uploaded files (requires @FileUpload({ mode: 'array' })) */\n get files(): any[] | undefined {\n return (this.req as any).files\n }\n\n // ── Metadata Store ──────────────────────────────────────────────────\n\n get<T = any>(key: string): T | undefined {\n return this.metadata.get(key) as T | undefined\n }\n\n set(key: string, value: any): void {\n this.metadata.set(key, value)\n }\n\n // ── Response Helpers ────────────────────────────────────────────────\n\n json(data: any, status = 200) {\n return this.res.status(status).json(data)\n }\n\n created(data: any) {\n return this.res.status(201).json(data)\n }\n\n noContent() {\n return this.res.status(204).end()\n }\n\n notFound(message = 'Not Found') {\n return this.res.status(404).json({ message })\n }\n\n badRequest(message: string) {\n return this.res.status(400).json({ message })\n }\n\n html(content: string, status = 200) {\n return this.res.status(status).type('html').send(content)\n }\n\n download(buffer: Buffer, filename: string, contentType = 'application/octet-stream') {\n this.res.setHeader('Content-Disposition', `attachment; filename=\"${filename}\"`)\n this.res.setHeader('Content-Type', contentType)\n return this.res.send(buffer)\n }\n\n /**\n * Render a template using the registered view engine (EJS, Pug, Handlebars, etc.).\n * Requires a ViewAdapter to be configured in bootstrap().\n *\n * @param template - Template name (without extension, relative to viewsDir)\n * @param data - Data to pass to the template\n *\n * @example\n * ```ts\n * ctx.render('dashboard', { user, title: 'Dashboard' })\n * ctx.render('emails/welcome', { name: 'Alice' })\n * ```\n */\n render(template: string, data: Record<string, any> = {}) {\n return this.res.render(template, data)\n }\n\n /**\n * Parse query params and return a standardized paginated response.\n * Calls `ctx.qs()` internally, then wraps your data with pagination meta.\n *\n * @param fetcher - Async function that receives ParsedQuery and returns `{ data, total }`\n * @param fieldConfig - Optional whitelist for filterable, sortable, searchable fields\n *\n * @example\n * ```ts\n * @Get('/')\n * async list(ctx: RequestContext) {\n * return ctx.paginate(\n * async (parsed) => {\n * const data = await db.select().from(users)\n * .where(query.where).limit(parsed.pagination.limit)\n * .offset(parsed.pagination.offset).all()\n * const total = await db.select({ count: count() }).from(users).get()\n * return { data, total: total?.count ?? 0 }\n * },\n * { filterable: ['name', 'role'], sortable: ['createdAt'] },\n * )\n * }\n * ```\n */\n async paginate<T>(\n fetcher: (parsed: ParsedQuery) => Promise<{ data: T[]; total: number }>,\n fieldConfig?: QueryFieldConfig,\n ) {\n const parsed = this.qs(fieldConfig)\n const { data, total } = await fetcher(parsed)\n const { page, limit } = parsed.pagination\n const totalPages = Math.ceil(total / limit) || 1\n\n const response: PaginatedResponse<T> = {\n data,\n meta: {\n page,\n limit,\n total,\n totalPages,\n hasNext: page < totalPages,\n hasPrev: page > 1,\n },\n }\n\n return this.json(response)\n }\n\n // ── Server-Sent Events ──────────────────────────────────────────────\n\n /**\n * Start an SSE (Server-Sent Events) stream.\n * Sets the correct headers and returns helpers to send events.\n *\n * @example\n * ```ts\n * @Get('/events')\n * async stream(ctx: RequestContext) {\n * const sse = ctx.sse()\n *\n * const interval = setInterval(() => {\n * sse.send({ time: new Date().toISOString() }, 'tick')\n * }, 1000)\n *\n * sse.onClose(() => clearInterval(interval))\n * }\n * ```\n */\n sse() {\n this.res.writeHead(200, {\n 'Content-Type': 'text/event-stream',\n 'Cache-Control': 'no-cache',\n Connection: 'keep-alive',\n 'X-Accel-Buffering': 'no',\n })\n this.res.flushHeaders()\n\n const closeCallbacks: Array<() => void> = []\n\n this.req.on('close', () => {\n for (const cb of closeCallbacks) cb()\n })\n\n return {\n /** Send an SSE event with optional event name and id */\n send: (data: any, event?: string, id?: string) => {\n if (id) this.res.write(`id: ${id}\\n`)\n if (event) this.res.write(`event: ${event}\\n`)\n this.res.write(`data: ${JSON.stringify(data)}\\n\\n`)\n },\n /** Send a comment (keeps connection alive) */\n comment: (text: string) => {\n this.res.write(`: ${text}\\n\\n`)\n },\n /** Register a callback when the client disconnects */\n onClose: (fn: () => void) => {\n closeCallbacks.push(fn)\n },\n /** End the SSE stream */\n close: () => {\n this.res.end()\n },\n }\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"context.mjs","names":[],"sources":["../../src/http/context.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport {\n parseQuery,\n type QueryFieldConfig,\n type PaginatedResponse,\n type TypedParsedQuery,\n} from './query'\n\n/**\n * The shape of a single route entry in `KickRoutes`. Generated by\n * `kick typegen` and consumed via the `Ctx<T>` helper. Each field is\n * `unknown` by default and is filled in as the typegen learns more\n * about the route (URL params from the path, body/query from validation\n * schemas, etc.).\n */\nexport interface RouteShape {\n params?: unknown\n body?: unknown\n query?: unknown\n response?: unknown\n}\n\n/**\n * Unified request/response abstraction passed to every controller method.\n * Shields handlers from raw Express objects and provides convenience methods.\n */\nexport class RequestContext<TBody = any, TParams = any, TQuery = any> {\n constructor(\n public readonly req: Request,\n public readonly res: Response,\n public readonly next: NextFunction,\n ) {}\n\n /**\n * Per-request metadata map shared across all RequestContext instances\n * for the same request. Stored on `req` so middleware can pass data\n * to handlers via `ctx.set()` / `ctx.get()`.\n */\n private get metadata(): Map<string, any> {\n const r = this.req as any\n if (!r.__ctxMeta) r.__ctxMeta = new Map<string, any>()\n return r.__ctxMeta\n }\n\n // ── Request Data ────────────────────────────────────────────────────\n\n get body(): TBody {\n return this.req.body as TBody\n }\n\n get params(): TParams {\n return this.req.params as TParams\n }\n\n get query(): TQuery {\n return this.req.query as TQuery\n }\n\n get headers() {\n return this.req.headers\n }\n\n get requestId(): string | undefined {\n return (this.req as any).requestId ?? (this.req.headers['x-request-id'] as string | undefined)\n }\n\n /** Session data (requires session middleware) */\n get session(): any {\n return (this.req as any).session\n }\n\n // ── Query String Parsing ───────────────────────────────────────────\n\n /**\n * Parse the request query string into structured filters, sort, pagination, and search.\n * Pass the result to an ORM query builder adapter (Drizzle, Prisma, Sequelize, etc.).\n *\n * Generic over the field config: when passed an inline literal (or\n * `as const`), `filters[].field` and `sort[].field` are narrowed to\n * the exact whitelisted field names. Pass nothing or a non-literal\n * config and you get the loose `string` fallback.\n *\n * @param fieldConfig - Optional whitelist for filterable, sortable, and searchable fields\n *\n * @example\n * ```ts\n * @Get('/')\n * async list(ctx: RequestContext) {\n * const parsed = ctx.qs({\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt', 'title'],\n * } as const)\n * parsed.filters[0].field // typed as 'status' | 'priority'\n * parsed.sort[0].field // typed as 'createdAt' | 'title'\n * }\n * ```\n */\n qs<TConfig extends QueryFieldConfig | undefined = undefined>(\n fieldConfig?: TConfig,\n ): TypedParsedQuery<TConfig> {\n return parseQuery<TConfig>(this.req.query as Record<string, any>, fieldConfig)\n }\n\n // ── File Uploads ────────────────────────────────────────────────────\n\n /** Single uploaded file (requires @FileUpload({ mode: 'single' })) */\n get file(): any {\n return (this.req as any).file\n }\n\n /** Array of uploaded files (requires @FileUpload({ mode: 'array' })) */\n get files(): any[] | undefined {\n return (this.req as any).files\n }\n\n // ── Metadata Store ──────────────────────────────────────────────────\n\n get<T = any>(key: string): T | undefined {\n return this.metadata.get(key) as T | undefined\n }\n\n set(key: string, value: any): void {\n this.metadata.set(key, value)\n }\n\n // ── Response Helpers ────────────────────────────────────────────────\n\n json(data: any, status = 200) {\n return this.res.status(status).json(data)\n }\n\n created(data: any) {\n return this.res.status(201).json(data)\n }\n\n noContent() {\n return this.res.status(204).end()\n }\n\n notFound(message = 'Not Found') {\n return this.res.status(404).json({ message })\n }\n\n badRequest(message: string) {\n return this.res.status(400).json({ message })\n }\n\n html(content: string, status = 200) {\n return this.res.status(status).type('html').send(content)\n }\n\n download(buffer: Buffer, filename: string, contentType = 'application/octet-stream') {\n this.res.setHeader('Content-Disposition', `attachment; filename=\"${filename}\"`)\n this.res.setHeader('Content-Type', contentType)\n return this.res.send(buffer)\n }\n\n /**\n * Render a template using the registered view engine (EJS, Pug, Handlebars, etc.).\n * Requires a ViewAdapter to be configured in bootstrap().\n *\n * @param template - Template name (without extension, relative to viewsDir)\n * @param data - Data to pass to the template\n *\n * @example\n * ```ts\n * ctx.render('dashboard', { user, title: 'Dashboard' })\n * ctx.render('emails/welcome', { name: 'Alice' })\n * ```\n */\n render(template: string, data: Record<string, any> = {}) {\n return this.res.render(template, data)\n }\n\n /**\n * Parse query params and return a standardized paginated response.\n * Calls `ctx.qs()` internally, then wraps your data with pagination meta.\n *\n * @param fetcher - Async function that receives ParsedQuery and returns `{ data, total }`\n * @param fieldConfig - Optional whitelist for filterable, sortable, searchable fields\n *\n * @example\n * ```ts\n * @Get('/')\n * async list(ctx: RequestContext) {\n * return ctx.paginate(\n * async (parsed) => {\n * const data = await db.select().from(users)\n * .where(query.where).limit(parsed.pagination.limit)\n * .offset(parsed.pagination.offset).all()\n * const total = await db.select({ count: count() }).from(users).get()\n * return { data, total: total?.count ?? 0 }\n * },\n * { filterable: ['name', 'role'], sortable: ['createdAt'] },\n * )\n * }\n * ```\n */\n async paginate<T, TConfig extends QueryFieldConfig | undefined = undefined>(\n fetcher: (parsed: TypedParsedQuery<TConfig>) => Promise<{ data: T[]; total: number }>,\n fieldConfig?: TConfig,\n ) {\n const parsed = this.qs<TConfig>(fieldConfig)\n const { data, total } = await fetcher(parsed)\n const { page, limit } = parsed.pagination\n const totalPages = Math.ceil(total / limit) || 1\n\n const response: PaginatedResponse<T> = {\n data,\n meta: {\n page,\n limit,\n total,\n totalPages,\n hasNext: page < totalPages,\n hasPrev: page > 1,\n },\n }\n\n return this.json(response)\n }\n\n // ── Server-Sent Events ──────────────────────────────────────────────\n\n /**\n * Start an SSE (Server-Sent Events) stream.\n * Sets the correct headers and returns helpers to send events.\n *\n * @example\n * ```ts\n * @Get('/events')\n * async stream(ctx: RequestContext) {\n * const sse = ctx.sse()\n *\n * const interval = setInterval(() => {\n * sse.send({ time: new Date().toISOString() }, 'tick')\n * }, 1000)\n *\n * sse.onClose(() => clearInterval(interval))\n * }\n * ```\n */\n sse() {\n this.res.writeHead(200, {\n 'Content-Type': 'text/event-stream',\n 'Cache-Control': 'no-cache',\n Connection: 'keep-alive',\n 'X-Accel-Buffering': 'no',\n })\n this.res.flushHeaders()\n\n const closeCallbacks: Array<() => void> = []\n\n this.req.on('close', () => {\n for (const cb of closeCallbacks) cb()\n })\n\n return {\n /** Send an SSE event with optional event name and id */\n send: (data: any, event?: string, id?: string) => {\n if (id) this.res.write(`id: ${id}\\n`)\n if (event) this.res.write(`event: ${event}\\n`)\n this.res.write(`data: ${JSON.stringify(data)}\\n\\n`)\n },\n /** Send a comment (keeps connection alive) */\n comment: (text: string) => {\n this.res.write(`: ${text}\\n\\n`)\n },\n /** Register a callback when the client disconnects */\n onClose: (fn: () => void) => {\n closeCallbacks.push(fn)\n },\n /** End the SSE stream */\n close: () => {\n this.res.end()\n },\n }\n }\n}\n\n/**\n * Short alias for `RequestContext` parameterised by a route shape.\n *\n * Use this with `kick typegen`'s generated `KickRoutes` global namespace\n * to get fully-typed `ctx.params`, `ctx.body`, and `ctx.query` from a\n * single annotation:\n *\n * ```ts\n * @Get('/:id')\n * getUser(ctx: Ctx<KickRoutes.UserController['getUser']>) {\n * ctx.params.id // typed\n * ctx.body // typed (or never if no body schema)\n * ctx.query.page // typed\n * }\n * ```\n *\n * `Ctx<>` (no arg) is equivalent to the loose `RequestContext`.\n *\n * Backward compat: existing handlers using `ctx: RequestContext` keep\n * working untouched. `Ctx<T>` is opt-in.\n */\nexport type Ctx<TRoute extends RouteShape = RouteShape> = RequestContext<\n TRoute extends { body: infer B } ? B : any,\n TRoute extends { params: infer P } ? P : any,\n TRoute extends { query: infer Q } ? Q : any\n>\n\n/**\n * Global ambient registry of typed routes, populated by `kick typegen`.\n *\n * Each interface inside `KickRoutes` corresponds to a controller class;\n * each property is one route method on that controller. The values\n * conform to `RouteShape`.\n *\n * Empty by default — declarations come from `.kickjs/types/routes.d.ts`\n * generated alongside the rest of the typegen output.\n */\ndeclare global {\n // eslint-disable-next-line @typescript-eslint/no-namespace\n namespace KickRoutes {}\n}\n"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -10,7 +10,7 @@
10
10
  */
11
11
  import { createLogger } from "../../core/logger.mjs";
12
12
  import { HttpException } from "../../core/errors.mjs";
13
- import "../../core-BL_H8fEZ.mjs";
13
+ import "../../core-CXHuViXn.mjs";
14
14
  //#region src/http/middleware/error-handler.ts
15
15
  const log = createLogger("ErrorHandler");
16
16
  /** Catch-all for unmatched routes */
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,7 +9,7 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { createLogger } from "../../core/logger.mjs";
12
- import "../../core-BL_H8fEZ.mjs";
12
+ import "../../core-CXHuViXn.mjs";
13
13
  //#region src/http/middleware/request-logger.ts
14
14
  /**
15
15
  * Middleware that logs every request with method, URL, status, duration, and request ID.
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
 
2
- import { r as AppAdapter, t as AdapterContext } from "../../adapter-BqGjZCSm.mjs";
2
+ import { r as AppAdapter, t as AdapterContext } from "../../adapter-wuoBNkNs.mjs";
3
3
  //#region src/http/middleware/spa.d.ts
4
4
  interface SpaAdapterOptions {
5
5
  /**
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,9 +8,9 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { t as __require } from "../../chunk-C5Qp-JxE.mjs";
11
+ import { t as __require } from "../../chunk-Djztpsb3.mjs";
12
12
  import { Logger } from "../../core/logger.mjs";
13
- import "../../core-BL_H8fEZ.mjs";
13
+ import "../../core-CXHuViXn.mjs";
14
14
  import { join, resolve } from "node:path";
15
15
  import { existsSync, readFileSync } from "node:fs";
16
16
  //#region src/http/middleware/spa.ts
@@ -1,5 +1,5 @@
1
1
 
2
- import { f as FileUploadConfig, i as BaseUploadOptions } from "../../decorators-CQ93ak6Z.mjs";
2
+ import { i as BaseUploadOptions, m as FileUploadConfig } from "../../decorators-D3lBlmud.mjs";
3
3
  import { NextFunction, Request, RequestHandler, Response } from "express";
4
4
  import { Options } from "multer";
5
5
 
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
 
2
- import { r as AppAdapter, t as AdapterContext } from "../../adapter-BqGjZCSm.mjs";
2
+ import { r as AppAdapter, t as AdapterContext } from "../../adapter-wuoBNkNs.mjs";
3
3
  //#region src/http/middleware/views.d.ts
4
4
  interface ViewAdapterOptions {
5
5
  /**
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,7 +9,7 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { Logger } from "../../core/logger.mjs";
12
- import "../../core-BL_H8fEZ.mjs";
12
+ import "../../core-CXHuViXn.mjs";
13
13
  import { resolve } from "node:path";
14
14
  //#region src/http/middleware/views.ts
15
15
  const log = Logger.for("ViewEngine");
@@ -1,3 +1,3 @@
1
1
 
2
- import { _ as StringQueryFieldConfig, a as parseSearchQuery, c as FILTER_OPERATORS, d as PaginatedResponse, f as PaginationParams, g as SortItem, h as QueryFieldConfig, i as parseQuery, l as FilterItem, m as QueryBuilderAdapter, n as parseFilters, o as parseSort, p as ParsedQuery, r as parsePagination, s as ColumnQueryFieldConfig, t as buildQueryParams, u as FilterOperator } from "../../index-Cls52etj.mjs";
3
- export { ColumnQueryFieldConfig, FILTER_OPERATORS, FilterItem, FilterOperator, PaginatedResponse, PaginationParams, ParsedQuery, QueryBuilderAdapter, QueryFieldConfig, SortItem, StringQueryFieldConfig, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
2
+ import { _ as SortItem, a as parseSearchQuery, c as FILTER_OPERATORS, d as FilterOperator, f as PaginatedResponse, g as QueryFieldConfig, h as QueryBuilderAdapter, i as parseQuery, l as FieldsOf, m as ParsedQuery, n as parseFilters, o as parseSort, p as PaginationParams, r as parsePagination, s as ColumnQueryFieldConfig, t as buildQueryParams, u as FilterItem, v as StringQueryFieldConfig, y as TypedParsedQuery } from "../../index-rnK23QBD.mjs";
3
+ export { ColumnQueryFieldConfig, FILTER_OPERATORS, FieldsOf, FilterItem, FilterOperator, PaginatedResponse, PaginationParams, ParsedQuery, QueryBuilderAdapter, QueryFieldConfig, SortItem, StringQueryFieldConfig, TypedParsedQuery, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "../../query-7cdHF6ry.mjs";
11
+ import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "../../query-BSIApo6Y.mjs";
12
12
  export { FILTER_OPERATORS, buildQueryParams, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,9 +9,9 @@
9
9
  * @license MIT
10
10
  */
11
11
  import { METADATA } from "../core/interfaces.mjs";
12
- import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-fmvikBA0.mjs";
13
- import { Container } from "../core/container.mjs";
14
- import "../core-BL_H8fEZ.mjs";
12
+ import { a as getMethodMeta, o as getMethodMetaOrUndefined, t as getClassMeta } from "../metadata-D5L3_cdl.mjs";
13
+ import { t as Container } from "../container-BKiJzakw.mjs";
14
+ import "../core-CXHuViXn.mjs";
15
15
  import { RequestContext } from "./context.mjs";
16
16
  import { validate } from "./middleware/validate.mjs";
17
17
  import { buildUploadMiddleware } from "./middleware/upload.mjs";
@@ -104,4 +104,4 @@ declare class CircuitBreaker {
104
104
  }
105
105
  //#endregion
106
106
  export { setInMetaRecord as _, CircuitOpenError as a, getMetaMap as c, getMethodMetaOrUndefined as d, hasClassMeta as f, setInMetaMap as g, setClassMeta as h, CircuitBreakerStats as i, getMetaRecord as l, pushMethodMeta as m, CircuitBreakerOptions as n, getClassMeta as o, pushClassMeta as p, CircuitBreakerState as r, getClassMetaOrUndefined as s, CircuitBreaker as t, getMethodMeta as u, setMethodMeta as v };
107
- //# sourceMappingURL=index-C0gbnpSg.d.mts.map
107
+ //# sourceMappingURL=index-4VM4dUJf.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index-C0gbnpSg.d.mts","names":[],"sources":["../src/core/metadata.ts","../src/core/circuit-breaker.ts"],"mappings":";;;;;;;;;KAUK,OAAA;;iBAKW,YAAA,GAAA,CAAgB,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,CAAA,EAAG,MAAA;AAf/B;AAAA,iBAoBT,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,CAAA,EAAG,MAAA,UAAgB,MAAA;;iBAOzD,YAAA,GAAA,CAAgB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,QAAA,EAAU,CAAA,GAAI,CAAA;;iBAK5D,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,MAAA,UAAgB,QAAA,EAAU,CAAA,GAAI,CAAA;;iBAK7E,YAAA,CAAa,GAAA,EAAK,OAAA,EAAS,MAAA;;iBAK3B,uBAAA,GAAA,CAA2B,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,CAAA;;iBAK1D,wBAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,WACC,CAAA;;iBAOa,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,aAAmB,KAAA,EAAO,CAAA;;iBAMzD,cAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,aACG,KAAA,EAAO,CAAA;;iBASI,YAAA,MAAA,CAAmB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,MAAA,EAAQ,CAAA,EAAG,QAAA,EAAU,CAAA;;iBAQtE,UAAA,MAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,GAAA,CAAI,CAAA,EAAG,CAAA;;iBAOvD,eAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,mBACA,QAAA,EAAU,CAAA;;iBASI,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,MAAA,kBAAwB,CAAA;;;;;;;;;;;;;;AAzG/D;;;;;AAezB;KCGY,mBAAA;AAAA,UAEK,qBAAA;EDLqC;ECOpD,gBAAA;EDPmC;ECSnC,YAAA;EDTmD;ECWnD,WAAA;AAAA;AAAA,UAGe,mBAAA;EACf,QAAA;EACA,SAAA;EACA,KAAA,EAAO,mBAAA;EACP,WAAA,GAAc,IAAA;AAAA;;;;cAMH,gBAAA,SAAyB,KAAA;EAAA,SACR,WAAA;cAAA,WAAA;AAAA;AAAA,cAMjB,cAAA;EAAA,SAaO,IAAA;EAAA,QAZV,KAAA;EAAA,QACA,QAAA;EAAA,QACA,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,WAAA;EAAA,QACA,QAAA;EAAA,iBAES,gBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,WAAA;cAGC,IAAA,UAChB,OAAA,EAAS,qBAAA;EDjCmB;;;;EC4CxB,OAAA,GAAA,CAAW,EAAA,QAAU,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;ED5C2B;ECsE3E,QAAA,CAAA,GAAY,mBAAA;EDjEE;ECuEd,QAAA,CAAA,GAAY,mBAAA;EDvEe;ECkF3B,KAAA,CAAA;EAAA,QASQ,SAAA;EAAA,QAWA,SAAA;EAAA,QAeA,yBAAA;AAAA"}
1
+ {"version":3,"file":"index-4VM4dUJf.d.mts","names":[],"sources":["../src/core/metadata.ts","../src/core/circuit-breaker.ts"],"mappings":";;;;;;;;;KAUK,OAAA;;iBAKW,YAAA,GAAA,CAAgB,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,CAAA,EAAG,MAAA;AAf/B;AAAA,iBAoBT,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,CAAA,EAAG,MAAA,UAAgB,MAAA;;iBAOzD,YAAA,GAAA,CAAgB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,QAAA,EAAU,CAAA,GAAI,CAAA;;iBAK5D,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,MAAA,UAAgB,QAAA,EAAU,CAAA,GAAI,CAAA;;iBAK7E,YAAA,CAAa,GAAA,EAAK,OAAA,EAAS,MAAA;;iBAK3B,uBAAA,GAAA,CAA2B,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,CAAA;;iBAK1D,wBAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,WACC,CAAA;;iBAOa,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,aAAmB,KAAA,EAAO,CAAA;;iBAMzD,cAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,aACG,KAAA,EAAO,CAAA;;iBASI,YAAA,MAAA,CAAmB,GAAA,EAAK,OAAA,EAAS,MAAA,UAAgB,MAAA,EAAQ,CAAA,EAAG,QAAA,EAAU,CAAA;;iBAQtE,UAAA,MAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,GAAA,CAAI,CAAA,EAAG,CAAA;;iBAOvD,eAAA,GAAA,CACd,GAAA,EAAK,OAAA,EACL,MAAA,UACA,MAAA,mBACA,QAAA,EAAU,CAAA;;iBASI,aAAA,GAAA,CAAiB,GAAA,EAAK,OAAA,EAAS,MAAA,WAAiB,MAAA,kBAAwB,CAAA;;;;;;;;;;;;;;AAzG/D;;;;;AAezB;KCGY,mBAAA;AAAA,UAEK,qBAAA;EDLqC;ECOpD,gBAAA;EDPmC;ECSnC,YAAA;EDTmD;ECWnD,WAAA;AAAA;AAAA,UAGe,mBAAA;EACf,QAAA;EACA,SAAA;EACA,KAAA,EAAO,mBAAA;EACP,WAAA,GAAc,IAAA;AAAA;;;;cAMH,gBAAA,SAAyB,KAAA;EAAA,SACR,WAAA;cAAA,WAAA;AAAA;AAAA,cAMjB,cAAA;EAAA,SAaO,IAAA;EAAA,QAZV,KAAA;EAAA,QACA,QAAA;EAAA,QACA,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,WAAA;EAAA,QACA,QAAA;EAAA,iBAES,gBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,WAAA;cAGC,IAAA,UAChB,OAAA,EAAS,qBAAA;EDjCmB;;;;EC4CxB,OAAA,GAAA,CAAW,EAAA,QAAU,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;ED5C2B;ECsE3E,QAAA,CAAA,GAAY,mBAAA;EDjEE;ECuEd,QAAA,CAAA,GAAY,mBAAA;EDvEe;ECkF3B,KAAA,CAAA;EAAA,QASQ,SAAA;EAAA,QAWA,SAAA;EAAA,QAeA,yBAAA;AAAA"}
@@ -28,6 +28,42 @@ interface ParsedQuery {
28
28
  pagination: PaginationParams;
29
29
  search: string;
30
30
  }
31
+ /**
32
+ * Helper that extracts the literal field union from a `QueryFieldConfig`
33
+ * key. When the user passes `{ filterable: ['status', 'category'] } as const`,
34
+ * `FieldsOf<typeof config, 'filterable'>` resolves to `'status' | 'category'`.
35
+ *
36
+ * Without `as const`, the arrays widen to `string[]` and the union falls
37
+ * back to `string`. This is the documented escape hatch.
38
+ */
39
+ type FieldsOf<TConfig extends QueryFieldConfig | undefined, K extends 'filterable' | 'sortable' | 'searchable'> = TConfig extends { readonly [P in K]: readonly (infer F)[] } ? F extends string ? F : string : TConfig extends {
40
+ columns: infer C;
41
+ } ? K extends 'filterable' ? keyof C & string : string : string;
42
+ /**
43
+ * Narrowed `ParsedQuery` whose `filters[].field` and `sort[].field`
44
+ * unions are constrained to the literal whitelist passed to
45
+ * `ctx.qs()` / `parseQuery()`. Extends `ParsedQuery`, so any function
46
+ * accepting `ParsedQuery` accepts a `TypedParsedQuery<X>` automatically
47
+ * (subtype assignment, no codegen, backward compatible).
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * const parsed = ctx.qs({
52
+ * filterable: ['status', 'priority'],
53
+ * sortable: ['createdAt'],
54
+ * } as const)
55
+ * parsed.filters[0]?.field // 'status' | 'priority'
56
+ * parsed.sort[0]?.field // 'createdAt'
57
+ * ```
58
+ */
59
+ interface TypedParsedQuery<TConfig extends QueryFieldConfig | undefined> extends ParsedQuery {
60
+ filters: Array<FilterItem & {
61
+ field: FieldsOf<TConfig, 'filterable'>;
62
+ }>;
63
+ sort: Array<SortItem & {
64
+ field: FieldsOf<TConfig, 'sortable'>;
65
+ }>;
66
+ }
31
67
  /**
32
68
  * Restrict which fields can be filtered, sorted, or searched.
33
69
  * Fields not in the allow-list are silently ignored.
@@ -140,9 +176,9 @@ declare function parseSearchQuery(q: string | undefined): string;
140
176
  *
141
177
  * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends
142
178
  */
143
- declare function parseQuery(query: Record<string, any>, fieldConfig?: QueryFieldConfig): ParsedQuery;
179
+ declare function parseQuery<TConfig extends QueryFieldConfig | undefined = undefined>(query: Record<string, any>, fieldConfig?: TConfig): TypedParsedQuery<TConfig>;
144
180
  /** Convert ParsedQuery back into query string parameters */
145
181
  declare function buildQueryParams(parsed: Partial<ParsedQuery>): Record<string, string | string[] | number>;
146
182
  //#endregion
147
- export { StringQueryFieldConfig as _, parseSearchQuery as a, FILTER_OPERATORS as c, PaginatedResponse as d, PaginationParams as f, SortItem as g, QueryFieldConfig as h, parseQuery as i, FilterItem as l, QueryBuilderAdapter as m, parseFilters as n, parseSort as o, ParsedQuery as p, parsePagination as r, ColumnQueryFieldConfig as s, buildQueryParams as t, FilterOperator as u };
148
- //# sourceMappingURL=index-Cls52etj.d.mts.map
183
+ export { SortItem as _, parseSearchQuery as a, FILTER_OPERATORS as c, FilterOperator as d, PaginatedResponse as f, QueryFieldConfig as g, QueryBuilderAdapter as h, parseQuery as i, FieldsOf as l, ParsedQuery as m, parseFilters as n, parseSort as o, PaginationParams as p, parsePagination as r, ColumnQueryFieldConfig as s, buildQueryParams as t, FilterItem as u, StringQueryFieldConfig as v, TypedParsedQuery as y };
184
+ //# sourceMappingURL=index-rnK23QBD.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-rnK23QBD.d.mts","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"mappings":";;;KACY,cAAA;AAAA,cAaC,gBAAA,EAAgB,GAAA;AAAA,UAcZ,UAAA;EACf,KAAA;EACA,QAAA,EAAU,cAAA;EACV,KAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,SAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;AARF;UAgBiB,WAAA;EACf,OAAA,EAAS,UAAA;EACT,IAAA,EAAM,QAAA;EACN,UAAA,EAAY,gBAAA;EACZ,MAAA;AAAA;;;;;;;;AAJF;KAeY,QAAA,iBACM,gBAAA,oEAEd,OAAA,0BAAiC,CAAA,4BACjC,CAAA,kBACE,CAAA,YAEF,OAAA;EAAkB,OAAA;AAAA,IAChB,CAAA,8BACQ,CAAA;;;;;;;;;;;;AATd;;;;;;UA8BiB,gBAAA,iBACC,gBAAA,sBACR,WAAA;EACR,OAAA,EAAS,KAAA,CAAM,UAAA;IAAe,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;EAC9C,IAAA,EAAM,KAAA,CAAM,QAAA;IAAa,KAAA,EAAO,QAAA,CAAS,OAAA;EAAA;AAAA;;;;;;;;;;;KAa/B,gBAAA,GAAmB,sBAAA,GAAyB,sBAAA;AAAA,UAEvC,sBAAA;EACf,UAAA;EACA,QAAA;EACA,UAAA;AAAA;;;;;UAOe,sBAAA;EACf,OAAA,EAAS,MAAA;EACT,QAAA,GAAW,MAAA;EACX,aAAA;EAAA,CACC,GAAA;AAAA;;UAIc,iBAAA;EACf,IAAA,EAAM,CAAA;EACN,IAAA;IACE,IAAA;IACA,KAAA;IACA,KAAA;IACA,UAAA;IACA,OAAA;IACA,OAAA;EAAA;AAAA;;;;;;;;AA5BJ;;;;;AAEA;;;;;;;;;AAUA;;UA2CiB,mBAAA;EAzCE;EAAA,SA2CR,IAAA;EA5CA;;;;;EAmDT,KAAA,CAAM,MAAA,EAAQ,WAAA,EAAa,MAAA,EAAQ,OAAA,GAAU,OAAA;AAAA;;;AA/K/C;AAAA,iBCmBgB,YAAA,CACd,WAAA,iCACA,aAAA,cACC,UAAA;;iBA8Ba,SAAA,CACd,SAAA,iCACA,aAAA,cACC,QAAA;;iBA0Ba,eAAA,CAAgB,MAAA;EAC9B,IAAA;EACA,KAAA;AAAA,IACE,gBAAA;;iBAkBY,gBAAA,CAAiB,CAAA;;;;;;;;;;ADrEjC;;;;;AAKA;;;;;;;;;AAWA;;;;;iBC+GgB,UAAA,iBAA2B,gBAAA,yBAAA,CACzC,KAAA,EAAO,MAAA,eACP,WAAA,GAAc,OAAA,GACb,gBAAA,CAAiB,OAAA;;iBAaJ,gBAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,WAAA,IACf,MAAA"}
package/dist/index.d.mts CHANGED
@@ -1,21 +1,21 @@
1
1
 
2
- import { a as METADATA, c as Scope, i as Constructor, l as ServiceOptions, n as BuilderOf, o as MaybePromise, r as ClassKind, s as PostConstructStatus, t as Buildable } from "./interfaces-D-48zotH.mjs";
3
- import { i as tokenName, n as ContainerChangeEvent, r as ContainerChangeListener, t as Container } from "./container-nBSIhyqV.mjs";
4
- import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-BqGjZCSm.mjs";
5
- import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-CcEbAVtB.mjs";
6
- import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider } from "./cache-DJeMaGqb.mjs";
7
- import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-RKhH5TOd.mjs";
8
- import { C as RouteDefinition, E as normalizeApiQueryParamsConfig, S as Repository, T as Value, _ as MiddlewareHandler, a as Builder, b as PostConstruct, c as Controller, d as FileUpload, f as FileUploadConfig, g as Middleware, h as Injectable, i as BaseUploadOptions, l as Delete, m as Inject, n as ApiQueryParamsConfig, o as ColumnApiQueryParamsConfig, p as Get, r as Autowired, s as Component, t as ApiQueryParams, u as FileTypeFilter, v as Patch, w as Service, x as Put, y as Post } from "./decorators-CQ93ak6Z.mjs";
9
- import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-te5Km00o.mjs";
10
- import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-Dzj-TF0t.mjs";
11
- import { n as normalizePath, t as joinPaths } from "./path-LmwfhfyH.mjs";
12
- import { t as KickPlugin } from "./plugin-DIoPIpSm.mjs";
13
- 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-BbS-99ow.mjs";
14
- import { _ as setInMetaRecord, a as CircuitOpenError, c as getMetaMap, d as getMethodMetaOrUndefined, f as hasClassMeta, g as setInMetaMap, h as setClassMeta, i as CircuitBreakerStats, l as getMetaRecord, m as pushMethodMeta, n as CircuitBreakerOptions, o as getClassMeta, p as pushClassMeta, r as CircuitBreakerState, s as getClassMetaOrUndefined, t as CircuitBreaker, u as getMethodMeta, v as setMethodMeta } from "./index-C0gbnpSg.mjs";
2
+ import { a as METADATA, c as Scope, i as Constructor, l as ServiceOptions, n as BuilderOf, o as MaybePromise, r as ClassKind, s as PostConstructStatus, t as Buildable } from "./interfaces-D5ohYl6D.mjs";
3
+ import { a as tokenName, c as createToken, i as KickJsRegistry, l as isInjectionToken, n as ContainerChangeEvent, o as INJECTION_TOKEN, r as ContainerChangeListener, s as InjectionToken, t as Container } from "./container-CcgV8eHL.mjs";
4
+ import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-wuoBNkNs.mjs";
5
+ import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-DOBmxARW.mjs";
6
+ import { a as Cacheable, c as setCacheProvider, i as CacheProvider, n as CacheEvict, o as MemoryCacheProvider, r as CacheOptions, s as getCacheProvider } from "./cache-PufEhr0n.mjs";
7
+ import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-C29iHvHT.mjs";
8
+ import { C as Put, D as Value, E as Service, O as normalizeApiQueryParamsConfig, S as PostConstruct, T as RouteDefinition, _ as Injectable, a as Builder, b as Patch, c as Controller, d as EnvKey, f as FileTypeFilter, g as Inject, h as Get, i as BaseUploadOptions, l as Delete, m as FileUploadConfig, n as ApiQueryParamsConfig, o as ColumnApiQueryParamsConfig, p as FileUpload, r as Autowired, s as Component, t as ApiQueryParams, u as Env, v as Middleware, w as Repository, x as Post, y as MiddlewareHandler } from "./decorators-D3lBlmud.mjs";
9
+ import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-BZUdxtjC.mjs";
10
+ import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-BLdfUF5b.mjs";
11
+ import { n as normalizePath, t as joinPaths } from "./path-Dq5V-i-x.mjs";
12
+ import { t as KickPlugin } from "./plugin-D20muJwC.mjs";
13
+ 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";
14
+ import { _ as setInMetaRecord, a as CircuitOpenError, c as getMetaMap, d as getMethodMetaOrUndefined, f as hasClassMeta, g as setInMetaMap, h as setClassMeta, i as CircuitBreakerStats, l as getMetaRecord, m as pushMethodMeta, n as CircuitBreakerOptions, o as getClassMeta, p as pushClassMeta, r as CircuitBreakerState, s as getClassMetaOrUndefined, t as CircuitBreaker, u as getMethodMeta, v as setMethodMeta } from "./index-4VM4dUJf.mjs";
15
15
  import { Application, ApplicationOptions, MiddlewareEntry } from "./http/application.mjs";
16
16
  import { bootstrap } from "./http/bootstrap.mjs";
17
- import { a as parseSearchQuery, c as FILTER_OPERATORS, d as PaginatedResponse, f as PaginationParams, g as SortItem, h as QueryFieldConfig, i as parseQuery, l as FilterItem, m as QueryBuilderAdapter, n as parseFilters, o as parseSort, p as ParsedQuery, r as parsePagination, t as buildQueryParams, u as FilterOperator } from "./index-Cls52etj.mjs";
18
- import { RequestContext } from "./http/context.mjs";
17
+ import { _ as SortItem, a as parseSearchQuery, c as FILTER_OPERATORS, d as FilterOperator, f as PaginatedResponse, g as QueryFieldConfig, h as QueryBuilderAdapter, i as parseQuery, l as FieldsOf, m as ParsedQuery, n as parseFilters, o as parseSort, p as PaginationParams, r as parsePagination, t as buildQueryParams, u as FilterItem, y as TypedParsedQuery } from "./index-rnK23QBD.mjs";
18
+ import { Ctx, RequestContext, RouteShape } from "./http/context.mjs";
19
19
  import { CorsOptions, cors } from "./http/middleware/cors.mjs";
20
20
  import { CsrfOptions, csrf } from "./http/middleware/csrf.mjs";
21
21
  import { errorHandler, notFoundHandler } from "./http/middleware/error-handler.mjs";
@@ -129,5 +129,5 @@ declare function parseTraceparent(header: string): TraceContext | null;
129
129
  */
130
130
  declare function traceContext(options?: TraceContextOptions): (req: Request, res: Response, next: NextFunction) => void;
131
131
  //#endregion
132
- export { AdapterContext, AdapterMiddleware, ApiQueryParams, ApiQueryParamsConfig, ApiQueryParamsConfig as QueryParamsConfig, AppAdapter, AppAdapterClass, AppModule, AppModuleClass, Application, type ApplicationOptions, Autowired, BaseUploadOptions, Buildable, Builder, BuilderOf, CRON_META, CacheEvict, CacheOptions, CacheProvider, Cacheable, CircuitBreaker, CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerStats, CircuitOpenError, ClassKind, type ClusterOptions, ColumnApiQueryParamsConfig, Component, ComputedRef, ConsoleLoggerProvider, Constructor, Container, ContainerChangeEvent, ContainerChangeListener, Controller, type CorsOptions, Cron, CronJobMeta, type CsrfOptions, Delete, FILTER_OPERATORS, FileTypeFilter, FileUpload, FileUploadConfig, type FilterItem, type FilterOperator, Get, type HelmetOptions, HttpException, HttpStatus, HttpStatusCode, Inject, Injectable, KickPlugin, Logger, LoggerProvider, METADATA, MaybePromise, MemoryCacheProvider, Middleware, type MiddlewareEntry, MiddlewareHandler, MiddlewarePhase, ModuleRoutes, type PaginatedResponse, type PaginationParams, type ParsedQuery, Patch, Post, PostConstruct, PostConstructStatus, Put, type QueryBuilderAdapter, type QueryFieldConfig, REQUEST_ID_HEADER, type RateLimitOptions, type RateLimitStore, Ref, Repository, RequestContext, type RequestLoggerOptions, type RequestStore, RouteDefinition, Scope, Service, ServiceOptions, type Session, type SessionData, type SessionOptions, type SessionStore, type SortItem, SpaAdapter, type SpaAdapterOptions, TRACEPARENT_HEADER, type TraceContext, type TraceContextOptions, type UploadOptions, ValidationError, Value, ViewAdapter, type ViewAdapterOptions, WatchOptions, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isRef, joinPaths, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, requestId, requestLogger, requestScopeMiddleware, requestStore, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
132
+ export { AdapterContext, AdapterMiddleware, ApiQueryParams, ApiQueryParamsConfig, ApiQueryParamsConfig as QueryParamsConfig, AppAdapter, AppAdapterClass, AppModule, AppModuleClass, Application, type ApplicationOptions, Autowired, BaseUploadOptions, Buildable, Builder, BuilderOf, CRON_META, CacheEvict, CacheOptions, CacheProvider, Cacheable, CircuitBreaker, CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerStats, CircuitOpenError, ClassKind, type ClusterOptions, ColumnApiQueryParamsConfig, Component, ComputedRef, ConsoleLoggerProvider, Constructor, Container, ContainerChangeEvent, ContainerChangeListener, Controller, type CorsOptions, Cron, CronJobMeta, type CsrfOptions, type Ctx, Delete, Env, EnvKey, FILTER_OPERATORS, type FieldsOf, FileTypeFilter, FileUpload, FileUploadConfig, type FilterItem, type FilterOperator, Get, type HelmetOptions, HttpException, HttpStatus, HttpStatusCode, INJECTION_TOKEN, Inject, Injectable, InjectionToken, KickJsRegistry, KickPlugin, Logger, LoggerProvider, METADATA, MaybePromise, MemoryCacheProvider, Middleware, type MiddlewareEntry, MiddlewareHandler, MiddlewarePhase, ModuleRoutes, type PaginatedResponse, type PaginationParams, type ParsedQuery, Patch, Post, PostConstruct, PostConstructStatus, Put, type QueryBuilderAdapter, type QueryFieldConfig, REQUEST_ID_HEADER, type RateLimitOptions, type RateLimitStore, Ref, Repository, RequestContext, type RequestLoggerOptions, type RequestStore, RouteDefinition, type RouteShape, Scope, Service, ServiceOptions, type Session, type SessionData, type SessionOptions, type SessionStore, type SortItem, SpaAdapter, type SpaAdapterOptions, TRACEPARENT_HEADER, type TraceContext, type TraceContextOptions, type TypedParsedQuery, type UploadOptions, ValidationError, Value, ViewAdapter, type ViewAdapterOptions, WatchOptions, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, createToken, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, isRef, joinPaths, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, requestId, requestLogger, requestScopeMiddleware, requestStore, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
133
133
  //# sourceMappingURL=index.d.mts.map
package/dist/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -10,20 +10,20 @@
10
10
  */
11
11
  import { METADATA, Scope } from "./core/interfaces.mjs";
12
12
  import { ConsoleLoggerProvider, Logger, createLogger, logger, rootLogger } from "./core/logger.mjs";
13
- import { a as getMethodMeta, c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, i as getMetaRecord, l as pushMethodMeta, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, p as setMethodMeta, r as getMetaMap, s as hasClassMeta, t as getClassMeta, u as setClassMeta } from "./metadata-fmvikBA0.mjs";
14
- import { Container, tokenName } from "./core/container.mjs";
13
+ import { a as getMethodMeta, c as pushClassMeta, d as setInMetaMap, f as setInMetaRecord, i as getMetaRecord, l as pushMethodMeta, n as getClassMetaOrUndefined, o as getMethodMetaOrUndefined, p as setMethodMeta, r as getMetaMap, s as hasClassMeta, t as getClassMeta, u as setClassMeta } from "./metadata-D5L3_cdl.mjs";
14
+ import { a as isInjectionToken, i as createToken, n as tokenName, r as INJECTION_TOKEN, t as Container } from "./container-BKiJzakw.mjs";
15
15
  import { ApiQueryParams, Autowired, Builder, Component, Controller, Delete, FileUpload, Get, Inject, Injectable, Middleware, Patch, Post, PostConstruct, Put, Repository, Service, Value, normalizeApiQueryParamsConfig } from "./core/decorators.mjs";
16
16
  import { CRON_META, Cron, getCronJobs } from "./core/cron.mjs";
17
17
  import { CacheEvict, Cacheable, MemoryCacheProvider, getCacheProvider, setCacheProvider } from "./core/cache.mjs";
18
18
  import { HttpException, HttpStatus } from "./core/errors.mjs";
19
19
  import { joinPaths, normalizePath } from "./core/path.mjs";
20
- import { n as CircuitOpenError, t as CircuitBreaker } from "./core-BL_H8fEZ.mjs";
20
+ import { n as CircuitOpenError, t as CircuitBreaker } from "./core-CXHuViXn.mjs";
21
21
  import { computed, isRef, reactive, ref, toRefs, unref, watch } from "./core/reactivity.mjs";
22
22
  import { REQUEST_ID_HEADER, requestId } from "./http/middleware/request-id.mjs";
23
23
  import { errorHandler, notFoundHandler } from "./http/middleware/error-handler.mjs";
24
- import { i as requestStore, n as requestScopeMiddleware, r as getRequestStore, t as Application } from "./application-DNHj-_UL.mjs";
25
- import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-DLEZaJ3b.mjs";
26
- import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "./query-7cdHF6ry.mjs";
24
+ import { i as requestStore, n as requestScopeMiddleware, r as getRequestStore, t as Application } from "./application-cYhTEy84.mjs";
25
+ import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-8_iBHhWp.mjs";
26
+ import { a as parseSearchQuery, i as parseQuery, n as parseFilters, o as parseSort, r as parsePagination, s as FILTER_OPERATORS, t as buildQueryParams } from "./query-BSIApo6Y.mjs";
27
27
  import { RequestContext } from "./http/context.mjs";
28
28
  import { validate } from "./http/middleware/validate.mjs";
29
29
  import { buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload } from "./http/middleware/upload.mjs";
@@ -121,6 +121,6 @@ function traceContext(options = {}) {
121
121
  };
122
122
  }
123
123
  //#endregion
124
- export { ApiQueryParams, Application, Autowired, Builder, CRON_META, CacheEvict, Cacheable, CircuitBreaker, CircuitOpenError, Component, ConsoleLoggerProvider, Container, Controller, Cron, Delete, FILTER_OPERATORS, FileUpload, Get, HttpException, HttpStatus, Inject, Injectable, Logger, METADATA, MemoryCacheProvider, Middleware, Patch, Post, PostConstruct, Put, REQUEST_ID_HEADER, Repository, RequestContext, Scope, Service, SpaAdapter, TRACEPARENT_HEADER, Value, ViewAdapter, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isRef, joinPaths, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, requestId, requestLogger, requestScopeMiddleware, requestStore, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
124
+ export { ApiQueryParams, Application, Autowired, Builder, CRON_META, CacheEvict, Cacheable, CircuitBreaker, CircuitOpenError, Component, ConsoleLoggerProvider, Container, Controller, Cron, Delete, FILTER_OPERATORS, FileUpload, Get, HttpException, HttpStatus, INJECTION_TOKEN, Inject, Injectable, Logger, METADATA, MemoryCacheProvider, Middleware, Patch, Post, PostConstruct, Put, REQUEST_ID_HEADER, Repository, RequestContext, Scope, Service, SpaAdapter, TRACEPARENT_HEADER, Value, ViewAdapter, bootstrap, buildQueryParams, buildRoutes, buildUploadMiddleware, cleanupFiles, computed, cors, createLogger, createToken, csrf, errorHandler, getCacheProvider, getClassMeta, getClassMetaOrUndefined, getControllerPath, getCronJobs, getMetaMap, getMetaRecord, getMethodMeta, getMethodMetaOrUndefined, getRequestStore, hasClassMeta, helmet, isClusterPrimary, isInjectionToken, isRef, joinPaths, logger, normalizeApiQueryParamsConfig, normalizePath, notFoundHandler, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, parseTraceparent, pushClassMeta, pushMethodMeta, rateLimit, reactive, ref, requestId, requestLogger, requestScopeMiddleware, requestStore, resolveMimeTypes, rootLogger, session, setCacheProvider, setClassMeta, setInMetaMap, setInMetaRecord, setMethodMeta, toRefs, tokenName, traceContext, unref, upload, validate, watch };
125
125
 
126
126
  //# sourceMappingURL=index.mjs.map
@@ -49,4 +49,4 @@ declare const METADATA: {
49
49
  };
50
50
  //#endregion
51
51
  export { METADATA as a, Scope as c, Constructor as i, ServiceOptions as l, BuilderOf as n, MaybePromise as o, ClassKind as r, PostConstructStatus as s, Buildable as t };
52
- //# sourceMappingURL=interfaces-D-48zotH.d.mts.map
52
+ //# sourceMappingURL=interfaces-D5ohYl6D.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces-D-48zotH.d.mts","names":[],"sources":["../src/core/interfaces.ts"],"mappings":";;;aAGY,KAAA;EACV,SAAA;EACA,SAAA;;EAEA,OAAA;AAAA;;KAIU,WAAA,oBAA+B,IAAA,YAAgB,CAAA;;KAG/C,YAAA,aAAyB,CAAA,GAAI,OAAA,CAAQ,CAAA;AAHjD;AAAA,UAMiB,cAAA;EACf,KAAA,GAAQ,KAAA;AAAA;;KAIE,SAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,UAAW,QAAA,WAAmB,CAAA,MAAO,KAAA,EAAO,CAAA,CAAE,CAAA,MAAO,SAAA,CAAU,CAAA;EAC9E,KAAA,IAAS,CAAA;AAAA;;UAGE,SAAA;EACf,OAAA,IAAW,SAAA,CAAU,CAAA;AAAA;;KAIX,SAAA;;KAWA,mBAAA;;cAGC,QAAA;EAAA"}
1
+ {"version":3,"file":"interfaces-D5ohYl6D.d.mts","names":[],"sources":["../src/core/interfaces.ts"],"mappings":";;;aAGY,KAAA;EACV,SAAA;EACA,SAAA;;EAEA,OAAA;AAAA;;KAIU,WAAA,oBAA+B,IAAA,YAAgB,CAAA;;KAG/C,YAAA,aAAyB,CAAA,GAAI,OAAA,CAAQ,CAAA;AAHjD;AAAA,UAMiB,cAAA;EACf,KAAA,GAAQ,KAAA;AAAA;;KAIE,SAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,UAAW,QAAA,WAAmB,CAAA,MAAO,KAAA,EAAO,CAAA,CAAE,CAAA,MAAO,SAAA,CAAU,CAAA;EAC9E,KAAA,IAAS,CAAA;AAAA;;UAGE,SAAA;EACf,OAAA,IAAW,SAAA,CAAU,CAAA;AAAA;;KAIX,SAAA;;KAWA,mBAAA;;cAGC,QAAA;EAAA"}
@@ -116,4 +116,4 @@ declare function createLogger(name: string): Logger;
116
116
  declare const logger: pino.Logger<never, boolean>;
117
117
  //#endregion
118
118
  export { logger as a, createLogger as i, Logger as n, rootLogger as o, LoggerProvider as r, ConsoleLoggerProvider as t };
119
- //# sourceMappingURL=logger-Dzj-TF0t.d.mts.map
119
+ //# sourceMappingURL=logger-BLdfUF5b.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"logger-Dzj-TF0t.d.mts","names":[],"sources":["../src/core/logger.ts"],"mappings":";;;;;cAKa,UAAA,EAAU,IAAA,CAAA,MAAA;AAAvB;;;;;AA0BA;AA1BA,UA0BiB,cAAA;EACf,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,EAAO,GAAA,aAAgB,IAAA;EACvB,KAAA,EAAO,GAAA,aAAgB,IAAA;EAJlB;EAML,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;cA0C7B,qBAAA,YAAiC,cAAA;EAAA,QACpC,MAAA;cAEI,MAAA;EAAA,QAIJ,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cAoC7B,MAAA;EAAA,QACH,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,KAAA;EAvC8C;;AAoCxD;;;EApCwD,OA8C/C,gBAAA,SAAyB,MAAA;EA8BH;EAAA,eA3Bd,gBAAA;cAEH,IAAA;EAyDS;EAAA,YAlDT,QAAA,CAAA;EAkDe;;;;;;;;;;EAAA,OAhCpB,WAAA,CAAY,QAAA,EAAU,cAAA;EAAA;EAAA,OAOtB,WAAA,CAAA,GAAe,cAAA;EAAf;;;;EAAA,OAQA,aAAA,CAAA;EAOmB;EAAA,OAAnB,GAAA,CAAI,IAAA,WAAe,MAAA;EAUpB;EAAN,KAAA,CAAM,IAAA,WAAe,MAAA;EAKb;EAAA,QAAA,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,KAAA,CAAM,QAAA,OAAe,GAAA,cAAiB,IAAA;EAUtC,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;AAAA;;iBAMR,YAAA,CAAa,IAAA,WAAe,MAAA;;cAK/B,MAAA,EAAM,IAAA,CAAA,MAAA"}
1
+ {"version":3,"file":"logger-BLdfUF5b.d.mts","names":[],"sources":["../src/core/logger.ts"],"mappings":";;;;;cAKa,UAAA,EAAU,IAAA,CAAA,MAAA;AAAvB;;;;;AA0BA;AA1BA,UA0BiB,cAAA;EACf,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EACrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EACtB,KAAA,EAAO,GAAA,aAAgB,IAAA;EACvB,KAAA,EAAO,GAAA,aAAgB,IAAA;EAJlB;EAML,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;cA0C7B,qBAAA,YAAiC,cAAA;EAAA,QACpC,MAAA;cAEI,MAAA;EAAA,QAIJ,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAGrB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAGtB,KAAA,CAAM,QAAA;IAAY,SAAA;EAAA,IAAsB,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cAoC7B,MAAA;EAAA,QACH,SAAA;EAAA,QACA,gBAAA;EAAA,QACA,KAAA;EAvC8C;;AAoCxD;;;EApCwD,OA8C/C,gBAAA,SAAyB,MAAA;EA8BH;EAAA,eA3Bd,gBAAA;cAEH,IAAA;EAyDS;EAAA,YAlDT,QAAA,CAAA;EAkDe;;;;;;;;;;EAAA,OAhCpB,WAAA,CAAY,QAAA,EAAU,cAAA;EAAA;EAAA,OAOtB,WAAA,CAAA,GAAe,cAAA;EAAf;;;;EAAA,OAQA,aAAA,CAAA;EAOmB;EAAA,OAAnB,GAAA,CAAI,IAAA,WAAe,MAAA;EAUpB;EAAN,KAAA,CAAM,IAAA,WAAe,MAAA;EAKb;EAAA,QAAA,GAAA;EAIR,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,IAAA,CAAK,GAAA,aAAgB,IAAA;EAIrB,KAAA,CAAM,QAAA,OAAe,GAAA,cAAiB,IAAA;EAUtC,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;EAItB,KAAA,CAAM,GAAA,aAAgB,IAAA;AAAA;;iBAMR,YAAA,CAAa,IAAA,WAAe,MAAA;;cAK/B,MAAA,EAAM,IAAA,CAAA,MAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -73,4 +73,4 @@ function getMetaRecord(key, target) {
73
73
  //#endregion
74
74
  export { getMethodMeta as a, pushClassMeta as c, setInMetaMap as d, setInMetaRecord as f, getMetaRecord as i, pushMethodMeta as l, getClassMetaOrUndefined as n, getMethodMetaOrUndefined as o, setMethodMeta as p, getMetaMap as r, hasClassMeta as s, getClassMeta as t, setClassMeta as u };
75
75
 
76
- //# sourceMappingURL=metadata-fmvikBA0.mjs.map
76
+ //# sourceMappingURL=metadata-D5L3_cdl.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"metadata-fmvikBA0.mjs","names":[],"sources":["../src/core/metadata.ts"],"sourcesContent":["import 'reflect-metadata'\n\n/**\n * Typed utilities for reflect-metadata operations.\n *\n * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single\n * source of truth. If we later move to Stage 3 decorators or a WeakMap-based\n * store, only this file changes — all 24+ consumer files stay untouched.\n */\n\ntype MetaKey = symbol | string\n\n// ── Setters ─────────────────────────────────────────────────────\n\n/** Set metadata on a class (or prototype for property decorators) */\nexport function setClassMeta<T>(key: MetaKey, value: T, target: object): void {\n Reflect.defineMetadata(key, value, target)\n}\n\n/** Set metadata on a specific method */\nexport function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void {\n Reflect.defineMetadata(key, value, target, method)\n}\n\n// ── Getters ─────────────────────────────────────────────────────\n\n/** Get metadata from a class, returning `fallback` if not set */\nexport function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T {\n return (Reflect.getMetadata(key, target) as T) ?? fallback\n}\n\n/** Get metadata from a specific method, returning `fallback` if not set */\nexport function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T {\n return (Reflect.getMetadata(key, target, method) as T) ?? fallback\n}\n\n/** Check if metadata exists on a class */\nexport function hasClassMeta(key: MetaKey, target: object): boolean {\n return Reflect.hasMetadata(key, target)\n}\n\n/** Get metadata from a class with no default (returns undefined if absent) */\nexport function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined {\n return Reflect.getMetadata(key, target) as T | undefined\n}\n\n/** Get metadata from a method with no default (returns undefined if absent) */\nexport function getMethodMetaOrUndefined<T>(\n key: MetaKey,\n target: object,\n method: string,\n): T | undefined {\n return Reflect.getMetadata(key, target, method) as T | undefined\n}\n\n// ── Accumulate: Arrays ──────────────────────────────────────────\n\n/** Append items to an array stored in class metadata */\nexport function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target)\n}\n\n/** Append items to an array stored in method metadata */\nexport function pushMethodMeta<T>(\n key: MetaKey,\n target: object,\n method: string,\n ...items: T[]\n): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target, method) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target, method)\n}\n\n// ── Accumulate: Maps ────────────────────────────────────────────\n\n/** Set a key/value in a Map stored in class metadata */\nexport function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void {\n const inherited: Map<K, V> | undefined = Reflect.getOwnMetadata(key, target)\n const map = inherited ? new Map(inherited) : new Map<K, V>()\n map.set(mapKey, mapValue)\n Reflect.defineMetadata(key, map, target)\n}\n\n/** Get a Map from class metadata (returns empty Map if absent) */\nexport function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V> {\n return Reflect.getMetadata(key, target) ?? new Map()\n}\n\n// ── Accumulate: Records ─────────────────────────────────────────\n\n/** Set a key/value in a Record stored in class metadata */\nexport function setInMetaRecord<V>(\n key: MetaKey,\n target: object,\n recKey: string | number,\n recValue: V,\n): void {\n const inherited: Record<string | number, V> | undefined = Reflect.getOwnMetadata(key, target)\n const rec = inherited ? { ...inherited } : {}\n rec[recKey] = recValue\n Reflect.defineMetadata(key, rec, target)\n}\n\n/** Get a Record from class metadata (returns empty object if absent) */\nexport function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V> {\n return Reflect.getMetadata(key, target) ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,aAAgB,KAAc,OAAU,QAAsB;AAC5E,SAAQ,eAAe,KAAK,OAAO,OAAO;;;AAI5C,SAAgB,cAAiB,KAAc,OAAU,QAAgB,QAAsB;AAC7F,SAAQ,eAAe,KAAK,OAAO,QAAQ,OAAO;;;AAMpD,SAAgB,aAAgB,KAAc,QAAgB,UAAgB;AAC5E,QAAQ,QAAQ,YAAY,KAAK,OAAO,IAAU;;;AAIpD,SAAgB,cAAiB,KAAc,QAAgB,QAAgB,UAAgB;AAC7F,QAAQ,QAAQ,YAAY,KAAK,QAAQ,OAAO,IAAU;;;AAI5D,SAAgB,aAAa,KAAc,QAAyB;AAClE,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,wBAA2B,KAAc,QAA+B;AACtF,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,yBACd,KACA,QACA,QACe;AACf,QAAO,QAAQ,YAAY,KAAK,QAAQ,OAAO;;;AAMjD,SAAgB,cAAiB,KAAc,QAAgB,GAAG,OAAkB;CAClF,MAAM,WAAgB,QAAQ,eAAe,KAAK,OAAO,IAAI,EAAE;AAC/D,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO;;;AAI9D,SAAgB,eACd,KACA,QACA,QACA,GAAG,OACG;CACN,MAAM,WAAgB,QAAQ,eAAe,KAAK,QAAQ,OAAO,IAAI,EAAE;AACvE,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,QAAQ,OAAO;;;AAMtE,SAAgB,aAAmB,KAAc,QAAgB,QAAW,UAAmB;CAC7F,MAAM,YAAmC,QAAQ,eAAe,KAAK,OAAO;CAC5E,MAAM,MAAM,YAAY,IAAI,IAAI,UAAU,mBAAG,IAAI,KAAW;AAC5D,KAAI,IAAI,QAAQ,SAAS;AACzB,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,WAAiB,KAAc,QAA2B;AACxE,QAAO,QAAQ,YAAY,KAAK,OAAO,oBAAI,IAAI,KAAK;;;AAMtD,SAAgB,gBACd,KACA,QACA,QACA,UACM;CACN,MAAM,YAAoD,QAAQ,eAAe,KAAK,OAAO;CAC7F,MAAM,MAAM,YAAY,EAAE,GAAG,WAAW,GAAG,EAAE;AAC7C,KAAI,UAAU;AACd,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,cAAiB,KAAc,QAA4C;AACzF,QAAO,QAAQ,YAAY,KAAK,OAAO,IAAI,EAAE"}
1
+ {"version":3,"file":"metadata-D5L3_cdl.mjs","names":[],"sources":["../src/core/metadata.ts"],"sourcesContent":["import 'reflect-metadata'\n\n/**\n * Typed utilities for reflect-metadata operations.\n *\n * Replaces scattered Reflect.defineMetadata/getMetadata calls with a single\n * source of truth. If we later move to Stage 3 decorators or a WeakMap-based\n * store, only this file changes — all 24+ consumer files stay untouched.\n */\n\ntype MetaKey = symbol | string\n\n// ── Setters ─────────────────────────────────────────────────────\n\n/** Set metadata on a class (or prototype for property decorators) */\nexport function setClassMeta<T>(key: MetaKey, value: T, target: object): void {\n Reflect.defineMetadata(key, value, target)\n}\n\n/** Set metadata on a specific method */\nexport function setMethodMeta<T>(key: MetaKey, value: T, target: object, method: string): void {\n Reflect.defineMetadata(key, value, target, method)\n}\n\n// ── Getters ─────────────────────────────────────────────────────\n\n/** Get metadata from a class, returning `fallback` if not set */\nexport function getClassMeta<T>(key: MetaKey, target: object, fallback: T): T {\n return (Reflect.getMetadata(key, target) as T) ?? fallback\n}\n\n/** Get metadata from a specific method, returning `fallback` if not set */\nexport function getMethodMeta<T>(key: MetaKey, target: object, method: string, fallback: T): T {\n return (Reflect.getMetadata(key, target, method) as T) ?? fallback\n}\n\n/** Check if metadata exists on a class */\nexport function hasClassMeta(key: MetaKey, target: object): boolean {\n return Reflect.hasMetadata(key, target)\n}\n\n/** Get metadata from a class with no default (returns undefined if absent) */\nexport function getClassMetaOrUndefined<T>(key: MetaKey, target: object): T | undefined {\n return Reflect.getMetadata(key, target) as T | undefined\n}\n\n/** Get metadata from a method with no default (returns undefined if absent) */\nexport function getMethodMetaOrUndefined<T>(\n key: MetaKey,\n target: object,\n method: string,\n): T | undefined {\n return Reflect.getMetadata(key, target, method) as T | undefined\n}\n\n// ── Accumulate: Arrays ──────────────────────────────────────────\n\n/** Append items to an array stored in class metadata */\nexport function pushClassMeta<T>(key: MetaKey, target: object, ...items: T[]): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target)\n}\n\n/** Append items to an array stored in method metadata */\nexport function pushMethodMeta<T>(\n key: MetaKey,\n target: object,\n method: string,\n ...items: T[]\n): void {\n const existing: T[] = Reflect.getOwnMetadata(key, target, method) ?? []\n Reflect.defineMetadata(key, [...existing, ...items], target, method)\n}\n\n// ── Accumulate: Maps ────────────────────────────────────────────\n\n/** Set a key/value in a Map stored in class metadata */\nexport function setInMetaMap<K, V>(key: MetaKey, target: object, mapKey: K, mapValue: V): void {\n const inherited: Map<K, V> | undefined = Reflect.getOwnMetadata(key, target)\n const map = inherited ? new Map(inherited) : new Map<K, V>()\n map.set(mapKey, mapValue)\n Reflect.defineMetadata(key, map, target)\n}\n\n/** Get a Map from class metadata (returns empty Map if absent) */\nexport function getMetaMap<K, V>(key: MetaKey, target: object): Map<K, V> {\n return Reflect.getMetadata(key, target) ?? new Map()\n}\n\n// ── Accumulate: Records ─────────────────────────────────────────\n\n/** Set a key/value in a Record stored in class metadata */\nexport function setInMetaRecord<V>(\n key: MetaKey,\n target: object,\n recKey: string | number,\n recValue: V,\n): void {\n const inherited: Record<string | number, V> | undefined = Reflect.getOwnMetadata(key, target)\n const rec = inherited ? { ...inherited } : {}\n rec[recKey] = recValue\n Reflect.defineMetadata(key, rec, target)\n}\n\n/** Get a Record from class metadata (returns empty object if absent) */\nexport function getMetaRecord<V>(key: MetaKey, target: object): Record<string | number, V> {\n return Reflect.getMetadata(key, target) ?? {}\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,aAAgB,KAAc,OAAU,QAAsB;AAC5E,SAAQ,eAAe,KAAK,OAAO,OAAO;;;AAI5C,SAAgB,cAAiB,KAAc,OAAU,QAAgB,QAAsB;AAC7F,SAAQ,eAAe,KAAK,OAAO,QAAQ,OAAO;;;AAMpD,SAAgB,aAAgB,KAAc,QAAgB,UAAgB;AAC5E,QAAQ,QAAQ,YAAY,KAAK,OAAO,IAAU;;;AAIpD,SAAgB,cAAiB,KAAc,QAAgB,QAAgB,UAAgB;AAC7F,QAAQ,QAAQ,YAAY,KAAK,QAAQ,OAAO,IAAU;;;AAI5D,SAAgB,aAAa,KAAc,QAAyB;AAClE,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,wBAA2B,KAAc,QAA+B;AACtF,QAAO,QAAQ,YAAY,KAAK,OAAO;;;AAIzC,SAAgB,yBACd,KACA,QACA,QACe;AACf,QAAO,QAAQ,YAAY,KAAK,QAAQ,OAAO;;;AAMjD,SAAgB,cAAiB,KAAc,QAAgB,GAAG,OAAkB;CAClF,MAAM,WAAgB,QAAQ,eAAe,KAAK,OAAO,IAAI,EAAE;AAC/D,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO;;;AAI9D,SAAgB,eACd,KACA,QACA,QACA,GAAG,OACG;CACN,MAAM,WAAgB,QAAQ,eAAe,KAAK,QAAQ,OAAO,IAAI,EAAE;AACvE,SAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,QAAQ,OAAO;;;AAMtE,SAAgB,aAAmB,KAAc,QAAgB,QAAW,UAAmB;CAC7F,MAAM,YAAmC,QAAQ,eAAe,KAAK,OAAO;CAC5E,MAAM,MAAM,YAAY,IAAI,IAAI,UAAU,mBAAG,IAAI,KAAW;AAC5D,KAAI,IAAI,QAAQ,SAAS;AACzB,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,WAAiB,KAAc,QAA2B;AACxE,QAAO,QAAQ,YAAY,KAAK,OAAO,oBAAI,IAAI,KAAK;;;AAMtD,SAAgB,gBACd,KACA,QACA,QACA,UACM;CACN,MAAM,YAAoD,QAAQ,eAAe,KAAK,OAAO;CAC7F,MAAM,MAAM,YAAY,EAAE,GAAG,WAAW,GAAG,EAAE;AAC7C,KAAI,UAAU;AACd,SAAQ,eAAe,KAAK,KAAK,OAAO;;;AAI1C,SAAgB,cAAiB,KAAc,QAA4C;AACzF,QAAO,QAAQ,YAAY,KAAK,OAAO,IAAI,EAAE"}
@@ -22,4 +22,4 @@ declare function normalizePath(path?: string): string;
22
22
  declare function joinPaths(...segments: (string | undefined)[]): string;
23
23
  //#endregion
24
24
  export { normalizePath as n, joinPaths as t };
25
- //# sourceMappingURL=path-LmwfhfyH.d.mts.map
25
+ //# sourceMappingURL=path-Dq5V-i-x.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"path-Dq5V-i-x.d.mts","names":[],"sources":["../src/core/path.ts"],"mappings":";;;AAOA;;;;;AAsBA;iBAtBgB,aAAA,CAAc,IAAA;;;;;;;;;;;;iBAsBd,SAAA,CAAA,GAAa,QAAA"}
@@ -1,7 +1,7 @@
1
1
 
2
- import { t as Container } from "./container-nBSIhyqV.mjs";
3
- import { r as AppAdapter } from "./adapter-BqGjZCSm.mjs";
4
- import { n as AppModuleClass } from "./app-module-CcEbAVtB.mjs";
2
+ import { t as Container } from "./container-CcgV8eHL.mjs";
3
+ import { r as AppAdapter } from "./adapter-wuoBNkNs.mjs";
4
+ import { n as AppModuleClass } from "./app-module-DOBmxARW.mjs";
5
5
 
6
6
  //#region src/core/plugin.d.ts
7
7
  /**
@@ -92,4 +92,4 @@ interface KickPlugin {
92
92
  }
93
93
  //#endregion
94
94
  export { KickPlugin as t };
95
- //# sourceMappingURL=plugin-DIoPIpSm.d.mts.map
95
+ //# sourceMappingURL=plugin-D20muJwC.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"plugin-DIoPIpSm.d.mts","names":[],"sources":["../src/core/plugin.ts"],"mappings":";;;;;;;;AAwDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAiB,UAAA;;EAEf,IAAA;;;;;EAMA,QAAA,EAAU,SAAA,EAAW,SAAA;;;;;EAMrB,OAAA,KAAY,cAAA;;;;;EAMZ,QAAA,KAAa,UAAA;;;;;EAMb,UAAA;;;;;EAMA,OAAA,EAAS,SAAA,EAAW,SAAA,UAAmB,OAAA;;;;;EAMvC,QAAA,YAAoB,OAAA;AAAA"}
1
+ {"version":3,"file":"plugin-D20muJwC.d.mts","names":[],"sources":["../src/core/plugin.ts"],"mappings":";;;;;;;;AAwDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAiB,UAAA;;EAEf,IAAA;;;;;EAMA,QAAA,EAAU,SAAA,EAAW,SAAA;;;;;EAMrB,OAAA,KAAY,cAAA;;;;;EAMZ,QAAA,KAAa,UAAA;;;;;EAMb,UAAA;;;;;EAMA,OAAA,EAAS,SAAA,EAAW,SAAA,UAAmB,OAAA;;;;;EAMvC,QAAA,YAAoB,OAAA;AAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v2.1.0
2
+ * @forinda/kickjs v2.2.1
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -76,10 +76,10 @@ function parseSort(sortParam, allowedFields) {
76
76
  }
77
77
  /** Parse page/limit into pagination with computed offset */
78
78
  function parsePagination(params) {
79
- let page = typeof params.page === "string" ? parseInt(params.page, 10) : params.page ?? DEFAULT_PAGE;
80
- let limit = typeof params.limit === "string" ? parseInt(params.limit, 10) : params.limit ?? DEFAULT_LIMIT;
81
- if (isNaN(page) || page < 1) page = DEFAULT_PAGE;
82
- if (isNaN(limit) || limit < 1) limit = DEFAULT_LIMIT;
79
+ let page = typeof params.page === "string" ? Number.parseInt(params.page, 10) : params.page ?? DEFAULT_PAGE;
80
+ let limit = typeof params.limit === "string" ? Number.parseInt(params.limit, 10) : params.limit ?? DEFAULT_LIMIT;
81
+ if (Number.isNaN(page) || page < 1) page = DEFAULT_PAGE;
82
+ if (Number.isNaN(limit) || limit < 1) limit = DEFAULT_LIMIT;
83
83
  if (limit > MAX_LIMIT) limit = MAX_LIMIT;
84
84
  return {
85
85
  page,
@@ -161,4 +161,4 @@ function buildQueryParams(parsed) {
161
161
  //#endregion
162
162
  export { parseSearchQuery as a, parseQuery as i, parseFilters as n, parseSort as o, parsePagination as r, FILTER_OPERATORS as s, buildQueryParams as t };
163
163
 
164
- //# sourceMappingURL=query-7cdHF6ry.mjs.map
164
+ //# sourceMappingURL=query-BSIApo6Y.mjs.map