@nebutra/collab 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @nebutra/collab
 
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @nebutra/capability-kit@2.0.0
+  - @nebutra/tenant-store@2.0.0
+
 ## 0.2.2
 
 ### Patch Changes

package/dist/{chunk-S2HTNEZN.js → chunk-PMIKORQM.js}

@@ -29,4 +29,4 @@ var LoopbackTransport = class {
 export {
   LoopbackTransport
 };
-//# sourceMappingURL=chunk-S2HTNEZN.js.map
+//# sourceMappingURL=chunk-PMIKORQM.js.map

package/dist/chunk-PMIKORQM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/loopback.ts"],"sourcesContent":["/**\n * Zero-config default `CollabTransport`. An in-process loopback bus keyed by\n * `tenantId\\0roomId`, so a subscriber for tenant A's room can never be\n * reached by a broadcast for tenant B's room of the same id (the tenant is\n * part of the channel key, not trusted from payload).\n *\n * A real network transport (Pusher channels, a WebSocket relay) implements\n * the same `CollabTransport` interface and is injected via\n * `createCollab({ transport })`. This file intentionally ships NO network\n * code — only the loopback so zero-config single-process usage works.\n */\n\nimport type { CollabTransport } from \"../types\";\n\ntype Listener = (update: Uint8Array) => void;\n\nfunction channel(tenantId: string, roomId: string): string {\n  // NUL separator: cannot occur in normal ids, so \"a\",\"bc\" and \"ab\",\"c\"\n  // can never collide into the same channel.\n  return `${tenantId}\\0${roomId}`;\n}\n\nexport class LoopbackTransport implements CollabTransport {\n  private readonly channels = new Map<string, Set<Listener>>();\n\n  broadcast(tenantId: string, roomId: string, update: Uint8Array): void {\n    const set = this.channels.get(channel(tenantId, roomId));\n    if (!set) return;\n    // Snapshot listeners so unsubscribing during dispatch is safe.\n    for (const cb of [...set]) cb(update);\n  }\n\n  subscribe(tenantId: string, roomId: string, cb: Listener): () => void {\n    const key = channel(tenantId, roomId);\n    let set = this.channels.get(key);\n    if (!set) {\n      set = new Set();\n      this.channels.set(key, set);\n    }\n    set.add(cb);\n    return () => {\n      const s = this.channels.get(key);\n      if (!s) return;\n      s.delete(cb);\n      if (s.size === 0) this.channels.delete(key);\n    };\n  }\n}\n"],"mappings":";AAgBA,SAAS,QAAQ,UAAkB,QAAwB;AAGzD,SAAO,GAAG,QAAQ,KAAK,MAAM;AAC/B;AAEO,IAAM,oBAAN,MAAmD;AAAA,EACvC,WAAW,oBAAI,IAA2B;AAAA,EAE3D,UAAU,UAAkB,QAAgB,QAA0B;AACpE,UAAM,MAAM,KAAK,SAAS,IAAI,QAAQ,UAAU,MAAM,CAAC;AACvD,QAAI,CAAC,IAAK;AAEV,eAAW,MAAM,CAAC,GAAG,GAAG,EAAG,IAAG,MAAM;AAAA,EACtC;AAAA,EAEA,UAAU,UAAkB,QAAgB,IAA0B;AACpE,UAAM,MAAM,QAAQ,UAAU,MAAM;AACpC,QAAI,MAAM,KAAK,SAAS,IAAI,GAAG;AAC/B,QAAI,CAAC,KAAK;AACR,YAAM,oBAAI,IAAI;AACd,WAAK,SAAS,IAAI,KAAK,GAAG;AAAA,IAC5B;AACA,QAAI,IAAI,EAAE;AACV,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,SAAS,IAAI,GAAG;AAC/B,UAAI,CAAC,EAAG;AACR,QAAE,OAAO,EAAE;AACX,UAAI,EAAE,SAAS,EAAG,MAAK,SAAS,OAAO,GAAG;AAAA,IAC5C;AAAA,EACF;AACF;","names":[]}

package/dist/index.js

@@ -1,9 +1,9 @@
-import {
-  LoopbackTransport
-} from "./chunk-S2HTNEZN.js";
 import {
   InMemorySnapshotStore
 } from "./chunk-6XHNO2RP.js";
