qortex-core 0.3.0 → 0.3.2

package/README.md

@@ -13,11 +13,10 @@
 
 - 🔐 **App core data** - Authentication, user profiles accessible from anywhere
 - 🎯 **Cross-framework** - Share data between React, Vue, vanilla JS, Node.js
-- 🔄 **Background services** - WebSocket updates, timers, external events
 - ⚡ **Real-time apps** - Push changes from anywhere, see them everywhere instantly
 
 ```bash
-pnpm add qortex-core
+npm install qortex-core
 ```
 
 ## 📚 Documentation
@@ -28,7 +27,7 @@ pnpm add qortex-core
 
 ## 📄 License
 
-MIT License - feel free to use this in your projects! 🎉
+LGPL-3.0 License - see [LICENSE](../../LICENSE) file for details.
 
 ## 🎯 Support
 
@@ -45,4 +44,4 @@ Need help? Have questions? Want to chat about data fetching strategies?
 <div align="center">
   <p>Made with ❤️ by <a href="https://darshannaik.com">Darshan</a></p>
   <p>⭐ Star this repo if you found it helpful!</p>
-</div>
+</div>

package/index.d.ts

@@ -1,9 +1,16 @@
-import { D as DefaultConfig, Q as QueryKey, a as QueryOptions, F as Fetcher, I as InferFetcherResult, b as QueryState } from './types-61b54557.js';
-export { E as EqualityFn, c as EqualityStrategy, d as QueryStatus, R as RefetchOnSubscribeOptions } from './types-61b54557.js';
+import { D as DefaultConfig, Q as QueryKey, a as QueryOptions, F as Fetcher, I as InferFetcherResult, S as SetDataUpdater, b as QueryState } from './types-15a3228d.js';
+export { E as EqualityFn, c as EqualityStrategy, d as QueryStatus, R as RefetchOnSubscribeOptions } from './types-15a3228d.js';
 
 /**
  * Core query manager that handles caching, fetching, and state management
  * Implements robust throttling and race condition prevention
+ *
+ * All public methods are arrow functions to support destructuring:
+ * @example
+ * ```typescript
+ * const { fetchQuery, getQueryData } = queryManager;
+ * fetchQuery('key'); // Works correctly!
+ * ```
  */
 declare class QueryManagerCore {
     private cache;
@@ -12,8 +19,56 @@ declare class QueryManagerCore {
     private throttleTime;
     private persister;
     private hasQueriesBeenUsed;
-    dangerClearCache(): void;
-    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(() => {
+     *   queryManager.dangerClearCache();
+     * });
+     *
+     * // ❌ Dangerous usage in production
+     * // queryManager.dangerClearCache(); // Don't do this!
+     * ```
+     */
+    dangerClearCache: () => void;
+    /**
+     * Sets default configuration that applies to all queries
+     *
+     * @param config - Default configuration object
+     * @param config.enabled - Default enabled state for all queries. Default: `true`
+     * @param config.staleTime - Default stale time in milliseconds. Default: `0` (data becomes stale immediately after fetch)
+     * @param config.refetchOnSubscribe - Default refetch behavior on subscription. Default: `"stale"`
+     * @param config.equalityStrategy - Default equality comparison strategy. Default: `"shallow"`
+     * @param config.equalityFn - Default equality function. Default: `Object.is`
+     * @param config.usePreviousDataOnError - Default behavior for previous data on error. Default: `false`
+     * @param config.usePlaceholderOnError - Default behavior for placeholder data on error. Default: `false`
+     * @param config.throttleTime - Time in ms to throttle fetch requests. Default: `500`
+     * @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.
+     *
+     * @example
+     * ```typescript
+     * queryManager.setDefaultConfig({
+     *   staleTime: 5000,
+     *   refetchOnSubscribe: 'stale',
+     *   persister: createPersister('local', { burstKey: 'v1' })
+     * });
+     * ```
+     */
+    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
@@ -23,29 +78,187 @@ declare class QueryManagerCore {
      * Notifies all subscribers of a query state change
      */
     private emit;
-    registerFetcher<T = any>(key: QueryKey, opts: QueryOptions<T>): void;
-    registerFetcher<F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
-        fetcher: F;
-    }): void;
-    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>>;
-    setQueryData<T = any>(key: QueryKey, data: T): void;
-    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;
-    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>>;
-    invalidateQuery(key: QueryKey): void;
-    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;
-    }): () => void;
-    subscribeQuery<T = any>(key: QueryKey, cb: (state: QueryState<T>) => void, opts?: QueryOptions<T>): () => void;
+    /**
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * queryManager.registerFetcher('users', {
+     *   fetcher: async () => fetch('/api/users').then(r => r.json()),
+     *   staleTime: 60000
+     * });
+     * ```
+     */
+    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.
+     *
+     * @example
+     * ```typescript
+     * const users = await queryManager.fetchQuery('users');
+     * ```
+     */
+    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 dataOrUpdater - Data to set, or an updater function that receives previous data
+     *
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * // Direct update
+     * setQueryData('user', { id: 1, name: 'John' });
+     *
+     * // Functional update - access previous data
+     * setQueryData('user', (prev) => ({ ...prev, name: 'Jane' }));
+     *
+     * // Increment counter example
+     * setQueryData('counter', (prev) => (prev ?? 0) + 1);
+     * ```
+     */
+    setQueryData: <T = any>(key: QueryKey, dataOrUpdater: T | SetDataUpdater<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.
+     *
+     * @example
+     * ```typescript
+     * const users = queryManager.getQueryData('users');
+     * if (users) {
+     *   console.log('Got cached users:', users);
+     * }
+     * ```
+     */
+    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.
+     *
+     * @example
+     * ```typescript
+     * const { data, isLoading, error, refetch } = queryManager.getQueryState('users');
+     * ```
+     */
+    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.
+     *
+     * @example
+     * ```typescript
+     * // After updating a user, invalidate the users list
+     * await updateUser(userId, newData);
+     * queryManager.invalidateQuery('users');
+     * ```
+     */
+    invalidateQuery: (key: QueryKey) => void;
+    /**
+     * Subscribes to query state changes and returns an unsubscribe function
+     *
+     * @param key - Unique identifier for the query
+     * @param cb - 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.
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = queryManager.subscribeQuery('users', (state) => {
+     *   console.log('Users state changed:', state);
+     * });
+     *
+     * // Later, when done
+     * unsubscribe();
+     * ```
+     */
+    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;
+    };
     /**
      * Core mount logic that determines when to fetch
      * Implements robust throttling and race condition prevention
@@ -53,24 +266,33 @@ declare class QueryManagerCore {
     private handleMountLogic;
 }
 
-declare const _queryManager: QueryManagerCore;
-
 /**
- * Registers a fetcher function for a query key and sets up the query state
+ * The global query manager instance.
+ * Use this to interact with the query cache directly.
+ *
+ * @example
+ * ```typescript
+ * import { queryManager } from 'qortex-core';
+ *
+ * queryManager.registerFetcher('users', { fetcher: () => fetch('/api/users') });
+ * const users = await queryManager.fetchQuery('users');
+ * ```
+ */
+declare const queryManager: QueryManagerCore;
+/**
+ * Registers a fetcher function for a query key and sets up the query state.
+ * Automatically triggers initial fetch if enabled is not false.
  *
  * @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.
+ * @param opts - Query configuration options including fetcher, staleTime, enabled, etc.
+ *
+ * @example
+ * ```typescript
+ * registerFetcher('users', {
+ *   fetcher: async () => fetch('/api/users').then(r => r.json()),
+ *   staleTime: 60000
+ * });
+ * ```
  */
 declare const registerFetcher: {
     <T = any>(key: QueryKey, opts: QueryOptions<T>): void;
@@ -79,14 +301,17 @@ declare const registerFetcher: {
     }): void;
 };
 /**
- * Executes a fetch operation with proper error handling and state management
+ * Executes a fetch operation with proper error handling and state management.
+ * Prevents duplicate fetches by tracking ongoing promises.
  *
  * @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.
+ * @example
+ * ```typescript
+ * const users = await fetchQuery('users');
+ * ```
  */
 declare const fetchQuery: {
     <T = any>(key: QueryKey, opts?: QueryOptions<T>): Promise<T>;
@@ -95,24 +320,37 @@ declare const fetchQuery: {
     }): Promise<InferFetcherResult<F>>;
 };
 /**
- * Manually sets query data without triggering a fetch operation
+ * Manually sets query data without triggering a fetch operation.
+ * Useful for optimistic updates or setting initial data.
  *
  * @param key - Unique identifier for the query
- * @param data - Data to set for the query
+ * @param dataOrUpdater - Data to set, or an updater function that receives previous data
+ *
+ * @example
+ * ```typescript
+ * // Direct update
+ * setQueryData('user', { id: 1, name: 'John' });
+ *
+ * // Functional update - access previous data
+ * setQueryData('user', (prev) => ({ ...prev, name: 'Jane' }));
  *
- * 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.
+ * // Increment counter example
+ * setQueryData('counter', (prev) => (prev ?? 0) + 1);
+ * ```
  */
