hadars 0.2.0 → 0.2.1

package/dist/cloudflare.d.cts

@@ -0,0 +1,64 @@
+import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-DEBSYAQl.cjs';
+
+/**
+ * Cloudflare Workers adapter for hadars.
+ *
+ * After running `hadars build`, bundle your app with:
+ *
+ *   hadars export cloudflare
+ *
+ * This produces a self-contained `cloudflare.mjs` that you deploy with:
+ *
+ *   wrangler deploy
+ *
+ * Static assets (JS, CSS, fonts) under `.hadars/static/` must be served from
+ * R2 or another CDN — the Worker only handles HTML rendering. Route requests
+ * for static file extensions to R2 and everything else to the Worker.
+ *
+ * @example wrangler.toml
+ *   name = "my-app"
+ *   main = "cloudflare.mjs"
+ *   compatibility_date = "2024-09-23"
+ *   compatibility_flags = ["nodejs_compat"]
+ */
+
+/**
+ * Pre-loaded SSR module and HTML template for single-file Cloudflare bundles
+ * produced by `hadars export cloudflare`. All I/O is eliminated at runtime —
+ * the Worker is fully self-contained.
+ */
+interface CloudflareBundled {
+    /** The compiled SSR module — import it statically in your entry shim. */
+    ssrModule: HadarsEntryModule<any>;
+    /**
+     * The contents of `.hadars/static/out.html` — esbuild inlines this as a
+     * string when `hadars export cloudflare` runs.
+     */
+    outHtml: string;
+}
+/**
+ * The shape of a Cloudflare Workers export object.
+ * Return this as the default export of your Worker entry file.
+ */
+interface CloudflareHandler {
+    fetch(request: Request, env: unknown, ctx: unknown): Promise<Response>;
+}
+/**
+ * Creates a Cloudflare Workers handler from a hadars config and a pre-bundled
+ * SSR module. Use this as the default export of your Worker entry.
+ *
+ * Unlike the Lambda adapter, Cloudflare Workers receive a standard Web
+ * `Request` and return a standard `Response` — no event format conversion is
+ * required. Static assets must be routed to R2/CDN via wrangler rules; this
+ * Worker handles only HTML rendering and API routes.
+ *
+ * @example — generated entry shim (created by `hadars export cloudflare`)
+ * import * as ssrModule from './.hadars/index.ssr.js';
+ * import outHtml from './.hadars/static/out.html';
+ * import { createCloudflareHandler } from 'hadars/cloudflare';
+ * import config from './hadars.config';
+ * export default createCloudflareHandler(config, { ssrModule, outHtml });
+ */
+declare function createCloudflareHandler(options: HadarsOptions, bundled: CloudflareBundled): CloudflareHandler;
+
+export { type CloudflareBundled, type CloudflareHandler, createCloudflareHandler };

package/dist/cloudflare.d.ts

