@yuhere/js-jsonrpc2 0.0.0-stage → 2.1.2

package/dist/core/Repository.js

@@ -0,0 +1,153 @@
+import { RPCError } from '../errors/RPCError';
+import { INTERNAL_ERROR, INVALID_REQUEST } from '../errors/codes';
+import { buildDescriptor, lookup, signatureOf } from './descriptor';
+import { convertParams } from './convert';
+import { checkPermission } from './permission';
+import { validateRequest } from './spec-check';
+import { registerSystemMethods } from './system-methods';
+import { registerSchema } from '../schema/z/register';
+import { RPCVersion } from "../schema/z/protocol";
+function formatRegisterIssues(error) {
+    return error.issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+        return `${path}: ${issue.message}`;
+    })
+        .join('; ');
+}
+function isAsyncIterable(v) {
+    return v != null && typeof v[Symbol.asyncIterator] === 'function';
+}
+export class Repository {
+    methods = new Map();
+    constructor(options = {}) {
+        if (options.withSystemMethods !== false) {
+            registerSystemMethods(this);
+        }
+    }
+    register(descriptor, fn) {
+        const result = registerSchema.safeParse([descriptor, fn]);
+        if (!result.success) {
+            throw new TypeError(`Invalid RPC descriptor: ${formatRegisterIssues(result.error)}`);
+        }
+        const built = buildDescriptor(descriptor, fn);
+        this.methods.set(built.namespace, built);
+    }
+    has(namespace) {
+        return this.methods.has(namespace);
+    }
+    list() {
+        return [...this.methods.keys()];
+    }
+    get(namespace) {
+        return this.methods.get(namespace);
+    }
+    signatureOf(descriptor) {
+        return signatureOf(descriptor);
+    }
+    async invoke(input, options = {}) {
+        const { injections = {}, errorTransform } = options;
+        try {
+            const request = validateRequest(input);
+            const id = request.id;
+            try {
+                const descriptor = lookup(this.methods, request.method);
+                await checkPermission(descriptor, injections);
+                const converted = await convertParams(descriptor, request.params, injections);
+                try { // errorTransform only apply when error occurs of actual call
+                    const result = await descriptor.fn.apply(descriptor, converted);
+                    const isStreamReturn = descriptor.shouldStreamReturn && isAsyncIterable(result);
+                    if (isStreamReturn) {
+                        return this.streamSuccess(id, result);
+                    }
+                    return { jsonrpc: RPCVersion, id, result };
+                }
+                catch (e0) {
+                    if (errorTransform) {
+                        const transformed = errorTransform(e0);
+                        if (transformed)
+                            return this.failure(id, transformed);
+                    }
+                    throw e0;
+                }
+            }
+            catch (error) {
+                if (error instanceof RPCError) {
+                    return this.failure(id, error);
+                }
+                const message = error instanceof Error ? error.message : String(error);
+                if (process.env['NODE_ENV'] !== 'production') {
+                    console.error('Internal JSON-RPC error when invoke method', message, error);
+                }
+                return this.failure(id, new RPCError(INTERNAL_ERROR, 'Internal error', message));
+            }
+        }
+        catch (e1) {
+            if (e1 instanceof RPCError) { // 
+                return this.failure(null, new RPCError(INVALID_REQUEST, 'Invalid Request', e1.message));
+            }
+            // ##############
+            const message = e1 instanceof Error ? e1.message : String(e1);
+            if (process.env['NODE_ENV'] !== 'production') {
+                console.error('Internal JSON-RPC error when invoke method', message, e1);
+            }
+            return this.failure(null, new RPCError(INTERNAL_ERROR, 'Internal error', message));
+        }
+    }
+    /**
+     * 把 handler 返回的 AsyncGenerator 包装成待消费的 chunk 流。
+     * 每帧都是完整的 RPCStreamChunk（含 jsonrpc/id）。
+     * 不做 chunk 的 schema 校验（按约定）。
+     * 正常结束发 {done:true,index}；异常终止发 {done:true,index?,error}。
+     */
+    async *streamChunks(id, source) {
+        let index = 0;
+        try {
+            while (true) {
+                const step = await source.next();
+                if (step.done) {
+                    yield { jsonrpc: RPCVersion, id, done: true, index };
+                    return;
+                }
+                yield { jsonrpc: RPCVersion, id, done: false, index: index++, value: step.value };
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const code = error instanceof RPCError ? error.code : INTERNAL_ERROR;
+            if (process.env['NODE_ENV'] !== 'production' && !(error instanceof RPCError)) {
+                console.error('Internal JSON-RPC stream error', message, error);
+            }
+            yield { jsonrpc: RPCVersion, id, done: true, index, error: { code, message } };
+        }
+        finally {
+            // 客户端断开或异常时，尽量让 handler 侧能感知并清理。
+            try {
+                await source.return?.(undefined);
+            }
+            catch {
+                /* ignore cleanup errors */
+            }
+        }
+    }
+    streamSuccess(id, source) {
+        return {
+            jsonrpc: RPCVersion,
+            id,
+            chunks: this.streamChunks(id, source),
+        };
+    }
+    failure(id, error) {
+        const data = process.env['NODE_ENV'] !== 'production' ? error.data : undefined;
+        const payload = error.toPayload();
+        if (data === undefined)
+            delete payload.data;
+        else
+            payload.data = data;
+        return { jsonrpc: RPCVersion, id, error: payload };
+    }
+}
+export function createRepository(options = {}) {
+    return new Repository(options);
+}
+//# sourceMappingURL=Repository.js.map

package/dist/core/Repository.js.map

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

package/dist/core/convert.d.ts

@@ -0,0 +1,4 @@
+import type { MethodDescriptor } from './descriptor';
+import type { Injectables } from '../types';
+export declare function convertParams(descriptor: MethodDescriptor, params: unknown, injections: Injectables): Promise<unknown[]>;
+//# sourceMappingURL=convert.d.ts.map

package/dist/core/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/core/convert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAsB,aAAa,CACjC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,OAAO,EAAE,CAAC,CAmCpB"}

package/dist/core/convert.js

@@ -0,0 +1,29 @@
+import { RPCError } from '../errors/RPCError';
+import { INVALID_PARAMS } from '../errors/codes';
+export async function convertParams(descriptor, params, injections) {
+    let raw = params;
+    if (raw === undefined || raw === null)
+        raw = [];
+    if (!Array.isArray(raw)) {
+        throw new RPCError(INVALID_PARAMS, 'Invalid params', 'The parameters must be an array.');
+    }
+    if (raw.length !== descriptor.indexed.length) {
+        throw new RPCError(INVALID_PARAMS, 'Invalid params', `Invalid parameters count. \`${raw.length}\` parameter(s) supplied to \`${descriptor.namespace}\`, expected \`${descriptor.indexed.length}\` parameter(s).`);
+    }
+    const converted = new Array(descriptor.paramsCount);
+    for (const injectable of descriptor.injectables) {
+        const rawValue = injections[injectable.name];
+        const value = typeof rawValue === 'function' ? await rawValue() : rawValue;
+        converted[injectable.originalIndex] = value;
+    }
+    for (let j = 0; j < descriptor.indexed.length; j++) {
+        const entry = descriptor.indexed[j];
+        const result = entry.schema.safeParse(raw[j]);
+        if (!result.success) {
+            throw new RPCError(INVALID_PARAMS, 'Invalid params', `Invalid parameter \`params[${j}]\` for \`${descriptor.namespace}\`: ${result.error.message}`);
+        }
+        converted[entry.originalIndex] = result.data;
+    }
+    return converted;
+}
+//# sourceMappingURL=convert.js.map

package/dist/core/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/core/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA4B,EAC5B,MAAe,EACf,UAAuB;IAEvB,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,GAAG,GAAG,EAAE,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,gBAAgB,EAAE,kCAAkC,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,gBAAgB,EAChB,+BAA+B,GAAG,CAAC,MAAM,iCAAiC,UAAU,CAAC,SAAS,kBAAkB,UAAU,CAAC,OAAO,CAAC,MAAM,kBAAkB,CAC5J,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,KAAK,CAAU,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7D,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAO,QAA6C,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjH,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,gBAAgB,EAChB,8BAA8B,CAAC,aAAa,UAAU,CAAC,SAAS,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAC9F,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/descriptor.d.ts

@@ -0,0 +1,27 @@
+import { RPCError } from '../errors/RPCError';
+import { Schema } from '../schema/json';
+import type { RPCDescriptor, RPCHandler, RPCSignature } from '../types';
+export interface IndexedParam {
+    schema: Schema<unknown>;
+    originalIndex: number;
+}
+export interface InjectableParam {
+    name: string;
+    originalIndex: number;
+}
+export interface MethodDescriptor {
+    namespace: string;
+    document?: RPCDescriptor['document'];
+    grantTo?: string[];
+    fn: RPCHandler;
+    indexed: IndexedParam[];
+    injectables: InjectableParam[];
+    paramsCount: number;
+    signature: RPCSignature;
+    shouldStreamReturn: boolean;
+}
+export declare function buildDescriptor(descriptor: RPCDescriptor, fn: RPCHandler): MethodDescriptor;
+export declare function signatureOf(descriptor: MethodDescriptor): unknown[];
+export declare function lookup(methods: Map<string, MethodDescriptor>, method: string): MethodDescriptor;
+export declare function invalidParams(message: string, data?: unknown): RPCError;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/core/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/core/descriptor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAA8C,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAA+B,MAAM,UAAU,CAAC;AAErG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAgBD,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,GAAG,gBAAgB,CAwC3F;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,EAAE,CAYnE;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAM/F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAEvE"}

package/dist/core/descriptor.js

@@ -0,0 +1,83 @@
+import { METHOD_NOT_FOUND, INVALID_PARAMS } from '../errors/codes';
+import { RPCError } from '../errors/RPCError';
+import { InjectableMarker, VoidMarker, StreamMarker, Schema } from '../schema/json';
+function normalizeGrantTo(grantTo) {
+    if (grantTo === undefined)
+        return undefined;
+    if (typeof grantTo === 'string')
+        return [grantTo];
+    if (!Array.isArray(grantTo)) {
+        throw new Error('grantTo should be an array or string.');
+    }
+    for (const item of grantTo) {
+        if (typeof item !== 'string') {
+            throw new Error('grantTo should be an array of string.');
+        }
+    }
+    return grantTo.slice();
+}
+export function buildDescriptor(descriptor, fn) {
+    const signs = descriptor.signature;
+    if (!Array.isArray(signs) || signs.length === 0) {
+        throw new Error('the signature should contain a return type as its first item.');
+    }
+    const head = signs[0];
+    if (head instanceof InjectableMarker) {
+        throw new Error('Invalid signature[0], the first signature could not be an injectable.');
+    }
+    const shouldStreamReturn = head instanceof StreamMarker;
+    const indexed = [];
+    const injectables = [];
+    for (let i = 1; i < signs.length; i++) {
+        const slot = signs[i];
+        if (slot instanceof InjectableMarker) {
+            injectables.push({ name: slot.key, originalIndex: i - 1 });
+        }
+        else if (slot instanceof Schema) {
+            indexed.push({ schema: slot, originalIndex: i - 1 });
+        }
+        else {
+            throw new Error(`Invalid signature slot at index ${i}.`);
+        }
+    }
+    const grantTo = normalizeGrantTo(descriptor.grantTo);
+    const result = {
+        namespace: descriptor.namespace,
+        fn,
+        indexed,
+        injectables,
+        paramsCount: indexed.length + injectables.length,
+        signature: signs,
+        shouldStreamReturn
+    };
+    if (descriptor.document !== undefined)
+        result.document = descriptor.document;
+    if (grantTo !== undefined)
+        result.grantTo = grantTo;
+    return result;
+}
+export function signatureOf(descriptor) {
+    return descriptor.signature
+        .filter((slot) => {
+        return !(slot instanceof InjectableMarker);
+    })
+        .map((slot) => {
+        if (slot instanceof VoidMarker)
+            return { kind: 'void' };
+        if (slot instanceof StreamMarker) {
+            return { kind: 'stream', children: { inner: slot.inner.toJSON() } };
+        }
+        return slot.toJSON();
+    });
+}
+export function lookup(methods, method) {
+    const found = methods.get(method);
+    if (!found) {
+        throw new RPCError(METHOD_NOT_FOUND, 'Method not found', JSON.stringify(method));
+    }
+    return found;
+}
+export function invalidParams(message, data) {
+    return new RPCError(INVALID_PARAMS, message, data);
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/core/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../src/core/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAyBpF,SAAS,gBAAgB,CAAC,OAAiC;IACzD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAyB,EAAE,EAAc;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,IAAI,YAAY,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,YAAY,YAAY,CAAC;IACxD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAsB,EAAE,CAAC;IAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,IAAI,YAAY,gBAAgB,EAAE,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,IAAI,IAAI,YAAY,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAqB;QAC/B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,EAAE;QACF,OAAO;QACP,WAAW;QACX,WAAW,EAAE,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM;QAChD,SAAS,EAAE,KAAK;QAChB,kBAAkB;KACnB,CAAC;IAEF,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IAC7E,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA4B;IACtD,OAAO,UAAU,CAAC,SAAS;SACxB,MAAM,CAAC,CAAC,IAAI,EAAmD,EAAE;QAChE,OAAO,CAAC,CAAC,IAAI,YAAY,gBAAgB,CAAC,CAAA;IAC5C,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,YAAY,UAAU;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACxD,IAAI,IAAI,YAAY,YAAY,EAAE,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAsC,EAAE,MAAc;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAc;IAC3D,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export { Repository, createRepository } from './Repository';
+export type { MethodDescriptor } from './descriptor';
+export { validateRequest } from './spec-check';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export { Repository, createRepository } from './Repository';
+export { validateRequest } from './spec-check';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/permission.d.ts

@@ -0,0 +1,4 @@
+import type { MethodDescriptor } from './descriptor';
+import type { Injectables } from '../types';
+export declare function checkPermission(descriptor: MethodDescriptor, injections: Injectables): Promise<void>;
+//# sourceMappingURL=permission.d.ts.map

package/dist/core/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../src/core/permission.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAsB,eAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB1G"}

package/dist/core/permission.js

@@ -0,0 +1,18 @@
+import { RPCError } from '../errors/RPCError';
+import { PERMISSION_DENIED } from '../errors/codes';
+export async function checkPermission(descriptor, injections) {
+    const grantTo = descriptor.grantTo;
+    if (!grantTo || grantTo.length === 0)
+        return;
+    const permCheck = injections['perm_check'];
+    if (typeof permCheck !== 'function')
+        return;
+    const result = await permCheck(grantTo, descriptor, injections);
+    if (result === true)
+        return;
+    if (result instanceof RPCError) {
+        throw result;
+    }
+    throw new RPCError(PERMISSION_DENIED, 'Permission denied', `one of ${JSON.stringify(grantTo)} is necessary for [${descriptor.namespace}].`);
+}
+//# sourceMappingURL=permission.js.map

package/dist/core/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/core/permission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKpD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAA4B,EAAE,UAAuB;IACzF,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE7C,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO;IAE5C,MAAM,MAAM,GAAG,MAAO,SAAmG,CACvH,OAAO,EACP,UAAU,EACV,UAAU,CACX,CAAC;IAEF,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO;IAE5B,IAAI,MAAM,YAAY,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC;IACf,CAAC;IAED,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,sBAAsB,UAAU,CAAC,SAAS,IAAI,CAAC,CAAC;AAC9I,CAAC"}

package/dist/core/spec-check.d.ts

@@ -0,0 +1,3 @@
+import type { RPCRequestInput } from '../types';
+export declare function validateRequest(input: unknown): RPCRequestInput;
+//# sourceMappingURL=spec-check.d.ts.map

package/dist/core/spec-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-check.d.ts","sourceRoot":"","sources":["../../src/core/spec-check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAM/D"}

package/dist/core/spec-check.js

@@ -0,0 +1,11 @@
+import { RPCRequestSchema } from '../schema/z/protocol';
+import { RPCError } from '../errors/RPCError';
+import { INVALID_REQUEST } from '../errors/codes';
+export function validateRequest(input) {
+    const result = RPCRequestSchema.safeParse(input);
+    if (!result.success) {
+        throw new RPCError(INVALID_REQUEST, 'Invalid Request', result.error.message);
+    }
+    return result.data;
+}
+//# sourceMappingURL=spec-check.js.map

package/dist/core/spec-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-check.js","sourceRoot":"","sources":["../../src/core/spec-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,IAAkC,CAAC;AACnD,CAAC"}

package/dist/core/system-methods.d.ts

@@ -0,0 +1,3 @@
+import type { Repository } from './Repository';
+export declare function registerSystemMethods(repository: Repository): void;
+//# sourceMappingURL=system-methods.d.ts.map

package/dist/core/system-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-methods.d.ts","sourceRoot":"","sources":["../../src/core/system-methods.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAkB/C,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CA+DlE"}

package/dist/core/system-methods.js

@@ -0,0 +1,76 @@
+// src/core/system-methods.ts
+import { RPCError } from '../errors/RPCError';
+import { METHOD_NOT_FOUND, PERMISSION_DENIED } from '../errors/codes';
+import { checkPermission } from './permission';
+import { s } from '../schema/json';
+function notFound(namespace) {
+    return new RPCError(METHOD_NOT_FOUND, 'Method not found', `Method not found.[${namespace}]`);
+}
+async function assertAccessible(descriptor, permCheck) {
+    try {
+        await checkPermission(descriptor, { perm_check: permCheck });
+    }
+    catch (error) {
+        if (error instanceof RPCError && error.code === PERMISSION_DENIED) {
+            throw notFound(descriptor.namespace);
+        }
+        throw error;
+    }
+}
+export function registerSystemMethods(repository) {
+    repository.register({
+        namespace: 'system.listMethods',
+        document: 'This method returns an array of strings, one for each method supported by the RPC server.',
+        signature: [s.array(s.string()), s.injectable('perm_check')],
+    }, async function systemListMethods(permCheck) {
+        const visible = [];
+        for (const name of repository.list()) {
+            const descriptor = repository.get(name);
+            if (!descriptor)
+                continue;
+            try {
+                await assertAccessible(descriptor, permCheck);
+                visible.push(name);
+            }
+            catch (error) {
+                if (error instanceof RPCError && error.code === METHOD_NOT_FOUND)
+                    continue;
+                throw error;
+            }
+        }
+        return visible;
+    });
+    repository.register({
+        namespace: 'system.methodSignature',
+        document: 'This method takes one parameter, the name of a method implemented by the RPC server.\n\n' +
+            'It returns an array of possible signatures for this method.\n' +
+            'A signature is an array of types.\n' +
+            'The first of these types is the return type of the method, the rest are parameters.\n',
+        signature: [s.array(s.unknown()), s.string(), s.injectable('perm_check')],
+    }, async function systemMethodSignature(namespace, permCheck) {
+        const descriptor = repository.get(namespace);
+        if (!descriptor)
+            throw notFound(namespace);
+        await assertAccessible(descriptor, permCheck);
+        return repository.signatureOf(descriptor);
+    });
+    repository.register({
+        namespace: 'system.methodHelp',
+        document: 'This method takes one parameter, the name of a method implemented by the RPC server.\n\n' +
+            'It returns a documentation string describing the use of that method.\n' +
+            'If no such string is available, an empty string is returned.\n' +
+            'The documentation string may contain HTML markup.\n',
+        signature: [s.string(), s.string(), s.injectable('perm_check')],
+    }, async function systemMethodHelp(namespace, permCheck) {
+        const descriptor = repository.get(namespace);
+        if (!descriptor)
+            throw notFound(namespace);
+        await assertAccessible(descriptor, permCheck);
+        const document = descriptor.document;
+        if (typeof document === 'function') {
+            return (await document(descriptor)) ?? null;
+        }
+        return document === undefined ? null : document;
+    });
+}
+//# sourceMappingURL=system-methods.js.map

package/dist/core/system-methods.js.map

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

package/dist/errors/RpcError.d.ts

@@ -0,0 +1,9 @@
+import type { RPCErrorPayload } from '../types';
+export declare class RPCError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+    toPayload(): RPCErrorPayload;
+    toJSON(): RPCErrorPayload;
+}
+//# sourceMappingURL=RPCError.d.ts.map

package/dist/errors/RpcError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RPCError.d.ts","sourceRoot":"","sources":["../../src/errors/RPCError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAExB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAOxD;IAED,SAAS,IAAI,eAAe,CAI3B;IAED,MAAM,IAAI,eAAe,CAExB;CACF"}

package/dist/errors/RpcError.js

@@ -0,0 +1,23 @@
+export class RPCError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'RPCError';
+        this.code = code;
+        if (data !== undefined)
+            this.data = data;
+        // Restore prototype chain in transpiled output.
+        Object.setPrototypeOf(this, RPCError.prototype);
+    }
+    toPayload() {
+        const payload = { code: this.code, message: this.message };
+        if (this.data !== undefined)
+            payload.data = this.data;
+        return payload;
+    }
+    toJSON() {
+        return this.toPayload();
+    }
+}
+//# sourceMappingURL=RPCError.js.map

