@gonzih/cc-wire 0.2.0 → 0.3.0

package/README.md

@@ -1,13 +1,15 @@
 # @gonzih/cc-wire
 
-Single source of truth for Redis channel names, key patterns, and message shapes across the cc-suite (`cc-agent`, `cc-discord`, `cc-tg`, `cc-agent-ui`).
+Single source of truth for Redis channel names, key patterns, message shapes, and
+storage runtime across the cc-suite (`cc-agent`, `cc-discord`, `cc-tg`, `cc-agent-ui`).
 
-No runtime dependencies. No Redis client. Just constants, builders, and types.
+v0.3.0+: ships a typed storage runtime — services call `createCcWire(redis)` and
+never touch raw Redis or import key builders directly.
 
 ## Install
 
 ```sh
-npm install @gonzih/cc-wire
+npm install @gonzih/cc-wire ioredis
 ```
 
 ## Architecture — Service Ownership
@@ -39,7 +41,53 @@ npm install @gonzih/cc-wire
 no sessions, and no state. cc-agent is a pure job runner; it no longer manages meta-agent
 lifecycle.
 
-## Usage
+## Runtime — `createCcWire(redis)`
+
+Pass an [ioredis](https://github.com/redis/ioredis) `Redis` instance and get back
+fully-typed storage APIs per service. No raw Redis commands, no key string management.
+
+```typescript
+import { createClient } from "ioredis";
+import { createCcWire } from "@gonzih/cc-wire";
+
+const redis = new Redis(process.env.REDIS_URL);
+const wire = createCcWire(redis);
+
+// cc-discord: per-namespace session management
+await wire.discord.enqueue("simorgh", { id: "...", source: "discord", ... });
+const msg = await wire.discord.dequeue("simorgh");                    // ChatMessage | null
+await wire.discord.publishOutgoing("simorgh", msg);                   // PUBLISH + log + LTRIM
+wire.discord.subscribeOutgoing("simorgh", (msg) => console.log(msg)); // live stream
+await wire.discord.setStatus("simorgh", { isTyping: true, ... });
+const status = await wire.discord.getStatus("simorgh");               // MetaAgentStatus | null
+await wire.discord.writeChatLog("simorgh", msg);
+const history = await wire.discord.getChatLog("simorgh", 50);         // chronological
+await wire.discord.notify("simorgh", { text: "job done" });
+const notif = await wire.discord.pollNotify("simorgh");               // NotificationPayload | null
+await wire.discord.registerChannel("1234567890", "simorgh", repoUrl);
+const chan = await wire.discord.getChannel("1234567890");
+const channels = await wire.discord.listChannels();
+
+// cc-tg: single money-brain session
+await wire.tg.publishOutgoing(msg);
+wire.tg.subscribeOutgoing((msg) => console.log(msg));
+await wire.tg.notify({ text: "job done" });
+const tgNotif = await wire.tg.pollNotify();
+
+// cc-agent: job queue
+await wire.jobs.enqueue({ id: "job-001", repoUrl: "...", task: "..." });
+const job = await wire.jobs.getStatus("job-001");
+await wire.jobs.publishDone("job-001", { status: "done", score: 1.0 });
+
+// shared master token
+await wire.token.setMaster("my-token");
+const token = await wire.token.getMaster();
+
+// raw redis escape hatch (migration only)
+const raw = wire._redis;
+```
+
+## Key builders (v0.2.x compat, use runtime in new code)
 
 ```typescript
 import {
@@ -241,8 +289,10 @@ The deprecated exports remain in v0.2.x for migration; they will be removed in v
 ## Development
 
 ```sh
-npm run build   # compile ESM + CJS
-npm test        # run tests (Node built-in test runner via tsx)
+npm run build          # compile ESM + CJS
+npm test               # run all tests (channels: node --test; runtime: vitest)
+npm run test:channels  # key builder tests only (node --test + tsx)
+npm run test:runtime   # runtime tests only (vitest + ioredis-mock)
 ```
 
 ## License

package/dist/cjs/index.cjs

@@ -24,3 +24,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./channels.cjs"), exports);
 __exportStar(require("./types.cjs"), exports);
+__exportStar(require("./runtime.cjs"), exports);

package/dist/cjs/runtime.cjs

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCcWire = createCcWire;
+const channels_js_1 = require("./channels.cjs");
+// ─── Private key helpers (not exported) ──────────────────────────────────────
+const channelHashKey = (channelId) => `cca:discord:channel:${channelId}`;
+const CHANNELS_SET = "cca:discord:channels:index";
+const discordNotifyLogKey = (ns) => `cca:discord:notify-log:${ns}`;
+const TG_NOTIFY_LOG = "cca:tg:notify-log";
+const SPAWN_QUEUE = "cca:spawn:queue";
+const MASTER_TOKEN_KEY = "cca:token:master";
+// ─── Factory ──────────────────────────────────────────────────────────────────
+function createCcWire(redis) {
+    return {
+        // ── discord ──────────────────────────────────────────────────────────────
+        discord: {
+            async enqueue(ns, msg) {
+                await redis.rpush((0, channels_js_1.discordMetaInputKey)(ns), JSON.stringify(msg));
+            },
+            async dequeue(ns) {
+                const val = await redis.rpop((0, channels_js_1.discordMetaInputKey)(ns));
+                return val ? JSON.parse(val) : null;
+            },
+            async publishOutgoing(ns, msg) {
+                const json = JSON.stringify(msg);
+                const pl = redis.pipeline();
+                pl.publish((0, channels_js_1.discordChatOutgoing)(ns), json);
+                pl.lpush((0, channels_js_1.discordChatLog)(ns), json);
+                pl.ltrim((0, channels_js_1.discordChatLog)(ns), 0, channels_js_1.CAP.CHAT_LOG - 1);
+                await pl.exec();
+            },
+            subscribeOutgoing(ns, cb) {
+                const sub = redis.duplicate();
+                sub.subscribe((0, channels_js_1.discordChatOutgoing)(ns));
+                sub.on("message", (channel, message) => {
+                    if (channel === (0, channels_js_1.discordChatOutgoing)(ns)) {
+                        cb(JSON.parse(message));
+                    }
+                });
+            },
+            async setStatus(ns, status) {
+                await redis.set((0, channels_js_1.discordMetaStatusKey)(ns), JSON.stringify(status), "EX", channels_js_1.TTL.JOB_SECONDS);
+            },
+            async getStatus(ns) {
+                const val = await redis.get((0, channels_js_1.discordMetaStatusKey)(ns));
+                return val ? JSON.parse(val) : null;
+            },
+            async writeChatLog(ns, msg) {
+                const pl = redis.pipeline();
+                pl.lpush((0, channels_js_1.discordChatLog)(ns), JSON.stringify(msg));
+                pl.ltrim((0, channels_js_1.discordChatLog)(ns), 0, channels_js_1.CAP.CHAT_LOG - 1);
+                await pl.exec();
+            },
+            async getChatLog(ns, limit = 50) {
+                const items = await redis.lrange((0, channels_js_1.discordChatLog)(ns), 0, limit - 1);
+                return items
+                    .map((i) => JSON.parse(i))
+                    .reverse();
+            },
+            async notify(ns, payload) {
+                const json = JSON.stringify(payload);
+                const pl = redis.pipeline();
+                pl.publish((0, channels_js_1.discordNotify)(ns), json);
+                pl.rpush((0, channels_js_1.discordNotify)(ns), json);
+                pl.lpush(discordNotifyLogKey(ns), json);
+                pl.ltrim(discordNotifyLogKey(ns), 0, channels_js_1.CAP.NOTIFY_LOG - 1);
+                await pl.exec();
+            },
+            async pollNotify(ns) {
+                const val = await redis.rpop((0, channels_js_1.discordNotify)(ns));
+                return val ? JSON.parse(val) : null;
+            },
+            async registerChannel(channelId, ns, repoUrl) {
+                const pl = redis.pipeline();
+                pl.hset(channelHashKey(channelId), { namespace: ns, repoUrl });
+                pl.sadd(CHANNELS_SET, channelId);
+                await pl.exec();
+            },
+            async getChannel(channelId) {
+                const data = await redis.hgetall(channelHashKey(channelId));
+                if (!data || !data["namespace"])
+                    return null;
+                return { namespace: data["namespace"], repoUrl: data["repoUrl"] ?? "" };
+            },
+            async listChannels() {
+                const ids = await redis.smembers(CHANNELS_SET);
+                const rows = await Promise.all(ids.map(async (channelId) => {
+                    const data = await redis.hgetall(channelHashKey(channelId));
+                    if (!data || !data["namespace"])
+                        return null;
+                    return {
+                        channelId,
+                        namespace: data["namespace"],
+                        repoUrl: data["repoUrl"] ?? "",
+                    };
+                }));
+                return rows.filter((r) => r !== null);
+            },
+        },
+        // ── tg ───────────────────────────────────────────────────────────────────
+        tg: {
+            async publishOutgoing(msg) {
+                const json = JSON.stringify(msg);
+                const pl = redis.pipeline();
+                pl.publish((0, channels_js_1.tgChatOutgoing)(), json);
+                pl.lpush("cca:tg:chat:log", json);
+                pl.ltrim("cca:tg:chat:log", 0, channels_js_1.CAP.CHAT_LOG - 1);
+                await pl.exec();
+            },
+            subscribeOutgoing(cb) {
+                const sub = redis.duplicate();
+                sub.subscribe((0, channels_js_1.tgChatOutgoing)());
+                sub.on("message", (_channel, message) => {
+                    cb(JSON.parse(message));
+                });
+            },
+            async notify(payload) {
+                const json = JSON.stringify(payload);
+                const pl = redis.pipeline();
+                pl.publish((0, channels_js_1.tgNotify)(), json);
+                pl.rpush((0, channels_js_1.tgNotify)(), json);
+                pl.lpush(TG_NOTIFY_LOG, json);
+                pl.ltrim(TG_NOTIFY_LOG, 0, channels_js_1.CAP.NOTIFY_LOG - 1);
+                await pl.exec();
+            },
+            async pollNotify() {
+                const val = await redis.rpop((0, channels_js_1.tgNotify)());
+                return val ? JSON.parse(val) : null;
+            },
+        },
+        // ── jobs ─────────────────────────────────────────────────────────────────
+        jobs: {
+            async enqueue(job) {
+                const pl = redis.pipeline();
+                pl.set((0, channels_js_1.jobKey)(job.id), JSON.stringify({ ...job, status: "pending" }), "EX", channels_js_1.TTL.JOB_SECONDS);
+                pl.lpush(SPAWN_QUEUE, JSON.stringify(job));
+                await pl.exec();
+            },
+            async getStatus(jobId) {
+                const val = await redis.get((0, channels_js_1.jobKey)(jobId));
+                return val ? JSON.parse(val) : null;
+            },
+            async publishDone(jobId, result) {
+                const json = JSON.stringify(result);
+                const pl = redis.pipeline();
+                pl.publish((0, channels_js_1.jobDoneChannel)(jobId), json);
+                pl.lpush((0, channels_js_1.jobDoneQueueKey)(jobId), json);
+                pl.expire((0, channels_js_1.jobDoneQueueKey)(jobId), channels_js_1.TTL.JOB_SECONDS);
+                await pl.exec();
+            },
+        },
+        // ── token ─────────────────────────────────────────────────────────────────
+        token: {
+            async getMaster() {
+                const val = await redis.get(MASTER_TOKEN_KEY);
+                if (val === null)
+                    throw new Error("cc-wire: master token not set");
+                return val;
+            },
+            async setMaster(token) {
+                await redis.set(MASTER_TOKEN_KEY, token);
+            },
+        },
+        _redis: redis,
+    };
+}

package/dist/esm/index.d.ts

@@ -8,4 +8,5 @@
  */
 export * from "./channels.js";
 export * from "./types.js";
+export * from "./runtime.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/esm/index.js

@@ -8,4 +8,5 @@
  */
 export * from "./channels.js";
 export * from "./types.js";
+export * from "./runtime.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/esm/runtime.d.ts

@@ -0,0 +1,90 @@
+/**
+ * cc-wire runtime — `createCcWire(redis)`
+ *
+ * The single entry point for all Redis I/O across the cc-suite.
+ * Services import this factory and call typed methods; they never
+ * write raw Redis commands or import key builders directly.
+ */
+import type { Redis } from "ioredis";
+import type { ChatMessage, MetaAgentStatus, NotificationPayload, SpawnParams } from "./types.js";
+export interface DiscordApi {
+    /** RPUSH message to the input queue for a namespace session. */
+    enqueue(ns: string, msg: ChatMessage): Promise<void>;
+    /** RPOP next message from the input queue; null when empty. */
+    dequeue(ns: string): Promise<ChatMessage | null>;
+    /**
+     * Pipeline: PUBLISH to outgoing channel + LPUSH to chat log + LTRIM.
+     * Subscribers on the channel receive the message live; the log persists it.
+     */
+    publishOutgoing(ns: string, msg: ChatMessage): Promise<void>;
+    /** Subscribe to outgoing messages for a namespace. Uses an internal duplicate connection. */
+    subscribeOutgoing(ns: string, cb: (msg: ChatMessage) => void): void;
+    /** SET session status with 7-day TTL. */
+    setStatus(ns: string, status: MetaAgentStatus): Promise<void>;
+    /** GET session status; null when key is absent or expired. */
+    getStatus(ns: string): Promise<MetaAgentStatus | null>;
+    /** LPUSH message to chat log + LTRIM to 500. */
+    writeChatLog(ns: string, msg: ChatMessage): Promise<void>;
+    /** LRANGE chat log, reversed to chronological order. Default limit 50. */
+    getChatLog(ns: string, limit?: number): Promise<ChatMessage[]>;
+    /** PUBLISH notify channel + RPUSH delivery list + log. */
+    notify(ns: string, payload: NotificationPayload): Promise<void>;
+    /** RPOP from notify delivery list; null when empty. */
+    pollNotify(ns: string): Promise<NotificationPayload | null>;
+    /** Register a Discord channel → namespace mapping. */
+    registerChannel(channelId: string, ns: string, repoUrl: string): Promise<void>;
+    /** Look up a channel registration; null if not found. */
+    getChannel(channelId: string): Promise<{
+        namespace: string;
+        repoUrl: string;
+    } | null>;
+    /** List all registered channel mappings. */
+    listChannels(): Promise<Array<{
+        channelId: string;
+        namespace: string;
+        repoUrl: string;
+    }>>;
+}
+export interface TgApi {
+    /** Pipeline: PUBLISH to outgoing channel + LPUSH log + LTRIM. */
+    publishOutgoing(msg: ChatMessage): Promise<void>;
+    /** Subscribe to outgoing messages. Uses an internal duplicate connection. */
+    subscribeOutgoing(cb: (msg: ChatMessage) => void): void;
+    /** PUBLISH notify channel + RPUSH delivery list + log. */
+    notify(payload: NotificationPayload): Promise<void>;
+    /** RPOP from notify delivery list; null when empty. */
+    pollNotify(): Promise<NotificationPayload | null>;
+}
+export interface JobsApi {
+    /** LPUSH job to spawn queue and write initial job record. */
+    enqueue(job: SpawnParams & {
+        id: string;
+    }): Promise<void>;
+    /** GET job record; null when job does not exist. */
+    getStatus(jobId: string): Promise<unknown>;
+    /** PUBLISH job-done channel + LPUSH to done queue. */
+    publishDone(jobId: string, result: unknown): Promise<void>;
+}
+export interface TokenApi {
+    /** GET master token; throws if not set. */
+    getMaster(): Promise<string>;
+    /** SET master token (no TTL). */
+    setMaster(token: string): Promise<void>;
+}
+export interface CcWire {
+    /** cc-discord: per-namespace session management. */
+    discord: DiscordApi;
+    /** cc-tg: single money-brain session. */
+    tg: TgApi;
+    /** cc-agent: job queue. */
+    jobs: JobsApi;
+    /** Master token (shared across services). */
+    token: TokenApi;
+    /**
+     * Raw redis client escape hatch — for migration only.
+     * @internal
+     */
+    _redis: Redis;
+}
+export declare function createCcWire(redis: Redis): CcWire;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/esm/runtime.d.ts.map

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

package/dist/esm/runtime.js

@@ -0,0 +1,164 @@
+import { discordMetaInputKey, discordMetaStatusKey, discordChatOutgoing, discordChatLog, discordNotify, tgChatOutgoing, tgNotify, jobKey, jobDoneChannel, jobDoneQueueKey, CAP, TTL, } from "./channels.js";
+// ─── Private key helpers (not exported) ──────────────────────────────────────
+const channelHashKey = (channelId) => `cca:discord:channel:${channelId}`;
+const CHANNELS_SET = "cca:discord:channels:index";
+const discordNotifyLogKey = (ns) => `cca:discord:notify-log:${ns}`;
+const TG_NOTIFY_LOG = "cca:tg:notify-log";
+const SPAWN_QUEUE = "cca:spawn:queue";
+const MASTER_TOKEN_KEY = "cca:token:master";
+// ─── Factory ──────────────────────────────────────────────────────────────────
+export function createCcWire(redis) {
+    return {
+        // ── discord ──────────────────────────────────────────────────────────────
+        discord: {
+            async enqueue(ns, msg) {
+                await redis.rpush(discordMetaInputKey(ns), JSON.stringify(msg));
+            },
+            async dequeue(ns) {
+                const val = await redis.rpop(discordMetaInputKey(ns));
+                return val ? JSON.parse(val) : null;
+            },
+            async publishOutgoing(ns, msg) {
+                const json = JSON.stringify(msg);
+                const pl = redis.pipeline();
+                pl.publish(discordChatOutgoing(ns), json);
+                pl.lpush(discordChatLog(ns), json);
+                pl.ltrim(discordChatLog(ns), 0, CAP.CHAT_LOG - 1);
+                await pl.exec();
+            },
+            subscribeOutgoing(ns, cb) {
+                const sub = redis.duplicate();
+                sub.subscribe(discordChatOutgoing(ns));
+                sub.on("message", (channel, message) => {
+                    if (channel === discordChatOutgoing(ns)) {
+                        cb(JSON.parse(message));
+                    }
+                });
+            },
+            async setStatus(ns, status) {
+                await redis.set(discordMetaStatusKey(ns), JSON.stringify(status), "EX", TTL.JOB_SECONDS);
+            },
+            async getStatus(ns) {
+                const val = await redis.get(discordMetaStatusKey(ns));
+                return val ? JSON.parse(val) : null;
+            },
+            async writeChatLog(ns, msg) {
+                const pl = redis.pipeline();
+                pl.lpush(discordChatLog(ns), JSON.stringify(msg));
+                pl.ltrim(discordChatLog(ns), 0, CAP.CHAT_LOG - 1);
+                await pl.exec();
+            },
+            async getChatLog(ns, limit = 50) {
+                const items = await redis.lrange(discordChatLog(ns), 0, limit - 1);
+                return items
+                    .map((i) => JSON.parse(i))
+                    .reverse();
+            },
+            async notify(ns, payload) {
+                const json = JSON.stringify(payload);
+                const pl = redis.pipeline();
+                pl.publish(discordNotify(ns), json);
+                pl.rpush(discordNotify(ns), json);
+                pl.lpush(discordNotifyLogKey(ns), json);
+                pl.ltrim(discordNotifyLogKey(ns), 0, CAP.NOTIFY_LOG - 1);
+                await pl.exec();
+            },
+            async pollNotify(ns) {
+                const val = await redis.rpop(discordNotify(ns));
+                return val ? JSON.parse(val) : null;
+            },
+            async registerChannel(channelId, ns, repoUrl) {
+                const pl = redis.pipeline();
+                pl.hset(channelHashKey(channelId), { namespace: ns, repoUrl });
+                pl.sadd(CHANNELS_SET, channelId);
+                await pl.exec();
+            },
+            async getChannel(channelId) {
+                const data = await redis.hgetall(channelHashKey(channelId));
+                if (!data || !data["namespace"])
+                    return null;
+                return { namespace: data["namespace"], repoUrl: data["repoUrl"] ?? "" };
+            },
+            async listChannels() {
+                const ids = await redis.smembers(CHANNELS_SET);
+                const rows = await Promise.all(ids.map(async (channelId) => {
+                    const data = await redis.hgetall(channelHashKey(channelId));
+                    if (!data || !data["namespace"])
+                        return null;
+                    return {
+                        channelId,
+                        namespace: data["namespace"],
+                        repoUrl: data["repoUrl"] ?? "",
+                    };
+                }));
+                return rows.filter((r) => r !== null);
+            },
+        },
+        // ── tg ───────────────────────────────────────────────────────────────────
+        tg: {
+            async publishOutgoing(msg) {
+                const json = JSON.stringify(msg);
+                const pl = redis.pipeline();
+                pl.publish(tgChatOutgoing(), json);
+                pl.lpush("cca:tg:chat:log", json);
+                pl.ltrim("cca:tg:chat:log", 0, CAP.CHAT_LOG - 1);
+                await pl.exec();
+            },
+            subscribeOutgoing(cb) {
+                const sub = redis.duplicate();
+                sub.subscribe(tgChatOutgoing());
+                sub.on("message", (_channel, message) => {
+                    cb(JSON.parse(message));
+                });
+            },
+            async notify(payload) {
+                const json = JSON.stringify(payload);
+                const pl = redis.pipeline();
+                pl.publish(tgNotify(), json);
+                pl.rpush(tgNotify(), json);
+                pl.lpush(TG_NOTIFY_LOG, json);
+                pl.ltrim(TG_NOTIFY_LOG, 0, CAP.NOTIFY_LOG - 1);
+                await pl.exec();
+            },
+            async pollNotify() {
+                const val = await redis.rpop(tgNotify());
+                return val ? JSON.parse(val) : null;
+            },
+        },
+        // ── jobs ─────────────────────────────────────────────────────────────────
+        jobs: {
+            async enqueue(job) {
+                const pl = redis.pipeline();
+                pl.set(jobKey(job.id), JSON.stringify({ ...job, status: "pending" }), "EX", TTL.JOB_SECONDS);
+                pl.lpush(SPAWN_QUEUE, JSON.stringify(job));
+                await pl.exec();
+            },
+            async getStatus(jobId) {
+                const val = await redis.get(jobKey(jobId));
+                return val ? JSON.parse(val) : null;
+            },
+            async publishDone(jobId, result) {
+                const json = JSON.stringify(result);
+                const pl = redis.pipeline();
+                pl.publish(jobDoneChannel(jobId), json);
+                pl.lpush(jobDoneQueueKey(jobId), json);
+                pl.expire(jobDoneQueueKey(jobId), TTL.JOB_SECONDS);
+                await pl.exec();
+            },
+        },
+        // ── token ─────────────────────────────────────────────────────────────────
+        token: {
+            async getMaster() {
+                const val = await redis.get(MASTER_TOKEN_KEY);
+                if (val === null)
+                    throw new Error("cc-wire: master token not set");
+                return val;
+            },
+            async setMaster(token) {
+                await redis.set(MASTER_TOKEN_KEY, token);
+            },
+        },
+        _redis: redis,
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/esm/runtime.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonzih/cc-wire",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Single source of truth for Redis channel names, key patterns, and message shapes across the cc-suite (cc-tg, cc-agent, cc-agent-ui)",
   "type": "module",
   "repository": {
@@ -27,12 +27,25 @@
     "build": "rm -rf dist && npm run build:esm && npm run build:cjs",
     "build:esm": "tsc -p tsconfig.json",
     "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/fix-cjs.mjs",
-    "test": "node --import tsx/esm --test src/channels.test.ts"
+    "test": "npm run test:channels && npm run test:runtime",
+    "test:channels": "node --import tsx/esm --test src/channels.test.ts",
+    "test:runtime": "vitest run --reporter=verbose"
+  },
+  "peerDependencies": {
+    "ioredis": ">=4 <6"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "22.15.21",
+    "ioredis": "5.11.1",
+    "ioredis-mock": "8.13.1",
     "tsx": "4.22.4",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "vitest": "4.1.8"
   },
   "keywords": [
     "redis",