raffel 0.1.2

package/dist/channels/types.js

@@ -0,0 +1,39 @@
+/**
+ * Channel Types
+ *
+ * Type definitions for Pusher-like WebSocket channels.
+ *
+ * Channel naming convention:
+ * - `chat-room` → Public channel (anyone can subscribe)
+ * - `private-xyz` → Private channel (requires authorization)
+ * - `presence-xyz` → Presence channel (auth + member tracking)
+ */
+/**
+ * Check if a message is a channel-related message
+ */
+export function isChannelMessage(message) {
+    if (!message || typeof message !== 'object')
+        return false;
+    const msg = message;
+    return (msg.type === 'subscribe' ||
+        msg.type === 'unsubscribe' ||
+        msg.type === 'publish');
+}
+/**
+ * Get channel type from name
+ */
+export function getChannelType(name) {
+    if (name.startsWith('presence-'))
+        return 'presence';
+    if (name.startsWith('private-'))
+        return 'private';
+    return 'public';
+}
+/**
+ * Check if channel requires authorization
+ */
+export function requiresAuth(channel) {
+    const type = getChannelType(channel);
+    return type === 'private' || type === 'presence';
+}
+//# sourceMappingURL=types.js.map

package/dist/channels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0UH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgB;IAEhB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzD,MAAM,GAAG,GAAG,OAAkC,CAAA;IAC9C,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,WAAW;QACxB,GAAG,CAAC,IAAI,KAAK,aAAa;QAC1B,GAAG,CAAC,IAAI,KAAK,SAAS,CACvB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,UAAU,CAAA;IACnD,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAA;IACjD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACpC,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,CAAA;AAClD,CAAC"}

package/dist/core/ctx-call.int.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ctx.call() Tests
+ *
+ * Tests for internal procedure calls via context.
+ */
+export {};
+//# sourceMappingURL=ctx-call.int.test.d.ts.map

package/dist/core/ctx-call.int.test.d.ts.map

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

package/dist/core/ctx-call.int.test.js

