@mauroandre/velojs 0.0.56 → 0.0.57

package/dist/live-loader.d.ts

@@ -3,11 +3,18 @@
  *
  * After hydration, every rendered module that declares `channels` opens one SSE
  * connection per (module, channel) at `/_channel/{moduleId}/{channel}`. The
- * snapshot the connection receives — the connect snapshot and each emit's —
- * replaces the value of the module's entry in the loader store, so the page
- * stays faithful to server state without a line of code from the developer:
- * `useLoader()`/`Loader()` handles keep the same signal instance and the
- * reading component re-renders on its own.
+ * connection declares the route params the module's path declares, extracted
+ * from the current URL and serialized in `?_route=` — the client declares the
+ * address it is already seeing, the server validates it against the declared
+ * path and decides the partition. The snapshot the connection receives — the
+ * connect snapshot and each emit's — replaces the value of the module's entry
+ * in the loader store, so the page stays faithful to server state without a
+ * line of code from the developer: `useLoader()`/`Loader()` handles keep the
+ * same signal instance and the reading component re-renders on its own.
+ *
+ * The connection is keyed by those params, not by the pathname: navigating
+ * between children of the same params keeps the connection; a move to another
+ * resource closes it and opens a new one.
  *
  * A `slice` event is the other delivery mode: the producer already holds the
  * value, so the payload carries only the changed keys. A slice is merged
@@ -68,19 +75,45 @@ export declare function loaderFreshness(): Signal<Freshness>;
  * closer — the channel lives exactly as long as the module that declares it is
  * mounted.
  *
+ * `routeParams` are the params the module's route declares, extracted from the
+ * current URL: the client **declares** the address it is already seeing (the
+ * same information `?_data=1` carries on every SPA navigation), serialized in
+ * the `?_route=` query param of the connection. It is not free input — the
+ * server validates the keys against the module's path and rejects what the path
+ * does not declare.
+ *
  * Inert (no connection, no freshness change) in a static build: there is no
  * server to speak SSE.
  */
-export declare function connectChannel(moduleId: string, channel: string): () => void;
+export declare function connectChannel(moduleId: string, channel: string, routeParams?: Record<string, string> | undefined): () => void;
+/**
+ * The params the module's route declares, extracted from a pathname. The
+ * module's `fullPath` matches as a **prefix** of the pathname: a layout
+ * declared at `/projeto/:id` covers `/projeto/7/sala` and extracts `id=7` —
+ * the child's suffix takes no part in the extraction. A path with a catch-all
+ * (`/docs/*`) declares no `:` key and yields the empty object, so the channel
+ * travels by principal.
+ */
+export declare function channelRouteParams(fullPath: string | undefined, pathname: string): Record<string, string>;
 /**
  * Mounts the live channels of one route module. It renders its children
  * unchanged (no DOM node, so SSR output and hydration are untouched) and only
  * exists to tie the connection lifecycle to the module's own mount/unmount —
  * SPA navigation and page close close the connections.
+ *
+ * The connection is **keyed by the params the module's route declares**, not
+ * by the pathname: navigating between children of the same params
+ * (`/projeto/7` → `/projeto/7/sala`) does not reconnect (the child's suffix is
+ * not part of the connection's identity), while a move to another resource
+ * (`/projeto/7` → `/projeto/9`) closes the old connection and opens a new one —
+ * with a fresh snapshot on connect, mirroring the loader store, which refetches
+ * when its own route's params move.
  */