@@ -0,0 +1,64 @@
+import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-DEBSYAQl.js';
+
+/**
+ * Cloudflare Workers adapter for hadars.
+ *
+ * After running `hadars build`, bundle your app with:
+ *
+ *   hadars export cloudflare
+ *
+ * This produces a self-contained `cloudflare.mjs` that you deploy with:
+ *
+ *   wrangler deploy
+ *
+ * Static assets (JS, CSS, fonts) under `.hadars/static/` must be served from
+ * R2 or another CDN — the Worker only handles HTML rendering. Route requests
+ * for static file extensions to R2 and everything else to the Worker.
+ *
+ * @example wrangler.toml
+ *   name = "my-app"
+ *   main = "cloudflare.mjs"
+ *   compatibility_date = "2024-09-23"
+ *   compatibility_flags = ["nodejs_compat"]
+ */
+
+/**
+ * Pre-loaded SSR module and HTML template for single-file Cloudflare bundles
+ * produced by `hadars export cloudflare`. All I/O is eliminated at runtime —
+ * the Worker is fully self-contained.
+ */
+interface CloudflareBundled {
+    /** The compiled SSR module — import it statically in your entry shim. */
+    ssrModule: HadarsEntryModule<any>;
+    /**
+     * The contents of `.hadars/static/out.html` — esbuild inlines this as a
+     * string when `hadars export cloudflare` runs.
+     */
+    outHtml: string;
+}
+/**
+ * The shape of a Cloudflare Workers export object.
+ * Return this as the default export of your Worker entry file.
+ */
+interface CloudflareHandler {
+    fetch(request: Request, env: unknown, ctx: unknown): Promise<Response>;
+}
+/**
+ * Creates a Cloudflare Workers handler from a hadars config and a pre-bundled
+ * SSR module. Use this as the default export of your Worker entry.
+ *
+ * Unlike the Lambda adapter, Cloudflare Workers receive a standard Web
+ * `Request` and return a standard `Response` — no event format conversion is
+ * required. Static assets must be routed to R2/CDN via wrangler rules; this
+ * Worker handles only HTML rendering and API routes.
+ *
+ * @example — generated entry shim (created by `hadars export cloudflare`)
+ * import * as ssrModule from './.hadars/index.ssr.js';
+ * import outHtml from './.hadars/static/out.html';
+ * import { createCloudflareHandler } from 'hadars/cloudflare';
+ * import config from './hadars.config';
+ * export default createCloudflareHandler(config, { ssrModule, outHtml });
+ */
+declare function createCloudflareHandler(options: HadarsOptions, bundled: CloudflareBundled): CloudflareHandler;
+
+export { type CloudflareBundled, type CloudflareHandler, createCloudflareHandler };

package/dist/cloudflare.js

@@ -0,0 +1,68 @@
+import {
+  buildHeadHtml,
+  buildSsrHtml,
+  createProxyHandler,
+  createRenderCache,
+  getReactResponse,
+  makePrecontentHtmlGetter,
+  parseRequest
+} from "./chunk-HWOLYLPF.js";
+import "./chunk-LY5MTHFV.js";
+import "./chunk-OS3V4CPN.js";
+
+// src/cloudflare.ts
+import "react";
+function createCloudflareHandler(options, bundled) {
+  const fetchHandler = options.fetch;
+  const handleProxy = createProxyHandler(options);
+  const getPrecontentHtml = makePrecontentHtmlGetter(Promise.resolve(bundled.outHtml));
+  const { ssrModule } = bundled;
+  const runHandler = async (req) => {
+    const request = parseRequest(req);
+    if (fetchHandler) {
+      const res = await fetchHandler(request);
+      if (res) return res;
+    }
+    const proxied = await handleProxy(request);
+    if (proxied) return proxied;
+    try {
+      const { default: Component, getInitProps, getFinalProps } = ssrModule;
+      const { head, status, getAppBody, finalize } = await getReactResponse(request, {
+        document: {
+          body: Component,
+          lang: "en",
+          getInitProps,
+          getFinalProps
+        }
+      });
+      if (request.headers.get("Accept") === "application/json") {
+        const { clientProps: clientProps2 } = await finalize();
+        const serverData = clientProps2.__serverData ?? {};
+        return new Response(JSON.stringify({ serverData }), {
+          status,
+          headers: { "Content-Type": "application/json; charset=utf-8" }
+        });
+      }
+      const bodyHtml = await getAppBody();
+      const { clientProps } = await finalize();
+      const headHtml = buildHeadHtml(head);
+      const html = await buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml);
+      return new Response(html, {
+        status,
+        headers: { "Content-Type": "text/html; charset=utf-8" }
+      });
+    } catch (err) {
+      console.error("[hadars] SSR render error:", err);
+      return new Response("Internal Server Error", { status: 500 });
+    }
+  };
+  const finalFetch = options.cache ? createRenderCache(options.cache, (req) => runHandler(req)) : (req) => runHandler(req);
+  return {
+    fetch: async (request, _env, ctx) => {
+      return await finalFetch(request, ctx) ?? new Response("Not Found", { status: 404 });
+    }
+  };
+}
+export {
+  createCloudflareHandler
+};

