@mauroandre/velojs 0.0.60 → 0.0.61

package/dist/telemetry-cli.js

@@ -1,61 +1,61 @@
-import d from "node:fs";
+import $ from "node:fs";
 import a from "node:path";
-import { expandTelemetryValue as w } from "./telemetry.js";
+import { expandTelemetryValue as g } from "./telemetry.js";
 import { readProjectEnv as k } from "./telemetry-node.js";
 function j(e) {
-  const o = e.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)?$/);
-  if (!o)
+  const r = e.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)?$/);
+  if (!r)
     throw new Error(
       `[velojs] invalid duration "${e}" — use a unit: 500ms, 30s, 60m, 2h, 7d.`
     );
-  const n = Number(o[1]), i = o[2] ?? "s";
+  const n = Number(r[1]), i = r[2] ?? "s";
   return n * (i === "ms" ? 1 : i === "s" ? 1e3 : i === "m" ? 6e4 : i === "h" ? 36e5 : 864e5);
 }
-function g(e) {
+function x(e) {
   try {
-    return d.statSync(e);
+    return $.statSync(e);
   } catch {
     return null;
   }
 }
-function x(e, o) {
-  const n = g(e);
+function L(e, r) {
+  const n = x(e);
   if (n?.isDirectory())
-    return d.readdirSync(e).filter((u) => u.includes(".jsonl")).sort().map((u) => a.join(e, u));
+    return $.readdirSync(e).filter((c) => c.includes(".jsonl")).sort().map((c) => a.join(e, c));
   if (n?.isFile()) return [e];
-  if (!o)
+  if (!r)
     throw new Error(`[velojs] velojs telemetry: file not found — ${e}`);
-  const i = a.dirname(e), t = a.basename(e), r = t.lastIndexOf("."), s = r > 0 ? t.slice(0, r) : t, l = r > 0 ? t.slice(r) : "";
-  if (!g(i))
+  const i = a.dirname(e), t = a.basename(e), o = t.lastIndexOf("."), s = o > 0 ? t.slice(0, o) : t, l = o > 0 ? t.slice(o) : "";
+  if (!x(i))
     throw new Error(
       `[velojs] velojs telemetry: no telemetry files at ${e} — the directory does not exist.`
     );
-  const h = d.readdirSync(i).filter((u) => u === t ? !0 : u.startsWith(`${s}.`) ? l === "" || u.includes(l) : !1).sort().map((u) => a.join(i, u));
+  const h = $.readdirSync(i).filter((c) => c === t ? !0 : c.startsWith(`${s}.`) ? l === "" || c.includes(l) : !1).sort().map((c) => a.join(i, c));
   if (h.length === 0)
     throw new Error(
       `[velojs] velojs telemetry: no telemetry files found for ${e} — set VELO_TELEMETRY_FILE (see .env.example) or pass the JSONL path explicitly.`
     );
   return h;
 }
-function M(e, o, n, i) {
+function M(e, r, n, i) {
   if (e) {
-    const l = w(e, { ...n, ...o }), h = a.isAbsolute(l) ? l : a.resolve(i, l);
-    return x(h, !1);
+    const l = g(e, { ...n, ...r }), h = a.isAbsolute(l) ? l : a.resolve(i, l);
+    return L(h, !1);
   }
-  const t = o.VELO_TELEMETRY_FILE ?? n.VELO_TELEMETRY_FILE ?? "";
+  const t = r.VELO_TELEMETRY_FILE ?? n.VELO_TELEMETRY_FILE ?? "";
   if (!t.trim())
     throw new Error(
       "[velojs] velojs telemetry: no destination — set VELO_TELEMETRY_FILE in the environment or in the project's .env (see .env.example), or pass the JSONL path as an argument."
     );
-  const r = w(t.trim(), { ...n, ...o }), s = a.isAbsolute(r) ? r : a.resolve(i, r);
-  return x(s, !0);
+  const o = g(t.trim(), { ...n, ...r }), s = a.isAbsolute(o) ? o : a.resolve(i, o);
+  return L(s, !0);
 }
 function O(e) {
-  const o = [];
+  const r = [];
   for (const n of e) {
     let i;
     try {
-      i = d.readFileSync(n, "utf-8");
+      i = $.readFileSync(n, "utf-8");
     } catch (t) {
       throw new Error(
         `[velojs] velojs telemetry: cannot read ${n} — ${t instanceof Error ? t.message : String(t)}`
@@ -63,56 +63,56 @@ function O(e) {
     }
     for (const t of i.split(`
 `)) {
-      const r = t.trim();
-      if (r)
+      const o = t.trim();
+      if (o)
         try {
-          const s = JSON.parse(r);
-          s && typeof s == "object" && typeof s.type == "string" && o.push(s);
+          const s = JSON.parse(o);
+          s && typeof s == "object" && typeof s.type == "string" && r.push(s);
         } catch {
         }
     }
   }
-  return o.sort((n, i) => {
-    const t = Date.parse(n.ts ?? ""), r = Date.parse(i.ts ?? "");
-    return (Number.isFinite(t) ? t : 0) - (Number.isFinite(r) ? r : 0);
-  }), o;
+  return r.sort((n, i) => {
+    const t = Date.parse(n.ts ?? ""), o = Date.parse(i.ts ?? "");
+    return (Number.isFinite(t) ? t : 0) - (Number.isFinite(o) ? o : 0);
+  }), r;
 }
-function N(e, o, n) {
-  if (o === null) return e;
-  const i = n - o;
+function N(e, r, n) {
+  if (r === null) return e;
+  const i = n - r;
   return e.filter((t) => {
-    const r = Date.parse(t.ts ?? "");
-    return Number.isFinite(r) && r >= i;
+    const o = Date.parse(t.ts ?? "");
+    return Number.isFinite(o) && o >= i;
   });
 }
-function L(e, o) {
+function T(e, r) {
   if (e.length === 0) return null;
   const n = [...e].sort((s, l) => s - l);
   if (n.length === 1) return n[0];
-  const i = (n.length - 1) * o, t = Math.floor(i), r = Math.ceil(i);
-  return t === r ? n[t] : n[t] + (n[r] - n[t]) * (i - t);
+  const i = (n.length - 1) * r, t = Math.floor(i), o = Math.ceil(i);
+  return t === o ? n[t] : n[t] + (n[o] - n[t]) * (i - t);
 }
-function y(e, o, n) {
+function m(e, r, n) {
   const i = /* @__PURE__ */ new Map();
   for (const t of e) {
-    if (!o(t)) continue;
-    const r = n(t);
-    let s = i.get(r);
-    s || (s = { durations: [], count: 0, errors: 0, bytes: 0 }, i.set(r, s)), s.count += 1, t.status === "error" && (s.errors += 1), typeof t.duration == "number" && Number.isFinite(t.duration) && s.durations.push(t.duration), typeof t.bytes == "number" && Number.isFinite(t.bytes) && (s.bytes += t.bytes);
+    if (!r(t)) continue;
+    const o = n(t);
+    let s = i.get(o);
+    s || (s = { durations: [], count: 0, errors: 0, bytes: 0 }, i.set(o, s)), s.count += 1, t.status === "error" && (s.errors += 1), typeof t.duration == "number" && Number.isFinite(t.duration) && s.durations.push(t.duration), typeof t.bytes == "number" && Number.isFinite(t.bytes) && (s.bytes += t.bytes);
   }
-  return [...i.entries()].map(([t, r]) => ({
+  return [...i.entries()].map(([t, o]) => ({
     key: t,
-    count: r.count,
-    errors: r.errors,
-    p50: L(r.durations, 0.5),
-    p95: L(r.durations, 0.95),
-    bytes: r.bytes
-  })).sort((t, r) => r.count - t.count || (t.key < r.key ? -1 : t.key > r.key ? 1 : 0));
+    count: o.count,
+    errors: o.errors,
+    p50: T(o.durations, 0.5),
+    p95: T(o.durations, 0.95),
+    bytes: o.bytes
+  })).sort((t, o) => o.count - t.count || (t.key < o.key ? -1 : t.key > o.key ? 1 : 0));
 }
 const R = (e) => e.type === "page" || e.type === "data" || e.type === "endpoint", D = (e) => {
-  const o = e.route ?? "(no route)";
-  return e.type === "endpoint" && e.method ? `${e.method} ${o}` : o;
-}, S = (e) => `${e.module ?? "(no module)"}/${e.name ?? "(no name)"}`, _ = (e) => typeof e.channel == "string";
+  const r = e.route ?? "(no route)";
+  return e.type === "endpoint" && e.method ? `${e.method} ${r}` : r;
+}, d = (e) => `${e.module ?? "(no module)"}/${e.name ?? "(no name)"}`, _ = (e) => typeof e.channel == "string", v = (e) => e.type === "live-action-connect" || (e.type === "delivery" || e.type === "close") && typeof e.name == "string";
 function B(e) {
   switch (e.type) {
     case "page":
@@ -120,13 +120,15 @@ function B(e) {
     case "endpoint":
       return `${e.method ? `${e.method} ` : ""}${e.route ?? "(no route)"}`;
     case "action":
-      return S(e);
+      return d(e);
+    case "live-action-connect":
+      return `${d(e)} (live)`;
     case "emit":
       return `${e.channel ?? "?"} (${e.mode ?? "?"}${e.connections !== void 0 ? `, ${e.connections} conn` : ""})`;
     case "delivery":
-      return `${e.channel ?? "?"} #${e.deliveries ?? "?"}`;
+      return e.channel === void 0 && e.name !== void 0 ? `${d(e)} #${e.deliveries ?? "?"}` : `${e.channel ?? "?"} #${e.deliveries ?? "?"}`;
     case "close":
-      return `${e.channel ?? "?"} ${e.deliveries ?? 0} deliveries`;
+      return e.channel === void 0 && e.name !== void 0 ? `${d(e)} ${e.deliveries ?? 0} deliveries` : `${e.channel ?? "?"} ${e.deliveries ?? 0} deliveries`;
     case "stream-connect":
       return `${e.route ?? "?"}${e.channel ? ` [${e.channel}]` : ""}`;
     case "socket-connect":
@@ -139,14 +141,15 @@ function B(e) {
       return e.route ?? e.channel ?? "?";
   }
 }
-function I(e, o) {
+function A(e, r) {
   return {
     files: e,
-    events: o,
-    routes: y(o, R, D),
-    actions: y(o, (n) => n.type === "action", S),
-    channels: y(o, _, (n) => n.channel),
-    timeline: o.map((n) => ({
+    events: r,
+    routes: m(r, R, D),
+    actions: m(r, (n) => n.type === "action", d),
+    channels: m(r, _, (n) => n.channel),
+    liveActions: m(r, v, d),
+    timeline: r.map((n) => ({
       ts: n.ts ?? "",
       type: n.type,
       label: B(n),
@@ -157,59 +160,59 @@ function I(e, o) {
     }))
   };
 }
-const V = "—";
+const I = "—";
 function p(e) {
-  return e === null ? V : e >= 1e3 ? `${(e / 1e3).toFixed(2)}s` : `${e.toFixed(1)}ms`;
+  return e === null ? I : e >= 1e3 ? `${(e / 1e3).toFixed(2)}s` : `${e.toFixed(1)}ms`;
 }
-function E(e) {
+function w(e) {
   return e <= 0 ? "0" : e >= 1024 * 1024 ? `${(e / (1024 * 1024)).toFixed(1)}MB` : e >= 1024 ? `${(e / 1024).toFixed(1)}KB` : `${e}B`;
 }
-function $(e, o) {
+function y(e, r) {
   const n = [e];
-  if (o.length === 0)
+  if (r.length === 0)
     return n.push("  (nothing)"), n;
   const i = {
-    key: Math.max(3, ...o.map((s) => s.key.length)),
-    count: Math.max(5, ...o.map((s) => String(s.count).length)),
-    errors: Math.max(6, ...o.map((s) => String(s.errors).length)),
-    p50: Math.max(4, ...o.map((s) => p(s.p50).length)),
-    p95: Math.max(4, ...o.map((s) => p(s.p95).length)),
-    bytes: Math.max(5, ...o.map((s) => E(s.bytes).length))
-  }, t = (s, l) => s.padEnd(l), r = (s, l) => s.padStart(l);
+    key: Math.max(3, ...r.map((s) => s.key.length)),
+    count: Math.max(5, ...r.map((s) => String(s.count).length)),
+    errors: Math.max(6, ...r.map((s) => String(s.errors).length)),
+    p50: Math.max(4, ...r.map((s) => p(s.p50).length)),
+    p95: Math.max(4, ...r.map((s) => p(s.p95).length)),
+    bytes: Math.max(5, ...r.map((s) => w(s.bytes).length))
+  }, t = (s, l) => s.padEnd(l), o = (s, l) => s.padStart(l);
   n.push(
-    `  ${t("key", i.key)}  ${r("count", i.count)}  ${r("errors", i.errors)}  ${r("p50", i.p50)}  ${r("p95", i.p95)}  ${r("bytes", i.bytes)}`
+    `  ${t("key", i.key)}  ${o("count", i.count)}  ${o("errors", i.errors)}  ${o("p50", i.p50)}  ${o("p95", i.p95)}  ${o("bytes", i.bytes)}`
   );
-  for (const s of o)
+  for (const s of r)
     n.push(
-      `  ${t(s.key, i.key)}  ${r(String(s.count), i.count)}  ${r(String(s.errors), i.errors)}  ${r(p(s.p50), i.p50)}  ${r(p(s.p95), i.p95)}  ${r(E(s.bytes), i.bytes)}`
+      `  ${t(s.key, i.key)}  ${o(String(s.count), i.count)}  ${o(String(s.errors), i.errors)}  ${o(p(s.p50), i.p50)}  ${o(p(s.p95), i.p95)}  ${o(w(s.bytes), i.bytes)}`
     );
   return n;
 }
-function J(e) {
-  const o = ["Timeline"];
+function V(e) {
+  const r = ["Timeline"];
   if (e.length === 0)
-    return o.push("  (nothing)"), o;
+    return r.push("  (nothing)"), r;
   for (const n of e) {
-    const i = n.ts.replace("T", " ").replace("Z", ""), t = n.duration === null ? "" : `  ${p(n.duration)}`, r = n.status ? `  ${n.status}` : "", s = n.bytes === null ? "" : `  ${E(n.bytes)}`;
-    o.push(`  ${i}  ${n.type.padEnd(15)}  ${n.label}${t}${r}${s}`);
+    const i = n.ts.replace("T", " ").replace("Z", ""), t = n.duration === null ? "" : `  ${p(n.duration)}`, o = n.status ? `  ${n.status}` : "", s = n.bytes === null ? "" : `  ${w(n.bytes)}`;
+    r.push(`  ${i}  ${n.type.padEnd(15)}  ${n.label}${t}${o}${s}`);
   }
-  return o;
+  return r;
 }
-function v(e, o, n, i) {
+function J(e, r, n, i) {
   const t = ["VeloJS telemetry"];
   t.push(`files:  ${e.files.length}`);
   for (const s of e.files) t.push(`  ${s}`);
-  const r = o === null ? "the whole file" : `last ${i ?? W(o)} — since ${new Date(n - o).toISOString()}`;
-  return t.push(`window: ${r}`), t.push(`events: ${e.events.length}`), t.push(""), t.push(...$("By route", e.routes)), t.push(""), t.push(...$("By action", e.actions)), t.push(""), t.push(...$("By channel", e.channels)), t.push(""), t.push(...J(e.timeline)), t.join(`
+  const o = r === null ? "the whole file" : `last ${i ?? W(r)} — since ${new Date(n - r).toISOString()}`;
+  return t.push(`window: ${o}`), t.push(`events: ${e.events.length}`), t.push(""), t.push(...y("By route", e.routes)), t.push(""), t.push(...y("By action", e.actions)), t.push(""), t.push(...y("By channel", e.channels)), t.push(""), t.push(...y("By live action", e.liveActions)), t.push(""), t.push(...V(e.timeline)), t.join(`
 `);
 }
 function W(e) {
   return e % 864e5 === 0 ? `${e / 864e5}d` : e % 36e5 === 0 ? `${e / 36e5}h` : e % 6e4 === 0 ? `${e / 6e4}m` : e % 1e3 === 0 ? `${e / 1e3}s` : `${e}ms`;
 }
-const b = `Usage: velojs telemetry [path] [--last <duration>]
+const E = `Usage: velojs telemetry [path] [--last <duration>]
 
 Ranks the JSONL written by the native telemetry (count, errors, p50/p95,
-bytes) by route, action and channel, and prints the timeline.
+bytes) by route, action, channel and live action, and prints the timeline.
 
   path            JSONL file copied from production (or a directory of them).
                   Without it, VELO_TELEMETRY_FILE from the environment or the
@@ -221,45 +224,45 @@ Examples:
   velojs telemetry
   velojs telemetry --last 60m
   velojs telemetry ./telemetry.prod.jsonl`;
-async function U(e, o = {}) {
-  const n = o.cwd ?? process.cwd(), i = o.env ?? process.env, t = o.write ?? ((f) => console.log(f));
-  let r = null, s = null, l;
+async function q(e, r = {}) {
+  const n = r.cwd ?? process.cwd(), i = r.env ?? process.env, t = r.write ?? ((f) => console.log(f));
+  let o = null, s = null, l;
   for (let f = 0; f < e.length; f += 1) {
-    const c = e[f];
-    if (c === "--help" || c === "-h") {
-      t(b);
+    const u = e[f];
+    if (u === "--help" || u === "-h") {
+      t(E);
       return;
     }
-    if (c === "--last") {
-      const m = e[f + 1];
-      if (m === void 0)
+    if (u === "--last") {
+      const b = e[f + 1];
+      if (b === void 0)
         throw new Error("[velojs] velojs telemetry: --last requires a duration (e.g. --last 60m).");
-      s = j(m), l = m, f += 1;
+      s = j(b), l = b, f += 1;
       continue;
     }
-    if (c.startsWith("--last=")) {
-      l = c.slice(7), s = j(l);
+    if (u.startsWith("--last=")) {
+      l = u.slice(7), s = j(l);
       continue;
     }
-    if (c.startsWith("-"))
-      throw new Error(`[velojs] velojs telemetry: unknown flag "${c}".
+    if (u.startsWith("-"))
+      throw new Error(`[velojs] velojs telemetry: unknown flag "${u}".
 
-${b}`);
-    if (r !== null)
-      throw new Error(`[velojs] velojs telemetry: unexpected argument "${c}".
+${E}`);
+    if (o !== null)
+      throw new Error(`[velojs] velojs telemetry: unexpected argument "${u}".
 
-${b}`);
-    r = c;
+${E}`);
+    o = u;
   }
-  const h = k(n), u = M(r, i, h, n), T = N(O(u), s, Date.now()), F = I(u, T);
-  t(v(F, s, Date.now(), l));
+  const h = k(n), c = M(o, i, h, n), S = N(O(c), s, Date.now()), F = A(c, S);
+  t(J(F, s, Date.now(), l));
 }
 export {
-  I as buildTelemetryReport,
-  x as collectTelemetryFiles,
-  v as formatTelemetryReport,
+  A as buildTelemetryReport,
+  L as collectTelemetryFiles,
+  J as formatTelemetryReport,
   j as parseDuration,
   O as readTelemetryEvents,
-  U as runTelemetryCli,
+  q as runTelemetryCli,
   N as windowEvents
 };

package/dist/telemetry.d.ts

@@ -2,8 +2,8 @@
  * Native telemetry — boundary traces, first-class JSONL (client-safe core).
  *
  * The framework owns a finite set of bottlenecks (page SSR, `?_data=1` refetch,
- * action, declarative endpoint, stream connect, socket setup, channel connect)
- * plus the emit chain that runs outside any request. This module turns each of
+ * action, declarative endpoint, stream connect, socket setup, channel connect,
+ * live action connect) plus the emit chain that runs outside any request. This module turns each of
  * them into one JSONL event with duration, status, response bytes, child spans
  * and — on long connections — one delivery line per frame delivered and a final
  * close line. The file is the production artifact; `velojs telemetry` ranks it.
@@ -22,7 +22,7 @@
  * injected at boot — the client bundle never reaches it.
  */
 /** Every line of the JSONL carries one of these types. */
-export type TelemetryEventType = "boot" | "page" | "data" | "action" | "endpoint" | "stream-connect" | "socket-connect" | "channel-connect" | "emit" | "delivery" | "close";
+export type TelemetryEventType = "boot" | "page" | "data" | "action" | "endpoint" | "stream-connect" | "socket-connect" | "channel-connect" | "live-action-connect" | "emit" | "delivery" | "close";
 export type TelemetryStatus = "ok" | "error";
 /** One child span: name, start relative to the trace, own duration and status. */
 export interface TelemetrySpan {

package/dist/testing/index.d.ts

@@ -21,4 +21,4 @@
  * snapshot — no sleep, no retry.
  */
 export { createTestApp } from "./createTestApp.js";
-export type { TestApp, TestResponse, TestSubscription, TestChannelSubscription, ChannelEvent, ChannelModuleRef, CreateTestAppOptions, RequestOptions, BodyRequestOptions, LoaderRequestOptions, SubscribeOptions, ChannelSubscribeOptions, NextOptions, MockContextOptions, Cookies, Headers, Query, Params, } from "./types.js";
+export type { TestApp, TestResponse, TestSubscription, TestChannelSubscription, ChannelEvent, ChannelModuleRef, CreateTestAppOptions, RequestOptions, BodyRequestOptions, LoaderRequestOptions, SubscribeOptions, ChannelSubscribeOptions, LiveActionSubscribeOptions, NextOptions, MockContextOptions, Cookies, Headers, Query, Params, } from "./types.js";