@stacksjs/realtime 0.75.452 → 0.75.458

package/dist/channel.d.ts

@@ -1,4 +1,5 @@
 import type { ChannelType } from 'ts-broadcasting';
+export declare function stripPrefix(name: string): string;
 /**
  * Create a new channel instance
  *

package/dist/channel.js

@@ -1 +1 @@
-import{getServer}from"./server-instance";const KNOWN_CHANNEL_PREFIXES=["private-","presence-"];function stripPrefix(name){for(const p of KNOWN_CHANNEL_PREFIXES)if(name.startsWith(p))return name.slice(p.length);return name}export class Channel{channelName;constructor(channel){this.channelName=channel}async private(event,data){const server=getServer();if(!server)throw Error("Broadcast server not initialized");await server.broadcast(`private-${stripPrefix(this.channelName)}`,event,data)}async public(event,data){const server=getServer();if(!server)throw Error("Broadcast server not initialized");await server.broadcast(stripPrefix(this.channelName),event,data)}async presence(event,data){const server=getServer();if(!server)throw Error("Broadcast server not initialized");await server.broadcast(`presence-${stripPrefix(this.channelName)}`,event,data)}async broadcast(event,data,type="public"){switch(type){case"private":return this.private(event,data);case"presence":return this.presence(event,data);default:return this.public(event,data)}}}export function channel(name){return new Channel(name)}
+import{getServer}from"./server-instance";const KNOWN_CHANNEL_PREFIXES=["private-","presence-"];export function stripPrefix(name){for(const p of KNOWN_CHANNEL_PREFIXES)if(name.startsWith(p))return name.slice(p.length);return name}export class Channel{channelName;constructor(channel){this.channelName=channel}async private(event,data){const server=getServer();if(!server)throw Error("Broadcast server not initialized");await server.broadcast(`private-${stripPrefix(this.channelName)}`,event,data)}async public(event,data){const server=getServer();if(!server)throw Error("Broadcast server not initialized");await server.broadcast(stripPrefix(this.channelName),event,data)}async presence(event,data){const server=getServer();if(!server)throw Error("Broadcast server not initialized");await server.broadcast(`presence-${stripPrefix(this.channelName)}`,event,data)}async broadcast(event,data,type="public"){switch(type){case"private":return this.private(event,data);case"presence":return this.presence(event,data);default:return this.public(event,data)}}}export function channel(name){return new Channel(name)}

package/dist/emit.js

@@ -1 +1 @@
-import{getServer}from"./server-instance";export function emit(channel,event,data,options){const server=getServer();if(!server){console.warn("[realtime] Server not initialized, cannot emit event");return}let channelName=channel;if(options?.presence){if(!channel.startsWith("presence-"))channelName=`presence-${channel}`}else if(options?.private){if(!channel.startsWith("private-"))channelName=`private-${channel}`}server.broadcast(channelName,event,data,options?.exclude)}export function emitToUser(userId,event,data,options){emit(`private-user.${userId}`,event,data,{...options,private:!0})}export function emitToUsers(userIds,event,data,options){for(const userId of userIds)emitToUser(userId,event,data,options)}
+import{stripPrefix}from"./channel";import{getServer}from"./server-instance";export function emit(channel,event,data,options){const server=getServer();if(!server){console.warn("[realtime] Server not initialized, cannot emit event");return}let channelName=channel;if(options?.presence)channelName=`presence-${stripPrefix(channel)}`;else if(options?.private)channelName=`private-${stripPrefix(channel)}`;server.broadcast(channelName,event,data,options?.exclude)}export function emitToUser(userId,event,data,options){emit(`private-user.${userId}`,event,data,{...options,private:!0})}export function emitToUsers(userIds,event,data,options){for(const userId of userIds)emitToUser(userId,event,data,options)}

package/dist/replay-buffer.d.ts

@@ -1,3 +1,4 @@
+declare function firstSeq(): number;
 /**
  * Install (or replace) the replay-buffer config. Pass `null` to disable
  * and drop all buffered state. Safe to call multiple times.
@@ -61,6 +62,15 @@ export declare function debugSnapshot(): Record<string, { count: number, firstSe
  * behind Redis each numbers its own copy, so route replay through a
  * shared store (Redis Streams, Postgres LISTEN/NOTIFY, etc.) there.
  *
+ * A channel's numbers rise by one per message and keep rising across a
+ * restart: each channel starts from the clock (milliseconds times 1000),
+ * never below a number this process already issued. They used to start
+ * at 1, so after a restart every new message was "older" than the seq a
+ * reconnecting client held: `replaySince` skipped them, and a client
+ * ignoring repeats dropped them live. When the first replayed seq is not
+ * the client's seq plus one, messages were lost: evicted, expired, or
+ * sent before a restart.
+ *
  * Memory shape: `Map<channel, RingBuffer<BufferedMessage>>`. Bounded by
  * `maxPerChannel` (default 100) so a chatty channel can't OOM the
  * server. Entries past `ttlMs` are evicted lazily on read — apps that

package/dist/replay-buffer.js

@@ -1 +1 @@
-let registry=null;export function setReplayBuffer(cfg){if(!cfg){registry=null;return}registry={channels:cfg.channels??[],maxPerChannel:cfg.maxPerChannel??100,ttlMs:cfg.ttlMs??300000,state:new Map}}export function getReplayBuffer(){return registry}function matches(pattern,channel){if(pattern==="*"||pattern===channel)return!0;return pattern.endsWith(".*")&&channel.startsWith(pattern.slice(0,-1))}function shouldBuffer(channel){if(!registry||registry.channels.length===0)return!1;const bare=channel.replace(/^(?:private|presence)-/,"");return registry.channels.some((pattern)=>matches(pattern,channel)||matches(pattern,bare))}export function recordBroadcast(channel,event,data){if(!registry||!shouldBuffer(channel))return null;let state=registry.state.get(channel);if(!state){state={messages:[],nextSeq:1};registry.state.set(channel,state)}const msg={seq:state.nextSeq++,ts:Date.now(),event,data};state.messages.push(msg);if(state.messages.length>registry.maxPerChannel)state.messages.splice(0,state.messages.length-registry.maxPerChannel);return msg.seq}export function replaySince(channel,sinceSeq){if(!registry)return[];const state=registry.state.get(channel);if(!state)return[];const now=Date.now(),ttl=registry.ttlMs;while(state.messages.length>0&&now-state.messages[0].ts>ttl)state.messages.shift();if(state.messages.length===0)return[];return state.messages.filter((m)=>m.seq>sinceSeq)}export function pruneExpired(){if(!registry)return;const now=Date.now(),ttl=registry.ttlMs;for(const state of registry.state.values())while(state.messages.length>0&&now-state.messages[0].ts>ttl)state.messages.shift()}export function debugSnapshot(){const out={};if(!registry)return out;for(const[ch,state]of registry.state)out[ch]={count:state.messages.length,firstSeq:state.messages[0]?.seq??null,lastSeq:state.messages[state.messages.length-1]?.seq??null};return out}
+let registry=null,lastIssued=0;function firstSeq(){return Math.max(Date.now()*1000,lastIssued+1)}export function setReplayBuffer(cfg){if(!cfg){registry=null;return}registry={channels:cfg.channels??[],maxPerChannel:cfg.maxPerChannel??100,ttlMs:cfg.ttlMs??300000,state:new Map}}export function getReplayBuffer(){return registry}function matches(pattern,channel){if(pattern==="*"||pattern===channel)return!0;return pattern.endsWith(".*")&&channel.startsWith(pattern.slice(0,-1))}function shouldBuffer(channel){if(!registry||registry.channels.length===0)return!1;const bare=channel.replace(/^(?:private|presence)-/,"");return registry.channels.some((pattern)=>matches(pattern,channel)||matches(pattern,bare))}export function recordBroadcast(channel,event,data){if(!registry||!shouldBuffer(channel))return null;let state=registry.state.get(channel);if(!state){state={messages:[],nextSeq:firstSeq()};registry.state.set(channel,state)}const msg={seq:state.nextSeq++,ts:Date.now(),event,data};lastIssued=Math.max(lastIssued,msg.seq);state.messages.push(msg);if(state.messages.length>registry.maxPerChannel)state.messages.splice(0,state.messages.length-registry.maxPerChannel);return msg.seq}export function replaySince(channel,sinceSeq){if(!registry)return[];const state=registry.state.get(channel);if(!state)return[];const now=Date.now(),ttl=registry.ttlMs;while(state.messages.length>0&&now-state.messages[0].ts>ttl)state.messages.shift();if(state.messages.length===0)return[];return state.messages.filter((m)=>m.seq>sinceSeq)}export function pruneExpired(){if(!registry)return;const now=Date.now(),ttl=registry.ttlMs;for(const state of registry.state.values())while(state.messages.length>0&&now-state.messages[0].ts>ttl)state.messages.shift()}export function debugSnapshot(){const out={};if(!registry)return out;for(const[ch,state]of registry.state)out[ch]={count:state.messages.length,firstSeq:state.messages[0]?.seq??null,lastSeq:state.messages[state.messages.length-1]?.seq??null};return out}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/realtime",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.452",
+  "version": "0.75.458",
   "description": "The Stacks realtime integration. Built on top of ts-broadcasting.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,9 +58,9 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/logging": "0.75.452",
-    "@stacksjs/path": "0.75.452",
-    "ts-broadcasting": "^0.0.11"
+    "@stacksjs/logging": "0.75.458",
+    "@stacksjs/path": "0.75.458",
+    "ts-broadcasting": "^0.0.12"
   },
   "devDependencies": {
     "better-dx": "^0.2.24"