@spoosh/core 0.17.1 → 0.18.1

package/dist/index.d.mts

@@ -2146,22 +2146,25 @@ declare function objectToUrlEncoded(obj: Record<string, unknown>): string;
 
 declare function sortObjectKeys(obj: unknown, seen?: WeakSet<object>): unknown;
 
-type TagMode = "all" | "self" | "none";
-type TagModeInArray = "all" | "self";
 /**
  * Common tag options used across plugins and operations.
  */
 type TagOptions = {
     /**
-     * Unified tag option (follows invalidation pattern)
-     * - String: mode only ('all' | 'self' | 'none')
-     * - Array: custom tags only OR [mode keyword mixed with custom tags]
-     *   - If array contains 'all' or 'self', it's treated as mode + tags
-     *   - Otherwise, it's custom tags only (replaces auto-generated tags)
-     *   - 'none' keyword should NOT be used in arrays (use string 'none' instead)
+     * Custom tags to use instead of auto-generated tag.
+     * Can be a single tag string or an array of tags.
      */
-    tags?: TagMode | (TagModeInArray | (string & {}))[];
+    tags?: string | string[];
 };
+/**
+ * Resolves tags for a cache entry.
+ * Returns a single tag by default (the joined path), or custom tags if provided.
+ * All tags are normalized (leading "/" removed) for consistency.
+ *
+ * @param options - Tag options containing optional custom tags
+ * @param resolvedPath - The resolved path segments
+ * @returns Array of normalized tags
+ */
 declare function resolveTags(options: TagOptions | undefined, resolvedPath: string[]): string[];
 declare function resolvePath(path: string[], params: Record<string, string | number> | undefined): string[];
 /**
@@ -2180,6 +2183,31 @@ declare function resolvePath(path: string[], params: Record<string, string | num
  */
 declare function resolvePathString(path: string, params: Record<string, string | number> | undefined): string;
 
+/**
+ * Normalizes a tag or pattern by removing leading slashes.
+ * Ensures consistency between "/hello" and "hello".
+ */
+declare function normalizeTag(tag: string): string;
+/**
+ * Checks if an entry's tag matches a given invalidation pattern.
+ * Both tag and pattern are normalized (leading "/" removed) before comparison.
+ *
+ * @param entryTag - The tag from a cache entry (e.g., "posts", "posts/1", "posts/1/comments")
+ * @param pattern - The pattern to match against:
+ *   - "posts" - Exact match only
+ *   - "posts/*" - Children only (matches posts/1, posts/1/comments, but NOT posts)
+ * @returns true if the entry tag matches the pattern
+ */
+declare function matchTag(entryTag: string, pattern: string): boolean;
+/**
+ * Checks if an entry's tag matches any of the given invalidation patterns.
+ *
+ * @param entryTag - The tag from a cache entry
+ * @param patterns - Array of patterns to match against
+ * @returns true if the entry tag matches any of the patterns
+ */
+declare function matchTags(entryTag: string, patterns: string[]): boolean;
+
 declare const isNetworkError: (err: unknown) => boolean;
 declare const isAbortError: (err: unknown) => boolean;
 
@@ -2199,6 +2227,13 @@ declare function clone<T>(value: T, seen?: WeakMap<WeakKey, any>): T;
  */
 declare function createTracer(plugin: string, trace: Trace | undefined): RequestTracer;
 
