@pixel-pulse/next-cache-brain-core 0.1.0 → 0.3.0

package/dist/index.d.mts

@@ -1,3 +1,17 @@
+interface CacheEntry<T> {
+    key: string;
+    data: T;
+    expiry: number;
+    ttl: number;
+}
+
+type Listener = (data: any[]) => void;
+declare const cacheEngine: {
+    subscribe(fn: Listener): () => boolean;
+    getValues(): CacheEntry<any>[];
+    notify(data?: any[]): void;
+};
+
 type Strategy = "cache-first" | "network-first" | "swr" | "no-cache";
 type SmartFetchOptions = {
     strategy?: Strategy;
@@ -5,10 +19,20 @@ type SmartFetchOptions = {
     dedupe?: boolean;
 };
 
-declare function smartFetch(url: string, options?: SmartFetchOptions): Promise<any>;
+/**
+ * smartFetch is the main entry point for the library.
+ * It handles deduplication, strategy selection, and DevTools notification.
+ */
+declare function smartFetch<T = any>(url: string, options?: SmartFetchOptions): Promise<T>;
+
+declare function setCache<T>(key: string, data: T, ttl: number): CacheEntry<T>;
 
 declare function clearCache(url?: string): void;
 
+/**
+ * GLOBAL TYPE DEFINITION
+ * Informs TypeScript about our DevTools bridge on the window object.
+ */
 declare global {
     interface Window {
         __NCB_DEVTOOLS__?: {
@@ -17,6 +41,5 @@ declare global {
         };
     }
 }
-declare const emitUpdate: () => void;
 
-export { type SmartFetchOptions, type Strategy, clearCache, emitUpdate, smartFetch };
+export { type CacheEntry, cacheEngine, clearCache, setCache, smartFetch };

package/dist/index.d.ts

@@ -1,3 +1,17 @@
+interface CacheEntry<T> {
+    key: string;
+    data: T;
+    expiry: number;
+    ttl: number;
+}
+
+type Listener = (data: any[]) => void;
+declare const cacheEngine: {
+    subscribe(fn: Listener): () => boolean;
+    getValues(): CacheEntry<any>[];
+    notify(data?: any[]): void;
+};
+
 type Strategy = "cache-first" | "network-first" | "swr" | "no-cache";
 type SmartFetchOptions = {
     strategy?: Strategy;
@@ -5,10 +19,20 @@ type SmartFetchOptions = {
     dedupe?: boolean;
 };
 
-declare function smartFetch(url: string, options?: SmartFetchOptions): Promise<any>;
+/**
+ * smartFetch is the main entry point for the library.
+ * It handles deduplication, strategy selection, and DevTools notification.
+ */
+declare function smartFetch<T = any>(url: string, options?: SmartFetchOptions): Promise<T>;
+
+declare function setCache<T>(key: string, data: T, ttl: number): CacheEntry<T>;
 
 declare function clearCache(url?: string): void;
 
+/**
+ * GLOBAL TYPE DEFINITION
+ * Informs TypeScript about our DevTools bridge on the window object.
+ */
 declare global {
     interface Window {
         __NCB_DEVTOOLS__?: {
@@ -17,6 +41,5 @@ declare global {
         };
     }
 }
-declare const emitUpdate: () => void;
 
-export { type SmartFetchOptions, type Strategy, clearCache, emitUpdate, smartFetch };
+export { type CacheEntry, cacheEngine, clearCache, setCache, smartFetch };

package/dist/index.js

@@ -1 +1 @@
-"use strict";var f=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var E=(t,e)=>{for(var o in e)f(t,o,{get:e[o],enumerable:!0})},S=(t,e,o,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of D(e))!T.call(t,a)&&a!==o&&f(t,a,{get:()=>e[a],enumerable:!(n=C(e,a))||n.enumerable});return t};var O=t=>S(f({},"__esModule",{value:!0}),t);var M={};E(M,{clearCache:()=>_,emitUpdate:()=>i,smartFetch:()=>F});module.exports=O(M);var h=Symbol.for("ncb.cache"),y=Symbol.for("ncb.pending"),d=Symbol.for("ncb.inflight");globalThis[h]||(globalThis[h]=new Map);globalThis[y]||(globalThis[y]=new Map);globalThis[d]||(globalThis[d]=new Map);var r=globalThis[h],p=globalThis[y],m=globalThis[d];var g=new Set,i=()=>{g.forEach(t=>t())},w=t=>{typeof window>"u"||(window.__NCB_DEVTOOLS__={getCache:t,subscribe(e){return g.add(e),()=>g.delete(e)}})};async function b(t,e){let o=Date.now(),n=r.get(t);if(n&&n.expiry>o)return n.data;if(p.has(t))return p.get(t);let a=fetch(t).then(s=>s.json()).then(s=>(r.set(t,{data:s,expiry:Date.now()+e,ttl:e}),p.delete(t),i(),s)).catch(s=>{throw p.delete(t),s});return p.set(t,a),i(),a}async function l(t,e){try{let n=await(await fetch(t)).json();return r.set(t,{data:n,expiry:Date.now()+e,ttl:e}),i(),n}catch(o){let n=r.get(t);if(n)return n.data;throw o}}async function u(t){return(await fetch(t)).json()}async function x(t,e){let o=Date.now(),n=r.get(t);if(n)return fetch(t).then(c=>c.json()).then(c=>{r.set(t,{data:c,expiry:Date.now()+e,ttl:e}),i()}).catch(c=>console.error("SWR Background Fetch Failed:",c)),n.data;let s=await(await fetch(t)).json();return r.set(t,{data:s,expiry:Date.now()+e,ttl:e}),i(),s}async function F(t,e){let o=e?.ttl??1e4,n=e?.strategy??"cache-first",a=e?.dedupe??!1;if(a&&m.has(t))return m.get(t);let c=(async()=>{try{switch(n){case"network-first":return await l(t,o);case"swr":return await x(t,o);case"no-cache":return await u(t);default:return await b(t,o)}}finally{a&&m.delete(t)}})();return a&&m.set(t,c),c}function _(t){t?r.delete(t):r.clear()}typeof window<"u"&&w(()=>Array.from(r.entries()).map(([t,e])=>({key:t,...e})));0&&(module.exports={clearCache,emitUpdate,smartFetch});
+"use strict";var d=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var D=(e,t)=>{for(var n in t)d(e,n,{get:t[n],enumerable:!0})},I=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of N(t))!F.call(e,r)&&r!==n&&d(e,r,{get:()=>t[r],enumerable:!(o=O(t,r))||o.enumerable});return e};var B=e=>I(d({},"__esModule",{value:!0}),e);var P={};D(P,{cacheEngine:()=>c,clearCache:()=>T,setCache:()=>i,smartFetch:()=>x});module.exports=B(P);var g=new Set,c={subscribe(e){return g.add(e),e(this.getValues()),()=>g.delete(e)},getValues(){return Array.from(s.values())},notify(e){let t=e||this.getValues();g.forEach(n=>n(t))}};var y=Symbol.for("ncb.cache"),l=Symbol.for("ncb.pending"),w=Symbol.for("ncb.inflight");globalThis[y]||(globalThis[y]=new Map);globalThis[l]||(globalThis[l]=new Map);globalThis[w]||(globalThis[w]=new Map);var s=globalThis[y],m=globalThis[l],p=globalThis[w];var A="ncb_cache_snapshot",L="ncb-devtools-update";var h=()=>{if(typeof window>"u")return;let e=c.getValues();try{localStorage.setItem(A,JSON.stringify(e))}catch(t){console.warn("NCB: Persist failed",t)}c.notify(e),window.dispatchEvent(new CustomEvent(L,{detail:e}))};var E="ncb_persistent_storage";function i(e,t,n){let o={key:e,data:t,expiry:Date.now()+n,ttl:n};if(s.set(e,o),typeof window<"u")try{let r=localStorage.getItem(E),a=r?JSON.parse(r):{};a[e]=o,localStorage.setItem(E,JSON.stringify(a))}catch(r){console.warn("NCB: Persistence failed",r)}return h(),o}async function b(e,t){let n=Date.now(),o=s.get(e);if(o&&o.expiry>n)return o.data;if(m.has(e))return m.get(e);let r=fetch(e).then(a=>a.json()).then(a=>(i(e,a,t),m.delete(e),a)).catch(a=>{throw m.delete(e),a});return m.set(e,r),r}async function C(e,t){try{let o=await(await fetch(e)).json();return i(e,o,t),o}catch(n){let o=s.get(e);if(o)return o.data;throw n}}async function S(e){return(await fetch(e)).json()}async function _(e,t){let n=s.get(e);if(n)return fetch(e).then(a=>a.json()).then(a=>i(e,a,t)).catch(a=>console.error("SWR Background Fetch Failed:",a)),n.data;let r=await(await fetch(e)).json();return i(e,r,t),r}async function x(e,t){let n=t?.ttl??1e4,o=t?.strategy??"cache-first",r=t?.dedupe??!0;if(r&&p.has(e))return p.get(e);let u=(async()=>{try{let f;switch(o){case"network-first":f=await C(e,n);break;case"swr":f=await _(e,n);break;case"no-cache":f=await S(e);break;default:f=await b(e,n);break}return h(),f}catch(f){throw console.error(`[NextCacheBrain] Fetch failed for ${e}:`,f),f}finally{r&&p.delete(e)}})();return r&&p.set(e,u),u}var v="ncb_persistent_storage";function T(e){if(e){if(s.delete(e),typeof window<"u"){let t=Array.from(s.values());localStorage.setItem(v,JSON.stringify(t))}}else s.clear(),typeof window<"u"&&localStorage.removeItem(v);h()}if(typeof window<"u"){try{let e=localStorage.getItem("ncb_persistent_storage");if(e){let t=JSON.parse(e);Object.values(t).forEach(n=>{n.expiry>Date.now()&&s.set(n.key,n)}),c.notify()}}catch(e){console.error("NCB Core: Hydration failed",e)}window.__NCB_DEVTOOLS__={getCache:()=>c.getValues(),subscribe:e=>c.subscribe(e)}}0&&(module.exports={cacheEngine,clearCache,setCache,smartFetch});

package/dist/index.mjs

@@ -1 +1 @@
-var f=Symbol.for("ncb.cache"),h=Symbol.for("ncb.pending"),y=Symbol.for("ncb.inflight");globalThis[f]||(globalThis[f]=new Map);globalThis[h]||(globalThis[h]=new Map);globalThis[y]||(globalThis[y]=new Map);var n=globalThis[f],p=globalThis[h],m=globalThis[y];var d=new Set,s=()=>{d.forEach(t=>t())},g=t=>{typeof window>"u"||(window.__NCB_DEVTOOLS__={getCache:t,subscribe(e){return d.add(e),()=>d.delete(e)}})};async function w(t,e){let a=Date.now(),r=n.get(t);if(r&&r.expiry>a)return r.data;if(p.has(t))return p.get(t);let c=fetch(t).then(o=>o.json()).then(o=>(n.set(t,{data:o,expiry:Date.now()+e,ttl:e}),p.delete(t),s(),o)).catch(o=>{throw p.delete(t),o});return p.set(t,c),s(),c}async function b(t,e){try{let r=await(await fetch(t)).json();return n.set(t,{data:r,expiry:Date.now()+e,ttl:e}),s(),r}catch(a){let r=n.get(t);if(r)return r.data;throw a}}async function l(t){return(await fetch(t)).json()}async function u(t,e){let a=Date.now(),r=n.get(t);if(r)return fetch(t).then(i=>i.json()).then(i=>{n.set(t,{data:i,expiry:Date.now()+e,ttl:e}),s()}).catch(i=>console.error("SWR Background Fetch Failed:",i)),r.data;let o=await(await fetch(t)).json();return n.set(t,{data:o,expiry:Date.now()+e,ttl:e}),s(),o}async function x(t,e){let a=e?.ttl??1e4,r=e?.strategy??"cache-first",c=e?.dedupe??!1;if(c&&m.has(t))return m.get(t);let i=(async()=>{try{switch(r){case"network-first":return await b(t,a);case"swr":return await u(t,a);case"no-cache":return await l(t);default:return await w(t,a)}}finally{c&&m.delete(t)}})();return c&&m.set(t,i),i}function F(t){t?n.delete(t):n.clear()}typeof window<"u"&&g(()=>Array.from(n.entries()).map(([t,e])=>({key:t,...e})));export{F as clearCache,s as emitUpdate,x as smartFetch};
+var d=new Set,c={subscribe(e){return d.add(e),e(this.getValues()),()=>d.delete(e)},getValues(){return Array.from(a.values())},notify(e){let t=e||this.getValues();d.forEach(n=>n(t))}};var g=Symbol.for("ncb.cache"),y=Symbol.for("ncb.pending"),l=Symbol.for("ncb.inflight");globalThis[g]||(globalThis[g]=new Map);globalThis[y]||(globalThis[y]=new Map);globalThis[l]||(globalThis[l]=new Map);var a=globalThis[g],m=globalThis[y],p=globalThis[l];var x="ncb_cache_snapshot",v="ncb-devtools-update";var h=()=>{if(typeof window>"u")return;let e=c.getValues();try{localStorage.setItem(x,JSON.stringify(e))}catch(t){console.warn("NCB: Persist failed",t)}c.notify(e),window.dispatchEvent(new CustomEvent(v,{detail:e}))};var u="ncb_persistent_storage";function f(e,t,n){let r={key:e,data:t,expiry:Date.now()+n,ttl:n};if(a.set(e,r),typeof window<"u")try{let s=localStorage.getItem(u),o=s?JSON.parse(s):{};o[e]=r,localStorage.setItem(u,JSON.stringify(o))}catch(s){console.warn("NCB: Persistence failed",s)}return h(),r}async function E(e,t){let n=Date.now(),r=a.get(e);if(r&&r.expiry>n)return r.data;if(m.has(e))return m.get(e);let s=fetch(e).then(o=>o.json()).then(o=>(f(e,o,t),m.delete(e),o)).catch(o=>{throw m.delete(e),o});return m.set(e,s),s}async function b(e,t){try{let r=await(await fetch(e)).json();return f(e,r,t),r}catch(n){let r=a.get(e);if(r)return r.data;throw n}}async function C(e){return(await fetch(e)).json()}async function S(e,t){let n=a.get(e);if(n)return fetch(e).then(o=>o.json()).then(o=>f(e,o,t)).catch(o=>console.error("SWR Background Fetch Failed:",o)),n.data;let s=await(await fetch(e)).json();return f(e,s,t),s}async function T(e,t){let n=t?.ttl??1e4,r=t?.strategy??"cache-first",s=t?.dedupe??!0;if(s&&p.has(e))return p.get(e);let w=(async()=>{try{let i;switch(r){case"network-first":i=await b(e,n);break;case"swr":i=await S(e,n);break;case"no-cache":i=await C(e);break;default:i=await E(e,n);break}return h(),i}catch(i){throw console.error(`[NextCacheBrain] Fetch failed for ${e}:`,i),i}finally{s&&p.delete(e)}})();return s&&p.set(e,w),w}var _="ncb_persistent_storage";function O(e){if(e){if(a.delete(e),typeof window<"u"){let t=Array.from(a.values());localStorage.setItem(_,JSON.stringify(t))}}else a.clear(),typeof window<"u"&&localStorage.removeItem(_);h()}if(typeof window<"u"){try{let e=localStorage.getItem("ncb_persistent_storage");if(e){let t=JSON.parse(e);Object.values(t).forEach(n=>{n.expiry>Date.now()&&a.set(n.key,n)}),c.notify()}}catch(e){console.error("NCB Core: Hydration failed",e)}window.__NCB_DEVTOOLS__={getCache:()=>c.getValues(),subscribe:e=>c.subscribe(e)}}export{c as cacheEngine,O as clearCache,f as setCache,T as smartFetch};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixel-pulse/next-cache-brain-core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",