@@ -0,0 +1,263 @@
+/**
+ * ctx.call() Tests
+ *
+ * Tests for internal procedure calls via context.
+ */
+import { describe, it, expect } from 'vitest';
+import { createRouter, RaffelError } from './router.js';
+import { createRegistry } from './registry.js';
+import { createContext } from '../types/index.js';
+function createEnvelope(procedure, payload = {}, ctx) {
+    return {
+        id: `test-${Date.now()}`,
+        procedure,
+        type: 'request',
+        payload,
+        metadata: {},
+        context: ctx ?? createContext('test-request'),
+    };
+}
+describe('ctx.call()', () => {
+    describe('basic functionality', () => {
+        it('should call another procedure and return its result', async () => {
+            const registry = createRegistry();
+            registry.procedure('users.get', async (input, ctx) => {
+                return { id: input.id, name: 'John' };
+            });
+            registry.procedure('orders.getWithUser', async (input, ctx) => {
+                // Call users.get internally
+                const user = await ctx.call('users.get', { id: 'user-123' });
+                return { orderId: input.orderId, user };
+            });
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('orders.getWithUser', { orderId: 'order-456' }));
+            expect(result).toMatchObject({
+                type: 'response',
+                payload: {
+                    orderId: 'order-456',
+                    user: { id: 'user-123', name: 'John' },
+                },
+            });
+        });
+        it('should propagate errors from called procedure', async () => {
+            const registry = createRegistry();
+            registry.procedure('users.get', async (input) => {
+                throw new RaffelError('NOT_FOUND', `User ${input.id} not found`);
+            });
+            registry.procedure('orders.getWithUser', async (input, ctx) => {
+                try {
+                    const user = await ctx.call('users.get', { id: 'invalid' });
+                    return { orderId: input.orderId, user };
+                }
+                catch (err) {
+                    if (err instanceof RaffelError && err.code === 'NOT_FOUND') {
+                        return { orderId: input.orderId, user: null };
+                    }
+                    throw err;
+                }
+            });
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('orders.getWithUser', { orderId: 'order-456' }));
+            expect(result).toMatchObject({
+                type: 'response',
+                payload: {
+                    orderId: 'order-456',
+                    user: null,
+                },
+            });
+        });
+        it('should throw error for non-existent procedure', async () => {
+            const registry = createRegistry();
+            registry.procedure('caller', async (input, ctx) => {
+                return await ctx.call('nonexistent', {});
+            });
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('caller', {}));
+            expect(result).toMatchObject({
+                type: 'error',
+                payload: {
+                    code: 'NOT_FOUND',
+                    message: expect.stringContaining('nonexistent'),
+                },
+            });
+        });
+    });
+    describe('context propagation', () => {
+        it('should propagate requestId to nested calls', async () => {
+            const registry = createRegistry();
+            let capturedRequestId;
+            registry.procedure('inner', async (input, ctx) => {
+                capturedRequestId = ctx.requestId;
+                return { captured: ctx.requestId };
+            });
+            registry.procedure('outer', async (input, ctx) => {
+                return await ctx.call('inner', {});
+            });
+            const context = createContext('original-request-id');
+            const router = createRouter(registry);
+            await router.handle(createEnvelope('outer', {}, context));
+            expect(capturedRequestId).toBe('original-request-id');
+        });
+        it('should propagate auth context to nested calls', async () => {
+            const registry = createRegistry();
+            let capturedAuth;
+            registry.procedure('inner', async (input, ctx) => {
+                capturedAuth = ctx.auth;
+                return { principal: ctx.auth?.principal };
+            });
+            registry.procedure('outer', async (input, ctx) => {
+                return await ctx.call('inner', {});
+            });
+            const context = createContext('req-1');
+            context.auth = {
+                authenticated: true,
+                principal: 'user-123',
+                claims: { role: 'admin' },
+            };
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('outer', {}, context));
+            expect(capturedAuth).toEqual({
+                authenticated: true,
+                principal: 'user-123',
+                claims: { role: 'admin' },
+            });
+        });
+        it('should propagate tracing context', async () => {
+            const registry = createRegistry();
+            let capturedTracing;
+            registry.procedure('inner', async (input, ctx) => {
+                capturedTracing = ctx.tracing;
+                return {};
+            });
+            registry.procedure('outer', async (input, ctx) => {
+                return await ctx.call('inner', {});
+            });
+            const context = createContext('req-1', {
+                tracing: {
+                    traceId: 'trace-abc',
+                    spanId: 'span-123',
+                    parentSpanId: 'span-000',
+                },
+            });
+            const router = createRouter(registry);
+            await router.handle(createEnvelope('outer', {}, context));
+            expect(capturedTracing.traceId).toBe('trace-abc');
+        });
+    });
+    describe('calling level tracking', () => {
+        it('should increment callingLevel for nested calls', async () => {
+            const registry = createRegistry();
+            const capturedLevels = [];
+            registry.procedure('level2', async (input, ctx) => {
+                capturedLevels.push(ctx.callingLevel ?? 0);
+                return {};
+            });
+            registry.procedure('level1', async (input, ctx) => {
+                capturedLevels.push(ctx.callingLevel ?? 0);
+                return await ctx.call('level2', {});
+            });
+            registry.procedure('level0', async (input, ctx) => {
+                capturedLevels.push(ctx.callingLevel ?? 0);
+                return await ctx.call('level1', {});
+            });
+            const router = createRouter(registry);
+            await router.handle(createEnvelope('level0', {}));
+            // level0 starts at 1 (enhanced by router), then increments each level
+            expect(capturedLevels).toEqual([1, 2, 3]);
+        });
+        it('should prevent excessive recursion', async () => {
+            const registry = createRegistry();
+            let maxDepthReached = 0;
+            // Create a procedure that keeps calling itself
+            registry.procedure('recursive', async (input, ctx) => {
+                maxDepthReached = Math.max(maxDepthReached, ctx.callingLevel ?? 0);
+                // This would recurse infinitely without the protection
+                return await ctx.call('recursive', { depth: input.depth + 1 });
+            });
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('recursive', { depth: 0 }));
+            // Should hit the depth limit (100) and return error
+            expect(result).toMatchObject({
+                type: 'error',
+                payload: {
+                    code: 'CALLING_DEPTH_EXCEEDED',
+                },
+            });
+            // Should have reached level 100 before failing
+            expect(maxDepthReached).toBe(100);
+        });
+    });
+    describe('interceptors', () => {
+        it('should run interceptors on internal calls', async () => {
+            const registry = createRegistry();
+            const interceptorCalls = [];
+            const trackingInterceptor = async (envelope, ctx, next) => {
+                interceptorCalls.push(envelope.procedure);
+                return next();
+            };
+            registry.procedure('inner', async () => ({ message: 'inner' }), { interceptors: [trackingInterceptor] });
+            registry.procedure('outer', async (input, ctx) => await ctx.call('inner', {}), { interceptors: [trackingInterceptor] });
+            const router = createRouter(registry);
+            await router.handle(createEnvelope('outer', {}));
+            expect(interceptorCalls).toEqual(['outer', 'inner']);
+        });
+        it('should run global interceptors on internal calls', async () => {
+            const registry = createRegistry();
+            const interceptorCalls = [];
+            const globalInterceptor = async (envelope, ctx, next) => {
+                interceptorCalls.push(`global:${envelope.procedure}`);
+                return next();
+            };
+            registry.procedure('inner', async () => ({ message: 'inner' }));
+            registry.procedure('outer', async (input, ctx) => await ctx.call('inner', {}));
+            const router = createRouter(registry, { interceptors: [globalInterceptor] });
+            await router.handle(createEnvelope('outer', {}));
+            expect(interceptorCalls).toEqual(['global:outer', 'global:inner']);
+        });
+    });
+    describe('concurrent calls', () => {
+        it('should handle multiple concurrent internal calls', async () => {
+            const registry = createRegistry();
+            registry.procedure('slow', async (input) => {
+                await new Promise((r) => setTimeout(r, input.delay));
+                return { value: input.value };
+            });
+            registry.procedure('aggregate', async (input, ctx) => {
+                const [a, b, c] = await Promise.all([
+                    ctx.call('slow', { delay: 30, value: 'a' }),
+                    ctx.call('slow', { delay: 20, value: 'b' }),
+                    ctx.call('slow', { delay: 10, value: 'c' }),
+                ]);
+                return { results: [a, b, c] };
+            });
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('aggregate', {}));
+            expect(result).toMatchObject({
+                type: 'response',
+                payload: {
+                    results: [{ value: 'a' }, { value: 'b' }, { value: 'c' }],
+                },
+            });
+        });
+    });
+    describe('type safety', () => {
+        it('should preserve types through ctx.call', async () => {
+            const registry = createRegistry();
+            registry.procedure('users.get', async (input, ctx) => {
+                return { id: input.id, name: 'Test User', email: 'test@example.com' };
+            });
+            registry.procedure('users.getEmail', async (input, ctx) => {
+                const user = await ctx.call('users.get', { id: input.userId });
+                // TypeScript should recognize user.email
+                return { email: user.email };
+            });
+            const router = createRouter(registry);
+            const result = await router.handle(createEnvelope('users.getEmail', { userId: 'u-1' }));
+            expect(result).toMatchObject({
+                type: 'response',
+                payload: { email: 'test@example.com' },
+            });
+        });
+    });
+});
+//# sourceMappingURL=ctx-call.int.test.js.map

