@rpckit/fallback 0.9.99

package/README.md

@@ -0,0 +1,107 @@
+# @rpckit/fallback
+
+Fallback meta-transport for rpckit. Provides automatic failover across multiple transports with optional health-based ranking.
+
+## Installation
+
+```bash
+npm install @rpckit/core @rpckit/fallback
+```
+
+## Usage
+
+```typescript
+import { fallback } from '@rpckit/fallback'
+import { webSocket } from '@rpckit/websocket'
+import { http } from '@rpckit/http'
+
+const transport = fallback([
+  webSocket('wss://primary.example.com'),
+  http('https://backup.example.com'),
+])
+
+await transport.connect()
+
+// Automatically tries next transport on failure
+const result = await transport.request('my.method', 'param')
+
+await transport.close()
+```
+
+## Options
+
+- `shouldThrow` - `(error: Error) => boolean | undefined` to control fallback behavior per error. Return `true` to throw immediately, `false` to continue to next transport, or `undefined` to use default logic. By default, deterministic JSON-RPC errors (parse error, invalid request, invalid params) stop the fallback chain.
+- `rank` - `true` or `{ interval, sampleCount, timeout, weights, ping }` for health ranking
+- `eagerConnect` - Connect to all transports in parallel (fastest transport is prioritized)
+
+## Health Ranking
+
+When `rank` is enabled, transports are periodically pinged and ranked by latency and stability. Requests are routed to the best-performing transport first.
+
+**Note:** Without a `ping` function, ranking has no way to probe transport health and will not collect samples — effectively making it a no-op. Provide a `ping` function appropriate for your protocol.
+
+```typescript
+const transport = fallback(transports, {
+  rank: {
+    interval: 4000,      // ms between health checks (default: 4000)
+    timeout: 1000,       // ping timeout in ms (default: 1000)
+    sampleCount: 10,     // number of samples to average (default: 10)
+    weights: {
+      latency: 0.3,      // weight for latency score (default: 0.3)
+      stability: 0.7,    // weight for stability score (default: 0.7)
+    },
+    ping: (t) => t.request('health.check'),  // provide a ping function for your protocol
+  },
+})
+```
+
+### Accessing Scores
+
+```typescript
+// Get current scores
+console.log(transport.scores)
+// [{ transport, score, latency, stability }, ...]
+
+// Get ranked transport list
+console.log(transport.transports)
+
+// Subscribe to score updates
+const unsub = transport.onScores((scores) => {
+  console.log('Scores updated:', scores)
+})
+// Later: unsub()
+```
+
+## Electrum Cash Variant
+
+The `@rpckit/fallback/electrum-cash` subpath provides a variant with `server.ping` as the default ping function for health ranking and a protocol-aware `shouldThrow` that retries on transient server errors (internal error, OOM, warmup, syncing) while stopping on deterministic errors (invalid params, bad address, etc.):
+
+```typescript
+import { fallback } from '@rpckit/fallback/electrum-cash'
+import { webSocket } from '@rpckit/websocket/electrum-cash'
+
+const transport = fallback([
+  webSocket('wss://server1.example.com:50004'),
+  webSocket('wss://server2.example.com:50004'),
+], { rank: true })  // Uses server.ping for health checks
+```
+
+The `shouldThrow` function is also exported for use in custom configurations:
+
+```typescript
+import { shouldThrow } from '@rpckit/fallback/electrum-cash'
+```
+
+## Response Observation
+
+Monitor all requests and responses across transports:
+
+```typescript
+const unsub = transport.onResponse(({ method, params, transport, response, error, status }) => {
+  console.log(`${method} via ${transport.url}: ${status}`)
+  if (status === 'error') {
+    console.error('Failed:', error)
+  }
+})
+// Later: unsub()
+```

package/dist/electrum-cash/fallback.d.ts

