qortex-core 0.3.0-beta.4 → 0.3.0-beta.6

package/index.d.ts

@@ -1,5 +1,5 @@
-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';
+import { D as DefaultConfig, Q as QueryKey, a as QueryOptions, F as Fetcher, I as InferFetcherResult, b as QueryState } from './types-96ae2039.js';
+export { E as EqualityFn, c as EqualityStrategy, d as QueryStatus, R as RefetchOnSubscribeOptions } from './types-96ae2039.js';
 
 /**
  * Core query manager that handles caching, fetching, and state management
@@ -12,32 +12,7 @@ declare class QueryManagerCore {
     private throttleTime;
     private persister;
     private hasQueriesBeenUsed;
-    /**
-     * ⚠️ DANGER: Clear all cached data and subscriptions
-     *
-     * This method completely wipes all internal state including:
-     * - 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.
-     *
-     * @example
-     * ```typescript
-     * // ✅ Safe usage in tests
-     * beforeEach(() => {
-     *   queryManager.dangerClearCache();
-     * });
-     *
-     * // ❌ Dangerous usage in production
-     * // queryManager.dangerClearCache(); // Don't do this!
-     * ```
-     */
     dangerClearCache(): void;
-    /**
-     * Set default configuration for all queries
-     */
     setDefaultConfig({ throttleTime, persister, ...config }: DefaultConfig): void;
     /**
      * Ensures a query state exists in cache, creating it if necessary
@@ -48,54 +23,24 @@ declare class QueryManagerCore {
      * Notifies all subscribers of a query state change
      */
     private emit;
-    /**
-    * Registers a fetcher function for a query key
-    * Automatically fetches if enabled is not false
-    * Enhanced with automatic type inference from fetcher
-    */
     registerFetcher<T = any>(key: QueryKey, opts: QueryOptions<T>): void;
     registerFetcher<F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
         fetcher: F;
     }): void;
-    /**
-    * Executes a fetch operation with proper error handling and state management
-    * Prevents duplicate fetches
-    * Enhanced with automatic type inference from fetcher
-    */
     fetchQuery<T = any>(key: QueryKey, opts?: QueryOptions<T>): Promise<T>;
     fetchQuery<F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
         fetcher: F;
     }): Promise<InferFetcherResult<F>>;
-    /**
-     * Manually sets query data without triggering a fetch
-     * Marks query as successful
-     */
     setQueryData<T = any>(key: QueryKey, data: T): void;
-    /**
-     * Gets query data
-     * Handles mount logic to potentially start fetching
-     */
     getQueryData<T = any>(key: QueryKey, opts?: QueryOptions<T>): T | undefined;
     getQueryData<F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
         fetcher: F;
     }): InferFetcherResult<F> | undefined;
-    /**
-     * Gets comprehensive query state including computed flags
-     * Handles placeholder data and error states appropriately
-     * Handles mount logic to potentially start fetching
-     */
     getQueryState<T = unknown>(key: QueryKey, opts?: QueryOptions<T>): QueryState<T>;
     getQueryState<F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
         fetcher: F;
     }): QueryState<InferFetcherResult<F>>;
-    /**
-     * Marks a query as invalidated, triggering refetch
-     */
     invalidateQuery(key: QueryKey): void;
