@fieldnotes/sync-redis 0.7.2 → 0.8.0

package/README.md

@@ -15,7 +15,7 @@ pnpm add ioredis
 
 `@fieldnotes/sync-redis` has **no Redis dependency of its own** — you inject a client that satisfies a
 minimal `RedisHashClient` interface (`hGetAll` / `hGet` / `hSet` / `hDel` / `del` / `eval`).
-`eval` is required for atomic fog-of-war updates.
+`eval` is optional for the generic element backend and is used by plugins that need atomic scripts.
 
 ## node-redis v4 (direct)
 
@@ -59,9 +59,10 @@ Each room is stored as a Redis **HASH** at `{keyPrefix}{room}` (default prefix `
 - **field** = element id
 - **value** = `JSON.stringify(element)`
 
-Fog uses two additional hashes, `${key}:fog:meta` and `${key}:fog:tiles`, and atomic Lua scripts via
-`EVAL`; custom Redis adapters must expose the node-redis-compatible `eval(script, { keys, arguments })`
-shape shown above.
+Backend plugins own any additional key schemas and atomic scripts. For fog, pass
+`createFogBackendPlugin()` from `@fieldnotes/vtt/redis`; it owns `${key}:fog:meta` and
+`${key}:fog:tiles` and requires the node-redis-compatible
+`eval(script, { keys, arguments })` shape shown above.
 
 node-redis v4 conforms to `RedisHashClient` directly (it has `hGet`); `RedisHubBackend.get(room, id)`
 (via `HGET`) powers the relay's ownership lookups for write authorization (D2).
@@ -72,6 +73,12 @@ The prefix is configurable:
 new RedisHubBackend(client, { keyPrefix: 'myapp:room:' });
 ```
 
+```ts
+import { createFogBackendPlugin } from '@fieldnotes/vtt/redis';
+
+new RedisHubBackend(client, { plugins: [createFogBackendPlugin()] });
+```
+
 ## Single vs. multiple relay instances
 
 Persistence and shared state work with any number of relay instances — every instance reads and writes the

package/dist/index.cjs

@@ -27,14 +27,19 @@ module.exports = __toCommonJS(index_exports);
 
 // src/redis-hub-backend.ts
 var import_sync = require("@fieldnotes/sync");
-var import_vtt = require("@fieldnotes/vtt");
 var RedisHubBackend = class {
   sharedAcrossInstances = true;
   client;
   keyPrefix;
+  services = /* @__PURE__ */ new Map();
+  pluginDisposers = [];
   constructor(client, options = {}) {
     this.client = client;
     this.keyPrefix = options.keyPrefix ?? "fieldnotes:room:";
+    this.installPlugins(options.plugins ?? []);
+  }
+  getService(key) {
+    return this.services.get(key.id);
   }
   key(room) {
     return `${this.keyPrefix}${room}`;
@@ -46,13 +51,11 @@ var RedisHubBackend = class {
     const map = await this.client.hGetAll(this.key(room));
     const out = [];
     for (const value of Object.values(map)) {
-      let parsed;
       try {
-        parsed = JSON.parse(value);
+        const parsed = JSON.parse(value);
+        if ((0, import_sync.isValidElement)(parsed)) out.push(parsed);
       } catch {
-        continue;
       }
-      if ((0, import_sync.isValidElement)(parsed)) out.push(parsed);
     }
     return out;
   }
@@ -77,13 +80,11 @@ var RedisHubBackend = class {
     const map = await this.client.hGetAll(this.layersKey(room));
     const out = [];
     for (const value of Object.values(map)) {
-      let parsed;
       try {
-        parsed = JSON.parse(value);
+        const parsed = JSON.parse(value);
+        if ((0, import_sync.isValidLayerRecord)(parsed)) out.push(parsed);
       } catch {
-        continue;
       }
-      if ((0, import_sync.isValidLayerRecord)(parsed)) out.push(parsed);
     }
     return out;
   }
@@ -100,167 +101,60 @@ var RedisHubBackend = class {
   async applyLayerRecord(room, record) {
     await this.client.hSet(this.layersKey(room), record.id, JSON.stringify(record));
   }
-  fogMetaKey(room) {
-    return `${this.keyPrefix}${room}:fog:meta`;
-  }
-  fogTilesKey(room) {
-    return `${this.keyPrefix}${room}:fog:tiles`;
+  dispose() {
+    for (const dispose of [...this.pluginDisposers].reverse()) safelyDispose(dispose);
+    this.pluginDisposers.length = 0;
+    this.services.clear();
   }
-  async fogSnapshot(room) {
-    const metaStr = await this.client.hGet(this.fogMetaKey(room), "current");
-    if (metaStr == null) return void 0;
-    let meta;
+  installPlugins(plugins) {
+    const names = /* @__PURE__ */ new Set();
+    const prefixes = /* @__PURE__ */ new Set();
     try {
-      meta = JSON.parse(metaStr);
-    } catch {
-      return void 0;
-    }
-    if (!(0, import_sync.isValidFogMetaRecord)(meta)) return void 0;
-    if (!meta.definition) return { meta, tiles: [] };
-    const definition = meta.definition;
-    if (!definition) return { meta, tiles: [] };
-    const tileMap = await this.client.hGetAll(this.fogTilesKey(room));
-    const tiles = [];
-    const seen = /* @__PURE__ */ new Set();
-    for (const value of Object.values(tileMap)) {
-      let parsed;
-      try {
-        parsed = JSON.parse(value);
-      } catch {
-        continue;
-      }
-      if (!(0, import_sync.isValidFogTileRecord)(parsed)) continue;
-      if (parsed.generation !== definition.generation) continue;
-      if (!(0, import_vtt.tileIntersectsDefinition)(parsed.x, parsed.y, definition)) continue;
-      if (!(0, import_sync.isValidFogSnapshot)({ meta, tiles: [parsed] })) continue;
-      const key = `${parsed.x},${parsed.y}`;
-      if (seen.has(key)) continue;
-      seen.add(key);
-      tiles.push(parsed);
-      if (tiles.length === 256) break;
-    }
-    const snapshot = { meta, tiles };
-    return (0, import_sync.isValidFogSnapshot)(snapshot) ? snapshot : void 0;
-  }
-  async applyFogMeta(room, record) {
-    for (let attempt = 0; attempt < 4; attempt++) {
-      const metaKey = this.fogMetaKey(room);
-      const tilesKey = this.fogTilesKey(room);
-      const expectedMeta = await this.client.hGet(metaKey, "current");
-      const expectedTiles = await this.client.hGetAll(tilesKey);
-      const replacements = [];
-      let current;
-      if (expectedMeta !== null) {
-        try {
-          const parsed = JSON.parse(expectedMeta);
-          if ((0, import_sync.isValidFogMetaRecord)(parsed)) current = parsed;
-        } catch {
-        }
-      }
-      if (current?.definition && record.definition && current.definition.generation === record.definition.generation) {
-        for (const raw of Object.values(expectedTiles)) {
-          let tile;
-          try {
-            tile = JSON.parse(raw);
-          } catch {
-            continue;
-          }
-          if (!(0, import_sync.isValidFogSnapshot)({ meta: current, tiles: [tile] })) continue;
-          const valid = tile;
-          if (!(0, import_vtt.tileIntersectsDefinition)(valid.x, valid.y, record.definition)) continue;
-          if (valid.data === void 0) {
-            replacements.push(valid);
-            continue;
-          }
-          const canonical = (0, import_vtt.canonicalizeFogTile)(
-            { x: valid.x, y: valid.y, data: valid.data },
-            record.definition
-          );
-          if (canonical) replacements.push({ ...valid, data: canonical.data });
+      for (const plugin of plugins) {
+        if (names.has(plugin.name))
+          throw new Error(`Backend plugin "${plugin.name}" is duplicated`);
+        if (prefixes.has(plugin.keyPrefix)) {
+          throw new Error(`Backend plugin key prefix "${plugin.keyPrefix}" is duplicated`);
         }
-      }
-      const result = await this.evalFog(import_vtt.FOG_META_LWW_SCRIPT, room, record, [
-        expectedMeta ?? "",
-        JSON.stringify(expectedTiles),
-        JSON.stringify(replacements)
-      ]);
-      if (Array.isArray(result) && result[0] === 2) continue;
-      return (0, import_vtt.parseFogRedisMetaResult)(result, import_sync.isValidFogMetaRecord);
-    }
-    throw new Error("Redis fog meta update did not converge after concurrent writes");
-  }
-  async applyFogTile(room, record) {
-    const result = await this.applyFogPatch(room, [record]);
-    if (result.accepted.length === 1) return { accepted: true };
-    return { accepted: false, correction: result.corrections[0] };
-  }
-  async applyFogPatch(room, records) {
-    for (let attempt = 0; attempt < 4; attempt++) {
-      const metaRaw = await this.client.hGet(this.fogMetaKey(room), "current");
-      if (metaRaw === null) return { accepted: [], corrections: [] };
-      let meta;
-      try {
-        meta = JSON.parse(metaRaw);
-      } catch {
-        return { accepted: [], corrections: [] };
-      }
-      if (!(0, import_sync.isValidFogMetaRecord)(meta) || !meta.definition) {
-        return { accepted: [], corrections: [] };
-      }
-      const definition = meta.definition;
-      const stored = await this.client.hGetAll(this.fogTilesKey(room));
-      const invalidStored = {};
-      for (const [field, raw] of Object.entries(stored)) {
-        let parsed;
+        names.add(plugin.name);
+        prefixes.add(plugin.keyPrefix);
+        const localDisposers = [];
+        const serviceKeys = [];
         try {
-          parsed = JSON.parse(raw);
-        } catch {
-          invalidStored[field] = raw;
-          continue;
-        }
-        if (!(0, import_sync.isValidFogSnapshot)({ meta, tiles: [parsed] })) invalidStored[field] = raw;
-      }
-      if (records.some((tile) => !(0, import_sync.isValidFogSnapshot)({ meta, tiles: [tile] }))) {
-        return {
-          accepted: [],
-          corrections: records.map((tile) => {
-            const raw = stored[`${tile.x},${tile.y}`];
-            if (raw) {
-              try {
-                const parsed = JSON.parse(raw);
-                if ((0, import_sync.isValidFogSnapshot)({ meta, tiles: [parsed] })) return parsed;
-              } catch {
+          plugin.start({
+            client: this.client,
+            roomKeyPrefix: this.keyPrefix,
+            registerService: (key, service) => {
+              if (this.services.has(key.id)) {
+                throw new Error(`Backend service "${key.name}" is already registered`);
               }
-            }
-            return {
-              generation: definition.generation,
-              x: tile.x,
-              y: tile.y,
-              version: 1,
-              editor: "hub"
-            };
-          })
-        };
+              this.services.set(key.id, service);
+              serviceKeys.push(key.id);
+            },
+            addDisposer: (dispose) => localDisposers.push(dispose)
+          });
+        } catch (error) {
+          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);
+          for (const key of serviceKeys) this.services.delete(key);
+          throw error;
+        }
+        this.pluginDisposers.push(() => {
+          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);
+          for (const key of serviceKeys) this.services.delete(key);
+        });
       }
-      const result = await this.evalFog(import_vtt.FOG_PATCH_LWW_SCRIPT, room, records, [
-        metaRaw,
-        JSON.stringify(invalidStored)
-      ]);
-      if (Array.isArray(result) && result[0] === 2) continue;
-      return (0, import_vtt.parseFogRedisPatchResult)(result);
-    }
-    throw new Error("Redis fog patch did not converge after concurrent definition writes");
-  }
-  async evalFog(script, room, record, extraArguments = []) {
-    if (!this.client.eval) {
-      throw new Error("Redis fog persistence requires a Redis client with EVAL support");
+    } catch (error) {
+      this.dispose();
+      throw error;
     }
-    return this.client.eval(script, {
-      keys: [this.fogMetaKey(room), this.fogTilesKey(room)],
-      arguments: [JSON.stringify(record), ...extraArguments]
-    });
   }
 };
+function safelyDispose(dispose) {
+  try {
+    dispose();
+  } catch {
+  }
+}
 
 // src/redis-hub-fanout.ts
 var RedisHubFanout = class {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/redis-hub-backend.ts","../src/redis-hub-fanout.ts"],"sourcesContent":["export { RedisHubBackend } from './redis-hub-backend';\nexport type { RedisHubBackendOptions } from './redis-hub-backend';\nexport type { RedisHashClient } from './redis-hash-client';\nexport { RedisHubFanout } from './redis-hub-fanout';\nexport type { RedisHubFanoutOptions } from './redis-hub-fanout';\nexport type { RedisPublisher, RedisSubscriber } from './redis-fanout-client';\nexport type {\n  BackendSyncPlugin,\n  ApplyResult,\n  BackendOpContext,\n  PluginSnapshot,\n} from './sync-plugin';\n","import {\n  isValidElement,\n  isValidLayerRecord,\n  isValidFogMetaRecord,\n  isValidFogTileRecord,\n  isValidFogSnapshot,\n  type LayerRecord,\n  type SyncOp,\n  type FogSnapshot,\n  type FogMetaRecord,\n  type FogTileRecord,\n} from '@fieldnotes/sync';\nimport {\n  canonicalizeFogTile,\n  tileIntersectsDefinition,\n  parseFogRedisMetaResult,\n  parseFogRedisPatchResult,\n  FOG_META_LWW_SCRIPT,\n  FOG_PATCH_LWW_SCRIPT,\n} from '@fieldnotes/vtt';\nimport type { CanvasElement } from '@fieldnotes/core';\nimport type { FogApplyResult, FogPatchApplyResult, HubBackend } from '@fieldnotes/sync-server';\nimport type { RedisHashClient } from './redis-hash-client';\n\nexport interface RedisHubBackendOptions {\n  keyPrefix?: string; // default 'fieldnotes:room:'\n}\n\nexport class RedisHubBackend implements HubBackend {\n  readonly sharedAcrossInstances = true;\n  private readonly client: RedisHashClient;\n  private readonly keyPrefix: string;\n\n  constructor(client: RedisHashClient, options: RedisHubBackendOptions = {}) {\n    this.client = client;\n    this.keyPrefix = options.keyPrefix ?? 'fieldnotes:room:';\n  }\n\n  private key(room: string): string {\n    return `${this.keyPrefix}${room}`;\n  }\n\n  private layersKey(room: string): string {\n    return `${this.keyPrefix}${room}:layers`;\n  }\n\n  async snapshot(room: string): Promise<CanvasElement[]> {\n    const map = await this.client.hGetAll(this.key(room));\n    const out: CanvasElement[] = [];\n    for (const value of Object.values(map)) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch {\n        continue; // skip a corrupt stored value rather than throwing the whole snapshot\n      }\n      if (isValidElement(parsed)) out.push(parsed);\n    }\n    return out;\n  }\n\n  async get(room: string, id: string): Promise<CanvasElement | undefined> {\n    const value = await this.client.hGet(this.key(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidElement(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async apply(room: string, op: SyncOp): Promise<void> {\n    const key = this.key(room);\n    if (op.kind === 'upsert')\n      await this.client.hSet(key, op.element.id, JSON.stringify(op.element));\n    else if (op.kind === 'remove') await this.client.hDel(key, op.id);\n    // 'clear' deletes elements only; the layer ledger is a separate hash and survives.\n    else if (op.kind === 'clear') await this.client.del(key);\n    // request-snapshot/snapshot never reach apply (the hub only applies data ops)\n  }\n\n  async layerRecords(room: string): Promise<LayerRecord[]> {\n    const map = await this.client.hGetAll(this.layersKey(room));\n    const out: LayerRecord[] = [];\n    for (const value of Object.values(map)) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch {\n        continue; // skip a corrupt stored value rather than throwing the whole ledger\n      }\n      if (isValidLayerRecord(parsed)) out.push(parsed);\n    }\n    return out;\n  }\n\n  async getLayerRecord(room: string, id: string): Promise<LayerRecord | undefined> {\n    const value = await this.client.hGet(this.layersKey(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidLayerRecord(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async applyLayerRecord(room: string, record: LayerRecord): Promise<void> {\n    await this.client.hSet(this.layersKey(room), record.id, JSON.stringify(record));\n  }\n\n  private fogMetaKey(room: string): string {\n    return `${this.keyPrefix}${room}:fog:meta`;\n  }\n\n  private fogTilesKey(room: string): string {\n    return `${this.keyPrefix}${room}:fog:tiles`;\n  }\n\n  async fogSnapshot(room: string): Promise<FogSnapshot | undefined> {\n    const metaStr = await this.client.hGet(this.fogMetaKey(room), 'current');\n    if (metaStr == null) return undefined;\n    let meta: unknown;\n    try {\n      meta = JSON.parse(metaStr);\n    } catch {\n      return undefined;\n    }\n    if (!isValidFogMetaRecord(meta)) return undefined;\n\n    if (!(meta as FogMetaRecord).definition) return { meta: meta as FogMetaRecord, tiles: [] };\n\n    const definition = (meta as FogMetaRecord).definition;\n    if (!definition) return { meta: meta as FogMetaRecord, tiles: [] };\n    const tileMap = await this.client.hGetAll(this.fogTilesKey(room));\n    const tiles: FogTileRecord[] = [];\n    const seen = new Set<string>();\n    for (const value of Object.values(tileMap)) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch {\n        continue;\n      }\n      if (!isValidFogTileRecord(parsed)) continue;\n      if (parsed.generation !== definition.generation) continue;\n      if (!tileIntersectsDefinition(parsed.x, parsed.y, definition)) continue;\n      if (!isValidFogSnapshot({ meta: meta as FogMetaRecord, tiles: [parsed] })) continue;\n      const key = `${parsed.x},${parsed.y}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      tiles.push(parsed);\n      if (tiles.length === 256) break;\n    }\n\n    const snapshot = { meta: meta as FogMetaRecord, tiles };\n    return isValidFogSnapshot(snapshot) ? snapshot : undefined;\n  }\n\n  async applyFogMeta(room: string, record: FogMetaRecord): Promise<FogApplyResult<FogMetaRecord>> {\n    for (let attempt = 0; attempt < 4; attempt++) {\n      const metaKey = this.fogMetaKey(room);\n      const tilesKey = this.fogTilesKey(room);\n      const expectedMeta = await this.client.hGet(metaKey, 'current');\n      const expectedTiles = await this.client.hGetAll(tilesKey);\n      const replacements: FogTileRecord[] = [];\n      let current: FogMetaRecord | undefined;\n      if (expectedMeta !== null) {\n        try {\n          const parsed: unknown = JSON.parse(expectedMeta);\n          if (isValidFogMetaRecord(parsed)) current = parsed;\n        } catch {\n          // Corrupt state is atomically replaced by a valid winning record.\n        }\n      }\n      if (\n        current?.definition &&\n        record.definition &&\n        current.definition.generation === record.definition.generation\n      ) {\n        for (const raw of Object.values(expectedTiles)) {\n          let tile: unknown;\n          try {\n            tile = JSON.parse(raw);\n          } catch {\n            continue;\n          }\n          if (!isValidFogSnapshot({ meta: current, tiles: [tile] })) continue;\n          const valid = tile as FogTileRecord;\n          if (!tileIntersectsDefinition(valid.x, valid.y, record.definition)) continue;\n          if (valid.data === undefined) {\n            replacements.push(valid);\n            continue;\n          }\n          const canonical = canonicalizeFogTile(\n            { x: valid.x, y: valid.y, data: valid.data },\n            record.definition,\n          );\n          if (canonical) replacements.push({ ...valid, data: canonical.data });\n        }\n      }\n      const result = await this.evalFog(FOG_META_LWW_SCRIPT, room, record, [\n        expectedMeta ?? '',\n        JSON.stringify(expectedTiles),\n        JSON.stringify(replacements),\n      ]);\n      if (Array.isArray(result) && result[0] === 2) continue;\n      return parseFogRedisMetaResult(result, isValidFogMetaRecord);\n    }\n    throw new Error('Redis fog meta update did not converge after concurrent writes');\n  }\n\n  async applyFogTile(room: string, record: FogTileRecord): Promise<FogApplyResult<FogTileRecord>> {\n    const result = await this.applyFogPatch(room, [record]);\n    if (result.accepted.length === 1) return { accepted: true };\n    return { accepted: false, correction: result.corrections[0] };\n  }\n\n  async applyFogPatch(\n    room: string,\n    records: readonly FogTileRecord[],\n  ): Promise<FogPatchApplyResult> {\n    for (let attempt = 0; attempt < 4; attempt++) {\n      const metaRaw = await this.client.hGet(this.fogMetaKey(room), 'current');\n      if (metaRaw === null) return { accepted: [], corrections: [] };\n      let meta: unknown;\n      try {\n        meta = JSON.parse(metaRaw);\n      } catch {\n        return { accepted: [], corrections: [] };\n      }\n      if (!isValidFogMetaRecord(meta) || !meta.definition) {\n        return { accepted: [], corrections: [] };\n      }\n      const definition = meta.definition;\n      const stored = await this.client.hGetAll(this.fogTilesKey(room));\n      const invalidStored: Record<string, string> = {};\n      for (const [field, raw] of Object.entries(stored)) {\n        let parsed: unknown;\n        try {\n          parsed = JSON.parse(raw);\n        } catch {\n          invalidStored[field] = raw;\n          continue;\n        }\n        if (!isValidFogSnapshot({ meta, tiles: [parsed] })) invalidStored[field] = raw;\n      }\n      if (records.some((tile) => !isValidFogSnapshot({ meta, tiles: [tile] }))) {\n        return {\n          accepted: [],\n          corrections: records.map((tile) => {\n            const raw = stored[`${tile.x},${tile.y}`];\n            if (raw) {\n              try {\n                const parsed: unknown = JSON.parse(raw);\n                if (isValidFogSnapshot({ meta, tiles: [parsed] })) return parsed as FogTileRecord;\n              } catch {\n                // Fall through to an authoritative tombstone.\n              }\n            }\n            return {\n              generation: definition.generation,\n              x: tile.x,\n              y: tile.y,\n              version: 1,\n              editor: 'hub',\n            };\n          }),\n        };\n      }\n      const result = await this.evalFog(FOG_PATCH_LWW_SCRIPT, room, records, [\n        metaRaw,\n        JSON.stringify(invalidStored),\n      ]);\n      if (Array.isArray(result) && result[0] === 2) continue;\n      return parseFogRedisPatchResult(result);\n    }\n    throw new Error('Redis fog patch did not converge after concurrent definition writes');\n  }\n\n  private async evalFog(\n    script: string,\n    room: string,\n    record: object,\n    extraArguments: string[] = [],\n  ): Promise<unknown> {\n    if (!this.client.eval) {\n      throw new Error('Redis fog persistence requires a Redis client with EVAL support');\n    }\n    return this.client.eval(script, {\n      keys: [this.fogMetaKey(room), this.fogTilesKey(room)],\n      arguments: [JSON.stringify(record), ...extraArguments],\n    });\n  }\n}\n","import type { HubFanout } from '@fieldnotes/sync-server';\nimport type { RedisPublisher, RedisSubscriber } from './redis-fanout-client';\n\nexport interface RedisHubFanoutOptions {\n  channel?: string;\n  onError?: (err: unknown) => void;\n}\n\nexport class RedisHubFanout implements HubFanout {\n  private readonly publisher: RedisPublisher;\n  private readonly subscriber: RedisSubscriber;\n  private readonly channel: string;\n  private readonly onError: (err: unknown) => void;\n  private readonly handlers = new Set<(payload: string) => void>();\n  private subscribed = false;\n\n  constructor(\n    publisher: RedisPublisher,\n    subscriber: RedisSubscriber,\n    options: RedisHubFanoutOptions = {},\n  ) {\n    this.publisher = publisher;\n    this.subscriber = subscriber;\n    this.channel = options.channel ?? 'fieldnotes:fanout';\n    this.onError = options.onError ?? (() => undefined);\n  }\n\n  async publish(payload: string): Promise<void> {\n    try {\n      await this.publisher.publish(this.channel, payload);\n    } catch (error) {\n      try {\n        this.onError(error);\n      } catch {\n        /* preserve the publication failure even when the observer throws */\n      }\n      throw error;\n    }\n  }\n\n  subscribe(handler: (payload: string) => void): () => void {\n    this.handlers.add(handler);\n    if (!this.subscribed) {\n      this.subscribed = true;\n      Promise.resolve(\n        this.subscriber.subscribe(this.channel, (message) => {\n          for (const h of this.handlers) {\n            try {\n              h(message);\n            } catch {\n              /* isolate handlers */\n            }\n          }\n        }),\n      ).catch(this.onError);\n    }\n    return () => this.handlers.delete(handler);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/redis-hub-backend.ts","../src/redis-hub-fanout.ts"],"sourcesContent":["export { RedisHubBackend } from './redis-hub-backend';\nexport type { RedisHubBackendOptions } from './redis-hub-backend';\nexport type { RedisHashClient } from './redis-hash-client';\nexport { RedisHubFanout } from './redis-hub-fanout';\nexport type { RedisHubFanoutOptions } from './redis-hub-fanout';\nexport type { RedisPublisher, RedisSubscriber } from './redis-fanout-client';\nexport type { BackendSyncPlugin, BackendPluginContext } from './sync-plugin';\n","import type { CanvasElement, ServiceKey } from '@fieldnotes/core';\nimport {\n  isValidElement,\n  isValidLayerRecord,\n  type LayerRecord,\n  type SyncOp,\n} from '@fieldnotes/sync';\nimport type { HubBackend } from '@fieldnotes/sync-server';\nimport type { RedisHashClient } from './redis-hash-client';\nimport type { BackendSyncPlugin } from './sync-plugin';\n\nexport interface RedisHubBackendOptions {\n  keyPrefix?: string;\n  plugins?: readonly BackendSyncPlugin[];\n}\n\nexport class RedisHubBackend implements HubBackend {\n  readonly sharedAcrossInstances = true;\n  private readonly client: RedisHashClient;\n  private readonly keyPrefix: string;\n  private readonly services = new Map<symbol, unknown>();\n  private readonly pluginDisposers: (() => void)[] = [];\n\n  constructor(client: RedisHashClient, options: RedisHubBackendOptions = {}) {\n    this.client = client;\n    this.keyPrefix = options.keyPrefix ?? 'fieldnotes:room:';\n    this.installPlugins(options.plugins ?? []);\n  }\n\n  getService<T>(key: ServiceKey<T>): T | undefined {\n    return this.services.get(key.id) as T | undefined;\n  }\n\n  private key(room: string): string {\n    return `${this.keyPrefix}${room}`;\n  }\n\n  private layersKey(room: string): string {\n    return `${this.keyPrefix}${room}:layers`;\n  }\n\n  async snapshot(room: string): Promise<CanvasElement[]> {\n    const map = await this.client.hGetAll(this.key(room));\n    const out: CanvasElement[] = [];\n    for (const value of Object.values(map)) {\n      try {\n        const parsed: unknown = JSON.parse(value);\n        if (isValidElement(parsed)) out.push(parsed);\n      } catch {\n        // Corrupt fields are isolated from the rest of the room snapshot.\n      }\n    }\n    return out;\n  }\n\n  async get(room: string, id: string): Promise<CanvasElement | undefined> {\n    const value = await this.client.hGet(this.key(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidElement(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async apply(room: string, op: SyncOp): Promise<void> {\n    const key = this.key(room);\n    if (op.kind === 'upsert')\n      await this.client.hSet(key, op.element.id, JSON.stringify(op.element));\n    else if (op.kind === 'remove') await this.client.hDel(key, op.id);\n    else if (op.kind === 'clear') await this.client.del(key);\n  }\n\n  async layerRecords(room: string): Promise<LayerRecord[]> {\n    const map = await this.client.hGetAll(this.layersKey(room));\n    const out: LayerRecord[] = [];\n    for (const value of Object.values(map)) {\n      try {\n        const parsed: unknown = JSON.parse(value);\n        if (isValidLayerRecord(parsed)) out.push(parsed);\n      } catch {\n        // Corrupt fields are isolated from the rest of the layer ledger.\n      }\n    }\n    return out;\n  }\n\n  async getLayerRecord(room: string, id: string): Promise<LayerRecord | undefined> {\n    const value = await this.client.hGet(this.layersKey(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidLayerRecord(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async applyLayerRecord(room: string, record: LayerRecord): Promise<void> {\n    await this.client.hSet(this.layersKey(room), record.id, JSON.stringify(record));\n  }\n\n  dispose(): void {\n    for (const dispose of [...this.pluginDisposers].reverse()) safelyDispose(dispose);\n    this.pluginDisposers.length = 0;\n    this.services.clear();\n  }\n\n  private installPlugins(plugins: readonly BackendSyncPlugin[]): void {\n    const names = new Set<string>();\n    const prefixes = new Set<string>();\n    try {\n      for (const plugin of plugins) {\n        if (names.has(plugin.name))\n          throw new Error(`Backend plugin \"${plugin.name}\" is duplicated`);\n        if (prefixes.has(plugin.keyPrefix)) {\n          throw new Error(`Backend plugin key prefix \"${plugin.keyPrefix}\" is duplicated`);\n        }\n        names.add(plugin.name);\n        prefixes.add(plugin.keyPrefix);\n        const localDisposers: (() => void)[] = [];\n        const serviceKeys: symbol[] = [];\n        try {\n          plugin.start({\n            client: this.client,\n            roomKeyPrefix: this.keyPrefix,\n            registerService: (key, service) => {\n              if (this.services.has(key.id)) {\n                throw new Error(`Backend service \"${key.name}\" is already registered`);\n              }\n              this.services.set(key.id, service);\n              serviceKeys.push(key.id);\n            },\n            addDisposer: (dispose) => localDisposers.push(dispose),\n          });\n        } catch (error) {\n          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);\n          for (const key of serviceKeys) this.services.delete(key);\n          throw error;\n        }\n        this.pluginDisposers.push(() => {\n          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);\n          for (const key of serviceKeys) this.services.delete(key);\n        });\n      }\n    } catch (error) {\n      this.dispose();\n      throw error;\n    }\n  }\n}\n\nfunction safelyDispose(dispose: () => void): void {\n  try {\n    dispose();\n  } catch {\n    // Continue rolling back later resources.\n  }\n}\n","import type { HubFanout } from '@fieldnotes/sync-server';\nimport type { RedisPublisher, RedisSubscriber } from './redis-fanout-client';\n\nexport interface RedisHubFanoutOptions {\n  channel?: string;\n  onError?: (err: unknown) => void;\n}\n\nexport class RedisHubFanout implements HubFanout {\n  private readonly publisher: RedisPublisher;\n  private readonly subscriber: RedisSubscriber;\n  private readonly channel: string;\n  private readonly onError: (err: unknown) => void;\n  private readonly handlers = new Set<(payload: string) => void>();\n  private subscribed = false;\n\n  constructor(\n    publisher: RedisPublisher,\n    subscriber: RedisSubscriber,\n    options: RedisHubFanoutOptions = {},\n  ) {\n    this.publisher = publisher;\n    this.subscriber = subscriber;\n    this.channel = options.channel ?? 'fieldnotes:fanout';\n    this.onError = options.onError ?? (() => undefined);\n  }\n\n  async publish(payload: string): Promise<void> {\n    try {\n      await this.publisher.publish(this.channel, payload);\n    } catch (error) {\n      try {\n        this.onError(error);\n      } catch {\n        /* preserve the publication failure even when the observer throws */\n      }\n      throw error;\n    }\n  }\n\n  subscribe(handler: (payload: string) => void): () => void {\n    this.handlers.add(handler);\n    if (!this.subscribed) {\n      this.subscribed = true;\n      Promise.resolve(\n        this.subscriber.subscribe(this.channel, (message) => {\n          for (const h of this.handlers) {\n            try {\n              h(message);\n            } catch {\n              /* isolate handlers */\n            }\n          }\n        }),\n      ).catch(this.onError);\n    }\n    return () => this.handlers.delete(handler);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { SyncOp, LayerRecord, FogSnapshot, FogMetaRecord, FogTileRecord } from '@fieldnotes/sync';
-import { CanvasElement } from '@fieldnotes/core';
-import { HubBackend, FogApplyResult, FogPatchApplyResult, HubFanout } from '@fieldnotes/sync-server';
+import { ServiceKey, CanvasElement } from '@fieldnotes/core';
+import { SyncOp, LayerRecord } from '@fieldnotes/sync';
+import { HubBackend, HubFanout } from '@fieldnotes/sync-server';
 
 interface RedisHashClient {
     hGetAll(key: string): Promise<Record<string, string>>;
@@ -8,21 +8,38 @@ interface RedisHashClient {
     hSet(key: string, field: string, value: string): Promise<unknown>;
     hDel(key: string, field: string): Promise<unknown>;
     del(key: string): Promise<unknown>;
-    /** Required for atomic fog LWW updates; node-redis conforms directly. */
+    /** Optional primitive used by backend plugins for atomic updates; node-redis conforms directly. */
     eval(script: string, options: {
         keys: string[];
         arguments: string[];
     }): Promise<unknown>;
 }
 
+interface BackendPluginContext {
+    readonly client: RedisHashClient;
+    readonly roomKeyPrefix: string;
+    registerService<T>(key: ServiceKey<T>, service: NoInfer<T>): void;
+    addDisposer(dispose: () => void): void;
+}
+interface BackendSyncPlugin {
+    readonly name: string;
+    readonly keyPrefix: string;
+    readonly scripts?: Readonly<Record<string, string>>;
+    start(context: BackendPluginContext): void;
+}
+
 interface RedisHubBackendOptions {
     keyPrefix?: string;
+    plugins?: readonly BackendSyncPlugin[];
 }
 declare class RedisHubBackend implements HubBackend {
     readonly sharedAcrossInstances = true;
     private readonly client;
     private readonly keyPrefix;
+    private readonly services;
+    private readonly pluginDisposers;
     constructor(client: RedisHashClient, options?: RedisHubBackendOptions);
+    getService<T>(key: ServiceKey<T>): T | undefined;
     private key;
     private layersKey;
     snapshot(room: string): Promise<CanvasElement[]>;
@@ -31,13 +48,8 @@ declare class RedisHubBackend implements HubBackend {
     layerRecords(room: string): Promise<LayerRecord[]>;
     getLayerRecord(room: string, id: string): Promise<LayerRecord | undefined>;
     applyLayerRecord(room: string, record: LayerRecord): Promise<void>;
-    private fogMetaKey;
-    private fogTilesKey;
-    fogSnapshot(room: string): Promise<FogSnapshot | undefined>;
-    applyFogMeta(room: string, record: FogMetaRecord): Promise<FogApplyResult<FogMetaRecord>>;
-    applyFogTile(room: string, record: FogTileRecord): Promise<FogApplyResult<FogTileRecord>>;
-    applyFogPatch(room: string, records: readonly FogTileRecord[]): Promise<FogPatchApplyResult>;
-    private evalFog;
+    dispose(): void;
+    private installPlugins;
 }
 
 interface RedisPublisher {
@@ -63,27 +75,4 @@ declare class RedisHubFanout implements HubFanout {
     subscribe(handler: (payload: string) => void): () => void;
 }
 
-interface ApplyResult {
-    accepted: SyncOp | null;
-    corrections: SyncOp[];
-    broadcast?: SyncOp[];
-    locality?: 'shared' | 'local';
-}
-interface BackendOpContext {
-    readonly room: string;
-}
-interface PluginSnapshot {
-    readonly pluginName: string;
-    readonly version: number;
-    readonly data: unknown;
-}
-interface BackendSyncPlugin {
-    readonly name: string;
-    readonly keyPrefix: string;
-    readonly scripts?: Record<string, string>;
-    snapshot?(room: string): Promise<PluginSnapshot>;
-    applyOp?(op: SyncOp, ctx: BackendOpContext): Promise<ApplyResult>;
-    dispose?(): void;
-}
-
-export { type ApplyResult, type BackendOpContext, type BackendSyncPlugin, type PluginSnapshot, type RedisHashClient, RedisHubBackend, type RedisHubBackendOptions, RedisHubFanout, type RedisHubFanoutOptions, type RedisPublisher, type RedisSubscriber };
+export { type BackendPluginContext, type BackendSyncPlugin, type RedisHashClient, RedisHubBackend, type RedisHubBackendOptions, RedisHubFanout, type RedisHubFanoutOptions, type RedisPublisher, type RedisSubscriber };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { SyncOp, LayerRecord, FogSnapshot, FogMetaRecord, FogTileRecord } from '@fieldnotes/sync';
-import { CanvasElement } from '@fieldnotes/core';
-import { HubBackend, FogApplyResult, FogPatchApplyResult, HubFanout } from '@fieldnotes/sync-server';
+import { ServiceKey, CanvasElement } from '@fieldnotes/core';
+import { SyncOp, LayerRecord } from '@fieldnotes/sync';
+import { HubBackend, HubFanout } from '@fieldnotes/sync-server';
 
 interface RedisHashClient {
     hGetAll(key: string): Promise<Record<string, string>>;
@@ -8,21 +8,38 @@ interface RedisHashClient {
     hSet(key: string, field: string, value: string): Promise<unknown>;
     hDel(key: string, field: string): Promise<unknown>;
     del(key: string): Promise<unknown>;
-    /** Required for atomic fog LWW updates; node-redis conforms directly. */
+    /** Optional primitive used by backend plugins for atomic updates; node-redis conforms directly. */
     eval(script: string, options: {
         keys: string[];
         arguments: string[];
     }): Promise<unknown>;
 }
 
+interface BackendPluginContext {
+    readonly client: RedisHashClient;
+    readonly roomKeyPrefix: string;
+    registerService<T>(key: ServiceKey<T>, service: NoInfer<T>): void;
+    addDisposer(dispose: () => void): void;
+}
+interface BackendSyncPlugin {
+    readonly name: string;
+    readonly keyPrefix: string;
+    readonly scripts?: Readonly<Record<string, string>>;
+    start(context: BackendPluginContext): void;
+}
+
 interface RedisHubBackendOptions {
     keyPrefix?: string;
+    plugins?: readonly BackendSyncPlugin[];
 }
 declare class RedisHubBackend implements HubBackend {
     readonly sharedAcrossInstances = true;
     private readonly client;
     private readonly keyPrefix;
+    private readonly services;
+    private readonly pluginDisposers;
     constructor(client: RedisHashClient, options?: RedisHubBackendOptions);
+    getService<T>(key: ServiceKey<T>): T | undefined;
     private key;
     private layersKey;
     snapshot(room: string): Promise<CanvasElement[]>;
@@ -31,13 +48,8 @@ declare class RedisHubBackend implements HubBackend {
     layerRecords(room: string): Promise<LayerRecord[]>;
     getLayerRecord(room: string, id: string): Promise<LayerRecord | undefined>;
     applyLayerRecord(room: string, record: LayerRecord): Promise<void>;
-    private fogMetaKey;
-    private fogTilesKey;
-    fogSnapshot(room: string): Promise<FogSnapshot | undefined>;
-    applyFogMeta(room: string, record: FogMetaRecord): Promise<FogApplyResult<FogMetaRecord>>;
-    applyFogTile(room: string, record: FogTileRecord): Promise<FogApplyResult<FogTileRecord>>;
-    applyFogPatch(room: string, records: readonly FogTileRecord[]): Promise<FogPatchApplyResult>;
-    private evalFog;
+    dispose(): void;
+    private installPlugins;
 }
 
 interface RedisPublisher {
@@ -63,27 +75,4 @@ declare class RedisHubFanout implements HubFanout {
     subscribe(handler: (payload: string) => void): () => void;
 }
 
-interface ApplyResult {
-    accepted: SyncOp | null;
-    corrections: SyncOp[];
-    broadcast?: SyncOp[];
-    locality?: 'shared' | 'local';
-}
-interface BackendOpContext {
-    readonly room: string;
-}
-interface PluginSnapshot {
-    readonly pluginName: string;
-    readonly version: number;
-    readonly data: unknown;
-}
-interface BackendSyncPlugin {
-    readonly name: string;
-    readonly keyPrefix: string;
-    readonly scripts?: Record<string, string>;
-    snapshot?(room: string): Promise<PluginSnapshot>;
-    applyOp?(op: SyncOp, ctx: BackendOpContext): Promise<ApplyResult>;
-    dispose?(): void;
-}
-
-export { type ApplyResult, type BackendOpContext, type BackendSyncPlugin, type PluginSnapshot, type RedisHashClient, RedisHubBackend, type RedisHubBackendOptions, RedisHubFanout, type RedisHubFanoutOptions, type RedisPublisher, type RedisSubscriber };
+export { type BackendPluginContext, type BackendSyncPlugin, type RedisHashClient, RedisHubBackend, type RedisHubBackendOptions, RedisHubFanout, type RedisHubFanoutOptions, type RedisPublisher, type RedisSubscriber };

package/dist/index.js

@@ -1,26 +1,21 @@
 // src/redis-hub-backend.ts
 import {
   isValidElement,
-  isValidLayerRecord,
-  isValidFogMetaRecord,
-  isValidFogTileRecord,
-  isValidFogSnapshot
+  isValidLayerRecord
 } from "@fieldnotes/sync";
-import {
-  canonicalizeFogTile,
-  tileIntersectsDefinition,
-  parseFogRedisMetaResult,
-  parseFogRedisPatchResult,
-  FOG_META_LWW_SCRIPT,
-  FOG_PATCH_LWW_SCRIPT
-} from "@fieldnotes/vtt";
 var RedisHubBackend = class {
   sharedAcrossInstances = true;
   client;
   keyPrefix;
+  services = /* @__PURE__ */ new Map();
+  pluginDisposers = [];
   constructor(client, options = {}) {
     this.client = client;
     this.keyPrefix = options.keyPrefix ?? "fieldnotes:room:";
+    this.installPlugins(options.plugins ?? []);
+  }
+  getService(key) {
+    return this.services.get(key.id);
   }
   key(room) {
     return `${this.keyPrefix}${room}`;
@@ -32,13 +27,11 @@ var RedisHubBackend = class {
     const map = await this.client.hGetAll(this.key(room));
     const out = [];
     for (const value of Object.values(map)) {
-      let parsed;
       try {
-        parsed = JSON.parse(value);
+        const parsed = JSON.parse(value);
+        if (isValidElement(parsed)) out.push(parsed);
       } catch {
-        continue;
       }
-      if (isValidElement(parsed)) out.push(parsed);
     }
     return out;
   }
@@ -63,13 +56,11 @@ var RedisHubBackend = class {
     const map = await this.client.hGetAll(this.layersKey(room));
     const out = [];
     for (const value of Object.values(map)) {
-      let parsed;
       try {
-        parsed = JSON.parse(value);
+        const parsed = JSON.parse(value);
+        if (isValidLayerRecord(parsed)) out.push(parsed);
       } catch {
-        continue;
       }
-      if (isValidLayerRecord(parsed)) out.push(parsed);
     }
     return out;
   }
@@ -86,167 +77,60 @@ var RedisHubBackend = class {
   async applyLayerRecord(room, record) {
     await this.client.hSet(this.layersKey(room), record.id, JSON.stringify(record));
   }
-  fogMetaKey(room) {
-    return `${this.keyPrefix}${room}:fog:meta`;
-  }
-  fogTilesKey(room) {
-    return `${this.keyPrefix}${room}:fog:tiles`;
+  dispose() {
+    for (const dispose of [...this.pluginDisposers].reverse()) safelyDispose(dispose);
+    this.pluginDisposers.length = 0;
+    this.services.clear();
   }
-  async fogSnapshot(room) {
-    const metaStr = await this.client.hGet(this.fogMetaKey(room), "current");
-    if (metaStr == null) return void 0;
-    let meta;
+  installPlugins(plugins) {
+    const names = /* @__PURE__ */ new Set();
+    const prefixes = /* @__PURE__ */ new Set();
     try {
-      meta = JSON.parse(metaStr);
-    } catch {
-      return void 0;
-    }
-    if (!isValidFogMetaRecord(meta)) return void 0;
-    if (!meta.definition) return { meta, tiles: [] };
-    const definition = meta.definition;
-    if (!definition) return { meta, tiles: [] };
-    const tileMap = await this.client.hGetAll(this.fogTilesKey(room));
-    const tiles = [];
-    const seen = /* @__PURE__ */ new Set();
-    for (const value of Object.values(tileMap)) {
-      let parsed;
-      try {
-        parsed = JSON.parse(value);
-      } catch {
-        continue;
-      }
-      if (!isValidFogTileRecord(parsed)) continue;
-      if (parsed.generation !== definition.generation) continue;
-      if (!tileIntersectsDefinition(parsed.x, parsed.y, definition)) continue;
-      if (!isValidFogSnapshot({ meta, tiles: [parsed] })) continue;
-      const key = `${parsed.x},${parsed.y}`;
-      if (seen.has(key)) continue;
-      seen.add(key);
-      tiles.push(parsed);
-      if (tiles.length === 256) break;
-    }
-    const snapshot = { meta, tiles };
-    return isValidFogSnapshot(snapshot) ? snapshot : void 0;
-  }
-  async applyFogMeta(room, record) {
-    for (let attempt = 0; attempt < 4; attempt++) {
-      const metaKey = this.fogMetaKey(room);
-      const tilesKey = this.fogTilesKey(room);
-      const expectedMeta = await this.client.hGet(metaKey, "current");
-      const expectedTiles = await this.client.hGetAll(tilesKey);
-      const replacements = [];
-      let current;
-      if (expectedMeta !== null) {
-        try {
-          const parsed = JSON.parse(expectedMeta);
-          if (isValidFogMetaRecord(parsed)) current = parsed;
-        } catch {
-        }
-      }
-      if (current?.definition && record.definition && current.definition.generation === record.definition.generation) {
-        for (const raw of Object.values(expectedTiles)) {
-          let tile;
-          try {
-            tile = JSON.parse(raw);
-          } catch {
-            continue;
-          }
-          if (!isValidFogSnapshot({ meta: current, tiles: [tile] })) continue;
-          const valid = tile;
-          if (!tileIntersectsDefinition(valid.x, valid.y, record.definition)) continue;
-          if (valid.data === void 0) {
-            replacements.push(valid);
-            continue;
-          }
-          const canonical = canonicalizeFogTile(
-            { x: valid.x, y: valid.y, data: valid.data },
-            record.definition
-          );
-          if (canonical) replacements.push({ ...valid, data: canonical.data });
+      for (const plugin of plugins) {
+        if (names.has(plugin.name))
+          throw new Error(`Backend plugin "${plugin.name}" is duplicated`);
+        if (prefixes.has(plugin.keyPrefix)) {
+          throw new Error(`Backend plugin key prefix "${plugin.keyPrefix}" is duplicated`);
         }
-      }
-      const result = await this.evalFog(FOG_META_LWW_SCRIPT, room, record, [
-        expectedMeta ?? "",
-        JSON.stringify(expectedTiles),
-        JSON.stringify(replacements)
-      ]);
-      if (Array.isArray(result) && result[0] === 2) continue;
-      return parseFogRedisMetaResult(result, isValidFogMetaRecord);
-    }
-    throw new Error("Redis fog meta update did not converge after concurrent writes");
-  }
-  async applyFogTile(room, record) {
-    const result = await this.applyFogPatch(room, [record]);
-    if (result.accepted.length === 1) return { accepted: true };
-    return { accepted: false, correction: result.corrections[0] };
-  }
-  async applyFogPatch(room, records) {
-    for (let attempt = 0; attempt < 4; attempt++) {
-      const metaRaw = await this.client.hGet(this.fogMetaKey(room), "current");
-      if (metaRaw === null) return { accepted: [], corrections: [] };
-      let meta;
-      try {
-        meta = JSON.parse(metaRaw);
-      } catch {
-        return { accepted: [], corrections: [] };
-      }
-      if (!isValidFogMetaRecord(meta) || !meta.definition) {
-        return { accepted: [], corrections: [] };
-      }
-      const definition = meta.definition;
-      const stored = await this.client.hGetAll(this.fogTilesKey(room));
-      const invalidStored = {};
-      for (const [field, raw] of Object.entries(stored)) {
-        let parsed;
+        names.add(plugin.name);
+        prefixes.add(plugin.keyPrefix);
+        const localDisposers = [];
+        const serviceKeys = [];
         try {
-          parsed = JSON.parse(raw);
-        } catch {
-          invalidStored[field] = raw;
-          continue;
-        }
-        if (!isValidFogSnapshot({ meta, tiles: [parsed] })) invalidStored[field] = raw;
-      }
-      if (records.some((tile) => !isValidFogSnapshot({ meta, tiles: [tile] }))) {
-        return {
-          accepted: [],
-          corrections: records.map((tile) => {
-            const raw = stored[`${tile.x},${tile.y}`];
-            if (raw) {
-              try {
-                const parsed = JSON.parse(raw);
-                if (isValidFogSnapshot({ meta, tiles: [parsed] })) return parsed;
-              } catch {
+          plugin.start({
+            client: this.client,
+            roomKeyPrefix: this.keyPrefix,
+            registerService: (key, service) => {
+              if (this.services.has(key.id)) {
+                throw new Error(`Backend service "${key.name}" is already registered`);
               }
-            }
-            return {
-              generation: definition.generation,
-              x: tile.x,
-              y: tile.y,
-              version: 1,
-              editor: "hub"
-            };
-          })
-        };
+              this.services.set(key.id, service);
+              serviceKeys.push(key.id);
+            },
+            addDisposer: (dispose) => localDisposers.push(dispose)
+          });
+        } catch (error) {
+          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);
+          for (const key of serviceKeys) this.services.delete(key);
+          throw error;
+        }
+        this.pluginDisposers.push(() => {
+          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);
+          for (const key of serviceKeys) this.services.delete(key);
+        });
       }
-      const result = await this.evalFog(FOG_PATCH_LWW_SCRIPT, room, records, [
-        metaRaw,
-        JSON.stringify(invalidStored)
-      ]);
-      if (Array.isArray(result) && result[0] === 2) continue;
-      return parseFogRedisPatchResult(result);
-    }
-    throw new Error("Redis fog patch did not converge after concurrent definition writes");
-  }
-  async evalFog(script, room, record, extraArguments = []) {
-    if (!this.client.eval) {
-      throw new Error("Redis fog persistence requires a Redis client with EVAL support");
+    } catch (error) {
+      this.dispose();
+      throw error;
     }
-    return this.client.eval(script, {
-      keys: [this.fogMetaKey(room), this.fogTilesKey(room)],
-      arguments: [JSON.stringify(record), ...extraArguments]
-    });
   }
 };
+function safelyDispose(dispose) {
+  try {
+    dispose();
+  } catch {
+  }
+}
 
 // src/redis-hub-fanout.ts
 var RedisHubFanout = class {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/redis-hub-backend.ts","../src/redis-hub-fanout.ts"],"sourcesContent":["import {\n  isValidElement,\n  isValidLayerRecord,\n  isValidFogMetaRecord,\n  isValidFogTileRecord,\n  isValidFogSnapshot,\n  type LayerRecord,\n  type SyncOp,\n  type FogSnapshot,\n  type FogMetaRecord,\n  type FogTileRecord,\n} from '@fieldnotes/sync';\nimport {\n  canonicalizeFogTile,\n  tileIntersectsDefinition,\n  parseFogRedisMetaResult,\n  parseFogRedisPatchResult,\n  FOG_META_LWW_SCRIPT,\n  FOG_PATCH_LWW_SCRIPT,\n} from '@fieldnotes/vtt';\nimport type { CanvasElement } from '@fieldnotes/core';\nimport type { FogApplyResult, FogPatchApplyResult, HubBackend } from '@fieldnotes/sync-server';\nimport type { RedisHashClient } from './redis-hash-client';\n\nexport interface RedisHubBackendOptions {\n  keyPrefix?: string; // default 'fieldnotes:room:'\n}\n\nexport class RedisHubBackend implements HubBackend {\n  readonly sharedAcrossInstances = true;\n  private readonly client: RedisHashClient;\n  private readonly keyPrefix: string;\n\n  constructor(client: RedisHashClient, options: RedisHubBackendOptions = {}) {\n    this.client = client;\n    this.keyPrefix = options.keyPrefix ?? 'fieldnotes:room:';\n  }\n\n  private key(room: string): string {\n    return `${this.keyPrefix}${room}`;\n  }\n\n  private layersKey(room: string): string {\n    return `${this.keyPrefix}${room}:layers`;\n  }\n\n  async snapshot(room: string): Promise<CanvasElement[]> {\n    const map = await this.client.hGetAll(this.key(room));\n    const out: CanvasElement[] = [];\n    for (const value of Object.values(map)) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch {\n        continue; // skip a corrupt stored value rather than throwing the whole snapshot\n      }\n      if (isValidElement(parsed)) out.push(parsed);\n    }\n    return out;\n  }\n\n  async get(room: string, id: string): Promise<CanvasElement | undefined> {\n    const value = await this.client.hGet(this.key(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidElement(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async apply(room: string, op: SyncOp): Promise<void> {\n    const key = this.key(room);\n    if (op.kind === 'upsert')\n      await this.client.hSet(key, op.element.id, JSON.stringify(op.element));\n    else if (op.kind === 'remove') await this.client.hDel(key, op.id);\n    // 'clear' deletes elements only; the layer ledger is a separate hash and survives.\n    else if (op.kind === 'clear') await this.client.del(key);\n    // request-snapshot/snapshot never reach apply (the hub only applies data ops)\n  }\n\n  async layerRecords(room: string): Promise<LayerRecord[]> {\n    const map = await this.client.hGetAll(this.layersKey(room));\n    const out: LayerRecord[] = [];\n    for (const value of Object.values(map)) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch {\n        continue; // skip a corrupt stored value rather than throwing the whole ledger\n      }\n      if (isValidLayerRecord(parsed)) out.push(parsed);\n    }\n    return out;\n  }\n\n  async getLayerRecord(room: string, id: string): Promise<LayerRecord | undefined> {\n    const value = await this.client.hGet(this.layersKey(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidLayerRecord(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async applyLayerRecord(room: string, record: LayerRecord): Promise<void> {\n    await this.client.hSet(this.layersKey(room), record.id, JSON.stringify(record));\n  }\n\n  private fogMetaKey(room: string): string {\n    return `${this.keyPrefix}${room}:fog:meta`;\n  }\n\n  private fogTilesKey(room: string): string {\n    return `${this.keyPrefix}${room}:fog:tiles`;\n  }\n\n  async fogSnapshot(room: string): Promise<FogSnapshot | undefined> {\n    const metaStr = await this.client.hGet(this.fogMetaKey(room), 'current');\n    if (metaStr == null) return undefined;\n    let meta: unknown;\n    try {\n      meta = JSON.parse(metaStr);\n    } catch {\n      return undefined;\n    }\n    if (!isValidFogMetaRecord(meta)) return undefined;\n\n    if (!(meta as FogMetaRecord).definition) return { meta: meta as FogMetaRecord, tiles: [] };\n\n    const definition = (meta as FogMetaRecord).definition;\n    if (!definition) return { meta: meta as FogMetaRecord, tiles: [] };\n    const tileMap = await this.client.hGetAll(this.fogTilesKey(room));\n    const tiles: FogTileRecord[] = [];\n    const seen = new Set<string>();\n    for (const value of Object.values(tileMap)) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch {\n        continue;\n      }\n      if (!isValidFogTileRecord(parsed)) continue;\n      if (parsed.generation !== definition.generation) continue;\n      if (!tileIntersectsDefinition(parsed.x, parsed.y, definition)) continue;\n      if (!isValidFogSnapshot({ meta: meta as FogMetaRecord, tiles: [parsed] })) continue;\n      const key = `${parsed.x},${parsed.y}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      tiles.push(parsed);\n      if (tiles.length === 256) break;\n    }\n\n    const snapshot = { meta: meta as FogMetaRecord, tiles };\n    return isValidFogSnapshot(snapshot) ? snapshot : undefined;\n  }\n\n  async applyFogMeta(room: string, record: FogMetaRecord): Promise<FogApplyResult<FogMetaRecord>> {\n    for (let attempt = 0; attempt < 4; attempt++) {\n      const metaKey = this.fogMetaKey(room);\n      const tilesKey = this.fogTilesKey(room);\n      const expectedMeta = await this.client.hGet(metaKey, 'current');\n      const expectedTiles = await this.client.hGetAll(tilesKey);\n      const replacements: FogTileRecord[] = [];\n      let current: FogMetaRecord | undefined;\n      if (expectedMeta !== null) {\n        try {\n          const parsed: unknown = JSON.parse(expectedMeta);\n          if (isValidFogMetaRecord(parsed)) current = parsed;\n        } catch {\n          // Corrupt state is atomically replaced by a valid winning record.\n        }\n      }\n      if (\n        current?.definition &&\n        record.definition &&\n        current.definition.generation === record.definition.generation\n      ) {\n        for (const raw of Object.values(expectedTiles)) {\n          let tile: unknown;\n          try {\n            tile = JSON.parse(raw);\n          } catch {\n            continue;\n          }\n          if (!isValidFogSnapshot({ meta: current, tiles: [tile] })) continue;\n          const valid = tile as FogTileRecord;\n          if (!tileIntersectsDefinition(valid.x, valid.y, record.definition)) continue;\n          if (valid.data === undefined) {\n            replacements.push(valid);\n            continue;\n          }\n          const canonical = canonicalizeFogTile(\n            { x: valid.x, y: valid.y, data: valid.data },\n            record.definition,\n          );\n          if (canonical) replacements.push({ ...valid, data: canonical.data });\n        }\n      }\n      const result = await this.evalFog(FOG_META_LWW_SCRIPT, room, record, [\n        expectedMeta ?? '',\n        JSON.stringify(expectedTiles),\n        JSON.stringify(replacements),\n      ]);\n      if (Array.isArray(result) && result[0] === 2) continue;\n      return parseFogRedisMetaResult(result, isValidFogMetaRecord);\n    }\n    throw new Error('Redis fog meta update did not converge after concurrent writes');\n  }\n\n  async applyFogTile(room: string, record: FogTileRecord): Promise<FogApplyResult<FogTileRecord>> {\n    const result = await this.applyFogPatch(room, [record]);\n    if (result.accepted.length === 1) return { accepted: true };\n    return { accepted: false, correction: result.corrections[0] };\n  }\n\n  async applyFogPatch(\n    room: string,\n    records: readonly FogTileRecord[],\n  ): Promise<FogPatchApplyResult> {\n    for (let attempt = 0; attempt < 4; attempt++) {\n      const metaRaw = await this.client.hGet(this.fogMetaKey(room), 'current');\n      if (metaRaw === null) return { accepted: [], corrections: [] };\n      let meta: unknown;\n      try {\n        meta = JSON.parse(metaRaw);\n      } catch {\n        return { accepted: [], corrections: [] };\n      }\n      if (!isValidFogMetaRecord(meta) || !meta.definition) {\n        return { accepted: [], corrections: [] };\n      }\n      const definition = meta.definition;\n      const stored = await this.client.hGetAll(this.fogTilesKey(room));\n      const invalidStored: Record<string, string> = {};\n      for (const [field, raw] of Object.entries(stored)) {\n        let parsed: unknown;\n        try {\n          parsed = JSON.parse(raw);\n        } catch {\n          invalidStored[field] = raw;\n          continue;\n        }\n        if (!isValidFogSnapshot({ meta, tiles: [parsed] })) invalidStored[field] = raw;\n      }\n      if (records.some((tile) => !isValidFogSnapshot({ meta, tiles: [tile] }))) {\n        return {\n          accepted: [],\n          corrections: records.map((tile) => {\n            const raw = stored[`${tile.x},${tile.y}`];\n            if (raw) {\n              try {\n                const parsed: unknown = JSON.parse(raw);\n                if (isValidFogSnapshot({ meta, tiles: [parsed] })) return parsed as FogTileRecord;\n              } catch {\n                // Fall through to an authoritative tombstone.\n              }\n            }\n            return {\n              generation: definition.generation,\n              x: tile.x,\n              y: tile.y,\n              version: 1,\n              editor: 'hub',\n            };\n          }),\n        };\n      }\n      const result = await this.evalFog(FOG_PATCH_LWW_SCRIPT, room, records, [\n        metaRaw,\n        JSON.stringify(invalidStored),\n      ]);\n      if (Array.isArray(result) && result[0] === 2) continue;\n      return parseFogRedisPatchResult(result);\n    }\n    throw new Error('Redis fog patch did not converge after concurrent definition writes');\n  }\n\n  private async evalFog(\n    script: string,\n    room: string,\n    record: object,\n    extraArguments: string[] = [],\n  ): Promise<unknown> {\n    if (!this.client.eval) {\n      throw new Error('Redis fog persistence requires a Redis client with EVAL support');\n    }\n    return this.client.eval(script, {\n      keys: [this.fogMetaKey(room), this.fogTilesKey(room)],\n      arguments: [JSON.stringify(record), ...extraArguments],\n    });\n  }\n}\n","import type { HubFanout } from '@fieldnotes/sync-server';\nimport type { RedisPublisher, RedisSubscriber } from './redis-fanout-client';\n\nexport interface RedisHubFanoutOptions {\n  channel?: string;\n  onError?: (err: unknown) => void;\n}\n\nexport class RedisHubFanout implements HubFanout {\n  private readonly publisher: RedisPublisher;\n  private readonly subscriber: RedisSubscriber;\n  private readonly channel: string;\n  private readonly onError: (err: unknown) => void;\n  private readonly handlers = new Set<(payload: string) => void>();\n  private subscribed = false;\n\n  constructor(\n    publisher: RedisPublisher,\n    subscriber: RedisSubscriber,\n    options: RedisHubFanoutOptions = {},\n  ) {\n    this.publisher = publisher;\n    this.subscriber = subscriber;\n    this.channel = options.channel ?? 'fieldnotes:fanout';\n    this.onError = options.onError ?? (() => undefined);\n  }\n\n  async publish(payload: string): Promise<void> {\n    try {\n      await this.publisher.publish(this.channel, payload);\n    } catch (error) {\n      try {\n        this.onError(error);\n      } catch {\n        /* preserve the publication failure even when the observer throws */\n      }\n      throw error;\n    }\n  }\n\n  subscribe(handler: (payload: string) => void): () => void {\n    this.handlers.add(handler);\n    if (!this.subscribed) {\n      this.subscribed = true;\n      Promise.resolve(\n        this.subscriber.subscribe(this.channel, (message) => {\n          for (const h of this.handlers) {\n            try {\n              h(message);\n            } catch {\n              /* isolate handlers */\n            }\n          }\n        }),\n      ).catch(this.onError);\n    }\n    return () => this.handlers.delete(handler);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/redis-hub-backend.ts","../src/redis-hub-fanout.ts"],"sourcesContent":["import type { CanvasElement, ServiceKey } from '@fieldnotes/core';\nimport {\n  isValidElement,\n  isValidLayerRecord,\n  type LayerRecord,\n  type SyncOp,\n} from '@fieldnotes/sync';\nimport type { HubBackend } from '@fieldnotes/sync-server';\nimport type { RedisHashClient } from './redis-hash-client';\nimport type { BackendSyncPlugin } from './sync-plugin';\n\nexport interface RedisHubBackendOptions {\n  keyPrefix?: string;\n  plugins?: readonly BackendSyncPlugin[];\n}\n\nexport class RedisHubBackend implements HubBackend {\n  readonly sharedAcrossInstances = true;\n  private readonly client: RedisHashClient;\n  private readonly keyPrefix: string;\n  private readonly services = new Map<symbol, unknown>();\n  private readonly pluginDisposers: (() => void)[] = [];\n\n  constructor(client: RedisHashClient, options: RedisHubBackendOptions = {}) {\n    this.client = client;\n    this.keyPrefix = options.keyPrefix ?? 'fieldnotes:room:';\n    this.installPlugins(options.plugins ?? []);\n  }\n\n  getService<T>(key: ServiceKey<T>): T | undefined {\n    return this.services.get(key.id) as T | undefined;\n  }\n\n  private key(room: string): string {\n    return `${this.keyPrefix}${room}`;\n  }\n\n  private layersKey(room: string): string {\n    return `${this.keyPrefix}${room}:layers`;\n  }\n\n  async snapshot(room: string): Promise<CanvasElement[]> {\n    const map = await this.client.hGetAll(this.key(room));\n    const out: CanvasElement[] = [];\n    for (const value of Object.values(map)) {\n      try {\n        const parsed: unknown = JSON.parse(value);\n        if (isValidElement(parsed)) out.push(parsed);\n      } catch {\n        // Corrupt fields are isolated from the rest of the room snapshot.\n      }\n    }\n    return out;\n  }\n\n  async get(room: string, id: string): Promise<CanvasElement | undefined> {\n    const value = await this.client.hGet(this.key(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidElement(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async apply(room: string, op: SyncOp): Promise<void> {\n    const key = this.key(room);\n    if (op.kind === 'upsert')\n      await this.client.hSet(key, op.element.id, JSON.stringify(op.element));\n    else if (op.kind === 'remove') await this.client.hDel(key, op.id);\n    else if (op.kind === 'clear') await this.client.del(key);\n  }\n\n  async layerRecords(room: string): Promise<LayerRecord[]> {\n    const map = await this.client.hGetAll(this.layersKey(room));\n    const out: LayerRecord[] = [];\n    for (const value of Object.values(map)) {\n      try {\n        const parsed: unknown = JSON.parse(value);\n        if (isValidLayerRecord(parsed)) out.push(parsed);\n      } catch {\n        // Corrupt fields are isolated from the rest of the layer ledger.\n      }\n    }\n    return out;\n  }\n\n  async getLayerRecord(room: string, id: string): Promise<LayerRecord | undefined> {\n    const value = await this.client.hGet(this.layersKey(room), id);\n    if (value == null) return undefined;\n    try {\n      const parsed: unknown = JSON.parse(value);\n      return isValidLayerRecord(parsed) ? parsed : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async applyLayerRecord(room: string, record: LayerRecord): Promise<void> {\n    await this.client.hSet(this.layersKey(room), record.id, JSON.stringify(record));\n  }\n\n  dispose(): void {\n    for (const dispose of [...this.pluginDisposers].reverse()) safelyDispose(dispose);\n    this.pluginDisposers.length = 0;\n    this.services.clear();\n  }\n\n  private installPlugins(plugins: readonly BackendSyncPlugin[]): void {\n    const names = new Set<string>();\n    const prefixes = new Set<string>();\n    try {\n      for (const plugin of plugins) {\n        if (names.has(plugin.name))\n          throw new Error(`Backend plugin \"${plugin.name}\" is duplicated`);\n        if (prefixes.has(plugin.keyPrefix)) {\n          throw new Error(`Backend plugin key prefix \"${plugin.keyPrefix}\" is duplicated`);\n        }\n        names.add(plugin.name);\n        prefixes.add(plugin.keyPrefix);\n        const localDisposers: (() => void)[] = [];\n        const serviceKeys: symbol[] = [];\n        try {\n          plugin.start({\n            client: this.client,\n            roomKeyPrefix: this.keyPrefix,\n            registerService: (key, service) => {\n              if (this.services.has(key.id)) {\n                throw new Error(`Backend service \"${key.name}\" is already registered`);\n              }\n              this.services.set(key.id, service);\n              serviceKeys.push(key.id);\n            },\n            addDisposer: (dispose) => localDisposers.push(dispose),\n          });\n        } catch (error) {\n          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);\n          for (const key of serviceKeys) this.services.delete(key);\n          throw error;\n        }\n        this.pluginDisposers.push(() => {\n          for (const dispose of localDisposers.reverse()) safelyDispose(dispose);\n          for (const key of serviceKeys) this.services.delete(key);\n        });\n      }\n    } catch (error) {\n      this.dispose();\n      throw error;\n    }\n  }\n}\n\nfunction safelyDispose(dispose: () => void): void {\n  try {\n    dispose();\n  } catch {\n    // Continue rolling back later resources.\n  }\n}\n","import type { HubFanout } from '@fieldnotes/sync-server';\nimport type { RedisPublisher, RedisSubscriber } from './redis-fanout-client';\n\nexport interface RedisHubFanoutOptions {\n  channel?: string;\n  onError?: (err: unknown) => void;\n}\n\nexport class RedisHubFanout implements HubFanout {\n  private readonly publisher: RedisPublisher;\n  private readonly subscriber: RedisSubscriber;\n  private readonly channel: string;\n  private readonly onError: (err: unknown) => void;\n  private readonly handlers = new Set<(payload: string) => void>();\n  private subscribed = false;\n\n  constructor(\n    publisher: RedisPublisher,\n    subscriber: RedisSubscriber,\n    options: RedisHubFanoutOptions = {},\n  ) {\n    this.publisher = publisher;\n    this.subscriber = subscriber;\n    this.channel = options.channel ?? 'fieldnotes:fanout';\n    this.onError = options.onError ?? (() => undefined);\n  }\n\n  async publish(payload: string): Promise<void> {\n    try {\n      await this.publisher.publish(this.channel, payload);\n    } catch (error) {\n      try {\n        this.onError(error);\n      } catch {\n        /* preserve the publication failure even when the observer throws */\n      }\n      throw error;\n    }\n  }\n\n  subscribe(handler: (payload: string) => void): () => void {\n    this.handlers.add(handler);\n    if (!this.subscribed) {\n      this.subscribed = true;\n      Promise.resolve(\n        this.subscriber.subscribe(this.channel, (message) => {\n          for (const h of this.handlers) {\n            try {\n              h(message);\n            } catch {\n              /* isolate handlers */\n            }\n          }\n        }),\n      ).catch(this.onError);\n    }\n    return () => this.handlers.delete(handler);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldnotes/sync-redis",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Redis-backed HubBackend for Field Notes real-time sync relay",
   "type": "module",
   "sideEffects": false,
@@ -36,15 +36,18 @@
     "fieldnotes"
   ],
   "dependencies": {
-    "@fieldnotes/sync": "0.17.0",
-    "@fieldnotes/vtt": "0.6.2"
+    "@fieldnotes/sync": "0.18.0"
+  },
+  "peerDependencies": {
+    "@fieldnotes/core": ">=0.81.0 <1.0.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",
     "tsup": "^8.5.1",
     "vitest": "^4.1.0",
-    "@fieldnotes/sync-server": "0.16.0",
-    "@fieldnotes/core": "0.80.0"
+    "@fieldnotes/vtt": "0.7.0",
+    "@fieldnotes/core": "0.81.0",
+    "@fieldnotes/sync-server": "0.17.0"
   },
   "scripts": {
     "build": "tsup",