@mauroandre/velojs 0.0.57 → 0.0.59

package/dist/cli.js

@@ -1,43 +1,43 @@
-import { spawnSync as a } from "node:child_process";
+import { spawnSync as c } from "node:child_process";
 import { join as n, resolve as u } from "node:path";
 import p from "node:fs";
-const t = process.argv.slice(2), c = t[0], v = (s, e = []) => {
-  const o = a(s, e, {
+const s = process.argv.slice(2), a = s[0], v = (t, e = []) => {
+  const r = c(t, e, {
     stdio: "inherit",
     cwd: process.cwd()
   });
-  process.exit(o.status ?? 0);
-}, m = () => {
-  v("npx", ["vite", ...t.slice(1)]);
-}, f = (s) => {
-  const e = Date.now().toString(36), o = {
+  process.exit(r.status ?? 0);
+}, g = () => {
+  v("npx", ["vite", ...s.slice(1)]);
+}, j = (t) => {
+  const e = Date.now().toString(36), r = {
     ...process.env,
     VELO_BUILD_HASH: e,
-    ...s ? { VELO_STATIC: "1" } : {}
+    ...t ? { VELO_STATIC: "1" } : {}
   };
   console.log("Building client...");
-  const r = a("npx", ["vite", "build"], {
+  const o = c("npx", ["vite", "build"], {
     stdio: "inherit",
     cwd: process.cwd(),
-    env: o
+    env: r
   });
-  r.status !== 0 && (console.error("Client build failed. Aborting."), process.exit(r.status ?? 1)), console.log("Building server...");
-  const i = a("npx", ["vite", "build", "--mode", "server"], {
+  o.status !== 0 && (console.error("Client build failed. Aborting."), process.exit(o.status ?? 1)), console.log("Building server...");
+  const i = c("npx", ["vite", "build", "--mode", "server"], {
     stdio: "inherit",
     cwd: process.cwd(),
-    env: o
+    env: r
   });
-  i.status !== 0 && (console.error("Server build failed. Aborting."), process.exit(i.status ?? 1)), console.log("Build complete!"), s && j();
-}, j = async () => {
+  i.status !== 0 && (console.error("Server build failed. Aborting."), process.exit(i.status ?? 1)), console.log("Build complete!"), t && f();
+}, f = async () => {
   process.env.NODE_ENV = "production", process.env.VELO_STATIC = "1";
-  const e = await import(u(process.cwd(), "dist/server.js")), o = e.default, r = e.routes;
-  (!o || !r) && (console.error("Failed to load app or routes from dist/server.js"), process.exit(1));
+  const e = await import(u(process.cwd(), "dist/server.js")), r = e.default, o = e.routes;
+  (!r || !o) && (console.error("Failed to load app or routes from dist/server.js"), process.exit(1));
   const { generateStatic: i } = await import("./static.js");
-  await i(o, r);
+  await i(r, o);
 }, b = () => {
   process.env.NODE_ENV = "production";
-  const s = u(process.cwd(), "dist/server.js");
-  v("node", [s]);
+  const t = u(process.cwd(), "dist/server.js");
+  v("node", [t]);
 }, d = () => {
   console.log(`
 VeloJS CLI
@@ -53,6 +53,8 @@ Commands:
   start            Start production server
   graph [app-dir]   Generate .velojs/graph.json (route tree + dependency graph)
   graph --view      Generate the graph and open an interactive viewer
+  telemetry [path]  Rank the native telemetry JSONL (count, p50/p95, errors, bytes)
+                    by route/action/channel; no path reads VELO_TELEMETRY_FILE
 
 Examples:
   velojs init my-app
@@ -63,45 +65,57 @@ Examples:
   velojs graph
   velojs graph src/app
   velojs graph --view
+  velojs telemetry
+  velojs telemetry --last 60m
+  velojs telemetry ./telemetry.prod.jsonl
 `);
 };
-switch (c) {
+switch (a) {
   case "init": {
-    const { runInit: s } = await import("./init.js");
+    const { runInit: t } = await import("./init.js");
     try {
-      const e = t[1] && !t[1].startsWith("-") ? t[1] : void 0;
-      await s(e, { force: t.includes("--force") });
+      const e = s[1] && !s[1].startsWith("-") ? s[1] : void 0;
+      await t(e, { force: s.includes("--force") });
     } catch (e) {
       console.error(e.message), process.exit(1);
     }
     break;
   }
   case "dev":
-    m();
+    g();
     break;
   case "build": {
-    const s = t.includes("--static");
-    f(s);
+    const t = s.includes("--static");
+    j(t);
     break;
   }
   case "start":
     b();
     break;
   case "graph": {
-    const { buildGraph: s } = await import("./graph.js"), e = process.cwd(), o = t[1] && !t[1].startsWith("-") ? t[1] : null, r = n(e, o ?? "app"), i = s(r), l = n(e, ".velojs");
+    const { buildGraph: t } = await import("./graph.js"), e = process.cwd(), r = s[1] && !s[1].startsWith("-") ? s[1] : null, o = n(e, r ?? "app"), i = t(o), l = n(e, ".velojs");
     p.mkdirSync(l, { recursive: !0 });
-    const g = n(l, "graph.json");
-    if (p.writeFileSync(g, JSON.stringify(i)), console.log("Graph written to .velojs/graph.json"), t.includes("--view")) {
+    const m = n(l, "graph.json");
+    if (p.writeFileSync(m, JSON.stringify(i)), console.log("Graph written to .velojs/graph.json"), s.includes("--view")) {
       const { serveGraphViewer: h } = await import("./graph-viewer.js"), w = await h(e);
       console.log(`Graph viewer running at ${w} (Ctrl+C to stop)`);
     }
     break;
   }
+  case "telemetry": {
+    const { runTelemetryCli: t } = await import("./telemetry-cli.js");
+    try {
+      await t(s.slice(1));
+    } catch (e) {
+      console.error(e.message), process.exit(1);
+    }
+    break;
+  }
   case "help":
   case "--help":
   case "-h":
     d();
     break;
   default:
-    c && console.error(`Unknown command: ${c}`), d(), process.exit(1);
+    a && console.error(`Unknown command: ${a}`), d(), process.exit(1);
 }

package/dist/events.d.ts

@@ -314,6 +314,14 @@ export declare function poll<TEvent>(opts: {
 /**
  * Registers a GET SSE route for the given stream at the given path.
  * Used both by standalone streams and by stream_* discovery.
+ *
+ * `info` carries the convention identity (moduleId + stream name) into the
+ * telemetry `stream-connect` trace; standalone streams pass none and are
+ * addressed by their declared path only.
  */
-export declare function registerStreamHandler<TEvent, TSnapshot>(app: Hono, path: string, stream: EventStream<TEvent, TSnapshot>, middlewares?: Array<(c: Context, next: () => Promise<void>) => any>): void;
+export interface StreamTelemetryInfo {
+    moduleId?: string | undefined;
+    name?: string | undefined;
+}
+export declare function registerStreamHandler<TEvent, TSnapshot>(app: Hono, path: string, stream: EventStream<TEvent, TSnapshot>, middlewares?: Array<(c: Context, next: () => Promise<void>) => any>, info?: StreamTelemetryInfo): void;
 export {};

package/dist/events.js

@@ -1,165 +1,166 @@
-import { getAppContext as R } from "./app-context.js";
-const D = 2e4, N = 300 * 1e3, M = "";
-function F(r) {
-  const o = R().pendingStreamRoutes.splice(0);
-  for (const a of o) a(r);
+import { getAppContext as q } from "./app-context.js";
+import { trace as L, byteLength as P } from "./telemetry.js";
+const N = 2e4, k = 300 * 1e3, C = "";
+function x(r) {
+  const n = q().pendingStreamRoutes.splice(0);
+  for (const u of n) u(r);
 }
-const q = /* @__PURE__ */ new Set();
-function O() {
-  return q;
+const D = /* @__PURE__ */ new Set();
+function z() {
+  return D;
 }
-function x(r = {}) {
+function H(r = {}) {
   if (r.broadcast && r.channel && console.warn(
     "[velojs] createEventStream: `broadcast: true` ignores `channel`. Remove one of them — broadcast streams have no channels."
   ), (r.source ? 1 : 0) + (r.perChannelSource ? 1 : 0) + (r.pipe ? 1 : 0) > 1)
     throw new Error(
       "[velojs] createEventStream: `source`, `perChannelSource`, and `pipe` are mutually exclusive — pick one. `source` is stream-wide, `perChannelSource` and `pipe` are per-channel (prefer `pipe` for new code)."
     );
-  const o = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Set(), l = /* @__PURE__ */ new Map();
-  let f = null, i = 0;
-  const h = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map(), d = () => {
-    r.source && (f || (f = new AbortController(), Promise.resolve(
-      r.source(v, { abortSignal: f.signal })
+  const n = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Set(), v = /* @__PURE__ */ new Map();
+  let l = null, i = 0;
+  const S = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), A = () => {
+    r.source && (l || (l = new AbortController(), Promise.resolve(
+      r.source(b, { abortSignal: l.signal })
     ).catch((e) => {
       console.error("[velojs] event stream source threw:", e);
     })));
-  }, m = () => {
-    i > 0 || f && (f.abort(), f = null);
-  }, C = (e) => {
-    if (!r.perChannelSource || h.has(e)) return;
-    const t = new AbortController();
-    h.set(e, t);
-    const s = (n, u) => {
-      c.emit(e, n, u);
+  }, I = () => {
+    i > 0 || l && (l.abort(), l = null);
+  }, d = (e) => {
+    if (!r.perChannelSource || S.has(e)) return;
+    const o = new AbortController();
+    S.set(e, o);
+    const s = (t, a) => {
+      f.emit(e, t, a);
     };
     Promise.resolve(
-      r.perChannelSource(e, s, { abortSignal: t.signal })
-    ).catch((n) => {
+      r.perChannelSource(e, s, { abortSignal: o.signal })
+    ).catch((t) => {
       console.error(
         `[velojs] perChannelSource threw for channel "${e}":`,
-        n
+        t
       );
     });
-  }, P = (e) => {
-    const t = h.get(e);
-    t && (t.abort(), h.delete(e));
-  }, w = (e, t) => {
-    if (!r.pipe || S.has(e) || !t)
+  }, h = (e) => {
+    const o = S.get(e);
+    o && (o.abort(), S.delete(e));
+  }, w = (e, o) => {
+    if (!r.pipe || c.has(e) || !o)
       return;
     const s = new AbortController();
-    S.set(e, s);
-    let n = !1;
-    const u = (g, _) => {
-      c.emit(e, g, _);
-    }, A = () => c.close(e), j = () => {
-      n = !0;
+    c.set(e, s);
+    let t = !1;
+    const a = (g, m) => {
+      f.emit(e, g, m);
+    }, T = () => f.close(e), j = () => {
+      t = !0;
     };
     Promise.resolve(
       r.pipe({
-        send: u,
+        send: a,
         keepOpen: j,
-        close: A,
+        close: T,
         abortSignal: s.signal,
-        c: t.c,
-        params: t.params,
-        query: t.query,
+        c: o.c,
+        params: o.params,
+        query: o.query,
         channel: e
       })
     ).then(() => {
-      s.signal.aborted || n || c.close(e);
+      s.signal.aborted || t || f.close(e);
     }).catch((g) => {
       console.error(
         `[velojs] stream pipe threw for channel "${e}":`,
         g
-      ), s.signal.aborted || c.close(e);
+      ), s.signal.aborted || f.close(e);
     });
-  }, E = (e) => {
-    const t = S.get(e);
-    t && (t.abort(), S.delete(e));
+  }, M = (e) => {
+    const o = c.get(e);
+    o && (o.abort(), c.delete(e));
   };
-  function v(e, t, s) {
-    let n, u, A;
-    if (!!r.broadcast ? (n = M, u = e, A = t) : (n = e, u = t, A = s), p.has(n)) {
+  function b(e, o, s) {
+    let t, a, T;
+    if (!!r.broadcast ? (t = C, a = e, T = o) : (t = e, a = o, T = s), p.has(t)) {
       console.warn(
-        `[velojs] emit() called on closed channel "${n}" — ignored. Reopen the channel by emitting to a fresh ID, or remove the close() call.`
+        `[velojs] emit() called on closed channel "${t}" — ignored. Reopen the channel by emitting to a fresh ID, or remove the close() call.`
       );
       return;
     }
-    if (A?.snapshot) {
-      const _ = a.get(n) ?? [];
-      _.push(u);
-      const I = r.bufferSize ?? 1 / 0;
-      _.length > I && _.splice(0, _.length - I), a.set(n, _);
+    if (T?.snapshot) {
+      const m = u.get(t) ?? [];
+      m.push(a);
+      const R = r.bufferSize ?? 1 / 0;
+      m.length > R && m.splice(0, m.length - R), u.set(t, m);
     }
-    const g = o.get(n);
+    const g = n.get(t);
     if (g)
-      for (const _ of g) _(u);
+      for (const m of g) m(a);
   }
-  function T(e = M) {
+  function E(e = C) {
     if (p.has(e)) return;
     p.add(e);
-    const t = o.get(e);
-    if (t)
-      for (const u of t) u.close();
-    const s = r.retainMs ?? N, n = l.get(e);
-    n && clearTimeout(n), l.set(
+    const o = n.get(e);
+    if (o)
+      for (const a of o) a.close();
+    const s = r.retainMs ?? k, t = v.get(e);
+    t && clearTimeout(t), v.set(
       e,
       setTimeout(() => {
-        a.delete(e), l.delete(e), p.delete(e);
+        u.delete(e), v.delete(e), p.delete(e);
       }, s)
     );
   }
-  const c = {
-    emit: v,
-    close: T,
+  const f = {
+    emit: b,
+    close: E,
     __isVeloEventStream: !0,
     __config: r,
-    __listeners: o,
-    __buffers: a,
+    __listeners: n,
+    __buffers: u,
     __path: r.path,
-    __onConnect(e, t, s) {
-      let n = o.get(e);
-      const u = !n || n.size === 0;
-      n || (n = /* @__PURE__ */ new Set(), o.set(e, n)), n.add(t), i++, d(), u && (C(e), w(e, s));
+    __onConnect(e, o, s) {
+      let t = n.get(e);
+      const a = !t || t.size === 0;
+      t || (t = /* @__PURE__ */ new Set(), n.set(e, t)), t.add(o), i++, A(), a && (d(e), w(e, s));
     },
-    __onDisconnect(e, t) {
-      const s = o.get(e);
-      s && (s.delete(t), s.size === 0 && (o.delete(e), P(e), E(e)), i--, m());
+    __onDisconnect(e, o) {
+      const s = n.get(e);
+      s && (s.delete(o), s.size === 0 && (n.delete(e), h(e), M(e)), i--, I());
     },
     __reset() {
-      for (const e of o.values())
-        for (const t of e)
+      for (const e of n.values())
+        for (const o of e)
           try {
-            t.close();
+            o.close();
           } catch {
           }
-      o.clear(), a.clear(), p.clear();
-      for (const e of l.values()) clearTimeout(e);
-      l.clear(), f && (f.abort(), f = null);
-      for (const e of h.values()) e.abort();
-      h.clear();
+      n.clear(), u.clear(), p.clear();
+      for (const e of v.values()) clearTimeout(e);
+      v.clear(), l && (l.abort(), l = null);
       for (const e of S.values()) e.abort();
-      S.clear(), i = 0;
+      S.clear();
+      for (const e of c.values()) e.abort();
+      c.clear(), i = 0;
     }
   };
-  return r.path && R().pendingStreamRoutes.push((e) => {
-    k(e, r.path, c, r.middlewares ?? []);
-  }), q.add(c), c;
+  return r.path && q().pendingStreamRoutes.push((e) => {
+    y(e, r.path, f, r.middlewares ?? []);
+  }), D.add(f), f;
 }
-function z(r) {
-  return async (b, { abortSignal: o }) => {
-    for (; !o.aborted; ) {
+function J(r) {
+  return async (_, { abortSignal: n }) => {
+    for (; !n.aborted; ) {
       try {
-        await r.tick(b);
-      } catch (a) {
-        console.error("[velojs] poll tick threw:", a);
+        await r.tick(_);
+      } catch (u) {
+        console.error("[velojs] poll tick threw:", u);
       }
-      await new Promise((a) => {
-        const p = setTimeout(a, r.intervalMs);
-        o.addEventListener(
+      await new Promise((u) => {
+        const p = setTimeout(u, r.intervalMs);
+        n.addEventListener(
           "abort",
           () => {
-            clearTimeout(p), a();
+            clearTimeout(p), u();
           },
           { once: !0 }
         );
@@ -167,75 +168,83 @@ function z(r) {
     }
   };
 }
-function L(r) {
-  return r.req.query("channel") ?? M;
+function F(r) {
+  return r.req.query("channel") ?? C;
 }
-function k(r, b, o, a = []) {
-  const p = async (l) => {
-    const { streamSSE: f } = await import("hono/streaming");
-    let i;
-    if (o.__config.broadcast)
-      i = M;
+function y(r, _, n, u = [], p = {}) {
+  const v = async (l) => {
+    const i = L("stream-connect", {
+      route: _,
+      module: p.moduleId,
+      name: p.name
+    }), { streamSSE: S } = await import("hono/streaming");
+    let c;
+    if (n.__config.broadcast)
+      c = C;
     else {
-      const d = o.__config.channel ?? L;
-      let m;
+      const d = n.__config.channel ?? F;
+      let h;
       try {
-        m = await d(l);
-      } catch (C) {
-        return console.error("[velojs] channel resolver threw:", C), l.json({ error: "internal" }, 500);
+        h = await d(l);
+      } catch (w) {
+        return console.error("[velojs] channel resolver threw:", w), i.end({ status: "error" }), l.json({ error: "internal" }, 500);
       }
-      if (m == null)
-        return l.json({ error: "forbidden" }, 403);
-      i = m;
+      if (h == null)
+        return i.end({ status: "error" }), l.json({ error: "forbidden" }, 403);
+      c = h;
     }
-    const h = o.__config.heartbeatMs, S = h === !1 ? 0 : h ?? D;
-    return f(l, async (d) => {
-      const m = o.__buffers.get(i);
-      if (m && m.length > 0 && await d.writeSSE({
-        event: "snapshot",
-        data: JSON.stringify(m)
-      }), o.__config.snapshot) {
-        const t = await o.__config.snapshot(
-          i === M ? void 0 : i
+    i.setFields({ channel: c === C ? void 0 : c });
+    const A = n.__config.heartbeatMs, I = A === !1 ? 0 : A ?? N;
+    return S(l, async (d) => {
+      const h = n.__buffers.get(c);
+      if (h && h.length > 0) {
+        const t = JSON.stringify(h);
+        await d.writeSSE({ event: "snapshot", data: t }), i.enabled && i.delivery(P(t));
+      }
+      if (n.__config.snapshot) {
+        const t = await n.__config.snapshot(
+          c === C ? void 0 : c
         );
-        t !== void 0 && await d.writeSSE({
-          event: "snapshot",
-          data: JSON.stringify(t)
-        });
+        if (t !== void 0) {
+          const a = JSON.stringify(t);
+          await d.writeSSE({ event: "snapshot", data: a }), i.enabled && i.delivery(P(a));
+        }
       }
-      let C;
-      const P = new Promise((t) => {
-        C = t;
+      let w;
+      const M = new Promise((t) => {
+        w = t;
       });
-      let w = !1, E = null, v = Promise.resolve();
-      const T = (t) => (v = v.then(() => d.writeSSE(t)).catch(() => {
-      }), v), c = () => {
-        w || (w = !0, E && clearInterval(E), o.__onDisconnect(i, e), C());
-      }, e = ((t) => {
-        w || (T({ data: JSON.stringify(t) }), o.__config.closeOn?.(t) && v.then(() => {
-          d.close(), c();
-        }));
+      let b = !1, E = null, f = Promise.resolve();
+      const e = (t) => (f = f.then(() => d.writeSSE(t)).catch(() => {
+      }), f), o = () => {
+        b || (b = !0, E && clearInterval(E), n.__onDisconnect(c, s), i.close(), w());
+      }, s = ((t) => {
+        if (b) return;
+        const a = JSON.stringify(t);
+        i.enabled && i.delivery(P(a)), e({ data: a }), n.__config.closeOn?.(t) && f.then(() => {
+          d.close(), o();
+        });
       });
-      e.close = () => {
-        w || (T({ event: "close", data: "" }), v.then(() => {
-          d.close(), c();
+      s.close = () => {
+        b || (e({ event: "close", data: "" }), f.then(() => {
+          d.close(), o();
         }));
-      }, o.__onConnect(i, e, {
+      }, n.__onConnect(c, s, {
         c: l,
         params: l.req.param(),
         query: l.req.query()
-      }), E = S > 0 ? setInterval(() => {
-        w || T({ event: "heartbeat", data: "" });
-      }, S) : null, d.onAbort(c), await P;
+      }), E = I > 0 ? setInterval(() => {
+        b || e({ event: "heartbeat", data: "" });
+      }, I) : null, d.onAbort(o), i.end({ status: "ok" }), await M;
     });
   };
-  a.length > 0 ? r.on(["GET"], [b], ...a, p) : r.on(["GET"], [b], p);
+  u.length > 0 ? r.on(["GET"], [_], ...u, v) : r.on(["GET"], [_], v);
 }
 export {
-  D as DEFAULT_HEARTBEAT_MS,
-  x as createEventStream,
-  F as flushPendingStreamRoutes,
-  O as getRegisteredStreams,
-  z as poll,
-  k as registerStreamHandler
+  N as DEFAULT_HEARTBEAT_MS,
+  H as createEventStream,
+  x as flushPendingStreamRoutes,
+  z as getRegisteredStreams,
+  J as poll,
+  y as registerStreamHandler
 };