@forinda/kickjs 5.2.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 (99) hide show
  1. package/dist/application-mir5CSWO.mjs +12 -0
  2. package/dist/{application-Bw87drVl.mjs.map → application-mir5CSWO.mjs.map} +1 -1
  3. package/dist/bootstrap-B7j_-dOg.mjs +12 -0
  4. package/dist/{bootstrap-CsQ7LE-W.mjs.map → bootstrap-B7j_-dOg.mjs.map} +1 -1
  5. package/dist/config/index.d.mts +1 -1
  6. package/dist/config/index.mjs +2 -4
  7. package/dist/config-Dk5RVTnD.mjs +12 -0
  8. package/dist/{config-DKRN5fqC.mjs.map → config-Dk5RVTnD.mjs.map} +1 -1
  9. package/dist/container-DArhTDQQ.mjs +12 -0
  10. package/dist/{container-C0FlgLNH.mjs.map → container-DArhTDQQ.mjs.map} +1 -1
  11. package/dist/{context-Ymvv-85x.d.mts → context-BAdAV-zO.d.mts} +48 -11
  12. package/dist/context-BAdAV-zO.d.mts.map +1 -0
  13. package/dist/context-CIoXqpAX.mjs +12 -0
  14. package/dist/context-CIoXqpAX.mjs.map +1 -0
  15. package/dist/core/adapter.mjs +2 -2
  16. package/dist/core/app-module.mjs +2 -2
  17. package/dist/core/cache.mjs +2 -103
  18. package/dist/core/cache.mjs.map +1 -1
  19. package/dist/core/container.mjs +2 -3
  20. package/dist/core/cron.mjs +2 -32
  21. package/dist/core/cron.mjs.map +1 -1
  22. package/dist/core/decorators.d.mts +2 -2
  23. package/dist/core/decorators.mjs +2 -241
  24. package/dist/core/decorators.mjs.map +1 -1
  25. package/dist/core/errors.mjs +2 -110
  26. package/dist/core/errors.mjs.map +1 -1
  27. package/dist/core/interfaces.mjs +2 -53
  28. package/dist/core/interfaces.mjs.map +1 -1
  29. package/dist/core/logger.mjs +2 -207
  30. package/dist/core/logger.mjs.map +1 -1
  31. package/dist/core/path.mjs +2 -35
  32. package/dist/core/path.mjs.map +1 -1
  33. package/dist/core/plugin.mjs +2 -2
  34. package/dist/core/reactivity.mjs +2 -179
  35. package/dist/core/reactivity.mjs.map +1 -1
  36. package/dist/core-BQZyB8Wv.mjs +12 -0
  37. package/dist/{core-K0J8AH_4.mjs.map → core-BQZyB8Wv.mjs.map} +1 -1
  38. package/dist/{decorators-CRmHuzxz.d.mts → decorators-J5mC7D-6.d.mts} +44 -4
  39. package/dist/{decorators-CRmHuzxz.d.mts.map → decorators-J5mC7D-6.d.mts.map} +1 -1
  40. package/dist/env-BL0xOTyi.mjs +12 -0
  41. package/dist/{env-CDMCT10_.mjs.map → env-BL0xOTyi.mjs.map} +1 -1
  42. package/dist/http/application.mjs +2 -3
  43. package/dist/http/bootstrap.mjs +2 -3
  44. package/dist/http/context.d.mts +2 -2
  45. package/dist/http/context.mjs +2 -3
  46. package/dist/http/middleware/cors.mjs +2 -73
  47. package/dist/http/middleware/cors.mjs.map +1 -1
  48. package/dist/http/middleware/csrf.mjs +2 -62
  49. package/dist/http/middleware/csrf.mjs.map +1 -1
  50. package/dist/http/middleware/error-handler.mjs +2 -54
  51. package/dist/http/middleware/error-handler.mjs.map +1 -1
  52. package/dist/http/middleware/helmet.mjs +2 -41
  53. package/dist/http/middleware/helmet.mjs.map +1 -1
  54. package/dist/http/middleware/rate-limit.mjs +2 -91
  55. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  56. package/dist/http/middleware/request-id.mjs +2 -25
  57. package/dist/http/middleware/request-id.mjs.map +1 -1
  58. package/dist/http/middleware/request-logger.mjs +2 -39
  59. package/dist/http/middleware/request-logger.mjs.map +1 -1
  60. package/dist/http/middleware/session.mjs +2 -167
  61. package/dist/http/middleware/session.mjs.map +1 -1
  62. package/dist/http/middleware/spa.mjs +2 -98
  63. package/dist/http/middleware/spa.mjs.map +1 -1
  64. package/dist/http/middleware/upload.d.mts +1 -1
  65. package/dist/http/middleware/upload.mjs +2 -181
  66. package/dist/http/middleware/upload.mjs.map +1 -1
  67. package/dist/http/middleware/validate.mjs +2 -68
  68. package/dist/http/middleware/validate.mjs.map +1 -1
  69. package/dist/http/middleware/views.d.mts +1 -1
  70. package/dist/http/middleware/views.mjs +2 -56
  71. package/dist/http/middleware/views.mjs.map +1 -1
  72. package/dist/http/query/index.mjs +2 -3
  73. package/dist/http/router-builder.mjs +2 -105
  74. package/dist/http/router-builder.mjs.map +1 -1
  75. package/dist/{index-DhNglXyS.d.mts → index-BbtF8kIr.d.mts} +2 -2
  76. package/dist/{index-DhNglXyS.d.mts.map → index-BbtF8kIr.d.mts.map} +1 -1
  77. package/dist/index.d.mts +6 -6
  78. package/dist/index.mjs +2 -171
  79. package/dist/index.mjs.map +1 -1
  80. package/dist/metadata-Dn6kNT82.mjs +12 -0
  81. package/dist/{metadata-DPLdmj1w.mjs.map → metadata-Dn6kNT82.mjs.map} +1 -1
  82. package/dist/query-B7n5isk_.mjs +12 -0
  83. package/dist/{query-CD0AMqxx.mjs.map → query-B7n5isk_.mjs.map} +1 -1
  84. package/dist/{upload-BM9uyR6Y.d.mts → upload-tGMrlhEB.d.mts} +2 -2
  85. package/dist/{upload-BM9uyR6Y.d.mts.map → upload-tGMrlhEB.d.mts.map} +1 -1
  86. package/dist/{views-DkNp9JJs.d.mts → views-oKRSw0Op.d.mts} +2 -2
  87. package/dist/{views-DkNp9JJs.d.mts.map → views-oKRSw0Op.d.mts.map} +1 -1
  88. package/package.json +1 -1
  89. package/dist/application-Bw87drVl.mjs +0 -574
  90. package/dist/bootstrap-CsQ7LE-W.mjs +0 -195
  91. package/dist/config-DKRN5fqC.mjs +0 -135
  92. package/dist/container-C0FlgLNH.mjs +0 -897
  93. package/dist/context-CDFiXWcV.mjs +0 -348
  94. package/dist/context-CDFiXWcV.mjs.map +0 -1
  95. package/dist/context-Ymvv-85x.d.mts.map +0 -1
  96. package/dist/core-K0J8AH_4.mjs +0 -820
  97. package/dist/env-CDMCT10_.mjs +0 -137
  98. package/dist/metadata-DPLdmj1w.mjs +0 -76
  99. package/dist/query-CD0AMqxx.mjs +0 -164
