@lolyjs/core 0.1.0-alpha.0

package/dist/react/cache.cjs

@@ -0,0 +1,251 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// modules/react/cache/index.ts
+var cache_exports = {};
+__export(cache_exports, {
+  getRouteData: () => getRouteData,
+  prefetchRouteData: () => prefetchRouteData,
+  revalidate: () => revalidate,
+  revalidatePath: () => revalidatePath,
+  revalidateRouteData: () => revalidateRouteData
+});
+module.exports = __toCommonJS(cache_exports);
+
+// modules/react/cache/client-data-cache/index.ts
+var CACHE_KEY = "__FW_DATA_CACHE__";
+var MAX_CACHE_SIZE = 100;
+function getCacheStore() {
+  if (typeof window !== "undefined") {
+    if (!window[CACHE_KEY]) {
+      window[CACHE_KEY] = {
+        data: /* @__PURE__ */ new Map(),
+        index: /* @__PURE__ */ new Map(),
+        lru: []
+      };
+    }
+    return window[CACHE_KEY];
+  }
+  return {
+    data: /* @__PURE__ */ new Map(),
+    index: /* @__PURE__ */ new Map(),
+    lru: []
+  };
+}
+var cacheStore = getCacheStore();
+var dataCache = cacheStore.data;
+var pathIndex = cacheStore.index;
+var lru = cacheStore.lru;
+function extractPathBase(key) {
+  return key.split("?")[0];
+}
+function addToIndex(key) {
+  const pathBase = extractPathBase(key);
+  if (!pathIndex.has(pathBase)) {
+    pathIndex.set(pathBase, /* @__PURE__ */ new Set());
+  }
+  pathIndex.get(pathBase).add(key);
+}
+function removeFromIndex(key) {
+  const pathBase = extractPathBase(key);
+  const keys = pathIndex.get(pathBase);
+  if (keys) {
+    keys.delete(key);
+    if (keys.size === 0) {
+      pathIndex.delete(pathBase);
+    }
+  }
+}
+function updateLRU(key) {
+  const index = lru.indexOf(key);
+  if (index !== -1) {
+    lru.splice(index, 1);
+  }
+  lru.push(key);
+}
+function evictOldest() {
+  while (lru.length >= MAX_CACHE_SIZE && lru.length > 0) {
+    const oldestKey = lru.shift();
+    dataCache.delete(oldestKey);
+    removeFromIndex(oldestKey);
+  }
+}
+function setCacheEntry(key, entry) {
+  const existingEntry = dataCache.get(key);
+  const wasFulfilled = existingEntry?.status === "fulfilled";
+  dataCache.set(key, entry);
+  if (entry.status === "fulfilled") {
+    if (!wasFulfilled) {
+      addToIndex(key);
+    }
+    updateLRU(key);
+    evictOldest();
+  } else if (wasFulfilled) {
+    removeFromIndex(key);
+  }
+}
+function deleteCacheEntry(key) {
+  if (dataCache.has(key)) {
+    dataCache.delete(key);
+    removeFromIndex(key);
+    const lruIndex = lru.indexOf(key);
+    if (lruIndex !== -1) {
+      lru.splice(lruIndex, 1);
+    }
+  }
+}
+function buildDataUrl(url) {
+  return url + (url.includes("?") ? "&" : "?") + "__fw_data=1";
+}
+async function fetchRouteDataOnce(url) {
+  const dataUrl = buildDataUrl(url);
+  const res = await fetch(dataUrl, {
+    headers: {
+      "x-fw-data": "1",
+      Accept: "application/json"
+    }
+  });
+  let json = {};
+  try {
+    const text = await res.text();
+    if (text) {
+      json = JSON.parse(text);
+    }
+  } catch (parseError) {
+    console.error(
+      "[client][cache] Failed to parse response as JSON:",
+      parseError
+    );
+  }
+  const result = {
+    ok: res.ok,
+    status: res.status,
+    json
+  };
+  return result;
+}
+function revalidatePath(path) {
+  const normalizedPath = path.split("?")[0];
+  const hasQueryParams = path.includes("?");
+  const keysForPath = pathIndex.get(normalizedPath);
+  if (!keysForPath || keysForPath.size === 0) {
+    return;
+  }
+  let specificQueryParams;
+  if (hasQueryParams) {
+    const queryPart = path.split("?")[1];
+    specificQueryParams = queryPart.split("&").filter((p) => !p.startsWith("__fw_data=")).sort().join("&");
+  }
+  const keysToDelete = [];
+  for (const key of keysForPath) {
+    if (hasQueryParams && specificQueryParams) {
+      const [, keyQuery = ""] = key.split("?");
+      const keyQueryParams = keyQuery.split("&").filter((p) => !p.startsWith("__fw_data=")).sort().join("&");
+      if (keyQueryParams === specificQueryParams) {
+        keysToDelete.push(key);
+      }
+    } else {
+      keysToDelete.push(key);
+    }
+  }
+  keysToDelete.forEach((key) => {
+    deleteCacheEntry(key);
+  });
+}
+async function revalidate() {
+  if (typeof window === "undefined") {
+    throw new Error("revalidate() can only be called on the client");
+  }
+  const pathname = window.location.pathname + window.location.search;
+  revalidatePath(pathname);
+  const freshData = await getRouteData(pathname, { revalidate: true });
+  if (window.__FW_DATA__ && freshData.ok && freshData.json) {
+    const currentData = window.__FW_DATA__;
+    window.__FW_DATA__ = {
+      ...currentData,
+      pathname: pathname.split("?")[0],
+      params: freshData.json.params || currentData.params || {},
+      props: freshData.json.props || currentData.props || {},
+      metadata: freshData.json.metadata ?? currentData.metadata ?? null,
+      notFound: freshData.json.notFound ?? false,
+      error: freshData.json.error ?? false
+    };
+    window.dispatchEvent(new CustomEvent("fw-data-refresh", {
+      detail: { data: freshData }
+    }));
+  }
+  return freshData;
+}
+function revalidateRouteData(url) {
+  revalidatePath(url);
+}
+function prefetchRouteData(url) {
+  const key = buildDataUrl(url);
+  const cached = dataCache.get(key);
+  if (cached && cached.status !== "rejected") {
+    if (cached.status === "fulfilled") {
+      updateLRU(key);
+    }
+    return;
+  }
+  const promise = fetchRouteDataOnce(url).then((value) => {
+    setCacheEntry(key, { status: "fulfilled", value });
+    return value;
+  }).catch((error) => {
+    console.error("[client][cache] Error prefetching route data:", error);
+    dataCache.set(key, { status: "rejected", error });
+    throw error;
+  });
+  dataCache.set(key, { status: "pending", promise });
+}
+async function getRouteData(url, options) {
+  const key = buildDataUrl(url);
+  if (options?.revalidate) {
+    deleteCacheEntry(key);
+  }
+  const entry = dataCache.get(key);
+  if (entry) {
+    if (entry.status === "fulfilled") {
+      updateLRU(key);
+      return entry.value;
+    }
+    if (entry.status === "pending") {
+      return entry.promise;
+    }
+  }
+  const promise = fetchRouteDataOnce(url).then((value) => {
+    setCacheEntry(key, { status: "fulfilled", value });
+    return value;
+  }).catch((error) => {
+    console.error("[client][cache] Error fetching route data:", error);
+    dataCache.set(key, { status: "rejected", error });
+    throw error;
+  });
+  dataCache.set(key, { status: "pending", promise });
+  return promise;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getRouteData,
+  prefetchRouteData,
+  revalidate,
+  revalidatePath,
+  revalidateRouteData
+});
+//# sourceMappingURL=cache.cjs.map

