@yuhere/js-jsonrpc2 2.1.1 → 2.1.3

package/htdoc/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>JSON-RPC 2.0</title>
-    <script type="module" crossorigin src="./assets/index-CQr-lnlD.js"></script>
+    <script type="module" crossorigin src="./assets/index-BEVUmX2-.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-hcP2-9jw.css">
   </head>
   <body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuhere/js-jsonrpc2",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "A TypeScript JSON-RPC 2.0 server library with schema validation, authorization, dependency injection, and multiple transports.",
   "homepage": "https://github.com/yuhere/js-jsonrpc2#readme",
   "license": "MIT",
@@ -41,7 +41,7 @@
   },
   "scripts": {
     "build": "npm run build:lib && npm run build:webui",
-    "build:lib": "tsc -p tsconfig.build.json",
+    "build:lib": "tsc -p tsconfig.build.json && tsc-esm-fix",
     "build:webui": "tsc -p webui//tsconfig.json && vite build --config webui/vite.config.ts",
     "dev": "run-p dev:lib dev:webui",
     "dev:lib": "tsx src/cli/express.ts",
@@ -74,19 +74,20 @@
     "@types/ws": "^8.18.2",
     "@vitejs/plugin-react": "^6.1.2",
     "@vitest/coverage-v8": "^5.0.5",
-    "express": "^5.3.0",
     "npm-run-all": "^4.1.5",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "supertest": "^7.3.1",
+    "tsc-esm-fix": "^3.1.2",
     "tsx": "^4.23.15",
     "typescript": "^7.0.2",
     "vite": "^8.3.5",
-    "vitest": "^5.0.5",
-    "ws": "^8.22.0"
+    "vitest": "^5.0.5"
   },
   "dependencies": {
-    "body-parser": "^2.3.0",
+    "body-parser": "^2.4.0",
+    "express": "^5.3.0",
+    "ws": "^8.22.0",
     "zod": "^4.6.7"
   }
-}
+}

package/webui/src/App.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 import { createRpc, type TransportKind } from './api/rpc';
 import { useMethods } from './hooks/useMethods';
 import { useMethodDetail } from './hooks/useMethodDetail';
@@ -6,14 +6,18 @@ import { Toolbar } from './components/Toolbar';
 import { MethodTree } from './components/MethodTree';
 import { MethodDetail } from './components/MethodDetail';
 import { TestPanel } from './components/TestPanel';
+import {
+    collectApiDoc,
+    downloadText,
+    renderMarkdown,
+} from './api/docGen';
 
 const ENDPOINT = '';