-export declare function ChannelBoundary({ moduleId, channels, children, }: {
+export declare function ChannelBoundary({ moduleId, channels, fullPath, children, }: {
     moduleId?: string | undefined;
     channels?: readonly string[] | undefined;
+    /** The module's declared route path (`metadata.fullPath`) — its `:params`. */
+    fullPath?: string | undefined;
     children?: ComponentChildren;
 }): ComponentChildren;
 /** Test-only. Drops every connection and resets every freshness signal. */

package/dist/live-loader.js

@@ -1,33 +1,34 @@
-import { signal as h } from "@preact/signals";
-import { useEffect as S } from "preact/hooks";
-import { loaderEntry as v } from "./loader-store.js";
-const E = 6e4, _ = "snapshot", g = "slice", a = /* @__PURE__ */ new Set(), u = h("live"), d = /* @__PURE__ */ new Map();
-function b(e) {
-  let n = d.get(e);
-  return n || (n = h({}), d.set(e, n)), n;
+import { signal as v } from "@preact/signals";
+import { useEffect as m } from "preact/hooks";
+import { useLocation as g } from "wouter-preact";
+import { extractParams as _, loaderEntry as S } from "./loader-store.js";
+const L = 6e4, C = "snapshot", w = "slice", f = /* @__PURE__ */ new Set(), p = v("live"), y = /* @__PURE__ */ new Map();
+function R(e) {
+  let n = y.get(e);
+  return n || (n = v({}), y.set(e, n)), n;
 }
-function O() {
-  return u;
+function V() {
+  return p;
 }
-const f = /* @__PURE__ */ new Map();
-let p = !1;
-function m(e, n) {
-  let t = f.get(e);
-  t || (t = [], f.set(e, t)), t.push(n), !p && (p = !0, queueMicrotask(y));
+const u = /* @__PURE__ */ new Map();
+let h = !1;
+function N(e, n) {
+  let o = u.get(e);
+  o || (o = [], u.set(e, o)), o.push(n), !h && (h = !0, queueMicrotask(E));
 }
-function y() {
-  if (p = !1, f.size === 0) return;
-  const e = [...f];
-  f.clear();
-  for (const [n, t] of e) {
-    const r = v(n);
-    let s = r.value;
-    for (const o of t)
-      s = { ...s !== null && typeof s == "object" && !Array.isArray(s) ? s : {}, ...o };
-    r.value = s;
+function E() {
+  if (h = !1, u.size === 0) return;
+  const e = [...u];
+  u.clear();
+  for (const [n, o] of e) {
+    const s = S(n);
+    let t = s.value;
+    for (const l of o)
+      t = { ...t !== null && typeof t == "object" && !Array.isArray(t) ? t : {}, ...l };
+    s.value = t;
   }
 }
-function L(e) {
+function T(e) {
   if (typeof e != "string" || e.length === 0) return null;
   try {
     const n = JSON.parse(e);
@@ -36,96 +37,105 @@ function L(e) {
     return null;
   }
 }
-function C(e) {
+function O(e) {
   return e.some((n) => n.failed) ? "error" : e.some((n) => n.state === "open" && !n.silent) ? "live" : "stale";
 }
-function c() {
+function a() {
   let e = !1, n = !1;
-  for (const t of a)
-    t.failed && (e = !0), t.state === "open" && !t.silent && (n = !0);
-  e ? u.value = "error" : a.size > 0 && !n ? u.value = "stale" : u.value = "live";
-  for (const [t, r] of d) {
-    const s = /* @__PURE__ */ new Map();
-    for (const l of a) {
-      if (l.moduleId !== t) continue;
-      const i = s.get(l.channel);
-      i ? i.push(l) : s.set(l.channel, [l]);
+  for (const o of f)
+    o.failed && (e = !0), o.state === "open" && !o.silent && (n = !0);
+  e ? p.value = "error" : f.size > 0 && !n ? p.value = "stale" : p.value = "live";
+  for (const [o, s] of y) {
+    const t = /* @__PURE__ */ new Map();
+    for (const i of f) {
+      if (i.moduleId !== o) continue;
+      const r = t.get(i.channel);
+      r ? r.push(i) : t.set(i.channel, [i]);
     }
-    const o = {};
-    for (const [l, i] of s)
-      o[l] = C(i);
-    r.value = o;
+    const l = {};
+    for (const [i, r] of t)
+      l[i] = O(r);
+    s.value = l;
   }
 }
-function T(e, n) {
+function A(e, n, o) {
   if (typeof __VELO_STATIC__ < "u" && __VELO_STATIC__) return () => {
   };
   if (typeof window > "u" || typeof EventSource > "u")
     return () => {
     };
-  const t = {
+  const s = {
     state: "open",
     failed: !1,
     silent: !1,
     moduleId: e,
     channel: n
   };
-  a.add(t), c();
-  let r = null;
-  const s = () => {
-    r !== null && clearTimeout(r), r = setTimeout(() => {
-      r = null, t.silent = !0, c();
-    }, E);
+  f.add(s), a();
+  let t = null;
+  const l = () => {
+    t !== null && clearTimeout(t), t = setTimeout(() => {
+      t = null, s.silent = !0, a();
+    }, L);
   };
-  s();
-  const o = new EventSource(
-    `/_channel/${encodeURI(e)}/${encodeURIComponent(n)}`
+  l();
+  const i = o && Object.keys(o).length > 0 ? `?_route=${encodeURIComponent(JSON.stringify(o))}` : "", r = new EventSource(
+    `/_channel/${encodeURI(e)}/${encodeURIComponent(n)}${i}`
   );
-  return o.addEventListener(_, (l) => {
+  return r.addEventListener(C, (c) => {
     try {
-      y(), v(e).value = JSON.parse(l.data), t.state = "open", t.failed = !1, t.silent = !1, s(), c();
+      E(), S(e).value = JSON.parse(c.data), s.state = "open", s.failed = !1, s.silent = !1, l(), a();
     } catch {
     }
-  }), o.addEventListener(g, (l) => {
-    const i = L(l.data);
-    i && (t.state = "open", t.failed = !1, t.silent = !1, s(), c(), m(e, i));
-  }), o.addEventListener("error", (l) => {
-    const i = l.data;
-    typeof i == "string" && i.length > 0 ? t.failed = !0 : t.state = o.readyState === EventSource.CLOSED ? "closed" : "reconnecting", c();
-  }), o.addEventListener("close", () => {
-    t.state = "closed", c();
+  }), r.addEventListener(w, (c) => {
+    const d = T(c.data);
+    d && (s.state = "open", s.failed = !1, s.silent = !1, l(), a(), N(e, d));
+  }), r.addEventListener("error", (c) => {
+    const d = c.data;
+    typeof d == "string" && d.length > 0 ? s.failed = !0 : s.state = r.readyState === EventSource.CLOSED ? "closed" : "reconnecting", a();
+  }), r.addEventListener("close", () => {
+    s.state = "closed", a();
   }), () => {
-    a.delete(t), r !== null && clearTimeout(r);
+    f.delete(s), t !== null && clearTimeout(t);
     try {
-      o.close();
+      r.close();
     } catch {
     }
-    c();
+    a();
   };
 }
-function M({
+function b(e, n) {
+  return e ? _(e, n) ?? {} : {};
+}
+function $({
   moduleId: e,
   channels: n,
-  children: t
+  fullPath: o,
+  children: s
 }) {
-  const r = n && n.length > 0 ? n.join(",") : "";
-  return S(() => {
-    if (!e || r === "") return;
-    const s = r.split(",").map((o) => T(e, o));
+  const t = n && n.length > 0 ? n.join(",") : "";
+  g();
+  const l = t === "" || typeof window > "u" ? "" : JSON.stringify(b(o, window.location.pathname));
+  return m(() => {
+    if (!e || t === "") return;
+    const i = l === "" ? void 0 : JSON.parse(l), r = t.split(",").map(
+      (c) => A(e, c, i)
+    );
     return () => {
-      for (const o of s) o();
+      for (const c of r) c();
     };
-  }, [e, r]), t;
+  }, [e, t, l]), s;
 }
-function F() {
-  a.clear(), f.clear(), p = !1, u.value = "live";
-  for (const e of d.values()) e.value = {};
+function k() {
+  f.clear(), u.clear(), h = !1, p.value = "live";
+  for (const e of y.values()) e.value = {};
 }
 export {
-  E as CHANNEL_SILENCE_MS,
-  M as ChannelBoundary,
-  F as __resetLiveLoader,
-  T as connectChannel,
-  O as loaderFreshness,
-  b as moduleChannelFreshness
+  L as CHANNEL_SILENCE_MS,
+  $ as ChannelBoundary,
+  k as __resetLiveLoader,
+  b as channelRouteParams,
+  A as connectChannel,
+  V as loaderFreshness,
+  R as moduleChannelFreshness
 };

package/dist/server.d.ts

@@ -2,7 +2,7 @@ import { Hono } from "hono";
 import type { AppRoutes } from "./types.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 export { emit, inspectChannels, registerChannels } from "./channels.js";
-export type { ChannelDefinition, ChannelMap, ChannelScopeResult, ChannelRegistryOptions, ChannelEmitModule, ChannelEmitKind, ChannelSlice, ChannelInspectGroup, ChannelInspectChannel, ChannelInspectWindow, ChannelInspectReport, } from "./channels.js";
+export type { ChannelDefinition, ChannelMap, ChannelScopeContext, ChannelGroupOpenContext, ChannelGroupCloseContext, ChannelScopeResult, ChannelRegistryOptions, ChannelEmitModule, ChannelEmitKind, ChannelSlice, ChannelInspectGroup, ChannelInspectChannel, ChannelInspectWindow, ChannelInspectReport, } from "./channels.js";
 export declare const serverDataStorage: AsyncLocalStorage<Record<string, unknown>>;
 type ServerCallback = (server: import("http").Server) => void;
 export declare function onServer(fn: ServerCallback): void;

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, NextOptions, MockContextOptions, Cookies, Headers, Query, Params, } from "./types.js";
+export type { TestApp, TestResponse, TestSubscription, TestChannelSubscription, ChannelEvent, ChannelModuleRef, CreateTestAppOptions, RequestOptions, BodyRequestOptions, LoaderRequestOptions, SubscribeOptions, ChannelSubscribeOptions, NextOptions, MockContextOptions, Cookies, Headers, Query, Params, } from "./types.js";