@cnstra/devtools-server-repository-redis 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# @cnstra/devtools-server-repository-redis
+
+> **⚠️ Experimental**: API may change.
+
+Redis persistence for the [CNStra](https://cnstra.org) DevTools server. A drop-in, durable
+replacement for `@cnstra/devtools-server-repository-in-memory`: same
+`ICNSDevToolsServerRepository` contract, backed by Redis so apps, topology, stimulations and
+per-hop history outlive a restart.
+
+## Install
+
+```bash
+npm install @cnstra/devtools-server-repository-redis ioredis
+```
+
+## Usage
+
+```ts
+import Redis from 'ioredis';
+import { CNSDevToolsServer } from '@cnstra/devtools-server';
+import { CNSDevToolsServerRepositoryRedis } from '@cnstra/devtools-server-repository-redis';
+
+const redis = new Redis(process.env.REDIS_URL);
+const repo = new CNSDevToolsServerRepositoryRedis(redis);
+
+const server = new CNSDevToolsServer(repo);
+```
+
+The constructor accepts any [ioredis](https://github.com/redis/ioredis)-style client. `ioredis`
+is an optional peer dependency (the client is typed structurally). `node-redis` v4 uses
+different method names (`hSet`, `hGetAll`, …) and is **not** directly compatible.
+
+## Options
+
+```ts
+new CNSDevToolsServerRepositoryRedis(redis, { keyPrefix: 'cns:' });
+```
+
+## Data layout
+
+With the default `cns:` prefix: `cns:apps` / `cns:topology` / `cns:cnsToApp` (hashes),
+`cns:stim:{id}` (stimulation JSON), `cns:stims:{appId}` (zset scored by `startedAt` for
+ordering/paging and time-range filters), `cns:hops:{stimId}` (list), `cns:appToCns:{appId}`
+(set). `hasError` / `collateralId` / `neuronId` filters are applied in memory after the
+time-range zset scan — fine at DevTools scale.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+// src/index.ts
+var parse = (s) => s == null ? null : JSON.parse(s);
+var CNSDevToolsServerRepositoryRedis = class {
+  constructor(redis, options = {}) {
+    this.redis = redis;
+    this.p = options.keyPrefix ?? "cns:";
+  }
+  // ─── Apps ───────────────────────────────────────────────────────────────
+  async upsertApp(app) {
+    await this.redis.hset(`${this.p}apps`, app.id, JSON.stringify(app));
+  }
+  async listApps() {
+    const all = await this.redis.hgetall(`${this.p}apps`);
+    return Object.values(all ?? {}).map((v) => JSON.parse(v));
+  }
+  // ─── Topology ───────────────────────────────────────────────────────────
+  async saveTopology(snapshot) {
+    await this.redis.hset(
+      `${this.p}topology`,
+      snapshot.cnsId,
+      JSON.stringify(snapshot)
+    );
+  }
+  async getTopology(cnsId) {
+    if (cnsId) {
+      const raw = await this.redis.hget(`${this.p}topology`, cnsId);
+      const snap = parse(raw);
+      return snap ? [snap] : [];
+    }
+    const all = await this.redis.hgetall(`${this.p}topology`);
+    return Object.values(all ?? {}).map(
+      (v) => JSON.parse(v)
+    );
+  }
+  // ─── Stimulations ───────────────────────────────────────────────────────
+  async saveStimulation(s) {
+    await this.redis.set(`${this.p}stim:${s.id}`, JSON.stringify(s));
+    await this.redis.zadd(`${this.p}stims:${s.appId}`, s.startedAt, s.id);
+  }
+  async completeStimulation(stimulationId, completedAt, hopCount, hasError) {
+    const raw = await this.redis.get(`${this.p}stim:${stimulationId}`);
+    const s = parse(raw);
+    if (!s) return;
+    const updated = {
+      ...s,
+      completedAt,
+      hopCount,
+      hasError
+    };
+    await this.redis.set(
+      `${this.p}stim:${stimulationId}`,
+      JSON.stringify(updated)
+    );
+  }
+  async getStimulations(appId, filter) {
+    const max = filter.toTimestamp ?? "+inf";
+    const min = filter.fromTimestamp ?? "-inf";
+    const ids = await this.redis.zrevrangebyscore(
+      `${this.p}stims:${appId}`,
+      max,
+      min
+    );
+    if (ids.length === 0) return { items: [], total: 0 };
+    const raws = await Promise.all(
+      ids.map((id) => this.redis.get(`${this.p}stim:${id}`))
+    );
+    let items = raws.map((r) => parse(r)).filter((s) => s !== null);
+    if (filter.hasError !== void 0)
+      items = items.filter((s) => s.hasError === filter.hasError);
+    if (filter.collateralId !== void 0)
+      items = items.filter((s) => s.collateralId === filter.collateralId);
+    if (filter.neuronId !== void 0)
+      items = items.filter(
+        (s) => s.collateralId.startsWith(filter.neuronId)
+      );
+    items.sort((a, b) => b.startedAt - a.startedAt);
+    const total = items.length;
+    const limit = filter.limit ?? 100;
+    const offset = filter.offset ?? 0;
+    return { items: items.slice(offset, offset + limit), total };
+  }
+  // ─── Hops ───────────────────────────────────────────────────────────────
+  async saveHop(hop) {
+    await this.redis.rpush(
+      `${this.p}hops:${hop.stimulationId}`,
+      JSON.stringify(hop)
+    );
+  }
+  async getHops(stimulationId) {
+    const raws = await this.redis.lrange(
+      `${this.p}hops:${stimulationId}`,
+      0,
+      -1
+    );
+    return raws.map((r) => JSON.parse(r)).sort((a, b) => a.index - b.index);
+  }
+  // ─── CNS ↔ App mapping ──────────────────────────────────────────────────
+  async addCnsToApp(appId, cnsId) {
+    await this.redis.hset(`${this.p}cnsToApp`, cnsId, appId);
+    await this.redis.sadd(`${this.p}appToCns:${appId}`, cnsId);
+  }
+  async getCnsByApp(appId) {
+    return this.redis.smembers(`${this.p}appToCns:${appId}`);
+  }
+  async findAppByCns(cnsId) {
+    const appId = await this.redis.hget(`${this.p}cnsToApp`, cnsId);
+    return appId ?? void 0;
+  }
+};
+
+exports.CNSDevToolsServerRepositoryRedis = CNSDevToolsServerRepositoryRedis;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n    ICNSDevToolsServerRepository,\n    CNSDTOTopologySnapshot,\n} from '@cnstra/devtools-server';\nimport type {\n    CNSDTOApp,\n    CNSDTOStimulation,\n    CNSDTOStimulationFilter,\n    CNSDTOHop,\n} from '@cnstra/devtools-dto';\n\n/**\n * Minimal structural view of an `ioredis` client — only the commands this\n * repository uses. A real `Redis` instance from `ioredis` satisfies it, so we\n * avoid a hard dependency on `ioredis` and its types.\n *\n * Note: this targets ioredis-style lowercase command methods. `node-redis` v4\n * uses different names (hSet, hGetAll, …) and is not directly compatible.\n */\nexport interface IRedisLike {\n    hset(key: string, field: string, value: string): Promise<unknown>;\n    hget(key: string, field: string): Promise<string | null>;\n    hgetall(key: string): Promise<Record<string, string>>;\n    set(key: string, value: string): Promise<unknown>;\n    get(key: string): Promise<string | null>;\n    zadd(key: string, score: number, member: string): Promise<unknown>;\n    zrevrangebyscore(\n        key: string,\n        max: number | string,\n        min: number | string\n    ): Promise<string[]>;\n    rpush(key: string, value: string): Promise<unknown>;\n    lrange(key: string, start: number, stop: number): Promise<string[]>;\n    sadd(key: string, member: string): Promise<unknown>;\n    smembers(key: string): Promise<string[]>;\n}\n\nexport interface CNSDevToolsServerRepositoryRedisOptions {\n    /** Key namespace prefix (default \"cns:\"). */\n    keyPrefix?: string;\n}\n\nconst parse = <T>(s: string | null): T | null =>\n    s == null ? null : (JSON.parse(s) as T);\n\n/**\n * Redis-backed repository for the CNStra DevTools server. Durable counterpart of\n * `@cnstra/devtools-server-repository-in-memory` with the same\n * `ICNSDevToolsServerRepository` contract.\n *\n * Data layout (with the default `cns:` prefix):\n *  - `cns:apps`               hash  appId  → app JSON\n *  - `cns:topology`           hash  cnsId  → snapshot JSON\n *  - `cns:stim:{id}`          string        stimulation JSON\n *  - `cns:stims:{appId}`      zset  score=startedAt, member=stimId (ordering/paging)\n *  - `cns:hops:{stimId}`      list          hop JSON (append order)\n *  - `cns:cnsToApp`           hash  cnsId  → appId\n *  - `cns:appToCns:{appId}`   set           cnsId\n */\nexport class CNSDevToolsServerRepositoryRedis\n    implements ICNSDevToolsServerRepository\n{\n    private readonly p: string;\n\n    constructor(\n        private readonly redis: IRedisLike,\n        options: CNSDevToolsServerRepositoryRedisOptions = {}\n    ) {\n        this.p = options.keyPrefix ?? 'cns:';\n    }\n\n    // ─── Apps ───────────────────────────────────────────────────────────────\n\n    async upsertApp(app: CNSDTOApp): Promise<void> {\n        await this.redis.hset(`${this.p}apps`, app.id, JSON.stringify(app));\n    }\n\n    async listApps(): Promise<CNSDTOApp[]> {\n        const all = await this.redis.hgetall(`${this.p}apps`);\n        return Object.values(all ?? {}).map(v => JSON.parse(v) as CNSDTOApp);\n    }\n\n    // ─── Topology ───────────────────────────────────────────────────────────\n\n    async saveTopology(snapshot: CNSDTOTopologySnapshot): Promise<void> {\n        await this.redis.hset(\n            `${this.p}topology`,\n            snapshot.cnsId,\n            JSON.stringify(snapshot)\n        );\n    }\n\n    async getTopology(cnsId?: string): Promise<CNSDTOTopologySnapshot[]> {\n        if (cnsId) {\n            const raw = await this.redis.hget(`${this.p}topology`, cnsId);\n            const snap = parse<CNSDTOTopologySnapshot>(raw);\n            return snap ? [snap] : [];\n        }\n        const all = await this.redis.hgetall(`${this.p}topology`);\n        return Object.values(all ?? {}).map(\n            v => JSON.parse(v) as CNSDTOTopologySnapshot\n        );\n    }\n\n    // ─── Stimulations ───────────────────────────────────────────────────────\n\n    async saveStimulation(s: CNSDTOStimulation): Promise<void> {\n        await this.redis.set(`${this.p}stim:${s.id}`, JSON.stringify(s));\n        await this.redis.zadd(`${this.p}stims:${s.appId}`, s.startedAt, s.id);\n    }\n\n    async completeStimulation(\n        stimulationId: string,\n        completedAt: number,\n        hopCount: number,\n        hasError: boolean\n    ): Promise<void> {\n        const raw = await this.redis.get(`${this.p}stim:${stimulationId}`);\n        const s = parse<CNSDTOStimulation>(raw);\n        if (!s) return;\n        const updated: CNSDTOStimulation = {\n            ...s,\n            completedAt,\n            hopCount,\n            hasError,\n        };\n        await this.redis.set(\n            `${this.p}stim:${stimulationId}`,\n            JSON.stringify(updated)\n        );\n    }\n\n    async getStimulations(\n        appId: string,\n        filter: CNSDTOStimulationFilter\n    ): Promise<{ items: CNSDTOStimulation[]; total: number }> {\n        const max = filter.toTimestamp ?? '+inf';\n        const min = filter.fromTimestamp ?? '-inf';\n\n        // Ids ordered by startedAt desc, already time-range filtered by score.\n        const ids = await this.redis.zrevrangebyscore(\n            `${this.p}stims:${appId}`,\n            max,\n            min\n        );\n        if (ids.length === 0) return { items: [], total: 0 };\n\n        const raws = await Promise.all(\n            ids.map(id => this.redis.get(`${this.p}stim:${id}`))\n        );\n        let items = raws\n            .map(r => parse<CNSDTOStimulation>(r))\n            .filter((s): s is CNSDTOStimulation => s !== null);\n\n        if (filter.hasError !== undefined)\n            items = items.filter(s => s.hasError === filter.hasError);\n        if (filter.collateralId !== undefined)\n            items = items.filter(s => s.collateralId === filter.collateralId);\n        if (filter.neuronId !== undefined)\n            items = items.filter(s =>\n                s.collateralId.startsWith(filter.neuronId!)\n            );\n\n        // zrevrangebyscore already returns desc; re-sort defensively.\n        items.sort((a, b) => b.startedAt - a.startedAt);\n\n        const total = items.length;\n        const limit = filter.limit ?? 100;\n        const offset = filter.offset ?? 0;\n        return { items: items.slice(offset, offset + limit), total };\n    }\n\n    // ─── Hops ───────────────────────────────────────────────────────────────\n\n    async saveHop(hop: CNSDTOHop): Promise<void> {\n        await this.redis.rpush(\n            `${this.p}hops:${hop.stimulationId}`,\n            JSON.stringify(hop)\n        );\n    }\n\n    async getHops(stimulationId: string): Promise<CNSDTOHop[]> {\n        const raws = await this.redis.lrange(\n            `${this.p}hops:${stimulationId}`,\n            0,\n            -1\n        );\n        return raws\n            .map(r => JSON.parse(r) as CNSDTOHop)\n            .sort((a, b) => a.index - b.index);\n    }\n\n    // ─── CNS ↔ App mapping ──────────────────────────────────────────────────\n\n    async addCnsToApp(appId: string, cnsId: string): Promise<void> {\n        await this.redis.hset(`${this.p}cnsToApp`, cnsId, appId);\n        await this.redis.sadd(`${this.p}appToCns:${appId}`, cnsId);\n    }\n\n    async getCnsByApp(appId: string): Promise<string[]> {\n        return this.redis.smembers(`${this.p}appToCns:${appId}`);\n    }\n\n    async findAppByCns(cnsId: string): Promise<string | undefined> {\n        const appId = await this.redis.hget(`${this.p}cnsToApp`, cnsId);\n        return appId ?? undefined;\n    }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import type { ICNSDevToolsServerRepository, CNSDTOTopologySnapshot } from '@cnstra/devtools-server';
+import type { CNSDTOApp, CNSDTOStimulation, CNSDTOStimulationFilter, CNSDTOHop } from '@cnstra/devtools-dto';
+/**
+ * Minimal structural view of an `ioredis` client — only the commands this
+ * repository uses. A real `Redis` instance from `ioredis` satisfies it, so we
+ * avoid a hard dependency on `ioredis` and its types.
+ *
+ * Note: this targets ioredis-style lowercase command methods. `node-redis` v4
+ * uses different names (hSet, hGetAll, …) and is not directly compatible.
+ */
+export interface IRedisLike {
+    hset(key: string, field: string, value: string): Promise<unknown>;
+    hget(key: string, field: string): Promise<string | null>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    set(key: string, value: string): Promise<unknown>;
+    get(key: string): Promise<string | null>;
+    zadd(key: string, score: number, member: string): Promise<unknown>;
+    zrevrangebyscore(key: string, max: number | string, min: number | string): Promise<string[]>;
+    rpush(key: string, value: string): Promise<unknown>;
+    lrange(key: string, start: number, stop: number): Promise<string[]>;
+    sadd(key: string, member: string): Promise<unknown>;
+    smembers(key: string): Promise<string[]>;
+}
+export interface CNSDevToolsServerRepositoryRedisOptions {
+    /** Key namespace prefix (default "cns:"). */
+    keyPrefix?: string;
+}
+/**
+ * Redis-backed repository for the CNStra DevTools server. Durable counterpart of
+ * `@cnstra/devtools-server-repository-in-memory` with the same
+ * `ICNSDevToolsServerRepository` contract.
+ *
+ * Data layout (with the default `cns:` prefix):
+ *  - `cns:apps`               hash  appId  → app JSON
+ *  - `cns:topology`           hash  cnsId  → snapshot JSON
+ *  - `cns:stim:{id}`          string        stimulation JSON
+ *  - `cns:stims:{appId}`      zset  score=startedAt, member=stimId (ordering/paging)
+ *  - `cns:hops:{stimId}`      list          hop JSON (append order)
+ *  - `cns:cnsToApp`           hash  cnsId  → appId
+ *  - `cns:appToCns:{appId}`   set           cnsId
+ */
+export declare class CNSDevToolsServerRepositoryRedis implements ICNSDevToolsServerRepository {
+    private readonly redis;
+    private readonly p;
+    constructor(redis: IRedisLike, options?: CNSDevToolsServerRepositoryRedisOptions);
+    upsertApp(app: CNSDTOApp): Promise<void>;
+    listApps(): Promise<CNSDTOApp[]>;
+    saveTopology(snapshot: CNSDTOTopologySnapshot): Promise<void>;
+    getTopology(cnsId?: string): Promise<CNSDTOTopologySnapshot[]>;
+    saveStimulation(s: CNSDTOStimulation): Promise<void>;
+    completeStimulation(stimulationId: string, completedAt: number, hopCount: number, hasError: boolean): Promise<void>;
+    getStimulations(appId: string, filter: CNSDTOStimulationFilter): Promise<{
+        items: CNSDTOStimulation[];
+        total: number;
+    }>;
+    saveHop(hop: CNSDTOHop): Promise<void>;
+    getHops(stimulationId: string): Promise<CNSDTOHop[]>;
+    addCnsToApp(appId: string, cnsId: string): Promise<void>;
+    getCnsByApp(appId: string): Promise<string[]>;
+    findAppByCns(cnsId: string): Promise<string | undefined>;
+}
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,113 @@
+// src/index.ts
+var parse = (s) => s == null ? null : JSON.parse(s);
+var CNSDevToolsServerRepositoryRedis = class {
+  constructor(redis, options = {}) {
+    this.redis = redis;
+    this.p = options.keyPrefix ?? "cns:";
+  }
+  // ─── Apps ───────────────────────────────────────────────────────────────
+  async upsertApp(app) {
+    await this.redis.hset(`${this.p}apps`, app.id, JSON.stringify(app));
+  }
+  async listApps() {
+    const all = await this.redis.hgetall(`${this.p}apps`);
+    return Object.values(all ?? {}).map((v) => JSON.parse(v));
+  }
+  // ─── Topology ───────────────────────────────────────────────────────────
+  async saveTopology(snapshot) {
+    await this.redis.hset(
+      `${this.p}topology`,
+      snapshot.cnsId,
+      JSON.stringify(snapshot)
+    );
+  }
+  async getTopology(cnsId) {
+    if (cnsId) {
+      const raw = await this.redis.hget(`${this.p}topology`, cnsId);
+      const snap = parse(raw);
+      return snap ? [snap] : [];
+    }
+    const all = await this.redis.hgetall(`${this.p}topology`);
+    return Object.values(all ?? {}).map(
+      (v) => JSON.parse(v)
+    );
+  }
+  // ─── Stimulations ───────────────────────────────────────────────────────
+  async saveStimulation(s) {
+    await this.redis.set(`${this.p}stim:${s.id}`, JSON.stringify(s));
+    await this.redis.zadd(`${this.p}stims:${s.appId}`, s.startedAt, s.id);
+  }
+  async completeStimulation(stimulationId, completedAt, hopCount, hasError) {
+    const raw = await this.redis.get(`${this.p}stim:${stimulationId}`);
+    const s = parse(raw);
+    if (!s) return;
+    const updated = {
+      ...s,
+      completedAt,
+      hopCount,
+      hasError
+    };
+    await this.redis.set(
+      `${this.p}stim:${stimulationId}`,
+      JSON.stringify(updated)
+    );
+  }
+  async getStimulations(appId, filter) {
+    const max = filter.toTimestamp ?? "+inf";
+    const min = filter.fromTimestamp ?? "-inf";
+    const ids = await this.redis.zrevrangebyscore(
+      `${this.p}stims:${appId}`,
+      max,
+      min
+    );
+    if (ids.length === 0) return { items: [], total: 0 };
+    const raws = await Promise.all(
+      ids.map((id) => this.redis.get(`${this.p}stim:${id}`))
+    );
+    let items = raws.map((r) => parse(r)).filter((s) => s !== null);
+    if (filter.hasError !== void 0)
+      items = items.filter((s) => s.hasError === filter.hasError);
+    if (filter.collateralId !== void 0)
+      items = items.filter((s) => s.collateralId === filter.collateralId);
+    if (filter.neuronId !== void 0)
+      items = items.filter(
+        (s) => s.collateralId.startsWith(filter.neuronId)
+      );
+    items.sort((a, b) => b.startedAt - a.startedAt);
+    const total = items.length;
+    const limit = filter.limit ?? 100;
+    const offset = filter.offset ?? 0;
+    return { items: items.slice(offset, offset + limit), total };
+  }
+  // ─── Hops ───────────────────────────────────────────────────────────────
+  async saveHop(hop) {
+    await this.redis.rpush(
+      `${this.p}hops:${hop.stimulationId}`,
+      JSON.stringify(hop)
+    );
+  }
+  async getHops(stimulationId) {
+    const raws = await this.redis.lrange(
+      `${this.p}hops:${stimulationId}`,
+      0,
+      -1
+    );
+    return raws.map((r) => JSON.parse(r)).sort((a, b) => a.index - b.index);
+  }
+  // ─── CNS ↔ App mapping ──────────────────────────────────────────────────
+  async addCnsToApp(appId, cnsId) {
+    await this.redis.hset(`${this.p}cnsToApp`, cnsId, appId);
+    await this.redis.sadd(`${this.p}appToCns:${appId}`, cnsId);
+  }
+  async getCnsByApp(appId) {
+    return this.redis.smembers(`${this.p}appToCns:${appId}`);
+  }
+  async findAppByCns(cnsId) {
+    const appId = await this.redis.hget(`${this.p}cnsToApp`, cnsId);
+    return appId ?? void 0;
+  }
+};
+
+export { CNSDevToolsServerRepositoryRedis };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n    ICNSDevToolsServerRepository,\n    CNSDTOTopologySnapshot,\n} from '@cnstra/devtools-server';\nimport type {\n    CNSDTOApp,\n    CNSDTOStimulation,\n    CNSDTOStimulationFilter,\n    CNSDTOHop,\n} from '@cnstra/devtools-dto';\n\n/**\n * Minimal structural view of an `ioredis` client — only the commands this\n * repository uses. A real `Redis` instance from `ioredis` satisfies it, so we\n * avoid a hard dependency on `ioredis` and its types.\n *\n * Note: this targets ioredis-style lowercase command methods. `node-redis` v4\n * uses different names (hSet, hGetAll, …) and is not directly compatible.\n */\nexport interface IRedisLike {\n    hset(key: string, field: string, value: string): Promise<unknown>;\n    hget(key: string, field: string): Promise<string | null>;\n    hgetall(key: string): Promise<Record<string, string>>;\n    set(key: string, value: string): Promise<unknown>;\n    get(key: string): Promise<string | null>;\n    zadd(key: string, score: number, member: string): Promise<unknown>;\n    zrevrangebyscore(\n        key: string,\n        max: number | string,\n        min: number | string\n    ): Promise<string[]>;\n    rpush(key: string, value: string): Promise<unknown>;\n    lrange(key: string, start: number, stop: number): Promise<string[]>;\n    sadd(key: string, member: string): Promise<unknown>;\n    smembers(key: string): Promise<string[]>;\n}\n\nexport interface CNSDevToolsServerRepositoryRedisOptions {\n    /** Key namespace prefix (default \"cns:\"). */\n    keyPrefix?: string;\n}\n\nconst parse = <T>(s: string | null): T | null =>\n    s == null ? null : (JSON.parse(s) as T);\n\n/**\n * Redis-backed repository for the CNStra DevTools server. Durable counterpart of\n * `@cnstra/devtools-server-repository-in-memory` with the same\n * `ICNSDevToolsServerRepository` contract.\n *\n * Data layout (with the default `cns:` prefix):\n *  - `cns:apps`               hash  appId  → app JSON\n *  - `cns:topology`           hash  cnsId  → snapshot JSON\n *  - `cns:stim:{id}`          string        stimulation JSON\n *  - `cns:stims:{appId}`      zset  score=startedAt, member=stimId (ordering/paging)\n *  - `cns:hops:{stimId}`      list          hop JSON (append order)\n *  - `cns:cnsToApp`           hash  cnsId  → appId\n *  - `cns:appToCns:{appId}`   set           cnsId\n */\nexport class CNSDevToolsServerRepositoryRedis\n    implements ICNSDevToolsServerRepository\n{\n    private readonly p: string;\n\n    constructor(\n        private readonly redis: IRedisLike,\n        options: CNSDevToolsServerRepositoryRedisOptions = {}\n    ) {\n        this.p = options.keyPrefix ?? 'cns:';\n    }\n\n    // ─── Apps ───────────────────────────────────────────────────────────────\n\n    async upsertApp(app: CNSDTOApp): Promise<void> {\n        await this.redis.hset(`${this.p}apps`, app.id, JSON.stringify(app));\n    }\n\n    async listApps(): Promise<CNSDTOApp[]> {\n        const all = await this.redis.hgetall(`${this.p}apps`);\n        return Object.values(all ?? {}).map(v => JSON.parse(v) as CNSDTOApp);\n    }\n\n    // ─── Topology ───────────────────────────────────────────────────────────\n\n    async saveTopology(snapshot: CNSDTOTopologySnapshot): Promise<void> {\n        await this.redis.hset(\n            `${this.p}topology`,\n            snapshot.cnsId,\n            JSON.stringify(snapshot)\n        );\n    }\n\n    async getTopology(cnsId?: string): Promise<CNSDTOTopologySnapshot[]> {\n        if (cnsId) {\n            const raw = await this.redis.hget(`${this.p}topology`, cnsId);\n            const snap = parse<CNSDTOTopologySnapshot>(raw);\n            return snap ? [snap] : [];\n        }\n        const all = await this.redis.hgetall(`${this.p}topology`);\n        return Object.values(all ?? {}).map(\n            v => JSON.parse(v) as CNSDTOTopologySnapshot\n        );\n    }\n\n    // ─── Stimulations ───────────────────────────────────────────────────────\n\n    async saveStimulation(s: CNSDTOStimulation): Promise<void> {\n        await this.redis.set(`${this.p}stim:${s.id}`, JSON.stringify(s));\n        await this.redis.zadd(`${this.p}stims:${s.appId}`, s.startedAt, s.id);\n    }\n\n    async completeStimulation(\n        stimulationId: string,\n        completedAt: number,\n        hopCount: number,\n        hasError: boolean\n    ): Promise<void> {\n        const raw = await this.redis.get(`${this.p}stim:${stimulationId}`);\n        const s = parse<CNSDTOStimulation>(raw);\n        if (!s) return;\n        const updated: CNSDTOStimulation = {\n            ...s,\n            completedAt,\n            hopCount,\n            hasError,\n        };\n        await this.redis.set(\n            `${this.p}stim:${stimulationId}`,\n            JSON.stringify(updated)\n        );\n    }\n\n    async getStimulations(\n        appId: string,\n        filter: CNSDTOStimulationFilter\n    ): Promise<{ items: CNSDTOStimulation[]; total: number }> {\n        const max = filter.toTimestamp ?? '+inf';\n        const min = filter.fromTimestamp ?? '-inf';\n\n        // Ids ordered by startedAt desc, already time-range filtered by score.\n        const ids = await this.redis.zrevrangebyscore(\n            `${this.p}stims:${appId}`,\n            max,\n            min\n        );\n        if (ids.length === 0) return { items: [], total: 0 };\n\n        const raws = await Promise.all(\n            ids.map(id => this.redis.get(`${this.p}stim:${id}`))\n        );\n        let items = raws\n            .map(r => parse<CNSDTOStimulation>(r))\n            .filter((s): s is CNSDTOStimulation => s !== null);\n\n        if (filter.hasError !== undefined)\n            items = items.filter(s => s.hasError === filter.hasError);\n        if (filter.collateralId !== undefined)\n            items = items.filter(s => s.collateralId === filter.collateralId);\n        if (filter.neuronId !== undefined)\n            items = items.filter(s =>\n                s.collateralId.startsWith(filter.neuronId!)\n            );\n\n        // zrevrangebyscore already returns desc; re-sort defensively.\n        items.sort((a, b) => b.startedAt - a.startedAt);\n\n        const total = items.length;\n        const limit = filter.limit ?? 100;\n        const offset = filter.offset ?? 0;\n        return { items: items.slice(offset, offset + limit), total };\n    }\n\n    // ─── Hops ───────────────────────────────────────────────────────────────\n\n    async saveHop(hop: CNSDTOHop): Promise<void> {\n        await this.redis.rpush(\n            `${this.p}hops:${hop.stimulationId}`,\n            JSON.stringify(hop)\n        );\n    }\n\n    async getHops(stimulationId: string): Promise<CNSDTOHop[]> {\n        const raws = await this.redis.lrange(\n            `${this.p}hops:${stimulationId}`,\n            0,\n            -1\n        );\n        return raws\n            .map(r => JSON.parse(r) as CNSDTOHop)\n            .sort((a, b) => a.index - b.index);\n    }\n\n    // ─── CNS ↔ App mapping ──────────────────────────────────────────────────\n\n    async addCnsToApp(appId: string, cnsId: string): Promise<void> {\n        await this.redis.hset(`${this.p}cnsToApp`, cnsId, appId);\n        await this.redis.sadd(`${this.p}appToCns:${appId}`, cnsId);\n    }\n\n    async getCnsByApp(appId: string): Promise<string[]> {\n        return this.redis.smembers(`${this.p}appToCns:${appId}`);\n    }\n\n    async findAppByCns(cnsId: string): Promise<string | undefined> {\n        const appId = await this.redis.hget(`${this.p}cnsToApp`, cnsId);\n        return appId ?? undefined;\n    }\n}\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@cnstra/devtools-server-repository-redis",
+  "version": "0.1.0",
+  "description": "Redis repository for CNStra DevTools server (durable stimulations & hops)",
+  "keywords": ["cnstra", "devtools", "repository", "redis", "ioredis"],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly",
+    "build:types": "tsc --emitDeclarationOnly",
+    "test": "jest",
+    "clean": "rm -rf dist"
+  },
+  "files": ["dist"],
+  "dependencies": {
+    "@cnstra/devtools-dto": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@cnstra/devtools-server": "^1.0.1",
+    "ioredis": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "ioredis-mock": "^8.9.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
+  },
+  "author": "Andrei Baikov <abaikov23@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}