qortex-core 0.3.0-beta.1 → 0.3.0-beta.3

package/index.d.ts

@@ -1,198 +1,5 @@
-/**
- * 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
- */
-type QueryKey = string | readonly (string | number)[];
-/** Function that fetches data, must be async */
-type Fetcher<T = any> = () => Promise<T>;
-/** Function that compares two values for equality */
-type EqualityFn<T = any> = (a: T | undefined, b: T | undefined) => boolean;
-/** Strategy for equality comparison */
-type EqualityStrategy = 'shallow' | 'deep';
-/**
- * Infers the return type of a fetcher function
- *
- * This utility type extracts the return type from a fetcher function,
- * handling both synchronous and asynchronous fetchers.
- *
- * @example
- * ```typescript
- * const fetchUser = async (id: string): Promise<User> => { ... };
- * type UserType = InferFetcherResult<typeof fetchUser>; // Promise<User>
- *
- * const fetchConfig = (): Config => { ... };
- * type ConfigType = InferFetcherResult<typeof fetchConfig>; // Config
- * ```
- *
- * @template F - The fetcher function type
- * @returns The inferred return type of the fetcher, or `any` if inference fails
- */
-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?: RefetchOnSubscribeOptions;
-    fetcher?: Fetcher<T>;
-    equalityFn?: EqualityFn<T>;
-    equalityStrategy?: EqualityStrategy;
-    staleTime?: number;
-    signal?: AbortSignal;
-    placeholderData?: T;
-    usePreviousDataOnError?: boolean;
-    usePlaceholderOnError?: boolean;
-};
-/**
- * Default configuration options that can be set globally
- * Includes throttleTime which is not part of regular QueryOptions
- */
-type DefaultConfig = {
-    enabled?: boolean;
-    refetchOnSubscribe?: RefetchOnSubscribeOptions;
-    staleTime?: number;
-    usePreviousDataOnError?: boolean;
-    usePlaceholderOnError?: boolean;
-    equalityFn?: EqualityFn<any>;
-    equalityStrategy?: EqualityStrategy;
-    throttleTime?: number;
-    persister?: Persister;
-};
-/**
- * Public query state returned by getQueryState
- * Improved with stricter error typing and better generic constraints
- */
-type QueryState<T = any, E = unknown> = {
-    data?: T;
-    error?: E;
-    status: QueryStatus;
-    updatedAt?: number;
-    isStale: boolean;
-    isPlaceholderData: boolean;
-    isLoading: boolean;
-    isFetching: boolean;
-    isError: boolean;
-    isSuccess: boolean;
-    refetch: () => Promise<T>;
-};
+import { D as DefaultConfig, Q as QueryKey, a as QueryOptions, F as Fetcher, I as InferFetcherResult, b as QueryState } from './types-14ced1fe.js';
+export { E as EqualityFn, c as EqualityStrategy, d as QueryStatus, R as RefetchOnSubscribeOptions } from './types-14ced1fe.js';
 
 /**
  * Core query manager that handles caching, fetching, and state management
@@ -318,4 +125,4 @@ declare const dangerClearCache: QueryManagerCore["dangerClearCache"];
  */
 declare function serializeKey(key: QueryKey): string;
 
-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 };
+export { DefaultConfig, Fetcher, InferFetcherResult, QueryKey, QueryManagerCore, QueryOptions, QueryState, _queryManager, dangerClearCache, fetchQuery, getQueryData, getQueryState, invalidateQuery, registerFetcher, serializeKey, setDefaultConfig, setQueryData, subscribeQuery };

package/index.js

@@ -1,17 +1,16 @@
 'use strict';
 
