qortex-core 0.2.8 → 0.3.0-beta.1

package/index.d.ts

@@ -1,3 +1,115 @@
+/**
+ * Internal query state that tracks all aspects of a query's lifecycle
+ * Used internally by QueryManager for state management
+ * NOT EXPORTED - internal implementation detail
+ */
+type QueryStateInternal<T = any, E = unknown> = {
+    data?: T;
+    error?: E;
+    status: QueryStatus;
+    updatedAt?: number;
+    staleTime: number;
+    isInvalidated: boolean;
+    fetcher?: Fetcher<T> | null;
+    equalityFn: EqualityFn<T>;
+    equalityStrategy: EqualityStrategy;
+    placeholderData?: T;
+    usePreviousDataOnError?: boolean;
+    usePlaceholderOnError?: boolean;
+    refetchOnSubscribe: "always" | "stale" | false;
+    enabled: boolean;
+    lastFetchTime?: number;
+    fetchPromise?: Promise<T> | T;
+    refetch?: () => Promise<T>;
+    isSuccess: boolean;
+    isError: boolean;
+    lastReturnedState?: QueryState<T>;
+};
+
+type SerializedQueryState = Omit<QueryStateInternal, 'fetcher' | 'fetchPromise' | 'refetch' | 'equalityFn'>;
+/**
+ * Persister configuration
+ */
+interface PersisterConfig {
+    burstKey?: string;
+    prefix?: string;
+    debounceTime?: number;
+}
+
+/**
+ * Base persister implementation
+ */
+declare class BasePersister {
+    protected readonly storage: Storage;
+    private syncTimeout;
+    private debounceTime;
+    private burstKey;
+    private storageKey;
+    constructor(storage: Storage, config?: PersisterConfig);
+    /**
+     * Save state to storage
+     */
+    save(state: Record<string, SerializedQueryState>): void;
+    /**
+     * Load state from storage and hydrate cache
+     */
+    load(cache: Map<string, QueryStateInternal>, hasQueriesBeenUsed: boolean): void;
+    /**
+     * Clear all persisted data
+     */
+    clear(): void;
+    /**
+     * Sync with debounced save (100ms delay)
+     * Handles serialization internally
+     */
+    sync(cache: Map<string, QueryStateInternal>): void;
+}
+type Persister = BasePersister;
+
+/**
+ * Creates a persister instance for data persistence.
+ *
+ * This factory function creates a persister that can save and load query state data
+ * to/from browser storage (localStorage or sessionStorage). The persister handles
+ * serialization, validation, burst key management, and debounced syncing automatically.
+ *
+ * @param {'local' | 'session'} type - The type of storage to use
+ *   - `'local'`: Uses localStorage for persistent data across browser sessions
+ *   - `'session'`: Uses sessionStorage for data that persists only during the current session
+ * @param {PersisterConfig} [config] - Optional configuration for the persister
+ * @returns {Persister | undefined} A persister instance, or undefined if storage is not available
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with localStorage
+ * const persister = createPersister('local');
+ *
+ * // With custom configuration
+ * const persister = createPersister('local', {
+ *   burstKey: 'v1.0.0',
+ *   prefix: 'my_app',
+ *   debounceTime: 50
+ * });
+ *
+ * // Use with query manager
+ * setDefaultConfig({ persister });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Session storage for temporary data
+ * const sessionPersister = createPersister('session', {
+ *   prefix: 'temp_data',
+ *   debounceTime: 200
+ * });
+ *
+ * setDefaultConfig({ persister: sessionPersister });
+ * ```
+ *
+ * @throws {Error} If an invalid storage type is provided
+ */
+declare const createPersister: (type: "local" | "session", config?: PersisterConfig) => BasePersister | undefined;
+
 /**
  * Query key can be a string or readonly array of strings/numbers
  * Using readonly to prevent accidental mutations
@@ -32,13 +144,14 @@ type InferFetcherResult<F> = F extends Fetcher<infer R> ? R : any;
  * Query status types for better type safety
  */
 type QueryStatus = "idle" | "fetching" | "success" | "error";
