purrtabby 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 minseon
+
+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,436 @@
+# purrtabby
+
+<p align="center">
+  <img src="./logo.png" width="100" height="100" alt="purrtabby" style="border-radius: 22px;">
+  <br>
+  <a href="https://www.npmjs.org/package/purrtabby"><img src="https://img.shields.io/npm/v/purrtabby.svg" alt="npm"></a>
+  <img src="https://github.com/let-sunny/purrtabby/workflows/CI/badge.svg" alt="build status">
+  <a href="https://unpkg.com/purrtabby/dist/index.global.js"><img src="https://img.badgesize.io/https://unpkg.com/purrtabby/dist/index.global.js?compression=gzip" alt="gzip size"></a>
+</p>
+
+> Lightweight browser tab communication and leader election library using BroadcastChannel and localStorage
+
+A lightweight library for cross-tab communication and leader election in browser environments. Perfect for coordinating multiple tabs/windows and electing a single leader tab.
+
+## Highlights
+
+**Microscopic**: weighs less than 6KB minified (~2KB gzipped)
+
+**Reliable**: leader election with lease-based heartbeat mechanism
+
+**Modern**: async iterables for generator-based message streams
+
+**Type-Safe**: full TypeScript support
+
+**Zero Dependencies**: uses native Browser APIs only (BroadcastChannel, localStorage)
+
+**Flexible**: callback-based or generator-based APIs, your choice
+
+## Features
+
+- **Cross-tab communication** using BroadcastChannel
+- **Leader election** with localStorage-based lease and heartbeat
+- **Generator-based streams** for async iteration
+- **TypeScript** support
+- **Browser compatible** (requires BroadcastChannel and localStorage support)
+- **Zero dependencies** (uses native Browser APIs)
+- **Tiny bundle size**
+- **AbortSignal** support for stream cancellation
+
+## Table of Contents
+
+- [Installation](#installation)
+  - [Requirements](#requirements)
+- [Usage](#usage)
+  - [TabBus - Cross-tab Communication](#tabbus---cross-tab-communication)
+  - [LeaderElector - Leader Election](#leaderelector---leader-election)
+  - [Generator-based Streams](#generator-based-streams)
+  - [With AbortSignal](#with-abortsignal)
+  - [Callback-based API](#callback-based-api)
+- [API](#api)
+  - [createBus(options)](#createbusoptions)
+  - [createLeaderElector(options)](#createleaderelectoroptions)
+- [Examples](#examples)
+
+## Installation
+
+**npm:**
+```bash
+npm install purrtabby
+```
+
+**UMD build (via unpkg):**
+```html
+<script src="https://unpkg.com/purrtabby/dist/index.global.js"></script>
+```
+
+### Requirements
+
+**Runtime:**
+- **Browser**: Modern browsers with BroadcastChannel and localStorage support
+- **Node.js**: Not supported (requires browser APIs)
+
+**Development:**
+- **Node.js**: 24.13.0 (tested with this version)
+
+## Usage
+
+### TabBus - Cross-tab Communication
+
+```typescript
+import { createBus } from 'purrtabby';
+
+const bus = createBus({
+  channel: 'my-app-channel',
+});
+
+// Subscribe to specific message types
+const unsubscribe = bus.subscribe('user-action', (message) => {
+  console.log('Received:', message.payload);
+  console.log('From tab:', message.tabId);
+});
+
+// Publish messages to all tabs
+bus.publish('user-action', { action: 'click', target: 'button' });
+
+// Subscribe to all messages
+bus.subscribeAll((message) => {
+  console.log('Any message:', message.type, message.payload);
+});
+
+// Cleanup
+unsubscribe();
+bus.close();
+```
+
+### LeaderElector - Leader Election
+
+```typescript
+import { createLeaderElector } from 'purrtabby';
+
+const leader = createLeaderElector({
+  key: 'my-app-leader',
+  tabId: 'tab-1', // Optional: auto-generated if not provided
+  leaseMs: 5000,  // Lease duration in milliseconds
+  heartbeatMs: 2000, // Heartbeat interval
+  jitterMs: 500,  // Jitter to avoid thundering herd
+});
+
+// Start leader election
+leader.start();
+
+// Check if this tab is the leader
+if (leader.isLeader()) {
+  console.log('This tab is the leader!');
+}
+
+// Listen for leader events
+leader.on('acquired', () => {
+  console.log('Became the leader!');
+});
+
+leader.on('lost', (event) => {
+  console.log('Lost leadership:', event.meta?.newLeader);
+});
+
+leader.on('changed', (event) => {
+  console.log('Leadership changed to:', event.meta?.newLeader);
+});
+
+// Stop leader election
+leader.stop();
+```
+
+### Generator-based Streams
+
+```typescript
+import { createBus, createLeaderElector } from 'purrtabby';
+
+const bus = createBus({ channel: 'my-channel' });
+
+// Consume messages as async iterable
+(async () => {
+  for await (const message of bus.stream()) {
+    console.log('Received:', message.type, message.payload);
+  }
+})();
+
+const leader = createLeaderElector({
+  key: 'my-leader',
+  tabId: 'tab-1',
+});
+
+leader.start();
+
+// Consume leader events as async iterable
+(async () => {
+  for await (const event of leader.stream()) {
+    console.log('Leader event:', event.type, event.ts);
+  }
+})();
+```
+
+### With AbortSignal
+
+```typescript
+const controller = new AbortController();
+
+(async () => {
+  for await (const message of bus.stream({ signal: controller.signal })) {
+    console.log(message);
+    if (shouldStop) {
+      controller.abort();
+    }
+  }
+})();
+```
+
+### Callback-based API
+
+```typescript
+const bus = createBus({ channel: 'my-channel' });
+
+// Subscribe to messages
+const unsubscribeMessage = bus.subscribe('type', (message) => {
+  console.log('Message:', message);
+});
+
+// Subscribe to all messages
+const unsubscribeAll = bus.subscribeAll((message) => {
+  console.log('Any message:', message);
+});
+
+// Unsubscribe when done
+unsubscribeMessage();
+unsubscribeAll();
+
+const leader = createLeaderElector({
+  key: 'my-leader',
+  tabId: 'tab-1',
+});
+
+leader.start();
+
+// Subscribe to leader events
+const unsubscribeAcquired = leader.on('acquired', (event) => {
+  console.log('Became leader');
+});
+
+const unsubscribeLost = leader.on('lost', (event) => {
+  console.log('Lost leadership');
+});
+
+// Subscribe to all leader events
+const unsubscribeAll = leader.onAll((event) => {
+  console.log('Leader event:', event.type);
+});
+
+// Unsubscribe when done
+unsubscribeAcquired();
+unsubscribeLost();
+unsubscribeAll();
+```
+
+## API
+
+### `createBus(options)`
+
+Creates a new TabBus instance for cross-tab communication.
+
+#### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `channel` | `string` | **required** | BroadcastChannel name |
+| `tabId` | `string` | auto-generated | Unique tab identifier |
+
+#### TabBus Methods
+
+##### `publish(type, payload?)`
+
+Publishes a message to all tabs listening on the same channel.
+
+```typescript
+bus.publish('user-action', { action: 'click' });
+```
+
+##### `subscribe(type, handler)`
+
+Subscribes to messages of a specific type. Returns an unsubscribe function.
+
+```typescript
+const unsubscribe = bus.subscribe('user-action', (message) => {
+  console.log(message);
+});
+```
+
+##### `subscribeAll(handler)`
+
+Subscribes to all messages regardless of type. Returns an unsubscribe function.
+
+```typescript
+const unsubscribe = bus.subscribeAll((message) => {
+  console.log(message);
+});
+```
+
+##### `stream(options?)`
+
+Returns an async iterable of all messages.
+
+```typescript
+for await (const message of bus.stream({ signal: abortSignal })) {
+  console.log(message);
+}
+```
+
+##### `getTabId()`
+
+Returns the current tab's unique identifier.
+
+##### `close()`
+
+Closes the bus and cleans up resources.
+
+### `createLeaderElector(options)`
+
+Creates a new LeaderElector instance for leader election.
+
+#### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `key` | `string` | **required** | localStorage key for leader lease |
+| `tabId` | `string` | **required** | Unique tab identifier |
+| `leaseMs` | `number` | `5000` | Lease duration in milliseconds |
+| `heartbeatMs` | `number` | `2000` | Heartbeat interval in milliseconds |
+| `jitterMs` | `number` | `500` | Jitter range to avoid synchronization |
+
+#### LeaderElector Methods
+
+##### `start()`
+
+Starts the leader election process.
+
+##### `stop()`
+
+Stops leader election and releases leadership if held.
+
+##### `isLeader()`
+
+Returns `true` if this tab is currently the leader.
+
+##### `on(event, handler)`
+
+Subscribes to a specific leader event. Returns an unsubscribe function.
+
+Events:
+- `'acquired'` - This tab became the leader
+- `'lost'` - This tab lost leadership
+- `'changed'` - Leadership changed to another tab
+
+##### `onAll(handler)`
+
+Subscribes to all leader events. Returns an unsubscribe function.
+
+##### `stream(options?)`
+
+Returns an async iterable of leader events.
+
+##### `getTabId()`
+
+Returns the current tab's unique identifier.
+
+## Examples
+
+### Complete Example: Tab Coordination
+
+```typescript
+import { createBus, createLeaderElector } from 'purrtabby';
+
+// Set up cross-tab communication
+const bus = createBus({ channel: 'my-app' });
+
+// Set up leader election
+const leader = createLeaderElector({
+  key: 'my-app-leader',
+  tabId: `tab-${Date.now()}`,
+  leaseMs: 5000,
+  heartbeatMs: 2000,
+});
+
+// Start leader election
+leader.start();
+
+// Handle leader events
+leader.on('acquired', () => {
+  console.log('This tab is now the leader');
+  // Only the leader performs certain tasks
+  bus.publish('leader-announcement', { tabId: leader.getTabId() });
+});
+
+leader.on('lost', () => {
+  console.log('This tab is no longer the leader');
+});
+
+// Listen for messages from other tabs
+bus.subscribe('user-action', (message) => {
+  console.log('User action from tab:', message.tabId, message.payload);
+  
+  // If we're the leader, process the action
+  if (leader.isLeader()) {
+    console.log('Processing action as leader');
+  }
+});
+
+// Publish user actions
+bus.publish('user-action', { action: 'click', target: 'button' });
+
+// Cleanup
+leader.stop();
+bus.close();
+```
+
+### Using with purrcat (WebSocket)
+
+```typescript
+import createSocket from 'purrcat';
+import { createBus, createLeaderElector } from 'purrtabby';
+
+const bus = createBus({ channel: 'ws-coordinator' });
+const leader = createLeaderElector({
+  key: 'ws-leader',
+  tabId: `tab-${Date.now()}`,
+});
+
+leader.start();
+
+// Only the leader maintains WebSocket connection
+leader.on('acquired', () => {
+  const socket = createSocket({
+    url: 'wss://api.example.com/ws',
+  });
+
+  // Forward messages from WebSocket to all tabs
+  socket.onMessage((message) => {
+    bus.publish('ws-message', message);
+  });
+
+  // Forward messages from tabs to WebSocket
+  bus.subscribe('send-to-ws', (message) => {
+    socket.send(message.payload);
+  });
+});
+
+// All tabs can receive WebSocket messages
+bus.subscribe('ws-message', (message) => {
+  console.log('WebSocket message:', message.payload);
+});
+
+// Any tab can send to WebSocket (leader forwards it)
+bus.publish('send-to-ws', { type: 'ping' });
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var T=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var G=(e,r)=>{for(var a in r)T(e,a,{get:r[a],enumerable:!0})},J=(e,r,a,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of O(r))!$.call(e,s)&&s!==a&&T(e,s,{get:()=>r[s],enumerable:!(n=j(r,s))||n.enumerable});return e};var N=e=>J(T({},"__esModule",{value:!0}),e);var U={};G(U,{createBus:()=>L,createLeaderElector:()=>g,createRPC:()=>I,default:()=>K});module.exports=N(U);function C(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function w(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function k(e,r){return{type:e,ts:Date.now(),meta:r}}function p(e,r){return{type:e,ts:Date.now(),meta:r}}function y(e,r){let a=(Math.random()*2-1)*r;return Math.max(0,e+a)}function m(e){try{let r=localStorage.getItem(e);return r?JSON.parse(r):null}catch{return null}}function h(e,r){try{localStorage.setItem(e,JSON.stringify(r))}catch(a){console.error("Error writing leader lease:",a)}}function B(e){try{localStorage.removeItem(e)}catch(r){console.error("Error removing leader lease:",r)}}function v(e){return e?Date.now()-e.timestamp<e.leaseMs:!1}function E(e,r,a,n,s){return new Promise(o=>{let t=null,c=!1,l=()=>{c||(e&&e.removeEventListener("abort",i),s(d),t!==null&&(clearTimeout(t),t=null))},d=()=>{c||(c=!0,l(),o())},i=()=>d();if(e?.aborted){d();return}if(e&&e.addEventListener("abort",i),r()){d();return}if(n(d),!e){let u=()=>{if(!c){if(r()){d();return}t=setTimeout(u,100)}};u()}})}async function*S(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.messages.length>0&&!a?.aborted;)yield r.messages.shift();await E(a,()=>r.messages.length>0,e.messageResolvers,n=>e.messageResolvers.add(n),n=>e.messageResolvers.delete(n))}}finally{e.activeIterators--,e.activeIterators===0&&(r.messages=[])}}async function*M(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.events.length>0&&!a?.aborted;)yield r.events.shift();await E(a,()=>r.events.length>0,e.eventResolvers,n=>e.eventResolvers.add(n),n=>e.eventResolvers.delete(n))}}finally{e.activeIterators--,e.activeIterators===0&&(r.events=[])}}function P(e,r,a,n){let s=a.messageCallbacks.get(e.type);s&&s.forEach(o=>{try{o(e)}catch(t){console.error("Error in TabBus callback:",t)}}),a.allCallbacks.forEach(o=>{try{o(e)}catch(t){console.error("Error in TabBus all callback:",t)}}),n.push(e),a.messageResolvers.forEach(o=>o()),a.messageResolvers.clear()}function F(e,r,a,n){try{let s=e.data;P(s,r,a,n)}catch(s){console.error("Error handling TabBus message:",s)}}function L(e){let{channel:r,tabId:a}=e,n=a||C();if(typeof BroadcastChannel>"u")throw new Error("BroadcastChannel is not supported in this environment");let s=new BroadcastChannel(r),o={channel:s,tabId:n,messageCallbacks:new Map,allCallbacks:new Set,messageResolvers:new Set,activeIterators:0},t=[];return s.onmessage=l=>{F(l,n,o,t)},s.onmessageerror=()=>{let l=k("err",{error:"Failed to receive message"})},{publish(l,d){let i={type:l,payload:d,tabId:n,ts:Date.now()};s.postMessage(i),setTimeout(()=>{P(i,n,o,t)},0)},subscribe(l,d){return o.messageCallbacks.has(l)||o.messageCallbacks.set(l,new Set),o.messageCallbacks.get(l).add(d),()=>{let i=o.messageCallbacks.get(l);i&&(i.delete(d),i.size===0&&o.messageCallbacks.delete(l))}},subscribeAll(l){return o.allCallbacks.add(l),()=>{o.allCallbacks.delete(l)}},stream(l){return S(o,{messages:t},l?.signal)},getTabId(){return n},close(){s.close(),o.channel=null,o.messageCallbacks.clear(),o.allCallbacks.clear(),o.messageResolvers.clear()}}}function b(e,r,a){let n=r.eventCallbacks.get(e.type);n&&n.forEach(s=>{try{s(e)}catch(o){console.error("Error in LeaderElector callback:",o)}}),r.allCallbacks.forEach(s=>{try{s(e)}catch(o){console.error("Error in LeaderElector all callback:",o)}}),a.push(e),r.eventResolvers.forEach(s=>s()),r.eventResolvers.clear()}function z(e,r){if(e.stopped)return!1;let a=m(e.key);if(!v(a)){let n={tabId:e.tabId,timestamp:Date.now(),leaseMs:e.leaseMs};if(h(e.key,n),m(e.key)?.tabId===e.tabId)return e.isLeader||(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)),!0}return a?.tabId===e.tabId&&v(a)?(e.isLeader||(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)),!0):(e.isLeader&&(e.isLeader=!1,b(p("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)),!1)}function H(e,r){if(e.stopped||!e.isLeader)return;let a=m(e.key);if(a?.tabId===e.tabId){let n={...a,timestamp:Date.now()};h(e.key,n)}else e.isLeader&&(e.isLeader=!1,b(p("lose",{tabId:e.tabId}),e,r))}function x(e,r){if(e.stopped)return;let a=m(e.key),n=e.isLeader,s=a?.tabId===e.tabId&&v(a);!n&&s?(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)):n&&!s?(e.isLeader=!1,b(p("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)):n&&s&&a?.tabId!==e.tabId&&b(p("change",{tabId:e.tabId,newLeader:a.tabId}),e,r)}function g(e){let{key:r,tabId:a,leaseMs:n=5e3,heartbeatMs:s=2e3,jitterMs:o=500}=e;if(typeof localStorage>"u")throw new Error("localStorage is not supported in this environment");let t={key:r,tabId:a,leaseMs:n,heartbeatMs:s,jitterMs:o,isLeader:!1,heartbeatTimer:null,checkTimer:null,eventCallbacks:new Map,allCallbacks:new Set,eventResolvers:new Set,activeIterators:0,stopped:!1},c=[];function l(i){i.key!==t.key||i.storageArea!==localStorage||x(t,c)}return typeof window<"u"&&window.addEventListener("storage",l),{start(){if(t.stopped&&(t.stopped=!1),z(t,c),t.isLeader){let u=y(t.heartbeatMs,t.jitterMs);t.heartbeatTimer=setInterval(()=>{H(t,c)},u)}let i=y(t.heartbeatMs/2,t.jitterMs);t.checkTimer=setInterval(()=>{x(t,c)},i)},stop(){t.stopped=!0,t.heartbeatTimer&&(clearInterval(t.heartbeatTimer),t.heartbeatTimer=null),t.checkTimer&&(clearInterval(t.checkTimer),t.checkTimer=null),t.isLeader&&(m(t.key)?.tabId===t.tabId&&B(t.key),t.isLeader=!1,b(p("lose",{tabId:t.tabId,reason:"stopped"}),t,c)),typeof window<"u"&&window.removeEventListener("storage",l)},isLeader(){return t.isLeader},on(i,u){return t.eventCallbacks.has(i)||t.eventCallbacks.set(i,new Set),t.eventCallbacks.get(i).add(u),()=>{let f=t.eventCallbacks.get(i);f&&(f.delete(u),f.size===0&&t.eventCallbacks.delete(i))}},onAll(i){return t.allCallbacks.add(i),()=>{t.allCallbacks.delete(i)}},stream(i){return M(t,{events:c},i?.signal)},getTabId(){return t.tabId}}}function Q(e,r,a){if(e.tabId===a)return;let n=r.handlers.get(e.method);if(!n){let s={type:"rpc-response",requestId:e.requestId,error:`No handler found for method: ${e.method}`,tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",s)}catch{}return}Promise.resolve(n(e.params)).then(s=>{let o={type:"rpc-response",requestId:e.requestId,result:s,tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",o)}catch{}}).catch(s=>{let o={type:"rpc-response",requestId:e.requestId,error:s instanceof Error?s.message:String(s),tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",o)}catch{}})}function V(e,r,a){let n=r.pendingRequests.get(e.requestId);n&&(clearTimeout(n.timeout),r.pendingRequests.delete(e.requestId),e.error?n.reject(new Error(e.error)):n.resolve(e.result))}function I(e){let{bus:r,timeout:a=5e3}=e,n=r.getTabId(),s={bus:r,timeout:a,pendingRequests:new Map,handlers:new Map},o=r.subscribe("rpc-request",l=>{let d=l.payload;d&&d.type==="rpc-request"&&Q(d,s,n)}),t=r.subscribe("rpc-response",l=>{let d=l.payload;d&&d.type==="rpc-response"&&V(d,s,n)});return{call(l,d,i){let u=w(),f=i?.timeout??s.timeout;return new Promise((q,R)=>{let A=setTimeout(()=>{s.pendingRequests.delete(u),R(new Error(`RPC call timeout: ${l} (${f}ms)`))},f);s.pendingRequests.set(u,{resolve:q,reject:R,timeout:A});let D={type:"rpc-request",method:l,params:d,requestId:u,tabId:n,ts:Date.now()};r.publish("rpc-request",D)})},handle(l,d){return s.handlers.set(l,d),()=>{s.handlers.delete(l)}},close(){s.pendingRequests.forEach(l=>{clearTimeout(l.timeout),l.reject(new Error("RPC closed"))}),s.pendingRequests.clear(),s.handlers.clear(),o(),t()}}}var K={createBus:L,createLeaderElector:g,createRPC:I};0&&(module.exports={createBus,createLeaderElector,createRPC});

package/dist/index.d.cts

@@ -0,0 +1,135 @@
+/** TabBus message structure */
+interface TabBusMessage<T = any> {
+    type: string;
+    payload?: T;
+    tabId: string;
+    ts: number;
+}
+/** TabBus event types */
+type TabBusEventType = 'msg' | 'err';
+/** TabBus event structure */
+interface TabBusEvent {
+    type: TabBusEventType;
+    ts: number;
+    meta?: Record<string, any>;
+}
+/** Options for createBus() */
+interface BusOptions {
+    channel: string;
+    tabId?: string;
+}
+/** Return type of createBus(), provides async iterables and callbacks */
+interface TabBus<T = any> {
+    /** Publish a message to all tabs */
+    publish(type: string, payload?: T): void;
+    /** Subscribe to messages of a specific type */
+    subscribe(type: string, handler: (message: TabBusMessage<T>) => void): () => void;
+    /** Subscribe to all messages */
+    subscribeAll(handler: (message: TabBusMessage<T>) => void): () => void;
+    /** Get async iterable stream of messages */
+    stream(options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<TabBusMessage<T>>;
+    /** Get the current tab ID */
+    getTabId(): string;
+    /** Close the bus and cleanup */
+    close(): void;
+}
+/** Leader election event types */
+type LeaderEventType = 'acquire' | 'lose' | 'change';
+/** Leader election event structure */
+interface LeaderEvent {
+    type: LeaderEventType;
+    ts: number;
+    meta?: Record<string, any>;
+}
+/** Options for createLeaderElector() */
+interface LeaderElectorOptions {
+    key: string;
+    tabId: string;
+    leaseMs?: number;
+    heartbeatMs?: number;
+    jitterMs?: number;
+}
+/** Return type of createLeaderElector() */
+interface LeaderElector {
+    /** Start leader election */
+    start(): void;
+    /** Stop leader election and release leadership if held */
+    stop(): void;
+    /** Check if this tab is the leader */
+    isLeader(): boolean;
+    /** Subscribe to leader events */
+    on(event: LeaderEventType, handler: (event: LeaderEvent) => void): () => void;
+    /** Subscribe to all leader events */
+    onAll(handler: (event: LeaderEvent) => void): () => void;
+    /** Get async iterable stream of leader events */
+    stream(options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<LeaderEvent>;
+    /** Get the current tab ID */
+    getTabId(): string;
+}
+/** RPC request message */
+interface RPCRequest<T = any> {
+    type: 'rpc-request';
+    method: string;
+    params?: T;
+    requestId: string;
+    tabId: string;
+    ts: number;
+}
+/** RPC response message */
+interface RPCResponse<T = any> {
+    type: 'rpc-response';
+    requestId: string;
+    result?: T;
+    error?: string;
+    tabId: string;
+    ts: number;
+}
+/** Options for createRPC() */
+interface RPCOptions {
+    bus: TabBus;
+    timeout?: number;
+}
+/** Return type of createRPC() */
+interface RPC {
+    /** Call a method on the leader (or any tab) */
+    call<TParams = any, TResult = any>(method: string, params?: TParams, options?: {
+        timeout?: number;
+    }): Promise<TResult>;
+    /** Handle incoming RPC requests */
+    handle<TParams = any, TResult = any>(method: string, handler: (params?: TParams) => Promise<TResult> | TResult): () => void;
+    /** Close the RPC instance and cleanup */
+    close(): void;
+}
+
+/**
+ * Create a TabBus instance for cross-tab communication
+ * @param options - Bus configuration options
+ * @returns TabBus instance
+ */
+declare function createBus<T = any>(options: BusOptions): TabBus<T>;
+
+/**
+ * Create a LeaderElector instance for leader election
+ * @param options - Leader elector configuration options
+ * @returns LeaderElector instance
+ */
+declare function createLeaderElector(options: LeaderElectorOptions): LeaderElector;
+
+/**
+ * Create an RPC instance for request-response communication
+ * @param options - RPC configuration options
+ * @returns RPC instance
+ */
+declare function createRPC(options: RPCOptions): RPC;
+
+declare const _default: {
+    createBus: typeof createBus;
+    createLeaderElector: typeof createLeaderElector;
+    createRPC: typeof createRPC;
+};
+
+export { type BusOptions, createBus as CreateBus, createLeaderElector as CreateLeaderElector, createRPC as CreateRPC, type LeaderElector, type LeaderElectorOptions, type LeaderEvent, type LeaderEventType, type RPC, type RPCOptions, type RPCRequest, type RPCResponse, type TabBus, type TabBusEvent, type TabBusEventType, type TabBusMessage, createBus, createLeaderElector, createRPC, _default as default };

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+/** TabBus message structure */
+interface TabBusMessage<T = any> {
+    type: string;
+    payload?: T;
+    tabId: string;
+    ts: number;
+}
+/** TabBus event types */
+type TabBusEventType = 'msg' | 'err';
+/** TabBus event structure */
+interface TabBusEvent {
+    type: TabBusEventType;
+    ts: number;
+    meta?: Record<string, any>;
+}
+/** Options for createBus() */
+interface BusOptions {
+    channel: string;
+    tabId?: string;
+}
+/** Return type of createBus(), provides async iterables and callbacks */
+interface TabBus<T = any> {
+    /** Publish a message to all tabs */
+    publish(type: string, payload?: T): void;
+    /** Subscribe to messages of a specific type */
+    subscribe(type: string, handler: (message: TabBusMessage<T>) => void): () => void;
+    /** Subscribe to all messages */
+    subscribeAll(handler: (message: TabBusMessage<T>) => void): () => void;
+    /** Get async iterable stream of messages */
+    stream(options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<TabBusMessage<T>>;
+    /** Get the current tab ID */
+    getTabId(): string;
+    /** Close the bus and cleanup */
+    close(): void;
+}
+/** Leader election event types */
+type LeaderEventType = 'acquire' | 'lose' | 'change';
+/** Leader election event structure */
+interface LeaderEvent {
+    type: LeaderEventType;
+    ts: number;
+    meta?: Record<string, any>;
+}
+/** Options for createLeaderElector() */
+interface LeaderElectorOptions {
+    key: string;
+    tabId: string;
+    leaseMs?: number;
+    heartbeatMs?: number;
+    jitterMs?: number;
+}
+/** Return type of createLeaderElector() */
+interface LeaderElector {
+    /** Start leader election */
+    start(): void;
+    /** Stop leader election and release leadership if held */
+    stop(): void;
+    /** Check if this tab is the leader */
+    isLeader(): boolean;
+    /** Subscribe to leader events */
+    on(event: LeaderEventType, handler: (event: LeaderEvent) => void): () => void;
+    /** Subscribe to all leader events */
+    onAll(handler: (event: LeaderEvent) => void): () => void;
+    /** Get async iterable stream of leader events */
+    stream(options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<LeaderEvent>;
+    /** Get the current tab ID */
+    getTabId(): string;
+}
+/** RPC request message */
+interface RPCRequest<T = any> {
+    type: 'rpc-request';
+    method: string;
+    params?: T;
+    requestId: string;
+    tabId: string;
+    ts: number;
+}
+/** RPC response message */
+interface RPCResponse<T = any> {
+    type: 'rpc-response';
+    requestId: string;
+    result?: T;
+    error?: string;
+    tabId: string;
+    ts: number;
+}
+/** Options for createRPC() */
+interface RPCOptions {
+    bus: TabBus;
+    timeout?: number;
+}
+/** Return type of createRPC() */
+interface RPC {
+    /** Call a method on the leader (or any tab) */
+    call<TParams = any, TResult = any>(method: string, params?: TParams, options?: {
+        timeout?: number;
+    }): Promise<TResult>;
+    /** Handle incoming RPC requests */
+    handle<TParams = any, TResult = any>(method: string, handler: (params?: TParams) => Promise<TResult> | TResult): () => void;
+    /** Close the RPC instance and cleanup */
+    close(): void;
+}
+
+/**
+ * Create a TabBus instance for cross-tab communication
+ * @param options - Bus configuration options
+ * @returns TabBus instance
+ */
+declare function createBus<T = any>(options: BusOptions): TabBus<T>;
+
+/**
+ * Create a LeaderElector instance for leader election
+ * @param options - Leader elector configuration options
+ * @returns LeaderElector instance
+ */
+declare function createLeaderElector(options: LeaderElectorOptions): LeaderElector;
+
+/**
+ * Create an RPC instance for request-response communication
+ * @param options - RPC configuration options
+ * @returns RPC instance
+ */
+declare function createRPC(options: RPCOptions): RPC;
+
+declare const _default: {
+    createBus: typeof createBus;
+    createLeaderElector: typeof createLeaderElector;
+    createRPC: typeof createRPC;
+};
+
+export { type BusOptions, createBus as CreateBus, createLeaderElector as CreateLeaderElector, createRPC as CreateRPC, type LeaderElector, type LeaderElectorOptions, type LeaderEvent, type LeaderEventType, type RPC, type RPCOptions, type RPCRequest, type RPCResponse, type TabBus, type TabBusEvent, type TabBusEventType, type TabBusMessage, createBus, createLeaderElector, createRPC, _default as default };

package/dist/index.global.js

@@ -0,0 +1 @@
+"use strict";var purrtabby=(()=>{var T=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var G=(e,r)=>{for(var a in r)T(e,a,{get:r[a],enumerable:!0})},J=(e,r,a,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of O(r))!$.call(e,s)&&s!==a&&T(e,s,{get:()=>r[s],enumerable:!(n=j(r,s))||n.enumerable});return e};var N=e=>J(T({},"__esModule",{value:!0}),e);var U={};G(U,{createBus:()=>L,createLeaderElector:()=>g,createRPC:()=>I,default:()=>K});function C(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function w(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function k(e,r){return{type:e,ts:Date.now(),meta:r}}function p(e,r){return{type:e,ts:Date.now(),meta:r}}function y(e,r){let a=(Math.random()*2-1)*r;return Math.max(0,e+a)}function m(e){try{let r=localStorage.getItem(e);return r?JSON.parse(r):null}catch{return null}}function h(e,r){try{localStorage.setItem(e,JSON.stringify(r))}catch(a){console.error("Error writing leader lease:",a)}}function B(e){try{localStorage.removeItem(e)}catch(r){console.error("Error removing leader lease:",r)}}function v(e){return e?Date.now()-e.timestamp<e.leaseMs:!1}function E(e,r,a,n,s){return new Promise(o=>{let t=null,c=!1,l=()=>{c||(e&&e.removeEventListener("abort",i),s(d),t!==null&&(clearTimeout(t),t=null))},d=()=>{c||(c=!0,l(),o())},i=()=>d();if(e?.aborted){d();return}if(e&&e.addEventListener("abort",i),r()){d();return}if(n(d),!e){let u=()=>{if(!c){if(r()){d();return}t=setTimeout(u,100)}};u()}})}async function*S(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.messages.length>0&&!a?.aborted;)yield r.messages.shift();await E(a,()=>r.messages.length>0,e.messageResolvers,n=>e.messageResolvers.add(n),n=>e.messageResolvers.delete(n))}}finally{e.activeIterators--,e.activeIterators===0&&(r.messages=[])}}async function*M(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.events.length>0&&!a?.aborted;)yield r.events.shift();await E(a,()=>r.events.length>0,e.eventResolvers,n=>e.eventResolvers.add(n),n=>e.eventResolvers.delete(n))}}finally{e.activeIterators--,e.activeIterators===0&&(r.events=[])}}function P(e,r,a,n){let s=a.messageCallbacks.get(e.type);s&&s.forEach(o=>{try{o(e)}catch(t){console.error("Error in TabBus callback:",t)}}),a.allCallbacks.forEach(o=>{try{o(e)}catch(t){console.error("Error in TabBus all callback:",t)}}),n.push(e),a.messageResolvers.forEach(o=>o()),a.messageResolvers.clear()}function F(e,r,a,n){try{let s=e.data;P(s,r,a,n)}catch(s){console.error("Error handling TabBus message:",s)}}function L(e){let{channel:r,tabId:a}=e,n=a||C();if(typeof BroadcastChannel>"u")throw new Error("BroadcastChannel is not supported in this environment");let s=new BroadcastChannel(r),o={channel:s,tabId:n,messageCallbacks:new Map,allCallbacks:new Set,messageResolvers:new Set,activeIterators:0},t=[];return s.onmessage=l=>{F(l,n,o,t)},s.onmessageerror=()=>{let l=k("err",{error:"Failed to receive message"})},{publish(l,d){let i={type:l,payload:d,tabId:n,ts:Date.now()};s.postMessage(i),setTimeout(()=>{P(i,n,o,t)},0)},subscribe(l,d){return o.messageCallbacks.has(l)||o.messageCallbacks.set(l,new Set),o.messageCallbacks.get(l).add(d),()=>{let i=o.messageCallbacks.get(l);i&&(i.delete(d),i.size===0&&o.messageCallbacks.delete(l))}},subscribeAll(l){return o.allCallbacks.add(l),()=>{o.allCallbacks.delete(l)}},stream(l){return S(o,{messages:t},l?.signal)},getTabId(){return n},close(){s.close(),o.channel=null,o.messageCallbacks.clear(),o.allCallbacks.clear(),o.messageResolvers.clear()}}}function b(e,r,a){let n=r.eventCallbacks.get(e.type);n&&n.forEach(s=>{try{s(e)}catch(o){console.error("Error in LeaderElector callback:",o)}}),r.allCallbacks.forEach(s=>{try{s(e)}catch(o){console.error("Error in LeaderElector all callback:",o)}}),a.push(e),r.eventResolvers.forEach(s=>s()),r.eventResolvers.clear()}function z(e,r){if(e.stopped)return!1;let a=m(e.key);if(!v(a)){let n={tabId:e.tabId,timestamp:Date.now(),leaseMs:e.leaseMs};if(h(e.key,n),m(e.key)?.tabId===e.tabId)return e.isLeader||(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)),!0}return a?.tabId===e.tabId&&v(a)?(e.isLeader||(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)),!0):(e.isLeader&&(e.isLeader=!1,b(p("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)),!1)}function H(e,r){if(e.stopped||!e.isLeader)return;let a=m(e.key);if(a?.tabId===e.tabId){let n={...a,timestamp:Date.now()};h(e.key,n)}else e.isLeader&&(e.isLeader=!1,b(p("lose",{tabId:e.tabId}),e,r))}function x(e,r){if(e.stopped)return;let a=m(e.key),n=e.isLeader,s=a?.tabId===e.tabId&&v(a);!n&&s?(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)):n&&!s?(e.isLeader=!1,b(p("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)):n&&s&&a?.tabId!==e.tabId&&b(p("change",{tabId:e.tabId,newLeader:a.tabId}),e,r)}function g(e){let{key:r,tabId:a,leaseMs:n=5e3,heartbeatMs:s=2e3,jitterMs:o=500}=e;if(typeof localStorage>"u")throw new Error("localStorage is not supported in this environment");let t={key:r,tabId:a,leaseMs:n,heartbeatMs:s,jitterMs:o,isLeader:!1,heartbeatTimer:null,checkTimer:null,eventCallbacks:new Map,allCallbacks:new Set,eventResolvers:new Set,activeIterators:0,stopped:!1},c=[];function l(i){i.key!==t.key||i.storageArea!==localStorage||x(t,c)}return typeof window<"u"&&window.addEventListener("storage",l),{start(){if(t.stopped&&(t.stopped=!1),z(t,c),t.isLeader){let u=y(t.heartbeatMs,t.jitterMs);t.heartbeatTimer=setInterval(()=>{H(t,c)},u)}let i=y(t.heartbeatMs/2,t.jitterMs);t.checkTimer=setInterval(()=>{x(t,c)},i)},stop(){t.stopped=!0,t.heartbeatTimer&&(clearInterval(t.heartbeatTimer),t.heartbeatTimer=null),t.checkTimer&&(clearInterval(t.checkTimer),t.checkTimer=null),t.isLeader&&(m(t.key)?.tabId===t.tabId&&B(t.key),t.isLeader=!1,b(p("lose",{tabId:t.tabId,reason:"stopped"}),t,c)),typeof window<"u"&&window.removeEventListener("storage",l)},isLeader(){return t.isLeader},on(i,u){return t.eventCallbacks.has(i)||t.eventCallbacks.set(i,new Set),t.eventCallbacks.get(i).add(u),()=>{let f=t.eventCallbacks.get(i);f&&(f.delete(u),f.size===0&&t.eventCallbacks.delete(i))}},onAll(i){return t.allCallbacks.add(i),()=>{t.allCallbacks.delete(i)}},stream(i){return M(t,{events:c},i?.signal)},getTabId(){return t.tabId}}}function Q(e,r,a){if(e.tabId===a)return;let n=r.handlers.get(e.method);if(!n){let s={type:"rpc-response",requestId:e.requestId,error:`No handler found for method: ${e.method}`,tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",s)}catch{}return}Promise.resolve(n(e.params)).then(s=>{let o={type:"rpc-response",requestId:e.requestId,result:s,tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",o)}catch{}}).catch(s=>{let o={type:"rpc-response",requestId:e.requestId,error:s instanceof Error?s.message:String(s),tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",o)}catch{}})}function V(e,r,a){let n=r.pendingRequests.get(e.requestId);n&&(clearTimeout(n.timeout),r.pendingRequests.delete(e.requestId),e.error?n.reject(new Error(e.error)):n.resolve(e.result))}function I(e){let{bus:r,timeout:a=5e3}=e,n=r.getTabId(),s={bus:r,timeout:a,pendingRequests:new Map,handlers:new Map},o=r.subscribe("rpc-request",l=>{let d=l.payload;d&&d.type==="rpc-request"&&Q(d,s,n)}),t=r.subscribe("rpc-response",l=>{let d=l.payload;d&&d.type==="rpc-response"&&V(d,s,n)});return{call(l,d,i){let u=w(),f=i?.timeout??s.timeout;return new Promise((q,R)=>{let A=setTimeout(()=>{s.pendingRequests.delete(u),R(new Error(`RPC call timeout: ${l} (${f}ms)`))},f);s.pendingRequests.set(u,{resolve:q,reject:R,timeout:A});let D={type:"rpc-request",method:l,params:d,requestId:u,tabId:n,ts:Date.now()};r.publish("rpc-request",D)})},handle(l,d){return s.handlers.set(l,d),()=>{s.handlers.delete(l)}},close(){s.pendingRequests.forEach(l=>{clearTimeout(l.timeout),l.reject(new Error("RPC closed"))}),s.pendingRequests.clear(),s.handlers.clear(),o(),t()}}}var K={createBus:L,createLeaderElector:g,createRPC:I};return N(U);})();

package/dist/index.js

@@ -0,0 +1 @@
+function R(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function C(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function w(e,r){return{type:e,ts:Date.now(),meta:r}}function p(e,r){return{type:e,ts:Date.now(),meta:r}}function L(e,r){let a=(Math.random()*2-1)*r;return Math.max(0,e+a)}function m(e){try{let r=localStorage.getItem(e);return r?JSON.parse(r):null}catch{return null}}function g(e,r){try{localStorage.setItem(e,JSON.stringify(r))}catch(a){console.error("Error writing leader lease:",a)}}function k(e){try{localStorage.removeItem(e)}catch(r){console.error("Error removing leader lease:",r)}}function v(e){return e?Date.now()-e.timestamp<e.leaseMs:!1}function I(e,r,a,n,s){return new Promise(o=>{let t=null,c=!1,l=()=>{c||(e&&e.removeEventListener("abort",i),s(d),t!==null&&(clearTimeout(t),t=null))},d=()=>{c||(c=!0,l(),o())},i=()=>d();if(e?.aborted){d();return}if(e&&e.addEventListener("abort",i),r()){d();return}if(n(d),!e){let u=()=>{if(!c){if(r()){d();return}t=setTimeout(u,100)}};u()}})}async function*B(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.messages.length>0&&!a?.aborted;)yield r.messages.shift();await I(a,()=>r.messages.length>0,e.messageResolvers,n=>e.messageResolvers.add(n),n=>e.messageResolvers.delete(n))}}finally{e.activeIterators--,e.activeIterators===0&&(r.messages=[])}}async function*S(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.events.length>0&&!a?.aborted;)yield r.events.shift();await I(a,()=>r.events.length>0,e.eventResolvers,n=>e.eventResolvers.add(n),n=>e.eventResolvers.delete(n))}}finally{e.activeIterators--,e.activeIterators===0&&(r.events=[])}}function M(e,r,a,n){let s=a.messageCallbacks.get(e.type);s&&s.forEach(o=>{try{o(e)}catch(t){console.error("Error in TabBus callback:",t)}}),a.allCallbacks.forEach(o=>{try{o(e)}catch(t){console.error("Error in TabBus all callback:",t)}}),n.push(e),a.messageResolvers.forEach(o=>o()),a.messageResolvers.clear()}function D(e,r,a,n){try{let s=e.data;M(s,r,a,n)}catch(s){console.error("Error handling TabBus message:",s)}}function T(e){let{channel:r,tabId:a}=e,n=a||R();if(typeof BroadcastChannel>"u")throw new Error("BroadcastChannel is not supported in this environment");let s=new BroadcastChannel(r),o={channel:s,tabId:n,messageCallbacks:new Map,allCallbacks:new Set,messageResolvers:new Set,activeIterators:0},t=[];return s.onmessage=l=>{D(l,n,o,t)},s.onmessageerror=()=>{let l=w("err",{error:"Failed to receive message"})},{publish(l,d){let i={type:l,payload:d,tabId:n,ts:Date.now()};s.postMessage(i),setTimeout(()=>{M(i,n,o,t)},0)},subscribe(l,d){return o.messageCallbacks.has(l)||o.messageCallbacks.set(l,new Set),o.messageCallbacks.get(l).add(d),()=>{let i=o.messageCallbacks.get(l);i&&(i.delete(d),i.size===0&&o.messageCallbacks.delete(l))}},subscribeAll(l){return o.allCallbacks.add(l),()=>{o.allCallbacks.delete(l)}},stream(l){return B(o,{messages:t},l?.signal)},getTabId(){return n},close(){s.close(),o.channel=null,o.messageCallbacks.clear(),o.allCallbacks.clear(),o.messageResolvers.clear()}}}function b(e,r,a){let n=r.eventCallbacks.get(e.type);n&&n.forEach(s=>{try{s(e)}catch(o){console.error("Error in LeaderElector callback:",o)}}),r.allCallbacks.forEach(s=>{try{s(e)}catch(o){console.error("Error in LeaderElector all callback:",o)}}),a.push(e),r.eventResolvers.forEach(s=>s()),r.eventResolvers.clear()}function j(e,r){if(e.stopped)return!1;let a=m(e.key);if(!v(a)){let n={tabId:e.tabId,timestamp:Date.now(),leaseMs:e.leaseMs};if(g(e.key,n),m(e.key)?.tabId===e.tabId)return e.isLeader||(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)),!0}return a?.tabId===e.tabId&&v(a)?(e.isLeader||(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)),!0):(e.isLeader&&(e.isLeader=!1,b(p("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)),!1)}function O(e,r){if(e.stopped||!e.isLeader)return;let a=m(e.key);if(a?.tabId===e.tabId){let n={...a,timestamp:Date.now()};g(e.key,n)}else e.isLeader&&(e.isLeader=!1,b(p("lose",{tabId:e.tabId}),e,r))}function P(e,r){if(e.stopped)return;let a=m(e.key),n=e.isLeader,s=a?.tabId===e.tabId&&v(a);!n&&s?(e.isLeader=!0,b(p("acquire",{tabId:e.tabId}),e,r)):n&&!s?(e.isLeader=!1,b(p("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)):n&&s&&a?.tabId!==e.tabId&&b(p("change",{tabId:e.tabId,newLeader:a.tabId}),e,r)}function y(e){let{key:r,tabId:a,leaseMs:n=5e3,heartbeatMs:s=2e3,jitterMs:o=500}=e;if(typeof localStorage>"u")throw new Error("localStorage is not supported in this environment");let t={key:r,tabId:a,leaseMs:n,heartbeatMs:s,jitterMs:o,isLeader:!1,heartbeatTimer:null,checkTimer:null,eventCallbacks:new Map,allCallbacks:new Set,eventResolvers:new Set,activeIterators:0,stopped:!1},c=[];function l(i){i.key!==t.key||i.storageArea!==localStorage||P(t,c)}return typeof window<"u"&&window.addEventListener("storage",l),{start(){if(t.stopped&&(t.stopped=!1),j(t,c),t.isLeader){let u=L(t.heartbeatMs,t.jitterMs);t.heartbeatTimer=setInterval(()=>{O(t,c)},u)}let i=L(t.heartbeatMs/2,t.jitterMs);t.checkTimer=setInterval(()=>{P(t,c)},i)},stop(){t.stopped=!0,t.heartbeatTimer&&(clearInterval(t.heartbeatTimer),t.heartbeatTimer=null),t.checkTimer&&(clearInterval(t.checkTimer),t.checkTimer=null),t.isLeader&&(m(t.key)?.tabId===t.tabId&&k(t.key),t.isLeader=!1,b(p("lose",{tabId:t.tabId,reason:"stopped"}),t,c)),typeof window<"u"&&window.removeEventListener("storage",l)},isLeader(){return t.isLeader},on(i,u){return t.eventCallbacks.has(i)||t.eventCallbacks.set(i,new Set),t.eventCallbacks.get(i).add(u),()=>{let f=t.eventCallbacks.get(i);f&&(f.delete(u),f.size===0&&t.eventCallbacks.delete(i))}},onAll(i){return t.allCallbacks.add(i),()=>{t.allCallbacks.delete(i)}},stream(i){return S(t,{events:c},i?.signal)},getTabId(){return t.tabId}}}function $(e,r,a){if(e.tabId===a)return;let n=r.handlers.get(e.method);if(!n){let s={type:"rpc-response",requestId:e.requestId,error:`No handler found for method: ${e.method}`,tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",s)}catch{}return}Promise.resolve(n(e.params)).then(s=>{let o={type:"rpc-response",requestId:e.requestId,result:s,tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",o)}catch{}}).catch(s=>{let o={type:"rpc-response",requestId:e.requestId,error:s instanceof Error?s.message:String(s),tabId:a,ts:Date.now()};try{r.bus.publish("rpc-response",o)}catch{}})}function G(e,r,a){let n=r.pendingRequests.get(e.requestId);n&&(clearTimeout(n.timeout),r.pendingRequests.delete(e.requestId),e.error?n.reject(new Error(e.error)):n.resolve(e.result))}function h(e){let{bus:r,timeout:a=5e3}=e,n=r.getTabId(),s={bus:r,timeout:a,pendingRequests:new Map,handlers:new Map},o=r.subscribe("rpc-request",l=>{let d=l.payload;d&&d.type==="rpc-request"&&$(d,s,n)}),t=r.subscribe("rpc-response",l=>{let d=l.payload;d&&d.type==="rpc-response"&&G(d,s,n)});return{call(l,d,i){let u=C(),f=i?.timeout??s.timeout;return new Promise((x,E)=>{let q=setTimeout(()=>{s.pendingRequests.delete(u),E(new Error(`RPC call timeout: ${l} (${f}ms)`))},f);s.pendingRequests.set(u,{resolve:x,reject:E,timeout:q});let A={type:"rpc-request",method:l,params:d,requestId:u,tabId:n,ts:Date.now()};r.publish("rpc-request",A)})},handle(l,d){return s.handlers.set(l,d),()=>{s.handlers.delete(l)}},close(){s.pendingRequests.forEach(l=>{clearTimeout(l.timeout),l.reject(new Error("RPC closed"))}),s.pendingRequests.clear(),s.handlers.clear(),o(),t()}}}var ee={createBus:T,createLeaderElector:y,createRPC:h};export{T as createBus,y as createLeaderElector,h as createRPC,ee as default};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "purrtabby",
+  "version": "0.1.0",
+  "description": "Lightweight browser tab communication and leader election library using BroadcastChannel and localStorage",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "unpkg": "dist/index.global.js",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm,iife --dts --minify --globalName purrtabby",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test",
+    "version": "npm run build"
+  },
+  "keywords": [
+    "broadcastchannel",
+    "tab",
+    "communication",
+    "leader-election",
+    "localstorage",
+    "inter-tab",
+    "cross-tab",
+    "pub-sub",
+    "rpc",
+    "typescript",
+    "async-iterable",
+    "generator"
+  ],
+  "author": "minseon",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "@types/node": "^20.0.0",
+    "jsdom": "^24.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "volta": {
+    "node": "24.13.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/let-sunny/purrtabby.git"
+  },
+  "bugs": {
+    "url": "https://github.com/let-sunny/purrtabby/issues"
+  },
+  "homepage": "https://github.com/let-sunny/purrtabby#readme"
+}