@rpckit/tcp 0.9.99

package/README.md

@@ -0,0 +1,89 @@
+# @rpckit/tcp
+
+TCP transport for rpckit (Node.js only). Supports TLS, subscriptions, keep-alive, and request batching.
+
+## Installation
+
+```bash
+npm install @rpckit/core @rpckit/tcp
+```
+
+## Usage
+
+```typescript
+import { tcp } from '@rpckit/tcp'
+
+// Plain TCP
+const transport = tcp('tcp://example.com:50001')
+
+// TCP with TLS
+const tlsTransport = tcp('tcp+tls://example.com:50002')
+
+await transport.connect()
+const result = await transport.request('my.method', 'param1')
+await transport.close()
+```
+
+## Electrum Cash Variant
+
+For Electrum Cash servers, use the `electrum-cash` subpath which pre-configures handshake, keep-alive method, and unsubscribe conventions:
+
+```typescript
+import { tcp } from '@rpckit/tcp/electrum-cash'
+
+const transport = tcp('tcp+tls://electrum.example.com:50002', {
+  keepAlive: 60000  // Automatically uses server.ping
+})
+
+// Handshake (server.version) sent automatically on connect
+const tip = await transport.request('blockchain.headers.get_tip')
+```
+
+The electrum-cash variant also accepts:
+
+- `clientName` - Client name sent in server.version handshake (default: `'rpckit'`)
+- `protocolVersion` - Protocol version (default: `'1.6'`)
+
+## Subscription Sharing
+
+Multiple callers subscribing to the same method+params will share a single server subscription. New subscribers receive the most recent notification data (not stale initial data). The server unsubscribe is only sent when the last listener unsubscribes.
+
+```typescript
+// Both callbacks share one server subscription
+const unsub1 = await transport.subscribe('events', callback1)
+const unsub2 = await transport.subscribe('events', callback2)
+
+await unsub1() // callback1 removed, server subscription stays active
+await unsub2() // callback2 removed, NOW server unsubscribe is sent
+```
+
+## Options
+
+- `timeout` - Request timeout in ms
+- `connectTimeout` - Connection timeout in ms
+- `retryCount` - Max retry attempts (default: 3)
+- `retryDelay` - Base delay between retries in ms (default: 150, exponential backoff applied)
+- `keepAlive` - Keep-alive ping interval in ms, or `{ interval, method, params }`
+- `tls` - TLS options (or `true` for defaults when using `tcp+tls://`)
+- `reconnect` - `{ delay: number, attempts: number }` for auto-reconnect after disconnect
+- `handshake` - `{ method, params }` to send on connect
+- `batch` - `true` (default), `false`, or `{ wait, batchSize }`
+- `onUnsubscribe` - Cleanup callback when the last listener unsubscribes (receives `{ request, method, params, initialResult }`)
+- `notificationFilter` - Filter notifications before delivery; receives `(subscriptionParams, notificationParams)` and returns `boolean`
+- `transformInitialResult` - Transform the initial subscription result before delivery; return `undefined` to suppress
+
+## Socket Access
+
+Access the underlying TCP socket for advanced use cases:
+
+```typescript
+// Synchronous - returns null if not yet connected
+const socket = transport.getSocket()
+
+// Async - connects first if needed, then returns socket
+const socket = await transport.getSocketAsync()
+```
+
+## Lazy Initialization
+
+Connections are established lazily on first use. Creating a transport is cheap - no resources are allocated until the first `request()`, `subscribe()`, or `connect()` call.

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

@@ -0,0 +1,3 @@
+export type { ElectrumTcpConfig, ElectrumTcpOptions } from './tcp.js';
+export { tcp } from './tcp.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,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/dist/electrum-cash/index.js

@@ -0,0 +1,2 @@
+export { tcp } from './tcp.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":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA"}

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

