h3 0.7.18 → 0.7.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +486 -4
- package/dist/index.d.ts +256 -29
- package/dist/index.mjs +427 -5
- package/package.json +4 -4
package/dist/index.cjs
CHANGED
|
@@ -2,9 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
Object.defineProperty(exports, '__esModule', { value: true });
|
|
4
4
|
|
|
5
|
-
require('
|
|
6
|
-
require('
|
|
7
|
-
require('cookie-es');
|
|
5
|
+
const ufo = require('ufo');
|
|
6
|
+
const destr = require('destr');
|
|
7
|
+
const cookieEs = require('cookie-es');
|
|
8
|
+
const radix3 = require('radix3');
|
|
9
|
+
|
|
10
|
+
function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e["default"] : e; }
|
|
11
|
+
|
|
12
|
+
const destr__default = /*#__PURE__*/_interopDefaultLegacy(destr);
|
|
8
13
|
|
|
9
14
|
class H3Error extends Error {
|
|
10
15
|
constructor() {
|
|
@@ -53,16 +58,247 @@ function createError(input) {
|
|
|
53
58
|
}
|
|
54
59
|
return err;
|
|
55
60
|
}
|
|
61
|
+
function sendError(event, error, debug) {
|
|
62
|
+
if (event.res.writableEnded) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
const h3Error = isError(error) ? error : createError(error);
|
|
66
|
+
const responseBody = {
|
|
67
|
+
statusCode: h3Error.statusCode,
|
|
68
|
+
statusMessage: h3Error.statusMessage,
|
|
69
|
+
stack: [],
|
|
70
|
+
data: h3Error.data
|
|
71
|
+
};
|
|
72
|
+
if (debug) {
|
|
73
|
+
responseBody.stack = (h3Error.stack || "").split("\n").map((l) => l.trim());
|
|
74
|
+
}
|
|
75
|
+
if (event.res.writableEnded) {
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
event.res.statusCode = h3Error.statusCode;
|
|
79
|
+
event.res.statusMessage = h3Error.statusMessage;
|
|
80
|
+
event.res.setHeader("Content-Type", MIMES.json);
|
|
81
|
+
event.res.end(JSON.stringify(responseBody, null, 2));
|
|
82
|
+
}
|
|
56
83
|
function isError(input) {
|
|
57
84
|
return input?.constructor?.__h3_error__ === true;
|
|
58
85
|
}
|
|
59
86
|
|
|
87
|
+
function getQuery(event) {
|
|
88
|
+
return ufo.getQuery(event.req.url || "");
|
|
89
|
+
}
|
|
90
|
+
const useQuery = getQuery;
|
|
91
|
+
function getRouterParams(event) {
|
|
92
|
+
return event.context.params || {};
|
|
93
|
+
}
|
|
94
|
+
function getRouterParam(event, name) {
|
|
95
|
+
const params = getRouterParams(event);
|
|
96
|
+
return params[name];
|
|
97
|
+
}
|
|
98
|
+
function getMethod(event, defaultMethod = "GET") {
|
|
99
|
+
return (event.req.method || defaultMethod).toUpperCase();
|
|
100
|
+
}
|
|
101
|
+
const useMethod = getMethod;
|
|
102
|
+
function isMethod(event, expected, allowHead) {
|
|
103
|
+
const method = getMethod(event);
|
|
104
|
+
if (allowHead && method === "HEAD") {
|
|
105
|
+
return true;
|
|
106
|
+
}
|
|
107
|
+
if (typeof expected === "string") {
|
|
108
|
+
if (method === expected) {
|
|
109
|
+
return true;
|
|
110
|
+
}
|
|
111
|
+
} else if (expected.includes(method)) {
|
|
112
|
+
return true;
|
|
113
|
+
}
|
|
114
|
+
return false;
|
|
115
|
+
}
|
|
116
|
+
function assertMethod(event, expected, allowHead) {
|
|
117
|
+
if (!isMethod(event, expected, allowHead)) {
|
|
118
|
+
throw createError({
|
|
119
|
+
statusCode: 405,
|
|
120
|
+
statusMessage: "HTTP method is not allowed."
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
function getRequestHeaders(event) {
|
|
125
|
+
return event.req.headers;
|
|
126
|
+
}
|
|
127
|
+
const getHeaders = getRequestHeaders;
|
|
128
|
+
function getRequestHeader(event, name) {
|
|
129
|
+
const headers = getRequestHeaders(event);
|
|
130
|
+
const value = headers[name.toLowerCase()];
|
|
131
|
+
return value;
|
|
132
|
+
}
|
|
133
|
+
const getHeader = getRequestHeader;
|
|
134
|
+
|
|
135
|
+
const RawBodySymbol = Symbol("h3RawBody");
|
|
136
|
+
const ParsedBodySymbol = Symbol("h3RawBody");
|
|
137
|
+
const PayloadMethods = ["PATCH", "POST", "PUT", "DELETE"];
|
|
138
|
+
function readRawBody(event, encoding = "utf-8") {
|
|
139
|
+
assertMethod(event, PayloadMethods);
|
|
140
|
+
if (RawBodySymbol in event.req) {
|
|
141
|
+
const promise2 = Promise.resolve(event.req[RawBodySymbol]);
|
|
142
|
+
return encoding ? promise2.then((buff) => buff.toString(encoding)) : promise2;
|
|
143
|
+
}
|
|
144
|
+
if ("body" in event.req) {
|
|
145
|
+
return Promise.resolve(event.req.body);
|
|
146
|
+
}
|
|
147
|
+
const promise = event.req[RawBodySymbol] = new Promise((resolve, reject) => {
|
|
148
|
+
const bodyData = [];
|
|
149
|
+
event.req.on("error", (err) => {
|
|
150
|
+
reject(err);
|
|
151
|
+
}).on("data", (chunk) => {
|
|
152
|
+
bodyData.push(chunk);
|
|
153
|
+
}).on("end", () => {
|
|
154
|
+
resolve(Buffer.concat(bodyData));
|
|
155
|
+
});
|
|
156
|
+
});
|
|
157
|
+
return encoding ? promise.then((buff) => buff.toString(encoding)) : promise;
|
|
158
|
+
}
|
|
159
|
+
const useRawBody = readRawBody;
|
|
160
|
+
async function readBody(event) {
|
|
161
|
+
if (ParsedBodySymbol in event.req) {
|
|
162
|
+
return event.req[ParsedBodySymbol];
|
|
163
|
+
}
|
|
164
|
+
const body = await readRawBody(event);
|
|
165
|
+
if (event.req.headers["content-type"] === "application/x-www-form-urlencoded") {
|
|
166
|
+
const parsedForm = Object.fromEntries(new URLSearchParams(body));
|
|
167
|
+
return parsedForm;
|
|
168
|
+
}
|
|
169
|
+
const json = destr__default(body);
|
|
170
|
+
event.req[ParsedBodySymbol] = json;
|
|
171
|
+
return json;
|
|
172
|
+
}
|
|
173
|
+
const useBody = readBody;
|
|
174
|
+
|
|
175
|
+
function handleCacheHeaders(event, opts) {
|
|
176
|
+
const cacheControls = ["public"].concat(opts.cacheControls || []);
|
|
177
|
+
let cacheMatched = false;
|
|
178
|
+
if (opts.maxAge !== void 0) {
|
|
179
|
+
cacheControls.push(`max-age=${+opts.maxAge}`, `s-maxage=${+opts.maxAge}`);
|
|
180
|
+
}
|
|
181
|
+
if (opts.modifiedTime) {
|
|
182
|
+
const modifiedTime = new Date(opts.modifiedTime);
|
|
183
|
+
const ifModifiedSince = event.req.headers["if-modified-since"];
|
|
184
|
+
event.res.setHeader("Last-Modified", modifiedTime.toUTCString());
|
|
185
|
+
if (ifModifiedSince) {
|
|
186
|
+
if (new Date(ifModifiedSince) >= opts.modifiedTime) {
|
|
187
|
+
cacheMatched = true;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
if (opts.etag) {
|
|
192
|
+
event.res.setHeader("Etag", opts.etag);
|
|
193
|
+
const ifNonMatch = event.req.headers["if-none-match"];
|
|
194
|
+
if (ifNonMatch === opts.etag) {
|
|
195
|
+
cacheMatched = true;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
event.res.setHeader("Cache-Control", cacheControls.join(", "));
|
|
199
|
+
if (cacheMatched) {
|
|
200
|
+
event.res.statusCode = 304;
|
|
201
|
+
event.res.end("");
|
|
202
|
+
return true;
|
|
203
|
+
}
|
|
204
|
+
return false;
|
|
205
|
+
}
|
|
206
|
+
|
|
60
207
|
const MIMES = {
|
|
61
208
|
html: "text/html",
|
|
62
209
|
json: "application/json"
|
|
63
210
|
};
|
|
64
211
|
|
|
65
|
-
typeof setImmediate !== "undefined" ? setImmediate : (fn) => fn();
|
|
212
|
+
const defer = typeof setImmediate !== "undefined" ? setImmediate : (fn) => fn();
|
|
213
|
+
function send(event, data, type) {
|
|
214
|
+
if (type) {
|
|
215
|
+
defaultContentType(event, type);
|
|
216
|
+
}
|
|
217
|
+
return new Promise((resolve) => {
|
|
218
|
+
defer(() => {
|
|
219
|
+
event.res.end(data);
|
|
220
|
+
resolve(void 0);
|
|
221
|
+
});
|
|
222
|
+
});
|
|
223
|
+
}
|
|
224
|
+
function defaultContentType(event, type) {
|
|
225
|
+
if (type && !event.res.getHeader("Content-Type")) {
|
|
226
|
+
event.res.setHeader("Content-Type", type);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
function sendRedirect(event, location, code = 302) {
|
|
230
|
+
const encodedLoc = encodeURI(decodeURI(location));
|
|
231
|
+
event.res.statusCode = code;
|
|
232
|
+
event.res.setHeader("Location", encodedLoc);
|
|
233
|
+
const html = `<!DOCTYPE html>
|
|
234
|
+
<html>
|
|
235
|
+
<head><meta http-equiv="refresh" content="0; url=${encodedLoc}"></head>
|
|
236
|
+
<body>Redirecting to <a href=${JSON.stringify(encodedLoc)}>${encodedLoc}</a></body>
|
|
237
|
+
</html>`;
|
|
238
|
+
return send(event, html, MIMES.html);
|
|
239
|
+
}
|
|
240
|
+
function getResponseHeaders(event) {
|
|
241
|
+
return event.res.getHeaders();
|
|
242
|
+
}
|
|
243
|
+
function getResponseHeader(event, name) {
|
|
244
|
+
return event.res.getHeader(name);
|
|
245
|
+
}
|
|
246
|
+
function setResponseHeaders(event, headers) {
|
|
247
|
+
Object.entries(headers).forEach(([name, value]) => event.res.setHeader(name, value));
|
|
248
|
+
}
|
|
249
|
+
const setHeaders = setResponseHeaders;
|
|
250
|
+
function setResponseHeader(event, name, value) {
|
|
251
|
+
event.res.setHeader(name, value);
|
|
252
|
+
}
|
|
253
|
+
const setHeader = setResponseHeader;
|
|
254
|
+
function appendResponseHeaders(event, headers) {
|
|
255
|
+
Object.entries(headers).forEach(([name, value]) => appendResponseHeader(event, name, value));
|
|
256
|
+
}
|
|
257
|
+
const appendHeaders = appendResponseHeaders;
|
|
258
|
+
function appendResponseHeader(event, name, value) {
|
|
259
|
+
let current = event.res.getHeader(name);
|
|
260
|
+
if (!current) {
|
|
261
|
+
event.res.setHeader(name, value);
|
|
262
|
+
return;
|
|
263
|
+
}
|
|
264
|
+
if (!Array.isArray(current)) {
|
|
265
|
+
current = [current.toString()];
|
|
266
|
+
}
|
|
267
|
+
event.res.setHeader(name, current.concat(value));
|
|
268
|
+
}
|
|
269
|
+
const appendHeader = appendResponseHeader;
|
|
270
|
+
function isStream(data) {
|
|
271
|
+
return data && typeof data === "object" && typeof data.pipe === "function" && typeof data.on === "function";
|
|
272
|
+
}
|
|
273
|
+
function sendStream(event, data) {
|
|
274
|
+
return new Promise((resolve, reject) => {
|
|
275
|
+
data.pipe(event.res);
|
|
276
|
+
data.on("end", () => resolve(void 0));
|
|
277
|
+
data.on("error", (error) => reject(createError(error)));
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
function parseCookies(event) {
|
|
282
|
+
return cookieEs.parse(event.req.headers.cookie || "");
|
|
283
|
+
}
|
|
284
|
+
const useCookies = parseCookies;
|
|
285
|
+
function getCookie(event, name) {
|
|
286
|
+
return parseCookies(event)[name];
|
|
287
|
+
}
|
|
288
|
+
const useCookie = getCookie;
|
|
289
|
+
function setCookie(event, name, value, serializeOptions) {
|
|
290
|
+
const cookieStr = cookieEs.serialize(name, value, {
|
|
291
|
+
path: "/",
|
|
292
|
+
...serializeOptions
|
|
293
|
+
});
|
|
294
|
+
appendHeader(event, "Set-Cookie", cookieStr);
|
|
295
|
+
}
|
|
296
|
+
function deleteCookie(event, name, serializeOptions) {
|
|
297
|
+
setCookie(event, name, "", {
|
|
298
|
+
...serializeOptions,
|
|
299
|
+
maxAge: 0
|
|
300
|
+
});
|
|
301
|
+
}
|
|
66
302
|
|
|
67
303
|
class H3Headers {
|
|
68
304
|
constructor(init) {
|
|
@@ -189,6 +425,15 @@ function createEvent(req, res) {
|
|
|
189
425
|
return new H3Event(req, res);
|
|
190
426
|
}
|
|
191
427
|
|
|
428
|
+
const defineHandler = (handler) => handler;
|
|
429
|
+
const defineHandle = defineHandler;
|
|
430
|
+
const defineMiddleware = (middleware) => middleware;
|
|
431
|
+
function promisifyHandler(handler) {
|
|
432
|
+
return function(req, res) {
|
|
433
|
+
return callHandler(handler, req, res);
|
|
434
|
+
};
|
|
435
|
+
}
|
|
436
|
+
const promisifyHandle = promisifyHandler;
|
|
192
437
|
function callHandler(handler, req, res) {
|
|
193
438
|
const isMiddleware = handler.length > 2;
|
|
194
439
|
return new Promise((resolve, reject) => {
|
|
@@ -212,6 +457,30 @@ function callHandler(handler, req, res) {
|
|
|
212
457
|
}
|
|
213
458
|
});
|
|
214
459
|
}
|
|
460
|
+
function defineLazyHandler(handler, promisify) {
|
|
461
|
+
let _promise;
|
|
462
|
+
const resolve = () => {
|
|
463
|
+
if (!_promise) {
|
|
464
|
+
_promise = Promise.resolve(handler()).then((r) => promisify ? promisifyHandler(r.default || r) : r.default || r);
|
|
465
|
+
}
|
|
466
|
+
return _promise;
|
|
467
|
+
};
|
|
468
|
+
return function(req, res) {
|
|
469
|
+
return resolve().then((h) => h(req, res));
|
|
470
|
+
};
|
|
471
|
+
}
|
|
472
|
+
const lazyHandle = defineLazyHandler;
|
|
473
|
+
function useBase(base, handler) {
|
|
474
|
+
base = ufo.withoutTrailingSlash(base);
|
|
475
|
+
if (!base) {
|
|
476
|
+
return handler;
|
|
477
|
+
}
|
|
478
|
+
return function(req, res) {
|
|
479
|
+
req.originalUrl = req.originalUrl || req.url || "/";
|
|
480
|
+
req.url = ufo.withoutBase(req.url || "/", base);
|
|
481
|
+
return handler(req, res);
|
|
482
|
+
};
|
|
483
|
+
}
|
|
215
484
|
|
|
216
485
|
function defineEventHandler(handler) {
|
|
217
486
|
handler.__is_handler__ = true;
|
|
@@ -272,15 +541,228 @@ function defineLazyEventHandler(factory) {
|
|
|
272
541
|
}
|
|
273
542
|
const lazyEventHandler = defineLazyEventHandler;
|
|
274
543
|
|
|
544
|
+
function createApp(options = {}) {
|
|
545
|
+
const stack = [];
|
|
546
|
+
const handler = createAppEventHandler(stack, options);
|
|
547
|
+
const nodeHandler = async function(req, res) {
|
|
548
|
+
const event = createEvent(req, res);
|
|
549
|
+
try {
|
|
550
|
+
await handler(event);
|
|
551
|
+
} catch (_error) {
|
|
552
|
+
const error = createError(_error);
|
|
553
|
+
if (!isError(_error)) {
|
|
554
|
+
error.unhandled = true;
|
|
555
|
+
}
|
|
556
|
+
if (options.onError) {
|
|
557
|
+
await options.onError(error, event);
|
|
558
|
+
} else {
|
|
559
|
+
if (error.unhandled || error.fatal) {
|
|
560
|
+
console.error("[h3]", error.fatal ? "[fatal]" : "[unhandled]", error);
|
|
561
|
+
}
|
|
562
|
+
await sendError(event, error, !!options.debug);
|
|
563
|
+
}
|
|
564
|
+
}
|
|
565
|
+
};
|
|
566
|
+
const app = nodeHandler;
|
|
567
|
+
app.nodeHandler = nodeHandler;
|
|
568
|
+
app.stack = stack;
|
|
569
|
+
app.handler = handler;
|
|
570
|
+
app.use = (arg1, arg2, arg3) => use(app, arg1, arg2, arg3);
|
|
571
|
+
return app;
|
|
572
|
+
}
|
|
573
|
+
function use(app, arg1, arg2, arg3) {
|
|
574
|
+
if (Array.isArray(arg1)) {
|
|
575
|
+
arg1.forEach((i) => use(app, i, arg2, arg3));
|
|
576
|
+
} else if (Array.isArray(arg2)) {
|
|
577
|
+
arg2.forEach((i) => use(app, arg1, i, arg3));
|
|
578
|
+
} else if (typeof arg1 === "string") {
|
|
579
|
+
app.stack.push(normalizeLayer({ ...arg3, route: arg1, handler: arg2 }));
|
|
580
|
+
} else if (typeof arg1 === "function") {
|
|
581
|
+
app.stack.push(normalizeLayer({ ...arg2, route: "/", handler: arg1 }));
|
|
582
|
+
} else {
|
|
583
|
+
app.stack.push(normalizeLayer({ ...arg1 }));
|
|
584
|
+
}
|
|
585
|
+
return app;
|
|
586
|
+
}
|
|
587
|
+
function createAppEventHandler(stack, options) {
|
|
588
|
+
const spacing = options.debug ? 2 : void 0;
|
|
589
|
+
return eventHandler(async (event) => {
|
|
590
|
+
event.req.originalUrl = event.req.originalUrl || event.req.url || "/";
|
|
591
|
+
const reqUrl = event.req.url || "/";
|
|
592
|
+
for (const layer of stack) {
|
|
593
|
+
if (layer.route.length > 1) {
|
|
594
|
+
if (!reqUrl.startsWith(layer.route)) {
|
|
595
|
+
continue;
|
|
596
|
+
}
|
|
597
|
+
event.req.url = reqUrl.slice(layer.route.length) || "/";
|
|
598
|
+
} else {
|
|
599
|
+
event.req.url = reqUrl;
|
|
600
|
+
}
|
|
601
|
+
if (layer.match && !layer.match(event.req.url, event)) {
|
|
602
|
+
continue;
|
|
603
|
+
}
|
|
604
|
+
const val = await layer.handler(event);
|
|
605
|
+
if (event.res.writableEnded) {
|
|
606
|
+
return;
|
|
607
|
+
}
|
|
608
|
+
const type = typeof val;
|
|
609
|
+
if (type === "string") {
|
|
610
|
+
return send(event, val, MIMES.html);
|
|
611
|
+
} else if (isStream(val)) {
|
|
612
|
+
return sendStream(event, val);
|
|
613
|
+
} else if (val === null) {
|
|
614
|
+
event.res.statusCode = 204;
|
|
615
|
+
return send(event);
|
|
616
|
+
} else if (type === "object" || type === "boolean" || type === "number") {
|
|
617
|
+
if (val.buffer) {
|
|
618
|
+
return send(event, val);
|
|
619
|
+
} else if (val instanceof Error) {
|
|
620
|
+
throw createError(val);
|
|
621
|
+
} else {
|
|
622
|
+
return send(event, JSON.stringify(val, null, spacing), MIMES.json);
|
|
623
|
+
}
|
|
624
|
+
}
|
|
625
|
+
}
|
|
626
|
+
if (!event.res.writableEnded) {
|
|
627
|
+
throw createError({ statusCode: 404, statusMessage: "Not Found" });
|
|
628
|
+
}
|
|
629
|
+
});
|
|
630
|
+
}
|
|
631
|
+
function normalizeLayer(input) {
|
|
632
|
+
let handler = input.handler || input.handle;
|
|
633
|
+
if (handler.handler) {
|
|
634
|
+
handler = handler.handler;
|
|
635
|
+
}
|
|
636
|
+
if (input.lazy) {
|
|
637
|
+
handler = lazyEventHandler(handler);
|
|
638
|
+
} else if (!isEventHandler(handler)) {
|
|
639
|
+
handler = toEventHandler(handler);
|
|
640
|
+
}
|
|
641
|
+
return {
|
|
642
|
+
route: ufo.withoutTrailingSlash(input.route),
|
|
643
|
+
match: input.match,
|
|
644
|
+
handler
|
|
645
|
+
};
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
const RouterMethods = ["connect", "delete", "get", "head", "options", "post", "put", "trace", "patch"];
|
|
649
|
+
function createRouter() {
|
|
650
|
+
const _router = radix3.createRouter({});
|
|
651
|
+
const routes = {};
|
|
652
|
+
const router = {};
|
|
653
|
+
const addRoute = (path, handler, method) => {
|
|
654
|
+
let route = routes[path];
|
|
655
|
+
if (!route) {
|
|
656
|
+
routes[path] = route = { handlers: {} };
|
|
657
|
+
_router.insert(path, route);
|
|
658
|
+
}
|
|
659
|
+
if (Array.isArray(method)) {
|
|
660
|
+
method.forEach((m) => addRoute(path, handler, m));
|
|
661
|
+
} else {
|
|
662
|
+
route.handlers[method] = toEventHandler(handler);
|
|
663
|
+
}
|
|
664
|
+
return router;
|
|
665
|
+
};
|
|
666
|
+
router.use = router.add = (path, handler, method) => addRoute(path, handler, method || "all");
|
|
667
|
+
for (const method of RouterMethods) {
|
|
668
|
+
router[method] = (path, handle) => router.add(path, handle, method);
|
|
669
|
+
}
|
|
670
|
+
router.handler = eventHandler((event) => {
|
|
671
|
+
let path = event.req.url || "/";
|
|
672
|
+
const queryUrlIndex = path.lastIndexOf("?");
|
|
673
|
+
if (queryUrlIndex > -1) {
|
|
674
|
+
path = path.substring(0, queryUrlIndex);
|
|
675
|
+
}
|
|
676
|
+
const matched = _router.lookup(path);
|
|
677
|
+
if (!matched) {
|
|
678
|
+
throw createError({
|
|
679
|
+
statusCode: 404,
|
|
680
|
+
name: "Not Found",
|
|
681
|
+
statusMessage: `Cannot find any route matching ${event.req.url || "/"}.`
|
|
682
|
+
});
|
|
683
|
+
}
|
|
684
|
+
const method = (event.req.method || "get").toLowerCase();
|
|
685
|
+
const handler = matched.handlers[method] || matched.handlers.all;
|
|
686
|
+
if (!handler) {
|
|
687
|
+
throw createError({
|
|
688
|
+
statusCode: 405,
|
|
689
|
+
name: "Method Not Allowed",
|
|
690
|
+
statusMessage: `Method ${method} is not allowed on this route.`
|
|
691
|
+
});
|
|
692
|
+
}
|
|
693
|
+
const params = matched.params || {};
|
|
694
|
+
event.event.context.params = params;
|
|
695
|
+
event.req.context.params = params;
|
|
696
|
+
return handler(event);
|
|
697
|
+
});
|
|
698
|
+
return router;
|
|
699
|
+
}
|
|
700
|
+
|
|
701
|
+
exports.H3Error = H3Error;
|
|
275
702
|
exports.H3Event = H3Event;
|
|
276
703
|
exports.H3Headers = H3Headers;
|
|
277
704
|
exports.H3Response = H3Response;
|
|
705
|
+
exports.MIMES = MIMES;
|
|
706
|
+
exports.appendHeader = appendHeader;
|
|
707
|
+
exports.appendHeaders = appendHeaders;
|
|
708
|
+
exports.appendResponseHeader = appendResponseHeader;
|
|
709
|
+
exports.appendResponseHeaders = appendResponseHeaders;
|
|
710
|
+
exports.assertMethod = assertMethod;
|
|
711
|
+
exports.callHandler = callHandler;
|
|
712
|
+
exports.createApp = createApp;
|
|
713
|
+
exports.createAppEventHandler = createAppEventHandler;
|
|
714
|
+
exports.createError = createError;
|
|
278
715
|
exports.createEvent = createEvent;
|
|
716
|
+
exports.createRouter = createRouter;
|
|
717
|
+
exports.defaultContentType = defaultContentType;
|
|
279
718
|
exports.defineEventHandler = defineEventHandler;
|
|
719
|
+
exports.defineHandle = defineHandle;
|
|
720
|
+
exports.defineHandler = defineHandler;
|
|
280
721
|
exports.defineLazyEventHandler = defineLazyEventHandler;
|
|
722
|
+
exports.defineLazyHandler = defineLazyHandler;
|
|
723
|
+
exports.defineMiddleware = defineMiddleware;
|
|
724
|
+
exports.deleteCookie = deleteCookie;
|
|
281
725
|
exports.dynamicEventHandler = dynamicEventHandler;
|
|
282
726
|
exports.eventHandler = eventHandler;
|
|
727
|
+
exports.getCookie = getCookie;
|
|
728
|
+
exports.getHeader = getHeader;
|
|
729
|
+
exports.getHeaders = getHeaders;
|
|
730
|
+
exports.getMethod = getMethod;
|
|
731
|
+
exports.getQuery = getQuery;
|
|
732
|
+
exports.getRequestHeader = getRequestHeader;
|
|
733
|
+
exports.getRequestHeaders = getRequestHeaders;
|
|
734
|
+
exports.getResponseHeader = getResponseHeader;
|
|
735
|
+
exports.getResponseHeaders = getResponseHeaders;
|
|
736
|
+
exports.getRouterParam = getRouterParam;
|
|
737
|
+
exports.getRouterParams = getRouterParams;
|
|
738
|
+
exports.handleCacheHeaders = handleCacheHeaders;
|
|
739
|
+
exports.isError = isError;
|
|
283
740
|
exports.isEvent = isEvent;
|
|
284
741
|
exports.isEventHandler = isEventHandler;
|
|
742
|
+
exports.isMethod = isMethod;
|
|
743
|
+
exports.isStream = isStream;
|
|
285
744
|
exports.lazyEventHandler = lazyEventHandler;
|
|
745
|
+
exports.lazyHandle = lazyHandle;
|
|
746
|
+
exports.parseCookies = parseCookies;
|
|
747
|
+
exports.promisifyHandle = promisifyHandle;
|
|
748
|
+
exports.promisifyHandler = promisifyHandler;
|
|
749
|
+
exports.readBody = readBody;
|
|
750
|
+
exports.readRawBody = readRawBody;
|
|
751
|
+
exports.send = send;
|
|
752
|
+
exports.sendError = sendError;
|
|
753
|
+
exports.sendRedirect = sendRedirect;
|
|
754
|
+
exports.sendStream = sendStream;
|
|
755
|
+
exports.setCookie = setCookie;
|
|
756
|
+
exports.setHeader = setHeader;
|
|
757
|
+
exports.setHeaders = setHeaders;
|
|
758
|
+
exports.setResponseHeader = setResponseHeader;
|
|
759
|
+
exports.setResponseHeaders = setResponseHeaders;
|
|
286
760
|
exports.toEventHandler = toEventHandler;
|
|
761
|
+
exports.use = use;
|
|
762
|
+
exports.useBase = useBase;
|
|
763
|
+
exports.useBody = useBody;
|
|
764
|
+
exports.useCookie = useCookie;
|
|
765
|
+
exports.useCookies = useCookies;
|
|
766
|
+
exports.useMethod = useMethod;
|
|
767
|
+
exports.useQuery = useQuery;
|
|
768
|
+
exports.useRawBody = useRawBody;
|
package/dist/index.d.ts
CHANGED
|
@@ -1,31 +1,6 @@
|
|
|
1
|
-
import http from 'http';
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
event: H3Event;
|
|
5
|
-
context: H3EventContext;
|
|
6
|
-
/** Only available with connect and press */
|
|
7
|
-
originalUrl?: string;
|
|
8
|
-
}
|
|
9
|
-
interface IncomingMessage extends http.IncomingMessage, CompatibilityRequestProps {
|
|
10
|
-
req: H3Event['req'];
|
|
11
|
-
res: H3Event['res'];
|
|
12
|
-
}
|
|
13
|
-
interface ServerResponse extends http.ServerResponse {
|
|
14
|
-
event: H3Event;
|
|
15
|
-
res: H3Event['res'];
|
|
16
|
-
req: http.ServerResponse['req'] & CompatibilityRequestProps;
|
|
17
|
-
}
|
|
18
|
-
declare type Handler<T = any, ReqT = {}> = (req: IncomingMessage & ReqT, res: ServerResponse) => T;
|
|
19
|
-
declare type Middleware = (req: IncomingMessage, res: ServerResponse, next: (err?: Error) => any) => any;
|
|
20
|
-
interface H3EventContext extends Record<string, any> {
|
|
21
|
-
}
|
|
22
|
-
declare type HandlerResponse<T = any> = T | Promise<T>;
|
|
23
|
-
interface EventHandler<T = any> {
|
|
24
|
-
'__is_handler__'?: true;
|
|
25
|
-
(event: H3Event): HandlerResponse<T>;
|
|
26
|
-
}
|
|
27
|
-
declare type LazyEventHandler = () => EventHandler | Promise<EventHandler>;
|
|
28
|
-
declare type CompatibilityEventHandler = EventHandler | Handler | Middleware;
|
|
1
|
+
import http, { OutgoingMessage } from 'http';
|
|
2
|
+
import { CookieSerializeOptions } from 'cookie-es';
|
|
3
|
+
import * as ufo from 'ufo';
|
|
29
4
|
|
|
30
5
|
declare class H3Headers implements Headers {
|
|
31
6
|
_headers: Record<string, string>;
|
|
@@ -81,4 +56,256 @@ declare function dynamicEventHandler(initial?: EventHandler): DynamicEventHandle
|
|
|
81
56
|
declare function defineLazyEventHandler(factory: LazyEventHandler): EventHandler;
|
|
82
57
|
declare const lazyEventHandler: typeof defineLazyEventHandler;
|
|
83
58
|
|
|
84
|
-
|
|
59
|
+
interface CompatibilityRequestProps {
|
|
60
|
+
event: H3Event;
|
|
61
|
+
context: H3EventContext;
|
|
62
|
+
/** Only available with connect and press */
|
|
63
|
+
originalUrl?: string;
|
|
64
|
+
}
|
|
65
|
+
interface IncomingMessage extends http.IncomingMessage, CompatibilityRequestProps {
|
|
66
|
+
req: H3Event['req'];
|
|
67
|
+
res: H3Event['res'];
|
|
68
|
+
}
|
|
69
|
+
interface ServerResponse extends http.ServerResponse {
|
|
70
|
+
event: H3Event;
|
|
71
|
+
res: H3Event['res'];
|
|
72
|
+
req: http.ServerResponse['req'] & CompatibilityRequestProps;
|
|
73
|
+
}
|
|
74
|
+
declare type Handler<T = any, ReqT = {}> = (req: IncomingMessage & ReqT, res: ServerResponse) => T;
|
|
75
|
+
declare type PromisifiedHandler = Handler<Promise<any>>;
|
|
76
|
+
declare type Middleware = (req: IncomingMessage, res: ServerResponse, next: (err?: Error) => any) => any;
|
|
77
|
+
declare type LazyHandler = () => Handler | Promise<Handler>;
|
|
78
|
+
declare type Encoding = false | 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'latin1' | 'binary' | 'hex';
|
|
79
|
+
declare type HTTPMethod = 'GET' | 'HEAD' | 'PATCH' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE';
|
|
80
|
+
interface H3EventContext extends Record<string, any> {
|
|
81
|
+
}
|
|
82
|
+
declare type CompatibilityEvent = H3Event | IncomingMessage;
|
|
83
|
+
declare type HandlerResponse<T = any> = T | Promise<T>;
|
|
84
|
+
interface EventHandler<T = any> {
|
|
85
|
+
'__is_handler__'?: true;
|
|
86
|
+
(event: H3Event): HandlerResponse<T>;
|
|
87
|
+
}
|
|
88
|
+
declare type LazyEventHandler = () => EventHandler | Promise<EventHandler>;
|
|
89
|
+
declare type CompatibilityEventHandler = EventHandler | Handler | Middleware;
|
|
90
|
+
|
|
91
|
+
interface Layer {
|
|
92
|
+
route: string;
|
|
93
|
+
match?: Matcher;
|
|
94
|
+
handler: EventHandler;
|
|
95
|
+
}
|
|
96
|
+
declare type Stack = Layer[];
|
|
97
|
+
interface InputLayer {
|
|
98
|
+
route?: string;
|
|
99
|
+
match?: Matcher;
|
|
100
|
+
handler: Handler | LazyHandler | EventHandler | LazyEventHandler;
|
|
101
|
+
lazy?: boolean;
|
|
102
|
+
/** @deprecated */
|
|
103
|
+
handle?: Handler;
|
|
104
|
+
/** @deprecated */
|
|
105
|
+
promisify?: boolean;
|
|
106
|
+
}
|
|
107
|
+
declare type InputStack = InputLayer[];
|
|
108
|
+
declare type Matcher = (url: string, event?: CompatibilityEvent) => boolean;
|
|
109
|
+
interface AppUse {
|
|
110
|
+
(route: string | string[], handler: CompatibilityEventHandler | CompatibilityEventHandler[], options?: Partial<InputLayer>): App;
|
|
111
|
+
(handler: CompatibilityEventHandler | CompatibilityEventHandler[], options?: Partial<InputLayer>): App;
|
|
112
|
+
(options: InputLayer): App;
|
|
113
|
+
}
|
|
114
|
+
declare type NodeHandler = (req: http.IncomingMessage, res: http.ServerResponse) => Promise<void>;
|
|
115
|
+
interface App extends NodeHandler {
|
|
116
|
+
stack: Stack;
|
|
117
|
+
handler: EventHandler;
|
|
118
|
+
nodeHandler: NodeHandler;
|
|
119
|
+
use: AppUse;
|
|
120
|
+
}
|
|
121
|
+
interface AppOptions {
|
|
122
|
+
debug?: boolean;
|
|
123
|
+
onError?: (error: Error, event: CompatibilityEvent) => any;
|
|
124
|
+
}
|
|
125
|
+
declare function createApp(options?: AppOptions): App;
|
|
126
|
+
declare function use(app: App, arg1: string | Handler | InputLayer | InputLayer[], arg2?: Handler | Partial<InputLayer> | Handler[] | Middleware | Middleware[], arg3?: Partial<InputLayer>): App;
|
|
127
|
+
declare function createAppEventHandler(stack: Stack, options: AppOptions): EventHandler<void>;
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* H3 Runtime Error
|
|
131
|
+
* @class
|
|
132
|
+
* @extends Error
|
|
133
|
+
* @property {Number} statusCode An Integer indicating the HTTP response status code.
|
|
134
|
+
* @property {String} statusMessage A String representing the HTTP status message
|
|
135
|
+
* @property {String} fatal Indicates if the error is a fatal error.
|
|
136
|
+
* @property {String} unhandled Indicates if the error was unhandled and auto captured.
|
|
137
|
+
* @property {Any} data An extra data that will includes in the response.<br>
|
|
138
|
+
* This can be used to pass additional information about the error.
|
|
139
|
+
* @property {Boolean} internal Setting this property to <code>true</code> will mark error as an internal error
|
|
140
|
+
*/
|
|
141
|
+
declare class H3Error extends Error {
|
|
142
|
+
static __h3_error__: boolean;
|
|
143
|
+
statusCode: number;
|
|
144
|
+
fatal: boolean;
|
|
145
|
+
unhandled: boolean;
|
|
146
|
+
statusMessage: string;
|
|
147
|
+
data?: any;
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Creates new `Error` that can be used to handle both internal and runtime errors.
|
|
151
|
+
*
|
|
152
|
+
* @param input {Partial<H3Error>}
|
|
153
|
+
* @return {H3Error} An instance of the H3Error
|
|
154
|
+
*/
|
|
155
|
+
declare function createError(input: string | Partial<H3Error>): H3Error;
|
|
156
|
+
/**
|
|
157
|
+
* Receive an error and return the corresponding response.<br>
|
|
158
|
+
* H3 internally uses this function to handle unhandled errors.<br>
|
|
159
|
+
* Note that calling this function will close the connection and no other data will be sent to client afterwards.
|
|
160
|
+
*
|
|
161
|
+
@param event {CompatibilityEvent} H3 event or req passed by h3 handler
|
|
162
|
+
* @param error {H3Error|Error} Raised error
|
|
163
|
+
* @param debug {Boolean} Whether application is in debug mode.<br>
|
|
164
|
+
* In the debug mode the stack trace of errors will be return in response.
|
|
165
|
+
*/
|
|
166
|
+
declare function sendError(event: CompatibilityEvent, error: Error | H3Error, debug?: boolean): void;
|
|
167
|
+
declare function isError(input: any): input is H3Error;
|
|
168
|
+
|
|
169
|
+
declare const defineHandler: <T>(handler: Handler<T, {}>) => Handler<T, {}>;
|
|
170
|
+
/** @deprecated Use defineHandler */
|
|
171
|
+
declare const defineHandle: <T>(handler: Handler<T, {}>) => Handler<T, {}>;
|
|
172
|
+
declare const defineMiddleware: (middleware: Middleware) => Middleware;
|
|
173
|
+
declare function promisifyHandler(handler: Handler | Middleware): PromisifiedHandler;
|
|
174
|
+
/** @deprecated Use defineHandler */
|
|
175
|
+
declare const promisifyHandle: typeof promisifyHandler;
|
|
176
|
+
declare function callHandler(handler: Middleware, req: IncomingMessage, res: ServerResponse): Promise<unknown>;
|
|
177
|
+
declare function defineLazyHandler(handler: LazyHandler, promisify?: boolean): Handler;
|
|
178
|
+
/** @deprecated Use defineLazyHandler */
|
|
179
|
+
declare const lazyHandle: typeof defineLazyHandler;
|
|
180
|
+
declare function useBase(base: string, handler: Handler): Handler;
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Reads body of the request and returns encoded raw string (default) or `Buffer` if encoding if falsy.
|
|
184
|
+
* @param event {CompatibilityEvent} H3 event or req passed by h3 handler
|
|
185
|
+
* @param encoding {Encoding} encoding="utf-8" - The character encoding to use.
|
|
186
|
+
*
|
|
187
|
+
* @return {String|Buffer} Encoded raw string or raw Buffer of the body
|
|
188
|
+
*/
|
|
189
|
+
declare function readRawBody(event: CompatibilityEvent, encoding?: Encoding): Encoding extends false ? Buffer : Promise<string | Buffer>;
|
|
190
|
+
/** @deprecated Use `h3.readRawBody` */
|
|
191
|
+
declare const useRawBody: typeof readRawBody;
|
|
192
|
+
/**
|
|
193
|
+
* Reads request body and try to safely parse using [destr](https://github.com/unjs/destr)
|
|
194
|
+
* @param event {CompatibilityEvent} H3 event or req passed by h3 handler
|
|
195
|
+
* @param encoding {Encoding} encoding="utf-8" - The character encoding to use.
|
|
196
|
+
*
|
|
197
|
+
* @return {*} The `Object`, `Array`, `String`, `Number`, `Boolean`, or `null` value corresponding to the request JSON body
|
|
198
|
+
*
|
|
199
|
+
* ```ts
|
|
200
|
+
* const body = await useBody(req)
|
|
201
|
+
* ```
|
|
202
|
+
*/
|
|
203
|
+
declare function readBody<T = any>(event: CompatibilityEvent): Promise<T>;
|
|
204
|
+
/** @deprecated Use `h3.readBody` */
|
|
205
|
+
declare const useBody: typeof readBody;
|
|
206
|
+
|
|
207
|
+
interface CacheConditions {
|
|
208
|
+
modifiedTime?: string | Date;
|
|
209
|
+
maxAge?: number;
|
|
210
|
+
etag?: string;
|
|
211
|
+
cacheControls?: string[];
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
* Check request caching headers (`If-Modified-Since`) and add caching headers (Last-Modified, Cache-Control)
|
|
215
|
+
* Note: `public` cache control will be added by default
|
|
216
|
+
* @returns `true` when cache headers are matching. When `true` is returned, no reponse should be sent anymore
|
|
217
|
+
*/
|
|
218
|
+
declare function handleCacheHeaders(event: CompatibilityEvent, opts: CacheConditions): boolean;
|
|
219
|
+
|
|
220
|
+
declare const MIMES: {
|
|
221
|
+
html: string;
|
|
222
|
+
json: string;
|
|
223
|
+
};
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* Parse the request to get HTTP Cookie header string and returning an object of all cookie name-value pairs.
|
|
227
|
+
* @param event {CompatibilityEvent} H3 event or req passed by h3 handler
|
|
228
|
+
* @returns Object of cookie name-value pairs
|
|
229
|
+
* ```ts
|
|
230
|
+
* const cookies = parseCookies(event)
|
|
231
|
+
* ```
|
|
232
|
+
*/
|
|
233
|
+
declare function parseCookies(event: CompatibilityEvent): Record<string, string>;
|
|
234
|
+
/** @deprecated Use `h3.parseCookies` */
|
|
235
|
+
declare const useCookies: typeof parseCookies;
|
|
236
|
+
/**
|
|
237
|
+
* Get a cookie value by name.
|
|
238
|
+
* @param event {CompatibilityEvent} H3 event or req passed by h3 handler
|
|
239
|
+
* @param name Name of the cookie to get
|
|
240
|
+
* @returns {*} Value of the cookie (String or undefined)
|
|
241
|
+
* ```ts
|
|
242
|
+
* const authorization = useCookie(request, 'Authorization')
|
|
243
|
+
* ```
|
|
244
|
+
*/
|
|
245
|
+
declare function getCookie(event: CompatibilityEvent, name: string): string | undefined;
|
|
246
|
+
/** @deprecated Use `h3.getCookie` */
|
|
247
|
+
declare const useCookie: typeof getCookie;
|
|
248
|
+
/**
|
|
249
|
+
* Set a cookie value by name.
|
|
250
|
+
* @param event {CompatibilityEvent} H3 event or res passed by h3 handler
|
|
251
|
+
* @param name Name of the cookie to set
|
|
252
|
+
* @param value Value of the cookie to set
|
|
253
|
+
* @param serializeOptions {CookieSerializeOptions} Options for serializing the cookie
|
|
254
|
+
* ```ts
|
|
255
|
+
* setCookie(res, 'Authorization', '1234567')
|
|
256
|
+
* ```
|
|
257
|
+
*/
|
|
258
|
+
declare function setCookie(event: CompatibilityEvent, name: string, value: string, serializeOptions?: CookieSerializeOptions): void;
|
|
259
|
+
/**
|
|
260
|
+
* Set a cookie value by name.
|
|
261
|
+
* @param event {CompatibilityEvent} H3 event or res passed by h3 handler
|
|
262
|
+
* @param name Name of the cookie to delete
|
|
263
|
+
* @param serializeOptions {CookieSerializeOptions} Cookie options
|
|
264
|
+
* ```ts
|
|
265
|
+
* deleteCookie(res, 'SessionId')
|
|
266
|
+
* ```
|
|
267
|
+
*/
|
|
268
|
+
declare function deleteCookie(event: CompatibilityEvent, name: string, serializeOptions?: CookieSerializeOptions): void;
|
|
269
|
+
|
|
270
|
+
declare function getQuery(event: CompatibilityEvent): ufo.QueryObject;
|
|
271
|
+
/** @deprecated Use `h3.getQuery` */
|
|
272
|
+
declare const useQuery: typeof getQuery;
|
|
273
|
+
declare function getRouterParams(event: CompatibilityEvent): CompatibilityEvent['context'];
|
|
274
|
+
declare function getRouterParam(event: CompatibilityEvent, name: string): CompatibilityEvent['context'][string];
|
|
275
|
+
declare function getMethod(event: CompatibilityEvent, defaultMethod?: HTTPMethod): HTTPMethod;
|
|
276
|
+
/** @deprecated Use `h3.getMethod` */
|
|
277
|
+
declare const useMethod: typeof getMethod;
|
|
278
|
+
declare function isMethod(event: CompatibilityEvent, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): boolean;
|
|
279
|
+
declare function assertMethod(event: CompatibilityEvent, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): void;
|
|
280
|
+
declare function getRequestHeaders(event: CompatibilityEvent): CompatibilityEvent['req']['headers'];
|
|
281
|
+
declare const getHeaders: typeof getRequestHeaders;
|
|
282
|
+
declare function getRequestHeader(event: CompatibilityEvent, name: string): CompatibilityEvent['req']['headers'][string];
|
|
283
|
+
declare const getHeader: typeof getRequestHeader;
|
|
284
|
+
|
|
285
|
+
declare function send(event: CompatibilityEvent, data?: any, type?: string): Promise<void>;
|
|
286
|
+
declare function defaultContentType(event: CompatibilityEvent, type?: string): void;
|
|
287
|
+
declare function sendRedirect(event: CompatibilityEvent, location: string, code?: number): Promise<void>;
|
|
288
|
+
declare function getResponseHeaders(event: CompatibilityEvent): ReturnType<CompatibilityEvent['res']['getHeaders']>;
|
|
289
|
+
declare function getResponseHeader(event: CompatibilityEvent, name: string): ReturnType<CompatibilityEvent['res']['getHeader']>;
|
|
290
|
+
declare function setResponseHeaders(event: CompatibilityEvent, headers: Record<string, Parameters<OutgoingMessage['setHeader']>[1]>): void;
|
|
291
|
+
declare const setHeaders: typeof setResponseHeaders;
|
|
292
|
+
declare function setResponseHeader(event: CompatibilityEvent, name: string, value: Parameters<OutgoingMessage['setHeader']>[1]): void;
|
|
293
|
+
declare const setHeader: typeof setResponseHeader;
|
|
294
|
+
declare function appendResponseHeaders(event: CompatibilityEvent, headers: Record<string, string>): void;
|
|
295
|
+
declare const appendHeaders: typeof appendResponseHeaders;
|
|
296
|
+
declare function appendResponseHeader(event: CompatibilityEvent, name: string, value: string): void;
|
|
297
|
+
declare const appendHeader: typeof appendResponseHeader;
|
|
298
|
+
declare function isStream(data: any): any;
|
|
299
|
+
declare function sendStream(event: CompatibilityEvent, data: any): Promise<void>;
|
|
300
|
+
|
|
301
|
+
declare type RouterMethod = Lowercase<HTTPMethod>;
|
|
302
|
+
declare type RouterUse = (path: string, handler: CompatibilityEventHandler, method?: RouterMethod | RouterMethod[]) => Router;
|
|
303
|
+
declare type AddRouteShortcuts = Record<RouterMethod, RouterUse>;
|
|
304
|
+
interface Router extends AddRouteShortcuts {
|
|
305
|
+
add: RouterUse;
|
|
306
|
+
use: RouterUse;
|
|
307
|
+
handler: EventHandler;
|
|
308
|
+
}
|
|
309
|
+
declare function createRouter(): Router;
|
|
310
|
+
|
|
311
|
+
export { AddRouteShortcuts, App, AppOptions, AppUse, CacheConditions, CompatibilityEvent, CompatibilityEventHandler, DynamicEventHandler, Encoding, EventHandler, H3Error, H3Event, H3EventContext, H3Headers, H3Response, HTTPMethod, Handler, HandlerResponse, IncomingMessage, InputLayer, InputStack, Layer, LazyEventHandler, LazyHandler, MIMES, Matcher, Middleware, NodeHandler, PromisifiedHandler, Router, RouterMethod, RouterUse, ServerResponse, Stack, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, callHandler, createApp, createAppEventHandler, createError, createEvent, createRouter, defaultContentType, defineEventHandler, defineHandle, defineHandler, defineLazyEventHandler, defineLazyHandler, defineMiddleware, deleteCookie, dynamicEventHandler, eventHandler, getCookie, getHeader, getHeaders, getMethod, getQuery, getRequestHeader, getRequestHeaders, getResponseHeader, getResponseHeaders, getRouterParam, getRouterParams, handleCacheHeaders, isError, isEvent, isEventHandler, isMethod, isStream, lazyEventHandler, lazyHandle, parseCookies, promisifyHandle, promisifyHandler, readBody, readRawBody, send, sendError, sendRedirect, sendStream, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, toEventHandler, use, useBase, useBody, useCookie, useCookies, useMethod, useQuery, useRawBody };
|
package/dist/index.mjs
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import '
|
|
2
|
-
import '
|
|
3
|
-
import 'cookie-es';
|
|
1
|
+
import { getQuery as getQuery$1, withoutTrailingSlash, withoutBase } from 'ufo';
|
|
2
|
+
import destr from 'destr';
|
|
3
|
+
import { parse, serialize } from 'cookie-es';
|
|
4
|
+
import { createRouter as createRouter$1 } from 'radix3';
|
|
4
5
|
|
|
5
6
|
class H3Error extends Error {
|
|
6
7
|
constructor() {
|
|
@@ -49,16 +50,247 @@ function createError(input) {
|
|
|
49
50
|
}
|
|
50
51
|
return err;
|
|
51
52
|
}
|
|
53
|
+
function sendError(event, error, debug) {
|
|
54
|
+
if (event.res.writableEnded) {
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
57
|
+
const h3Error = isError(error) ? error : createError(error);
|
|
58
|
+
const responseBody = {
|
|
59
|
+
statusCode: h3Error.statusCode,
|
|
60
|
+
statusMessage: h3Error.statusMessage,
|
|
61
|
+
stack: [],
|
|
62
|
+
data: h3Error.data
|
|
63
|
+
};
|
|
64
|
+
if (debug) {
|
|
65
|
+
responseBody.stack = (h3Error.stack || "").split("\n").map((l) => l.trim());
|
|
66
|
+
}
|
|
67
|
+
if (event.res.writableEnded) {
|
|
68
|
+
return;
|
|
69
|
+
}
|
|
70
|
+
event.res.statusCode = h3Error.statusCode;
|
|
71
|
+
event.res.statusMessage = h3Error.statusMessage;
|
|
72
|
+
event.res.setHeader("Content-Type", MIMES.json);
|
|
73
|
+
event.res.end(JSON.stringify(responseBody, null, 2));
|
|
74
|
+
}
|
|
52
75
|
function isError(input) {
|
|
53
76
|
return input?.constructor?.__h3_error__ === true;
|
|
54
77
|
}
|
|
55
78
|
|
|
79
|
+
function getQuery(event) {
|
|
80
|
+
return getQuery$1(event.req.url || "");
|
|
81
|
+
}
|
|
82
|
+
const useQuery = getQuery;
|
|
83
|
+
function getRouterParams(event) {
|
|
84
|
+
return event.context.params || {};
|
|
85
|
+
}
|
|
86
|
+
function getRouterParam(event, name) {
|
|
87
|
+
const params = getRouterParams(event);
|
|
88
|
+
return params[name];
|
|
89
|
+
}
|
|
90
|
+
function getMethod(event, defaultMethod = "GET") {
|
|
91
|
+
return (event.req.method || defaultMethod).toUpperCase();
|
|
92
|
+
}
|
|
93
|
+
const useMethod = getMethod;
|
|
94
|
+
function isMethod(event, expected, allowHead) {
|
|
95
|
+
const method = getMethod(event);
|
|
96
|
+
if (allowHead && method === "HEAD") {
|
|
97
|
+
return true;
|
|
98
|
+
}
|
|
99
|
+
if (typeof expected === "string") {
|
|
100
|
+
if (method === expected) {
|
|
101
|
+
return true;
|
|
102
|
+
}
|
|
103
|
+
} else if (expected.includes(method)) {
|
|
104
|
+
return true;
|
|
105
|
+
}
|
|
106
|
+
return false;
|
|
107
|
+
}
|
|
108
|
+
function assertMethod(event, expected, allowHead) {
|
|
109
|
+
if (!isMethod(event, expected, allowHead)) {
|
|
110
|
+
throw createError({
|
|
111
|
+
statusCode: 405,
|
|
112
|
+
statusMessage: "HTTP method is not allowed."
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
function getRequestHeaders(event) {
|
|
117
|
+
return event.req.headers;
|
|
118
|
+
}
|
|
119
|
+
const getHeaders = getRequestHeaders;
|
|
120
|
+
function getRequestHeader(event, name) {
|
|
121
|
+
const headers = getRequestHeaders(event);
|
|
122
|
+
const value = headers[name.toLowerCase()];
|
|
123
|
+
return value;
|
|
124
|
+
}
|
|
125
|
+
const getHeader = getRequestHeader;
|
|
126
|
+
|
|
127
|
+
const RawBodySymbol = Symbol("h3RawBody");
|
|
128
|
+
const ParsedBodySymbol = Symbol("h3RawBody");
|
|
129
|
+
const PayloadMethods = ["PATCH", "POST", "PUT", "DELETE"];
|
|
130
|
+
function readRawBody(event, encoding = "utf-8") {
|
|
131
|
+
assertMethod(event, PayloadMethods);
|
|
132
|
+
if (RawBodySymbol in event.req) {
|
|
133
|
+
const promise2 = Promise.resolve(event.req[RawBodySymbol]);
|
|
134
|
+
return encoding ? promise2.then((buff) => buff.toString(encoding)) : promise2;
|
|
135
|
+
}
|
|
136
|
+
if ("body" in event.req) {
|
|
137
|
+
return Promise.resolve(event.req.body);
|
|
138
|
+
}
|
|
139
|
+
const promise = event.req[RawBodySymbol] = new Promise((resolve, reject) => {
|
|
140
|
+
const bodyData = [];
|
|
141
|
+
event.req.on("error", (err) => {
|
|
142
|
+
reject(err);
|
|
143
|
+
}).on("data", (chunk) => {
|
|
144
|
+
bodyData.push(chunk);
|
|
145
|
+
}).on("end", () => {
|
|
146
|
+
resolve(Buffer.concat(bodyData));
|
|
147
|
+
});
|
|
148
|
+
});
|
|
149
|
+
return encoding ? promise.then((buff) => buff.toString(encoding)) : promise;
|
|
150
|
+
}
|
|
151
|
+
const useRawBody = readRawBody;
|
|
152
|
+
async function readBody(event) {
|
|
153
|
+
if (ParsedBodySymbol in event.req) {
|
|
154
|
+
return event.req[ParsedBodySymbol];
|
|
155
|
+
}
|
|
156
|
+
const body = await readRawBody(event);
|
|
157
|
+
if (event.req.headers["content-type"] === "application/x-www-form-urlencoded") {
|
|
158
|
+
const parsedForm = Object.fromEntries(new URLSearchParams(body));
|
|
159
|
+
return parsedForm;
|
|
160
|
+
}
|
|
161
|
+
const json = destr(body);
|
|
162
|
+
event.req[ParsedBodySymbol] = json;
|
|
163
|
+
return json;
|
|
164
|
+
}
|
|
165
|
+
const useBody = readBody;
|
|
166
|
+
|
|
167
|
+
function handleCacheHeaders(event, opts) {
|
|
168
|
+
const cacheControls = ["public"].concat(opts.cacheControls || []);
|
|
169
|
+
let cacheMatched = false;
|
|
170
|
+
if (opts.maxAge !== void 0) {
|
|
171
|
+
cacheControls.push(`max-age=${+opts.maxAge}`, `s-maxage=${+opts.maxAge}`);
|
|
172
|
+
}
|
|
173
|
+
if (opts.modifiedTime) {
|
|
174
|
+
const modifiedTime = new Date(opts.modifiedTime);
|
|
175
|
+
const ifModifiedSince = event.req.headers["if-modified-since"];
|
|
176
|
+
event.res.setHeader("Last-Modified", modifiedTime.toUTCString());
|
|
177
|
+
if (ifModifiedSince) {
|
|
178
|
+
if (new Date(ifModifiedSince) >= opts.modifiedTime) {
|
|
179
|
+
cacheMatched = true;
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
if (opts.etag) {
|
|
184
|
+
event.res.setHeader("Etag", opts.etag);
|
|
185
|
+
const ifNonMatch = event.req.headers["if-none-match"];
|
|
186
|
+
if (ifNonMatch === opts.etag) {
|
|
187
|
+
cacheMatched = true;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
event.res.setHeader("Cache-Control", cacheControls.join(", "));
|
|
191
|
+
if (cacheMatched) {
|
|
192
|
+
event.res.statusCode = 304;
|
|
193
|
+
event.res.end("");
|
|
194
|
+
return true;
|
|
195
|
+
}
|
|
196
|
+
return false;
|
|
197
|
+
}
|
|
198
|
+
|
|
56
199
|
const MIMES = {
|
|
57
200
|
html: "text/html",
|
|
58
201
|
json: "application/json"
|
|
59
202
|
};
|
|
60
203
|
|
|
61
|
-
typeof setImmediate !== "undefined" ? setImmediate : (fn) => fn();
|
|
204
|
+
const defer = typeof setImmediate !== "undefined" ? setImmediate : (fn) => fn();
|
|
205
|
+
function send(event, data, type) {
|
|
206
|
+
if (type) {
|
|
207
|
+
defaultContentType(event, type);
|
|
208
|
+
}
|
|
209
|
+
return new Promise((resolve) => {
|
|
210
|
+
defer(() => {
|
|
211
|
+
event.res.end(data);
|
|
212
|
+
resolve(void 0);
|
|
213
|
+
});
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
function defaultContentType(event, type) {
|
|
217
|
+
if (type && !event.res.getHeader("Content-Type")) {
|
|
218
|
+
event.res.setHeader("Content-Type", type);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
function sendRedirect(event, location, code = 302) {
|
|
222
|
+
const encodedLoc = encodeURI(decodeURI(location));
|
|
223
|
+
event.res.statusCode = code;
|
|
224
|
+
event.res.setHeader("Location", encodedLoc);
|
|
225
|
+
const html = `<!DOCTYPE html>
|
|
226
|
+
<html>
|
|
227
|
+
<head><meta http-equiv="refresh" content="0; url=${encodedLoc}"></head>
|
|
228
|
+
<body>Redirecting to <a href=${JSON.stringify(encodedLoc)}>${encodedLoc}</a></body>
|
|
229
|
+
</html>`;
|
|
230
|
+
return send(event, html, MIMES.html);
|
|
231
|
+
}
|
|
232
|
+
function getResponseHeaders(event) {
|
|
233
|
+
return event.res.getHeaders();
|
|
234
|
+
}
|
|
235
|
+
function getResponseHeader(event, name) {
|
|
236
|
+
return event.res.getHeader(name);
|
|
237
|
+
}
|
|
238
|
+
function setResponseHeaders(event, headers) {
|
|
239
|
+
Object.entries(headers).forEach(([name, value]) => event.res.setHeader(name, value));
|
|
240
|
+
}
|
|
241
|
+
const setHeaders = setResponseHeaders;
|
|
242
|
+
function setResponseHeader(event, name, value) {
|
|
243
|
+
event.res.setHeader(name, value);
|
|
244
|
+
}
|
|
245
|
+
const setHeader = setResponseHeader;
|
|
246
|
+
function appendResponseHeaders(event, headers) {
|
|
247
|
+
Object.entries(headers).forEach(([name, value]) => appendResponseHeader(event, name, value));
|
|
248
|
+
}
|
|
249
|
+
const appendHeaders = appendResponseHeaders;
|
|
250
|
+
function appendResponseHeader(event, name, value) {
|
|
251
|
+
let current = event.res.getHeader(name);
|
|
252
|
+
if (!current) {
|
|
253
|
+
event.res.setHeader(name, value);
|
|
254
|
+
return;
|
|
255
|
+
}
|
|
256
|
+
if (!Array.isArray(current)) {
|
|
257
|
+
current = [current.toString()];
|
|
258
|
+
}
|
|
259
|
+
event.res.setHeader(name, current.concat(value));
|
|
260
|
+
}
|
|
261
|
+
const appendHeader = appendResponseHeader;
|
|
262
|
+
function isStream(data) {
|
|
263
|
+
return data && typeof data === "object" && typeof data.pipe === "function" && typeof data.on === "function";
|
|
264
|
+
}
|
|
265
|
+
function sendStream(event, data) {
|
|
266
|
+
return new Promise((resolve, reject) => {
|
|
267
|
+
data.pipe(event.res);
|
|
268
|
+
data.on("end", () => resolve(void 0));
|
|
269
|
+
data.on("error", (error) => reject(createError(error)));
|
|
270
|
+
});
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
function parseCookies(event) {
|
|
274
|
+
return parse(event.req.headers.cookie || "");
|
|
275
|
+
}
|
|
276
|
+
const useCookies = parseCookies;
|
|
277
|
+
function getCookie(event, name) {
|
|
278
|
+
return parseCookies(event)[name];
|
|
279
|
+
}
|
|
280
|
+
const useCookie = getCookie;
|
|
281
|
+
function setCookie(event, name, value, serializeOptions) {
|
|
282
|
+
const cookieStr = serialize(name, value, {
|
|
283
|
+
path: "/",
|
|
284
|
+
...serializeOptions
|
|
285
|
+
});
|
|
286
|
+
appendHeader(event, "Set-Cookie", cookieStr);
|
|
287
|
+
}
|
|
288
|
+
function deleteCookie(event, name, serializeOptions) {
|
|
289
|
+
setCookie(event, name, "", {
|
|
290
|
+
...serializeOptions,
|
|
291
|
+
maxAge: 0
|
|
292
|
+
});
|
|
293
|
+
}
|
|
62
294
|
|
|
63
295
|
class H3Headers {
|
|
64
296
|
constructor(init) {
|
|
@@ -185,6 +417,15 @@ function createEvent(req, res) {
|
|
|
185
417
|
return new H3Event(req, res);
|
|
186
418
|
}
|
|
187
419
|
|
|
420
|
+
const defineHandler = (handler) => handler;
|
|
421
|
+
const defineHandle = defineHandler;
|
|
422
|
+
const defineMiddleware = (middleware) => middleware;
|
|
423
|
+
function promisifyHandler(handler) {
|
|
424
|
+
return function(req, res) {
|
|
425
|
+
return callHandler(handler, req, res);
|
|
426
|
+
};
|
|
427
|
+
}
|
|
428
|
+
const promisifyHandle = promisifyHandler;
|
|
188
429
|
function callHandler(handler, req, res) {
|
|
189
430
|
const isMiddleware = handler.length > 2;
|
|
190
431
|
return new Promise((resolve, reject) => {
|
|
@@ -208,6 +449,30 @@ function callHandler(handler, req, res) {
|
|
|
208
449
|
}
|
|
209
450
|
});
|
|
210
451
|
}
|
|
452
|
+
function defineLazyHandler(handler, promisify) {
|
|
453
|
+
let _promise;
|
|
454
|
+
const resolve = () => {
|
|
455
|
+
if (!_promise) {
|
|
456
|
+
_promise = Promise.resolve(handler()).then((r) => promisify ? promisifyHandler(r.default || r) : r.default || r);
|
|
457
|
+
}
|
|
458
|
+
return _promise;
|
|
459
|
+
};
|
|
460
|
+
return function(req, res) {
|
|
461
|
+
return resolve().then((h) => h(req, res));
|
|
462
|
+
};
|
|
463
|
+
}
|
|
464
|
+
const lazyHandle = defineLazyHandler;
|
|
465
|
+
function useBase(base, handler) {
|
|
466
|
+
base = withoutTrailingSlash(base);
|
|
467
|
+
if (!base) {
|
|
468
|
+
return handler;
|
|
469
|
+
}
|
|
470
|
+
return function(req, res) {
|
|
471
|
+
req.originalUrl = req.originalUrl || req.url || "/";
|
|
472
|
+
req.url = withoutBase(req.url || "/", base);
|
|
473
|
+
return handler(req, res);
|
|
474
|
+
};
|
|
475
|
+
}
|
|
211
476
|
|
|
212
477
|
function defineEventHandler(handler) {
|
|
213
478
|
handler.__is_handler__ = true;
|
|
@@ -268,4 +533,161 @@ function defineLazyEventHandler(factory) {
|
|
|
268
533
|
}
|
|
269
534
|
const lazyEventHandler = defineLazyEventHandler;
|
|
270
535
|
|
|
271
|
-
|
|
536
|
+
function createApp(options = {}) {
|
|
537
|
+
const stack = [];
|
|
538
|
+
const handler = createAppEventHandler(stack, options);
|
|
539
|
+
const nodeHandler = async function(req, res) {
|
|
540
|
+
const event = createEvent(req, res);
|
|
541
|
+
try {
|
|
542
|
+
await handler(event);
|
|
543
|
+
} catch (_error) {
|
|
544
|
+
const error = createError(_error);
|
|
545
|
+
if (!isError(_error)) {
|
|
546
|
+
error.unhandled = true;
|
|
547
|
+
}
|
|
548
|
+
if (options.onError) {
|
|
549
|
+
await options.onError(error, event);
|
|
550
|
+
} else {
|
|
551
|
+
if (error.unhandled || error.fatal) {
|
|
552
|
+
console.error("[h3]", error.fatal ? "[fatal]" : "[unhandled]", error);
|
|
553
|
+
}
|
|
554
|
+
await sendError(event, error, !!options.debug);
|
|
555
|
+
}
|
|
556
|
+
}
|
|
557
|
+
};
|
|
558
|
+
const app = nodeHandler;
|
|
559
|
+
app.nodeHandler = nodeHandler;
|
|
560
|
+
app.stack = stack;
|
|
561
|
+
app.handler = handler;
|
|
562
|
+
app.use = (arg1, arg2, arg3) => use(app, arg1, arg2, arg3);
|
|
563
|
+
return app;
|
|
564
|
+
}
|
|
565
|
+
function use(app, arg1, arg2, arg3) {
|
|
566
|
+
if (Array.isArray(arg1)) {
|
|
567
|
+
arg1.forEach((i) => use(app, i, arg2, arg3));
|
|
568
|
+
} else if (Array.isArray(arg2)) {
|
|
569
|
+
arg2.forEach((i) => use(app, arg1, i, arg3));
|
|
570
|
+
} else if (typeof arg1 === "string") {
|
|
571
|
+
app.stack.push(normalizeLayer({ ...arg3, route: arg1, handler: arg2 }));
|
|
572
|
+
} else if (typeof arg1 === "function") {
|
|
573
|
+
app.stack.push(normalizeLayer({ ...arg2, route: "/", handler: arg1 }));
|
|
574
|
+
} else {
|
|
575
|
+
app.stack.push(normalizeLayer({ ...arg1 }));
|
|
576
|
+
}
|
|
577
|
+
return app;
|
|
578
|
+
}
|
|
579
|
+
function createAppEventHandler(stack, options) {
|
|
580
|
+
const spacing = options.debug ? 2 : void 0;
|
|
581
|
+
return eventHandler(async (event) => {
|
|
582
|
+
event.req.originalUrl = event.req.originalUrl || event.req.url || "/";
|
|
583
|
+
const reqUrl = event.req.url || "/";
|
|
584
|
+
for (const layer of stack) {
|
|
585
|
+
if (layer.route.length > 1) {
|
|
586
|
+
if (!reqUrl.startsWith(layer.route)) {
|
|
587
|
+
continue;
|
|
588
|
+
}
|
|
589
|
+
event.req.url = reqUrl.slice(layer.route.length) || "/";
|
|
590
|
+
} else {
|
|
591
|
+
event.req.url = reqUrl;
|
|
592
|
+
}
|
|
593
|
+
if (layer.match && !layer.match(event.req.url, event)) {
|
|
594
|
+
continue;
|
|
595
|
+
}
|
|
596
|
+
const val = await layer.handler(event);
|
|
597
|
+
if (event.res.writableEnded) {
|
|
598
|
+
return;
|
|
599
|
+
}
|
|
600
|
+
const type = typeof val;
|
|
601
|
+
if (type === "string") {
|
|
602
|
+
return send(event, val, MIMES.html);
|
|
603
|
+
} else if (isStream(val)) {
|
|
604
|
+
return sendStream(event, val);
|
|
605
|
+
} else if (val === null) {
|
|
606
|
+
event.res.statusCode = 204;
|
|
607
|
+
return send(event);
|
|
608
|
+
} else if (type === "object" || type === "boolean" || type === "number") {
|
|
609
|
+
if (val.buffer) {
|
|
610
|
+
return send(event, val);
|
|
611
|
+
} else if (val instanceof Error) {
|
|
612
|
+
throw createError(val);
|
|
613
|
+
} else {
|
|
614
|
+
return send(event, JSON.stringify(val, null, spacing), MIMES.json);
|
|
615
|
+
}
|
|
616
|
+
}
|
|
617
|
+
}
|
|
618
|
+
if (!event.res.writableEnded) {
|
|
619
|
+
throw createError({ statusCode: 404, statusMessage: "Not Found" });
|
|
620
|
+
}
|
|
621
|
+
});
|
|
622
|
+
}
|
|
623
|
+
function normalizeLayer(input) {
|
|
624
|
+
let handler = input.handler || input.handle;
|
|
625
|
+
if (handler.handler) {
|
|
626
|
+
handler = handler.handler;
|
|
627
|
+
}
|
|
628
|
+
if (input.lazy) {
|
|
629
|
+
handler = lazyEventHandler(handler);
|
|
630
|
+
} else if (!isEventHandler(handler)) {
|
|
631
|
+
handler = toEventHandler(handler);
|
|
632
|
+
}
|
|
633
|
+
return {
|
|
634
|
+
route: withoutTrailingSlash(input.route),
|
|
635
|
+
match: input.match,
|
|
636
|
+
handler
|
|
637
|
+
};
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
const RouterMethods = ["connect", "delete", "get", "head", "options", "post", "put", "trace", "patch"];
|
|
641
|
+
function createRouter() {
|
|
642
|
+
const _router = createRouter$1({});
|
|
643
|
+
const routes = {};
|
|
644
|
+
const router = {};
|
|
645
|
+
const addRoute = (path, handler, method) => {
|
|
646
|
+
let route = routes[path];
|
|
647
|
+
if (!route) {
|
|
648
|
+
routes[path] = route = { handlers: {} };
|
|
649
|
+
_router.insert(path, route);
|
|
650
|
+
}
|
|
651
|
+
if (Array.isArray(method)) {
|
|
652
|
+
method.forEach((m) => addRoute(path, handler, m));
|
|
653
|
+
} else {
|
|
654
|
+
route.handlers[method] = toEventHandler(handler);
|
|
655
|
+
}
|
|
656
|
+
return router;
|
|
657
|
+
};
|
|
658
|
+
router.use = router.add = (path, handler, method) => addRoute(path, handler, method || "all");
|
|
659
|
+
for (const method of RouterMethods) {
|
|
660
|
+
router[method] = (path, handle) => router.add(path, handle, method);
|
|
661
|
+
}
|
|
662
|
+
router.handler = eventHandler((event) => {
|
|
663
|
+
let path = event.req.url || "/";
|
|
664
|
+
const queryUrlIndex = path.lastIndexOf("?");
|
|
665
|
+
if (queryUrlIndex > -1) {
|
|
666
|
+
path = path.substring(0, queryUrlIndex);
|
|
667
|
+
}
|
|
668
|
+
const matched = _router.lookup(path);
|
|
669
|
+
if (!matched) {
|
|
670
|
+
throw createError({
|
|
671
|
+
statusCode: 404,
|
|
672
|
+
name: "Not Found",
|
|
673
|
+
statusMessage: `Cannot find any route matching ${event.req.url || "/"}.`
|
|
674
|
+
});
|
|
675
|
+
}
|
|
676
|
+
const method = (event.req.method || "get").toLowerCase();
|
|
677
|
+
const handler = matched.handlers[method] || matched.handlers.all;
|
|
678
|
+
if (!handler) {
|
|
679
|
+
throw createError({
|
|
680
|
+
statusCode: 405,
|
|
681
|
+
name: "Method Not Allowed",
|
|
682
|
+
statusMessage: `Method ${method} is not allowed on this route.`
|
|
683
|
+
});
|
|
684
|
+
}
|
|
685
|
+
const params = matched.params || {};
|
|
686
|
+
event.event.context.params = params;
|
|
687
|
+
event.req.context.params = params;
|
|
688
|
+
return handler(event);
|
|
689
|
+
});
|
|
690
|
+
return router;
|
|
691
|
+
}
|
|
692
|
+
|
|
693
|
+
export { H3Error, H3Event, H3Headers, H3Response, MIMES, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, callHandler, createApp, createAppEventHandler, createError, createEvent, createRouter, defaultContentType, defineEventHandler, defineHandle, defineHandler, defineLazyEventHandler, defineLazyHandler, defineMiddleware, deleteCookie, dynamicEventHandler, eventHandler, getCookie, getHeader, getHeaders, getMethod, getQuery, getRequestHeader, getRequestHeaders, getResponseHeader, getResponseHeaders, getRouterParam, getRouterParams, handleCacheHeaders, isError, isEvent, isEventHandler, isMethod, isStream, lazyEventHandler, lazyHandle, parseCookies, promisifyHandle, promisifyHandler, readBody, readRawBody, send, sendError, sendRedirect, sendStream, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, toEventHandler, use, useBase, useBody, useCookie, useCookies, useMethod, useQuery, useRawBody };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "h3",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.19",
|
|
4
4
|
"description": "Tiny JavaScript Server",
|
|
5
5
|
"repository": "unjs/h3",
|
|
6
6
|
"license": "MIT",
|
|
@@ -12,9 +12,9 @@
|
|
|
12
12
|
"require": "./dist/index.cjs"
|
|
13
13
|
}
|
|
14
14
|
},
|
|
15
|
-
"main": "dist/index.cjs",
|
|
16
|
-
"module": "dist/index.mjs",
|
|
17
|
-
"types": "dist/index.d.ts",
|
|
15
|
+
"main": "./dist/index.cjs",
|
|
16
|
+
"module": "./dist/index.mjs",
|
|
17
|
+
"types": "./dist/index.d.ts",
|
|
18
18
|
"files": [
|
|
19
19
|
"dist"
|
|
20
20
|
],
|