@weifuwujs/weifuwu 0.9.0

package/dist/app.d.ts

@@ -0,0 +1,122 @@
+import { type IncomingMessage, type RequestListener, type Server } from 'node:http';
+import type { Duplex } from 'node:stream';
+import { Group } from './group.ts';
+import type { Context, ErrorHandler, Middleware, MountableApi, MountOptions, NotFoundHandler, OnRegistrar, RouteRegistrar } from './types.ts';
+import type { WebSocketMiddleware, WsRegistrar } from './websocket/types.ts';
+/**
+ * Fetch 风格的应用。
+ *
+ * - `app.fetch(request)` 是纯函数入口，可直接用于测试或部署到任何 Fetch 运行时
+ * - `app.listen(port)` 是 Node HTTP 适配层
+ *
+ * 泛型 `C` 会随着 `app.use(...)` 注入的数据不断累积，
+ * 从而让后续路由的 `ctx` 拥有完整类型。
+ */
+export declare class App<C extends Context = Context> {
+    #private;
+    /**
+     * 注册全局中间件，并把它注入的字段累积到上下文类型中。
+     *
+     * ```ts
+     * const auth: Middleware<Context, Context & { user: User }> =
+     *   async (req, ctx, next) => next(req, { ...ctx, user: await verify(req) })
+     *
+     * const app = createApp().use(auth)
+     * app.get('/', (req, ctx) => json(ctx.user)) // ctx.user 有类型
+     * ```
+     */
+    use<Out extends Context>(middleware: Middleware<C, Out, any>): App<C & Out>;
+    /** 注册仅作用于某个路径前缀的中间件 */
+    use(prefix: string, ...middlewares: Array<Middleware<any, any, any>>): this;
+    /** 批量注册不改变上下文类型的中间件 */
+    use(...middlewares: Array<Middleware<any, any, any>>): this;
+    /**
+     * 注册进程关闭时的清理钩子。
+     *
+     * `app.close()` 会按后注册先执行的顺序运行；CLI 的 SIGINT / SIGTERM
+     * 会自动调用 `app.close()`。
+     */
+    onClose(disposer: () => void | Promise<void>): this;
+    /**
+     * 关闭应用：按 LIFO 运行关闭钩子（含 `resource()` 资源）。
+     * 单个钩子失败只记录日志，不阻断其它；可重复调用（幂等）。
+     *
+     * **构造期绑定**：会被交给进程生命周期钩子，可能脱离实例调用或在 dev
+     * 双模块副本间传递（mandate 3.3 事故家族），因此不用原型方法。
+     */
+    close: () => Promise<void>;
+    get: RouteRegistrar<C, '', this>;
+    post: RouteRegistrar<C, '', this>;
+    put: RouteRegistrar<C, '', this>;
+    patch: RouteRegistrar<C, '', this>;
+    delete: RouteRegistrar<C, '', this>;
+    head: RouteRegistrar<C, '', this>;
+    options: RouteRegistrar<C, '', this>;
+    /** 为同一路径注册所有标准方法 */
+    all: RouteRegistrar<C, '', this>;
+    /** 注册任意 HTTP 方法 */
+    on: OnRegistrar<C, '', this>;
+    /**
+     * 注册 WebSocket 路由。终端是每连接调用一次的工厂：
+     *
+     * ```ts
+     * app.ws('/chat/:room', async (socket, ctx) => {
+     *   await join(ctx.params.room, socket)          // 工厂体 = open 钩子
+     *   const timer = setInterval(() => socket.ping(), 30_000)
+     *   return {
+     *     onMessage: (socket, message) => broadcast(ctx.params.room, message.data),
+     *     onClose: () => { clearInterval(timer); leave(ctx.params.room, socket) },
+     *   }
+     * })
+     * ```
+     */
+    ws: WsRegistrar<C, '', this>;
+    /** 注册全局 WebSocket 中间件（只作用于 upgrade 请求） */
+    wsUse(...middlewares: Array<WebSocketMiddleware<any, any>>): this;
+    /** 路由分组，统一添加前缀（前缀中的参数也会体现在 ctx.params 类型里） */
+    group<Prefix extends string>(prefix: Prefix, define: (group: Group<C, Prefix>) => void): this;
+    /** 覆盖默认 404 响应 */
+    notFound(handler: NotFoundHandler<C>): this;
+    /** 注册全局错误处理器 */
+    onError(handler: ErrorHandler<C>): this;
+    /**
+     * 挂载单源 API（`defineApi` / `defineResource` 的产物）。
+     *
+     * ```ts
+     * app.mount(api, { graphql: '/graphql' })
+     * ```
+     */
+    mount(api: MountableApi<C>, options?: MountOptions): this;
+    /** 纯 Fetch 入口：把一个 `Request` 变成 `Response`（构造期绑定：可脱离调用/跨副本安全） */
+    fetch: (request: Request) => Promise<Response>;
+    /**
+     * WebSocket 升级入口：匹配 ws 路由、运行 WS 中间件并完成握手。
+     *
+     * - 返回 `undefined` 表示已升级，socket 归连接接管
+     * - 返回 `Response` 表示拒绝升级（HTTP 响应写回原始 socket）
+     *
+     * 用构造期绑定的箭头函数而非原型方法：dev 下 app 经 Vite SSR 加载时，
+     * 框架模块可能存在两份副本（CLI bundle 与 SSR 运行时），原型方法读到
+     * 另一副本的 `this` 会触发私有字段 brand 错误
+     * （TypeError: Cannot read private member #wsRouter ...）。
+     */
+    readonly upgrade: (request: Request, socket: Duplex, head?: Uint8Array, rawRequest?: IncomingMessage) => Promise<Response | undefined>;
+    /** 便捷方法：直接传入路径字符串发起内部请求（主要给测试用；构造期绑定） */
+    request: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    /** 适配为 Node 的 `(req, res)` 处理函数 */
+    get handler(): RequestListener;
+    /** 把 HTTP + WebSocket 监听器挂到已有 server 上（构造期绑定：可脱离调用） */
+    attach: (server: Server) => Server;
+    /**
+     * 启动 Node HTTP Server（构造期绑定：可脱离调用）
+     *
+     * 重载签名保留在属性类型上：`listen(port, cb)` / `listen(port, hostname, cb)`。
+     */
+    readonly listen: {
+        (port?: number, callback?: () => void): Server;
+        (port: number, hostname: string, callback?: () => void): Server;
+    };
+}
+/** 创建应用 */
+export declare function createApp<C extends Context = Context>(): App<C>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

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

