alabjs 0.1.0

package/dist/server/app.js

@@ -0,0 +1,407 @@
+import { createApp as createH3App, createRouter, defineEventHandler, getQuery, readBody } from "h3";
+import { createServer } from "node:http";
+import { resolve, dirname, join, extname } from "node:path";
+import { existsSync, createReadStream, statSync } from "node:fs";
+import { toNodeListener } from "h3";
+import { renderToResponse } from "../ssr/render.js";
+import { generateSitemap } from "./sitemap.js";
+import { csrfMiddleware, setCsrfCookie } from "./csrf.js";
+import { handleImageRequest } from "./image.js";
+import { runMiddleware } from "./middleware.js";
+import { checkRevalidateAuth, applyRevalidate } from "./revalidate.js";
+/**
+ * Find layout file paths (relative to cwd root) for a given route.file, ordered outermost→innermost.
+ * Checks the compiled dist directory for the existence of each layout.
+ */
+function findProdLayoutFiles(routeFile, distDir) {
+    // routeFile is like "app/users/[id]/page.tsx"
+    const pageDir = dirname(routeFile);
+    const parts = pageDir.split("/");
+    const layouts = [];
+    for (let i = 1; i <= parts.length; i++) {
+        const dir = parts.slice(0, i).join("/");
+        const layoutRelPath = `${dir}/layout.tsx`;
+        if (existsSync(join(distDir, "server", layoutRelPath))) {
+            layouts.push(layoutRelPath);
+        }
+    }
+    return layouts;
+}
+/**
+ * Find nearest error.tsx for a given route.file, searching innermost→outermost.
+ */
+function findProdErrorFile(routeFile, distDir) {
+    let dir = dirname(routeFile);
+    while (dir.length > 0 && dir !== ".") {
+        const candidate = `${dir}/error.tsx`;
+        if (existsSync(join(distDir, "server", candidate)))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+function findProdLoadingFile(routeFile, distDir) {
+    let dir = dirname(routeFile);
+    while (dir.length > 0 && dir !== ".") {
+        const candidate = `${dir}/loading.tsx`;
+        if (existsSync(join(distDir, "server", candidate)))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Create and return an Alab HTTP application backed by H3.
+ *
+ * In production (`alab start`), this is the entry point.
+ * In development, Vite's dev server wraps the SSR logic directly via the
+ * dev command middleware — this function is not used in dev.
+ */
+export function createApp(manifest, distDir) {
+    const app = createH3App();
+    const router = createRouter();
+    const publicDir = resolve(distDir, "../../public");
+    // ─── Global middleware ───────────────────────────────────────────────────────
+    app.use(defineEventHandler((event) => {
+        const res = event.node.res;
+        res.setHeader("x-content-type-options", "nosniff");
+        res.setHeader("x-frame-options", "SAMEORIGIN");
+        res.setHeader("referrer-policy", "strict-origin-when-cross-origin");
+        res.setHeader("permissions-policy", "camera=(), microphone=(), geolocation=()");
+        res.setHeader("x-permitted-cross-domain-policies", "none");
+        // HSTS — only meaningful over HTTPS; set in production only.
+        res.setHeader("strict-transport-security", "max-age=31536000; includeSubDomains");
+    }));
+    // ─── User middleware (middleware.ts compiled to dist/server/middleware.ts) ───
+    const middlewareModulePath = `${distDir}/server/middleware.ts`;
+    if (existsSync(middlewareModulePath)) {
+        app.use(defineEventHandler(async (event) => {
+            const mod = await import(middlewareModulePath);
+            if (typeof mod.middleware !== "function")
+                return;
+            const req = event.node.req;
+            const res = event.node.res;
+            const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+            const webReq = new Request(url.toString(), {
+                method: req.method ?? "GET",
+                headers: req.headers,
+            });
+            const middlewareRes = await runMiddleware(mod, webReq);
+            if (middlewareRes) {
+                res.statusCode = middlewareRes.status;
+                middlewareRes.headers.forEach((v, k) => res.setHeader(k, v));
+                res.end(Buffer.from(await middlewareRes.arrayBuffer()));
+                return null;
+            }
+            return undefined;
+        }));
+    }
+    // CSRF protection (active in production, skipped in dev)
+    app.use(csrfMiddleware());
+    // ─── Static file serving ────────────────────────────────────────────────────
+    // Serves built client assets (JS/CSS from `.alabjs/dist/client/`) and files
+    // from the project's `public/` directory. Dynamic alab routes take priority
+    // via the router registered below; this handler only fires for real files.
+    const clientDir = resolve(distDir, "client");
+    const MIME_TYPES = {
+        ".js": "application/javascript; charset=utf-8",
+        ".mjs": "application/javascript; charset=utf-8",
+        ".css": "text/css; charset=utf-8",
+        ".html": "text/html; charset=utf-8",
+        ".json": "application/json; charset=utf-8",
+        ".svg": "image/svg+xml",
+        ".png": "image/png",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".gif": "image/gif",
+        ".webp": "image/webp",
+        ".ico": "image/x-icon",
+        ".woff": "font/woff",
+        ".woff2": "font/woff2",
+        ".ttf": "font/ttf",
+        ".txt": "text/plain; charset=utf-8",
+        ".xml": "application/xml; charset=utf-8",
+        ".map": "application/json; charset=utf-8",
+    };
+    app.use(defineEventHandler((event) => {
+        const req = event.node.req;
+        const res = event.node.res;
+        if (req.method !== "GET" && req.method !== "HEAD")
+            return;
+        const rawPath = (req.url ?? "/").split("?")[0] ?? "/";
+        // Decode and strip traversal attempts
+        let relPath;
+        try {
+            relPath = decodeURIComponent(rawPath);
+        }
+        catch {
+            return;
+        }
+        if (relPath.includes(".."))
+            return;
+        const ext = extname(relPath).toLowerCase();
+        const contentType = MIME_TYPES[ext];
+        if (!contentType)
+            return; // skip extensionless paths (page routes)
+        // 1. Built client assets (JS chunks, CSS, source maps)
+        const clientCandidate = join(clientDir, relPath);
+        if (existsSync(clientCandidate)) {
+            const stat = statSync(clientCandidate);
+            if (stat.isFile()) {
+                res.setHeader("content-type", contentType);
+                res.setHeader("content-length", stat.size);
+                // Immutable cache for hashed assets; short TTL for others
+                const isHashed = /\.[a-f0-9]{8,}\.[a-z]+$/.test(relPath);
+                res.setHeader("cache-control", isHashed
+                    ? "public, max-age=31536000, immutable"
+                    : "public, max-age=3600");
+                if (req.method === "HEAD") {
+                    res.end();
+                    return null;
+                }
+                createReadStream(clientCandidate).pipe(res);
+                return null;
+            }
+        }
+        // 2. Public directory (favicons, fonts, open-graph images, etc.)
+        const publicCandidate = join(publicDir, relPath);
+        if (existsSync(publicCandidate)) {
+            const stat = statSync(publicCandidate);
+            if (stat.isFile()) {
+                res.setHeader("content-type", contentType);
+                res.setHeader("content-length", stat.size);
+                res.setHeader("cache-control", "public, max-age=3600");
+                if (req.method === "HEAD") {
+                    res.end();
+                    return null;
+                }
+                createReadStream(publicCandidate).pipe(res);
+                return null;
+            }
+        }
+        return undefined;
+    }));
+    // ─── Built-in routes ────────────────────────────────────────────────────────
+    // Rust-powered image optimisation — resize + JPEG encode via `alab-napi`
+    router.get("/_alabjs/image", defineEventHandler((event) => {
+        return handleImageRequest(event.node.req, event.node.res, publicDir);
+    }));
+    // On-demand ISR revalidation
+    router.post("/_alabjs/revalidate", defineEventHandler(async (event) => {
+        const res = event.node.res;
+        res.setHeader("content-type", "application/json");
+        if (!checkRevalidateAuth(event.node.req.headers["authorization"])) {
+            res.statusCode = 401;
+            return JSON.stringify({ error: "Unauthorized. Set Authorization: Bearer <ALAB_REVALIDATE_SECRET>." });
+        }
+        const body = await readBody(event);
+        const result = applyRevalidate(body);
+        if ("error" in result) {
+            res.statusCode = result.status;
+            return JSON.stringify({ error: result.error });
+        }
+        return JSON.stringify(result);
+    }));
+    // Auto sitemap.xml from route manifest
+    router.get("/sitemap.xml", defineEventHandler((event) => {
+        const baseUrl = process.env["PUBLIC_URL"] ??
+            `http://localhost:${process.env["PORT"] ?? "3000"}`;
+        const xml = generateSitemap(manifest.routes, baseUrl);
+        event.node.res.setHeader("content-type", "application/xml; charset=utf-8");
+        event.node.res.setHeader("cache-control", "public, max-age=3600");
+        return xml;
+    }));
+    // ─── API routes (route.ts) ──────────────────────────────────────────────────
+    for (const route of manifest.routes) {
+        if (route.kind !== "api")
+            continue;
+        const h3ApiPath = route.path.replace(/\[([^\]]+)\]/g, ":$1");
+        const apiModulePath = `${distDir}/server/${route.file}`;
+        for (const method of ["get", "post", "put", "patch", "delete", "head"]) {
+            router[method](h3ApiPath, defineEventHandler(async (event) => {
+                const apiMod = await import(apiModulePath);
+                const handler = apiMod[method.toUpperCase()];
+                if (typeof handler !== "function") {
+                    event.node.res.statusCode = 405;
+                    const allowed = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"].filter(m => typeof apiMod[m] === "function").join(", ");
+                    event.node.res.setHeader("allow", allowed);
+                    event.node.res.end("Method Not Allowed");
+                    return;
+                }
+                const req = event.node.req;
+                const chunks = [];
+                await new Promise((ok) => {
+                    req.on("data", (c) => chunks.push(c));
+                    req.on("end", ok);
+                });
+                const body = chunks.length ? Buffer.concat(chunks) : null;
+                const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+                const webReq = new Request(url.toString(), {
+                    method: method.toUpperCase(),
+                    headers: req.headers,
+                    body: body?.length ? body : null,
+                });
+                const webRes = await handler(webReq);
+                const nodeRes = event.node.res;
+                nodeRes.statusCode = webRes.status;
+                webRes.headers.forEach((v, k) => nodeRes.setHeader(k, v));
+                // SSE: pipe the ReadableStream body without buffering.
+                if ((webRes.headers.get("content-type") ?? "").startsWith("text/event-stream") &&
+                    webRes.body) {
+                    const reader = webRes.body.getReader();
+                    nodeRes.on("close", () => { void reader.cancel(); });
+                    try {
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done || nodeRes.destroyed)
+                                break;
+                            nodeRes.write(value);
+                        }
+                    }
+                    catch { /* client disconnected */ }
+                    finally {
+                        nodeRes.end();
+                    }
+                    return;
+                }
+                nodeRes.end(Buffer.from(await webRes.arrayBuffer()));
+            }));
+        }
+    }
+    // ─── Page routes ────────────────────────────────────────────────────────────
+    for (const route of manifest.routes) {
+        if (route.kind !== "page")
+            continue;
+        // Convert Alab path pattern `/users/[id]` → H3 pattern `/users/:id`
+        const h3Path = route.path.replace(/\[([^\]]+)\]/g, ":$1");
+        router.get(h3Path, defineEventHandler(async (event) => {
+            const res = event.node.res;
+            // HTML pages must not be cached by intermediaries — they contain
+            // user-specific CSRF tokens and may reflect auth state.
+            res.setHeader("cache-control", "no-store");
+            // Set CSRF cookie so the client can send it on mutations.
+            const csrfToken = setCsrfCookie(event);
+            const rawParams = (event.context.params ?? {});
+            const params = rawParams;
+            const rawQuery = getQuery(event);
+            const searchParams = {};
+            for (const [k, v] of Object.entries(rawQuery)) {
+                searchParams[k] = Array.isArray(v) ? v[0] ?? "" : v;
+            }
+            // Dynamically import the compiled page module from the dist directory.
+            const pageModulePath = `${distDir}/server/${route.file}`;
+            const mod = await import(pageModulePath);
+            const Page = mod.default;
+            if (typeof Page !== "function") {
+                res.statusCode = 500;
+                res.end(`[alabjs] Page has no default export: ${route.file}`);
+                return;
+            }
+            // Support both static metadata and dynamic generateMetadata (production fix)
+            const metadata = typeof mod.generateMetadata === "function"
+                ? await mod.generateMetadata(params)
+                : (mod.metadata ?? {});
+            const ssrEnabled = mod.ssr === true;
+            // ── Layouts ──────────────────────────────────────────────────────────
+            const layoutRelPaths = findProdLayoutFiles(route.file, distDir);
+            const layoutMods = await Promise.all(layoutRelPaths.map((p) => import(`${distDir}/server/${p}`)));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const layouts = layoutMods.map((m) => m.default).filter((c) => typeof c === "function");
+            const layoutsJson = JSON.stringify(layoutRelPaths);
+            const loadingFile = findProdLoadingFile(route.file, distDir) ?? undefined;
+            // Inject CSRF token into the HTML head so client JS can read it.
+            const headExtra = `<meta name="csrf-token" content="${csrfToken.replace(/"/g, "&quot;")}" />`;
+            try {
+                renderToResponse(res, {
+                    Page: Page,
+                    layouts,
+                    params,
+                    searchParams,
+                    metadata,
+                    routeFile: route.file,
+                    layoutsJson,
+                    loadingFile,
+                    ssr: ssrEnabled,
+                    headExtra,
+                });
+            }
+            catch (err) {
+                // ── error.tsx fallback ────────────────────────────────────────────
+                const errorRelPath = findProdErrorFile(route.file, distDir);
+                if (errorRelPath) {
+                    try {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const errorMod = await import(`${distDir}/server/${errorRelPath}`);
+                        const ErrorPage = errorMod.default;
+                        if (typeof ErrorPage === "function") {
+                            renderToResponse(res, {
+                                Page: ErrorPage,
+                                params,
+                                searchParams,
+                                metadata: {},
+                                routeFile: errorRelPath,
+                                ssr: true,
+                                headExtra,
+                            });
+                            return;
+                        }
+                    }
+                    catch (fallbackErr) {
+                        console.warn(`[alabjs] error.tsx fallback also failed for ${route.file}:`, fallbackErr);
+                        // fall through to plain error
+                    }
+                }
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[alabjs] render error in ${route.file}:`, err);
+                res.statusCode = 500;
+                res.end(`[alabjs] Render error in ${route.file}: ${msg}`);
+            }
+        }));
+    }
+    app.use(router);
+    // ─── 404 / not-found fallback ────────────────────────────────────────────────
+    const notFoundPath = `${distDir}/server/app/not-found.tsx`;
+    app.use(defineEventHandler(async (event) => {
+        const res = event.node.res;
+        res.statusCode = 404;
+        if (existsSync(notFoundPath)) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const nfMod = await import(notFoundPath);
+                const NotFound = nfMod.default;
+                if (typeof NotFound === "function") {
+                    renderToResponse(res, {
+                        Page: NotFound,
+                        params: {},
+                        searchParams: {},
+                        metadata: { title: "404 — Not Found" },
+                        routeFile: "app/not-found.tsx",
+                        ssr: true,
+                    });
+                    return;
+                }
+            }
+            catch (notFoundErr) {
+                console.warn("[alabjs] not-found.tsx render failed:", notFoundErr);
+                // fall through to plain text 404
+            }
+        }
+        res.setHeader("content-type", "text/plain; charset=utf-8");
+        res.end("404 Not Found");
+    }));
+    return {
+        listen(port = 3000) {
+            const server = createServer(toNodeListener(app));
+            server.listen(port, () => {
+                console.log(`  alab  ready at http://localhost:${port}`);
+            });
+        },
+    };
+}
+//# sourceMappingURL=app.js.map

package/dist/server/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"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"}