+/**
+ * Generates a UUID v4 string.
+ * Uses crypto.randomUUID() when available (secure contexts),
+ * falls back to Math.random() for non-secure contexts (HTTP).
+ */
+declare function generateUUID(): string;
+
 type ProxyHandlerConfig<TOptions = SpooshOptions> = {
     baseUrl: string;
     defaultOptions: TOptions;
@@ -2605,4 +2640,4 @@ interface CreateSubscriptionControllerOptions<TData, TError> {
 }
 declare function createSubscriptionController<TData, TError>(options: CreateSubscriptionControllerOptions<TData, TError>): SubscriptionController<TData, TError>;
 
-export { type AnyMethod, type AnyRequestOptions, type ApiContext, type ApiPluginExecutor, type ApiResolvers, type ApiSchema, type BaseSubscriptionResponse, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type CreateSubscriptionControllerOptions, type DataAwareCallback, type DataAwareTransform, type DataChangeCallback, type DevtoolEvents, type EventEmitter, type EventListener, type EventOptions, type EventTracer, type ExecuteOptions, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type ExtractTriggerBody, type ExtractTriggerParams, type ExtractTriggerQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasSubscriptionMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteNextContext, type InfinitePage, type InfinitePageStatus, type InfinitePrevContext, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InfiniteTriggerOptions, type LifecyclePhase, type MergePluginApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextBase, type PluginContextExtensions, type PluginContextInput, type PluginExecutor, type PluginFactory, type PluginHandler, type PluginInternalRegistry, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type QueueController, type QueueControllerConfig, type QueueControllerContext, type QueueItem, type QueueItemStatus, type QueueSelectorClient, type QueueStats, type QueueTriggerInput, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestCompleteEvent, type RequestOptions$1 as RequestOptions, type RequestTracer, type ResolveApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, Semaphore, type SetupContext, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type SpooshSubscriptionMethodRegistry, type SpooshTransport, type SpooshTransportRegistry, type StandaloneEvent, type StateManager, type StripPrefix, type Subscriber, type SubscriptionAccumulateEvent, type SubscriptionAdapter, type SubscriptionClient, type SubscriptionConnectEvent, type SubscriptionConnectedEvent, type SubscriptionContext, type SubscriptionController, type SubscriptionDisconnectEvent, type SubscriptionErrorEvent, type SubscriptionHandle, type SubscriptionMessageEvent, type SubscriptionMethod, type SubscriptionPaths, type TagMode, type TagOptions, type Trace, type TraceColor, type TraceEvent, type TraceInfo, type TraceListener, type TraceOptions, type TraceStage, type Transport, type TransportName, type TransportOption, type TransportOptionsMap, type TransportResponse, type TypedPluginContext, type TypedPluginDefinition, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, type WriteSelectorClient, __DEV__, buildUrl, clone, composeAdapter, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createQueueController, createSelectorProxy, createSpooshPlugin, createStateManager, createSubscriptionController, createTracer, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateSelfTagFromKey, generateTags, getContentType, isAbortError, isJsonBody, isNetworkError, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, removeHeaderKeys, resolveHeadersToRecord, resolvePath, resolvePathString, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };
+export { type AnyMethod, type AnyRequestOptions, type ApiContext, type ApiPluginExecutor, type ApiResolvers, type ApiSchema, type BaseSubscriptionResponse, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type CreateSubscriptionControllerOptions, type DataAwareCallback, type DataAwareTransform, type DataChangeCallback, type DevtoolEvents, type EventEmitter, type EventListener, type EventOptions, type EventTracer, type ExecuteOptions, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type ExtractTriggerBody, type ExtractTriggerParams, type ExtractTriggerQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasSubscriptionMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteNextContext, type InfinitePage, type InfinitePageStatus, type InfinitePrevContext, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InfiniteTriggerOptions, type LifecyclePhase, type MergePluginApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextBase, type PluginContextExtensions, type PluginContextInput, type PluginExecutor, type PluginFactory, type PluginHandler, type PluginInternalRegistry, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type QueueController, type QueueControllerConfig, type QueueControllerContext, type QueueItem, type QueueItemStatus, type QueueSelectorClient, type QueueStats, type QueueTriggerInput, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestCompleteEvent, type RequestOptions$1 as RequestOptions, type RequestTracer, type ResolveApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, Semaphore, type SetupContext, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type SpooshSubscriptionMethodRegistry, type SpooshTransport, type SpooshTransportRegistry, type StandaloneEvent, type StateManager, type StripPrefix, type Subscriber, type SubscriptionAccumulateEvent, type SubscriptionAdapter, type SubscriptionClient, type SubscriptionConnectEvent, type SubscriptionConnectedEvent, type SubscriptionContext, type SubscriptionController, type SubscriptionDisconnectEvent, type SubscriptionErrorEvent, type SubscriptionHandle, type SubscriptionMessageEvent, type SubscriptionMethod, type SubscriptionPaths, type TagOptions, type Trace, type TraceColor, type TraceEvent, type TraceInfo, type TraceListener, type TraceOptions, type TraceStage, type Transport, type TransportName, type TransportOption, type TransportOptionsMap, type TransportResponse, type TypedPluginContext, type TypedPluginDefinition, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, type WriteSelectorClient, __DEV__, buildUrl, clone, composeAdapter, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createQueueController, createSelectorProxy, createSpooshPlugin, createStateManager, createSubscriptionController, createTracer, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateSelfTagFromKey, generateTags, generateUUID, getContentType, isAbortError, isJsonBody, isNetworkError, isSpooshBody, json, matchTag, matchTags, mergeHeaders, normalizeTag, objectToFormData, objectToUrlEncoded, removeHeaderKeys, resolveHeadersToRecord, resolvePath, resolvePathString, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };

package/dist/index.d.ts

@@ -2146,22 +2146,25 @@ declare function objectToUrlEncoded(obj: Record<string, unknown>): string;
 
 declare function sortObjectKeys(obj: unknown, seen?: WeakSet<object>): unknown;
 
-type TagMode = "all" | "self" | "none";
-type TagModeInArray = "all" | "self";
 /**
  * Common tag options used across plugins and operations.
  */
 type TagOptions = {
     /**
-     * Unified tag option (follows invalidation pattern)
-     * - String: mode only ('all' | 'self' | 'none')
-     * - Array: custom tags only OR [mode keyword mixed with custom tags]
-     *   - If array contains 'all' or 'self', it's treated as mode + tags
-     *   - Otherwise, it's custom tags only (replaces auto-generated tags)
-     *   - 'none' keyword should NOT be used in arrays (use string 'none' instead)
+     * Custom tags to use instead of auto-generated tag.
+     * Can be a single tag string or an array of tags.
      */
-    tags?: TagMode | (TagModeInArray | (string & {}))[];
+    tags?: string | string[];
 };
+/**
+ * Resolves tags for a cache entry.
+ * Returns a single tag by default (the joined path), or custom tags if provided.
+ * All tags are normalized (leading "/" removed) for consistency.
+ *
+ * @param options - Tag options containing optional custom tags
+ * @param resolvedPath - The resolved path segments
+ * @returns Array of normalized tags
+ */
 declare function resolveTags(options: TagOptions | undefined, resolvedPath: string[]): string[];
 declare function resolvePath(path: string[], params: Record<string, string | number> | undefined): string[];
 /**
@@ -2180,6 +2183,31 @@ declare function resolvePath(path: string[], params: Record<string, string | num
  */
 declare function resolvePathString(path: string, params: Record<string, string | number> | undefined): string;
 
+/**
+ * Normalizes a tag or pattern by removing leading slashes.
+ * Ensures consistency between "/hello" and "hello".
+ */
+declare function normalizeTag(tag: string): string;
+/**
+ * Checks if an entry's tag matches a given invalidation pattern.
+ * Both tag and pattern are normalized (leading "/" removed) before comparison.
+ *
+ * @param entryTag - The tag from a cache entry (e.g., "posts", "posts/1", "posts/1/comments")
+ * @param pattern - The pattern to match against:
+ *   - "posts" - Exact match only
+ *   - "posts/*" - Children only (matches posts/1, posts/1/comments, but NOT posts)
+ * @returns true if the entry tag matches the pattern
+ */
+declare function matchTag(entryTag: string, pattern: string): boolean;
+/**
+ * Checks if an entry's tag matches any of the given invalidation patterns.
+ *
+ * @param entryTag - The tag from a cache entry
+ * @param patterns - Array of patterns to match against
+ * @returns true if the entry tag matches any of the patterns
+ */
+declare function matchTags(entryTag: string, patterns: string[]): boolean;
+
 declare const isNetworkError: (err: unknown) => boolean;
 declare const isAbortError: (err: unknown) => boolean;
 
@@ -2199,6 +2227,13 @@ declare function clone<T>(value: T, seen?: WeakMap<WeakKey, any>): T;
  */
 declare function createTracer(plugin: string, trace: Trace | undefined): RequestTracer;
 
+/**
+ * Generates a UUID v4 string.
+ * Uses crypto.randomUUID() when available (secure contexts),
+ * falls back to Math.random() for non-secure contexts (HTTP).
+ */
+declare function generateUUID(): string;
+
 type ProxyHandlerConfig<TOptions = SpooshOptions> = {
     baseUrl: string;
     defaultOptions: TOptions;
@@ -2605,4 +2640,4 @@ interface CreateSubscriptionControllerOptions<TData, TError> {
 }
 declare function createSubscriptionController<TData, TError>(options: CreateSubscriptionControllerOptions<TData, TError>): SubscriptionController<TData, TError>;
 
-export { type AnyMethod, type AnyRequestOptions, type ApiContext, type ApiPluginExecutor, type ApiResolvers, type ApiSchema, type BaseSubscriptionResponse, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type CreateSubscriptionControllerOptions, type DataAwareCallback, type DataAwareTransform, type DataChangeCallback, type DevtoolEvents, type EventEmitter, type EventListener, type EventOptions, type EventTracer, type ExecuteOptions, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type ExtractTriggerBody, type ExtractTriggerParams, type ExtractTriggerQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasSubscriptionMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteNextContext, type InfinitePage, type InfinitePageStatus, type InfinitePrevContext, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InfiniteTriggerOptions, type LifecyclePhase, type MergePluginApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextBase, type PluginContextExtensions, type PluginContextInput, type PluginExecutor, type PluginFactory, type PluginHandler, type PluginInternalRegistry, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type QueueController, type QueueControllerConfig, type QueueControllerContext, type QueueItem, type QueueItemStatus, type QueueSelectorClient, type QueueStats, type QueueTriggerInput, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestCompleteEvent, type RequestOptions$1 as RequestOptions, type RequestTracer, type ResolveApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, Semaphore, type SetupContext, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type SpooshSubscriptionMethodRegistry, type SpooshTransport, type SpooshTransportRegistry, type StandaloneEvent, type StateManager, type StripPrefix, type Subscriber, type SubscriptionAccumulateEvent, type SubscriptionAdapter, type SubscriptionClient, type SubscriptionConnectEvent, type SubscriptionConnectedEvent, type SubscriptionContext, type SubscriptionController, type SubscriptionDisconnectEvent, type SubscriptionErrorEvent, type SubscriptionHandle, type SubscriptionMessageEvent, type SubscriptionMethod, type SubscriptionPaths, type TagMode, type TagOptions, type Trace, type TraceColor, type TraceEvent, type TraceInfo, type TraceListener, type TraceOptions, type TraceStage, type Transport, type TransportName, type TransportOption, type TransportOptionsMap, type TransportResponse, type TypedPluginContext, type TypedPluginDefinition, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, type WriteSelectorClient, __DEV__, buildUrl, clone, composeAdapter, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createQueueController, createSelectorProxy, createSpooshPlugin, createStateManager, createSubscriptionController, createTracer, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateSelfTagFromKey, generateTags, getContentType, isAbortError, isJsonBody, isNetworkError, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, removeHeaderKeys, resolveHeadersToRecord, resolvePath, resolvePathString, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };
+export { type AnyMethod, type AnyRequestOptions, type ApiContext, type ApiPluginExecutor, type ApiResolvers, type ApiSchema, type BaseSubscriptionResponse, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type CreateSubscriptionControllerOptions, type DataAwareCallback, type DataAwareTransform, type DataChangeCallback, type DevtoolEvents, type EventEmitter, type EventListener, type EventOptions, type EventTracer, type ExecuteOptions, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type ExtractTriggerBody, type ExtractTriggerParams, type ExtractTriggerQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasSubscriptionMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteNextContext, type InfinitePage, type InfinitePageStatus, type InfinitePrevContext, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InfiniteTriggerOptions, type LifecyclePhase, type MergePluginApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextBase, type PluginContextExtensions, type PluginContextInput, type PluginExecutor, type PluginFactory, type PluginHandler, type PluginInternalRegistry, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type QueueController, type QueueControllerConfig, type QueueControllerContext, type QueueItem, type QueueItemStatus, type QueueSelectorClient, type QueueStats, type QueueTriggerInput, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestCompleteEvent, type RequestOptions$1 as RequestOptions, type RequestTracer, type ResolveApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, Semaphore, type SetupContext, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type SpooshSubscriptionMethodRegistry, type SpooshTransport, type SpooshTransportRegistry, type StandaloneEvent, type StateManager, type StripPrefix, type Subscriber, type SubscriptionAccumulateEvent, type SubscriptionAdapter, type SubscriptionClient, type SubscriptionConnectEvent, type SubscriptionConnectedEvent, type SubscriptionContext, type SubscriptionController, type SubscriptionDisconnectEvent, type SubscriptionErrorEvent, type SubscriptionHandle, type SubscriptionMessageEvent, type SubscriptionMethod, type SubscriptionPaths, type TagOptions, type Trace, type TraceColor, type TraceEvent, type TraceInfo, type TraceListener, type TraceOptions, type TraceStage, type Transport, type TransportName, type TransportOption, type TransportOptionsMap, type TransportResponse, type TypedPluginContext, type TypedPluginDefinition, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, type WriteSelectorClient, __DEV__, buildUrl, clone, composeAdapter, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createQueueController, createSelectorProxy, createSpooshPlugin, createStateManager, createSubscriptionController, createTracer, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateSelfTagFromKey, generateTags, generateUUID, getContentType, isAbortError, isJsonBody, isNetworkError, isSpooshBody, json, matchTag, matchTags, mergeHeaders, normalizeTag, objectToFormData, objectToUrlEncoded, removeHeaderKeys, resolveHeadersToRecord, resolvePath, resolvePathString, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };

package/dist/index.js

@@ -49,13 +49,17 @@ __export(src_exports, {
   form: () => form,
   generateSelfTagFromKey: () => generateSelfTagFromKey,
   generateTags: () => generateTags,
+  generateUUID: () => generateUUID,
   getContentType: () => getContentType,
   isAbortError: () => isAbortError,
   isJsonBody: () => isJsonBody,
   isNetworkError: () => isNetworkError,
   isSpooshBody: () => isSpooshBody,
   json: () => json,
+  matchTag: () => matchTag,
+  matchTags: () => matchTags,
   mergeHeaders: () => mergeHeaders,
+  normalizeTag: () => normalizeTag,
   objectToFormData: () => objectToFormData,
   objectToUrlEncoded: () => objectToUrlEncoded,
   removeHeaderKeys: () => removeHeaderKeys,
@@ -326,41 +330,38 @@ function resolveRequestBody(rawBody) {
   return { body: rawBody };
 }
 
-// src/utils/path-utils.ts
-function resolveTagMode(mode, path) {
-  switch (mode) {
-    case "all":
-      return generateTags(path);
-    case "self":
-      return [path.join("/")];
-    case "none":
-      return [];
+// src/utils/matchTag.ts
+function normalizeTag(tag) {
+  return tag.startsWith("/") ? tag.slice(1) : tag;
+}
+function matchTag(entryTag, pattern) {
+  const normalizedTag = normalizeTag(entryTag);
+  const normalizedPattern = normalizeTag(pattern);
+  if (normalizedPattern.endsWith("/*")) {
+    const prefix = normalizedPattern.slice(0, -2);
+    return prefix === "" ? normalizedTag.length > 0 : normalizedTag.startsWith(prefix + "/");
   }
+  return normalizedTag === normalizedPattern;
+}
+function matchTags(entryTag, patterns) {
+  return patterns.some((pattern) => matchTag(entryTag, pattern));
 }
+
+// src/utils/path-utils.ts
 function resolveTags(options, resolvedPath) {
   const tagsOption = options?.tags;
   if (!tagsOption) {
-    return generateTags(resolvedPath);
+    const tag2 = resolvedPath.join("/");
+    return tag2 ? [normalizeTag(tag2)] : [];
   }
   if (typeof tagsOption === "string") {
-    return resolveTagMode(tagsOption, resolvedPath);
+    return [normalizeTag(tagsOption)];
   }
   if (Array.isArray(tagsOption)) {
-    const tags = [];
-    let mode = null;
-    for (const item of tagsOption) {
-      if (item === "all" || item === "self") {
-        mode = item;
-      } else if (typeof item === "string") {
-        tags.push(item);
-      }
-    }
-    if (mode) {
-      tags.push(...resolveTagMode(mode, resolvedPath));
-    }
-    return [...new Set(tags)];
+    return [...new Set(tagsOption.map(normalizeTag))];
   }
-  return generateTags(resolvedPath);
+  const tag = resolvedPath.join("/");
+  return tag ? [normalizeTag(tag)] : [];
 }
 function resolvePath(path, params) {
   if (!params) return path;
@@ -442,6 +443,18 @@ function createTracer(plugin, trace) {
   };
 }
 
+// src/utils/uuid.ts
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+
 // src/transport/fetch.ts
 var fetchTransport = async (url, init) => {
   const res = await fetch(url, init);
@@ -856,19 +869,19 @@ function createStateManager() {
         }
       };
     },
-    getCacheByTags(tags) {
+    getCacheByTags(patterns) {
       for (const entry of cache.values()) {
-        const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+        const hasMatch = entry.tags.some((tag) => matchTags(tag, patterns));
         if (hasMatch && entry.state.data !== void 0) {
           return entry;
         }
       }
       return void 0;
     },
-    getCacheEntriesByTags(tags) {
+    getCacheEntriesByTags(patterns) {
       const entries = [];
       cache.forEach((entry, key) => {
-        const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+        const hasMatch = entry.tags.some((tag) => matchTags(tag, patterns));
         if (hasMatch) {
           entries.push({
             key,
@@ -907,9 +920,9 @@ function createStateManager() {
       entry.state = { ...entry.state };
       notifySubscribers(key);
     },
-    markStale(tags) {
+    markStale(patterns) {
       cache.forEach((entry) => {
-        const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+        const hasMatch = entry.tags.some((tag) => matchTags(tag, patterns));
         if (hasMatch) {
           entry.stale = true;
         }

package/dist/index.mjs

@@ -253,41 +253,38 @@ function resolveRequestBody(rawBody) {
   return { body: rawBody };
 }
 
-// src/utils/path-utils.ts
-function resolveTagMode(mode, path) {
-  switch (mode) {
-    case "all":
-      return generateTags(path);
-    case "self":
-      return [path.join("/")];
-    case "none":
-      return [];
+// src/utils/matchTag.ts
+function normalizeTag(tag) {
+  return tag.startsWith("/") ? tag.slice(1) : tag;
+}
+function matchTag(entryTag, pattern) {
+  const normalizedTag = normalizeTag(entryTag);
+  const normalizedPattern = normalizeTag(pattern);
+  if (normalizedPattern.endsWith("/*")) {
+    const prefix = normalizedPattern.slice(0, -2);
+    return prefix === "" ? normalizedTag.length > 0 : normalizedTag.startsWith(prefix + "/");
   }
+  return normalizedTag === normalizedPattern;
+}
+function matchTags(entryTag, patterns) {
+  return patterns.some((pattern) => matchTag(entryTag, pattern));
 }
+
+// src/utils/path-utils.ts
 function resolveTags(options, resolvedPath) {
   const tagsOption = options?.tags;
   if (!tagsOption) {
-    return generateTags(resolvedPath);
+    const tag2 = resolvedPath.join("/");
+    return tag2 ? [normalizeTag(tag2)] : [];
   }
   if (typeof tagsOption === "string") {
-    return resolveTagMode(tagsOption, resolvedPath);
+    return [normalizeTag(tagsOption)];
   }
   if (Array.isArray(tagsOption)) {
-    const tags = [];
-    let mode = null;
-    for (const item of tagsOption) {
-      if (item === "all" || item === "self") {
-        mode = item;
-      } else if (typeof item === "string") {
-        tags.push(item);
-      }
-    }
-    if (mode) {
-      tags.push(...resolveTagMode(mode, resolvedPath));
-    }
-    return [...new Set(tags)];
+    return [...new Set(tagsOption.map(normalizeTag))];
   }
-  return generateTags(resolvedPath);
+  const tag = resolvedPath.join("/");
+  return tag ? [normalizeTag(tag)] : [];
 }
 function resolvePath(path, params) {
   if (!params) return path;
@@ -369,6 +366,18 @@ function createTracer(plugin, trace) {
   };
 }
 
+// src/utils/uuid.ts
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+
 // src/transport/fetch.ts
 var fetchTransport = async (url, init) => {
   const res = await fetch(url, init);
@@ -783,19 +792,19 @@ function createStateManager() {
         }
       };
     },
-    getCacheByTags(tags) {
+    getCacheByTags(patterns) {
       for (const entry of cache.values()) {
-        const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+        const hasMatch = entry.tags.some((tag) => matchTags(tag, patterns));
         if (hasMatch && entry.state.data !== void 0) {
           return entry;
         }
       }
       return void 0;
     },
-    getCacheEntriesByTags(tags) {
+    getCacheEntriesByTags(patterns) {
       const entries = [];
       cache.forEach((entry, key) => {
-        const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+        const hasMatch = entry.tags.some((tag) => matchTags(tag, patterns));
         if (hasMatch) {
           entries.push({
             key,
@@ -834,9 +843,9 @@ function createStateManager() {
       entry.state = { ...entry.state };
       notifySubscribers(key);
     },
-    markStale(tags) {
+    markStale(patterns) {
       cache.forEach((entry) => {
-        const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+        const hasMatch = entry.tags.some((tag) => matchTags(tag, patterns));
         if (hasMatch) {
           entry.stale = true;
         }
@@ -2464,13 +2473,17 @@ export {
   form,
   generateSelfTagFromKey,
   generateTags,
+  generateUUID,
   getContentType,
   isAbortError,
   isJsonBody,
   isNetworkError,
   isSpooshBody,
   json,
+  matchTag,
+  matchTags,
   mergeHeaders,
+  normalizeTag,
   objectToFormData,
   objectToUrlEncoded,
   removeHeaderKeys,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/core",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "license": "MIT",
   "description": "Type-safe API toolkit with plugin middleware system",
   "keywords": [