cantonjs 0.0.1

package/dist/cjs/streaming/createStream.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * Core AsyncIterable stream factory for Canton WebSocket connections.
+ *
+ * Creates a stream that:
+ * - Opens a WebSocket connection with Canton subprotocol auth
+ * - Sends a subscription request on connection open
+ * - Yields parsed JSON messages as an AsyncIterable
+ * - Auto-reconnects with exponential backoff on disconnect
+ * - Tracks offsets for gap-free resumption
+ * - Supports AbortSignal cancellation
+ *
+ * @see ADR 0005 — Streaming Architecture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWebSocketUrl = toWebSocketUrl;
+exports.calculateDelay = calculateDelay;
+exports.createStream = createStream;
+const streaming_js_1 = require("../errors/streaming.js");
+const DEFAULT_RECONNECT = {
+    initialDelay: 1000,
+    maxDelay: 30000,
+    factor: 2,
+    jitter: 0.25,
+    maxAttempts: Infinity,
+};
+/**
+ * Convert an HTTP(S) URL to a WebSocket URL.
+ * http://host → ws://host, https://host → wss://host
+ * If already ws/wss, return as-is.
+ */
+function toWebSocketUrl(baseUrl, path) {
+    const url = new URL(path, baseUrl);
+    if (url.protocol === 'https:') {
+        url.protocol = 'wss:';
+    }
+    else if (url.protocol === 'http:') {
+        url.protocol = 'ws:';
+    }
+    return url.toString();
+}
+/**
+ * Calculate reconnect delay with exponential backoff and jitter.
+ */
+function calculateDelay(attempt, config) {
+    const baseDelay = Math.min(config.initialDelay * Math.pow(config.factor, attempt), config.maxDelay);
+    const jitterRange = baseDelay * config.jitter;
+    const jitter = (Math.random() * 2 - 1) * jitterRange;
+    return Math.max(0, baseDelay + jitter);
+}
+/**
+ * Create a Canton WebSocket stream as an AsyncIterable.
+ *
+ * Each iteration yields a parsed JSON message from the WebSocket.
+ * The stream auto-reconnects on disconnect unless:
+ * - The AbortSignal is aborted
+ * - reconnect is set to false
+ * - The stream is bounded and the server closed normally (code 1000)
+ * - Max reconnect attempts are exhausted
+ */
+function createStream(config) {
+    return {
+        [Symbol.asyncIterator]() {
+            return new StreamIterator(config);
+        },
+    };
+}
+/**
+ * Internal AsyncIterator implementation.
+ *
+ * Uses a message queue with promise-based signaling to bridge the
+ * event-driven WebSocket API to the pull-based AsyncIterator protocol.
+ */
+class StreamIterator {
+    config;
+    reconnectConfig;
+    ws = null;
+    lastOffset = undefined;
+    reconnectAttempts = 0;
+    done = false;
+    abortHandler = null;
+    // Message queue for buffering received messages
+    queue = [];
+    // Error stored when fail() is called before next()
+    storedError = null;
+    // Pending resolve/reject for when consumer is waiting
+    pendingResolve = null;
+    pendingReject = null;
+    constructor(config) {
+        this.config = config;
+        if (config.reconnect === false) {
+            this.reconnectConfig = false;
+        }
+        else {
+            this.reconnectConfig = { ...DEFAULT_RECONNECT, ...config.reconnect };
+        }
+        if (config.signal?.aborted) {
+            this.done = true;
+        }
+        else {
+            this.setupAbortHandler();
+            this.connect();
+        }
+    }
+    async next() {
+        // If an error was stored before next() was called, throw it now
+        if (this.storedError) {
+            const error = this.storedError;
+            this.storedError = null;
+            throw error;
+        }
+        if (this.done && this.queue.length === 0) {
+            return { done: true, value: undefined };
+        }
+        // If there are queued messages, return immediately
+        if (this.queue.length > 0) {
+            return { done: false, value: this.queue.shift() };
+        }
+        // Wait for the next message, error, or close
+        return new Promise((resolve, reject) => {
+            this.pendingResolve = resolve;
+            this.pendingReject = reject;
+        });
+    }
+    async return() {
+        this.cleanup();
+        return { done: true, value: undefined };
+    }
+    async throw(error) {
+        this.cleanup();
+        throw error;
+    }
+    setupAbortHandler() {
+        if (!this.config.signal)
+            return;
+        this.abortHandler = () => {
+            this.cleanup();
+            if (this.pendingResolve) {
+                this.pendingResolve({ done: true, value: undefined });
+                this.pendingResolve = null;
+                this.pendingReject = null;
+            }
+        };
+        this.config.signal.addEventListener('abort', this.abortHandler);
+    }
+    connect() {
+        if (this.done)
+            return;
+        const WS = this.config.WebSocket ?? globalThis.WebSocket;
+        if (!WS) {
+            const error = new streaming_js_1.WebSocketError(this.config.url, {
+                cause: new Error('No WebSocket implementation available. Provide a WebSocket constructor.'),
+            });
+            this.fail(error);
+            return;
+        }
+        const protocols = this.config.token
+            ? ['daml.ws.auth', `jwt.token.${this.config.token}`]
+            : undefined;
+        let ws;
+        try {
+            ws = new WS(this.config.url, protocols);
+        }
+        catch (err) {
+            const error = new streaming_js_1.WebSocketError(this.config.url, {
+                cause: err instanceof Error ? err : new Error(String(err)),
+            });
+            this.fail(error);
+            return;
+        }
+        this.ws = ws;
+        ws.onopen = () => {
+            this.reconnectAttempts = 0;
+            const request = this.config.buildRequest(this.lastOffset);
+            ws.send(JSON.stringify(request));
+        };
+        ws.onmessage = (event) => {
+            let message;
+            try {
+                message = JSON.parse(String(event.data));
+            }
+            catch {
+                return; // Skip non-JSON messages
+            }
+            // Track offset for resumption
+            const offset = this.config.extractOffset(message);
+            if (offset !== undefined) {
+                this.lastOffset = offset;
+            }
+            this.enqueue(message);
+        };
+        ws.onerror = () => {
+            // onerror is always followed by onclose, so we handle reconnection there
+        };
+        ws.onclose = (event) => {
+            this.ws = null;
+            // Normal close on bounded stream = stream complete
+            if (this.config.bounded && event.code === 1000) {
+                this.cleanup();
+                if (this.pendingResolve) {
+                    this.pendingResolve({ done: true, value: undefined });
+                    this.pendingResolve = null;
+                    this.pendingReject = null;
+                }
+                return;
+            }
+            // If already done (abort, return), don't reconnect
+            if (this.done)
+                return;
+            // Try to reconnect
+            if (this.reconnectConfig === false) {
+                const error = new streaming_js_1.StreamClosedError(event.code, event.reason);
+                this.fail(error);
+                return;
+            }
+            if (this.reconnectAttempts >= this.reconnectConfig.maxAttempts) {
+                const error = new streaming_js_1.ReconnectFailedError(this.reconnectAttempts);
+                this.fail(error);
+                return;
+            }
+            const delay = calculateDelay(this.reconnectAttempts, this.reconnectConfig);
+            this.reconnectAttempts++;
+            setTimeout(() => {
+                if (!this.done) {
+                    this.connect();
+                }
+            }, delay);
+        };
+    }
+    enqueue(message) {
+        if (this.pendingResolve) {
+            const resolve = this.pendingResolve;
+            this.pendingResolve = null;
+            this.pendingReject = null;
+            resolve({ done: false, value: message });
+        }
+        else {
+            this.queue.push(message);
+        }
+    }
+    fail(error) {
+        this.done = true;
+        if (this.pendingReject) {
+            const reject = this.pendingReject;
+            this.pendingResolve = null;
+            this.pendingReject = null;
+            reject(error);
+        }
+        else {
+            this.storedError = error;
+        }
+    }
+    cleanup() {
+        this.done = true;
+        if (this.config.signal && this.abortHandler) {
+            this.config.signal.removeEventListener('abort', this.abortHandler);
+            this.abortHandler = null;
+        }
+        if (this.ws) {
+            // Clear handlers before closing to prevent reconnect
+            this.ws.onopen = null;
+            this.ws.onmessage = null;
+            this.ws.onerror = null;
+            this.ws.onclose = null;
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+}
+//# sourceMappingURL=createStream.js.map

package/dist/cjs/streaming/createStream.js.map

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

package/dist/cjs/streaming/index.d.ts

@@ -0,0 +1,8 @@
+export { createStream, toWebSocketUrl, calculateDelay } from './createStream.js';
+export type { CreateStreamConfig } from './createStream.js';
+export { streamUpdates } from './streamUpdates.js';
+export { streamContracts, type ActiveContractsResponse } from './streamContracts.js';
+export { streamCompletions } from './streamCompletions.js';
+export type { WebSocketConstructor, WebSocketLike, ReconnectConfig, StreamOptions, StreamUpdatesOptions, StreamContractsOptions, StreamCompletionsOptions, CompletionEvent, } from './types.js';
+export { WS_READY_STATE } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChF,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/cjs/streaming/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WS_READY_STATE = exports.streamCompletions = exports.streamContracts = exports.streamUpdates = exports.calculateDelay = exports.toWebSocketUrl = exports.createStream = void 0;
+var createStream_js_1 = require("./createStream.js");
+Object.defineProperty(exports, "createStream", { enumerable: true, get: function () { return createStream_js_1.createStream; } });
+Object.defineProperty(exports, "toWebSocketUrl", { enumerable: true, get: function () { return createStream_js_1.toWebSocketUrl; } });
+Object.defineProperty(exports, "calculateDelay", { enumerable: true, get: function () { return createStream_js_1.calculateDelay; } });
+var streamUpdates_js_1 = require("./streamUpdates.js");
+Object.defineProperty(exports, "streamUpdates", { enumerable: true, get: function () { return streamUpdates_js_1.streamUpdates; } });
+var streamContracts_js_1 = require("./streamContracts.js");
+Object.defineProperty(exports, "streamContracts", { enumerable: true, get: function () { return streamContracts_js_1.streamContracts; } });
+var streamCompletions_js_1 = require("./streamCompletions.js");
+Object.defineProperty(exports, "streamCompletions", { enumerable: true, get: function () { return streamCompletions_js_1.streamCompletions; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "WS_READY_STATE", { enumerable: true, get: function () { return types_js_1.WS_READY_STATE; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/streaming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":";;;AAAA,qDAAgF;AAAvE,+GAAA,YAAY,OAAA;AAAE,iHAAA,cAAc,OAAA;AAAE,iHAAA,cAAc,OAAA;AAGrD,uDAAkD;AAAzC,iHAAA,aAAa,OAAA;AACtB,2DAAoF;AAA3E,qHAAA,eAAe,OAAA;AACxB,+DAA0D;AAAjD,yHAAA,iBAAiB,OAAA;AAa1B,uCAA2C;AAAlC,0GAAA,cAAc,OAAA"}

package/dist/cjs/streaming/streamCompletions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stream command completions from Canton's /v2/commands/completions WebSocket endpoint.
+ *
+ * Yields completion events as an AsyncIterable with auto-reconnect.
+ */
+import type { CompletionEvent, StreamCompletionsOptions } from './types.js';
+/**
+ * Stream command completions from a Canton node.
+ *
+ * @example
+ * ```typescript
+ * const completions = streamCompletions({
+ *   url: 'http://localhost:7575',
+ *   token: jwt,
+ *   parties: ['Alice::1220'],
+ *   beginExclusive: 0,
+ * })
+ *
+ * for await (const event of completions) {
+ *   console.log('Completion:', event.completion.commandId, event.completion.status)
+ * }
+ * ```
+ */
+export declare function streamCompletions(options: StreamCompletionsOptions): AsyncIterable<CompletionEvent>;
+//# sourceMappingURL=streamCompletions.d.ts.map

package/dist/cjs/streaming/streamCompletions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamCompletions.d.ts","sourceRoot":"","sources":["../../../src/streaming/streamCompletions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAG3E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,aAAa,CAAC,eAAe,CAAC,CAoBhC"}

package/dist/cjs/streaming/streamCompletions.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Stream command completions from Canton's /v2/commands/completions WebSocket endpoint.
+ *
+ * Yields completion events as an AsyncIterable with auto-reconnect.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamCompletions = streamCompletions;
+const createStream_js_1 = require("./createStream.js");
+/**
+ * Stream command completions from a Canton node.
+ *
+ * @example
+ * ```typescript
+ * const completions = streamCompletions({
+ *   url: 'http://localhost:7575',
+ *   token: jwt,
+ *   parties: ['Alice::1220'],
+ *   beginExclusive: 0,
+ * })
+ *
+ * for await (const event of completions) {
+ *   console.log('Completion:', event.completion.commandId, event.completion.status)
+ * }
+ * ```
+ */
+function streamCompletions(options) {
+    const wsUrl = (0, createStream_js_1.toWebSocketUrl)(options.url, '/v2/commands/completions');
+    return (0, createStream_js_1.createStream)({
+        url: wsUrl,
+        token: options.token,
+        WebSocket: options.WebSocket,
+        signal: options.signal,
+        reconnect: options.reconnect,
+        bounded: false,
+        buildRequest: (lastOffset) => ({
+            beginExclusive: lastOffset ?? options.beginExclusive ?? 0,
+            parties: options.parties,
+            ...(options.applicationId && { applicationId: options.applicationId }),
+        }),
+        extractOffset: (message) => {
+            const msg = message;
+            return msg.completion?.offset;
+        },
+    });
+}
+//# sourceMappingURL=streamCompletions.js.map

package/dist/cjs/streaming/streamCompletions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamCompletions.js","sourceRoot":"","sources":["../../../src/streaming/streamCompletions.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAsBH,8CAsBC;AAzCD,uDAAgE;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,iBAAiB,CAC/B,OAAiC;IAEjC,MAAM,KAAK,GAAG,IAAA,gCAAc,EAAC,OAAO,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAA;IAErE,OAAO,IAAA,8BAAY,EAAkB;QACnC,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC7B,cAAc,EAAE,UAAU,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC;YACzD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;SACvE,CAAC;QACF,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,OAA0B,CAAA;YACtC,OAAO,GAAG,CAAC,UAAU,EAAE,MAAM,CAAA;QAC/B,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/cjs/streaming/streamContracts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Stream active contracts from Canton's /v2/state/active-contracts WebSocket endpoint.
+ *
+ * This is a bounded stream: the server sends all matching active contracts
+ * and then closes the connection. No auto-reconnect is used.
+ */
+import type { StreamContractsOptions } from './types.js';
+/** Response message from the active contracts stream. */
+export type ActiveContractsResponse = {
+    readonly contractEntry?: {
+        readonly [key: string]: unknown;
+    };
+    readonly offset?: number;
+};
+/**
+ * Stream active contracts from a Canton node.
+ *
+ * The stream yields contract entries matching the provided filters.
+ * It is bounded: the server closes the connection when all contracts
+ * have been sent.
+ *
+ * @example
+ * ```typescript
+ * const contracts = streamContracts({
+ *   url: 'http://localhost:7575',
+ *   token: jwt,
+ *   eventFormat: {
+ *     filtersByParty: {
+ *       [party]: { cumulative: [{ identifierFilter: { WildcardFilter: { value: {} } } }] }
+ *     }
+ *   }
+ * })
+ *
+ * for await (const entry of contracts) {
+ *   if (entry.contractEntry && 'JsActiveContract' in entry.contractEntry) {
+ *     console.log('Contract:', entry.contractEntry.JsActiveContract)
+ *   }
+ * }
+ * ```
+ */
+export declare function streamContracts(options: StreamContractsOptions): AsyncIterable<ActiveContractsResponse>;
+//# sourceMappingURL=streamContracts.d.ts.map

package/dist/cjs/streaming/streamContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamContracts.d.ts","sourceRoot":"","sources":["../../../src/streaming/streamContracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAGxD,yDAAyD;AACzD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,aAAa,CAAC,uBAAuB,CAAC,CAmBxC"}

package/dist/cjs/streaming/streamContracts.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Stream active contracts from Canton's /v2/state/active-contracts WebSocket endpoint.
+ *
+ * This is a bounded stream: the server sends all matching active contracts
+ * and then closes the connection. No auto-reconnect is used.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamContracts = streamContracts;
+const createStream_js_1 = require("./createStream.js");
+/**
+ * Stream active contracts from a Canton node.
+ *
+ * The stream yields contract entries matching the provided filters.
+ * It is bounded: the server closes the connection when all contracts
+ * have been sent.
+ *
+ * @example
+ * ```typescript
+ * const contracts = streamContracts({
+ *   url: 'http://localhost:7575',
+ *   token: jwt,
+ *   eventFormat: {
+ *     filtersByParty: {
+ *       [party]: { cumulative: [{ identifierFilter: { WildcardFilter: { value: {} } } }] }
+ *     }
+ *   }
+ * })
+ *
+ * for await (const entry of contracts) {
+ *   if (entry.contractEntry && 'JsActiveContract' in entry.contractEntry) {
+ *     console.log('Contract:', entry.contractEntry.JsActiveContract)
+ *   }
+ * }
+ * ```
+ */
+function streamContracts(options) {
+    const wsUrl = (0, createStream_js_1.toWebSocketUrl)(options.url, '/v2/state/active-contracts');
+    return (0, createStream_js_1.createStream)({
+        url: wsUrl,
+        token: options.token,
+        WebSocket: options.WebSocket,
+        signal: options.signal,
+        reconnect: false, // Bounded stream — no reconnect
+        bounded: true,
+        buildRequest: () => ({
+            eventFormat: options.eventFormat,
+            ...(options.activeAtOffset !== undefined && { activeAtOffset: options.activeAtOffset }),
+        }),
+        extractOffset: (message) => {
+            const msg = message;
+            return msg.offset;
+        },
+    });
+}
+//# sourceMappingURL=streamContracts.js.map

package/dist/cjs/streaming/streamContracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamContracts.js","sourceRoot":"","sources":["../../../src/streaming/streamContracts.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAqCH,0CAqBC;AAvDD,uDAAgE;AAQhE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,eAAe,CAC7B,OAA+B;IAE/B,MAAM,KAAK,GAAG,IAAA,gCAAc,EAAC,OAAO,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAA;IAEvE,OAAO,IAAA,8BAAY,EAA0B;QAC3C,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,KAAK,EAAE,gCAAgC;QAClD,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;YACnB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;SACxF,CAAC;QACF,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,OAAkC,CAAA;YAC9C,OAAO,GAAG,CAAC,MAAM,CAAA;QACnB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/cjs/streaming/streamUpdates.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Stream updates from Canton's /v2/updates WebSocket endpoint.
+ *
+ * Yields TaggedUpdate messages (Transaction, Reassignment, OffsetCheckpoint,
+ * TopologyTransaction) as an AsyncIterable with auto-reconnect.
+ */
+import type { TaggedUpdate } from '../types/transaction.js';
+import type { StreamUpdatesOptions } from './types.js';
+/**
+ * Stream ledger updates from a Canton node.
+ *
+ * @example
+ * ```typescript
+ * const updates = streamUpdates({
+ *   url: 'http://localhost:7575',
+ *   token: jwt,
+ *   beginExclusive: 0,
+ *   updateFormat: {
+ *     includeTransactions: {
+ *       transactionShape: 'TRANSACTION_SHAPE_ACS_DELTA',
+ *       eventFormat: {
+ *         filtersByParty: {
+ *           [party]: { cumulative: [{ identifierFilter: { WildcardFilter: { value: {} } } }] }
+ *         }
+ *       }
+ *     }
+ *   }
+ * })
+ *
+ * for await (const update of updates) {
+ *   if ('Transaction' in update) {
+ *     console.log('Transaction:', update.Transaction.value.updateId)
+ *   }
+ * }
+ * ```
+ */
+export declare function streamUpdates(options: StreamUpdatesOptions): AsyncIterable<TaggedUpdate>;
+//# sourceMappingURL=streamUpdates.d.ts.map

package/dist/cjs/streaming/streamUpdates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamUpdates.d.ts","sourceRoot":"","sources":["../../../src/streaming/streamUpdates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAAC,YAAY,CAAC,CA2BxF"}

package/dist/cjs/streaming/streamUpdates.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Stream updates from Canton's /v2/updates WebSocket endpoint.
+ *
+ * Yields TaggedUpdate messages (Transaction, Reassignment, OffsetCheckpoint,
+ * TopologyTransaction) as an AsyncIterable with auto-reconnect.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamUpdates = streamUpdates;
+const createStream_js_1 = require("./createStream.js");
+/**
+ * Stream ledger updates from a Canton node.
+ *
+ * @example
+ * ```typescript
+ * const updates = streamUpdates({
+ *   url: 'http://localhost:7575',
+ *   token: jwt,
+ *   beginExclusive: 0,
+ *   updateFormat: {
+ *     includeTransactions: {
+ *       transactionShape: 'TRANSACTION_SHAPE_ACS_DELTA',
+ *       eventFormat: {
+ *         filtersByParty: {
+ *           [party]: { cumulative: [{ identifierFilter: { WildcardFilter: { value: {} } } }] }
+ *         }
+ *       }
+ *     }
+ *   }
+ * })
+ *
+ * for await (const update of updates) {
+ *   if ('Transaction' in update) {
+ *     console.log('Transaction:', update.Transaction.value.updateId)
+ *   }
+ * }
+ * ```
+ */
+function streamUpdates(options) {
+    const wsUrl = (0, createStream_js_1.toWebSocketUrl)(options.url, '/v2/updates');
+    const isOpen = options.endInclusive === undefined;
+    return (0, createStream_js_1.createStream)({
+        url: wsUrl,
+        token: options.token,
+        WebSocket: options.WebSocket,
+        signal: options.signal,
+        reconnect: isOpen ? options.reconnect : false,
+        bounded: !isOpen,
+        buildRequest: (lastOffset) => ({
+            beginExclusive: lastOffset ?? options.beginExclusive ?? 0,
+            ...(options.endInclusive !== undefined && { endInclusive: options.endInclusive }),
+            ...(options.updateFormat && { updateFormat: options.updateFormat }),
+        }),
+        extractOffset: (message) => {
+            const msg = message;
+            if ('Transaction' in msg) {
+                return msg.Transaction.value.offset;
+            }
+            if ('OffsetCheckpoint' in msg) {
+                return msg.OffsetCheckpoint.value.offset;
+            }
+            return undefined;
+        },
+    });
+}
+//# sourceMappingURL=streamUpdates.js.map

package/dist/cjs/streaming/streamUpdates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamUpdates.js","sourceRoot":"","sources":["../../../src/streaming/streamUpdates.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAkCH,sCA2BC;AAzDD,uDAAgE;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,aAAa,CAAC,OAA6B;IACzD,MAAM,KAAK,GAAG,IAAA,gCAAc,EAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS,CAAA;IAEjD,OAAO,IAAA,8BAAY,EAAe;QAChC,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;QAC7C,OAAO,EAAE,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC7B,cAAc,EAAE,UAAU,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC;YACzD,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;YACjF,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;SACpE,CAAC;QACF,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,OAAuB,CAAA;YACnC,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;gBACzB,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAA;YACrC,CAAC;YACD,IAAI,kBAAkB,IAAI,GAAG,EAAE,CAAC;gBAC9B,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAA;YAC1C,CAAC;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}