raffel 0.1.2

package/dist/core/registry.js

@@ -0,0 +1,107 @@
+/**
+ * Registry - Handler Registration
+ *
+ * Stores and retrieves handlers for procedures, streams, and events.
+ * Provides introspection for adapters to generate schemas/routes.
+ */
+/**
+ * Create a new Registry
+ */
+export function createRegistry() {
+    const procedures = new Map();
+    const streams = new Map();
+    const events = new Map();
+    return {
+        // === Registration ===
+        procedure(name, handler, options = {}) {
+            if (procedures.has(name) || streams.has(name) || events.has(name)) {
+                throw new Error(`Handler '${name}' already registered`);
+            }
+            procedures.set(name, {
+                handler: handler,
+                meta: {
+                    kind: 'procedure',
+                    name,
+                    summary: options.summary,
+                    description: options.description,
+                    tags: options.tags,
+                    contentType: options.contentType,
+                    contentTypes: options.contentTypes,
+                    graphql: options.graphql,
+                    httpPath: options.httpPath,
+                    httpMethod: options.httpMethod,
+                    jsonrpc: options.jsonrpc,
+                    grpc: options.grpc,
+                },
+                interceptors: options.interceptors,
+            });
+        },
+        stream(name, handler, options = {}) {
+            if (procedures.has(name) || streams.has(name) || events.has(name)) {
+                throw new Error(`Handler '${name}' already registered`);
+            }
+            streams.set(name, {
+                handler: handler,
+                meta: {
+                    kind: 'stream',
+                    name,
+                    description: options.description,
+                    streamDirection: options.direction ?? 'server',
+                    contentType: options.contentType,
+                    contentTypes: options.contentTypes,
+                },
+                interceptors: options.interceptors,
+            });
+        },
+        event(name, handler, options = {}) {
+            if (procedures.has(name) || streams.has(name) || events.has(name)) {
+                throw new Error(`Handler '${name}' already registered`);
+            }
+            events.set(name, {
+                handler: handler,
+                meta: {
+                    kind: 'event',
+                    name,
+                    description: options.description,
+                    delivery: options.delivery ?? 'best-effort',
+                    retryPolicy: options.retryPolicy,
+                    deduplicationWindow: options.deduplicationWindow,
+                    contentType: options.contentType,
+                    contentTypes: options.contentTypes,
+                },
+                interceptors: options.interceptors,
+            });
+        },
+        // === Lookup ===
+        getProcedure(name) {
+            return procedures.get(name);
+        },
+        getStream(name) {
+            return streams.get(name);
+        },
+        getEvent(name) {
+            return events.get(name);
+        },
+        has(name) {
+            return procedures.has(name) || streams.has(name) || events.has(name);
+        },
+        // === Introspection ===
+        list() {
+            return [
+                ...Array.from(procedures.values()).map((h) => h.meta),
+                ...Array.from(streams.values()).map((h) => h.meta),
+                ...Array.from(events.values()).map((h) => h.meta),
+            ];
+        },
+        listProcedures() {
+            return Array.from(procedures.values()).map((h) => h.meta);
+        },
+        listStreams() {
+            return Array.from(streams.values()).map((h) => h.meta);
+        },
+        listEvents() {
+            return Array.from(events.values()).map((h) => h.meta);
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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

package/dist/core/registry.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.unit.test.d.ts.map

package/dist/core/registry.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.unit.test.d.ts","sourceRoot":"","sources":["../../src/core/registry.unit.test.ts"],"names":[],"mappings":""}

package/dist/core/registry.unit.test.js

@@ -0,0 +1,133 @@
+import { describe, it, expect } from 'vitest';
+import { createRegistry } from './registry.js';
+describe('Registry', () => {
+    describe('procedure registration', () => {
+        it('should register a procedure handler', () => {
+            const registry = createRegistry();
+            registry.procedure('users.create', async (input) => {
+                return { id: '1', name: input.name };
+            });
+            expect(registry.has('users.create')).toBe(true);
+            expect(registry.getProcedure('users.create')).toBeTruthy();
+        });
+        it('should register with options', () => {
+            const registry = createRegistry();
+            registry.procedure('users.get', async (input) => ({ id: input.id }), { description: 'Get user by ID' });
+            const registered = registry.getProcedure('users.get');
+            expect(registered?.meta.description).toBe('Get user by ID');
+            expect(registered?.meta.kind).toBe('procedure');
+        });
+        it('should prevent duplicate registration', () => {
+            const registry = createRegistry();
+            registry.procedure('test', async () => { });
+            expect(() => registry.procedure('test', async () => { })).toThrow(/already registered/);
+        });
+        it('should return undefined for unknown procedure', () => {
+            const registry = createRegistry();
+            expect(registry.getProcedure('unknown')).toBeUndefined();
+        });
+    });
+    describe('stream registration', () => {
+        it('should register a stream handler', () => {
+            const registry = createRegistry();
+            registry.stream('logs.stream', async function* () {
+                yield { level: 'info', message: 'test' };
+            });
+            expect(registry.has('logs.stream')).toBe(true);
+            expect(registry.getStream('logs.stream')).toBeTruthy();
+        });
+        it('should set default direction to server', () => {
+            const registry = createRegistry();
+            registry.stream('test', async function* () { });
+            const registered = registry.getStream('test');
+            expect(registered?.meta.streamDirection).toBe('server');
+        });
+        it('should accept custom direction', () => {
+            const registry = createRegistry();
+            registry.stream('chat', async function* () { }, { direction: 'bidi' });
+            const registered = registry.getStream('chat');
+            expect(registered?.meta.streamDirection).toBe('bidi');
+        });
+    });
+    describe('event registration', () => {
+        it('should register an event handler', () => {
+            const registry = createRegistry();
+            registry.event('user.created', async () => { });
+            expect(registry.has('user.created')).toBe(true);
+            expect(registry.getEvent('user.created')).toBeTruthy();
+        });
+        it('should set default delivery to best-effort', () => {
+            const registry = createRegistry();
+            registry.event('analytics.track', async () => { });
+            const registered = registry.getEvent('analytics.track');
+            expect(registered?.meta.delivery).toBe('best-effort');
+        });
+        it('should accept delivery guarantee config', () => {
+            const registry = createRegistry();
+            registry.event('order.created', async () => { }, {
+                delivery: 'at-least-once',
+                retryPolicy: {
+                    maxAttempts: 3,
+                    initialDelay: 1000,
+                    maxDelay: 30000,
+                    backoffMultiplier: 2,
+                },
+            });
+            const registered = registry.getEvent('order.created');
+            expect(registered?.meta.delivery).toBe('at-least-once');
+            expect(registered?.meta.retryPolicy?.maxAttempts).toBe(3);
+        });
+    });
+    describe('cross-type collision', () => {
+        it('should prevent same name across types', () => {
+            const registry = createRegistry();
+            registry.procedure('test', async () => { });
+            expect(() => registry.stream('test', async function* () { })).toThrow(/already registered/);
+            expect(() => registry.event('test', async () => { })).toThrow(/already registered/);
+        });
+    });
+    describe('introspection', () => {
+        it('should list all handlers', () => {
+            const registry = createRegistry();
+            registry.procedure('users.create', async () => { });
+            registry.procedure('users.get', async () => { });
+            registry.stream('logs.stream', async function* () { });
+            registry.event('user.created', async () => { });
+            const all = registry.list();
+            expect(all.length).toBe(4);
+        });
+        it('should list by type', () => {
+            const registry = createRegistry();
+            registry.procedure('p1', async () => { });
+            registry.procedure('p2', async () => { });
+            registry.stream('s1', async function* () { });
+            registry.event('e1', async () => { });
+            expect(registry.listProcedures().length).toBe(2);
+            expect(registry.listStreams().length).toBe(1);
+            expect(registry.listEvents().length).toBe(1);
+        });
+        it('should include metadata in listings', () => {
+            const registry = createRegistry();
+            registry.procedure('test', async () => { }, {
+                description: 'Test procedure',
+            });
+            const [meta] = registry.listProcedures();
+            expect(meta.name).toBe('test');
+            expect(meta.kind).toBe('procedure');
+            expect(meta.description).toBe('Test procedure');
+        });
+    });
+    describe('has()', () => {
+        it('should check existence across all types', () => {
+            const registry = createRegistry();
+            registry.procedure('proc', async () => { });
+            registry.stream('stream', async function* () { });
+            registry.event('event', async () => { });
+            expect(registry.has('proc')).toBe(true);
+            expect(registry.has('stream')).toBe(true);
+            expect(registry.has('event')).toBe(true);
+            expect(registry.has('unknown')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=registry.unit.test.js.map

package/dist/core/registry.unit.test.js.map

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

package/dist/core/router.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Router - Envelope Dispatch
+ *
+ * Routes incoming envelopes to the correct handler, executing
+ * interceptors in an onion model.
+ */
+import type { Envelope, Interceptor, RaffelStream } from '../types/index.js';
+import type { Registry } from './registry.js';
+import { type EventDeliveryOptions } from './event-delivery.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 declare class RaffelError extends Error {
+    /** String error code (e.g., 'NOT_FOUND', 'VALIDATION_ERROR') */
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    /**
+     * Numeric status code (HTTP-compatible)
+     *
+     * - 400-499: Client errors
+     * - 500-599: Server errors
+     */
+    readonly status: number;
+    constructor(
+    /** String error code (e.g., 'NOT_FOUND', 'VALIDATION_ERROR') */
+    code: string, message: string, details?: unknown | undefined, 
+    /** Optional explicit status override */
+    status?: number);
+    /**
+     * Convert to plain object for serialization
+     */
+    toJSON(): {
+        code: string;
+        status: number;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Router result - envelope or stream of envelopes
+ */
+export type RouterResult = Envelope | RaffelStream<Envelope> | AsyncIterable<Envelope>;
+/**
+ * Router options
+ */
+export interface RouterOptions {
+    /** Global interceptors (run for all handlers) */
+    interceptors?: Interceptor[];
+    /** Event delivery configuration */
+    eventDelivery?: EventDeliveryOptions;
+}
+/**
+ * Router interface
+ */
+export interface Router {
+    /** Handle an incoming envelope */
+    handle(envelope: Envelope): Promise<RouterResult>;
+    /** Add a global interceptor */
+    use(interceptor: Interceptor): void;
+    /** Stop background tasks (timers, retries) */
+    stop(): void;
+}
+/**
+ * Create a new Router
+ */
+export declare function createRouter(registry: Registry, options?: RouterOptions): Router;
+//# sourceMappingURL=router.d.ts.map

package/dist/core/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EAGX,YAAY,EAGb,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAA;AAI5B;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAUlC,gEAAgE;aAChD,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;IAZnC;;;;;OAKG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAA;;IAG5B,gEAAgE;IAChD,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;IACjC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM;IAOjB;;OAEG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ/E;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,mCAAmC;IACnC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAEjD,+BAA+B;IAC/B,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAEnC,8CAA8C;IAC9C,IAAI,IAAI,IAAI,CAAA;CACb;AAyGD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoNpF"}

package/dist/core/router.int.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=router.int.test.d.ts.map

package/dist/core/router.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.int.test.d.ts","sourceRoot":"","sources":["../../src/core/router.int.test.ts"],"names":[],"mappings":""}