@weifuwujs/weifuwu 0.9.0

package/dist/middleware/static.d.ts

@@ -0,0 +1,27 @@
+import type { Middleware } from '../types.ts';
+export interface ServeStaticOptions {
+    /** 目录默认文件，设为 `false` 关闭。默认 `'index.html'` */
+    index?: string | false;
+    /** 文件不存在时回退到的文件（SPA 常用 `'index.html'`） */
+    fallback?: string;
+    /** Cache-Control: max-age 秒数 */
+    maxAge?: number;
+    /** 追加 `immutable` 指令（配合带 hash 的文件名使用） */
+    immutable?: boolean;
+    /** 是否处理点文件，默认 `'ignore'`（交给后续路由） */
+    dotfiles?: 'allow' | 'ignore' | 'deny';
+    /** 附加响应头 */
+    headers?: Record<string, string>;
+    /** 是否生成 ETag，默认 `true` */
+    etag?: boolean;
+}
+/**
+ * 静态文件中间件。未命中时调用 `next()`，因此可以和 API 路由共存。
+ *
+ * ```ts
+ * app.use(serveStatic('./public'))
+ * app.use('/assets', serveStatic('./dist/assets', { maxAge: 31536000, immutable: true }))
+ * ```
+ */
+export declare function serveStatic(root: string, options?: ServeStaticOptions): Middleware;
+//# sourceMappingURL=static.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/middleware/static.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AA2C7C,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IACtC,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,UAAU,CAkFZ"}

package/dist/middleware/static.js

@@ -0,0 +1,150 @@
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { extname, resolve, sep } from 'node:path';
+import { Readable } from 'node:stream';
+const MIME_TYPES = {
+    '.aac': 'audio/aac',
+    '.avif': 'image/avif',
+    '.bin': 'application/octet-stream',
+    '.bmp': 'image/bmp',
+    '.css': 'text/css; charset=utf-8',
+    '.csv': 'text/csv; charset=utf-8',
+    '.gif': 'image/gif',
+    '.gz': 'application/gzip',
+    '.htm': 'text/html; charset=utf-8',
+    '.html': 'text/html; charset=utf-8',
+    '.ico': 'image/x-icon',
+    '.jpeg': 'image/jpeg',
+    '.jpg': 'image/jpeg',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.mp3': 'audio/mpeg',
+    '.mp4': 'video/mp4',
+    '.oga': 'audio/ogg',
+    '.ogg': 'audio/ogg',
+    '.ogv': 'video/ogg',
+    '.otf': 'font/otf',
+    '.pdf': 'application/pdf',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.tar': 'application/x-tar',
+    '.tiff': 'image/tiff',
+    '.ttf': 'font/ttf',
+    '.txt': 'text/plain; charset=utf-8',
+    '.wasm': 'application/wasm',
+    '.wav': 'audio/wav',
+    '.webm': 'video/webm',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.xml': 'application/xml; charset=utf-8',
+    '.zip': 'application/zip',
+};
+/**
+ * 静态文件中间件。未命中时调用 `next()`，因此可以和 API 路由共存。
+ *
+ * ```ts
+ * app.use(serveStatic('./public'))
+ * app.use('/assets', serveStatic('./dist/assets', { maxAge: 31536000, immutable: true }))
+ * ```
+ */
+export function serveStatic(root, options = {}) {
+    const rootDir = resolve(root);
+    const indexFile = options.index === undefined ? 'index.html' : options.index;
+    const etagEnabled = options.etag !== false;
+    return async (req, ctx, next) => {
+        if (req.method !== 'GET' && req.method !== 'HEAD')
+            return next(req, ctx);
+        let pathname;
+        try {
+            pathname = new URL(req.url).pathname;
+        }
+        catch {
+            return next(req, ctx);
+        }
+        const decoded = safeDecode(pathname);
+        if (decoded === null)
+            return next(req, ctx);
+        let filePath = resolve(rootDir, `.${decoded}`);
+        if (!isInside(rootDir, filePath))
+            return next(req, ctx);
+        let info = await statOrNull(filePath);
+        if (info?.isDirectory() && indexFile) {
+            filePath = resolve(filePath, indexFile);
+            if (!isInside(rootDir, filePath))
+                return next(req, ctx);
+            info = await statOrNull(filePath);
+        }
+        if (!info?.isFile()) {
+            if (!options.fallback)
+                return next(req, ctx);
+            const fallbackPath = resolve(rootDir, `.${ensureLeadingSlash(options.fallback)}`);
+            if (!isInside(rootDir, fallbackPath))
+                return next(req, ctx);
+            const fallbackInfo = await statOrNull(fallbackPath);
+            if (!fallbackInfo?.isFile())
+                return next(req, ctx);
+            filePath = fallbackPath;
+            info = fallbackInfo;
+        }
+        const relative = filePath.slice(rootDir.length + 1);
+        if (options.dotfiles !== 'allow' &&
+            relative.split(sep).some((part) => part.startsWith('.'))) {
+            if (options.dotfiles === 'deny') {
+                return new Response('Forbidden', { status: 403 });
+            }
+            return next(req, ctx);
+        }
+        const headers = new Headers(options.headers);
+        if (!headers.has('content-type')) {
+            const contentType = MIME_TYPES[extname(filePath).toLowerCase()];
+            if (contentType)
+                headers.set('content-type', contentType);
+        }
+        headers.set('content-length', String(info.size));
+        headers.set('last-modified', info.mtime.toUTCString());
+        if (options.maxAge !== undefined || options.immutable) {
+            const directives = ['public', `max-age=${options.maxAge ?? 0}`];
+            if (options.immutable)
+                directives.push('immutable');
+            headers.set('cache-control', directives.join(', '));
+        }
+        if (etagEnabled) {
+            const etag = `W/"${info.size.toString(16)}-${Math.floor(info.mtimeMs).toString(16)}"`;
+            headers.set('etag', etag);
+            if (req.headers.get('if-none-match') === etag) {
+                const notModified = new Headers(headers);
+                notModified.delete('content-length');
+                return new Response(null, { status: 304, headers: notModified });
+            }
+        }
+        const stream = createReadStream(filePath);
+        return new Response(Readable.toWeb(stream), { status: 200, headers });
+    };
+}
+function safeDecode(value) {
+    try {
+        const decoded = decodeURIComponent(value);
+        return decoded.includes('\0') ? null : decoded;
+    }
+    catch {
+        return null;
+    }
+}
+function isInside(root, file) {
+    return file === root || file.startsWith(root + sep);
+}
+async function statOrNull(path) {
+    try {
+        return await stat(path);
+    }
+    catch {
+        return null;
+    }
+}
+function ensureLeadingSlash(path) {
+    return path.startsWith('/') ? path : `/${path}`;
+}
+//# sourceMappingURL=static.js.map