-// 如需强制指定 WS 地址，可改为例如 'ws://localhost:3000/'
-// 默认由 wsTransport 从 window.location 推导。
 
 export default function App() {
     const [transport, setTransport] = useState<TransportKind>('http');
     const [selected, setSelected] = useState('');
+    const [generatingDocs, setGeneratingDocs] = useState(false);
 
     const rpc = useMemo(() => {
         return createRpc({ transport, endpoint: ENDPOINT });
@@ -26,6 +30,27 @@ export default function App() {
     const { methods, loading, error, refresh } = useMethods(rpc);
     const detail = useMethodDetail(rpc, selected);
 
+    const generateDocs = useCallback(async () => {
+        if (methods.length === 0) {
+            alert('方法列表为空，请先刷新方法列表。');
+            return;
+        }
+        setGeneratingDocs(true);
+        try {
+            const doc = await collectApiDoc(rpc, methods);
+            const md = renderMarkdown(doc);
+            const ts = new Date()
+                .toISOString()
+                .replace(/[:.]/g, '-')
+                .slice(0, 19);
+            downloadText(`jsonrpc-api-doc-${ts}.md`, md, 'text/markdown');
+        } catch (e) {
+            alert(`生成文档失败：${e instanceof Error ? e.message : String(e)}`);
+        } finally {
+            setGeneratingDocs(false);
+        }
+    }, [rpc, methods]);
+
     return (
         <div className="app">
             <Toolbar
@@ -34,6 +59,8 @@ export default function App() {
                 onRefresh={refresh}
                 loading={loading}
                 error={error}
+                onGenerateDocs={generateDocs}
+                generatingDocs={generatingDocs}
             />
             <main>
                 <aside className="sidebar">

package/webui/src/api/docGen.ts

@@ -0,0 +1,188 @@
+import type { RpcClient } from './rpc';
+import type { SchemaDescription } from './schema';
+
+export interface MethodDoc {
+    name: string;
+    help: string;
+    signature: SchemaDescription[];
+    error?: string;
+}
+
+export interface ApiDoc {
+    generatedAt: string;
+    methods: MethodDoc[];
+}
+
+function isSchema(v: unknown): v is SchemaDescription {
+    return !!v && typeof v === 'object' && typeof (v as SchemaDescription).kind === 'string';
+}
+
+/** 逐个方法拉取 help + signature */
+export async function collectApiDoc(
+    rpc: RpcClient,
+    methods: string[],
+    onProgress?: (done: number, total: number) => void,
+): Promise<ApiDoc> {
+    const out: MethodDoc[] = [];
+    for (let i = 0; i < methods.length; i++) {
+        const name = methods[i];
+        try {
+            const [help, sig] = await Promise.all([
+                rpc.call<string>('system.methodHelp', name).catch(() => ''),
+                rpc.call<unknown[]>('system.methodSignature', name).catch(() => []),
+            ]);
+            out.push({
+                name,
+                help: typeof help === 'string' ? help : '',
+                signature: Array.isArray(sig) ? sig.filter(isSchema) : [],
+            });
+        } catch (e) {
+            out.push({
+                name,
+                help: '',
+                signature: [],
+                error: e instanceof Error ? e.message : String(e),
+            });
+        }
+        onProgress?.(i + 1, methods.length);
+    }
+    return { generatedAt: new Date().toISOString(), methods: out };
+}
+
+// ─────────────────────────────────────────────────────────────
+// Markdown 渲染
+// ─────────────────────────────────────────────────────────────
+
+function renderSchema(schema: SchemaDescription): string {
+    // 简单的单行描述：kind + constraints + nullable
+    let s = schema.kind;
+    if (schema.nullable) s += ' | null';
+    const c = schema.constraints;
+    if (c && Object.keys(c).length > 0) {
+        const parts = Object.entries(c)
+            .filter(([, v]) => v !== undefined)
+            .map(([k, v]) => `${k}=${JSON.stringify(v)}`);
+        if (parts.length) s += ` { ${parts.join(', ')} }`;
+    }
+    return s;
+}
+
+function renderSchemaTree(schema: SchemaDescription, indent = 0): string[] {
+    const pad = '  '.repeat(indent);
+    const lines: string[] = [];
+    let head = `${pad}- \`${schema.kind}\``;
+    if (schema.nullable) head += ' _(nullable)_';
+    if (schema.description) head += ` — ${schema.description}`;
+    const c = schema.constraints;
+    if (c && Object.keys(c).length > 0) {
+        const parts = Object.entries(c)
+            .filter(([, v]) => v !== undefined)
+            .map(([k, v]) => `${k}=${JSON.stringify(v)}`);
+        if (parts.length) head += ` \`{ ${parts.join(', ')} }\``;
+    }
+    lines.push(head);
+
+    const ch = schema.children ?? {};
+    const pushChild = (label: string, child: SchemaDescription) => {
+        const sub = renderSchemaTree(child, indent + 1);
+        if (sub.length) {
+            sub[0] = `${'  '.repeat(indent + 1)}- **${label}**: ${sub[0].trim().replace(/^- /, '')}`;
+            lines.push(...sub);
+        }
+    };
+
+    if (isSchema(ch.inner)) pushChild('inner', ch.inner);
+    if (Array.isArray(ch.items)) {
+        (ch.items as unknown[]).forEach((it, i) => {
+            if (isSchema(it)) pushChild(`[${i}]`, it);
+        });
+    } else if (isSchema(ch.items)) {
+        pushChild('items', ch.items);
+    }
+    if (Array.isArray(ch.options)) {
+        (ch.options as unknown[]).forEach((opt, i) => {
+            if (isSchema(opt)) pushChild(`option[${i}]`, opt);
+        });
+    }
+    if (ch.properties && typeof ch.properties === 'object') {
+        for (const [k, v] of Object.entries(ch.properties)) {
+            if (isSchema(v)) pushChild(k, v);
+        }
+    }
+    if (isSchema(ch.values)) pushChild('values', ch.values);
+
+    return lines;
+}
+
+export function renderMarkdown(doc: ApiDoc): string {
+    const lines: string[] = [];
+    lines.push('# JSON-RPC API 文档');
+    lines.push('');
+    lines.push(`> 生成时间：${doc.generatedAt}`);
+    lines.push(`> 方法总数：${doc.methods.length}`);
+    lines.push('');
+    lines.push('## 目录');
+    lines.push('');
+    for (const m of doc.methods) {
+        const anchor = m.name.toLowerCase().replace(/[^\w]+/g, '-');
+        lines.push(`- [\`${m.name}\`](#${anchor})`);
+    }
+    lines.push('');
+
+    for (const m of doc.methods) {
+        lines.push(`## \`${m.name}\``);
+        lines.push('');
+        if (m.error) {
+            lines.push(`> ⚠️ 获取失败：${m.error}`);
+            lines.push('');
+            continue;
+        }
+        lines.push('**帮助**');
+        lines.push('');
+        lines.push(m.help ? m.help : '_（无帮助信息）_');
+        lines.push('');
+
+        if (m.signature.length === 0) {
+            lines.push('**签名**：_（无）_');
+            lines.push('');
+            continue;
+        }
+
+        const [ret, ...params] = m.signature;
+        lines.push('**返回类型**');
+        lines.push('');
+        lines.push(...renderSchemaTree(ret, 0));
+        lines.push('');
+        lines.push(`**参数**（${params.length} 个）`);
+        lines.push('');
+        if (params.length === 0) {
+            lines.push('_（无参数）_');
+        } else {
+            params.forEach((p, i) => {
+                const sub = renderSchemaTree(p, 0);
+                if (sub.length) {
+                    sub[0] = `- **参数 [${i}]**: ${sub[0].trim().replace(/^- /, '')}`;
+                    lines.push(...sub);
+                }
+            });
+        }
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    }
+
+    return lines.join('\n');
+}
+
+/** 触发浏览器下载 */
+export function downloadText(filename: string, text: string, mime = 'text/plain') {
+    const blob = new Blob([text], { type: `${mime};charset=utf-8` });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    setTimeout(() => URL.revokeObjectURL(url), 1000);
+}

package/webui/src/components/SchemaForm.tsx

@@ -120,7 +120,6 @@ function SchemaField({
                     <span className="sf-kind" style={{ color: colorOf('nullable') }}>
                         nullable
                     </span>
-                    <span className="sf-nullable">| null</span>
                     {!isNull && (
                         <button
                             type="button"

package/webui/src/components/Toolbar.tsx

@@ -7,6 +7,9 @@ interface ToolbarProps {
     onRefresh: () => void;
     loading: boolean;
     error: string | null;
+    /** 新增：生成文档 */
+    onGenerateDocs: () => void;
+    generatingDocs: boolean;
 }
 
 const THEME_OPTIONS: { value: ThemeMode; label: string }[] = [
@@ -21,6 +24,8 @@ export function Toolbar({
     onRefresh,
     loading,
     error,
+    onGenerateDocs,
+    generatingDocs,
 }: ToolbarProps) {
     const { mode, setMode } = useTheme();
 
@@ -49,9 +54,16 @@ export function Toolbar({
                 {loading ? '刷新中…' : '刷新方法列表'}
             </button>
 
+            <button
+                onClick={onGenerateDocs}
+                disabled={generatingDocs || loading || loading /* methods 空时由 App 拦截 */}
+                title="拉取所有方法的帮助与签名，生成 Markdown 文档并下载"
+            >
+                {generatingDocs ? '生成中…' : '生成文档 ⬇'}
+            </button>
+
             {error && <span className="error">{error}</span>}
 
-            {/* 主题下拉，放右上角 */}
             <label className="theme-select" title="主题">
                 <span className="theme-select-label">主题</span>
                 <select

package/dist/schema/index.d.ts

@@ -1,4 +0,0 @@
-export * from './primitives';
-export * from './rpc';
-export { z } from 'zod';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/schema/index.js

@@ -1,4 +0,0 @@
-export * from './primitives';
-export * from './rpc';
-export { z } from 'zod';
-//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/schema/primitives.d.ts

@@ -1,25 +0,0 @@
-import type { ParamSchema } from '../types';
-export interface ParamMeta {
-    kind?: 'void' | 'any' | 'array' | 'boolean' | 'function' | 'number' | 'object' | 'string' | 'symbol' | 'arrayOf' | 'objectOf' | 'shape' | 'oneOf' | 'oneOfType' | 'instanceOf' | 'injectable';
-    naming?: string;
-    required?: 'none' | 'isRequired' | 'isRequiredNotNull';
-    injectable?: string;
-    of?: unknown;
-}
-export declare function getMeta(schema: ParamSchema): ParamMeta;
-export declare function setJSONString(schema: ParamSchema, description: string): ParamSchema;
-export declare function toJSONString(schema: ParamSchema): string;
-export declare function voidSchema(): ParamSchema;
-export declare function anySchema(): ParamSchema;
-export declare function injectableSchema(name: string): ParamSchema;
-export declare function named(schema: ParamSchema, naming: string): ParamSchema;
-export declare function required(schema: ParamSchema): ParamSchema;
-export declare function requiredNotNull(schema: ParamSchema): ParamSchema;
-export declare function primitiveSchema(kind: 'void' | 'string' | 'number' | 'boolean' | 'function' | 'object' | 'symbol' | 'array'): ParamSchema;
-export declare function arrayOf(schema: ParamSchema): ParamSchema;
-export declare function objectOf(schema: ParamSchema): ParamSchema;
-export declare function oneOf<T extends readonly [string, ...string[]]>(values: T): ParamSchema;
-export declare function oneOfType(schemas: ParamSchema[]): ParamSchema;
-export declare function shape<T extends Record<string, ParamSchema>>(shapeMap: T): ParamSchema;
-export declare function instanceOf<T extends abstract new (...args: any[]) => any>(cls: T): ParamSchema;
-//# sourceMappingURL=primitives.d.ts.map

package/dist/schema/primitives.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/schema/primitives.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EACH,MAAM,GACN,KAAK,GACL,OAAO,GACP,SAAS,GACT,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,OAAO,GACP,OAAO,GACP,WAAW,GACX,YAAY,GACZ,YAAY,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,mBAAmB,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAOD,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAEtD;AA8BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAInF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMxD;AAED,wBAAgB,UAAU,IAAI,WAAW,CAIxC;AAED,wBAAgB,SAAS,IAAI,WAAW,CAIvC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAI1D;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAKtE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAKzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAKhE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAC1F,WAAW,CA8Bb;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAKxD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAKzD;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,WAAW,CAKtF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAa7D;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,WAAW,CAOrF;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,WAAW,CAO9F"}

package/dist/schema/primitives.js

@@ -1,153 +0,0 @@
-import { z } from 'zod';
-export function getMeta(schema) {
-    return schema.__meta ?? {};
-}
-function withMeta(schema, meta) {
-    const target = schema;
-    target.__meta = meta;
-    return schema;
-}
-function describe(meta) {
-    const kind = meta.kind ?? 'any';
-    switch (kind) {
-        case 'void':
-            return 'void';
-        case 'injectable':
-            return `injectable:${meta.injectable ?? 'unknown'}`;
-        case 'arrayOf':
-            return `arrayOf(${String(meta.of ?? 'any')})`;
-        case 'objectOf':
-            return `objectOf(${String(meta.of ?? 'any')})`;
-        case 'oneOf':
-            return `oneOf(${JSON.stringify(meta.of ?? [])})`;
-        case 'oneOfType':
-            return `oneOfType(${JSON.stringify(meta.of ?? [])})`;
-        case 'shape':
-            return `shape(${JSON.stringify(meta.of ?? {})})`;
-        default:
-            return kind;
-    }
-}
-export function setJSONString(schema, description) {
-    const target = schema;
-    target.toJSONString = () => description;
-    return schema;
-}
-export function toJSONString(schema) {
-    const target = schema;
-    if (typeof target.toJSONString === 'function') {
-        return target.toJSONString();
-    }
-    return describe(getMeta(schema));
-}
-export function voidSchema() {
-    const schema = z.undefined();
-    const result = withMeta(schema, { kind: 'void', required: 'none' });
-    return setJSONString(result, 'void');
-}
-export function anySchema() {
-    const schema = z.any();
-    const result = withMeta(schema, { kind: 'any' });
-    return setJSONString(result, 'any');
-}
-export function injectableSchema(name) {
-    const schema = z.any();
-    const result = withMeta(schema, { kind: 'injectable', injectable: name });
-    return setJSONString(result, `injectable:${name}`);
-}
-export function named(schema, naming) {
-    const meta = getMeta(schema);
-    withMeta(schema, { ...meta, naming });
-    const base = toJSONString(schema);
-    return setJSONString(schema, `${base}.named(${naming})`);
-}
-export function required(schema) {
-    const meta = getMeta(schema);
-    withMeta(schema, { ...meta, required: 'isRequired' });
-    const base = toJSONString(schema);
-    return setJSONString(schema, `${base}.isRequired`);
-}
-export function requiredNotNull(schema) {
-    const meta = getMeta(schema);
-    withMeta(schema, { ...meta, required: 'isRequiredNotNull' });
-    const base = toJSONString(schema);
-    return setJSONString(schema, `${base}.isRequiredNotNull`);
-}
-export function primitiveSchema(kind) {
-    let schema;
-    switch (kind) {
-        case 'string':
-            schema = z.string();
-            break;
-        case 'number':
-            schema = z.number();
-            break;
-        case 'boolean':
-            schema = z.boolean();
-            break;
-        case 'function':
-            schema = z.function();
-            break;
-        case 'object':
-            schema = z.object({}).passthrough();
-            break;
-        case 'array':
-            schema = z.array(z.any());
-            break;
-        case 'symbol':
-            schema = z.custom((value) => typeof value === 'symbol');
-            break;
-        case 'void':
-            schema = z.void();
-            break;
-    }
-    const result = withMeta(schema, { kind });
-    return setJSONString(result, kind);
-}
-export function arrayOf(schema) {
-    const inner = z.array(schema);
-    const description = describe({ kind: 'arrayOf', of: toJSONString(schema) });
-    const result = withMeta(inner, { kind: 'arrayOf', of: toJSONString(schema) });
-    return setJSONString(result, description);
-}
-export function objectOf(schema) {
-    const inner = z.record(schema);
-    const description = describe({ kind: 'objectOf', of: toJSONString(schema) });
-    const result = withMeta(inner, { kind: 'objectOf', of: toJSONString(schema) });
-    return setJSONString(result, description);
-}
-export function oneOf(values) {
-    const schema = z.enum(values);
-    const description = `oneOf(${JSON.stringify(values)})`;
-    const result = withMeta(schema, { kind: 'oneOf', of: values });
-    return setJSONString(result, description);
-}
-export function oneOfType(schemas) {
-    if (schemas.length === 0) {
-        throw new Error('oneOfType requires at least one schema.');
-    }
-    const [first, ...rest] = schemas;
-    if (!first)
-        throw new Error('oneOfType requires at least one schema.');
-    const union = rest.length === 0
-        ? first
-        : z.union([first, ...rest]);
-    const description = `oneOfType(${JSON.stringify(schemas.map((s) => toJSONString(s)))})`;
-    const result = withMeta(union, { kind: 'oneOfType', of: schemas.map((s) => toJSONString(s)) });
-    return setJSONString(result, description);
-}
-export function shape(shapeMap) {
-    const objectShape = z.object(shapeMap);
-    const description = `shape(${JSON.stringify(Object.fromEntries(Object.entries(shapeMap).map(([k, v]) => [k, toJSONString(v)])))})`;
-    const result = withMeta(objectShape, { kind: 'shape', of: shapeMap });
-    return setJSONString(result, description);
-}
-export function instanceOf(cls) {
-    // zod's instanceof typing is strict about concrete constructors;
-    // runtime behaviour is identical, so we bridge via unknown.
-    const schema = z.instanceof(cls);
-    const name = cls.name || '<<anonymous>>';
-    const result = withMeta(schema, { kind: 'instanceOf', of: name });
-    return setJSONString(result, `instanceOf(${name})`);
-}
-//# sourceMappingURL=primitives.js.map

package/dist/schema/primitives.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/schema/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB,MAAM,UAAU,OAAO,CAAC,MAAmB;IACzC,OAAQ,MAA6B,CAAC,MAAM,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,MAAmB,EAAE,IAAe;IACpD,MAAM,MAAM,GAAG,MAA4B,CAAC;IAC5C,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAe;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;IAChC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,YAAY;YACf,OAAO,cAAc,IAAI,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC;QACtD,KAAK,SAAS;YACZ,OAAO,WAAW,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC;QAChD,KAAK,UAAU;YACb,OAAO,YAAY,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC;QACjD,KAAK,OAAO;YACV,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;QACnD,KAAK,WAAW;YACd,OAAO,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;QACvD,KAAK,OAAO;YACV,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;QACnD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,WAAmB;IACpE,MAAM,MAAM,GAAG,MAA4B,CAAC;IAC5C,MAAM,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,MAAM,MAAM,GAAG,MAA4B,CAAC;IAC5C,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,OAAO,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,aAAa,CAAC,MAAM,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAmB,EAAE,MAAc;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,aAAa,CAAC,MAAM,EAAE,GAAG,IAAI,UAAU,MAAM,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAmB;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,aAAa,CAAC,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,aAAa,CAAC,MAAM,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAA2F;IAE3F,IAAI,MAAoB,CAAC;IACzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,UAAU;YACb,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM;QACR,KAAK,OAAO;YACV,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1B,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,CAAC,CAAC,MAAM,CAAS,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;YAChE,MAAM;QACR,KAAK,MAAM;YACT,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM;IACV,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,MAAmB;IACzC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9E,OAAO,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAmB;IAC1C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK,CAA2C,MAAS;IACvE,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,OAAO,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACvE,MAAM,KAAK,GACT,IAAI,CAAC,MAAM,KAAK,CAAC;QACf,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAoD,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,aAAa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxF,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/F,OAAO,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK,CAAwC,QAAW;IACtE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,SAAS,IAAI,CAAC,SAAS,CACzC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACnF,GAAG,CAAC;IACL,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtE,OAAO,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAiD,GAAM;IAC/E,iEAAiE;IACjE,4DAA4D;IAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,GAAyD,CAAC,CAAC;IACvF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,eAAe,CAAC;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,OAAO,aAAa,CAAC,MAAM,EAAE,cAAc,IAAI,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/schema/rpc.d.ts

@@ -1,21 +0,0 @@
-import { z } from 'zod';
-/** Strict JSON-RPC 2.0 request: id is required (string | number). */
-export declare const RequestSchema: z.ZodObject<{
-    jsonrpc: z.ZodLiteral<"2.0">;
-    method: z.ZodString;
-    params: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodUnknown, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
-    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-}, "strip", z.ZodTypeAny, {
-    jsonrpc: "2.0";
-    method: string;
-    id: string | number;
-    params?: Record<string, unknown> | unknown[] | undefined;
-}, {
-    jsonrpc: "2.0";
-    method: string;
-    id: string | number;
-    params?: Record<string, unknown> | unknown[] | undefined;
-}>;
-export type ParsedRequest = z.infer<typeof RequestSchema>;
-export declare function formatIssues(error: z.ZodError): string;
-//# sourceMappingURL=rpc.d.ts.map

package/dist/schema/rpc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/schema/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,wBAAgB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAOtD"}

package/dist/schema/rpc.js

@@ -1,17 +0,0 @@
-import { z } from 'zod';
-/** Strict JSON-RPC 2.0 request: id is required (string | number). */
-export const RequestSchema = z.object({
-    jsonrpc: z.literal('2.0'),
-    method: z.string().min(1),
-    params: z.union([z.array(z.unknown()), z.record(z.unknown())]).optional(),
-    id: z.union([z.string(), z.number()]),
-});
-export function formatIssues(error) {
-    return error.issues
-        .map((issue) => {
-        const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
-        return `${path}: ${issue.message}`;
-    })
-        .join('; ');
-}
-//# sourceMappingURL=rpc.js.map

package/dist/schema/rpc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/schema/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;CACtC,CAAC,CAAC;AAIH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,KAAK,CAAC,MAAM;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACrE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/stream/index.d.ts

@@ -1,3 +0,0 @@
-export { stringifySync, pipeStringify } from './stringify';
-export type { PipeOptions } from './stringify';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/stream/index.js

@@ -1,2 +0,0 @@
-export { stringifySync, pipeStringify } from './stringify';
-//# sourceMappingURL=index.js.map

package/dist/stream/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/stream/stringify.d.ts

@@ -1,19 +0,0 @@
-import type { Writable } from 'node:stream';
-/** Synchronous serializer that mirrors JSON.stringify but tolerates undefined values. */
-export declare function stringifySync(input: unknown): string;
-export interface PipeOptions {
-    /** HTTP status for streaming success (default 200). */
-    status?: number;
-    /** Additional headers to merge. */
-    headers?: Record<string, string>;
-}
-/**
- * Streams `value` to a writable (typically `express.Response`).
- * Sets headers on first chunk and always ends the response.
- */
-export declare function pipeStringify(value: unknown, res: Writable & {
-    setHeader(name: string, value: string): unknown;
-    status?(code: number): unknown;
-    end(): unknown;
-}, options?: PipeOptions): Promise<void>;
-//# sourceMappingURL=stringify.d.ts.map

package/dist/stream/stringify.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stringify.d.ts","sourceRoot":"","sources":["../../src/stream/stringify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgDpD;AA0GD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,GAAG,IAAI,OAAO,CAAC;CAChB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC3C"}