-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)};
+function c(t){return Array.isArray(t)?t.join(","):String(t)}function l(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,s=r;if(Array.isArray(e)&&Array.isArray(s)){if(e.length!==s.length)return !1;for(let o=0;o<e.length;o++)if(a==="deep"){if(!l(e[o],s[o],a))return !1}else if(e[o]!==s[o])return !1;return !0}if(Array.isArray(e)||Array.isArray(s))return !1;let n=Object.keys(e),u=Object.keys(s);if(n.length!==u.length)return !1;for(let o=0;o<n.length;o++){let y=n[o];if(a==="deep"){if(!l(e[y],s[y],a))return !1}else if(e[y]!==s[y])return !1}return !0}catch{return !1}}function d(t,r){return r||((a,e)=>l(a,e,t||"shallow"))}function Q(t,r){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:d(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 f(t){let r=Date.now(),a=t.updatedAt!==void 0&&r-t.updatedAt>t.staleTime||t.isInvalidated,e,s=!1;switch(t.status){case"error":t.usePreviousDataOnError&&t.data!==void 0?e=t.data:t.usePlaceholderOnError&&t.placeholderData!==void 0&&(e=t.placeholderData,s=!0);break;case"fetching":t.data!==void 0?(e=t.data,s=!1):t.placeholderData&&(e=t.placeholderData,s=!0);break;case"success":case"idle":e=t.data??t.placeholderData,s=t.data?!1:!!t.placeholderData;break}return {data:e,error:t.error,status:t.status,updatedAt:t.updatedAt,isStale:a,isPlaceholderData:s,isLoading:t.status==="fetching"&&!t.updatedAt,isFetching:t.status==="fetching",isError:t.isError,isSuccess:t.isSuccess,refetch:t.refetch}}function p(t){console.warn(`[qortex] No fetcher or data for key "${c(t)}". Register a fetcher or set initial data.`);}var h=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:a,...e}){this.defaultConfig={...this.defaultConfig,...e},r!==void 0&&(this.throttleTime=r),a&&(this.persister=a,this.persister?.load(this.cache,this.hasQueriesBeenUsed));}ensureState(r,a={}){this.hasQueriesBeenUsed=!0;let e=c(r),s=this.cache.get(e);if(s){let n={...this.defaultConfig,...s,...a};Object.assign(s,n),s.enabled=n.enabled!==!1,this.cache.set(e,s);}else {let n={...this.defaultConfig,...a},u=Q(n,()=>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),this.persister?.sync(this.cache);let s=this.subs.get(e);if(!s)return;let n=f(a);for(let u of Array.from(s))u(n);}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 s=e.fetcher;if(!s)return e.updatedAt===void 0&&p(r),Promise.resolve(e.data);let n=s();return e.fetchPromise=n,e.status="fetching",e.lastFetchTime=Date.now(),this.emit(r,e),n.then(u=>{let o=d(e.equalityStrategy,e.equalityFn);e.data=o(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);}),n}setQueryData(r,a){let e=this.ensureState(r),s=e.data;d(e.equalityStrategy,e.equalityFn)(s,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),f(e).data}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let s=f(e),n=e.lastReturnedState;return !n||!l(n,s,"shallow")?(e.lastReturnedState=s,s):n}invalidateQuery(r){let a=this.ensureState(r);a.isInvalidated=!0,this.emit(r,a),this.fetchQuery(r);}subscribeQuery(r,a,e){let s=c(r),n=this.ensureState(r,e);return this.subs.has(s)||this.subs.set(s,new Set),this.subs.get(s).add(a),this.handleMountLogic(r,n),()=>{this.subs.get(s).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 s=Date.now(),n=a.updatedAt==null||s-(a.updatedAt||0)>a.staleTime||a.isInvalidated,u=!1;a.updatedAt==null?u=!0:(a.refetchOnSubscribe==="always"&&(u=!0),a.refetchOnSubscribe==="stale"&&(u=n)),u&&this.fetchQuery(r);}},g=h;var i=new g,D=i.registerFetcher.bind(i),O=i.fetchQuery.bind(i),K=i.setQueryData.bind(i),C=i.getQueryData.bind(i),E=i.getQueryState.bind(i),w=i.invalidateQuery.bind(i),x=i.subscribeQuery.bind(i),A=i.setDefaultConfig.bind(i),q=i.dangerClearCache.bind(i);
 
-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.QueryManagerCore = h;
+exports._queryManager = i;
+exports.dangerClearCache = q;
+exports.fetchQuery = O;
+exports.getQueryData = C;
+exports.getQueryState = E;
+exports.invalidateQuery = w;
+exports.registerFetcher = D;
 exports.serializeKey = c;
-exports.setDefaultConfig = _;
-exports.setQueryData = N;
-exports.subscribeQuery = J;
+exports.setDefaultConfig = A;
+exports.setQueryData = K;
+exports.subscribeQuery = x;

package/index.mjs

