@rpckit/core 0.9.99

package/dist/parse.js

@@ -0,0 +1,310 @@
+function parseOptions(query) {
+    const options = {};
+    if (!query)
+        return options;
+    for (const pair of query.split('&')) {
+        const [key, value] = pair.split('=');
+        if (key && value !== undefined) {
+            options[key] = decodeURIComponent(value);
+        }
+    }
+    return options;
+}
+function inferType(scheme) {
+    switch (scheme) {
+        case 'ws':
+        case 'wss':
+            return 'websocket';
+        case 'tcp':
+        case 'tcp+tls':
+            return 'tcp';
+        case 'http':
+        case 'https':
+            return 'http';
+        default:
+            throw new Error(`Unknown scheme: ${scheme}`);
+    }
+}
+function findMatchingParen(str, start) {
+    let depth = 1;
+    for (let i = start; i < str.length; i++) {
+        if (str[i] === '(')
+            depth++;
+        else if (str[i] === ')') {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+function splitArgs(str) {
+    const args = [];
+    let current = '';
+    let depth = 0;
+    for (const char of str) {
+        if (char === '(') {
+            depth++;
+            current += char;
+        }
+        else if (char === ')') {
+            depth--;
+            current += char;
+        }
+        else if (char === ',' && depth === 0) {
+            args.push(current.trim());
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.trim()) {
+        args.push(current.trim());
+    }
+    return args;
+}
+function parseTransport(input) {
+    input = input.trim();
+    // Check for meta-transports: fallback(...) or cluster(...)
+    const metaMatch = input.match(/^(fallback|cluster)\(/);
+    if (metaMatch) {
+        const type = metaMatch[1];
+        const argsStart = metaMatch[0].length;
+        const argsEnd = findMatchingParen(input, argsStart);
+        if (argsEnd === -1) {
+            throw new Error(`Unmatched parenthesis in: ${input}`);
+        }
+        const argsStr = input.slice(argsStart, argsEnd);
+        const afterParen = input.slice(argsEnd + 1);
+        // Parse options after closing paren: cluster(...)?timeout=1000
+        let options = {};
+        if (afterParen.startsWith('?')) {
+            options = parseOptions(afterParen.slice(1));
+        }
+        const args = splitArgs(argsStr);
+        if (type === 'cluster') {
+            // First arg is quorum number
+            const quorum = Number.parseInt(args[0], 10);
+            if (Number.isNaN(quorum) || quorum < 1) {
+                throw new Error(`Invalid quorum value: ${args[0]}`);
+            }
+            const children = args.slice(1).map(parseTransport);
+            return { type, options, children, quorum };
+        }
+        const children = args.map(parseTransport);
+        return { type, options, children };
+    }
+    // Simple transport URL: wss://host:port?timeout=1000
+    const urlMatch = input.match(/^([a-z+]+):\/\/([^?]+)(?:\?(.*))?$/);
+    if (!urlMatch) {
+        throw new Error(`Invalid transport URL: ${input}`);
+    }
+    const [, scheme, rest, query] = urlMatch;
+    const type = inferType(scheme);
+    const url = `${scheme}://${rest}`;
+    const options = parseOptions(query || '');
+    return { type, url, options };
+}
+const KEY_ALIASES = { webSocket: 'websocket' };
+function normalizeKeys(map) {
+    const result = {};
+    for (const [key, value] of Object.entries(map)) {
+        result[KEY_ALIASES[key] ?? key] = value;
+    }
+    return result;
+}
+const DEFAULT_PACKAGE_MAP = {
+    websocket: '@rpckit/websocket',
+    tcp: '@rpckit/tcp',
+    http: '@rpckit/http',
+    fallback: '@rpckit/fallback',
+    cluster: '@rpckit/cluster',
+};
+const EXPORT_MAP = {
+    websocket: 'webSocket',
+    tcp: 'tcp',
+    http: 'http',
+    fallback: 'fallback',
+    cluster: 'cluster',
+};
+async function loadFactory(type, packageMap) {
+    const pkg = packageMap[type];
+    const exportName = EXPORT_MAP[type];
+    try {
+        const module = await import(pkg);
+        return module[exportName];
+    }
+    catch {
+        throw new Error(`Package ${pkg} is not installed. Run: npm install ${pkg}`);
+    }
+}
+function buildOptions(options) {
+    const result = {};
+    for (const [key, value] of Object.entries(options)) {
+        // Parse numeric values
+        if (key === 'timeout' ||
+            key === 'connectTimeout' ||
+            key === 'keepAlive' ||
+            key === 'quorum' ||
+            key === 'retryCount' ||
+            key === 'retryDelay') {
+            result[key] = Number.parseInt(value, 10);
+        }
+        // Parse boolean values
+        else if (key === 'rank' || key === 'eagerConnect') {
+            result[key] = value === 'true';
+        }
+        // batch can be boolean or will be built from batchSize/batchWait
+        else if (key === 'batch') {
+            result[key] = value === 'true';
+        }
+        // Skip batchSize/batchWait - handled below
+        else if (key === 'batchSize' || key === 'batchWait') {
+            // handled after loop
+        }
+        // Keep strings as-is
+        else {
+            result[key] = value;
+        }
+    }
+    // Build batch config from batchSize/batchWait
+    if (options.batchSize || options.batchWait) {
+        const batchConfig = {};
+        if (options.batchSize) {
+            batchConfig.batchSize = Number.parseInt(options.batchSize, 10);
+        }
+        if (options.batchWait) {
+            batchConfig.wait = Number.parseInt(options.batchWait, 10);
+        }
+        result.batch = batchConfig;
+    }
+    return result;
+}
+function createBuildTransport(packageMap) {
+    async function buildTransport(parsed) {
+        const factory = await loadFactory(parsed.type, packageMap);
+        const options = buildOptions(parsed.options);
+        if (parsed.type === 'fallback' && parsed.children) {
+            const transports = await Promise.all(parsed.children.map(buildTransport));
+            return factory(transports, options);
+        }
+        if (parsed.type === 'cluster' && parsed.children) {
+            const transports = await Promise.all(parsed.children.map(buildTransport));
+            return factory(transports, { quorum: parsed.quorum, ...options });
+        }
+        // Simple transport
+        if (!parsed.url) {
+            throw new Error(`Missing URL for ${parsed.type} transport`);
+        }
+        return factory(parsed.url, options);
+    }
+    return buildTransport;
+}
+/**
+ * Create a `parse` function that uses a custom package map for dynamic imports.
+ *
+ * Override specific transport types while keeping defaults for the rest.
+ * Useful for creating protocol-specific parse variants (e.g. electrum-cash).
+ */
+export function createParse(overrides) {
+    const packageMap = { ...DEFAULT_PACKAGE_MAP, ...normalizeKeys(overrides) };
+    const buildTransport = createBuildTransport(packageMap);
+    return async (input) => {
+        const parsed = parseTransport(input);
+        const transport = await buildTransport(parsed);
+        return transport;
+    };
+}
+/**
+ * Create a synchronous `parse` function using pre-imported factory functions.
+ *
+ * Unlike `createParse` which uses dynamic imports, this variant accepts
+ * already-loaded factory functions, making it fully synchronous.
+ *
+ * @example
+ * ```typescript
+ * import { webSocket } from '@rpckit/websocket/electrum-cash'
+ * import { fallback } from '@rpckit/fallback'
+ * import { createParseSync } from '@rpckit/core'
+ *
+ * const parseSync = createParseSync({ webSocket, fallback })
+ * const transport = parseSync('fallback(wss://a.com,wss://b.com)?eagerConnect=true')
+ * ```
+ */
+export function createParseSync(factories) {
+    const normalized = normalizeKeys(factories);
+    function buildTransport(parsed) {
+        const factory = normalized[parsed.type];
+        if (!factory) {
+            throw new Error(`No factory for transport type "${parsed.type}". Available: ${Object.keys(normalized).join(', ')}`);
+        }
+        const options = buildOptions(parsed.options);
+        if (parsed.type === 'fallback' && parsed.children) {
+            const transports = parsed.children.map(buildTransport);
+            return factory(transports, options);
+        }
+        if (parsed.type === 'cluster' && parsed.children) {
+            const transports = parsed.children.map(buildTransport);
+            return factory(transports, { quorum: parsed.quorum, ...options });
+        }
+        if (!parsed.url) {
+            throw new Error(`Missing URL for ${parsed.type} transport`);
+        }
+        return factory(parsed.url, options);
+    }
+    return (input) => {
+        const parsed = parseTransport(input);
+        const transport = buildTransport(parsed);
+        return transport;
+    };
+}
+/**
+ * Parse a transport one-liner string into a Transport instance.
+ *
+ * @example
+ * ```typescript
+ * // Simple transports
+ * const ws = await parse('wss://example.com')
+ * const tcp = await parse('tcp+tls://host:50002?timeout=10000')
+ *
+ * // Meta-transports
+ * const fb = await parse('fallback(wss://a.com,tcp://b.com)')
+ * const cl = await parse('cluster(2,ws://1.com,ws://2.com,ws://3.com)')
+ *
+ * // Nested
+ * const nested = await parse('fallback(wss://a.com,cluster(2,ws://1.com,ws://2.com))')
+ *
+ * // With options
+ * const withOpts = await parse('wss://example.com?timeout=10000&keepAlive=30000')
+ * const batched = await parse('wss://example.com?batchSize=10&batchWait=50')
+ * const fbRanked = await parse('fallback(wss://a.com,tcp://b.com)?rank=true')
+ * ```
+ *
+ * Supported schemes:
+ * - `wss://`, `ws://` → @rpckit/websocket
+ * - `tcp://`, `tcp+tls://` → @rpckit/tcp
+ * - `http://`, `https://` → @rpckit/http
+ * - `fallback(...)` → @rpckit/fallback
+ * - `cluster(quorum,...)` → @rpckit/cluster
+ *
+ * Supported options (via query params):
+ * - `timeout` - Request timeout in ms
+ * - `keepAlive` - Keep-alive ping interval in ms
+ * - `batch` - Enable batching (true/false)
+ * - `batchSize` - Max requests per batch
+ * - `batchWait` - Max wait time before flushing batch (ms)
+ * - `rank` - Enable health ranking for fallback (true/false)
+ * - `eagerConnect` - Connect all fallback transports in parallel (true/false)
+ * - `clientName` - Client name for electrum-cash handshake (default: 'rpckit')
+ * - `protocolVersion` - Protocol version for electrum-cash handshake (default: '1.6')
+ *
+ * Packages are loaded dynamically at runtime. Missing packages throw an error.
+ */
+export async function parse(input) {
+    const buildTransport = createBuildTransport(DEFAULT_PACKAGE_MAP);
+    const parsed = parseTransport(input);
+    const transport = await buildTransport(parsed);
+    return transport;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAWA,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAA;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,GAAG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,SAAS,CAChB,MAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,IAAI,CAAC;QACV,KAAK,KAAK;YACR,OAAO,WAAW,CAAA;QACpB,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,KAAK,CAAA;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,MAAM,CAAA;QACf;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAA;IAChD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW,EAAE,KAAa;IACnD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAA;aACtB,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,EAAE,CAAA;YACP,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAA;AACX,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,IAAI,OAAO,GAAG,EAAE,CAAA;IAChB,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,KAAK,EAAE,CAAA;YACP,OAAO,IAAI,IAAI,CAAA;QACjB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,EAAE,CAAA;YACP,OAAO,IAAI,IAAI,CAAA;QACjB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;YACzB,OAAO,GAAG,EAAE,CAAA;QACd,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,IAAI,CAAA;QACjB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAEpB,2DAA2D;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACtD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAA2B,CAAA;QACnD,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAEnD,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAA;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;QAE3C,+DAA+D;QAC/D,IAAI,OAAO,GAA2B,EAAE,CAAA;QACxC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7C,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;QAE/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,6BAA6B;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YACrD,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;IACpC,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAA;IACxC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAG,GAAG,MAAM,MAAM,IAAI,EAAE,CAAA;IACjC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAEzC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;AAC/B,CAAC;AAQD,MAAM,WAAW,GAA2B,EAAE,SAAS,EAAE,WAAW,EAAE,CAAA;AAEtE,SAAS,aAAa,CAAI,GAAsB;IAC9C,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAA;IACzC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,mBAAmB,GAAe;IACtC,SAAS,EAAE,mBAAmB;IAC9B,GAAG,EAAE,aAAa;IAClB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,iBAAiB;CAC3B,CAAA;AAED,MAAM,UAAU,GAA2B;IACzC,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,KAAK,UAAU,WAAW,CACxB,IAA2D,EAC3D,UAAsB;IAEtB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAEnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;QAChC,OAAO,MAAM,CAAC,UAAU,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,uCAAuC,GAAG,EAAE,CAAC,CAAA;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,OAA+B;IAE/B,MAAM,MAAM,GAA4B,EAAE,CAAA;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,uBAAuB;QACvB,IACE,GAAG,KAAK,SAAS;YACjB,GAAG,KAAK,gBAAgB;YACxB,GAAG,KAAK,WAAW;YACnB,GAAG,KAAK,QAAQ;YAChB,GAAG,KAAK,YAAY;YACpB,GAAG,KAAK,YAAY,EACpB,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAC1C,CAAC;QACD,uBAAuB;aAClB,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,CAAA;QAChC,CAAC;QACD,iEAAiE;aAC5D,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,CAAA;QAChC,CAAC;QACD,2CAA2C;aACtC,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACpD,qBAAqB;QACvB,CAAC;QACD,qBAAqB;aAChB,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,WAAW,GAA0C,EAAE,CAAA;QAC7D,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,MAAM,CAAC,KAAK,GAAG,WAAW,CAAA;IAC5B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAsB;IAClD,KAAK,UAAU,cAAc,CAAC,MAAuB;QACnD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5C,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;YACzE,OAAO,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACrC,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;YACzE,OAAO,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QACnE,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,YAAY,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,cAAc,CAAA;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,SAAqB;IAErB,MAAM,UAAU,GAAG,EAAE,GAAG,mBAAmB,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,CAAA;IAC1E,MAAM,cAAc,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAA;IAEvD,OAAO,KAAK,EACV,KAAa,EACU,EAAE;QACzB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;QAC9C,OAAO,SAAoC,CAAA;IAC7C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAqB;IAErB,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;IAC3C,SAAS,cAAc,CAAC,MAAuB;QAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kCAAkC,MAAM,CAAC,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnG,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5C,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACtD,OAAO,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACrC,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACtD,OAAO,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QACnE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,YAAY,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,CAA+B,KAAa,EAAgB,EAAE;QACnE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;QACxC,OAAO,SAAoC,CAAA;IAC7C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,KAAa;IAEb,MAAM,cAAc,GAAG,oBAAoB,CAAC,mBAAmB,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IACpC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;IAC9C,OAAO,SAAoC,CAAA;AAC7C,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,22 @@
+export interface RpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown[];
+    id: number;
+}
+export interface RpcResponse {
+    jsonrpc: '2.0';
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    id: number;
+}
+export interface SubscriptionNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params: unknown[];
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACzD,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB"}

package/dist/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,9 @@
+export interface RetryOptions {
+    retryCount?: number;
+    retryDelay?: number;
+}
+/**
+ * Execute an async function with exponential backoff retry.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAKD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/retry.js

@@ -0,0 +1,26 @@
+const DEFAULT_RETRY_COUNT = 3;
+const DEFAULT_RETRY_DELAY = 150;
+/**
+ * Execute an async function with exponential backoff retry.
+ */
+export async function withRetry(fn, options = {}) {
+    const maxAttempts = (options.retryCount ?? DEFAULT_RETRY_COUNT) + 1;
+    const baseDelay = options.retryDelay ?? DEFAULT_RETRY_DELAY;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxAttempts) {
+                break;
+            }
+            // Exponential backoff: delay * 2^(attempt-1)
+            const delay = baseDelay * 2 ** (attempt - 1);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAKA,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAC7B,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAA;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAA;IAE3D,IAAI,SAAkB,CAAA;IAEtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAA;YAEjB,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;gBAC5B,MAAK;YACP,CAAC;YAED,6CAA6C;YAC7C,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;YAC5C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAA;AACjB,CAAC"}

package/dist/schema-utils.d.ts

@@ -0,0 +1,28 @@
+/** Filter out entries with a specific method from a tuple */
+export type FilterMethod<T extends readonly unknown[], M extends string> = T extends readonly [infer Head, ...infer Tail] ? Head extends {
+    method: M;
+} ? FilterMethod<Tail, M> : [Head, ...FilterMethod<Tail, M>] : [];
+/** Filter out multiple methods from a tuple */
+export type FilterMethods<T extends readonly unknown[], Entries extends readonly {
+    method: string;
+}[]> = Entries extends readonly [
+    infer E extends {
+        method: string;
+    },
+    ...infer Rest extends {
+        method: string;
+    }[]
+] ? FilterMethods<FilterMethod<T, E['method']>, Rest> : T;
+/** Override request methods in a schema */
+export type OverrideRequests<S extends {
+    requests: readonly unknown[];
+    subscriptions: readonly unknown[];
+}, NewEntries extends readonly {
+    method: string;
+    params: unknown[];
+    return: unknown;
+}[]> = {
+    requests: [...FilterMethods<S['requests'], NewEntries>, ...NewEntries];
+    subscriptions: S['subscriptions'];
+};
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schema-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.d.ts","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,MAAM,YAAY,CACtB,CAAC,SAAS,SAAS,OAAO,EAAE,EAC5B,CAAC,SAAS,MAAM,IACd,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,GAC9C,IAAI,SAAS;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,GACxB,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,GACrB,CAAC,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAClC,EAAE,CAAA;AAEN,+CAA+C;AAC/C,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,SAAS,OAAO,EAAE,EAC5B,OAAO,SAAS,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,IAC3C,OAAO,SAAS,SAAS;IAC3B,MAAM,CAAC,SAAS;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAClC,GAAG,MAAM,IAAI,SAAS;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;CAC3C,GACG,aAAa,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GACjD,CAAC,CAAA;AAEL,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS;IAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAAC,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,EAC7E,UAAU,SAAS,SAAS;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB,EAAE,IACD;IACF,QAAQ,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,UAAU,CAAC,CAAA;IACtE,aAAa,EAAE,CAAC,CAAC,eAAe,CAAC,CAAA;CAClC,CAAA"}

package/dist/schema-utils.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-utils.js.map

package/dist/schema-utils.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,32 @@
+export type SchemaEntry = {
+    method: string;
+    params: unknown[];
+    return: unknown;
+};
+export type Schema = {
+    requests: SchemaEntry[];
+    subscriptions: SchemaEntry[];
+};
+export type AnySchema = {
+    requests: [{
+        method: string;
+        params: unknown[];
+        return: unknown;
+    }];
+    subscriptions: [{
+        method: string;
+        params: unknown[];
+        return: unknown;
+    }];
+};
+type AllEntries<S extends Schema> = [...S['requests'], ...S['subscriptions']];
+export type ExtractMethod<S extends Schema> = AllEntries<S>[number]['method'];
+export type ExtractRequestMethod<S extends Schema> = S['requests'][number]['method'];
+export type ExtractSubscriptionMethod<S extends Schema> = S['subscriptions'][number]['method'];
+export type ExtractEntry<S extends Schema, M extends string> = Extract<AllEntries<S>[number], {
+    method: M;
+}>;
+export type ExtractReturn<S extends Schema, M extends string> = ExtractEntry<S, M> extends never ? unknown : ExtractEntry<S, M>['return'];
+export type ExtractParams<S extends Schema, M extends string> = ExtractEntry<S, M> extends never ? unknown[] : ExtractEntry<S, M>['params'];
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAEhF,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAG9E,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAClE,aAAa,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACxE,CAAA;AAED,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAA;AAE7E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;AAE7E,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAC/C,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;AAEjC,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,MAAM,IACpD,CAAC,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;AAEtC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CACpE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EACrB;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CACd,CAAA;AAGD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,YAAY,CAC1E,CAAC,EACD,CAAC,CACF,SAAS,KAAK,GACX,OAAO,GACP,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;AAEhC,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,YAAY,CAC1E,CAAC,EACD,CAAC,CACF,SAAS,KAAK,GACX,OAAO,EAAE,GACT,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA"}

package/dist/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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