@clamator/over-redis 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+# @clamator/over-redis
+
+Redis-streams transport for [clamator](https://www.npmjs.com/package/@clamator/protocol). Implements the `Transport` interface from `@clamator/protocol` so JSON-RPC traffic flows over Redis streams between processes — typically a TS service and a Py service, or two TS services on different hosts.
+
+## Install
+
+```bash
+npm install @clamator/over-redis @clamator/protocol ioredis
+```
+
+## Quickstart
+
+Define the contract in TypeScript:
+
+```typescript
+// contracts/arith.ts
+import { z } from 'zod';
+import { defineContract, defineMethod, defineNotification } from '@clamator/protocol';
+
+export const arithContract = defineContract('arith', {
+  add: defineMethod({
+    params: z.object({ a: z.number(), b: z.number() }),
+    result: z.object({ sum: z.number() }),
+  }),
+  ping: defineNotification({ params: z.object({}) }),
+});
+```
+
+Run [`@clamator/codegen`](https://www.npmjs.com/package/@clamator/codegen) to emit a typed client and a service interface from that contract:
+
+```bash
+npx @clamator/codegen --src contracts --out-ts generated --ts-contract-import '../contracts/arith.js'
+```
+
+Server — implement the generated `ArithService` interface:
+
+```typescript
+// server.ts
+import { RedisRpcServer } from '@clamator/over-redis';
+import { arithContract } from './contracts/arith.js';
+import type { ArithService } from './generated/arith.js';
+
+const handlers: ArithService = {
+  add: async ({ a, b }) => ({ sum: a + b }),
+  ping: async () => {},
+};
+
+const server = new RedisRpcServer({ keyPrefix: 'my-app' });
+server.registerService(arithContract, handlers);
+await server.start();
+process.on('SIGTERM', () => { void server.stop(); });
+```
+
+Client — call methods on the generated `ArithClient`:
+
+```typescript
+// client.ts
+import { RedisRpcClient } from '@clamator/over-redis';
+import { ArithClient } from './generated/arith.js';
+
+const transport = new RedisRpcClient({ keyPrefix: 'my-app' });
+await transport.start();
+
+const arith = new ArithClient(transport);
+const result = await arith.add({ a: 2, b: 3 });
+console.log(result); // { sum: 5 }
+
+await transport.stop();
+```
+
+By default the connection is built from `$REDIS_URL` (or `redis://localhost:6379`). Pass `redisUrl` for a different URL, or `redis` for a pre-built `ioredis` instance.
+
+## Key surface
+
+- `RedisRpcServer({ keyPrefix, redis?, redisUrl?, ... })` — `registerService(contract, handlers)`, `start()`, `stop()`.
+- `RedisRpcClient({ keyPrefix, redis?, redisUrl?, defaultTimeoutMs? })` — `start()`, `stop()`. The instance is also a `ClamatorClient`, so it can be wrapped by a generated `*Client` proxy.
+
+## When to reach for this vs. `@clamator/over-memory`
+
+- [`@clamator/over-memory`](https://www.npmjs.com/package/@clamator/over-memory) — tests, embedded scenarios, anything single-process.
+- `@clamator/over-redis` — cross-process, cross-host, durable streams, production.
+
+## Links
+
+- Sibling (Python): [`clamator-over-redis`](https://pypi.org/project/clamator-over-redis/)
+- Codegen: [`@clamator/codegen`](https://www.npmjs.com/package/@clamator/codegen)
+- Design spec: [`docs/2026-05-07-clamator-design.md`](../../../docs/2026-05-07-clamator-design.md)
+- Agent rules: [`AGENTS.md`](./AGENTS.md)

package/dist/backoff.d.ts

@@ -0,0 +1,12 @@
+export interface BackoffOptions {
+    initialMs: number;
+    maxMs: number;
+    factor?: number;
+    jitter?: boolean;
+}
+export declare function expBackoff(opts: BackoffOptions): () => number;
+export declare function resetable(opts: BackoffOptions): {
+    next: () => number;
+    reset: () => void;
+};
+//# sourceMappingURL=backoff.d.ts.map

package/dist/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,MAAM,CAS7D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAMzF"}

package/dist/backoff.js

@@ -0,0 +1,19 @@
+export function expBackoff(opts) {
+    const factor = opts.factor ?? 2;
+    let current = opts.initialMs;
+    return () => {
+        const value = current;
+        current = Math.min(opts.maxMs, current * factor);
+        if (opts.jitter ?? true)
+            return Math.floor(value * (0.5 + Math.random() * 0.5));
+        return value;
+    };
+}
+export function resetable(opts) {
+    let next = expBackoff(opts);
+    return {
+        next: () => next(),
+        reset: () => { next = expBackoff(opts); },
+    };
+}
+//# sourceMappingURL=backoff.js.map

package/dist/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAoB;IAC5C,IAAI,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/client-transport.d.ts

@@ -0,0 +1,31 @@
+import { type Redis } from 'ioredis';
+import { type Transport, type SendOptions, type Dispatcher } from '@clamator/protocol';
+export interface ClientTransportOptions {
+    /** Existing ioredis instance. Mutually exclusive with `redisUrl`. */
+    redis?: Redis;
+    /** Redis URL. If neither `redis` nor `redisUrl` is provided, falls back to `process.env.REDIS_URL` then `redis://localhost:6379`. */
+    redisUrl?: string;
+    keyPrefix: string;
+    instanceId?: string;
+    defaultTimeoutMs?: number;
+}
+export declare class ClientRedisTransport implements Transport {
+    readonly instanceId: string;
+    private readonly redis;
+    private readonly ownsRedis;
+    private readonly keyPrefix;
+    private readonly replyStream;
+    private state;
+    private pending;
+    private replyLoop;
+    private replyLoopAbort;
+    private replyRedis;
+    constructor(opts: ClientTransportOptions);
+    registerService(_name: string, _dispatch: Dispatcher): Promise<void>;
+    send(env: Record<string, unknown>, sendOpts: SendOptions): Promise<Record<string, unknown>>;
+    notify(env: Record<string, unknown>): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private runReplyLoop;
+}
+//# sourceMappingURL=client-transport.d.ts.map

package/dist/client-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-transport.d.ts","sourceRoot":"","sources":["../src/client-transport.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAEL,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAClD,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qIAAqI;IACrI,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,qBAAa,oBAAqB,YAAW,SAAS;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,UAAU,CAAsB;gBAE5B,IAAI,EAAE,sBAAsB;IAgBlC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA6B3F,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAoBb,YAAY;CAgC3B"}

package/dist/client-transport.js

@@ -0,0 +1,162 @@
+import { randomUUID } from 'node:crypto';
+import IORedis, {} from 'ioredis';
+import { parseEnvelope, EnvelopeKind, ClamatorTransportError, } from '@clamator/protocol';
+import { commandStream, replyStream } from './keys.js';
+export class ClientRedisTransport {
+    instanceId;
+    redis;
+    ownsRedis;
+    keyPrefix;
+    replyStream;
+    state = 'idle';
+    pending = new Map();
+    replyLoop = null;
+    replyLoopAbort = false;
+    // Dedicated connection for the blocking XREAD reply loop, so that
+    // xadd calls in send() are not queued behind the blocking read.
+    replyRedis = null;
+    constructor(opts) {
+        if (opts.redis && opts.redisUrl)
+            throw new ClamatorTransportError('provide either `redis` or `redisUrl`, not both');
+        if (opts.redis) {
+            this.redis = opts.redis;
+            this.ownsRedis = false;
+        }
+        else {
+            const url = opts.redisUrl ?? process.env.REDIS_URL ?? 'redis://localhost:6379';
+            this.redis = new IORedis(url);
+            this.ownsRedis = true;
+        }
+        this.keyPrefix = opts.keyPrefix;
+        this.instanceId = opts.instanceId ?? randomUUID();
+        this.replyStream = replyStream(opts.keyPrefix, this.instanceId);
+    }
+    async registerService(_name, _dispatch) {
+        throw new Error('client transport cannot host services');
+    }
+    async send(env, sendOpts) {
+        if (this.state !== 'started')
+            throw new ClamatorTransportError(`transport not started (state=${this.state})`);
+        const parsed = parseEnvelope(env);
+        if (parsed.kind !== EnvelopeKind.Request)
+            throw new ClamatorTransportError('send requires a request envelope');
+        const idStr = String(parsed.id);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(idStr);
+                reject(new ClamatorTransportError('call timeout'));
+            }, sendOpts.timeoutMs);
+            this.pending.set(idStr, { resolve, reject, timer });
+            void this.redis.xadd(commandStream(this.keyPrefix, parsed.service), '*', 'type', 'rpc', 'envelope', JSON.stringify(env), 'reply-to', this.replyStream).catch(err => {
+                const p = this.pending.get(idStr);
+                if (!p)
+                    return;
+                this.pending.delete(idStr);
+                clearTimeout(p.timer);
+                p.reject(new ClamatorTransportError('xadd failed', err));
+            });
+        });
+    }
+    async notify(env) {
+        if (this.state !== 'started')
+            throw new ClamatorTransportError(`transport not started (state=${this.state})`);
+        const parsed = parseEnvelope(env);
+        if (parsed.kind !== EnvelopeKind.Notification)
+            throw new ClamatorTransportError('notify requires a notification envelope');
+        await this.redis.xadd(commandStream(this.keyPrefix, parsed.service), '*', 'type', 'rpc', 'envelope', JSON.stringify(env));
+    }
+    async start() {
+        if (this.state === 'stopped')
+            throw new ClamatorTransportError('transport has been stopped');
+        if (this.state === 'started')
+            return;
+        this.state = 'started';
+        this.replyLoopAbort = false;
+        // Use a dedicated duplicate connection for the blocking XREAD so that
+        // xadd commands in send() are not queued behind the blocking read.
+        this.replyRedis = this.redis.duplicate();
+        this.replyLoop = this.runReplyLoop().catch(err => {
+            // surface fatal loop errors
+            console.error('[clamator/over-redis] reply loop fatal:', err);
+        });
+    }
+    async stop() {
+        if (this.state !== 'started') {
+            this.state = 'stopped';
+            return;
+        }
+        this.replyLoopAbort = true;
+        // Disconnect the reply connection to unblock the XREAD immediately.
+        try {
+            this.replyRedis?.disconnect();
+        }
+        catch { /* ignore */ }
+        try {
+            await this.replyLoop;
+        }
+        catch { /* ignore */ }
+        for (const [id, p] of this.pending.entries()) {
+            clearTimeout(p.timer);
+            p.reject(new ClamatorTransportError('transport stopped'));
+            this.pending.delete(id);
+        }
+        try {
+            await this.redis.del(this.replyStream);
+        }
+        catch { /* best effort */ }
+        try {
+            await this.replyRedis?.quit();
+        }
+        catch { /* best effort */ }
+        this.replyRedis = null;
+        if (this.ownsRedis) {
+            try {
+                await this.redis.quit();
+            }
+            catch { /* best effort */ }
+        }
+        this.state = 'stopped';
+    }
+    async runReplyLoop() {
+        // Use '0-0' rather than '$' so replies are never missed between iterations.
+        // The reply stream is unique per client instance, so reading from the
+        // beginning is always correct and safe.
+        let lastId = '0-0';
+        while (!this.replyLoopAbort) {
+            try {
+                const result = await this.replyRedis.xread('BLOCK', 1000, 'STREAMS', this.replyStream, lastId);
+                if (!result)
+                    continue;
+                for (const [, entries] of result) {
+                    for (const [entryId, fields] of entries) {
+                        lastId = entryId;
+                        const idx = fields.indexOf('envelope');
+                        if (idx < 0)
+                            continue;
+                        const json = fields[idx + 1] ?? '';
+                        let parsed;
+                        try {
+                            parsed = JSON.parse(json);
+                        }
+                        catch {
+                            continue;
+                        }
+                        const replyId = String(parsed.id);
+                        const pending = this.pending.get(replyId);
+                        if (!pending)
+                            continue; // late or stranger reply
+                        this.pending.delete(replyId);
+                        clearTimeout(pending.timer);
+                        pending.resolve(parsed);
+                    }
+                }
+            }
+            catch (err) {
+                if (this.replyLoopAbort)
+                    return;
+                await new Promise(r => setTimeout(r, 100));
+            }
+        }
+    }
+}
+//# sourceMappingURL=client-transport.js.map

package/dist/client-transport.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import { RpcClientCore } from '@clamator/protocol';
+import { type ClientTransportOptions } from './client-transport.js';
+export interface RedisRpcClientOptions extends ClientTransportOptions {
+}
+export declare class RedisRpcClient extends RpcClientCore {
+    constructor(opts: RedisRpcClientOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;CAAG;AAExE,qBAAa,cAAe,SAAQ,aAAa;gBACnC,IAAI,EAAE,qBAAqB;CAMxC"}

package/dist/client.js

@@ -0,0 +1,8 @@
+import { RpcClientCore } from '@clamator/protocol';
+import { ClientRedisTransport } from './client-transport.js';
+export class RedisRpcClient extends RpcClientCore {
+    constructor(opts) {
+        super(new ClientRedisTransport(opts), { defaultTimeoutMs: opts.defaultTimeoutMs ?? 30_000 });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA+B,MAAM,uBAAuB,CAAC;AAI1F,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,YAAY,IAA2B;QACrC,KAAK,CACH,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAC9B,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,MAAM,EAAE,CACtD,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { RedisRpcServer, type RedisRpcServerOptions } from './server.js';
+export { RedisRpcClient, type RedisRpcClientOptions } from './client.js';
+export { ServerRedisTransport } from './server-transport.js';
+export { ClientRedisTransport } from './client-transport.js';
+export * from './keys.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { RedisRpcServer } from './server.js';
+export { RedisRpcClient } from './client.js';
+export { ServerRedisTransport } from './server-transport.js';
+export { ClientRedisTransport } from './client-transport.js';
+export * from './keys.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,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,cAAc,WAAW,CAAC"}

package/dist/keys.d.ts

@@ -0,0 +1,5 @@
+export declare function commandStream(prefix: string, service: string): string;
+export declare function replyStream(prefix: string, instanceId: string): string;
+export declare function consumerGroupName(service: string): string;
+export declare function consumerName(service: string, instanceId: string): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/keys.js

@@ -0,0 +1,13 @@
+export function commandStream(prefix, service) {
+    return `${prefix}:cmds:${service}`;
+}
+export function replyStream(prefix, instanceId) {
+    return `${prefix}:replies:${instanceId}`;
+}
+export function consumerGroupName(service) {
+    return service;
+}
+export function consumerName(service, instanceId) {
+    return `${service}:${instanceId}`;
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe;IAC3D,OAAO,GAAG,MAAM,SAAS,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,UAAkB;IAC5D,OAAO,GAAG,MAAM,YAAY,UAAU,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,UAAkB;IAC9D,OAAO,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;AACpC,CAAC"}

package/dist/server-transport.d.ts

@@ -0,0 +1,39 @@
+import { type Redis } from 'ioredis';
+import { type Transport, type Dispatcher } from '@clamator/protocol';
+export interface ServerTransportOptions {
+    /** Existing ioredis instance. Mutually exclusive with `redisUrl`. */
+    redis?: Redis;
+    /** Redis URL. If neither `redis` nor `redisUrl` is provided, falls back to `process.env.REDIS_URL` then `redis://localhost:6379`. */
+    redisUrl?: string;
+    keyPrefix: string;
+    instanceId?: string;
+    consumerClaimIdleMs?: number;
+    replyStreamMaxLen?: number;
+    shutdownGraceMs?: number;
+}
+export declare class ServerRedisTransport implements Transport {
+    readonly instanceId: string;
+    private dispatchers;
+    private state;
+    private loops;
+    private abort;
+    private reclaimWakers;
+    private blockingConns;
+    private readonly redis;
+    private readonly ownsRedis;
+    private readonly keyPrefix;
+    private readonly replyStreamMaxLen;
+    private readonly consumerClaimIdleMs;
+    private readonly shutdownGraceMs;
+    constructor(opts: ServerTransportOptions);
+    registerService(name: string, dispatch: Dispatcher): Promise<void>;
+    send(): Promise<Record<string, unknown>>;
+    notify(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private runConsumerLoop;
+    private interruptibleSleep;
+    private runReclaimLoop;
+    private handleEntry;
+}
+//# sourceMappingURL=server-transport.d.ts.map

package/dist/server-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-transport.d.ts","sourceRoot":"","sources":["../src/server-transport.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAEL,KAAK,SAAS,EAAE,KAAK,UAAU,EAChC,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qIAAqI;IACrI,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,oBAAqB,YAAW,SAAS;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAA8B;IAInD,OAAO,CAAC,aAAa,CAAe;IAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,IAAI,EAAE,sBAAsB;IAkBlC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIxC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA0Bb,eAAe;IAuB7B,OAAO,CAAC,kBAAkB;YAQZ,cAAc;YAuBd,WAAW;CA6B1B"}

package/dist/server-transport.js

@@ -0,0 +1,202 @@
+import { randomUUID } from 'node:crypto';
+import IORedis, {} from 'ioredis';
+import { parseEnvelope, EnvelopeKind, ClamatorTransportError, } from '@clamator/protocol';
+import { commandStream, consumerGroupName, consumerName } from './keys.js';
+export class ServerRedisTransport {
+    instanceId;
+    dispatchers = new Map();
+    state = 'idle';
+    loops = [];
+    abort = false;
+    reclaimWakers = new Set();
+    // Dedicated connection per service for the blocking XREADGROUP call so that
+    // xadd (reply), xack, and xautoclaim on the main connection are never
+    // queued behind the blocking read.
+    blockingConns = [];
+    redis;
+    ownsRedis;
+    keyPrefix;
+    replyStreamMaxLen;
+    consumerClaimIdleMs;
+    shutdownGraceMs;
+    constructor(opts) {
+        if (opts.redis && opts.redisUrl)
+            throw new ClamatorTransportError('provide either `redis` or `redisUrl`, not both');
+        if (opts.redis) {
+            this.redis = opts.redis;
+            this.ownsRedis = false;
+        }
+        else {
+            const url = opts.redisUrl ?? process.env.REDIS_URL ?? 'redis://localhost:6379';
+            this.redis = new IORedis(url);
+            this.ownsRedis = true;
+        }
+        this.keyPrefix = opts.keyPrefix;
+        this.instanceId = opts.instanceId ?? randomUUID();
+        this.replyStreamMaxLen = opts.replyStreamMaxLen ?? 1024;
+        this.consumerClaimIdleMs = opts.consumerClaimIdleMs ?? 60_000;
+        this.shutdownGraceMs = opts.shutdownGraceMs ?? 5_000;
+    }
+    async registerService(name, dispatch) {
+        this.dispatchers.set(name, dispatch);
+    }
+    async send() {
+        throw new Error('server transport cannot send requests');
+    }
+    async notify() {
+        throw new Error('server transport cannot send notifications');
+    }
+    async start() {
+        if (this.state === 'stopped')
+            throw new ClamatorTransportError('transport has been stopped');
+        if (this.state === 'started')
+            return;
+        this.state = 'started';
+        this.abort = false;
+        for (const service of this.dispatchers.keys()) {
+            const stream = commandStream(this.keyPrefix, service);
+            const group = consumerGroupName(service);
+            try {
+                await this.redis.xgroup('CREATE', stream, group, '$', 'MKSTREAM');
+            }
+            catch (e) {
+                const msg = e.message;
+                if (!msg.includes('BUSYGROUP'))
+                    throw e;
+            }
+            // Dedicated connection for blocking XREADGROUP so the main connection
+            // stays free for non-blocking operations (xadd, xack, xautoclaim).
+            const blockingRedis = this.redis.duplicate();
+            this.blockingConns.push(blockingRedis);
+            this.loops.push(this.runConsumerLoop(service, blockingRedis));
+            this.loops.push(this.runReclaimLoop(service));
+        }
+    }
+    async stop() {
+        if (this.state !== 'started') {
+            this.state = 'stopped';
+            return;
+        }
+        this.abort = true;
+        // Wake up any sleeping reclaim loops so they can check abort and exit promptly.
+        for (const wake of this.reclaimWakers)
+            wake();
+        this.reclaimWakers.clear();
+        // Disconnect blocking connections to unblock XREADGROUP immediately.
+        for (const conn of this.blockingConns) {
+            try {
+                conn.disconnect();
+            }
+            catch { /* ignore */ }
+        }
+        const grace = this.shutdownGraceMs;
+        await Promise.race([
+            Promise.allSettled(this.loops),
+            new Promise(r => setTimeout(r, grace)),
+        ]);
+        // Clean up dedicated blocking connections.
+        for (const conn of this.blockingConns) {
+            try {
+                await conn.quit();
+            }
+            catch { /* best effort */ }
+        }
+        this.blockingConns = [];
+        if (this.ownsRedis) {
+            try {
+                await this.redis.quit();
+            }
+            catch { /* best effort */ }
+        }
+        this.state = 'stopped';
+    }
+    async runConsumerLoop(service, blockingRedis) {
+        const stream = commandStream(this.keyPrefix, service);
+        const group = consumerGroupName(service);
+        const consumer = consumerName(service, this.instanceId);
+        while (!this.abort) {
+            try {
+                const result = await blockingRedis.xreadgroup('GROUP', group, consumer, 'COUNT', 16, 'BLOCK', 1000, 'STREAMS', stream, '>');
+                if (!result)
+                    continue;
+                for (const [, entries] of result) {
+                    for (const [entryId, fields] of entries) {
+                        await this.handleEntry(service, stream, group, entryId, fields);
+                    }
+                }
+            }
+            catch (err) {
+                if (this.abort)
+                    return;
+                await new Promise(r => setTimeout(r, 100));
+            }
+        }
+    }
+    interruptibleSleep(ms) {
+        return new Promise(resolve => {
+            const timer = setTimeout(() => { this.reclaimWakers.delete(wake); resolve(); }, ms);
+            const wake = () => { clearTimeout(timer); this.reclaimWakers.delete(wake); resolve(); };
+            this.reclaimWakers.add(wake);
+        });
+    }
+    async runReclaimLoop(service) {
+        const stream = commandStream(this.keyPrefix, service);
+        const group = consumerGroupName(service);
+        const consumer = consumerName(service, this.instanceId);
+        const idleThreshold = this.consumerClaimIdleMs;
+        while (!this.abort) {
+            try {
+                await this.interruptibleSleep(Math.max(1000, idleThreshold / 4));
+                if (this.abort)
+                    return;
+                const claimed = await this.redis.xautoclaim(stream, group, consumer, idleThreshold, '0', 'COUNT', 32);
+                const entries = claimed[1];
+                if (!entries || entries.length === 0)
+                    continue;
+                for (const [entryId, fields] of entries) {
+                    await this.handleEntry(service, stream, group, entryId, fields);
+                }
+            }
+            catch (err) {
+                if (this.abort)
+                    return;
+            }
+        }
+    }
+    async handleEntry(service, stream, group, entryId, fields) {
+        const envIdx = fields.indexOf('envelope');
+        if (envIdx < 0) {
+            await this.redis.xack(stream, group, entryId);
+            return;
+        }
+        const replyToIdx = fields.indexOf('reply-to');
+        const replyTo = replyToIdx >= 0 ? fields[replyToIdx + 1] : null;
+        let envObj;
+        try {
+            envObj = JSON.parse(fields[envIdx + 1] ?? '');
+        }
+        catch {
+            await this.redis.xack(stream, group, entryId);
+            return;
+        }
+        let parsed;
+        try {
+            parsed = parseEnvelope(envObj);
+        }
+        catch {
+            await this.redis.xack(stream, group, entryId);
+            return;
+        }
+        const dispatcher = this.dispatchers.get(service);
+        if (!dispatcher) {
+            await this.redis.xack(stream, group, entryId);
+            return;
+        }
+        const reply = await dispatcher(parsed);
+        if (replyTo && reply) {
+            await this.redis.xadd(replyTo, 'MAXLEN', '~', String(this.replyStreamMaxLen), '*', 'type', 'rpc', 'envelope', JSON.stringify(reply));
+        }
+        await this.redis.xack(stream, group, entryId);
+    }
+}
+//# sourceMappingURL=server-transport.js.map

package/dist/server-transport.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import { RpcServerCore } from '@clamator/protocol';
+import { type ServerTransportOptions } from './server-transport.js';
+export interface RedisRpcServerOptions extends ServerTransportOptions {
+}
+export declare class RedisRpcServer extends RpcServerCore {
+    constructor(opts: RedisRpcServerOptions);
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;CAAG;AAExE,qBAAa,cAAe,SAAQ,aAAa;gBACnC,IAAI,EAAE,qBAAqB;CAGxC"}

package/dist/server.js

@@ -0,0 +1,8 @@
+import { RpcServerCore } from '@clamator/protocol';
+import { ServerRedisTransport } from './server-transport.js';
+export class RedisRpcServer extends RpcServerCore {
+    constructor(opts) {
+        super(new ServerRedisTransport(opts));
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA+B,MAAM,uBAAuB,CAAC;AAI1F,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,YAAY,IAA2B;QACrC,KAAK,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@clamator/over-redis",
+  "version": "0.1.0",
+  "description": "Redis-streams transport for clamator (pre-1.0).",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ioredis": "^5.4.0",
+    "@clamator/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}