@@ -1 +1 @@
1
- {"version":3,"file":"request-logger.mjs","names":[],"sources":["../../../src/http/middleware/request-logger.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport { createLogger } from '../../core'\n\nexport interface RequestLoggerOptions {\n /** Logger name (default: 'HTTP') */\n name?: string\n /** Log level for successful requests (default: 'info') */\n level?: 'info' | 'debug' | 'trace'\n /** Skip logging for paths matching these prefixes (e.g. ['/health', '/_debug']) */\n skip?: string[]\n}\n\n/**\n * Middleware that logs every request with method, URL, status, duration, and request ID.\n *\n * @example\n * ```ts\n * bootstrap({\n * middleware: [requestId(), requestLogger(), express.json()],\n * })\n * ```\n *\n * Output:\n * ```\n * [HTTP] GET /api/v1/users 200 12ms req-abc123\n * [HTTP] POST /api/v1/users 201 45ms req-def456\n * ```\n */\nexport function requestLogger(options: RequestLoggerOptions = {}) {\n const log = createLogger(options.name ?? 'HTTP')\n const level = options.level ?? 'info'\n const skip = options.skip ?? []\n\n return (req: Request, res: Response, next: NextFunction) => {\n // Skip logging for excluded paths\n if (skip.some((prefix) => req.path.startsWith(prefix))) {\n return next()\n }\n\n const start = Date.now()\n\n res.on('finish', () => {\n const duration = Date.now() - start\n const requestId = (req as any).requestId || req.headers['x-request-id'] || '-'\n const status = res.statusCode\n\n log[level](`${req.method} ${req.originalUrl} ${status} ${duration}ms ${requestId}`)\n })\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,cAAc,UAAgC,EAAE,EAAE;CAChE,MAAM,MAAM,aAAa,QAAQ,QAAQ,OAAO;CAChD,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,OAAO,QAAQ,QAAQ,EAAE;AAE/B,SAAQ,KAAc,KAAe,SAAuB;AAE1D,MAAI,KAAK,MAAM,WAAW,IAAI,KAAK,WAAW,OAAO,CAAC,CACpD,QAAO,MAAM;EAGf,MAAM,QAAQ,KAAK,KAAK;AAExB,MAAI,GAAG,gBAAgB;GACrB,MAAM,WAAW,KAAK,KAAK,GAAG;GAC9B,MAAM,YAAa,IAAY,aAAa,IAAI,QAAQ,mBAAmB;GAC3E,MAAM,SAAS,IAAI;AAEnB,OAAI,OAAO,GAAG,IAAI,OAAO,GAAG,IAAI,YAAY,GAAG,OAAO,GAAG,SAAS,KAAK,YAAY;IACnF;AAEF,QAAM"}
1
+ {"version":3,"file":"request-logger.mjs","names":[],"sources":["../../../src/http/middleware/request-logger.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\nimport { createLogger } from '../../core'\n\nexport interface RequestLoggerOptions {\n /** Logger name (default: 'HTTP') */\n name?: string\n /** Log level for successful requests (default: 'info') */\n level?: 'info' | 'debug' | 'trace'\n /** Skip logging for paths matching these prefixes (e.g. ['/health', '/_debug']) */\n skip?: string[]\n}\n\n/**\n * Middleware that logs every request with method, URL, status, duration, and request ID.\n *\n * @example\n * ```ts\n * bootstrap({\n * middleware: [requestId(), requestLogger(), express.json()],\n * })\n * ```\n *\n * Output:\n * ```\n * [HTTP] GET /api/v1/users 200 12ms req-abc123\n * [HTTP] POST /api/v1/users 201 45ms req-def456\n * ```\n */\nexport function requestLogger(options: RequestLoggerOptions = {}) {\n const log = createLogger(options.name ?? 'HTTP')\n const level = options.level ?? 'info'\n const skip = options.skip ?? []\n\n return (req: Request, res: Response, next: NextFunction) => {\n // Skip logging for excluded paths\n if (skip.some((prefix) => req.path.startsWith(prefix))) {\n return next()\n }\n\n const start = Date.now()\n\n res.on('finish', () => {\n const duration = Date.now() - start\n const requestId = (req as any).requestId || req.headers['x-request-id'] || '-'\n const status = res.statusCode\n\n log[level](`${req.method} ${req.originalUrl} ${status} ${duration}ms ${requestId}`)\n })\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;gFA4BA,SAAgB,cAAc,QAAgC,EAAE,CAAE,CAChE,IAAM,IAAM,aAAa,QAAQ,MAAQ,OAAO,CAC1C,MAAQ,QAAQ,OAAS,OACzB,KAAO,QAAQ,MAAQ,EAAE,CAE/B,OAAQ,IAAc,IAAe,OAAuB,CAE1D,GAAI,KAAK,KAAM,QAAW,IAAI,KAAK,WAAW,OAAO,CAAC,CACpD,OAAO,MAAM,CAGf,IAAM,MAAQ,KAAK,KAAK,CAExB,IAAI,GAAG,aAAgB,CACrB,IAAM,SAAW,KAAK,KAAK,CAAG,MACxB,UAAa,IAAY,WAAa,IAAI,QAAQ,iBAAmB,IACrE,OAAS,IAAI,WAEnB,IAAI,OAAO,GAAG,IAAI,OAAO,GAAG,IAAI,YAAY,GAAG,OAAO,GAAG,SAAS,KAAK,YAAY,EACnF,CAEF,MAAM"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.2.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,170 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { createHmac, randomUUID, timingSafeEqual } from "node:crypto";
12
- //#region src/http/middleware/session.ts
13
- var MemoryStore = class {
14
- sessions = /* @__PURE__ */ new Map();
15
- cleanupInterval;
16
- constructor() {
17
- this.cleanupInterval = setInterval(() => this.purge(), 6e4);
18
- this.cleanupInterval.unref();
19
- }
20
- async get(sid) {
21
- const entry = this.sessions.get(sid);
22
- if (!entry) return null;
23
- if (Date.now() > entry.expires) {
24
- this.sessions.delete(sid);
25
- return null;
26
- }
27
- return entry.data;
28
- }
29
- async set(sid, data, maxAge) {
30
- this.sessions.set(sid, {
31
- data,
32
- expires: Date.now() + maxAge
33
- });
34
- }
35
- async destroy(sid) {
36
- this.sessions.delete(sid);
37
- }
38
- async touch(sid, maxAge) {
39
- const entry = this.sessions.get(sid);
40
- if (entry) entry.expires = Date.now() + maxAge;
41
- }
42
- purge() {
43
- const now = Date.now();
44
- for (const [sid, entry] of this.sessions) if (now > entry.expires) this.sessions.delete(sid);
45
- }
46
- };
47
- function parseCookieHeader(header) {
48
- const out = {};
49
- for (const pair of header.split(";")) {
50
- const eq = pair.indexOf("=");
51
- if (eq === -1) continue;
52
- const key = pair.slice(0, eq).trim();
53
- if (!key) continue;
54
- let value = pair.slice(eq + 1).trim();
55
- if (value.startsWith("\"") && value.endsWith("\"")) value = value.slice(1, -1);
56
- try {
57
- out[key] = decodeURIComponent(value);
58
- } catch {
59
- out[key] = value;
60
- }
61
- }
62
- return out;
63
- }
64
- function sign(value, secret) {
65
- return `s:${value}.${createHmac("sha256", secret).update(value).digest("base64url")}`;
66
- }
67
- function unsign(signed, secret) {
68
- if (!signed.startsWith("s:")) return false;
69
- const raw = signed.slice(2);
70
- const dotIndex = raw.lastIndexOf(".");
71
- if (dotIndex === -1) return false;
72
- const value = raw.slice(0, dotIndex);
73
- const providedSig = raw.slice(dotIndex + 1);
74
- const expectedSig = createHmac("sha256", secret).update(value).digest("base64url");
75
- const a = Buffer.from(providedSig);
76
- const b = Buffer.from(expectedSig);
77
- if (a.length !== b.length || !timingSafeEqual(a, b)) return false;
78
- return value;
79
- }
80
- /**
81
- * Session management middleware.
82
- *
83
- * Attaches a `req.session` object with `id`, `data`, `regenerate()`,
84
- * `destroy()`, and `save()` methods. Session IDs are signed with
85
- * HMAC-SHA256 to prevent cookie tampering.
86
- *
87
- * Reads the session cookie from `req.cookies` when an upstream cookie
88
- * parser is present; otherwise parses `req.headers.cookie` directly, so
89
- * no cookie parser is required upstream.
90
- *
91
- * @example
92
- * ```ts
93
- * import { session } from '@forinda/kickjs'
94
- *
95
- * bootstrap({
96
- * modules,
97
- * middleware: [
98
- * session({ secret: process.env.SESSION_SECRET! }),
99
- * // ... other middleware
100
- * ],
101
- * })
102
- * ```
103
- */
104
- function session(options) {
105
- const { secret, cookieName = "kick.sid", maxAge = 864e5, rolling = false, saveUninitialized = true, store = new MemoryStore(), cookie: cookieOpts = {} } = options;
106
- const cookieDefaults = {
107
- httpOnly: cookieOpts.httpOnly ?? true,
108
- secure: cookieOpts.secure ?? process.env.NODE_ENV === "production",
109
- sameSite: cookieOpts.sameSite ?? "lax",
110
- path: cookieOpts.path ?? "/",
111
- ...cookieOpts.domain ? { domain: cookieOpts.domain } : {},
112
- maxAge
113
- };
114
- return async (req, res, next) => {
115
- let cookies = req.cookies;
116
- if (!cookies) {
117
- const header = req.headers.cookie;
118
- cookies = header ? parseCookieHeader(header) : {};
119
- }
120
- const signedCookie = cookies[cookieName];
121
- let sid = false;
122
- let sessionData = null;
123
- let isNew = false;
124
- if (signedCookie) {
125
- sid = unsign(signedCookie, secret);
126
- if (sid) sessionData = await store.get(sid);
127
- }
128
- if (!sid || !sessionData) {
129
- sid = randomUUID();
130
- sessionData = {};
131
- isNew = true;
132
- }
133
- let currentSid = sid;
134
- let currentData = { ...sessionData };
135
- let destroyed = false;
136
- const sessionObj = {
137
- get id() {
138
- return currentSid;
139
- },
140
- data: currentData,
141
- async regenerate() {
142
- await store.destroy(currentSid);
143
- currentSid = randomUUID();
144
- currentData = {};
145
- sessionObj.data = currentData;
146
- await store.set(currentSid, currentData, maxAge);
147
- res.cookie(cookieName, sign(currentSid, secret), cookieDefaults);
148
- },
149
- async destroy() {
150
- await store.destroy(currentSid);
151
- destroyed = true;
152
- currentData = {};
153
- sessionObj.data = currentData;
154
- res.clearCookie(cookieName, { path: cookieDefaults.path });
155
- },
156
- async save() {
157
- if (!destroyed) await store.set(currentSid, currentData, maxAge);
158
- }
159
- };
160
- req.session = sessionObj;
161
- if (isNew) res.cookie(cookieName, sign(currentSid, secret), cookieDefaults);
162
- res.on("finish", async () => {
163
- if (destroyed) return;
164
- if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return;
165
- await store.set(currentSid, currentData, maxAge);
166
- if (rolling && !isNew) {
167
- if (store.touch) await store.touch(currentSid, maxAge);
168
- }
169
- });
170
- if (rolling && !isNew) res.cookie(cookieName, sign(currentSid, secret), cookieDefaults);
171
- next();
172
- };
173
- }
174
- //#endregion
175
- export { session };
176
-
11
+ import{createHmac,randomUUID,timingSafeEqual}from"node:crypto";var MemoryStore=class{sessions=new Map;cleanupInterval;constructor(){this.cleanupInterval=setInterval(()=>this.purge(),6e4),this.cleanupInterval.unref()}async get(sid){let entry=this.sessions.get(sid);return entry?Date.now()>entry.expires?(this.sessions.delete(sid),null):entry.data:null}async set(sid,data,maxAge){this.sessions.set(sid,{data,expires:Date.now()+maxAge})}async destroy(sid){this.sessions.delete(sid)}async touch(sid,maxAge){let entry=this.sessions.get(sid);entry&&(entry.expires=Date.now()+maxAge)}purge(){let now=Date.now();for(let[sid,entry]of this.sessions)now>entry.expires&&this.sessions.delete(sid)}};function parseCookieHeader(header){let out={};for(let pair of header.split(`;`)){let eq=pair.indexOf(`=`);if(eq===-1)continue;let key=pair.slice(0,eq).trim();if(!key)continue;let value=pair.slice(eq+1).trim();value.startsWith(`"`)&&value.endsWith(`"`)&&(value=value.slice(1,-1));try{out[key]=decodeURIComponent(value)}catch{out[key]=value}}return out}function sign(value,secret){return`s:${value}.${createHmac(`sha256`,secret).update(value).digest(`base64url`)}`}function unsign(signed,secret){if(!signed.startsWith(`s:`))return!1;let raw=signed.slice(2),dotIndex=raw.lastIndexOf(`.`);if(dotIndex===-1)return!1;let value=raw.slice(0,dotIndex),providedSig=raw.slice(dotIndex+1),expectedSig=createHmac(`sha256`,secret).update(value).digest(`base64url`),a=Buffer.from(providedSig),b=Buffer.from(expectedSig);return a.length!==b.length||!timingSafeEqual(a,b)?!1:value}function session(options){let{secret,cookieName=`kick.sid`,maxAge=864e5,rolling=!1,saveUninitialized=!0,store=new MemoryStore,cookie:cookieOpts={}}=options,cookieDefaults={httpOnly:cookieOpts.httpOnly??!0,secure:cookieOpts.secure??process.env.NODE_ENV===`production`,sameSite:cookieOpts.sameSite??`lax`,path:cookieOpts.path??`/`,...cookieOpts.domain?{domain:cookieOpts.domain}:{},maxAge};return async(req,res,next)=>{let cookies=req.cookies;if(!cookies){let header=req.headers.cookie;cookies=header?parseCookieHeader(header):{}}let signedCookie=cookies[cookieName],sid=!1,sessionData=null,isNew=!1;signedCookie&&(sid=unsign(signedCookie,secret),sid&&(sessionData=await store.get(sid))),(!sid||!sessionData)&&(sid=randomUUID(),sessionData={},isNew=!0);let currentSid=sid,currentData={...sessionData},destroyed=!1,sessionObj={get id(){return currentSid},data:currentData,async regenerate(){await store.destroy(currentSid),currentSid=randomUUID(),currentData={},sessionObj.data=currentData,await store.set(currentSid,currentData,maxAge),res.cookie(cookieName,sign(currentSid,secret),cookieDefaults)},async destroy(){await store.destroy(currentSid),destroyed=!0,currentData={},sessionObj.data=currentData,res.clearCookie(cookieName,{path:cookieDefaults.path})},async save(){destroyed||await store.set(currentSid,currentData,maxAge)}};req.session=sessionObj,isNew&&res.cookie(cookieName,sign(currentSid,secret),cookieDefaults),res.on(`finish`,async()=>{destroyed||isNew&&!saveUninitialized&&Object.keys(currentData).length===0||(await store.set(currentSid,currentData,maxAge),rolling&&!isNew&&store.touch&&await store.touch(currentSid,maxAge))}),rolling&&!isNew&&res.cookie(cookieName,sign(currentSid,secret),cookieDefaults),next()}}export{session};
177
12
  //# sourceMappingURL=session.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"session.mjs","names":[],"sources":["../../../src/http/middleware/session.ts"],"sourcesContent":["import { randomUUID, createHmac, timingSafeEqual } from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\n\nexport interface SessionData {\n [key: string]: unknown\n}\n\nexport interface SessionStore {\n get(sid: string): Promise<SessionData | null>\n set(sid: string, data: SessionData, maxAge: number): Promise<void>\n destroy(sid: string): Promise<void>\n touch?(sid: string, maxAge: number): Promise<void>\n}\n\nexport interface Session {\n id: string\n data: SessionData\n regenerate(): Promise<void>\n destroy(): Promise<void>\n save(): Promise<void>\n}\n\nexport interface SessionOptions {\n /** Secret used to sign the session cookie (required) */\n secret: string\n /** Cookie name (default: 'kick.sid') */\n cookieName?: string\n /** Session max age in milliseconds (default: 86400000 = 24h) */\n maxAge?: number\n /** Reset maxAge on every response (default: false) */\n rolling?: boolean\n /** Save new sessions that have not been modified (default: true) */\n saveUninitialized?: boolean\n /** Cookie options */\n cookie?: {\n httpOnly?: boolean\n secure?: boolean\n sameSite?: 'strict' | 'lax' | 'none'\n path?: string\n domain?: string\n }\n /** Custom session store (default: in-memory store with TTL cleanup) */\n store?: SessionStore\n}\n\n// ── In-Memory Store ───────────────────────────────────────────────────\n\nclass MemoryStore implements SessionStore {\n private readonly sessions = new Map<string, { data: SessionData; expires: number }>()\n private readonly cleanupInterval: ReturnType<typeof setInterval>\n\n constructor() {\n // Purge expired sessions every 60 seconds\n this.cleanupInterval = setInterval(() => this.purge(), 60_000)\n this.cleanupInterval.unref()\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const entry = this.sessions.get(sid)\n if (!entry) return null\n if (Date.now() > entry.expires) {\n this.sessions.delete(sid)\n return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.delete(sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const entry = this.sessions.get(sid)\n if (entry) {\n entry.expires = Date.now() + maxAge\n }\n }\n\n private purge() {\n const now = Date.now()\n for (const [sid, entry] of this.sessions) {\n if (now > entry.expires) {\n this.sessions.delete(sid)\n }\n }\n }\n}\n\n// ── Cookie Header Parsing ─────────────────────────────────────────────\n\nfunction parseCookieHeader(header: string): Record<string, string> {\n const out: Record<string, string> = {}\n for (const pair of header.split(';')) {\n const eq = pair.indexOf('=')\n if (eq === -1) continue\n const key = pair.slice(0, eq).trim()\n if (!key) continue\n let value = pair.slice(eq + 1).trim()\n if (value.startsWith('\"') && value.endsWith('\"')) {\n value = value.slice(1, -1)\n }\n try {\n out[key] = decodeURIComponent(value)\n } catch {\n out[key] = value\n }\n }\n return out\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\n\nfunction sign(value: string, secret: string): string {\n const signature = createHmac('sha256', secret).update(value).digest('base64url')\n return `s:${value}.${signature}`\n}\n\nfunction unsign(signed: string, secret: string): string | false {\n if (!signed.startsWith('s:')) return false\n const raw = signed.slice(2)\n const dotIndex = raw.lastIndexOf('.')\n if (dotIndex === -1) return false\n\n const value = raw.slice(0, dotIndex)\n const providedSig = raw.slice(dotIndex + 1)\n const expectedSig = createHmac('sha256', secret).update(value).digest('base64url')\n\n const a = Buffer.from(providedSig)\n const b = Buffer.from(expectedSig)\n\n if (a.length !== b.length || !timingSafeEqual(a, b)) {\n return false\n }\n\n return value\n}\n\n// ── Middleware Factory ────────────────────────────────────────────────\n\n/**\n * Session management middleware.\n *\n * Attaches a `req.session` object with `id`, `data`, `regenerate()`,\n * `destroy()`, and `save()` methods. Session IDs are signed with\n * HMAC-SHA256 to prevent cookie tampering.\n *\n * Reads the session cookie from `req.cookies` when an upstream cookie\n * parser is present; otherwise parses `req.headers.cookie` directly, so\n * no cookie parser is required upstream.\n *\n * @example\n * ```ts\n * import { session } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middleware: [\n * session({ secret: process.env.SESSION_SECRET! }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function session(options: SessionOptions) {\n const {\n secret,\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n store = new MemoryStore(),\n cookie: cookieOpts = {},\n } = options\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? process.env.NODE_ENV === 'production',\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n maxAge,\n }\n\n return async (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const signedCookie = cookies[cookieName]\n let sid: string | false = false\n let sessionData: SessionData | null = null\n let isNew = false\n\n // Attempt to recover existing session\n if (signedCookie) {\n sid = unsign(signedCookie, secret)\n if (sid) {\n sessionData = await store.get(sid)\n }\n }\n\n // Create new session if none found\n if (!sid || !sessionData) {\n sid = randomUUID()\n sessionData = {}\n isNew = true\n }\n\n let currentSid = sid\n let currentData = { ...sessionData }\n let destroyed = false\n\n const sessionObj: Session = {\n get id() {\n return currentSid\n },\n data: currentData,\n\n async regenerate() {\n await store.destroy(currentSid)\n currentSid = randomUUID()\n currentData = {}\n sessionObj.data = currentData\n await store.set(currentSid, currentData, maxAge)\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n },\n\n async destroy() {\n await store.destroy(currentSid)\n destroyed = true\n currentData = {}\n sessionObj.data = currentData\n res.clearCookie(cookieName, { path: cookieDefaults.path })\n },\n\n async save() {\n if (!destroyed) {\n await store.set(currentSid, currentData, maxAge)\n }\n },\n }\n\n ;(req as any).session = sessionObj\n\n // Set cookie for new sessions\n if (isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n // Auto-save on response finish\n res.on('finish', async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n\n await store.set(currentSid, currentData, maxAge)\n\n if (rolling && !isNew) {\n if (store.touch) {\n await store.touch(currentSid, maxAge)\n }\n }\n })\n\n // Rolling: refresh cookie on every response\n if (rolling && !isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n next()\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"session.mjs","names":[],"sources":["../../../src/http/middleware/session.ts"],"sourcesContent":["import { randomUUID, createHmac, timingSafeEqual } from 'node:crypto'\nimport type { Request, Response, NextFunction } from 'express'\n\nexport interface SessionData {\n [key: string]: unknown\n}\n\nexport interface SessionStore {\n get(sid: string): Promise<SessionData | null>\n set(sid: string, data: SessionData, maxAge: number): Promise<void>\n destroy(sid: string): Promise<void>\n touch?(sid: string, maxAge: number): Promise<void>\n}\n\nexport interface Session {\n id: string\n data: SessionData\n regenerate(): Promise<void>\n destroy(): Promise<void>\n save(): Promise<void>\n}\n\nexport interface SessionOptions {\n /** Secret used to sign the session cookie (required) */\n secret: string\n /** Cookie name (default: 'kick.sid') */\n cookieName?: string\n /** Session max age in milliseconds (default: 86400000 = 24h) */\n maxAge?: number\n /** Reset maxAge on every response (default: false) */\n rolling?: boolean\n /** Save new sessions that have not been modified (default: true) */\n saveUninitialized?: boolean\n /** Cookie options */\n cookie?: {\n httpOnly?: boolean\n secure?: boolean\n sameSite?: 'strict' | 'lax' | 'none'\n path?: string\n domain?: string\n }\n /** Custom session store (default: in-memory store with TTL cleanup) */\n store?: SessionStore\n}\n\n// ── In-Memory Store ───────────────────────────────────────────────────\n\nclass MemoryStore implements SessionStore {\n private readonly sessions = new Map<string, { data: SessionData; expires: number }>()\n private readonly cleanupInterval: ReturnType<typeof setInterval>\n\n constructor() {\n // Purge expired sessions every 60 seconds\n this.cleanupInterval = setInterval(() => this.purge(), 60_000)\n this.cleanupInterval.unref()\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const entry = this.sessions.get(sid)\n if (!entry) return null\n if (Date.now() > entry.expires) {\n this.sessions.delete(sid)\n return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.delete(sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const entry = this.sessions.get(sid)\n if (entry) {\n entry.expires = Date.now() + maxAge\n }\n }\n\n private purge() {\n const now = Date.now()\n for (const [sid, entry] of this.sessions) {\n if (now > entry.expires) {\n this.sessions.delete(sid)\n }\n }\n }\n}\n\n// ── Cookie Header Parsing ─────────────────────────────────────────────\n\nfunction parseCookieHeader(header: string): Record<string, string> {\n const out: Record<string, string> = {}\n for (const pair of header.split(';')) {\n const eq = pair.indexOf('=')\n if (eq === -1) continue\n const key = pair.slice(0, eq).trim()\n if (!key) continue\n let value = pair.slice(eq + 1).trim()\n if (value.startsWith('\"') && value.endsWith('\"')) {\n value = value.slice(1, -1)\n }\n try {\n out[key] = decodeURIComponent(value)\n } catch {\n out[key] = value\n }\n }\n return out\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\n\nfunction sign(value: string, secret: string): string {\n const signature = createHmac('sha256', secret).update(value).digest('base64url')\n return `s:${value}.${signature}`\n}\n\nfunction unsign(signed: string, secret: string): string | false {\n if (!signed.startsWith('s:')) return false\n const raw = signed.slice(2)\n const dotIndex = raw.lastIndexOf('.')\n if (dotIndex === -1) return false\n\n const value = raw.slice(0, dotIndex)\n const providedSig = raw.slice(dotIndex + 1)\n const expectedSig = createHmac('sha256', secret).update(value).digest('base64url')\n\n const a = Buffer.from(providedSig)\n const b = Buffer.from(expectedSig)\n\n if (a.length !== b.length || !timingSafeEqual(a, b)) {\n return false\n }\n\n return value\n}\n\n// ── Middleware Factory ────────────────────────────────────────────────\n\n/**\n * Session management middleware.\n *\n * Attaches a `req.session` object with `id`, `data`, `regenerate()`,\n * `destroy()`, and `save()` methods. Session IDs are signed with\n * HMAC-SHA256 to prevent cookie tampering.\n *\n * Reads the session cookie from `req.cookies` when an upstream cookie\n * parser is present; otherwise parses `req.headers.cookie` directly, so\n * no cookie parser is required upstream.\n *\n * @example\n * ```ts\n * import { session } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middleware: [\n * session({ secret: process.env.SESSION_SECRET! }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function session(options: SessionOptions) {\n const {\n secret,\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n store = new MemoryStore(),\n cookie: cookieOpts = {},\n } = options\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? process.env.NODE_ENV === 'production',\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n maxAge,\n }\n\n return async (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const signedCookie = cookies[cookieName]\n let sid: string | false = false\n let sessionData: SessionData | null = null\n let isNew = false\n\n // Attempt to recover existing session\n if (signedCookie) {\n sid = unsign(signedCookie, secret)\n if (sid) {\n sessionData = await store.get(sid)\n }\n }\n\n // Create new session if none found\n if (!sid || !sessionData) {\n sid = randomUUID()\n sessionData = {}\n isNew = true\n }\n\n let currentSid = sid\n let currentData = { ...sessionData }\n let destroyed = false\n\n const sessionObj: Session = {\n get id() {\n return currentSid\n },\n data: currentData,\n\n async regenerate() {\n await store.destroy(currentSid)\n currentSid = randomUUID()\n currentData = {}\n sessionObj.data = currentData\n await store.set(currentSid, currentData, maxAge)\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n },\n\n async destroy() {\n await store.destroy(currentSid)\n destroyed = true\n currentData = {}\n sessionObj.data = currentData\n res.clearCookie(cookieName, { path: cookieDefaults.path })\n },\n\n async save() {\n if (!destroyed) {\n await store.set(currentSid, currentData, maxAge)\n }\n },\n }\n\n ;(req as any).session = sessionObj\n\n // Set cookie for new sessions\n if (isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n // Auto-save on response finish\n res.on('finish', async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n\n await store.set(currentSid, currentData, maxAge)\n\n if (rolling && !isNew) {\n if (store.touch) {\n await store.touch(currentSid, maxAge)\n }\n }\n })\n\n // Rolling: refresh cookie on every response\n if (rolling && !isNew) {\n res.cookie(cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n next()\n }\n}\n"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.2.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,101 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { h as __require } from "../../container-C0FlgLNH.mjs";
12
- import { Logger } from "../../core/logger.mjs";
13
- import "../../core-K0J8AH_4.mjs";
14
- import { existsSync, readFileSync } from "node:fs";
15
- import { join, resolve } from "node:path";
16
- //#region src/http/middleware/spa.ts
17
- const log = Logger.for("SpaAdapter");
18
- /**
19
- * SPA adapter — serve a Vue, React, Svelte, or Angular build alongside
20
- * your KickJS API. API routes are handled by controllers; everything else
21
- * falls back to index.html for client-side routing.
22
- *
23
- * @example
24
- * ```ts
25
- * import { SpaAdapter } from '@forinda/kickjs/spa'
26
- *
27
- * bootstrap({
28
- * modules,
29
- * adapters: [
30
- * new SpaAdapter({
31
- * clientDir: 'dist/client', // or 'build', 'dist', etc.
32
- * apiPrefix: '/api',
33
- * }),
34
- * ],
35
- * })
36
- * ```
37
- *
38
- * File structure:
39
- * ```
40
- * dist/
41
- * client/ ← SPA build output
42
- * index.html
43
- * assets/
44
- * app.js
45
- * style.css
46
- * server/ ← KickJS server
47
- * ```
48
- */
49
- var SpaAdapter = class {
50
- name = "SpaAdapter";
51
- clientDir;
52
- apiPrefixes;
53
- excludePaths;
54
- cacheControl;
55
- indexCacheControl;
56
- indexHtml = null;
57
- constructor(options = {}) {
58
- this.options = options;
59
- this.clientDir = resolve(options.clientDir ?? "dist/client");
60
- this.excludePaths = options.exclude ?? [];
61
- this.cacheControl = options.cacheControl ?? "public, max-age=31536000, immutable";
62
- this.indexCacheControl = options.indexCacheControl ?? "no-cache";
63
- const prefix = options.apiPrefix ?? "/api";
64
- this.apiPrefixes = Array.isArray(prefix) ? prefix : [prefix];
65
- }
66
- beforeMount({ app }) {
67
- if (!existsSync(this.clientDir)) {
68
- log.warn(`SPA client directory not found: ${this.clientDir}`);
69
- log.warn("Build your frontend first, or set clientDir to the correct path.");
70
- return;
71
- }
72
- const indexPath = join(this.clientDir, "index.html");
73
- if (existsSync(indexPath)) this.indexHtml = readFileSync(indexPath, "utf-8");
74
- else {
75
- log.warn(`index.html not found in ${this.clientDir}`);
76
- return;
77
- }
78
- try {
79
- const express = __require("express");
80
- const staticOpts = {};
81
- if (this.cacheControl) staticOpts.setHeaders = (res, filePath) => {
82
- if (filePath.endsWith(".html")) res.setHeader("Cache-Control", this.indexCacheControl);
83
- else res.setHeader("Cache-Control", this.cacheControl);
84
- };
85
- app.use(express.static(this.clientDir, staticOpts));
86
- } catch {
87
- log.error("express.static not available — SPA static file serving disabled");
88
- return;
89
- }
90
- log.debug(`Serving SPA from ${this.clientDir}`);
91
- }
92
- beforeStart({ app }) {
93
- if (!this.indexHtml) return;
94
- app.use((req, res, next) => {
95
- for (const prefix of this.apiPrefixes) if (req.path.startsWith(prefix)) return next();
96
- for (const path of this.excludePaths) if (req.path.startsWith(path)) return next();
97
- if (req.path.includes(".")) return next();
98
- if (req.method !== "GET") return next();
99
- res.setHeader("Content-Type", "text/html");
100
- res.setHeader("Cache-Control", this.indexCacheControl);
101
- res.send(this.indexHtml);
102
- });
103
- }
104
- };
105
- //#endregion
106
- export { SpaAdapter };
107
-
11
+ import{h as __require}from"../../container-DArhTDQQ.mjs";import{Logger}from"../../core/logger.mjs";import"../../core-BQZyB8Wv.mjs";import{existsSync,readFileSync}from"node:fs";import{join,resolve}from"node:path";const log=Logger.for(`SpaAdapter`);var SpaAdapter=class{name=`SpaAdapter`;clientDir;apiPrefixes;excludePaths;cacheControl;indexCacheControl;indexHtml=null;constructor(options={}){this.options=options,this.clientDir=resolve(options.clientDir??`dist/client`),this.excludePaths=options.exclude??[],this.cacheControl=options.cacheControl??`public, max-age=31536000, immutable`,this.indexCacheControl=options.indexCacheControl??`no-cache`;let prefix=options.apiPrefix??`/api`;this.apiPrefixes=Array.isArray(prefix)?prefix:[prefix]}beforeMount({app}){if(!existsSync(this.clientDir)){log.warn(`SPA client directory not found: ${this.clientDir}`),log.warn(`Build your frontend first, or set clientDir to the correct path.`);return}let indexPath=join(this.clientDir,`index.html`);if(existsSync(indexPath))this.indexHtml=readFileSync(indexPath,`utf-8`);else{log.warn(`index.html not found in ${this.clientDir}`);return}try{let express=__require(`express`),staticOpts={};this.cacheControl&&(staticOpts.setHeaders=(res,filePath)=>{filePath.endsWith(`.html`)?res.setHeader(`Cache-Control`,this.indexCacheControl):res.setHeader(`Cache-Control`,this.cacheControl)}),app.use(express.static(this.clientDir,staticOpts))}catch{log.error(`express.static not available — SPA static file serving disabled`);return}log.debug(`Serving SPA from ${this.clientDir}`)}beforeStart({app}){this.indexHtml&&app.use((req,res,next)=>{for(let prefix of this.apiPrefixes)if(req.path.startsWith(prefix))return next();for(let path of this.excludePaths)if(req.path.startsWith(path))return next();if(req.path.includes(`.`)||req.method!==`GET`)return next();res.setHeader(`Content-Type`,`text/html`),res.setHeader(`Cache-Control`,this.indexCacheControl),res.send(this.indexHtml)})}};export{SpaAdapter};
108
12
  //# sourceMappingURL=spa.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"spa.mjs","names":[],"sources":["../../../src/http/middleware/spa.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { Logger, type AppAdapter, type AdapterContext } from '../../core'\n\nconst log = Logger.for('SpaAdapter')\n\nexport interface SpaAdapterOptions {\n /**\n * Directory containing the built SPA files (index.html, assets, etc.)\n * Default: 'dist/client'\n *\n * @example\n * ```ts\n * // Vue: 'dist'\n * // React (Vite): 'dist'\n * // React (CRA): 'build'\n * // Svelte: 'build'\n * // Angular: 'dist/my-app/browser'\n * ```\n */\n clientDir?: string\n\n /**\n * URL prefix for API routes. SPA fallback only applies to\n * non-API routes (routes NOT starting with this prefix).\n * Default: '/api'\n *\n * Set to an array for multiple prefixes:\n * ```ts\n * apiPrefix: ['/api', '/graphql', '/_debug']\n * ```\n */\n apiPrefix?: string | string[]\n\n /**\n * Additional paths to exclude from SPA fallback.\n * These paths will NOT serve index.html.\n *\n * @example\n * ```ts\n * exclude: ['/health', '/metrics', '/ws']\n * ```\n */\n exclude?: string[]\n\n /**\n * Cache-Control header for static assets (default: 'public, max-age=31536000, immutable')\n * Set to false to disable caching headers.\n */\n cacheControl?: string | false\n\n /**\n * Cache-Control for index.html (default: 'no-cache')\n * index.html should not be cached to ensure clients get fresh builds.\n */\n indexCacheControl?: string\n}\n\n/**\n * SPA adapter — serve a Vue, React, Svelte, or Angular build alongside\n * your KickJS API. API routes are handled by controllers; everything else\n * falls back to index.html for client-side routing.\n *\n * @example\n * ```ts\n * import { SpaAdapter } from '@forinda/kickjs/spa'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * new SpaAdapter({\n * clientDir: 'dist/client', // or 'build', 'dist', etc.\n * apiPrefix: '/api',\n * }),\n * ],\n * })\n * ```\n *\n * File structure:\n * ```\n * dist/\n * client/ ← SPA build output\n * index.html\n * assets/\n * app.js\n * style.css\n * server/ ← KickJS server\n * ```\n */\nexport class SpaAdapter implements AppAdapter {\n name = 'SpaAdapter'\n private clientDir: string\n private apiPrefixes: string[]\n private excludePaths: string[]\n private cacheControl: string | false\n private indexCacheControl: string\n private indexHtml: string | null = null\n\n constructor(private options: SpaAdapterOptions = {}) {\n this.clientDir = resolve(options.clientDir ?? 'dist/client')\n this.excludePaths = options.exclude ?? []\n this.cacheControl = options.cacheControl ?? 'public, max-age=31536000, immutable'\n this.indexCacheControl = options.indexCacheControl ?? 'no-cache'\n\n const prefix = options.apiPrefix ?? '/api'\n this.apiPrefixes = Array.isArray(prefix) ? prefix : [prefix]\n }\n\n beforeMount({ app }: AdapterContext): void {\n if (!existsSync(this.clientDir)) {\n log.warn(`SPA client directory not found: ${this.clientDir}`)\n log.warn('Build your frontend first, or set clientDir to the correct path.')\n return\n }\n\n // Read index.html into memory\n const indexPath = join(this.clientDir, 'index.html')\n if (existsSync(indexPath)) {\n this.indexHtml = readFileSync(indexPath, 'utf-8')\n } else {\n log.warn(`index.html not found in ${this.clientDir}`)\n return\n }\n\n // Serve static files with cache headers\n try {\n // Dynamic import to avoid hard dependency on express.static\n const express = require('express')\n const staticOpts: any = {}\n\n if (this.cacheControl) {\n staticOpts.setHeaders = (res: any, filePath: string) => {\n if (filePath.endsWith('.html')) {\n res.setHeader('Cache-Control', this.indexCacheControl)\n } else {\n res.setHeader('Cache-Control', this.cacheControl as string)\n }\n }\n }\n\n app.use(express.static(this.clientDir, staticOpts))\n } catch {\n log.error('express.static not available — SPA static file serving disabled')\n return\n }\n\n log.debug(`Serving SPA from ${this.clientDir}`)\n }\n\n beforeStart({ app }: AdapterContext): void {\n if (!this.indexHtml) return\n\n // SPA fallback: serve index.html for all non-API, non-file routes\n app.use((req: any, res: any, next: any) => {\n // Skip API routes\n for (const prefix of this.apiPrefixes) {\n if (req.path.startsWith(prefix)) return next()\n }\n\n // Skip excluded paths\n for (const path of this.excludePaths) {\n if (req.path.startsWith(path)) return next()\n }\n\n // Skip requests for files (have an extension)\n if (req.path.includes('.')) return next()\n\n // Skip non-GET requests\n if (req.method !== 'GET') return next()\n\n // Serve index.html\n res.setHeader('Content-Type', 'text/html')\n res.setHeader('Cache-Control', this.indexCacheControl)\n res.send(this.indexHtml)\n })\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAIA,MAAM,MAAM,OAAO,IAAI,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqFpC,IAAa,aAAb,MAA8C;CAC5C,OAAO;CACP;CACA;CACA;CACA;CACA;CACA,YAAmC;CAEnC,YAAY,UAAqC,EAAE,EAAE;AAAjC,OAAA,UAAA;AAClB,OAAK,YAAY,QAAQ,QAAQ,aAAa,cAAc;AAC5D,OAAK,eAAe,QAAQ,WAAW,EAAE;AACzC,OAAK,eAAe,QAAQ,gBAAgB;AAC5C,OAAK,oBAAoB,QAAQ,qBAAqB;EAEtD,MAAM,SAAS,QAAQ,aAAa;AACpC,OAAK,cAAc,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO;;CAG9D,YAAY,EAAE,OAA6B;AACzC,MAAI,CAAC,WAAW,KAAK,UAAU,EAAE;AAC/B,OAAI,KAAK,mCAAmC,KAAK,YAAY;AAC7D,OAAI,KAAK,mEAAmE;AAC5E;;EAIF,MAAM,YAAY,KAAK,KAAK,WAAW,aAAa;AACpD,MAAI,WAAW,UAAU,CACvB,MAAK,YAAY,aAAa,WAAW,QAAQ;OAC5C;AACL,OAAI,KAAK,2BAA2B,KAAK,YAAY;AACrD;;AAIF,MAAI;GAEF,MAAM,UAAA,UAAkB,UAAU;GAClC,MAAM,aAAkB,EAAE;AAE1B,OAAI,KAAK,aACP,YAAW,cAAc,KAAU,aAAqB;AACtD,QAAI,SAAS,SAAS,QAAQ,CAC5B,KAAI,UAAU,iBAAiB,KAAK,kBAAkB;QAEtD,KAAI,UAAU,iBAAiB,KAAK,aAAuB;;AAKjE,OAAI,IAAI,QAAQ,OAAO,KAAK,WAAW,WAAW,CAAC;UAC7C;AACN,OAAI,MAAM,kEAAkE;AAC5E;;AAGF,MAAI,MAAM,oBAAoB,KAAK,YAAY;;CAGjD,YAAY,EAAE,OAA6B;AACzC,MAAI,CAAC,KAAK,UAAW;AAGrB,MAAI,KAAK,KAAU,KAAU,SAAc;AAEzC,QAAK,MAAM,UAAU,KAAK,YACxB,KAAI,IAAI,KAAK,WAAW,OAAO,CAAE,QAAO,MAAM;AAIhD,QAAK,MAAM,QAAQ,KAAK,aACtB,KAAI,IAAI,KAAK,WAAW,KAAK,CAAE,QAAO,MAAM;AAI9C,OAAI,IAAI,KAAK,SAAS,IAAI,CAAE,QAAO,MAAM;AAGzC,OAAI,IAAI,WAAW,MAAO,QAAO,MAAM;AAGvC,OAAI,UAAU,gBAAgB,YAAY;AAC1C,OAAI,UAAU,iBAAiB,KAAK,kBAAkB;AACtD,OAAI,KAAK,KAAK,UAAU;IACxB"}
1
+ {"version":3,"file":"spa.mjs","names":[],"sources":["../../../src/http/middleware/spa.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { Logger, type AppAdapter, type AdapterContext } from '../../core'\n\nconst log = Logger.for('SpaAdapter')\n\nexport interface SpaAdapterOptions {\n /**\n * Directory containing the built SPA files (index.html, assets, etc.)\n * Default: 'dist/client'\n *\n * @example\n * ```ts\n * // Vue: 'dist'\n * // React (Vite): 'dist'\n * // React (CRA): 'build'\n * // Svelte: 'build'\n * // Angular: 'dist/my-app/browser'\n * ```\n */\n clientDir?: string\n\n /**\n * URL prefix for API routes. SPA fallback only applies to\n * non-API routes (routes NOT starting with this prefix).\n * Default: '/api'\n *\n * Set to an array for multiple prefixes:\n * ```ts\n * apiPrefix: ['/api', '/graphql', '/_debug']\n * ```\n */\n apiPrefix?: string | string[]\n\n /**\n * Additional paths to exclude from SPA fallback.\n * These paths will NOT serve index.html.\n *\n * @example\n * ```ts\n * exclude: ['/health', '/metrics', '/ws']\n * ```\n */\n exclude?: string[]\n\n /**\n * Cache-Control header for static assets (default: 'public, max-age=31536000, immutable')\n * Set to false to disable caching headers.\n */\n cacheControl?: string | false\n\n /**\n * Cache-Control for index.html (default: 'no-cache')\n * index.html should not be cached to ensure clients get fresh builds.\n */\n indexCacheControl?: string\n}\n\n/**\n * SPA adapter — serve a Vue, React, Svelte, or Angular build alongside\n * your KickJS API. API routes are handled by controllers; everything else\n * falls back to index.html for client-side routing.\n *\n * @example\n * ```ts\n * import { SpaAdapter } from '@forinda/kickjs/spa'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * new SpaAdapter({\n * clientDir: 'dist/client', // or 'build', 'dist', etc.\n * apiPrefix: '/api',\n * }),\n * ],\n * })\n * ```\n *\n * File structure:\n * ```\n * dist/\n * client/ ← SPA build output\n * index.html\n * assets/\n * app.js\n * style.css\n * server/ ← KickJS server\n * ```\n */\nexport class SpaAdapter implements AppAdapter {\n name = 'SpaAdapter'\n private clientDir: string\n private apiPrefixes: string[]\n private excludePaths: string[]\n private cacheControl: string | false\n private indexCacheControl: string\n private indexHtml: string | null = null\n\n constructor(private options: SpaAdapterOptions = {}) {\n this.clientDir = resolve(options.clientDir ?? 'dist/client')\n this.excludePaths = options.exclude ?? []\n this.cacheControl = options.cacheControl ?? 'public, max-age=31536000, immutable'\n this.indexCacheControl = options.indexCacheControl ?? 'no-cache'\n\n const prefix = options.apiPrefix ?? '/api'\n this.apiPrefixes = Array.isArray(prefix) ? prefix : [prefix]\n }\n\n beforeMount({ app }: AdapterContext): void {\n if (!existsSync(this.clientDir)) {\n log.warn(`SPA client directory not found: ${this.clientDir}`)\n log.warn('Build your frontend first, or set clientDir to the correct path.')\n return\n }\n\n // Read index.html into memory\n const indexPath = join(this.clientDir, 'index.html')\n if (existsSync(indexPath)) {\n this.indexHtml = readFileSync(indexPath, 'utf-8')\n } else {\n log.warn(`index.html not found in ${this.clientDir}`)\n return\n }\n\n // Serve static files with cache headers\n try {\n // Dynamic import to avoid hard dependency on express.static\n const express = require('express')\n const staticOpts: any = {}\n\n if (this.cacheControl) {\n staticOpts.setHeaders = (res: any, filePath: string) => {\n if (filePath.endsWith('.html')) {\n res.setHeader('Cache-Control', this.indexCacheControl)\n } else {\n res.setHeader('Cache-Control', this.cacheControl as string)\n }\n }\n }\n\n app.use(express.static(this.clientDir, staticOpts))\n } catch {\n log.error('express.static not available — SPA static file serving disabled')\n return\n }\n\n log.debug(`Serving SPA from ${this.clientDir}`)\n }\n\n beforeStart({ app }: AdapterContext): void {\n if (!this.indexHtml) return\n\n // SPA fallback: serve index.html for all non-API, non-file routes\n app.use((req: any, res: any, next: any) => {\n // Skip API routes\n for (const prefix of this.apiPrefixes) {\n if (req.path.startsWith(prefix)) return next()\n }\n\n // Skip excluded paths\n for (const path of this.excludePaths) {\n if (req.path.startsWith(path)) return next()\n }\n\n // Skip requests for files (have an extension)\n if (req.path.includes('.')) return next()\n\n // Skip non-GET requests\n if (req.method !== 'GET') return next()\n\n // Serve index.html\n res.setHeader('Content-Type', 'text/html')\n res.setHeader('Cache-Control', this.indexCacheControl)\n res.send(this.indexHtml)\n })\n }\n}\n"],"mappings":";;;;;;;;;;oNAIA,MAAM,IAAM,OAAO,IAAI,aAAa,CAqFpC,IAAa,WAAb,KAA8C,CAC5C,KAAO,aACP,UACA,YACA,aACA,aACA,kBACA,UAAmC,KAEnC,YAAY,QAAqC,EAAE,CAAE,CAAjC,KAAA,QAAA,QAClB,KAAK,UAAY,QAAQ,QAAQ,WAAa,cAAc,CAC5D,KAAK,aAAe,QAAQ,SAAW,EAAE,CACzC,KAAK,aAAe,QAAQ,cAAgB,sCAC5C,KAAK,kBAAoB,QAAQ,mBAAqB,WAEtD,IAAM,OAAS,QAAQ,WAAa,OACpC,KAAK,YAAc,MAAM,QAAQ,OAAO,CAAG,OAAS,CAAC,OAAO,CAG9D,YAAY,CAAE,KAA6B,CACzC,GAAI,CAAC,WAAW,KAAK,UAAU,CAAE,CAC/B,IAAI,KAAK,mCAAmC,KAAK,YAAY,CAC7D,IAAI,KAAK,mEAAmE,CAC5E,OAIF,IAAM,UAAY,KAAK,KAAK,UAAW,aAAa,CACpD,GAAI,WAAW,UAAU,CACvB,KAAK,UAAY,aAAa,UAAW,QAAQ,KAC5C,CACL,IAAI,KAAK,2BAA2B,KAAK,YAAY,CACrD,OAIF,GAAI,CAEF,IAAM,QAAA,UAAkB,UAAU,CAC5B,WAAkB,EAAE,CAEtB,KAAK,eACP,WAAW,YAAc,IAAU,WAAqB,CAClD,SAAS,SAAS,QAAQ,CAC5B,IAAI,UAAU,gBAAiB,KAAK,kBAAkB,CAEtD,IAAI,UAAU,gBAAiB,KAAK,aAAuB,GAKjE,IAAI,IAAI,QAAQ,OAAO,KAAK,UAAW,WAAW,CAAC,MAC7C,CACN,IAAI,MAAM,kEAAkE,CAC5E,OAGF,IAAI,MAAM,oBAAoB,KAAK,YAAY,CAGjD,YAAY,CAAE,KAA6B,CACpC,KAAK,WAGV,IAAI,KAAK,IAAU,IAAU,OAAc,CAEzC,IAAK,IAAM,UAAU,KAAK,YACxB,GAAI,IAAI,KAAK,WAAW,OAAO,CAAE,OAAO,MAAM,CAIhD,IAAK,IAAM,QAAQ,KAAK,aACtB,GAAI,IAAI,KAAK,WAAW,KAAK,CAAE,OAAO,MAAM,CAO9C,GAHI,IAAI,KAAK,SAAS,IAAI,EAGtB,IAAI,SAAW,MAAO,OAAO,MAAM,CAGvC,IAAI,UAAU,eAAgB,YAAY,CAC1C,IAAI,UAAU,gBAAiB,KAAK,kBAAkB,CACtD,IAAI,KAAK,KAAK,UAAU,EACxB"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as upload, i as resolveMimeTypes, n as buildUploadMiddleware, r as cleanupFiles, t as UploadOptions } from "../../upload-BM9uyR6Y.mjs";
2
+ import { a as upload, i as resolveMimeTypes, n as buildUploadMiddleware, r as cleanupFiles, t as UploadOptions } from "../../upload-tGMrlhEB.mjs";
3
3
  export { UploadOptions, buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v5.2.0
2
+ * @forinda/kickjs v5.4.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,184 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { unlink } from "node:fs/promises";
12
- import multer from "multer";
13
- //#region src/http/middleware/upload.ts
14
- /**
15
- * Maps short file extensions to their MIME types.
16
- * Users can pass `['jpg', 'png', 'pdf']` instead of full MIME strings.
17
- */
18
- const MIME_MAP = {
19
- jpg: "image/jpeg",
20
- jpeg: "image/jpeg",
21
- png: "image/png",
22
- gif: "image/gif",
23
- webp: "image/webp",
24
- svg: "image/svg+xml",
25
- bmp: "image/bmp",
26
- ico: "image/x-icon",
27
- tiff: "image/tiff",
28
- tif: "image/tiff",
29
- avif: "image/avif",
30
- pdf: "application/pdf",
31
- doc: "application/msword",
32
- docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
33
- xls: "application/vnd.ms-excel",
34
- xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
35
- ppt: "application/vnd.ms-powerpoint",
36
- pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
37
- odt: "application/vnd.oasis.opendocument.text",
38
- ods: "application/vnd.oasis.opendocument.spreadsheet",
39
- odp: "application/vnd.oasis.opendocument.presentation",
40
- rtf: "application/rtf",
41
- txt: "text/plain",
42
- csv: "text/csv",
43
- zip: "application/zip",
44
- gz: "application/gzip",
45
- tar: "application/x-tar",
46
- rar: "application/vnd.rar",
47
- "7z": "application/x-7z-compressed",
48
- mp3: "audio/mpeg",
49
- wav: "audio/wav",
50
- ogg: "audio/ogg",
51
- flac: "audio/flac",
52
- aac: "audio/aac",
53
- mp4: "video/mp4",
54
- webm: "video/webm",
55
- avi: "video/x-msvideo",
56
- mov: "video/quicktime",
57
- mkv: "video/x-matroska",
58
- json: "application/json",
59
- xml: "application/xml",
60
- html: "text/html"
61
- };
62
- /**
63
- * Resolves a list of file type identifiers to MIME type strings.
64
- * Accepts short extensions (`'jpg'`, `'pdf'`) or full MIME types (`'image/jpeg'`).
65
- *
66
- * @example
67
- * ```ts
68
- * resolveMimeTypes(['jpg', 'png', 'application/pdf'])
69
- * // → ['image/jpeg', 'image/png', 'application/pdf']
70
- * ```
71
- */
72
- function resolveMimeTypes(types) {
73
- return types.map((t) => {
74
- return MIME_MAP[t.toLowerCase().replace(/^\./, "")] ?? t;
75
- });
76
- }
77
- function createMulter(options) {
78
- const mimeMap = options.customMimeMap ? {
79
- ...MIME_MAP,
80
- ...options.customMimeMap
81
- } : MIME_MAP;
82
- const limits = { fileSize: options.maxSize ?? 5 * 1024 * 1024 };
83
- let fileFilter;
84
- if (typeof options.allowedTypes === "function") {
85
- const filterFn = options.allowedTypes;
86
- fileFilter = (_req, file, cb) => {
87
- if (filterFn(file.mimetype, file.originalname)) cb(null, true);
88
- else cb(/* @__PURE__ */ new Error(`File type ${file.mimetype} is not allowed`));
89
- };
90
- } else if (Array.isArray(options.allowedTypes)) {
91
- const resolvedTypes = options.allowedTypes.map((t) => {
92
- return mimeMap[t.toLowerCase().replace(/^\./, "")] ?? t;
93
- });
94
- fileFilter = (_req, file, cb) => {
95
- if (resolvedTypes.some((type) => {
96
- if (type.endsWith("/*")) return file.mimetype.startsWith(type.replace("/*", "/"));
97
- return file.mimetype === type;
98
- })) cb(null, true);
99
- else cb(/* @__PURE__ */ new Error(`File type ${file.mimetype} is not allowed`));
100
- };
101
- }
102
- return multer({
103
- limits,
104
- ...fileFilter ? { fileFilter } : {},
105
- ...options.storage ? { storage: options.storage } : {},
106
- ...options.dest ? { dest: options.dest } : {}
107
- });
108
- }
109
- /**
110
- * Single file upload middleware. Attaches the file to `req.file`.
111
- *
112
- * @example
113
- * ```ts
114
- * @Post('/avatar')
115
- * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['jpg', 'png'] }))
116
- * async uploadAvatar(ctx: RequestContext) {
117
- * ctx.json({ filename: ctx.file.originalname })
118
- * }
119
- * ```
120
- */
121
- function single(fieldName, options = {}) {
122
- return createMulter(options).single(fieldName);
123
- }
124
- /**
125
- * Multiple file upload middleware. Attaches files to `req.files`.
126
- */
127
- function array(fieldName, maxCount = 10, options = {}) {
128
- return createMulter(options).array(fieldName, maxCount);
129
- }
130
- /**
131
- * No file upload — just parse multipart form data without file fields.
132
- */
133
- function none(options = {}) {
134
- return createMulter(options).none();
135
- }
136
- /**
137
- * Removes temporary files from disk after the response is sent.
138
- * Attach this as Express middleware after the upload middleware.
139
- * Works with both `req.file` (single) and `req.files` (array).
140
- *
141
- * @example
142
- * ```ts
143
- * @Post('/process')
144
- * @Middleware(upload.single('document', { dest: '/tmp/uploads' }), cleanupFiles())
145
- * async processDocument(ctx: RequestContext) {
146
- * ctx.json({ ok: true })
147
- * }
148
- * ```
149
- */
150
- function cleanupFiles() {
151
- return (req, res, next) => {
152
- res.on("finish", async () => {
153
- const files = [];
154
- if (req.file?.path) files.push(req.file);
155
- if (Array.isArray(req.files)) {
156
- for (const f of req.files) if (f?.path) files.push(f);
157
- }
158
- for (const file of files) try {
159
- await unlink(file.path);
160
- } catch {}
161
- });
162
- next();
163
- };
164
- }
165
- /**
166
- * Build upload middleware from a @FileUpload decorator config.
167
- * Used internally by the router builder when it detects FILE_UPLOAD metadata.
168
- * Accepts the same FileUploadConfig interface used by the @FileUpload decorator.
169
- */
170
- function buildUploadMiddleware(config) {
171
- const options = {};
172
- if (config.maxSize) options.maxSize = config.maxSize;
173
- if (config.allowedTypes) options.allowedTypes = config.allowedTypes;
174
- if (config.customMimeMap) options.customMimeMap = config.customMimeMap;
175
- const fieldName = config.fieldName ?? "file";
176
- switch (config.mode) {
177
- case "single": return single(fieldName, options);
178
- case "array": return array(fieldName, config.maxCount ?? 10, options);
179
- case "none": return none(options);
180
- }
181
- }
182
- /** Upload middleware factory with `.single()`, `.array()`, `.none()` methods */
183
- const upload = {
184
- single,
185
- array,
186
- none
187
- };
188
- //#endregion
189
- export { buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload };
190
-
11
+ import{unlink}from"node:fs/promises";import multer from"multer";const MIME_MAP={jpg:`image/jpeg`,jpeg:`image/jpeg`,png:`image/png`,gif:`image/gif`,webp:`image/webp`,svg:`image/svg+xml`,bmp:`image/bmp`,ico:`image/x-icon`,tiff:`image/tiff`,tif:`image/tiff`,avif:`image/avif`,pdf:`application/pdf`,doc:`application/msword`,docx:`application/vnd.openxmlformats-officedocument.wordprocessingml.document`,xls:`application/vnd.ms-excel`,xlsx:`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,ppt:`application/vnd.ms-powerpoint`,pptx:`application/vnd.openxmlformats-officedocument.presentationml.presentation`,odt:`application/vnd.oasis.opendocument.text`,ods:`application/vnd.oasis.opendocument.spreadsheet`,odp:`application/vnd.oasis.opendocument.presentation`,rtf:`application/rtf`,txt:`text/plain`,csv:`text/csv`,zip:`application/zip`,gz:`application/gzip`,tar:`application/x-tar`,rar:`application/vnd.rar`,"7z":`application/x-7z-compressed`,mp3:`audio/mpeg`,wav:`audio/wav`,ogg:`audio/ogg`,flac:`audio/flac`,aac:`audio/aac`,mp4:`video/mp4`,webm:`video/webm`,avi:`video/x-msvideo`,mov:`video/quicktime`,mkv:`video/x-matroska`,json:`application/json`,xml:`application/xml`,html:`text/html`};function resolveMimeTypes(types){return types.map(t=>MIME_MAP[t.toLowerCase().replace(/^\./,``)]??t)}function createMulter(options){let mimeMap=options.customMimeMap?{...MIME_MAP,...options.customMimeMap}:MIME_MAP,limits={fileSize:options.maxSize??5*1024*1024},fileFilter;if(typeof options.allowedTypes==`function`){let filterFn=options.allowedTypes;fileFilter=(_req,file,cb)=>{filterFn(file.mimetype,file.originalname)?cb(null,!0):cb(Error(`File type ${file.mimetype} is not allowed`))}}else if(Array.isArray(options.allowedTypes)){let resolvedTypes=options.allowedTypes.map(t=>mimeMap[t.toLowerCase().replace(/^\./,``)]??t);fileFilter=(_req,file,cb)=>{resolvedTypes.some(type=>type.endsWith(`/*`)?file.mimetype.startsWith(type.replace(`/*`,`/`)):file.mimetype===type)?cb(null,!0):cb(Error(`File type ${file.mimetype} is not allowed`))}}return multer({limits,...fileFilter?{fileFilter}:{},...options.storage?{storage:options.storage}:{},...options.dest?{dest:options.dest}:{}})}function single(fieldName,options={}){return createMulter(options).single(fieldName)}function array(fieldName,maxCount=10,options={}){return createMulter(options).array(fieldName,maxCount)}function none(options={}){return createMulter(options).none()}function cleanupFiles(){return(req,res,next)=>{res.on(`finish`,async()=>{let files=[];if(req.file?.path&&files.push(req.file),Array.isArray(req.files))for(let f of req.files)f?.path&&files.push(f);for(let file of files)try{await unlink(file.path)}catch{}}),next()}}function buildUploadMiddleware(config){let options={};config.maxSize&&(options.maxSize=config.maxSize),config.allowedTypes&&(options.allowedTypes=config.allowedTypes),config.customMimeMap&&(options.customMimeMap=config.customMimeMap);let fieldName=config.fieldName??`file`;switch(config.mode){case`single`:return single(fieldName,options);case`array`:return array(fieldName,config.maxCount??10,options);case`none`:return none(options)}}const upload={single,array,none};export{buildUploadMiddleware,cleanupFiles,resolveMimeTypes,upload};
191
12
  //# sourceMappingURL=upload.mjs.map