@forthix/forthic 0.7.2 → 0.8.0

package/dist/esm/websocket/action_cable_client.js

@@ -1,265 +0,0 @@
-/**
- * ActionCable Client for Forthic
- * Browser-compatible client that mirrors GrpcClient API
- * Specifically designed for Rails ActionCable WebSocket protocol
- */
-import { serializeStack, deserializeStack } from './serializer.js';
-import { RemoteRuntimeError } from './errors.js';
-/**
- * ActionCable client for executing words in remote Forthic runtimes
- * Mirrors the GrpcClient API for compatibility
- * Uses Rails ActionCable WebSocket protocol
- */
-export class ActionCableClient {
-    ws;
-    config;
-    pendingRequests = new Map();
-    messageId = 0;
-    connected = false;
-    connectionPromise;
-    constructor(config) {
-        this.config = {
-            url: config.url,
-            timezone: config.timezone || 'UTC',
-            reconnect: config.reconnect ?? true,
-            reconnectDelay: config.reconnectDelay || 3000,
-            channel: config.channel || 'ForthicRuntimeChannel',
-        };
-        this.connect();
-    }
-    /**
-     * Connect to the WebSocket server
-     */
-    connect() {
-        if (this.connectionPromise) {
-            return this.connectionPromise;
-        }
-        this.connectionPromise = new Promise((resolve, reject) => {
-            try {
-                this.ws = new WebSocket(this.config.url);
-                this.ws.onopen = () => {
-                    this.connected = true;
-                    // Subscribe to ActionCable channel
-                    const subscribeMessage = {
-                        command: 'subscribe',
-                        identifier: JSON.stringify({
-                            channel: this.config.channel,
-                            timezone: this.config.timezone,
-                        }),
-                    };
-                    this.ws.send(JSON.stringify(subscribeMessage));
-                    resolve();
-                };
-                this.ws.onmessage = (event) => {
-                    this.handleMessage(event);
-                };
-                this.ws.onerror = (error) => {
-                    console.error('WebSocket error:', error);
-                    reject(new Error('WebSocket connection error'));
-                };
-                this.ws.onclose = () => {
-                    this.connected = false;
-                    this.connectionPromise = undefined;
-                    // Reject all pending requests
-                    for (const [id, pending] of this.pendingRequests.entries()) {
-                        pending.reject(new Error('WebSocket connection closed'));
-                    }
-                    this.pendingRequests.clear();
-                    // Attempt reconnect if enabled
-                    if (this.config.reconnect) {
-                        setTimeout(() => this.connect(), this.config.reconnectDelay);
-                    }
-                };
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
-        return this.connectionPromise;
-    }
-    /**
-     * Handle incoming WebSocket messages
-     */
-    handleMessage(event) {
-        try {
-            const data = JSON.parse(event.data);
-            // Handle ActionCable control messages
-            if (data.type === 'welcome' || data.type === 'ping' || data.type === 'confirm_subscription') {
-                return;
-            }
-            // Extract the actual message from ActionCable envelope
-            const message = data.message || data;
-            if (!message.id) {
-                console.warn('Received message without ID:', message);
-                return;
-            }
-            // Handle streaming progress updates
-            if (message.type === 'streaming_progress') {
-                const pending = this.pendingRequests.get(message.id);
-                if (pending?.onProgress) {
-                    pending.onProgress(message.progress);
-                }
-                return;
-            }
-            // Handle final responses
-            const pending = this.pendingRequests.get(message.id);
-            if (!pending) {
-                console.warn('Received response for unknown request:', message.id);
-                return;
-            }
-            if (message.error) {
-                pending.reject(new RemoteRuntimeError(message.error));
-            }
-            else {
-                pending.resolve(message.result);
-            }
-            this.pendingRequests.delete(message.id);
-        }
-        catch (error) {
-            console.error('Error handling WebSocket message:', error);
-        }
-    }
-    /**
-     * Generate next message ID
-     */
-    nextMessageId() {
-        return `msg-${++this.messageId}-${Date.now()}`;
-    }
-    /**
-     * Send a request and wait for response
-     * @template T The expected result type (the value of the `result` field)
-     */
-    async sendRequest(message) {
-        await this.ensureConnected();
-        return new Promise((resolve, reject) => {
-            this.pendingRequests.set(message.id, { resolve, reject });
-            // Wrap message in ActionCable format
-            const actionCableMessage = {
-                command: 'message',
-                identifier: JSON.stringify({
-                    channel: this.config.channel,
-                }),
-                data: JSON.stringify(message),
-            };
-            this.ws.send(JSON.stringify(actionCableMessage));
-        });
-    }
-    /**
-     * Send a streaming request with progress callbacks
-     * @template T The expected result type (the value of the `result` field)
-     */
-    async sendStreamingRequest(message, onProgress) {
-        await this.ensureConnected();
-        return new Promise((resolve, reject) => {
-            this.pendingRequests.set(message.id, { resolve, reject, onProgress });
-            // Wrap message in ActionCable format
-            const actionCableMessage = {
-                command: 'message',
-                identifier: JSON.stringify({
-                    channel: this.config.channel,
-                }),
-                data: JSON.stringify(message),
-            };
-            this.ws.send(JSON.stringify(actionCableMessage));
-        });
-    }
-    /**
-     * Ensure WebSocket is connected
-     */
-    async ensureConnected() {
-        if (!this.connected) {
-            await this.connect();
-        }
-    }
-    /**
-     * Execute a word in the remote runtime
-     * Mirrors GrpcClient.executeWord
-     */
-    async executeWord(word, stack) {
-        const message = {
-            type: 'execute_word',
-            id: this.nextMessageId(),
-            params: {
-                word,
-                stack: serializeStack(stack),
-            },
-        };
-        const result = await this.sendRequest(message);
-        return deserializeStack(result.stack);
-    }
-    /**
-     * Execute a sequence of words (batched execution)
-     * Mirrors GrpcClient.executeSequence
-     */
-    async executeSequence(words, stack) {
-        const message = {
-            type: 'execute_sequence',
-            id: this.nextMessageId(),
-            params: {
-                words,
-                stack: serializeStack(stack),
-            },
-        };
-        const result = await this.sendRequest(message);
-        return deserializeStack(result.stack);
-    }
-    /**
-     * List available runtime-specific modules
-     * Mirrors GrpcClient.listModules
-     */
-    async listModules() {
-        const message = {
-            type: 'list_modules',
-            id: this.nextMessageId(),
-        };
-        const result = await this.sendRequest(message);
-        return result.modules || [];
-    }
-    /**
-     * Get detailed information about a specific module
-     * Mirrors GrpcClient.getModuleInfo
-     */
-    async getModuleInfo(moduleName) {
-        const message = {
-            type: 'get_module_info',
-            id: this.nextMessageId(),
-            params: {
-                module_name: moduleName,
-            },
-        };
-        return await this.sendRequest(message);
-    }
-    /**
-     * Execute code with streaming progress updates (NEW capability)
-     */
-    async streamingExecute(code, stack, onProgress) {
-        const message = {
-            type: 'streaming_execute',
-            id: this.nextMessageId(),
-            params: {
-                code,
-                stack: serializeStack(stack),
-            },
-        };
-        const result = await this.sendStreamingRequest(message, onProgress);
-        return deserializeStack(result.stack);
-    }
-    /**
-     * Close the WebSocket connection
-     */
-    close() {
-        if (this.ws) {
-            this.config.reconnect = false; // Disable auto-reconnect
-            this.ws.close();
-            this.ws = undefined;
-            this.connected = false;
-        }
-    }
-    /**
-     * Check if the client is connected
-     */
-    isConnected() {
-        return this.connected;
-    }
-}
-//# sourceMappingURL=action_cable_client.js.map

package/dist/esm/websocket/action_cable_client.js.map

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

package/dist/esm/websocket/client.d.ts

@@ -1,103 +0,0 @@
-/**
- * WebSocket Client for Forthic
- * Browser-compatible client that mirrors GrpcClient API
- * Connects to Rails ActionCable server and executes remote words
- */
-import { StackValue } from './serializer.js';
-export interface ModuleSummary {
-    name: string;
-    description: string;
-    word_count: number;
-}
-export interface WordInfo {
-    name: string;
-    stack_effect: string;
-    description: string;
-}
-export interface ModuleInfo {
-    module_name: string;
-    words: WordInfo[];
-}
-export interface ProgressUpdate {
-    step: number;
-    total_steps: number;
-    current_word: string;
-    message?: string;
-    partial_stack?: StackValue[];
-}
-export interface WebSocketClientConfig {
-    url: string;
-    timezone?: string;
-    reconnect?: boolean;
-    reconnectDelay?: number;
-    channel?: string;
-}
-/**
- * WebSocket client for executing words in remote Forthic runtimes
- * Mirrors the GrpcClient API for compatibility
- */
-export declare class WebSocketClient {
-    private ws?;
-    private config;
-    private pendingRequests;
-    private messageId;
-    private connected;
-    private connectionPromise?;
-    constructor(config: WebSocketClientConfig);
-    /**
-     * Connect to the WebSocket server
-     */
-    private connect;
-    /**
-     * Handle incoming WebSocket messages
-     */
-    private handleMessage;
-    /**
-     * Generate next message ID
-     */
-    private nextMessageId;
-    /**
-     * Send a request and wait for response
-     */
-    private sendRequest;
-    /**
-     * Send a streaming request with progress callbacks
-     */
-    private sendStreamingRequest;
-    /**
-     * Ensure WebSocket is connected
-     */
-    private ensureConnected;
-    /**
-     * Execute a word in the remote runtime
-     * Mirrors GrpcClient.executeWord
-     */
-    executeWord(word: string, stack: any[]): Promise<any[]>;
-    /**
-     * Execute a sequence of words (batched execution)
-     * Mirrors GrpcClient.executeSequence
-     */
-    executeSequence(words: string[], stack: any[]): Promise<any[]>;
-    /**
-     * List available runtime-specific modules
-     * Mirrors GrpcClient.listModules
-     */
-    listModules(): Promise<ModuleSummary[]>;
-    /**
-     * Get detailed information about a specific module
-     * Mirrors GrpcClient.getModuleInfo
-     */
-    getModuleInfo(moduleName: string): Promise<ModuleInfo>;
-    /**
-     * Execute code with streaming progress updates (NEW capability)
-     */
-    streamingExecute(code: string, stack: any[], onProgress?: (progress: ProgressUpdate) => void): Promise<any[]>;
-    /**
-     * Close the WebSocket connection
-     */
-    close(): void;
-    /**
-     * Check if the client is connected
-     */
-    isConnected(): boolean;
-}

package/dist/esm/websocket/client.js

@@ -1,262 +0,0 @@
-/**
- * WebSocket Client for Forthic
- * Browser-compatible client that mirrors GrpcClient API
- * Connects to Rails ActionCable server and executes remote words
- */
-import { serializeStack, deserializeStack } from './serializer.js';
-import { RemoteRuntimeError } from './errors.js';
-/**
- * WebSocket client for executing words in remote Forthic runtimes
- * Mirrors the GrpcClient API for compatibility
- */
-export class WebSocketClient {
-    ws;
-    config;
-    pendingRequests = new Map();
-    messageId = 0;
-    connected = false;
-    connectionPromise;
-    constructor(config) {
-        this.config = {
-            url: config.url,
-            timezone: config.timezone || 'UTC',
-            reconnect: config.reconnect ?? true,
-            reconnectDelay: config.reconnectDelay || 3000,
-            channel: config.channel || 'ForthicRuntimeChannel',
-        };
-        this.connect();
-    }
-    /**
-     * Connect to the WebSocket server
-     */
-    connect() {
-        if (this.connectionPromise) {
-            return this.connectionPromise;
-        }
-        this.connectionPromise = new Promise((resolve, reject) => {
-            try {
-                this.ws = new WebSocket(this.config.url);
-                this.ws.onopen = () => {
-                    this.connected = true;
-                    // Subscribe to ActionCable channel
-                    const subscribeMessage = {
-                        command: 'subscribe',
-                        identifier: JSON.stringify({
-                            channel: this.config.channel,
-                            timezone: this.config.timezone,
-                        }),
-                    };
-                    this.ws.send(JSON.stringify(subscribeMessage));
-                    resolve();
-                };
-                this.ws.onmessage = (event) => {
-                    this.handleMessage(event);
-                };
-                this.ws.onerror = (error) => {
-                    console.error('WebSocket error:', error);
-                    reject(new Error('WebSocket connection error'));
-                };
-                this.ws.onclose = () => {
-                    this.connected = false;
-                    this.connectionPromise = undefined;
-                    // Reject all pending requests
-                    for (const [id, pending] of this.pendingRequests.entries()) {
-                        pending.reject(new Error('WebSocket connection closed'));
-                    }
-                    this.pendingRequests.clear();
-                    // Attempt reconnect if enabled
-                    if (this.config.reconnect) {
-                        setTimeout(() => this.connect(), this.config.reconnectDelay);
-                    }
-                };
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
-        return this.connectionPromise;
-    }
-    /**
-     * Handle incoming WebSocket messages
-     */
-    handleMessage(event) {
-        try {
-            const data = JSON.parse(event.data);
-            // Handle ActionCable control messages
-            if (data.type === 'welcome' || data.type === 'ping' || data.type === 'confirm_subscription') {
-                return;
-            }
-            // Extract the actual message from ActionCable envelope
-            const message = data.message || data;
-            if (!message.id) {
-                console.warn('Received message without ID:', message);
-                return;
-            }
-            // Handle streaming progress updates
-            if (message.type === 'streaming_progress') {
-                const pending = this.pendingRequests.get(message.id);
-                if (pending?.onProgress) {
-                    pending.onProgress(message.progress);
-                }
-                return;
-            }
-            // Handle final responses
-            const pending = this.pendingRequests.get(message.id);
-            if (!pending) {
-                console.warn('Received response for unknown request:', message.id);
-                return;
-            }
-            if (message.error) {
-                pending.reject(new RemoteRuntimeError(message.error));
-            }
-            else {
-                pending.resolve(message.result);
-            }
-            this.pendingRequests.delete(message.id);
-        }
-        catch (error) {
-            console.error('Error handling WebSocket message:', error);
-        }
-    }
-    /**
-     * Generate next message ID
-     */
-    nextMessageId() {
-        return `msg-${++this.messageId}-${Date.now()}`;
-    }
-    /**
-     * Send a request and wait for response
-     */
-    async sendRequest(message) {
-        await this.ensureConnected();
-        return new Promise((resolve, reject) => {
-            this.pendingRequests.set(message.id, { resolve, reject });
-            // Wrap message in ActionCable format
-            const actionCableMessage = {
-                command: 'message',
-                identifier: JSON.stringify({
-                    channel: this.config.channel,
-                }),
-                data: JSON.stringify(message),
-            };
-            this.ws.send(JSON.stringify(actionCableMessage));
-        });
-    }
-    /**
-     * Send a streaming request with progress callbacks
-     */
-    async sendStreamingRequest(message, onProgress) {
-        await this.ensureConnected();
-        return new Promise((resolve, reject) => {
-            this.pendingRequests.set(message.id, { resolve, reject, onProgress });
-            // Wrap message in ActionCable format
-            const actionCableMessage = {
-                command: 'message',
-                identifier: JSON.stringify({
-                    channel: this.config.channel,
-                }),
-                data: JSON.stringify(message),
-            };
-            this.ws.send(JSON.stringify(actionCableMessage));
-        });
-    }
-    /**
-     * Ensure WebSocket is connected
-     */
-    async ensureConnected() {
-        if (!this.connected) {
-            await this.connect();
-        }
-    }
-    /**
-     * Execute a word in the remote runtime
-     * Mirrors GrpcClient.executeWord
-     */
-    async executeWord(word, stack) {
-        const message = {
-            type: 'execute_word',
-            id: this.nextMessageId(),
-            params: {
-                word,
-                stack: serializeStack(stack),
-            },
-        };
-        const result = await this.sendRequest(message);
-        return deserializeStack(result.stack);
-    }
-    /**
-     * Execute a sequence of words (batched execution)
-     * Mirrors GrpcClient.executeSequence
-     */
-    async executeSequence(words, stack) {
-        const message = {
-            type: 'execute_sequence',
-            id: this.nextMessageId(),
-            params: {
-                words,
-                stack: serializeStack(stack),
-            },
-        };
-        const result = await this.sendRequest(message);
-        return deserializeStack(result.stack);
-    }
-    /**
-     * List available runtime-specific modules
-     * Mirrors GrpcClient.listModules
-     */
-    async listModules() {
-        const message = {
-            type: 'list_modules',
-            id: this.nextMessageId(),
-        };
-        const result = await this.sendRequest(message);
-        return result.modules || [];
-    }
-    /**
-     * Get detailed information about a specific module
-     * Mirrors GrpcClient.getModuleInfo
-     */
-    async getModuleInfo(moduleName) {
-        const message = {
-            type: 'get_module_info',
-            id: this.nextMessageId(),
-            params: {
-                module_name: moduleName,
-            },
-        };
-        return await this.sendRequest(message);
-    }
-    /**
-     * Execute code with streaming progress updates (NEW capability)
-     */
-    async streamingExecute(code, stack, onProgress) {
-        const message = {
-            type: 'streaming_execute',
-            id: this.nextMessageId(),
-            params: {
-                code,
-                stack: serializeStack(stack),
-            },
-        };
-        const result = await this.sendStreamingRequest(message, onProgress);
-        return deserializeStack(result.stack);
-    }
-    /**
-     * Close the WebSocket connection
-     */
-    close() {
-        if (this.ws) {
-            this.config.reconnect = false; // Disable auto-reconnect
-            this.ws.close();
-            this.ws = undefined;
-            this.connected = false;
-        }
-    }
-    /**
-     * Check if the client is connected
-     */
-    isConnected() {
-        return this.connected;
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/esm/websocket/client.js.map

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