h3 0.3.3 → 0.3.4

package/README.md

@@ -98,6 +98,11 @@ Instead of adding helpers to `req` and `res`, h3 exposes them as composable util
 - `appendHeader(res, name, value)`
 - `createError({ statusCode, statusMessage, data? }`
 - `sendError(res, error, debug?)`
+- `defineHandle(handle)`
+- `defineMiddleware(middlware)`
+- `useMethod(req, default?)`
+- `isMethod(req, expected, allowHead?)`
+- `assertMethod(req, expected, allowHead?)`
 
 👉 You can learn more about usage in [JSDocs Documentation](https://www.jsdocs.io/package/h3#package-functions).
 

package/dist/index.cjs

@@ -83,8 +83,8 @@ function parseURL(input = "", defaultProto) {
     return defaultProto ? parseURL(defaultProto + input) : parsePath(input);
   }
   const [protocol = "", auth, hostAndPath] = (input.match(/([^:/]+:)?\/\/([^/@]+@)?(.*)/) || []).splice(1);
-  const [host = "", path = ""] = (hostAndPath.match(/([^/]*)(.*)?/) || []).splice(1);
-  const {pathname, search, hash} = parsePath(path);
+  const [host = "", path = ""] = (hostAndPath.match(/([^/?]*)(.*)?/) || []).splice(1);
+  const { pathname, search, hash } = parsePath(path);
   return {
     protocol,
     auth: auth ? auth.substr(0, auth.length - 1) : "",
@@ -103,6 +103,8 @@ function parsePath(input = "") {
   };
 }
 
+const defineHandle = (handler) => handler;
+const defineMiddleware = (middleware) => middleware;
 function promisifyHandle(handle) {
   return function(req, res) {
     return callHandle(handle, req, res);
@@ -346,11 +348,7 @@ function serialize(name, val, options) {
 
   if (null != opt.maxAge) {
     var maxAge = opt.maxAge - 0;
-
-    if (isNaN(maxAge) || !isFinite(maxAge)) {
-      throw new TypeError('option maxAge is invalid')
-    }
-
+    if (isNaN(maxAge)) throw new Error('maxAge should be a Number');
     str += '; Max-Age=' + Math.floor(maxAge);
   }
 
@@ -475,6 +473,31 @@ function setCookie(res, name, value, serializeOptions) {
 function useQuery(req) {
   return getQuery(req.url || "");
 }
+function useMethod(req, defaultMethod = "GET") {
+  return (req.method || defaultMethod).toUpperCase();
+}
+function isMethod(req, expected, allowHead) {
+  const method = useMethod(req);
+  if (allowHead && method === "HEAD") {
+    return true;
+  }
+  if (typeof expected === "string") {
+    if (method === expected) {
+      return true;
+    }
+  } else if (expected.includes(method)) {
+    return true;
+  }
+  return false;
+}
+function assertMethod(req, expected, allowHead) {
+  if (!isMethod(req, expected, allowHead)) {
+    throw createError({
+      statusCode: 405,
+      statusMessage: "HTTP method is not allowed."
+    });
+  }
+}
 
 class H3Error extends Error {
   constructor() {
@@ -609,11 +632,15 @@ function normalizeLayer(layer) {
 exports.H3Error = H3Error;
 exports.MIMES = MIMES;
 exports.appendHeader = appendHeader;
+exports.assertMethod = assertMethod;
 exports.callHandle = callHandle;
 exports.createApp = createApp;
 exports.createError = createError;
 exports.createHandle = createHandle;
 exports.defaultContentType = defaultContentType;
+exports.defineHandle = defineHandle;
+exports.defineMiddleware = defineMiddleware;
+exports.isMethod = isMethod;
 exports.lazyHandle = lazyHandle;
 exports.promisifyHandle = promisifyHandle;
 exports.send = send;
@@ -625,5 +652,6 @@ exports.useBase = useBase;
 exports.useBody = useBody;
 exports.useCookie = useCookie;
 exports.useCookies = useCookies;
+exports.useMethod = useMethod;
 exports.useQuery = useQuery;
 exports.useRawBody = useRawBody;

package/dist/index.d.ts

@@ -7,6 +7,8 @@ declare type Handle<T = any> = (req: IncomingMessage, res: ServerResponse) => T;
 declare type PHandle = Handle<Promise<any>>;
 declare type Middleware = (req: IncomingMessage, res: ServerResponse, next: (err?: Error) => any) => any;
 declare type LazyHandle = () => Handle | Promise<Handle>;
+declare const defineHandle: <T>(handler: Handle<T>) => Handle<T>;
+declare const defineMiddleware: (middleware: Middleware) => Middleware;
 declare function promisifyHandle(handle: Handle | Middleware): PHandle;
 declare function callHandle(handle: Middleware, req: IncomingMessage, res: ServerResponse): Promise<unknown>;
 declare function lazyHandle(handle: LazyHandle, promisify?: boolean): PHandle;
@@ -226,10 +228,14 @@ declare function useCookie(req: IncomingMessage, name: string): string | undefin
 declare function setCookie(res: ServerResponse, name: string, value: string, serializeOptions?: CookieSerializeOptions): void;
 
 declare function useQuery(req: IncomingMessage): ufo.QueryObject;
+declare type HTTPMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE';
+declare function useMethod(req: IncomingMessage, defaultMethod?: HTTPMethod): HTTPMethod;
+declare function isMethod(req: IncomingMessage, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): boolean;
+declare function assertMethod(req: IncomingMessage, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): void;
 
 declare function send(res: ServerResponse, data: any, type?: string): Promise<unknown>;
 declare function defaultContentType(res: ServerResponse, type?: string): void;
 declare function sendRedirect(res: ServerResponse, location: string, code?: number): Promise<unknown>;
 declare function appendHeader(res: ServerResponse, name: string, value: string): void;
 
-export { App, AppOptions, AppUse, H3Error, Handle, InputLayer, InputStack, Layer, LazyHandle, MIMES, Matcher, Middleware, PHandle, Stack, appendHeader, callHandle, createApp, createError, createHandle, defaultContentType, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useQuery, useRawBody };
+export { App, AppOptions, AppUse, H3Error, HTTPMethod, Handle, InputLayer, InputStack, Layer, LazyHandle, MIMES, Matcher, Middleware, PHandle, Stack, appendHeader, assertMethod, callHandle, createApp, createError, createHandle, defaultContentType, defineHandle, defineMiddleware, isMethod, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useMethod, useQuery, useRawBody };

package/dist/index.mjs

@@ -79,8 +79,8 @@ function parseURL(input = "", defaultProto) {
     return defaultProto ? parseURL(defaultProto + input) : parsePath(input);
   }
   const [protocol = "", auth, hostAndPath] = (input.match(/([^:/]+:)?\/\/([^/@]+@)?(.*)/) || []).splice(1);
-  const [host = "", path = ""] = (hostAndPath.match(/([^/]*)(.*)?/) || []).splice(1);
-  const {pathname, search, hash} = parsePath(path);
+  const [host = "", path = ""] = (hostAndPath.match(/([^/?]*)(.*)?/) || []).splice(1);
+  const { pathname, search, hash } = parsePath(path);
   return {
     protocol,
     auth: auth ? auth.substr(0, auth.length - 1) : "",
@@ -99,6 +99,8 @@ function parsePath(input = "") {
   };
 }
 
+const defineHandle = (handler) => handler;
+const defineMiddleware = (middleware) => middleware;
 function promisifyHandle(handle) {
   return function(req, res) {
     return callHandle(handle, req, res);
@@ -342,11 +344,7 @@ function serialize(name, val, options) {
 
   if (null != opt.maxAge) {
     var maxAge = opt.maxAge - 0;
-
-    if (isNaN(maxAge) || !isFinite(maxAge)) {
-      throw new TypeError('option maxAge is invalid')
-    }
-
+    if (isNaN(maxAge)) throw new Error('maxAge should be a Number');
     str += '; Max-Age=' + Math.floor(maxAge);
   }
 
@@ -471,6 +469,31 @@ function setCookie(res, name, value, serializeOptions) {
 function useQuery(req) {
   return getQuery(req.url || "");
 }
+function useMethod(req, defaultMethod = "GET") {
+  return (req.method || defaultMethod).toUpperCase();
+}
+function isMethod(req, expected, allowHead) {
+  const method = useMethod(req);
+  if (allowHead && method === "HEAD") {
+    return true;
+  }
+  if (typeof expected === "string") {
+    if (method === expected) {
+      return true;
+    }
+  } else if (expected.includes(method)) {
+    return true;
+  }
+  return false;
+}
+function assertMethod(req, expected, allowHead) {
+  if (!isMethod(req, expected, allowHead)) {
+    throw createError({
+      statusCode: 405,
+      statusMessage: "HTTP method is not allowed."
+    });
+  }
+}
 
 class H3Error extends Error {
   constructor() {
@@ -602,4 +625,4 @@ function normalizeLayer(layer) {
   };
 }
 
-export { H3Error, MIMES, appendHeader, callHandle, createApp, createError, createHandle, defaultContentType, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useQuery, useRawBody };
+export { H3Error, MIMES, appendHeader, assertMethod, callHandle, createApp, createError, createHandle, defaultContentType, defineHandle, defineMiddleware, isMethod, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useMethod, useQuery, useRawBody };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h3",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Tiny JavaScript Server",
   "repository": "unjs/h3",
   "license": "MIT",
@@ -21,8 +21,8 @@
     "build": "siroc build",
     "dev": "jiti test/playground",
     "lint": "eslint --ext ts .",
-    "release": "yarn test && yarn build && standard-version && npm publish && git push --follow-tags",
     "profile": "0x -o -D .profile -P 'autocannon -c 100 -p 10 -d 40 http://localhost:$PORT' ./hello.js",
+    "release": "yarn test && yarn build && standard-version && npm publish && git push --follow-tags",
     "test": "yarn lint && jest"
   },
   "devDependencies": {
@@ -35,11 +35,11 @@
     "@types/supertest": "latest",
     "autocannon": "latest",
     "connect": "latest",
-    "cookie": "latest",
+    "cookie-es": "latest",
     "destr": "latest",
     "eslint": "latest",
     "express": "latest",
-    "get-port": "latest",
+    "get-port": "^5.0.0",
     "jest": "latest",
     "jiti": "latest",
     "listhen": "latest",