@camera.ui/rpc 1.0.1

package/README.md

@@ -0,0 +1,3 @@
+# @camera.ui/rpc
+
+This is the Node implementation of the camera-ui-rpc library.

package/dist/channel.d.ts

@@ -0,0 +1,106 @@
+import type { RPCClient } from './client.js';
+export interface ChannelMessage {
+    type: 'message' | 'close' | 'error';
+    data?: any;
+    error?: string;
+    sender?: string;
+}
+/**
+ * Bidirectional communication channel between RPC clients
+ */
+export declare class Channel {
+    protected client: RPCClient;
+    protected channelId: string;
+    protected closed: boolean;
+    protected unsubscribe?: () => void;
+    protected initialized: boolean;
+    private handlers;
+    private closeHandlers;
+    private errorHandlers;
+    private subscriptions;
+    /**
+     * Check if channel is closed
+     */
+    get isClosed(): boolean;
+    /**
+     * Get the channel ID
+     */
+    get id(): string;
+    constructor(client: RPCClient, channelId: string);
+    /**
+     * Initialize the channel (called by RPCClient)
+     */
+    init(): Promise<void>;
+    /**
+     * Send data through the channel
+     */
+    send<TMessage = any>(data: TMessage): Promise<void>;
+    /**
+     * Send a request and wait for reply
+     */
+    request<TRequest = any, TResponse = any>(data: TRequest, timeout?: number): Promise<TResponse>;
+    /**
+     * Setup a request handler for this channel
+     */
+    onRequest<TRequest = any, TResponse = any>(handler: (data: TRequest) => Promise<TResponse> | TResponse): Promise<() => void>;
+    /**
+     * Listen for messages
+     */
+    on<TEvent = any>(event: 'message', handler: (data: TEvent) => void): void;
+    on(event: 'close', handler: () => void): void;
+    on(event: 'error', handler: (error: Error) => void): void;
+    /**
+     * Remove event listener
+     */
+    off<TEvent = any>(event: 'message', handler: (data: TEvent) => void): void;
+    off(event: 'close', handler: () => void): void;
+    off(event: 'error', handler: (error: Error) => void): void;
+    /**
+     * Close the channel gracefully
+     */
+    close(): Promise<void>;
+    private handlerChain;
+    private runHandler;
+    protected emit(event: string, data?: any): void;
+    protected handleClose(): void;
+    protected handleError(error: Error): void;
+    protected cleanup(): Promise<void>;
+}
+/**
+ * Private channel for 1:1 communication between two specific clients
+ */
+export declare class PrivateChannel extends Channel {
+    private targetClientId;
+    private readonly clientId;
+    private remoteClientId?;
+    /**
+     * Get the remote client ID (if connected)
+     */
+    get remoteId(): string | undefined;
+    constructor(client: RPCClient, channelId: string, targetClientId: string);
+    /**
+     * Initialize private channel with handshake
+     */
+    init(): Promise<void>;
+    /**
+     * Send data through the private channel
+     */
+    send<TMessage = any>(data: TMessage): Promise<void>;
+    /**
+     * Send a request and wait for reply using native NATS request/reply
+     */
+    request<TRequest = any, TResponse = any>(data: TRequest, timeout?: number): Promise<TResponse>;
+    /**
+     * Setup a request handler for this private channel
+     */
+    onRequest<TRequest = any, TResponse = any>(handler: (data: TRequest) => Promise<TResponse> | TResponse): Promise<() => void>;
+    /**
+     * Close the private channel gracefully
+     */
+    close(): Promise<void>;
+    /**
+     * Check if channel is connected to a specific client
+     */
+    isConnectedTo(clientId: string): boolean;
+    private sendRaw;
+}

package/dist/channel.js

