@spoosh/core 0.11.1 → 0.12.1

package/README.md

@@ -164,7 +164,7 @@ import { Spoosh } from "@spoosh/core";
 import { cachePlugin } from "@spoosh/plugin-cache";
 import { retryPlugin } from "@spoosh/plugin-retry";
 
-const client = new Spoosh<ApiSchema, Error>("/api", {
+const spoosh = new Spoosh<ApiSchema, Error>("/api", {
   headers: { Authorization: "Bearer token" },
 }).use([cachePlugin({ staleTime: 5000 }), retryPlugin({ retries: 3 })]);
 

package/dist/index.d.mts

@@ -82,10 +82,6 @@ interface TransportOptionsMap {
     fetch: never;
 }
 
-type RetryConfig = {
-    retries?: number | false;
-    retryDelay?: number;
-};
 type HeadersInitOrGetter = HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
 type SpooshOptions = Omit<RequestInit, "method" | "body" | "headers"> & {
     headers?: HeadersInitOrGetter;
@@ -134,7 +130,7 @@ type AnyRequestOptions = BaseRequestOptions$1 & {
     transport?: TransportOption;
     /** Transport-specific options passed through to the transport function. */
     transportOptions?: unknown;
-} & Partial<RetryConfig>;
+};
 type DynamicParamsOption = {
     params?: Record<string, string | number>;
 };
@@ -270,7 +266,7 @@ type CacheEntry<TData = unknown, TError = unknown> = {
     stale?: boolean;
 };
 /** RequestOptions in plugin context have headers already resolved to Record */
-type PluginRequestOptions = Omit<AnyRequestOptions, "headers"> & {
+type PluginRequestOptions = Omit<AnyRequestOptions, "headers" | "cache"> & {
     headers: Record<string, string>;
 };
 type PluginContext = {
@@ -279,13 +275,16 @@ type PluginContext = {
     readonly method: HttpMethod;
     readonly queryKey: string;
     readonly tags: string[];
-    /** Timestamp when this request was initiated. Useful for tracing and debugging. */
     readonly requestTimestamp: number;
-    /** Unique identifier for the hook instance. Persists across queryKey changes within the same hook. */
-    readonly hookId?: string;
+    /** Unique identifier for this usage instance. Persists across queryKey changes. */
+    readonly instanceId?: string;
+    /** Request options with resolved headers. Modify to customize the request (e.g., add headers, signal, body). */
     request: PluginRequestOptions;
+    /** Temporary storage for inter-plugin communication during a single request lifecycle. Data stored here doesn't persist beyond the request. */
     temp: Map<string, unknown>;
+    /** State manager for accessing and modifying cache entries. */
     stateManager: StateManager;
+    /** Event emitter for triggering refetch, invalidation, and other events. */
     eventEmitter: EventEmitter;
     /** Access other plugins' exported APIs */
     plugins: PluginAccessor;
@@ -315,12 +314,9 @@ type PluginContextInput = Omit<PluginContext, "plugins">;
  *   return next();
  * }
  *
- * // Retry middleware - wrap and retry on error
+ * // Auth middleware - add authentication headers
  * middleware: async (context, next) => {
- *   for (let i = 0; i < 3; i++) {
- *     const result = await next();
- *     if (!result.error) return result;
- *   }
+ *   context.request.headers['Authorization'] = `Bearer ${getToken()}`;
  *   return next();
  * }
  * ```
@@ -376,7 +372,7 @@ type PluginTypeConfig = {
  * Base interface for Spoosh plugins.
  *
  * Plugins can implement:
- * - `middleware`: Wraps the fetch flow for full control (intercept, retry, transform)
+ * - `middleware`: Wraps the fetch flow for full control (intercept, transform, modify)
  * - `afterResponse`: Called after every response, regardless of early returns
  * - `lifecycle`: Component lifecycle hooks (onMount, onUpdate, onUnmount)
  * - `exports`: Functions/variables accessible to other plugins
@@ -424,7 +420,7 @@ interface SpooshPlugin<T extends PluginTypeConfig = PluginTypeConfig> {
     /** Expose functions/variables for other plugins to access via `context.plugins.get(name)` */
     exports?: (context: PluginContext) => object;
     /**
-     * Expose functions/properties on the framework adapter return value (e.g., createReactSpoosh).
+     * Expose functions/properties on the framework adapter return value (e.g., create).
      * Unlike `exports`, these are accessible directly from the instance, not just within plugin context.
      *
      * @example
@@ -438,7 +434,37 @@ interface SpooshPlugin<T extends PluginTypeConfig = PluginTypeConfig> {
     instanceApi?: (context: InstanceApiContext) => T extends {
         instanceApi: infer A;
     } ? A : object;
-    /** Declare plugin dependencies. These plugins must be registered before this one. */
+    /**
+     * Plugin execution priority. Lower numbers run first, higher numbers run last.
+     * Default: 0
+     *
+     * @example
+     * ```ts
+     * // Cache plugin runs early (checks cache before other plugins)
+     * { name: "cache", priority: -10, ... }
+     *
+     * // Throttle plugin runs last (blocks all requests including force fetches)
+     * { name: "throttle", priority: 100, ... }
+     *
+     * // Most plugins use default priority
+     * { name: "retry", priority: 0, ... } // or omit priority
+     * ```
+     */
+    priority?: number;
+    /**
+     * List of plugin names that this plugin depends on.
+     * Used to validate that required plugins are registered.
+     * Does not affect execution order - use `priority` for that.
+     *
+     * @example
+     * ```ts
+     * {
+     *   name: "spoosh:optimistic",
+     *   dependencies: ["spoosh:invalidation"],
+     *   // ...
+     * }
+     * ```
+     */
     dependencies?: string[];
     /** @internal Type carrier for inference - do not use directly */
     readonly _types?: T;
@@ -1129,8 +1155,8 @@ type SpooshInstance<TSchema = unknown, TDefaultError = unknown, TPlugins extends
  *
  * @example Basic usage
  * ```ts
- * const client = new Spoosh<ApiSchema, Error>('/api')
- *   .use([cachePlugin(), retryPlugin()]);
+ * const spoosh = new Spoosh<ApiSchema, Error>('/api')
+ *   .use([cachePlugin(), debugPlugin()]);
  *
  * const { api } = client;
  * const response = await api("posts").GET();
@@ -1138,19 +1164,19 @@ type SpooshInstance<TSchema = unknown, TDefaultError = unknown, TPlugins extends
  *
  * @example With default options
  * ```ts
- * const client = new Spoosh<ApiSchema, Error>('/api', {
+ * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
  *   headers: { 'Authorization': 'Bearer token' }
  * }).use([cachePlugin()]);
  * ```
  *
  * @example With React hooks
  * ```ts
- * import { createReactSpoosh } from '@spoosh/react';
+ * import { create } from '@spoosh/react';
  *
- * const client = new Spoosh<ApiSchema, Error>('/api')
- *   .use([cachePlugin(), retryPlugin()]);
+ * const spoosh = new Spoosh<ApiSchema, Error>('/api')
+ *   .use([cachePlugin(), prefetchPlugin()]);
  *
- * const { useRead, useWrite } = createReactSpoosh(client);
+ * const { useRead, useWrite } = create(client);
  *
  * // In component
  * const { data } = useRead((api) => api("posts").GET());
@@ -1173,15 +1199,15 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      * @example
      * ```ts
      * // Simple usage
-     * const client = new Spoosh<ApiSchema, Error>('/api');
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api');
      *
      * // With default headers
-     * const client = new Spoosh<ApiSchema, Error>('/api', {
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
      *   headers: { 'X-API-Key': 'secret' }
      * });
      *
      * // With XHR transport (narrows available options to XHR-compatible fields)
-     * const client = new Spoosh<ApiSchema, Error>('/api', {
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
      *   transport: 'xhr',
      *   credentials: 'include',
      * });
@@ -1198,26 +1224,10 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      * @param plugins - Array of plugin instances to use
      * @returns A new Spoosh instance with the specified plugins
      *
-     * @example Single use() call
-     * ```ts
-     * const client = new Spoosh<Schema, Error>('/api')
-     *   .use([cachePlugin(), retryPlugin(), debouncePlugin()]);
-     * ```
-     *
-     * @example Chaining use() calls (replaces plugins)
-     * ```ts
-     * const client1 = new Spoosh<Schema, Error>('/api')
-     *   .use([cachePlugin()]);
-     *
-     * // This replaces cachePlugin with retryPlugin
-     * const client2 = client1.use([retryPlugin()]);
-     * ```
-     *
-     * @example With plugin configuration
      * ```ts
-     * const client = new Spoosh<Schema, Error>('/api').use([
+     * const spoosh = new Spoosh<Schema, Error>('/api').use([
      *   cachePlugin({ staleTime: 5000 }),
-     *   retryPlugin({ retries: 3, retryDelay: 1000 }),
+     *   invalidationPlugin(),
      *   prefetchPlugin(),
      * ]);
      * ```
@@ -1242,7 +1252,7 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      *
      * @example
      * ```ts
-     * const client = new Spoosh<ApiSchema, Error>('/api').use([...]);
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api').use([...]);
      * const { api } = client;
      *
      * // GET request
@@ -1433,6 +1443,9 @@ type TagOptions = {
 declare function resolveTags(options: TagOptions | undefined, resolvedPath: string[]): string[];
 declare function resolvePath(path: string[], params: Record<string, string | number> | undefined): string[];
 
+declare const isNetworkError: (err: unknown) => boolean;
+declare const isAbortError: (err: unknown) => boolean;
+
 type ProxyHandlerConfig<TOptions = SpooshOptions> = {
     baseUrl: string;
     defaultOptions: TOptions;
@@ -1610,7 +1623,7 @@ type CreateOperationOptions<TData, TError> = {
     pluginExecutor: PluginExecutor;
     fetchFn: (options: AnyRequestOptions) => Promise<SpooshResponse<TData, TError>>;
     /** Unique identifier for the hook instance. Persists across queryKey changes. */
-    hookId?: string;
+    instanceId?: string;
 };
 declare function createOperationController<TData, TError>(options: CreateOperationOptions<TData, TError>): OperationController<TData, TError>;
 
@@ -1663,8 +1676,8 @@ type CreateInfiniteReadOptions<TData, TItem, TError, TRequest> = {
     pluginExecutor: PluginExecutor;
     fetchFn: (options: InfiniteRequestOptions, signal: AbortSignal) => Promise<SpooshResponse<TData, TError>>;
     /** Unique identifier for the hook instance. Persists across queryKey changes. */
-    hookId?: string;
+    instanceId?: string;
 };
 declare function createInfiniteReadController<TData, TItem, TError, TRequest extends InfiniteRequestOptions = InfiniteRequestOptions>(options: CreateInfiniteReadOptions<TData, TItem, TError, TRequest>): InfiniteReadController<TData, TItem, TError>;
 
-export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type RetryConfig, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type StripPrefix, type TagMode, type TagOptions, type Transport, type TransportOption, type TransportOptionsMap, type TransportResponse, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, __DEV__, buildUrl, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateTags, getContentType, isJsonBody, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };
+export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type StripPrefix, type TagMode, type TagOptions, type Transport, type TransportOption, type TransportOptionsMap, type TransportResponse, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, __DEV__, buildUrl, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateTags, getContentType, isAbortError, isJsonBody, isNetworkError, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };

package/dist/index.d.ts

@@ -82,10 +82,6 @@ interface TransportOptionsMap {
     fetch: never;
 }
 
-type RetryConfig = {
-    retries?: number | false;
-    retryDelay?: number;
-};
 type HeadersInitOrGetter = HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
 type SpooshOptions = Omit<RequestInit, "method" | "body" | "headers"> & {
     headers?: HeadersInitOrGetter;
@@ -134,7 +130,7 @@ type AnyRequestOptions = BaseRequestOptions$1 & {
     transport?: TransportOption;
     /** Transport-specific options passed through to the transport function. */
     transportOptions?: unknown;
-} & Partial<RetryConfig>;
+};
 type DynamicParamsOption = {
     params?: Record<string, string | number>;
 };
@@ -270,7 +266,7 @@ type CacheEntry<TData = unknown, TError = unknown> = {
     stale?: boolean;
 };
 /** RequestOptions in plugin context have headers already resolved to Record */
-type PluginRequestOptions = Omit<AnyRequestOptions, "headers"> & {
+type PluginRequestOptions = Omit<AnyRequestOptions, "headers" | "cache"> & {
     headers: Record<string, string>;
 };
 type PluginContext = {
@@ -279,13 +275,16 @@ type PluginContext = {
     readonly method: HttpMethod;
     readonly queryKey: string;
     readonly tags: string[];
-    /** Timestamp when this request was initiated. Useful for tracing and debugging. */
     readonly requestTimestamp: number;
-    /** Unique identifier for the hook instance. Persists across queryKey changes within the same hook. */
-    readonly hookId?: string;
+    /** Unique identifier for this usage instance. Persists across queryKey changes. */
+    readonly instanceId?: string;
+    /** Request options with resolved headers. Modify to customize the request (e.g., add headers, signal, body). */
     request: PluginRequestOptions;
+    /** Temporary storage for inter-plugin communication during a single request lifecycle. Data stored here doesn't persist beyond the request. */
     temp: Map<string, unknown>;
+    /** State manager for accessing and modifying cache entries. */
     stateManager: StateManager;
+    /** Event emitter for triggering refetch, invalidation, and other events. */
     eventEmitter: EventEmitter;
     /** Access other plugins' exported APIs */
     plugins: PluginAccessor;
@@ -315,12 +314,9 @@ type PluginContextInput = Omit<PluginContext, "plugins">;
  *   return next();
  * }
  *
- * // Retry middleware - wrap and retry on error
+ * // Auth middleware - add authentication headers
  * middleware: async (context, next) => {
- *   for (let i = 0; i < 3; i++) {
- *     const result = await next();
- *     if (!result.error) return result;
- *   }
+ *   context.request.headers['Authorization'] = `Bearer ${getToken()}`;
  *   return next();
  * }
  * ```
@@ -376,7 +372,7 @@ type PluginTypeConfig = {
  * Base interface for Spoosh plugins.
  *
  * Plugins can implement:
- * - `middleware`: Wraps the fetch flow for full control (intercept, retry, transform)
+ * - `middleware`: Wraps the fetch flow for full control (intercept, transform, modify)
  * - `afterResponse`: Called after every response, regardless of early returns
  * - `lifecycle`: Component lifecycle hooks (onMount, onUpdate, onUnmount)
  * - `exports`: Functions/variables accessible to other plugins
@@ -424,7 +420,7 @@ interface SpooshPlugin<T extends PluginTypeConfig = PluginTypeConfig> {
     /** Expose functions/variables for other plugins to access via `context.plugins.get(name)` */
     exports?: (context: PluginContext) => object;
     /**
-     * Expose functions/properties on the framework adapter return value (e.g., createReactSpoosh).
+     * Expose functions/properties on the framework adapter return value (e.g., create).
      * Unlike `exports`, these are accessible directly from the instance, not just within plugin context.
      *
      * @example
@@ -438,7 +434,37 @@ interface SpooshPlugin<T extends PluginTypeConfig = PluginTypeConfig> {
     instanceApi?: (context: InstanceApiContext) => T extends {
         instanceApi: infer A;
     } ? A : object;
-    /** Declare plugin dependencies. These plugins must be registered before this one. */
+    /**
+     * Plugin execution priority. Lower numbers run first, higher numbers run last.
+     * Default: 0
+     *
+     * @example
+     * ```ts
+     * // Cache plugin runs early (checks cache before other plugins)
+     * { name: "cache", priority: -10, ... }
+     *
+     * // Throttle plugin runs last (blocks all requests including force fetches)
+     * { name: "throttle", priority: 100, ... }
+     *
+     * // Most plugins use default priority
+     * { name: "retry", priority: 0, ... } // or omit priority
+     * ```
+     */
+    priority?: number;
+    /**
+     * List of plugin names that this plugin depends on.
+     * Used to validate that required plugins are registered.
+     * Does not affect execution order - use `priority` for that.
+     *
+     * @example
+     * ```ts
+     * {
+     *   name: "spoosh:optimistic",
+     *   dependencies: ["spoosh:invalidation"],
+     *   // ...
+     * }
+     * ```
+     */
     dependencies?: string[];
     /** @internal Type carrier for inference - do not use directly */
     readonly _types?: T;
@@ -1129,8 +1155,8 @@ type SpooshInstance<TSchema = unknown, TDefaultError = unknown, TPlugins extends
  *
  * @example Basic usage
  * ```ts
- * const client = new Spoosh<ApiSchema, Error>('/api')
- *   .use([cachePlugin(), retryPlugin()]);
+ * const spoosh = new Spoosh<ApiSchema, Error>('/api')
+ *   .use([cachePlugin(), debugPlugin()]);
  *
  * const { api } = client;
  * const response = await api("posts").GET();
@@ -1138,19 +1164,19 @@ type SpooshInstance<TSchema = unknown, TDefaultError = unknown, TPlugins extends
  *
  * @example With default options
  * ```ts
- * const client = new Spoosh<ApiSchema, Error>('/api', {
+ * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
  *   headers: { 'Authorization': 'Bearer token' }
  * }).use([cachePlugin()]);
  * ```
  *
  * @example With React hooks
  * ```ts
- * import { createReactSpoosh } from '@spoosh/react';
+ * import { create } from '@spoosh/react';
  *
- * const client = new Spoosh<ApiSchema, Error>('/api')
- *   .use([cachePlugin(), retryPlugin()]);
+ * const spoosh = new Spoosh<ApiSchema, Error>('/api')
+ *   .use([cachePlugin(), prefetchPlugin()]);
  *
- * const { useRead, useWrite } = createReactSpoosh(client);
+ * const { useRead, useWrite } = create(client);
  *
  * // In component
  * const { data } = useRead((api) => api("posts").GET());
@@ -1173,15 +1199,15 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      * @example
      * ```ts
      * // Simple usage
-     * const client = new Spoosh<ApiSchema, Error>('/api');
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api');
      *
      * // With default headers
-     * const client = new Spoosh<ApiSchema, Error>('/api', {
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
      *   headers: { 'X-API-Key': 'secret' }
      * });
      *
      * // With XHR transport (narrows available options to XHR-compatible fields)
-     * const client = new Spoosh<ApiSchema, Error>('/api', {
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
      *   transport: 'xhr',
      *   credentials: 'include',
      * });
@@ -1198,26 +1224,10 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      * @param plugins - Array of plugin instances to use
      * @returns A new Spoosh instance with the specified plugins
      *
-     * @example Single use() call
-     * ```ts
-     * const client = new Spoosh<Schema, Error>('/api')
-     *   .use([cachePlugin(), retryPlugin(), debouncePlugin()]);
-     * ```
-     *
-     * @example Chaining use() calls (replaces plugins)
-     * ```ts
-     * const client1 = new Spoosh<Schema, Error>('/api')
-     *   .use([cachePlugin()]);
-     *
-     * // This replaces cachePlugin with retryPlugin
-     * const client2 = client1.use([retryPlugin()]);
-     * ```
-     *
-     * @example With plugin configuration
      * ```ts
-     * const client = new Spoosh<Schema, Error>('/api').use([
+     * const spoosh = new Spoosh<Schema, Error>('/api').use([
      *   cachePlugin({ staleTime: 5000 }),
-     *   retryPlugin({ retries: 3, retryDelay: 1000 }),
+     *   invalidationPlugin(),
      *   prefetchPlugin(),
      * ]);
      * ```
@@ -1242,7 +1252,7 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      *
      * @example
      * ```ts
-     * const client = new Spoosh<ApiSchema, Error>('/api').use([...]);
+     * const spoosh = new Spoosh<ApiSchema, Error>('/api').use([...]);
      * const { api } = client;
      *
      * // GET request
@@ -1433,6 +1443,9 @@ type TagOptions = {
 declare function resolveTags(options: TagOptions | undefined, resolvedPath: string[]): string[];
 declare function resolvePath(path: string[], params: Record<string, string | number> | undefined): string[];
 
+declare const isNetworkError: (err: unknown) => boolean;
+declare const isAbortError: (err: unknown) => boolean;
+
 type ProxyHandlerConfig<TOptions = SpooshOptions> = {
     baseUrl: string;
     defaultOptions: TOptions;
@@ -1610,7 +1623,7 @@ type CreateOperationOptions<TData, TError> = {
     pluginExecutor: PluginExecutor;
     fetchFn: (options: AnyRequestOptions) => Promise<SpooshResponse<TData, TError>>;
     /** Unique identifier for the hook instance. Persists across queryKey changes. */
-    hookId?: string;
+    instanceId?: string;
 };
 declare function createOperationController<TData, TError>(options: CreateOperationOptions<TData, TError>): OperationController<TData, TError>;
 
@@ -1663,8 +1676,8 @@ type CreateInfiniteReadOptions<TData, TItem, TError, TRequest> = {
     pluginExecutor: PluginExecutor;
     fetchFn: (options: InfiniteRequestOptions, signal: AbortSignal) => Promise<SpooshResponse<TData, TError>>;
     /** Unique identifier for the hook instance. Persists across queryKey changes. */
-    hookId?: string;
+    instanceId?: string;
 };
 declare function createInfiniteReadController<TData, TItem, TError, TRequest extends InfiniteRequestOptions = InfiniteRequestOptions>(options: CreateInfiniteReadOptions<TData, TItem, TError, TRequest>): InfiniteReadController<TData, TItem, TError>;
 
-export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type RetryConfig, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type StripPrefix, type TagMode, type TagOptions, type Transport, type TransportOption, type TransportOptionsMap, type TransportResponse, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, __DEV__, buildUrl, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateTags, getContentType, isJsonBody, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };
+export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginRequestOptions, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshOptions, type SpooshOptionsInput, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type StripPrefix, type TagMode, type TagOptions, type Transport, type TransportOption, type TransportOptionsMap, type TransportResponse, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, __DEV__, buildUrl, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, fetchTransport, form, generateTags, getContentType, isAbortError, isJsonBody, isNetworkError, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded, xhrTransport };

package/dist/index.js

@@ -42,7 +42,9 @@ __export(src_exports, {
   form: () => form,
   generateTags: () => generateTags,
   getContentType: () => getContentType,
+  isAbortError: () => isAbortError,
   isJsonBody: () => isJsonBody,
+  isNetworkError: () => isNetworkError,
   isSpooshBody: () => isSpooshBody,
   json: () => json,
   mergeHeaders: () => mergeHeaders,
@@ -352,6 +354,10 @@ function resolvePath(path, params) {
   });
 }
 
+// src/utils/errors.ts
+var isNetworkError = (err) => err instanceof TypeError;
+var isAbortError = (err) => err instanceof DOMException && err.name === "AbortError";
+
 // src/transport/fetch.ts
 var fetchTransport = async (url, init) => {
   const res = await fetch(url, init);
@@ -434,9 +440,6 @@ var xhrTransport = (url, init, options) => {
 };
 
 // src/fetch.ts
-var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-var isNetworkError = (err) => err instanceof TypeError;
-var isAbortError = (err) => err instanceof DOMException && err.name === "AbortError";
 async function executeFetch(baseUrl, path, method, defaultOptions, requestOptions, nextTags) {
   return executeCoreFetch({
     baseUrl,
@@ -486,9 +489,6 @@ async function executeCoreFetch(config) {
     ...fetchDefaults
   } = defaultOptions;
   const inputFields = buildInputFields(requestOptions);
-  const maxRetries = requestOptions?.retries ?? 3;
-  const baseDelay = requestOptions?.retryDelay ?? 1e3;
-  const retryCount = maxRetries === false ? 0 : maxRetries;
   const finalPath = path;
   const url = buildUrl(baseUrl, finalPath, requestOptions?.query);
   let headers = await mergeHeaders(defaultHeaders, requestOptions?.headers);
@@ -529,50 +529,40 @@ async function executeCoreFetch(config) {
   const resolvedTransport = resolveTransport(
     requestOptions?.transport ?? defaultTransport
   );
-  let lastError;
-  for (let attempt = 0; attempt <= retryCount; attempt++) {
-    try {
-      const result = await resolvedTransport(
-        url,
-        fetchInit,
-        requestOptions?.transportOptions
-      );
-      if (result.ok) {
-        return {
-          status: result.status,
-          data: result.data,
-          headers: result.headers,
-          error: void 0,
-          ...inputFields
-        };
-      }
+  try {
+    const result = await resolvedTransport(
+      url,
+      fetchInit,
+      requestOptions?.transportOptions
+    );
+    if (result.ok) {
       return {
         status: result.status,
-        error: result.data,
+        data: result.data,
         headers: result.headers,
+        error: void 0,
+        ...inputFields
+      };
+    }
+    return {
+      status: result.status,
+      error: result.data,
+      headers: result.headers,
+      data: void 0,
+      ...inputFields
+    };
+  } catch (err) {
+    if (isAbortError(err)) {
+      return {
+        status: 0,
+        error: err,
         data: void 0,
+        aborted: true,
         ...inputFields
       };
-    } catch (err) {
-      if (isAbortError(err)) {
-        return {
-          status: 0,
-          error: err,
-          data: void 0,
-          aborted: true,
-          ...inputFields
-        };
-      }
-      lastError = err;
-      if (isNetworkError(err) && attempt < retryCount) {
-        const delayMs = baseDelay * Math.pow(2, attempt);
-        await delay(delayMs);
-        continue;
-      }
-      return { status: 0, error: lastError, data: void 0, ...inputFields };
     }
+    return { status: 0, error: err, data: void 0, ...inputFields };
   }
-  return { status: 0, error: lastError, data: void 0, ...inputFields };
 }
 
 // src/proxy/handler.ts
@@ -865,46 +855,29 @@ function createEventEmitter() {
 
 // src/plugins/executor.ts
 function validateDependencies(plugins) {
-  const names = new Set(plugins.map((p) => p.name));
+  const pluginNames = new Set(plugins.map((p) => p.name));
   for (const plugin of plugins) {
-    for (const dep of plugin.dependencies ?? []) {
-      if (!names.has(dep)) {
-        throw new Error(
-          `Plugin "${plugin.name}" depends on "${dep}" which is not registered`
-        );
+    if (plugin.dependencies) {
+      for (const dep of plugin.dependencies) {
+        if (!pluginNames.has(dep)) {
+          throw new Error(
+            `Plugin "${plugin.name}" depends on "${dep}", but "${dep}" is not registered.`
+          );
+        }
       }
     }
   }
 }
-function sortByDependencies(plugins) {
-  const sorted = [];
-  const visited = /* @__PURE__ */ new Set();
-  const visiting = /* @__PURE__ */ new Set();
-  const pluginMap = new Map(plugins.map((p) => [p.name, p]));
-  function visit(plugin) {
-    if (visited.has(plugin.name)) return;
-    if (visiting.has(plugin.name)) {
-      throw new Error(
-        `Circular dependency detected involving "${plugin.name}"`
-      );
-    }
-    visiting.add(plugin.name);
-    for (const dep of plugin.dependencies ?? []) {
-      const depPlugin = pluginMap.get(dep);
-      if (depPlugin) visit(depPlugin);
-    }
-    visiting.delete(plugin.name);
-    visited.add(plugin.name);
-    sorted.push(plugin);
-  }
-  for (const plugin of plugins) {
-    visit(plugin);
-  }
-  return sorted;
+function sortByPriority(plugins) {
+  return [...plugins].sort((a, b) => {
+    const priorityA = a.priority ?? 0;
+    const priorityB = b.priority ?? 0;
+    return priorityA - priorityB;
+  });
 }
 function createPluginExecutor(initialPlugins = []) {
   validateDependencies(initialPlugins);
-  const plugins = sortByDependencies(initialPlugins);
+  const plugins = sortByPriority(initialPlugins);
   const frozenPlugins = Object.freeze([...plugins]);
   const createPluginAccessor = (context) => ({
     get(name) {
@@ -1007,15 +980,15 @@ var Spoosh = class _Spoosh {
    * @example
    * ```ts
    * // Simple usage
-   * const client = new Spoosh<ApiSchema, Error>('/api');
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api');
    *
    * // With default headers
-   * const client = new Spoosh<ApiSchema, Error>('/api', {
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
    *   headers: { 'X-API-Key': 'secret' }
    * });
    *
    * // With XHR transport (narrows available options to XHR-compatible fields)
-   * const client = new Spoosh<ApiSchema, Error>('/api', {
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
    *   transport: 'xhr',
    *   credentials: 'include',
    * });
@@ -1036,26 +1009,10 @@ var Spoosh = class _Spoosh {
    * @param plugins - Array of plugin instances to use
    * @returns A new Spoosh instance with the specified plugins
    *
-   * @example Single use() call
-   * ```ts
-   * const client = new Spoosh<Schema, Error>('/api')
-   *   .use([cachePlugin(), retryPlugin(), debouncePlugin()]);
-   * ```
-   *
-   * @example Chaining use() calls (replaces plugins)
-   * ```ts
-   * const client1 = new Spoosh<Schema, Error>('/api')
-   *   .use([cachePlugin()]);
-   *
-   * // This replaces cachePlugin with retryPlugin
-   * const client2 = client1.use([retryPlugin()]);
-   * ```
-   *
-   * @example With plugin configuration
    * ```ts
-   * const client = new Spoosh<Schema, Error>('/api').use([
+   * const spoosh = new Spoosh<Schema, Error>('/api').use([
    *   cachePlugin({ staleTime: 5000 }),
-   *   retryPlugin({ retries: 3, retryDelay: 1000 }),
+   *   invalidationPlugin(),
    *   prefetchPlugin(),
    * ]);
    * ```
@@ -1112,7 +1069,7 @@ var Spoosh = class _Spoosh {
    *
    * @example
    * ```ts
-   * const client = new Spoosh<ApiSchema, Error>('/api').use([...]);
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api').use([...]);
    * const { api } = client;
    *
    * // GET request
@@ -1232,7 +1189,7 @@ function createOperationController(options) {
     eventEmitter,
     pluginExecutor,
     fetchFn,
-    hookId
+    instanceId
   } = options;
   const queryKey = stateManager.createQueryKey({
     path,
@@ -1255,7 +1212,7 @@ function createOperationController(options) {
       queryKey,
       tags: resolvedTags,
       requestTimestamp,
-      hookId,
+      instanceId,
       request: {
         ...initialRequestOptions,
         ...requestOptions,
@@ -1450,7 +1407,7 @@ function createInfiniteReadController(options) {
     eventEmitter,
     pluginExecutor,
     fetchFn,
-    hookId
+    instanceId
   } = options;
   let pageKeys = [];
   let pageRequests = /* @__PURE__ */ new Map();
@@ -1550,7 +1507,7 @@ function createInfiniteReadController(options) {
       queryKey: pageKey,
       tags,
       requestTimestamp: Date.now(),
-      hookId,
+      instanceId,
       request: { headers: {} },
       temp: /* @__PURE__ */ new Map(),
       pluginOptions,

package/dist/index.mjs

@@ -291,6 +291,10 @@ function resolvePath(path, params) {
   });
 }
 
+// src/utils/errors.ts
+var isNetworkError = (err) => err instanceof TypeError;
+var isAbortError = (err) => err instanceof DOMException && err.name === "AbortError";
+
 // src/transport/fetch.ts
 var fetchTransport = async (url, init) => {
   const res = await fetch(url, init);
@@ -373,9 +377,6 @@ var xhrTransport = (url, init, options) => {
 };
 
 // src/fetch.ts
-var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-var isNetworkError = (err) => err instanceof TypeError;
-var isAbortError = (err) => err instanceof DOMException && err.name === "AbortError";
 async function executeFetch(baseUrl, path, method, defaultOptions, requestOptions, nextTags) {
   return executeCoreFetch({
     baseUrl,
@@ -425,9 +426,6 @@ async function executeCoreFetch(config) {
     ...fetchDefaults
   } = defaultOptions;
   const inputFields = buildInputFields(requestOptions);
-  const maxRetries = requestOptions?.retries ?? 3;
-  const baseDelay = requestOptions?.retryDelay ?? 1e3;
-  const retryCount = maxRetries === false ? 0 : maxRetries;
   const finalPath = path;
   const url = buildUrl(baseUrl, finalPath, requestOptions?.query);
   let headers = await mergeHeaders(defaultHeaders, requestOptions?.headers);
@@ -468,50 +466,40 @@ async function executeCoreFetch(config) {
   const resolvedTransport = resolveTransport(
     requestOptions?.transport ?? defaultTransport
   );
-  let lastError;
-  for (let attempt = 0; attempt <= retryCount; attempt++) {
-    try {
-      const result = await resolvedTransport(
-        url,
-        fetchInit,
-        requestOptions?.transportOptions
-      );
-      if (result.ok) {
-        return {
-          status: result.status,
-          data: result.data,
-          headers: result.headers,
-          error: void 0,
-          ...inputFields
-        };
-      }
+  try {
+    const result = await resolvedTransport(
+      url,
+      fetchInit,
+      requestOptions?.transportOptions
+    );
+    if (result.ok) {
       return {
         status: result.status,
-        error: result.data,
+        data: result.data,
         headers: result.headers,
+        error: void 0,
+        ...inputFields
+      };
+    }
+    return {
+      status: result.status,
+      error: result.data,
+      headers: result.headers,
+      data: void 0,
+      ...inputFields
+    };
+  } catch (err) {
+    if (isAbortError(err)) {
+      return {
+        status: 0,
+        error: err,
         data: void 0,
+        aborted: true,
         ...inputFields
       };
-    } catch (err) {
-      if (isAbortError(err)) {
-        return {
-          status: 0,
-          error: err,
-          data: void 0,
-          aborted: true,
-          ...inputFields
-        };
-      }
-      lastError = err;
-      if (isNetworkError(err) && attempt < retryCount) {
-        const delayMs = baseDelay * Math.pow(2, attempt);
-        await delay(delayMs);
-        continue;
-      }
-      return { status: 0, error: lastError, data: void 0, ...inputFields };
     }
+    return { status: 0, error: err, data: void 0, ...inputFields };
   }
-  return { status: 0, error: lastError, data: void 0, ...inputFields };
 }
 
 // src/proxy/handler.ts
@@ -804,46 +792,29 @@ function createEventEmitter() {
 
 // src/plugins/executor.ts
 function validateDependencies(plugins) {
-  const names = new Set(plugins.map((p) => p.name));
+  const pluginNames = new Set(plugins.map((p) => p.name));
   for (const plugin of plugins) {
-    for (const dep of plugin.dependencies ?? []) {
-      if (!names.has(dep)) {
-        throw new Error(
-          `Plugin "${plugin.name}" depends on "${dep}" which is not registered`
-        );
+    if (plugin.dependencies) {
+      for (const dep of plugin.dependencies) {
+        if (!pluginNames.has(dep)) {
+          throw new Error(
+            `Plugin "${plugin.name}" depends on "${dep}", but "${dep}" is not registered.`
+          );
+        }
       }
     }
   }
 }
-function sortByDependencies(plugins) {
-  const sorted = [];
-  const visited = /* @__PURE__ */ new Set();
-  const visiting = /* @__PURE__ */ new Set();
-  const pluginMap = new Map(plugins.map((p) => [p.name, p]));
-  function visit(plugin) {
-    if (visited.has(plugin.name)) return;
-    if (visiting.has(plugin.name)) {
-      throw new Error(
-        `Circular dependency detected involving "${plugin.name}"`
-      );
-    }
-    visiting.add(plugin.name);
-    for (const dep of plugin.dependencies ?? []) {
-      const depPlugin = pluginMap.get(dep);
-      if (depPlugin) visit(depPlugin);
-    }
-    visiting.delete(plugin.name);
-    visited.add(plugin.name);
-    sorted.push(plugin);
-  }
-  for (const plugin of plugins) {
-    visit(plugin);
-  }
-  return sorted;
+function sortByPriority(plugins) {
+  return [...plugins].sort((a, b) => {
+    const priorityA = a.priority ?? 0;
+    const priorityB = b.priority ?? 0;
+    return priorityA - priorityB;
+  });
 }
 function createPluginExecutor(initialPlugins = []) {
   validateDependencies(initialPlugins);
-  const plugins = sortByDependencies(initialPlugins);
+  const plugins = sortByPriority(initialPlugins);
   const frozenPlugins = Object.freeze([...plugins]);
   const createPluginAccessor = (context) => ({
     get(name) {
@@ -946,15 +917,15 @@ var Spoosh = class _Spoosh {
    * @example
    * ```ts
    * // Simple usage
-   * const client = new Spoosh<ApiSchema, Error>('/api');
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api');
    *
    * // With default headers
-   * const client = new Spoosh<ApiSchema, Error>('/api', {
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
    *   headers: { 'X-API-Key': 'secret' }
    * });
    *
    * // With XHR transport (narrows available options to XHR-compatible fields)
-   * const client = new Spoosh<ApiSchema, Error>('/api', {
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api', {
    *   transport: 'xhr',
    *   credentials: 'include',
    * });
@@ -975,26 +946,10 @@ var Spoosh = class _Spoosh {
    * @param plugins - Array of plugin instances to use
    * @returns A new Spoosh instance with the specified plugins
    *
-   * @example Single use() call
-   * ```ts
-   * const client = new Spoosh<Schema, Error>('/api')
-   *   .use([cachePlugin(), retryPlugin(), debouncePlugin()]);
-   * ```
-   *
-   * @example Chaining use() calls (replaces plugins)
-   * ```ts
-   * const client1 = new Spoosh<Schema, Error>('/api')
-   *   .use([cachePlugin()]);
-   *
-   * // This replaces cachePlugin with retryPlugin
-   * const client2 = client1.use([retryPlugin()]);
-   * ```
-   *
-   * @example With plugin configuration
    * ```ts
-   * const client = new Spoosh<Schema, Error>('/api').use([
+   * const spoosh = new Spoosh<Schema, Error>('/api').use([
    *   cachePlugin({ staleTime: 5000 }),
-   *   retryPlugin({ retries: 3, retryDelay: 1000 }),
+   *   invalidationPlugin(),
    *   prefetchPlugin(),
    * ]);
    * ```
@@ -1051,7 +1006,7 @@ var Spoosh = class _Spoosh {
    *
    * @example
    * ```ts
-   * const client = new Spoosh<ApiSchema, Error>('/api').use([...]);
+   * const spoosh = new Spoosh<ApiSchema, Error>('/api').use([...]);
    * const { api } = client;
    *
    * // GET request
@@ -1171,7 +1126,7 @@ function createOperationController(options) {
     eventEmitter,
     pluginExecutor,
     fetchFn,
-    hookId
+    instanceId
   } = options;
   const queryKey = stateManager.createQueryKey({
     path,
@@ -1194,7 +1149,7 @@ function createOperationController(options) {
       queryKey,
       tags: resolvedTags,
       requestTimestamp,
-      hookId,
+      instanceId,
       request: {
         ...initialRequestOptions,
         ...requestOptions,
@@ -1389,7 +1344,7 @@ function createInfiniteReadController(options) {
     eventEmitter,
     pluginExecutor,
     fetchFn,
-    hookId
+    instanceId
   } = options;
   let pageKeys = [];
   let pageRequests = /* @__PURE__ */ new Map();
@@ -1489,7 +1444,7 @@ function createInfiniteReadController(options) {
       queryKey: pageKey,
       tags,
       requestTimestamp: Date.now(),
-      hookId,
+      instanceId,
       request: { headers: {} },
       temp: /* @__PURE__ */ new Map(),
       pluginOptions,
@@ -1733,7 +1688,9 @@ export {
   form,
   generateTags,
   getContentType,
+  isAbortError,
   isJsonBody,
+  isNetworkError,
   isSpooshBody,
   json,
   mergeHeaders,

package/package.json

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