@mauroandre/velojs 0.0.22 → 0.0.23

package/dist/server.js

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