@spoosh/react 0.14.1 → 0.15.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ReadClient, TagMode, SpooshResponse, ExtractTriggerQuery as ExtractTriggerQuery$3, ExtractTriggerBody as ExtractTriggerBody$3, ExtractTriggerParams as ExtractTriggerParams$3, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteSelectorClient, SpooshBody, QueueSelectorClient, QueueItem, QueueStats, InfiniteRequestOptions, InfiniteNextContext, InfinitePage, InfinitePrevContext, SubscriptionClient, SubscriptionAdapter, OperationType, StateManager, EventEmitter, PluginExecutor, SpooshTransport, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginApi, MethodOptionsMap, CoreRequestOptionsBase, SpooshClient, SpooshOptions } from '@spoosh/core';
+import { ReadClient, SpooshResponse, ExtractTriggerQuery as ExtractTriggerQuery$3, ExtractTriggerBody as ExtractTriggerBody$3, ExtractTriggerParams as ExtractTriggerParams$3, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteSelectorClient, SpooshBody, QueueSelectorClient, QueueItem, QueueStats, InfiniteRequestOptions, InfiniteNextContext, InfinitePage, InfinitePrevContext, SubscriptionClient, SubscriptionAdapter, OperationType, StateManager, EventEmitter, PluginExecutor, SpooshTransport, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginApi, MethodOptionsMap, CoreRequestOptionsBase, SpooshClient, SpooshOptions } from '@spoosh/core';
 
 type SuccessResponse<T> = Extract<T, {
     data: unknown;
@@ -72,7 +72,6 @@ type ExtractSubscriptionError<T> = SubscriptionReturnType<T> extends {
     error: infer E;
 } ? E : unknown;
 
-type TagModeInArray$1 = "all" | "self";
 /**
  * Base options for `useRead` hook.
  */
@@ -80,13 +79,11 @@ type BaseReadOptions = {
     /** Whether to fetch automatically on mount. Default: true */
     enabled?: boolean;
     /**
-     * Unified tag option
-     * - String: mode only ('all' | 'self' | 'none')
-     * - Array: custom tags only OR [mode keyword mixed with custom tags]
-     *   - 'all' or 'self' can be used in arrays
-     *   - 'none' should only be used as string (use `tags: 'none'` not in array)
+     * Custom tags for cache entry.
+     * Can be a single tag string or an array of tags.
+     * Default: auto-generated from path (e.g., "users/1")
      */
-    tags?: TagMode | (TagModeInArray$1 | (string & {}))[];
+    tags?: string | string[];
 };
 type QueryField<TQuery> = [TQuery] extends [never] ? object : undefined extends TQuery ? {
     query?: Exclude<TQuery, undefined>;
@@ -291,7 +288,6 @@ type UseQueueResult<TData, TError, TTriggerInput, TMeta = object> = {
  */
 type QueueApiClient<TSchema, TDefaultError> = QueueSelectorClient<TSchema, TDefaultError>;
 
-type TagModeInArray = "all" | "self";
 type TriggerAwaitedReturn<T> = T extends (...args: never[]) => infer R ? Awaited<R> : never;
 type ExtractInputFromResponse<T> = T extends {
     input: infer I;
@@ -314,13 +310,11 @@ type BasePagesOptions<TData, TItem, TError = unknown, TRequest = InfiniteRequest
     /** Whether to fetch automatically on mount. Default: true */
     enabled?: boolean;
     /**
-     * Unified tag option
-     * - String: mode only ('all' | 'self' | 'none')
-     * - Array: custom tags only OR [mode keyword mixed with custom tags]
-     *   - 'all' or 'self' can be used in arrays
-     *   - 'none' should only be used as string (use `tags: 'none'` not in array)
+     * Custom tags for cache entry.
+     * Can be a single tag string or an array of tags.
+     * Default: auto-generated from path (e.g., "posts/1")
      */
-    tags?: TagMode | (TagModeInArray | (string & {}))[];
+    tags?: string | string[];
     /**
      * Callback to determine if there's a next page to fetch.
      * Receives the last page to check for pagination indicators.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ReadClient, TagMode, SpooshResponse, ExtractTriggerQuery as ExtractTriggerQuery$3, ExtractTriggerBody as ExtractTriggerBody$3, ExtractTriggerParams as ExtractTriggerParams$3, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteSelectorClient, SpooshBody, QueueSelectorClient, QueueItem, QueueStats, InfiniteRequestOptions, InfiniteNextContext, InfinitePage, InfinitePrevContext, SubscriptionClient, SubscriptionAdapter, OperationType, StateManager, EventEmitter, PluginExecutor, SpooshTransport, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginApi, MethodOptionsMap, CoreRequestOptionsBase, SpooshClient, SpooshOptions } from '@spoosh/core';
+import { ReadClient, SpooshResponse, ExtractTriggerQuery as ExtractTriggerQuery$3, ExtractTriggerBody as ExtractTriggerBody$3, ExtractTriggerParams as ExtractTriggerParams$3, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteSelectorClient, SpooshBody, QueueSelectorClient, QueueItem, QueueStats, InfiniteRequestOptions, InfiniteNextContext, InfinitePage, InfinitePrevContext, SubscriptionClient, SubscriptionAdapter, OperationType, StateManager, EventEmitter, PluginExecutor, SpooshTransport, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginApi, MethodOptionsMap, CoreRequestOptionsBase, SpooshClient, SpooshOptions } from '@spoosh/core';
 
 type SuccessResponse<T> = Extract<T, {
     data: unknown;
@@ -72,7 +72,6 @@ type ExtractSubscriptionError<T> = SubscriptionReturnType<T> extends {
     error: infer E;
 } ? E : unknown;
 
-type TagModeInArray$1 = "all" | "self";
 /**
  * Base options for `useRead` hook.
  */
@@ -80,13 +79,11 @@ type BaseReadOptions = {
     /** Whether to fetch automatically on mount. Default: true */
     enabled?: boolean;
     /**
-     * Unified tag option
-     * - String: mode only ('all' | 'self' | 'none')
-     * - Array: custom tags only OR [mode keyword mixed with custom tags]
-     *   - 'all' or 'self' can be used in arrays
-     *   - 'none' should only be used as string (use `tags: 'none'` not in array)
+     * Custom tags for cache entry.
+     * Can be a single tag string or an array of tags.
+     * Default: auto-generated from path (e.g., "users/1")
      */
-    tags?: TagMode | (TagModeInArray$1 | (string & {}))[];
+    tags?: string | string[];
 };
 type QueryField<TQuery> = [TQuery] extends [never] ? object : undefined extends TQuery ? {
     query?: Exclude<TQuery, undefined>;
@@ -291,7 +288,6 @@ type UseQueueResult<TData, TError, TTriggerInput, TMeta = object> = {
  */
 type QueueApiClient<TSchema, TDefaultError> = QueueSelectorClient<TSchema, TDefaultError>;
 
-type TagModeInArray = "all" | "self";
 type TriggerAwaitedReturn<T> = T extends (...args: never[]) => infer R ? Awaited<R> : never;
 type ExtractInputFromResponse<T> = T extends {
     input: infer I;
@@ -314,13 +310,11 @@ type BasePagesOptions<TData, TItem, TError = unknown, TRequest = InfiniteRequest
     /** Whether to fetch automatically on mount. Default: true */
     enabled?: boolean;
     /**
-     * Unified tag option
-     * - String: mode only ('all' | 'self' | 'none')
-     * - Array: custom tags only OR [mode keyword mixed with custom tags]
-     *   - 'all' or 'self' can be used in arrays
-     *   - 'none' should only be used as string (use `tags: 'none'` not in array)
+     * Custom tags for cache entry.
+     * Can be a single tag string or an array of tags.
+     * Default: auto-generated from path (e.g., "posts/1")
      */
-    tags?: TagMode | (TagModeInArray | (string & {}))[];
+    tags?: string | string[];
     /**
      * Callback to determine if there's a next page to fetch.
      * Receives the last page to check for pagination indicators.

package/dist/index.js

@@ -153,9 +153,9 @@ function createUseRead(options) {
       });
       const unsubInvalidate = eventEmitter.on(
         "invalidate",
-        (invalidatedTags) => {
-          const hasMatch = invalidatedTags.some(
-            (tag) => resolvedTags.includes(tag)
+        (invalidatePatterns) => {
+          const hasMatch = resolvedTags.some(
+            (tag) => (0, import_core.matchTags)(tag, invalidatePatterns)
           );
           if (hasMatch) {
             executeWithTracking(true);
@@ -548,9 +548,9 @@ function createUsePages(options) {
       }
       const unsubInvalidate = eventEmitter.on(
         "invalidate",
-        (invalidatedTags) => {
-          const hasMatch = invalidatedTags.some(
-            (tag) => resolvedTags.includes(tag)
+        (invalidatePatterns) => {
+          const hasMatch = resolvedTags.some(
+            (tag) => (0, import_core3.matchTags)(tag, invalidatePatterns)
           );
           if (hasMatch) {
             setIsPending(true);

package/dist/index.mjs

@@ -13,7 +13,8 @@ import {
   createOperationController,
   createSelectorProxy,
   resolvePath,
-  resolveTags
+  resolveTags,
+  matchTags
 } from "@spoosh/core";
 function createUseRead(options) {
   const { api, stateManager, eventEmitter, pluginExecutor } = options;
@@ -140,9 +141,9 @@ function createUseRead(options) {
       });
       const unsubInvalidate = eventEmitter.on(
         "invalidate",
-        (invalidatedTags) => {
-          const hasMatch = invalidatedTags.some(
-            (tag) => resolvedTags.includes(tag)
+        (invalidatePatterns) => {
+          const hasMatch = resolvedTags.some(
+            (tag) => matchTags(tag, invalidatePatterns)
           );
           if (hasMatch) {
             executeWithTracking(true);
@@ -415,7 +416,8 @@ import {
   createInfiniteReadController,
   createSelectorProxy as createSelectorProxy3,
   resolvePath as resolvePath3,
-  resolveTags as resolveTags3
+  resolveTags as resolveTags3,
+  matchTags as matchTags2
 } from "@spoosh/core";
 function createUsePages(options) {
   const { api, stateManager, eventEmitter, pluginExecutor } = options;
@@ -558,9 +560,9 @@ function createUsePages(options) {
       }
       const unsubInvalidate = eventEmitter.on(
         "invalidate",
-        (invalidatedTags) => {
-          const hasMatch = invalidatedTags.some(
-            (tag) => resolvedTags.includes(tag)
+        (invalidatePatterns) => {
+          const hasMatch = resolvedTags.some(
+            (tag) => matchTags2(tag, invalidatePatterns)
           );
           if (hasMatch) {
             setIsPending(true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/react",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "license": "MIT",
   "description": "React hooks for Spoosh API toolkit",
   "keywords": [
@@ -34,7 +34,7 @@
     }
   },
   "peerDependencies": {
-    "@spoosh/core": ">=0.17.1",
+    "@spoosh/core": ">=0.18.0",
     "@spoosh/transport-sse": ">=0.1.0",
     "react": "^18 || ^19"
   },
@@ -46,7 +46,7 @@
   "devDependencies": {
     "@testing-library/react": "^16.0.0",
     "jsdom": "^26.0.0",
-    "@spoosh/core": "0.17.1",
+    "@spoosh/core": "0.18.0",
     "@spoosh/transport-sse": "0.1.1",
     "@spoosh/test-utils": "0.3.0"
   },