@@ -0,0 +1,347 @@
+import { isPromise } from './utils.js';
+/**
+ * Bidirectional communication channel between RPC clients
+ */
+export class Channel {
+    client;
+    channelId;
+    closed = false;
+    unsubscribe;
+    initialized = false;
+    // Return type is `void` (consumer-void) so handlers that incidentally
+    // return a value type-check. Runtime uses isPromise() on the actual
+    // returned value to detect async handlers and chain them.
+    handlers = new Map();
+    closeHandlers = new Set();
+    errorHandlers = new Set();
+    subscriptions = [];
+    /**
+     * Check if channel is closed
+     */
+    get isClosed() {
+        return this.closed;
+    }
+    /**
+     * Get the channel ID
+     */
+    get id() {
+        return this.channelId;
+    }
+    constructor(client, channelId) {
+        this.client = client;
+        this.channelId = channelId;
+    }
+    /**
+     * Initialize the channel (called by RPCClient)
+     */
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        const subject = `channel.${this.channelId}`;
+        this.unsubscribe = await this.client.subscribe(subject, async (msg) => {
+            switch (msg.type) {
+                case 'message':
+                    this.emit('message', msg.data);
+                    break;
+                case 'close':
+                    this.handleClose();
+                    break;
+                case 'error':
+                    this.handleError(new Error(msg.error ?? 'Channel error'));
+                    break;
+            }
+        });
+    }
+    /**
+     * Send data through the channel
+     */
+    async send(data) {
+        if (this.closed) {
+            throw new Error('Channel is closed');
+        }
+        const msg = {
+            type: 'message',
+            data,
+        };
+        await this.client.publish(`channel.${this.channelId}`, msg);
+    }
+    /**
+     * Send a request and wait for reply
+     */
+    async request(data, timeout = 5000) {
+        if (this.closed) {
+            throw new Error('Channel is closed');
+        }
+        const subject = `channel.${this.channelId}.request`;
+        return this.client.request(subject, data, { timeout });
+    }
+    /**
+     * Setup a request handler for this channel
+     */
+    async onRequest(handler) {
+        const subject = `channel.${this.channelId}.request`;
+        const unsubscribe = this.client.onRequest(subject, handler);
+        this.subscriptions.push(unsubscribe);
+        return unsubscribe;
+    }
+    on(event, handler) {
+        if (event === 'close') {
+            this.closeHandlers.add(handler);
+        }
+        else if (event === 'error') {
+            this.errorHandlers.add(handler);
+        }
+        else {
+            if (!this.handlers.has(event)) {
+                this.handlers.set(event, new Set());
+            }
+            this.handlers.get(event).add(handler);
+        }
+    }
+    off(event, handler) {
+        if (event === 'close') {
+            this.closeHandlers.delete(handler);
+        }
+        else if (event === 'error') {
+            this.errorHandlers.delete(handler);
+        }
+        else {
+            this.handlers.get(event)?.delete(handler);
+        }
+    }
+    /**
+     * Close the channel gracefully
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        // Try to notify other side
+        try {
+            const msg = { type: 'close' };
+            await this.client.publish(`channel.${this.channelId}`, msg);
+        }
+        catch {
+            // Ignore publish errors during close
+        }
+        // Cleanup
+        await this.cleanup();
+    }
+    // Per-channel promise chain. Async handlers for message / close / error
+    // are serialized via this chain so dispatch stays ordered — matches
+    // Python's channel.py:_emit/_handle_close/_handle_error behavior.
+    // Sync handlers stay fire-and-forget (not chained, no overhead).
+    handlerChain = Promise.resolve();
+    runHandler(handler, arg, label) {
+        let result;
+        try {
+            result = handler(arg);
+        }
+        catch (error) {
+            console.error(`Error in ${label}:`, error);
+            return;
+        }
+        if (isPromise(result)) {
+            const pending = result;
+            this.handlerChain = this.handlerChain.then(() => pending).catch((error) => console.error(`Error in ${label}:`, error));
+        }
+    }
+    emit(event, data) {
+        const handlers = this.handlers.get(event);
+        if (!handlers)
+            return;
+        for (const handler of handlers) {
+            this.runHandler(handler, data, 'channel handler');
+        }
+    }
+    handleClose() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const handler of this.closeHandlers) {
+            this.runHandler(() => handler(), undefined, 'close handler');
+        }
+        this.cleanup().catch(console.error);
+    }
+    handleError(error) {
+        for (const handler of this.errorHandlers) {
+            this.runHandler(handler, error, 'error handler');
+        }
+    }
+    async cleanup() {
+        // Clear all handlers
+        this.handlers.clear();
+        this.closeHandlers.clear();
+        this.errorHandlers.clear();
+        // Clear subscriptions
+        await Promise.allSettled(this.subscriptions.map((unsub) => unsub));
+        // Unsubscribe from NATS
+        if (this.unsubscribe) {
+            try {
+                this.unsubscribe();
+            }
+            catch {
+                // Ignore unsubscribe errors
+            }
+            this.unsubscribe = undefined;
+        }
+        // Disconnect isolated client if present
+        const isolatedClient = this._isolatedClient;
+        if (isolatedClient) {
+            try {
+                await isolatedClient.disconnect();
+            }
+            catch {
+                // Ignore disconnect errors
+            }
+        }
+    }
+}
+/**
+ * Private channel for 1:1 communication between two specific clients
+ */
+export class PrivateChannel extends Channel {
+    targetClientId;
+    clientId;
+    remoteClientId;
+    /**
+     * Get the remote client ID (if connected)
+     */
+    get remoteId() {
+        return this.remoteClientId;
+    }
+    constructor(client, channelId, targetClientId) {
+        super(client, channelId);
+        this.targetClientId = targetClientId;
+        // Use the original client name, not the isolated connection name
+        // When using isolated connections, the name includes suffixes like '-channel-secret-chat'
+        // We need to extract the original name to maintain consistent identity
+        const fullName = client.options.name ?? `client-${Date.now()}`;
+        // Extract base name by removing any suffixes added for isolated connections
+        this.clientId = fullName.replace(/-(channel|private)-.*$/, '');
+    }
+    /**
+     * Initialize private channel with handshake
+     */
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        // Use a unique subject that includes channelId and both client IDs for true privacy
+        const sortedIds = [this.clientId, this.targetClientId].sort();
+        const subject = `channel.private.${this.channelId}.${sortedIds.join('.')}`;
+        this.unsubscribe = await this.client.subscribe(subject, async (msg) => {
+            // Filter messages: only process if it's for us
+            if (msg.sender === this.clientId) {
+                // Skip our own messages
+                return;
+            }
+            if (msg.sender !== this.targetClientId) {
+                // Only accept messages from the target client
+                return;
+            }
+            if (!this.remoteClientId && msg.sender) {
+                // First message establishes the connection
+                this.remoteClientId = msg.sender;
+            }
+            if (this.remoteClientId && msg.sender !== this.remoteClientId) {
+                // After connection established, only accept from connected client
+                return;
+            }
+            switch (msg.type) {
+                case 'message':
+                    // Filter out handshake messages
+                    if (msg.data && typeof msg.data === 'object' && '__handshake' in msg.data) {
+                        // Handshake received, connection established
+                        return;
+                    }
+                    this.emit('message', msg.data);
+                    break;
+                case 'close':
+                    this.handleClose();
+                    break;
+                case 'error':
+                    this.handleError(new Error(msg.error ?? 'Channel error'));
+                    break;
+            }
+        });
+        // Send initial handshake
+        try {
+            await this.sendRaw({
+                type: 'message',
+                data: { __handshake: true },
+                sender: this.clientId,
+            });
+        }
+        catch {
+            // Ignore handshake errors - connection might still work
+        }
+    }
+    /**
+     * Send data through the private channel
+     */
+    async send(data) {
+        if (this.closed) {
+            throw new Error('Channel is closed');
+        }
+        await this.sendRaw({
+            type: 'message',
+            data,
+            sender: this.clientId,
+        });
+    }
+    /**
+     * Send a request and wait for reply using native NATS request/reply
+     */
+    async request(data, timeout = 5000) {
+        if (this.closed) {
+            throw new Error('Channel is closed');
+        }
+        const sortedIds = [this.clientId, this.targetClientId].sort();
+        const subject = `channel.private.${this.channelId}.${sortedIds.join('.')}.request`;
+        return this.client.request(subject, data, { timeout });
+    }
+    /**
+     * Setup a request handler for this private channel
+     */
+    async onRequest(handler) {
+        const sortedIds = [this.clientId, this.targetClientId].sort();
+        const subject = `channel.private.${this.channelId}.${sortedIds.join('.')}.request`;
+        return this.client.onRequest(subject, handler);
+    }
+    /**
+     * Close the private channel gracefully
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        // Try to notify remote client, but don't fail if it errors
+        try {
+            await this.sendRaw({
+                type: 'close',
+                sender: this.clientId,
+            });
+        }
+        catch {
+            // Ignore send errors during close
+        }
+        await this.cleanup();
+    }
+    /**
+     * Check if channel is connected to a specific client
+     */
+    isConnectedTo(clientId) {
+        return this.remoteClientId === clientId;
+    }
+    async sendRaw(msg) {
+        // Use the same subject format as in init()
+        const sortedIds = [this.clientId, this.targetClientId].sort();
+        const subject = `channel.private.${this.channelId}.${sortedIds.join('.')}`;
+        await this.client.publish(subject, msg);
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/chunking.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Message types for chunked transfers
+ */
+export interface ChunkMessage {
+    id: string;
+    chunkIndex: number;
+    data: Uint8Array;
+    isLast: boolean;
+}
+/**
+ * Split data into chunks
+ */
+export declare function createChunks(encoded: Uint8Array, chunkId: string, maxChunkSize: number): Generator<ChunkMessage>;
+/**
+ * Reassemble chunks back into original data using a pre-allocated buffer.
+ * Chunks are written directly to the buffer - no intermediate Map storage.
+ */
+export declare class ChunkAssembler {
+    readonly id: string;
+    private buffer;
+    private receivedChunks;
+    private totalChunks;
+    private chunkSize;
+    constructor(id: string, totalSize: number, totalChunks: number, chunkSize?: number);
+    /**
+     * Add a chunk to the assembler.
+     * Writes directly to the pre-allocated buffer.
+     * @returns true if all chunks are received
+     */
+    addChunk(chunk: ChunkMessage): boolean;
+    /**
+     * Check if all chunks have been received
+     */
+    isComplete(): boolean;
+    /**
+     * Get the reassembled data.
+     * Buffer is already complete, just decode - no copy needed.
+     */
+    getData<T = any>(): T;
+    /**
+     * Get progress information
+     */
+    getProgress(): {
+        received: number;
+        total: number;
+        percentage: number;
+    };
+}
+/**
+ * Manager for handling multiple chunk transfers
+ */
+export declare class ChunkingManager {
+    private assemblers;
+    private completedCallbacks;
+    private errorCallbacks;
+    /**
+     * Start receiving chunks for a transfer.
+     * Pre-allocates buffer for direct chunk writing.
+     */
+    startReceiving(id: string, totalChunks: number, onComplete: (data: any) => void, onError: (error: Error) => void, totalSize: number, chunkSize?: number): void;
+    /**
+     * Process an incoming chunk
+     */
+    processChunk(chunk: ChunkMessage): void;
+    /**
+     * Cancel a transfer
+     */
+    cancel(id: string): void;
+    /**
+     * Get progress for a transfer
+     */
+    getProgress(id: string): {
+        received: number;
+        total: number;
+        percentage: number;
+    } | null;
+}