package/dist/core/ctx-call.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctx-call.int.test.js","sourceRoot":"","sources":["../../src/core/ctx-call.int.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAM,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,SAAS,cAAc,CACrB,SAAiB,EACjB,UAAmB,EAAE,EACrB,GAAa;IAEb,OAAO;QACL,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE;QACxB,SAAS;QACT,IAAI,EAAE,SAAS;QACf,OAAO;QACP,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,GAAG,IAAI,aAAa,CAAC,cAAc,CAAC;KAC9C,CAAA;AACH,CAAC;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YAEjC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAqB,EAAE,GAAG,EAAE,EAAE;gBACnE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;YACvC,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAA0B,EAAE,GAAG,EAAE,EAAE;gBACjF,4BAA4B;gBAC5B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAK,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;gBAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;YACzC,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,cAAc,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAC/D,CAAA;YAED,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE;oBACP,OAAO,EAAE,WAAW;oBACpB,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;iBACvC;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YAEjC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAqB,EAAE,EAAE;gBAC9D,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,QAAQ,KAAK,CAAC,EAAE,YAAY,CAAC,CAAA;YAClE,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAA0B,EAAE,GAAG,EAAE,EAAE;gBACjF,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAK,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;oBAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;gBACzC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;oBAC/C,CAAC;oBACD,MAAM,GAAG,CAAA;gBACX,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,cAAc,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAC/D,CAAA;YAED,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE;oBACP,OAAO,EAAE,WAAW;oBACpB,IAAI,EAAE,IAAI;iBACX;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YAEjC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAChD,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;YAC3C,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;YAEhE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE;oBACP,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC;iBAChD;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,IAAI,iBAAqC,CAAA;YAEzC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC/C,iBAAiB,GAAG,GAAG,CAAC,SAAS,CAAA;gBACjC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,CAAA;YACpC,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC/C,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;YACrC,CAAC,CAAC,CAAA;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAA;YACpD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAEzD,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,IAAI,YAAiB,CAAA;YAErB,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC/C,YAAY,GAAG,GAAG,CAAC,IAAI,CAAA;gBACvB,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAA;YAC3C,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC/C,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;YACrC,CAAC,CAAC,CAAA;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CACrC;YAAC,OAAe,CAAC,IAAI,GAAG;gBACvB,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;aAC1B,CAAA;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAExE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;gBAC3B,aAAa,EAAE,IAAI;gBACnB,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;aAC1B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,IAAI,eAAoB,CAAA;YAExB,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC/C,eAAe,GAAG,GAAG,CAAC,OAAO,CAAA;gBAC7B,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC/C,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;YACrC,CAAC,CAAC,CAAA;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE;gBACrC,OAAO,EAAE;oBACP,OAAO,EAAE,WAAW;oBACpB,MAAM,EAAE,UAAU;oBAClB,YAAY,EAAE,UAAU;iBACzB;aACF,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAEzD,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACnD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,MAAM,cAAc,GAAa,EAAE,CAAA;YAEnC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAChD,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;gBAC1C,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAChD,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;gBAC1C,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;YACtC,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAChD,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;gBAC1C,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;YACtC,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;YAEjD,sEAAsE;YACtE,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,IAAI,eAAe,GAAG,CAAC,CAAA;YAEvB,+CAA+C;YAC/C,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAwB,EAAE,GAAG,EAAE,EAAE;gBACtE,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;gBAClE,uDAAuD;gBACvD,OAAO,MAAM,GAAG,CAAC,IAAK,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAA;YACjE,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAE7E,oDAAoD;YACpD,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE;oBACP,IAAI,EAAE,wBAAwB;iBAC/B;aACF,CAAC,CAAA;YAEF,+CAA+C;YAC/C,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,MAAM,gBAAgB,GAAa,EAAE,CAAA;YAErC,MAAM,mBAAmB,GAAgB,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;gBACrE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACzC,OAAO,IAAI,EAAE,CAAA;YACf,CAAC,CAAA;YAED,QAAQ,CAAC,SAAS,CAChB,OAAO,EACP,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAClC,EAAE,YAAY,EAAE,CAAC,mBAAmB,CAAC,EAAE,CACxC,CAAA;YAED,QAAQ,CAAC,SAAS,CAChB,OAAO,EACP,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,IAAK,CAAC,OAAO,EAAE,EAAE,CAAC,EAClD,EAAE,YAAY,EAAE,CAAC,mBAAmB,CAAC,EAAE,CACxC,CAAA;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;YAEhD,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YACjC,MAAM,gBAAgB,GAAa,EAAE,CAAA;YAErC,MAAM,iBAAiB,GAAgB,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;gBACnE,gBAAgB,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;gBACrD,OAAO,IAAI,EAAE,CAAA;YACf,CAAC,CAAA;YAED,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;YAC/D,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,IAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;YAE/E,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAA;YAC5E,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;YAEhD,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAA;QACpE,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YAEjC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,KAAuC,EAAE,EAAE;gBAC3E,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;gBACpD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAA;YAC/B,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACnD,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBAClC,GAAG,CAAC,IAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;oBAC5C,GAAG,CAAC,IAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;oBAC5C,GAAG,CAAC,IAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;iBAC7C,CAAC,CAAA;gBACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;YAC/B,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAA;YAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE;oBACP,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;iBAC1D;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;YAQjC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,KAAqB,EAAE,GAAG,EAAiB,EAAE;gBAClF,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAA;YACvE,CAAC,CAAC,CAAA;YAEF,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,KAAK,EAAE,KAAyB,EAAE,GAAG,EAAE,EAAE;gBAC5E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAK,CAAuB,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;gBACrF,yCAAyC;gBACzC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;YAC9B,CAAC,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,cAAc,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CACpD,CAAA;YAED,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE;aACvC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/core/event-delivery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Event Delivery Engine
+ *
+ * Implements delivery guarantees for events with retry and deduplication.
+ */
+import type { RetryPolicy } from '../types/handlers.js';
+export interface EventDeliveryOptions {
+    /** Delivery state store (default: in-memory) */
+    store?: EventDeliveryStore;
+    /** Default retry policy for at-least-once events */
+    defaultRetryPolicy?: RetryPolicy;
+    /** Default deduplication window for at-most-once events (ms) */
+    defaultDeduplicationWindow?: number;
+}
+export interface EventDeliveryStore {
+    getRetryState(eventId: string): Promise<RetryState | null>;
+    setRetryState(eventId: string, state: RetryState): Promise<void>;
+    deleteRetryState(eventId: string): Promise<void>;
+    isDuplicate(eventId: string): Promise<boolean>;
+    markDuplicate(eventId: string, ttlMs: number): Promise<void>;
+}
+export interface EventDeliveryEngine {
+    deliver(options: {
+        eventId: string;
+        delivery: 'best-effort' | 'at-least-once' | 'at-most-once';
+        retryPolicy?: RetryPolicy;
+        deduplicationWindow?: number;
+        execute: (ack: () => void) => Promise<void>;
+    }): Promise<void>;
+    stop(): void;
+}
+interface RetryState {
+    attempts: number;
+}
+export declare function createInMemoryEventDeliveryStore(): EventDeliveryStore;
+export declare function createEventDeliveryEngine(options?: EventDeliveryOptions): EventDeliveryEngine;
+export {};
+//# sourceMappingURL=event-delivery.d.ts.map