-    /**
-     * Subscribes to query state changes with automatic subscription management
-     * Handles mount logic to potentially start fetching
-     */
     subscribeQuery(key: QueryKey, cb: (state: QueryState<any>) => void): () => void;
     subscribeQuery<F extends Fetcher>(key: QueryKey, cb: (state: QueryState<InferFetcherResult<F>>) => void, opts: QueryOptions<InferFetcherResult<F>> & {
         fetcher: F;
@@ -109,15 +54,168 @@ declare class QueryManagerCore {
 }
 
 declare const _queryManager: QueryManagerCore;
-declare const registerFetcher: QueryManagerCore["registerFetcher"];
-declare const fetchQuery: QueryManagerCore["fetchQuery"];
-declare const setQueryData: QueryManagerCore["setQueryData"];
-declare const getQueryData: QueryManagerCore["getQueryData"];
-declare const getQueryState: QueryManagerCore["getQueryState"];
-declare const invalidateQuery: QueryManagerCore["invalidateQuery"];
-declare const subscribeQuery: QueryManagerCore["subscribeQuery"];
-declare const setDefaultConfig: QueryManagerCore["setDefaultConfig"];
-declare const dangerClearCache: QueryManagerCore["dangerClearCache"];
+
+/**
+ * Registers a fetcher function for a query key and sets up the query state
+ *
+ * @param key - Unique identifier for the query (string or array of primitives)
+ * @param opts - Query configuration options
+ * @param opts.fetcher - Async function that fetches data for this query
+ * @param opts.enabled - Whether the query should be active (default: true)
+ * @param opts.staleTime - Time in ms before data is considered stale (default: 0)
+ * @param opts.equalityStrategy - How to compare data for changes ('shallow' | 'deep')
+ * @param opts.equalityFn - Custom equality function for data comparison
+ * @param opts.refetchOnSubscribe - When to refetch on subscription ('always' | 'stale' | false)
+ * @param opts.placeholderData - Initial data to show while loading
+ * @param opts.usePreviousDataOnError - Keep previous data when error occurs
+ * @param opts.usePlaceholderOnError - Use placeholder data when error occurs
+ *
+ * Automatically triggers initial fetch if enabled is not false. Enhanced with automatic type inference from fetcher function.
+ */
+declare const registerFetcher: {
+    <T = any>(key: QueryKey, opts: QueryOptions<T>): void;
+    <F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
+        fetcher: F;
+    }): void;
+};
+/**
+ * Executes a fetch operation with proper error handling and state management
+ *
+ * @param key - Unique identifier for the query
+ * @param opts - Optional query configuration (if not already registered)
+ * @returns Promise that resolves to the fetched data
+ *
+ * Prevents duplicate fetches by tracking ongoing promises. Enhanced with automatic type inference from fetcher function.
+ * Updates query state with loading, success, or error status. Handles race conditions and concurrent requests.
+ */
+declare const fetchQuery: {
+    <T = any>(key: QueryKey, opts?: QueryOptions<T>): Promise<T>;
+    <F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
+        fetcher: F;
+    }): Promise<InferFetcherResult<F>>;
+};
+/**
+ * Manually sets query data without triggering a fetch operation
+ *
+ * @param key - Unique identifier for the query
+ * @param data - Data to set for the query
+ *
+ * Marks the query as successful and updates the cache. Useful for optimistic updates or setting initial data.
+ * Triggers all subscribers with the new data. Does not affect the fetcher function or trigger network requests.
+ */
+declare const setQueryData: <T = any>(key: QueryKey, data: T) => void;
+/**
+ * Gets the current data for a query
+ *
+ * @param key - Unique identifier for the query
+ * @param opts - Optional query configuration (if not already registered)
+ * @returns The current data value or undefined if not available
+ *
+ * Handles mount logic to potentially start fetching if data is stale or missing.
+ * Returns undefined if the query has never been fetched or if an error occurred.
+ */
+declare const getQueryData: {
+    <T = any>(key: QueryKey, opts?: QueryOptions<T>): T | undefined;
+    <F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
+        fetcher: F;
+    }): InferFetcherResult<F> | undefined;
+};
+/**
+ * Gets the complete query state including loading, error, and computed flags
+ *
+ * @param key - Unique identifier for the query
+ * @param opts - Optional query configuration (if not already registered)
+ * @returns QueryState object with data, error, status, and computed flags
+ *
+ * Returns an object containing:
+ * - data: The current data value
+ * - error: Any error that occurred during fetching
+ * - status: Current status ('idle' | 'fetching' | 'success' | 'error')
+ * - isStale: Whether the data is considered stale
+ * - isLoading: Whether the query is currently loading
+ * - isFetching: Whether a fetch is in progress
+ * - isError: Whether the query is in an error state
+ * - isSuccess: Whether the query completed successfully
+ * - refetch: Function to manually trigger a refetch
+ *
+ * Handles mount logic to potentially start fetching if data is stale or missing.
+ */
+declare const getQueryState: {
+    <T = unknown>(key: QueryKey, opts?: QueryOptions<T>): QueryState<T>;
+    <F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
+        fetcher: F;
+    }): QueryState<InferFetcherResult<F>>;
+};
+/**
+ * Invalidates a query, marking it as stale and triggering a refetch
+ *
+ * @param key - Unique identifier for the query
+ *
+ * Marks the query as invalidated and immediately triggers a refetch operation.
+ * Useful for forcing data refresh after mutations or when you know data is outdated.
+ * All subscribers will be notified of the state changes.
+ */
+declare const invalidateQuery: (key: QueryKey) => void;
+/**
+ * Subscribes to query state changes and returns an unsubscribe function
+ *
+ * @param key - Unique identifier for the query
+ * @param callback - Function called whenever the query state changes
+ * @param opts - Optional query configuration (if not already registered)
+ * @returns Unsubscribe function to stop receiving updates
+ *
+ * The callback receives the current QueryState object. Handles mount logic to potentially start fetching.
+ * Returns a cleanup function that should be called when the subscription is no longer needed.
+ * Multiple subscribers can be registered for the same query key.
+ */
+declare const subscribeQuery: {
+    (key: QueryKey, cb: (state: QueryState<any>) => void): () => void;
+    <F extends Fetcher>(key: QueryKey, cb: (state: QueryState<InferFetcherResult<F>>) => void, opts: QueryOptions<InferFetcherResult<F>> & {
+        fetcher: F;
+    }): () => void;
+    <T = any>(key: QueryKey, cb: (state: QueryState<T>) => void, opts?: QueryOptions<T>): () => void;
+};
+/**
+ * Sets default configuration that applies to all queries
+ *
+ * @param config - Default configuration object
+ * @param config.enabled - Default enabled state for all queries
+ * @param config.staleTime - Default stale time in milliseconds
+ * @param config.refetchOnSubscribe - Default refetch behavior on subscription
+ * @param config.equalityStrategy - Default equality comparison strategy
+ * @param config.equalityFn - Default equality function
+ * @param config.usePreviousDataOnError - Default behavior for previous data on error
+ * @param config.usePlaceholderOnError - Default behavior for placeholder data on error
+ * @param config.throttleTime - Time in ms to throttle fetch requests (default: 1000)
+ * @param config.persister - Persister instance for data persistence
+ *
+ * These defaults will be merged with individual query options. Useful for setting global behavior
+ * like default stale times, error handling, or persistence configuration.
+ */
+declare const setDefaultConfig: ({ throttleTime, persister, ...config }: DefaultConfig) => void;
+/**
+ * ⚠️ DANGER: Clear all cached data and subscriptions
+ *
+ * This method completely wipes all internal state including:
+ * - 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.
+ *
+ * @example
+ * ```typescript
+ * // ✅ Safe usage in tests
+ * beforeEach(() => {
+ *   dangerClearCache();
+ * });
+ *
+ * // ❌ Dangerous usage in production
+ * // dangerClearCache(); // Don't do this!
+ * ```
+ */
+declare const dangerClearCache: () => void;
 
 /**
  * Normalizes query keys to a consistent string format for internal storage

package/index.js

@@ -1,16 +1,16 @@
 'use strict';
 
-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);
+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 p(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 Q(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,this.defaultConfig));}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=p(n,()=>this.fetchQuery(r));this.cache.set(e,u);}return this.persister?.sync(this.cache,this.defaultConfig),this.cache.get(e)}emit(r,a){let e=c(r);this.cache.set(e,a),this.persister?.sync(this.cache,this.defaultConfig);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&&Q(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;var D=i.registerFetcher.bind(i),O=i.fetchQuery.bind(i),K=i.setQueryData.bind(i),x=i.getQueryData.bind(i),E=i.getQueryState.bind(i),w=i.invalidateQuery.bind(i),A=i.subscribeQuery.bind(i),q=i.setDefaultConfig.bind(i),I=i.dangerClearCache.bind(i);
 
 exports.QueryManagerCore = h;
 exports._queryManager = i;
-exports.dangerClearCache = q;
+exports.dangerClearCache = I;
 exports.fetchQuery = O;
-exports.getQueryData = C;
+exports.getQueryData = x;
 exports.getQueryState = E;
 exports.invalidateQuery = w;
 exports.registerFetcher = D;
 exports.serializeKey = c;
-exports.setDefaultConfig = A;
+exports.setDefaultConfig = q;
 exports.setQueryData = K;
-exports.subscribeQuery = x;
+exports.subscribeQuery = A;

package/index.mjs

@@ -1,3 +1,3 @@
-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);
+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 p(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 Q(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,this.defaultConfig));}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=p(n,()=>this.fetchQuery(r));this.cache.set(e,u);}return this.persister?.sync(this.cache,this.defaultConfig),this.cache.get(e)}emit(r,a){let e=c(r);this.cache.set(e,a),this.persister?.sync(this.cache,this.defaultConfig);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&&Q(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;var D=i.registerFetcher.bind(i),O=i.fetchQuery.bind(i),K=i.setQueryData.bind(i),x=i.getQueryData.bind(i),E=i.getQueryState.bind(i),w=i.invalidateQuery.bind(i),A=i.subscribeQuery.bind(i),q=i.setDefaultConfig.bind(i),I=i.dangerClearCache.bind(i);
 
-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 };
+export { h as QueryManagerCore, i as _queryManager, I as dangerClearCache, O as fetchQuery, x as getQueryData, E as getQueryState, w as invalidateQuery, D as registerFetcher, c as serializeKey, q as setDefaultConfig, K as setQueryData, A as subscribeQuery };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qortex-core",
-  "version": "0.3.0-beta.4",
+  "version": "0.3.0-beta.6",
   "description": "Framework-agnostic query cache & fetch registry (MFE friendly).",
   "main": "index.js",
   "module": "index.mjs",
@@ -12,10 +12,10 @@
       "import": "./index.mjs",
       "require": "./index.js"
     },
-    "./persister-export": {
-      "types": "./persister-export.d.ts",
-      "import": "./persister-export.mjs",
-      "require": "./persister-export.js"
+    "./persister": {
+      "types": "./persister.d.ts",
+      "import": "./persister.mjs",
+      "require": "./persister.js"
     }
   },
   "publishConfig": {
@@ -25,9 +25,10 @@
     "index.js",
     "index.mjs",
     "index.d.ts",
-    "persister-export.js",
-    "persister-export.mjs",
-    "persister-export.d.ts",
+    "persister.js",
+    "persister.mjs",
+    "persister.d.ts",
+    "types-96ae2039.d.ts",
     "README.md"
   ],
   "repository": {

package/{persister-export.d.ts → persister.d.ts}

@@ -1,5 +1,5 @@
-import { P as PersisterConfig, B as BasePersister } from './types-14ced1fe.js';
-export { e as Persister } from './types-14ced1fe.js';
+import { P as PersisterConfig, B as BasePersister } from './types-96ae2039.js';
+export { e as Persister } from './types-96ae2039.js';
 
 /**
  * Creates a persister instance for data persistence.

package/persister.js

@@ -0,0 +1,5 @@
+'use strict';
+
+function w(e){return typeof e=="string"&&["idle","fetching","success","error"].includes(e)}function x(e){return typeof e=="string"&&["shallow","deep"].includes(e)}function T(e){return e===!1||typeof e=="string"&&["always","stale"].includes(e)}function q(e){return !(!e||typeof e!="object"||!w(e.status)||typeof e.staleTime!="number"||e.staleTime<0||typeof e.isInvalidated!="boolean"||!x(e.equalityStrategy)||!T(e.refetchOnSubscribe))}function c(e){if(!e||typeof e!="object"||!e.queries||typeof e.queries!="object")return !1;for(let[t,r]of Object.entries(e.queries))if(typeof t!="string"||!q(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function p(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:a,...i}=e;return i}function d(e,t){return {...t??{},...e}}function S(e){try{let t=JSON.parse(e);return c(t)?t:null}catch{return null}}var m=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},g=()=>{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 o=class{constructor(t,r){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.0";this.storageKey="qortex";this.storage=t,this.burstKey=r?.burstKey??this.burstKey,this.storageKey=r?.prefix??this.storageKey,this.debounceTime=r?.debounceTime??this.debounceTime;}save(t,r){try{let s={queries:{},burstKey:this.burstKey,timestamp:Date.now(),defaultConfig:r};for(let[i,n]of Object.entries(t))s.queries[i]=n;let a=JSON.stringify(s);this.storage.setItem(this.storageKey,a);}catch(s){console.warn("[Qortex] Failed to persist state:",s);}}load(t,r,s){r&&g();try{let a=this.storage.getItem(this.storageKey);if(!a)return;let i=S(a);if(!i){console.warn("[Qortex] Invalid persisted state format, clearing cache"),this.clear();return}if(i.burstKey!==this.burstKey){console.warn("[Qortex] Burst key mismatch, clearing cache"),this.clear();return}let n=i.defaultConfig||{},h=this.hasDefaultConfigChanged(n,s);for(let[u,b]of Object.entries(i.queries)){let Q=b,P=t.get(u),l=d(Q,P);h&&(Object.keys(s).forEach(f=>{let y=s[f];y!==void 0&&(l[f]=y);}),l.enabled=s.enabled!==!1),t.set(u,l);}}catch(a){console.warn("[Qortex] Failed to load persisted state:",a),this.clear();}}hasDefaultConfigChanged(t,r){return !t||Object.keys(t).length===0?!0:Object.keys(r).some(s=>t[s]!==r[s])}clear(){try{this.storage.removeItem(this.storageKey);}catch(t){console.warn("[Qortex] Failed to clear persisted data:",t);}}sync(t,r){this.syncTimeout&&clearTimeout(this.syncTimeout),this.syncTimeout=setTimeout(()=>{let s={};for(let[a,i]of t.entries())s[a]=p(i);this.save(s,r);},this.debounceTime);}};var C=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}`)}},v=(e,t)=>{let r=C(e);if(!r){m();return}return new o(r,t)};
+
+exports.createPersister = v;

package/persister.mjs

@@ -0,0 +1,3 @@
+function w(e){return typeof e=="string"&&["idle","fetching","success","error"].includes(e)}function x(e){return typeof e=="string"&&["shallow","deep"].includes(e)}function T(e){return e===!1||typeof e=="string"&&["always","stale"].includes(e)}function q(e){return !(!e||typeof e!="object"||!w(e.status)||typeof e.staleTime!="number"||e.staleTime<0||typeof e.isInvalidated!="boolean"||!x(e.equalityStrategy)||!T(e.refetchOnSubscribe))}function c(e){if(!e||typeof e!="object"||!e.queries||typeof e.queries!="object")return !1;for(let[t,r]of Object.entries(e.queries))if(typeof t!="string"||!q(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function p(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:a,...i}=e;return i}function d(e,t){return {...t??{},...e}}function S(e){try{let t=JSON.parse(e);return c(t)?t:null}catch{return null}}var m=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},g=()=>{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 o=class{constructor(t,r){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.0";this.storageKey="qortex";this.storage=t,this.burstKey=r?.burstKey??this.burstKey,this.storageKey=r?.prefix??this.storageKey,this.debounceTime=r?.debounceTime??this.debounceTime;}save(t,r){try{let s={queries:{},burstKey:this.burstKey,timestamp:Date.now(),defaultConfig:r};for(let[i,n]of Object.entries(t))s.queries[i]=n;let a=JSON.stringify(s);this.storage.setItem(this.storageKey,a);}catch(s){console.warn("[Qortex] Failed to persist state:",s);}}load(t,r,s){r&&g();try{let a=this.storage.getItem(this.storageKey);if(!a)return;let i=S(a);if(!i){console.warn("[Qortex] Invalid persisted state format, clearing cache"),this.clear();return}if(i.burstKey!==this.burstKey){console.warn("[Qortex] Burst key mismatch, clearing cache"),this.clear();return}let n=i.defaultConfig||{},h=this.hasDefaultConfigChanged(n,s);for(let[u,b]of Object.entries(i.queries)){let Q=b,P=t.get(u),l=d(Q,P);h&&(Object.keys(s).forEach(f=>{let y=s[f];y!==void 0&&(l[f]=y);}),l.enabled=s.enabled!==!1),t.set(u,l);}}catch(a){console.warn("[Qortex] Failed to load persisted state:",a),this.clear();}}hasDefaultConfigChanged(t,r){return !t||Object.keys(t).length===0?!0:Object.keys(r).some(s=>t[s]!==r[s])}clear(){try{this.storage.removeItem(this.storageKey);}catch(t){console.warn("[Qortex] Failed to clear persisted data:",t);}}sync(t,r){this.syncTimeout&&clearTimeout(this.syncTimeout),this.syncTimeout=setTimeout(()=>{let s={};for(let[a,i]of t.entries())s[a]=p(i);this.save(s,r);},this.debounceTime);}};var C=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}`)}},v=(e,t)=>{let r=C(e);if(!r){m();return}return new o(r,t)};
+
+export { v as createPersister };

package/types-96ae2039.d.ts

@@ -0,0 +1,157 @@
+/**
+ * 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>, defaultConfig?: DefaultConfig): void;
+    /**
+     * Load state from storage and hydrate cache
+     */
+    load(cache: Map<string, QueryStateInternal>, hasQueriesBeenUsed: boolean, currentDefaultConfig: DefaultConfig): void;
+    /**
+     * Checks if the default config has changed by comparing stored and current configs
+     */
+    private hasDefaultConfigChanged;
+    /**
+     * Clear all persisted data
+     */
+    clear(): void;
+    /**
+     * Sync with debounced save (100ms delay)
+     * Handles serialization internally
+     */
+    sync(cache: Map<string, QueryStateInternal>, defaultConfig?: DefaultConfig): void;
+}
+type Persister = BasePersister;
+
+/**
+ * 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>;
+};
+
+export { BasePersister as B, DefaultConfig as D, EqualityFn as E, Fetcher as F, InferFetcherResult as I, PersisterConfig as P, QueryKey as Q, RefetchOnSubscribeOptions as R, QueryOptions as a, QueryState as b, EqualityStrategy as c, QueryStatus as d, Persister as e };

package/persister-export.js

@@ -1,5 +0,0 @@
-'use strict';
-
-function g(e){return typeof e=="string"&&["idle","fetching","success","error"].includes(e)}function h(e){return typeof e=="string"&&["shallow","deep"].includes(e)}function b(e){return e===!1||typeof e=="string"&&["always","stale"].includes(e)}function Q(e){return !(!e||typeof e!="object"||!g(e.status)||typeof e.staleTime!="number"||e.staleTime<0||typeof e.isInvalidated!="boolean"||!h(e.equalityStrategy)||!b(e.refetchOnSubscribe))}function n(e){if(!e||typeof e!="object"||!e.entries||typeof e.entries!="object")return !1;for(let[t,r]of Object.entries(e.entries))if(typeof t!="string"||!Q(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function l(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:i,...a}=e;return a}function u(e,t){return {...t??{},...e}}function y(e){try{let t=JSON.parse(e);return n(t)?t:null}catch{return null}}var f=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},c=()=>{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 o=class{constructor(t,r){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.0";this.storageKey="qortex";this.storage=t,this.burstKey=r?.burstKey??this.burstKey,this.storageKey=r?.prefix??this.storageKey,this.debounceTime=r?.debounceTime??this.debounceTime;}save(t){try{let r={entries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[i,a]of Object.entries(t))r.entries[i]=a;let s=JSON.stringify(r);this.storage.setItem(this.storageKey,s);}catch(r){console.warn("[Qortex] Failed to persist state:",r);}}load(t,r){r&&c();try{let s=this.storage.getItem(this.storageKey);if(!s)return;let i=y(s);if(!i){console.warn("[Qortex] Invalid persisted state format, clearing cache"),this.clear();return}if(i.burstKey!==this.burstKey){console.warn("[Qortex] Burst key mismatch, clearing cache"),this.clear();return}for(let[a,p]of Object.entries(i.entries)){let S=p,d=t.get(a),m=u(S,d);t.set(a,m);}}catch(s){console.warn("[Qortex] Failed to load persisted state:",s),this.clear();}}clear(){try{this.storage.removeItem(this.storageKey);}catch(t){console.warn("[Qortex] Failed to clear persisted data:",t);}}sync(t){this.syncTimeout&&clearTimeout(this.syncTimeout),this.syncTimeout=setTimeout(()=>{let r={};for(let[s,i]of t.entries())r[s]=l(i);this.save(r);},this.debounceTime);}};var P=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}`)}},w=(e,t)=>{let r=P(e);if(!r){f();return}return new o(r,t)};
-
-exports.createPersister = w;

package/persister-export.mjs

@@ -1,3 +0,0 @@
-function g(e){return typeof e=="string"&&["idle","fetching","success","error"].includes(e)}function h(e){return typeof e=="string"&&["shallow","deep"].includes(e)}function b(e){return e===!1||typeof e=="string"&&["always","stale"].includes(e)}function Q(e){return !(!e||typeof e!="object"||!g(e.status)||typeof e.staleTime!="number"||e.staleTime<0||typeof e.isInvalidated!="boolean"||!h(e.equalityStrategy)||!b(e.refetchOnSubscribe))}function n(e){if(!e||typeof e!="object"||!e.entries||typeof e.entries!="object")return !1;for(let[t,r]of Object.entries(e.entries))if(typeof t!="string"||!Q(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function l(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:i,...a}=e;return a}function u(e,t){return {...t??{},...e}}function y(e){try{let t=JSON.parse(e);return n(t)?t:null}catch{return null}}var f=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},c=()=>{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 o=class{constructor(t,r){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.0";this.storageKey="qortex";this.storage=t,this.burstKey=r?.burstKey??this.burstKey,this.storageKey=r?.prefix??this.storageKey,this.debounceTime=r?.debounceTime??this.debounceTime;}save(t){try{let r={entries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[i,a]of Object.entries(t))r.entries[i]=a;let s=JSON.stringify(r);this.storage.setItem(this.storageKey,s);}catch(r){console.warn("[Qortex] Failed to persist state:",r);}}load(t,r){r&&c();try{let s=this.storage.getItem(this.storageKey);if(!s)return;let i=y(s);if(!i){console.warn("[Qortex] Invalid persisted state format, clearing cache"),this.clear();return}if(i.burstKey!==this.burstKey){console.warn("[Qortex] Burst key mismatch, clearing cache"),this.clear();return}for(let[a,p]of Object.entries(i.entries)){let S=p,d=t.get(a),m=u(S,d);t.set(a,m);}}catch(s){console.warn("[Qortex] Failed to load persisted state:",s),this.clear();}}clear(){try{this.storage.removeItem(this.storageKey);}catch(t){console.warn("[Qortex] Failed to clear persisted data:",t);}}sync(t){this.syncTimeout&&clearTimeout(this.syncTimeout),this.syncTimeout=setTimeout(()=>{let r={};for(let[s,i]of t.entries())r[s]=l(i);this.save(r);},this.debounceTime);}};var P=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}`)}},w=(e,t)=>{let r=P(e);if(!r){f();return}return new o(r,t)};
-
-export { w as createPersister };