@weifuwujs/weifuwu 0.9.0

package/dist/group.d.ts

@@ -0,0 +1,32 @@
+import type { App } from './app.ts';
+import type { Context, MountableApi, MountOptions, OnRegistrar, RouteRegistrar } from './types.ts';
+import type { WsRegistrar } from './websocket/types.ts';
+/**
+ * 路由分组：为一组路由统一添加路径前缀。
+ *
+ * ```ts
+ * app.group('/api', (api) => {
+ *   api.get('/users/:id', (req, ctx) => json(ctx.params.id)) // GET /api/users/:id
+ * })
+ * ```
+ */
+export declare class Group<C extends Context = Context, Prefix extends string = ''> {
+    #private;
+    constructor(app: App<C>, prefix: string);
+    get: RouteRegistrar<C, Prefix, this>;
+    post: RouteRegistrar<C, Prefix, this>;
+    put: RouteRegistrar<C, Prefix, this>;
+    patch: RouteRegistrar<C, Prefix, this>;
+    delete: RouteRegistrar<C, Prefix, this>;
+    head: RouteRegistrar<C, Prefix, this>;
+    options: RouteRegistrar<C, Prefix, this>;
+    all: RouteRegistrar<C, Prefix, this>;
+    on: OnRegistrar<C, Prefix, this>;
+    /** 在分组内注册 WebSocket 路由，前缀同样生效 */
+    ws: WsRegistrar<C, Prefix, this>;
+    /** 在分组内挂载单源 API，前缀生效 */
+    mount(api: MountableApi<C>, options?: MountOptions): this;
+    /** 嵌套分组，前缀会继续叠加 */
+    group<P extends string>(prefix: P, define: (group: Group<C, `${Prefix}${P}`>) => void): this;
+}
+//# sourceMappingURL=group.d.ts.map

package/dist/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAGnC,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;;;;GAQG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,MAAM,SAAS,MAAM,GAAG,EAAE;;gBAI5D,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM;IAKvC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CACF;IAElC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CACF;IAEnC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CACF;IAElC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CACF;IAEpC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAGC;IAExC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CACF;IAEnC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAGC;IAEzC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAGnC;IAED,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAIM;IAEtC,iCAAiC;IACjC,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAM/B;IAED,wBAAwB;IACxB,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAiB7D,mBAAmB;IACnB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpB,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,GACjD,IAAI;CAYR"}

package/dist/group.js

