@forinda/kickjs 5.3.0 → 5.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. package/dist/application-mir5CSWO.mjs +12 -0
  2. package/dist/{application-Cna_2gex.mjs.map → application-mir5CSWO.mjs.map} +1 -1
  3. package/dist/bootstrap-B7j_-dOg.mjs +12 -0
  4. package/dist/{bootstrap-kPcmbbWe.mjs.map → bootstrap-B7j_-dOg.mjs.map} +1 -1
  5. package/dist/config/index.mjs +2 -4
  6. package/dist/config-Dk5RVTnD.mjs +12 -0
  7. package/dist/{config-DxEREQmR.mjs.map → config-Dk5RVTnD.mjs.map} +1 -1
  8. package/dist/container-DArhTDQQ.mjs +12 -0
  9. package/dist/{container-SMnB5yeT.mjs.map → container-DArhTDQQ.mjs.map} +1 -1
  10. package/dist/{context-Ymvv-85x.d.mts → context-BAdAV-zO.d.mts} +48 -11
  11. package/dist/context-BAdAV-zO.d.mts.map +1 -0
  12. package/dist/context-CIoXqpAX.mjs +12 -0
  13. package/dist/context-CIoXqpAX.mjs.map +1 -0
  14. package/dist/core/adapter.mjs +2 -2
  15. package/dist/core/app-module.mjs +2 -2
  16. package/dist/core/cache.mjs +2 -103
  17. package/dist/core/cache.mjs.map +1 -1
  18. package/dist/core/container.mjs +2 -3
  19. package/dist/core/cron.mjs +2 -32
  20. package/dist/core/cron.mjs.map +1 -1
  21. package/dist/core/decorators.mjs +2 -285
  22. package/dist/core/decorators.mjs.map +1 -1
  23. package/dist/core/errors.mjs +2 -110
  24. package/dist/core/errors.mjs.map +1 -1
  25. package/dist/core/interfaces.mjs +2 -53
  26. package/dist/core/interfaces.mjs.map +1 -1
  27. package/dist/core/logger.mjs +2 -207
  28. package/dist/core/logger.mjs.map +1 -1
  29. package/dist/core/path.mjs +2 -35
  30. package/dist/core/path.mjs.map +1 -1
  31. package/dist/core/plugin.mjs +2 -2
  32. package/dist/core/reactivity.mjs +2 -179
  33. package/dist/core/reactivity.mjs.map +1 -1
  34. package/dist/core-BQZyB8Wv.mjs +12 -0
  35. package/dist/{core--a4XflX7.mjs.map → core-BQZyB8Wv.mjs.map} +1 -1
  36. package/dist/env-BL0xOTyi.mjs +12 -0
  37. package/dist/{env-C4Yr6nN8.mjs.map → env-BL0xOTyi.mjs.map} +1 -1
  38. package/dist/http/application.mjs +2 -3
  39. package/dist/http/bootstrap.mjs +2 -3
  40. package/dist/http/context.d.mts +2 -2
  41. package/dist/http/context.mjs +2 -3
  42. package/dist/http/middleware/cors.mjs +2 -73
  43. package/dist/http/middleware/cors.mjs.map +1 -1
  44. package/dist/http/middleware/csrf.mjs +2 -62
  45. package/dist/http/middleware/csrf.mjs.map +1 -1
  46. package/dist/http/middleware/error-handler.mjs +2 -54
  47. package/dist/http/middleware/error-handler.mjs.map +1 -1
  48. package/dist/http/middleware/helmet.mjs +2 -41
  49. package/dist/http/middleware/helmet.mjs.map +1 -1
  50. package/dist/http/middleware/rate-limit.mjs +2 -91
  51. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  52. package/dist/http/middleware/request-id.mjs +2 -25
  53. package/dist/http/middleware/request-id.mjs.map +1 -1
  54. package/dist/http/middleware/request-logger.mjs +2 -39
  55. package/dist/http/middleware/request-logger.mjs.map +1 -1
  56. package/dist/http/middleware/session.mjs +2 -167
  57. package/dist/http/middleware/session.mjs.map +1 -1
  58. package/dist/http/middleware/spa.mjs +2 -98
  59. package/dist/http/middleware/spa.mjs.map +1 -1
  60. package/dist/http/middleware/upload.mjs +2 -181
  61. package/dist/http/middleware/upload.mjs.map +1 -1
  62. package/dist/http/middleware/validate.mjs +2 -68
  63. package/dist/http/middleware/validate.mjs.map +1 -1
  64. package/dist/http/middleware/views.d.mts +1 -1
  65. package/dist/http/middleware/views.mjs +2 -56
  66. package/dist/http/middleware/views.mjs.map +1 -1
  67. package/dist/http/query/index.mjs +2 -3
  68. package/dist/http/router-builder.mjs +2 -105
  69. package/dist/http/router-builder.mjs.map +1 -1
  70. package/dist/index.d.mts +3 -3
  71. package/dist/index.mjs +2 -171
  72. package/dist/index.mjs.map +1 -1
  73. package/dist/metadata-Dn6kNT82.mjs +12 -0
  74. package/dist/{metadata-CdYaU-XM.mjs.map → metadata-Dn6kNT82.mjs.map} +1 -1
  75. package/dist/query-B7n5isk_.mjs +12 -0
  76. package/dist/{query-nAYUgagU.mjs.map → query-B7n5isk_.mjs.map} +1 -1
  77. package/dist/{views-DkNp9JJs.d.mts → views-oKRSw0Op.d.mts} +2 -2
  78. package/dist/{views-DkNp9JJs.d.mts.map → views-oKRSw0Op.d.mts.map} +1 -1
  79. package/package.json +1 -1
  80. package/dist/application-Cna_2gex.mjs +0 -574
  81. package/dist/bootstrap-kPcmbbWe.mjs +0 -195
  82. package/dist/config-DxEREQmR.mjs +0 -135
  83. package/dist/container-SMnB5yeT.mjs +0 -897
  84. package/dist/context-B0B3WQft.mjs +0 -348
  85. package/dist/context-B0B3WQft.mjs.map +0 -1
  86. package/dist/context-Ymvv-85x.d.mts.map +0 -1
  87. package/dist/core--a4XflX7.mjs +0 -820
  88. package/dist/env-C4Yr6nN8.mjs +0 -137
  89. package/dist/metadata-CdYaU-XM.mjs +0 -76
  90. package/dist/query-nAYUgagU.mjs +0 -164
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,113 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- //#region src/core/errors.ts
12
- /**
13
- * Standard HTTP status codes as a const enum.
14
- * Use instead of raw numbers for readability and type safety.
15
- *
16
- * @example
17
- * ```ts
18
- * throw new HttpException(HttpStatus.NOT_FOUND, 'User not found')
19
- * ctx.res.status(HttpStatus.CREATED).json(data)
20
- * ```
21
- */
22
- const HttpStatus = {
23
- OK: 200,
24
- CREATED: 201,
25
- ACCEPTED: 202,
26
- NO_CONTENT: 204,
27
- MOVED_PERMANENTLY: 301,
28
- FOUND: 302,
29
- NOT_MODIFIED: 304,
30
- TEMPORARY_REDIRECT: 307,
31
- PERMANENT_REDIRECT: 308,
32
- BAD_REQUEST: 400,
33
- UNAUTHORIZED: 401,
34
- PAYMENT_REQUIRED: 402,
35
- FORBIDDEN: 403,
36
- NOT_FOUND: 404,
37
- METHOD_NOT_ALLOWED: 405,
38
- NOT_ACCEPTABLE: 406,
39
- CONFLICT: 409,
40
- GONE: 410,
41
- UNPROCESSABLE_ENTITY: 422,
42
- TOO_MANY_REQUESTS: 429,
43
- INTERNAL_SERVER_ERROR: 500,
44
- NOT_IMPLEMENTED: 501,
45
- BAD_GATEWAY: 502,
46
- SERVICE_UNAVAILABLE: 503,
47
- GATEWAY_TIMEOUT: 504
48
- };
49
- /**
50
- * Typed HTTP exception with status code, free-form details, and optional
51
- * response headers. Provides static factory methods for common HTTP errors.
52
- *
53
- * `details` is intentionally typed as `unknown` — it serializes straight into
54
- * the response body's `errors` field, so any JSON-compatible shape works
55
- * (string, object, array of mixed values, ValidationError[]).
56
- *
57
- * `headers` are merged into the response by the global error handler so
58
- * spec-mandated headers (Retry-After, WWW-Authenticate, Allow, Location)
59
- * stay on the exception, not on ad-hoc try/catch chains.
60
- */
61
- var HttpException = class HttpException extends Error {
62
- constructor(status, message, details, headers) {
63
- super(message);
64
- this.status = status;
65
- this.details = details;
66
- this.headers = headers;
67
- this.name = "HttpException";
68
- }
69
- /** Return a new exception with `headers` shallow-merged onto this one. */
70
- withHeaders(headers) {
71
- return new HttpException(this.status, this.message, this.details, {
72
- ...this.headers,
73
- ...headers
74
- });
75
- }
76
- /** Create from a Zod error */
77
- static fromZodError(error, message) {
78
- const firstIssue = error.issues?.[0];
79
- const details = (error.issues || []).map((issue) => ({
80
- field: issue.path?.join(".") || "",
81
- message: issue.message,
82
- code: issue.code
83
- }));
84
- return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY, message || firstIssue?.message || "Validation failed", details);
85
- }
86
- static badRequest(message = "Bad Request") {
87
- return new HttpException(HttpStatus.BAD_REQUEST, message);
88
- }
89
- static unauthorized(message = "Unauthorized", wwwAuthenticate) {
90
- return new HttpException(HttpStatus.UNAUTHORIZED, message, void 0, wwwAuthenticate ? { "WWW-Authenticate": wwwAuthenticate } : void 0);
91
- }
92
- static forbidden(message = "Forbidden") {
93
- return new HttpException(HttpStatus.FORBIDDEN, message);
94
- }
95
- static notFound(message = "Not Found") {
96
- return new HttpException(HttpStatus.NOT_FOUND, message);
97
- }
98
- static methodNotAllowed(allowedMethods, message = "Method Not Allowed") {
99
- return new HttpException(HttpStatus.METHOD_NOT_ALLOWED, message, void 0, { Allow: allowedMethods.join(", ") });
100
- }
101
- static conflict(message = "Conflict") {
102
- return new HttpException(HttpStatus.CONFLICT, message);
103
- }
104
- static unprocessable(message = "Unprocessable Entity", details) {
105
- return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY, message, details);
106
- }
107
- static tooManyRequests(message = "Too Many Requests", retryAfterSeconds) {
108
- return new HttpException(HttpStatus.TOO_MANY_REQUESTS, message, void 0, retryAfterSeconds !== void 0 ? { "Retry-After": String(retryAfterSeconds) } : void 0);
109
- }
110
- static serviceUnavailable(message = "Service Unavailable", retryAfterSeconds) {
111
- return new HttpException(HttpStatus.SERVICE_UNAVAILABLE, message, void 0, retryAfterSeconds !== void 0 ? { "Retry-After": String(retryAfterSeconds) } : void 0);
112
- }
113
- static internal(message = "Internal Server Error") {
114
- return new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, message);
115
- }
116
- };
117
- //#endregion
118
- export { HttpException, HttpStatus };
119
-
11
+ const HttpStatus={OK:200,CREATED:201,ACCEPTED:202,NO_CONTENT:204,MOVED_PERMANENTLY:301,FOUND:302,NOT_MODIFIED:304,TEMPORARY_REDIRECT:307,PERMANENT_REDIRECT:308,BAD_REQUEST:400,UNAUTHORIZED:401,PAYMENT_REQUIRED:402,FORBIDDEN:403,NOT_FOUND:404,METHOD_NOT_ALLOWED:405,NOT_ACCEPTABLE:406,CONFLICT:409,GONE:410,UNPROCESSABLE_ENTITY:422,TOO_MANY_REQUESTS:429,INTERNAL_SERVER_ERROR:500,NOT_IMPLEMENTED:501,BAD_GATEWAY:502,SERVICE_UNAVAILABLE:503,GATEWAY_TIMEOUT:504};var HttpException=class HttpException extends Error{constructor(status,message,details,headers){super(message),this.status=status,this.details=details,this.headers=headers,this.name=`HttpException`}withHeaders(headers){return new HttpException(this.status,this.message,this.details,{...this.headers,...headers})}static fromZodError(error,message){let firstIssue=error.issues?.[0],details=(error.issues||[]).map(issue=>({field:issue.path?.join(`.`)||``,message:issue.message,code:issue.code}));return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY,message||firstIssue?.message||`Validation failed`,details)}static badRequest(message=`Bad Request`){return new HttpException(HttpStatus.BAD_REQUEST,message)}static unauthorized(message=`Unauthorized`,wwwAuthenticate){return new HttpException(HttpStatus.UNAUTHORIZED,message,void 0,wwwAuthenticate?{"WWW-Authenticate":wwwAuthenticate}:void 0)}static forbidden(message=`Forbidden`){return new HttpException(HttpStatus.FORBIDDEN,message)}static notFound(message=`Not Found`){return new HttpException(HttpStatus.NOT_FOUND,message)}static methodNotAllowed(allowedMethods,message=`Method Not Allowed`){return new HttpException(HttpStatus.METHOD_NOT_ALLOWED,message,void 0,{Allow:allowedMethods.join(`, `)})}static conflict(message=`Conflict`){return new HttpException(HttpStatus.CONFLICT,message)}static unprocessable(message=`Unprocessable Entity`,details){return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY,message,details)}static tooManyRequests(message=`Too Many Requests`,retryAfterSeconds){return new HttpException(HttpStatus.TOO_MANY_REQUESTS,message,void 0,retryAfterSeconds===void 0?void 0:{"Retry-After":String(retryAfterSeconds)})}static serviceUnavailable(message=`Service Unavailable`,retryAfterSeconds){return new HttpException(HttpStatus.SERVICE_UNAVAILABLE,message,void 0,retryAfterSeconds===void 0?void 0:{"Retry-After":String(retryAfterSeconds)})}static internal(message=`Internal Server Error`){return new HttpException(HttpStatus.INTERNAL_SERVER_ERROR,message)}};export{HttpException,HttpStatus};
120
12
  //# sourceMappingURL=errors.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.mjs","names":[],"sources":["../../src/core/errors.ts"],"sourcesContent":["/**\n * Standard HTTP status codes as a const enum.\n * Use instead of raw numbers for readability and type safety.\n *\n * @example\n * ```ts\n * throw new HttpException(HttpStatus.NOT_FOUND, 'User not found')\n * ctx.res.status(HttpStatus.CREATED).json(data)\n * ```\n */\nexport const HttpStatus = {\n // 2xx Success\n OK: 200,\n CREATED: 201,\n ACCEPTED: 202,\n NO_CONTENT: 204,\n\n // 3xx Redirection\n MOVED_PERMANENTLY: 301,\n FOUND: 302,\n NOT_MODIFIED: 304,\n TEMPORARY_REDIRECT: 307,\n PERMANENT_REDIRECT: 308,\n\n // 4xx Client Errors\n BAD_REQUEST: 400,\n UNAUTHORIZED: 401,\n PAYMENT_REQUIRED: 402,\n FORBIDDEN: 403,\n NOT_FOUND: 404,\n METHOD_NOT_ALLOWED: 405,\n NOT_ACCEPTABLE: 406,\n CONFLICT: 409,\n GONE: 410,\n UNPROCESSABLE_ENTITY: 422,\n TOO_MANY_REQUESTS: 429,\n\n // 5xx Server Errors\n INTERNAL_SERVER_ERROR: 500,\n NOT_IMPLEMENTED: 501,\n BAD_GATEWAY: 502,\n SERVICE_UNAVAILABLE: 503,\n GATEWAY_TIMEOUT: 504,\n} as const\n\nexport type HttpStatusCode = (typeof HttpStatus)[keyof typeof HttpStatus]\n\n/** Validation error detail — shape used by `unprocessable()` and `fromZodError()`. */\nexport interface ValidationError {\n field: string\n message: string\n code?: string\n}\n\n/**\n * Typed HTTP exception with status code, free-form details, and optional\n * response headers. Provides static factory methods for common HTTP errors.\n *\n * `details` is intentionally typed as `unknown` — it serializes straight into\n * the response body's `errors` field, so any JSON-compatible shape works\n * (string, object, array of mixed values, ValidationError[]).\n *\n * `headers` are merged into the response by the global error handler so\n * spec-mandated headers (Retry-After, WWW-Authenticate, Allow, Location)\n * stay on the exception, not on ad-hoc try/catch chains.\n */\nexport class HttpException extends Error {\n constructor(\n public readonly status: number,\n message: string,\n public readonly details?: unknown,\n public readonly headers?: Record<string, string>,\n ) {\n super(message)\n this.name = 'HttpException'\n }\n\n /** Return a new exception with `headers` shallow-merged onto this one. */\n withHeaders(headers: Record<string, string>): HttpException {\n return new HttpException(this.status, this.message, this.details, {\n ...this.headers,\n ...headers,\n })\n }\n\n /** Create from a Zod error */\n static fromZodError(error: any, message?: string): HttpException {\n const firstIssue = error.issues?.[0]\n const details: ValidationError[] = (error.issues || []).map((issue: any) => ({\n field: issue.path?.join('.') || '',\n message: issue.message,\n code: issue.code,\n }))\n return new HttpException(\n HttpStatus.UNPROCESSABLE_ENTITY,\n message || firstIssue?.message || 'Validation failed',\n details,\n )\n }\n\n static badRequest(message = 'Bad Request') {\n return new HttpException(HttpStatus.BAD_REQUEST, message)\n }\n static unauthorized(message = 'Unauthorized', wwwAuthenticate?: string) {\n return new HttpException(\n HttpStatus.UNAUTHORIZED,\n message,\n undefined,\n wwwAuthenticate ? { 'WWW-Authenticate': wwwAuthenticate } : undefined,\n )\n }\n static forbidden(message = 'Forbidden') {\n return new HttpException(HttpStatus.FORBIDDEN, message)\n }\n static notFound(message = 'Not Found') {\n return new HttpException(HttpStatus.NOT_FOUND, message)\n }\n static methodNotAllowed(allowedMethods: string[], message = 'Method Not Allowed') {\n return new HttpException(HttpStatus.METHOD_NOT_ALLOWED, message, undefined, {\n Allow: allowedMethods.join(', '),\n })\n }\n static conflict(message = 'Conflict') {\n return new HttpException(HttpStatus.CONFLICT, message)\n }\n static unprocessable(message = 'Unprocessable Entity', details?: ValidationError[]) {\n return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY, message, details)\n }\n static tooManyRequests(message = 'Too Many Requests', retryAfterSeconds?: number) {\n return new HttpException(\n HttpStatus.TOO_MANY_REQUESTS,\n message,\n undefined,\n retryAfterSeconds !== undefined ? { 'Retry-After': String(retryAfterSeconds) } : undefined,\n )\n }\n static serviceUnavailable(message = 'Service Unavailable', retryAfterSeconds?: number) {\n return new HttpException(\n HttpStatus.SERVICE_UNAVAILABLE,\n message,\n undefined,\n retryAfterSeconds !== undefined ? { 'Retry-After': String(retryAfterSeconds) } : undefined,\n )\n }\n static internal(message = 'Internal Server Error') {\n return new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, message)\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAUA,MAAa,aAAa;CAExB,IAAI;CACJ,SAAS;CACT,UAAU;CACV,YAAY;CAGZ,mBAAmB;CACnB,OAAO;CACP,cAAc;CACd,oBAAoB;CACpB,oBAAoB;CAGpB,aAAa;CACb,cAAc;CACd,kBAAkB;CAClB,WAAW;CACX,WAAW;CACX,oBAAoB;CACpB,gBAAgB;CAChB,UAAU;CACV,MAAM;CACN,sBAAsB;CACtB,mBAAmB;CAGnB,uBAAuB;CACvB,iBAAiB;CACjB,aAAa;CACb,qBAAqB;CACrB,iBAAiB;CAClB;;;;;;;;;;;;;AAuBD,IAAa,gBAAb,MAAa,sBAAsB,MAAM;CACvC,YACE,QACA,SACA,SACA,SACA;AACA,QAAM,QAAQ;AALE,OAAA,SAAA;AAEA,OAAA,UAAA;AACA,OAAA,UAAA;AAGhB,OAAK,OAAO;;;CAId,YAAY,SAAgD;AAC1D,SAAO,IAAI,cAAc,KAAK,QAAQ,KAAK,SAAS,KAAK,SAAS;GAChE,GAAG,KAAK;GACR,GAAG;GACJ,CAAC;;;CAIJ,OAAO,aAAa,OAAY,SAAiC;EAC/D,MAAM,aAAa,MAAM,SAAS;EAClC,MAAM,WAA8B,MAAM,UAAU,EAAE,EAAE,KAAK,WAAgB;GAC3E,OAAO,MAAM,MAAM,KAAK,IAAI,IAAI;GAChC,SAAS,MAAM;GACf,MAAM,MAAM;GACb,EAAE;AACH,SAAO,IAAI,cACT,WAAW,sBACX,WAAW,YAAY,WAAW,qBAClC,QACD;;CAGH,OAAO,WAAW,UAAU,eAAe;AACzC,SAAO,IAAI,cAAc,WAAW,aAAa,QAAQ;;CAE3D,OAAO,aAAa,UAAU,gBAAgB,iBAA0B;AACtE,SAAO,IAAI,cACT,WAAW,cACX,SACA,KAAA,GACA,kBAAkB,EAAE,oBAAoB,iBAAiB,GAAG,KAAA,EAC7D;;CAEH,OAAO,UAAU,UAAU,aAAa;AACtC,SAAO,IAAI,cAAc,WAAW,WAAW,QAAQ;;CAEzD,OAAO,SAAS,UAAU,aAAa;AACrC,SAAO,IAAI,cAAc,WAAW,WAAW,QAAQ;;CAEzD,OAAO,iBAAiB,gBAA0B,UAAU,sBAAsB;AAChF,SAAO,IAAI,cAAc,WAAW,oBAAoB,SAAS,KAAA,GAAW,EAC1E,OAAO,eAAe,KAAK,KAAK,EACjC,CAAC;;CAEJ,OAAO,SAAS,UAAU,YAAY;AACpC,SAAO,IAAI,cAAc,WAAW,UAAU,QAAQ;;CAExD,OAAO,cAAc,UAAU,wBAAwB,SAA6B;AAClF,SAAO,IAAI,cAAc,WAAW,sBAAsB,SAAS,QAAQ;;CAE7E,OAAO,gBAAgB,UAAU,qBAAqB,mBAA4B;AAChF,SAAO,IAAI,cACT,WAAW,mBACX,SACA,KAAA,GACA,sBAAsB,KAAA,IAAY,EAAE,eAAe,OAAO,kBAAkB,EAAE,GAAG,KAAA,EAClF;;CAEH,OAAO,mBAAmB,UAAU,uBAAuB,mBAA4B;AACrF,SAAO,IAAI,cACT,WAAW,qBACX,SACA,KAAA,GACA,sBAAsB,KAAA,IAAY,EAAE,eAAe,OAAO,kBAAkB,EAAE,GAAG,KAAA,EAClF;;CAEH,OAAO,SAAS,UAAU,yBAAyB;AACjD,SAAO,IAAI,cAAc,WAAW,uBAAuB,QAAQ"}