package/dist/react/cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/react/cache/index.ts","../../modules/react/cache/client-data-cache/index.ts"],"sourcesContent":["export * from \"./client-data-cache\";","type RouteData = {\n  ok: boolean;\n  status: number;\n  json: any;\n};\n\ntype CacheEntry =\n  | { status: \"pending\"; promise: Promise<RouteData> }\n  | { status: \"fulfilled\"; value: RouteData }\n  | { status: \"rejected\"; error: any };\n\n// Use window to guarantee a single shared cache instance\n// across all bundles/modules\nconst CACHE_KEY = \"__FW_DATA_CACHE__\";\n\n// Maximum number of entries in the cache (LRU)\nconst MAX_CACHE_SIZE = 100;\n\ntype CacheStore = {\n  data: Map<string, CacheEntry>;\n  index: Map<string, Set<string>>; // pathBase -> Set of keys\n  lru: string[]; // Ordered list: most recent at end, oldest at start\n};\n\nfunction getCacheStore(): CacheStore {\n  if (typeof window !== \"undefined\") {\n    if (!(window as any)[CACHE_KEY]) {\n      (window as any)[CACHE_KEY] = {\n        data: new Map<string, CacheEntry>(),\n        index: new Map<string, Set<string>>(),\n        lru: [],\n      };\n    }\n    return (window as any)[CACHE_KEY];\n  }\n  // Fallback for SSR (though this shouldn't be used on the client)\n  return {\n    data: new Map<string, CacheEntry>(),\n    index: new Map<string, Set<string>>(),\n    lru: [],\n  };\n}\n\nconst cacheStore = getCacheStore();\nconst dataCache = cacheStore.data;\nconst pathIndex = cacheStore.index;\nconst lru = cacheStore.lru;\n\n// Helper functions for cache management\n\n/**\n * Extract base path from a cache key (removes query params)\n */\nfunction extractPathBase(key: string): string {\n  return key.split(\"?\")[0];\n}\n\n/**\n * Add key to path index\n */\nfunction addToIndex(key: string): void {\n  const pathBase = extractPathBase(key);\n  if (!pathIndex.has(pathBase)) {\n    pathIndex.set(pathBase, new Set());\n  }\n  pathIndex.get(pathBase)!.add(key);\n}\n\n/**\n * Remove key from path index\n */\nfunction removeFromIndex(key: string): void {\n  const pathBase = extractPathBase(key);\n  const keys = pathIndex.get(pathBase);\n  if (keys) {\n    keys.delete(key);\n    if (keys.size === 0) {\n      pathIndex.delete(pathBase);\n    }\n  }\n}\n\n/**\n * Update LRU order - move key to end (most recent)\n */\nfunction updateLRU(key: string): void {\n  const index = lru.indexOf(key);\n  if (index !== -1) {\n    lru.splice(index, 1);\n  }\n  lru.push(key);\n}\n\n/**\n * Remove oldest entries if cache exceeds MAX_CACHE_SIZE\n */\nfunction evictOldest(): void {\n  while (lru.length >= MAX_CACHE_SIZE && lru.length > 0) {\n    const oldestKey = lru.shift()!;\n    dataCache.delete(oldestKey);\n    removeFromIndex(oldestKey);\n  }\n}\n\n/**\n * Set cache entry and maintain indexes\n */\nfunction setCacheEntry(key: string, entry: CacheEntry): void {\n  const existingEntry = dataCache.get(key);\n  const wasFulfilled = existingEntry?.status === \"fulfilled\";\n  \n  dataCache.set(key, entry);\n  \n  // Only track fulfilled entries in LRU and index (not pending/rejected)\n  if (entry.status === \"fulfilled\") {\n    // Add to index if it wasn't already fulfilled (new entry or transition from pending/rejected)\n    if (!wasFulfilled) {\n      addToIndex(key);\n    }\n    updateLRU(key);\n    evictOldest();\n  } else if (wasFulfilled) {\n    // If entry was fulfilled and now isn't (transitioning to pending/rejected), remove from index\n    removeFromIndex(key);\n  }\n}\n\n/**\n * Delete cache entry and clean up indexes\n */\nfunction deleteCacheEntry(key: string): void {\n  if (dataCache.has(key)) {\n    dataCache.delete(key);\n    removeFromIndex(key);\n    const lruIndex = lru.indexOf(key);\n    if (lruIndex !== -1) {\n      lru.splice(lruIndex, 1);\n    }\n  }\n}\n\nfunction buildDataUrl(url: string): string {\n  return url + (url.includes(\"?\") ? \"&\" : \"?\") + \"__fw_data=1\";\n}\n\nasync function fetchRouteDataOnce(url: string): Promise<RouteData> {\n  const dataUrl = buildDataUrl(url);\n\n  const res = await fetch(dataUrl, {\n    headers: {\n      \"x-fw-data\": \"1\",\n      Accept: \"application/json\",\n    },\n  });\n\n  let json: any = {};\n\n  try {\n    const text = await res.text();\n    if (text) {\n      json = JSON.parse(text);\n    }\n  } catch (parseError) {\n    console.error(\n      \"[client][cache] Failed to parse response as JSON:\",\n      parseError\n    );\n  }\n\n  const result: RouteData = {\n    ok: res.ok,\n    status: res.status,\n    json,\n  };\n\n  return result;\n}\n\n/**\n * Revalidates route data by removing it from the cache.\n * The next time you navigate to this route, fresh data will be fetched from the server.\n * This is a client-side function and does not require a server-side revalidation.\n *\n * @param path - The route path to revalidate (e.g., '/posts/1' or '/posts/1?page=2')\n *               If query params are not included, revalidates all variants of that route.\n *\n * @example\n * ```ts\n * // After saving something to the DB, revalidate the route\n * await saveToDatabase(data);\n * revalidatePath('/posts');\n * \n * // Revalidate a specific route with query params\n * revalidatePath('/posts?page=2');\n * ```\n */\nexport function revalidatePath(path: string): void {\n  // Normalize the base path (without query params)\n  const normalizedPath = path.split(\"?\")[0];\n  const hasQueryParams = path.includes(\"?\");\n  \n  // Get all keys for this path base from index (O(1) lookup)\n  const keysForPath = pathIndex.get(normalizedPath);\n  \n  if (!keysForPath || keysForPath.size === 0) {\n    return; // No entries to revalidate\n  }\n  \n  // If the path includes specific query params, extract them\n  let specificQueryParams: string | undefined;\n  if (hasQueryParams) {\n    const queryPart = path.split(\"?\")[1];\n    // Sort query params for consistent comparison\n    specificQueryParams = queryPart\n      .split(\"&\")\n      .filter((p) => !p.startsWith(\"__fw_data=\"))\n      .sort()\n      .join(\"&\");\n  }\n  \n  // Iterate only over keys for this path (much smaller set)\n  const keysToDelete: string[] = [];\n  for (const key of keysForPath) {\n    // If specific query params were specified, check if they match\n    if (hasQueryParams && specificQueryParams) {\n      const [, keyQuery = \"\"] = key.split(\"?\");\n      const keyQueryParams = keyQuery\n        .split(\"&\")\n        .filter((p) => !p.startsWith(\"__fw_data=\"))\n        .sort()\n        .join(\"&\");\n      \n      if (keyQueryParams === specificQueryParams) {\n        keysToDelete.push(key);\n      }\n    } else {\n      // If no specific query params, revalidate all variants\n      keysToDelete.push(key);\n    }\n  }\n  \n  // Delete matching entries\n  keysToDelete.forEach((key) => {\n    deleteCacheEntry(key);\n  });\n}\n\n/**\n * Revalidates and refreshes the current page data.\n * Similar to Next.js's `router.refresh()`.\n * \n * This function:\n * 1. Removes the current route from cache\n * 2. Fetches fresh data from the server\n * 3. Updates window.__FW_DATA__ with the new data\n * 4. Dispatches a 'fw-data-refresh' event for components to listen to\n * \n * @returns Promise that resolves with the fresh route data\n * \n * @example\n * ```ts\n * // Refresh current page data after a mutation\n * await revalidate();\n * ```\n */\nexport async function revalidate(): Promise<RouteData> {\n  if (typeof window === \"undefined\") {\n    throw new Error(\"revalidate() can only be called on the client\");\n  }\n\n  const pathname = window.location.pathname + window.location.search;\n  \n  // Revalidate the path (remove from cache)\n  revalidatePath(pathname);\n  \n  // Fetch fresh data\n  const freshData = await getRouteData(pathname, { revalidate: true });\n  \n  // Update window.__FW_DATA__ if it exists\n  if ((window as any).__FW_DATA__ && freshData.ok && freshData.json) {\n    const currentData = (window as any).__FW_DATA__;\n    (window as any).__FW_DATA__ = {\n      ...currentData,\n      pathname: pathname.split(\"?\")[0],\n      params: freshData.json.params || currentData.params || {},\n      props: freshData.json.props || currentData.props || {},\n      metadata: freshData.json.metadata ?? currentData.metadata ?? null,\n      notFound: freshData.json.notFound ?? false,\n      error: freshData.json.error ?? false,\n    };\n    \n    // Dispatch event for components to listen to\n    window.dispatchEvent(new CustomEvent(\"fw-data-refresh\", {\n      detail: { data: freshData },\n    }));\n  }\n  \n  return freshData;\n}\n\n/**\n * @deprecated Use `revalidatePath()` instead. This function is kept for backwards compatibility.\n */\nexport function revalidateRouteData(url: string): void {\n  revalidatePath(url);\n}\n\nexport function prefetchRouteData(url: string): void {\n  const key = buildDataUrl(url);\n\n  const cached = dataCache.get(key);\n\n  if (cached && cached.status !== \"rejected\") {\n    // Update LRU if it exists and is fulfilled\n    if (cached.status === \"fulfilled\") {\n      updateLRU(key);\n    }\n    return;\n  }\n\n  const promise = fetchRouteDataOnce(url)\n    .then((value) => {\n      setCacheEntry(key, { status: \"fulfilled\", value });\n      return value;\n    })\n    .catch((error) => {\n      console.error(\"[client][cache] Error prefetching route data:\", error);\n      dataCache.set(key, { status: \"rejected\", error });\n      throw error;\n    });\n\n  dataCache.set(key, { status: \"pending\", promise });\n}\n\nexport type GetRouteDataOptions = {\n  /**\n   * If true, forces revalidation of route data,\n   * ignoring the cache and fetching fresh data from the server.\n   * Similar to Next.js's `router.refresh()` behavior.\n   */\n  revalidate?: boolean;\n};\n\nexport async function getRouteData(\n  url: string,\n  options?: GetRouteDataOptions\n): Promise<RouteData> {\n  const key = buildDataUrl(url);\n\n  // If revalidation is requested, remove the entry from cache\n  if (options?.revalidate) {\n    deleteCacheEntry(key);\n  }\n\n  const entry = dataCache.get(key);\n\n  if (entry) {\n    if (entry.status === \"fulfilled\") {\n      // Update LRU: mark as recently used\n      updateLRU(key);\n      return entry.value;\n    }\n    if (entry.status === \"pending\") {\n      return entry.promise;\n    }\n  }\n\n  // No entry in cache, fetch it\n  const promise = fetchRouteDataOnce(url)\n    .then((value) => {\n      setCacheEntry(key, { status: \"fulfilled\", value });\n      return value;\n    })\n    .catch((error) => {\n      console.error(\"[client][cache] Error fetching route data:\", error);\n      dataCache.set(key, { status: \"rejected\", error });\n      throw error;\n    });\n\n  dataCache.set(key, { status: \"pending\", promise });\n  return promise;\n}\n"],"mappings":"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","names":[]}