package/dist/app.js

@@ -0,0 +1,484 @@
+import {} from 'node:http';
+import { compose } from "./compose.js";
+import { Group } from "./group.js";
+import { HttpError } from "./helpers.js";
+import { METHODS } from "./methods.js";
+import { matchesPrefix, normalizePrefix } from "./path.js";
+import { attachToServer, serve, toNodeHandler } from "./node.js";
+import { Router } from "./router.js";
+import { CLOSE_CODE } from "./websocket/close-code.js";
+import { RESOURCE_DISPOSE } from "./resources.js";
+import { acceptWebSocket, validateUpgradeRequest } from "./websocket/accept.js";
+const defaultNotFound = () => new Response('Not Found', { status: 404 });
+/**
+ * Fetch 风格的应用。
+ *
+ * - `app.fetch(request)` 是纯函数入口，可直接用于测试或部署到任何 Fetch 运行时
+ * - `app.listen(port)` 是 Node HTTP 适配层
+ *
+ * 泛型 `C` 会随着 `app.use(...)` 注入的数据不断累积，
+ * 从而让后续路由的 `ctx` 拥有完整类型。
+ */
+export class App {
+    #router = new Router();
+    #wsRouter = new Router();
+    #middlewares = [];
+    #wsMiddlewares = [];
+    #errorHandler = null;
+    #notFoundHandler = null;
+    #disposers = [];
+    #wsVoidWarned = new Set();
+    use(...args) {
+        if (typeof args[0] === 'string') {
+            const prefix = normalizePrefix(args[0]);
+            for (const middleware of args.slice(1)) {
+                this.#middlewares.push({ prefix, middleware });
+                this.#registerDispose(middleware);
+            }
+        }
+        else {
+            for (const middleware of args) {
+                this.#middlewares.push({ prefix: null, middleware });
+                this.#registerDispose(middleware);
+            }
+        }
+        return this;
+    }
+    #registerDispose(middleware) {
+        const dispose = middleware[RESOURCE_DISPOSE];
+        if (typeof dispose === 'function')
+            this.#disposers.push(dispose);
+    }
+    /**
+     * 注册进程关闭时的清理钩子。
+     *
+     * `app.close()` 会按后注册先执行的顺序运行；CLI 的 SIGINT / SIGTERM
+     * 会自动调用 `app.close()`。
+     */
+    onClose(disposer) {
+        this.#disposers.push(disposer);
+        return this;
+    }
+    /**
+     * 关闭应用：按 LIFO 运行关闭钩子（含 `resource()` 资源）。
+     * 单个钩子失败只记录日志，不阻断其它；可重复调用（幂等）。
+     *
+     * **构造期绑定**：会被交给进程生命周期钩子，可能脱离实例调用或在 dev
+     * 双模块副本间传递（mandate 3.3 事故家族），因此不用原型方法。
+     */
+    close = async () => {
+        const disposers = this.#disposers.splice(0).reverse();
+        for (const dispose of disposers) {
+            try {
+                await dispose();
+            }
+            catch (error) {
+                console.error(error);
+            }
+        }
+    };
+    get = (path, ...handlers) => this.#route('GET', path, handlers);
+    post = (path, ...handlers) => this.#route('POST', path, handlers);
+    put = (path, ...handlers) => this.#route('PUT', path, handlers);
+    patch = (path, ...handlers) => this.#route('PATCH', path, handlers);
+    delete = (path, ...handlers) => this.#route('DELETE', path, handlers);
+    head = (path, ...handlers) => this.#route('HEAD', path, handlers);
+    options = (path, ...handlers) => this.#route('OPTIONS', path, handlers);
+    /** 为同一路径注册所有标准方法 */
+    all = (path, ...handlers) => {
+        for (const method of METHODS)
+            this.#route(method, path, handlers);
+        return this;
+    };
+    /** 注册任意 HTTP 方法 */
+    on = (method, path, ...handlers) => this.#route(method, path, handlers);
+    /**
+     * 注册 WebSocket 路由。终端是每连接调用一次的工厂：
+     *
+     * ```ts
+     * app.ws('/chat/:room', async (socket, ctx) => {
+     *   await join(ctx.params.room, socket)          // 工厂体 = open 钩子
+     *   const timer = setInterval(() => socket.ping(), 30_000)
+     *   return {
+     *     onMessage: (socket, message) => broadcast(ctx.params.room, message.data),
+     *     onClose: () => { clearInterval(timer); leave(ctx.params.room, socket) },
+     *   }
+     * })
+     * ```
+     */
+    ws = (path, ...args) => {
+        const { options, middlewares, handler } = splitWsArgs(args);
+        this.#wsRouter.add({
+            method: 'GET',
+            path,
+            middlewares,
+            handler,
+            options,
+        });
+        return this;
+    };
+    /** 注册全局 WebSocket 中间件（只作用于 upgrade 请求） */
+    wsUse(...middlewares) {
+        this.#wsMiddlewares.push(...middlewares);
+        return this;
+    }
+    /** 路由分组，统一添加前缀（前缀中的参数也会体现在 ctx.params 类型里） */
+    group(prefix, define) {
+        define(new Group(this, normalizePrefix(prefix)));
+        return this;
+    }
+    /** 覆盖默认 404 响应 */
+    notFound(handler) {
+        this.#notFoundHandler = handler;
+        return this;
+    }
+    /** 注册全局错误处理器 */
+    onError(handler) {
+        this.#errorHandler = handler;
+        return this;
+    }
+    /**
+     * 挂载单源 API（`defineApi` / `defineResource` 的产物）。
+     *
+     * ```ts
+     * app.mount(api, { graphql: '/graphql' })
+     * ```
+     */
+    mount(api, options = {}) {
+        if (options.rest !== false) {
+            for (const route of api.routes()) {
+                this.#route(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.#route('GET', options.graphql, [handler]);
+            this.#route('POST', options.graphql, [handler]);
+        }
+        return this;
+    }
+    /** 纯 Fetch 入口：把一个 `Request` 变成 `Response`（构造期绑定：可脱离调用/跨副本安全） */
+    fetch = async (request) => {
+        const url = new URL(request.url);
+        const method = (request.method || 'GET').toUpperCase();
+        const ctx = {
+            params: {},
+            query: queryFromURL(url),
+        };
+        let routeEntry = null;
+        let allowed = [];
+        const result = this.#router.match(method, url.pathname);
+        if (result.type === 'match') {
+            routeEntry = result.entry;
+            Object.assign(ctx.params, result.params);
+        }
+        else if (result.type === 'method') {
+            allowed = result.allowed;
+        }
+        const chain = [];
+        for (const entry of this.#middlewares) {
+            if (entry.prefix === null) {
+                chain.push(entry.middleware);
+            }
+            else if (matchesPrefix(entry.prefix, url.pathname)) {
+                chain.push(scopeToPrefix(entry.prefix, entry.middleware));
+            }
+        }
+        let handler;
+        if (routeEntry) {
+            chain.push(...routeEntry.middlewares);
+            handler = routeEntry.handler;
+        }
+        else if (allowed.length > 0) {
+            const allowHeader = allowed.join(', ');
+            handler =
+                method === 'OPTIONS'
+                    ? () => new Response(null, { status: 204, headers: { allow: allowHeader } })
+                    : () => new Response('Method Not Allowed', {
+                        status: 405,
+                        headers: { allow: allowHeader },
+                    });
+        }
+        else {
+            handler = this.#notFoundHandler ?? defaultNotFound;
+        }
+        try {
+            const response = await compose(chain, handler)(request, ctx);
+            if (response instanceof Response)
+                return response;
+            // 注册位接受任意 R 的中间件（同一实例可在 HTTP/WS 双端复用）；
+            // HTTP 链的结果必须是 Response，否则给出可定位的错误而不是静默 TypeError。
+            throw new Error(`HTTP 中间件链必须返回 Response，实际收到 ${String(response)}` +
+                '（WS 专用中间件请注册到 app.wsUse / app.ws）');
+        }
+        catch (error) {
+            const errorHandler = this.#errorHandler;
+            if (errorHandler) {
+                try {
+                    const response = await errorHandler(error, request, ctx);
+                    if (response)
+                        return response;
+                }
+                catch (nested) {
+                    console.error(nested);
+                }
+            }
+            if (error instanceof HttpError)
+                return error.toResponse();
+            console.error(error);
+            return new Response('Internal Server Error', { status: 500 });
+        }
+    };
+    /**
+     * WebSocket 升级入口：匹配 ws 路由、运行 WS 中间件并完成握手。
+     *
+     * - 返回 `undefined` 表示已升级，socket 归连接接管
+     * - 返回 `Response` 表示拒绝升级（HTTP 响应写回原始 socket）
+     *
+     * 用构造期绑定的箭头函数而非原型方法：dev 下 app 经 Vite SSR 加载时，
+     * 框架模块可能存在两份副本（CLI bundle 与 SSR 运行时），原型方法读到
+     * 另一副本的 `this` 会触发私有字段 brand 错误
+     * （TypeError: Cannot read private member #wsRouter ...）。
+     */
+    upgrade = async (request, socket, head, rawRequest) => {
+        const url = new URL(request.url);
+        const ctx = { params: {}, query: queryFromURL(url) };
+        const result = this.#wsRouter.match('GET', url.pathname);
+        const chain = [...this.#wsMiddlewares];
+        let route = null;
+        if (result.type === 'match') {
+            route = result.entry;
+            Object.assign(ctx.params, result.params);
+            chain.push(...route.middlewares);
+        }
+        const options = route?.options ?? {};
+        const handler = route?.handler;
+        const terminal = async (req, terminalCtx) => {
+            if (!handler)
+                return new Response('Not Found', { status: 404 });
+            const refusal = validateUpgradeRequest(req);
+            if (refusal)
+                return refusal;
+            const connection = acceptWebSocket(socket, req, { ...options, head, rawRequest });
+            // 工厂每连接调用一次，可以异步（查库/鉴权/加载房间）。结算前到达的消息由连接
+            // 缓冲（#early），布线在工厂返回后立即完成——不再依赖“同步注册监听器”。
+            let lifecycle;
+            try {
+                lifecycle = await handler(connection, terminalCtx);
+            }
+            catch (error) {
+                await this.#failConnection(error, req, terminalCtx, null, connection, {
+                    close: true,
+                    viaOnError: false,
+                });
+                return undefined;
+            }
+            if (lifecycle) {
+                this.#wireLifecycle(connection, lifecycle, terminalCtx, req);
+            }
+            else {
+                this.#warnIfUnconsumedWs(connection, route?.path ?? url.pathname);
+            }
+            connection.start();
+            return undefined;
+        };
+        try {
+            const result = await compose(chain, terminal)(request, ctx);
+            return result ?? undefined;
+        }
+        catch (error) {
+            if (error instanceof HttpError)
+                return error.toResponse();
+            console.error(error);
+            return new Response('Internal Server Error', { status: 500 });
+        }
+    };
+    /**
+     * 接线连接生命周期：所有回调都在 `connection.start()` 之前注册，
+     * 消息按到达顺序串行 await，`onClose` 恰好一次。
+     */
+    #wireLifecycle(connection, lifecycle, ctx, req) {
+        let queue = Promise.resolve();
+        const run = (task, options = {
+            close: true,
+            viaOnError: true,
+        }) => {
+            queue = queue
+                .then(task)
+                .catch((error) => this.#failConnection(error, req, ctx, lifecycle, connection, options))
+                // #failConnection 自身出错也不能让队列永久 reject
+                .catch((error) => console.error(error));
+        };
+        connection.on('message', (data, isBinary) => {
+            run(() => lifecycle.onMessage?.(connection, { data, binary: isBinary }, ctx));
+        });
+        connection.on('close', (code, reason) => {
+            run(() => lifecycle.onClose?.(connection, code, reason, ctx), {
+                close: false,
+                viaOnError: true,
+            });
+        });
+        connection.on('error', (error) => {
+            run(() => lifecycle.onError?.(connection, error, ctx), {
+                close: false,
+                viaOnError: false,
+            });
+        });
+    }
+    /**
+     * 连接级错误路由：`onError`（若有）→ `app.onError` → `console.error`；
+     * 业务回调抛出的错误默认以 1011 关闭连接。
+     */
+    async #failConnection(error, req, ctx, lifecycle, connection, options) {
+        const failure = error instanceof Error ? error : new Error(String(error));
+        const onError = lifecycle?.onError;
+        if (options.viaOnError && onError) {
+            try {
+                await onError(connection, failure, ctx);
+            }
+            catch (nested) {
+                await this.#reportWsError(nested, req, ctx);
+            }
+        }
+        else {
+            await this.#reportWsError(failure, req, ctx);
+        }
+        if (options.close && connection.readyState === 'open') {
+            connection.close(CLOSE_CODE.INTERNAL_ERROR, 'Internal Server Error');
+        }
+    }
+    async #reportWsError(error, req, ctx) {
+        const errorHandler = this.#errorHandler;
+        if (errorHandler) {
+            try {
+                await errorHandler(error, req, ctx);
+                return;
+            }
+            catch (nested) {
+                console.error(nested);
+                return;
+            }
+        }
+        console.error(error);
+    }
+    /** dev 护栏：工厂忘了 return 生命周期对象时，消息会被静默丢弃 */
+    #warnIfUnconsumedWs(connection, path) {
+        if (isProduction())
+            return;
+        if (connection.hasMessageConsumer())
+            return;
+        if (this.#wsVoidWarned.has(path))
+            return;
+        this.#wsVoidWarned.add(path);
+        console.warn(`[weifuwu] app.ws('${path}') 的工厂返回了 void，且该连接没有消息消费者` +
+            '（onMessage / socket.on("message") / for await）；收到的消息将被丢弃。' +
+            '若是有意的纯流式模式请忽略，否则请从工厂 return { onMessage, ... }。');
+    }
+    /** 便捷方法：直接传入路径字符串发起内部请求（主要给测试用；构造期绑定） */
+    request = (input, init) => {
+        if (input instanceof Request)
+            return this.fetch(input);
+        const url = typeof input === 'string' ? new URL(input, 'http://localhost') : input;
+        return this.fetch(new Request(url, init));
+    };
+    /** 适配为 Node 的 `(req, res)` 处理函数 */
+    get handler() {
+        return toNodeHandler(this);
+    }
+    /** 把 HTTP + WebSocket 监听器挂到已有 server 上（构造期绑定：可脱离调用） */
+    attach = (server) => {
+        return attachToServer(this, server);
+    };
+    /**
+     * 启动 Node HTTP Server（构造期绑定：可脱离调用）
+     *
+     * 重载签名保留在属性类型上：`listen(port, cb)` / `listen(port, hostname, cb)`。
+     */
+    listen = (port = 3000, hostnameOrCallback, callback) => {
+        const hostname = typeof hostnameOrCallback === 'string' ? hostnameOrCallback : undefined;
+        const onListening = typeof hostnameOrCallback === 'function' ? hostnameOrCallback : callback;
+        const server = serve(this, { port, hostname });
+        if (onListening)
+            server.once('listening', onListening);
+        return server;
+    };
+    #route(method, path, handlers) {
+        const list = [...handlers];
+        const handler = list.pop();
+        if (!handler) {
+            throw new Error(`Route ${method} ${path} requires a handler`);
+        }
+        this.#router.add({
+            method,
+            path,
+            middlewares: list,
+            handler,
+        });
+        return this;
+    }
+}
+function queryFromURL(url) {
+    const query = {};
+    for (const [key, value] of url.searchParams) {
+        if (!Object.prototype.hasOwnProperty.call(query, key))
+            query[key] = value;
+    }
+    return query;
+}
+function splitWsArgs(args) {
+    const list = [...args];
+    const handler = list.pop();
+    if (typeof handler !== 'function') {
+        // 工厂必须是函数：`(socket, ctx) => lifecycle | void`
+        throw new Error('WebSocket route requires a handler factory');
+    }
+    let options = {};
+    const first = list[0];
+    if (typeof first === 'object' && first !== null && !Array.isArray(first)) {
+        options = list.shift();
+    }
+    return {
+        options,
+        middlewares: list,
+        handler: handler,
+    };
+}
+/**
+ * 路径中间件（Express 风格）：进入时把 URL 前缀去掉，
+ * 调用 `next()` 时再还原，从而让 `serveStatic` 这类中间件
+ * 可以像 `app.use('/assets', serveStatic('./public'))` 这样挂载。
+ */
+function scopeToPrefix(prefix, middleware) {
+    if (prefix === '/')
+        return middleware;
+    return (req, ctx, next) => {
+        const scoped = stripPrefix(req, prefix);
+        return middleware(scoped, ctx, (nextReq, nextCtx) => next(nextReq === scoped ? req : nextReq, nextCtx));
+    };
+}
+function stripPrefix(req, prefix) {
+    const url = new URL(req.url);
+    const rest = url.pathname.slice(prefix.length);
+    url.pathname = rest.startsWith('/') ? rest : `/${rest}`;
+    const init = {
+        method: req.method,
+        headers: req.headers,
+        body: req.body,
+        signal: req.signal,
+    };
+    if (req.body)
+        init.duplex = 'half';
+    return new Request(url, init);
+}
+/** 创建应用 */
+export function createApp() {
+    return new App();
+}
+/** dev 护栏只在非生产环境生效 */
+function isProduction() {
+    return typeof process !== 'undefined' && process.env?.NODE_ENV === 'production';
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}