package/dist/server/cache.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Alab in-process cache for server functions.
+ *
+ * Nothing is cached unless you explicitly opt in — no implicit layers.
+ * You own the key, the TTL, and the invalidation.
+ *
+ * @example
+ * ```ts
+ * // app/posts/[id]/page.server.ts
+ * export const getPost = defineServerFn(
+ *   async ({ params }) => db.posts.findById(params.id),
+ *   { cache: { ttl: 60, tags: ["posts", `post:${params.id}`] } },
+ * );
+ *
+ * // Invalidate from another server function or API route
+ * import { invalidateCache } from "alabjs/cache";
+ * await invalidateCache({ tags: ["posts"] });
+ * ```
+ */
+/** Sentinel value returned when a cache key has no valid entry. */
+declare const CACHE_MISS: unique symbol;
+export { CACHE_MISS };
+/** Retrieve a cached value. Returns `CACHE_MISS` if absent or expired. */
+export declare function getCached(key: string): unknown | typeof CACHE_MISS;
+/** Store a value in the cache with a TTL (seconds) and optional tags. */
+export declare function setCache(key: string, data: unknown, opts: {
+    ttl: number;
+    tags?: string[];
+}): void;
+/**
+ * Invalidate all cache entries that carry at least one of the given tags.
+ *
+ * @example
+ * ```ts
+ * import { invalidateCache } from "alabjs/cache";
+ * await invalidateCache({ tags: ["posts"] });
+ * ```
+ */
+export declare function invalidateCache(opts: {
+    tags: string[];
+}): void;
+/**
+ * Invalidate a specific cache entry by its exact key.
+ * Prefer `invalidateCache({ tags })` for logical invalidation.
+ */
+export declare function invalidateCacheKey(key: string): void;
+/**
+ * Retrieve a cached HTML page. Returns `null` if absent or fully expired
+ * (more than 2× TTL past — serves stale-while-revalidate window).
+ */
+export declare function getCachedPage(pathname: string): {
+    html: string;
+    stale: boolean;
+} | null;
+/** Store a rendered HTML page with a TTL (seconds). */
+export declare function setCachedPage(pathname: string, html: string, ttl: number, tags?: string[]): void;
+/** Mark a page as currently being revalidated to prevent concurrent regen. */
+export declare function markPageRevalidating(pathname: string): void;
+/** Check if a page is currently being revalidated in the background. */
+export declare function isPageRevalidating(pathname: string): boolean;
+/**
+ * Purge a specific page's cached HTML, forcing a fresh render on the next request.
+ *
+ * @example
+ * ```ts
+ * import { revalidatePath } from "alabjs/cache";
+ * await revalidatePath("/posts/1"); // next request regenerates the page
+ * ```
+ */
+export declare function revalidatePath(pathname: string): void;
+/**
+ * Purge all cached pages whose pathname starts with the given prefix.
+ *
+ * @example
+ * ```ts
+ * await revalidatePath("/posts"); // clears /posts, /posts/1, /posts/2, ...
+ * ```
+ */
+export declare function revalidatePathPrefix(prefix: string): void;
+/**
+ * Purge all server-function cache entries AND page HTML cache entries
+ * that carry at least one of the given tags.
+ *
+ * @example
+ * ```ts
+ * import { revalidateTag } from "alabjs/cache";
+ * revalidateTag({ tags: ["posts"] }); // clears both data and page caches
+ * ```
+ */
+export declare function revalidateTag(opts: {
+    tags: string[];
+}): void;
+/** Return a snapshot of all live cache entries (for the dev Cache Inspector). */
+export declare function inspectCache(): Array<{
+    key: string;
+    tags: string[];
+    expiresIn: number;
+}>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/server/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/server/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,mEAAmE;AACnE,QAAA,MAAM,UAAU,EAAE,OAAO,MAAkC,CAAC;AAK5D,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,UAAU,CAQlE;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrC,IAAI,CAMN;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAM9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpD;AAeD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAavF;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI,CAEpG;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG3D;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAIzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAS5D;AAED,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,KAAK,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CASD"}