package/dist/react/cache.d.mts

@@ -0,0 +1,59 @@
+type RouteData = {
+    ok: boolean;
+    status: number;
+    json: any;
+};
+/**
+ * Revalidates route data by removing it from the cache.
+ * The next time you navigate to this route, fresh data will be fetched from the server.
+ * This is a client-side function and does not require a server-side revalidation.
+ *
+ * @param path - The route path to revalidate (e.g., '/posts/1' or '/posts/1?page=2')
+ *               If query params are not included, revalidates all variants of that route.
+ *
+ * @example
+ * ```ts
+ * // After saving something to the DB, revalidate the route
+ * await saveToDatabase(data);
+ * revalidatePath('/posts');
+ *
+ * // Revalidate a specific route with query params
+ * revalidatePath('/posts?page=2');
+ * ```
+ */
+declare function revalidatePath(path: string): void;
+/**
+ * Revalidates and refreshes the current page data.
+ * Similar to Next.js's `router.refresh()`.
+ *
+ * This function:
+ * 1. Removes the current route from cache
+ * 2. Fetches fresh data from the server
+ * 3. Updates window.__FW_DATA__ with the new data
+ * 4. Dispatches a 'fw-data-refresh' event for components to listen to
+ *
+ * @returns Promise that resolves with the fresh route data
+ *
+ * @example
+ * ```ts
+ * // Refresh current page data after a mutation
+ * await revalidate();
+ * ```
+ */
+declare function revalidate(): Promise<RouteData>;
+/**
+ * @deprecated Use `revalidatePath()` instead. This function is kept for backwards compatibility.
+ */
+declare function revalidateRouteData(url: string): void;
+declare function prefetchRouteData(url: string): void;
+type GetRouteDataOptions = {
+    /**
+     * If true, forces revalidation of route data,
+     * ignoring the cache and fetching fresh data from the server.
+     * Similar to Next.js's `router.refresh()` behavior.
+     */
+    revalidate?: boolean;
+};
+declare function getRouteData(url: string, options?: GetRouteDataOptions): Promise<RouteData>;
+
+export { type GetRouteDataOptions, getRouteData, prefetchRouteData, revalidate, revalidatePath, revalidateRouteData };

