yuustate 3.10.2 → 3.11.0

package/esm/react/create-query.d.mts

@@ -72,7 +72,11 @@ type Internal<TData, TError> = {
     garbageCollectionTimeoutId?: number;
     rollbackData?: TData | undefined;
 };
-type AdditionalStoreApi<TData, TError> = {
+type AdditionalStoreApi<TData, TError, TVariable extends StoreKey = never> = {
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -205,7 +209,7 @@ type AdditionalStoreApi<TData, TError> = {
  * @remarks
  * Controls caching, retry behavior, lifecycle, and side effects of an async operation.
  */
-export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError>> & {
+export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError, TVariable>> & {
     /**
      * Time (in milliseconds) that data is considered fresh.
      *
@@ -357,6 +361,10 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
     getState: () => QueryState<TData, TError>;
     subscribe: (subscriber: import("../vanilla.d.mts").Subscriber<QueryState<TData, TError>>) => () => void;
     getSubscriberCount: () => number;
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -490,6 +498,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Useful for bulk refetching.
      */
     executeAll: (options?: {
+        /**
+         * Optional predicate to select which query to execute.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -499,6 +516,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Only re-fetches stale queries.
      */
     revalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to revalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -509,11 +535,25 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
     invalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to invalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
      * Resets all query instances.
      */
-    resetAll: () => void;
+    resetAll: (options?: {
+        /**
+         * Optional predicate to select which query to reset.
+         */
+        filter?: (variable: TVariable) => boolean;
+    }) => void;
 };
 export {};

package/esm/react.mjs

@@ -118,6 +118,7 @@ const createStores = (initialState, options) => {
     let store;
     if (stores.has(keyHash)) {
       store = stores.get(keyHash);
+      store.key = key;
     } else {
       store = initStore(
         initialState,
@@ -417,12 +418,14 @@ const createQuery = (queryFn, options = {}) => {
     let store;
     if (stores.has(variableHash)) {
       store = stores.get(variableHash);
+      store.variable = variable;
     } else {
       store = initStore(
         initialState,
         configureStoreEvents(variableHash)
         // Intentionally using as any: don't want to add generic on `initStore`
       );
+      store.variable = variable;
       store.variableHash = variableHash;
       stores.set(variableHash, store);
       const apis = getApis(store, variable);
@@ -522,6 +525,7 @@ const createQuery = (queryFn, options = {}) => {
       }
     });
   };
+  const shouldApplyToStore = (store, filter) => filter ? filter(store.variable) : true;
   return Object.assign(getStore, {
     /**
      * Executes all query instances.
@@ -529,8 +533,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Useful for bulk refetching.
      */
-    executeAll: (options2) => {
-      stores.forEach((store) => store.execute(options2));
+    executeAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.execute(restOptions);
+      });
     },
     /**
      * Revalidates all query instances.
@@ -538,8 +546,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Only re-fetches stale queries.
      */
-    revalidateAll: (options2) => {
-      stores.forEach((store) => store.revalidate(options2));
+    revalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.revalidate(restOptions);
+      });
     },
     /**
      * Invalidates all query instances.
@@ -548,14 +560,22 @@ const createQuery = (queryFn, options = {}) => {
      * - Marks all queries as invalidated and triggers revalidation if active.
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
-    invalidateAll: (options2) => {
-      stores.forEach((store) => store.invalidate(options2));
+    invalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.invalidate(restOptions);
+      });
     },
     /**
      * Resets all query instances.
      */
-    resetAll: () => {
-      stores.forEach((store) => store.reset());
+    resetAll: (options2 = {}) => {
+      const { filter } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.reset();
+      });
     }
   });
 };

package/package.json

@@ -2,7 +2,7 @@
   "name": "yuustate",
   "description": "Lightweight unified state management for sync and async data.",
   "private": false,
-  "version": "3.10.2",
+  "version": "3.11.0",
   "keywords": [
     "utilities",
     "store",

package/react/create-query.d.ts

@@ -72,7 +72,11 @@ type Internal<TData, TError> = {
     garbageCollectionTimeoutId?: number;
     rollbackData?: TData | undefined;
 };
-type AdditionalStoreApi<TData, TError> = {
+type AdditionalStoreApi<TData, TError, TVariable extends StoreKey = never> = {
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -205,7 +209,7 @@ type AdditionalStoreApi<TData, TError> = {
  * @remarks
  * Controls caching, retry behavior, lifecycle, and side effects of an async operation.
  */
-export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError>> & {
+export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError, TVariable>> & {
     /**
      * Time (in milliseconds) that data is considered fresh.
      *
@@ -357,6 +361,10 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
     getState: () => QueryState<TData, TError>;
     subscribe: (subscriber: import("../vanilla.ts").Subscriber<QueryState<TData, TError>>) => () => void;
     getSubscriberCount: () => number;
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -490,6 +498,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Useful for bulk refetching.
      */
     executeAll: (options?: {
+        /**
+         * Optional predicate to select which query to execute.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -499,6 +516,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Only re-fetches stale queries.
      */
     revalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to revalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -509,11 +535,25 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
     invalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to invalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
      * Resets all query instances.
      */
-    resetAll: () => void;
+    resetAll: (options?: {
+        /**
+         * Optional predicate to select which query to reset.
+         */
+        filter?: (variable: TVariable) => boolean;
+    }) => void;
 };
 export {};

package/react.js

@@ -120,6 +120,7 @@ const createStores = (initialState, options) => {
     let store;
     if (stores.has(keyHash)) {
       store = stores.get(keyHash);
+      store.key = key;
     } else {
       store = vanilla.initStore(
         initialState,
@@ -419,12 +420,14 @@ const createQuery = (queryFn, options = {}) => {
     let store;
     if (stores.has(variableHash)) {
       store = stores.get(variableHash);
+      store.variable = variable;
     } else {
       store = vanilla.initStore(
         initialState,
         configureStoreEvents(variableHash)
         // Intentionally using as any: don't want to add generic on `initStore`
       );
+      store.variable = variable;
       store.variableHash = variableHash;
       stores.set(variableHash, store);
       const apis = getApis(store, variable);
@@ -524,6 +527,7 @@ const createQuery = (queryFn, options = {}) => {
       }
     });
   };
+  const shouldApplyToStore = (store, filter) => filter ? filter(store.variable) : true;
   return Object.assign(getStore, {
     /**
      * Executes all query instances.
@@ -531,8 +535,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Useful for bulk refetching.
      */
-    executeAll: (options2) => {
-      stores.forEach((store) => store.execute(options2));
+    executeAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.execute(restOptions);
+      });
     },
     /**
      * Revalidates all query instances.
@@ -540,8 +548,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Only re-fetches stale queries.
      */
-    revalidateAll: (options2) => {
-      stores.forEach((store) => store.revalidate(options2));
+    revalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.revalidate(restOptions);
+      });
     },
     /**
      * Invalidates all query instances.
@@ -550,14 +562,22 @@ const createQuery = (queryFn, options = {}) => {
      * - Marks all queries as invalidated and triggers revalidation if active.
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
-    invalidateAll: (options2) => {
-      stores.forEach((store) => store.invalidate(options2));
+    invalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.invalidate(restOptions);
+      });
     },
     /**
      * Resets all query instances.
      */
-    resetAll: () => {
-      stores.forEach((store) => store.reset());
+    resetAll: (options2 = {}) => {
+      const { filter } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.reset();
+      });
     }
   });
 };