@eggjs/router 2.0.1 → 3.0.1

package/dist/commonjs/index.d.ts

@@ -0,0 +1,7 @@
+import { Router } from './Router.js';
+export type * from './types.js';
+export * from './Layer.js';
+export * from './Router.js';
+export * from './EggRouter.js';
+export declare const KoaRouter: typeof Router;
+export default Router;

package/dist/commonjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KoaRouter = void 0;
+const Router_js_1 = require("./Router.js");
+__exportStar(require("./Layer.js"), exports);
+__exportStar(require("./Router.js"), exports);
+__exportStar(require("./EggRouter.js"), exports);
+exports.KoaRouter = Router_js_1.Router;
+exports.default = Router_js_1.Router;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwyQ0FBcUM7QUFHckMsNkNBQTJCO0FBQzNCLDhDQUE0QjtBQUM1QixpREFBK0I7QUFFbEIsUUFBQSxTQUFTLEdBQUcsa0JBQU0sQ0FBQztBQUNoQyxrQkFBZSxrQkFBTSxDQUFDIn0=

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/commonjs/types.d.ts

@@ -0,0 +1,18 @@
+export type Next = () => Promise<void>;
+export type MiddlewareFunc = (ctx: any, next: Next) => Promise<void> | void;
+export type MiddlewareFuncWithParamProperty = MiddlewareFunc & {
+    param?: string;
+};
+export type ParamMiddlewareFunc = (param: string, ctx: any, next: Next) => Promise<void> | void;
+export type MiddlewareFuncWithRouter<T> = MiddlewareFunc & {
+    router: T;
+};
+export interface ResourcesController {
+    index?: MiddlewareFunc;
+    new?: MiddlewareFunc;
+    create?: MiddlewareFunc;
+    show?: MiddlewareFunc;
+    edit?: MiddlewareFunc;
+    update?: MiddlewareFunc;
+    destroy?: MiddlewareFunc;
+}

package/dist/commonjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/esm/EggRouter.d.ts

