@anaemia/core 0.3.7 → 0.5.0

package/dist/runtime/server/render-request.jsx

@@ -0,0 +1,170 @@
+import { Router } from "@solidjs/router";
+import { renderToStream } from "solid-js/web";
+import { ssrStorage } from "../context.js";
+import { LOADER_DATA_KEY } from "../shared/constants.js";
+import { setDevResponseCacheHeaders } from "./assets.js";
+import { runGuards } from "./guards.js";
+import { createDevNoCacheHeadTags, createHtmlStreamShell, getRouteAssetTags } from "./html.js";
+import { createHydrationDataScript, createHydrationRuntimeScript } from "./hydration.js";
+import { matchRoute } from "./route-match.js";
+const staticCache = new Map();
+function renderApp(App, url) {
+    return renderToStream(() => (<Router url={url}>
+      <App />
+    </Router>));
+}
+async function render500(args) {
+    const error500Pattern = args.manifest.errors?.["500"];
+    if (!error500Pattern) {
+        const stack = args.error instanceof Error ? args.error.stack : String(args.error);
+        return `<h1>500 Internal Server Error</h1><pre>${args.env.isDev ? stack : ""}</pre>`;
+    }
+    const error500Loader = args.serverLoaderRegistry.get(error500Pattern);
+    if (error500Loader) {
+        const message = args.error instanceof Error ? args.error.message : String(args.error);
+        const stack = args.error instanceof Error ? args.error.stack : undefined;
+        args.store.set(LOADER_DATA_KEY, { message, stack: args.env.isDev ? stack : undefined });
+        try {
+            return await ssrStorage.run(args.store, async () => renderApp(args.App, error500Pattern));
+        }
+        catch {
+            return `<h1>500 Internal Server Error</h1>`;
+        }
+    }
+    const stack = args.error instanceof Error ? args.error.stack : String(args.error);
+    return `<h1>500 Internal Server Error</h1><pre>${args.env.isDev ? stack : ""}</pre>`;
+}
+function createHtmlResponseStream(args) {
+    const encoder = new TextEncoder();
+    const collected = [];
+    const shouldCollect = Boolean(args.onComplete);
+    return new ReadableStream({
+        start(controller) {
+            const enqueue = (chunk) => {
+                if (shouldCollect)
+                    collected.push(chunk);
+                controller.enqueue(encoder.encode(chunk));
+            };
+            enqueue(args.beforeEntry);
+            if (typeof args.renderStream === "string") {
+                enqueue(args.renderStream);
+                const after = args.afterEntry();
+                enqueue(after);
+                args.onComplete?.(collected.join(""));
+                controller.close();
+                return;
+            }
+            const renderStream = args.renderStream;
+            const writable = new WritableStream({
+                write(chunk) {
+                    enqueue(chunk);
+                },
+                close() {
+                    const after = args.afterEntry();
+                    enqueue(after);
+                    args.onComplete?.(collected.join(""));
+                    controller.close();
+                },
+                abort(error) {
+                    controller.error(error);
+                },
+            });
+            void ssrStorage
+                .run(args.store, async () => {
+                await renderStream.pipeTo(writable);
+            })
+                .catch((error) => {
+                controller.error(error);
+            });
+        },
+    });
+}
+export function createRenderRequestHandler(options) {
+    return async (c) => {
+        if (options.env.isDev)
+            await options.loadManifestAndTemplate();
+        const { template, manifest, sortedRoutes, staticRoutes, loaderRoutes, guardRoutes } = options.getManifestSnapshot();
+        if (!template || !manifest) {
+            return c.text("anaemia engine error: build assets are missing", 500);
+        }
+        const reqPath = c.req.path;
+        const { activeChunk, targetPattern, statusCode: matchedStatus, params, } = matchRoute(manifest, reqPath, sortedRoutes);
+        let statusCode = matchedStatus;
+        const loaderArgs = { params, request: c.req.raw };
+        const store = ssrStorage.getStore() || new Map();
+        let renderStream;
+        const isStaticRoute = !options.env.isDev && staticRoutes.has(targetPattern);
+        // serve from cache before doing any work
+        if (isStaticRoute) {
+            const cached = staticCache.get(reqPath);
+            if (cached) {
+                c.header("Content-Type", "text/html; charset=UTF-8");
+                c.header("X-Anaemia-Cache", "HIT");
+                return c.html(cached, statusCode);
+            }
+        }
+        if (targetPattern && guardRoutes.has(targetPattern)) {
+            try {
+                const guardResult = await runGuards(options.serverGuardRegistry, targetPattern, {
+                    params,
+                    request: c.req.raw,
+                    url: reqPath,
+                });
+                if (guardResult) {
+                    if ("redirect" in guardResult) {
+                        return c.redirect(guardResult.redirect, (guardResult.status ?? 302));
+                    }
+                    if ("status" in guardResult)
+                        statusCode = guardResult.status;
+                }
+            }
+            catch (err) {
+                console.error("[anaemia] guard threw unexpectedly:", err);
+                return c.text("Internal Server Error", 500);
+            }
+        }
+        try {
+            renderStream = await ssrStorage.run(store, async () => {
+                if (targetPattern && loaderRoutes.has(targetPattern)) {
+                    const executableLoader = options.serverLoaderRegistry.get(targetPattern);
+                    if (executableLoader) {
+                        const initialLoaderData = await executableLoader(loaderArgs);
+                        store.set(LOADER_DATA_KEY, initialLoaderData);
+                    }
+                }
+                await options.preloadActiveClientRoute(reqPath);
+                return renderApp(options.App, reqPath);
+            });
+        }
+        catch (err) {
+            statusCode = 500;
+            console.error("[anaemia framework] runtime execution crash handled:", err);
+            renderStream = await render500({
+                App: options.App,
+                error: err,
+                env: options.env,
+                manifest,
+                serverLoaderRegistry: options.serverLoaderRegistry,
+                store,
+            });
+        }
+        const routeAssetTags = getRouteAssetTags(manifest, activeChunk);
+        const headInjections = `${createDevNoCacheHeadTags(options.env.isDev)}${routeAssetTags.styles}${createHydrationRuntimeScript()}`;
+        const shell = createHtmlStreamShell({ template, headInjections, bodyInjections: "" });
+        setDevResponseCacheHeaders(c, options.env);
+        c.status(statusCode);
+        c.header("Content-Type", "text/html; charset=UTF-8");
+        return c.body(createHtmlResponseStream({
+            beforeEntry: shell.beforeEntry,
+            renderStream,
+            afterEntry: () => {
+                const bodyInjections = `${createHydrationDataScript(store)}${routeAssetTags.scripts}`;
+                return shell.afterEntry.includes("</body>")
+                    ? shell.afterEntry.replace("</body>", `${bodyInjections}</body>`)
+                    : `${shell.afterEntry}${bodyInjections}`;
+            },
+            store,
+            onComplete: isStaticRoute ? (html) => staticCache.set(reqPath, html) : undefined,
+        }));
+    };
+}

