qortex-core 0.1.8 → 0.2.0

package/index.d.ts

@@ -182,41 +182,15 @@ declare class QueryManagerCore {
 }
 
 declare const _queryManager: QueryManagerCore;
-declare const registerFetcher: {
-    <T = any>(key: QueryKey, opts: QueryOptions<T>): void;
-    <F extends Fetcher>(key: QueryKey, opts: QueryOptions<InferFetcherResult<F>> & {
-        fetcher: F;
-    }): void;
-};
-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>>;
-};
-declare const setQueryData: <T = any>(key: QueryKey, data: T) => void;
-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;
-};
-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>>;
-};
-declare const invalidateQuery: (key: QueryKey) => void;
-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;
-};
-declare const setDefaultConfig: ({ throttleTime, ...config }: DefaultConfig) => void;
-declare const dangerClearCache: () => void;
+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"];
 
 /**
  * Normalizes query keys to a consistent string format for internal storage

package/index.js

@@ -1,352 +1,16 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+'use strict';
 
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  QueryManagerCore: () => QueryManagerCore,
-  _queryManager: () => _queryManager,
-  dangerClearCache: () => dangerClearCache,
-  fetchQuery: () => fetchQuery,
-  getQueryData: () => getQueryData,
-  getQueryState: () => getQueryState,
-  invalidateQuery: () => invalidateQuery,
-  registerFetcher: () => registerFetcher,
-  serializeKey: () => serializeKey,
-  setDefaultConfig: () => setDefaultConfig,
-  setQueryData: () => setQueryData,
-  subscribeQuery: () => subscribeQuery
-});
-module.exports = __toCommonJS(src_exports);
+function c(t){return Array.isArray(t)?t.join(","):String(t)}function l(t,r){if(t===r)return !0;if(t==null||r==null)return t===r;if(typeof t!="object"||typeof r!="object")return !1;try{let a=t,e=r,s=Object.keys(a),i=Object.keys(e);if(s.length!==i.length)return !1;for(let n=0;n<s.length;n++){let o=s[n];if(a[o]!==e[o])return !1}return !0}catch{return !1}}function f(t,r){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:t?.equalityFn??l,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}}function d(t){let r=Date.now(),a=t.updatedAt==null||r-(t.updatedAt||0)>t.staleTime||t.isInvalidated,e=t.data,s=!1;switch(t.status){case"error":t.usePlaceholderOnError&&t.placeholderData!==void 0&&(e=t.placeholderData,s=!0);break;case"fetching":!t.data&&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 h(t){console.warn(`[qortex] No fetcher or data for key "${c(t)}". Register a fetcher or set initial data.`);}var y=class{constructor(){this.cache=new Map;this.subs=new Map;this.lastReturnedState=new Map;this.defaultConfig={};this.throttleTime=50;}dangerClearCache(){this.cache.clear(),this.subs.clear(),this.lastReturnedState.clear();}setDefaultConfig({throttleTime:r,...a}){this.defaultConfig={...this.defaultConfig,...a},r!==void 0&&(this.throttleTime=r);}ensureState(r,a={}){let e=c(r),s=this.cache.get(e),i={...this.defaultConfig,...a};if(s)Object.assign(s,i),s.enabled=i.enabled!==!1,this.cache.set(e,s);else {let n=f(i,()=>this.fetchQuery(r));this.cache.set(e,n);}return this.cache.get(e)}emit(r,a){let e=c(r);this.cache.set(e,a);let s=this.subs.get(e);if(!s)return;let i=d(a);for(let n of Array.from(s))n(i);}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&&h(r),Promise.resolve(e.data);e.status="fetching",e.lastFetchTime=Date.now(),this.emit(r,e);let i=s(),n=Promise.resolve(i);return e.fetchPromise=n,n.then(o=>{e.data=e.equalityFn(e.data,o)?e.data:o,e.status="success",e.updatedAt=Date.now(),e.isError=!1,e.isSuccess=!0;}).catch(o=>{e.error=o,e.status="error",e.isError=!0,e.isSuccess=!1;}).finally(()=>{e.fetchPromise=void 0,this.emit(r,e);}),n}setQueryData(r,a){let e=this.ensureState(r),s=e.data;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),e.data??e.placeholderData}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let s=d(e),i=c(r),n=this.lastReturnedState?.get(i);return !n||!l(n,s)?(this.lastReturnedState||(this.lastReturnedState=new Map),this.lastReturnedState.set(i,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),i=this.ensureState(r,e);return this.subs.has(s)||this.subs.set(s,new Set),this.subs.get(s).add(a),this.handleMountLogic(r,i),()=>{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(),i=a?.updatedAt==null||s-(a.updatedAt||0)>a.staleTime||a.isInvalidated,n=!1;a.refetchOnSubscribe==="always"&&(n=!0),a.refetchOnSubscribe==="stale"&&(n=i),n&&this.fetchQuery(r);}},Q=y;var u=new Q,m=u.registerFetcher.bind(u),D=u.fetchQuery.bind(u),v=u.setQueryData.bind(u),O=u.getQueryData.bind(u),K=u.getQueryState.bind(u),C=u.invalidateQuery.bind(u),x=u.subscribeQuery.bind(u),w=u.setDefaultConfig.bind(u),I=u.dangerClearCache.bind(u);
 
-// src/constants.ts
-var DEFAULT_STALE_TIME = 0;
-var THROTTLE_TIME = 50;
-
-// src/utils.ts
-function serializeKey(key) {
-  return Array.isArray(key) ? key.join(",") : String(key);
-}
-function shallowEqual(a, b) {
-  if (a === b)
-    return true;
-  if (a == null || b == null)
-    return a === b;
-  if (typeof a !== "object" || typeof b !== "object")
-    return false;
-  try {
-    const aAny = a;
-    const bAny = b;
-    const aKeys = Object.keys(aAny);
-    const bKeys = Object.keys(bAny);
-    if (aKeys.length !== bKeys.length)
-      return false;
-    for (let i = 0; i < aKeys.length; i++) {
-      const k = aKeys[i];
-      if (aAny[k] !== bAny[k])
-        return false;
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-function createDefaultState(opts, refetch) {
-  return {
-    status: "idle",
-    updatedAt: void 0,
-    staleTime: opts?.staleTime ?? DEFAULT_STALE_TIME,
-    isInvalidated: false,
-    fetcher: opts?.fetcher,
-    equalityFn: opts?.equalityFn ?? shallowEqual,
-    placeholderData: opts?.placeholderData,
-    usePreviousDataOnError: opts?.usePreviousDataOnError ?? false,
-    usePlaceholderOnError: opts?.usePlaceholderOnError ?? false,
-    refetchOnSubscribe: opts?.refetchOnSubscribe ?? "stale",
-    enabled: opts?.enabled === false ? false : true,
-    refetch: refetch || (() => Promise.resolve(void 0)),
-    isSuccess: false,
-    isError: false
-  };
-}
-function createPublicState(state) {
-  const now = Date.now();
-  const isStale = state.updatedAt == null || now - (state.updatedAt || 0) > state.staleTime || state.isInvalidated;
-  let returnedData = state.data;
-  let isPlaceholderData = false;
-  switch (state.status) {
-    case "error":
-      if (state.usePlaceholderOnError && state.placeholderData !== void 0) {
-        returnedData = state.placeholderData;
-        isPlaceholderData = true;
-      }
-      break;
-    case "fetching":
-      if (!state.data && state.placeholderData) {
-        returnedData = state.placeholderData;
-        isPlaceholderData = true;
-      }
-      break;
-    case "success":
-    case "idle":
-      returnedData = state.data ?? state.placeholderData;
-      isPlaceholderData = state.data ? false : Boolean(state.placeholderData);
-      break;
-  }
-  return {
-    data: returnedData,
-    error: state.error,
-    status: state.status,
-    updatedAt: state.updatedAt,
-    isStale,
-    isPlaceholderData,
-    isLoading: state.status === "fetching" && !state.updatedAt,
-    isFetching: state.status === "fetching",
-    isError: state.isError,
-    isSuccess: state.isSuccess,
-    refetch: state.refetch
-  };
-}
-function warnNoFetcherOrData(key) {
-  console.warn(
-    `[qortex] No fetcher or data for key "${serializeKey(key)}". Register a fetcher or set initial data.`
-  );
-}
-
-// src/queryManagerCore.ts
-var QueryManagerCore = class {
-  constructor() {
-    this.cache = /* @__PURE__ */ new Map();
-    this.subs = /* @__PURE__ */ new Map();
-    this.lastReturnedState = /* @__PURE__ */ new Map();
-    this.defaultConfig = {};
-    this.throttleTime = THROTTLE_TIME;
-  }
-  /**
-   * ⚠️ 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
-   * 
-   * @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() {
-    this.cache.clear();
-    this.subs.clear();
-    this.lastReturnedState.clear();
-  }
-  /**
-   * Set default configuration for all queries
-   */
-  setDefaultConfig({ throttleTime, ...config }) {
-    this.defaultConfig = { ...this.defaultConfig, ...config };
-    if (throttleTime !== void 0) {
-      this.throttleTime = throttleTime;
-    }
-  }
-  /**
-   * Ensures a query state exists in cache, creating it if necessary
-   * User-friendly with any fallback for better developer experience
-   */
-  ensureState(key, opts = {}) {
-    const sk = serializeKey(key);
-    const state = this.cache.get(sk);
-    const mergedOpts = { ...this.defaultConfig, ...opts };
-    if (state) {
-      Object.assign(state, mergedOpts);
-      state.enabled = mergedOpts.enabled === false ? false : true;
-      this.cache.set(sk, state);
-    } else {
-      const newState = createDefaultState(mergedOpts, () => this.fetchQuery(key));
-      this.cache.set(sk, newState);
-    }
-    return this.cache.get(sk);
-  }
-  /**
-   * Notifies all subscribers of a query state change
-   */
-  emit(key, state) {
-    const stateKey = serializeKey(key);
-    this.cache.set(stateKey, state);
-    const set = this.subs.get(stateKey);
-    if (!set)
-      return;
-    const publicState = createPublicState(state);
-    for (const cb of Array.from(set))
-      cb(publicState);
-  }
-  registerFetcher(key, opts) {
-    const state = this.ensureState(key, opts);
-    this.handleMountLogic(key, state);
-  }
-  fetchQuery(key, opts) {
-    const state = this.ensureState(key, opts);
-    if (state.fetchPromise)
-      return state.fetchPromise;
-    const fetcher = state.fetcher;
-    if (!fetcher) {
-      if (state.updatedAt === void 0) {
-        warnNoFetcherOrData(key);
-      }
-      return Promise.resolve(state.data);
-    }
-    ;
-    state.status = "fetching";
-    state.lastFetchTime = Date.now();
-    this.emit(key, state);
-    const result = fetcher();
-    const promise = Promise.resolve(result);
-    state.fetchPromise = promise;
-    promise.then((result2) => {
-      state.data = state.equalityFn(state.data, result2) ? state.data : result2;
-      state.status = "success";
-      state.updatedAt = Date.now();
-      state.isError = false;
-      state.isSuccess = true;
-    }).catch((error) => {
-      state.error = error;
-      state.status = "error";
-      state.isError = true;
-      state.isSuccess = false;
-    }).finally(() => {
-      state.fetchPromise = void 0;
-      this.emit(key, state);
-    });
-    return promise;
-  }
-  /**
-   * Manually sets query data without triggering a fetch
-   * Marks query as successful
-   */
-  setQueryData(key, data) {
-    const state = this.ensureState(key);
-    const old = state.data;
-    if (state.equalityFn(old, data))
-      return;
-    state.data = data;
-    state.updatedAt = Date.now();
-    state.error = void 0;
-    state.status = "success";
-    state.isInvalidated = false;
-    state.isError = false;
-    state.isSuccess = true;
-    this.emit(key, state);
-  }
-  getQueryData(key, opts) {
-    const state = this.ensureState(key, opts);
-    this.handleMountLogic(key, state);
-    return state.data ?? state.placeholderData;
-  }
-  getQueryState(key, opts) {
-    let state = this.ensureState(key, opts);
-    this.handleMountLogic(key, state);
-    const currentState = createPublicState(state);
-    const stateKey = serializeKey(key);
-    const lastState = this.lastReturnedState?.get(stateKey);
-    if (!lastState || !shallowEqual(lastState, currentState)) {
-      if (!this.lastReturnedState)
-        this.lastReturnedState = /* @__PURE__ */ new Map();
-      this.lastReturnedState.set(stateKey, currentState);
-      return currentState;
-    }
-    return lastState;
-  }
-  /**
-   * Marks a query as invalidated, triggering refetch
-   */
-  invalidateQuery(key) {
-    const state = this.ensureState(key);
-    state.isInvalidated = true;
-    this.emit(key, state);
-    this.fetchQuery(key);
-  }
-  subscribeQuery(key, cb, opts) {
-    const sk = serializeKey(key);
-    const state = this.ensureState(key, opts);
-    if (!this.subs.has(sk))
-      this.subs.set(sk, /* @__PURE__ */ new Set());
-    this.subs.get(sk).add(cb);
-    this.handleMountLogic(key, state);
-    return () => {
-      this.subs.get(sk).delete(cb);
-    };
-  }
-  /**
-   * Core mount logic that determines when to fetch
-   * Implements robust throttling and race condition prevention
-   */
-  handleMountLogic(key, state) {
-    const isThrottled = state.lastFetchTime && Date.now() - state.lastFetchTime < this.throttleTime;
-    if (state?.status === "fetching" || !state?.enabled || isThrottled || !state?.fetcher)
-      return;
-    const now = Date.now();
-    const isStale = state?.updatedAt == null || now - (state.updatedAt || 0) > state.staleTime || state.isInvalidated;
-    let shouldRefetch = false;
-    if (state.refetchOnSubscribe === "always") {
-      shouldRefetch = true;
-    }
-    if (state.refetchOnSubscribe === "stale") {
-      shouldRefetch = isStale;
-    }
-    if (shouldRefetch) {
-      this.fetchQuery(key);
-    }
-  }
-};
-var queryManagerCore_default = QueryManagerCore;
-
-// src/queryManager.ts
-var _queryManager = new queryManagerCore_default();
-var registerFetcher = _queryManager.registerFetcher.bind(_queryManager);
-var fetchQuery = _queryManager.fetchQuery.bind(_queryManager);
-var setQueryData = _queryManager.setQueryData.bind(_queryManager);
-var getQueryData = _queryManager.getQueryData.bind(_queryManager);
-var getQueryState = _queryManager.getQueryState.bind(_queryManager);
-var invalidateQuery = _queryManager.invalidateQuery.bind(_queryManager);
-var subscribeQuery = _queryManager.subscribeQuery.bind(_queryManager);
-var setDefaultConfig = _queryManager.setDefaultConfig.bind(_queryManager);
-var dangerClearCache = _queryManager.dangerClearCache.bind(_queryManager);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  QueryManagerCore,
-  _queryManager,
-  dangerClearCache,
-  fetchQuery,
-  getQueryData,
-  getQueryState,
-  invalidateQuery,
-  registerFetcher,
-  serializeKey,
-  setDefaultConfig,
-  setQueryData,
-  subscribeQuery
-});
+exports.QueryManagerCore = y;
+exports._queryManager = u;
+exports.dangerClearCache = I;
+exports.fetchQuery = D;
+exports.getQueryData = O;
+exports.getQueryState = K;
+exports.invalidateQuery = C;
+exports.registerFetcher = m;
+exports.serializeKey = c;
+exports.setDefaultConfig = w;
+exports.setQueryData = v;
+exports.subscribeQuery = x;

