@stacksjs/realtime 0.75.120 → 0.75.122

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export type { BroadcastStreamOptions } from './stream';
 export type { EmitOptions } from './emit';
 export type { BroadcastInstance } from './broadcast';
 export type { BufferedMessage, ReplayBufferConfig } from './replay-buffer';
@@ -13,7 +14,8 @@ export * from 'ts-broadcasting';
 // Note: all exports are already provided by `export * from 'ts-broadcasting'` above.
 // Aliases are provided below for convenience.
 // Server instance management
-export { getServer, setServer, createServer, stopServer } from './server-instance';
+export { getServer, setServer, createServer, createBroadcastHub, stopServer } from './server-instance';
+export { createBroadcastResponse } from './stream';
 // Stacks-specific exports
 export { emit, emitToUser, emitToUsers } from './emit';
 export { channel, channel as createChannel, Channel as StacksChannel } from './channel';

package/dist/index.js

@@ -1 +1 @@
-export*from"ts-broadcasting";export{getServer,setServer,createServer,stopServer}from"./server-instance";export{emit,emitToUser,emitToUsers}from"./emit";export{channel,channel as createChannel,Channel as StacksChannel}from"./channel";export{broadcast as dispatchBroadcast,runBroadcast,Broadcast as LegacyBroadcast}from"./broadcast";export{debugSnapshot,getReplayBuffer,pruneExpired,recordBroadcast,replaySince,setReplayBuffer}from"./replay-buffer";export{storeWebSocketEvent}from"./ws";export{setWsAuthenticator,getWsAuthenticator}from"./ws";
+export*from"ts-broadcasting";export{getServer,setServer,createServer,createBroadcastHub,stopServer}from"./server-instance";export{createBroadcastResponse}from"./stream";export{emit,emitToUser,emitToUsers}from"./emit";export{channel,channel as createChannel,Channel as StacksChannel}from"./channel";export{broadcast as dispatchBroadcast,runBroadcast,Broadcast as LegacyBroadcast}from"./broadcast";export{debugSnapshot,getReplayBuffer,pruneExpired,recordBroadcast,replaySince,setReplayBuffer}from"./replay-buffer";export{storeWebSocketEvent}from"./ws";export{setWsAuthenticator,getWsAuthenticator}from"./ws";

package/dist/server-instance.d.ts

@@ -21,6 +21,8 @@ export declare function setServer(server: BroadcastServer | null): void;
  * Get the global broadcast server instance
  */
 export declare function getServer(): BroadcastServer | null;
