@jack-kernel/sdk 1.0.0 → 1.1.0

package/dist/esm/yellow/clear-node-connection.js

@@ -0,0 +1,385 @@
+/**
+ * ClearNode WebSocket Connection Manager
+ *
+ * Manages the WebSocket connection to Yellow Network's ClearNode relay server
+ * with reconnection logic, request-response correlation, and event emission.
+ *
+ * Key features:
+ * - Exponential backoff reconnection: delay = initialDelay * 2^(attempt-1)
+ * - Request-response correlation using method name matching
+ * - EventEmitter pattern for connected/disconnected events
+ * - Cleanup of all pending handlers on disconnect
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+import { EventEmitter } from 'events';
+/** WebSocket readyState constants */
+const WS_OPEN = 1;
+const WS_CONNECTING = 0;
+/**
+ * Calculate the exponential backoff delay for a given reconnection attempt.
+ *
+ * Formula: delay = initialDelay * 2^(attempt - 1)
+ *
+ * This is exported as a pure function so it can be independently tested
+ * (including via property-based tests).
+ *
+ * @param initialDelay - The base delay in milliseconds
+ * @param attempt - The attempt number (1-based)
+ * @returns The delay in milliseconds before the given attempt
+ */
+export function calculateBackoffDelay(initialDelay, attempt) {
+    if (attempt < 1) {
+        return initialDelay;
+    }
+    return initialDelay * Math.pow(2, attempt - 1);
+}
+/**
+ * Manages a WebSocket connection to Yellow Network's ClearNode.
+ *
+ * Provides:
+ * - connect/disconnect lifecycle management
+ * - send (fire-and-forget) and sendAndWait (request-response correlation)
+ * - Automatic reconnection with exponential backoff
+ * - Event emission for 'connected' and 'disconnected' events
+ * - Cleanup of pending handlers on disconnect
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+export class ClearNodeConnection {
+    url;
+    maxReconnectAttempts;
+    reconnectDelay;
+    messageTimeout;
+    wsFactory;
+    ws = null;
+    emitter = new EventEmitter();
+    pendingRequests = [];
+    messageHandlers = [];
+    _isConnected = false;
+    _isDisposed = false;
+    reconnectAttempt = 0;
+    reconnectTimer = null;
+    /**
+     * @param url - The ClearNode WebSocket URL
+     * @param options - Connection configuration options
+     * @param wsFactory - Optional WebSocket factory for testing. Defaults to global WebSocket.
+     */
+    constructor(url, options, wsFactory) {
+        this.url = url;
+        this.maxReconnectAttempts = options?.maxReconnectAttempts ?? 5;
+        this.reconnectDelay = options?.reconnectDelay ?? 1000;
+        this.messageTimeout = options?.messageTimeout ?? 30000;
+        this.wsFactory = wsFactory ?? ((wsUrl) => new WebSocket(wsUrl));
+    }
+    /**
+     * Establish a WebSocket connection to ClearNode.
+     *
+     * Resolves when the connection is open and ready.
+     * Rejects if the connection fails to establish.
+     *
+     * Requirement 10.1: Emit a connected event on successful connection.
+     */
+    async connect() {
+        if (this._isDisposed) {
+            throw new Error('ClearNodeConnection has been disposed');
+        }
+        if (this._isConnected && this.ws) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            try {
+                this.ws = this.wsFactory(this.url);
+            }
+            catch (err) {
+                reject(new Error(`Failed to create WebSocket: ${err instanceof Error ? err.message : String(err)}`));
+                return;
+            }
+            this.ws.onopen = () => {
+                if (settled)
+                    return;
+                settled = true;
+                this._isConnected = true;
+                this.reconnectAttempt = 0;
+                this.emitter.emit('connected');
+                resolve();
+            };
+            this.ws.onerror = (event) => {
+                if (settled)
+                    return;
+                settled = true;
+                const errorMessage = event && typeof event === 'object' && 'message' in event
+                    ? String(event.message)
+                    : 'WebSocket connection failed';
+                reject(new Error(errorMessage));
+            };
+            this.ws.onclose = () => {
+                if (!settled) {
+                    settled = true;
+                    reject(new Error('WebSocket closed before connection was established'));
+                    return;
+                }
+                this.handleDisconnect();
+            };
+            this.ws.onmessage = (event) => {
+                this.handleMessage(event.data);
+            };
+        });
+    }
+    /**
+     * Close the WebSocket connection and clean up all resources.
+     *
+     * Requirement 10.4: Clean up all pending message handlers on disconnect.
+     */
+    async disconnect() {
+        this._isDisposed = true;
+        this.cancelReconnect();
+        this.cleanupPendingRequests(new Error('Connection closed by client'));
+        this.messageHandlers = [];
+        if (this.ws) {
+            const ws = this.ws;
+            this.ws = null;
+            this._isConnected = false;
+            // Remove handlers to prevent reconnection attempts
+            ws.onopen = null;
+            ws.onclose = null;
+            ws.onerror = null;
+            ws.onmessage = null;
+            // Only close if not already closed/closing
+            if (ws.readyState === WS_OPEN || ws.readyState === WS_CONNECTING) {
+                ws.close();
+            }
+            this.emitter.emit('disconnected');
+        }
+        this._isConnected = false;
+    }
+    /**
+     * Send a message and wait for a correlated response.
+     *
+     * The response is matched by method name: when a message is received
+     * that contains a matching method field, the promise resolves with that response.
+     *
+     * Requirement 10.5: Request-response correlation using method name matching.
+     *
+     * @param message - The message string to send
+     * @param method - The method name to correlate the response with
+     * @param timeout - Optional timeout in ms (defaults to messageTimeout)
+     * @returns The parsed response data
+     * @throws Error if the connection is not open, the request times out, or the connection drops
+     */
+    async sendAndWait(message, method, timeout) {
+        if (!this._isConnected || !this.ws || this.ws.readyState !== WS_OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        const effectiveTimeout = timeout ?? this.messageTimeout;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.removePendingRequest(pending);
+                reject(new Error(`Request timed out waiting for response to method: ${method}`));
+            }, effectiveTimeout);
+            const pending = {
+                method,
+                resolve: resolve,
+                reject,
+                timer,
+            };
+            this.pendingRequests.push(pending);
+            this.ws.send(message);
+        });
+    }
+    /**
+     * Send a message without waiting for a response (fire-and-forget).
+     *
+     * @param message - The message string to send
+     * @throws Error if the connection is not open
+     */
+    send(message) {
+        if (!this._isConnected || !this.ws || this.ws.readyState !== WS_OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        this.ws.send(message);
+    }
+    /**
+     * Register a handler for incoming messages.
+     *
+     * Handlers receive the parsed message data for all incoming messages
+     * (including those that match pending requests).
+     *
+     * @param handler - Callback invoked with the parsed message data
+     */
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    /**
+     * Whether the WebSocket connection is currently open and ready.
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Register an event listener for connection lifecycle events.
+     *
+     * Supported events: 'connected', 'disconnected'
+     */
+    on(event, handler) {
+        this.emitter.on(event, handler);
+    }
+    /**
+     * Remove an event listener.
+     */
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    /**
+     * Handle an incoming WebSocket message.
+     *
+     * Parses the message as JSON and checks for method-based correlation
+     * with pending requests. Also dispatches to all registered message handlers.
+     */
+    handleMessage(rawData) {
+        let data;
+        try {
+            const text = typeof rawData === 'string' ? rawData : String(rawData);
+            data = JSON.parse(text);
+        }
+        catch {
+            // If the message is not valid JSON, pass the raw data
+            data = rawData;
+        }
+        // Dispatch to all registered message handlers
+        for (const handler of this.messageHandlers) {
+            try {
+                handler(data);
+            }
+            catch {
+                // Swallow handler errors to prevent one handler from breaking others
+            }
+        }
+        // Check for method-based correlation with pending requests
+        if (data && typeof data === 'object') {
+            const messageObj = data;
+            const responseMethod = this.extractMethod(messageObj);
+            if (responseMethod) {
+                const matchIndex = this.pendingRequests.findIndex((req) => req.method === responseMethod);
+                if (matchIndex !== -1) {
+                    const pending = this.pendingRequests[matchIndex];
+                    this.pendingRequests.splice(matchIndex, 1);
+                    clearTimeout(pending.timer);
+                    pending.resolve(data);
+                }
+            }
+        }
+    }
+    /**
+     * Extract the method name from a parsed message object.
+     *
+     * Supports common message formats:
+     * - { method: "..." }
+     * - { type: "..." }
+     * - Nested: { response: { method: "..." } }
+     */
+    extractMethod(obj) {
+        // Direct method field
+        if (typeof obj.method === 'string') {
+            return obj.method;
+        }
+        // Type field as fallback
+        if (typeof obj.type === 'string') {
+            return obj.type;
+        }
+        // Nested response object
+        if (obj.response && typeof obj.response === 'object') {
+            const response = obj.response;
+            if (typeof response.method === 'string') {
+                return response.method;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Handle an unexpected WebSocket disconnection.
+     *
+     * Cleans up state and initiates reconnection with exponential backoff.
+     *
+     * Requirement 10.2: Exponential backoff reconnection.
+     * Requirement 10.3: Emit disconnected and mark unavailable when retries exhausted.
+     */
+    handleDisconnect() {
+        const wasConnected = this._isConnected;
+        this._isConnected = false;
+        this.ws = null;
+        // If disposed, don't attempt reconnection
+        if (this._isDisposed) {
+            return;
+        }
+        // Attempt reconnection
+        if (wasConnected) {
+            this.attemptReconnect();
+        }
+    }
+    /**
+     * Attempt to reconnect with exponential backoff.
+     *
+     * Requirement 10.2: delay = initialDelay * 2^(attempt-1)
+     * Requirement 10.3: Mark provider unavailable when all retries exhausted.
+     */
+    attemptReconnect() {
+        this.reconnectAttempt++;
+        if (this.reconnectAttempt > this.maxReconnectAttempts) {
+            // All retries exhausted
+            this.cleanupPendingRequests(new Error('All reconnection attempts exhausted'));
+            this.emitter.emit('disconnected');
+            return;
+        }
+        const delay = calculateBackoffDelay(this.reconnectDelay, this.reconnectAttempt);
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = null;
+            if (this._isDisposed) {
+                return;
+            }
+            try {
+                await this.connect();
+            }
+            catch {
+                // Connection failed, try again
+                this.attemptReconnect();
+            }
+        }, delay);
+    }
+    /**
+     * Cancel any pending reconnection timer.
+     */
+    cancelReconnect() {
+        if (this.reconnectTimer !== null) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    /**
+     * Reject all pending requests with the given error and clean up timers.
+     *
+     * Requirement 10.4: Clean up all pending message handlers on disconnect.
+     */
+    cleanupPendingRequests(error) {
+        const pending = [...this.pendingRequests];
+        this.pendingRequests = [];
+        for (const req of pending) {
+            clearTimeout(req.timer);
+            req.reject(error);
+        }
+    }
+    /**
+     * Remove a specific pending request from the list.
+     */
+    removePendingRequest(request) {
+        const index = this.pendingRequests.indexOf(request);
+        if (index !== -1) {
+            this.pendingRequests.splice(index, 1);
+        }
+    }
+}
+//# sourceMappingURL=clear-node-connection.js.map

package/dist/esm/yellow/clear-node-connection.js.map

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

package/dist/esm/yellow/event-mapper.js

@@ -0,0 +1,248 @@
+/**
+ * Yellow Network Event-to-Status Mapper
+ *
+ * Maps Yellow Network events, channel statuses, and state intents to JACK
+ * ExecutionStatus values. These are pure functions with no side effects,
+ * extracted from the dashboard's route.ts mapping tables into SDK-level
+ * reusable functions.
+ *
+ * Requirements: 9.1, 9.2, 9.3, 9.4, 9.5, 9.6
+ */
+import { ExecutionStatus } from '../types.js';
+// ============================================================================
+// Terminal statuses — only SETTLED, ABORTED, and EXPIRED are terminal
+// ============================================================================
+const TERMINAL_STATUSES = new Set([
+    ExecutionStatus.SETTLED,
+    ExecutionStatus.ABORTED,
+    ExecutionStatus.EXPIRED,
+]);
+// ============================================================================
+// Yellow Event Mapping Table
+// ============================================================================
+const EVENT_STATUS_MAP = {
+    quote_accepted: {
+        executionStatus: ExecutionStatus.QUOTED,
+        stepLabel: 'Solver Quote Accepted (Yellow Network)',
+        stepStatus: 'COMPLETED',
+        isTerminal: false,
+    },
+    solver_quoted: {
+        executionStatus: ExecutionStatus.QUOTED,
+        stepLabel: 'Solver Quote Received (Yellow Network)',
+        stepStatus: 'COMPLETED',
+        isTerminal: false,
+    },
+    execution_started: {
+        executionStatus: ExecutionStatus.EXECUTING,
+        stepLabel: 'Execution Started (Yellow Network)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    routing_started: {
+        executionStatus: ExecutionStatus.EXECUTING,
+        stepLabel: 'Cross-Chain Routing Started (Yellow Network)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    settlement_submitted: {
+        executionStatus: ExecutionStatus.SETTLING,
+        stepLabel: 'Settlement Submitted (Yellow Network)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    settled: {
+        executionStatus: ExecutionStatus.SETTLED,
+        stepLabel: 'Settlement Finalized (Yellow Network)',
+        stepStatus: 'COMPLETED',
+        isTerminal: true,
+    },
+    settlement_finalized: {
+        executionStatus: ExecutionStatus.SETTLED,
+        stepLabel: 'Settlement Finalized (Yellow Network)',
+        stepStatus: 'COMPLETED',
+        isTerminal: true,
+    },
+    failed: {
+        executionStatus: ExecutionStatus.ABORTED,
+        stepLabel: 'Execution Failed (Yellow Network)',
+        stepStatus: 'FAILED',
+        isTerminal: true,
+    },
+    execution_failed: {
+        executionStatus: ExecutionStatus.ABORTED,
+        stepLabel: 'Execution Failed (Yellow Network)',
+        stepStatus: 'FAILED',
+        isTerminal: true,
+    },
+    settlement_failed: {
+        executionStatus: ExecutionStatus.ABORTED,
+        stepLabel: 'Settlement Failed (Yellow Network)',
+        stepStatus: 'FAILED',
+        isTerminal: true,
+    },
+    expired: {
+        executionStatus: ExecutionStatus.EXPIRED,
+        stepLabel: 'Intent Expired (Yellow Network)',
+        stepStatus: 'FAILED',
+        isTerminal: true,
+    },
+    canceled: {
+        executionStatus: ExecutionStatus.ABORTED,
+        stepLabel: 'Intent Canceled (Yellow Network)',
+        stepStatus: 'FAILED',
+        isTerminal: true,
+    },
+};
+// ============================================================================
+// Channel Status Mapping Table
+// ============================================================================
+const CHANNEL_STATUS_MAP = {
+    void: {
+        executionStatus: ExecutionStatus.CREATED,
+        stepLabel: 'Channel Status: VOID (ERC-7824)',
+        stepStatus: 'COMPLETED',
+        isTerminal: false,
+    },
+    initial: {
+        executionStatus: ExecutionStatus.QUOTED,
+        stepLabel: 'Channel Status: INITIAL (ERC-7824)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    active: {
+        executionStatus: ExecutionStatus.EXECUTING,
+        stepLabel: 'Channel Status: ACTIVE (ERC-7824)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    dispute: {
+        executionStatus: ExecutionStatus.EXECUTING,
+        stepLabel: 'Channel Status: DISPUTE (ERC-7824)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    final: {
+        executionStatus: ExecutionStatus.SETTLED,
+        stepLabel: 'Channel Status: FINAL (ERC-7824)',
+        stepStatus: 'COMPLETED',
+        isTerminal: true,
+    },
+};
+// ============================================================================
+// State Intent Mapping Table
+// ============================================================================
+const STATE_INTENT_MAP = {
+    initialize: {
+        executionStatus: ExecutionStatus.QUOTED,
+        stepLabel: 'State Intent: INITIALIZE (ERC-7824)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    operate: {
+        executionStatus: ExecutionStatus.EXECUTING,
+        stepLabel: 'State Intent: OPERATE (ERC-7824)',
+        stepStatus: 'IN_PROGRESS',
+        isTerminal: false,
+    },
+    resize: {
+        executionStatus: ExecutionStatus.EXECUTING,
+        stepLabel: 'State Intent: RESIZE (ERC-7824)',
+        stepStatus: 'COMPLETED',
+        isTerminal: false,
+    },
+    finalize: {
+        executionStatus: ExecutionStatus.SETTLED,
+        stepLabel: 'State Intent: FINALIZE (ERC-7824)',
+        stepStatus: 'COMPLETED',
+        isTerminal: true,
+    },
+};
+// ============================================================================
+// Normalization Helper
+// ============================================================================
+/**
+ * Normalizes an event/status/intent string to lowercase with underscores.
+ * Trims whitespace and replaces spaces and hyphens with underscores.
+ */
+function normalizeKey(value) {
+    return value.trim().toLowerCase().replace(/[\s-]+/g, '_');
+}
+// ============================================================================
+// Public Mapping Functions
+// ============================================================================
+/**
+ * Map a Yellow Network event name to a JACK MappedEvent.
+ *
+ * Accepts event names in any casing; normalizes to lowercase with underscores.
+ * Returns undefined for unknown events.
+ *
+ * @param event - The Yellow Network event name (e.g., "quote_accepted", "settled")
+ * @returns The corresponding MappedEvent, or undefined if the event is unknown
+ *
+ * Requirements: 9.1, 9.2, 9.3, 9.4, 9.5
+ */
+export function mapYellowEvent(event) {
+    const key = normalizeKey(event);
+    return Object.hasOwn(EVENT_STATUS_MAP, key) ? EVENT_STATUS_MAP[key] : undefined;
+}
+/**
+ * Map a channel status to a JACK MappedEvent.
+ *
+ * Accepts channel statuses in any casing (e.g., "ACTIVE", "active", "Active").
+ * Returns undefined for unknown statuses.
+ *
+ * @param status - The ERC-7824 channel status (e.g., "VOID", "ACTIVE", "FINAL")
+ * @returns The corresponding MappedEvent, or undefined if the status is unknown
+ *
+ * Requirement: 9.6
+ */
+export function mapChannelStatus(status) {
+    const key = normalizeKey(status);
+    return Object.hasOwn(CHANNEL_STATUS_MAP, key) ? CHANNEL_STATUS_MAP[key] : undefined;
+}
+/**
+ * Map a state intent to a JACK MappedEvent.
+ *
+ * Accepts state intents in any casing (e.g., "FINALIZE", "finalize", "Finalize").
+ * Returns undefined for unknown intents.
+ *
+ * @param intent - The ERC-7824 state intent (e.g., "INITIALIZE", "OPERATE", "FINALIZE")
+ * @returns The corresponding MappedEvent, or undefined if the intent is unknown
+ *
+ * Requirement: 9.6
+ */
+export function mapStateIntent(intent) {
+    const key = normalizeKey(intent);
+    return Object.hasOwn(STATE_INTENT_MAP, key) ? STATE_INTENT_MAP[key] : undefined;
+}
+/**
+ * Infer the best mapping from a notification payload.
+ *
+ * Checks fields in priority order: event → channelStatus → stateIntent.
+ * Returns the first successful mapping, or undefined if no field matches.
+ *
+ * @param notification - An object with optional event, channelStatus, and stateIntent fields
+ * @returns The best matching MappedEvent, or undefined if no mapping is found
+ *
+ * Requirements: 9.1, 9.2, 9.3, 9.4, 9.5, 9.6
+ */
+export function inferMapping(notification) {
+    if (notification.event) {
+        const mapped = mapYellowEvent(notification.event);
+        if (mapped)
+            return mapped;
+    }
+    if (notification.channelStatus) {
+        const mapped = mapChannelStatus(notification.channelStatus);
+        if (mapped)
+            return mapped;
+    }
+    if (notification.stateIntent) {
+        const mapped = mapStateIntent(notification.stateIntent);
+        if (mapped)
+            return mapped;
+    }
+    return undefined;
+}
+//# sourceMappingURL=event-mapper.js.map

package/dist/esm/yellow/event-mapper.js.map

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