@fairmint/canton-node-sdk 0.0.88 → 0.0.90

package/build/src/core/operations/WebSocketOperationFactory.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSocketOperation = createWebSocketOperation;
+const zod_1 = require("zod");
+const ws_1 = require("../ws");
+const errors_1 = require("../errors");
+function createWebSocketOperation(config) {
+    return class WebSocketOperation {
+        constructor(client) {
+            this.client = client;
+        }
+        validateParams(params, schema) {
+            try {
+                return schema.parse(params);
+            }
+            catch (error) {
+                if (error instanceof zod_1.z.ZodError) {
+                    throw new errors_1.ValidationError(`Parameter validation failed: ${error.issues.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`);
+                }
+                throw error;
+            }
+        }
+        async subscribe(params, handlers) {
+            const validatedParams = this.validateParams(params, config.paramsSchema);
+            const wsClient = new ws_1.WebSocketClient(this.client);
+            const path = config.buildPath(validatedParams, this.client.getApiUrl(), this.client);
+            const request = await config.buildRequestMessage(validatedParams, this.client);
+            const wrappedHandlers = config.transformInbound
+                ? {
+                    ...handlers,
+                    onMessage: (msg) => handlers.onMessage(config.transformInbound(msg)),
+                }
+                : handlers;
+            return wsClient.connect(path, request, wrappedHandlers);
+        }
+    };
+}
+//# sourceMappingURL=WebSocketOperationFactory.js.map

package/build/src/core/operations/WebSocketOperationFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketOperationFactory.js","sourceRoot":"","sources":["../../../../src/core/operations/WebSocketOperationFactory.ts"],"names":[],"mappings":";;AAYA,4DAsCC;AAlDD,6BAAwB;AAExB,8BAAkF;AAClF,sCAA4C;AAS5C,SAAgB,wBAAwB,CACvC,MAAwE;IAExE,OAAO,MAAM,kBAAkB;QAC9B,YAAmB,MAAkB;YAAlB,WAAM,GAAN,MAAM,CAAY;QAAG,CAAC;QAElC,cAAc,CAAI,MAAS,EAAE,MAAsB;YACzD,IAAI,CAAC;gBACJ,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;oBACjC,MAAM,IAAI,wBAAe,CACxB,gCAAgC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvG,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;QAEM,KAAK,CAAC,SAAS,CACrB,MAAc,EACd,QAA2C;YAE3C,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACzE,MAAM,QAAQ,GAAG,IAAI,oBAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACrF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAE/E,MAAM,eAAe,GAAsC,MAAM,CAAC,gBAAgB;gBACjF,CAAC,CAAC;oBACD,GAAG,QAAQ;oBACX,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAiB,CAAC,GAAG,CAAC,CAAC;iBACrE;gBACD,CAAC,CAAC,QAAQ,CAAC;YAEZ,OAAO,QAAQ,CAAC,OAAO,CAAiC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QACzF,CAAC;KACD,CAAC;AACH,CAAC"}

package/build/src/core/operations/index.d.ts

@@ -1,3 +1,4 @@
 export * from './ApiOperation';
 export * from './ApiOperationFactory';
+export * from './WebSocketOperationFactory';
 //# sourceMappingURL=index.d.ts.map

package/build/src/core/operations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}

package/build/src/core/operations/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ApiOperation"), exports);
 __exportStar(require("./ApiOperationFactory"), exports);