-declare const setQueryData: <T = any>(key: QueryKey, data: T) => void;
+declare const setQueryData: <T = any>(key: QueryKey, dataOrUpdater: T | SetDataUpdater<T>) => void;
 /**
- * Gets the current data for a query
+ * Gets the current data for a query.
+ * Returns undefined if the query has never been fetched or if an error occurred.
  *
  * @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.
+ * @example
+ * ```typescript
+ * const users = getQueryData('users');
+ * ```
  */
 declare const getQueryData: {
     <T = any>(key: QueryKey, opts?: QueryOptions<T>): T | undefined;
@@ -121,24 +359,16 @@ declare const getQueryData: {
     }): InferFetcherResult<F> | undefined;
 };
 /**
- * Gets the complete query state including loading, error, and computed flags
+ * 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.
+ * @returns QueryState object with data, error, status, isLoading, isFetching, isError, isSuccess, isStale, and refetch
+ *
+ * @example
+ * ```typescript
+ * const { data, isLoading, error, refetch } = getQueryState('users');
+ * ```
  */
 declare const getQueryState: {
     <T = unknown>(key: QueryKey, opts?: QueryOptions<T>): QueryState<T>;
@@ -147,26 +377,33 @@ declare const getQueryState: {
     }): QueryState<InferFetcherResult<F>>;
 };
 /**
- * Invalidates a query, marking it as stale and triggering a refetch
+ * Invalidates a query, marking it as stale and triggering a refetch.
+ * Useful for forcing data refresh after mutations.
  *
  * @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.
+ * @example
+ * ```typescript
+ * await updateUser(userId, newData);
+ * invalidateQuery('users');
+ * ```
  */
 declare const invalidateQuery: (key: QueryKey) => void;
 /**
- * Subscribes to query state changes and returns an unsubscribe function
+ * 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 cb - 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.
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeQuery('users', (state) => {
+ *   console.log('Users state changed:', state);
+ * });
+ * unsubscribe(); // When done
+ * ```
  */
 declare const subscribeQuery: {
     (key: QueryKey, cb: (state: QueryState<any>) => void): () => void;
@@ -176,43 +413,28 @@ declare const subscribeQuery: {
     <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. Default: `true`
- * @param config.staleTime - Default stale time in milliseconds. Default: `0` (data becomes stale immediately after fetch)
- * @param config.refetchOnSubscribe - Default refetch behavior on subscription. Default: `"stale"`
- * @param config.equalityStrategy - Default equality comparison strategy. Default: `"shallow"`
- * @param config.equalityFn - Default equality function. Default: `Object.is`
- * @param config.usePreviousDataOnError - Default behavior for previous data on error. Default: `false`
- * @param config.usePlaceholderOnError - Default behavior for placeholder data on error. Default: `false`
- * @param config.throttleTime - Time in ms to throttle fetch requests. Default: `50`
- * @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.
+ * Sets default configuration that applies to all queries.
+ *
+ * @param config - Default configuration object (staleTime, enabled, refetchOnSubscribe, throttleTime, persister, etc.)
+ *
+ * @example
+ * ```typescript
+ * setDefaultConfig({
+ *   staleTime: 5000,
+ *   refetchOnSubscribe: 'stale'
+ * });
+ * ```
  */
 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.
+ * ⚠️ DANGER: Clear all cached data and subscriptions.
+ * Only use in testing environments!
  *
  * @example
  * ```typescript
- * // ✅ Safe usage in tests
  * beforeEach(() => {
  *   dangerClearCache();
  * });
- *
- * // ❌ Dangerous usage in production
- * // dangerClearCache(); // Don't do this!
  * ```
  */
 declare const dangerClearCache: () => void;
@@ -223,4 +445,4 @@ declare const dangerClearCache: () => void;
  */
 declare function serializeKey(key: QueryKey): string;
 
-export { DefaultConfig, Fetcher, InferFetcherResult, QueryKey, QueryManagerCore, QueryOptions, QueryState, _queryManager, dangerClearCache, fetchQuery, getQueryData, getQueryState, invalidateQuery, registerFetcher, serializeKey, setDefaultConfig, setQueryData, subscribeQuery };
+export { DefaultConfig, Fetcher, InferFetcherResult, QueryKey, QueryManagerCore, QueryOptions, QueryState, SetDataUpdater, dangerClearCache, fetchQuery, getQueryData, getQueryState, invalidateQuery, queryManager, registerFetcher, serializeKey, setDefaultConfig, setQueryData, subscribeQuery };

package/index.js

@@ -1,15 +1,15 @@
 '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 f(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:f(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,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));}ensureState(r,a={}){this.hasQueriesBeenUsed=!0;let e=c(r),s=this.cache.get(e);if(s){let n=s.fromPersisterCache?{...s,...this.defaultConfig,...a}:{...this.defaultConfig,...s,...a};Object.assign(s,n),s.enabled=n.enabled!==!1,s.fromPersisterCache=!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.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=d(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=f(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;f(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),d(e).data}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let s=d(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);
+function c(t){return Array.isArray(t)?t.join("-"):String(t)}function l(t,a,r="shallow"){if(t===a)return !0;if(t==null||a==null)return t===a;if(typeof t!="object"||typeof a!="object")return !1;try{let e=t,s=a;if(Array.isArray(e)&&Array.isArray(s)){if(e.length!==s.length)return !1;for(let u=0;u<e.length;u++)if(r==="deep"){if(!l(e[u],s[u],r))return !1}else if(e[u]!==s[u])return !1;return !0}if(Array.isArray(e)||Array.isArray(s))return !1;let n=Object.keys(e),i=Object.keys(s);if(n.length!==i.length)return !1;for(let u=0;u<n.length;u++){let f=n[u];if(r==="deep"){if(!l(e[f],s[f],r))return !1}else if(e[f]!==s[f])return !1}return !0}catch{return !1}}function y(t,a){return a||((r,e)=>l(r,e,t||"shallow"))}function p(t,a){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:y(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:a||(()=>Promise.resolve(void 0)),isSuccess:!1,isError:!1,lastReturnedState:void 0,persist:t?.persist!==!1}}function d(t){let a=Date.now(),r=t.updatedAt!==void 0&&a-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:r,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=500;this.persister=null;this.hasQueriesBeenUsed=!1;this.dangerClearCache=()=>{this.cache.clear(),this.subs.clear(),this.persister?.clear();};this.setDefaultConfig=({throttleTime:a,persister:r,...e})=>{this.defaultConfig={...this.defaultConfig,...e},a!==void 0&&(this.throttleTime=a),r&&(this.persister=r,this.persister?.load(this.cache,this.hasQueriesBeenUsed));};this.registerFetcher=(a,r)=>{let e=this.ensureState(a,r);this.handleMountLogic(a,e);};this.fetchQuery=(a,r)=>{let e=this.ensureState(a,r);if(e.fetchPromise)return e.fetchPromise;let s=e.fetcher;if(!s)return e.updatedAt===void 0&&Q(a),Promise.resolve(e.data);let n=s();return e.fetchPromise=n,e.status="fetching",e.lastFetchTime=Date.now(),this.emit(a,e),n.then(i=>{let u=y(e.equalityStrategy,e.equalityFn);e.data=u(e.data,i)?e.data:i,e.status="success",e.isError=!1,e.isSuccess=!0,e.updatedAt=Date.now(),e.fetchPromise=void 0,e.error=void 0,this.emit(a,e);}).catch(i=>{e.error=i,e.status="error",e.isError=!0,e.isSuccess=!1,e.updatedAt=Date.now(),e.fetchPromise=void 0,this.emit(a,e);}),n};this.setQueryData=(a,r)=>{let e=this.ensureState(a),s=e.data,n=typeof r=="function"?r(s):r;y(e.equalityStrategy,e.equalityFn)(s,n)||(e.data=n,e.updatedAt=Date.now(),e.error=void 0,e.status="success",e.isInvalidated=!1,e.isError=!1,e.isSuccess=!0,this.emit(a,e));};this.getQueryData=(a,r)=>{let e=this.ensureState(a,r);return this.handleMountLogic(a,e),d(e).data};this.getQueryState=(a,r)=>{let e=this.ensureState(a,r);this.handleMountLogic(a,e);let s=d(e),n=e.lastReturnedState;return !n||!l(n,s,"shallow")?(e.lastReturnedState=s,s):n};this.invalidateQuery=a=>{let r=this.ensureState(a);r.isInvalidated=!0,this.emit(a,r),this.fetchQuery(a);};this.subscribeQuery=(a,r,e)=>{let s=c(a),n=this.ensureState(a,e);return this.subs.has(s)||this.subs.set(s,new Set),this.subs.get(s).add(r),this.handleMountLogic(a,n),()=>{this.subs.get(s).delete(r);}};}ensureState(a,r={}){this.hasQueriesBeenUsed=!0;let e=c(a),s=this.cache.get(e);if(s){let n=s.fromPersisterCache?{...s,...this.defaultConfig,...r}:{...this.defaultConfig,...s,...r};Object.assign(s,n),s.enabled=n.enabled!==!1,s.persist=n.persist!==!1,s.fromPersisterCache=!1,this.cache.set(e,s);}else {let n={...this.defaultConfig,...r},i=p(n,()=>this.fetchQuery(a));this.cache.set(e,i);}return this.persister?.sync(this.cache),this.cache.get(e)}emit(a,r){let e=c(a);this.cache.set(e,r),this.persister?.sync(this.cache);let s=this.subs.get(e);if(!s)return;let n=d(r);for(let i of Array.from(s))i(n);}handleMountLogic(a,r){let e=r.lastFetchTime&&Date.now()-r.lastFetchTime<this.throttleTime;if(r.status==="fetching"||!r.enabled||e||!r.fetcher)return;let s=Date.now(),n=r.updatedAt==null||s-(r.updatedAt||0)>r.staleTime||r.isInvalidated,i=!1;r.updatedAt==null?i=!0:(r.refetchOnSubscribe==="always"&&(i=!0),r.refetchOnSubscribe==="stale"&&(i=n)),i&&this.fetchQuery(a);}},T=h;var o=new T,b=o.registerFetcher,O=o.fetchQuery,K=o.setQueryData,w=o.getQueryData,x=o.getQueryState,E=o.invalidateQuery,A=o.subscribeQuery,q=o.setDefaultConfig,I=o.dangerClearCache;
 
 exports.QueryManagerCore = h;
-exports._queryManager = i;
 exports.dangerClearCache = I;
 exports.fetchQuery = O;
-exports.getQueryData = x;
-exports.getQueryState = E;
-exports.invalidateQuery = w;
-exports.registerFetcher = D;
+exports.getQueryData = w;
+exports.getQueryState = x;
+exports.invalidateQuery = E;
+exports.queryManager = o;
+exports.registerFetcher = b;
 exports.serializeKey = c;
 exports.setDefaultConfig = q;
 exports.setQueryData = K;

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 f(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:f(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,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));}ensureState(r,a={}){this.hasQueriesBeenUsed=!0;let e=c(r),s=this.cache.get(e);if(s){let n=s.fromPersisterCache?{...s,...this.defaultConfig,...a}:{...this.defaultConfig,...s,...a};Object.assign(s,n),s.enabled=n.enabled!==!1,s.fromPersisterCache=!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.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=d(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=f(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;f(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),d(e).data}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let s=d(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);
+function c(t){return Array.isArray(t)?t.join("-"):String(t)}function l(t,a,r="shallow"){if(t===a)return !0;if(t==null||a==null)return t===a;if(typeof t!="object"||typeof a!="object")return !1;try{let e=t,s=a;if(Array.isArray(e)&&Array.isArray(s)){if(e.length!==s.length)return !1;for(let u=0;u<e.length;u++)if(r==="deep"){if(!l(e[u],s[u],r))return !1}else if(e[u]!==s[u])return !1;return !0}if(Array.isArray(e)||Array.isArray(s))return !1;let n=Object.keys(e),i=Object.keys(s);if(n.length!==i.length)return !1;for(let u=0;u<n.length;u++){let f=n[u];if(r==="deep"){if(!l(e[f],s[f],r))return !1}else if(e[f]!==s[f])return !1}return !0}catch{return !1}}function y(t,a){return a||((r,e)=>l(r,e,t||"shallow"))}function p(t,a){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:y(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:a||(()=>Promise.resolve(void 0)),isSuccess:!1,isError:!1,lastReturnedState:void 0,persist:t?.persist!==!1}}function d(t){let a=Date.now(),r=t.updatedAt!==void 0&&a-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:r,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=500;this.persister=null;this.hasQueriesBeenUsed=!1;this.dangerClearCache=()=>{this.cache.clear(),this.subs.clear(),this.persister?.clear();};this.setDefaultConfig=({throttleTime:a,persister:r,...e})=>{this.defaultConfig={...this.defaultConfig,...e},a!==void 0&&(this.throttleTime=a),r&&(this.persister=r,this.persister?.load(this.cache,this.hasQueriesBeenUsed));};this.registerFetcher=(a,r)=>{let e=this.ensureState(a,r);this.handleMountLogic(a,e);};this.fetchQuery=(a,r)=>{let e=this.ensureState(a,r);if(e.fetchPromise)return e.fetchPromise;let s=e.fetcher;if(!s)return e.updatedAt===void 0&&Q(a),Promise.resolve(e.data);let n=s();return e.fetchPromise=n,e.status="fetching",e.lastFetchTime=Date.now(),this.emit(a,e),n.then(i=>{let u=y(e.equalityStrategy,e.equalityFn);e.data=u(e.data,i)?e.data:i,e.status="success",e.isError=!1,e.isSuccess=!0,e.updatedAt=Date.now(),e.fetchPromise=void 0,e.error=void 0,this.emit(a,e);}).catch(i=>{e.error=i,e.status="error",e.isError=!0,e.isSuccess=!1,e.updatedAt=Date.now(),e.fetchPromise=void 0,this.emit(a,e);}),n};this.setQueryData=(a,r)=>{let e=this.ensureState(a),s=e.data,n=typeof r=="function"?r(s):r;y(e.equalityStrategy,e.equalityFn)(s,n)||(e.data=n,e.updatedAt=Date.now(),e.error=void 0,e.status="success",e.isInvalidated=!1,e.isError=!1,e.isSuccess=!0,this.emit(a,e));};this.getQueryData=(a,r)=>{let e=this.ensureState(a,r);return this.handleMountLogic(a,e),d(e).data};this.getQueryState=(a,r)=>{let e=this.ensureState(a,r);this.handleMountLogic(a,e);let s=d(e),n=e.lastReturnedState;return !n||!l(n,s,"shallow")?(e.lastReturnedState=s,s):n};this.invalidateQuery=a=>{let r=this.ensureState(a);r.isInvalidated=!0,this.emit(a,r),this.fetchQuery(a);};this.subscribeQuery=(a,r,e)=>{let s=c(a),n=this.ensureState(a,e);return this.subs.has(s)||this.subs.set(s,new Set),this.subs.get(s).add(r),this.handleMountLogic(a,n),()=>{this.subs.get(s).delete(r);}};}ensureState(a,r={}){this.hasQueriesBeenUsed=!0;let e=c(a),s=this.cache.get(e);if(s){let n=s.fromPersisterCache?{...s,...this.defaultConfig,...r}:{...this.defaultConfig,...s,...r};Object.assign(s,n),s.enabled=n.enabled!==!1,s.persist=n.persist!==!1,s.fromPersisterCache=!1,this.cache.set(e,s);}else {let n={...this.defaultConfig,...r},i=p(n,()=>this.fetchQuery(a));this.cache.set(e,i);}return this.persister?.sync(this.cache),this.cache.get(e)}emit(a,r){let e=c(a);this.cache.set(e,r),this.persister?.sync(this.cache);let s=this.subs.get(e);if(!s)return;let n=d(r);for(let i of Array.from(s))i(n);}handleMountLogic(a,r){let e=r.lastFetchTime&&Date.now()-r.lastFetchTime<this.throttleTime;if(r.status==="fetching"||!r.enabled||e||!r.fetcher)return;let s=Date.now(),n=r.updatedAt==null||s-(r.updatedAt||0)>r.staleTime||r.isInvalidated,i=!1;r.updatedAt==null?i=!0:(r.refetchOnSubscribe==="always"&&(i=!0),r.refetchOnSubscribe==="stale"&&(i=n)),i&&this.fetchQuery(a);}},T=h;var o=new T,b=o.registerFetcher,O=o.fetchQuery,K=o.setQueryData,w=o.getQueryData,x=o.getQueryState,E=o.invalidateQuery,A=o.subscribeQuery,q=o.setDefaultConfig,I=o.dangerClearCache;
 
-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 };
+export { h as QueryManagerCore, I as dangerClearCache, O as fetchQuery, w as getQueryData, x as getQueryState, E as invalidateQuery, o as queryManager, b 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",
+  "version": "0.3.2",
   "description": "Framework-agnostic query cache & fetch registry (MFE friendly).",
   "main": "index.js",
   "module": "index.mjs",
@@ -28,7 +28,7 @@
     "persister.js",
     "persister.mjs",
     "persister.d.ts",
-    "types-61b54557.d.ts",
+    "types-15a3228d.d.ts",
     "README.md"
   ],
   "repository": {

package/persister.d.ts

@@ -1,5 +1,5 @@
-import { P as PersisterConfig, B as BasePersister } from './types-61b54557.js';
-export { e as Persister } from './types-61b54557.js';
+import { P as PersisterConfig, B as BasePersister } from './types-15a3228d.js';
+export { e as Persister } from './types-15a3228d.js';
 
 /**
  * Creates a persister instance for data persistence.
@@ -12,7 +12,7 @@ export { e as Persister } from './types-61b54557.js';
  *   - `'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
- *   - `burstKey`: Default `"0.3.0"`
+ *   - `burstKey`: Default `"package version"`
  *   - `prefix`: Default `"qortex"`
  *   - `debounceTime`: Default `100` (ms)
  * @returns {Persister | undefined} A persister instance, or undefined if storage is not available

package/persister.js

@@ -1,5 +1,5 @@
 '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 P(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 l(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"||!P(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function u(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:i,fromPersisterCache:o,...n}=e;return n}function f(e,t){return {...t??{},...e,fromPersisterCache:!t}}function y(e){try{let t=JSON.parse(e);return l(t)?t:null}catch{return null}}var c=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},p=()=>{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 a=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={queries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[i,o]of Object.entries(t))r.queries[i]=o;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&&p();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[o,n]of Object.entries(i.queries)){let S=n,m=t.get(o),d=f(S,m);t.set(o,d);}}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]=u(i);this.save(r);},this.debounceTime);}};var Q=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=Q(e);if(!r){c();return}return new a(r,t)};
+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 P(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 l(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"||!P(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function u(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:i,fromPersisterCache:o,...n}=e;return n}function f(e,t){return {...t??{},...e,fromPersisterCache:!t}}function y(e){try{let t=JSON.parse(e);return l(t)?t:null}catch{return null}}var c=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},p=()=>{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 a=class{constructor(t,r){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.2";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={queries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[i,o]of Object.entries(t))r.queries[i]=o;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&&p();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[o,n]of Object.entries(i.queries)){let S=n,m=t.get(o),d=f(S,m);t.set(o,d);}}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())i.persist!==!1&&(r[s]=u(i));this.save(r);},this.debounceTime);}};var Q=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=Q(e);if(!r){c();return}return new a(r,t)};
 
 exports.createPersister = w;

package/persister.mjs

@@ -1,3 +1,3 @@
-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 P(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 l(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"||!P(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function u(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:i,fromPersisterCache:o,...n}=e;return n}function f(e,t){return {...t??{},...e,fromPersisterCache:!t}}function y(e){try{let t=JSON.parse(e);return l(t)?t:null}catch{return null}}var c=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},p=()=>{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 a=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={queries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[i,o]of Object.entries(t))r.queries[i]=o;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&&p();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[o,n]of Object.entries(i.queries)){let S=n,m=t.get(o),d=f(S,m);t.set(o,d);}}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]=u(i);this.save(r);},this.debounceTime);}};var Q=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=Q(e);if(!r){c();return}return new a(r,t)};
+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 P(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 l(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"||!P(r))return !1;return !(typeof e.burstKey!="string"||typeof e.timestamp!="number"||e.timestamp<0)}function u(e){let{fetcher:t,equalityFn:r,fetchPromise:s,refetch:i,fromPersisterCache:o,...n}=e;return n}function f(e,t){return {...t??{},...e,fromPersisterCache:!t}}function y(e){try{let t=JSON.parse(e);return l(t)?t:null}catch{return null}}var c=()=>{console.warn("[Qortex] No storage found, persister will not be able to persist data");},p=()=>{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 a=class{constructor(t,r){this.syncTimeout=null;this.debounceTime=100;this.burstKey="0.3.2";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={queries:{},burstKey:this.burstKey,timestamp:Date.now()};for(let[i,o]of Object.entries(t))r.queries[i]=o;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&&p();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[o,n]of Object.entries(i.queries)){let S=n,m=t.get(o),d=f(S,m);t.set(o,d);}}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())i.persist!==!1&&(r[s]=u(i));this.save(r);},this.debounceTime);}};var Q=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=Q(e);if(!r){c();return}return new a(r,t)};
 
 export { w as createPersister };

package/{types-61b54557.d.ts → types-15a3228d.d.ts}

@@ -25,6 +25,7 @@ type QueryStateInternal<T = any, E = unknown> = {
     isError: boolean;
     lastReturnedState?: QueryState<T>;
     fromPersisterCache?: boolean;
+    persist: boolean;
 };
 
 type SerializedQueryState = Omit<QueryStateInternal, 'fetcher' | 'fetchPromise' | 'refetch' | 'equalityFn'>;
@@ -62,6 +63,7 @@ declare class BasePersister {
     /**
      * Sync with debounced save (100ms delay)
      * Handles serialization internally
+     * Filters out queries with persist: false
      */
     sync(cache: Map<string, QueryStateInternal>): void;
 }
@@ -76,8 +78,13 @@ type QueryKey = string | readonly (string | number)[];
 type Fetcher<T = any> = () => Promise<T>;
 /** Function that compares two values for equality */
 type EqualityFn<T = any> = (a: T | undefined, b: T | undefined) => boolean;
+/**
+ * Updater function for setQueryData
+ * Receives previous data and returns new data
+ */
+type SetDataUpdater<T> = (prevData: T | undefined) => T;
 /** Strategy for equality comparison */
-type EqualityStrategy = 'shallow' | 'deep';
+type EqualityStrategy = "shallow" | "deep";
 /**
  * Infers the return type of a fetcher function
  *
@@ -117,6 +124,8 @@ type QueryOptions<T = any> = {
     placeholderData?: T;
     usePreviousDataOnError?: boolean;
     usePlaceholderOnError?: boolean;
+    /** Whether to persist this query's data. Default: true */
+    persist?: boolean;
 };
 /**
  * Default configuration options that can be set globally
@@ -151,4 +160,4 @@ type QueryState<T = any, E = unknown> = {
     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 };
+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, SetDataUpdater as S, QueryOptions as a, QueryState as b, EqualityStrategy as c, QueryStatus as d, Persister as e };