@mauroandre/velojs 0.0.24 → 0.0.26

package/README.md

@@ -534,6 +534,47 @@ The client-side transform rewrites the import to fetch `/_action/admin/Layout/lo
 
 ---
 
+## Endpoints
+
+Declarative HTTP endpoints for anything that isn't a page — webhooks, email-verification redirects, OAuth callbacks, health checks.
+
+Declare them directly in `routes.tsx`:
+
+```tsx
+import type { AppRoutes, EndpointHandler } from "@mauroandre/velojs";
+import * as Home from "./pages/Home.js";
+import { githubWebhook } from "./webhooks/github.handler.js";
+
+export default [
+    { path: "/", module: Home },
+    { path: "/api/github/webhook", method: "POST", handler: githubWebhook },
+] satisfies AppRoutes;
+```
+
+The handler gets `{ c, params, query }` and must return a `Response`:
+
+```ts
+import type { EndpointHandler } from "@mauroandre/velojs";
+
+export const githubWebhook: EndpointHandler = async ({ c }) => {
+    const body = await c.req.json();
+    // ...verify signature, process event...
+    return c.json({ ok: true });
+};
+```
+
+Endpoints inherit parent `middlewares` and can be nested inside grouping nodes. The Vite plugin strips endpoint objects (and their handler imports) from the client bundle, so server-only code never ships to the browser.
+
+Because endpoints live in `routes.tsx`, the testing toolkit sees them automatically:
+
+```ts
+const res = await app.post("/api/github/webhook", { body: {...}, headers: {...} });
+```
+
+Full documentation: [site/docs/17-endpoints.md](./site/docs/17-endpoints.md).
+
+---
+
 ## Event Streams
 
 Push real-time updates from server to client via Server-Sent Events (SSE). Live progress, notifications, metrics, log streaming, AI tokens — anything server → client.

package/dist/client.js

@@ -1,19 +1,46 @@
-import { jsx as r } from "preact/jsx-runtime";
-import { hydrate as l } from "preact";
-import { Router as p, Route as s, Switch as h } from "wouter-preact";
-const u = (e, o = !1) => e.map((t, n) => {
-  const c = t.module.Component;
-  if (!t.children)
-    return /* @__PURE__ */ r(s, { path: t.path || "", children: /* @__PURE__ */ r(c, {}) }, n);
-  const i = u(t.children, !!t.path);
-  return t.isRoot ? /* @__PURE__ */ r(h, { children: i }, n) : t.path ? /* @__PURE__ */ r(s, { path: t.path, nest: !0, children: /* @__PURE__ */ r(c, { children: /* @__PURE__ */ r(h, { children: i }) }) }, n) : /* @__PURE__ */ r(c, { children: /* @__PURE__ */ r(h, { children: i }) }, n);
-}), m = ({ routes: e }) => {
-  const o = u(e);
-  return /* @__PURE__ */ r(p, { children: o });
-}, R = (e) => {
-  const { routes: o } = e, t = document.querySelector("body");
-  t && l(/* @__PURE__ */ r(m, { routes: o }), t);
+import { jsx as e } from "preact/jsx-runtime";
+import { hydrate as p } from "preact";
+import { Router as f, Route as l, Switch as s } from "wouter-preact";
+const u = (r, i = !1) => {
+  const o = [];
+  for (let n = 0; n < r.length; n++) {
+    const t = r[n];
+    if (!t.module) {
+      if (t.children)
+        for (const d of u(t.children, i))
+          o.push(d);
+      continue;
+    }
+    const c = t.module.Component;
+    if (!t.children) {
+      o.push(
+        /* @__PURE__ */ e(l, { path: t.path || "", children: /* @__PURE__ */ e(c, {}) }, n)
+      );
+      continue;
+    }
+    const h = u(t.children, !!t.path);
+    if (t.isRoot) {
+      o.push(/* @__PURE__ */ e(s, { children: h }, n));
+      continue;
+    }
+    if (!t.path) {
+      o.push(
+        /* @__PURE__ */ e(c, { children: /* @__PURE__ */ e(s, { children: h }) }, n)
+      );
+      continue;
+    }
+    o.push(
+      /* @__PURE__ */ e(l, { path: t.path, nest: !0, children: /* @__PURE__ */ e(c, { children: /* @__PURE__ */ e(s, { children: h }) }) }, n)
+    );
+  }
+  return o;
+}, m = ({ routes: r }) => {
+  const i = u(r);
+  return /* @__PURE__ */ e(f, { children: i });
+}, C = (r) => {
+  const { routes: i } = r, o = document.querySelector("body");
+  o && p(/* @__PURE__ */ e(m, { routes: i }), o);
 };
 export {
-  R as startClient
+  C as startClient
 };

package/dist/events.js

@@ -1,8 +1,8 @@
 import { getAppContext as A } from "./app-context.js";
-const M = 2e4, R = 300 * 1e3, v = "";
+const M = 2e4, R = 300 * 1e3, m = "";
 function x(t) {
-  const o = A().pendingStreamRoutes.splice(0);
-  for (const c of o) c(t);
+  const n = A().pendingStreamRoutes.splice(0);
+  for (const l of n) l(t);
 }
 const I = /* @__PURE__ */ new Set();
 function y() {
@@ -15,116 +15,116 @@ function L(t = {}) {
     throw new Error(
       "[velojs] createEventStream: `source` and `perChannelSource` are mutually exclusive. Use `source` for stream-wide producers or `perChannelSource` for per-channel resources, not both."
     );
-  const a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Set(), f = /* @__PURE__ */ new Map();
-  let l = null, w = 0;
+  const a = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Set(), h = /* @__PURE__ */ new Map();
+  let c = null, w = 0;
   const i = /* @__PURE__ */ new Map(), b = () => {
-    t.source && (l || (l = new AbortController(), Promise.resolve(
-      t.source(p, { abortSignal: l.signal })
+    t.source && (c || (c = new AbortController(), Promise.resolve(
+      t.source(_, { abortSignal: c.signal })
     ).catch((e) => {
       console.error("[velojs] event stream source threw:", e);
     })));
-  }, m = () => {
-    w > 0 || l && (l.abort(), l = null);
-  }, u = (e) => {
+  }, g = () => {
+    w > 0 || c && (c.abort(), c = null);
+  }, d = (e) => {
     if (!t.perChannelSource || i.has(e)) return;
-    const n = new AbortController();
-    i.set(e, n);
-    const s = (r, S) => {
-      h.emit(e, r, S);
+    const r = new AbortController();
+    i.set(e, r);
+    const o = (s, f) => {
+      p.emit(e, s, f);
     };
     Promise.resolve(
-      t.perChannelSource(e, s, { abortSignal: n.signal })
-    ).catch((r) => {
+      t.perChannelSource(e, o, { abortSignal: r.signal })
+    ).catch((s) => {
       console.error(
         `[velojs] perChannelSource threw for channel "${e}":`,
-        r
+        s
       );
     });
-  }, d = (e) => {
-    const n = i.get(e);
-    n && (n.abort(), i.delete(e));
+  }, S = (e) => {
+    const r = i.get(e);
+    r && (r.abort(), i.delete(e));
   };
-  function p(e, n, s) {
-    let r, S, E;
-    if (!!t.broadcast ? (r = v, S = e, E = n) : (r = e, S = n, E = s), c.has(r)) {
+  function _(e, r, o) {
+    let s, f, u;
+    if (!!t.broadcast ? (s = m, f = e, u = r) : (s = e, f = r, u = o), l.has(s)) {
       console.warn(
-        `[velojs] emit() called on closed channel "${r}" — 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 (E?.snapshot) {
-      const _ = o.get(r) ?? [];
-      _.push(S);
+    if (u?.snapshot) {
+      const v = n.get(s) ?? [];
+      v.push(f);
       const T = t.bufferSize ?? 1 / 0;
-      _.length > T && _.splice(0, _.length - T), o.set(r, _);
+      v.length > T && v.splice(0, v.length - T), n.set(s, v);
     }
-    const C = a.get(r);
-    if (C)
-      for (const _ of C) _(S);
+    const E = a.get(s);
+    if (E)
+      for (const v of E) v(f);
   }