@@ -1,3 +1,3 @@
-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)};
+function c(t){return Array.isArray(t)?t.join(","):String(t)}function l(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,s=r;if(Array.isArray(e)&&Array.isArray(s)){if(e.length!==s.length)return !1;for(let o=0;o<e.length;o++)if(a==="deep"){if(!l(e[o],s[o],a))return !1}else if(e[o]!==s[o])return !1;return !0}if(Array.isArray(e)||Array.isArray(s))return !1;let n=Object.keys(e),u=Object.keys(s);if(n.length!==u.length)return !1;for(let o=0;o<n.length;o++){let y=n[o];if(a==="deep"){if(!l(e[y],s[y],a))return !1}else if(e[y]!==s[y])return !1}return !0}catch{return !1}}function d(t,r){return r||((a,e)=>l(a,e,t||"shallow"))}function Q(t,r){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:d(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 f(t){let r=Date.now(),a=t.updatedAt!==void 0&&r-t.updatedAt>t.staleTime||t.isInvalidated,e,s=!1;switch(t.status){case"error":t.usePreviousDataOnError&&t.data!==void 0?e=t.data:t.usePlaceholderOnError&&t.placeholderData!==void 0&&(e=t.placeholderData,s=!0);break;case"fetching":t.data!==void 0?(e=t.data,s=!1):t.placeholderData&&(e=t.placeholderData,s=!0);break;case"success":case"idle":e=t.data??t.placeholderData,s=t.data?!1:!!t.placeholderData;break}return {data:e,error:t.error,status:t.status,updatedAt:t.updatedAt,isStale:a,isPlaceholderData:s,isLoading:t.status==="fetching"&&!t.updatedAt,isFetching:t.status==="fetching",isError:t.isError,isSuccess:t.isSuccess,refetch:t.refetch}}function p(t){console.warn(`[qortex] No fetcher or data for key "${c(t)}". Register a fetcher or set initial data.`);}var h=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:a,...e}){this.defaultConfig={...this.defaultConfig,...e},r!==void 0&&(this.throttleTime=r),a&&(this.persister=a,this.persister?.load(this.cache,this.hasQueriesBeenUsed));}ensureState(r,a={}){this.hasQueriesBeenUsed=!0;let e=c(r),s=this.cache.get(e);if(s){let n={...this.defaultConfig,...s,...a};Object.assign(s,n),s.enabled=n.enabled!==!1,this.cache.set(e,s);}else {let n={...this.defaultConfig,...a},u=Q(n,()=>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),this.persister?.sync(this.cache);let s=this.subs.get(e);if(!s)return;let n=f(a);for(let u of Array.from(s))u(n);}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 s=e.fetcher;if(!s)return e.updatedAt===void 0&&p(r),Promise.resolve(e.data);let n=s();return e.fetchPromise=n,e.status="fetching",e.lastFetchTime=Date.now(),this.emit(r,e),n.then(u=>{let o=d(e.equalityStrategy,e.equalityFn);e.data=o(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);}),n}setQueryData(r,a){let e=this.ensureState(r),s=e.data;d(e.equalityStrategy,e.equalityFn)(s,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),f(e).data}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let s=f(e),n=e.lastReturnedState;return !n||!l(n,s,"shallow")?(e.lastReturnedState=s,s):n}invalidateQuery(r){let a=this.ensureState(r);a.isInvalidated=!0,this.emit(r,a),this.fetchQuery(r);}subscribeQuery(r,a,e){let s=c(r),n=this.ensureState(r,e);return this.subs.has(s)||this.subs.set(s,new Set),this.subs.get(s).add(a),this.handleMountLogic(r,n),()=>{this.subs.get(s).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 s=Date.now(),n=a.updatedAt==null||s-(a.updatedAt||0)>a.staleTime||a.isInvalidated,u=!1;a.updatedAt==null?u=!0:(a.refetchOnSubscribe==="always"&&(u=!0),a.refetchOnSubscribe==="stale"&&(u=n)),u&&this.fetchQuery(r);}},g=h;var i=new g,D=i.registerFetcher.bind(i),O=i.fetchQuery.bind(i),K=i.setQueryData.bind(i),C=i.getQueryData.bind(i),E=i.getQueryState.bind(i),w=i.invalidateQuery.bind(i),x=i.subscribeQuery.bind(i),A=i.setDefaultConfig.bind(i),q=i.dangerClearCache.bind(i);
 
-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 };
+export { h as QueryManagerCore, i as _queryManager, q as dangerClearCache, O as fetchQuery, C as getQueryData, E as getQueryState, w as invalidateQuery, D as registerFetcher, c as serializeKey, A as setDefaultConfig, K as setQueryData, x as subscribeQuery };

package/package.json

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