package/dist/react/cache.d.ts

@@ -0,0 +1,59 @@
+type RouteData = {
+    ok: boolean;
+    status: number;
+    json: any;
+};
+/**
+ * Revalidates route data by removing it from the cache.
+ * The next time you navigate to this route, fresh data will be fetched from the server.
+ * This is a client-side function and does not require a server-side revalidation.
+ *
+ * @param path - The route path to revalidate (e.g., '/posts/1' or '/posts/1?page=2')
+ *               If query params are not included, revalidates all variants of that route.
+ *
+ * @example
+ * ```ts
+ * // After saving something to the DB, revalidate the route
+ * await saveToDatabase(data);
+ * revalidatePath('/posts');
+ *
+ * // Revalidate a specific route with query params
+ * revalidatePath('/posts?page=2');
+ * ```
+ */
+declare function revalidatePath(path: string): void;
+/**
+ * Revalidates and refreshes the current page data.
+ * Similar to Next.js's `router.refresh()`.
+ *
+ * This function:
+ * 1. Removes the current route from cache
+ * 2. Fetches fresh data from the server
+ * 3. Updates window.__FW_DATA__ with the new data
+ * 4. Dispatches a 'fw-data-refresh' event for components to listen to
+ *
+ * @returns Promise that resolves with the fresh route data
+ *
+ * @example
+ * ```ts
+ * // Refresh current page data after a mutation
+ * await revalidate();
+ * ```
+ */
+declare function revalidate(): Promise<RouteData>;
+/**
+ * @deprecated Use `revalidatePath()` instead. This function is kept for backwards compatibility.
+ */
+declare function revalidateRouteData(url: string): void;
+declare function prefetchRouteData(url: string): void;
+type GetRouteDataOptions = {
+    /**
+     * If true, forces revalidation of route data,
+     * ignoring the cache and fetching fresh data from the server.
+     * Similar to Next.js's `router.refresh()` behavior.
+     */
+    revalidate?: boolean;
+};
+declare function getRouteData(url: string, options?: GetRouteDataOptions): Promise<RouteData>;
+
+export { type GetRouteDataOptions, getRouteData, prefetchRouteData, revalidate, revalidatePath, revalidateRouteData };