+import {
+  LoopbackTransport
+} from "./chunk-PMIKORQM.js";
 
 // src/errors.ts
 import { CapabilityError } from "@nebutra/capability-kit";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/room.ts","../src/hub.ts"],"sourcesContent":["/**\n * Every failure surfaced by this package is a `CollabError`. The contract is\n * deliberately strict: a machine-stable `code` and a human-actionable\n * `suggestion` are MANDATORY, so no code path can throw a bare `Error` that\n * leaves a caller without a remediation hint.\n *\n * Mechanics (code/suggestion/toJSON/empty-suggestion fallback) are inherited\n * from the shared `@nebutra/capability-kit` `CapabilityError`; this subclass\n * only pins collab's error name + its package-specific fallback wording, so\n * the observable contract is unchanged.\n */\n\nimport { CapabilityError } from \"@nebutra/capability-kit\";\n\nexport type CollabErrorCode =\n  | \"COLLAB_INVALID_TENANT\"\n  | \"COLLAB_INVALID_ROOM\"\n  | \"COLLAB_SNAPSHOT_FAILED\"\n  | \"COLLAB_RESTORE_FAILED\"\n  | \"COLLAB_DESTROYED\"\n  | \"COLLAB_TEST\"\n  | (string & {});\n\nexport interface CollabErrorInit {\n  readonly code: CollabErrorCode;\n  /** A non-empty, actionable remediation hint. */\n  readonly suggestion: string;\n  readonly cause?: unknown;\n}\n\nexport class CollabError extends CapabilityError {\n  declare readonly code: CollabErrorCode;\n\n  constructor(message: string, init: CollabErrorInit) {\n    super(message, init, {\n      name: \"CollabError\",\n      emptySuggestionFallback:\n        \"No suggestion was provided. This is a bug in @nebutra/collab — \" +\n        \"report it with the failing operation.\",\n    });\n  }\n}\n","/**\n * A single tenant-scoped CRDT room. One `Y.Doc` per (tenant, room). The hub\n * owns the partitioning; this class assumes its `tenantId`/`roomId` are\n * already the partition it belongs to and never reaches outside them.\n *\n * Snapshot persistence is serialized through `withTenantLock(tenantId,\n * roomId, ...)` borrowed from `@nebutra/tenant-store` rather than a\n * hand-rolled mutex — same primitive used by canvas/reel, so a future swap\n * to a distributed lock changes one place.\n */\n\nimport { withTenantLock } from \"@nebutra/tenant-store\";\nimport * as Y from \"yjs\";\nimport { CollabError } from \"./errors\";\nimport type { CollabRoom, CollabTransport, SnapshotStore, UpdateListener } from \"./types\";\n\n/** Origin tag used when applying remote updates so we don't echo them back. */\nconst REMOTE_ORIGIN = Symbol(\"collab.remote\");\n\nexport class Room implements CollabRoom {\n  readonly doc: Y.Doc;\n  private readonly listeners = new Set<UpdateListener>();\n  private readonly unsubTransport: () => void;\n  private destroyed = false;\n\n  constructor(\n    readonly tenantId: string,\n    readonly roomId: string,\n    private readonly store: SnapshotStore,\n    private readonly transport: CollabTransport,\n  ) {\n    this.doc = new Y.Doc();\n\n    // Fan local updates out to: registered listeners + the transport. The\n    // transport echo is guarded by origin so a remote-applied update is not\n    // re-broadcast into a loop.\n    this.doc.on(\"update\", (update: Uint8Array, origin: unknown) => {\n      for (const cb of [...this.listeners]) cb(update, origin);\n      if (origin !== REMOTE_ORIGIN) {\n        void Promise.resolve(this.transport.broadcast(this.tenantId, this.roomId, update)).catch(\n          () => {\n            // Transport delivery is best-effort; CRDT state stays correct and\n            // converges on the next exchanged update. Swallowing here avoids\n            // an unhandled rejection from a flaky network adapter.\n          },\n        );\n      }\n    });\n\n    // Remote updates for THIS tenant-scoped channel only.\n    this.unsubTransport = this.transport.subscribe(this.tenantId, this.roomId, (update) => {\n      if (this.destroyed) return;\n      Y.applyUpdate(this.doc, update, REMOTE_ORIGIN);\n    });\n  }\n\n  applyUpdate(update: Uint8Array, origin?: unknown): void {\n    this.assertLive();\n    Y.applyUpdate(this.doc, update, origin);\n  }\n\n  encodeState(): Uint8Array {\n    this.assertLive();\n    return Y.encodeStateAsUpdate(this.doc);\n  }\n\n  onUpdate(cb: UpdateListener): () => void {\n    this.assertLive();\n    this.listeners.add(cb);\n    return () => {\n      this.listeners.delete(cb);\n    };\n  }\n\n  async snapshot(): Promise<void> {\n    this.assertLive();\n    const state = this.encodeState();\n    try {\n      // Serialize concurrent snapshots of the SAME room; different rooms (or\n      // the same room under another tenant) persist in parallel.\n      await withTenantLock(this.tenantId, this.roomId, () =>\n        this.store.save(this.tenantId, this.roomId, state),\n      );\n    } catch (cause) {\n      throw new CollabError(`Failed to persist snapshot for room \"${this.roomId}\".`, {\n        code: \"COLLAB_SNAPSHOT_FAILED\",\n        suggestion:\n          \"Verify the configured SnapshotStore is reachable (DB/Redis up, \" +\n          \"credentials valid). The in-memory default never fails; a custom \" +\n          \"adapter likely threw.\",\n        cause,\n      });\n    }\n  }\n\n  /** Hydrate this doc from persisted state, if any. Internal to the hub. */\n  async _restore(): Promise<void> {\n    try {\n      const persisted = await this.store.load(this.tenantId, this.roomId);\n      if (persisted) Y.applyUpdate(this.doc, persisted, REMOTE_ORIGIN);\n    } catch (cause) {\n      throw new CollabError(`Failed to restore room \"${this.roomId}\" from snapshot store.`, {\n        code: \"COLLAB_RESTORE_FAILED\",\n        suggestion:\n          \"Check the SnapshotStore adapter's load() — it should resolve \" +\n          \"null (not throw) when no snapshot exists for the tenant+room.\",\n        cause,\n      });\n    }\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    this.unsubTransport();\n    this.listeners.clear();\n    this.doc.destroy();\n  }\n\n  private assertLive(): void {\n    if (this.destroyed) {\n      throw new CollabError(`Room \"${this.roomId}\" was destroyed and can no longer be used.`, {\n        code: \"COLLAB_DESTROYED\",\n        suggestion:\n          \"Acquire a fresh room via hub.room(tenantId, roomId) instead of \" +\n          \"reusing a destroyed instance.\",\n      });\n    }\n  }\n}\n","/**\n * `CollabHub` — the tenant-partition boundary.\n *\n * TENANT ISOLATION IS STRUCTURAL: rooms are stored in a `Map` keyed by a\n * composite `tenantId\u0000roomId` string with a NUL separator that cannot\n * appear in a normal id. There is no API that takes only a roomId, so a key\n * minted for tenant A is unreachable from tenant B — a room handle is only\n * ever produced by passing an explicit `tenantId`, and the snapshot store +\n * transport are likewise addressed by (tenantId, roomId). The same property\n * a Prisma adapter gets from RLS is enforced here by the composite key, with\n * no trust placed in caller-supplied payload.\n */\n\nimport { CollabError } from \"./errors\";\nimport { Room } from \"./room\";\nimport { InMemorySnapshotStore } from \"./store/memory\";\nimport { LoopbackTransport } from \"./transport/loopback\";\nimport type {\n  CollabConfig,\n  CollabHub,\n  CollabRoom,\n  CollabTransport,\n  DoctorReport,\n  SnapshotStore,\n} from \"./types\";\n\n// NUL separator: it cannot appear in a normal tenant/room id, so the pairs\n// (\"a\",\"bc\") and (\"ab\",\"c\") can never collide into the same room key — the\n// tenant partition is exact, not merely conventional.\nconst KEY_SEP = \"\u0000\";\n\nfunction roomKey(tenantId: string, roomId: string): string {\n  return `${tenantId}${KEY_SEP}${roomId}`;\n}\n\nfunction assertId(value: string, kind: \"tenant\" | \"room\"): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new CollabError(`A non-empty ${kind}Id is required.`, {\n      code: kind === \"tenant\" ? \"COLLAB_INVALID_TENANT\" : \"COLLAB_INVALID_ROOM\",\n      suggestion:\n        kind === \"tenant\"\n          ? \"Pass the current tenant id, e.g. from getCurrentTenant().tenantId — \" +\n            \"never call room() without an explicit tenant.\"\n          : \"Pass a stable, non-empty roomId (document/canvas id).\",\n    });\n  }\n}\n\nclass Hub implements CollabHub {\n  private readonly rooms = new Map<string, Room>();\n  private readonly store: SnapshotStore;\n  private readonly transport: CollabTransport;\n\n  constructor(config: CollabConfig = {}) {\n    this.store = config.store ?? new InMemorySnapshotStore();\n    this.transport = config.transport ?? new LoopbackTransport();\n  }\n\n  room(tenantId: string, roomId: string): CollabRoom {\n    assertId(tenantId, \"tenant\");\n    assertId(roomId, \"room\");\n    const key = roomKey(tenantId, roomId);\n    let room = this.rooms.get(key);\n    if (!room) {\n      room = new Room(tenantId, roomId, this.store, this.transport);\n      this.rooms.set(key, room);\n    }\n    return room;\n  }\n\n  async roomRestored(tenantId: string, roomId: string): Promise<CollabRoom> {\n    const key = roomKey(tenantId, roomId);\n    const existed = this.rooms.has(key);\n    const room = this.room(tenantId, roomId) as Room;\n    // Only hydrate a freshly created room; an already-live room is the\n    // authoritative in-memory state.\n    if (!existed) await room._restore();\n    return room;\n  }\n\n  async doctor(): Promise<DoctorReport> {\n    const start = Date.now();\n\n    // 1. Yjs presence + a real round-trip (not just \"is it imported\").\n    let yjsOk = false;\n    let yjsDetail = \"\";\n    try {\n      const Y = await import(\"yjs\");\n      const probe = new Y.Doc();\n      probe.getMap(\"p\").set(\"k\", 1);\n      const restored = new Y.Doc();\n      Y.applyUpdate(restored, Y.encodeStateAsUpdate(probe));\n      const ok = restored.getMap(\"p\").get(\"k\") === 1;\n      probe.destroy();\n      restored.destroy();\n      yjsOk = ok;\n      yjsDetail = ok\n        ? \"Yjs encode/apply round-trip succeeded.\"\n        : \"Yjs round-trip produced unexpected state.\";\n    } catch (e) {\n      yjsDetail = `Yjs unavailable: ${String(e)}`;\n    }\n    const yjs = { ok: yjsOk, detail: yjsDetail };\n\n    // 2. Store health — write+read under a reserved diagnostic tenant.\n    let storeOk = false;\n    let storeDetail = \"\";\n    try {\n      const probe = new Uint8Array([7, 7, 7]);\n      await this.store.save(\"__collab_doctor__\", \"__probe__\", probe);\n      const back = await this.store.load(\"__collab_doctor__\", \"__probe__\");\n      const ok = !!back && back.length === probe.length && back[0] === 7;\n      storeOk = ok;\n      storeDetail = ok\n        ? \"SnapshotStore save/load round-trip succeeded.\"\n        : \"SnapshotStore returned unexpected bytes.\";\n    } catch (e) {\n      storeDetail = `SnapshotStore error: ${String(e)}`;\n    }\n    const store = { ok: storeOk, detail: storeDetail };\n\n    // 3. Transport health — subscribe, broadcast, observe, unsubscribe.\n    let transportOk = false;\n    let transportDetail = \"\";\n    try {\n      let received = false;\n      const off = this.transport.subscribe(\"__collab_doctor__\", \"__probe__\", () => {\n        received = true;\n      });\n      await this.transport.broadcast(\"__collab_doctor__\", \"__probe__\", new Uint8Array([1]));\n      off();\n      transportOk = received;\n      transportDetail = received\n        ? \"Transport broadcast/subscribe round-trip succeeded.\"\n        : \"Transport did not deliver the probe (network adapter may be async).\";\n    } catch (e) {\n      transportDetail = `Transport error: ${String(e)}`;\n    }\n    const transport = { ok: transportOk, detail: transportDetail };\n\n    return {\n      ok: yjs.ok && store.ok && transport.ok,\n      durationMs: Date.now() - start,\n      checks: { yjs, store, transport },\n    };\n  }\n\n  destroy(): void {\n    for (const room of this.rooms.values()) room.destroy();\n    this.rooms.clear();\n  }\n}\n\n/** Synchronous factory. */\nexport function createCollab(config?: CollabConfig): CollabHub {\n  return new Hub(config);\n}\n\n/**\n * Async factory mirroring other Sailor integration packages. There is no\n * env/credential negotiation for the zero-config defaults, so this resolves\n * immediately — the async shape is reserved for future credentialed\n * store/transport providers without a breaking signature change.\n */\nexport async function getCollab(config?: CollabConfig): Promise<CollabHub> {\n  return createCollab(config);\n}\n"],"mappings":"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","names":["Y"]}