package/dist/runtime/server/route-match.d.ts

@@ -0,0 +1,14 @@
+import type { RouteManifest, RouteMatch } from "./types.js";
+type SortedRoute = RouteManifest["routes"][number];
+export declare function sortRoutes(routes: RouteManifest["routes"]): SortedRoute[];
+export declare function matchRoute(manifest: RouteManifest, reqPath: string, sortedRoutes?: {
+    urlPattern: string;
+    chunkName: string;
+    params: string[];
+    isStatic: boolean;
+    hasLoader: boolean;
+    hasGuard: boolean;
+    serverFunctionIds: string[];
+}[]): RouteMatch;
+export {};
+//# sourceMappingURL=route-match.d.ts.map

package/dist/runtime/server/route-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-match.d.ts","sourceRoot":"","sources":["../../../src/runtime/server/route-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,KAAK,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAWnD,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,WAAW,EAAE,CAEzE;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,YAAY;;;;;;;;GAA8B,GACzC,UAAU,CAuBZ"}

package/dist/runtime/server/route-match.js

@@ -0,0 +1,35 @@
+function scoreRoutePattern(pattern) {
+    const segments = pattern.split("/").filter(Boolean);
+    return segments.reduce((acc, segment) => {
+        if (segment.startsWith(":"))
+            return acc - 1;
+        if (segment === "*" || segment.startsWith("*"))
+            return acc - 2;
+        return acc;
+    }, segments.length * 10);
+}
+export function sortRoutes(routes) {
+    return [...routes].sort((a, b) => scoreRoutePattern(b.urlPattern) - scoreRoutePattern(a.urlPattern));
+}
+export function matchRoute(manifest, reqPath, sortedRoutes = sortRoutes(manifest.routes)) {
+    for (const route of sortedRoutes) {
+        const regexStr = route.urlPattern
+            .replace(/:([a-zA-Z0-9_-]+)/g, "(?<$1>[^/]+)")
+            .replace(/\*([a-zA-Z0-9_-]*)/g, "(?<catchall>.*)");
+        const match = new RegExp(`^${regexStr}$`).exec(reqPath);
+        if (match) {
+            return {
+                activeChunk: route.chunkName,
+                targetPattern: route.urlPattern,
+                statusCode: 200,
+                params: match.groups ? { ...match.groups } : {},
+            };
+        }
+    }
+    return {
+        activeChunk: "route-404",
+        targetPattern: manifest.errors?.["404"] || "",
+        statusCode: 404,
+        params: {},
+    };
+}