package/dist/react/cache.js

@@ -0,0 +1,220 @@
+// modules/react/cache/client-data-cache/index.ts
+var CACHE_KEY = "__FW_DATA_CACHE__";
+var MAX_CACHE_SIZE = 100;
+function getCacheStore() {
+  if (typeof window !== "undefined") {
+    if (!window[CACHE_KEY]) {
+      window[CACHE_KEY] = {
+        data: /* @__PURE__ */ new Map(),
+        index: /* @__PURE__ */ new Map(),
+        lru: []
+      };
+    }
+    return window[CACHE_KEY];
+  }
+  return {
+    data: /* @__PURE__ */ new Map(),
+    index: /* @__PURE__ */ new Map(),
+    lru: []
+  };
+}
+var cacheStore = getCacheStore();
+var dataCache = cacheStore.data;
+var pathIndex = cacheStore.index;
+var lru = cacheStore.lru;
+function extractPathBase(key) {
+  return key.split("?")[0];
+}
+function addToIndex(key) {
+  const pathBase = extractPathBase(key);
+  if (!pathIndex.has(pathBase)) {
+    pathIndex.set(pathBase, /* @__PURE__ */ new Set());
+  }
+  pathIndex.get(pathBase).add(key);
+}
+function removeFromIndex(key) {
+  const pathBase = extractPathBase(key);
+  const keys = pathIndex.get(pathBase);
+  if (keys) {
+    keys.delete(key);
+    if (keys.size === 0) {
+      pathIndex.delete(pathBase);
+    }
+  }
+}
+function updateLRU(key) {
+  const index = lru.indexOf(key);
+  if (index !== -1) {
+    lru.splice(index, 1);
+  }
+  lru.push(key);
+}
+function evictOldest() {
+  while (lru.length >= MAX_CACHE_SIZE && lru.length > 0) {
+    const oldestKey = lru.shift();
+    dataCache.delete(oldestKey);
+    removeFromIndex(oldestKey);
+  }
+}
+function setCacheEntry(key, entry) {
+  const existingEntry = dataCache.get(key);
+  const wasFulfilled = existingEntry?.status === "fulfilled";
+  dataCache.set(key, entry);
+  if (entry.status === "fulfilled") {
+    if (!wasFulfilled) {
+      addToIndex(key);
+    }
+    updateLRU(key);
+    evictOldest();
+  } else if (wasFulfilled) {
+    removeFromIndex(key);
+  }
+}
+function deleteCacheEntry(key) {
+  if (dataCache.has(key)) {
+    dataCache.delete(key);
+    removeFromIndex(key);
+    const lruIndex = lru.indexOf(key);
+    if (lruIndex !== -1) {
+      lru.splice(lruIndex, 1);
+    }
+  }
+}
+function buildDataUrl(url) {
+  return url + (url.includes("?") ? "&" : "?") + "__fw_data=1";
+}
+async function fetchRouteDataOnce(url) {
+  const dataUrl = buildDataUrl(url);
+  const res = await fetch(dataUrl, {
+    headers: {
+      "x-fw-data": "1",
+      Accept: "application/json"
+    }
+  });
+  let json = {};
+  try {
+    const text = await res.text();
+    if (text) {
+      json = JSON.parse(text);
+    }
+  } catch (parseError) {
+    console.error(
+      "[client][cache] Failed to parse response as JSON:",
+      parseError
+    );
+  }
+  const result = {
+    ok: res.ok,
+    status: res.status,
+    json
+  };
+  return result;
+}
+function revalidatePath(path) {
+  const normalizedPath = path.split("?")[0];
+  const hasQueryParams = path.includes("?");
+  const keysForPath = pathIndex.get(normalizedPath);
+  if (!keysForPath || keysForPath.size === 0) {
+    return;
+  }
+  let specificQueryParams;
+  if (hasQueryParams) {
+    const queryPart = path.split("?")[1];
+    specificQueryParams = queryPart.split("&").filter((p) => !p.startsWith("__fw_data=")).sort().join("&");
+  }
+  const keysToDelete = [];
+  for (const key of keysForPath) {
+    if (hasQueryParams && specificQueryParams) {
+      const [, keyQuery = ""] = key.split("?");
+      const keyQueryParams = keyQuery.split("&").filter((p) => !p.startsWith("__fw_data=")).sort().join("&");
+      if (keyQueryParams === specificQueryParams) {
+        keysToDelete.push(key);
+      }
+    } else {
+      keysToDelete.push(key);
+    }
+  }
+  keysToDelete.forEach((key) => {
+    deleteCacheEntry(key);
+  });
+}
+async function revalidate() {
+  if (typeof window === "undefined") {
+    throw new Error("revalidate() can only be called on the client");
+  }
+  const pathname = window.location.pathname + window.location.search;
+  revalidatePath(pathname);
+  const freshData = await getRouteData(pathname, { revalidate: true });
+  if (window.__FW_DATA__ && freshData.ok && freshData.json) {
+    const currentData = window.__FW_DATA__;
+    window.__FW_DATA__ = {
+      ...currentData,
+      pathname: pathname.split("?")[0],
+      params: freshData.json.params || currentData.params || {},
+      props: freshData.json.props || currentData.props || {},
+      metadata: freshData.json.metadata ?? currentData.metadata ?? null,
+      notFound: freshData.json.notFound ?? false,
+      error: freshData.json.error ?? false
+    };
+    window.dispatchEvent(new CustomEvent("fw-data-refresh", {
+      detail: { data: freshData }
+    }));
+  }
+  return freshData;
+}
+function revalidateRouteData(url) {
+  revalidatePath(url);
+}
+function prefetchRouteData(url) {
+  const key = buildDataUrl(url);
+  const cached = dataCache.get(key);
+  if (cached && cached.status !== "rejected") {
+    if (cached.status === "fulfilled") {
+      updateLRU(key);
+    }
+    return;
+  }
+  const promise = fetchRouteDataOnce(url).then((value) => {
+    setCacheEntry(key, { status: "fulfilled", value });
+    return value;
+  }).catch((error) => {
+    console.error("[client][cache] Error prefetching route data:", error);
+    dataCache.set(key, { status: "rejected", error });
+    throw error;
+  });
+  dataCache.set(key, { status: "pending", promise });
+}
+async function getRouteData(url, options) {
+  const key = buildDataUrl(url);
+  if (options?.revalidate) {
+    deleteCacheEntry(key);
+  }
+  const entry = dataCache.get(key);
+  if (entry) {
+    if (entry.status === "fulfilled") {
+      updateLRU(key);
+      return entry.value;
+    }
+    if (entry.status === "pending") {
+      return entry.promise;
+    }
+  }
+  const promise = fetchRouteDataOnce(url).then((value) => {
+    setCacheEntry(key, { status: "fulfilled", value });
+    return value;
+  }).catch((error) => {
+    console.error("[client][cache] Error fetching route data:", error);
+    dataCache.set(key, { status: "rejected", error });
+    throw error;
+  });
+  dataCache.set(key, { status: "pending", promise });
+  return promise;
+}
+export {
+  getRouteData,
+  prefetchRouteData,
+  revalidate,
+  revalidatePath,
+  revalidateRouteData
+};
+//# sourceMappingURL=cache.js.map

