alabjs 0.2.6 → 0.4.0

package/dist/components/ImageServer.js

@@ -0,0 +1,37 @@
+/**
+ * Server-only image utilities.
+ *
+ * Import from "alabjs/components/server" — do NOT import from "alabjs/components"
+ * because this file uses Node.js built-ins (fs, path) and must never be bundled
+ * for the browser.
+ */
+/**
+ * Generate a Base64 blur-up placeholder for an image in `public/`.
+ *
+ * Calls the Rust napi binding to resize the image to 8px wide and encode it
+ * as a tiny WebP, then Base64-encodes it into a data URL ready for `blurDataURL`.
+ *
+ * Run this in a server function — it reads from disk and must not run in the browser.
+ *
+ * @param src - Path relative to `public/` (e.g. `"/hero.jpg"`)
+ * @param publicDir - Absolute path to the `public/` directory
+ */
+export async function generateBlurPlaceholder(src, publicDir) {
+    const { readFile } = await import("node:fs/promises");
+    const { resolve } = await import("node:path");
+    const safeSrc = src.replace(/\.\./g, "").replace(/^\/+/, "");
+    const filePath = resolve(publicDir, safeSrc);
+    const input = await readFile(filePath);
+    let napi;
+    try {
+        napi = (await import("@alabjs/compiler"));
+    }
+    catch {
+        // napi not built — return empty string (image still loads, just no blur effect)
+        return "";
+    }
+    const tiny = await napi.optimizeImage(input, 40, 8, null, "webp");
+    const b64 = Buffer.from(tiny).toString("base64");
+    return `data:image/webp;base64,${b64}`;
+}
+//# sourceMappingURL=ImageServer.js.map

package/dist/components/ImageServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageServer.js","sourceRoot":"","sources":["../../src/components/ImageServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAW,EACX,SAAiB;IAEjB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACtD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,IAAiH,CAAC;IACtH,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAgB,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,0BAA0B,GAAG,EAAE,CAAC;AACzC,CAAC"}

package/dist/components/Link.d.ts

@@ -4,6 +4,14 @@ export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
     /** Prefetch the target page on hover (default: true). */
     prefetch?: boolean;
 }
