@hookraft/userequest 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -0,0 +1,213 @@
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  clearAll: () => clearAll,
+  useRequest: () => useRequest
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/useRequest.ts
+var import_react = require("react");
+
+// src/store.ts
+var cache = /* @__PURE__ */ new Map();
+var inFlight = /* @__PURE__ */ new Map();
+function getCached(key, cacheTime) {
+  const entry = cache.get(key);
+  if (!entry) return null;
+  if (cacheTime === 0) return null;
+  const isStale = Date.now() - entry.timestamp > cacheTime;
+  if (isStale) {
+    cache.delete(key);
+    return null;
+  }
+  return entry.data;
+}
+function setCached(key, data) {
+  cache.set(key, { data, timestamp: Date.now() });
+}
+function clearCached(key) {
+  cache.delete(key);
+}
+function getInFlight(key) {
+  const entry = inFlight.get(key);
+  if (!entry) return null;
+  entry.subscribers++;
+  return entry.promise;
+}
+function setInFlight(key, promise) {
+  inFlight.set(key, { promise, subscribers: 1 });
+}
+function clearInFlight(key) {
+  inFlight.delete(key);
+}
+function clearAll() {
+  cache.clear();
+  inFlight.clear();
+}
+
+// src/useRequest.ts
+var defaultFetcher = (key) => fetch(key).then((res) => {
+  if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`);
+  return res.json();
+});
+function useRequest(key, options = {}) {
+  const {
+    fetcher = defaultFetcher,
+    cacheTime = 3e4,
+    dedupe = true,
+    manual = false,
+    onSuccess,
+    onError,
+    onStatusChange
+  } = options;
+  const [data, setData] = (0, import_react.useState)(() => {
+    var _a;
+    if (!key) return void 0;
+    return (_a = getCached(key, cacheTime)) != null ? _a : void 0;
+  });
+  const [status, setStatus] = (0, import_react.useState)(() => {
+    if (!key) return "idle";
+    const cached = getCached(key, cacheTime);
+    return cached !== null ? "success" : "idle";
+  });
+  const [error, setError] = (0, import_react.useState)(void 0);
+  const mountedRef = (0, import_react.useRef)(true);
+  const onSuccessRef = (0, import_react.useRef)(onSuccess);
+  const onErrorRef = (0, import_react.useRef)(onError);
+  const onStatusChangeRef = (0, import_react.useRef)(onStatusChange);
+  (0, import_react.useEffect)(() => {
+    onSuccessRef.current = onSuccess;
+  }, [onSuccess]);
+  (0, import_react.useEffect)(() => {
+    onErrorRef.current = onError;
+  }, [onError]);
+  (0, import_react.useEffect)(() => {
+    onStatusChangeRef.current = onStatusChange;
+  }, [onStatusChange]);
+  (0, import_react.useEffect)(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const updateStatus = (0, import_react.useCallback)((next) => {
+    var _a;
+    if (!mountedRef.current) return;
+    setStatus(next);
+    (_a = onStatusChangeRef.current) == null ? void 0 : _a.call(onStatusChangeRef, next);
+  }, []);
+  const execute = (0, import_react.useCallback)(
+    async (forceRefresh = false) => {
+      var _a, _b, _c, _d;
+      if (!key) return;
+      if (!forceRefresh) {
+        const cached = getCached(key, cacheTime);
+        if (cached !== null) {
+          if (mountedRef.current) {
+            setData(cached);
+            updateStatus("success");
+          }
+          return;
+        }
+      } else {
+        clearCached(key);
+      }
+      if (dedupe) {
+        const existing = getInFlight(key);
+        if (existing) {
+          updateStatus("loading");
+          try {
+            const result = await existing;
+            if (!mountedRef.current) return;
+            setData(result);
+            updateStatus("success");
+            (_a = onSuccessRef.current) == null ? void 0 : _a.call(onSuccessRef, result);
+          } catch (err) {
+            if (!mountedRef.current) return;
+            setError(err);
+            updateStatus("error");
+            (_b = onErrorRef.current) == null ? void 0 : _b.call(onErrorRef, err);
+          }
+          return;
+        }
+      }
+      updateStatus("loading");
+      const promise = fetcher(key);
+      if (dedupe) {
+        setInFlight(key, promise);
+      }
+      try {
+        const result = await promise;
+        setCached(key, result);
+        clearInFlight(key);
+        if (!mountedRef.current) return;
+        setData(result);
+        setError(void 0);
+        updateStatus("success");
+        (_c = onSuccessRef.current) == null ? void 0 : _c.call(onSuccessRef, result);
+      } catch (err) {
+        clearInFlight(key);
+        if (!mountedRef.current) return;
+        setError(err);
+        updateStatus("error");
+        (_d = onErrorRef.current) == null ? void 0 : _d.call(onErrorRef, err);
+      }
+    },
+    [key, cacheTime, dedupe, fetcher, updateStatus]
+  );
+  (0, import_react.useEffect)(() => {
+    if (!key || manual) return;
+    execute();
+  }, [key, manual, execute]);
+  const refetch = (0, import_react.useCallback)(async () => {
+    await execute(true);
+  }, [execute]);
+  const clear = (0, import_react.useCallback)(() => {
+    if (!key) return;
+    clearCached(key);
+    setData(void 0);
+    setError(void 0);
+    updateStatus("idle");
+  }, [key, updateStatus]);
+  const is = (0, import_react.useCallback)(
+    (s) => status === s,
+    [status]
+  );
+  return {
+    data,
+    status,
+    error,
+    isLoading: status === "loading",
+    isSuccess: status === "success",
+    isError: status === "error",
+    is,
+    refetch,
+    clear
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearAll,
+  useRequest
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/useRequest.ts","../src/store.ts"],"sourcesContent":["export { useRequest } from \"./useRequest\"\nexport { clearAll } from \"./store\"\nexport type {\n  RequestStatus,\n  UseRequestOptions,\n  UseRequestReturn,\n  CacheEntry,\n} from \"./types\"","import { useState, useEffect, useCallback, useRef } from \"react\"\nimport {\n  getCached,\n  setCached,\n  clearCached,\n  getInFlight,\n  setInFlight,\n  clearInFlight,\n} from \"./store\"\nimport type {\n  RequestStatus,\n  UseRequestOptions,\n  UseRequestReturn,\n} from \"./types\"\n\nconst defaultFetcher = (key: string) =>\n  fetch(key).then((res) => {\n    if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`)\n    return res.json()\n  })\n\n/**\n * useRequest\n *\n * A deduplication-first data fetching hook.\n * Multiple components requesting the same key at the same time\n * will share a single in-flight request — not fire multiple.\n *\n * All caching is in-memory only (JS RAM). Nothing is written\n * to localStorage, sessionStorage, or any browser storage.\n *\n * @example\n * // All three components share ONE network request\n * const { data } = useRequest(\"/api/user\")\n * const { data } = useRequest(\"/api/user\")\n * const { data } = useRequest(\"/api/user\")\n */\nexport function useRequest<T = unknown>(\n  key: string | null,\n  options: UseRequestOptions<T> = {}\n): UseRequestReturn<T> {\n  const {\n    fetcher = defaultFetcher as (key: string) => Promise<T>,\n    cacheTime = 30_000,\n    dedupe = true,\n    manual = false,\n    onSuccess,\n    onError,\n    onStatusChange,\n  } = options\n\n  const [data, setData] = useState<T | undefined>(() => {\n    if (!key) return undefined\n    return getCached<T>(key, cacheTime) ?? undefined\n  })\n  const [status, setStatus] = useState<RequestStatus>(() => {\n    if (!key) return \"idle\"\n    const cached = getCached<T>(key, cacheTime)\n    return cached !== null ? \"success\" : \"idle\"\n  })\n  const [error, setError] = useState<unknown>(undefined)\n\n  const mountedRef = useRef(true)\n  const onSuccessRef = useRef(onSuccess)\n  const onErrorRef = useRef(onError)\n  const onStatusChangeRef = useRef(onStatusChange)\n\n  // Keep callback refs fresh without causing re-runs\n  useEffect(() => { onSuccessRef.current = onSuccess }, [onSuccess])\n  useEffect(() => { onErrorRef.current = onError }, [onError])\n  useEffect(() => { onStatusChangeRef.current = onStatusChange }, [onStatusChange])\n\n  useEffect(() => {\n    mountedRef.current = true\n    return () => { mountedRef.current = false }\n  }, [])\n\n  const updateStatus = useCallback((next: RequestStatus) => {\n    if (!mountedRef.current) return\n    setStatus(next)\n    onStatusChangeRef.current?.(next)\n  }, [])\n\n  const execute = useCallback(\n    async (forceRefresh = false): Promise<void> => {\n      if (!key) return\n\n      // Check cache first (unless force refreshing)\n      if (!forceRefresh) {\n        const cached = getCached<T>(key, cacheTime)\n        if (cached !== null) {\n          if (mountedRef.current) {\n            setData(cached)\n            updateStatus(\"success\")\n          }\n          return\n        }\n      } else {\n        clearCached(key)\n      }\n\n      // Check for an in-flight request for this key\n      if (dedupe) {\n        const existing = getInFlight<T>(key)\n        if (existing) {\n          updateStatus(\"loading\")\n          try {\n            const result = await existing\n            if (!mountedRef.current) return\n            setData(result)\n            updateStatus(\"success\")\n            onSuccessRef.current?.(result)\n          } catch (err) {\n            if (!mountedRef.current) return\n            setError(err)\n            updateStatus(\"error\")\n            onErrorRef.current?.(err)\n          }\n          return\n        }\n      }\n\n      // No cache, no in-flight — fire a new request\n      updateStatus(\"loading\")\n\n      const promise = fetcher(key)\n\n      if (dedupe) {\n        setInFlight(key, promise)\n      }\n\n      try {\n        const result = await promise\n        setCached(key, result)\n        clearInFlight(key)\n\n        if (!mountedRef.current) return\n        setData(result)\n        setError(undefined)\n        updateStatus(\"success\")\n        onSuccessRef.current?.(result)\n      } catch (err) {\n        clearInFlight(key)\n\n        if (!mountedRef.current) return\n        setError(err)\n        updateStatus(\"error\")\n        onErrorRef.current?.(err)\n      }\n    },\n    [key, cacheTime, dedupe, fetcher, updateStatus]\n  )\n\n  // Auto-fetch on mount unless manual mode\n  useEffect(() => {\n    if (!key || manual) return\n    execute()\n  }, [key, manual, execute])\n\n  const refetch = useCallback(async () => {\n    await execute(true)\n  }, [execute])\n\n  const clear = useCallback(() => {\n    if (!key) return\n    clearCached(key)\n    setData(undefined)\n    setError(undefined)\n    updateStatus(\"idle\")\n  }, [key, updateStatus])\n\n  const is = useCallback(\n    (s: RequestStatus) => status === s,\n    [status]\n  )\n\n  return {\n    data,\n    status,\n    error,\n    isLoading: status === \"loading\",\n    isSuccess: status === \"success\",\n    isError: status === \"error\",\n    is,\n    refetch,\n    clear,\n  }\n}","import type { CacheEntry, InFlightEntry } from \"./types\"\n\n/**\n * Global in-memory cache — lives in JS RAM only.\n * Never touches localStorage, sessionStorage, or any browser storage.\n * Cleared automatically when the page refreshes or tab closes.\n */\nconst cache = new Map<string, CacheEntry<unknown>>()\n\n/**\n * In-flight registry — tracks requests currently in progress.\n * If a request for the same key is already in flight,\n * new subscribers attach to the existing Promise instead of firing a new request.\n */\nconst inFlight = new Map<string, InFlightEntry<unknown>>()\n\nexport function getCached<T>(key: string, cacheTime: number): T | null {\n  const entry = cache.get(key) as CacheEntry<T> | undefined\n  if (!entry) return null\n  if (cacheTime === 0) return null\n  const isStale = Date.now() - entry.timestamp > cacheTime\n  if (isStale) {\n    cache.delete(key)\n    return null\n  }\n  return entry.data\n}\n\nexport function setCached<T>(key: string, data: T): void {\n  cache.set(key, { data, timestamp: Date.now() })\n}\n\nexport function clearCached(key: string): void {\n  cache.delete(key)\n}\n\nexport function getInFlight<T>(key: string): Promise<T> | null {\n  const entry = inFlight.get(key) as InFlightEntry<T> | undefined\n  if (!entry) return null\n  entry.subscribers++\n  return entry.promise\n}\n\nexport function setInFlight<T>(key: string, promise: Promise<T>): void {\n  inFlight.set(key, { promise: promise as Promise<unknown>, subscribers: 1 })\n}\n\nexport function clearInFlight(key: string): void {\n  inFlight.delete(key)\n}\n\nexport function clearAll(): void {\n  cache.clear()\n  inFlight.clear()\n}"],"mappings":"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","names":[]}

package/dist/index.js

@@ -0,0 +1,185 @@
+// src/useRequest.ts
+import { useState, useEffect, useCallback, useRef } from "react";
+
+// src/store.ts
+var cache = /* @__PURE__ */ new Map();
+var inFlight = /* @__PURE__ */ new Map();
+function getCached(key, cacheTime) {
+  const entry = cache.get(key);
+  if (!entry) return null;
+  if (cacheTime === 0) return null;
+  const isStale = Date.now() - entry.timestamp > cacheTime;
+  if (isStale) {
+    cache.delete(key);
+    return null;
+  }
+  return entry.data;
+}
+function setCached(key, data) {
+  cache.set(key, { data, timestamp: Date.now() });
+}
+function clearCached(key) {
+  cache.delete(key);
+}
+function getInFlight(key) {
+  const entry = inFlight.get(key);
+  if (!entry) return null;
+  entry.subscribers++;
+  return entry.promise;
+}
+function setInFlight(key, promise) {
+  inFlight.set(key, { promise, subscribers: 1 });
+}
+function clearInFlight(key) {
+  inFlight.delete(key);
+}
+function clearAll() {
+  cache.clear();
+  inFlight.clear();
+}
+
+// src/useRequest.ts
+var defaultFetcher = (key) => fetch(key).then((res) => {
+  if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`);
+  return res.json();
+});
+function useRequest(key, options = {}) {
+  const {
+    fetcher = defaultFetcher,
+    cacheTime = 3e4,
+    dedupe = true,
+    manual = false,
+    onSuccess,
+    onError,
+    onStatusChange
+  } = options;
+  const [data, setData] = useState(() => {
+    var _a;
+    if (!key) return void 0;
+    return (_a = getCached(key, cacheTime)) != null ? _a : void 0;
+  });
+  const [status, setStatus] = useState(() => {
+    if (!key) return "idle";
+    const cached = getCached(key, cacheTime);
+    return cached !== null ? "success" : "idle";
+  });
+  const [error, setError] = useState(void 0);
+  const mountedRef = useRef(true);
+  const onSuccessRef = useRef(onSuccess);
+  const onErrorRef = useRef(onError);
+  const onStatusChangeRef = useRef(onStatusChange);
+  useEffect(() => {
+    onSuccessRef.current = onSuccess;
+  }, [onSuccess]);
+  useEffect(() => {
+    onErrorRef.current = onError;
+  }, [onError]);
+  useEffect(() => {
+    onStatusChangeRef.current = onStatusChange;
+  }, [onStatusChange]);
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const updateStatus = useCallback((next) => {
+    var _a;
+    if (!mountedRef.current) return;
+    setStatus(next);
+    (_a = onStatusChangeRef.current) == null ? void 0 : _a.call(onStatusChangeRef, next);
+  }, []);
+  const execute = useCallback(
+    async (forceRefresh = false) => {
+      var _a, _b, _c, _d;
+      if (!key) return;
+      if (!forceRefresh) {
+        const cached = getCached(key, cacheTime);
+        if (cached !== null) {
+          if (mountedRef.current) {
+            setData(cached);
+            updateStatus("success");
+          }
+          return;
+        }
+      } else {
+        clearCached(key);
+      }
+      if (dedupe) {
+        const existing = getInFlight(key);
+        if (existing) {
+          updateStatus("loading");
+          try {
+            const result = await existing;
+            if (!mountedRef.current) return;
+            setData(result);
+            updateStatus("success");
+            (_a = onSuccessRef.current) == null ? void 0 : _a.call(onSuccessRef, result);
+          } catch (err) {
+            if (!mountedRef.current) return;
+            setError(err);
+            updateStatus("error");
+            (_b = onErrorRef.current) == null ? void 0 : _b.call(onErrorRef, err);
+          }
+          return;
+        }
+      }
+      updateStatus("loading");
+      const promise = fetcher(key);
+      if (dedupe) {
+        setInFlight(key, promise);
+      }
+      try {
+        const result = await promise;
+        setCached(key, result);
+        clearInFlight(key);
+        if (!mountedRef.current) return;
+        setData(result);
+        setError(void 0);
+        updateStatus("success");
+        (_c = onSuccessRef.current) == null ? void 0 : _c.call(onSuccessRef, result);
+      } catch (err) {
+        clearInFlight(key);
+        if (!mountedRef.current) return;
+        setError(err);
+        updateStatus("error");
+        (_d = onErrorRef.current) == null ? void 0 : _d.call(onErrorRef, err);
+      }
+    },
+    [key, cacheTime, dedupe, fetcher, updateStatus]
+  );
+  useEffect(() => {
+    if (!key || manual) return;
+    execute();
+  }, [key, manual, execute]);
+  const refetch = useCallback(async () => {
+    await execute(true);
+  }, [execute]);
+  const clear = useCallback(() => {
+    if (!key) return;
+    clearCached(key);
+    setData(void 0);
+    setError(void 0);
+    updateStatus("idle");
+  }, [key, updateStatus]);
+  const is = useCallback(
+    (s) => status === s,
+    [status]
+  );
+  return {
+    data,
+    status,
+    error,
+    isLoading: status === "loading",
+    isSuccess: status === "success",
+    isError: status === "error",
+    is,
+    refetch,
+    clear
+  };
+}
+export {
+  clearAll,
+  useRequest
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useRequest.ts","../src/store.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useRef } from \"react\"\nimport {\n  getCached,\n  setCached,\n  clearCached,\n  getInFlight,\n  setInFlight,\n  clearInFlight,\n} from \"./store\"\nimport type {\n  RequestStatus,\n  UseRequestOptions,\n  UseRequestReturn,\n} from \"./types\"\n\nconst defaultFetcher = (key: string) =>\n  fetch(key).then((res) => {\n    if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`)\n    return res.json()\n  })\n\n/**\n * useRequest\n *\n * A deduplication-first data fetching hook.\n * Multiple components requesting the same key at the same time\n * will share a single in-flight request — not fire multiple.\n *\n * All caching is in-memory only (JS RAM). Nothing is written\n * to localStorage, sessionStorage, or any browser storage.\n *\n * @example\n * // All three components share ONE network request\n * const { data } = useRequest(\"/api/user\")\n * const { data } = useRequest(\"/api/user\")\n * const { data } = useRequest(\"/api/user\")\n */\nexport function useRequest<T = unknown>(\n  key: string | null,\n  options: UseRequestOptions<T> = {}\n): UseRequestReturn<T> {\n  const {\n    fetcher = defaultFetcher as (key: string) => Promise<T>,\n    cacheTime = 30_000,\n    dedupe = true,\n    manual = false,\n    onSuccess,\n    onError,\n    onStatusChange,\n  } = options\n\n  const [data, setData] = useState<T | undefined>(() => {\n    if (!key) return undefined\n    return getCached<T>(key, cacheTime) ?? undefined\n  })\n  const [status, setStatus] = useState<RequestStatus>(() => {\n    if (!key) return \"idle\"\n    const cached = getCached<T>(key, cacheTime)\n    return cached !== null ? \"success\" : \"idle\"\n  })\n  const [error, setError] = useState<unknown>(undefined)\n\n  const mountedRef = useRef(true)\n  const onSuccessRef = useRef(onSuccess)\n  const onErrorRef = useRef(onError)\n  const onStatusChangeRef = useRef(onStatusChange)\n\n  // Keep callback refs fresh without causing re-runs\n  useEffect(() => { onSuccessRef.current = onSuccess }, [onSuccess])\n  useEffect(() => { onErrorRef.current = onError }, [onError])\n  useEffect(() => { onStatusChangeRef.current = onStatusChange }, [onStatusChange])\n\n  useEffect(() => {\n    mountedRef.current = true\n    return () => { mountedRef.current = false }\n  }, [])\n\n  const updateStatus = useCallback((next: RequestStatus) => {\n    if (!mountedRef.current) return\n    setStatus(next)\n    onStatusChangeRef.current?.(next)\n  }, [])\n\n  const execute = useCallback(\n    async (forceRefresh = false): Promise<void> => {\n      if (!key) return\n\n      // Check cache first (unless force refreshing)\n      if (!forceRefresh) {\n        const cached = getCached<T>(key, cacheTime)\n        if (cached !== null) {\n          if (mountedRef.current) {\n            setData(cached)\n            updateStatus(\"success\")\n          }\n          return\n        }\n      } else {\n        clearCached(key)\n      }\n\n      // Check for an in-flight request for this key\n      if (dedupe) {\n        const existing = getInFlight<T>(key)\n        if (existing) {\n          updateStatus(\"loading\")\n          try {\n            const result = await existing\n            if (!mountedRef.current) return\n            setData(result)\n            updateStatus(\"success\")\n            onSuccessRef.current?.(result)\n          } catch (err) {\n            if (!mountedRef.current) return\n            setError(err)\n            updateStatus(\"error\")\n            onErrorRef.current?.(err)\n          }\n          return\n        }\n      }\n\n      // No cache, no in-flight — fire a new request\n      updateStatus(\"loading\")\n\n      const promise = fetcher(key)\n\n      if (dedupe) {\n        setInFlight(key, promise)\n      }\n\n      try {\n        const result = await promise\n        setCached(key, result)\n        clearInFlight(key)\n\n        if (!mountedRef.current) return\n        setData(result)\n        setError(undefined)\n        updateStatus(\"success\")\n        onSuccessRef.current?.(result)\n      } catch (err) {\n        clearInFlight(key)\n\n        if (!mountedRef.current) return\n        setError(err)\n        updateStatus(\"error\")\n        onErrorRef.current?.(err)\n      }\n    },\n    [key, cacheTime, dedupe, fetcher, updateStatus]\n  )\n\n  // Auto-fetch on mount unless manual mode\n  useEffect(() => {\n    if (!key || manual) return\n    execute()\n  }, [key, manual, execute])\n\n  const refetch = useCallback(async () => {\n    await execute(true)\n  }, [execute])\n\n  const clear = useCallback(() => {\n    if (!key) return\n    clearCached(key)\n    setData(undefined)\n    setError(undefined)\n    updateStatus(\"idle\")\n  }, [key, updateStatus])\n\n  const is = useCallback(\n    (s: RequestStatus) => status === s,\n    [status]\n  )\n\n  return {\n    data,\n    status,\n    error,\n    isLoading: status === \"loading\",\n    isSuccess: status === \"success\",\n    isError: status === \"error\",\n    is,\n    refetch,\n    clear,\n  }\n}","import type { CacheEntry, InFlightEntry } from \"./types\"\n\n/**\n * Global in-memory cache — lives in JS RAM only.\n * Never touches localStorage, sessionStorage, or any browser storage.\n * Cleared automatically when the page refreshes or tab closes.\n */\nconst cache = new Map<string, CacheEntry<unknown>>()\n\n/**\n * In-flight registry — tracks requests currently in progress.\n * If a request for the same key is already in flight,\n * new subscribers attach to the existing Promise instead of firing a new request.\n */\nconst inFlight = new Map<string, InFlightEntry<unknown>>()\n\nexport function getCached<T>(key: string, cacheTime: number): T | null {\n  const entry = cache.get(key) as CacheEntry<T> | undefined\n  if (!entry) return null\n  if (cacheTime === 0) return null\n  const isStale = Date.now() - entry.timestamp > cacheTime\n  if (isStale) {\n    cache.delete(key)\n    return null\n  }\n  return entry.data\n}\n\nexport function setCached<T>(key: string, data: T): void {\n  cache.set(key, { data, timestamp: Date.now() })\n}\n\nexport function clearCached(key: string): void {\n  cache.delete(key)\n}\n\nexport function getInFlight<T>(key: string): Promise<T> | null {\n  const entry = inFlight.get(key) as InFlightEntry<T> | undefined\n  if (!entry) return null\n  entry.subscribers++\n  return entry.promise\n}\n\nexport function setInFlight<T>(key: string, promise: Promise<T>): void {\n  inFlight.set(key, { promise: promise as Promise<unknown>, subscribers: 1 })\n}\n\nexport function clearInFlight(key: string): void {\n  inFlight.delete(key)\n}\n\nexport function clearAll(): void {\n  cache.clear()\n  inFlight.clear()\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hookraft/userequest",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Deduplication-first data fetching hook for React. One request fires no matter how many components ask for the same data at the same time.",
   "author": "virus",
   "license": "MIT",