-  function g(e = v) {
-    if (c.has(e)) return;
-    c.add(e);
-    const n = a.get(e);
-    if (n)
-      for (const S of n) S.close();
-    const s = t.retainMs ?? R, r = f.get(e);
-    r && clearTimeout(r), f.set(
+  function C(e = m) {
+    if (l.has(e)) return;
+    l.add(e);
+    const r = a.get(e);
+    if (r)
+      for (const f of r) f.close();
+    const o = t.retainMs ?? R, s = h.get(e);
+    s && clearTimeout(s), h.set(
       e,
       setTimeout(() => {
-        o.delete(e), f.delete(e), c.delete(e);
-      }, s)
+        n.delete(e), h.delete(e), l.delete(e);
+      }, o)
     );
   }
-  const h = {
-    emit: p,
-    close: g,
+  const p = {
+    emit: _,
+    close: C,
     __isVeloEventStream: !0,
     __config: t,
     __listeners: a,
-    __buffers: o,
+    __buffers: n,
     __path: t.path,
-    __onConnect(e, n) {
-      let s = a.get(e);
-      const r = !s || s.size === 0;
-      s || (s = /* @__PURE__ */ new Set(), a.set(e, s)), s.add(n), w++, b(), r && u(e);
+    __onConnect(e, r) {
+      let o = a.get(e);
+      const s = !o || o.size === 0;
+      o || (o = /* @__PURE__ */ new Set(), a.set(e, o)), o.add(r), w++, b(), s && d(e);
     },
-    __onDisconnect(e, n) {
-      const s = a.get(e);
-      s && (s.delete(n), s.size === 0 && (a.delete(e), d(e)), w--, m());
+    __onDisconnect(e, r) {
+      const o = a.get(e);
+      o && (o.delete(r), o.size === 0 && (a.delete(e), S(e)), w--, g());
     },
     __reset() {
       for (const e of a.values())
-        for (const n of e)
+        for (const r of e)
           try {
-            n.close();
+            r.close();
           } catch {
           }
-      a.clear(), o.clear(), c.clear();
-      for (const e of f.values()) clearTimeout(e);
-      f.clear(), l && (l.abort(), l = null);
+      a.clear(), n.clear(), l.clear();
+      for (const e of h.values()) clearTimeout(e);
+      h.clear(), c && (c.abort(), c = null);
       for (const e of i.values()) e.abort();
       i.clear(), w = 0;
     }
   };
   return t.path && A().pendingStreamRoutes.push((e) => {
-    D(e, t.path, h, t.middlewares ?? []);
-  }), I.add(h), h;
+    P(e, t.path, p, t.middlewares ?? []);
+  }), I.add(p), p;
 }
 function B(t) {
-  return async (a, { abortSignal: o }) => {
-    for (; !o.aborted; ) {
+  return async (a, { abortSignal: n }) => {
+    for (; !n.aborted; ) {
       try {
         await t.tick(a);
-      } catch (c) {
-        console.error("[velojs] poll tick threw:", c);
+      } catch (l) {
+        console.error("[velojs] poll tick threw:", l);
       }
-      await new Promise((c) => {
-        const f = setTimeout(c, t.intervalMs);
-        o.addEventListener(
+      await new Promise((l) => {
+        const h = setTimeout(l, t.intervalMs);
+        n.addEventListener(
           "abort",
           () => {
-            clearTimeout(f), c();
+            clearTimeout(h), l();
           },
           { once: !0 }
         );
@@ -133,67 +133,69 @@ function B(t) {
   };
 }
 function j(t) {
-  return t.req.query("channel") ?? v;
+  return t.req.query("channel") ?? m;
 }
-function D(t, a, o, c = []) {
-  const f = async (l) => {
+function P(t, a, n, l = []) {
+  const h = async (c) => {
     const { streamSSE: w } = await import("hono/streaming");
     let i;
-    if (o.__config.broadcast)
-      i = v;
+    if (n.__config.broadcast)
+      i = m;
     else {
-      const u = o.__config.channel ?? j;
-      let d;
+      const d = n.__config.channel ?? j;
+      let S;
       try {
-        d = await u(l);
-      } catch (p) {
-        return console.error("[velojs] channel resolver threw:", p), l.json({ error: "internal" }, 500);
+        S = await d(c);
+      } catch (_) {
+        return console.error("[velojs] channel resolver threw:", _), c.json({ error: "internal" }, 500);
       }
-      if (d == null)
-        return l.json({ error: "forbidden" }, 403);
-      i = d;
+      if (S == null)
+        return c.json({ error: "forbidden" }, 403);
+      i = S;
     }
-    const b = o.__config.heartbeatMs, m = b === !1 ? 0 : b ?? M;
-    return w(l, async (u) => {
-      const d = o.__buffers.get(i);
-      if (d && d.length > 0 && await u.writeSSE({
+    const b = n.__config.heartbeatMs, g = b === !1 ? 0 : b ?? M;
+    return w(c, async (d) => {
+      const S = n.__buffers.get(i);
+      if (S && S.length > 0 && await d.writeSSE({
         event: "snapshot",
-        data: JSON.stringify(d)
-      }), o.__config.snapshot) {
-        const r = await o.__config.snapshot(
-          i === v ? void 0 : i
+        data: JSON.stringify(S)
+      }), n.__config.snapshot) {
+        const u = await n.__config.snapshot(
+          i === m ? void 0 : i
         );
-        r !== void 0 && await u.writeSSE({
+        u !== void 0 && await d.writeSSE({
           event: "snapshot",
-          data: JSON.stringify(r)
+          data: JSON.stringify(u)
         });
       }
-      let p;
-      const g = new Promise((r) => {
-        p = r;
+      let _;
+      const C = new Promise((u) => {
+        _ = u;
       });
-      let h = !1, e = null;
-      const n = () => {
-        h || (h = !0, e && clearInterval(e), o.__onDisconnect(i, s), p());
-      }, s = ((r) => {
-        h || (u.writeSSE({ data: JSON.stringify(r) }).catch(() => {
-        }), o.__config.closeOn?.(r) && (u.close(), n()));
+      let p = !1, e = null, r = Promise.resolve();
+      const o = (u) => (r = r.then(() => d.writeSSE(u)).catch(() => {
+      }), r), s = () => {
+        p || (p = !0, e && clearInterval(e), n.__onDisconnect(i, f), _());
+      }, f = ((u) => {
+        p || (o({ data: JSON.stringify(u) }), n.__config.closeOn?.(u) && r.then(() => {
+          d.close(), s();
+        }));
       });
-      s.close = () => {
-        h || (u.writeSSE({ event: "close", data: "" }).catch(() => {
-        }), u.close(), n());
-      }, o.__onConnect(i, s), e = m > 0 ? setInterval(() => {
-        h || u.writeSSE({ event: "heartbeat", data: "" }).catch(() => {
-        });
-      }, m) : null, u.onAbort(n), await g;
+      f.close = () => {
+        p || (o({ event: "close", data: "" }), r.then(() => {
+          d.close(), s();
+        }));
+      }, n.__onConnect(i, f), e = g > 0 ? setInterval(() => {
+        p || o({ event: "heartbeat", data: "" });
+      }, g) : null, d.onAbort(s), await C;
     });
   };
-  c.length > 0 ? t.on(["GET"], [a], ...c, f) : t.on(["GET"], [a], f);
+  l.length > 0 ? t.on(["GET"], [a], ...l, h) : t.on(["GET"], [a], h);
 }
 export {
   L as createEventStream,
   x as flushPendingStreamRoutes,
   y as getRegisteredStreams,
   B as poll,
-  D as registerStreamHandler
+  P as registerStreamHandler
 };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { AppRoutes, RouteNode, RouteModule, LoaderArgs, ActionArgs, Metadata, } from "./types.js";
+export type { AppRoutes, RouteNode, RouteModule, LoaderArgs, ActionArgs, Metadata, HTTPMethod, EndpointHandler, EndpointHandlerArgs, } from "./types.js";
 export type { VeloConfig } from "./config.js";
 export { defineConfig } from "./config.js";
 export { Scripts, Link } from "./components.js";