package/index.mjs

@@ -1,314 +1,3 @@
-// src/constants.ts
-var DEFAULT_STALE_TIME = 0;
-var THROTTLE_TIME = 50;
+function c(t){return Array.isArray(t)?t.join(","):String(t)}function l(t,r){if(t===r)return !0;if(t==null||r==null)return t===r;if(typeof t!="object"||typeof r!="object")return !1;try{let a=t,e=r,s=Object.keys(a),i=Object.keys(e);if(s.length!==i.length)return !1;for(let n=0;n<s.length;n++){let o=s[n];if(a[o]!==e[o])return !1}return !0}catch{return !1}}function f(t,r){return {status:"idle",updatedAt:void 0,staleTime:t?.staleTime??0,isInvalidated:!1,fetcher:t?.fetcher,equalityFn:t?.equalityFn??l,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}}function d(t){let r=Date.now(),a=t.updatedAt==null||r-(t.updatedAt||0)>t.staleTime||t.isInvalidated,e=t.data,s=!1;switch(t.status){case"error":t.usePlaceholderOnError&&t.placeholderData!==void 0&&(e=t.placeholderData,s=!0);break;case"fetching":!t.data&&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 h(t){console.warn(`[qortex] No fetcher or data for key "${c(t)}". Register a fetcher or set initial data.`);}var y=class{constructor(){this.cache=new Map;this.subs=new Map;this.lastReturnedState=new Map;this.defaultConfig={};this.throttleTime=50;}dangerClearCache(){this.cache.clear(),this.subs.clear(),this.lastReturnedState.clear();}setDefaultConfig({throttleTime:r,...a}){this.defaultConfig={...this.defaultConfig,...a},r!==void 0&&(this.throttleTime=r);}ensureState(r,a={}){let e=c(r),s=this.cache.get(e),i={...this.defaultConfig,...a};if(s)Object.assign(s,i),s.enabled=i.enabled!==!1,this.cache.set(e,s);else {let n=f(i,()=>this.fetchQuery(r));this.cache.set(e,n);}return this.cache.get(e)}emit(r,a){let e=c(r);this.cache.set(e,a);let s=this.subs.get(e);if(!s)return;let i=d(a);for(let n of Array.from(s))n(i);}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&&h(r),Promise.resolve(e.data);e.status="fetching",e.lastFetchTime=Date.now(),this.emit(r,e);let i=s(),n=Promise.resolve(i);return e.fetchPromise=n,n.then(o=>{e.data=e.equalityFn(e.data,o)?e.data:o,e.status="success",e.updatedAt=Date.now(),e.isError=!1,e.isSuccess=!0;}).catch(o=>{e.error=o,e.status="error",e.isError=!0,e.isSuccess=!1;}).finally(()=>{e.fetchPromise=void 0,this.emit(r,e);}),n}setQueryData(r,a){let e=this.ensureState(r),s=e.data;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),e.data??e.placeholderData}getQueryState(r,a){let e=this.ensureState(r,a);this.handleMountLogic(r,e);let s=d(e),i=c(r),n=this.lastReturnedState?.get(i);return !n||!l(n,s)?(this.lastReturnedState||(this.lastReturnedState=new Map),this.lastReturnedState.set(i,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),i=this.ensureState(r,e);return this.subs.has(s)||this.subs.set(s,new Set),this.subs.get(s).add(a),this.handleMountLogic(r,i),()=>{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(),i=a?.updatedAt==null||s-(a.updatedAt||0)>a.staleTime||a.isInvalidated,n=!1;a.refetchOnSubscribe==="always"&&(n=!0),a.refetchOnSubscribe==="stale"&&(n=i),n&&this.fetchQuery(r);}},Q=y;var u=new Q,m=u.registerFetcher.bind(u),D=u.fetchQuery.bind(u),v=u.setQueryData.bind(u),O=u.getQueryData.bind(u),K=u.getQueryState.bind(u),C=u.invalidateQuery.bind(u),x=u.subscribeQuery.bind(u),w=u.setDefaultConfig.bind(u),I=u.dangerClearCache.bind(u);
 
-// src/utils.ts
-function serializeKey(key) {
-  return Array.isArray(key) ? key.join(",") : String(key);
-}
-function shallowEqual(a, b) {
-  if (a === b)
-    return true;
-  if (a == null || b == null)
-    return a === b;
-  if (typeof a !== "object" || typeof b !== "object")
-    return false;
-  try {
-    const aAny = a;
-    const bAny = b;
-    const aKeys = Object.keys(aAny);
-    const bKeys = Object.keys(bAny);
-    if (aKeys.length !== bKeys.length)
-      return false;
-    for (let i = 0; i < aKeys.length; i++) {
-      const k = aKeys[i];
-      if (aAny[k] !== bAny[k])
-        return false;
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-function createDefaultState(opts, refetch) {
-  return {
-    status: "idle",
-    updatedAt: void 0,
-    staleTime: opts?.staleTime ?? DEFAULT_STALE_TIME,
-    isInvalidated: false,
-    fetcher: opts?.fetcher,
-    equalityFn: opts?.equalityFn ?? shallowEqual,
-    placeholderData: opts?.placeholderData,
-    usePreviousDataOnError: opts?.usePreviousDataOnError ?? false,
-    usePlaceholderOnError: opts?.usePlaceholderOnError ?? false,
-    refetchOnSubscribe: opts?.refetchOnSubscribe ?? "stale",
-    enabled: opts?.enabled === false ? false : true,
-    refetch: refetch || (() => Promise.resolve(void 0)),
-    isSuccess: false,
-    isError: false
-  };
-}
-function createPublicState(state) {
-  const now = Date.now();
-  const isStale = state.updatedAt == null || now - (state.updatedAt || 0) > state.staleTime || state.isInvalidated;
-  let returnedData = state.data;
-  let isPlaceholderData = false;
-  switch (state.status) {
-    case "error":
-      if (state.usePlaceholderOnError && state.placeholderData !== void 0) {
-        returnedData = state.placeholderData;
-        isPlaceholderData = true;
-      }
-      break;
-    case "fetching":
-      if (!state.data && state.placeholderData) {
-        returnedData = state.placeholderData;
-        isPlaceholderData = true;
-      }
-      break;
-    case "success":
-    case "idle":
-      returnedData = state.data ?? state.placeholderData;
-      isPlaceholderData = state.data ? false : Boolean(state.placeholderData);
-      break;
-  }
-  return {
-    data: returnedData,
-    error: state.error,
-    status: state.status,
-    updatedAt: state.updatedAt,
-    isStale,
-    isPlaceholderData,
-    isLoading: state.status === "fetching" && !state.updatedAt,
-    isFetching: state.status === "fetching",
-    isError: state.isError,
-    isSuccess: state.isSuccess,
-    refetch: state.refetch
-  };
-}
-function warnNoFetcherOrData(key) {
-  console.warn(
-    `[qortex] No fetcher or data for key "${serializeKey(key)}". Register a fetcher or set initial data.`
-  );
-}
-
-// src/queryManagerCore.ts
-var QueryManagerCore = class {
-  constructor() {
-    this.cache = /* @__PURE__ */ new Map();
-    this.subs = /* @__PURE__ */ new Map();
-    this.lastReturnedState = /* @__PURE__ */ new Map();
-    this.defaultConfig = {};
-    this.throttleTime = THROTTLE_TIME;
-  }
-  /**
-   * ⚠️ 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
-   * 
-   * @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() {
-    this.cache.clear();
-    this.subs.clear();
-    this.lastReturnedState.clear();
-  }
-  /**
-   * Set default configuration for all queries
-   */
-  setDefaultConfig({ throttleTime, ...config }) {
-    this.defaultConfig = { ...this.defaultConfig, ...config };
-    if (throttleTime !== void 0) {
-      this.throttleTime = throttleTime;
-    }
-  }
-  /**
-   * Ensures a query state exists in cache, creating it if necessary
-   * User-friendly with any fallback for better developer experience
-   */
-  ensureState(key, opts = {}) {
-    const sk = serializeKey(key);
-    const state = this.cache.get(sk);
-    const mergedOpts = { ...this.defaultConfig, ...opts };
-    if (state) {
-      Object.assign(state, mergedOpts);
-      state.enabled = mergedOpts.enabled === false ? false : true;
-      this.cache.set(sk, state);
-    } else {
-      const newState = createDefaultState(mergedOpts, () => this.fetchQuery(key));
-      this.cache.set(sk, newState);
-    }
-    return this.cache.get(sk);
-  }
-  /**
-   * Notifies all subscribers of a query state change
-   */
-  emit(key, state) {
-    const stateKey = serializeKey(key);
-    this.cache.set(stateKey, state);
-    const set = this.subs.get(stateKey);
-    if (!set)
-      return;
-    const publicState = createPublicState(state);
-    for (const cb of Array.from(set))
-      cb(publicState);
-  }
-  registerFetcher(key, opts) {
-    const state = this.ensureState(key, opts);
-    this.handleMountLogic(key, state);
-  }
-  fetchQuery(key, opts) {
-    const state = this.ensureState(key, opts);
-    if (state.fetchPromise)
-      return state.fetchPromise;
-    const fetcher = state.fetcher;
-    if (!fetcher) {
-      if (state.updatedAt === void 0) {
-        warnNoFetcherOrData(key);
-      }
-      return Promise.resolve(state.data);
-    }
-    ;
-    state.status = "fetching";
-    state.lastFetchTime = Date.now();
-    this.emit(key, state);
-    const result = fetcher();
-    const promise = Promise.resolve(result);
-    state.fetchPromise = promise;
-    promise.then((result2) => {
-      state.data = state.equalityFn(state.data, result2) ? state.data : result2;
-      state.status = "success";
-      state.updatedAt = Date.now();
-      state.isError = false;
-      state.isSuccess = true;
-    }).catch((error) => {
-      state.error = error;
-      state.status = "error";
-      state.isError = true;
-      state.isSuccess = false;
-    }).finally(() => {
-      state.fetchPromise = void 0;
-      this.emit(key, state);
-    });
-    return promise;
-  }
-  /**
-   * Manually sets query data without triggering a fetch
-   * Marks query as successful
-   */
-  setQueryData(key, data) {
-    const state = this.ensureState(key);
-    const old = state.data;
-    if (state.equalityFn(old, data))
-      return;
-    state.data = data;
-    state.updatedAt = Date.now();
-    state.error = void 0;
-    state.status = "success";
-    state.isInvalidated = false;
-    state.isError = false;
-    state.isSuccess = true;
-    this.emit(key, state);
-  }
-  getQueryData(key, opts) {
-    const state = this.ensureState(key, opts);
-    this.handleMountLogic(key, state);
-    return state.data ?? state.placeholderData;
-  }
-  getQueryState(key, opts) {
-    let state = this.ensureState(key, opts);
-    this.handleMountLogic(key, state);
-    const currentState = createPublicState(state);
-    const stateKey = serializeKey(key);
-    const lastState = this.lastReturnedState?.get(stateKey);
-    if (!lastState || !shallowEqual(lastState, currentState)) {
-      if (!this.lastReturnedState)
-        this.lastReturnedState = /* @__PURE__ */ new Map();
-      this.lastReturnedState.set(stateKey, currentState);
-      return currentState;
-    }
-    return lastState;
-  }
-  /**
-   * Marks a query as invalidated, triggering refetch
-   */
-  invalidateQuery(key) {
-    const state = this.ensureState(key);
-    state.isInvalidated = true;
-    this.emit(key, state);
-    this.fetchQuery(key);
-  }
-  subscribeQuery(key, cb, opts) {
-    const sk = serializeKey(key);
-    const state = this.ensureState(key, opts);
-    if (!this.subs.has(sk))
-      this.subs.set(sk, /* @__PURE__ */ new Set());
-    this.subs.get(sk).add(cb);
-    this.handleMountLogic(key, state);
-    return () => {
-      this.subs.get(sk).delete(cb);
-    };
-  }
-  /**
-   * Core mount logic that determines when to fetch
-   * Implements robust throttling and race condition prevention
-   */
-  handleMountLogic(key, state) {
-    const isThrottled = state.lastFetchTime && Date.now() - state.lastFetchTime < this.throttleTime;
-    if (state?.status === "fetching" || !state?.enabled || isThrottled || !state?.fetcher)
-      return;
-    const now = Date.now();
-    const isStale = state?.updatedAt == null || now - (state.updatedAt || 0) > state.staleTime || state.isInvalidated;
-    let shouldRefetch = false;
-    if (state.refetchOnSubscribe === "always") {
-      shouldRefetch = true;
-    }
-    if (state.refetchOnSubscribe === "stale") {
-      shouldRefetch = isStale;
-    }
-    if (shouldRefetch) {
-      this.fetchQuery(key);
-    }
-  }
-};
-var queryManagerCore_default = QueryManagerCore;
-
-// src/queryManager.ts
-var _queryManager = new queryManagerCore_default();
-var registerFetcher = _queryManager.registerFetcher.bind(_queryManager);
-var fetchQuery = _queryManager.fetchQuery.bind(_queryManager);
-var setQueryData = _queryManager.setQueryData.bind(_queryManager);
-var getQueryData = _queryManager.getQueryData.bind(_queryManager);
-var getQueryState = _queryManager.getQueryState.bind(_queryManager);
-var invalidateQuery = _queryManager.invalidateQuery.bind(_queryManager);
-var subscribeQuery = _queryManager.subscribeQuery.bind(_queryManager);
-var setDefaultConfig = _queryManager.setDefaultConfig.bind(_queryManager);
-var dangerClearCache = _queryManager.dangerClearCache.bind(_queryManager);
-export {
-  QueryManagerCore,
-  _queryManager,
-  dangerClearCache,
-  fetchQuery,
-  getQueryData,
-  getQueryState,
-  invalidateQuery,
-  registerFetcher,
-  serializeKey,
-  setDefaultConfig,
-  setQueryData,
-  subscribeQuery
-};
+export { y as QueryManagerCore, u as _queryManager, I as dangerClearCache, D as fetchQuery, O as getQueryData, K as getQueryState, C as invalidateQuery, m as registerFetcher, c as serializeKey, w as setDefaultConfig, v as setQueryData, x as subscribeQuery };

package/package.json

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