@tangentfeed/transport-broadcast 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sreeraj T A
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @tangentfeed/transport-broadcast
+
+BroadcastChannel transport for tangentfeed. Syncs replicas across tabs and workers on the same device, with no infrastructure.
+
+Part of [tangentfeed](https://github.com/sreerajta/tangentfeed). MIT licensed.

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { Transport, WireMsg } from '@tangentfeed/core';
+
+/**
+ * BroadcastChannel transport — same-origin, same-device sync (tabs, workers).
+ *
+ * BroadcastChannel is already a bus with exactly our Transport semantics:
+ * postMessage reaches every other listener on the channel name, never
+ * ourselves. Structured clone carries WireMsg objects natively. This file
+ * being ~30 lines is the proof the Transport interface is cut right; the
+ * WebRTC transport (M4) implements the same four members.
+ *
+ * Works in browsers and in Node ≥18 (worker_threads-backed), which is why the
+ * tests need no mocks.
+ */
+
+declare class BroadcastTransport implements Transport {
+    private readonly channel;
+    private readonly listeners;
+    constructor(space: string);
+    send(msg: WireMsg): void;
+    onMessage(cb: (msg: WireMsg) => void): () => void;
+    close(): void;
+}
+
+export { BroadcastTransport };

package/dist/index.js

@@ -0,0 +1,25 @@
+// src/index.ts
+var BroadcastTransport = class {
+  channel;
+  listeners = /* @__PURE__ */ new Set();
+  constructor(space) {
+    this.channel = new BroadcastChannel(`tangentfeed:${space}`);
+    this.channel.onmessage = (ev) => {
+      for (const cb of this.listeners) cb(ev.data);
+    };
+  }
+  send(msg) {
+    this.channel.postMessage(msg);
+  }
+  onMessage(cb) {
+    this.listeners.add(cb);
+    return () => this.listeners.delete(cb);
+  }
+  close() {
+    this.listeners.clear();
+    this.channel.close();
+  }
+};
+export {
+  BroadcastTransport
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@tangentfeed/transport-broadcast",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@tangentfeed/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "tsup": "^8.5.0"
+  },
+  "description": "BroadcastChannel transport for tangentfeed (same-device tabs)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sreerajta/tangentfeed.git",
+    "directory": "packages/transport-broadcast"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}