+{"version":3,"sources":["../src/errors.ts","../src/room.ts","../src/hub.ts"],"sourcesContent":["/**\n * Every failure surfaced by this package is a `CollabError`. The contract is\n * deliberately strict: a machine-stable `code` and a human-actionable\n * `suggestion` are MANDATORY, so no code path can throw a bare `Error` that\n * leaves a caller without a remediation hint.\n *\n * Mechanics (code/suggestion/toJSON/empty-suggestion fallback) are inherited\n * from the shared `@nebutra/capability-kit` `CapabilityError`; this subclass\n * only pins collab's error name + its package-specific fallback wording, so\n * the observable contract is unchanged.\n */\n\nimport { CapabilityError } from \"@nebutra/capability-kit\";\n\nexport type CollabErrorCode =\n  | \"COLLAB_INVALID_TENANT\"\n  | \"COLLAB_INVALID_ROOM\"\n  | \"COLLAB_SNAPSHOT_FAILED\"\n  | \"COLLAB_RESTORE_FAILED\"\n  | \"COLLAB_DESTROYED\"\n  | \"COLLAB_TEST\"\n  | (string & {});\n\nexport interface CollabErrorInit {\n  readonly code: CollabErrorCode;\n  /** A non-empty, actionable remediation hint. */\n  readonly suggestion: string;\n  readonly cause?: unknown;\n}\n\nexport class CollabError extends CapabilityError {\n  declare readonly code: CollabErrorCode;\n\n  constructor(message: string, init: CollabErrorInit) {\n    super(message, init, {\n      name: \"CollabError\",\n      emptySuggestionFallback:\n        \"No suggestion was provided. This is a bug in @nebutra/collab — \" +\n        \"report it with the failing operation.\",\n    });\n  }\n}\n","/**\n * A single tenant-scoped CRDT room. One `Y.Doc` per (tenant, room). The hub\n * owns the partitioning; this class assumes its `tenantId`/`roomId` are\n * already the partition it belongs to and never reaches outside them.\n *\n * Snapshot persistence is serialized through `withTenantLock(tenantId,\n * roomId, ...)` borrowed from `@nebutra/tenant-store` rather than a\n * hand-rolled mutex — same primitive used by canvas/reel, so a future swap\n * to a distributed lock changes one place.\n */\n\nimport { withTenantLock } from \"@nebutra/tenant-store\";\nimport * as Y from \"yjs\";\nimport { CollabError } from \"./errors\";\nimport type { CollabRoom, CollabTransport, SnapshotStore, UpdateListener } from \"./types\";\n\n/** Origin tag used when applying remote updates so we don't echo them back. */\nconst REMOTE_ORIGIN = Symbol(\"collab.remote\");\n\nexport class Room implements CollabRoom {\n  readonly doc: Y.Doc;\n  private readonly listeners = new Set<UpdateListener>();\n  private readonly unsubTransport: () => void;\n  private destroyed = false;\n\n  constructor(\n    readonly tenantId: string,\n    readonly roomId: string,\n    private readonly store: SnapshotStore,\n    private readonly transport: CollabTransport,\n  ) {\n    this.doc = new Y.Doc();\n\n    // Fan local updates out to: registered listeners + the transport. The\n    // transport echo is guarded by origin so a remote-applied update is not\n    // re-broadcast into a loop.\n    this.doc.on(\"update\", (update: Uint8Array, origin: unknown) => {\n      for (const cb of [...this.listeners]) cb(update, origin);\n      if (origin !== REMOTE_ORIGIN) {\n        void Promise.resolve(this.transport.broadcast(this.tenantId, this.roomId, update)).catch(\n          () => {\n            // Transport delivery is best-effort; CRDT state stays correct and\n            // converges on the next exchanged update. Swallowing here avoids\n            // an unhandled rejection from a flaky network adapter.\n          },\n        );\n      }\n    });\n\n    // Remote updates for THIS tenant-scoped channel only.\n    this.unsubTransport = this.transport.subscribe(this.tenantId, this.roomId, (update) => {\n      if (this.destroyed) return;\n      Y.applyUpdate(this.doc, update, REMOTE_ORIGIN);\n    });\n  }\n\n  applyUpdate(update: Uint8Array, origin?: unknown): void {\n    this.assertLive();\n    Y.applyUpdate(this.doc, update, origin);\n  }\n\n  encodeState(): Uint8Array {\n    this.assertLive();\n    return Y.encodeStateAsUpdate(this.doc);\n  }\n\n  onUpdate(cb: UpdateListener): () => void {\n    this.assertLive();\n    this.listeners.add(cb);\n    return () => {\n      this.listeners.delete(cb);\n    };\n  }\n\n  async snapshot(): Promise<void> {\n    this.assertLive();\n    const state = this.encodeState();\n    try {\n      // Serialize concurrent snapshots of the SAME room; different rooms (or\n      // the same room under another tenant) persist in parallel.\n      await withTenantLock(this.tenantId, this.roomId, () =>\n        this.store.save(this.tenantId, this.roomId, state),\n      );\n    } catch (cause) {\n      throw new CollabError(`Failed to persist snapshot for room \"${this.roomId}\".`, {\n        code: \"COLLAB_SNAPSHOT_FAILED\",\n        suggestion:\n          \"Verify the configured SnapshotStore is reachable (DB/Redis up, \" +\n          \"credentials valid). The in-memory default never fails; a custom \" +\n          \"adapter likely threw.\",\n        cause,\n      });\n    }\n  }\n\n  /** Hydrate this doc from persisted state, if any. Internal to the hub. */\n  async _restore(): Promise<void> {\n    try {\n      const persisted = await this.store.load(this.tenantId, this.roomId);\n      if (persisted) Y.applyUpdate(this.doc, persisted, REMOTE_ORIGIN);\n    } catch (cause) {\n      throw new CollabError(`Failed to restore room \"${this.roomId}\" from snapshot store.`, {\n        code: \"COLLAB_RESTORE_FAILED\",\n        suggestion:\n          \"Check the SnapshotStore adapter's load() — it should resolve \" +\n          \"null (not throw) when no snapshot exists for the tenant+room.\",\n        cause,\n      });\n    }\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    this.unsubTransport();\n    this.listeners.clear();\n    this.doc.destroy();\n  }\n\n  private assertLive(): void {\n    if (this.destroyed) {\n      throw new CollabError(`Room \"${this.roomId}\" was destroyed and can no longer be used.`, {\n        code: \"COLLAB_DESTROYED\",\n        suggestion:\n          \"Acquire a fresh room via hub.room(tenantId, roomId) instead of \" +\n          \"reusing a destroyed instance.\",\n      });\n    }\n  }\n}\n","/**\n * `CollabHub` — the tenant-partition boundary.\n *\n * TENANT ISOLATION IS STRUCTURAL: rooms are stored in a `Map` keyed by a\n * composite `tenantId\\0roomId` string with a NUL separator that cannot\n * appear in a normal id. There is no API that takes only a roomId, so a key\n * minted for tenant A is unreachable from tenant B — a room handle is only\n * ever produced by passing an explicit `tenantId`, and the snapshot store +\n * transport are likewise addressed by (tenantId, roomId). The same property\n * a Prisma adapter gets from RLS is enforced here by the composite key, with\n * no trust placed in caller-supplied payload.\n */\n\nimport { CollabError } from \"./errors\";\nimport { Room } from \"./room\";\nimport { InMemorySnapshotStore } from \"./store/memory\";\nimport { LoopbackTransport } from \"./transport/loopback\";\nimport type {\n  CollabConfig,\n  CollabHub,\n  CollabRoom,\n  CollabTransport,\n  DoctorReport,\n  SnapshotStore,\n} from \"./types\";\n\n// NUL separator: it cannot appear in a normal tenant/room id, so the pairs\n// (\"a\",\"bc\") and (\"ab\",\"c\") can never collide into the same room key — the\n// tenant partition is exact, not merely conventional.\nconst KEY_SEP = \"\\0\";\n\nfunction roomKey(tenantId: string, roomId: string): string {\n  return `${tenantId}${KEY_SEP}${roomId}`;\n}\n\nfunction assertId(value: string, kind: \"tenant\" | \"room\"): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new CollabError(`A non-empty ${kind}Id is required.`, {\n      code: kind === \"tenant\" ? \"COLLAB_INVALID_TENANT\" : \"COLLAB_INVALID_ROOM\",\n      suggestion:\n        kind === \"tenant\"\n          ? \"Pass the current tenant id, e.g. from getCurrentTenant().tenantId — \" +\n            \"never call room() without an explicit tenant.\"\n          : \"Pass a stable, non-empty roomId (document/canvas id).\",\n    });\n  }\n}\n\nclass Hub implements CollabHub {\n  private readonly rooms = new Map<string, Room>();\n  private readonly store: SnapshotStore;\n  private readonly transport: CollabTransport;\n\n  constructor(config: CollabConfig = {}) {\n    this.store = config.store ?? new InMemorySnapshotStore();\n    this.transport = config.transport ?? new LoopbackTransport();\n  }\n\n  room(tenantId: string, roomId: string): CollabRoom {\n    assertId(tenantId, \"tenant\");\n    assertId(roomId, \"room\");\n    const key = roomKey(tenantId, roomId);\n    let room = this.rooms.get(key);\n    if (!room) {\n      room = new Room(tenantId, roomId, this.store, this.transport);\n      this.rooms.set(key, room);\n    }\n    return room;\n  }\n\n  async roomRestored(tenantId: string, roomId: string): Promise<CollabRoom> {\n    const key = roomKey(tenantId, roomId);\n    const existed = this.rooms.has(key);\n    const room = this.room(tenantId, roomId) as Room;\n    // Only hydrate a freshly created room; an already-live room is the\n    // authoritative in-memory state.\n    if (!existed) await room._restore();\n    return room;\n  }\n\n  async doctor(): Promise<DoctorReport> {\n    const start = Date.now();\n\n    // 1. Yjs presence + a real round-trip (not just \"is it imported\").\n    let yjsOk = false;\n    let yjsDetail = \"\";\n    try {\n      const Y = await import(\"yjs\");\n      const probe = new Y.Doc();\n      probe.getMap(\"p\").set(\"k\", 1);\n      const restored = new Y.Doc();\n      Y.applyUpdate(restored, Y.encodeStateAsUpdate(probe));\n      const ok = restored.getMap(\"p\").get(\"k\") === 1;\n      probe.destroy();\n      restored.destroy();\n      yjsOk = ok;\n      yjsDetail = ok\n        ? \"Yjs encode/apply round-trip succeeded.\"\n        : \"Yjs round-trip produced unexpected state.\";\n    } catch (e) {\n      yjsDetail = `Yjs unavailable: ${String(e)}`;\n    }\n    const yjs = { ok: yjsOk, detail: yjsDetail };\n\n    // 2. Store health — write+read under a reserved diagnostic tenant.\n    let storeOk = false;\n    let storeDetail = \"\";\n    try {\n      const probe = new Uint8Array([7, 7, 7]);\n      await this.store.save(\"__collab_doctor__\", \"__probe__\", probe);\n      const back = await this.store.load(\"__collab_doctor__\", \"__probe__\");\n      const ok = !!back && back.length === probe.length && back[0] === 7;\n      storeOk = ok;\n      storeDetail = ok\n        ? \"SnapshotStore save/load round-trip succeeded.\"\n        : \"SnapshotStore returned unexpected bytes.\";\n    } catch (e) {\n      storeDetail = `SnapshotStore error: ${String(e)}`;\n    }\n    const store = { ok: storeOk, detail: storeDetail };\n\n    // 3. Transport health — subscribe, broadcast, observe, unsubscribe.\n    let transportOk = false;\n    let transportDetail = \"\";\n    try {\n      let received = false;\n      const off = this.transport.subscribe(\"__collab_doctor__\", \"__probe__\", () => {\n        received = true;\n      });\n      await this.transport.broadcast(\"__collab_doctor__\", \"__probe__\", new Uint8Array([1]));\n      off();\n      transportOk = received;\n      transportDetail = received\n        ? \"Transport broadcast/subscribe round-trip succeeded.\"\n        : \"Transport did not deliver the probe (network adapter may be async).\";\n    } catch (e) {\n      transportDetail = `Transport error: ${String(e)}`;\n    }\n    const transport = { ok: transportOk, detail: transportDetail };\n\n    return {\n      ok: yjs.ok && store.ok && transport.ok,\n      durationMs: Date.now() - start,\n      checks: { yjs, store, transport },\n    };\n  }\n\n  destroy(): void {\n    for (const room of this.rooms.values()) room.destroy();\n    this.rooms.clear();\n  }\n}\n\n/** Synchronous factory. */\nexport function createCollab(config?: CollabConfig): CollabHub {\n  return new Hub(config);\n}\n\n/**\n * Async factory mirroring other Sailor integration packages. There is no\n * env/credential negotiation for the zero-config defaults, so this resolves\n * immediately — the async shape is reserved for future credentialed\n * store/transport providers without a breaking signature change.\n */\nexport async function getCollab(config?: CollabConfig): Promise<CollabHub> {\n  return createCollab(config);\n}\n"],"mappings":"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","names":["Y"]}

