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 CHANGED
@@ -2,9 +2,14 @@
2
2
 
3
3
  Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
- require('destr');
6
- require('ufo');
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
- interface CompatibilityRequestProps {
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
- export { DynamicEventHandler, H3Event, H3Headers, H3Response, createEvent, defineEventHandler, defineLazyEventHandler, dynamicEventHandler, eventHandler, isEvent, isEventHandler, lazyEventHandler, toEventHandler };
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 'destr';
2
- import 'ufo';
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
- export { H3Event, H3Headers, H3Response, createEvent, defineEventHandler, defineLazyEventHandler, dynamicEventHandler, eventHandler, isEvent, isEventHandler, lazyEventHandler, toEventHandler };
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.18",
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
  ],