@@ -0,0 +1,102 @@
+import { RegisterOptions, Router, RouterMethod, RouterOptions } from './Router.js';
+import { MiddlewareFunc, ResourcesController } from './types.js';
+interface Application {
+    controller: Record<string, any>;
+}
+/**
+ * FIXME: move these patch into @eggjs/router
+ */
+export declare class EggRouter extends Router {
+    readonly app: Application;
+    /**
+     * @class
+     * @param {Object} opts - Router options.
+     * @param {Application} app - Application object.
+     */
+    constructor(opts: RouterOptions, app: Application);
+    verb(method: RouterMethod | RouterMethod[], nameOrPath: string | RegExp | (string | RegExp)[], pathOrMiddleware: string | RegExp | (string | RegExp)[] | MiddlewareFunc, ...middleware: (MiddlewareFunc | string)[]): this;
+    head(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    head(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    options(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    options(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    get(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    get(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    put(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    put(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    patch(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    patch(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    post(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    post(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    delete(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    delete(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    all(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    all(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): Router;
+    register(path: string | RegExp | (string | RegExp)[], methods: string[], middleware: MiddlewareFunc | string | (MiddlewareFunc | string | ResourcesController)[], opts?: RegisterOptions): import("./Layer.js").Layer | import("./Layer.js").Layer[];
+    /**
+     * restful router api
+     * @param {String} name - Router name
+     * @param {String} prefix - url prefix
+     * @param {Function} middleware - middleware or controller
+     * @example
+     * ```js
+     * app.resources('/posts', 'posts')
+     * app.resources('posts', '/posts', 'posts')
+     * app.resources('posts', '/posts', app.role.can('user'), app.controller.posts)
+     * ```
+     *
+     * Examples:
+     *
+     * ```js
+     * app.resources('/posts', 'posts')
+     * ```
+     *
+     * yield router mapping
+     *
+     * Method | Path            | Route Name     | Controller.Action
+     * -------|-----------------|----------------|-----------------------------
+     * GET    | /posts          | posts          | app.controller.posts.index
+     * GET    | /posts/new      | new_post       | app.controller.posts.new
+     * GET    | /posts/:id      | post           | app.controller.posts.show
+     * GET    | /posts/:id/edit | edit_post      | app.controller.posts.edit
+     * POST   | /posts          | posts          | app.controller.posts.create
+     * PATCH  | /posts/:id      | post           | app.controller.posts.update
+     * DELETE | /posts/:id      | post           | app.controller.posts.destroy
+     *
+     * app.router.url can generate url based on arguments
+     * ```js
+     * app.router.url('posts')
+     * => /posts
+     * app.router.url('post', { id: 1 })
+     * => /posts/1
+     * app.router.url('new_post')
+     * => /posts/new
+     * app.router.url('edit_post', { id: 1 })
+     * => /posts/1/edit
+     * ```
+     * @return {Router} return route object.
+     * @since 1.0.0
+     */
+    resources(prefix: string, controller: string | ResourcesController): Router;
+    resources(prefix: string, middleware: MiddlewareFunc, controller: string | ResourcesController): Router;
+    resources(name: string, prefix: string, controller: string | ResourcesController): Router;
+    resources(name: string, prefix: string, middleware: MiddlewareFunc, controller: string | ResourcesController): Router;
+    /**
+     * @param {String} name - Router name
+     * @param {Object} params - more parameters
+     * @example
+     * ```js
+     * router.url('edit_post', { id: 1, name: 'foo', page: 2 })
+     * => /posts/1/edit?name=foo&page=2
+     * router.url('posts', { name: 'foo&1', page: 2 })
+     * => /posts?name=foo%261&page=2
+     * ```
+     * @return {String} url by path name and query params.
+     * @since 1.0.0
+     */
+    url(name: string, params?: Record<string, string | number | (string | number)[]>): string;
+    /**
+     * @alias to url()
+     */
+    pathFor(name: string, params?: Record<string, string | number | (string | number)[]>): string;
+}
+export {};

package/dist/esm/EggRouter.js

@@ -0,0 +1,228 @@
+import assert from 'node:assert';
+import { encodeURIComponent as safeEncodeURIComponent } from 'utility';
+import inflection from 'inflection';
+import methods from 'methods';
+import { Router } from './Router.js';
+const REST_MAP = {
+    index: {
+        suffix: '',
+        method: 'GET',
+    },
+    new: {
+        namePrefix: 'new_',
+        member: true,
+        suffix: 'new',
+        method: 'GET',
+    },
+    create: {
+        suffix: '',
+        method: 'POST',
+    },
+    show: {
+        member: true,
+        suffix: ':id',
+        method: 'GET',
+    },
+    edit: {
+        member: true,
+        namePrefix: 'edit_',
+        suffix: ':id/edit',
+        method: 'GET',
+    },
+    update: {
+        member: true,
+        namePrefix: '',
+        suffix: ':id',
+        method: ['PATCH', 'PUT'],
+    },
+    destroy: {
+        member: true,
+        namePrefix: 'destroy_',
+        suffix: ':id',
+        method: 'DELETE',
+    },
+};
+/**
+ * FIXME: move these patch into @eggjs/router
+ */
+export class EggRouter extends Router {
+    app;
+    /**
+     * @class
+     * @param {Object} opts - Router options.
+     * @param {Application} app - Application object.
+     */
+    constructor(opts, app) {
+        super(opts);
+        this.app = app;
+    }
+    verb(method, nameOrPath, pathOrMiddleware, ...middleware) {
+        const { path, middlewares, options } = this._formatRouteParams(nameOrPath, pathOrMiddleware, middleware);
+        if (typeof method === 'string') {
+            method = [method];
+        }
+        this.register(path, method, middlewares, options);
+        return this;
+    }
+    head(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('head', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    options(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('options', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    get(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('get', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    put(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('put', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    patch(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('patch', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    post(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('post', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    delete(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb('delete', nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    all(nameOrPath, pathOrMiddleware, ...middlewares) {
+        return this.verb(methods, nameOrPath, pathOrMiddleware, ...middlewares);
+    }
+    register(path, methods, middleware, opts) {
+        // patch register to support generator function middleware and string controller
+        middleware = Array.isArray(middleware) ? middleware : [middleware];
+        const middlewares = convertMiddlewares(middleware, this.app);
+        return super.register(path, methods, middlewares, opts);
+    }
+    resources(nameOrPath, pathOrMiddleware, ...middleware) {
+        const { path, middlewares, options } = this._formatRouteParams(nameOrPath, pathOrMiddleware, middleware);
+        // last argument is Controller object
+        const controller = resolveController(middlewares.pop(), this.app);
+        for (const key in REST_MAP) {
+            const action = controller[key];
+            if (!action)
+                continue;
+            const opts = REST_MAP[key];
+            let routeName;
+            if (opts.member) {
+                routeName = inflection.singularize(options.name ?? '');
+            }
+            else {
+                routeName = inflection.pluralize(options.name ?? '');
+            }
+            if (opts.namePrefix) {
+                routeName = opts.namePrefix + routeName;
+            }
+            const prefix = path.replace(/\/$/, '');
+            const urlPath = opts.suffix ? `${prefix}/${opts.suffix}` : prefix;
+            const method = Array.isArray(opts.method) ? opts.method : [opts.method];
+            this.register(urlPath, method, middlewares.concat(action), { name: routeName });
+        }
+        return this;
+    }
+    /**
+     * @param {String} name - Router name
+     * @param {Object} params - more parameters
+     * @example
+     * ```js
+     * router.url('edit_post', { id: 1, name: 'foo', page: 2 })
+     * => /posts/1/edit?name=foo&page=2
+     * router.url('posts', { name: 'foo&1', page: 2 })
+     * => /posts?name=foo%261&page=2
+     * ```
+     * @return {String} url by path name and query params.
+     * @since 1.0.0
+     */
+    url(name, params) {
+        const route = this.route(name);
+        if (!route)
+            return '';
+        const args = params;
+        let url = route.path;
+        assert(!(url instanceof RegExp), `Can't get the url for regExp ${url} for by name '${name}'`);
+        const queries = [];
+        if (typeof args === 'object' && args !== null) {
+            const replacedParams = [];
+            url = url.replace(/:([a-zA-Z_]\w*)/g, ($0, key) => {
+                if (key in args) {
+                    const values = args[key];
+                    replacedParams.push(key);
+                    return safeEncodeURIComponent(Array.isArray(values) ? String(values[0]) : String(values));
+                }
+                return $0;
+            });
+            for (const key in args) {
+                if (replacedParams.includes(key)) {
+                    continue;
+                }
+                const values = args[key];
+                const encodedKey = safeEncodeURIComponent(key);
+                if (Array.isArray(values)) {
+                    for (const val of values) {
+                        queries.push(`${encodedKey}=${safeEncodeURIComponent(String(val))}`);
+                    }
+                }
+                else {
+                    queries.push(`${encodedKey}=${safeEncodeURIComponent(String(values))}`);
+                }
+            }
+        }
+        if (queries.length > 0) {
+            const queryStr = queries.join('&');
+            if (!url.includes('?')) {
+                url = `${url}?${queryStr}`;
+            }
+            else {
+                url = `${url}&${queryStr}`;
+            }
+        }
+        return url;
+    }
+    /**
+     * @alias to url()
+     */
+    pathFor(name, params) {
+        return this.url(name, params);
+    }
+}
+/**
+ * resolve controller from string to function
+ * @param {String|Function} controller input controller
+ * @param {Application} app egg application instance
+ */
+function resolveController(controller, app) {
+    if (typeof controller === 'string') {
+        // resolveController('foo.bar.Home', app)
+        const actions = controller.split('.');
+        let obj = app.controller;
+        actions.forEach(key => {
+            obj = obj[key];
+            if (!obj)
+                throw new Error(`app.controller.${controller} not exists`);
+        });
+        controller = obj;
+    }
+    // ensure controller is exists
+    if (!controller)
+        throw new Error('controller not exists');
+    return controller;
+}
+/**
+ * 1. ensure controller(last argument) support string
+ * - [url, controller]: app.get('/home', 'home');
+ * - [name, url, controller(string)]: app.get('posts', '/posts', 'posts.list');
+ * - [name, url, controller]: app.get('posts', '/posts', app.controller.posts.list);
+ * - [name, url(regexp), controller]: app.get('regRouter', /\/home\/index/, 'home.index');
+ * - [name, url, middleware, [...], controller]: `app.get(/user/:id', hasLogin, canGetUser, 'user.show');`
+ *
+ * 2. make middleware support generator function
+ *
+ * @param  {Array} middlewares middlewares and controller(last middleware)
+ * @param  {Application} app  egg application instance
+ */
+function convertMiddlewares(middlewares, app) {
+    // ensure controller is resolved
+    const controller = resolveController(middlewares.pop(), app);
+    return [...middlewares, controller];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRWdnUm91dGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL0VnZ1JvdXRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLE1BQU0sTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxFQUFFLGtCQUFrQixJQUFJLHNCQUFzQixFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3ZFLE9BQU8sVUFBVSxNQUFNLFlBQVksQ0FBQztBQUNwQyxPQUFPLE9BQU8sTUFBTSxTQUFTLENBQUM7QUFDOUIsT0FBTyxFQUFtQixNQUFNLEVBQStCLE1BQU0sYUFBYSxDQUFDO0FBVW5GLE1BQU0sUUFBUSxHQUFtQztJQUMvQyxLQUFLLEVBQUU7UUFDTCxNQUFNLEVBQUUsRUFBRTtRQUNWLE1BQU0sRUFBRSxLQUFLO0tBQ2Q7SUFDRCxHQUFHLEVBQUU7UUFDSCxVQUFVLEVBQUUsTUFBTTtRQUNsQixNQUFNLEVBQUUsSUFBSTtRQUNaLE1BQU0sRUFBRSxLQUFLO1FBQ2IsTUFBTSxFQUFFLEtBQUs7S0FDZDtJQUNELE1BQU0sRUFBRTtRQUNOLE1BQU0sRUFBRSxFQUFFO1FBQ1YsTUFBTSxFQUFFLE1BQU07S0FDZjtJQUNELElBQUksRUFBRTtRQUNKLE1BQU0sRUFBRSxJQUFJO1FBQ1osTUFBTSxFQUFFLEtBQUs7UUFDYixNQUFNLEVBQUUsS0FBSztLQUNkO0lBQ0QsSUFBSSxFQUFFO1FBQ0osTUFBTSxFQUFFLElBQUk7UUFDWixVQUFVLEVBQUUsT0FBTztRQUNuQixNQUFNLEVBQUUsVUFBVTtRQUNsQixNQUFNLEVBQUUsS0FBSztLQUNkO0lBQ0QsTUFBTSxFQUFFO1FBQ04sTUFBTSxFQUFFLElBQUk7UUFDWixVQUFVLEVBQUUsRUFBRTtRQUNkLE1BQU0sRUFBRSxLQUFLO1FBQ2IsTUFBTSxFQUFFLENBQUUsT0FBTyxFQUFFLEtBQUssQ0FBRTtLQUMzQjtJQUNELE9BQU8sRUFBRTtRQUNQLE1BQU0sRUFBRSxJQUFJO1FBQ1osVUFBVSxFQUFFLFVB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

package/dist/esm/Layer.d.ts

@@ -0,0 +1,114 @@
+import { type Key } from 'path-to-regexp';
+import type { MiddlewareFunc, MiddlewareFuncWithParamProperty, ParamMiddlewareFunc } from './types.js';
+export interface LayerOptions {
+    prefix?: string;
+    /** route name */
+    name?: string;
+    /** case sensitive (default: false) */
+    sensitive?: boolean;
+    /** require the trailing slash (default: false) */
+    strict?: boolean;
+    ignoreCaptures?: boolean;
+    end?: boolean;
+}
+export interface LayerURLOptions {
+    query?: string | object;
+}
+export declare class Layer {
+    readonly opts: LayerOptions;
+    readonly name?: string;
+    readonly methods: string[];
+    readonly stack: MiddlewareFuncWithParamProperty[];
+    path: string | RegExp;
+    regexp: RegExp;
+    paramNames: Key[];
+    /**
+     * Initialize a new routing Layer with given `method`, `path`, and `middleware`.
+     *
+     * @param {String|RegExp} path Path string or regular expression.
+     * @param {Array} methods Array of HTTP verbs.
+     * @param {Array|Function} middlewares Layer callback/middleware or series of.
+     * @param {Object=} opts optional params
+     * @param {String=} opts.name route name
+     * @param {String=} opts.sensitive case sensitive (default: false)
+     * @param {String=} opts.strict require the trailing slash (default: false)
+     * @private
+     */
+    constructor(path: string | RegExp, methods: string[], middlewares: MiddlewareFunc | MiddlewareFunc[], opts?: LayerOptions | string);
+    /**
+     * Returns whether request `path` matches route.
+     *
+     * @param {String} path path string
+     * @return {Boolean} matched or not
+     * @private
+     */
+    match(path: string): boolean;
+    /**
+     * Returns map of URL parameters for given `path` and `paramNames`.
+     *
+     * @param {String} _path path string
+     * @param {Array.<String>} captures captures strings
+     * @param {Object=} [existingParams] existing params
+     * @return {Object} params object
+     * @private
+     */
+    params(_path: string, captures: Array<string>, existingParams?: Record<string, string>): Record<string, string>;
+    /**
+     * Returns array of regexp url path captures.
+     *
+     * @param {String} path path string
+     * @return {Array.<String>} captures strings
+     * @private
+     */
+    captures(path: string): Array<string>;
+    /**
+     * Generate URL for route using given `params`.
+     *
+     * @example
+     *
+     * ```javascript
+     * var route = new Layer(['GET'], '/users/:id', fn);
+     *
+     * route.url(123); // => "/users/123"
+     * route.url('123'); // => "/users/123"
+     * route.url({ id: 123 }); // => "/users/123"
+     * ```
+     *
+     * @param {Object} params url parameters
+     * @param {Object} paramsOrOptions optional parameters
+     * @return {String} url string
+     * @private
+     */
+    url(params?: string | number | object, ...paramsOrOptions: (string | number | object | LayerURLOptions)[]): string;
+    /**
+     * Run validations on route named parameters.
+     *
+     * @example
+     *
+     * ```javascript
+     * router
+     *   .param('user', function (id, ctx, next) {
+     *     ctx.user = users[id];
+     *     if (!user) return ctx.status = 404;
+     *     next();
+     *   })
+     *   .get('/users/:user', function (ctx, next) {
+     *     ctx.body = ctx.user;
+     *   });
+     * ```
+     *
+     * @param {String} param param string
+     * @param {Function} fn middleware function
+     * @return {Layer} layer instance
+     * @private
+     */
+    param(param: string, fn: ParamMiddlewareFunc): Layer;
+    /**
+     * Prefix route path.
+     *
+     * @param {String} prefix prefix string
+     * @return {Layer} layer instance
+     * @private
+     */
+    setPrefix(prefix: string): Layer;
+}