package/dist/{hadars-Bh-V5YXg.d.cts → hadars-DEBSYAQl.d.cts}

@@ -1,5 +1,3 @@
-import { MetaHTMLAttributes, LinkHTMLAttributes, StyleHTMLAttributes, ScriptHTMLAttributes } from 'react';
-
 type HadarsGetInitialProps<T extends {}> = (req: HadarsRequest) => Promise<T> | T;
 type HadarsGetClientProps<T extends {}> = (props: T) => Promise<T> | T;
 type HadarsGetFinalProps<T extends {}> = (props: HadarsProps<T>) => Promise<T> | T;
@@ -10,43 +8,10 @@ type HadarsEntryModule<T extends {}> = {
     getFinalProps?: HadarsGetFinalProps<T>;
     getClientProps?: HadarsGetClientProps<T>;
 };
-interface AppHead {
-    title: string;
-    status: number;
-    meta: Record<string, MetaProps>;
-    link: Record<string, LinkProps>;
-    style: Record<string, StyleProps>;
-    script: Record<string, ScriptProps>;
-}
-type UnsuspendEntry = {
-    status: 'pending';
-    promise: Promise<unknown>;
-} | {
-    status: 'fulfilled';
-    value: unknown;
-} | {
-    status: 'rejected';
-    reason: unknown;
-};
-/** @internal Populated by the framework's render loop — use useServerData() instead. */
-interface AppUnsuspend {
-    cache: Map<string, UnsuspendEntry>;
-}
-interface AppContext {
-    path?: string;
-    head: AppHead;
-    /** @internal Framework use only — use the useServerData() hook instead. */
-    _unsuspend?: AppUnsuspend;
-}
 type HadarsEntryBase = {
     location: string;
-    context: AppContext;
 };
 type HadarsProps<T extends {}> = T & HadarsEntryBase;
