purrtabby 0.1.0 → 0.1.2

package/README.md

@@ -14,7 +14,7 @@ A lightweight library for cross-tab communication and leader election in browser
 
 ## Highlights
 
-**Microscopic**: weighs less than 6KB minified (~2KB gzipped)
+**Microscopic**: weighs less than 7KB minified (~3KB gzipped)
 
 **Reliable**: leader election with lease-based heartbeat mechanism
 
@@ -26,6 +26,18 @@ A lightweight library for cross-tab communication and leader election in browser
 
 **Flexible**: callback-based or generator-based APIs, your choice
 
+## 🎮 Try It Live
+
+**[Interactive Demo →](https://let-sunny.github.io/purrtabby/)**
+
+Try purrtabby in your browser with our interactive demo. Test cross-tab communication and leader election between multiple tabs.
+
+## 📚 Documentation
+
+**[Architecture Documentation →](./docs/ARCHITECTURE.md)** 
+
+Learn about purrtabby's internal architecture and design decisions.
+
 ## Features
 
 - **Cross-tab communication** using BroadcastChannel
@@ -125,15 +137,15 @@ if (leader.isLeader()) {
 }
 
 // Listen for leader events
-leader.on('acquired', () => {
+leader.on('acquire', () => {
   console.log('Became the leader!');
 });
 
-leader.on('lost', (event) => {
+leader.on('lose', (event) => {
   console.log('Lost leadership:', event.meta?.newLeader);
 });
 
-leader.on('changed', (event) => {
+leader.on('change', (event) => {
   console.log('Leadership changed to:', event.meta?.newLeader);
 });
 
@@ -141,11 +153,62 @@ leader.on('changed', (event) => {
 leader.stop();
 ```
 
-### Generator-based Streams
+### Choosing Between Callback and Generator APIs
+
+purrtabby provides two ways to consume messages and events: **callbacks** and **generators**. Choose based on your needs:
+
+- **Callbacks**: Simple, event-driven, good for one-off handlers
+- **Generators**: Modern async/await patterns, better for complex flows, supports AbortSignal
+
+### Callback-based API
 
 ```typescript
-import { createBus, createLeaderElector } from 'purrtabby';
+const bus = createBus({ channel: 'my-channel' });
+
+// Subscribe to specific message types
+const unsubscribeMessage = bus.subscribe('user-action', (message) => {
+  console.log('Message:', message.payload);
+});
+
+// Subscribe to all messages
+const unsubscribeAll = bus.subscribeAll((message) => {
+  console.log('Any message:', message.type, message.payload);
+});
+
+// Unsubscribe when done
+unsubscribeMessage();
+unsubscribeAll();
+
+const leader = createLeaderElector({
+  key: 'my-leader',
+  tabId: 'tab-1',
+});
+
+leader.start();
+
+// Subscribe to specific leader events
+const unsubscribeAcquired = leader.on('acquire', (event) => {
+  console.log('Became leader');
+});
+
+const unsubscribeLost = leader.on('lose', (event) => {
+  console.log('Lost leadership');
+});
+
+// Subscribe to all leader events
+const unsubscribeAllEvents = leader.onAll((event) => {
+  console.log('Leader event:', event.type);
+});
+
+// Unsubscribe when done
+unsubscribeAcquired();
+unsubscribeLost();
+unsubscribeAllEvents();
+```
+
+### Generator-based Streams
 
+```typescript
 const bus = createBus({ channel: 'my-channel' });
 
 // Consume messages as async iterable
@@ -185,52 +248,6 @@ const controller = new AbortController();
 })();
 ```
 
-### 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)`
@@ -305,6 +322,11 @@ Creates a new LeaderElector instance for leader election.
 | `leaseMs` | `number` | `5000` | Lease duration in milliseconds |
 | `heartbeatMs` | `number` | `2000` | Heartbeat interval in milliseconds |
 | `jitterMs` | `number` | `500` | Jitter range to avoid synchronization |
+| `buffer` | `BufferConfig` | `{ size: 100, overflow: 'oldest' }` | Buffer configuration for stream generators |
+
+**BufferConfig:**
+- `size`: Maximum queue size (default: 100)
+- `overflow`: Overflow policy - `'oldest'` (drop oldest), `'newest'` (drop newest), or `'error'` (throw error)
 
 #### LeaderElector Methods
 
@@ -325,9 +347,9 @@ Returns `true` if this tab is currently the leader.
 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
+- `'acquire'` - This tab became the leader
+- `'lose'` - This tab lost leadership
+- `'change'` - Leadership changed to another tab
 
 ##### `onAll(handler)`
 
@@ -363,13 +385,13 @@ const leader = createLeaderElector({
 leader.start();
 
 // Handle leader events
-leader.on('acquired', () => {
+leader.on('acquire', () => {
   console.log('This tab is now the leader');
   // Only the leader performs certain tasks
   bus.publish('leader-announcement', { tabId: leader.getTabId() });
 });
 
-leader.on('lost', () => {
+leader.on('lose', () => {
   console.log('This tab is no longer the leader');
 });
 
@@ -391,7 +413,9 @@ leader.stop();
 bus.close();
 ```
 
-### Using with purrcat (WebSocket)
+### Using with [purrcat](https://www.npmjs.com/package/purrcat) (WebSocket)
+
+> **[📖 Full WebSocket Usage Guide →](./docs/WEBSOCKET-USAGE.md)** - Learn how to share WebSocket connections across tabs, implement request-response patterns, and handle edge cases.
 
 ```typescript
 import createSocket from 'purrcat';
@@ -406,7 +430,7 @@ const leader = createLeaderElector({
 leader.start();
 
 // Only the leader maintains WebSocket connection
-leader.on('acquired', () => {
+leader.on('acquire', () => {
   const socket = createSocket({
     url: 'wss://api.example.com/ws',
   });

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -13,10 +13,18 @@ interface TabBusEvent {
     ts: number;
     meta?: Record<string, any>;
 }
+/** Buffer overflow policy */
+type BufferOverflowPolicy = 'oldest' | 'newest' | 'error';
+/** Buffer configuration */
+interface BufferConfig {
+    size?: number;
+    overflow?: BufferOverflowPolicy;
+}
 /** Options for createBus() */
 interface BusOptions {
     channel: string;
     tabId?: string;
+    buffer?: BufferConfig;
 }
 /** Return type of createBus(), provides async iterables and callbacks */
 interface TabBus<T = any> {
@@ -50,6 +58,7 @@ interface LeaderElectorOptions {
     leaseMs?: number;
     heartbeatMs?: number;
     jitterMs?: number;
+    buffer?: BufferConfig;
 }
 /** Return type of createLeaderElector() */
 interface LeaderElector {
@@ -70,40 +79,6 @@ interface LeaderElector {
     /** 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
@@ -119,17 +94,9 @@ declare function createBus<T = any>(options: BusOptions): TabBus<T>;
  */
 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 };
+export { type BusOptions, createBus as CreateBus, createLeaderElector as CreateLeaderElector, type LeaderElector, type LeaderElectorOptions, type LeaderEvent, type LeaderEventType, type TabBus, type TabBusEvent, type TabBusEventType, type TabBusMessage, createBus, createLeaderElector, _default as default };

package/dist/index.d.ts

@@ -13,10 +13,18 @@ interface TabBusEvent {
     ts: number;
     meta?: Record<string, any>;
 }
+/** Buffer overflow policy */
+type BufferOverflowPolicy = 'oldest' | 'newest' | 'error';
+/** Buffer configuration */
+interface BufferConfig {
+    size?: number;
+    overflow?: BufferOverflowPolicy;
+}
 /** Options for createBus() */
 interface BusOptions {
     channel: string;
     tabId?: string;
+    buffer?: BufferConfig;
 }
 /** Return type of createBus(), provides async iterables and callbacks */
 interface TabBus<T = any> {
@@ -50,6 +58,7 @@ interface LeaderElectorOptions {
     leaseMs?: number;
     heartbeatMs?: number;
     jitterMs?: number;
+    buffer?: BufferConfig;
 }
 /** Return type of createLeaderElector() */
 interface LeaderElector {
@@ -70,40 +79,6 @@ interface LeaderElector {
     /** 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
@@ -119,17 +94,9 @@ declare function createBus<T = any>(options: BusOptions): TabBus<T>;
  */
 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 };
+export { type BusOptions, createBus as CreateBus, createLeaderElector as CreateLeaderElector, type LeaderElector, type LeaderElectorOptions, type LeaderEvent, type LeaderEventType, type TabBus, type TabBusEvent, type TabBusEventType, type TabBusMessage, createBus, createLeaderElector, _default as default };

package/dist/index.global.js

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

package/dist/index.js

@@ -1 +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};
+function m(e,r,a){e&&e.forEach(n=>{try{n(r)}catch(s){console.error(a,s)}})}function C(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function x(e,r){return{type:e,ts:Date.now(),meta:r}}function b(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 h(e,r,a,n,s){return new Promise(l=>{if(e?.aborted){l();return}if(r()){l();return}let u=()=>{s(l),e&&e.removeEventListener("abort",c)},c=()=>{u(),l()};e&&e.addEventListener("abort",c),n(()=>{u(),l()})})}function g(e){try{let r=localStorage.getItem(e);return r?JSON.parse(r):null}catch{return null}}function k(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 T(e){return e?Date.now()-e.timestamp<e.leaseMs:!1}function w(e,r,a,n){return r.length<n?{action:"add"}:e==="oldest"?{action:"drop_oldest",dropped:r.shift()}:e==="newest"?{action:"drop_newest",dropped:a}:{action:"error"}}async function*O(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.messages.length>0&&!a?.aborted;)yield r.messages.shift();await h(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*R(e,r,a){e.activeIterators++;try{for(;!a?.aborted;){for(;r.events.length>0&&!a?.aborted;)yield r.events.shift();await h(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 A(e,r,a,n){let s=a.messageCallbacks.get(e.type);if(m(s,e,"Error in TabBus callback:"),m(a.allCallbacks,e,"Error in TabBus all callback:"),a.activeIterators===0)return;let l=w(a.bufferOverflow,n,e,a.bufferSize);if(l.action==="error"){console.error("Message buffer overflow");return}l.action!=="drop_newest"&&(l.action,n.push(e),a.messageResolvers.forEach(u=>u()),a.messageResolvers.clear())}function z(e,r,a,n){try{let s=e.data;A(s,r,a,n)}catch(s){console.error("Error handling TabBus message:",s)}}function S(e){let{channel:r,tabId:a,buffer:n}=e,s=a||C(),l=n?.size??100,u=n?.overflow??"oldest";if(typeof BroadcastChannel>"u")throw new Error("BroadcastChannel is not supported in this environment");let c=new BroadcastChannel(r),i={channel:c,tabId:s,messageCallbacks:new Map,allCallbacks:new Set,messageResolvers:new Set,activeIterators:0,bufferSize:l,bufferOverflow:u},t=[];return c.onmessage=o=>{z(o,s,i,t)},c.onmessageerror=()=>{let o=x("err",{error:"Failed to receive message"})},{publish(o,f){let p={type:o,payload:f,tabId:s,ts:Date.now()};c.postMessage(p),queueMicrotask(()=>{A(p,s,i,t)})},subscribe(o,f){return i.messageCallbacks.has(o)||i.messageCallbacks.set(o,new Set),i.messageCallbacks.get(o).add(f),()=>{let p=i.messageCallbacks.get(o);p&&(p.delete(f),p.size===0&&i.messageCallbacks.delete(o))}},subscribeAll(o){return i.allCallbacks.add(o),()=>{i.allCallbacks.delete(o)}},stream(o){return O(i,{messages:t},o?.signal)},getTabId(){return s},close(){c.close(),i.channel=null,i.messageCallbacks.clear(),i.allCallbacks.clear(),i.messageResolvers.clear()}}}function v(e,r,a){let n=r.eventCallbacks.get(e.type);if(m(n,e,"Error in LeaderElector callback:"),m(r.allCallbacks,e,"Error in LeaderElector all callback:"),r.activeIterators===0)return;let s=w(r.bufferOverflow,a,e,r.bufferSize);if(s.action==="error"){console.error("Event buffer overflow");return}s.action!=="drop_newest"&&(s.action,a.push(e),r.eventResolvers.forEach(l=>l()),r.eventResolvers.clear())}function _(e,r){if(e.stopped)return!1;let a=g(e.key);if(!T(a)){let n={tabId:e.tabId,timestamp:Date.now(),leaseMs:e.leaseMs};if(k(e.key,n),g(e.key)?.tabId===e.tabId)return e.isLeader||(e.isLeader=!0,v(b("acquire",{tabId:e.tabId}),e,r)),!0}return a?.tabId===e.tabId&&T(a)?(e.isLeader||(e.isLeader=!0,v(b("acquire",{tabId:e.tabId}),e,r)),!0):(e.isLeader&&(e.isLeader=!1,v(b("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)),!1)}function D(e,r){if(e.stopped||!e.isLeader)return;let a=g(e.key);if(a?.tabId===e.tabId){let n={...a,timestamp:Date.now()};k(e.key,n)}else e.isLeader&&(e.isLeader=!1,v(b("lose",{tabId:e.tabId}),e,r))}function j(e,r){if(e.stopped)return;let a=g(e.key),n=e.isLeader,s=a?.tabId===e.tabId&&T(a);!n&&s?(e.isLeader=!0,v(b("acquire",{tabId:e.tabId}),e,r)):n&&!s?(e.isLeader=!1,v(b("lose",{tabId:e.tabId,newLeader:a?.tabId}),e,r)):n&&s&&a?.tabId!==e.tabId&&v(b("change",{tabId:e.tabId,newLeader:a.tabId}),e,r)}function M(e){let{key:r,tabId:a,leaseMs:n=5e3,heartbeatMs:s=2e3,jitterMs:l=500,buffer:u}=e,c=u?.size??100,i=u?.overflow??"oldest";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:l,isLeader:!1,heartbeatTimer:null,checkTimer:null,eventCallbacks:new Map,allCallbacks:new Set,eventResolvers:new Set,activeIterators:0,stopped:!1,bufferSize:c,bufferOverflow:i},L=[];typeof window<"u"&&(window.addEventListener("storage",o),window.addEventListener("pagehide",f),window.addEventListener("beforeunload",f));function o(d){d.key!==t.key||d.storageArea!==localStorage||j(t,L)}function f(){t.isLeader&&g(t.key)?.tabId===t.tabId&&B(t.key)}return{start(){if(t.stopped&&(t.stopped=!1),_(t,L),t.isLeader){let I=y(t.heartbeatMs,t.jitterMs);t.heartbeatTimer=setInterval(()=>{D(t,L)},I)}let d=y(t.heartbeatMs/2,t.jitterMs);t.checkTimer=setInterval(()=>{j(t,L)},d)},stop(){t.stopped=!0,t.heartbeatTimer&&(clearInterval(t.heartbeatTimer),t.heartbeatTimer=null),t.checkTimer&&(clearInterval(t.checkTimer),t.checkTimer=null),t.isLeader&&(g(t.key)?.tabId===t.tabId&&B(t.key),t.isLeader=!1,v(b("lose",{tabId:t.tabId,reason:"stopped"}),t,L)),typeof window<"u"&&(window.removeEventListener("storage",o),window.removeEventListener("pagehide",f),window.removeEventListener("beforeunload",f))},isLeader(){return t.isLeader},on(d,I){return t.eventCallbacks.has(d)||t.eventCallbacks.set(d,new Set),t.eventCallbacks.get(d).add(I),()=>{let E=t.eventCallbacks.get(d);E&&(E.delete(I),E.size===0&&t.eventCallbacks.delete(d))}},onAll(d){return t.allCallbacks.add(d),()=>{t.allCallbacks.delete(d)}},stream(d){return R(t,{events:L},d?.signal)},getTabId(){return t.tabId}}}var Q={createBus:S,createLeaderElector:M};export{S as createBus,M as createLeaderElector,Q as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "purrtabby",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Lightweight browser tab communication and leader election library using BroadcastChannel and localStorage",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -30,7 +30,6 @@
     "inter-tab",
     "cross-tab",
     "pub-sub",
-    "rpc",
     "typescript",
     "async-iterable",
     "generator"