yuustate 3.10.2 → 3.11.1

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

@@ -3,7 +3,15 @@ import { isClient, initStore, getHash, noop } from 'yuustate/vanilla';
 
 const useIsomorphicLayoutEffect = isClient ? useLayoutEffect : useEffect;
 
-const getValueByPath = (obj, path) => path.reduce((acc, key) => acc == null ? void 0 : acc[key], obj);
+const DATE_METHOD_REGEX = /^(?:to|get)[A-Z]/;
+const getValueByPath = (obj, path) => {
+  return path.reduce((acc, key) => {
+    if (acc instanceof Date && DATE_METHOD_REGEX.test(key)) {
+      return acc[key]();
+    }
+    return acc == null ? void 0 : acc[key];
+  }, obj);
+};
 const isPrefixPath = (candidatePrefix, targetPath) => {
   if (candidatePrefix.length >= targetPath.length) return false;
   for (let i = 0; i < candidatePrefix.length; i++) {
@@ -39,6 +47,9 @@ const useStoreStateProxy = (storeState) => {
           const newPath = [...path, key];
           track(newPath);
           const value = obj[key];
+          if (target instanceof Date && typeof value === "function" && DATE_METHOD_REGEX.test(key)) {
+            return value.bind(target);
+          }
           return createDeepProxy(value, newPath);
         }
       });
@@ -118,6 +129,7 @@ const createStores = (initialState, options) => {
     let store;
     if (stores.has(keyHash)) {
       store = stores.get(keyHash);
+      store.key = key;
     } else {
       store = initStore(
         initialState,
@@ -417,12 +429,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 +536,7 @@ const createQuery = (queryFn, options = {}) => {
       }
     });
   };
+  const shouldApplyToStore = (store, filter) => filter ? filter(store.variable) : true;
   return Object.assign(getStore, {
     /**
      * Executes all query instances.
@@ -529,8 +544,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 +557,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 +571,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.1",
   "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

@@ -5,7 +5,15 @@ var vanilla = require('yuustate/vanilla');
 
 const useIsomorphicLayoutEffect = vanilla.isClient ? react.useLayoutEffect : react.useEffect;
 
-const getValueByPath = (obj, path) => path.reduce((acc, key) => acc == null ? void 0 : acc[key], obj);
+const DATE_METHOD_REGEX = /^(?:to|get)[A-Z]/;
+const getValueByPath = (obj, path) => {
+  return path.reduce((acc, key) => {
+    if (acc instanceof Date && DATE_METHOD_REGEX.test(key)) {
+      return acc[key]();
+    }
+    return acc == null ? void 0 : acc[key];
+  }, obj);
+};
 const isPrefixPath = (candidatePrefix, targetPath) => {
   if (candidatePrefix.length >= targetPath.length) return false;
   for (let i = 0; i < candidatePrefix.length; i++) {
@@ -41,6 +49,9 @@ const useStoreStateProxy = (storeState) => {
           const newPath = [...path, key];
           track(newPath);
           const value = obj[key];
+          if (target instanceof Date && typeof value === "function" && DATE_METHOD_REGEX.test(key)) {
+            return value.bind(target);
+          }
           return createDeepProxy(value, newPath);
         }
       });
@@ -120,6 +131,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 +431,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 +538,7 @@ const createQuery = (queryFn, options = {}) => {
       }
     });
   };
+  const shouldApplyToStore = (store, filter) => filter ? filter(store.variable) : true;
   return Object.assign(getStore, {
     /**
      * Executes all query instances.
@@ -531,8 +546,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 +559,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 +573,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();
+      });
     }
   });
 };