package/dist/transport/loopback.js

@@ -1,6 +1,6 @@
 import {
   LoopbackTransport
-} from "../chunk-S2HTNEZN.js";
+} from "../chunk-PMIKORQM.js";
 export {
   LoopbackTransport
 };

package/package.json

@@ -1,26 +1,30 @@
 {
   "name": "@nebutra/collab",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Multi-tenant, transport-agnostic real-time collaborative sync layer: tenant-partitioned CRDT rooms (Yjs) with pluggable snapshot store + transport seams",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "status": "wip",
+    "graph": "labs",
     "featureId": "collab",
     "category": "integrations",
     "summary": "Tenant-partitioned CRDT room manager (Yjs) with pluggable store + transport seams"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./store/memory": "./src/store/memory.ts",
-    "./transport/loopback": "./src/transport/loopback.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
     "yjs": "^13.6.30",
-    "@nebutra/capability-kit": "0.2.2",
-    "@nebutra/tenant-store": "0.2.2"
+    "@nebutra/tenant-store": "2.0.0",
+    "@nebutra/capability-kit": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -41,6 +45,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,28 +0,0 @@
-
-> @nebutra/collab@0.2.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/collab
-> tsup
-
-CLI Building entry: src/index.ts, src/transport/loopback.ts, src/store/memory.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/collab/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js                  7.13 KB
-ESM dist/chunk-S2HTNEZN.js         817.00 B
-ESM dist/chunk-6XHNO2RP.js         581.00 B
-ESM dist/store/memory.js           134.00 B
-ESM dist/transport/loopback.js     128.00 B
-ESM dist/chunk-S2HTNEZN.js.map     2.46 KB
-ESM dist/index.js.map              16.61 KB
-ESM dist/chunk-6XHNO2RP.js.map     2.04 KB
-ESM dist/store/memory.js.map       71.00 B
-ESM dist/transport/loopback.js.map 71.00 B
-ESM ⚡️ Build success in 26ms
-DTS Build start
-DTS ⚡️ Build success in 2909ms
-DTS dist/index.d.ts              2.68 KB
-DTS dist/transport/loopback.d.ts 1005.00 B
-DTS dist/store/memory.d.ts       1.04 KB
-DTS dist/types-68zA3h9k.d.ts     2.27 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/collab@0.2.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/collab
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/collab
-
- ✓ src/__tests__/collab.test.ts (14 tests) 25ms
-
- Test Files  1 passed (1)
-      Tests  14 passed (14)
-   Start at  09:38:32
-   Duration  586ms (transform 260ms, setup 0ms, import 356ms, tests 25ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/collab@0.2.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/collab
-> tsc --noEmit
-

package/coverage/base.css

@@ -1,224 +0,0 @@
-body, html {
-  margin:0; padding: 0;
-  height: 100%;
-}
-body {
-    font-family: Helvetica Neue, Helvetica, Arial;
-    font-size: 14px;
-    color:#333;
-}
-.small { font-size: 12px; }
-*, *:after, *:before {
-  -webkit-box-sizing:border-box;
-     -moz-box-sizing:border-box;
-          box-sizing:border-box;
-  }
-h1 { font-size: 20px; margin: 0;}
-h2 { font-size: 14px; }
-pre {
-    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
-    margin: 0;
-    padding: 0;
-    -moz-tab-size: 2;
-    -o-tab-size:  2;
-    tab-size: 2;
-}
-a { color:#0074D9; text-decoration:none; }
-a:hover { text-decoration:underline; }
-.strong { font-weight: bold; }
-.space-top1 { padding: 10px 0 0 0; }
-.pad2y { padding: 20px 0; }
-.pad1y { padding: 10px 0; }
-.pad2x { padding: 0 20px; }
-.pad2 { padding: 20px; }
-.pad1 { padding: 10px; }
-.space-left2 { padding-left:55px; }
-.space-right2 { padding-right:20px; }
-.center { text-align:center; }
-.clearfix { display:block; }
-.clearfix:after {
-  content:'';
-  display:block;
-  height:0;
-  clear:both;
-  visibility:hidden;
-  }
-.fl { float: left; }
-@media only screen and (max-width:640px) {
-  .col3 { width:100%; max-width:100%; }
-  .hide-mobile { display:none!important; }
-}
-
-.quiet {
-  color: #7f7f7f;
-  color: rgba(0,0,0,0.5);
-}
-.quiet a { opacity: 0.7; }
-
-.fraction {
-  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
-  font-size: 10px;
-  color: #555;
-  background: #E8E8E8;
-  padding: 4px 5px;
-  border-radius: 3px;
-  vertical-align: middle;
-}
-
-div.path a:link, div.path a:visited { color: #333; }
-table.coverage {
-  border-collapse: collapse;
-  margin: 10px 0 0 0;
-  padding: 0;
-}
-
-table.coverage td {
-  margin: 0;
-  padding: 0;
-  vertical-align: top;
-}
-table.coverage td.line-count {
-    text-align: right;
-    padding: 0 5px 0 20px;
-}
-table.coverage td.line-coverage {
-    text-align: right;
-    padding-right: 10px;
-    min-width:20px;
-}
-
-table.coverage td span.cline-any {
-    display: inline-block;
-    padding: 0 5px;
-    width: 100%;
-}
-.missing-if-branch {
-    display: inline-block;
-    margin-right: 5px;
-    border-radius: 3px;
-    position: relative;
-    padding: 0 4px;
-    background: #333;
-    color: yellow;
-}
-
-.skip-if-branch {
-    display: none;
-    margin-right: 10px;
-    position: relative;
-    padding: 0 4px;
-    background: #ccc;
-    color: white;
-}
-.missing-if-branch .typ, .skip-if-branch .typ {
-    color: inherit !important;
-}
-.coverage-summary {
-  border-collapse: collapse;
-  width: 100%;
-}
-.coverage-summary tr { border-bottom: 1px solid #bbb; }
-.keyline-all { border: 1px solid #ddd; }
-.coverage-summary td, .coverage-summary th { padding: 10px; }
-.coverage-summary tbody { border: 1px solid #bbb; }
-.coverage-summary td { border-right: 1px solid #bbb; }
-.coverage-summary td:last-child { border-right: none; }
-.coverage-summary th {
-  text-align: left;
-  font-weight: normal;
-  white-space: nowrap;
-}
-.coverage-summary th.file { border-right: none !important; }
-.coverage-summary th.pct { }
-.coverage-summary th.pic,
-.coverage-summary th.abs,
-.coverage-summary td.pct,
-.coverage-summary td.abs { text-align: right; }
-.coverage-summary td.file { white-space: nowrap;  }
-.coverage-summary td.pic { min-width: 120px !important;  }
-.coverage-summary tfoot td { }
-
-.coverage-summary .sorter {
-    height: 10px;
-    width: 7px;
-    display: inline-block;
-    margin-left: 0.5em;
-    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
-}
-.coverage-summary .sorted .sorter {
-    background-position: 0 -20px;
-}
-.coverage-summary .sorted-desc .sorter {
-    background-position: 0 -10px;
-}
-.status-line {  height: 10px; }
-/* yellow */
-.cbranch-no { background: yellow !important; color: #111; }
-/* dark red */
-.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
-.low .chart { border:1px solid #C21F39 }
-.highlighted,
-.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
-  background: #C21F39 !important;
-}
-/* medium red */
-.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
-/* light red */
-.low, .cline-no { background:#FCE1E5 }
-/* light green */
-.high, .cline-yes { background:rgb(230,245,208) }
-/* medium green */
-.cstat-yes { background:rgb(161,215,106) }
-/* dark green */
-.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
-.high .chart { border:1px solid rgb(77,146,33) }
-/* dark yellow (gold) */
-.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
-.medium .chart { border:1px solid #f9cd0b; }
-/* light yellow */
-.medium { background: #fff4c2; }
-
-.cstat-skip { background: #ddd; color: #111; }
-.fstat-skip { background: #ddd; color: #111 !important; }
-.cbranch-skip { background: #ddd !important; color: #111; }
-
-span.cline-neutral { background: #eaeaea; }
-
-.coverage-summary td.empty {
-    opacity: .5;
-    padding-top: 4px;
-    padding-bottom: 4px;
-    line-height: 1;
-    color: #888;
-}
-
-.cover-fill, .cover-empty {
-  display:inline-block;
-  height: 12px;
-}
-.chart {
-  line-height: 0;
-}
-.cover-empty {
-    background: white;
-}
-.cover-full {
-    border-right: none !important;
-}
-pre.prettyprint {
-    border: none !important;
-    padding: 0 !important;
-    margin: 0 !important;
-}
-.com { color: #999 !important; }
-.ignore-none { color: #999; font-weight: normal; }
-
-.wrapper {
-  min-height: 100%;
-  height: auto !important;
-  height: 100%;
-  margin: 0 auto -48px;
-}
-.footer, .push {
-  height: 48px;
-}

package/coverage/block-navigation.js

@@ -1,87 +0,0 @@
-/* eslint-disable */
-var jumpToCode = (function init() {
-    // Classes of code we would like to highlight in the file view
-    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
-
-    // Elements to highlight in the file listing view
-    var fileListingElements = ['td.pct.low'];
-
-    // We don't want to select elements that are direct descendants of another match
-    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
-
-    // Selector that finds elements on the page to which we can jump
-    var selector =
-        fileListingElements.join(', ') +
-        ', ' +
-        notSelector +
-        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
-
-    // The NodeList of matching elements
-    var missingCoverageElements = document.querySelectorAll(selector);
-
-    var currentIndex;
-
-    function toggleClass(index) {
-        missingCoverageElements
-            .item(currentIndex)
-            .classList.remove('highlighted');
-        missingCoverageElements.item(index).classList.add('highlighted');
-    }
-
-    function makeCurrent(index) {
-        toggleClass(index);
-        currentIndex = index;
-        missingCoverageElements.item(index).scrollIntoView({
-            behavior: 'smooth',
-            block: 'center',
-            inline: 'center'
-        });
-    }
-
-    function goToPrevious() {
-        var nextIndex = 0;
-        if (typeof currentIndex !== 'number' || currentIndex === 0) {
-            nextIndex = missingCoverageElements.length - 1;
-        } else if (missingCoverageElements.length > 1) {
-            nextIndex = currentIndex - 1;
-        }
-
-        makeCurrent(nextIndex);
-    }
-
-    function goToNext() {
-        var nextIndex = 0;
-
-        if (
-            typeof currentIndex === 'number' &&
-            currentIndex < missingCoverageElements.length - 1
-        ) {
-            nextIndex = currentIndex + 1;
-        }
-
-        makeCurrent(nextIndex);
-    }
-
-    return function jump(event) {
-        if (
-            document.getElementById('fileSearch') === document.activeElement &&
-            document.activeElement != null
-        ) {
-            // if we're currently focused on the search input, we don't want to navigate
-            return;
-        }
-
-        switch (event.which) {
-            case 78: // n
-            case 74: // j
-                goToNext();
-                break;
-            case 66: // b
-            case 75: // k
-            case 80: // p
-                goToPrevious();
-                break;
-        }
-    };
-})();
-window.addEventListener('keydown', jumpToCode);