package/dist/runtime/server/rpc.d.ts

@@ -0,0 +1,3 @@
+import type { Hono } from "hono";
+export declare function registerRpcRoute(app: Hono): void;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/runtime/server/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../src/runtime/server/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,QA6BzC"}

package/dist/runtime/server/rpc.js

@@ -0,0 +1,32 @@
+import { serverFunctionsRegistry } from "../context.js";
+import { RPC_PATH } from "../shared/constants.js";
+export function registerRpcRoute(app) {
+    app.post(RPC_PATH, async (c) => {
+        const functionId = c.req.query("id");
+        if (!functionId || !serverFunctionsRegistry.has(functionId)) {
+            return c.json({ error: "RPC function not found" }, 404);
+        }
+        const contentLength = Number(c.req.header("content-length") ?? 0);
+        if (contentLength > 512_000) {
+            return c.json({ error: "Payload too large" }, 413);
+        }
+        let argumentsArray;
+        try {
+            const body = await c.req.json();
+            if (!Array.isArray(body))
+                throw new Error("Expected array");
+            argumentsArray = body;
+        }
+        catch {
+            return c.json({ error: "Invalid request body" }, 400);
+        }
+        try {
+            const result = await serverFunctionsRegistry.get(functionId)(...argumentsArray);
+            return c.json(result);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Internal server error";
+            return c.json({ error: message }, 500);
+        }
+    });
+}

package/dist/runtime/server/types.d.ts

@@ -0,0 +1,33 @@
+import type { StatusCode } from "hono/utils/http-status";
+export interface ChunkAssets {
+    js?: string[];
+    css?: string[];
+}
+export type RouteManifest = {
+    routes: Array<{
+        urlPattern: string;
+        chunkName: string;
+        params: string[];
+        isStatic: boolean;
+        hasLoader: boolean;
+        hasGuard: boolean;
+        serverFunctionIds: string[];
+    }>;
+    chunks: Record<string, ChunkAssets>;
+    errors?: Record<string, string>;
+};
+export type RouteMatch = {
+    activeChunk: string;
+    targetPattern: string;
+    statusCode: StatusCode;
+    params: Record<string, string>;
+};
+export type RuntimeEnv = {
+    port: number;
+    isDev: boolean;
+    devServerUrl: string;
+    templatePath: string;
+    manifestPath: string;
+    clientDistPath: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,KAAK,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;QAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC,CAAC;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/dist/runtime/server/types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/shared/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const ANAEMIA_DATA_SCRIPT_ID = "__ANAEMIA_DATA__";
+export declare const ENTRY_SELECTOR = "[anaemia-entry]";
+export declare const ENTRY_ATTRIBUTE = "anaemia-entry";
+export declare const HONO_CONTEXT_KEY = "honoContext";
+export declare const LOADER_DATA_KEY = "__LOADER_DATA__";
+export declare const RPC_PATH = "/_rpc";
+export declare const SERVER_FUNCTION_DATA_KEY = "__SERVER_FUNCTION_DATA__";
+//# sourceMappingURL=constants.d.ts.map

package/dist/runtime/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAChD,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAC/C,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,wBAAwB,6BAA6B,CAAC"}

package/dist/runtime/shared/constants.js

@@ -0,0 +1,7 @@
+export const ANAEMIA_DATA_SCRIPT_ID = "__ANAEMIA_DATA__";
+export const ENTRY_SELECTOR = "[anaemia-entry]";
+export const ENTRY_ATTRIBUTE = "anaemia-entry";
+export const HONO_CONTEXT_KEY = "honoContext";
+export const LOADER_DATA_KEY = "__LOADER_DATA__";
+export const RPC_PATH = "/_rpc";
+export const SERVER_FUNCTION_DATA_KEY = "__SERVER_FUNCTION_DATA__";

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxF,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAExL;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhG,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErJ,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/T,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG;IAClG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxF,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CACnH,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,KACrB,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhG,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,SAAS,GACT;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,KACG,IAAI,GACJ,SAAS,GACT;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,OAAO,CAAC,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtH,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG;IAClG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anaemia/core",
-  "version": "0.3.7",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,6 +28,10 @@
       "types": "./dist/plugins/index.d.ts",
       "import": "./dist/plugins/index.js"
     },