+__exportStar(require("./WebSocketOperationFactory"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/core/operations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/operations/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/operations/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,wDAAsC;AACtC,8DAA4C"}

package/build/src/core/ws/WebSocketClient.d.ts

@@ -0,0 +1,27 @@
+import { BaseClient } from '../BaseClient';
+export interface WebSocketSubscription {
+    close: () => void;
+    isConnected: () => boolean;
+    getConnectionState: () => number;
+}
+export interface WebSocketHandlers<Message, ErrorMessage = unknown> {
+    onOpen?: () => void;
+    onMessage: (msg: Message) => void;
+    onError?: (err: Error | ErrorMessage) => void;
+    onClose?: (code: number, reason: string) => void;
+}
+/**
+ * Minimal WebSocket helper that:
+ * - Upgrades http(s) URL to ws(s)
+ * - Auth via Authorization header (standard approach)
+ * - Uses 'daml-ledger-api' subprotocol
+ * - Sends an initial request message
+ * - Dispatches parsed messages to user handlers
+ */
+export declare class WebSocketClient {
+    private client;
+    constructor(client: BaseClient);
+    connect<RequestMessage, InboundMessage, ErrorMessage = unknown>(path: string, requestMessage: RequestMessage, handlers: WebSocketHandlers<InboundMessage, ErrorMessage>): Promise<WebSocketSubscription>;
+    private buildWsUrl;
+}
+//# sourceMappingURL=WebSocketClient.d.ts.map

package/build/src/core/ws/WebSocketClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketClient.d.ts","sourceRoot":"","sources":["../../../../src/core/ws/WebSocketClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IACjE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,YAAY,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzB,OAAO,CAAC,cAAc,EAAE,cAAc,EAAE,YAAY,GAAG,OAAO,EAC1E,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,iBAAiB,CAAC,cAAc,EAAE,YAAY,CAAC,GACvD,OAAO,CAAC,qBAAqB,CAAC;IAwEjC,OAAO,CAAC,UAAU;CAMlB"}

package/build/src/core/ws/WebSocketClient.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const WebSocketErrorUtils_1 = require("./WebSocketErrorUtils");
+/**
+ * Minimal WebSocket helper that:
+ * - Upgrades http(s) URL to ws(s)
+ * - Auth via Authorization header (standard approach)
+ * - Uses 'daml-ledger-api' subprotocol
+ * - Sends an initial request message
+ * - Dispatches parsed messages to user handlers
+ */
+class WebSocketClient {
+    constructor(client) {
+        this.client = client;
+    }
+    async connect(path, requestMessage, handlers) {
+        const baseUrl = this.client.getApiUrl();
+        const wsUrl = this.buildWsUrl(baseUrl, path);
+        const token = await this.client.authenticate();
+        // Use standard WebSocket auth pattern:
+        // - JWT in Authorization header
+        // - Application protocol in subprotocol (daml.ws.auth)
+        const protocols = ['daml.ws.auth'];
+        const socket = new ws_1.default(wsUrl, protocols, {
+            handshakeTimeout: 30000,
+            headers: token ? { 'Authorization': `Bearer ${token}` } : undefined,
+        });
+        const logger = this.client.getLogger();
+        const log = async (event, payload) => {
+            if (logger) {
+                await logger.logRequestResponse(wsUrl, { event, requestMessage }, payload);
+            }
+        };
+        await log('connect', { headers: token ? { Authorization: '[REDACTED]' } : undefined, protocols });
+        socket.on('open', async () => {
+            try {
+                socket.send(JSON.stringify(requestMessage));
+                await log('send', requestMessage);
+                if (handlers.onOpen)
+                    handlers.onOpen();
+            }
+            catch (err) {
+                await log('send_error', err instanceof Error ? { message: err.message } : String(err));
+                if (handlers.onError)
+                    handlers.onError(err);
+                socket.close();
+            }
+        });
+        socket.on('message', async (data) => {
+            try {
+                const parsed = WebSocketErrorUtils_1.WebSocketErrorUtils.safeJsonParse(data.toString(), 'WebSocket message');
+                await log('message', parsed);
+                handlers.onMessage(parsed);
+            }
+            catch (err) {
+                await log('parse_error', { raw: data.toString(), error: err instanceof Error ? err.message : String(err) });
+                // Close connection on JSON parse failure to prevent inconsistent state
+                socket.close(1003, 'Invalid JSON received');
+                if (handlers.onError)
+                    handlers.onError(err);
+            }
+        });
+        socket.on('error', async (err) => {
+            await log('socket_error', { message: err.message });
+            if (handlers.onError)
+                handlers.onError(err);
+        });
+        socket.on('close', async (code, reason) => {
+            await log('close', { code, reason: reason.toString() });
+            if (handlers.onClose)
+                handlers.onClose(code, reason.toString());
+        });
+        return {
+            close: () => {
+                // Remove all event listeners to prevent memory leaks
+                socket.removeAllListeners();
+                socket.close();
+            },
+            isConnected: () => socket.readyState === ws_1.default.OPEN,
+            getConnectionState: () => socket.readyState,
+        };
+    }
+    buildWsUrl(base, path) {
+        const hasProtocol = base.startsWith('http://') || base.startsWith('https://');
+        const normalizedBase = hasProtocol ? base : `https://${base}`;
+        const wsBase = normalizedBase.replace(/^http:/, 'ws:').replace(/^https:/, 'wss:');
+        return `${wsBase}${path}`;
+    }
+}
+exports.WebSocketClient = WebSocketClient;
+//# sourceMappingURL=WebSocketClient.js.map

package/build/src/core/ws/WebSocketClient.js.map

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

package/build/src/core/ws/WebSocketErrorUtils.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/**
+ * Utility functions for consistent WebSocket error handling
+ */
+export declare class WebSocketErrorUtils {
+    /**
+     * Safely parses a message using multiple schemas, throwing descriptive errors if all fail
+     * @param msg - The message to parse
+     * @param schemas - Array of schemas to try in order
+     * @param operationName - Name of the operation for error context
+     * @returns The parsed message
+     * @throws CantonError if all schemas fail to parse
+     */
+    static parseWithFallback<T>(msg: unknown, schemas: Array<{
+        schema: z.ZodSchema<T>;
+        name: string;
+    }>, operationName: string): T;
+    /**
+     * Parses a union schema and returns the result without type assertion
+     * @param msg - The message to parse
+     * @param unionSchema - The Zod union schema
+     * @param operationName - Name of the operation for error context
+     * @returns The parsed message with proper typing
+     * @throws CantonError if parsing fails
+     */
+    static parseUnion<T>(msg: unknown, unionSchema: z.ZodSchema<T>, operationName: string): T;
+    /**
+     * Creates a safe JSON parser that throws descriptive errors
+     * @param data - Raw data to parse
+     * @param context - Context for error messages
+     * @returns Parsed JSON object
+     * @throws CantonError if JSON parsing fails
+     */
+    static safeJsonParse(data: string, context: string): unknown;
+}
+//# sourceMappingURL=WebSocketErrorUtils.d.ts.map

package/build/src/core/ws/WebSocketErrorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketErrorUtils.d.ts","sourceRoot":"","sources":["../../../../src/core/ws/WebSocketErrorUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EACxB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EACxD,aAAa,EAAE,MAAM,GACpB,CAAC;IAsBJ;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EACjB,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,GACpB,CAAC;IAmBJ;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAW7D"}

package/build/src/core/ws/WebSocketErrorUtils.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketErrorUtils = void 0;
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+/**
+ * Utility functions for consistent WebSocket error handling
+ */
+class WebSocketErrorUtils {
+    /**
+     * Safely parses a message using multiple schemas, throwing descriptive errors if all fail
+     * @param msg - The message to parse
+     * @param schemas - Array of schemas to try in order
+     * @param operationName - Name of the operation for error context
+     * @returns The parsed message
+     * @throws CantonError if all schemas fail to parse
+     */
+    static parseWithFallback(msg, schemas, operationName) {
+        const errors = [];
+        for (const { schema, name } of schemas) {
+            try {
+                return schema.parse(msg);
+            }
+            catch (error) {
+                if (error instanceof zod_1.z.ZodError) {
+                    errors.push(`${name}: ${error.issues.map(e => e.message).join(', ')}`);
+                }
+                else {
+                    errors.push(`${name}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+        throw new errors_1.CantonError(`Failed to parse ${operationName} message with any expected schema. Errors: ${errors.join('; ')}`, 'VALIDATION_ERROR', { originalMessage: msg, attemptedSchemas: schemas.map(s => s.name) });
+    }
+    /**
+     * Parses a union schema and returns the result without type assertion
+     * @param msg - The message to parse
+     * @param unionSchema - The Zod union schema
+     * @param operationName - Name of the operation for error context
+     * @returns The parsed message with proper typing
+     * @throws CantonError if parsing fails
+     */
+    static parseUnion(msg, unionSchema, operationName) {
+        try {
+            return unionSchema.parse(msg);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                throw new errors_1.CantonError(`Failed to parse ${operationName} message: ${error.issues.map(e => e.message).join(', ')}`, 'VALIDATION_ERROR', { originalMessage: msg, validationErrors: error.issues });
+            }
+            throw new errors_1.CantonError(`Failed to parse ${operationName} message: ${error instanceof Error ? error.message : String(error)}`, 'VALIDATION_ERROR', { originalMessage: msg });
+        }
+    }
+    /**
+     * Creates a safe JSON parser that throws descriptive errors
+     * @param data - Raw data to parse
+     * @param context - Context for error messages
+     * @returns Parsed JSON object
+     * @throws CantonError if JSON parsing fails
+     */
+    static safeJsonParse(data, context) {
+        try {
+            return JSON.parse(data);
+        }
+        catch (error) {
+            throw new errors_1.CantonError(`Failed to parse JSON in ${context}: ${error instanceof Error ? error.message : String(error)}`, 'VALIDATION_ERROR', { rawData: data, context });
+        }
+    }
+}
+exports.WebSocketErrorUtils = WebSocketErrorUtils;
+//# sourceMappingURL=WebSocketErrorUtils.js.map

package/build/src/core/ws/WebSocketErrorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketErrorUtils.js","sourceRoot":"","sources":["../../../../src/core/ws/WebSocketErrorUtils.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAwC;AAExC;;GAEG;AACH,MAAa,mBAAmB;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,iBAAiB,CACtB,GAAY,EACZ,OAAwD,EACxD,aAAqB;QAErB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACzE,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACpF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,oBAAW,CACnB,mBAAmB,aAAa,8CAA8C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACjG,kBAAkB,EAClB,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CACf,GAAY,EACZ,WAA2B,EAC3B,aAAqB;QAErB,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,oBAAW,CACnB,mBAAmB,aAAa,aAAa,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC1F,kBAAkB,EAClB,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,CACzD,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,oBAAW,CACnB,mBAAmB,aAAa,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACrG,kBAAkB,EAClB,EAAE,eAAe,EAAE,GAAG,EAAE,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,IAAY,EAAE,OAAe;QAChD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,oBAAW,CACnB,2BAA2B,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/F,kBAAkB,EAClB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApFD,kDAoFC"}

package/build/src/core/ws/index.d.ts

@@ -0,0 +1,2 @@
+export * from './WebSocketClient';
+//# sourceMappingURL=index.d.ts.map

package/build/src/core/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/ws/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/build/src/core/ws/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./WebSocketClient"), exports);
+//# sourceMappingURL=index.js.map

package/build/src/core/ws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/ws/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/canton-node-sdk",
-  "version": "0.0.88",
+  "version": "0.0.90",
   "description": "Canton Node SDK",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
@@ -11,7 +11,7 @@
     "build": "npm run build:core && npm run build:lint",
     "build:core": "npm run generate:openapi-types && npm run build:core:generate-client-methods && tsc",
     "build:core:generate-client-methods": "tsx scripts/generate-all-client-methods.ts",
-    "generate:openapi-types": "find artifacts/splice -name '*.yaml' -exec sh -c 'relative_path=\"$(echo \"$1\" | sed \"s|^artifacts/splice/||\" | sed \"s|\\.yaml$|.ts|\")\"; output_file=\"src/generated/$relative_path\"; mkdir -p \"$(dirname \"$output_file\")\"; npx openapi-typescript \"$1\" -o \"$output_file\"' _ {} \\;",
+    "generate:openapi-types": "tsx scripts/generate-openapi-types.ts",
     "build:lint": "tsc -p tsconfig.lint.json",
     "simulate": "tsx --tsconfig tsconfig.lint.json scripts/run-simulations.ts",
     "simulate:events": "tsx --tsconfig tsconfig.lint.json scripts/run-events-simulation.ts",
@@ -56,19 +56,20 @@
     "@types/jest": "30.0.0",
     "@types/node": "24.3.0",
     "@typescript-eslint/eslint-plugin": "8.40.0",
-    "@typescript-eslint/parser": "8.40.0",
+    "@typescript-eslint/parser": "8.41.0",
     "eslint": "9.34.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-markdown": "5.1.0",
     "eslint-plugin-prettier": "5.5.4",
-    "jest": "30.0.5",
+    "jest": "30.1.2",
     "markdownlint-cli": "0.45.0",
     "npm-package-json-lint": "9.0.0",
     "prettier": "3.6.2",
     "ts-jest": "29.4.1",
     "tsx": "4.20.5",
-    "typescript": "5.9.2"
+    "typescript": "5.9.2",
+    "@types/ws": "8.5.12"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -79,6 +80,7 @@
     "glob": "^11.0.3",
     "openapi-fetch": "^0.14.0",
     "openapi-typescript": "7.9.1",
-    "zod": "4.1.5"
+    "zod": "4.1.5",
+    "ws": "8.18.0"
   }
 }