@camera.ui/rpc 1.0.1

package/dist/handler.js

@@ -0,0 +1,399 @@
+import { createError, RPCException } from './errors.js';
+import { ERROR_CODES } from './types.js';
+import { sleep } from './utils.js';
+/**
+ * Handle streaming request - common logic for client and service
+ */
+export async function handleStreamRequest(handler, args, streamSubject, requestId, client) {
+    let generator;
+    // Check if handler is async or sync
+    const handlerResult = handler(...args);
+    // Check if the handler returned a Promise (async function)
+    if (handlerResult && typeof handlerResult.then === 'function') {
+        // Await the async result
+        const result = await handlerResult;
+        // Check if result is async generator
+        if (result && typeof result[Symbol.asyncIterator] === 'function') {
+            generator = result;
+        }
+        else if (result && typeof result[Symbol.iterator] === 'function') {
+            // Sync generator/iterator - convert to async
+            generator = (async function* () {
+                for (const value of result) {
+                    yield value;
+                }
+            })();
+        }
+        else {
+            throw createError(ERROR_CODES.INTERNAL_ERROR, 'Handler must return a generator for stream');
+        }
+    }
+    else if (handlerResult && typeof handlerResult[Symbol.asyncIterator] === 'function') {
+        // Direct async generator
+        generator = handlerResult;
+    }
+    else if (handlerResult && typeof handlerResult[Symbol.iterator] === 'function') {
+        // Direct sync generator/iterator - convert to async
+        generator = (async function* () {
+            for (const value of handlerResult) {
+                yield value;
+            }
+        })();
+    }
+    else {
+        throw createError(ERROR_CODES.INTERNAL_ERROR, 'Handler must return a generator for stream');
+    }
+    // Listen for cancellation
+    let cancelled = false;
+    const cancelUnsub = await client.subscribe(`${streamSubject}.cancel`, () => {
+        cancelled = true;
+    });
+    // Give client time to set up subscription
+    await sleep(0);
+    // Stream values
+    try {
+        for await (const value of generator) {
+            if (cancelled || !client.isConnected)
+                break;
+            const streamMsg = {
+                id: requestId,
+                type: 'data',
+                data: value,
+            };
+            await client.publish(streamSubject, streamMsg);
+        }
+        if (!cancelled && client.isConnected) {
+            const endMsg = {
+                id: requestId,
+                type: 'end',
+            };
+            await client.publish(streamSubject, endMsg);
+        }
+    }
+    catch (error) {
+        if (!cancelled && client.isConnected) {
+            try {
+                const errorMsg = {
+                    id: requestId,
+                    type: 'error',
+                    error: formatErrorObject(error),
+                };
+                await client.publish(streamSubject, errorMsg);
+            }
+            catch {
+                // Ignore publish errors during disconnect
+            }
+        }
+    }
+    finally {
+        cancelUnsub();
+        // Ensure generator is closed
+        if (generator.return) {
+            try {
+                await generator.return();
+            }
+            catch {
+                // Ignore errors when closing generator
+            }
+        }
+    }
+}
+/**
+ * Handle normal RPC call - common logic for client and service
+ */
+export async function handleNormalRPC(handler, params) {
+    // Ensure params is an array
+    const args = Array.isArray(params) ? params : params != null ? [params] : [];
+    // Call the handler
+    return handler(...args);
+}
+/**
+ * Format exception as error object
+ */
+export function formatErrorObject(error) {
+    if (error instanceof RPCException) {
+        return error.toJSON();
+    }
+    else {
+        return {
+            code: ERROR_CODES.INTERNAL_ERROR,
+            message: error instanceof Error ? error.message : 'Internal error',
+        };
+    }
+}
+/**
+ * Handle pull-based iterator request
+ */
+export async function handlePullIteratorRequest(handler, args, iteratorId, client) {
+    let generator;
+    // Check if handler is async or sync
+    const handlerResult = handler(...args);
+    // Check if the handler returned a Promise (async function)
+    if (handlerResult && typeof handlerResult.then === 'function') {
+        // Await the async result
+        const result = await handlerResult;
+        // Check if result is async generator
+        if (result && typeof result[Symbol.asyncIterator] === 'function') {
+            generator = result;
+        }
+        else if (result && typeof result[Symbol.iterator] === 'function') {
+            // Sync generator/iterator - convert to async
+            generator = (async function* () {
+                for (const value of result) {
+                    yield value;
+                }
+            })();
+        }
+        else {
+            throw createError(ERROR_CODES.INTERNAL_ERROR, 'Handler must return a generator for pull iterator');
+        }
+    }
+    else if (handlerResult && typeof handlerResult[Symbol.asyncIterator] === 'function') {
+        // Direct async generator
+        generator = handlerResult;
+    }
+    else if (handlerResult && typeof handlerResult[Symbol.iterator] === 'function') {
+        // Direct sync generator/iterator - convert to async
+        generator = (async function* () {
+            for (const value of handlerResult) {
+                yield value;
+            }
+        })();
+    }
+    else {
+        throw createError(ERROR_CODES.INTERNAL_ERROR, 'Handler must return a generator for pull iterator');
+    }
+    // Set up request/response subjects
+    const requestSubject = `_rpc.iterator.${iteratorId}.request`;
+    const responseSubject = `_rpc.iterator.${iteratorId}.response`;
+    // Track if iterator is active
+    let active = true;
+    // Subscribe to iterator requests
+    const unsub = await client.subscribe(requestSubject, async (msg) => {
+        if (!active)
+            return;
+        try {
+            if (msg.type === 'cancel') {
+                active = false;
+                // Close the generator explicitly
+                if (generator.return) {
+                    await generator.return();
+                }
+                const response = {
+                    id: iteratorId,
+                    type: 'done',
+                };
+                await client.publish(responseSubject, response);
+            }
+            else if (msg.type === 'next') {
+                const { value, done } = await generator.next();
+                if (done) {
+                    active = false;
+                    const response = {
+                        id: iteratorId,
+                        type: 'done',
+                    };
+                    await client.publish(responseSubject, response);
+                }
+                else {
+                    const response = {
+                        id: iteratorId,
+                        type: 'value',
+                        value,
+                    };
+                    await client.publish(responseSubject, response);
+                }
+            }
+        }
+        catch (error) {
+            active = false;
+            const response = {
+                id: iteratorId,
+                type: 'error',
+                error: formatErrorObject(error),
+            };
+            await client.publish(responseSubject, response);
+        }
+    });
+    // Return cleanup function
+    const cleanup = async () => {
+        active = false;
+        unsub();
+        // Ensure generator is closed
+        if (generator.return) {
+            try {
+                await generator.return();
+            }
+            catch {
+                // Ignore errors when closing generator
+            }
+        }
+    };
+    return cleanup;
+}
+/**
+ * Handle a pull-iterator-with-callbacks request.
+ *
+ * Builds a callback proxy whose methods publish oneway to `callbackSubject`,
+ * invokes the user handler with (...args, callbackProxy), then drives the
+ * returned async generator from iterator `next`/`cancel` requests.
+ *
+ * The iterator yields `undefined` — its sole purpose is client-driven flow
+ * control. Meaningful data travels over the callback channel.
+ */
+export async function handlePullCallbackRequest(handler, args, iteratorId, callbackSubject, callbackMethods, onewayMethods, client) {
+    // Build callback proxy. Each method publishes a CallbackInvocation oneway.
+    // Methods not in onewayMethods reject with NotImplemented (request-reply is v2).
+    const onewaySet = new Set(onewayMethods);
+    const callbackProxy = {};
+    let proxyActive = true;
+    for (const method of callbackMethods) {
+        const isOneway = onewaySet.has(method);
+        if (isOneway) {
+            callbackProxy[method] = (...a) => {
+                if (!proxyActive || !client.isConnected)
+                    return;
+                const msg = { method, args: a };
+                client.publish(callbackSubject, msg).catch(() => {
+                    // Swallow publish errors (disconnect mid-flight, client already gone).
+                });
+            };
+        }
+        else {
+            callbackProxy[method] = () => {
+                throw createError(ERROR_CODES.INTERNAL_ERROR, `Request-reply callback '${method}' not supported in v1`);
+            };
+        }
+    }
+    // Invoke the handler with callback proxy appended as last argument.
+    let generator;
+    const handlerResult = handler(...args, callbackProxy);
+    const coerceToAsyncGenerator = (r) => {
+        if (r && typeof r[Symbol.asyncIterator] === 'function')
+            return r;
+        if (r && typeof r[Symbol.iterator] === 'function') {
+            return (async function* () {
+                for (const value of r)
+                    yield value;
+            })();
+        }
+        throw createError(ERROR_CODES.INTERNAL_ERROR, 'Handler must return a generator for pull-callback iterator');
+    };
+    if (handlerResult && typeof handlerResult.then === 'function') {
+        generator = coerceToAsyncGenerator(await handlerResult);
+    }
+    else {
+        generator = coerceToAsyncGenerator(handlerResult);
+    }
+    // Iterator request/response subjects (shared with plain pull iterator).
+    const requestSubject = `_rpc.iterator.${iteratorId}.request`;
+    const responseSubject = `_rpc.iterator.${iteratorId}.response`;
+    let active = true;
+    const unsub = await client.subscribe(requestSubject, async (msg) => {
+        if (!active)
+            return;
+        try {
+            if (msg.type === 'cancel') {
+                active = false;
+                proxyActive = false;
+                if (generator.return) {
+                    await generator.return();
+                }
+                const response = { id: iteratorId, type: 'done' };
+                await client.publish(responseSubject, response);
+            }
+            else if (msg.type === 'next') {
+                const { done } = await generator.next();
+                if (done) {
+                    active = false;
+                    proxyActive = false;
+                    const response = { id: iteratorId, type: 'done' };
+                    await client.publish(responseSubject, response);
+                }
+                else {
+                    // Batch boundary reached. Value is ignored by the protocol.
+                    const response = { id: iteratorId, type: 'value' };
+                    await client.publish(responseSubject, response);
+                }
+            }
+        }
+        catch (error) {
+            active = false;
+            proxyActive = false;
+            const response = {
+                id: iteratorId,
+                type: 'error',
+                error: formatErrorObject(error),
+            };
+            await client.publish(responseSubject, response);
+        }
+    });
+    const cleanup = async () => {
+        active = false;
+        proxyActive = false;
+        unsub();
+        if (generator.return) {
+            try {
+                await generator.return();
+            }
+            catch {
+                // Ignore errors when closing generator
+            }
+        }
+    };
+    return cleanup;
+}
+/**
+ * Handle callback subscription request.
+ * Creates a wrapper function, calls the handler with it,
+ * and manages the subscription lifecycle.
+ */
+export async function handleCallbackRequest(handler, args, callbackSubject, requestId, client) {
+    // Create wrapper callback that publishes to callbackSubject
+    const wrapperCallback = async (value) => {
+        if (!client.isConnected)
+            return;
+        const msg = {
+            id: requestId,
+            type: 'data',
+            data: value,
+        };
+        await client.publish(callbackSubject, msg);
+    };
+    // Call handler with args + wrapper callback
+    let handlerCleanup;
+    try {
+        const result = handler(...args, wrapperCallback);
+        // Handler may return cleanup sync or async
+        if (result && typeof result.then === 'function') {
+            handlerCleanup = await result;
+        }
+        else if (typeof result === 'function') {
+            handlerCleanup = result;
+        }
+    }
+    catch (error) {
+        // Send error to subscriber
+        const errorMsg = {
+            id: requestId,
+            type: 'error',
+            error: formatErrorObject(error),
+        };
+        await client.publish(callbackSubject, errorMsg);
+        throw error;
+    }
+    // Subscribe to cancel subject
+    const cancelUnsub = await client.subscribe(`${callbackSubject}.cancel`, async () => {
+        if (handlerCleanup) {
+            await handlerCleanup();
+        }
+    });
+    // Return combined cleanup
+    return async () => {
+        cancelUnsub();
+        if (handlerCleanup) {
+            await handlerCleanup();
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createRPCClient } from './client.js';
+export { Channel, PrivateChannel } from './channel.js';
+export { isNoRespondersError, isRPCError, RPCException } from './errors.js';
+export { ERROR_CODES } from './types.js';
+export { RPCService, Service } from './service.js';
+export { RPCClass, RPCMethod, RPCNested, RPCProperty } from './decorators.js';
+export { rpcCallbacks } from './utils.js';
+export type { CallbackInvocation, CallbackMessage, CallbackParams, ErrorCode, PullCallbackParams, RPCAuthOptions, RPCClient, RPCClientOptions, RPCError, } from './types.js';
+export type { Promisify } from './types.js';
+export type { ServiceConfig, ServiceInfo, ServiceStats } from '@nats-io/services';
+export type * from '@nats-io/nats-core';

package/dist/index.js

@@ -0,0 +1,14 @@
+// Main client
+export { createRPCClient } from './client.js';
+// Channel/PrivateChannel for bidirectional communication
+export { Channel, PrivateChannel } from './channel.js';
+// Error handling
+export { isNoRespondersError, isRPCError, RPCException } from './errors.js';
+export { ERROR_CODES } from './types.js';
+// Service support
+export { RPCService, Service } from './service.js';
+// Decorators
+export { RPCClass, RPCMethod, RPCNested, RPCProperty } from './decorators.js';
+// Pull-iterator-with-callbacks helper
+export { rpcCallbacks } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,yDAAyD;AACzD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvD,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEnD,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9E,sCAAsC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,60 @@
+import type { Service as NATSService, ServiceClient, ServiceConfig, ServiceInfo, ServiceStats } from '@nats-io/services';
+import type { NatsConnection } from '@nats-io/transport-node';
+import type { RPCClient } from './client.js';
+/**
+ * RPC Service wrapper with automatic encoding/decoding and streaming support
+ */
+export declare class RPCService {
+    private client;
+    private svc?;
+    private services;
+    private initialized;
+    constructor(client: RPCClient);
+    /**
+     * Initialize the service manager
+     */
+    init(nc: NatsConnection): void;
+    /**
+     * Add a service with automatic RPC endpoint wrapping
+     * Supports objects, classes, nested structures, streaming, and chunking
+     */
+    registerHandler(config: ServiceConfig, handlers: object, options?: {
+        isolatedConnection?: boolean;
+    }): Promise<Service>;
+    /**
+     * Get service monitoring client
+     */
+    monitor(): ServiceClient;
+    /**
+     * Stop all services and cleanup isolated connections
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Stop a specific service by name
+     */
+    stop(serviceName: string): Promise<void>;
+    /**
+     * Get all services info
+     */
+    getAllInfo(): ServiceInfo[];
+    /**
+     * Get info for a specific service
+     */
+    getInfo(serviceName: string): ServiceInfo | undefined;
+    /**
+     * Get all services stats
+     */
+    getAllStats(): Promise<ServiceStats[]>;
+    /**
+     * Get stats for a specific service
+     */
+    getStats(serviceName: string): Promise<ServiceStats | undefined>;
+}
+export declare class Service {
+    private natsService;
+    get isStopped(): boolean;
+    constructor(natsService: NATSService);
+    info(): ServiceInfo;
+    stats(): Promise<ServiceStats>;
+    stop(err?: Error): Promise<void>;
+}