raffel 0.1.2

package/dist/core/router.js

@@ -0,0 +1,308 @@
+/**
+ * Router - Envelope Dispatch
+ *
+ * Routes incoming envelopes to the correct handler, executing
+ * interceptors in an onion model.
+ */
+import { createResponseEnvelope, createErrorEnvelope } from '../types/envelope.js';
+import { createEventDeliveryEngine, } from './event-delivery.js';
+import { getStatusForCode } from '../errors/codes.js';
+import { sid as generateId } from '../utils/id/index.js';
+/**
+ * Raffel error - thrown by handlers to signal known errors
+ *
+ * Contains both a string code (e.g., 'NOT_FOUND') and a numeric status (e.g., 404)
+ * for interoperability across protocols.
+ */
+export class RaffelError extends Error {
+    code;
+    details;
+    /**
+     * Numeric status code (HTTP-compatible)
+     *
+     * - 400-499: Client errors
+     * - 500-599: Server errors
+     */
+    status;
+    constructor(
+    /** String error code (e.g., 'NOT_FOUND', 'VALIDATION_ERROR') */
+    code, message, details, 
+    /** Optional explicit status override */
+    status) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'RaffelError';
+        this.status = status ?? getStatusForCode(code);
+    }
+    /**
+     * Convert to plain object for serialization
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            status: this.status,
+            message: this.message,
+            ...(this.details !== undefined && { details: this.details }),
+        };
+    }
+}
+/**
+ * Build full interceptor chain with envelope and context
+ */
+function buildChain(envelope, ctx, interceptors, finalHandler) {
+    if (interceptors.length === 0) {
+        return finalHandler;
+    }
+    // Build chain from right to left
+    let chain = finalHandler;
+    for (let i = interceptors.length - 1; i >= 0; i--) {
+        const interceptor = interceptors[i];
+        const next = chain;
+        chain = () => interceptor(envelope, ctx, next);
+    }
+    return chain;
+}
+/**
+ * Create a context with call function and incremented callingLevel
+ *
+ * Note: The call function is created lazily to capture the current context's
+ * callingLevel properly for nested calls.
+ */
+function createContextWithCall(parentCtx, router) {
+    const callingLevel = (parentCtx.callingLevel ?? 0) + 1;
+    // Create the context first with a placeholder
+    const ctxWithCall = {
+        ...parentCtx,
+        extensions: new Map(parentCtx.extensions),
+        callingLevel,
+        call: undefined,
+    };
+    // Now create the call function with reference to this context
+    const callFn = async (procedure, input) => {
+        // Prevent excessive nesting (protection against infinite recursion)
+        if (ctxWithCall.callingLevel >= 100) {
+            throw new RaffelError('CALLING_DEPTH_EXCEEDED', `Maximum calling depth exceeded (${ctxWithCall.callingLevel}). Possible infinite recursion.`, { procedure, callingLevel: ctxWithCall.callingLevel }, 500);
+        }
+        // Create envelope for the internal call
+        // Pass ctxWithCall so the next level will see the incremented callingLevel
+        const envelope = {
+            id: generateId(),
+            procedure,
+            type: 'request',
+            payload: input,
+            metadata: {
+                ...(ctxWithCall.tracing && { 'x-trace-id': ctxWithCall.tracing.traceId }),
+                'x-internal-call': 'true',
+            },
+            context: ctxWithCall,
+        };
+        // Execute through router
+        const result = await router.handle(envelope);
+        // Handle error response
+        if (result && typeof result === 'object' && 'type' in result) {
+            const responseEnvelope = result;
+            if (responseEnvelope.type === 'error') {
+                const errorPayload = responseEnvelope.payload;
+                throw new RaffelError(errorPayload.code, errorPayload.message, errorPayload.details, errorPayload.status);
+            }
+            // Extract payload from response
+            return responseEnvelope.payload;
+        }
+        // For streams or other results, return as-is
+        return result;
+    };
+    // Assign the call function
+    ctxWithCall.call = callFn;
+    return ctxWithCall;
+}
+/**
+ * Create a new Router
+ */
+export function createRouter(registry, options = {}) {
+    const globalInterceptors = options.interceptors ?? [];
+    const deliveryEngine = createEventDeliveryEngine(options.eventDelivery);
+    return {
+        use(interceptor) {
+            globalInterceptors.push(interceptor);
+        },
+        stop() {
+            deliveryEngine.stop();
+        },
+        async handle(envelope) {
+            const { procedure, type, payload, context } = envelope;
+            // Create call function bound to this router
+            // We need a reference to `this` (the router) for ctx.call()
+            const router = this;
+            try {
+                // Check deadline
+                if (context.deadline && Date.now() > context.deadline) {
+                    return createErrorEnvelope(envelope, 'DEADLINE_EXCEEDED', 'Request deadline exceeded');
+                }
+                // Check cancellation
+                if (context.signal.aborted) {
+                    return createErrorEnvelope(envelope, 'CANCELLED', 'Request was cancelled');
+                }
+                // Create enhanced context with call function
+                const ctxWithCall = createContextWithCall(context, router);
+                // Route based on envelope type
+                switch (type) {
+                    case 'request': {
+                        // Look up procedure
+                        const registered = registry.getProcedure(procedure);
+                        if (!registered) {
+                            return createErrorEnvelope(envelope, 'NOT_FOUND', `Procedure '${procedure}' not found`);
+                        }
+                        // Build interceptor chain
+                        const interceptors = [
+                            ...globalInterceptors,
+                            ...(registered.interceptors ?? []),
+                        ];
+                        const handler = registered.handler;
+                        const chain = buildChain(envelope, ctxWithCall, interceptors, async () => handler(payload, ctxWithCall));
+                        // Execute chain
+                        const result = await chain();
+                        return createResponseEnvelope(envelope, result);
+                    }
+                    case 'stream:start': {
+                        // Look up stream handler
+                        const registered = registry.getStream(procedure);
+                        if (!registered) {
+                            return createErrorEnvelope(envelope, 'NOT_FOUND', `Stream '${procedure}' not found`);
+                        }
+                        // Build interceptor chain for stream initiation
+                        const interceptors = [
+                            ...globalInterceptors,
+                            ...(registered.interceptors ?? []),
+                        ];
+                        const streamDirection = registered.meta.streamDirection ?? 'server';
+                        const isAsyncIterable = (value) => !!value && typeof value === 'object' && Symbol.asyncIterator in value;
+                        if (streamDirection === 'server') {
+                            const handler = registered.handler;
+                            const chain = buildChain(envelope, ctxWithCall, interceptors, async () => handler(payload, ctxWithCall));
+                            // Execute chain - returns stream or async iterable
+                            const result = (await chain());
+                            // Wrap in envelope stream
+                            return wrapStreamInEnvelopes(envelope, result);
+                        }
+                        if (!isAsyncIterable(payload)) {
+                            return createErrorEnvelope(envelope, 'INVALID_ARGUMENT', 'Stream payload must be an async iterable');
+                        }
+                        if (streamDirection === 'client') {
+                            const handler = registered.handler;
+                            const chain = buildChain(envelope, ctxWithCall, interceptors, async () => handler(payload, ctxWithCall));
+                            const result = await chain();
+                            return createResponseEnvelope(envelope, result);
+                        }
+                        const handler = registered.handler;
+                        const chain = buildChain(envelope, ctxWithCall, interceptors, async () => handler(payload, ctxWithCall));
+                        const result = (await chain());
+                        return wrapStreamInEnvelopes(envelope, result);
+                    }
+                    case 'event': {
+                        // Look up event handler
+                        const registered = registry.getEvent(procedure);
+                        if (!registered) {
+                            // Events are fire-and-forget, but still return error for bad routing
+                            return createErrorEnvelope(envelope, 'NOT_FOUND', `Event '${procedure}' not found`);
+                        }
+                        // Build interceptor chain
+                        const interceptors = [
+                            ...globalInterceptors,
+                            ...(registered.interceptors ?? []),
+                        ];
+                        const handler = registered.handler;
+                        const delivery = registered.meta.delivery ?? 'best-effort';
+                        const execute = async (ack) => {
+                            const chain = buildChain(envelope, ctxWithCall, interceptors, async () => handler(payload, ctxWithCall, ack));
+                            await chain();
+                        };
+                        const deliveryPromise = deliveryEngine.deliver({
+                            eventId: envelope.id,
+                            delivery,
+                            retryPolicy: registered.meta.retryPolicy,
+                            deduplicationWindow: registered.meta.deduplicationWindow,
+                            execute,
+                        });
+                        if (delivery === 'best-effort') {
+                            deliveryPromise.catch((err) => {
+                                console.error(`Event handler error for '${procedure}':`, err);
+                            });
+                        }
+                        else {
+                            await deliveryPromise;
+                        }
+                        // Events don't return meaningful responses
+                        return createResponseEnvelope(envelope, { received: true });
+                    }
+                    default:
+                        return createErrorEnvelope(envelope, 'INVALID_TYPE', `Cannot route envelope type: ${type}`);
+                }
+            }
+            catch (err) {
+                // Handle known errors
+                if (err instanceof RaffelError) {
+                    return createErrorEnvelope(envelope, err.code, err.message, err.details, err.status);
+                }
+                // Handle unknown errors
+                const error = err;
+                return createErrorEnvelope(envelope, 'INTERNAL_ERROR', error.message ?? 'Unknown error', process.env.NODE_ENV === 'development' ? error.stack : undefined);
+            }
+        },
+    };
+}
+/**
+ * Wrap a stream result in envelope stream
+ */
+async function* wrapStreamInEnvelopes(request, stream) {
+    // Send stream start
+    yield {
+        id: `${request.id}:stream:start`,
+        procedure: request.procedure,
+        type: 'stream:start',
+        payload: null,
+        metadata: {},
+        context: request.context,
+    };
+    try {
+        // Send data chunks
+        for await (const chunk of stream) {
+            yield {
+                id: `${request.id}:stream:data:${Date.now()}`,
+                procedure: request.procedure,
+                type: 'stream:data',
+                payload: chunk,
+                metadata: {},
+                context: request.context,
+            };
+        }
+        // Send stream end
+        yield {
+            id: `${request.id}:stream:end`,
+            procedure: request.procedure,
+            type: 'stream:end',
+            payload: null,
+            metadata: {},
+            context: request.context,
+        };
+    }
+    catch (err) {
+        // Send stream error
+        const error = err;
+        const code = err instanceof RaffelError ? err.code : 'STREAM_ERROR';
+        yield {
+            id: `${request.id}:stream:error`,
+            procedure: request.procedure,
+            type: 'stream:error',
+            payload: {
+                code,
+                status: err instanceof RaffelError ? err.status : getStatusForCode(code),
+                message: error.message ?? 'Stream error',
+                details: err instanceof RaffelError ? err.details : undefined,
+            },
+            metadata: {},
+            context: request.context,
+        };
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/core/router.js.map

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

package/dist/docs/generators/content-types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Content type helpers for USD generators
+ */
+import type { USDContentTypes } from '../../usd/index.js';
+export interface ContentTypeMeta {
+    contentType?: string;
+    contentTypes?: USDContentTypes;
+}
+export declare function resolveContentTypes(meta?: ContentTypeMeta): USDContentTypes | undefined;
+//# sourceMappingURL=content-types.d.ts.map

package/dist/docs/generators/content-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.d.ts","sourceRoot":"","sources":["../../../src/docs/generators/content-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,eAAe,CAAA;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAYvF"}

package/dist/docs/generators/content-types.js

@@ -0,0 +1,18 @@
+/**
+ * Content type helpers for USD generators
+ */
+export function resolveContentTypes(meta) {
+    if (!meta)
+        return undefined;
+    if (meta.contentTypes) {
+        return meta.contentTypes;
+    }
+    if (meta.contentType) {
+        return {
+            default: meta.contentType,
+            supported: [meta.contentType],
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=content-types.js.map

package/dist/docs/generators/content-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.js","sourceRoot":"","sources":["../../../src/docs/generators/content-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,SAAS,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;SAC9B,CAAA;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}