+    "./client": {
+      "types": "./anaemia.d.ts",
+      "default": "./anaemia.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
@@ -36,6 +40,12 @@
     "@solidjs/router": "^0.16.1",
     "hono": "^4.12.23"
   },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/node": "^25.9.1",
+    "jiti": "^2.7.0",
+    "playwright": "^1.60.0"
+  },
   "peerDependencies": {
     "@rspack/core": "*",
     "lightningcss": "^1.32.0",
@@ -49,12 +59,6 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@types/babel__core": "^7.20.5",
-    "@types/node": "^25.9.1",
-    "jiti": "^2.7.0",
-    "playwright": "^1.60.0"
-  },
   "scripts": {
     "build": "tsc",
     "test": "pnpm run build && node --test test/*.test.mjs",

package/src/anaemia.d.ts

@@ -0,0 +1,75 @@
+/// <reference types="@rspack/core/module" />
+
+// asset imports
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+declare module "*.jpeg" {
+  const src: string;
+  export default src;
+}
+declare module "*.gif" {
+  const src: string;
+  export default src;
+}
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+declare module "*.avif" {
+  const src: string;
+  export default src;
+}
+declare module "*.ico" {
+  const src: string;
+  export default src;
+}
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+// query suffixes
+declare module "*?raw" {
+  const content: string;
+  export default content;
+}
+declare module "*?url" {
+  const src: string;
+  export default src;
+}
+declare module "*?inline" {
+  const src: string;
+  export default src;
+}
+
+// CSS modules
+declare module "*.module.css" {
+  const classes: Record<string, string>;
+  export default classes;
+}
+declare module "*.module.scss" {
+  const classes: Record<string, string>;
+  export default classes;
+}
+declare module "*.module.sass" {
+  const classes: Record<string, string>;
+  export default classes;
+}
+
+// import.meta.env
+interface ImportMetaEnv {
+  readonly MODE: string;
+  readonly DEV: boolean;
+  readonly PROD: boolean;
+  readonly [key: string]: string | boolean | undefined;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/src/config.ts

@@ -45,6 +45,14 @@ export interface AnaemiaConfig {
   styles?: {
     sass?: boolean;
     modules?: boolean;
+
+    /**
+     * customize the generated CSS module class names.
+     * defaults to "[name]__[local]__[hash:base64:5]" in both development and production
+     * for readable, themeable class names. Set to "[hash:base64:8]" if you prefer
+     * fully hashed production output and don't need external theme support.
+     */
+    modulesLocalIdentName?: string;
   };
   experimental?: {
     outputModule?: boolean;
@@ -63,7 +71,7 @@ export interface AnaemiaConfig {
    *   client: { __APP_VERSION__: JSON.stringify("1.0.0") },
    *   server: { __DB_POOL_SIZE__: "10" }
    * }
-  */
+   */
   define?: {
     client?: Record<string, string>;
     server?: Record<string, string>;

package/src/index.ts

@@ -5,4 +5,12 @@ export { RouteDataController, useRouteData } from "./runtime/route-data.js";
 export { $$executeClientRpc } from "./runtime/rpc-client.js";
 export { createServerResource } from "./runtime/resources.js";
 
-export type { LoaderArgs, LoaderFunction, InferServerData, GuardContext, GuardResult, GuardFn, ServerFunction } from "./types.js";
+export type {
+  LoaderArgs,
+  LoaderFunction,
+  InferServerData,
+  GuardContext,
+  GuardResult,
+  GuardFn,
+  ServerFunction,
+} from "./types.js";

package/src/plugins/index.ts

@@ -1 +1 @@
-export { anaemiaLightningCssPlugin } from "./lightningcss.js";
+export { anaemiaLightningCssPlugin } from "./lightningcss.js";

package/src/plugins/lightningcss.ts

@@ -11,12 +11,12 @@ export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } =
 
   const localRequire = createRequire(import.meta.url);
   let rspackModule: RspackModule;
-  
+
   try {
     rspackModule = localRequire("@rspack/core");
   } catch {
     throw new Error(
-      "[anaemia] The LightningCSS plugin requires '@rspack/core' to be available in the execution workspace."
+      "[anaemia] The LightningCSS plugin requires '@rspack/core' to be available in the execution workspace.",
     );
   }
 
@@ -27,22 +27,22 @@ export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } =
       const isProd = process.env.NODE_ENV === "production";
 
       if (config.module?.rules) {
-        config.module.rules.forEach((rule) => {
+        for (const rule of config.module.rules) {
           if (rule && typeof rule === "object" && rule.test && rule.test.toString().includes("ss")) {
             const currentUse = Array.isArray(rule.use) ? rule.use : [];
-            
+
             rule.use = [
               ...currentUse,
               {
                 loader: "builtin:lightningcss-loader",
-                options: { 
+                options: {
                   targets,
                   modules: rule.type === "css/auto",
                 },
               },
             ];
           }
-        });
+        }
       }
 
       if (isProd) {
@@ -63,24 +63,24 @@ export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } =
 
     serverRspackConfig(config) {
       if (config.module?.rules) {
-        config.module.rules.forEach((rule) => {
+        for (const rule of config.module.rules) {
           if (rule && typeof rule === "object" && rule.test && rule.test.toString().includes("ss")) {
             const currentUse = Array.isArray(rule.use) ? rule.use : [];
-            
+
             rule.use = [
               ...currentUse,
               {
                 loader: "builtin:lightningcss-loader",
-                options: { 
+                options: {
                   targets,
                   modules: rule.type === "css/auto",
                 },
               },
             ];
           }
-        });
+        }
       }
       return config;
     },
   };
-}
+}

package/src/runtime/context.browser.ts

@@ -3,4 +3,4 @@ export const ssrStorage = null as any;
 // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
 export const serverFunctionsRegistry = new Map<string, Function>();
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const runOnServer = null as any;
+export const runOnServer = null as any;

package/src/runtime/context.ts

@@ -1,4 +1,5 @@
 import { AsyncLocalStorage } from "node:async_hooks";
+import { SERVER_FUNCTION_DATA_KEY } from "./shared/constants.js";
 
 type AnyFn = (...args: unknown[]) => unknown;
 
@@ -7,17 +8,17 @@ export const ssrStorage = new AsyncLocalStorage<Map<string, unknown>>();
 (globalThis as unknown as Record<string, unknown>).__ANAEMIA_SERVER_STORAGE__ = ssrStorage;
 
 export function runOnServer<T extends AnyFn>(backendFn: T, id?: string): T & { id: string } {
-  const hashId = id || "";
+  const hashId = id ?? crypto.randomUUID();
   serverFunctionsRegistry.set(hashId, backendFn);
 
   const rpcProxy = async function (...args: unknown[]) {
     const result = await backendFn(...args);
     const store = ssrStorage.getStore();
     if (store && hashId) {
-      if (!store.has("__SERVER_FUNCTION_DATA__")) {
-        store.set("__SERVER_FUNCTION_DATA__", {});
+      if (!store.has(SERVER_FUNCTION_DATA_KEY)) {
+        store.set(SERVER_FUNCTION_DATA_KEY, {});
       }
-      const functionCache = store.get("__SERVER_FUNCTION_DATA__") as Record<string, Record<string, unknown>>;
+      const functionCache = store.get(SERVER_FUNCTION_DATA_KEY) as Record<string, Record<string, unknown> | undefined>;
       if (!functionCache[hashId]) {
         functionCache[hashId] = {};
       }
@@ -28,4 +29,4 @@ export function runOnServer<T extends AnyFn>(backendFn: T, id?: string): T & { i
   };
   rpcProxy.id = hashId;
   return rpcProxy as unknown as T & { id: string };
-}
+}

package/src/runtime/entry-client.tsx

@@ -1,12 +1,11 @@
 import { hydrate, render } from "solid-js/web";
 import { Router } from "@solidjs/router";
+import { ENTRY_SELECTOR } from "./shared/constants.js";
 
 // @ts-expect-error - resolved by Rspack
 import App, { preloadActiveClientRoute } from "anaemia-user-app";
 
-const mountTarget = document.querySelector(
-  "[anaemia-entry]"
-) as HTMLElement | null;
+const mountTarget = document.querySelector(ENTRY_SELECTOR) as HTMLElement | null;
 
 if (!mountTarget) {
   throw new Error("[anaemia] missing mount target");
@@ -17,9 +16,7 @@ const root = mountTarget;
 async function start() {
   await preloadActiveClientRoute(window.location.pathname);
 
-  const mount = root.hasChildNodes()
-    ? hydrate
-    : render;
+  const mount = root.hasChildNodes() ? hydrate : render;
 
   mount(
     () => (
@@ -27,8 +24,8 @@ async function start() {
         <App />
       </Router>
     ),
-    root
+    root,
   );
 }
 
-start();
+await start();