-type MetaProps = MetaHTMLAttributes<HTMLMetaElement>;
-type LinkProps = LinkHTMLAttributes<HTMLLinkElement>;
-type StyleProps = StyleHTMLAttributes<HTMLStyleElement>;
-type ScriptProps = ScriptHTMLAttributes<HTMLScriptElement>;
 interface HadarsOptions {
     port?: number;
     entry: string;
@@ -196,4 +161,4 @@ interface HadarsRequest extends Request {
     cookies: Record<string, string>;
 }
 
-export type { AppContext as A, HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g };
+export type { HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g };

package/dist/{hadars-Bh-V5YXg.d.ts → hadars-DEBSYAQl.d.ts}

@@ -1,5 +1,3 @@
-import { MetaHTMLAttributes, LinkHTMLAttributes, StyleHTMLAttributes, ScriptHTMLAttributes } from 'react';
-
 type HadarsGetInitialProps<T extends {}> = (req: HadarsRequest) => Promise<T> | T;
 type HadarsGetClientProps<T extends {}> = (props: T) => Promise<T> | T;
 type HadarsGetFinalProps<T extends {}> = (props: HadarsProps<T>) => Promise<T> | T;
@@ -10,43 +8,10 @@ type HadarsEntryModule<T extends {}> = {
     getFinalProps?: HadarsGetFinalProps<T>;
     getClientProps?: HadarsGetClientProps<T>;
 };
-interface AppHead {
-    title: string;
-    status: number;
-    meta: Record<string, MetaProps>;
-    link: Record<string, LinkProps>;
-    style: Record<string, StyleProps>;
-    script: Record<string, ScriptProps>;
-}
-type UnsuspendEntry = {
-    status: 'pending';
-    promise: Promise<unknown>;
-} | {
-    status: 'fulfilled';
-    value: unknown;
-} | {
-    status: 'rejected';
-    reason: unknown;
-};
-/** @internal Populated by the framework's render loop — use useServerData() instead. */
-interface AppUnsuspend {
-    cache: Map<string, UnsuspendEntry>;
-}
-interface AppContext {
-    path?: string;
-    head: AppHead;
-    /** @internal Framework use only — use the useServerData() hook instead. */
-    _unsuspend?: AppUnsuspend;
-}
 type HadarsEntryBase = {
     location: string;
-    context: AppContext;
 };
 type HadarsProps<T extends {}> = T & HadarsEntryBase;
-type MetaProps = MetaHTMLAttributes<HTMLMetaElement>;
-type LinkProps = LinkHTMLAttributes<HTMLLinkElement>;
-type StyleProps = StyleHTMLAttributes<HTMLStyleElement>;
-type ScriptProps = ScriptHTMLAttributes<HTMLScriptElement>;
 interface HadarsOptions {
     port?: number;
     entry: string;
@@ -196,4 +161,4 @@ interface HadarsRequest extends Request {
     cookies: Record<string, string>;
 }
 
-export type { AppContext as A, HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g };
+export type { HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g };

package/dist/index.cjs

@@ -30,7 +30,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.tsx
 var index_exports = {};
 __export(index_exports, {
-  HadarsContext: () => HadarsContext,
   HadarsHead: () => Head,
   initServerDataCache: () => initServerDataCache,
   loadModule: () => loadModule,
@@ -40,7 +39,6 @@ module.exports = __toCommonJS(index_exports);
 
 // src/utils/Head.tsx
 var import_react = __toESM(require("react"), 1);
-var import_jsx_runtime = require("react/jsx-runtime");
 function deriveKey(tag, props) {
   switch (tag) {
     case "meta": {
@@ -70,134 +68,116 @@ function deriveKey(tag, props) {
       return `${tag}:${JSON.stringify(props)}`;
   }
 }
-var AppContext = import_react.default.createContext({
-  setTitle: () => {
-    console.warn("AppContext: setTitle called outside of provider");
-  },
-  addMeta: () => {
-    console.warn("AppContext: addMeta called outside of provider");
-  },
-  addLink: () => {
-    console.warn("AppContext: addLink called outside of provider");
-  },
-  addStyle: () => {
-    console.warn("AppContext: addStyle called outside of provider");
-  },
-  addScript: () => {
-    console.warn("AppContext: addScript called outside of provider");
-  },
-  setStatus: () => {
-  }
-});
-var AppProviderSSR = import_react.default.memo(({ children, context }) => {
-  const { head } = context;
-  const setTitle = import_react.default.useCallback((title) => {
-    head.title = title;
-  }, [head]);
-  const addMeta = import_react.default.useCallback((props) => {
-    head.meta[deriveKey("meta", props)] = props;
-  }, [head]);
-  const addLink = import_react.default.useCallback((props) => {
-    head.link[deriveKey("link", props)] = props;
-  }, [head]);
-  const addStyle = import_react.default.useCallback((props) => {
-    head.style[deriveKey("style", props)] = props;
-  }, [head]);
-  const addScript = import_react.default.useCallback((props) => {
-    head.script[deriveKey("script", props)] = props;
-  }, [head]);
-  const setStatus = import_react.default.useCallback((status) => {
-    head.status = status;
-  }, [head]);
-  const contextValue = import_react.default.useMemo(() => ({
-    setTitle,
-    addMeta,
-    addLink,
-    addStyle,
-    addScript,
-    setStatus
-  }), [setTitle, addMeta, addLink, addStyle, addScript, setStatus]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AppContext.Provider, { value: contextValue, children });
-});
-var AppProviderCSR = import_react.default.memo(({ children }) => {
-  const setTitle = import_react.default.useCallback((title) => {
-    document.title = title;
-  }, []);
-  const addMeta = import_react.default.useCallback((props) => {
-    const p = props;
-    let meta = null;
-    if (p.name) meta = document.querySelector(`meta[name="${CSS.escape(p.name)}"]`);
-    else if (p.property) meta = document.querySelector(`meta[property="${CSS.escape(p.property)}"]`);
-    else if (p.httpEquiv ?? p["http-equiv"]) meta = document.querySelector(`meta[http-equiv="${CSS.escape(p.httpEquiv ?? p["http-equiv"])}"]`);
-    else if ("charSet" in p || "charset" in p) meta = document.querySelector("meta[charset]");
-    if (!meta) {
-      meta = document.createElement("meta");
-      document.head.appendChild(meta);
-    }
-    for (const [k, v] of Object.entries(p)) {
-      if (v != null && v !== false) meta.setAttribute(k === "charSet" ? "charset" : k === "httpEquiv" ? "http-equiv" : k, String(v));
-    }
-  }, []);
-  const addLink = import_react.default.useCallback((props) => {
-    const p = props;
-    let link = null;
-    const asSel = p.as ? `[as="${CSS.escape(p.as)}"]` : "";
-    if (p.rel && p.href) link = document.querySelector(`link[rel="${CSS.escape(p.rel)}"][href="${CSS.escape(p.href)}"]${asSel}`);
-    else if (p.rel) link = document.querySelector(`link[rel="${CSS.escape(p.rel)}"]${asSel}`);
-    if (!link) {
-      link = document.createElement("link");
-      document.head.appendChild(link);
-    }
-    const LINK_ATTR = { crossOrigin: "crossorigin", referrerPolicy: "referrerpolicy", fetchPriority: "fetchpriority", hrefLang: "hreflang" };
-    for (const [k, v] of Object.entries(p)) {
-      if (v != null && v !== false) link.setAttribute(LINK_ATTR[k] ?? k, String(v));
-    }
-  }, []);
-  const addStyle = import_react.default.useCallback((props) => {
-    const p = props;
-    let style = null;
-    if (p["data-id"]) style = document.querySelector(`style[data-id="${CSS.escape(p["data-id"])}"]`);
-    if (!style) {
-      style = document.createElement("style");
-      document.head.appendChild(style);
+var LINK_ATTR = {
+  crossOrigin: "crossorigin",
+  referrerPolicy: "referrerpolicy",
+  fetchPriority: "fetchpriority",
+  hrefLang: "hreflang"
+};
+function makeServerCtx(head) {
+  return {
+    setTitle: (t) => {
+      head.title = t;
+    },
+    addMeta: (p) => {
+      head.meta[deriveKey("meta", p)] = p;
+    },
+    addLink: (p) => {
+      head.link[deriveKey("link", p)] = p;
+    },
+    addStyle: (p) => {
+      head.style[deriveKey("style", p)] = p;
+    },
+    addScript: (p) => {
+      head.script[deriveKey("script", p)] = p;
+    },
+    setStatus: (s) => {
+      head.status = s;
     }
-    for (const [k, v] of Object.entries(p)) {
-      if (k === "dangerouslySetInnerHTML") {
-        style.innerHTML = v.__html ?? "";
-        continue;
+  };
+}
+var _cliCtx = null;
+function makeClientCtx() {
+  if (_cliCtx) return _cliCtx;
+  _cliCtx = {
+    setTitle: (title) => {
+      document.title = title;
+    },
+    setStatus: () => {
+    },
+    addMeta: (props) => {
+      const p = props;
+      let meta = null;
+      if (p.name) meta = document.querySelector(`meta[name="${CSS.escape(p.name)}"]`);
+      else if (p.property) meta = document.querySelector(`meta[property="${CSS.escape(p.property)}"]`);
+      else if (p.httpEquiv ?? p["http-equiv"]) meta = document.querySelector(`meta[http-equiv="${CSS.escape(p.httpEquiv ?? p["http-equiv"])}"]`);
+      else if ("charSet" in p || "charset" in p) meta = document.querySelector("meta[charset]");
+      if (!meta) {
+        meta = document.createElement("meta");
+        document.head.appendChild(meta);
       }
-      if (v != null && v !== false) style.setAttribute(k, String(v));
-    }
-  }, []);
-  const addScript = import_react.default.useCallback((props) => {
-    const p = props;
-    let script = null;
-    if (p.src) script = document.querySelector(`script[src="${CSS.escape(p.src)}"]`);
-    else if (p["data-id"]) script = document.querySelector(`script[data-id="${CSS.escape(p["data-id"])}"]`);
-    if (!script) {
-      script = document.createElement("script");
-      document.body.appendChild(script);
-    }
-    for (const [k, v] of Object.entries(p)) {
-      if (k === "dangerouslySetInnerHTML") {
-        script.innerHTML = v.__html ?? "";
-        continue;
+      for (const [k, v] of Object.entries(p)) {
+        if (v != null && v !== false) meta.setAttribute(k === "charSet" ? "charset" : k === "httpEquiv" ? "http-equiv" : k, String(v));
+      }
+    },
+    addLink: (props) => {
+      const p = props;
+      let link = null;
+      const asSel = p.as ? `[as="${CSS.escape(p.as)}"]` : "";
+      if (p.rel && p.href) link = document.querySelector(`link[rel="${CSS.escape(p.rel)}"][href="${CSS.escape(p.href)}"]${asSel}`);
+      else if (p.rel) link = document.querySelector(`link[rel="${CSS.escape(p.rel)}"]${asSel}`);
+      if (!link) {
+        link = document.createElement("link");
+        document.head.appendChild(link);
+      }
+      for (const [k, v] of Object.entries(p)) {
+        if (v != null && v !== false) link.setAttribute(LINK_ATTR[k] ?? k, String(v));
+      }
+    },
+    addStyle: (props) => {
+      const p = props;
+      let style = null;
+      if (p["data-id"]) style = document.querySelector(`style[data-id="${CSS.escape(p["data-id"])}"]`);
+      if (!style) {
+        style = document.createElement("style");
+        document.head.appendChild(style);
+      }
+      for (const [k, v] of Object.entries(p)) {
+        if (k === "dangerouslySetInnerHTML") {
+          style.innerHTML = v.__html ?? "";
+          continue;
+        }
+        if (v != null && v !== false) style.setAttribute(k, String(v));
+      }
+    },
+    addScript: (props) => {
+      const p = props;
+      let script = null;
+      if (p.src) script = document.querySelector(`script[src="${CSS.escape(p.src)}"]`);
+      else if (p["data-id"]) script = document.querySelector(`script[data-id="${CSS.escape(p["data-id"])}"]`);
+      if (!script) {
+        script = document.createElement("script");
+        document.body.appendChild(script);
+      }
+      for (const [k, v] of Object.entries(p)) {
+        if (k === "dangerouslySetInnerHTML") {
+          script.innerHTML = v.__html ?? "";
+          continue;
+        }
+        if (v != null && v !== false) script.setAttribute(k, String(v));
       }
-      if (v != null && v !== false) script.setAttribute(k, String(v));
-    }
-  }, []);
-  const contextValue = import_react.default.useMemo(() => ({
-    setTitle,
-    addMeta,
-    addLink,
-    addStyle,
-    addScript,
-    setStatus: () => {
     }
-  }), [setTitle, addMeta, addLink, addStyle, addScript]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AppContext.Provider, { value: contextValue, children });
-});
-var useApp = () => import_react.default.useContext(AppContext);
+  };
+  return _cliCtx;
+}
+function getCtx() {
+  if (typeof window === "undefined") {
+    const head = globalThis.__hadarsContext?.head;
+    if (!head) return null;
+    return makeServerCtx(head);
+  }
+  return makeClientCtx();
+}
 var clientServerDataCache = /* @__PURE__ */ new Map();
 var pendingDataFetch = /* @__PURE__ */ new Map();
 var fetchedPaths = /* @__PURE__ */ new Set();
@@ -267,26 +247,12 @@ function useServerData(key, fn) {
   const unsuspend = globalThis.__hadarsUnsuspend;
   if (!unsuspend) return void 0;
   const _u = unsuspend;
-  if (!_u.seenThisPass) _u.seenThisPass = /* @__PURE__ */ new Set();
-  if (!_u.seenLastPass) _u.seenLastPass = /* @__PURE__ */ new Set();
-  if (_u.newPassStarting) {
-    _u.seenLastPass = new Set(_u.seenThisPass);
-    _u.seenThisPass.clear();
-    _u.newPassStarting = false;
-  }
-  _u.seenThisPass.add(cacheKey);
+  if (!_u.pendingCreated) _u.pendingCreated = 0;
   const existing = unsuspend.cache.get(cacheKey);
+  if (existing?.status === "fulfilled" && _u.lastPendingKey === cacheKey) {
+    _u.lastPendingKeyAccessed = true;
+  }
   if (!existing) {
-    if (_u.seenLastPass.size > 0) {
-      const hasVanishedKey = [..._u.seenLastPass].some(
-        (k) => !_u.seenThisPass.has(k)
-      );
-      if (hasVanishedKey) {
-        throw new Error(
-          `[hadars] useServerData: key ${JSON.stringify(cacheKey)} appeared in this pass but a key that was present in the previous pass is now missing. This means the key is not stable across render passes (e.g. it contains Date.now(), Math.random(), or a value that changes on every render). Keys must be deterministic.`
-        );
-      }
-    }
     const result = fn();
     const isThenable = result !== null && typeof result === "object" && typeof result.then === "function";
     if (!isThenable) {
@@ -294,6 +260,22 @@ function useServerData(key, fn) {
       unsuspend.cache.set(cacheKey, { status: "fulfilled", value });
       return value;
     }
+    if (_u.lastPendingKey != null && !_u.lastPendingKeyAccessed) {
+      const prev = unsuspend.cache.get(_u.lastPendingKey);
+      if (prev?.status === "fulfilled") {
+        throw new Error(
+          `[hadars] useServerData: key ${JSON.stringify(cacheKey)} is not stable between render passes. The previous pass resolved ${JSON.stringify(_u.lastPendingKey)} but it was not requested in this pass \u2014 the key is changing between renders. Avoid dynamic values in keys (e.g. Date.now() or Math.random()); use stable, deterministic identifiers instead.`
+        );
+      }
+    }
+    _u.pendingCreated++;
+    if (_u.pendingCreated > 100) {
+      throw new Error(
+        `[hadars] useServerData: more than 100 async keys created in a single render. This usually means a key is not stable between renders (e.g. it contains Date.now() or Math.random()). Currently offending key: ${JSON.stringify(cacheKey)}.`
+      );
+    }
+    _u.lastPendingKey = cacheKey;
+    _u.lastPendingKeyAccessed = false;
     const promise = result.then(
       (value) => {
         unsuspend.cache.set(cacheKey, { status: "fulfilled", value });
@@ -303,25 +285,18 @@ function useServerData(key, fn) {
       }
     );
     unsuspend.cache.set(cacheKey, { status: "pending", promise });
-    _u.newPassStarting = true;
     throw promise;
   }
   if (existing.status === "pending") {
-    _u.newPassStarting = true;
     throw existing.promise;
   }
   if (existing.status === "rejected") throw existing.reason;
   return existing.value;
 }
 var Head = import_react.default.memo(({ children, status }) => {
-  const {
-    setStatus,
-    setTitle,
-    addMeta,
-    addLink,
-    addStyle,
-    addScript
-  } = useApp();
+  const ctx = getCtx();
+  if (!ctx) return null;
+  const { setStatus, setTitle, addMeta, addLink, addStyle, addScript } = ctx;
   if (status) {
     setStatus(status);
   }
@@ -366,7 +341,6 @@ var Head = import_react.default.memo(({ children, status }) => {
 });
 
 // src/index.tsx
-var HadarsContext = typeof window === "undefined" ? AppProviderSSR : AppProviderCSR;
 function loadModule(path) {
   return import(
     /* webpackIgnore: true */
@@ -375,7 +349,6 @@ function loadModule(path) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  HadarsContext,
   HadarsHead,
   initServerDataCache,
   loadModule,