@@ -0,0 +1,8 @@
+import type { FallbackTransport, FallbackTransportOptions } from '@rpckit/core';
+/** Default shouldThrow for Electrum Cash / BCHN: throws for all deterministic
+ *  RPC errors (invalid params, bad address, verify rejected, etc.) and falls
+ *  through on transient server-health issues (internal error, OOM, warmup). */
+export declare function shouldThrow(error: Error): boolean | undefined;
+export declare function fallback<T>(transports: [T], options?: FallbackTransportOptions): T;
+export declare function fallback<T>(transports: [T, T, ...T[]], options?: FallbackTransportOptions): FallbackTransport;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/electrum-cash/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/electrum-cash/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,iBAAiB,EACjB,wBAAwB,EAIzB,MAAM,cAAc,CAAA;AAarB;;+EAE+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAQ7D;AAGD,wBAAgB,QAAQ,CAAC,CAAC,EACxB,UAAU,EAAE,CAAC,CAAC,CAAC,EACf,OAAO,CAAC,EAAE,wBAAwB,GACjC,CAAC,CAAA;AAGJ,wBAAgB,QAAQ,CAAC,CAAC,EACxB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,iBAAiB,CAAA"}

package/dist/electrum-cash/fallback.js

@@ -0,0 +1,40 @@
+import { fallback as baseFallback } from '../fallback.js';
+/** Transient server-specific errors worth retrying on another server. */
+const TRANSIENT_CODES = new Set([
+    -32603, // RPC_INTERNAL_ERROR — server corruption/bug
+    -7, // RPC_OUT_OF_MEMORY
+    -20, // RPC_DATABASE_ERROR
+    -28, // RPC_IN_WARMUP — server still starting
+    -9, // RPC_CLIENT_NOT_CONNECTED — server's node disconnected
+    -10, // RPC_CLIENT_IN_INITIAL_DOWNLOAD — server still syncing
+]);
+/** Default shouldThrow for Electrum Cash / BCHN: throws for all deterministic
+ *  RPC errors (invalid params, bad address, verify rejected, etc.) and falls
+ *  through on transient server-health issues (internal error, OOM, warmup). */
+export function shouldThrow(error) {
+    if ('code' in error &&
+        typeof error.code === 'number') {
+        return !TRANSIENT_CODES.has(error.code);
+    }
+    return false;
+}
+// Implementation
+export function fallback(transports, options = {}) {
+    // biome-ignore lint/suspicious/noExplicitAny: overload forwarding requires type erasure
+    return baseFallback(transports, resolveOptions(options));
+}
+function resolveOptions(options) {
+    const resolved = { ...options };
+    if (!resolved.shouldThrow) {
+        resolved.shouldThrow = shouldThrow;
+    }
+    if (resolved.rank) {
+        const rankOpts = typeof resolved.rank === 'object' ? { ...resolved.rank } : {};
+        if (!rankOpts.ping) {
+            rankOpts.ping = (t) => t.request('server.ping');
+        }
+        resolved.rank = rankOpts;
+    }
+    return resolved;
+}
+//# sourceMappingURL=fallback.js.map

package/dist/electrum-cash/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/electrum-cash/fallback.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEzD,yEAAyE;AACzE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,CAAC,KAAK,EAAE,6CAA6C;IACrD,CAAC,CAAC,EAAE,oBAAoB;IACxB,CAAC,EAAE,EAAE,qBAAqB;IAC1B,CAAC,EAAE,EAAE,wCAAwC;IAC7C,CAAC,CAAC,EAAE,wDAAwD;IAC5D,CAAC,EAAE,EAAE,wDAAwD;CAC9D,CAAC,CAAA;AAEF;;+EAE+E;AAC/E,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,IACE,MAAM,IAAI,KAAK;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,QAAQ,EACrD,CAAC;QACD,OAAO,CAAC,eAAe,CAAC,GAAG,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAcD,iBAAiB;AACjB,MAAM,UAAU,QAAQ,CACtB,UAA0B,EAC1B,UAAuC,EAAE;IAEzC,wFAAwF;IACxF,OAAQ,YAAoB,CAAC,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;AACnE,CAAC;AAED,SAAS,cAAc,CACrB,OAAoC;IAEpC,MAAM,QAAQ,GAAgC,EAAE,GAAG,OAAO,EAAE,CAAA;IAE5D,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1B,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAA;IACpC,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,QAAQ,GACZ,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAE/D,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAe,EAAE,EAAE,CAClC,CAAC,CAAC,OAAO,CAAC,aAAwC,CAAC,CAAA;QACvD,CAAC;QAED,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/electrum-cash/index.d.ts