@@ -0,0 +1,20 @@
+import type { AnySchema, Schema, TcpTransport, TcpTransportOptions } from '@rpckit/core';
+export interface ElectrumTcpOptions extends TcpTransportOptions {
+    /** Client name sent in server.version handshake (default: 'rpckit') */
+    clientName?: string;
+    /** Electrum protocol version (default: '1.6') */
+    protocolVersion?: string;
+}
+export type ElectrumTcpConfig = ({
+    url: string;
+    tls?: import('tls').ConnectionOptions;
+} & ElectrumTcpOptions) | ({
+    host: string;
+    port: number;
+    tls?: boolean | import('tls').ConnectionOptions;
+} & ElectrumTcpOptions);
+export declare function tcp<S extends Schema = AnySchema>(url: string, options?: ElectrumTcpOptions & {
+    tls?: import('tls').ConnectionOptions;
+}): TcpTransport<S>;
+export declare function tcp<S extends Schema = AnySchema>(config: ElectrumTcpConfig): TcpTransport<S>;
+//# sourceMappingURL=tcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tcp.d.ts","sourceRoot":"","sources":["../../src/electrum-cash/tcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAET,MAAM,EACN,YAAY,EACZ,mBAAmB,EACpB,MAAM,cAAc,CAAA;AAGrB,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,MAAM,iBAAiB,GACzB,CAAC;IACC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,OAAO,KAAK,EAAE,iBAAiB,CAAA;CACtC,GAAG,kBAAkB,CAAC,GACvB,CAAC;IACC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,KAAK,EAAE,iBAAiB,CAAA;CAChD,GAAG,kBAAkB,CAAC,CAAA;AAE3B,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAC9C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,kBAAkB,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACvE,YAAY,CAAC,CAAC,CAAC,CAAA;AAClB,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAC9C,MAAM,EAAE,iBAAiB,GACxB,YAAY,CAAC,CAAC,CAAC,CAAA"}

package/dist/electrum-cash/tcp.js

@@ -0,0 +1,66 @@
+import { tcp as baseTcp } from '../tcp.js';
+export function tcp(configOrUrl, options) {
+    if (typeof configOrUrl === 'string') {
+        const { clientName = 'rpckit', protocolVersion = '1.6', ...rest } = options ?? {};
+        const keepAlive = normalizeKeepAlive(rest.keepAlive);
+        return baseTcp(configOrUrl, {
+            handshake: {
+                method: 'server.version',
+                params: [clientName, protocolVersion],
+            },
+            onUnsubscribe: ({ request, method, params }) => request(method.replace('subscribe', 'unsubscribe'), ...params),
+            transformInitialResult: (_method, params, result) => [
+                ...params,
+                ...result,
+            ],
+            notificationFilter: electrumParamsMatch,
+            ...rest,
+            ...(keepAlive !== undefined ? { keepAlive } : {}),
+        });
+    }
+    const { clientName = 'rpckit', protocolVersion = '1.6', ...rest } = configOrUrl;
+    const keepAlive = normalizeKeepAlive(rest.keepAlive);
+    return baseTcp({
+        handshake: {
+            method: 'server.version',
+            params: [clientName, protocolVersion],
+        },
+        onUnsubscribe: ({ request, method, params }) => request(method.replace('subscribe', 'unsubscribe'), ...params),
+        transformInitialResult: (_method, params, result) => [...params, ...result],
+        notificationFilter: electrumParamsMatch,
+        ...rest,
+        ...(keepAlive !== undefined ? { keepAlive } : {}),
+    });
+}
+function normalizeKeepAlive(ka) {
+    if (ka === undefined)
+        return undefined;
+    if (typeof ka === 'number') {
+        return { interval: ka, method: 'server.ping' };
+    }
+    const ping = { ...ka };
+    if (!ping.method)
+        ping.method = 'server.ping';
+    return ping;
+}
+/**
+ * Electrum protocol notification filter.
+ * Notifications include subscription params as prefix: subscribe([address]) → notification([address, status])
+ */
+function electrumParamsMatch(subscriptionParams, notificationParams) {
+    return subscriptionParams.every((p, i) => {
+        if (i >= notificationParams.length)
+            return false;
+        const np = notificationParams[i];
+        // Simple types can be compared directly
+        if (typeof p !== 'object' ||
+            p === null ||
+            typeof np !== 'object' ||
+            np === null) {
+            return p === np;
+        }
+        // Complex types need JSON comparison
+        return JSON.stringify(p) === JSON.stringify(np);
+    });
+}
+//# sourceMappingURL=tcp.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { tcp } from './tcp.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,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { tcp } from './tcp.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,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/dist/tcp.d.ts

