@canvas-harness/sync-broadcast 0.0.0

package/dist/index.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/index.ts
+var createBroadcastSyncAdapter = ({
+  channelName,
+  clientId,
+  initialPresence
+}) => {
+  if (typeof BroadcastChannel === "undefined") {
+    throw new Error("BroadcastChannel is not available in this environment.");
+  }
+  const channel = new BroadcastChannel(channelName);
+  const batchListeners = /* @__PURE__ */ new Set();
+  const presenceListeners = /* @__PURE__ */ new Set();
+  let lastLocalPresence = initialPresence;
+  const post = (msg) => {
+    channel.postMessage(msg);
+  };
+  channel.addEventListener("message", (e) => {
+    const msg = e.data;
+    if (msg.kind === "batch") {
+      if (msg.batch.clientId === clientId) return;
+      for (const cb of batchListeners) cb(msg.batch);
+      return;
+    }
+    if (msg.kind === "presence") {
+      if (msg.clientId === clientId) return;
+      for (const cb of presenceListeners) cb(msg.clientId, msg.state);
+      return;
+    }
+    if (msg.kind === "presence-leave") {
+      if (msg.clientId === clientId) return;
+      for (const cb of presenceListeners) cb(msg.clientId, null);
+      return;
+    }
+    if (msg.kind === "hello" && msg.clientId !== clientId && lastLocalPresence) {
+      post({ kind: "presence", clientId, state: lastLocalPresence });
+    }
+  });
+  post({ kind: "hello", clientId });
+  const onPageHide = () => {
+    post({ kind: "presence-leave", clientId });
+  };
+  if (typeof window !== "undefined") window.addEventListener("pagehide", onPageHide);
+  return {
+    capabilities: { causalOrdering: true },
+    sendBatch(batch) {
+      post({ kind: "batch", batch });
+    },
+    sendPresence(patch) {
+      const state = {
+        ...lastLocalPresence ?? {},
+        ...patch,
+        clientId
+      };
+      lastLocalPresence = state;
+      post({ kind: "presence", clientId, state });
+    },
+    onBatch(cb) {
+      batchListeners.add(cb);
+      return () => {
+        batchListeners.delete(cb);
+      };
+    },
+    onPresence(cb) {
+      presenceListeners.add(cb);
+      return () => {
+        presenceListeners.delete(cb);
+      };
+    },
+    destroy() {
+      if (typeof window !== "undefined") window.removeEventListener("pagehide", onPageHide);
+      post({ kind: "presence-leave", clientId });
+      channel.close();
+      batchListeners.clear();
+      presenceListeners.clear();
+    }
+  };
+};
+
+exports.createBroadcastSyncAdapter = createBroadcastSyncAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  ClientId,\n  OpBatch,\n  PresencePatch,\n  PresenceState,\n  SyncAdapter,\n  Unsubscribe,\n} from '@canvas-harness/core'\n\n/**\n * BroadcastChannel-backed SyncAdapter — see ARCHITECTURE.md §10.6.\n *\n * The simplest possible adapter: serializes op batches + presence\n * patches to JSON and broadcasts over the BroadcastChannel API. Same\n * machine, multiple tabs of the same origin. Good for demos + dev.\n *\n * Causal-ordering guarantee: BroadcastChannel within a single browser\n * process delivers messages in send order, so we can advertise\n * `capabilities.causalOrdering: true`. For cross-machine / cross-origin\n * collab use a real transport (WebSocket + sequenced server, Yjs, etc.).\n */\n\ntype Wire =\n  | { kind: 'batch'; batch: OpBatch }\n  | { kind: 'presence'; clientId: ClientId; state: PresenceState }\n  | { kind: 'presence-leave'; clientId: ClientId }\n  | { kind: 'hello'; clientId: ClientId }\n\nexport type BroadcastSyncOptions = {\n  /** Channel name — peers join by sharing the same name. */\n  channelName: string\n  /** This client's id. Used to filter self-echoes + announce on attach. */\n  clientId: ClientId\n  /** Optional initial presence to broadcast on attach. */\n  initialPresence?: PresenceState\n}\n\nexport const createBroadcastSyncAdapter = ({\n  channelName,\n  clientId,\n  initialPresence,\n}: BroadcastSyncOptions): SyncAdapter => {\n  if (typeof BroadcastChannel === 'undefined') {\n    throw new Error('BroadcastChannel is not available in this environment.')\n  }\n  const channel = new BroadcastChannel(channelName)\n\n  const batchListeners = new Set<(batch: OpBatch) => void>()\n  const presenceListeners = new Set<(clientId: ClientId, state: PresenceState | null) => void>()\n  // Latest presence per remote client. We keep a snapshot so when a new\n  // peer announces 'hello' we can replay our own presence to them.\n  let lastLocalPresence: PresenceState | undefined = initialPresence\n\n  const post = (msg: Wire): void => {\n    channel.postMessage(msg)\n  }\n\n  channel.addEventListener('message', e => {\n    const msg = e.data as Wire\n    // BroadcastChannel doesn't echo to the sender, but in case a future\n    // transport changes that, defensively drop self-messages.\n    if (msg.kind === 'batch') {\n      if (msg.batch.clientId === clientId) return\n      for (const cb of batchListeners) cb(msg.batch)\n      return\n    }\n    if (msg.kind === 'presence') {\n      if (msg.clientId === clientId) return\n      for (const cb of presenceListeners) cb(msg.clientId, msg.state)\n      return\n    }\n    if (msg.kind === 'presence-leave') {\n      if (msg.clientId === clientId) return\n      for (const cb of presenceListeners) cb(msg.clientId, null)\n      return\n    }\n    if (msg.kind === 'hello' && msg.clientId !== clientId && lastLocalPresence) {\n      // A new peer joined; replay our presence so they can paint our cursor.\n      post({ kind: 'presence', clientId, state: lastLocalPresence })\n    }\n  })\n\n  // Announce arrival so existing peers can replay their presence to us.\n  post({ kind: 'hello', clientId })\n\n  // Best-effort departure: BroadcastChannel doesn't have a leave event,\n  // but pagehide is close enough for a demo.\n  const onPageHide = (): void => {\n    post({ kind: 'presence-leave', clientId })\n  }\n  if (typeof window !== 'undefined') window.addEventListener('pagehide', onPageHide)\n\n  return {\n    capabilities: { causalOrdering: true },\n\n    sendBatch(batch: OpBatch) {\n      post({ kind: 'batch', batch })\n    },\n\n    sendPresence(patch: PresencePatch) {\n      const state: PresenceState = {\n        ...(lastLocalPresence ?? ({} as PresenceState)),\n        ...patch,\n        clientId,\n      }\n      lastLocalPresence = state\n      post({ kind: 'presence', clientId, state })\n    },\n\n    onBatch(cb): Unsubscribe {\n      batchListeners.add(cb)\n      return () => {\n        batchListeners.delete(cb)\n      }\n    },\n\n    onPresence(cb): Unsubscribe {\n      presenceListeners.add(cb)\n      return () => {\n        presenceListeners.delete(cb)\n      }\n    },\n\n    destroy() {\n      if (typeof window !== 'undefined') window.removeEventListener('pagehide', onPageHide)\n      post({ kind: 'presence-leave', clientId })\n      channel.close()\n      batchListeners.clear()\n      presenceListeners.clear()\n    },\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,13 @@
+import { ClientId, PresenceState, SyncAdapter } from '@canvas-harness/core';
+
+type BroadcastSyncOptions = {
+    /** Channel name — peers join by sharing the same name. */
+    channelName: string;
+    /** This client's id. Used to filter self-echoes + announce on attach. */
+    clientId: ClientId;
+    /** Optional initial presence to broadcast on attach. */
+    initialPresence?: PresenceState;
+};
+declare const createBroadcastSyncAdapter: ({ channelName, clientId, initialPresence, }: BroadcastSyncOptions) => SyncAdapter;
+
+export { type BroadcastSyncOptions, createBroadcastSyncAdapter };

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { ClientId, PresenceState, SyncAdapter } from '@canvas-harness/core';
+
+type BroadcastSyncOptions = {
+    /** Channel name — peers join by sharing the same name. */
+    channelName: string;
+    /** This client's id. Used to filter self-echoes + announce on attach. */
+    clientId: ClientId;
+    /** Optional initial presence to broadcast on attach. */
+    initialPresence?: PresenceState;
+};
+declare const createBroadcastSyncAdapter: ({ channelName, clientId, initialPresence, }: BroadcastSyncOptions) => SyncAdapter;
+
+export { type BroadcastSyncOptions, createBroadcastSyncAdapter };

package/dist/index.js

@@ -0,0 +1,81 @@
+// src/index.ts
+var createBroadcastSyncAdapter = ({
+  channelName,
+  clientId,
+  initialPresence
+}) => {
+  if (typeof BroadcastChannel === "undefined") {
+    throw new Error("BroadcastChannel is not available in this environment.");
+  }
+  const channel = new BroadcastChannel(channelName);
+  const batchListeners = /* @__PURE__ */ new Set();
+  const presenceListeners = /* @__PURE__ */ new Set();
+  let lastLocalPresence = initialPresence;
+  const post = (msg) => {
+    channel.postMessage(msg);
+  };
+  channel.addEventListener("message", (e) => {
+    const msg = e.data;
+    if (msg.kind === "batch") {
+      if (msg.batch.clientId === clientId) return;
+      for (const cb of batchListeners) cb(msg.batch);
+      return;
+    }
+    if (msg.kind === "presence") {
+      if (msg.clientId === clientId) return;
+      for (const cb of presenceListeners) cb(msg.clientId, msg.state);
+      return;
+    }
+    if (msg.kind === "presence-leave") {
+      if (msg.clientId === clientId) return;
+      for (const cb of presenceListeners) cb(msg.clientId, null);
+      return;
+    }
+    if (msg.kind === "hello" && msg.clientId !== clientId && lastLocalPresence) {
+      post({ kind: "presence", clientId, state: lastLocalPresence });
+    }
+  });
+  post({ kind: "hello", clientId });
+  const onPageHide = () => {
+    post({ kind: "presence-leave", clientId });
+  };
+  if (typeof window !== "undefined") window.addEventListener("pagehide", onPageHide);
+  return {
+    capabilities: { causalOrdering: true },
+    sendBatch(batch) {
+      post({ kind: "batch", batch });
+    },
+    sendPresence(patch) {
+      const state = {
+        ...lastLocalPresence ?? {},
+        ...patch,
+        clientId
+      };
+      lastLocalPresence = state;
+      post({ kind: "presence", clientId, state });
+    },
+    onBatch(cb) {
+      batchListeners.add(cb);
+      return () => {
+        batchListeners.delete(cb);
+      };
+    },
+    onPresence(cb) {
+      presenceListeners.add(cb);
+      return () => {
+        presenceListeners.delete(cb);
+      };
+    },
+    destroy() {
+      if (typeof window !== "undefined") window.removeEventListener("pagehide", onPageHide);
+      post({ kind: "presence-leave", clientId });
+      channel.close();
+      batchListeners.clear();
+      presenceListeners.clear();
+    }
+  };
+};
+
+export { createBroadcastSyncAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  ClientId,\n  OpBatch,\n  PresencePatch,\n  PresenceState,\n  SyncAdapter,\n  Unsubscribe,\n} from '@canvas-harness/core'\n\n/**\n * BroadcastChannel-backed SyncAdapter — see ARCHITECTURE.md §10.6.\n *\n * The simplest possible adapter: serializes op batches + presence\n * patches to JSON and broadcasts over the BroadcastChannel API. Same\n * machine, multiple tabs of the same origin. Good for demos + dev.\n *\n * Causal-ordering guarantee: BroadcastChannel within a single browser\n * process delivers messages in send order, so we can advertise\n * `capabilities.causalOrdering: true`. For cross-machine / cross-origin\n * collab use a real transport (WebSocket + sequenced server, Yjs, etc.).\n */\n\ntype Wire =\n  | { kind: 'batch'; batch: OpBatch }\n  | { kind: 'presence'; clientId: ClientId; state: PresenceState }\n  | { kind: 'presence-leave'; clientId: ClientId }\n  | { kind: 'hello'; clientId: ClientId }\n\nexport type BroadcastSyncOptions = {\n  /** Channel name — peers join by sharing the same name. */\n  channelName: string\n  /** This client's id. Used to filter self-echoes + announce on attach. */\n  clientId: ClientId\n  /** Optional initial presence to broadcast on attach. */\n  initialPresence?: PresenceState\n}\n\nexport const createBroadcastSyncAdapter = ({\n  channelName,\n  clientId,\n  initialPresence,\n}: BroadcastSyncOptions): SyncAdapter => {\n  if (typeof BroadcastChannel === 'undefined') {\n    throw new Error('BroadcastChannel is not available in this environment.')\n  }\n  const channel = new BroadcastChannel(channelName)\n\n  const batchListeners = new Set<(batch: OpBatch) => void>()\n  const presenceListeners = new Set<(clientId: ClientId, state: PresenceState | null) => void>()\n  // Latest presence per remote client. We keep a snapshot so when a new\n  // peer announces 'hello' we can replay our own presence to them.\n  let lastLocalPresence: PresenceState | undefined = initialPresence\n\n  const post = (msg: Wire): void => {\n    channel.postMessage(msg)\n  }\n\n  channel.addEventListener('message', e => {\n    const msg = e.data as Wire\n    // BroadcastChannel doesn't echo to the sender, but in case a future\n    // transport changes that, defensively drop self-messages.\n    if (msg.kind === 'batch') {\n      if (msg.batch.clientId === clientId) return\n      for (const cb of batchListeners) cb(msg.batch)\n      return\n    }\n    if (msg.kind === 'presence') {\n      if (msg.clientId === clientId) return\n      for (const cb of presenceListeners) cb(msg.clientId, msg.state)\n      return\n    }\n    if (msg.kind === 'presence-leave') {\n      if (msg.clientId === clientId) return\n      for (const cb of presenceListeners) cb(msg.clientId, null)\n      return\n    }\n    if (msg.kind === 'hello' && msg.clientId !== clientId && lastLocalPresence) {\n      // A new peer joined; replay our presence so they can paint our cursor.\n      post({ kind: 'presence', clientId, state: lastLocalPresence })\n    }\n  })\n\n  // Announce arrival so existing peers can replay their presence to us.\n  post({ kind: 'hello', clientId })\n\n  // Best-effort departure: BroadcastChannel doesn't have a leave event,\n  // but pagehide is close enough for a demo.\n  const onPageHide = (): void => {\n    post({ kind: 'presence-leave', clientId })\n  }\n  if (typeof window !== 'undefined') window.addEventListener('pagehide', onPageHide)\n\n  return {\n    capabilities: { causalOrdering: true },\n\n    sendBatch(batch: OpBatch) {\n      post({ kind: 'batch', batch })\n    },\n\n    sendPresence(patch: PresencePatch) {\n      const state: PresenceState = {\n        ...(lastLocalPresence ?? ({} as PresenceState)),\n        ...patch,\n        clientId,\n      }\n      lastLocalPresence = state\n      post({ kind: 'presence', clientId, state })\n    },\n\n    onBatch(cb): Unsubscribe {\n      batchListeners.add(cb)\n      return () => {\n        batchListeners.delete(cb)\n      }\n    },\n\n    onPresence(cb): Unsubscribe {\n      presenceListeners.add(cb)\n      return () => {\n        presenceListeners.delete(cb)\n      }\n    },\n\n    destroy() {\n      if (typeof window !== 'undefined') window.removeEventListener('pagehide', onPageHide)\n      post({ kind: 'presence-leave', clientId })\n      channel.close()\n      batchListeners.clear()\n      presenceListeners.clear()\n    },\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@canvas-harness/sync-broadcast",
+  "version": "0.0.0",
+  "description": "BroadcastChannel-backed SyncAdapter for canvas-harness — single-machine multi-tab demos.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "keywords": [
+    "canvas-harness",
+    "sync",
+    "broadcastchannel",
+    "collab",
+    "multi-tab"
+  ],
+  "author": "Le Ha Quang <winlp4ever@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/winlp4ever/canvas-harness#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/winlp4ever/canvas-harness.git",
+    "directory": "packages/sync-broadcast"
+  },
+  "bugs": {
+    "url": "https://github.com/winlp4ever/canvas-harness/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@canvas-harness/core": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}