+type RefetchOnSubscribeOptions = "always" | "stale" | false;
 /**
  * Comprehensive options for all query operations
  * Improved with better type constraints
  */
 type QueryOptions<T = any> = {
     enabled?: boolean;
-    refetchOnSubscribe?: "always" | "stale" | false;
+    refetchOnSubscribe?: RefetchOnSubscribeOptions;
     fetcher?: Fetcher<T>;
     equalityFn?: EqualityFn<T>;
     equalityStrategy?: EqualityStrategy;
@@ -54,13 +167,14 @@ type QueryOptions<T = any> = {
  */
 type DefaultConfig = {
     enabled?: boolean;
-    refetchOnSubscribe?: "always" | "stale" | false;
+    refetchOnSubscribe?: RefetchOnSubscribeOptions;
     staleTime?: number;
     usePreviousDataOnError?: boolean;
     usePlaceholderOnError?: boolean;
     equalityFn?: EqualityFn<any>;
     equalityStrategy?: EqualityStrategy;
     throttleTime?: number;
+    persister?: Persister;
 };
 /**
  * Public query state returned by getQueryState
@@ -89,6 +203,8 @@ declare class QueryManagerCore {
     private subs;
     private defaultConfig;
     private throttleTime;
+    private persister;
+    private hasQueriesBeenUsed;
     /**
      * ⚠️ DANGER: Clear all cached data and subscriptions
      *
@@ -96,6 +212,7 @@ declare class QueryManagerCore {
      * - All cached query data
      * - All active subscriptions
      * - All state references
+     * - All persisted data
      *
      * @warning This should ONLY be used in testing environments or when you need to completely reset the query manager state. Using this in production will cause all active queries to lose their data and subscriptions to break.
      *
@@ -114,7 +231,7 @@ declare class QueryManagerCore {
     /**
      * Set default configuration for all queries
      */
-    setDefaultConfig({ throttleTime, ...config }: DefaultConfig): void;
+    setDefaultConfig({ throttleTime, persister, ...config }: DefaultConfig): void;
     /**
      * Ensures a query state exists in cache, creating it if necessary
      * User-friendly with any fallback for better developer experience
@@ -201,4 +318,4 @@ declare const dangerClearCache: QueryManagerCore["dangerClearCache"];
  */
 declare function serializeKey(key: QueryKey): string;
 
-export { DefaultConfig, EqualityFn, EqualityStrategy, Fetcher, InferFetcherResult, QueryKey, QueryManagerCore, QueryOptions, QueryState, QueryStatus, _queryManager, dangerClearCache, fetchQuery, getQueryData, getQueryState, invalidateQuery, registerFetcher, serializeKey, setDefaultConfig, setQueryData, subscribeQuery };
+export { DefaultConfig, EqualityFn, EqualityStrategy, Fetcher, InferFetcherResult, Persister, PersisterConfig, QueryKey, QueryManagerCore, QueryOptions, QueryState, QueryStatus, RefetchOnSubscribeOptions, _queryManager, createPersister, dangerClearCache, fetchQuery, getQueryData, getQueryState, invalidateQuery, registerFetcher, serializeKey, setDefaultConfig, setQueryData, subscribeQuery };

package/index.js

@@ -1,16 +1,17 @@
 'use strict';
 
-function c(t){return Array.isArray(t)?t.join(","):String(t)}function y(t,r,a="shallow"){if(t===r)return !0;if(t==null||r==null)return t===r;if(typeof t!="object"||typeof r!="object")return !1;try{let e=t,n=r;if(Array.isArray(e)&&Array.isArray(n)){if(e.length!==n.length)return !1;for(let o=0;o<e.length;o++)if(a==="deep"){if(!y(e[o],n[o],a))return !1}else if(e[o]!==n[o])return !1;return !0}if(Array.isArray(e)||Array.isArray(n))return !1;let s=Object.keys(e),u=Object.keys(n);if(s.length!==u.length)return !1;for(let o=0;o<s.length;o++){let l=s[o];if(a==="deep"){if(!y(e[l],n[l],a))return !1}else if(e[l]!==n[l])return !1}return !0}catch{return !1}}function g(t,r){return r||((a,e)=>y(a,e,t||"shallow"))}function h(t,r){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:g(t?.equalityStrategy,t?.equalityFn),equalityStrategy:t?.equalityStrategy??"shallow",placeholderData:t?.placeholderData,usePreviousDataOnError:t?.usePreviousDataOnError??!1,usePlaceholderOnError:t?.usePlaceholderOnError??!1,refetchOnSubscribe:t?.refetchOnSubscribe??"stale",enabled:t?.enabled!==!1,refetch:r||(()=>Promise.resolve(void 0)),isSuccess:!1,isError:!1,lastReturnedState:void 0}}function d(t){let r=Date.now(),a=t.updatedAt!==void 0&&r-t.updatedAt>t.staleTime||t.isInvalidated,e,n=!1;switch(t.status){case"error":t.usePreviousDataOnError&&t.data!==void 0?e=t.data:t.usePlaceholderOnError&&t.placeholderData!==void 0&&(e=t.placeholderData,n=!0);break;case"fetching":t.data!==void 0?(e=t.data,n=!1):t.placeholderData&&(e=t.placeholderData,n=!0);break;case"success":case"idle":e=t.data??t.placeholderData,n=t.data?!1:!!t.placeholderData;break}return {data:e,error:t.error,status:t.status,updatedAt:t.updatedAt,isStale:a,isPlaceholderData:n,isLoading:t.status==="fetching"&&!t.updatedAt,isFetching:t.status==="fetching",isError:t.isError,isSuccess:t.isSuccess,refetch:t.refetch}}function Q(t){console.warn(`[qortex] No fetcher or data for key "${c(t)}". Register a fetcher or set initial data.`);}var f=class{constructor(){this.cache=new Map;this.subs=new Map;this.defaultConfig={};this.throttleTime=50;}dangerClearCache(){this.cache.clear(),this.subs.clear();}setDefaultConfig({throttleTime:r,...a}){this.defaultConfig={...this.defaultConfig,...a},r!==void 0&&(this.throttleTime=r);}ensureState(r,a={}){let e=c(r),n=this.cache.get(e);if(n){let s={...this.defaultConfig,...n,...a};Object.assign(n,s),n.enabled=s.enabled!==!1,this.cache.set(e,n);}else {let s={...this.defaultConfig,...a},u=h(s,()=>this.fetchQuery(r));this.cache.set(e,u);}return this.cache.get(e)}emit(r,a){let e=c(r);this.cache.set(e,a);let n=this.subs.get(e);if(!n)return;let s=d(a);for(let u of Array.from(n))u(s);}registerFetcher(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);}fetchQuery(r,a){let e=this.ensureState(r,a);if(e.fetchPromise)return e.fetchPromise;let n=e.fetcher;if(!n)return e.updatedAt===void 0&&Q(r),Promise.resolve(e.data);let s=n();return e.fetchPromise=s,e.status="fetching",e.lastFetchTime=Date.now(),this.emit(r,e),s.then(u=>{e.data=e.equalityFn(e.data,u)?e.data:u,e.status="success",e.isError=!1,e.isSuccess=!0,e.updatedAt=Date.now(),e.fetchPromise=void 0,e.error=void 0,this.emit(r,e);}).catch(u=>{e.error=u,e.status="error",e.isError=!0,e.isSuccess=!1,e.updatedAt=Date.now(),e.fetchPromise=void 0,this.emit(r,e);}),s}setQueryData(r,a){let e=this.ensureState(r),n=e.data;e.equalityFn(n,a)||(e.data=a,e.updatedAt=Date.now(),e.error=void 0,e.status="success",e.isInvalidated=!1,e.isError=!1,e.isSuccess=!0,this.emit(r,e));}getQueryData(r,a){let e=this.ensureState(r,a);return this.handleMountLogic(r,e),d(e).data}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let n=d(e),s=e.lastReturnedState;return !s||!y(s,n,"shallow")?(e.lastReturnedState=n,n):s}invalidateQuery(r){let a=this.ensureState(r);a.isInvalidated=!0,this.emit(r,a),this.fetchQuery(r);}subscribeQuery(r,a,e){let n=c(r),s=this.ensureState(r,e);return this.subs.has(n)||this.subs.set(n,new Set),this.subs.get(n).add(a),this.handleMountLogic(r,s),()=>{this.subs.get(n).delete(a);}}handleMountLogic(r,a){let e=a.lastFetchTime&&Date.now()-a.lastFetchTime<this.throttleTime;if(a.status==="fetching"||!a.enabled||e||!a.fetcher)return;let n=Date.now(),s=a.updatedAt==null||n-(a.updatedAt||0)>a.staleTime||a.isInvalidated,u=!1;a.updatedAt==null?u=!0:(a.refetchOnSubscribe==="always"&&(u=!0),a.refetchOnSubscribe==="stale"&&(u=s)),u&&this.fetchQuery(r);}},p=f;var i=new p,v=i.registerFetcher.bind(i),O=i.fetchQuery.bind(i),K=i.setQueryData.bind(i),C=i.getQueryData.bind(i),w=i.getQueryState.bind(i),x=i.invalidateQuery.bind(i),A=i.subscribeQuery.bind(i),E=i.setDefaultConfig.bind(i),I=i.dangerClearCache.bind(i);
+function c(e){return Array.isArray(e)?e.join(","):String(e)}function y(e,r,s="shallow"){if(e===r)return !0;if(e==null||r==null)return e===r;if(typeof e!="object"||typeof r!="object")return !1;try{let t=e,a=r;if(Array.isArray(t)&&Array.isArray(a)){if(t.length!==a.length)return !1;for(let u=0;u<t.length;u++)if(s==="deep"){if(!y(t[u],a[u],s))return !1}else if(t[u]!==a[u])return !1;return !0}if(Array.isArray(t)||Array.isArray(a))return !1;let i=Object.keys(t),o=Object.keys(a);if(i.length!==o.length)return !1;for(let u=0;u<i.length;u++){let l=i[u];if(s==="deep"){if(!y(t[l],a[l],s))return !1}else if(t[l]!==a[l])return !1}return !0}catch{return !1}}function p(e,r){return r||((s,t)=>y(s,t,e||"shallow"))}function Q(e,r){return {status:"idle",updatedAt:void 0,staleTime:e?.staleTime??0,isInvalidated:!1,fetcher:e?.fetcher,equalityFn:p(e?.equalityStrategy,e?.equalityFn),equalityStrategy:e?.equalityStrategy??"shallow",placeholderData:e?.placeholderData,usePreviousDataOnError:e?.usePreviousDataOnError??!1,usePlaceholderOnError:e?.usePlaceholderOnError??!1,refetchOnSubscribe:e?.refetchOnSubscribe??"stale",enabled:e?.enabled!==!1,refetch:r||(()=>Promise.resolve(void 0)),isSuccess:!1,isError:!1,lastReturnedState:void 0}}function f(e){let r=Date.now(),s=e.updatedAt!==void 0&&r-e.updatedAt>e.staleTime||e.isInvalidated,t,a=!1;switch(e.status){case"error":e.usePreviousDataOnError&&e.data!==void 0?t=e.data:e.usePlaceholderOnError&&e.placeholderData!==void 0&&(t=e.placeholderData,a=!0);break;case"fetching":e.data!==void 0?(t=e.data,a=!1):e.placeholderData&&(t=e.placeholderData,a=!0);break;case"success":case"idle":t=e.data??e.placeholderData,a=e.data?!1:!!e.placeholderData;break}return {data:t,error:e.error,status:e.status,updatedAt:e.updatedAt,isStale:s,isPlaceholderData:a,isLoading:e.status==="fetching"&&!e.updatedAt,isFetching:e.status==="fetching",isError:e.isError,isSuccess:e.isSuccess,refetch:e.refetch}}function S(e){console.warn(`[qortex] No fetcher or data for key "${c(e)}". Register a fetcher or set initial data.`);}var d=class{constructor(){this.cache=new Map;this.subs=new Map;this.defaultConfig={};this.throttleTime=50;this.persister=null;this.hasQueriesBeenUsed=!1;}dangerClearCache(){this.cache.clear(),this.subs.clear(),this.persister?.clear();}setDefaultConfig({throttleTime:r,persister:s,...t}){this.defaultConfig={...this.defaultConfig,...t},r!==void 0&&(this.throttleTime=r),s&&(this.persister=s,this.persister?.load(this.cache,this.hasQueriesBeenUsed));}ensureState(r,s={}){this.hasQueriesBeenUsed=!0;let t=c(r),a=this.cache.get(t);if(a){let i={...this.defaultConfig,...a,...s};Object.assign(a,i),a.enabled=i.enabled!==!1,this.cache.set(t,a);}else {let i={...this.defaultConfig,...s},o=Q(i,()=>this.fetchQuery(r));this.cache.set(t,o);}return this.cache.get(t)}emit(r,s){let t=c(r);this.cache.set(t,s),this.persister?.sync(this.cache);let a=this.subs.get(t);if(!a)return;let i=f(s);for(let o of Array.from(a))o(i);}registerFetcher(r,s){let t=this.ensureState(r,s);this.handleMountLogic(r,t);}fetchQuery(r,s){let t=this.ensureState(r,s);if(t.fetchPromise)return t.fetchPromise;let a=t.fetcher;if(!a)return t.updatedAt===void 0&&S(r),Promise.resolve(t.data);let i=a();return t.fetchPromise=i,t.status="fetching",t.lastFetchTime=Date.now(),this.emit(r,t),i.then(o=>{t.data=t.equalityFn(t.data,o)?t.data:o,t.status="success",t.isError=!1,t.isSuccess=!0,t.updatedAt=Date.now(),t.fetchPromise=void 0,t.error=void 0,this.emit(r,t);}).catch(o=>{t.error=o,t.status="error",t.isError=!0,t.isSuccess=!1,t.updatedAt=Date.now(),t.fetchPromise=void 0,this.emit(r,t);}),i}setQueryData(r,s){let t=this.ensureState(r),a=t.data;t.equalityFn(a,s)||(t.data=s,t.updatedAt=Date.now(),t.error=void 0,t.status="success",t.isInvalidated=!1,t.isError=!1,t.isSuccess=!0,this.emit(r,t));}getQueryData(r,s){let t=this.ensureState(r,s);return this.handleMountLogic(r,t),f(t).data}getQueryState(r,s){let t=this.ensureState(r,s);this.handleMountLogic(r,t);let a=f(t),i=t.lastReturnedState;return !i||!y(i,a,"shallow")?(t.lastReturnedState=a,a):i}invalidateQuery(r){let s=this.ensureState(r);s.isInvalidated=!0,this.emit(r,s),this.fetchQuery(r);}subscribeQuery(r,s,t){let a=c(r),i=this.ensureState(r,t);return this.subs.has(a)||this.subs.set(a,new Set),this.subs.get(a).add(s),this.handleMountLogic(r,i),()=>{this.subs.get(a).delete(s);}}handleMountLogic(r,s){let t=s.lastFetchTime&&Date.now()-s.lastFetchTime<this.throttleTime;if(s.status==="fetching"||!s.enabled||t||!s.fetcher)return;let a=Date.now(),i=s.updatedAt==null||a-(s.updatedAt||0)>s.staleTime||s.isInvalidated,o=!1;s.updatedAt==null?o=!0:(s.refetchOnSubscribe==="always"&&(o=!0),s.refetchOnSubscribe==="stale"&&(o=i)),o&&this.fetchQuery(r);}},g=d;var n=new g,k=n.registerFetcher.bind(n),j=n.fetchQuery.bind(n),N=n.setQueryData.bind(n),L=n.getQueryData.bind(n),B=n.getQueryState.bind(n),U=n.invalidateQuery.bind(n),J=n.subscribeQuery.bind(n),_=n.setDefaultConfig.bind(n),V=n.dangerClearCache.bind(n);function P(e){return typeof e=="string"&&["idle","fetching","success","error"].includes(e)}function K(e){return typeof e=="string"&&["shallow","deep"].includes(e)}function O(e){return e===!1||typeof e=="string"&&["always","stale"].includes(e)}function D(e){return !(!e||typeof e!="object"||!P(e.status)||typeof e.staleTime!="number"||e.staleTime<0||typeof e.isInvalidated!="boolean"||!K(e.equalityStrategy)||!O(e.refetchOnSubscribe))}function m(e){if(!e||typeof e!="object"||!e.entries||typeof e.entries!="object")return !1;for(let[r,s]of Object.entries(e.entries))if(typeof r!="string"||!D(s))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function b(e){let{fetcher:r,equalityFn:s,fetchPromise:t,refetch:a,...i}=e;return i}function T(e,r){let s={...r??{},...e};return {...s,equalityFn:r?.equalityFn||p(s.equalityStrategy)}}function F(e){try{let r=JSON.parse(e);return m(r)?r:null}catch{return null}}var v=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},w=()=>{console.warn("[Qortex] Persister is being set after queries have been used. This may cause data inconsistency. It is recommended to set the persister before any query usage.");};var h=class{constructor(r,s){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.0";this.storageKey="qortex";this.storage=r,this.burstKey=s?.burstKey??this.burstKey,this.storageKey=s?.prefix??this.storageKey,this.debounceTime=s?.debounceTime??this.debounceTime;}save(r){try{let s={entries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[a,i]of Object.entries(r))s.entries[a]=i;let t=JSON.stringify(s);this.storage.setItem(this.storageKey,t);}catch(s){console.warn("[Qortex] Failed to persist state:",s);}}load(r,s){s&&w();try{let t=this.storage.getItem(this.storageKey);if(!t)return;let a=F(t);if(!a){console.warn("[Qortex] Invalid persisted state format, clearing cache"),this.clear();return}if(a.burstKey!==this.burstKey){console.warn("[Qortex] Burst key mismatch, clearing cache"),this.clear();return}for(let[i,o]of Object.entries(a.entries)){let u=o,l=r.get(i),x=T(u,l);r.set(i,x);}}catch(t){console.warn("[Qortex] Failed to load persisted state:",t),this.clear();}}clear(){try{this.storage.removeItem(this.storageKey);}catch(r){console.warn("[Qortex] Failed to clear persisted data:",r);}}sync(r){this.syncTimeout&&clearTimeout(this.syncTimeout),this.syncTimeout=setTimeout(()=>{let s={};for(let[t,a]of r.entries())s[t]=b(a);this.save(s);},this.debounceTime);}};var I=e=>{switch(e){case"local":if(typeof localStorage<"u")return window.localStorage;break;case"session":if(typeof sessionStorage<"u")return window.sessionStorage;break;default:throw new Error(`Invalid storage type: ${e}`)}},C=(e,r)=>{let s=I(e);if(!s){v();return}return new h(s,r)};
 
-exports.QueryManagerCore = f;
-exports._queryManager = i;
-exports.dangerClearCache = I;
-exports.fetchQuery = O;
-exports.getQueryData = C;
-exports.getQueryState = w;
-exports.invalidateQuery = x;
-exports.registerFetcher = v;
+exports.QueryManagerCore = d;
+exports._queryManager = n;
+exports.createPersister = C;
+exports.dangerClearCache = V;
+exports.fetchQuery = j;
+exports.getQueryData = L;
+exports.getQueryState = B;
+exports.invalidateQuery = U;
+exports.registerFetcher = k;
 exports.serializeKey = c;
-exports.setDefaultConfig = E;
-exports.setQueryData = K;
-exports.subscribeQuery = A;
+exports.setDefaultConfig = _;
+exports.setQueryData = N;
+exports.subscribeQuery = J;

package/index.mjs

@@ -1,3 +1,3 @@
-function c(t){return Array.isArray(t)?t.join(","):String(t)}function y(t,r,a="shallow"){if(t===r)return !0;if(t==null||r==null)return t===r;if(typeof t!="object"||typeof r!="object")return !1;try{let e=t,n=r;if(Array.isArray(e)&&Array.isArray(n)){if(e.length!==n.length)return !1;for(let o=0;o<e.length;o++)if(a==="deep"){if(!y(e[o],n[o],a))return !1}else if(e[o]!==n[o])return !1;return !0}if(Array.isArray(e)||Array.isArray(n))return !1;let s=Object.keys(e),u=Object.keys(n);if(s.length!==u.length)return !1;for(let o=0;o<s.length;o++){let l=s[o];if(a==="deep"){if(!y(e[l],n[l],a))return !1}else if(e[l]!==n[l])return !1}return !0}catch{return !1}}function g(t,r){return r||((a,e)=>y(a,e,t||"shallow"))}function h(t,r){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:g(t?.equalityStrategy,t?.equalityFn),equalityStrategy:t?.equalityStrategy??"shallow",placeholderData:t?.placeholderData,usePreviousDataOnError:t?.usePreviousDataOnError??!1,usePlaceholderOnError:t?.usePlaceholderOnError??!1,refetchOnSubscribe:t?.refetchOnSubscribe??"stale",enabled:t?.enabled!==!1,refetch:r||(()=>Promise.resolve(void 0)),isSuccess:!1,isError:!1,lastReturnedState:void 0}}function d(t){let r=Date.now(),a=t.updatedAt!==void 0&&r-t.updatedAt>t.staleTime||t.isInvalidated,e,n=!1;switch(t.status){case"error":t.usePreviousDataOnError&&t.data!==void 0?e=t.data:t.usePlaceholderOnError&&t.placeholderData!==void 0&&(e=t.placeholderData,n=!0);break;case"fetching":t.data!==void 0?(e=t.data,n=!1):t.placeholderData&&(e=t.placeholderData,n=!0);break;case"success":case"idle":e=t.data??t.placeholderData,n=t.data?!1:!!t.placeholderData;break}return {data:e,error:t.error,status:t.status,updatedAt:t.updatedAt,isStale:a,isPlaceholderData:n,isLoading:t.status==="fetching"&&!t.updatedAt,isFetching:t.status==="fetching",isError:t.isError,isSuccess:t.isSuccess,refetch:t.refetch}}function Q(t){console.warn(`[qortex] No fetcher or data for key "${c(t)}". Register a fetcher or set initial data.`);}var f=class{constructor(){this.cache=new Map;this.subs=new Map;this.defaultConfig={};this.throttleTime=50;}dangerClearCache(){this.cache.clear(),this.subs.clear();}setDefaultConfig({throttleTime:r,...a}){this.defaultConfig={...this.defaultConfig,...a},r!==void 0&&(this.throttleTime=r);}ensureState(r,a={}){let e=c(r),n=this.cache.get(e);if(n){let s={...this.defaultConfig,...n,...a};Object.assign(n,s),n.enabled=s.enabled!==!1,this.cache.set(e,n);}else {let s={...this.defaultConfig,...a},u=h(s,()=>this.fetchQuery(r));this.cache.set(e,u);}return this.cache.get(e)}emit(r,a){let e=c(r);this.cache.set(e,a);let n=this.subs.get(e);if(!n)return;let s=d(a);for(let u of Array.from(n))u(s);}registerFetcher(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);}fetchQuery(r,a){let e=this.ensureState(r,a);if(e.fetchPromise)return e.fetchPromise;let n=e.fetcher;if(!n)return e.updatedAt===void 0&&Q(r),Promise.resolve(e.data);let s=n();return e.fetchPromise=s,e.status="fetching",e.lastFetchTime=Date.now(),this.emit(r,e),s.then(u=>{e.data=e.equalityFn(e.data,u)?e.data:u,e.status="success",e.isError=!1,e.isSuccess=!0,e.updatedAt=Date.now(),e.fetchPromise=void 0,e.error=void 0,this.emit(r,e);}).catch(u=>{e.error=u,e.status="error",e.isError=!0,e.isSuccess=!1,e.updatedAt=Date.now(),e.fetchPromise=void 0,this.emit(r,e);}),s}setQueryData(r,a){let e=this.ensureState(r),n=e.data;e.equalityFn(n,a)||(e.data=a,e.updatedAt=Date.now(),e.error=void 0,e.status="success",e.isInvalidated=!1,e.isError=!1,e.isSuccess=!0,this.emit(r,e));}getQueryData(r,a){let e=this.ensureState(r,a);return this.handleMountLogic(r,e),d(e).data}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let n=d(e),s=e.lastReturnedState;return !s||!y(s,n,"shallow")?(e.lastReturnedState=n,n):s}invalidateQuery(r){let a=this.ensureState(r);a.isInvalidated=!0,this.emit(r,a),this.fetchQuery(r);}subscribeQuery(r,a,e){let n=c(r),s=this.ensureState(r,e);return this.subs.has(n)||this.subs.set(n,new Set),this.subs.get(n).add(a),this.handleMountLogic(r,s),()=>{this.subs.get(n).delete(a);}}handleMountLogic(r,a){let e=a.lastFetchTime&&Date.now()-a.lastFetchTime<this.throttleTime;if(a.status==="fetching"||!a.enabled||e||!a.fetcher)return;let n=Date.now(),s=a.updatedAt==null||n-(a.updatedAt||0)>a.staleTime||a.isInvalidated,u=!1;a.updatedAt==null?u=!0:(a.refetchOnSubscribe==="always"&&(u=!0),a.refetchOnSubscribe==="stale"&&(u=s)),u&&this.fetchQuery(r);}},p=f;var i=new p,v=i.registerFetcher.bind(i),O=i.fetchQuery.bind(i),K=i.setQueryData.bind(i),C=i.getQueryData.bind(i),w=i.getQueryState.bind(i),x=i.invalidateQuery.bind(i),A=i.subscribeQuery.bind(i),E=i.setDefaultConfig.bind(i),I=i.dangerClearCache.bind(i);
+function c(e){return Array.isArray(e)?e.join(","):String(e)}function y(e,r,s="shallow"){if(e===r)return !0;if(e==null||r==null)return e===r;if(typeof e!="object"||typeof r!="object")return !1;try{let t=e,a=r;if(Array.isArray(t)&&Array.isArray(a)){if(t.length!==a.length)return !1;for(let u=0;u<t.length;u++)if(s==="deep"){if(!y(t[u],a[u],s))return !1}else if(t[u]!==a[u])return !1;return !0}if(Array.isArray(t)||Array.isArray(a))return !1;let i=Object.keys(t),o=Object.keys(a);if(i.length!==o.length)return !1;for(let u=0;u<i.length;u++){let l=i[u];if(s==="deep"){if(!y(t[l],a[l],s))return !1}else if(t[l]!==a[l])return !1}return !0}catch{return !1}}function p(e,r){return r||((s,t)=>y(s,t,e||"shallow"))}function Q(e,r){return {status:"idle",updatedAt:void 0,staleTime:e?.staleTime??0,isInvalidated:!1,fetcher:e?.fetcher,equalityFn:p(e?.equalityStrategy,e?.equalityFn),equalityStrategy:e?.equalityStrategy??"shallow",placeholderData:e?.placeholderData,usePreviousDataOnError:e?.usePreviousDataOnError??!1,usePlaceholderOnError:e?.usePlaceholderOnError??!1,refetchOnSubscribe:e?.refetchOnSubscribe??"stale",enabled:e?.enabled!==!1,refetch:r||(()=>Promise.resolve(void 0)),isSuccess:!1,isError:!1,lastReturnedState:void 0}}function f(e){let r=Date.now(),s=e.updatedAt!==void 0&&r-e.updatedAt>e.staleTime||e.isInvalidated,t,a=!1;switch(e.status){case"error":e.usePreviousDataOnError&&e.data!==void 0?t=e.data:e.usePlaceholderOnError&&e.placeholderData!==void 0&&(t=e.placeholderData,a=!0);break;case"fetching":e.data!==void 0?(t=e.data,a=!1):e.placeholderData&&(t=e.placeholderData,a=!0);break;case"success":case"idle":t=e.data??e.placeholderData,a=e.data?!1:!!e.placeholderData;break}return {data:t,error:e.error,status:e.status,updatedAt:e.updatedAt,isStale:s,isPlaceholderData:a,isLoading:e.status==="fetching"&&!e.updatedAt,isFetching:e.status==="fetching",isError:e.isError,isSuccess:e.isSuccess,refetch:e.refetch}}function S(e){console.warn(`[qortex] No fetcher or data for key "${c(e)}". Register a fetcher or set initial data.`);}var d=class{constructor(){this.cache=new Map;this.subs=new Map;this.defaultConfig={};this.throttleTime=50;this.persister=null;this.hasQueriesBeenUsed=!1;}dangerClearCache(){this.cache.clear(),this.subs.clear(),this.persister?.clear();}setDefaultConfig({throttleTime:r,persister:s,...t}){this.defaultConfig={...this.defaultConfig,...t},r!==void 0&&(this.throttleTime=r),s&&(this.persister=s,this.persister?.load(this.cache,this.hasQueriesBeenUsed));}ensureState(r,s={}){this.hasQueriesBeenUsed=!0;let t=c(r),a=this.cache.get(t);if(a){let i={...this.defaultConfig,...a,...s};Object.assign(a,i),a.enabled=i.enabled!==!1,this.cache.set(t,a);}else {let i={...this.defaultConfig,...s},o=Q(i,()=>this.fetchQuery(r));this.cache.set(t,o);}return this.cache.get(t)}emit(r,s){let t=c(r);this.cache.set(t,s),this.persister?.sync(this.cache);let a=this.subs.get(t);if(!a)return;let i=f(s);for(let o of Array.from(a))o(i);}registerFetcher(r,s){let t=this.ensureState(r,s);this.handleMountLogic(r,t);}fetchQuery(r,s){let t=this.ensureState(r,s);if(t.fetchPromise)return t.fetchPromise;let a=t.fetcher;if(!a)return t.updatedAt===void 0&&S(r),Promise.resolve(t.data);let i=a();return t.fetchPromise=i,t.status="fetching",t.lastFetchTime=Date.now(),this.emit(r,t),i.then(o=>{t.data=t.equalityFn(t.data,o)?t.data:o,t.status="success",t.isError=!1,t.isSuccess=!0,t.updatedAt=Date.now(),t.fetchPromise=void 0,t.error=void 0,this.emit(r,t);}).catch(o=>{t.error=o,t.status="error",t.isError=!0,t.isSuccess=!1,t.updatedAt=Date.now(),t.fetchPromise=void 0,this.emit(r,t);}),i}setQueryData(r,s){let t=this.ensureState(r),a=t.data;t.equalityFn(a,s)||(t.data=s,t.updatedAt=Date.now(),t.error=void 0,t.status="success",t.isInvalidated=!1,t.isError=!1,t.isSuccess=!0,this.emit(r,t));}getQueryData(r,s){let t=this.ensureState(r,s);return this.handleMountLogic(r,t),f(t).data}getQueryState(r,s){let t=this.ensureState(r,s);this.handleMountLogic(r,t);let a=f(t),i=t.lastReturnedState;return !i||!y(i,a,"shallow")?(t.lastReturnedState=a,a):i}invalidateQuery(r){let s=this.ensureState(r);s.isInvalidated=!0,this.emit(r,s),this.fetchQuery(r);}subscribeQuery(r,s,t){let a=c(r),i=this.ensureState(r,t);return this.subs.has(a)||this.subs.set(a,new Set),this.subs.get(a).add(s),this.handleMountLogic(r,i),()=>{this.subs.get(a).delete(s);}}handleMountLogic(r,s){let t=s.lastFetchTime&&Date.now()-s.lastFetchTime<this.throttleTime;if(s.status==="fetching"||!s.enabled||t||!s.fetcher)return;let a=Date.now(),i=s.updatedAt==null||a-(s.updatedAt||0)>s.staleTime||s.isInvalidated,o=!1;s.updatedAt==null?o=!0:(s.refetchOnSubscribe==="always"&&(o=!0),s.refetchOnSubscribe==="stale"&&(o=i)),o&&this.fetchQuery(r);}},g=d;var n=new g,k=n.registerFetcher.bind(n),j=n.fetchQuery.bind(n),N=n.setQueryData.bind(n),L=n.getQueryData.bind(n),B=n.getQueryState.bind(n),U=n.invalidateQuery.bind(n),J=n.subscribeQuery.bind(n),_=n.setDefaultConfig.bind(n),V=n.dangerClearCache.bind(n);function P(e){return typeof e=="string"&&["idle","fetching","success","error"].includes(e)}function K(e){return typeof e=="string"&&["shallow","deep"].includes(e)}function O(e){return e===!1||typeof e=="string"&&["always","stale"].includes(e)}function D(e){return !(!e||typeof e!="object"||!P(e.status)||typeof e.staleTime!="number"||e.staleTime<0||typeof e.isInvalidated!="boolean"||!K(e.equalityStrategy)||!O(e.refetchOnSubscribe))}function m(e){if(!e||typeof e!="object"||!e.entries||typeof e.entries!="object")return !1;for(let[r,s]of Object.entries(e.entries))if(typeof r!="string"||!D(s))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function b(e){let{fetcher:r,equalityFn:s,fetchPromise:t,refetch:a,...i}=e;return i}function T(e,r){let s={...r??{},...e};return {...s,equalityFn:r?.equalityFn||p(s.equalityStrategy)}}function F(e){try{let r=JSON.parse(e);return m(r)?r:null}catch{return null}}var v=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},w=()=>{console.warn("[Qortex] Persister is being set after queries have been used. This may cause data inconsistency. It is recommended to set the persister before any query usage.");};var h=class{constructor(r,s){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.0";this.storageKey="qortex";this.storage=r,this.burstKey=s?.burstKey??this.burstKey,this.storageKey=s?.prefix??this.storageKey,this.debounceTime=s?.debounceTime??this.debounceTime;}save(r){try{let s={entries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[a,i]of Object.entries(r))s.entries[a]=i;let t=JSON.stringify(s);this.storage.setItem(this.storageKey,t);}catch(s){console.warn("[Qortex] Failed to persist state:",s);}}load(r,s){s&&w();try{let t=this.storage.getItem(this.storageKey);if(!t)return;let a=F(t);if(!a){console.warn("[Qortex] Invalid persisted state format, clearing cache"),this.clear();return}if(a.burstKey!==this.burstKey){console.warn("[Qortex] Burst key mismatch, clearing cache"),this.clear();return}for(let[i,o]of Object.entries(a.entries)){let u=o,l=r.get(i),x=T(u,l);r.set(i,x);}}catch(t){console.warn("[Qortex] Failed to load persisted state:",t),this.clear();}}clear(){try{this.storage.removeItem(this.storageKey);}catch(r){console.warn("[Qortex] Failed to clear persisted data:",r);}}sync(r){this.syncTimeout&&clearTimeout(this.syncTimeout),this.syncTimeout=setTimeout(()=>{let s={};for(let[t,a]of r.entries())s[t]=b(a);this.save(s);},this.debounceTime);}};var I=e=>{switch(e){case"local":if(typeof localStorage<"u")return window.localStorage;break;case"session":if(typeof sessionStorage<"u")return window.sessionStorage;break;default:throw new Error(`Invalid storage type: ${e}`)}},C=(e,r)=>{let s=I(e);if(!s){v();return}return new h(s,r)};
 
-export { f as QueryManagerCore, i as _queryManager, I as dangerClearCache, O as fetchQuery, C as getQueryData, w as getQueryState, x as invalidateQuery, v as registerFetcher, c as serializeKey, E as setDefaultConfig, K as setQueryData, A as subscribeQuery };
+export { d as QueryManagerCore, n as _queryManager, C as createPersister, V as dangerClearCache, j as fetchQuery, L as getQueryData, B as getQueryState, U as invalidateQuery, k as registerFetcher, c as serializeKey, _ as setDefaultConfig, N as setQueryData, J as subscribeQuery };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qortex-core",
-  "version": "0.2.8",
+  "version": "0.3.0-beta.1",
   "description": "Framework-agnostic query cache & fetch registry (MFE friendly).",
   "main": "index.js",
   "module": "index.mjs",