@@ -0,0 +1,6 @@
+import { type AnySchema, type Schema, type TcpTransport, type TcpTransportConfig, type TcpTransportOptions } from '@rpckit/core';
+export declare function tcp<S extends Schema = AnySchema>(url: string, options?: TcpTransportOptions & {
+    tls?: import('tls').ConnectionOptions;
+}): TcpTransport<S>;
+export declare function tcp<S extends Schema = AnySchema>(config: TcpTransportConfig): TcpTransport<S>;
+//# sourceMappingURL=tcp.d.ts.map

package/dist/tcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp.d.ts","sourceRoot":"","sources":["../src/tcp.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAId,KAAK,MAAM,EAEX,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGzB,MAAM,cAAc,CAAA;AA+crB,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAC9C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACxE,YAAY,CAAC,CAAC,CAAC,CAAA;AAClB,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAC9C,MAAM,EAAE,kBAAkB,GACzB,YAAY,CAAC,CAAC,CAAC,CAAA"}

package/dist/tcp.js

@@ -0,0 +1,439 @@
+import { createConnection as netConnect } from 'node:net';
+import { connect as tlsConnect } from 'node:tls';
+import { BatchScheduler, withRetry, } from '@rpckit/core';
+function parseUrl(config) {
+    if ('url' in config) {
+        const isTls = config.url.startsWith('tcp+tls://');
+        const stripped = config.url.replace(/^tcp(\+tls)?:\/\//, '');
+        const [host, portStr] = stripped.split(':');
+        const port = portStr ? parseInt(portStr, 10) : isTls ? 50002 : 50001;
+        const tls = isTls
+            ? (config.tls ?? true)
+            : false;
+        return { host, port, tls };
+    }
+    return { host: config.host, port: config.port, tls: config.tls ?? false };
+}
+const tcpSocketCache = new Map();
+function getCacheKey(config) {
+    const { host, port, tls } = parseUrl(config);
+    return JSON.stringify({
+        host,
+        port,
+        tls: typeof tls === 'object' ? tls : !!tls,
+        keepAlive: config.keepAlive,
+    });
+}
+function getOrCreateTcpSocketClient(config) {
+    const cacheKey = getCacheKey(config);
+    let client = tcpSocketCache.get(cacheKey);
+    if (client) {
+        client.refCount++;
+        return client;
+    }
+    const { host, port, tls } = parseUrl(config);
+    const url = `tcp${tls ? '+tls' : ''}://${host}:${port}`;
+    let socket = null;
+    let nextId = 1;
+    let closed = false;
+    let connectPromise = null;
+    let buffer = '';
+    let _reconnectCount = 0;
+    const pending = new Map();
+    const subscriptions = new Map();
+    let keepAliveTimer = null;
+    let batchScheduler = null;
+    if (config.batch !== false) {
+        batchScheduler = new BatchScheduler(typeof config.batch === 'object' ? config.batch : {}, sendBatch);
+    }
+    function getSubscriptionKey(method, params) {
+        return `${method}:${JSON.stringify(params)}`;
+    }
+    function connect() {
+        if (connectPromise)
+            return connectPromise;
+        connectPromise = new Promise((resolve, reject) => {
+            let connectTimer;
+            if (config.connectTimeout) {
+                connectTimer = setTimeout(() => {
+                    reject(new Error('Connection timeout'));
+                    socket?.destroy();
+                    void handleDisconnect();
+                }, config.connectTimeout);
+            }
+            const onConnect = async () => {
+                try {
+                    _reconnectCount = 0;
+                    if (config.handshake) {
+                        const id = nextId++;
+                        const req = {
+                            jsonrpc: '2.0',
+                            method: config.handshake.method,
+                            params: config.handshake.params ?? [],
+                            id,
+                        };
+                        await new Promise((res, rej) => {
+                            pending.set(id, { resolve: () => res(), reject: rej });
+                            sendRaw(req);
+                        });
+                    }
+                    startKeepAlive();
+                    // Restore subscriptions after reconnect
+                    if (subscriptions.size > 0) {
+                        for (const [_key, entry] of subscriptions) {
+                            const id = nextId++;
+                            const req = {
+                                jsonrpc: '2.0',
+                                method: entry.method,
+                                params: entry.params,
+                                id,
+                            };
+                            sendRaw(req);
+                        }
+                    }
+                    if (connectTimer)
+                        clearTimeout(connectTimer);
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            };
+            if (tls) {
+                const tlsOpts = typeof tls === 'object' ? tls : {};
+                socket = tlsConnect({ host, port, ...tlsOpts }, onConnect);
+            }
+            else {
+                socket = netConnect({ host, port }, onConnect);
+            }
+            socket.setEncoding('utf8');
+            socket.on('data', (chunk) => {
+                buffer += chunk;
+                const lines = buffer.split('\n');
+                // biome-ignore lint/style/noNonNullAssertion: split always returns at least one element
+                buffer = lines.pop();
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    let msg;
+                    try {
+                        msg = JSON.parse(line);
+                    }
+                    catch {
+                        continue;
+                    }
+                    const messages = Array.isArray(msg) ? msg : [msg];
+                    for (const m of messages) {
+                        if ('id' in m && m.id != null) {
+                            const p = pending.get(m.id);
+                            if (p) {
+                                pending.delete(m.id);
+                                if (p.timer)
+                                    clearTimeout(p.timer);
+                                const resp = m;
+                                if (resp.error)
+                                    p.reject(resp.error);
+                                else
+                                    p.resolve(resp.result);
+                            }
+                        }
+                        else {
+                            const notif = m;
+                            for (const [, entry] of subscriptions) {
+                                if (entry.method === notif.method) {
+                                    // Apply notification filter if configured
+                                    if (config.notificationFilter) {
+                                        const notifParams = notif.params;
+                                        if (!config.notificationFilter(entry.params, notifParams)) {
+                                            continue;
+                                        }
+                                    }
+                                    entry.lastNotification = notif.params;
+                                    for (const handler of entry.listeners)
+                                        handler(notif.params);
+                                }
+                            }
+                        }
+                    }
+                }
+            });
+            socket.on('error', (err) => {
+                if (connectTimer)
+                    clearTimeout(connectTimer);
+                reject(err);
+                void handleDisconnect(err);
+            });
+            socket.on('close', () => {
+                void handleDisconnect();
+            });
+        });
+        return connectPromise;
+    }
+    async function handleDisconnect(error) {
+        stopKeepAlive();
+        connectPromise = null;
+        socket = null;
+        buffer = '';
+        // Reject all pending requests (but keep subscriptions for restore)
+        for (const [, p] of pending) {
+            if (p.timer)
+                clearTimeout(p.timer);
+            p.reject(error ?? new Error('TCP disconnected'));
+        }
+        pending.clear();
+        if (!closed &&
+            config.reconnect &&
+            _reconnectCount < config.reconnect.attempts) {
+            _reconnectCount++;
+            await new Promise((r) => setTimeout(r, config.reconnect?.delay));
+            if (!closed)
+                await connect();
+        }
+    }
+    function startKeepAlive() {
+        stopKeepAlive();
+        const ka = config.keepAlive;
+        if (!ka)
+            return;
+        const interval = typeof ka === 'number' ? ka : ka.interval;
+        const method = typeof ka === 'number' ? undefined : ka.method;
+        const params = typeof ka === 'number' ? [] : (ka.params ?? []);
+        if (interval > 0 && method) {
+            keepAliveTimer = setInterval(() => {
+                sendRaw({ jsonrpc: '2.0', method, params, id: nextId++ });
+            }, interval);
+        }
+    }
+    function stopKeepAlive() {
+        if (keepAliveTimer) {
+            clearInterval(keepAliveTimer);
+            keepAliveTimer = null;
+        }
+    }
+    function sendRaw(request) {
+        socket?.write(`${JSON.stringify(request)}\n`);
+    }
+    async function sendBatch(requests) {
+        await connect();
+        return new Promise((resolve, reject) => {
+            const ids = new Set(requests.map((r) => r.id));
+            const results = [];
+            const timer = config.timeout
+                ? setTimeout(() => {
+                    for (const id of ids)
+                        pending.delete(id);
+                    reject(new Error('Batch timeout'));
+                }, config.timeout)
+                : undefined;
+            for (const req of requests) {
+                pending.set(req.id, {
+                    resolve: (result) => {
+                        results.push({ jsonrpc: '2.0', result, id: req.id });
+                        ids.delete(req.id);
+                        if (ids.size === 0) {
+                            if (timer)
+                                clearTimeout(timer);
+                            resolve(results);
+                        }
+                    },
+                    reject: (error) => {
+                        for (const id of ids)
+                            pending.delete(id);
+                        if (timer)
+                            clearTimeout(timer);
+                        reject(error);
+                    },
+                });
+            }
+            socket?.write(`${JSON.stringify(requests)}\n`);
+        });
+    }
+    async function request(method, params = []) {
+        await connect();
+        const id = nextId++;
+        const req = { jsonrpc: '2.0', method, params, id };
+        if (batchScheduler) {
+            return batchScheduler.enqueue(req);
+        }
+        return new Promise((resolve, reject) => {
+            const timer = config.timeout
+                ? setTimeout(() => {
+                    pending.delete(id);
+                    reject(new Error('Request timeout'));
+                }, config.timeout)
+                : undefined;
+            pending.set(id, { resolve, reject, timer });
+            sendRaw(req);
+        });
+    }
+    async function subscribe(method, params, onData) {
+        await connect();
+        const subKey = getSubscriptionKey(method, params);
+        let entry = subscriptions.get(subKey);
+        if (entry) {
+            entry.listeners.add(onData);
+            const hasNotification = entry.lastNotification !== undefined;
+            return {
+                initialResult: hasNotification
+                    ? entry.lastNotification
+                    : entry.initialResult,
+                unsubscribe: () => {
+                    entry?.listeners.delete(onData);
+                    if (entry?.listeners.size === 0) {
+                        subscriptions.delete(subKey);
+                        return true; // was the last listener
+                    }
+                    return false; // other listeners remain
+                },
+                fromNotification: hasNotification,
+            };
+        }
+        const id = nextId++;
+        const req = { jsonrpc: '2.0', method, params, id };
+        const initialResult = await new Promise((resolve, reject) => {
+            const timer = config.timeout
+                ? setTimeout(() => {
+                    pending.delete(id);
+                    reject(new Error('Request timeout'));
+                }, config.timeout)
+                : undefined;
+            pending.set(id, { resolve, reject, timer });
+            sendRaw(req);
+        });
+        entry = {
+            method,
+            params,
+            listeners: new Set([onData]),
+            initialResult,
+            lastNotification: undefined,
+        };
+        subscriptions.set(subKey, entry);
+        return {
+            initialResult,
+            unsubscribe: () => {
+                entry?.listeners.delete(onData);
+                if (entry?.listeners.size === 0) {
+                    subscriptions.delete(subKey);
+                    return true; // was the last listener
+                }
+                return false; // other listeners remain
+            },
+            fromNotification: false,
+        };
+    }
+    async function close() {
+        closed = true;
+        stopKeepAlive();
+        if (batchScheduler)
+            await batchScheduler.flush();
+        for (const [, p] of pending) {
+            if (p.timer)
+                clearTimeout(p.timer);
+            p.reject(new Error('Transport closed'));
+        }
+        pending.clear();
+        subscriptions.clear();
+        socket?.destroy();
+        socket = null;
+        connectPromise = null;
+        tcpSocketCache.delete(cacheKey);
+    }
+    client = {
+        refCount: 1,
+        get socket() {
+            return socket;
+        },
+        nextId,
+        connectPromise,
+        closed,
+        buffer,
+        pending,
+        subscriptions,
+        keepAliveTimer,
+        batchScheduler,
+        connect,
+        sendRaw,
+        request,
+        subscribe,
+        close,
+        url,
+    };
+    tcpSocketCache.set(cacheKey, client);
+    return client;
+}
+export function tcp(configOrUrl, options) {
+    const config = typeof configOrUrl === 'string'
+        ? { ...options, url: configOrUrl }
+        : configOrUrl;
+    // Compute URL without creating client
+    const { host, port, tls } = parseUrl(config);
+    const url = `tcp${tls ? '+tls' : ''}://${host}:${port}`;
+    // Lazy client initialization - only created on first use
+    let client = null;
+    const getClient = () => {
+        if (!client)
+            client = getOrCreateTcpSocketClient(config);
+        return client;
+    };
+    const retryOpts = {
+        retryCount: config.retryCount,
+        retryDelay: config.retryDelay,
+    };
+    const self = {
+        url,
+        connect: () => withRetry(() => getClient().connect(), retryOpts),
+        request: (method, ...params) => withRetry(() => getClient().request(method, params), retryOpts),
+        async subscribe(method, ...args) {
+            const onData = args.pop();
+            const params = args;
+            const { initialResult, unsubscribe, fromNotification } = await withRetry(() => getClient().subscribe(method, params, onData), retryOpts);
+            // Deliver initial result if we got one
+            if (initialResult !== undefined) {
+                if (fromNotification) {
+                    // Reused subscription: lastNotification is already in notification format
+                    onData(initialResult);
+                }
+                else {
+                    const transformed = config.transformInitialResult
+                        ? config.transformInitialResult(method, params, [initialResult])
+                        : initialResult;
+                    // Allow transformInitialResult to return undefined to suppress delivery
+                    if (transformed !== undefined) {
+                        onData(transformed);
+                    }
+                }
+            }
+            const unsub = async (cleanup) => {
+                const wasLastListener = unsubscribe();
+                // Only call onUnsubscribe when the last listener is removed
+                if (wasLastListener) {
+                    const fn = cleanup ?? config.onUnsubscribe;
+                    if (fn) {
+                        await fn({ request: self.request, method, params, initialResult });
+                    }
+                }
+            };
+            return unsub;
+        },
+        async close() {
+            if (!client)
+                return;
+            client.refCount--;
+            if (client.refCount <= 0) {
+                await client.close();
+            }
+        },
+        getSocket() {
+            return client?.socket ?? null;
+        },
+        async getSocketAsync() {
+            await getClient().connect();
+            const c = getClient();
+            if (!c.socket)
+                throw new Error('TCP socket not connected');
+            return c.socket;
+        },
+    };
+    return self;
+}
+//# sourceMappingURL=tcp.js.map

package/dist/tcp.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@rpckit/tcp",
+  "version": "0.9.99",
+  "description": "TCP transport for rpckit (Node.js) with TLS support",
+  "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",
+    "tcp",
+    "electrum",
+    "electrum-cash",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mainnet-pat/rpckit.git",
+    "directory": "packages/tcp"
+  },
+  "homepage": "https://rpckit.dev",
+  "bugs": {
+    "url": "https://github.com/mainnet-pat/rpckit/issues"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@rpckit/core": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}