@use-everywhere/core 0.5.0 → 0.7.0

package/dist/testing.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing.ts
+var testing_exports = {};
+__export(testing_exports, {
+  MemoryHub: () => MemoryHub,
+  MemoryTransport: () => MemoryTransport
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/transport/memory-transport.ts
+var MemoryTransport = class {
+  constructor(hub) {
+    this.hub = hub;
+    this.kind = "memory";
+    this.listeners = /* @__PURE__ */ new Set();
+    this.closed = false;
+  }
+  post(data) {
+    if (this.closed) return;
+    this.hub.broadcast(this, data);
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  close() {
+    this.closed = true;
+    this.listeners.clear();
+    this.hub.disconnect(this);
+  }
+  /** @internal */
+  deliver(data) {
+    if (this.closed) return;
+    for (const listener of this.listeners) listener(data);
+  }
+};
+
+// src/transport/memory-hub.ts
+var MemoryHub = class {
+  constructor() {
+    this.transports = /* @__PURE__ */ new Set();
+  }
+  connect() {
+    const transport = new MemoryTransport(this);
+    this.transports.add(transport);
+    return transport;
+  }
+  /** @internal */
+  broadcast(from, data) {
+    structuredClone(data);
+    for (const transport of this.transports) {
+      if (transport !== from) {
+        const copy = structuredClone(data);
+        queueMicrotask(() => transport.deliver(copy));
+      }
+    }
+  }
+  /** @internal */
+  disconnect(transport) {
+    this.transports.delete(transport);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MemoryHub,
+  MemoryTransport
+});

package/dist/testing.d.cts

@@ -0,0 +1,31 @@
+import { T as Transport, a as TransportKind } from './transport.types-CV1WZOhy.cjs';
+
+/** One simulated client on a MemoryHub. Create via hub.connect(). */
+declare class MemoryTransport implements Transport {
+    private hub;
+    readonly kind: TransportKind;
+    private listeners;
+    private closed;
+    constructor(hub: MemoryHub);
+    post(data: unknown): void;
+    subscribe(listener: (data: unknown) => void): () => void;
+    close(): void;
+    /** @internal */
+    deliver(data: unknown): void;
+}
+
+/**
+ * In-memory hub for tests: N transports attached to one hub, each post is
+ * delivered to every *other* transport on a microtask (mirrors BroadcastChannel's
+ * async, no-self-echo delivery).
+ */
+declare class MemoryHub {
+    private transports;
+    connect(): MemoryTransport;
+    /** @internal */
+    broadcast(from: MemoryTransport, data: unknown): void;
+    /** @internal */
+    disconnect(transport: MemoryTransport): void;
+}
+
+export { MemoryHub, MemoryTransport };

package/dist/testing.d.ts

@@ -0,0 +1,31 @@
+import { T as Transport, a as TransportKind } from './transport.types-CV1WZOhy.js';
+
+/** One simulated client on a MemoryHub. Create via hub.connect(). */
+declare class MemoryTransport implements Transport {
+    private hub;
+    readonly kind: TransportKind;
+    private listeners;
+    private closed;
+    constructor(hub: MemoryHub);
+    post(data: unknown): void;
+    subscribe(listener: (data: unknown) => void): () => void;
+    close(): void;
+    /** @internal */
+    deliver(data: unknown): void;
+}
+
+/**
+ * In-memory hub for tests: N transports attached to one hub, each post is
+ * delivered to every *other* transport on a microtask (mirrors BroadcastChannel's
+ * async, no-self-echo delivery).
+ */
+declare class MemoryHub {
+    private transports;
+    connect(): MemoryTransport;
+    /** @internal */
+    broadcast(from: MemoryTransport, data: unknown): void;
+    /** @internal */
+    disconnect(transport: MemoryTransport): void;
+}
+
+export { MemoryHub, MemoryTransport };

package/dist/testing.js

@@ -0,0 +1,57 @@
+// src/transport/memory-transport.ts
+var MemoryTransport = class {
+  constructor(hub) {
+    this.hub = hub;
+    this.kind = "memory";
+    this.listeners = /* @__PURE__ */ new Set();
+    this.closed = false;
+  }
+  post(data) {
+    if (this.closed) return;
+    this.hub.broadcast(this, data);
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  close() {
+    this.closed = true;
+    this.listeners.clear();
+    this.hub.disconnect(this);
+  }
+  /** @internal */
+  deliver(data) {
+    if (this.closed) return;
+    for (const listener of this.listeners) listener(data);
+  }
+};
+
+// src/transport/memory-hub.ts
+var MemoryHub = class {
+  constructor() {
+    this.transports = /* @__PURE__ */ new Set();
+  }
+  connect() {
+    const transport = new MemoryTransport(this);
+    this.transports.add(transport);
+    return transport;
+  }
+  /** @internal */
+  broadcast(from, data) {
+    structuredClone(data);
+    for (const transport of this.transports) {
+      if (transport !== from) {
+        const copy = structuredClone(data);
+        queueMicrotask(() => transport.deliver(copy));
+      }
+    }
+  }
+  /** @internal */
+  disconnect(transport) {
+    this.transports.delete(transport);
+  }
+};
+export {
+  MemoryHub,
+  MemoryTransport
+};

package/dist/transport.types-CV1WZOhy.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Which mechanism a transport actually uses. Worth surfacing, because they are
+ * not equivalent: `storage` is a fallback with lower fidelity than
+ * `broadcast-channel`, and `none` means nothing is being shared at all.
+ */
+type TransportKind = 'broadcast-channel' | 'storage' | 'memory' | 'none' | (string & {});
+/**
+ * Minimal message bus. Implementations: BroadcastChannelTransport (same-origin),
+ * StorageTransport (fallback), NoopTransport (SSR / local-only), MemoryTransport
+ * (tests). A transport never echoes a client's own posts back to it.
+ */
+interface Transport {
+    /** What this transport is. Optional so a custom transport need not declare one. */
+    readonly kind?: TransportKind;
+    post(data: unknown): void;
+    subscribe(listener: (data: unknown) => void): () => void;
+    close(): void;
+}
+
+export type { Transport as T, TransportKind as a };

package/dist/transport.types-CV1WZOhy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Which mechanism a transport actually uses. Worth surfacing, because they are
+ * not equivalent: `storage` is a fallback with lower fidelity than
+ * `broadcast-channel`, and `none` means nothing is being shared at all.
+ */
+type TransportKind = 'broadcast-channel' | 'storage' | 'memory' | 'none' | (string & {});
+/**
+ * Minimal message bus. Implementations: BroadcastChannelTransport (same-origin),
+ * StorageTransport (fallback), NoopTransport (SSR / local-only), MemoryTransport
+ * (tests). A transport never echoes a client's own posts back to it.
+ */
+interface Transport {
+    /** What this transport is. Optional so a custom transport need not declare one. */
+    readonly kind?: TransportKind;
+    post(data: unknown): void;
+    subscribe(listener: (data: unknown) => void): () => void;
+    close(): void;
+}
+
+export type { Transport as T, TransportKind as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@use-everywhere/core",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Cross-tab shared state, events, presence, and cross-origin window channels",
   "license": "MIT",
   "author": "Jonatan Kruszewski <jonakrusze@gmail.com>",
@@ -38,6 +38,16 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing.d.ts",
+        "default": "./dist/testing.js"
+      },
+      "require": {
+        "types": "./dist/testing.d.cts",
+        "default": "./dist/testing.cjs"
+      }
     }
   },
   "files": [
@@ -48,49 +58,43 @@
       "name": "everything (import *)",
       "path": "dist/index.js",
       "import": "*",
-      "limit": "5 kB"
+      "limit": "7.2 kB"
     },
     {
       "name": "createLeader",
       "path": "dist/index.js",
       "import": "{ createLeader }",
-      "limit": "1.6 kB"
+      "limit": "3.33 kB"
     },
     {
       "name": "createSharedStore",
       "path": "dist/index.js",
       "import": "{ createSharedStore }",
-      "limit": "2.25 kB"
+      "limit": "3.3 kB"
     },
     {
       "name": "createChannel",
       "path": "dist/index.js",
       "import": "{ createChannel }",
-      "limit": "1.25 kB"
+      "limit": "2.1 kB"
     },
     {
       "name": "createPresence",
       "path": "dist/index.js",
       "import": "{ createPresence }",
-      "limit": "1.35 kB"
+      "limit": "2.28 kB"
     },
     {
       "name": "openWindow (opener side)",
       "path": "dist/index.js",
       "import": "{ openWindow }",
-      "limit": "1.3 kB"
+      "limit": "1.49 kB"
     },
     {
       "name": "connectToOpener (child side)",
       "path": "dist/index.js",
       "import": "{ connectToOpener }",
-      "limit": "1.15 kB"
-    },
-    {
-      "name": "MemoryHub (test transport)",
-      "path": "dist/index.js",
-      "import": "{ MemoryHub }",
-      "limit": "300 B"
+      "limit": "1.32 kB"
     },
     {
       "name": "observeBus + enableDebug",
@@ -103,12 +107,19 @@
       "path": "dist/index.js",
       "import": "{ localStorageAdapter }",
       "limit": "500 B"
+    },
+    {
+      "name": "MemoryHub (testing subpath)",
+      "path": "dist/testing.js",
+      "import": "{ MemoryHub }",
+      "limit": "350 B"
     }
   ],
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@size-limit/preset-small-lib": "^13.0.1",
     "@vitest/coverage-v8": "^4.1.10",
+    "fast-check": "^4.9.0",
     "happy-dom": "^20.11.1",
     "publint": "^0.3.21",
     "size-limit": "^13.0.1",
@@ -116,6 +127,13 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   },
+  "typesVersions": {
+    "*": {
+      "testing": [
+        "./dist/testing.d.ts"
+      ]
+    }
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run --coverage",