1
+ {"version":3,"file":"errors.mjs","names":[],"sources":["../../src/core/errors.ts"],"sourcesContent":["/**\n * Standard HTTP status codes as a const enum.\n * Use instead of raw numbers for readability and type safety.\n *\n * @example\n * ```ts\n * throw new HttpException(HttpStatus.NOT_FOUND, 'User not found')\n * ctx.res.status(HttpStatus.CREATED).json(data)\n * ```\n */\nexport const HttpStatus = {\n // 2xx Success\n OK: 200,\n CREATED: 201,\n ACCEPTED: 202,\n NO_CONTENT: 204,\n\n // 3xx Redirection\n MOVED_PERMANENTLY: 301,\n FOUND: 302,\n NOT_MODIFIED: 304,\n TEMPORARY_REDIRECT: 307,\n PERMANENT_REDIRECT: 308,\n\n // 4xx Client Errors\n BAD_REQUEST: 400,\n UNAUTHORIZED: 401,\n PAYMENT_REQUIRED: 402,\n FORBIDDEN: 403,\n NOT_FOUND: 404,\n METHOD_NOT_ALLOWED: 405,\n NOT_ACCEPTABLE: 406,\n CONFLICT: 409,\n GONE: 410,\n UNPROCESSABLE_ENTITY: 422,\n TOO_MANY_REQUESTS: 429,\n\n // 5xx Server Errors\n INTERNAL_SERVER_ERROR: 500,\n NOT_IMPLEMENTED: 501,\n BAD_GATEWAY: 502,\n SERVICE_UNAVAILABLE: 503,\n GATEWAY_TIMEOUT: 504,\n} as const\n\nexport type HttpStatusCode = (typeof HttpStatus)[keyof typeof HttpStatus]\n\n/** Validation error detail — shape used by `unprocessable()` and `fromZodError()`. */\nexport interface ValidationError {\n field: string\n message: string\n code?: string\n}\n\n/**\n * Typed HTTP exception with status code, free-form details, and optional\n * response headers. Provides static factory methods for common HTTP errors.\n *\n * `details` is intentionally typed as `unknown` — it serializes straight into\n * the response body's `errors` field, so any JSON-compatible shape works\n * (string, object, array of mixed values, ValidationError[]).\n *\n * `headers` are merged into the response by the global error handler so\n * spec-mandated headers (Retry-After, WWW-Authenticate, Allow, Location)\n * stay on the exception, not on ad-hoc try/catch chains.\n */\nexport class HttpException extends Error {\n constructor(\n public readonly status: number,\n message: string,\n public readonly details?: unknown,\n public readonly headers?: Record<string, string>,\n ) {\n super(message)\n this.name = 'HttpException'\n }\n\n /** Return a new exception with `headers` shallow-merged onto this one. */\n withHeaders(headers: Record<string, string>): HttpException {\n return new HttpException(this.status, this.message, this.details, {\n ...this.headers,\n ...headers,\n })\n }\n\n /** Create from a Zod error */\n static fromZodError(error: any, message?: string): HttpException {\n const firstIssue = error.issues?.[0]\n const details: ValidationError[] = (error.issues || []).map((issue: any) => ({\n field: issue.path?.join('.') || '',\n message: issue.message,\n code: issue.code,\n }))\n return new HttpException(\n HttpStatus.UNPROCESSABLE_ENTITY,\n message || firstIssue?.message || 'Validation failed',\n details,\n )\n }\n\n static badRequest(message = 'Bad Request') {\n return new HttpException(HttpStatus.BAD_REQUEST, message)\n }\n static unauthorized(message = 'Unauthorized', wwwAuthenticate?: string) {\n return new HttpException(\n HttpStatus.UNAUTHORIZED,\n message,\n undefined,\n wwwAuthenticate ? { 'WWW-Authenticate': wwwAuthenticate } : undefined,\n )\n }\n static forbidden(message = 'Forbidden') {\n return new HttpException(HttpStatus.FORBIDDEN, message)\n }\n static notFound(message = 'Not Found') {\n return new HttpException(HttpStatus.NOT_FOUND, message)\n }\n static methodNotAllowed(allowedMethods: string[], message = 'Method Not Allowed') {\n return new HttpException(HttpStatus.METHOD_NOT_ALLOWED, message, undefined, {\n Allow: allowedMethods.join(', '),\n })\n }\n static conflict(message = 'Conflict') {\n return new HttpException(HttpStatus.CONFLICT, message)\n }\n static unprocessable(message = 'Unprocessable Entity', details?: ValidationError[]) {\n return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY, message, details)\n }\n static tooManyRequests(message = 'Too Many Requests', retryAfterSeconds?: number) {\n return new HttpException(\n HttpStatus.TOO_MANY_REQUESTS,\n message,\n undefined,\n retryAfterSeconds !== undefined ? { 'Retry-After': String(retryAfterSeconds) } : undefined,\n )\n }\n static serviceUnavailable(message = 'Service Unavailable', retryAfterSeconds?: number) {\n return new HttpException(\n HttpStatus.SERVICE_UNAVAILABLE,\n message,\n undefined,\n retryAfterSeconds !== undefined ? { 'Retry-After': String(retryAfterSeconds) } : undefined,\n )\n }\n static internal(message = 'Internal Server Error') {\n return new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, message)\n }\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,WAAa,CAExB,GAAI,IACJ,QAAS,IACT,SAAU,IACV,WAAY,IAGZ,kBAAmB,IACnB,MAAO,IACP,aAAc,IACd,mBAAoB,IACpB,mBAAoB,IAGpB,YAAa,IACb,aAAc,IACd,iBAAkB,IAClB,UAAW,IACX,UAAW,IACX,mBAAoB,IACpB,eAAgB,IAChB,SAAU,IACV,KAAM,IACN,qBAAsB,IACtB,kBAAmB,IAGnB,sBAAuB,IACvB,gBAAiB,IACjB,YAAa,IACb,oBAAqB,IACrB,gBAAiB,IAClB,CAuBD,IAAa,cAAb,MAAa,sBAAsB,KAAM,CACvC,YACE,OACA,QACA,QACA,QACA,CACA,MAAM,QAAQ,CALE,KAAA,OAAA,OAEA,KAAA,QAAA,QACA,KAAA,QAAA,QAGhB,KAAK,KAAO,gBAId,YAAY,QAAgD,CAC1D,OAAO,IAAI,cAAc,KAAK,OAAQ,KAAK,QAAS,KAAK,QAAS,CAChE,GAAG,KAAK,QACR,GAAG,QACJ,CAAC,CAIJ,OAAO,aAAa,MAAY,QAAiC,CAC/D,IAAM,WAAa,MAAM,SAAS,GAC5B,SAA8B,MAAM,QAAU,EAAE,EAAE,IAAK,QAAgB,CAC3E,MAAO,MAAM,MAAM,KAAK,IAAI,EAAI,GAChC,QAAS,MAAM,QACf,KAAM,MAAM,KACb,EAAE,CACH,OAAO,IAAI,cACT,WAAW,qBACX,SAAW,YAAY,SAAW,oBAClC,QACD,CAGH,OAAO,WAAW,QAAU,cAAe,CACzC,OAAO,IAAI,cAAc,WAAW,YAAa,QAAQ,CAE3D,OAAO,aAAa,QAAU,eAAgB,gBAA0B,CACtE,OAAO,IAAI,cACT,WAAW,aACX,QACA,IAAA,GACA,gBAAkB,CAAE,mBAAoB,gBAAiB,CAAG,IAAA,GAC7D,CAEH,OAAO,UAAU,QAAU,YAAa,CACtC,OAAO,IAAI,cAAc,WAAW,UAAW,QAAQ,CAEzD,OAAO,SAAS,QAAU,YAAa,CACrC,OAAO,IAAI,cAAc,WAAW,UAAW,QAAQ,CAEzD,OAAO,iBAAiB,eAA0B,QAAU,qBAAsB,CAChF,OAAO,IAAI,cAAc,WAAW,mBAAoB,QAAS,IAAA,GAAW,CAC1E,MAAO,eAAe,KAAK,KAAK,CACjC,CAAC,CAEJ,OAAO,SAAS,QAAU,WAAY,CACpC,OAAO,IAAI,cAAc,WAAW,SAAU,QAAQ,CAExD,OAAO,cAAc,QAAU,uBAAwB,QAA6B,CAClF,OAAO,IAAI,cAAc,WAAW,qBAAsB,QAAS,QAAQ,CAE7E,OAAO,gBAAgB,QAAU,oBAAqB,kBAA4B,CAChF,OAAO,IAAI,cACT,WAAW,kBACX,QACA,IAAA,GACA,oBAAsB,IAAA,GAA2D,IAAA,GAA/C,CAAE,cAAe,OAAO,kBAAkB,CAAE,CAC/E,CAEH,OAAO,mBAAmB,QAAU,sBAAuB,kBAA4B,CACrF,OAAO,IAAI,cACT,WAAW,oBACX,QACA,IAAA,GACA,oBAAsB,IAAA,GAA2D,IAAA,GAA/C,CAAE,cAAe,OAAO,kBAAkB,CAAE,CAC/E,CAEH,OAAO,SAAS,QAAU,wBAAyB,CACjD,OAAO,IAAI,cAAc,WAAW,sBAAuB,QAAQ"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,56 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import "reflect-metadata";
12
- //#region src/core/interfaces.ts
13
- /** Lifecycle scope for DI registrations */
14
- let Scope = /* @__PURE__ */ function(Scope) {
15
- Scope["SINGLETON"] = "singleton";
16
- Scope["TRANSIENT"] = "transient";
17
- /** One instance per HTTP request, cached in AsyncLocalStorage. Throws outside request context. */
18
- Scope["REQUEST"] = "request";
19
- return Scope;
20
- }({});
21
- /**
22
- * String metadata keys for the DI system + decorator subsystem. Every
23
- * key starts with the `kick:` prefix; the suffix is a short identifier
24
- * that may itself contain `:`, `-`, or `_` separators (historical —
25
- * keys grew alongside the framework). The §22 v4 convention is "no
26
- * Symbols", not "use a strict naming scheme" — Symbols don't survive
27
- * JSON serialisation, can't be addressed by string from worker
28
- * threads, and don't show up in DevTools snapshots.
29
- *
30
- * `reflect-metadata` accepts both Symbol and string keys identically,
31
- * so the consumer-side change is internal — references go through the
32
- * `METADATA` enum's named members (e.g. `METADATA.INJECT`), not the
33
- * underlying string.
34
- *
35
- * The `design:*` entries match what TypeScript's
36
- * `emitDecoratorMetadata` writes; those names are fixed by the
37
- * compiler + must stay as-is.
38
- */
39
- const METADATA = {
40
- INJECTABLE: "kick:injectable",
41
- SCOPE: "kick:scope",
42
- CLASS_KIND: "kick:class-kind",
43
- AUTOWIRED: "kick:autowired",
44
- INJECT: "kick:inject",
45
- POST_CONSTRUCT: "kick:post_construct",
46
- BUILDER: "kick:builder",
47
- QUERY_PARAMS: "kick:query:params",
48
- ROUTES: "kick:routes",
49
- CLASS_MIDDLEWARES: "kick:class:middlewares",
50
- METHOD_MIDDLEWARES: "kick:method:middlewares",
51
- CLASS_CONTRIBUTORS: "kick:class:contributors",
52
- METHOD_CONTRIBUTORS: "kick:method:contributors",
53
- FILE_UPLOAD: "kick:file:upload",
54
- VALUE: "kick:value",
55
- ASSET: "kick:asset",
56
- PARAM_TYPES: "design:paramtypes",
57
- PROPERTY_TYPE: "design:type",
58
- RETURN_TYPE: "design:returntype"
59
- };
60
- //#endregion
61
- export { METADATA, Scope };
62
-
11
+ import"reflect-metadata";let Scope=function(Scope){return Scope.SINGLETON=`singleton`,Scope.TRANSIENT=`transient`,Scope.REQUEST=`request`,Scope}({});const METADATA={INJECTABLE:`kick:injectable`,SCOPE:`kick:scope`,CLASS_KIND:`kick:class-kind`,AUTOWIRED:`kick:autowired`,INJECT:`kick:inject`,POST_CONSTRUCT:`kick:post_construct`,BUILDER:`kick:builder`,QUERY_PARAMS:`kick:query:params`,ROUTES:`kick:routes`,CLASS_MIDDLEWARES:`kick:class:middlewares`,METHOD_MIDDLEWARES:`kick:method:middlewares`,CLASS_CONTRIBUTORS:`kick:class:contributors`,METHOD_CONTRIBUTORS:`kick:method:contributors`,FILE_UPLOAD:`kick:file:upload`,VALUE:`kick:value`,ASSET:`kick:asset`,PARAM_TYPES:`design:paramtypes`,PROPERTY_TYPE:`design:type`,RETURN_TYPE:`design:returntype`};export{METADATA,Scope};
63
12
  //# sourceMappingURL=interfaces.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces.mjs","names":[],"sources":["../../src/core/interfaces.ts"],"sourcesContent":["import 'reflect-metadata'\n\n/** Lifecycle scope for DI registrations */\nexport enum Scope {\n SINGLETON = 'singleton',\n TRANSIENT = 'transient',\n /** One instance per HTTP request, cached in AsyncLocalStorage. Throws outside request context. */\n REQUEST = 'request',\n}\n\n/** Generic constructor type */\nexport type Constructor<T = any> = new (...args: any[]) => T\n\n/** A value that may or may not be wrapped in a Promise */\nexport type MaybePromise<T = void> = T | Promise<T>\n\n/** Options for @Service, @Repository, @Component decorators */\nexport interface ServiceOptions {\n scope?: Scope\n}\n\n/** Fluent builder type */\nexport type BuilderOf<T> = {\n [K in keyof T as T[K] extends Function ? never : K]-?: (value: T[K]) => BuilderOf<T>\n} & { build(): T }\n\n/** Class with static builder() method */\nexport interface Buildable<T> {\n builder(): BuilderOf<T>\n}\n\n/** Decorator class kind for devtools introspection */\nexport type ClassKind =\n | 'service'\n | 'controller'\n | 'repository'\n | 'component'\n | 'injectable'\n | 'factory'\n | 'instance'\n | 'unknown'\n\n/** PostConstruct lifecycle status */\nexport type PostConstructStatus = 'pending' | 'completed' | 'failed' | 'skipped'\n\n/**\n * String metadata keys for the DI system + decorator subsystem. Every\n * key starts with the `kick:` prefix; the suffix is a short identifier\n * that may itself contain `:`, `-`, or `_` separators (historical —\n * keys grew alongside the framework). The §22 v4 convention is \"no\n * Symbols\", not \"use a strict naming scheme\" — Symbols don't survive\n * JSON serialisation, can't be addressed by string from worker\n * threads, and don't show up in DevTools snapshots.\n *\n * `reflect-metadata` accepts both Symbol and string keys identically,\n * so the consumer-side change is internal — references go through the\n * `METADATA` enum's named members (e.g. `METADATA.INJECT`), not the\n * underlying string.\n *\n * The `design:*` entries match what TypeScript's\n * `emitDecoratorMetadata` writes; those names are fixed by the\n * compiler + must stay as-is.\n */\nexport const METADATA = {\n INJECTABLE: 'kick:injectable',\n SCOPE: 'kick:scope',\n CLASS_KIND: 'kick:class-kind',\n AUTOWIRED: 'kick:autowired',\n INJECT: 'kick:inject',\n POST_CONSTRUCT: 'kick:post_construct',\n BUILDER: 'kick:builder',\n QUERY_PARAMS: 'kick:query:params',\n ROUTES: 'kick:routes',\n CLASS_MIDDLEWARES: 'kick:class:middlewares',\n METHOD_MIDDLEWARES: 'kick:method:middlewares',\n CLASS_CONTRIBUTORS: 'kick:class:contributors',\n METHOD_CONTRIBUTORS: 'kick:method:contributors',\n FILE_UPLOAD: 'kick:file:upload',\n VALUE: 'kick:value',\n ASSET: 'kick:asset',\n // TypeScript emit metadata keys — fixed by the compiler.\n PARAM_TYPES: 'design:paramtypes',\n PROPERTY_TYPE: 'design:type',\n RETURN_TYPE: 'design:returntype',\n} as const\n"],"mappings":";;;;;;;;;;;;;AAGA,IAAY,QAAL,yBAAA,OAAA;AACL,OAAA,eAAA;AACA,OAAA,eAAA;;AAEA,OAAA,aAAA;;KACD;;;;;;;;;;;;;;;;;;;AAuDD,MAAa,WAAW;CACtB,YAAY;CACZ,OAAO;CACP,YAAY;CACZ,WAAW;CACX,QAAQ;CACR,gBAAgB;CAChB,SAAS;CACT,cAAc;CACd,QAAQ;CACR,mBAAmB;CACnB,oBAAoB;CACpB,oBAAoB;CACpB,qBAAqB;CACrB,aAAa;CACb,OAAO;CACP,OAAO;CAEP,aAAa;CACb,eAAe;CACf,aAAa;CACd"}
1
+ {"version":3,"file":"interfaces.mjs","names":[],"sources":["../../src/core/interfaces.ts"],"sourcesContent":["import 'reflect-metadata'\n\n/** Lifecycle scope for DI registrations */\nexport enum Scope {\n SINGLETON = 'singleton',\n TRANSIENT = 'transient',\n /** One instance per HTTP request, cached in AsyncLocalStorage. Throws outside request context. */\n REQUEST = 'request',\n}\n\n/** Generic constructor type */\nexport type Constructor<T = any> = new (...args: any[]) => T\n\n/** A value that may or may not be wrapped in a Promise */\nexport type MaybePromise<T = void> = T | Promise<T>\n\n/** Options for @Service, @Repository, @Component decorators */\nexport interface ServiceOptions {\n scope?: Scope\n}\n\n/** Fluent builder type */\nexport type BuilderOf<T> = {\n [K in keyof T as T[K] extends Function ? never : K]-?: (value: T[K]) => BuilderOf<T>\n} & { build(): T }\n\n/** Class with static builder() method */\nexport interface Buildable<T> {\n builder(): BuilderOf<T>\n}\n\n/** Decorator class kind for devtools introspection */\nexport type ClassKind =\n | 'service'\n | 'controller'\n | 'repository'\n | 'component'\n | 'injectable'\n | 'factory'\n | 'instance'\n | 'unknown'\n\n/** PostConstruct lifecycle status */\nexport type PostConstructStatus = 'pending' | 'completed' | 'failed' | 'skipped'\n\n/**\n * String metadata keys for the DI system + decorator subsystem. Every\n * key starts with the `kick:` prefix; the suffix is a short identifier\n * that may itself contain `:`, `-`, or `_` separators (historical —\n * keys grew alongside the framework). The §22 v4 convention is \"no\n * Symbols\", not \"use a strict naming scheme\" — Symbols don't survive\n * JSON serialisation, can't be addressed by string from worker\n * threads, and don't show up in DevTools snapshots.\n *\n * `reflect-metadata` accepts both Symbol and string keys identically,\n * so the consumer-side change is internal — references go through the\n * `METADATA` enum's named members (e.g. `METADATA.INJECT`), not the\n * underlying string.\n *\n * The `design:*` entries match what TypeScript's\n * `emitDecoratorMetadata` writes; those names are fixed by the\n * compiler + must stay as-is.\n */\nexport const METADATA = {\n INJECTABLE: 'kick:injectable',\n SCOPE: 'kick:scope',\n CLASS_KIND: 'kick:class-kind',\n AUTOWIRED: 'kick:autowired',\n INJECT: 'kick:inject',\n POST_CONSTRUCT: 'kick:post_construct',\n BUILDER: 'kick:builder',\n QUERY_PARAMS: 'kick:query:params',\n ROUTES: 'kick:routes',\n CLASS_MIDDLEWARES: 'kick:class:middlewares',\n METHOD_MIDDLEWARES: 'kick:method:middlewares',\n CLASS_CONTRIBUTORS: 'kick:class:contributors',\n METHOD_CONTRIBUTORS: 'kick:method:contributors',\n FILE_UPLOAD: 'kick:file:upload',\n VALUE: 'kick:value',\n ASSET: 'kick:asset',\n // TypeScript emit metadata keys — fixed by the compiler.\n PARAM_TYPES: 'design:paramtypes',\n PROPERTY_TYPE: 'design:type',\n RETURN_TYPE: 'design:returntype',\n} as const\n"],"mappings":";;;;;;;;;;yBAGA,IAAY,MAAL,SAAA,MAAA,OACL,OAAA,UAAA,YACA,MAAA,UAAA,YAEA,MAAA,QAAA,oBACD,CAuDD,MAAa,SAAW,CACtB,WAAY,kBACZ,MAAO,aACP,WAAY,kBACZ,UAAW,iBACX,OAAQ,cACR,eAAgB,sBAChB,QAAS,eACT,aAAc,oBACd,OAAQ,cACR,kBAAmB,yBACnB,mBAAoB,0BACpB,mBAAoB,0BACpB,oBAAqB,2BACrB,YAAa,mBACb,MAAO,aACP,MAAO,aAEP,YAAa,oBACb,cAAe,cACf,YAAa,oBACd"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,210 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import pino from "pino";
12
- //#region src/core/logger.ts
13
- const isDev = process.env.NODE_ENV !== "production";
14
- /** Root pino logger instance */
15
- const rootLogger = pino({
16
- level: process.env.LOG_LEVEL || "info",
17
- ...isDev ? { transport: {
18
- target: "pino-pretty",
19
- options: {
20
- colorize: true,
21
- translateTime: "SYS:HH:MM:ss.l",
22
- singleLine: true,
23
- ignore: "pid,hostname,component",
24
- messageFormat: "{if component}[{component}] {end}{msg}"
25
- }
26
- } } : {}
27
- });
28
- /** Default provider that delegates to the root pino instance */
29
- var PinoLoggerProvider = class PinoLoggerProvider {
30
- log;
31
- constructor(pinoInstance) {
32
- this.log = pinoInstance ?? rootLogger;
33
- }
34
- info(msg, ...args) {
35
- this.log.info(msg, ...args);
36
- }
37
- warn(msg, ...args) {
38
- this.log.warn(msg, ...args);
39
- }
40
- error(msg, ...args) {
41
- this.log.error(msg, ...args);
42
- }
43
- debug(msg, ...args) {
44
- this.log.debug(msg, ...args);
45
- }
46
- trace(msg, ...args) {
47
- this.log.trace(msg, ...args);
48
- }
49
- fatal(msg, ...args) {
50
- this.log.fatal(msg, ...args);
51
- }
52
- child(bindings) {
53
- return new PinoLoggerProvider(this.log.child(bindings));
54
- }
55
- };
56
- /**
57
- * Built-in fallback provider that uses `console.*` methods.
58
- * Useful for environments where pino is unavailable or undesired.
59
- */
60
- var ConsoleLoggerProvider = class ConsoleLoggerProvider {
61
- prefix;
62
- constructor(prefix) {
63
- this.prefix = prefix ?? "";
64
- }
65
- fmt(msg) {
66
- return this.prefix ? `[${this.prefix}] ${msg}` : msg;
67
- }
68
- info(msg, ...args) {
69
- console.log(this.fmt(msg), ...args);
70
- }
71
- warn(msg, ...args) {
72
- console.warn(this.fmt(msg), ...args);
73
- }
74
- error(msg, ...args) {
75
- console.error(this.fmt(msg), ...args);
76
- }
77
- debug(msg, ...args) {
78
- console.debug(this.fmt(msg), ...args);
79
- }
80
- trace(msg, ...args) {
81
- console.trace(this.fmt(msg), ...args);
82
- }
83
- fatal(msg, ...args) {
84
- console.error(this.fmt(msg), ...args);
85
- }
86
- child(bindings) {
87
- return new ConsoleLoggerProvider(bindings.component);
88
- }
89
- };
90
- let activeProvider = new PinoLoggerProvider();
91
- /** Cache of named loggers to avoid creating duplicates */
92
- const loggerCache = /* @__PURE__ */ new Map();
93
- /**
94
- * Named logger with component context.
95
- *
96
- * @example
97
- * ```ts
98
- * // Static factory — preferred
99
- * const log = Logger.for('UserService')
100
- * log.info('User created')
101
- * // Output: [UserService] User created
102
- *
103
- * // Shorthand function
104
- * const log = createLogger('OrderService')
105
- *
106
- * // Pluggable backend
107
- * Logger.setProvider(new ConsoleLoggerProvider())
108
- *
109
- * // Injectable — auto-named from class
110
- * class MyService {
111
- * @Autowired() private logger!: Logger
112
- * // or inject a named one:
113
- * private log = Logger.for('MyService')
114
- * }
115
- * ```
116
- */
117
- var Logger = class Logger {
118
- _provider;
119
- _providerVersion;
120
- _name;
121
- /**
122
- * Optional context provider for request-scoped log enrichment.
123
- * Set by the HTTP package to inject requestId from AsyncLocalStorage.
124
- * Returns extra fields to merge into every log call, or null if outside a request.
125
- */
126
- static _contextProvider = null;
127
- /** Incremented on every setProvider/resetProvider so instances know to refresh */
128
- static _providerVersion = 0;
129
- constructor(name) {
130
- this._name = name;
131
- this._providerVersion = Logger._providerVersion;
132
- this._provider = name ? activeProvider.child({ component: name }) : activeProvider;
133
- }
134
- /** Re-derive the provider if setProvider() was called since construction/last access */
135
- get provider() {
136
- if (this._providerVersion !== Logger._providerVersion) {
137
- this._providerVersion = Logger._providerVersion;
138
- this._provider = this._name ? activeProvider.child({ component: this._name }) : activeProvider;
139
- }
140
- return this._provider;
141
- }
142
- /**
143
- * Replace the logging backend for **all** Logger instances created after
144
- * this call. Clears the logger cache so subsequent `Logger.for()` calls
145
- * pick up the new provider.
146
- *
147
- * @example
148
- * ```ts
149
- * Logger.setProvider(new ConsoleLoggerProvider())
150
- * ```
151
- */
152
- static setProvider(provider) {
153
- activeProvider = provider;
154
- Logger._providerVersion++;
155
- loggerCache.clear();
156
- }
157
- /** Return the currently active provider (useful for testing) */
158
- static getProvider() {
159
- return activeProvider;
160
- }
161
- /**
162
- * Reset the provider back to the default pino-based implementation.
163
- * Primarily intended for test teardown.
164
- */
165
- static resetProvider() {
166
- activeProvider = new PinoLoggerProvider();
167
- Logger._providerVersion++;
168
- loggerCache.clear();
169
- }
170
- /** Create or retrieve a cached named logger */
171
- static for(name) {
172
- let cached = loggerCache.get(name);
173
- if (!cached) {
174
- cached = new Logger(name);
175
- loggerCache.set(name, cached);
176
- }
177
- return cached;
178
- }
179
- /** Create a child logger with a sub-component name */
180
- child(name) {
181
- return new Logger(name);
182
- }
183
- /** Get request context (requestId, etc.) if inside a request */
184
- ctx() {
185
- return Logger._contextProvider?.() ?? void 0;
186
- }
187
- info(msg, ...args) {
188
- this.provider.info(msg, ...args);
189
- }
190
- warn(msg, ...args) {
191
- this.provider.warn(msg, ...args);
192
- }
193
- error(msgOrObj, msg, ...args) {
194
- if (typeof msgOrObj === "string") this.provider.error(msgOrObj);
195
- else if (msg) this.provider.error(msg, ...args);
196
- else this.provider.error(String(msgOrObj));
197
- }
198
- debug(msg, ...args) {
199
- this.provider.debug(msg, ...args);
200
- }
201
- trace(msg, ...args) {
202
- if (this.provider.trace) this.provider.trace(msg, ...args);
203
- else this.provider.debug(msg, ...args);
204
- }
205
- fatal(msg, ...args) {
206
- if (this.provider.fatal) this.provider.fatal(msg, ...args);
207
- else this.provider.error(msg, ...args);
208
- }
209
- };
210
- /** Shorthand for Logger.for(name) */
211
- function createLogger(name) {
212
- return Logger.for(name);
213
- }
214
- //#endregion
215
- export { ConsoleLoggerProvider, Logger, createLogger, rootLogger };
216
-
11
+ import pino from"pino";const isDev=process.env.NODE_ENV!==`production`,rootLogger=pino({level:process.env.LOG_LEVEL||`info`,...isDev?{transport:{target:`pino-pretty`,options:{colorize:!0,translateTime:`SYS:HH:MM:ss.l`,singleLine:!0,ignore:`pid,hostname,component`,messageFormat:`{if component}[{component}] {end}{msg}`}}}:{}});var PinoLoggerProvider=class PinoLoggerProvider{log;constructor(pinoInstance){this.log=pinoInstance??rootLogger}info(msg,...args){this.log.info(msg,...args)}warn(msg,...args){this.log.warn(msg,...args)}error(msg,...args){this.log.error(msg,...args)}debug(msg,...args){this.log.debug(msg,...args)}trace(msg,...args){this.log.trace(msg,...args)}fatal(msg,...args){this.log.fatal(msg,...args)}child(bindings){return new PinoLoggerProvider(this.log.child(bindings))}},ConsoleLoggerProvider=class ConsoleLoggerProvider{prefix;constructor(prefix){this.prefix=prefix??``}fmt(msg){return this.prefix?`[${this.prefix}] ${msg}`:msg}info(msg,...args){console.log(this.fmt(msg),...args)}warn(msg,...args){console.warn(this.fmt(msg),...args)}error(msg,...args){console.error(this.fmt(msg),...args)}debug(msg,...args){console.debug(this.fmt(msg),...args)}trace(msg,...args){console.trace(this.fmt(msg),...args)}fatal(msg,...args){console.error(this.fmt(msg),...args)}child(bindings){return new ConsoleLoggerProvider(bindings.component)}};let activeProvider=new PinoLoggerProvider;const loggerCache=new Map;var Logger=class Logger{_provider;_providerVersion;_name;static _contextProvider=null;static _providerVersion=0;constructor(name){this._name=name,this._providerVersion=Logger._providerVersion,this._provider=name?activeProvider.child({component:name}):activeProvider}get provider(){return this._providerVersion!==Logger._providerVersion&&(this._providerVersion=Logger._providerVersion,this._provider=this._name?activeProvider.child({component:this._name}):activeProvider),this._provider}static setProvider(provider){activeProvider=provider,Logger._providerVersion++,loggerCache.clear()}static getProvider(){return activeProvider}static resetProvider(){activeProvider=new PinoLoggerProvider,Logger._providerVersion++,loggerCache.clear()}static for(name){let cached=loggerCache.get(name);return cached||(cached=new Logger(name),loggerCache.set(name,cached)),cached}child(name){return new Logger(name)}ctx(){return Logger._contextProvider?.()??void 0}info(msg,...args){this.provider.info(msg,...args)}warn(msg,...args){this.provider.warn(msg,...args)}error(msgOrObj,msg,...args){typeof msgOrObj==`string`?this.provider.error(msgOrObj):msg?this.provider.error(msg,...args):this.provider.error(String(msgOrObj))}debug(msg,...args){this.provider.debug(msg,...args)}trace(msg,...args){this.provider.trace?this.provider.trace(msg,...args):this.provider.debug(msg,...args)}fatal(msg,...args){this.provider.fatal?this.provider.fatal(msg,...args):this.provider.error(msg,...args)}};function createLogger(name){return Logger.for(name)}export{ConsoleLoggerProvider,Logger,createLogger,rootLogger};
217
12
  //# sourceMappingURL=logger.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"logger.mjs","names":[],"sources":["../../src/core/logger.ts"],"sourcesContent":["import pino from 'pino'\n\nconst isDev = process.env.NODE_ENV !== 'production'\n\n/** Root pino logger instance */\nexport const rootLogger = pino({\n level: process.env.LOG_LEVEL || 'info',\n ...(isDev\n ? {\n transport: {\n target: 'pino-pretty',\n options: {\n colorize: true,\n translateTime: 'SYS:HH:MM:ss.l',\n singleLine: true,\n ignore: 'pid,hostname,component',\n messageFormat: '{if component}[{component}] {end}{msg}',\n },\n },\n }\n : {}),\n})\n\n// ── LoggerProvider interface ───────────────────────────────────────────\n\n/**\n * Pluggable logger backend.\n *\n * Implement this interface to replace the default pino-based logging\n * with any logging library (winston, bunyan, console, etc.).\n */\nexport interface LoggerProvider {\n info(msg: string, ...args: any[]): void\n warn(msg: string, ...args: any[]): void\n error(msg: string, ...args: any[]): void\n debug(msg: string, ...args: any[]): void\n trace?(msg: string, ...args: any[]): void\n fatal?(msg: string, ...args: any[]): void\n /** Return a child provider scoped to the given component name */\n child(bindings: { component: string }): LoggerProvider\n}\n\n// ── PinoLoggerProvider (default) ───────────────────────────────────────\n\n/** Default provider that delegates to the root pino instance */\nclass PinoLoggerProvider implements LoggerProvider {\n private log: pino.Logger\n\n constructor(pinoInstance?: pino.Logger) {\n this.log = pinoInstance ?? rootLogger\n }\n\n info(msg: string, ...args: any[]) {\n this.log.info(msg, ...args)\n }\n warn(msg: string, ...args: any[]) {\n this.log.warn(msg, ...args)\n }\n error(msg: string, ...args: any[]) {\n this.log.error(msg, ...args)\n }\n debug(msg: string, ...args: any[]) {\n this.log.debug(msg, ...args)\n }\n trace(msg: string, ...args: any[]) {\n this.log.trace(msg, ...args)\n }\n fatal(msg: string, ...args: any[]) {\n this.log.fatal(msg, ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new PinoLoggerProvider(this.log.child(bindings))\n }\n}\n\n// ── ConsoleLoggerProvider ──────────────────────────────────────────────\n\n/**\n * Built-in fallback provider that uses `console.*` methods.\n * Useful for environments where pino is unavailable or undesired.\n */\nexport class ConsoleLoggerProvider implements LoggerProvider {\n private prefix: string\n\n constructor(prefix?: string) {\n this.prefix = prefix ?? ''\n }\n\n private fmt(msg: string): string {\n return this.prefix ? `[${this.prefix}] ${msg}` : msg\n }\n\n info(msg: string, ...args: any[]) {\n console.log(this.fmt(msg), ...args)\n }\n warn(msg: string, ...args: any[]) {\n console.warn(this.fmt(msg), ...args)\n }\n error(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n debug(msg: string, ...args: any[]) {\n console.debug(this.fmt(msg), ...args)\n }\n trace(msg: string, ...args: any[]) {\n console.trace(this.fmt(msg), ...args)\n }\n fatal(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new ConsoleLoggerProvider(bindings.component)\n }\n}\n\n// ── Active provider ────────────────────────────────────────────────────\n\nlet activeProvider: LoggerProvider = new PinoLoggerProvider()\n\n/** Cache of named loggers to avoid creating duplicates */\nconst loggerCache = new Map<string, Logger>()\n\n/**\n * Named logger with component context.\n *\n * @example\n * ```ts\n * // Static factory — preferred\n * const log = Logger.for('UserService')\n * log.info('User created')\n * // Output: [UserService] User created\n *\n * // Shorthand function\n * const log = createLogger('OrderService')\n *\n * // Pluggable backend\n * Logger.setProvider(new ConsoleLoggerProvider())\n *\n * // Injectable — auto-named from class\n * class MyService {\n * @Autowired() private logger!: Logger\n * // or inject a named one:\n * private log = Logger.for('MyService')\n * }\n * ```\n */\nexport class Logger {\n private _provider: LoggerProvider\n private _providerVersion: number\n private _name?: string\n\n /**\n * Optional context provider for request-scoped log enrichment.\n * Set by the HTTP package to inject requestId from AsyncLocalStorage.\n * Returns extra fields to merge into every log call, or null if outside a request.\n */\n static _contextProvider: (() => Record<string, any> | null) | null = null\n\n /** Incremented on every setProvider/resetProvider so instances know to refresh */\n private static _providerVersion = 0\n\n constructor(name?: string) {\n this._name = name\n this._providerVersion = Logger._providerVersion\n this._provider = name ? activeProvider.child({ component: name }) : activeProvider\n }\n\n /** Re-derive the provider if setProvider() was called since construction/last access */\n private get provider(): LoggerProvider {\n if (this._providerVersion !== Logger._providerVersion) {\n this._providerVersion = Logger._providerVersion\n this._provider = this._name ? activeProvider.child({ component: this._name }) : activeProvider\n }\n return this._provider\n }\n\n /**\n * Replace the logging backend for **all** Logger instances created after\n * this call. Clears the logger cache so subsequent `Logger.for()` calls\n * pick up the new provider.\n *\n * @example\n * ```ts\n * Logger.setProvider(new ConsoleLoggerProvider())\n * ```\n */\n static setProvider(provider: LoggerProvider): void {\n activeProvider = provider\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Return the currently active provider (useful for testing) */\n static getProvider(): LoggerProvider {\n return activeProvider\n }\n\n /**\n * Reset the provider back to the default pino-based implementation.\n * Primarily intended for test teardown.\n */\n static resetProvider(): void {\n activeProvider = new PinoLoggerProvider()\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Create or retrieve a cached named logger */\n static for(name: string): Logger {\n let cached = loggerCache.get(name)\n if (!cached) {\n cached = new Logger(name)\n loggerCache.set(name, cached)\n }\n return cached\n }\n\n /** Create a child logger with a sub-component name */\n child(name: string): Logger {\n return new Logger(name)\n }\n\n /** Get request context (requestId, etc.) if inside a request */\n private ctx(): Record<string, any> | undefined {\n return Logger._contextProvider?.() ?? undefined\n }\n\n info(msg: string, ...args: any[]) {\n this.provider.info(msg, ...args)\n }\n\n warn(msg: string, ...args: any[]) {\n this.provider.warn(msg, ...args)\n }\n\n error(msgOrObj: any, msg?: string, ...args: any[]) {\n if (typeof msgOrObj === 'string') {\n this.provider.error(msgOrObj)\n } else if (msg) {\n this.provider.error(msg, ...args)\n } else {\n this.provider.error(String(msgOrObj))\n }\n }\n\n debug(msg: string, ...args: any[]) {\n this.provider.debug(msg, ...args)\n }\n\n trace(msg: string, ...args: any[]) {\n if (this.provider.trace) this.provider.trace(msg, ...args)\n else this.provider.debug(msg, ...args)\n }\n\n fatal(msg: string, ...args: any[]) {\n if (this.provider.fatal) this.provider.fatal(msg, ...args)\n else this.provider.error(msg, ...args)\n }\n}\n\n/** Shorthand for Logger.for(name) */\nexport function createLogger(name: string): Logger {\n return Logger.for(name)\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"logger.mjs","names":[],"sources":["../../src/core/logger.ts"],"sourcesContent":["import pino from 'pino'\n\nconst isDev = process.env.NODE_ENV !== 'production'\n\n/** Root pino logger instance */\nexport const rootLogger = pino({\n level: process.env.LOG_LEVEL || 'info',\n ...(isDev\n ? {\n transport: {\n target: 'pino-pretty',\n options: {\n colorize: true,\n translateTime: 'SYS:HH:MM:ss.l',\n singleLine: true,\n ignore: 'pid,hostname,component',\n messageFormat: '{if component}[{component}] {end}{msg}',\n },\n },\n }\n : {}),\n})\n\n// ── LoggerProvider interface ───────────────────────────────────────────\n\n/**\n * Pluggable logger backend.\n *\n * Implement this interface to replace the default pino-based logging\n * with any logging library (winston, bunyan, console, etc.).\n */\nexport interface LoggerProvider {\n info(msg: string, ...args: any[]): void\n warn(msg: string, ...args: any[]): void\n error(msg: string, ...args: any[]): void\n debug(msg: string, ...args: any[]): void\n trace?(msg: string, ...args: any[]): void\n fatal?(msg: string, ...args: any[]): void\n /** Return a child provider scoped to the given component name */\n child(bindings: { component: string }): LoggerProvider\n}\n\n// ── PinoLoggerProvider (default) ───────────────────────────────────────\n\n/** Default provider that delegates to the root pino instance */\nclass PinoLoggerProvider implements LoggerProvider {\n private log: pino.Logger\n\n constructor(pinoInstance?: pino.Logger) {\n this.log = pinoInstance ?? rootLogger\n }\n\n info(msg: string, ...args: any[]) {\n this.log.info(msg, ...args)\n }\n warn(msg: string, ...args: any[]) {\n this.log.warn(msg, ...args)\n }\n error(msg: string, ...args: any[]) {\n this.log.error(msg, ...args)\n }\n debug(msg: string, ...args: any[]) {\n this.log.debug(msg, ...args)\n }\n trace(msg: string, ...args: any[]) {\n this.log.trace(msg, ...args)\n }\n fatal(msg: string, ...args: any[]) {\n this.log.fatal(msg, ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new PinoLoggerProvider(this.log.child(bindings))\n }\n}\n\n// ── ConsoleLoggerProvider ──────────────────────────────────────────────\n\n/**\n * Built-in fallback provider that uses `console.*` methods.\n * Useful for environments where pino is unavailable or undesired.\n */\nexport class ConsoleLoggerProvider implements LoggerProvider {\n private prefix: string\n\n constructor(prefix?: string) {\n this.prefix = prefix ?? ''\n }\n\n private fmt(msg: string): string {\n return this.prefix ? `[${this.prefix}] ${msg}` : msg\n }\n\n info(msg: string, ...args: any[]) {\n console.log(this.fmt(msg), ...args)\n }\n warn(msg: string, ...args: any[]) {\n console.warn(this.fmt(msg), ...args)\n }\n error(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n debug(msg: string, ...args: any[]) {\n console.debug(this.fmt(msg), ...args)\n }\n trace(msg: string, ...args: any[]) {\n console.trace(this.fmt(msg), ...args)\n }\n fatal(msg: string, ...args: any[]) {\n console.error(this.fmt(msg), ...args)\n }\n child(bindings: { component: string }): LoggerProvider {\n return new ConsoleLoggerProvider(bindings.component)\n }\n}\n\n// ── Active provider ────────────────────────────────────────────────────\n\nlet activeProvider: LoggerProvider = new PinoLoggerProvider()\n\n/** Cache of named loggers to avoid creating duplicates */\nconst loggerCache = new Map<string, Logger>()\n\n/**\n * Named logger with component context.\n *\n * @example\n * ```ts\n * // Static factory — preferred\n * const log = Logger.for('UserService')\n * log.info('User created')\n * // Output: [UserService] User created\n *\n * // Shorthand function\n * const log = createLogger('OrderService')\n *\n * // Pluggable backend\n * Logger.setProvider(new ConsoleLoggerProvider())\n *\n * // Injectable — auto-named from class\n * class MyService {\n * @Autowired() private logger!: Logger\n * // or inject a named one:\n * private log = Logger.for('MyService')\n * }\n * ```\n */\nexport class Logger {\n private _provider: LoggerProvider\n private _providerVersion: number\n private _name?: string\n\n /**\n * Optional context provider for request-scoped log enrichment.\n * Set by the HTTP package to inject requestId from AsyncLocalStorage.\n * Returns extra fields to merge into every log call, or null if outside a request.\n */\n static _contextProvider: (() => Record<string, any> | null) | null = null\n\n /** Incremented on every setProvider/resetProvider so instances know to refresh */\n private static _providerVersion = 0\n\n constructor(name?: string) {\n this._name = name\n this._providerVersion = Logger._providerVersion\n this._provider = name ? activeProvider.child({ component: name }) : activeProvider\n }\n\n /** Re-derive the provider if setProvider() was called since construction/last access */\n private get provider(): LoggerProvider {\n if (this._providerVersion !== Logger._providerVersion) {\n this._providerVersion = Logger._providerVersion\n this._provider = this._name ? activeProvider.child({ component: this._name }) : activeProvider\n }\n return this._provider\n }\n\n /**\n * Replace the logging backend for **all** Logger instances created after\n * this call. Clears the logger cache so subsequent `Logger.for()` calls\n * pick up the new provider.\n *\n * @example\n * ```ts\n * Logger.setProvider(new ConsoleLoggerProvider())\n * ```\n */\n static setProvider(provider: LoggerProvider): void {\n activeProvider = provider\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Return the currently active provider (useful for testing) */\n static getProvider(): LoggerProvider {\n return activeProvider\n }\n\n /**\n * Reset the provider back to the default pino-based implementation.\n * Primarily intended for test teardown.\n */\n static resetProvider(): void {\n activeProvider = new PinoLoggerProvider()\n Logger._providerVersion++\n loggerCache.clear()\n }\n\n /** Create or retrieve a cached named logger */\n static for(name: string): Logger {\n let cached = loggerCache.get(name)\n if (!cached) {\n cached = new Logger(name)\n loggerCache.set(name, cached)\n }\n return cached\n }\n\n /** Create a child logger with a sub-component name */\n child(name: string): Logger {\n return new Logger(name)\n }\n\n /** Get request context (requestId, etc.) if inside a request */\n private ctx(): Record<string, any> | undefined {\n return Logger._contextProvider?.() ?? undefined\n }\n\n info(msg: string, ...args: any[]) {\n this.provider.info(msg, ...args)\n }\n\n warn(msg: string, ...args: any[]) {\n this.provider.warn(msg, ...args)\n }\n\n error(msgOrObj: any, msg?: string, ...args: any[]) {\n if (typeof msgOrObj === 'string') {\n this.provider.error(msgOrObj)\n } else if (msg) {\n this.provider.error(msg, ...args)\n } else {\n this.provider.error(String(msgOrObj))\n }\n }\n\n debug(msg: string, ...args: any[]) {\n this.provider.debug(msg, ...args)\n }\n\n trace(msg: string, ...args: any[]) {\n if (this.provider.trace) this.provider.trace(msg, ...args)\n else this.provider.debug(msg, ...args)\n }\n\n fatal(msg: string, ...args: any[]) {\n if (this.provider.fatal) this.provider.fatal(msg, ...args)\n else this.provider.error(msg, ...args)\n }\n}\n\n/** Shorthand for Logger.for(name) */\nexport function createLogger(name: string): Logger {\n return Logger.for(name)\n}\n"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,38 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- //#region src/core/path.ts
12
- /**
13
- * Normalize a URL path segment:
14
- * - '/' or '' or undefined → ''
15
- * - Ensures leading '/' if non-empty
16
- * - Strips trailing '/'
17
- * - Collapses consecutive '//' into single '/'
18
- */
19
- function normalizePath(path) {
20
- let p = path?.trim() || "";
21
- if (p === "/") return "";
22
- if (p && !p.startsWith("/")) p = `/${p}`;
23
- p = p.replace(/\/+$/, "");
24
- p = p.replace(/\/\/+/g, "/");
25
- return p;
26
- }
27
- /**
28
- * Join path segments into a single normalized path.
29
- * Handles leading/trailing slashes and prevents double slashes.
30
- *
31
- * @example
32
- * joinPaths('/api/v1', '/users') // '/api/v1/users'
33
- * joinPaths('/api/v1/', '/users') // '/api/v1/users'
34
- * joinPaths('/api/v1', '/') // '/api/v1'
35
- * joinPaths('/api/v1', '') // '/api/v1'
36
- * joinPaths('/api/v1', 'users') // '/api/v1/users'
37
- */
38
- function joinPaths(...segments) {
39
- const normalized = ("/" + segments.map((s) => s?.trim() || "").filter(Boolean).join("/")).replace(/\/\/+/g, "/");
40
- return normalized === "/" ? "/" : normalized.replace(/\/+$/, "");
41
- }
42
- //#endregion
43
- export { joinPaths, normalizePath };
44
-
11
+ function normalizePath(path){let p=path?.trim()||``;return p===`/`?``:(p&&!p.startsWith(`/`)&&(p=`/${p}`),p=p.replace(/\/+$/,``),p=p.replace(/\/\/+/g,`/`),p)}function joinPaths(...segments){let normalized=(`/`+segments.map(s=>s?.trim()||``).filter(Boolean).join(`/`)).replace(/\/\/+/g,`/`);return normalized===`/`?`/`:normalized.replace(/\/+$/,``)}export{joinPaths,normalizePath};
45
12
  //# sourceMappingURL=path.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"path.mjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["/**\n * Normalize a URL path segment:\n * - '/' or '' or undefined → ''\n * - Ensures leading '/' if non-empty\n * - Strips trailing '/'\n * - Collapses consecutive '//' into single '/'\n */\nexport function normalizePath(path?: string): string {\n let p = path?.trim() || ''\n if (p === '/') return ''\n if (p && !p.startsWith('/')) p = `/${p}`\n // Strip trailing slash\n p = p.replace(/\\/+$/, '')\n // Collapse double slashes\n p = p.replace(/\\/\\/+/g, '/')\n return p\n}\n\n/**\n * Join path segments into a single normalized path.\n * Handles leading/trailing slashes and prevents double slashes.\n *\n * @example\n * joinPaths('/api/v1', '/users') // '/api/v1/users'\n * joinPaths('/api/v1/', '/users') // '/api/v1/users'\n * joinPaths('/api/v1', '/') // '/api/v1'\n * joinPaths('/api/v1', '') // '/api/v1'\n * joinPaths('/api/v1', 'users') // '/api/v1/users'\n */\nexport function joinPaths(...segments: (string | undefined)[]): string {\n const joined = segments\n .map((s) => s?.trim() || '')\n .filter(Boolean)\n .join('/')\n // Ensure leading slash, collapse doubles\n const normalized = ('/' + joined).replace(/\\/\\/+/g, '/')\n // Strip trailing slash (unless it's just '/')\n return normalized === '/' ? '/' : normalized.replace(/\\/+$/, '')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAOA,SAAgB,cAAc,MAAuB;CACnD,IAAI,IAAI,MAAM,MAAM,IAAI;AACxB,KAAI,MAAM,IAAK,QAAO;AACtB,KAAI,KAAK,CAAC,EAAE,WAAW,IAAI,CAAE,KAAI,IAAI;AAErC,KAAI,EAAE,QAAQ,QAAQ,GAAG;AAEzB,KAAI,EAAE,QAAQ,UAAU,IAAI;AAC5B,QAAO;;;;;;;;;;;;;AAcT,SAAgB,UAAU,GAAG,UAA0C;CAMrE,MAAM,cAAc,MALL,SACZ,KAAK,MAAM,GAAG,MAAM,IAAI,GAAG,CAC3B,OAAO,QAAQ,CACf,KAAK,IAAI,EAEsB,QAAQ,UAAU,IAAI;AAExD,QAAO,eAAe,MAAM,MAAM,WAAW,QAAQ,QAAQ,GAAG"}
1
+ {"version":3,"file":"path.mjs","names":[],"sources":["../../src/core/path.ts"],"sourcesContent":["/**\n * Normalize a URL path segment:\n * - '/' or '' or undefined → ''\n * - Ensures leading '/' if non-empty\n * - Strips trailing '/'\n * - Collapses consecutive '//' into single '/'\n */\nexport function normalizePath(path?: string): string {\n let p = path?.trim() || ''\n if (p === '/') return ''\n if (p && !p.startsWith('/')) p = `/${p}`\n // Strip trailing slash\n p = p.replace(/\\/+$/, '')\n // Collapse double slashes\n p = p.replace(/\\/\\/+/g, '/')\n return p\n}\n\n/**\n * Join path segments into a single normalized path.\n * Handles leading/trailing slashes and prevents double slashes.\n *\n * @example\n * joinPaths('/api/v1', '/users') // '/api/v1/users'\n * joinPaths('/api/v1/', '/users') // '/api/v1/users'\n * joinPaths('/api/v1', '/') // '/api/v1'\n * joinPaths('/api/v1', '') // '/api/v1'\n * joinPaths('/api/v1', 'users') // '/api/v1/users'\n */\nexport function joinPaths(...segments: (string | undefined)[]): string {\n const joined = segments\n .map((s) => s?.trim() || '')\n .filter(Boolean)\n .join('/')\n // Ensure leading slash, collapse doubles\n const normalized = ('/' + joined).replace(/\\/\\/+/g, '/')\n // Strip trailing slash (unless it's just '/')\n return normalized === '/' ? '/' : normalized.replace(/\\/+$/, '')\n}\n"],"mappings":";;;;;;;;;;AAOA,SAAgB,cAAc,KAAuB,CACnD,IAAI,EAAI,MAAM,MAAM,EAAI,GAOxB,OANI,IAAM,IAAY,IAClB,GAAK,CAAC,EAAE,WAAW,IAAI,GAAE,EAAI,IAAI,KAErC,EAAI,EAAE,QAAQ,OAAQ,GAAG,CAEzB,EAAI,EAAE,QAAQ,SAAU,IAAI,CACrB,GAcT,SAAgB,UAAU,GAAG,SAA0C,CAMrE,IAAM,YAAc,IALL,SACZ,IAAK,GAAM,GAAG,MAAM,EAAI,GAAG,CAC3B,OAAO,QAAQ,CACf,KAAK,IAAI,EAEsB,QAAQ,SAAU,IAAI,CAExD,OAAO,aAAe,IAAM,IAAM,WAAW,QAAQ,OAAQ,GAAG"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.3.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,4 +8,4 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- export {};
11
+ export{};