package/dist/middleware/static.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,27 @@
+import { type IncomingMessage, type RequestListener, type Server } from 'node:http';
+import { type Duplex } from 'node:stream';
+/** 任何实现了 `fetch(Request)` 的对象都可以跑在 Node 上 */
+export interface FetchApp {
+    fetch(request: Request): Promise<Response>;
+}
+/** 额外实现了 upgrade 的应用（如 `App`），支持 WebSocket */
+export interface UpgradeApp extends FetchApp {
+    upgrade(request: Request, socket: Duplex, head?: Uint8Array, rawRequest?: IncomingMessage): Promise<Response | undefined>;
+}
+export interface NodeHandlerOptions {
+    /** 信任 `X-Forwarded-Proto` / `X-Forwarded-Host`（反向代理场景） */
+    trustProxy?: boolean;
+}
+export interface ServeOptions extends NodeHandlerOptions {
+    port?: number;
+    hostname?: string;
+}
+/** 把 Node 的 `(req, res)` 适配为 Fetch 处理函数 */
+export declare function toNodeHandler(app: FetchApp, options?: NodeHandlerOptions): RequestListener;
+/** 把 Node 的 `(req, socket, head)` 适配为 WebSocket 升级处理函数 */
+export declare function toUpgradeHandler(app: UpgradeApp, options?: NodeHandlerOptions): (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
+/** 把 `request` + `upgrade` 监听器挂到已有 server 上 */
+export declare function attachToServer(app: Partial<UpgradeApp> & FetchApp, server: Server, options?: NodeHandlerOptions): Server;
+/** 创建 Node HTTP Server 并开始监听（自动挂载 WebSocket upgrade） */
+export declare function serve(app: FetchApp, options?: ServeOptions): Server;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEZ,MAAM,WAAW,CAAA;AAClB,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAInD,6CAA6C;AAC7C,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC3C;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,OAAO,CACL,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAaD,2CAA2C;AAC3C,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE,kBAAuB,GAC/B,eAAe,CAIjB;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,OAAO,GAAE,kBAAuB,GAC/B,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAI9D;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,QAAQ,EACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAMR;AAED,wDAAwD;AACxD,wBAAgB,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAOvE"}

package/dist/node.js

@@ -0,0 +1,193 @@
+import { createServer, } from 'node:http';
+import { Readable } from 'node:stream';
+import { getStatusText } from "./helpers.js";
+const HOP_BY_HOP_HEADERS = new Set([
+    'connection',
+    'keep-alive',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+]);
+/** 把 Node 的 `(req, res)` 适配为 Fetch 处理函数 */
+export function toNodeHandler(app, options = {}) {
+    return (req, res) => {
+        void handleRequest(app, req, res, options);
+    };
+}
+/** 把 Node 的 `(req, socket, head)` 适配为 WebSocket 升级处理函数 */
+export function toUpgradeHandler(app, options = {}) {
+    return (req, socket, head) => {
+        void handleUpgrade(app, req, socket, head, options);
+    };
+}
+/** 把 `request` + `upgrade` 监听器挂到已有 server 上 */
+export function attachToServer(app, server, options = {}) {
+    server.on('request', toNodeHandler(app, options));
+    if (typeof app.upgrade === 'function') {
+        server.on('upgrade', toUpgradeHandler(app, options));
+    }
+    return server;
+}
+/** 创建 Node HTTP Server 并开始监听（自动挂载 WebSocket upgrade） */
+export function serve(app, options = {}) {
+    const server = createServer();
+    attachToServer(app, server, options);
+    const { port = 3000, hostname } = options;
+    if (hostname)
+        server.listen(port, hostname);
+    else
+        server.listen(port);
+    return server;
+}
+async function handleRequest(app, req, res, options) {
+    let response;
+    try {
+        response = await app.fetch(toRequest(req, options));
+    }
+    catch (error) {
+        console.error(error);
+        response = new Response('Internal Server Error', { status: 500 });
+    }
+    await sendResponse(res, response, req.method ?? 'GET');
+}
+async function handleUpgrade(app, req, socket, head, options) {
+    let response;
+    try {
+        const request = toRequest(req, options, true);
+        const result = await app.upgrade(request, socket, head, req);
+        if (!result)
+            return; // 已完成升级，socket 由连接接管
+        response = result;
+    }
+    catch (error) {
+        console.error(error);
+        response = new Response('Internal Server Error', { status: 500 });
+    }
+    await writeRawResponse(socket, response);
+}
+/** 在原始 socket 上写回一个完整的 HTTP 响应（升级被拒绝时使用） */
+async function writeRawResponse(socket, response) {
+    if (socket.destroyed)
+        return;
+    const body = response.body ? Buffer.from(await response.arrayBuffer()) : null;
+    const headers = new Headers(response.headers);
+    headers.set('connection', 'close');
+    if (body)
+        headers.set('content-length', String(body.length));
+    const statusText = response.statusText || getStatusText(response.status);
+    const lines = [`HTTP/1.1 ${response.status} ${statusText}`.trimEnd()];
+    for (const [key, value] of headers) {
+        if (key.toLowerCase() === 'set-cookie')
+            continue;
+        lines.push(`${key}: ${value}`);
+    }
+    for (const cookie of headers.getSetCookie?.() ?? []) {
+        lines.push(`set-cookie: ${cookie}`);
+    }
+    socket.write(`${lines.join('\r\n')}\r\n\r\n`);
+    if (body)
+        socket.write(body);
+    socket.end();
+}
+/** IncomingMessage -> Request */
+function toRequest(req, options, upgrade = false) {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value === undefined)
+            continue;
+        // 升级请求需要保留 Upgrade / Connection 头
+        if (!upgrade && HOP_BY_HOP_HEADERS.has(key.toLowerCase()))
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                headers.append(key, item);
+        }
+        else {
+            headers.set(key, value);
+        }
+    }
+    const forwardedProto = options.trustProxy
+        ? headers.get('x-forwarded-proto')?.split(',')[0]?.trim()
+        : undefined;
+    const protocol = forwardedProto ||
+        (req.socket.encrypted ? 'https' : 'http');
+    const forwardedHost = options.trustProxy
+        ? headers.get('x-forwarded-host')?.split(',')[0]?.trim()
+        : undefined;
+    const host = forwardedHost ?? headers.get('host') ?? 'localhost';
+    let url;
+    try {
+        url = new URL(req.url ?? '/', `${protocol}://${host}`);
+    }
+    catch {
+        url = new URL(req.url ?? '/', 'http://localhost');
+    }
+    const method = req.method ?? 'GET';
+    const init = { method, headers };
+    if (!upgrade && method !== 'GET' && method !== 'HEAD') {
+        init.body = Readable.toWeb(req);
+        init.duplex = 'half';
+    }
+    else if (!upgrade) {
+        // 消费掉可能存在的请求体，避免 keep-alive 连接被污染
+        req.resume();
+    }
+    return new Request(url, init);
+}
+/** Response -> ServerResponse */
+async function sendResponse(res, response, method) {
+    if (res.writableEnded || res.destroyed)
+        return;
+    res.statusCode = response.status;
+    if (response.statusText) {
+        try {
+            res.statusMessage = response.statusText;
+        }
+        catch {
+            // 非法的 reason phrase，忽略并使用 Node 默认值
+        }
+    }
+    const setCookies = response.headers.getSetCookie?.() ?? [];
+    try {
+        for (const [key, value] of response.headers) {
+            const lower = key.toLowerCase();
+            if (lower === 'set-cookie' && setCookies.length > 0)
+                continue;
+            if (HOP_BY_HOP_HEADERS.has(lower))
+                continue;
+            res.setHeader(key, value);
+        }
+        if (setCookies.length > 0)
+            res.setHeader('set-cookie', setCookies);
+    }
+    catch (error) {
+        console.error(error);
+        if (!res.headersSent) {
+            res.statusCode = 500;
+            res.end('Internal Server Error');
+        }
+        else {
+            res.destroy();
+        }
+        return;
+    }
+    const canHaveBody = method !== 'HEAD' && response.status !== 204 && response.status !== 304;
+    if (!canHaveBody || !response.body) {
+        await response.body?.cancel().catch(() => { });
+        res.end();
+        return;
+    }
+    const body = Readable.fromWeb(response.body);
+    res.on('close', () => {
+        if (!res.writableFinished)
+            body.destroy();
+    });
+    body.on('error', (error) => {
+        res.destroy(error instanceof Error ? error : undefined);
+    });
+    body.pipe(res);
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAKb,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AA2B5C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,IAAI;IACJ,SAAS;IACT,mBAAmB;IACnB,SAAS;CACV,CAAC,CAAA;AAEF,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAC3B,GAAa,EACb,UAA8B,EAAE;IAEhC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClB,KAAK,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC,CAAA;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAC9B,GAAe,EACf,UAA8B,EAAE;IAEhC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC3B,KAAK,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACrD,CAAC,CAAA;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAC5B,GAAmC,EACnC,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,GAAiB,EAAE,OAAO,CAAC,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,KAAK,CAAC,GAAa,EAAE,UAAwB,EAAE;IAC7D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IACzC,IAAI,QAAQ;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;;QACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,GAAa,EACb,GAAoB,EACpB,GAAmB,EACnB,OAA2B;IAE3B,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACpB,QAAQ,GAAG,IAAI,QAAQ,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAA;AACxD,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,GAAe,EACf,GAAoB,EACpB,MAAc,EACd,IAAY,EACZ,OAA2B;IAE3B,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;QAC5D,IAAI,CAAC,MAAM;YAAE,OAAM,CAAC,qBAAqB;QACzC,QAAQ,GAAG,MAAM,CAAA;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACpB,QAAQ,GAAG,IAAI,QAAQ,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAC1C,CAAC;AAED,4CAA4C;AAC5C,KAAK,UAAU,gBAAgB,CAC7B,MAAc,EACd,QAAkB;IAElB,IAAI,MAAM,CAAC,SAAS;QAAE,OAAM;IAE5B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAClC,IAAI,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAE5D,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACxE,MAAM,KAAK,GAAG,CAAC,YAAY,QAAQ,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IACrE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,YAAY;YAAE,SAAQ;QAChD,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAA;IAChC,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC7C,IAAI,IAAI;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,CAAC,GAAG,EAAE,CAAA;AACd,CAAC;AAED,iCAAiC;AACjC,SAAS,SAAS,CAChB,GAAoB,EACpB,OAA2B,EAC3B,OAAO,GAAG,KAAK;IAEf,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,kCAAkC;QAClC,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAAE,SAAQ;QACnE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACrD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU;QACvC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;QACzD,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,QAAQ,GACZ,cAAc;QACd,CAAE,GAAG,CAAC,MAAkC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAExE,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU;QACtC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;QACxD,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,IAAI,GAAG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,WAAW,CAAA;IAEhE,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,QAAQ,MAAM,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAA;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAA;IAClC,MAAM,IAAI,GAAsC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IAEnE,IAAI,CAAC,OAAO,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAA0C,CAAA;QACxE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;SAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,kCAAkC;QAClC,GAAG,CAAC,MAAM,EAAE,CAAA;IACd,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC/B,CAAC;AAED,iCAAiC;AACjC,KAAK,UAAU,YAAY,CACzB,GAAmB,EACnB,QAAkB,EAClB,MAAc;IAEd,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,SAAS;QAAE,OAAM;IAE9C,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAA;IAChC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,GAAG,CAAC,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAA;IAC1D,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAA;YAC/B,IAAI,KAAK,KAAK,YAAY,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAQ;YAC7D,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAQ;YAC3C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC3B,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACpB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAA;YACpB,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QAClC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,OAAO,EAAE,CAAA;QACf,CAAC;QACD,OAAM;IACR,CAAC;IAED,MAAM,WAAW,GACf,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAA;IACzE,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC7C,GAAG,CAAC,GAAG,EAAE,CAAA;QACT,OAAM;IACR,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAC3B,QAAQ,CAAC,IAAiD,CAC3D,CAAA;IACD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACnB,IAAI,CAAC,GAAG,CAAC,gBAAgB;YAAE,IAAI,CAAC,OAAO,EAAE,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACzB,GAAG,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAChB,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,9 @@
+/** 把路径拆成段，忽略空段（因此尾斜杠 / 连续斜杠都会被归一化） */
+export declare function splitPath(path: string): string[];
+/** 归一化 `app.use` 的前缀：去掉尾部的 `/` 与 `/*` */
+export declare function normalizePrefix(prefix: string): string;
+/** 判断 `pathname` 是否落在前缀 `prefix` 下（按路径段边界匹配） */
+export declare function matchesPrefix(prefix: string, pathname: string): boolean;
+/** 拼接 group / 路由前缀 */
+export declare function joinPaths(prefix: string, path: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,sBAAsB;AACtB,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D"}

package/dist/path.js

@@ -0,0 +1,31 @@
+/** 把路径拆成段，忽略空段（因此尾斜杠 / 连续斜杠都会被归一化） */
+export function splitPath(path) {
+    return path.split('/').filter((segment) => segment.length > 0);
+}
+/** 归一化 `app.use` 的前缀：去掉尾部的 `/` 与 `/*` */
+export function normalizePrefix(prefix) {
+    if (!prefix.startsWith('/')) {
+        throw new Error(`Prefix must start with "/": ${prefix}`);
+    }
+    if (prefix === '/' || prefix === '/*')
+        return '/';
+    let normalized = prefix.replace(/\/+$/, '');
+    if (normalized.endsWith('/*'))
+        normalized = normalized.slice(0, -2);
+    return normalized === '' ? '/' : normalized;
+}
+/** 判断 `pathname` 是否落在前缀 `prefix` 下（按路径段边界匹配） */
+export function matchesPrefix(prefix, pathname) {
+    if (prefix === '/' || prefix === '')
+        return true;
+    return pathname === prefix || pathname.startsWith(`${prefix}/`);
+}
+/** 拼接 group / 路由前缀 */
+export function joinPaths(prefix, path) {
+    if (path === '')
+        return prefix === '' ? '/' : prefix;
+    const left = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix;
+    const right = path.startsWith('/') ? path : `/${path}`;
+    return `${left}${right}`;
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAChE,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAA;IAC1D,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IACjD,IAAI,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3C,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACnE,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAA;AAC7C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC5D,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAChD,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAA;AACjE,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,IAAY;IACpD,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IACtD,OAAO,GAAG,IAAI,GAAG,KAAK,EAAE,CAAA;AAC1B,CAAC"}

package/dist/postgres.d.ts

@@ -0,0 +1,19 @@
+import type postgresJs from 'postgres';
+import { type Resource } from './resources.ts';
+/** postgres.js 的客户端类型（`ctx.sql`） */
+export type Sql = postgresJs.Sql;
+/** postgres.js 的 options（`Parameters<typeof postgresJs>[1]`，其泛型无默认值） */
+export type PostgresOptions = NonNullable<Parameters<typeof postgresJs>[1]>;
+/**
+ * 注入 `ctx.sql`（postgres.js 客户端）的中间件。
+ *
+ * - 首次请求时懒加载 `postgres` 并建连（池由 postgres.js 维护）
+ * - `app.close()` / CLI SIGTERM 时调用 `sql.end()`
+ * - 默认连接串：`process.env.DATABASE_URL`
+ *
+ * ```ts
+ * app.use(postgres()) // ctx.sql: Sql
+ * ```
+ */
+export declare function postgres(urlOrOptions?: string | PostgresOptions, options?: PostgresOptions): Resource<'sql', Sql>;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,UAAU,CAAA;AACtC,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAExD,oCAAoC;AACpC,MAAM,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAA;AAEhC,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,EACvC,OAAO,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAkBtB"}

package/dist/postgres.js

@@ -0,0 +1,27 @@
+import { resource } from "./resources.js";
+/**
+ * 注入 `ctx.sql`（postgres.js 客户端）的中间件。
+ *
+ * - 首次请求时懒加载 `postgres` 并建连（池由 postgres.js 维护）
+ * - `app.close()` / CLI SIGTERM 时调用 `sql.end()`
+ * - 默认连接串：`process.env.DATABASE_URL`
+ *
+ * ```ts
+ * app.use(postgres()) // ctx.sql: Sql
+ * ```
+ */
+export function postgres(urlOrOptions, options) {
+    return resource('sql', async () => {
+        const { default: createPostgres } = (await import('postgres'));
+        if (typeof urlOrOptions === 'string') {
+            return createPostgres(urlOrOptions, options);
+        }
+        const url = process.env.DATABASE_URL;
+        if (url)
+            return createPostgres(url, urlOrOptions);
+        return createPostgres(urlOrOptions);
+    }, {
+        close: (sql) => sql.end({ timeout: 5 }).then(() => undefined),
+    });
+}
+//# sourceMappingURL=postgres.js.map

package/dist/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAA;AAQxD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CACtB,YAAuC,EACvC,OAAyB;IAEzB,OAAO,QAAQ,CACb,KAAK,EACL,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAE5D,CAAA;QACD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;QACpC,IAAI,GAAG;YAAE,OAAO,cAAc,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QACjD,OAAO,cAAc,CAAC,YAAY,CAAC,CAAA;IACrC,CAAC,EACD;QACE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;KAC9D,CACF,CAAA;AACH,CAAC"}

package/dist/react-router.d.ts

@@ -0,0 +1,31 @@
+import type { RouterContextProvider, ServerBuild } from 'react-router';
+import type { Context, Handler } from './types.ts';
+export interface ReactRouterOptions<C extends Context = Context> {
+    /**
+     * RR server build。默认从 Vite 虚拟模块 `virtual:react-router/server-build`
+     * 加载：dev 由 Vite 解析，prod 由 `react-router build` 构建时替换。
+     */
+    build?: ServerBuild | (() => ServerBuild | Promise<ServerBuild>);
+    /** 运行模式，默认 `process.env.NODE_ENV` */
+    mode?: string;
+    /**
+     * 把 weifuwu 的上下文桥接为 RR 的 load context。
+     * 在 loader/action 中通过 `context.get(...)` 读取。
+     */
+    getLoadContext?: (request: Request, ctx: C) => RouterContextProvider | void | Promise<RouterContextProvider | void>;
+}
+/**
+ * 把 React Router 挂载为 weifuwu 的兜底处理器。
+ *
+ * ```ts
+ * app.notFound(reactRouter({
+ *   getLoadContext(request, ctx) {
+ *     const context = new RouterContextProvider()
+ *     context.set(dbContext, ctx.db)
+ *     return context
+ *   },
+ * }))
+ * ```
+ */
+export declare function reactRouter<C extends Context = Context>(options?: ReactRouterOptions<C>): Handler<C>;
+//# sourceMappingURL=react-router.d.ts.map

package/dist/react-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.d.ts","sourceRoot":"","sources":["../src/react-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC7D;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;IAChE,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,CACf,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,CAAC,KACH,qBAAqB,GAAG,IAAI,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAA;CAC1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EACrD,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/react-router.js

@@ -0,0 +1,25 @@
+import { createRequestHandler } from 'react-router';
+/**
+ * 把 React Router 挂载为 weifuwu 的兜底处理器。
+ *
+ * ```ts
+ * app.notFound(reactRouter({
+ *   getLoadContext(request, ctx) {
+ *     const context = new RouterContextProvider()
+ *     context.set(dbContext, ctx.db)
+ *     return context
+ *   },
+ * }))
+ * ```
+ */
+export function reactRouter(options = {}) {
+    const build = options.build ?? (() => import('virtual:react-router/server-build'));
+    const handle = createRequestHandler(build, options.mode ?? process.env.NODE_ENV);
+    return async (request, ctx) => {
+        if (!options.getLoadContext)
+            return handle(request);
+        const loadContext = await options.getLoadContext(request, ctx);
+        return loadContext ? handle(request, loadContext) : handle(request);
+    };
+}
+//# sourceMappingURL=react-router.js.map

package/dist/react-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.js","sourceRoot":"","sources":["../src/react-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAsBnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,UAAiC,EAAE;IAEnC,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;QAC5B,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;QACnD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAC9D,OAAO,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrE,CAAC,CAAA;AACH,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,35 @@
+import type { Context, Middleware } from './types.ts';
+/** `App.use()` 识别该 symbol 上的 dispose 并注册到 `app.close()`（内部协议） */
+export declare const RESOURCE_DISPOSE: unique symbol;
+export interface ResourceOptions<V> {
+    /** 进程关闭时清理（`app.close()` / CLI 的 SIGINT、SIGTERM 触发） */
+    close?: (value: V) => void | Promise<void>;
+}
+/**
+ * `resource()` 返回的中间件：
+ * - 注入 `ctx[key]`（类型精确到 `V`）
+ * - 懒初始化：首个请求时才 `create()`
+ * - 单例 + single-flight：并发首请求只创建一次
+ * - 失败不缓存：下次请求重试
+ * - `app.close()` 时按 LIFO 调用 `options.close`
+ */
+export interface Resource<K extends string = string, V = unknown, C extends Context = Context> extends Middleware<C, C & Record<K, V>> {
+    readonly key: K;
+    /** 已创建则返回实例，否则 `undefined`（测试 / 工具用） */
+    peek(): V | undefined;
+    /** 立即创建（预热用），失败不缓存 */
+    load(): Promise<V>;
+    /** 手动关闭（`app.close()` 之外）；幂等 */
+    close(): Promise<void>;
+}
+/**
+ * 懒初始化的共享资源中间件。
+ *
+ * ```ts
+ * const db = resource('db', () => openDatabase(), { close: (db) => db.end() })
+ * const app = createApp().use(db)
+ * app.get('/', (req, ctx) => json(ctx.db.query()))
+ * ```
+ */
+export declare function resource<const K extends string, V, C extends Context = Context>(key: K, create: () => V | Promise<V>, options?: ResourceOptions<V>): Resource<K, V, C>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAW,UAAU,EAAE,MAAM,YAAY,CAAA;AAE9D,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAA2C,CAAA;AAEjF,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,uDAAuD;IACvD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ,CACvB,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,CAAC,GAAG,OAAO,EACX,CAAC,SAAS,OAAO,GAAG,OAAO,CAC3B,SAAQ,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAA;IACf,wCAAwC;IACxC,IAAI,IAAI,CAAC,GAAG,SAAS,CAAA;IACrB,sBAAsB;IACtB,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;IAClB,gCAAgC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,CAAC,CAAC,SAAS,MAAM,EACtB,CAAC,EACD,CAAC,SAAS,OAAO,GAAG,OAAO,EAE3B,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC5B,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAoDnB"}