@mauroandre/velojs 0.0.20 → 0.0.21

package/README.md

@@ -581,11 +581,12 @@ One line to declare, three verbs to use. Route at `/_event/admin/Provision/logs`
 export const stream_progress = createEventStream<DeployState>();
 ```
 
-**Standalone** — for cross-cutting streams (global metrics, notifications). Pass `path` and (if needed) `middlewares` explicitly.
+**Standalone** — for cross-cutting streams (global metrics, notifications). Pass `path` and (if needed) `middlewares` explicitly. Use `broadcast: true` for streams without channels.
 
 ```typescript
 export const containerMetrics = createEventStream<Metric[]>({
     path: "/api/metrics/containers",
+    broadcast: true,
     middlewares: [authMiddleware],
 });
 ```
@@ -604,6 +605,7 @@ stream_logs.emit(sessionId, "Line", { snapshot: true });
 import { poll } from "@mauroandre/velojs";
 
 export const stream_metrics = createEventStream<Metric[]>({
+    broadcast: true,
     source: poll({
         intervalMs: 3000,
         tick: async (emit) => emit(await collectMetrics()),
@@ -626,7 +628,8 @@ export const stream_deploy = createEventStream<DeployState>({
 | Option | Type | Description |
 |--------|------|-------------|
 | `path` | `string` | (Standalone) Explicit URL path |
-| `channel` | `(c) => string` | Extract channel ID. Default: `?channel=...` query param |
+| `broadcast` | `boolean` | If true, every emit goes to all subscribers (no channels). Default: false |
+| `channel` | `(c) => string` | Extract channel ID. Default: `?channel=...` query param. Ignored when `broadcast: true` |
 | `snapshot` | `(channel) => TSnapshot` | Returns current state on connect (state-machine pattern) |
 | `closeOn` | `(event) => boolean` | Closes SSE when matching event is sent (declarative) |
 | `source` | `(emit, { abortSignal }) => Promise<void>` | Self-running producer, only runs while subscribed |

package/dist/events.d.ts

@@ -78,8 +78,19 @@ export interface EventStreamConfig<TEvent, TSnapshot = TEvent> {
      * Subscribers only receive events emitted to their channel.
      * When omitted, defaults to `c.req.query("channel") ?? ""` so client-side
      * `useEventStream(stream, { channel })` works out of the box.
+     *
+     * Ignored when `broadcast: true` is set.
      */
     channel?: (c: Context) => string;
+    /**
+     * If true, this stream has no channels — every emit goes to all subscribers.
+     * - `emit(value, options?)` (no channel arg)
+     * - `useEventStream(stream)` (no channel option)
+     * - Server uses a single broadcast bucket regardless of `?channel=` query.
+     *
+     * Default: false (channel-aware — `emit(channel, value, options?)`).
+     */
+    broadcast?: boolean;
     /**
      * Returns the current state of a channel for snapshot-on-connect.
      * Sent before any new events to bring the client up to date.
@@ -126,9 +137,12 @@ export interface EventStreamConfig<TEvent, TSnapshot = TEvent> {
     retainMs?: number;
 }
 export interface EventStream<TEvent, TSnapshot = TEvent> {
-    /** Broadcast emit (no channel) */
+    /**
+     * Emit an event.
+     * - For channel-aware streams (default): `emit(channel, value, options?)`
+     * - For broadcast streams (`config.broadcast: true`): `emit(value, options?)`
+     */
     emit(event: TEvent, options?: EmitOptions): void;
-    /** Channel-targeted emit */
     emit(channel: string, event: TEvent, options?: EmitOptions): void;
     /**
      * Closes the stream (or a specific channel).

package/dist/events.js

@@ -1,85 +1,88 @@
-const p = [];
+const T = [];
 function m(t) {
-  for (const r of p) r(t);
-  p.length = 0;
+  for (const r of T) r(t);
+  T.length = 0;
 }
-function C(t = {}) {
-  const r = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set(), _ = /* @__PURE__ */ new Map();
-  let u = null, S = 0;
-  const b = () => {
-    t.source && (u || (u = new AbortController(), Promise.resolve(
-      t.source(A, { abortSignal: u.signal })
+function N(t = {}) {
+  t.broadcast && t.channel && console.warn(
+    "[velojs] createEventStream: `broadcast: true` ignores `channel`. Remove one of them — broadcast streams have no channels."
+  );
+  const r = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set(), u = /* @__PURE__ */ new Map();
+  let f = null, A = 0;
+  const d = () => {
+    t.source && (f || (f = new AbortController(), Promise.resolve(
+      t.source(E, { abortSignal: f.signal })
     ).catch((e) => {
       console.error("[velojs] event stream source threw:", e);
     })));
-  }, h = () => {
-    S > 0 || u && (u.abort(), u = null);
+  }, w = () => {
+    A > 0 || f && (f.abort(), f = null);
   };
-  function A(e, i, s) {
-    let o, l, d;
-    if (!!t.channel ? (o = e, l = i, d = s) : (o = "", l = e, d = i), a.has(o)) {
+  function E(e, c, n) {
+    let s, l, h;
+    if (!!t.broadcast ? (s = "", l = e, h = c) : (s = e, l = c, h = n), a.has(s)) {
       console.warn(
-        `[velojs] emit() called on closed channel "${o}" — ignored. Reopen the channel by emitting to a fresh ID, or remove the close() call.`
+        `[velojs] emit() called on closed channel "${s}" — ignored. Reopen the channel by emitting to a fresh ID, or remove the close() call.`
       );
       return;
     }
-    if (d?.snapshot) {
-      const T = n.get(o) ?? [];
-      T.push(l), n.set(o, T);
+    if (h?.snapshot) {
+      const b = o.get(s) ?? [];
+      b.push(l), o.set(s, b);
     }
-    const f = r.get(o);
-    if (f)
-      for (const T of f) T(l);
+    const v = r.get(s);
+    if (v)
+      for (const b of v) b(l);
   }
-  function E(e = "") {
+  function i(e = "") {
     if (a.has(e)) return;
     a.add(e);
-    const i = r.get(e);
-    if (i)
-      for (const l of i) l.close();
-    const s = t.retainMs ?? 3e5, o = _.get(e);
-    o && clearTimeout(o), _.set(
+    const c = r.get(e);
+    if (c)
+      for (const l of c) l.close();
+    const n = t.retainMs ?? 3e5, s = u.get(e);
+    s && clearTimeout(s), u.set(
       e,
       setTimeout(() => {
-        n.delete(e), _.delete(e), a.delete(e);
-      }, s)
+        o.delete(e), u.delete(e), a.delete(e);
+      }, n)
     );
   }
-  const c = {
-    emit: A,
-    close: E,
+  const S = {
+    emit: E,
+    close: i,
     __isVeloEventStream: !0,
     __config: t,
     __listeners: r,
-    __buffers: n,
+    __buffers: o,
     __path: t.path,
-    __onConnect(e, i) {
-      let s = r.get(e);
-      s || (s = /* @__PURE__ */ new Set(), r.set(e, s)), s.add(i), S++, b();
+    __onConnect(e, c) {
+      let n = r.get(e);
+      n || (n = /* @__PURE__ */ new Set(), r.set(e, n)), n.add(c), A++, d();
     },
-    __onDisconnect(e, i) {
-      const s = r.get(e);
-      s && (s.delete(i), s.size === 0 && r.delete(e), S--, h());
+    __onDisconnect(e, c) {
+      const n = r.get(e);
+      n && (n.delete(c), n.size === 0 && r.delete(e), A--, w());
     }
   };
-  return t.path && p.push((e) => {
-    v(e, t.path, c, t.middlewares ?? []);
-  }), c;
+  return t.path && T.push((e) => {
+    g(e, t.path, S, t.middlewares ?? []);
+  }), S;
 }
-function N(t) {
-  return async (r, { abortSignal: n }) => {
-    for (; !n.aborted; ) {
+function C(t) {
+  return async (r, { abortSignal: o }) => {
+    for (; !o.aborted; ) {
       try {
         await t.tick(r);
       } catch (a) {
         console.error("[velojs] poll tick threw:", a);
       }
       await new Promise((a) => {
-        const _ = setTimeout(a, t.intervalMs);
-        n.addEventListener(
+        const u = setTimeout(a, t.intervalMs);
+        o.addEventListener(
           "abort",
           () => {
-            clearTimeout(_), a();
+            clearTimeout(u), a();
           },
           { once: !0 }
         );
@@ -87,51 +90,51 @@ function N(t) {
     }
   };
 }
-function g(t) {
+function p(t) {
   return t.req.query("channel") ?? "";
 }
-function v(t, r, n, a = []) {
-  const _ = async (u) => {
-    const { streamSSE: S } = await import("hono/streaming"), h = (n.__config.channel ?? g)(u), A = n.__config.heartbeatMs, E = A === !1 ? 0 : A ?? 2e4;
-    return S(u, async (c) => {
-      const e = n.__buffers.get(h);
-      if (e && e.length > 0 && await c.writeSSE({
+function g(t, r, o, a = []) {
+  const u = async (f) => {
+    const { streamSSE: A } = await import("hono/streaming"), d = o.__config.broadcast ? "" : (o.__config.channel ?? p)(f), w = o.__config.heartbeatMs, E = w === !1 ? 0 : w ?? 2e4;
+    return A(f, async (i) => {
+      const S = o.__buffers.get(d);
+      if (S && S.length > 0 && await i.writeSSE({
         event: "snapshot",
-        data: JSON.stringify(e)
-      }), n.__config.snapshot) {
-        const f = await n.__config.snapshot(
-          h === "" ? void 0 : h
+        data: JSON.stringify(S)
+      }), o.__config.snapshot) {
+        const _ = await o.__config.snapshot(
+          d === "" ? void 0 : d
         );
-        f !== void 0 && await c.writeSSE({
+        _ !== void 0 && await i.writeSSE({
           event: "snapshot",
-          data: JSON.stringify(f)
+          data: JSON.stringify(_)
         });
       }
-      let i;
-      const s = new Promise((f) => {
-        i = f;
+      let e;
+      const c = new Promise((_) => {
+        e = _;
       });
-      let o = !1, l = null;
-      const d = () => {
-        o || (o = !0, l && clearInterval(l), n.__onDisconnect(h, w), i());
-      }, w = ((f) => {
-        o || (c.writeSSE({ data: JSON.stringify(f) }).catch(() => {
-        }), n.__config.closeOn?.(f) && (c.close(), d()));
+      let n = !1, s = null;
+      const l = () => {
+        n || (n = !0, s && clearInterval(s), o.__onDisconnect(d, h), e());
+      }, h = ((_) => {
+        n || (i.writeSSE({ data: JSON.stringify(_) }).catch(() => {
+        }), o.__config.closeOn?.(_) && (i.close(), l()));
       });
-      w.close = () => {
-        o || (c.writeSSE({ event: "close", data: "" }).catch(() => {
-        }), c.close(), d());
-      }, n.__onConnect(h, w), l = E > 0 ? setInterval(() => {
-        o || c.writeSSE({ event: "heartbeat", data: "" }).catch(() => {
+      h.close = () => {
+        n || (i.writeSSE({ event: "close", data: "" }).catch(() => {
+        }), i.close(), l());
+      }, o.__onConnect(d, h), s = E > 0 ? setInterval(() => {
+        n || i.writeSSE({ event: "heartbeat", data: "" }).catch(() => {
         });
-      }, E) : null, c.onAbort(d), await s;
+      }, E) : null, i.onAbort(l), await c;
     });
   };
-  a.length > 0 ? t.on(["GET"], [r], ...a, _) : t.on(["GET"], [r], _);
+  a.length > 0 ? t.on(["GET"], [r], ...a, u) : t.on(["GET"], [r], u);
 }
 export {
-  C as createEventStream,
+  N as createEventStream,
   m as flushPendingStreamRoutes,
-  N as poll,
-  v as registerStreamHandler
+  C as poll,
+  g as registerStreamHandler
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mauroandre/velojs",
-    "version": "0.0.20",
+    "version": "0.0.21",
     "type": "module",
     "description": "Fullstack web framework built on Hono + Preact with Vite-powered AST transforms",
     "keywords": [