@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.
- package/README.md +63 -20
- package/dist/{adapter-BqGjZCSm.d.mts → adapter-wuoBNkNs.d.mts} +3 -3
- package/dist/{adapter-BqGjZCSm.d.mts.map → adapter-wuoBNkNs.d.mts.map} +1 -1
- package/dist/{app-module-CcEbAVtB.d.mts → app-module-DOBmxARW.d.mts} +11 -4
- package/dist/app-module-DOBmxARW.d.mts.map +1 -0
- package/dist/{application-DNHj-_UL.mjs → application-cYhTEy84.mjs} +6 -6
- package/dist/application-cYhTEy84.mjs.map +1 -0
- package/dist/{bootstrap-DLEZaJ3b.mjs → bootstrap-8_iBHhWp.mjs} +6 -6
- package/dist/{bootstrap-DLEZaJ3b.mjs.map → bootstrap-8_iBHhWp.mjs.map} +1 -1
- package/dist/{cache-DJeMaGqb.d.mts → cache-PufEhr0n.d.mts} +1 -1
- package/dist/{cache-DJeMaGqb.d.mts.map → cache-PufEhr0n.d.mts.map} +1 -1
- package/dist/{chunk-C5Qp-JxE.mjs → chunk-Djztpsb3.mjs} +1 -1
- package/dist/container-BKiJzakw.mjs +496 -0
- package/dist/container-BKiJzakw.mjs.map +1 -0
- package/dist/{container-nBSIhyqV.d.mts → container-CcgV8eHL.d.mts} +116 -4
- package/dist/container-CcgV8eHL.d.mts.map +1 -0
- package/dist/core/adapter.d.mts +1 -1
- package/dist/core/adapter.mjs +1 -1
- package/dist/core/app-module.d.mts +1 -1
- package/dist/core/app-module.mjs +1 -1
- package/dist/core/cache.d.mts +1 -1
- package/dist/core/cache.mjs +1 -1
- package/dist/core/container.d.mts +2 -2
- package/dist/core/container.mjs +2 -416
- package/dist/core/cron.d.mts +1 -1
- package/dist/core/cron.mjs +2 -2
- package/dist/core/decorators.d.mts +2 -2
- package/dist/core/decorators.mjs +9 -3
- package/dist/core/decorators.mjs.map +1 -1
- package/dist/core/errors.d.mts +1 -1
- package/dist/core/errors.mjs +1 -1
- package/dist/core/interfaces.d.mts +1 -1
- package/dist/core/interfaces.mjs +1 -1
- package/dist/core/logger.d.mts +1 -1
- package/dist/core/logger.mjs +1 -1
- package/dist/core/path.d.mts +1 -1
- package/dist/core/path.mjs +1 -1
- package/dist/core/plugin.d.mts +1 -1
- package/dist/core/plugin.mjs +1 -1
- package/dist/core/reactivity.d.mts +1 -1
- package/dist/core/reactivity.mjs +1 -1
- package/dist/{core-BL_H8fEZ.mjs → core-CXHuViXn.mjs} +4 -4
- package/dist/{core-BL_H8fEZ.mjs.map → core-CXHuViXn.mjs.map} +1 -1
- package/dist/{cron-RKhH5TOd.d.mts → cron-C29iHvHT.d.mts} +1 -1
- package/dist/{cron-RKhH5TOd.d.mts.map → cron-C29iHvHT.d.mts.map} +1 -1
- package/dist/{decorators-CQ93ak6Z.d.mts → decorators-D3lBlmud.d.mts} +54 -4
- package/dist/decorators-D3lBlmud.d.mts.map +1 -0
- package/dist/{errors-te5Km00o.d.mts → errors-BZUdxtjC.d.mts} +1 -1
- package/dist/{errors-te5Km00o.d.mts.map → errors-BZUdxtjC.d.mts.map} +1 -1
- package/dist/http/application.d.mts +4 -4
- package/dist/http/application.d.mts.map +1 -1
- package/dist/http/application.mjs +2 -2
- package/dist/http/bootstrap.mjs +2 -2
- package/dist/http/context.d.mts +67 -8
- package/dist/http/context.d.mts.map +1 -1
- package/dist/http/context.mjs +10 -5
- package/dist/http/context.mjs.map +1 -1
- package/dist/http/middleware/cors.mjs +1 -1
- package/dist/http/middleware/csrf.mjs +1 -1
- package/dist/http/middleware/error-handler.mjs +2 -2
- package/dist/http/middleware/helmet.mjs +1 -1
- package/dist/http/middleware/rate-limit.mjs +1 -1
- package/dist/http/middleware/request-id.mjs +1 -1
- package/dist/http/middleware/request-logger.mjs +2 -2
- package/dist/http/middleware/session.mjs +1 -1
- package/dist/http/middleware/spa.d.mts +1 -1
- package/dist/http/middleware/spa.mjs +3 -3
- package/dist/http/middleware/upload.d.mts +1 -1
- package/dist/http/middleware/upload.mjs +1 -1
- package/dist/http/middleware/validate.mjs +1 -1
- package/dist/http/middleware/views.d.mts +1 -1
- package/dist/http/middleware/views.mjs +2 -2
- package/dist/http/query/index.d.mts +2 -2
- package/dist/http/query/index.mjs +2 -2
- package/dist/http/router-builder.mjs +4 -4
- package/dist/{index-C0gbnpSg.d.mts → index-4VM4dUJf.d.mts} +1 -1
- package/dist/{index-C0gbnpSg.d.mts.map → index-4VM4dUJf.d.mts.map} +1 -1
- package/dist/{index-Cls52etj.d.mts → index-rnK23QBD.d.mts} +39 -3
- package/dist/index-rnK23QBD.d.mts.map +1 -0
- package/dist/index.d.mts +16 -16
- package/dist/index.mjs +8 -8
- package/dist/{interfaces-D-48zotH.d.mts → interfaces-D5ohYl6D.d.mts} +1 -1
- package/dist/{interfaces-D-48zotH.d.mts.map → interfaces-D5ohYl6D.d.mts.map} +1 -1
- package/dist/{logger-Dzj-TF0t.d.mts → logger-BLdfUF5b.d.mts} +1 -1
- package/dist/{logger-Dzj-TF0t.d.mts.map → logger-BLdfUF5b.d.mts.map} +1 -1
- package/dist/{metadata-fmvikBA0.mjs → metadata-D5L3_cdl.mjs} +2 -2
- package/dist/{metadata-fmvikBA0.mjs.map → metadata-D5L3_cdl.mjs.map} +1 -1
- package/dist/{path-LmwfhfyH.d.mts → path-Dq5V-i-x.d.mts} +1 -1
- package/dist/path-Dq5V-i-x.d.mts.map +1 -0
- package/dist/{plugin-DIoPIpSm.d.mts → plugin-D20muJwC.d.mts} +4 -4
- package/dist/{plugin-DIoPIpSm.d.mts.map → plugin-D20muJwC.d.mts.map} +1 -1
- package/dist/{query-7cdHF6ry.mjs → query-BSIApo6Y.mjs} +6 -6
- package/dist/query-BSIApo6Y.mjs.map +1 -0
- package/dist/{reactivity-BbS-99ow.d.mts → reactivity-CMAQh0gi.d.mts} +1 -1
- package/dist/{reactivity-BbS-99ow.d.mts.map → reactivity-CMAQh0gi.d.mts.map} +1 -1
- package/package.json +16 -13
- package/dist/app-module-CcEbAVtB.d.mts.map +0 -1
- package/dist/application-DNHj-_UL.mjs.map +0 -1
- package/dist/container-nBSIhyqV.d.mts.map +0 -1
- package/dist/core/container.mjs.map +0 -1
- package/dist/decorators-CQ93ak6Z.d.mts.map +0 -1
- package/dist/index-Cls52etj.d.mts.map +0 -1
- package/dist/path-LmwfhfyH.d.mts.map +0 -1
- 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":";;;;;;;;;;;;;;;;AA0BA,IAAa,iBAAb,MAAsE;CACpE,YACE,KACA,KACA,MACA;AAHgB,OAAA,MAAA;AACA,OAAA,MAAA;AACA,OAAA,OAAA;;;;;;;CAQlB,IAAY,WAA6B;EACvC,MAAM,IAAI,KAAK;AACf,MAAI,CAAC,EAAE,UAAW,GAAE,4BAAY,IAAI,KAAkB;AACtD,SAAO,EAAE;;CAKX,IAAI,OAAc;AAChB,SAAO,KAAK,IAAI;;CAGlB,IAAI,SAAkB;AACpB,SAAO,KAAK,IAAI;;CAGlB,IAAI,QAAgB;AAClB,SAAO,KAAK,IAAI;;CAGlB,IAAI,UAAU;AACZ,SAAO,KAAK,IAAI;;CAGlB,IAAI,YAAgC;AAClC,SAAQ,KAAK,IAAY,aAAc,KAAK,IAAI,QAAQ;;;CAI1D,IAAI,UAAe;AACjB,SAAQ,KAAK,IAAY;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B3B,GACE,aAC2B;AAC3B,SAAO,WAAoB,KAAK,IAAI,OAA8B,YAAY;;;CAMhF,IAAI,OAAY;AACd,SAAQ,KAAK,IAAY;;;CAI3B,IAAI,QAA2B;AAC7B,SAAQ,KAAK,IAAY;;CAK3B,IAAa,KAA4B;AACvC,SAAO,KAAK,SAAS,IAAI,IAAI;;CAG/B,IAAI,KAAa,OAAkB;AACjC,OAAK,SAAS,IAAI,KAAK,MAAM;;CAK/B,KAAK,MAAW,SAAS,KAAK;AAC5B,SAAO,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK;;CAG3C,QAAQ,MAAW;AACjB,SAAO,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK;;CAGxC,YAAY;AACV,SAAO,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK;;CAGnC,SAAS,UAAU,aAAa;AAC9B,SAAO,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;;CAG/C,WAAW,SAAiB;AAC1B,SAAO,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;;CAG/C,KAAK,SAAiB,SAAS,KAAK;AAClC,SAAO,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ;;CAG3D,SAAS,QAAgB,UAAkB,cAAc,4BAA4B;AACnF,OAAK,IAAI,UAAU,uBAAuB,yBAAyB,SAAS,GAAG;AAC/E,OAAK,IAAI,UAAU,gBAAgB,YAAY;AAC/C,SAAO,KAAK,IAAI,KAAK,OAAO;;;;;;;;;;;;;;;CAgB9B,OAAO,UAAkB,OAA4B,EAAE,EAAE;AACvD,SAAO,KAAK,IAAI,OAAO,UAAU,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BxC,MAAM,SACJ,SACA,aACA;EACA,MAAM,SAAS,KAAK,GAAY,YAAY;EAC5C,MAAM,EAAE,MAAM,UAAU,MAAM,QAAQ,OAAO;EAC7C,MAAM,EAAE,MAAM,UAAU,OAAO;EAC/B,MAAM,aAAa,KAAK,KAAK,QAAQ,MAAM,IAAI;EAE/C,MAAM,WAAiC;GACrC;GACA,MAAM;IACJ;IACA;IACA;IACA;IACA,SAAS,OAAO;IAChB,SAAS,OAAO;IACjB;GACF;AAED,SAAO,KAAK,KAAK,SAAS;;;;;;;;;;;;;;;;;;;;CAuB5B,MAAM;AACJ,OAAK,IAAI,UAAU,KAAK;GACtB,gBAAgB;GAChB,iBAAiB;GACjB,YAAY;GACZ,qBAAqB;GACtB,CAAC;AACF,OAAK,IAAI,cAAc;EAEvB,MAAM,iBAAoC,EAAE;AAE5C,OAAK,IAAI,GAAG,eAAe;AACzB,QAAK,MAAM,MAAM,eAAgB,KAAI;IACrC;AAEF,SAAO;GAEL,OAAO,MAAW,OAAgB,OAAgB;AAChD,QAAI,GAAI,MAAK,IAAI,MAAM,OAAO,GAAG,IAAI;AACrC,QAAI,MAAO,MAAK,IAAI,MAAM,UAAU,MAAM,IAAI;AAC9C,SAAK,IAAI,MAAM,SAAS,KAAK,UAAU,KAAK,CAAC,MAAM;;GAGrD,UAAU,SAAiB;AACzB,SAAK,IAAI,MAAM,KAAK,KAAK,MAAM;;GAGjC,UAAU,OAAmB;AAC3B,mBAAe,KAAK,GAAG;;GAGzB,aAAa;AACX,SAAK,IAAI,KAAK;;GAEjB"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v2.1
|
|
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-
|
|
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
|
|
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-
|
|
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
|
|
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-
|
|
11
|
+
import { t as __require } from "../../chunk-Djztpsb3.mjs";
|
|
12
12
|
import { Logger } from "../../core/logger.mjs";
|
|
13
|
-
import "../../core-
|
|
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 {
|
|
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
|
|
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-
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
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-
|
|
13
|
-
import { Container } from "../
|
|
14
|
-
import "../core-
|
|
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-
|
|
107
|
+
//# sourceMappingURL=index-4VM4dUJf.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index-
|
|
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?:
|
|
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 {
|
|
148
|
-
//# sourceMappingURL=index-
|
|
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-
|
|
3
|
-
import {
|
|
4
|
-
import { a as MiddlewarePhase, i as AppAdapterClass, n as AdapterMiddleware, r as AppAdapter, t as AdapterContext } from "./adapter-
|
|
5
|
-
import { n as AppModuleClass, r as ModuleRoutes, t as AppModule } from "./app-module-
|
|
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-
|
|
7
|
-
import { i as getCronJobs, n as Cron, r as CronJobMeta, t as CRON_META } from "./cron-
|
|
8
|
-
import { C as
|
|
9
|
-
import { i as ValidationError, n as HttpStatus, r as HttpStatusCode, t as HttpException } from "./errors-
|
|
10
|
-
import { a as logger, i as createLogger, n as Logger, o as rootLogger, r as LoggerProvider, t as ConsoleLoggerProvider } from "./logger-
|
|
11
|
-
import { n as normalizePath, t as joinPaths } from "./path-
|
|
12
|
-
import { t as KickPlugin } from "./plugin-
|
|
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-
|
|
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-
|
|
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
|
|
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
|
|
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-
|
|
14
|
-
import {
|
|
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-
|
|
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-
|
|
25
|
-
import { n as isClusterPrimary, t as bootstrap } from "./bootstrap-
|
|
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-
|
|
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-
|
|
52
|
+
//# sourceMappingURL=interfaces-D5ohYl6D.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"interfaces-
|
|
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-
|
|
119
|
+
//# sourceMappingURL=logger-BLdfUF5b.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logger-
|
|
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
|
|
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-
|
|
76
|
+
//# sourceMappingURL=metadata-D5L3_cdl.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"metadata-
|
|
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-
|
|
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-
|
|
3
|
-
import { r as AppAdapter } from "./adapter-
|
|
4
|
-
import { n as AppModuleClass } from "./app-module-
|
|
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-
|
|
95
|
+
//# sourceMappingURL=plugin-D20muJwC.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plugin-
|
|
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
|
|
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-
|
|
164
|
+
//# sourceMappingURL=query-BSIApo6Y.mjs.map
|