qortex-core 0.1.4 → 0.1.5

package/index.d.ts

@@ -3,8 +3,6 @@
  * Using readonly to prevent accidental mutations
  */
 type QueryKey = string | readonly (string | number)[];
-/** Valid query key values - only strings and numbers are allowed */
-type QueryKeyValue = string | number;
 /** Function that fetches data, can be async or sync */
 type Fetcher<T = any> = () => Promise<T> | T;
 /** Function that compares two values for equality */
@@ -88,6 +86,28 @@ declare class QueryManager {
     private lastReturnedState;
     private defaultConfig;
     private throttleTime;
+    /**
+     * ⚠️ 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(): void;
     /**
      * Set default configuration for all queries
      */
@@ -168,4 +188,4 @@ declare const queryManager: QueryManager;
  */
 declare function serializeKey(key: QueryKey): string;
 
-export { DefaultConfig, EqualityFn, Fetcher, InferFetcherResult, QueryKey, QueryKeyValue, QueryManager, QueryOptions, QueryState, QueryStatus, queryManager, serializeKey };
+export { DefaultConfig, EqualityFn, Fetcher, InferFetcherResult, QueryKey, QueryManager, QueryOptions, QueryState, QueryStatus, queryManager, serializeKey };

package/index.js

@@ -114,6 +114,11 @@ function createPublicState(state) {
     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/queryManager.ts
 var QueryManager = class {
@@ -124,6 +129,32 @@ var QueryManager = class {
     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
    */
@@ -179,7 +210,9 @@ var QueryManager = class {
       return state.fetchPromise;
     const fetcher = state.fetcher;
     if (!fetcher) {
-      console.error("No fetcher found for key", key);
+      if (state.updatedAt === void 0) {
+        warnNoFetcherOrData(key);
+      }
       return Promise.resolve(state.data);
     }
     ;

package/index.mjs

@@ -86,6 +86,11 @@ function createPublicState(state) {
     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/queryManager.ts
 var QueryManager = class {
@@ -96,6 +101,32 @@ var QueryManager = class {
     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
    */
@@ -151,7 +182,9 @@ var QueryManager = class {
       return state.fetchPromise;
     const fetcher = state.fetcher;
     if (!fetcher) {
-      console.error("No fetcher found for key", key);
+      if (state.updatedAt === void 0) {
+        warnNoFetcherOrData(key);
+      }
       return Promise.resolve(state.data);
     }
     ;

package/package.json

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