+/** Initialize the native broadcast engine for HTTP stream consumers, without binding a socket port. */
+export declare function createBroadcastHub(config?: ServerConfig): BroadcastServer;
 /**
  * Create and start a new broadcast server.
  *

package/dist/server-instance.js

@@ -1 +1 @@
-import{Broadcast}from"ts-broadcasting";import{recordBroadcast}from"./replay-buffer";import{getWsAuthenticator}from"./ws";let serverInstance=null,removeReplayHook=null;export function setServer(server){removeReplayHook?.();removeReplayHook=null;serverInstance=server;Broadcast.setServer(server);if(server)removeReplayHook=server.addBroadcastHook(({channel,event,data})=>{const seq=recordBroadcast(channel,event,data);return seq===null?void 0:{seq}})}export function getServer(){return serverInstance}function stacksConnectionAuthorizer(config){return async(req,user)=>{let accepted={};const authenticate=getWsAuthenticator();if(authenticate){const result=await authenticate(req);if(!result.ok)return{ok:!1,status:result.status,message:result.message};accepted={user:result.user,data:result.data}}const resolvedUser=accepted.user!==void 0?accepted.user:user;if(config.authorizeConnection){const result=await config.authorizeConnection(req,resolvedUser);if(result===!0)return{ok:!0,user:resolvedUser,data:accepted.data};return result}return{ok:!0,user:resolvedUser,data:accepted.data}}}export async function createServer(config){const server=new(await import("ts-broadcasting")).BroadcastServer({...config,authorizeConnection:stacksConnectionAuthorizer(config)});await server.start();setServer(server);return server}export async function stopServer(){if(serverInstance){await serverInstance.stop();setServer(null)}}
+import{Broadcast,BroadcastServer as Server}from"ts-broadcasting";import{recordBroadcast}from"./replay-buffer";import{getWsAuthenticator}from"./ws";let serverInstance=null,removeReplayHook=null;export function setServer(server){removeReplayHook?.();removeReplayHook=null;serverInstance=server;Broadcast.setServer(server);if(server)removeReplayHook=server.addBroadcastHook(({channel,event,data})=>{const seq=recordBroadcast(channel,event,data);return seq===null?void 0:{seq}})}export function getServer(){return serverInstance}export function createBroadcastHub(config={}){if(serverInstance)return serverInstance;const server=new Server(config);setServer(server);return server}function stacksConnectionAuthorizer(config){return async(req,user)=>{let accepted={};const authenticate=getWsAuthenticator();if(authenticate){const result=await authenticate(req);if(!result.ok)return{ok:!1,status:result.status,message:result.message};accepted={user:result.user,data:result.data}}const resolvedUser=accepted.user!==void 0?accepted.user:user;if(config.authorizeConnection){const result=await config.authorizeConnection(req,resolvedUser);if(result===!0)return{ok:!0,user:resolvedUser,data:accepted.data};return result}return{ok:!0,user:resolvedUser,data:accepted.data}}}export async function createServer(config){const server=new(await import("ts-broadcasting")).BroadcastServer({...config,authorizeConnection:stacksConnectionAuthorizer(config)});await server.start();setServer(server);return server}export async function stopServer(){if(serverInstance){await serverInstance.stop();setServer(null)}}

package/dist/stream.d.ts

@@ -0,0 +1,9 @@
+/** Authenticated SSE transport for the same engine used by emit(), channels and model broadcasts. */
+export declare function createBroadcastResponse(options: BroadcastStreamOptions): Promise<Response>;
+export declare interface BroadcastStreamOptions {
+  channels: readonly string[]
+  authorize: () => boolean | Promise<boolean>
+  signal?: AbortSignal
+  heartbeatMs?: number
+  maxPending?: number
+}

package/dist/stream.js

@@ -0,0 +1,7 @@
+import{getServer}from"./server-instance";export async function createBroadcastResponse(options){if(!options.channels.length||typeof options.authorize!=="function")throw Error("Broadcast streams require channels and authorization");if(!await options.authorize())return new Response("Unauthorized",{status:401});const server=getServer();if(!server)throw Error("Broadcast server not initialized");const channels=new Set(options.channels),encoder=new TextEncoder,maxPending=options.maxPending??64;if(!Number.isSafeInteger(maxPending)||maxPending<1||maxPending>1024||options.heartbeatMs!==void 0&&(!Number.isFinite(options.heartbeatMs)||options.heartbeatMs<1))throw Error("Invalid broadcast stream configuration");let cleanup=()=>{};const stream=new ReadableStream({start(controller){let closed=!1,pending=0,chain=Promise.resolve(),timer,remove=()=>{};function close(){if(closed)return;closed=!0;remove();clearInterval(timer);options.signal?.removeEventListener("abort",close);try{controller.close()}catch{}}function enqueue(frame){if(closed)return;if((controller.desiredSize??0)<=0){close();return}controller.enqueue(encoder.encode(frame))}function deliver(frame){if(closed)return;if(++pending>maxPending){close();return}chain=chain.then(async()=>{if(closed)return;if(!await options.authorize()){close();return}enqueue(frame)}).catch(close).finally(()=>{pending--})}cleanup=close;remove=server.addBroadcastHook(({channel,event,data})=>{if(channels.has(channel))deliver(`data: ${JSON.stringify({channel,event,data})}
+
+`)});enqueue(`: connected
+
+`);timer=setInterval(()=>deliver(`: heartbeat
+
+`),options.heartbeatMs??15000);options.signal?.addEventListener("abort",close,{once:!0});if(options.signal?.aborted)close()},cancel(){cleanup()}},{highWaterMark:maxPending});return new Response(stream,{headers:{"Content-Type":"text/event-stream","Cache-Control":"no-store","X-Accel-Buffering":"no"}})}

package/package.json

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