package/dist/core/event-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-delivery.d.ts","sourceRoot":"","sources":["../../src/core/event-delivery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,WAAW,CAAA;IAChC,gEAAgE;IAChE,0BAA0B,CAAC,EAAE,MAAM,CAAA;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAC1D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE;QACf,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,aAAa,GAAG,eAAe,GAAG,cAAc,CAAA;QAC1D,WAAW,CAAC,EAAE,WAAW,CAAA;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjB,IAAI,IAAI,IAAI,CAAA;CACb;AAED,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAWD,wBAAgB,gCAAgC,IAAI,kBAAkB,CA+BrE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA6HjG"}

package/dist/core/event-delivery.js

@@ -0,0 +1,131 @@
+/**
+ * Event Delivery Engine
+ *
+ * Implements delivery guarantees for events with retry and deduplication.
+ */
+const DEFAULT_RETRY_POLICY = {
+    maxAttempts: 5,
+    initialDelay: 1000,
+    maxDelay: 60000,
+    backoffMultiplier: 2,
+};
+const DEFAULT_DEDUP_WINDOW_MS = 5 * 60 * 1000;
+export function createInMemoryEventDeliveryStore() {
+    const retryState = new Map();
+    const dedup = new Map();
+    function isExpired(expiresAt) {
+        return Date.now() > expiresAt;
+    }
+    return {
+        async getRetryState(eventId) {
+            return retryState.get(eventId) ?? null;
+        },
+        async setRetryState(eventId, state) {
+            retryState.set(eventId, state);
+        },
+        async deleteRetryState(eventId) {
+            retryState.delete(eventId);
+        },
+        async isDuplicate(eventId) {
+            const expiresAt = dedup.get(eventId);
+            if (!expiresAt)
+                return false;
+            if (isExpired(expiresAt)) {
+                dedup.delete(eventId);
+                return false;
+            }
+            return true;
+        },
+        async markDuplicate(eventId, ttlMs) {
+            dedup.set(eventId, Date.now() + ttlMs);
+        },
+    };
+}
+export function createEventDeliveryEngine(options = {}) {
+    const store = options.store ?? createInMemoryEventDeliveryStore();
+    const defaultRetryPolicy = options.defaultRetryPolicy ?? DEFAULT_RETRY_POLICY;
+    const defaultDedupWindow = options.defaultDeduplicationWindow ?? DEFAULT_DEDUP_WINDOW_MS;
+    const timers = new Set();
+    function scheduleRetry(fn, delayMs) {
+        const timer = setTimeout(() => {
+            timers.delete(timer);
+            fn();
+        }, delayMs);
+        timers.add(timer);
+    }
+    function computeBackoff(attempt, policy) {
+        const delay = policy.initialDelay * Math.pow(policy.backoffMultiplier, attempt - 1);
+        return Math.min(policy.maxDelay, delay);
+    }
+    async function deliverBestEffort(execute) {
+        try {
+            await execute(() => { });
+        }
+        catch (err) {
+            console.error('Event handler error (best-effort):', err);
+        }
+    }
+    async function deliverAtMostOnce(eventId, execute, deduplicationWindow) {
+        if (await store.isDuplicate(eventId)) {
+            return;
+        }
+        await store.markDuplicate(eventId, deduplicationWindow);
+        try {
+            await execute(() => { });
+        }
+        catch (err) {
+            console.error('Event handler error (at-most-once):', err);
+        }
+    }
+    async function deliverAtLeastOnce(eventId, execute, policy) {
+        const state = await store.getRetryState(eventId);
+        const attempt = (state?.attempts ?? 0) + 1;
+        const runAttempt = async (currentAttempt) => {
+            let acked = false;
+            const ack = () => {
+                acked = true;
+            };
+            try {
+                await execute(ack);
+            }
+            catch (err) {
+                console.error('Event handler error (at-least-once):', err);
+            }
+            if (acked) {
+                await store.deleteRetryState(eventId);
+                return;
+            }
+            if (currentAttempt >= policy.maxAttempts) {
+                await store.deleteRetryState(eventId);
+                return;
+            }
+            await store.setRetryState(eventId, { attempts: currentAttempt });
+            const delay = computeBackoff(currentAttempt, policy);
+            scheduleRetry(() => {
+                void runAttempt(currentAttempt + 1);
+            }, delay);
+        };
+        await runAttempt(attempt);
+    }
+    return {
+        async deliver(options) {
+            const { eventId, delivery, retryPolicy, deduplicationWindow, execute, } = options;
+            if (delivery === 'best-effort') {
+                await deliverBestEffort(execute);
+                return;
+            }
+            if (delivery === 'at-most-once') {
+                await deliverAtMostOnce(eventId, execute, deduplicationWindow ?? defaultDedupWindow);
+                return;
+            }
+            await deliverAtLeastOnce(eventId, execute, retryPolicy ?? defaultRetryPolicy);
+        },
+        stop() {
+            for (const timer of timers) {
+                clearTimeout(timer);
+            }
+            timers.clear();
+        },
+    };
+}
+//# sourceMappingURL=event-delivery.js.map