@@ -0,0 +1,66 @@
+import { METHODS } from "./methods.js";
+import { joinPaths } from "./path.js";
+/**
+ * 路由分组：为一组路由统一添加路径前缀。
+ *
+ * ```ts
+ * app.group('/api', (api) => {
+ *   api.get('/users/:id', (req, ctx) => json(ctx.params.id)) // GET /api/users/:id
+ * })
+ * ```
+ */
+export class Group {
+    #app;
+    #prefix;
+    constructor(app, prefix) {
+        this.#app = app;
+        this.#prefix = prefix;
+    }
+    get = (path, ...handlers) => this.#add('GET', path, handlers);
+    post = (path, ...handlers) => this.#add('POST', path, handlers);
+    put = (path, ...handlers) => this.#add('PUT', path, handlers);
+    patch = (path, ...handlers) => this.#add('PATCH', path, handlers);
+    delete = (path, ...handlers) => this.#add('DELETE', path, handlers);
+    head = (path, ...handlers) => this.#add('HEAD', path, handlers);
+    options = (path, ...handlers) => this.#add('OPTIONS', path, handlers);
+    all = (path, ...handlers) => {
+        for (const method of METHODS)
+            this.#add(method, path, handlers);
+        return this;
+    };
+    on = (method, path, ...handlers) => this.#add(method, path, handlers);
+    /** 在分组内注册 WebSocket 路由，前缀同样生效 */
+    ws = (path, ...args) => {
+        const app = this.#app;
+        app.ws(joinPaths(this.#prefix, path), ...args);
+        return this;
+    };
+    /** 在分组内挂载单源 API，前缀生效 */
+    mount(api, options = {}) {
+        if (options.rest !== false) {
+            for (const route of api.routes()) {
+                this.#add(route.method, route.path, [route.handler]);
+            }
+        }
+        if (typeof options.graphql === 'string') {
+            if (!api.graphqlHandler) {
+                throw new Error('This API does not provide a GraphQL handler');
+            }
+            const handler = api.graphqlHandler();
+            this.#add('GET', options.graphql, [handler]);
+            this.#add('POST', options.graphql, [handler]);
+        }
+        return this;
+    }
+    /** 嵌套分组，前缀会继续叠加 */
+    group(prefix, define) {
+        define(new Group(this.#app, joinPaths(this.#prefix, prefix)));
+        return this;
+    }
+    #add(method, path, handlers) {
+        const app = this.#app;
+        app.on(method, joinPaths(this.#prefix, path), ...handlers);
+        return this;
+    }
+}
+//# sourceMappingURL=group.js.map

package/dist/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAUrC;;;;;;;;GAQG;AACH,MAAM,OAAO,KAAK;IACP,IAAI,CAAQ;IACZ,OAAO,CAAQ;IAExB,YAAY,GAAW,EAAE,MAAc;QACrC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;QACf,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,GAAG,GAAoC,CAAC,IAAY,EAAE,GAAG,QAAe,EAAE,EAAE,CAC1E,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAElC,IAAI,GAAoC,CAAC,IAAY,EAAE,GAAG,QAAe,EAAE,EAAE,CAC3E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEnC,GAAG,GAAoC,CAAC,IAAY,EAAE,GAAG,QAAe,EAAE,EAAE,CAC1E,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAElC,KAAK,GAAoC,CAAC,IAAY,EAAE,GAAG,QAAe,EAAE,EAAE,CAC5E,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEpC,MAAM,GAAoC,CACxC,IAAY,EACZ,GAAG,QAAe,EAClB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAExC,IAAI,GAAoC,CAAC,IAAY,EAAE,GAAG,QAAe,EAAE,EAAE,CAC3E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEnC,OAAO,GAAoC,CACzC,IAAY,EACZ,GAAG,QAAe,EAClB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEzC,GAAG,GAAoC,CAAC,IAAY,EAAE,GAAG,QAAe,EAAE,EAAE;QAC1E,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC/D,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED,EAAE,GAAiC,CACjC,MAAc,EACd,IAAY,EACZ,GAAG,QAAe,EAClB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEtC,iCAAiC;IACjC,EAAE,GAAiC,CAAC,IAAY,EAAE,GAAG,IAAW,EAAE,EAAE;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,IAEhB,CAAA;QACD,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;QAC9C,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED,wBAAwB;IACxB,KAAK,CAAC,GAAoB,EAAE,UAAwB,EAAE;QACpD,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;YAChE,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,EAAE,CAAA;YACpC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;YAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;QAC/C,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mBAAmB;IACnB,KAAK,CACH,MAAS,EACT,MAAkD;QAElD,MAAM,CAAC,IAAI,KAAK,CAAqB,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QACjF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,IAAY,EAAE,QAA4B;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAEhB,CAAA;QACD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAA;QAC1D,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/helpers.d.ts

@@ -0,0 +1,37 @@
+export interface HttpErrorOptions {
+    /** 是否把 message 暴露给客户端（默认 5xx 不暴露、4xx 暴露） */
+    expose?: boolean;
+    headers?: ConstructorParameters<typeof Headers>[0];
+    cause?: unknown;
+}
+/**
+ * 抛出后由框架统一转换为对应的 HTTP 响应。
+ *
+ * ```ts
+ * app.get('/users/:id', async (req, ctx) => {
+ *   const user = await db.find(ctx.params.id)
+ *   if (!user) throw new HttpError(404, 'User not found')
+ *   return json(user)
+ * })
+ * ```
+ */
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly expose: boolean;
+    readonly headers: ConstructorParameters<typeof Headers>[0] | undefined;
+    constructor(status: number, message?: string, options?: HttpErrorOptions);
+    toResponse(): Response;
+}
+/**
+ * 可以外发给客户端的错误文案：`expose=false`（默认 5xx）退化为状态文案。
+ * HTTP 响应与 GraphQL 错误共用这一条规则。
+ */
+export declare function publicErrorMessage(error: HttpError): string;
+export declare function getStatusText(status: number): string;
+/** `Response.json` 的封装，统一带上 `charset=utf-8` */
+export declare function json(data: unknown, init?: ResponseInit): Response;
+export declare function text(body: string, init?: ResponseInit): Response;
+export declare function html(body: string, init?: ResponseInit): Response;
+export declare function redirect(location: string, status?: 301 | 302 | 303 | 307 | 308): Response;
+export declare function noContent(init?: ResponseInit): Response;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IAClD,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;gBAE1D,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAW5E,UAAU,IAAI,QAAQ;CAMvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,+CAA+C;AAC/C,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,YAAiB,GAAG,QAAQ,CAOrE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,QAAQ,CAMpE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,QAAQ,CAMpE;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS,GACxC,QAAQ,CAEV;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,YAAiB,GAAG,QAAQ,CAE3D"}

package/dist/helpers.js

@@ -0,0 +1,101 @@
+const STATUS_TEXT = {
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    402: 'Payment Required',
+    403: 'Forbidden',
+    404: 'Not Found',
+    405: 'Method Not Allowed',
+    406: 'Not Acceptable',
+    408: 'Request Timeout',
+    409: 'Conflict',
+    410: 'Gone',
+    411: 'Length Required',
+    412: 'Precondition Failed',
+    413: 'Payload Too Large',
+    415: 'Unsupported Media Type',
+    418: "I'm a Teapot",
+    422: 'Unprocessable Entity',
+    423: 'Locked',
+    424: 'Failed Dependency',
+    425: 'Too Early',
+    426: 'Upgrade Required',
+    428: 'Precondition Required',
+    429: 'Too Many Requests',
+    431: 'Request Header Fields Too Large',
+    451: 'Unavailable For Legal Reasons',
+    500: 'Internal Server Error',
+    501: 'Not Implemented',
+    502: 'Bad Gateway',
+    503: 'Service Unavailable',
+    504: 'Gateway Timeout',
+    505: 'HTTP Version Not Supported',
+};
+/**
+ * 抛出后由框架统一转换为对应的 HTTP 响应。
+ *
+ * ```ts
+ * app.get('/users/:id', async (req, ctx) => {
+ *   const user = await db.find(ctx.params.id)
+ *   if (!user) throw new HttpError(404, 'User not found')
+ *   return json(user)
+ * })
+ * ```
+ */
+export class HttpError extends Error {
+    status;
+    expose;
+    headers;
+    constructor(status, message, options = {}) {
+        super(message ?? STATUS_TEXT[status] ?? `HTTP ${status}`, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'HttpError';
+        this.status = status;
+        this.expose = options.expose ?? status < 500;
+        this.headers = options.headers;
+    }
+    toResponse() {
+        return new Response(publicErrorMessage(this), {
+            status: this.status,
+            headers: this.headers,
+        });
+    }
+}
+/**
+ * 可以外发给客户端的错误文案：`expose=false`（默认 5xx）退化为状态文案。
+ * HTTP 响应与 GraphQL 错误共用这一条规则。
+ */
+export function publicErrorMessage(error) {
+    return error.expose ? error.message : STATUS_TEXT[error.status] ?? 'Error';
+}
+export function getStatusText(status) {
+    return STATUS_TEXT[status] ?? '';
+}
+/** `Response.json` 的封装，统一带上 `charset=utf-8` */
+export function json(data, init = {}) {
+    const body = data === undefined ? '' : JSON.stringify(data);
+    const headers = new Headers(init.headers);
+    if (!headers.has('content-type')) {
+        headers.set('content-type', 'application/json; charset=utf-8');
+    }
+    return new Response(body, { ...init, headers });
+}
+export function text(body, init = {}) {
+    const headers = new Headers(init.headers);
+    if (!headers.has('content-type')) {
+        headers.set('content-type', 'text/plain; charset=utf-8');
+    }
+    return new Response(body, { ...init, headers });
+}
+export function html(body, init = {}) {
+    const headers = new Headers(init.headers);
+    if (!headers.has('content-type')) {
+        headers.set('content-type', 'text/html; charset=utf-8');
+    }
+    return new Response(body, { ...init, headers });
+}
+export function redirect(location, status = 302) {
+    return new Response(null, { status, headers: { location } });
+}
+export function noContent(init = {}) {
+    return new Response(null, { ...init, status: init.status ?? 204 });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,4BAA4B;CAClC,CAAA;AASD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,MAAM,CAAQ;IACd,MAAM,CAAS;IACf,OAAO,CAAsD;IAEtE,YAAY,MAAc,EAAE,OAAgB,EAAE,UAA4B,EAAE;QAC1E,KAAK,CACH,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,QAAQ,MAAM,EAAE,EAClD,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CACnE,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,GAAG,GAAG,CAAA;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAChC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;YAC5C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAA;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;AAClC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,IAAI,CAAC,IAAa,EAAE,OAAqB,EAAE;IACzD,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAqB,EAAE;IACxD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAqB,EAAE;IACxD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,QAAgB,EAChB,SAAsC,GAAG;IAEzC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAqB,EAAE;IAC/C,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAA;AACpE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { App, createApp } from './app.ts';
+export { resource } from './resources.ts';
+export type { Resource, ResourceOptions } from './resources.ts';
+export { Group } from './group.ts';
+export { compose } from './compose.ts';
+export { Router } from './router.ts';
+export type { RouteEntry, RouteMatch } from './router.ts';
+export { HttpError, json, publicErrorMessage, text, html, redirect, noContent, } from './helpers.ts';
+export type { HttpErrorOptions } from './helpers.ts';
+export { serve, toNodeHandler, toUpgradeHandler, attachToServer } from './node.ts';
+export type { FetchApp, NodeHandlerOptions, ServeOptions, UpgradeApp } from './node.ts';
+export { acceptWebSocket, CLOSE_CODE, isValidCloseCode, validateUpgradeRequest, WebSocketConnection, } from './websocket/index.ts';
+export type { AcceptOptions, WebSocketHandler, WebSocketHandlers, WebSocketLifecycle, WebSocketMessage, WebSocketMiddleware, WebSocketNext, WebSocketOptions, WebSocketReadyState, WsRegistrar, } from './websocket/index.ts';
+export type { Context, ContextWithParams, ErrorHandler, Handler, HttpMethod, Middleware, MountableApi, MountableRoute, MountOptions, Next, NotFoundHandler, OnRegistrar, PathParams, RouteHandlers, RouteMiddleware, RouteRegistrar, } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EACL,SAAS,EACT,IAAI,EACJ,kBAAkB,EAClB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAClF,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACvF,OAAO,EACL,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,IAAI,EACJ,eAAe,EACf,WAAW,EACX,UAAU,EACV,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { App, createApp } from "./app.js";
+export { resource } from "./resources.js";
+export { Group } from "./group.js";
+export { compose } from "./compose.js";
+export { Router } from "./router.js";
+export { HttpError, json, publicErrorMessage, text, html, redirect, noContent, } from "./helpers.js";
+export { serve, toNodeHandler, toUpgradeHandler, attachToServer } from "./node.js";
+export { acceptWebSocket, CLOSE_CODE, isValidCloseCode, validateUpgradeRequest, WebSocketConnection, } from "./websocket/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EACL,SAAS,EACT,IAAI,EACJ,kBAAkB,EAClB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAElF,OAAO,EACL,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA"}

package/dist/ioredis.d.ts

@@ -0,0 +1,16 @@
+import type { Redis, RedisOptions } from 'ioredis';
+import { type Resource } from './resources.ts';
+export type { Redis, RedisOptions };
+/**
+ * 注入 `ctx.redis`（ioredis 客户端）的中间件。
+ *
+ * - 首次请求时懒加载 `ioredis` 并连接
+ * - `app.close()` / CLI SIGTERM 时 `quit()`（失败则 `disconnect()`）
+ * - 默认连接串：`process.env.REDIS_URL`（缺省时用 ioredis 默认 localhost:6379）
+ *
+ * ```ts
+ * app.use(redis()) // ctx.redis: Redis
+ * ```
+ */
+export declare function redis(urlOrOptions?: string | RedisOptions, options?: RedisOptions): Resource<'redis', Redis>;
+//# sourceMappingURL=ioredis.d.ts.map

package/dist/ioredis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ioredis.d.ts","sourceRoot":"","sources":["../src/ioredis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAExD,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;AAEnC;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CACnB,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,EACpC,OAAO,CAAC,EAAE,YAAY,GACrB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAoC1B"}

package/dist/ioredis.js

@@ -0,0 +1,42 @@
+import { resource } from "./resources.js";
+/**
+ * 注入 `ctx.redis`（ioredis 客户端）的中间件。
+ *
+ * - 首次请求时懒加载 `ioredis` 并连接
+ * - `app.close()` / CLI SIGTERM 时 `quit()`（失败则 `disconnect()`）
+ * - 默认连接串：`process.env.REDIS_URL`（缺省时用 ioredis 默认 localhost:6379）
+ *
+ * ```ts
+ * app.use(redis()) // ctx.redis: Redis
+ * ```
+ */
+export function redis(urlOrOptions, options) {
+    return resource('redis', async () => {
+        const { default: RedisClient } = (await import('ioredis'));
+        if (typeof urlOrOptions === 'string') {
+            return new RedisClient(urlOrOptions, options);
+        }
+        const url = process.env.REDIS_URL;
+        if (url)
+            return new RedisClient(url, urlOrOptions);
+        return new RedisClient(urlOrOptions ?? {});
+    }, {
+        close: (client) => new Promise((resolveClose) => {
+            if (client.status === 'end')
+                return resolveClose();
+            const timer = setTimeout(resolveClose, 1_000);
+            const finish = () => {
+                clearTimeout(timer);
+                resolveClose();
+            };
+            client.once('end', finish);
+            // ioredis v6 的 quit() 在 end 事件之前 resolve，所以等事件本身；
+            // quit 失败时降级 disconnect。
+            client.quit().catch(() => {
+                client.disconnect();
+                finish();
+            });
+        }),
+    });
+}
+//# sourceMappingURL=ioredis.js.map

package/dist/ioredis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ioredis.js","sourceRoot":"","sources":["../src/ioredis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAA;AAIxD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CACnB,YAAoC,EACpC,OAAsB;IAEtB,OAAO,QAAQ,CACb,OAAO,EACP,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAKxD,CAAA;QACD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,IAAI,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC/C,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAA;QACjC,IAAI,GAAG;YAAE,OAAO,IAAI,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QAClD,OAAO,IAAI,WAAW,CAAC,YAAY,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC,EACD;QACE,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAChB,IAAI,OAAO,CAAO,CAAC,YAAY,EAAE,EAAE;YACjC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;gBAAE,OAAO,YAAY,EAAE,CAAA;YAClD,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;YAC7C,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,YAAY,EAAE,CAAA;YAChB,CAAC,CAAA;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC1B,kDAAkD;YAClD,yBAAyB;YACzB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBACvB,MAAM,CAAC,UAAU,EAAE,CAAA;gBACnB,MAAM,EAAE,CAAA;YACV,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC;KACL,CACF,CAAA;AACH,CAAC"}

package/dist/methods.d.ts

@@ -0,0 +1,3 @@
+import type { HttpMethod } from './types.ts';
+export declare const METHODS: readonly HttpMethod[];
+//# sourceMappingURL=methods.d.ts.map

package/dist/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,eAAO,MAAM,OAAO,EAAE,SAAS,UAAU,EAQxC,CAAA"}

package/dist/methods.js

@@ -0,0 +1,10 @@
+export const METHODS = [
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+    'HEAD',
+    'OPTIONS',
+];
+//# sourceMappingURL=methods.js.map

package/dist/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAA0B;IAC5C,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;CACV,CAAA"}

package/dist/middleware/cors.d.ts

@@ -0,0 +1,24 @@
+import type { Middleware } from '../types.ts';
+export type CorsOrigin = string | string[] | ((origin: string) => string | null | undefined);
+export interface CorsOptions {
+    /**
+     * 允许的来源。默认 `'*'`；
+     * 当 `credentials: true` 且为 `'*'` 时会回显请求的 Origin。
+     */
+    origin?: CorsOrigin;
+    methods?: string | string[];
+    allowedHeaders?: string | string[];
+    exposedHeaders?: string | string[];
+    credentials?: boolean;
+    /** 预检结果缓存秒数 */
+    maxAge?: number;
+}
+/**
+ * CORS 中间件，自动处理预检请求（OPTIONS + Access-Control-Request-Method）。
+ *
+ * ```ts
+ * app.use(cors({ origin: ['https://a.com'], credentials: true }))
+ * ```
+ */
+export declare function cors(options?: CorsOptions): Middleware;
+//# sourceMappingURL=cors.d.ts.map

package/dist/middleware/cors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../src/middleware/cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,EAAE,GACR,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEnD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAClC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAClC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA6C1D"}

package/dist/middleware/cors.js

@@ -0,0 +1,77 @@
+const DEFAULT_METHODS = 'GET,POST,PUT,PATCH,DELETE,HEAD,OPTIONS';
+/**
+ * CORS 中间件，自动处理预检请求（OPTIONS + Access-Control-Request-Method）。
+ *
+ * ```ts
+ * app.use(cors({ origin: ['https://a.com'], credentials: true }))
+ * ```
+ */
+export function cors(options = {}) {
+    const methods = toHeaderValue(options.methods) ?? DEFAULT_METHODS;
+    const allowedHeaders = toHeaderValue(options.allowedHeaders);
+    const exposedHeaders = toHeaderValue(options.exposedHeaders);
+    const credentials = options.credentials === true;
+    const maxAge = options.maxAge;
+    return async (req, ctx, next) => {
+        const requestOrigin = req.headers.get('origin');
+        const allowOrigin = resolveOrigin(options.origin, requestOrigin, credentials);
+        const isPreflight = req.method === 'OPTIONS' &&
+            req.headers.has('access-control-request-method');
+        if (isPreflight) {
+            const headers = new Headers();
+            if (allowOrigin)
+                headers.set('access-control-allow-origin', allowOrigin);
+            headers.set('access-control-allow-methods', methods);
+            const requestedHeaders = req.headers.get('access-control-request-headers');
+            if (allowedHeaders)
+                headers.set('access-control-allow-headers', allowedHeaders);
+            else if (requestedHeaders)
+                headers.set('access-control-allow-headers', requestedHeaders);
+            if (exposedHeaders)
+                headers.set('access-control-expose-headers', exposedHeaders);
+            if (credentials)
+                headers.set('access-control-allow-credentials', 'true');
+            if (maxAge !== undefined)
+                headers.set('access-control-max-age', String(maxAge));
+            appendVary(headers, allowOrigin);
+            return new Response(null, { status: 204, headers });
+        }
+        const response = await next(req, ctx);
+        if (!allowOrigin)
+            return response;
+        const headers = new Headers(response.headers);
+        headers.set('access-control-allow-origin', allowOrigin);
+        if (credentials)
+            headers.set('access-control-allow-credentials', 'true');
+        if (exposedHeaders)
+            headers.set('access-control-expose-headers', exposedHeaders);
+        appendVary(headers, allowOrigin);
+        return new Response(response.body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+        });
+    };
+}
+function resolveOrigin(origin, requestOrigin, credentials) {
+    if (origin === undefined) {
+        return credentials ? requestOrigin : '*';
+    }
+    if (typeof origin === 'string') {
+        if (origin === '*' && credentials)
+            return requestOrigin;
+        return origin;
+    }
+    if (Array.isArray(origin)) {
+        return requestOrigin && origin.includes(requestOrigin) ? requestOrigin : null;
+    }
+    return requestOrigin ? origin(requestOrigin) ?? null : null;
+}
+function toHeaderValue(value) {
+    return Array.isArray(value) ? value.join(',') : value;
+}
+function appendVary(headers, allowOrigin) {
+    if (allowOrigin !== '*')
+        headers.append('vary', 'Origin');
+}
+//# sourceMappingURL=cors.js.map

package/dist/middleware/cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../src/middleware/cors.ts"],"names":[],"mappings":"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"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,7 @@
+export { logger } from './logger.ts';
+export type { LogInfo, LoggerOptions } from './logger.ts';
+export { cors } from './cors.ts';
+export type { CorsOptions, CorsOrigin } from './cors.ts';
+export { serveStatic } from './static.ts';
+export type { ServeStaticOptions } from './static.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/middleware/index.js

@@ -0,0 +1,4 @@
+export { logger } from "./logger.js";
+export { cors } from "./cors.js";
+export { serveStatic } from "./static.js";
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/middleware/logger.d.ts

@@ -0,0 +1,27 @@
+import type { Middleware } from '../types.ts';
+export interface LogInfo {
+    method: string;
+    path: string;
+    status: number;
+    /** 毫秒 */
+    duration: number;
+    request: Request;
+    response?: Response;
+    /** handler 抛出的原始错误（仅失败时有值） */
+    error?: unknown;
+}
+export interface LoggerOptions {
+    /** 输出函数，默认 `console.log` */
+    log?: (message: string) => void;
+    /** 自定义日志格式 */
+    format?: (info: LogInfo) => string;
+}
+/**
+ * 访问日志中间件。
+ *
+ * ```ts
+ * app.use(logger())
+ * ```
+ */
+export declare function logger(options?: LoggerOptions): Middleware;
+//# sourceMappingURL=logger.d.ts.map

package/dist/middleware/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,cAAc;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAA;CACnC;AAKD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,UAAU,CAmC9D"}

package/dist/middleware/logger.js

@@ -0,0 +1,48 @@
+const defaultFormat = (info) => `${info.method} ${info.path} ${info.status} ${info.duration.toFixed(1)}ms`;
+/**
+ * 访问日志中间件。
+ *
+ * ```ts
+ * app.use(logger())
+ * ```
+ */
+export function logger(options = {}) {
+    const log = options.log ?? ((message) => console.log(message));
+    const format = options.format ?? defaultFormat;
+    return async (req, ctx, next) => {
+        const start = performance.now();
+        const path = pathOf(req.url);
+        try {
+            const response = await next(req, ctx);
+            log(format({
+                method: req.method,
+                path,
+                status: response.status,
+                duration: performance.now() - start,
+                request: req,
+                response,
+            }));
+            return response;
+        }
+        catch (error) {
+            log(format({
+                method: req.method,
+                path,
+                status: 500,
+                duration: performance.now() - start,
+                request: req,
+                error,
+            }));
+            throw error;
+        }
+    };
+}
+function pathOf(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/middleware/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAqBA,MAAM,aAAa,GAAG,CAAC,IAAa,EAAU,EAAE,CAC9C,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAA;IAE9C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE5B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YACrC,GAAG,CACD,MAAM,CAAC;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI;gBACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;gBACnC,OAAO,EAAE,GAAG;gBACZ,QAAQ;aACT,CAAC,CACH,CAAA;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CACD,MAAM,CAAC;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI;gBACJ,MAAM,EAAE,GAAG;gBACX,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;gBACnC,OAAO,EAAE,GAAG;gBACZ,KAAK;aACN,CAAC,CACH,CAAA;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC"}