@camera.ui/rpc 1.0.1

package/dist/service.js

@@ -0,0 +1,286 @@
+import { Svcm } from '@nats-io/services';
+import { decode } from './codec.js';
+import { extractNestedMethodsWithDecorators } from './decorators.js';
+import { formatErrorObject, handleNormalRPC, handlePullIteratorRequest, handleStreamRequest } from './handler.js';
+/**
+ * RPC Service wrapper with automatic encoding/decoding and streaming support
+ */
+export class RPCService {
+    client;
+    svc;
+    services = [];
+    initialized = false;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Initialize the service manager
+     */
+    init(nc) {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        this.svc = new Svcm(nc);
+        this.services = [];
+    }
+    /**
+     * Add a service with automatic RPC endpoint wrapping
+     * Supports objects, classes, nested structures, streaming, and chunking
+     */
+    async registerHandler(config, handlers, options) {
+        if (!this.svc) {
+            throw new Error('RPCService is not initialized. Call init() first.');
+        }
+        // Track pull iterator cleanups for this service
+        const pullIteratorCleanups = new Map();
+        // Use isolated connection if requested
+        let serviceClient = this.client;
+        let svc = this.svc;
+        if (options?.isolatedConnection) {
+            // Create isolated connection for this service
+            serviceClient = this.client.createIsolatedClient({
+                ...this.client.options,
+                name: `${this.client.options.name}-service-${config.name}`,
+            });
+            // Initialize isolated client
+            const nc = await serviceClient.connect();
+            // Create service manager for isolated connection
+            svc = new Svcm(nc);
+        }
+        const service = await svc.add(config);
+        this.services.push(service);
+        // Store reference to isolated connection if used
+        if (options?.isolatedConnection) {
+            service._isolatedClient = serviceClient;
+        }
+        // Extract all methods including nested ones
+        const methods = extractNestedMethodsWithDecorators(handlers);
+        // Create groups for nested paths
+        const groups = new Map();
+        for (const [path, handler] of Object.entries(methods)) {
+            const parts = path.split('.');
+            const methodName = parts.pop();
+            let target = service;
+            // Create nested groups if needed
+            if (parts.length > 0) {
+                const groupPath = parts.join('.');
+                if (!groups.has(groupPath)) {
+                    let current = service;
+                    for (const part of parts) {
+                        current = current.addGroup(part);
+                    }
+                    groups.set(groupPath, current);
+                }
+                target = groups.get(groupPath);
+            }
+            // Add endpoint with auto-encoding/decoding
+            target.addEndpoint(methodName, async (err, msg) => {
+                if (err) {
+                    msg.respondError(500, err.message);
+                    return;
+                }
+                try {
+                    const chunkType = msg.headers?.get('x-chunked-transfer');
+                    if (chunkType === 'header') {
+                        // Chunked transfer header
+                        const data = decode(msg.data);
+                        const chunkId = msg.headers?.get('x-chunk-id');
+                        if (!chunkId || data.transferId !== chunkId) {
+                            console.error('Invalid chunk header');
+                            return;
+                        }
+                        // Setup chunk assembly with pre-allocated buffer (optimized)
+                        serviceClient.chunkingManager.startReceiving(data.transferId, data.totalChunks, async (assembledData) => {
+                            // Process the assembled RPC message
+                            await processRPCMessage(assembledData, msg);
+                        }, (error) => {
+                            console.error(`Error assembling chunks for ${methodName}:`, error);
+                        }, data.totalSize, // Pass totalSize for pre-allocated buffer optimization
+                        data.chunkSize);
+                    }
+                    else if (chunkType === 'chunk') {
+                        // Chunk data
+                        const chunkId = msg.headers?.get('x-chunk-id');
+                        const chunkIndex = parseInt(msg.headers?.get('x-chunk-index') ?? '0');
+                        if (!chunkId) {
+                            console.error('Chunk missing chunk ID');
+                            return;
+                        }
+                        // Process raw chunk data
+                        serviceClient.chunkingManager.processChunk({
+                            id: chunkId,
+                            chunkIndex,
+                            data: msg.data,
+                            isLast: false, // Determined by total chunks from header
+                        });
+                    }
+                    else {
+                        // Regular message - decode MessagePack data
+                        const rpcMsg = decode(msg.data);
+                        await processRPCMessage(rpcMsg, msg);
+                    }
+                }
+                catch (error) {
+                    console.error(`Error processing message for ${methodName}:`, error);
+                }
+                // Define the RPC message processor function
+                async function processRPCMessage(rpcMsg, originalMsg) {
+                    const response = { id: rpcMsg.id };
+                    try {
+                        // Handle stream request
+                        if (rpcMsg.params?.__stream && rpcMsg.params?.__streamSubject) {
+                            const streamSubject = rpcMsg.params.__streamSubject;
+                            const args = rpcMsg.params.args ?? [];
+                            await handleStreamRequest(handler, args, streamSubject, rpcMsg.id, serviceClient);
+                        }
+                        else if (
+                        // Check if it's a pull iterator request
+                        // Could be direct object or wrapped in array from call()
+                        rpcMsg.params?.__pullIterator ||
+                            (Array.isArray(rpcMsg.params) && rpcMsg.params[0]?.__pullIterator)) {
+                            // Extract pull iterator params
+                            const pullParams = rpcMsg.params?.__pullIterator ? rpcMsg.params : rpcMsg.params[0];
+                            const args = pullParams.args ?? [];
+                            const iteratorId = pullParams.__iteratorId ?? rpcMsg.id;
+                            const cleanup = await handlePullIteratorRequest(handler, args, iteratorId, serviceClient);
+                            // Store cleanup function for later
+                            pullIteratorCleanups.set(iteratorId, cleanup);
+                            response.result = { iteratorId };
+                            // Send response with iterator ID
+                            const replySubject = `${originalMsg.subject}.reply.${rpcMsg.id}`;
+                            await serviceClient.publish(replySubject, response);
+                        }
+                        else {
+                            // Normal RPC call
+                            const result = await handleNormalRPC(handler, rpcMsg.params);
+                            response.result = result;
+                            // Send response
+                            const replySubject = `${originalMsg.subject}.reply.${rpcMsg.id}`;
+                            await serviceClient.publish(replySubject, response);
+                        }
+                    }
+                    catch (error) {
+                        response.error = formatErrorObject(error);
+                        try {
+                            const replySubject = `${originalMsg.subject}.reply.${rpcMsg.id}`;
+                            await serviceClient.publish(replySubject, response);
+                        }
+                        catch (publishError) {
+                            if (serviceClient.isClosed) {
+                                return; // Ignore if client is closed
+                            }
+                            console.error('Failed to send error response:', publishError);
+                        }
+                    }
+                }
+            });
+        }
+        // Extend service with cleanup management
+        const extendedService = service;
+        extendedService._pullIteratorCleanups = pullIteratorCleanups;
+        // Override stop method to clean up pull iterators
+        const originalStop = service.stop.bind(service);
+        service.stop = async (err) => {
+            // Clean up all pull iterators
+            await Promise.allSettled(Array.from(pullIteratorCleanups.values()).map((cleanup) => cleanup()));
+            pullIteratorCleanups.clear();
+            // Call original stop
+            return originalStop(err);
+        };
+        return new Service(service);
+    }
+    /**
+     * Get service monitoring client
+     */
+    monitor() {
+        if (!this.svc) {
+            throw new Error('RPCService is not initialized. Call init() first.');
+        }
+        return this.svc.client({ strategy: 'stall', stall: 10, maxWait: 2000 });
+    }
+    /**
+     * Stop all services and cleanup isolated connections
+     */
+    async stopAll() {
+        await Promise.allSettled(this.services.map(async (s) => {
+            await s.stop();
+            // Disconnect isolated connection if present
+            const isolatedClient = s._isolatedClient;
+            if (isolatedClient) {
+                await isolatedClient.disconnect();
+            }
+        }));
+        this.services = [];
+    }
+    /**
+     * Stop a specific service by name
+     */
+    async stop(serviceName) {
+        const service = this.services.find((s) => s.info().name === serviceName);
+        if (service) {
+            try {
+                await service.stop();
+                // Disconnect isolated connection if present
+                const isolatedClient = service._isolatedClient;
+                if (isolatedClient) {
+                    await isolatedClient.disconnect();
+                }
+                this.services = this.services.filter((s) => s !== service);
+            }
+            catch {
+                // Ignore errors during stop
+            }
+        }
+    }
+    /**
+     * Get all services info
+     */
+    getAllInfo() {
+        return this.services.map((s) => s.info());
+    }
+    /**
+     * Get info for a specific service
+     */
+    getInfo(serviceName) {
+        const service = this.services.find((s) => s.info().name === serviceName);
+        return service?.info();
+    }
+    /**
+     * Get all services stats
+     */
+    async getAllStats() {
+        return Promise.all(this.services.map((s) => s.stats()));
+    }
+    /**
+     * Get stats for a specific service
+     */
+    async getStats(serviceName) {
+        const service = this.services.find((s) => s.info().name === serviceName);
+        return service?.stats();
+    }
+}
+export class Service {
+    natsService;
+    get isStopped() {
+        return this.natsService.isStopped;
+    }
+    constructor(natsService) {
+        this.natsService = natsService;
+    }
+    info() {
+        return this.natsService.info();
+    }
+    stats() {
+        return this.natsService.stats();
+    }
+    async stop(err) {
+        try {
+            await this.natsService.stop(err);
+        }
+        catch {
+            // Ignore errors during stop
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,300 @@
+import type { NatsConnection, Status } from '@nats-io/nats-core';
+import type { Channel, PrivateChannel } from './channel.js';
+import type { RPCService } from './service.js';
+export interface RPCClient {
+    readonly service: RPCService;
+    readonly isConnected: boolean;
+    readonly isClosed: boolean;
+    readonly maxPayloadSize: number;
+    connect(options?: {
+        signal?: AbortSignal;
+    }): Promise<NatsConnection>;
+    disconnect(): Promise<void>;
+    suspend(): Promise<void>;
+    reconfigure(overrides: {
+        servers?: string[];
+        auth?: RPCAuthOptions;
+    }): void;
+    setServers(servers: string[]): void;
+    forceReconnect(): Promise<void>;
+    abortClose(err?: Error): void;
+    status(): AsyncIterable<Status> | undefined;
+    flush(timeoutMs?: number): Promise<void>;
+    publish<TMessage = any>(subject: string, data: TMessage): Promise<void>;
+    subscribe<TResponse = any>(pattern: string, handler: (data: TResponse) => void | Promise<void>, options?: {
+        queue?: string;
+    }): Promise<() => void>;
+    request<TRequest = any, TResponse = any>(subject: string, data: TRequest, options?: {
+        timeout?: number;
+        noResponderRetry?: {
+            maxRetries?: number;
+            delays?: number[];
+        };
+    }): Promise<TResponse>;
+    onRequest<TRequest = any, TResponse = any>(pattern: string, handler: (data: TRequest) => Promise<TResponse> | TResponse): Promise<() => void>;
+    registerHandler(namespace: string, handlers: object, options?: {
+        isolatedConnection?: boolean;
+        withoutDecorators?: boolean;
+        queue?: string;
+    }): Promise<() => Promise<void>>;
+    callWithCallback<TResponse = any>(subject: string, args: any[], callback: (value: TResponse) => void | Promise<void>): Promise<() => void>;
+    callPullIteratorWithCallback(subject: string, callbacks: Record<string, (...a: any[]) => any>, onewayMethods: string[], ...args: any[]): AsyncGenerator<void>;
+    channel(channelId: string, options?: {
+        isolatedConnection?: boolean;
+    }): Promise<Channel>;
+    privateChannel(channelId: string, targetClientId: string, options?: {
+        isolatedConnection?: boolean;
+    }): Promise<PrivateChannel>;
+    createProxy<T extends object>(namespace: string): Promisify<T>;
+    createProxy<T extends object>(namespace: string, options: {
+        isolatedConnection: false;
+    }): Promisify<T>;
+    createProxy<T extends object>(namespace: string, options: {
+        isolatedConnection: true;
+    }): {
+        proxy: Promisify<T>;
+        close: () => Promise<void>;
+    };
+    createServiceProxy<T extends object>(serviceName: string): Promise<Promisify<T>>;
+    createServiceProxy<T extends object>(serviceName: string, options: {
+        preferredId?: string;
+        timeout?: number;
+        isolatedConnection?: false;
+    }): Promise<Promisify<T>>;
+    createServiceProxy<T extends object>(serviceName: string, options: {
+        preferredId?: string;
+        timeout?: number;
+        isolatedConnection?: true;
+    }): Promise<{
+        proxy: Promisify<T>;
+        close: () => Promise<void>;
+    }>;
+}
+export interface RPCAuthOptions {
+    /** Username for authentication */
+    user: string;
+    /** Password for authentication */
+    password: string;
+}
+/**
+ * Configuration options for RPC client
+ */
+export interface RPCClientOptions {
+    /** NATS server URLs */
+    servers: string[];
+    /** Client name for identification */
+    name: string;
+    /** Authentication credentials */
+    auth?: RPCAuthOptions;
+    /** Default RPC call timeout in milliseconds */
+    timeout?: number;
+    /** Enable automatic reconnection */
+    reconnect?: boolean;
+    /** Max number of pings the client will allow unanswered before raising a stale connection error */
+    maxPingOut?: number;
+    /** Number of milliseconds between client-sent pings */
+    pingInterval?: number;
+    /** Number of milliseconds to wait for a ping response before considering the connection stale and initiating a reconnect */
+    pingTimeout?: number;
+    /** Maximum reconnection attempts (-1 for infinite) */
+    maxReconnectAttempts?: number;
+    /** Delay between reconnection attempts in milliseconds */
+    reconnectTimeWait?: number;
+    /** Maximum delay between reconnection attempts in milliseconds (default: 0 - disabled — legacy linear delay) */
+    reconnectionDelayMax?: number;
+    /** Randomization factor for reconnection delay (default: 0 - no multiplicative jitter) */
+    reconnectionRandomizationFactor?: number;
+    /** Random jitter in ms added to `reconnectTimeWait` */
+    reconnectJitter?: number;
+    /** Random jitter in ms added to `reconnectTimeWait` for TLS connections */
+    reconnectJitterTLS?: number;
+    /** Don't abort the connection after two consecutive auth errors. Important
+     *  for clients with token rotation: a brief window where the proxy still
+     *  sees the previous token would otherwise kill reconnection permanently
+     *  and require a full page reload */
+    ignoreAuthErrorAbort?: boolean;
+    /** Print NATS protocol traffic to the console. Development only. */
+    debug?: boolean;
+    /** TLS configuration */
+    tls?: {
+        cert: string;
+        key: string;
+        ca: string;
+    };
+    /** Maximum payload size in bytes (default: auto-detect from NATS server) */
+    maxPayloadSize?: number;
+    /** Block connect() until the first connection succeeds (default: true).
+     *  Set to false for browser clients where disconnect() must be able to
+     *  abort an in-flight connection attempt immediately. */
+    waitOnFirstConnect?: boolean;
+    /** Maximum time in ms to wait for the NATS connection to fully close
+     *  during disconnect(). Relevant when waitOnFirstConnect is false, as the
+     *  underlying transport may still be mid-handshake when close() is called.
+     *  Default: 2000 */
+    disconnectTimeout?: number;
+    /** Retry configuration for 503 / no-responder errors. */
+    noResponderRetry?: {
+        /** Maximum number of retries (default: 3) */
+        maxRetries?: number;
+        /** Delay in ms before each retry attempt (default: [500, 1000, 2000]) */
+        delays?: number[];
+    };
+}
+/**
+ * RPC request message format
+ */
+export interface RPCMessage<T = any> {
+    /** Unique request ID */
+    id: string;
+    /** Method name to call */
+    method: string;
+    /** Method parameters */
+    params: T;
+    /** Optional error (unused in requests) */
+    error?: RPCError;
+}
+/**
+ * RPC response message format
+ */
+export interface RPCResponse<T = any> {
+    /** Request ID this response belongs to */
+    id: string;
+    /** Result data (if successful) */
+    result?: T;
+    /** Error information (if failed) */
+    error?: RPCError;
+    /** Available methods on namespace (internal metadata for proxy) */
+    __methods?: string[];
+}
+/**
+ * RPC error format
+ */
+export interface RPCError {
+    /** Error code (see ERROR_CODES) */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error data */
+    data?: any;
+}
+/**
+ * Convert service interface to async client interface
+ * - Regular methods become Promise-returning
+ * - AsyncGenerator methods stay as AsyncGenerators
+ * - Generator methods become AsyncGenerators
+ * - Promise<Generator> becomes AsyncGenerator
+ * - Promise<AsyncGenerator> becomes AsyncGenerator
+ * - Generic methods preserve their generic parameters
+ */
+type PromisifyMethod<T> = T extends (...args: infer Args) => infer R ? R extends AsyncGenerator<infer Y, any, any> ? (...args: Args) => AsyncGenerator<Y, any, any> : R extends Generator<infer Y, any, any> ? (...args: Args) => AsyncGenerator<Y, any, any> : R extends Promise<infer U> ? U extends AsyncGenerator<infer Y, any, any> ? (...args: Args) => AsyncGenerator<Y, any, any> : U extends Generator<infer Y, any, any> ? (...args: Args) => AsyncGenerator<Y, any, any> : T : (...args: Args) => Promise<R> : T;
+export type Promisify<T> = {
+    [K in keyof T]: T[K] extends ((...args: any[]) => any) | undefined ? T[K] extends undefined ? undefined : PromisifyMethod<Exclude<T[K], undefined>> | (T[K] extends undefined ? undefined : never) : T[K] extends (...args: any[]) => any ? PromisifyMethod<T[K]> : T[K];
+};
+/**
+ * Message format for streaming data
+ */
+export interface StreamMessage<T = any> {
+    /** Stream ID (same as request ID) */
+    id: string;
+    /** Message type */
+    type: 'data' | 'end' | 'error';
+    /** Data payload (for 'data' type) */
+    data?: T;
+    /** Error information (for 'error' type) */
+    error?: RPCError;
+}
+/**
+ * Pull iterator request message
+ */
+export interface PullIteratorRequest {
+    /** Iterator ID */
+    id: string;
+    /** Request type */
+    type: 'next' | 'cancel';
+}
+/**
+ * Pull iterator response message
+ */
+export interface PullIteratorResponse<T = any> {
+    /** Iterator ID */
+    id: string;
+    /** Response type */
+    type: 'value' | 'done' | 'error';
+    /** Value (for 'value' type) */
+    value?: T;
+    /** Error (for 'error' type) */
+    error?: RPCError;
+}
+/**
+ * Parameters for callback subscription request
+ */
+export interface CallbackParams {
+    __callback: true;
+    __callbackSubject: string;
+    args: any[];
+}
+/**
+ * Message format for callback data pushed to subscribers
+ */
+export interface CallbackMessage<T = any> {
+    id: string;
+    type: 'data' | 'error';
+    data?: T;
+    error?: RPCError;
+}
+/**
+ * Parameters for pull-iterator-with-callbacks request.
+ * Combines pull-iterator flow control with oneway callbacks for frame-level delivery.
+ */
+export interface PullCallbackParams {
+    __pullCallback: true;
+    __iteratorId: string;
+    __callbackSubject: string;
+    __callbackMethods: string[];
+    __onewayMethods: string[];
+    args: any[];
+}
+/**
+ * A single callback invocation pushed from server to client on the callback subject.
+ * Oneway: no reply expected.
+ */
+export interface CallbackInvocation {
+    method: string;
+    args: any[];
+}
+/**
+ * Standard error codes
+ */
+export declare const ERROR_CODES: {
+    readonly METHOD_NOT_FOUND: "METHOD_NOT_FOUND";
+    readonly INVALID_PARAMS: "INVALID_PARAMS";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly CONNECTION_CLOSED: "CONNECTION_CLOSED";
+    readonly STREAM_ERROR: "STREAM_ERROR";
+    readonly PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE";
+    readonly NOT_FOUND: "NOT_FOUND";
+};
+/**
+ * Error code type
+ */
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * Chunked transfer header
+ */
+export interface ChunkedTransferHeader {
+    type: 'chunked';
+    transferId: string;
+    totalChunks: number;
+    totalSize: number;
+    chunkSize: number;
+}
+/**
+ * Individual chunk message
+ */
+export interface ChunkData {
+    transferId: string;
+    index: number;
+    data: Uint8Array;
+}
+export {};

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Standard error codes
+ */
+export const ERROR_CODES = {
+    METHOD_NOT_FOUND: 'METHOD_NOT_FOUND',
+    INVALID_PARAMS: 'INVALID_PARAMS',
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    TIMEOUT: 'TIMEOUT',
+    CONNECTION_CLOSED: 'CONNECTION_CLOSED',
+    STREAM_ERROR: 'STREAM_ERROR',
+    PAYLOAD_TOO_LARGE: 'PAYLOAD_TOO_LARGE',
+    NOT_FOUND: 'NOT_FOUND',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwTA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,mBAAmB;IACtC,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,WAAW;CACd,CAAC"}