package/dist/errors/RpcError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RPCError.js","sourceRoot":"","sources":["../../src/errors/RPCError.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,IAAI,CAAW;IAExB,YAAY,IAAY,EAAE,OAAe,EAAE,IAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACzC,gDAAgD;QAChD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,SAAS;QACP,MAAM,OAAO,GAAoB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5E,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/errors/codes.d.ts

@@ -0,0 +1,7 @@
+export declare const PARSE_ERROR = -32700;
+export declare const INVALID_REQUEST = -32600;
+export declare const METHOD_NOT_FOUND = -32601;
+export declare const INVALID_PARAMS = -32602;
+export declare const INTERNAL_ERROR = -32603;
+export declare const PERMISSION_DENIED = -32604;
+//# sourceMappingURL=codes.d.ts.map

package/dist/errors/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,eAAe,SAAS,CAAC;AACtC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,iBAAiB,SAAS,CAAC"}

package/dist/errors/codes.js

@@ -0,0 +1,7 @@
+export const PARSE_ERROR = -32700;
+export const INVALID_REQUEST = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS = -32602;
+export const INTERNAL_ERROR = -32603;
+export const PERMISSION_DENIED = -32604;
+//# sourceMappingURL=codes.js.map

package/dist/errors/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { RPCError } from './RPCError';
+export * from './codes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+export { RPCError } from './RPCError';
+export * from './codes';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { Repository, createRepository } from './core/Repository';
+import { RPCError } from './errors/RPCError';
+import * as codes from './errors/codes';
+import { s } from './schema/json';
+export { Repository, createRepository };
+export { RPCError };
+export { codes };
+export { s };
+export * from './types';
+import { createExpressRouter } from './transport/express';
+export { createExpressRouter };
+import { attachWebSocket, createWebSocketServer } from './transport/ws';
+import { serveStdio } from './transport/stdio';
+export { attachWebSocket, createWebSocketServer, serveStdio };
+export type { WSOptions, StandaloneWsOptions, StandaloneWsHandle } from './transport/ws';
+export type { StdioOptions } from './transport/stdio';
+export type { ExpressOptions } from './transport/express';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,OAAO,EAAE,CAAC,EAAE,CAAC;AACb,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzF,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}