@@ -0,0 +1,2 @@
+export { fallback, shouldThrow } from './fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/electrum-cash/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/electrum-cash/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/electrum-cash/index.js

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

package/dist/electrum-cash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/electrum-cash/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/fallback.d.ts

@@ -0,0 +1,6 @@
+import type { FallbackTransport, FallbackTransportOptions } from '@rpckit/core';
+export declare function fallback<T>(transports: [T], options?: FallbackTransportOptions): T;
+export declare function fallback<T>(transports: [T, T, ...T[]], options?: FallbackTransportOptions): FallbackTransport;
+/** Default shouldThrow: stops fallback for deterministic JSON-RPC errors. */
+export declare function shouldThrow(error: Error): boolean | undefined;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../src/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,wBAAwB,EAMzB,MAAM,cAAc,CAAA;AAGrB,wBAAgB,QAAQ,CAAC,CAAC,EACxB,UAAU,EAAE,CAAC,CAAC,CAAC,EACf,OAAO,CAAC,EAAE,wBAAwB,GACjC,CAAC,CAAA;AAGJ,wBAAgB,QAAQ,CAAC,CAAC,EACxB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,iBAAiB,CAAA;AA4OpB,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAc7D"}

package/dist/fallback.js

@@ -0,0 +1,208 @@
+// Implementation
+export function fallback(transports, options = {}) {
+    // Single transport: no need to wrap
+    if (transports.length === 1) {
+        return transports[0];
+    }
+    let ranked = [...transports];
+    const { shouldThrow: shouldThrow_ = shouldThrow } = options;
+    let rankingTimer = null;
+    let rankingStopped = false;
+    let currentScores = transports.map((t) => ({
+        transport: t,
+        score: 0,
+        latency: 0,
+        stability: 0,
+    }));
+    const scoreListeners = new Set();
+    const responseListeners = new Set();
+    if (options.rank) {
+        const rankOpts = typeof options.rank === 'object' ? options.rank : {};
+        startRanking(transports, rankOpts);
+    }
+    function startRanking(transports, opts) {
+        if (!opts.ping)
+            return;
+        const ping = opts.ping;
+        const interval = opts.interval ?? 4000;
+        const sampleCount = opts.sampleCount ?? 10;
+        const timeout = opts.timeout ?? 1000;
+        const latencyWeight = opts.weights?.latency ?? 0.3;
+        const stabilityWeight = opts.weights?.stability ?? 0.7;
+        const samples = [];
+        async function sample() {
+            if (rankingStopped)
+                return;
+            const results = await Promise.all(transports.map(async (transport) => {
+                const start = performance.now();
+                try {
+                    await Promise.race([
+                        ping(transport),
+                        new Promise((_, reject) => setTimeout(() => reject(new Error('ping timeout')), timeout)),
+                    ]);
+                    return { latency: performance.now() - start, success: 1 };
+                }
+                catch {
+                    return { latency: timeout, success: 0 };
+                }
+            }));
+            samples.push(results);
+            if (samples.length > sampleCount)
+                samples.shift();
+            const maxLatency = Math.max(...samples.flatMap((s) => s.map((r) => r.latency)));
+            const scores = transports.map((transport, i) => {
+                const latencies = samples.map((s) => s[i].latency);
+                const meanLatency = latencies.reduce((a, b) => a + b, 0) / latencies.length;
+                const latencyScore = maxLatency > 0 ? 1 - meanLatency / maxLatency : 0;
+                const successes = samples.map((s) => s[i].success);
+                const stabilityScore = successes.reduce((a, b) => a + b, 0) / successes.length;
+                const score = stabilityScore === 0
+                    ? 0
+                    : latencyWeight * latencyScore + stabilityWeight * stabilityScore;
+                return {
+                    transport,
+                    score,
+                    latency: meanLatency,
+                    stability: stabilityScore,
+                };
+            });
+            scores.sort((a, b) => b.score - a.score);
+            ranked = scores.map((s) => s.transport);
+            currentScores = scores;
+            for (const listener of scoreListeners) {
+                listener(scores);
+            }
+            if (!rankingStopped) {
+                rankingTimer = setTimeout(sample, interval);
+            }
+        }
+        sample();
+    }
+    return {
+        url: transports.map((t) => t.url).join(','),
+        async connect() {
+            if (options.eagerConnect) {
+                const connectResults = ranked.map((t, i) => t.connect().then(() => i));
+                const fastestIndex = await Promise.any(connectResults);
+                // Move the fastest-connecting transport to front priority
+                if (fastestIndex > 0) {
+                    const [fastest] = ranked.splice(fastestIndex, 1);
+                    ranked.unshift(fastest);
+                }
+                // Let remaining connections settle in background
+                Promise.allSettled(connectResults);
+            }
+            else {
+                await Promise.all(ranked.map((t) => t.connect()));
+            }
+        },
+        get transports() {
+            return ranked;
+        },
+        get scores() {
+            return currentScores;
+        },
+        onScores(listener) {
+            scoreListeners.add(listener);
+            return () => {
+                scoreListeners.delete(listener);
+            };
+        },
+        onResponse(listener) {
+            responseListeners.add(listener);
+            return () => {
+                responseListeners.delete(listener);
+            };
+        },
+        async request(method, ...params) {
+            let lastError;
+            for (const transport of ranked) {
+                try {
+                    // biome-ignore lint/suspicious/noExplicitAny: meta-transport delegates with erased types
+                    const response = await transport.request(method, ...params);
+                    for (const listener of responseListeners) {
+                        listener({
+                            method,
+                            params,
+                            transport,
+                            response,
+                            status: 'success',
+                        });
+                    }
+                    return response;
+                }
+                catch (error) {
+                    lastError = error;
+                    for (const listener of responseListeners) {
+                        listener({
+                            method,
+                            params,
+                            transport,
+                            error,
+                            status: 'error',
+                        });
+                    }
+                    if (shouldThrow_(error))
+                        throw error;
+                }
+            }
+            throw lastError;
+        },
+        async subscribe(method, ...args) {
+            const onData = args.pop();
+            const params = args;
+            let lastError;
+            for (const transport of ranked) {
+                try {
+                    // biome-ignore lint/suspicious/noExplicitAny: meta-transport delegates with erased types
+                    const result = await transport.subscribe(method, ...params, onData);
+                    for (const listener of responseListeners) {
+                        listener({
+                            method,
+                            params,
+                            transport,
+                            response: result,
+                            status: 'success',
+                        });
+                    }
+                    return result;
+                }
+                catch (error) {
+                    lastError = error;
+                    for (const listener of responseListeners) {
+                        listener({
+                            method,
+                            params,
+                            transport,
+                            error,
+                            status: 'error',
+                        });
+                    }
+                }
+            }
+            throw lastError;
+        },
+        async close() {
+            rankingStopped = true;
+            if (rankingTimer)
+                clearTimeout(rankingTimer);
+            scoreListeners.clear();
+            responseListeners.clear();
+            await Promise.all(transports.map((t) => t.close()));
+        },
+    };
+}
+/** Default shouldThrow: stops fallback for deterministic JSON-RPC errors. */
+export function shouldThrow(error) {
+    if ('code' in error &&
+        typeof error.code === 'number') {
+        const code = error.code;
+        if (code === -32700 || // Parse error
+            code === -32600 || // Invalid Request
+            code === -32602 // Invalid params
+        )
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=fallback.js.map

package/dist/fallback.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { fallback, shouldThrow } from './fallback.js';
+//# 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,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

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

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@rpckit/fallback",
+  "version": "0.9.99",
+  "description": "Fallback meta-transport for rpckit with automatic failover and health ranking",
+  "author": "mainnet_pat",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./electrum-cash": {
+      "types": "./dist/electrum-cash/index.d.ts",
+      "default": "./dist/electrum-cash/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "json-rpc",
+    "rpc",
+    "fallback",
+    "failover",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mainnet-pat/rpckit.git",
+    "directory": "packages/fallback"
+  },
+  "homepage": "https://rpckit.dev",
+  "bugs": {
+    "url": "https://github.com/mainnet-pat/rpckit/issues"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@rpckit/core": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}