@mauroandre/velojs 0.0.22 → 0.0.24

package/dist/server.js

@@ -1,200 +1,200 @@
-import { jsx as _ } from "preact/jsx-runtime";
-import { Hono as T } from "hono";
-import { logger as b } from "hono/logger";
-import { trimTrailingSlash as A } from "hono/trailing-slash";
-import { render as R } from "preact-render-to-string";
-import { Router as D } from "wouter-preact";
-import { AsyncLocalStorage as I } from "node:async_hooks";
-const y = new I();
-globalThis.__veloServerData = y;
-const v = [];
-let g = null;
-function L(t) {
-  if (g) {
-    t(g);
+import { jsx as p } from "preact/jsx-runtime";
+import { Hono as b } from "hono";
+import { logger as q } from "hono/logger";
+import { trimTrailingSlash as T } from "hono/trailing-slash";
+import { render as A } from "preact-render-to-string";
+import { Router as R } from "wouter-preact";
+import { AsyncLocalStorage as C } from "node:async_hooks";
+import { getAppContext as g } from "./app-context.js";
+import { flushPendingStreamRoutes as D, registerStreamHandler as I } from "./events.js";
+const v = new C();
+globalThis.__veloServerData = v;
+let _ = null;
+function W(e) {
+  if (_) {
+    e(_);
     return;
   }
-  v.push(t);
+  g().serverCallbacks.push(e);
 }
-function w(t) {
-  g = t;
-  for (const e of v) e(t);
-  v.length = 0;
+function y(e) {
+  _ = e;
+  const t = g();
+  for (const s of t.serverCallbacks) s(e);
+  t.serverCallbacks.length = 0;
 }
-const S = [];
-function U(t) {
-  S.push(t);
+function J(e) {
+  g().pendingRoutes.push(e);
 }
-const N = (t, e, s) => {
-  if (t.req.query("_data") === "1") {
-    const c = globalThis.__veloBuildHash || void 0, o = s ? { ...s, __buildHash: c } : { __buildHash: c };
-    return t.json(o);
+const N = (e, t, s) => {
+  if (e.req.query("_data") === "1") {
+    const a = globalThis.__veloBuildHash || void 0, r = s ? { ...s, __buildHash: a } : { __buildHash: a };
+    return e.json(r);
   }
-  const r = t.req.path, n = y.run(
+  const n = e.req.path, o = v.run(
     s ?? {},
-    () => R(/* @__PURE__ */ _(D, { ssrPath: r, children: e }))
+    () => A(/* @__PURE__ */ p(R, { ssrPath: n, children: t }))
   );
-  if (t.header("Cache-Control", "no-cache"), !s)
-    return t.html(n);
-  const a = `<script>window.__PAGE_DATA__=${JSON.stringify(
+  if (e.header("Cache-Control", "no-cache"), !s)
+    return e.html(o);
+  const c = `<script>window.__PAGE_DATA__=${JSON.stringify(
     s
   )}<\/script>`;
-  return t.html(n.replace("</head>", `${a}</head>`));
-}, O = async (t, e) => {
-  const s = e.req.param(), r = e.req.query(), n = { params: s, query: r, c: e }, a = await Promise.all(
-    t.map(async (o) => {
-      if (!o.loader) return null;
-      const l = await o.loader(n), i = o.metadata?.moduleId;
-      return i ? { moduleId: i, loaderData: l } : null;
+  return e.html(o.replace("</head>", `${c}</head>`));
+}, O = async (e, t) => {
+  const s = t.req.param(), n = t.req.query(), o = { params: s, query: n, c: t }, c = await Promise.all(
+    e.map(async (r) => {
+      if (!r.loader) return null;
+      const d = await r.loader(o), i = r.metadata?.moduleId;
+      return i ? { moduleId: i, loaderData: d } : null;
     })
-  ), c = {
+  ), a = {
     __params: s,
-    __query: r,
-    __pathname: e.req.path
+    __query: n,
+    __pathname: t.req.path
   };
-  for (const o of a)
-    o && (c[o.moduleId] = o.loaderData);
+  for (const r of c)
+    r && (a[r.moduleId] = r.loaderData);
   return {
-    components: t.map((o) => o.Component),
-    data: c
+    components: e.map((r) => r.Component),
+    data: a
   };
-}, j = (t) => {
-  if (t.length === 0) return null;
-  const e = t.filter(Boolean);
+}, j = (e) => {
   if (e.length === 0) return null;
-  if (e.length === 1) {
-    const n = e[0];
-    return /* @__PURE__ */ _(n, {});
+  const t = e.filter(Boolean);
+  if (t.length === 0) return null;
+  if (t.length === 1) {
+    const o = t[0];
+    return /* @__PURE__ */ p(o, {});
   }
-  const s = e[e.length - 1];
-  return e.slice(0, -1).reduceRight((n, a) => /* @__PURE__ */ _(a, { children: n }), /* @__PURE__ */ _(s, {}));
-}, P = (t, e, s = [], r = []) => {
-  for (const n of e) {
-    const a = [...s, n.module], c = [
-      ...r,
-      ...n.middlewares || []
+  const s = t[t.length - 1];
+  return t.slice(0, -1).reduceRight((o, c) => /* @__PURE__ */ p(c, { children: o }), /* @__PURE__ */ p(s, {}));
+}, w = (e, t, s = [], n = []) => {
+  for (const o of t) {
+    const c = [...s, o.module], a = [
+      ...n,
+      ...o.middlewares || []
     ];
-    if (n.children)
-      P(
-        t,
-        n.children,
-        a,
-        c
+    if (o.children)
+      w(
+        e,
+        o.children,
+        c,
+        a
       );
     else {
-      const o = n.module.metadata?.fullPath;
-      if (!o) {
+      const r = o.module.metadata?.fullPath;
+      if (!r) {
         console.warn(
-          `Module ${n.module.metadata?.moduleId} has no fullPath`
+          `Module ${o.module.metadata?.moduleId} has no fullPath`
         );
         continue;
       }
-      const l = async (i) => {
-        const { components: m, data: d } = await O(a, i), u = j(m);
-        return N(i, u, d);
+      const d = async (i) => {
+        const { components: u, data: m } = await O(c, i), l = j(u);
+        return N(i, l, m);
       };
-      c.length > 0 ? t.on(["GET"], [o], ...c, l) : t.on(["GET"], [o], l);
+      a.length > 0 ? e.on(["GET"], [r], ...a, d) : e.on(["GET"], [r], d);
     }
   }
-}, E = (t, e, s = []) => {
-  for (const r of e) {
-    const n = r.module.metadata?.moduleId, a = [
+}, S = (e, t, s = []) => {
+  for (const n of t) {
+    const o = n.module.metadata?.moduleId, c = [
       ...s,
-      ...r.middlewares || []
+      ...n.middlewares || []
     ];
-    if (n) {
-      const c = Object.keys(r.module).filter(
-        (o) => o.startsWith("action_")
+    if (o) {
+      const a = Object.keys(n.module).filter(
+        (r) => r.startsWith("action_")
       );
-      for (const o of c) {
-        const l = o.replace("action_", ""), i = r.module[o];
+      for (const r of a) {
+        const d = r.replace("action_", ""), i = n.module[r];
         if (typeof i == "function") {
-          const m = `/_action/${n}/${l}`, d = async (u) => {
+          const u = `/_action/${o}/${d}`, m = async (l) => {
             let f = {};
             try {
-              f = await u.req.json();
+              f = await l.req.json();
             } catch {
             }
-            const h = {
+            const P = {
               body: f,
-              params: u.req.param(),
-              query: u.req.query(),
-              c: u
+              params: l.req.param(),
+              query: l.req.query(),
+              c: l
             };
             try {
-              const p = await i(h);
-              return u.json(p ?? { ok: !0 });
-            } catch (p) {
-              const q = p instanceof Error ? p.message : "Action failed";
-              return u.json({ error: q }, 500);
+              const h = await i(P);
+              return l.json(h ?? { ok: !0 });
+            } catch (h) {
+              const E = h instanceof Error ? h.message : "Action failed";
+              return l.json({ error: E }, 500);
             }
           };
-          a.length > 0 ? t.on(
+          c.length > 0 ? e.on(
             ["POST"],
-            [m],
-            ...a,
-            d
-          ) : t.on(["POST"], [m], d);
+            [u],
+            ...c,
+            m
+          ) : e.on(["POST"], [u], m);
         }
       }
     }
-    r.children && E(t, r.children, a);
+    n.children && S(e, n.children, c);
   }
-}, C = async (t, e, s = []) => {
-  const { registerStreamHandler: r } = await import("./events.js"), n = (a, c) => {
-    for (const o of a) {
-      const l = o.module.metadata?.moduleId, i = [
+}, $ = async (e, t, s = []) => {
+  const n = (o, c) => {
+    for (const a of o) {
+      const r = a.module.metadata?.moduleId, d = [
         ...c,
-        ...o.middlewares || []
+        ...a.middlewares || []
       ];
-      if (l) {
-        const m = Object.keys(o.module).filter(
-          (d) => d.startsWith("stream_")
+      if (r) {
+        const i = Object.keys(a.module).filter(
+          (u) => u.startsWith("stream_")
         );
-        for (const d of m) {
-          const u = d.replace("stream_", ""), f = o.module[d];
-          if (f?.__isVeloEventStream) {
-            const h = `/_event/${l}/${u}`;
-            f.__path = h, r(
-              t,
-              h,
+        for (const u of i) {
+          const m = u.replace("stream_", ""), l = a.module[u];
+          if (l?.__isVeloEventStream) {
+            const f = `/_event/${r}/${m}`;
+            l.__path = f, I(
+              e,
               f,
-              i
+              l,
+              d
             );
           }
         }
       }
-      o.children && n(o.children, i);
+      a.children && n(a.children, d);
     }
   };
-  n(e, s);
-}, $ = async (t) => {
-  const e = new T();
-  e.use(A()), process.env.NODE_ENV !== "production" && e.use("*", b());
-  for (const r of S)
-    await r(e);
-  P(e, t), E(e, t), await C(e, t);
-  const { flushPendingStreamRoutes: s } = await import("./events.js");
-  if (s(e), process.env.NODE_ENV !== "production" && !g) {
-    const r = globalThis.__veloDevServer;
-    r && w(r);
+  n(t, s);
+}, k = async (e) => {
+  const t = new b();
+  t.use(T()), process.env.NODE_ENV !== "production" && t.use("*", q());
+  const n = g().pendingRoutes.splice(0);
+  for (const o of n)
+    await o(t);
+  if (w(t, e), S(t, e), await $(t, e), D(t), process.env.NODE_ENV !== "production" && !_) {
+    const o = globalThis.__veloDevServer;
+    o && y(o);
   }
-  return e;
-}, W = async (t) => {
-  const { routes: e, port: s = Number(process.env.SERVER_PORT) || 3e3 } = t, r = await $(e);
+  return t;
+}, z = async (e) => {
+  const { routes: t, port: s = Number(process.env.SERVER_PORT) || 3e3 } = e, n = await k(t);
   if (process.env.NODE_ENV === "production" && !process.env.VELO_STATIC) {
-    const { serve: n } = await import("@hono/node-server"), { serveStatic: a } = await import("@hono/node-server/serve-static"), { join: c } = await import("node:path"), o = c(process.cwd(), "dist/client");
-    (process.env.STATIC_BASE_URL || "").startsWith("http") || r.use("/*", a({ root: o })), console.log(`Server running on http://localhost:${s}`);
-    const i = n({ fetch: r.fetch, port: s });
-    w(i);
+    const { serve: o } = await import("@hono/node-server"), { serveStatic: c } = await import("@hono/node-server/serve-static"), { join: a } = await import("node:path"), r = a(process.cwd(), "dist/client");
+    (process.env.STATIC_BASE_URL || "").startsWith("http") || n.use("/*", c({ root: r })), console.log(`Server running on http://localhost:${s}`);
+    const i = o({ fetch: n.fetch, port: s });
+    y(i);
   }
-  return r;
+  return n;
 };
 export {
-  U as addRoutes,
-  $ as createApp,
-  $ as default,
-  L as onServer,
-  y as serverDataStorage,
-  W as startServer
+  J as addRoutes,
+  k as createApp,
+  k as default,
+  W as onServer,
+  v as serverDataStorage,
+  z as startServer
 };

package/dist/testing/conventions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Resolve URLs from VeloJS function references (action_*, loader, stream_*).
+ * Relies on metadata injected by the VeloJS Vite plugin at build time.
+ */
+import type { AppRoutes } from "../types.js";
+interface ActionEntry {
+    name: string;
+    fn: Function;
+    moduleId: string;
+    url: string;
+}
+interface LoaderEntry {
+    fn: Function;
+    moduleId: string;
+    /** Multiple URL paths can share a loader if registered under different parents. */
+    paths: string[];
+}
+export interface ConventionRegistry {
+    actions: Map<Function, ActionEntry>;
+    loaders: Map<Function, LoaderEntry>;
+}
+export declare function buildConventionRegistry(routes: AppRoutes): ConventionRegistry;
+export declare function resolveActionUrl(registry: ConventionRegistry, fnOrUrl: Function | string): string;
+export declare function resolveLoaderPath(registry: ConventionRegistry, fnOrUrl: Function | string, params?: Record<string, string>): string;
+export {};

package/dist/testing/createTestApp.d.ts

@@ -0,0 +1,23 @@
+/**
+ * createTestApp — main entry point for the VeloJS testing toolkit.
+ *
+ * Builds an in-memory Hono app from your `routes` import, isolates side effects
+ * via AsyncLocalStorage so multiple test apps coexist, and exposes a
+ * FastAPI-TestClient-style API on top.
+ */
+import type { TestApp, CreateTestAppOptions } from "./types.js";
+/**
+ * Creates an isolated test app from your routes.
+ *
+ * ```typescript
+ * import { createTestApp } from "@mauroandre/velojs/testing";
+ * import { routes } from "../app/routes.js";
+ *
+ * const app = await createTestApp({
+ *     routes,
+ *     bootstrap: async () => { await connectDb(); },
+ *     getSessionCookie: async ({ user }) => ({ session: await sign(user) }),
+ * });
+ * ```
+ */
+export declare function createTestApp(opts: CreateTestAppOptions): Promise<TestApp>;

package/dist/testing/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @mauroandre/velojs/testing
+ *
+ * Backend testing toolkit for VeloJS apps. FastAPI-TestClient-style API:
+ * spin up the app in memory, fire HTTP requests against the registered handlers,
+ * subscribe to event streams, assert on the result. No socket, no browser.
+ *
+ * @example
+ * ```typescript
+ * import { createTestApp } from "@mauroandre/velojs/testing";
+ * import { routes } from "../app/routes.js";
+ *
+ * const app = await createTestApp({ routes });
+ * const res = await app.get("/api/health");
+ * expect(res.status).toBe(200);
+ * await app.close();
+ * ```
+ */
+export { createTestApp } from "./createTestApp.js";
+export type { TestApp, TestResponse, TestSubscription, CreateTestAppOptions, RequestOptions, BodyRequestOptions, LoaderRequestOptions, SubscribeOptions, NextOptions, MockContextOptions, Cookies, Headers, Query, Params, } from "./types.js";