package/dist/core/event-delivery.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { createRegistry } from './registry.js';
+export type { Registry, ProcedureOptions, StreamOptions, EventOptions } from './registry.js';
+export { createRouter, RaffelError } from './router.js';
+export type { Router, RouterOptions, RouterResult } from './router.js';
+export { createEventDeliveryEngine, createInMemoryEventDeliveryStore, } from './event-delivery.js';
+export type { EventDeliveryOptions, EventDeliveryStore, EventDeliveryEngine, } from './event-delivery.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGtE,OAAO,EACL,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+// Registry
+export { createRegistry } from './registry.js';
+// Router
+export { createRouter, RaffelError } from './router.js';
+// Event delivery
+export { createEventDeliveryEngine, createInMemoryEventDeliveryStore, } from './event-delivery.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGvD,iBAAiB;AACjB,OAAO,EACL,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,qBAAqB,CAAA"}

package/dist/core/registry.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Registry - Handler Registration
+ *
+ * Stores and retrieves handlers for procedures, streams, and events.
+ * Provides introspection for adapters to generate schemas/routes.
+ */
+import type { ProcedureHandler, StreamHandler, EventHandler, HandlerMeta, RegisteredHandler, Interceptor, DeliveryGuarantee, RetryPolicy, StreamDirection, GraphQLMeta, HttpMethod, JsonRpcMeta, GrpcMeta } from '../types/handlers.js';
+/**
+ * Procedure registration options
+ */
+export interface ProcedureOptions {
+    summary?: string;
+    description?: string;
+    /** Tags for OpenAPI grouping */
+    tags?: string[];
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    graphql?: GraphQLMeta;
+    httpPath?: string;
+    httpMethod?: HttpMethod;
+    jsonrpc?: JsonRpcMeta;
+    grpc?: GrpcMeta;
+    interceptors?: Interceptor[];
+}
+/**
+ * Stream registration options
+ */
+export interface StreamOptions {
+    description?: string;
+    direction?: StreamDirection;
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    interceptors?: Interceptor[];
+}
+/**
+ * Event registration options
+ */
+export interface EventOptions {
+    description?: string;
+    delivery?: DeliveryGuarantee;
+    retryPolicy?: RetryPolicy;
+    deduplicationWindow?: number;
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    interceptors?: Interceptor[];
+}
+/**
+ * Registry interface
+ */
+export interface Registry {
+    /** Register a procedure handler */
+    procedure<TInput, TOutput>(name: string, handler: ProcedureHandler<TInput, TOutput>, options?: ProcedureOptions): void;
+    /** Register a stream handler */
+    stream<TInput, TOutput>(name: string, handler: StreamHandler<TInput, TOutput>, options?: StreamOptions): void;
+    /** Register an event handler */
+    event<TPayload>(name: string, handler: EventHandler<TPayload>, options?: EventOptions): void;
+    /** Get a procedure handler by name */
+    getProcedure(name: string): RegisteredHandler<ProcedureHandler> | undefined;
+    /** Get a stream handler by name */
+    getStream(name: string): RegisteredHandler<StreamHandler> | undefined;
+    /** Get an event handler by name */
+    getEvent(name: string): RegisteredHandler<EventHandler> | undefined;
+    /** Check if a handler exists */
+    has(name: string): boolean;
+    /** List all registered handlers */
+    list(): HandlerMeta[];
+    /** List procedures only */
+    listProcedures(): HandlerMeta[];
+    /** List streams only */
+    listStreams(): HandlerMeta[];
+    /** List events only */
+    listEvents(): HandlerMeta[];
+}
+/**
+ * Create a new Registry
+ */
+export declare function createRegistry(): Registry;
+//# sourceMappingURL=registry.d.ts.map

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

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