+export interface RouteLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    /** The destination path. Narrows to AlabRoutes when routes.d.ts is included. */
+    to: string;
+    /** Replace the current history entry instead of pushing a new one. */
+    replace?: boolean;
+    /** Prefetch the target page on hover (default: true). */
+    prefetch?: boolean;
+}
 declare global {
     interface Window {
         __alabjs_navigate?: (href: string) => Promise<void>;
@@ -20,4 +28,12 @@ declare global {
  * background so the browser caches it before the user clicks.
  */
 export declare function Link({ href, children, prefetch, onClick, ...rest }: LinkProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Type-safe navigation link.
+ *
+ * Identical to `<Link>` but uses a `to` prop instead of `href`.
+ * When `.alabjs/routes.d.ts` is included in your tsconfig, the `to` prop
+ * is narrowed to the `AlabRoutes` union so typos become build errors.
+ */
+export declare function RouteLink({ to, replace: _replace, ...rest }: RouteLinkProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Link.d.ts.map

package/dist/components/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAc,MAAM,OAAO,CAAC;AAE9D,MAAM,WAAW,SAAU,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrD;CACF;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAe,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,2CAuCpF"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAc,MAAM,OAAO,CAAC;AAE9D,MAAM,WAAW,SAAU,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3F,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrD;CACF;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAe,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,2CAuCpF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,cAAc,2CAE3E"}

package/dist/components/Link.js

@@ -45,4 +45,14 @@ export function Link({ href, children, prefetch = true, onClick, ...rest }) {
         : undefined;
     return (_jsx("a", { href: href, onClick: handleClick, onMouseEnter: handleMouseEnter, ...rest, children: children }));
 }
+/**
+ * Type-safe navigation link.
+ *
+ * Identical to `<Link>` but uses a `to` prop instead of `href`.
+ * When `.alabjs/routes.d.ts` is included in your tsconfig, the `to` prop
+ * is narrowed to the `AlabRoutes` union so typos become build errors.
+ */
+export function RouteLink({ to, replace: _replace, ...rest }) {
+    return _jsx(Link, { href: to, ...rest });
+}
 //# sourceMappingURL=Link.js.map

package/dist/components/Link.js.map

@@ -1 +1 @@
-{"version":3,"file":"Link.js","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":";AAcA;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAa;IACnF,MAAM,YAAY,GAAG,CAAC,GAAW,EAAW,EAAE;QAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,CAAgC,EAAE,EAAE;QAC7D,oEAAoE;QACpE,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO;QAC7D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO;QAEhC,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAEb,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YACnD,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,QAAQ;QAC/B,CAAC,CAAC,GAAG,EAAE;YACH,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;gBACnD,8DAA8D;gBAC9D,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAiB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,CACL,YAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,KAAM,IAAI,YAC1E,QAAQ,GACP,CACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"Link.js","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":";AAuBA;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAa;IACnF,MAAM,YAAY,GAAG,CAAC,GAAW,EAAW,EAAE;QAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,CAAgC,EAAE,EAAE;QAC7D,oEAAoE;QACpE,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO;QAC7D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO;QAEhC,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAEb,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YACnD,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,QAAQ;QAC/B,CAAC,CAAC,GAAG,EAAE;YACH,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;gBACnD,8DAA8D;gBAC9D,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAiB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,CACL,YAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,KAAM,IAAI,YAC1E,QAAQ,GACP,CACL,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAkB;IAC1E,OAAO,KAAC,IAAI,IAAC,IAAI,EAAE,EAAE,KAAM,IAAI,GAAI,CAAC;AACtC,CAAC"}

package/dist/components/index.d.ts

@@ -1,7 +1,7 @@
-export { Image, generateBlurPlaceholder } from "./Image.js";
+export { Image } from "./Image.js";
 export type { ImageProps } from "./Image.js";
-export { Link } from "./Link.js";
-export type { LinkProps } from "./Link.js";
+export { Link, RouteLink } from "./Link.js";
+export type { LinkProps, RouteLinkProps } from "./Link.js";
 export { ErrorBoundary } from "./ErrorBoundary.js";
 export { Script } from "./Script.js";
 export type { ScriptProps } from "./Script.js";

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/index.js

@@ -1,5 +1,5 @@
-export { Image, generateBlurPlaceholder } from "./Image.js";
-export { Link } from "./Link.js";
+export { Image } from "./Image.js";
+export { Link, RouteLink } from "./Link.js";
 export { ErrorBoundary } from "./ErrorBoundary.js";
 export { Script } from "./Script.js";
 export { Font } from "./Font.js";

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/live/broadcaster.d.ts

@@ -0,0 +1,64 @@
+/**
+ * In-process tag-based pub/sub broadcaster for live components.
+ *
+ * Each SSE connection subscribes to the tags returned by its component's
+ * `liveTags(props)` export. When `invalidateLive({ tags })` is called from
+ * anywhere on the server (route handler, webhook, cron job), every matching
+ * subscriber is notified and re-renders its HTML fragment over SSE.
+ *
+ * Current implementation: plain Node.js `EventEmitter` — zero dependencies,
+ * zero config, works for any single-process deployment (Railway, Fly.io,
+ * Render, Heroku — single dyno/instance covers the vast majority of use cases).
+ *
+ * ─── Redis adapter (ON HOLD) ──────────────────────────────────────────────────
+ * Multi-instance deployments (PM2 cluster, multiple replicas behind a load
+ * balancer) need cross-process pub/sub: `invalidateLive` called on instance A
+ * must wake SSE connections on instances B and C.
+ *
+ * A Redis adapter is planned but intentionally deferred:
+ *  - Most alab apps run single-instance and would pay Redis cost for no benefit
+ *  - Vertical scaling (bigger machine) handles serious load before needing replicas
+ *  - The interface here (`subscribeToTag` / `broadcastTag`) is already the right
+ *    abstraction; swapping the backend is a ~20-line change when needed
+ *
+ * When it ships it will be an optional package:
+ *
+ * ```ts
+ * // alabjs.config.ts
+ * import { redisBroadcaster } from "@alabjs/broadcaster-redis";
+ *
+ * export default defineConfig({
+ *   live: { broadcaster: redisBroadcaster({ url: process.env.REDIS_URL }) },
+ * });
+ * ```
+ *
+ * Tracking issue: https://github.com/alab-framework/alab/issues — search
+ * "broadcaster-redis" to follow progress or upvote.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+/**
+ * Subscribe a callback to a specific tag.
+ *
+ * @returns An unsubscribe function — call it on SSE client disconnect.
+ */
+export declare function subscribeToTag(tag: string, callback: () => void): () => void;
+/**
+ * Broadcast a tag change to all live SSE connections subscribed to it.
+ */
+export declare function broadcastTag(tag: string): void;
+/**
+ * Invalidate live components by tag.
+ *
+ * Triggers an immediate re-render push for every SSE connection subscribed
+ * to any of the given tags. Called from route handlers, webhooks, cron jobs,
+ * or the existing `/_alabjs/revalidate` endpoint.
+ *
+ * ```ts
+ * import { invalidateLive } from "alabjs/server";
+ * await invalidateLive({ tags: ["stock:AAPL", "stock:GOOG"] });
+ * ```
+ */
+export declare function invalidateLive(opts: {
+    tags: string[];
+}): Promise<void>;
+//# sourceMappingURL=broadcaster.d.ts.map

package/dist/live/broadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcaster.d.ts","sourceRoot":"","sources":["../../src/live/broadcaster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAWH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAI5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5E"}

package/dist/live/broadcaster.js

@@ -0,0 +1,78 @@
+/**
+ * In-process tag-based pub/sub broadcaster for live components.
+ *
+ * Each SSE connection subscribes to the tags returned by its component's
+ * `liveTags(props)` export. When `invalidateLive({ tags })` is called from
+ * anywhere on the server (route handler, webhook, cron job), every matching
+ * subscriber is notified and re-renders its HTML fragment over SSE.
+ *
+ * Current implementation: plain Node.js `EventEmitter` — zero dependencies,
+ * zero config, works for any single-process deployment (Railway, Fly.io,
+ * Render, Heroku — single dyno/instance covers the vast majority of use cases).
+ *
+ * ─── Redis adapter (ON HOLD) ──────────────────────────────────────────────────
+ * Multi-instance deployments (PM2 cluster, multiple replicas behind a load
+ * balancer) need cross-process pub/sub: `invalidateLive` called on instance A
+ * must wake SSE connections on instances B and C.
+ *
+ * A Redis adapter is planned but intentionally deferred:
+ *  - Most alab apps run single-instance and would pay Redis cost for no benefit
+ *  - Vertical scaling (bigger machine) handles serious load before needing replicas
+ *  - The interface here (`subscribeToTag` / `broadcastTag`) is already the right
+ *    abstraction; swapping the backend is a ~20-line change when needed
+ *
+ * When it ships it will be an optional package:
+ *
+ * ```ts
+ * // alabjs.config.ts
+ * import { redisBroadcaster } from "@alabjs/broadcaster-redis";
+ *
+ * export default defineConfig({
+ *   live: { broadcaster: redisBroadcaster({ url: process.env.REDIS_URL }) },
+ * });
+ * ```
+ *
+ * Tracking issue: https://github.com/alab-framework/alab/issues — search
+ * "broadcaster-redis" to follow progress or upvote.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+import { EventEmitter } from "node:events";
+// One emitter per process — all SSE handlers share it.
+const _emitter = new EventEmitter();
+// Prevent Node.js MaxListenersExceededWarning on pages with many live components.
+_emitter.setMaxListeners(0);
+const TAG_EVENT_PREFIX = "live:tag:";
+/**
+ * Subscribe a callback to a specific tag.
+ *
+ * @returns An unsubscribe function — call it on SSE client disconnect.
+ */
+export function subscribeToTag(tag, callback) {
+    const event = TAG_EVENT_PREFIX + tag;
+    _emitter.on(event, callback);
+    return () => _emitter.off(event, callback);
+}
+/**
+ * Broadcast a tag change to all live SSE connections subscribed to it.
+ */
+export function broadcastTag(tag) {
+    _emitter.emit(TAG_EVENT_PREFIX + tag);
+}
+/**
+ * Invalidate live components by tag.
+ *
+ * Triggers an immediate re-render push for every SSE connection subscribed
+ * to any of the given tags. Called from route handlers, webhooks, cron jobs,
+ * or the existing `/_alabjs/revalidate` endpoint.
+ *
+ * ```ts
+ * import { invalidateLive } from "alabjs/server";
+ * await invalidateLive({ tags: ["stock:AAPL", "stock:GOOG"] });
+ * ```
+ */
+export async function invalidateLive(opts) {
+    for (const tag of opts.tags) {
+        broadcastTag(tag);
+    }
+}
+//# sourceMappingURL=broadcaster.js.map

package/dist/live/broadcaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcaster.js","sourceRoot":"","sources":["../../src/live/broadcaster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,uDAAuD;AACvD,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;AACpC,kFAAkF;AAClF,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAE5B,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAAoB;IAC9D,MAAM,KAAK,GAAG,gBAAgB,GAAG,GAAG,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAwB;IAC3D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,YAAY,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/live/registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Live component registry.
+ *
+ * At server startup, `createApp` scans `dist/server/**\/*.live.js`, imports
+ * each module, reads the `liveInterval` and `liveTags` exports, and calls
+ * `registerLiveComponent()`. The SSE endpoint then looks up entries here.
+ */
+export interface LiveComponentEntry {
+    /** Stable FNV-1a hash of the original source module path (16 hex chars). */
+    id: string;
+    /** Absolute path to the compiled `.live.js` file in dist/server. */
+    modulePath: string;
+    /**
+     * Re-render interval in milliseconds.
+     * Set via `export const liveInterval = 5000` in the live component file.
+     * When undefined, the component only updates on tag invalidation.
+     */
+    liveInterval?: number;
+    /**
+     * Function that returns cache tags for a given props object.
+     * Set via `export const liveTags = (props) => [\`stock:\${props.ticker}\`]`.
+     * When undefined, the component is not subscribed to tag broadcasts.
+     */
+    liveTags?: (props: unknown) => string[];
+}
+export declare function registerLiveComponent(entry: LiveComponentEntry): void;
+export declare function getLiveComponent(id: string): LiveComponentEntry | undefined;
+/** Return all entries whose `liveTags(props)` includes the given tag. */
+export declare function getLiveComponentsByTag(tag: string): Array<{
+    entry: LiveComponentEntry;
+    props: unknown;
+}>;
+export declare function registrySize(): number;
+//# sourceMappingURL=registry.d.ts.map

package/dist/live/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/live/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;CACzC;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAErE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE3E;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAaxG;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/live/registry.js

@@ -0,0 +1,33 @@
+/**
+ * Live component registry.
+ *
+ * At server startup, `createApp` scans `dist/server/**\/*.live.js`, imports
+ * each module, reads the `liveInterval` and `liveTags` exports, and calls
+ * `registerLiveComponent()`. The SSE endpoint then looks up entries here.
+ */
+const _registry = new Map();
+export function registerLiveComponent(entry) {
+    _registry.set(entry.id, entry);
+}
+export function getLiveComponent(id) {
+    return _registry.get(id);
+}
+/** Return all entries whose `liveTags(props)` includes the given tag. */
+export function getLiveComponentsByTag(tag) {
+    // This is called by the broadcaster when a tag is invalidated.
+    // Each SSE connection registers itself with the tag broadcaster directly,
+    // so this function is used only for discovery — not for fan-out.
+    const results = [];
+    for (const entry of _registry.values()) {
+        if (entry.liveTags) {
+            // We don't know props here — tag matching is handled per-connection
+            // in the SSE handler via subscribeToTag.
+            results.push({ entry, props: undefined });
+        }
+    }
+    return results;
+}
+export function registrySize() {
+    return _registry.size;
+}
+//# sourceMappingURL=registry.js.map

package/dist/live/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/live/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;AAExD,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,+DAA+D;IAC/D,0EAA0E;IAC1E,iEAAiE;IACjE,MAAM,OAAO,GAAyD,EAAE,CAAC;IACzE,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,oEAAoE;YACpE,yCAAyC;YACzC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC"}

package/dist/live/renderer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Server-side HTML fragment renderer for live components.
+ *
+ * Uses `renderToStaticMarkup` (not `renderToPipeableStream`) because:
+ *   - The SSE update path does a raw DOM swap — no React hydration needed.
+ *   - Synchronous output fits the push model.
+ *   - No `data-reactroot` attributes in the fragment (smaller payload).
+ */
+/**
+ * Render a live component to an HTML fragment string.
+ *
+ * @param modulePath - Absolute path to the compiled `.live.js` module.
+ * @param props      - Props to pass to the component (from the SSE query string).
+ * @returns          - Raw HTML string (no wrapping element).
+ */
+export declare function renderLiveFragment(modulePath: string, props: unknown): Promise<string>;
+/**
+ * FNV-1a 64-bit content hash of an HTML string.
+ * Used to suppress no-op SSE pushes when the rendered output hasn't changed.
+ */
+export declare function hashFragment(html: string): string;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/live/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/live/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD"}

package/dist/live/renderer.js

@@ -0,0 +1,45 @@
+/**
+ * Server-side HTML fragment renderer for live components.
+ *
+ * Uses `renderToStaticMarkup` (not `renderToPipeableStream`) because:
+ *   - The SSE update path does a raw DOM swap — no React hydration needed.
+ *   - Synchronous output fits the push model.
+ *   - No `data-reactroot` attributes in the fragment (smaller payload).
+ */
+import { createElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+/**
+ * Render a live component to an HTML fragment string.
+ *
+ * @param modulePath - Absolute path to the compiled `.live.js` module.
+ * @param props      - Props to pass to the component (from the SSE query string).
+ * @returns          - Raw HTML string (no wrapping element).
+ */
+export async function renderLiveFragment(modulePath, props) {
+    // Dynamic import — Node's module cache means repeated calls for the same
+    // module path are effectively free after the first load.
+    const mod = await import(modulePath);
+    const Component = mod.default;
+    if (typeof Component !== "function") {
+        throw new Error(`[alabjs] live component at ${modulePath} has no default export`);
+    }
+    // renderToStaticMarkup handles async components (React 19+).
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const html = renderToStaticMarkup(createElement(Component, props));
+    return html;
+}
+/**
+ * FNV-1a 64-bit content hash of an HTML string.
+ * Used to suppress no-op SSE pushes when the rendered output hasn't changed.
+ */
+export function hashFragment(html) {
+    const FNV_OFFSET = 14695981039346656037n;
+    const FNV_PRIME = 1099511628211n;
+    let hash = FNV_OFFSET;
+    for (let i = 0; i < html.length; i++) {
+        hash ^= BigInt(html.charCodeAt(i));
+        hash = BigInt.asUintN(64, hash * FNV_PRIME);
+    }
+    return hash.toString(16).padStart(16, "0");
+}
+//# sourceMappingURL=renderer.js.map

package/dist/live/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/live/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,KAAc;IAEd,yEAAyE;IACzE,yDAAyD;IACzD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAA0B,CAAC;IAC9D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;IAE9B,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,8BAA8B,UAAU,wBAAwB,CACjE,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,8DAA8D;IAC9D,MAAM,IAAI,GAAG,oBAAoB,CAAC,aAAa,CAAC,SAAgB,EAAE,KAAY,CAAC,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,UAAU,GAAG,qBAA2B,CAAC;IAC/C,MAAM,SAAS,GAAG,cAAkB,CAAC;IACrC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/router/manifest.d.ts

@@ -1,4 +1,4 @@
-export type RouteKind = "page" | "server" | "layout" | "error" | "loading" | "api";
+export type RouteKind = "page" | "server" | "layout" | "error" | "loading" | "api" | "live";
 export interface Route {
     path: string;
     file: string;

package/dist/router/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/router/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;AAEnF,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/router/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5F,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}

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

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA6D3D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAoiB3E"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAqI3D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAiyB3E"}