package/dist/react/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/react/cache/client-data-cache/index.ts"],"sourcesContent":["type RouteData = {\n  ok: boolean;\n  status: number;\n  json: any;\n};\n\ntype CacheEntry =\n  | { status: \"pending\"; promise: Promise<RouteData> }\n  | { status: \"fulfilled\"; value: RouteData }\n  | { status: \"rejected\"; error: any };\n\n// Use window to guarantee a single shared cache instance\n// across all bundles/modules\nconst CACHE_KEY = \"__FW_DATA_CACHE__\";\n\n// Maximum number of entries in the cache (LRU)\nconst MAX_CACHE_SIZE = 100;\n\ntype CacheStore = {\n  data: Map<string, CacheEntry>;\n  index: Map<string, Set<string>>; // pathBase -> Set of keys\n  lru: string[]; // Ordered list: most recent at end, oldest at start\n};\n\nfunction getCacheStore(): CacheStore {\n  if (typeof window !== \"undefined\") {\n    if (!(window as any)[CACHE_KEY]) {\n      (window as any)[CACHE_KEY] = {\n        data: new Map<string, CacheEntry>(),\n        index: new Map<string, Set<string>>(),\n        lru: [],\n      };\n    }\n    return (window as any)[CACHE_KEY];\n  }\n  // Fallback for SSR (though this shouldn't be used on the client)\n  return {\n    data: new Map<string, CacheEntry>(),\n    index: new Map<string, Set<string>>(),\n    lru: [],\n  };\n}\n\nconst cacheStore = getCacheStore();\nconst dataCache = cacheStore.data;\nconst pathIndex = cacheStore.index;\nconst lru = cacheStore.lru;\n\n// Helper functions for cache management\n\n/**\n * Extract base path from a cache key (removes query params)\n */\nfunction extractPathBase(key: string): string {\n  return key.split(\"?\")[0];\n}\n\n/**\n * Add key to path index\n */\nfunction addToIndex(key: string): void {\n  const pathBase = extractPathBase(key);\n  if (!pathIndex.has(pathBase)) {\n    pathIndex.set(pathBase, new Set());\n  }\n  pathIndex.get(pathBase)!.add(key);\n}\n\n/**\n * Remove key from path index\n */\nfunction removeFromIndex(key: string): void {\n  const pathBase = extractPathBase(key);\n  const keys = pathIndex.get(pathBase);\n  if (keys) {\n    keys.delete(key);\n    if (keys.size === 0) {\n      pathIndex.delete(pathBase);\n    }\n  }\n}\n\n/**\n * Update LRU order - move key to end (most recent)\n */\nfunction updateLRU(key: string): void {\n  const index = lru.indexOf(key);\n  if (index !== -1) {\n    lru.splice(index, 1);\n  }\n  lru.push(key);\n}\n\n/**\n * Remove oldest entries if cache exceeds MAX_CACHE_SIZE\n */\nfunction evictOldest(): void {\n  while (lru.length >= MAX_CACHE_SIZE && lru.length > 0) {\n    const oldestKey = lru.shift()!;\n    dataCache.delete(oldestKey);\n    removeFromIndex(oldestKey);\n  }\n}\n\n/**\n * Set cache entry and maintain indexes\n */\nfunction setCacheEntry(key: string, entry: CacheEntry): void {\n  const existingEntry = dataCache.get(key);\n  const wasFulfilled = existingEntry?.status === \"fulfilled\";\n  \n  dataCache.set(key, entry);\n  \n  // Only track fulfilled entries in LRU and index (not pending/rejected)\n  if (entry.status === \"fulfilled\") {\n    // Add to index if it wasn't already fulfilled (new entry or transition from pending/rejected)\n    if (!wasFulfilled) {\n      addToIndex(key);\n    }\n    updateLRU(key);\n    evictOldest();\n  } else if (wasFulfilled) {\n    // If entry was fulfilled and now isn't (transitioning to pending/rejected), remove from index\n    removeFromIndex(key);\n  }\n}\n\n/**\n * Delete cache entry and clean up indexes\n */\nfunction deleteCacheEntry(key: string): void {\n  if (dataCache.has(key)) {\n    dataCache.delete(key);\n    removeFromIndex(key);\n    const lruIndex = lru.indexOf(key);\n    if (lruIndex !== -1) {\n      lru.splice(lruIndex, 1);\n    }\n  }\n}\n\nfunction buildDataUrl(url: string): string {\n  return url + (url.includes(\"?\") ? \"&\" : \"?\") + \"__fw_data=1\";\n}\n\nasync function fetchRouteDataOnce(url: string): Promise<RouteData> {\n  const dataUrl = buildDataUrl(url);\n\n  const res = await fetch(dataUrl, {\n    headers: {\n      \"x-fw-data\": \"1\",\n      Accept: \"application/json\",\n    },\n  });\n\n  let json: any = {};\n\n  try {\n    const text = await res.text();\n    if (text) {\n      json = JSON.parse(text);\n    }\n  } catch (parseError) {\n    console.error(\n      \"[client][cache] Failed to parse response as JSON:\",\n      parseError\n    );\n  }\n\n  const result: RouteData = {\n    ok: res.ok,\n    status: res.status,\n    json,\n  };\n\n  return result;\n}\n\n/**\n * Revalidates route data by removing it from the cache.\n * The next time you navigate to this route, fresh data will be fetched from the server.\n * This is a client-side function and does not require a server-side revalidation.\n *\n * @param path - The route path to revalidate (e.g., '/posts/1' or '/posts/1?page=2')\n *               If query params are not included, revalidates all variants of that route.\n *\n * @example\n * ```ts\n * // After saving something to the DB, revalidate the route\n * await saveToDatabase(data);\n * revalidatePath('/posts');\n * \n * // Revalidate a specific route with query params\n * revalidatePath('/posts?page=2');\n * ```\n */\nexport function revalidatePath(path: string): void {\n  // Normalize the base path (without query params)\n  const normalizedPath = path.split(\"?\")[0];\n  const hasQueryParams = path.includes(\"?\");\n  \n  // Get all keys for this path base from index (O(1) lookup)\n  const keysForPath = pathIndex.get(normalizedPath);\n  \n  if (!keysForPath || keysForPath.size === 0) {\n    return; // No entries to revalidate\n  }\n  \n  // If the path includes specific query params, extract them\n  let specificQueryParams: string | undefined;\n  if (hasQueryParams) {\n    const queryPart = path.split(\"?\")[1];\n    // Sort query params for consistent comparison\n    specificQueryParams = queryPart\n      .split(\"&\")\n      .filter((p) => !p.startsWith(\"__fw_data=\"))\n      .sort()\n      .join(\"&\");\n  }\n  \n  // Iterate only over keys for this path (much smaller set)\n  const keysToDelete: string[] = [];\n  for (const key of keysForPath) {\n    // If specific query params were specified, check if they match\n    if (hasQueryParams && specificQueryParams) {\n      const [, keyQuery = \"\"] = key.split(\"?\");\n      const keyQueryParams = keyQuery\n        .split(\"&\")\n        .filter((p) => !p.startsWith(\"__fw_data=\"))\n        .sort()\n        .join(\"&\");\n      \n      if (keyQueryParams === specificQueryParams) {\n        keysToDelete.push(key);\n      }\n    } else {\n      // If no specific query params, revalidate all variants\n      keysToDelete.push(key);\n    }\n  }\n  \n  // Delete matching entries\n  keysToDelete.forEach((key) => {\n    deleteCacheEntry(key);\n  });\n}\n\n/**\n * Revalidates and refreshes the current page data.\n * Similar to Next.js's `router.refresh()`.\n * \n * This function:\n * 1. Removes the current route from cache\n * 2. Fetches fresh data from the server\n * 3. Updates window.__FW_DATA__ with the new data\n * 4. Dispatches a 'fw-data-refresh' event for components to listen to\n * \n * @returns Promise that resolves with the fresh route data\n * \n * @example\n * ```ts\n * // Refresh current page data after a mutation\n * await revalidate();\n * ```\n */\nexport async function revalidate(): Promise<RouteData> {\n  if (typeof window === \"undefined\") {\n    throw new Error(\"revalidate() can only be called on the client\");\n  }\n\n  const pathname = window.location.pathname + window.location.search;\n  \n  // Revalidate the path (remove from cache)\n  revalidatePath(pathname);\n  \n  // Fetch fresh data\n  const freshData = await getRouteData(pathname, { revalidate: true });\n  \n  // Update window.__FW_DATA__ if it exists\n  if ((window as any).__FW_DATA__ && freshData.ok && freshData.json) {\n    const currentData = (window as any).__FW_DATA__;\n    (window as any).__FW_DATA__ = {\n      ...currentData,\n      pathname: pathname.split(\"?\")[0],\n      params: freshData.json.params || currentData.params || {},\n      props: freshData.json.props || currentData.props || {},\n      metadata: freshData.json.metadata ?? currentData.metadata ?? null,\n      notFound: freshData.json.notFound ?? false,\n      error: freshData.json.error ?? false,\n    };\n    \n    // Dispatch event for components to listen to\n    window.dispatchEvent(new CustomEvent(\"fw-data-refresh\", {\n      detail: { data: freshData },\n    }));\n  }\n  \n  return freshData;\n}\n\n/**\n * @deprecated Use `revalidatePath()` instead. This function is kept for backwards compatibility.\n */\nexport function revalidateRouteData(url: string): void {\n  revalidatePath(url);\n}\n\nexport function prefetchRouteData(url: string): void {\n  const key = buildDataUrl(url);\n\n  const cached = dataCache.get(key);\n\n  if (cached && cached.status !== \"rejected\") {\n    // Update LRU if it exists and is fulfilled\n    if (cached.status === \"fulfilled\") {\n      updateLRU(key);\n    }\n    return;\n  }\n\n  const promise = fetchRouteDataOnce(url)\n    .then((value) => {\n      setCacheEntry(key, { status: \"fulfilled\", value });\n      return value;\n    })\n    .catch((error) => {\n      console.error(\"[client][cache] Error prefetching route data:\", error);\n      dataCache.set(key, { status: \"rejected\", error });\n      throw error;\n    });\n\n  dataCache.set(key, { status: \"pending\", promise });\n}\n\nexport type GetRouteDataOptions = {\n  /**\n   * If true, forces revalidation of route data,\n   * ignoring the cache and fetching fresh data from the server.\n   * Similar to Next.js's `router.refresh()` behavior.\n   */\n  revalidate?: boolean;\n};\n\nexport async function getRouteData(\n  url: string,\n  options?: GetRouteDataOptions\n): Promise<RouteData> {\n  const key = buildDataUrl(url);\n\n  // If revalidation is requested, remove the entry from cache\n  if (options?.revalidate) {\n    deleteCacheEntry(key);\n  }\n\n  const entry = dataCache.get(key);\n\n  if (entry) {\n    if (entry.status === \"fulfilled\") {\n      // Update LRU: mark as recently used\n      updateLRU(key);\n      return entry.value;\n    }\n    if (entry.status === \"pending\") {\n      return entry.promise;\n    }\n  }\n\n  // No entry in cache, fetch it\n  const promise = fetchRouteDataOnce(url)\n    .then((value) => {\n      setCacheEntry(key, { status: \"fulfilled\", value });\n      return value;\n    })\n    .catch((error) => {\n      console.error(\"[client][cache] Error fetching route data:\", error);\n      dataCache.set(key, { status: \"rejected\", error });\n      throw error;\n    });\n\n  dataCache.set(key, { status: \"pending\", promise });\n  return promise;\n}\n"],"mappings":"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","names":[]}