@gcmdev/faxios 0.1.0 → 0.2.1

package/dist/lib/plugins/timing.js

@@ -0,0 +1,53 @@
+// @ts-self-types="./timing.d.ts" — required for Deno: maps built .js to adjacent .d.ts in dist/
+import buildFullPath from "../core/buildFullPath.js";
+import utils from "../utils.js";
+import { RETRY_ATTEMPT } from "./attempt.js";
+import { definePlugin } from "./definePlugin.js";
+const now = () => (typeof performance === "undefined" ? Date.now() : performance.now());
+const own = (source, key) => (utils.hasOwnProp(source, key) ? source[key] : undefined);
+// Read once the request settles, so a later middleware's changes to the config count. The query
+// and fragment often carry secrets, and they'd make every URL a different metric label.
+function describe({ config, state }) {
+    // Typed string, but undefined when the request has neither url nor baseURL.
+    const full = buildFullPath(own(config, "baseURL"), own(config, "url"), own(config, "allowAbsoluteUrls"));
+    const url = typeof full === "string" ? full : "";
+    const end = url.search(/[?#]/);
+    const attempt = state[RETRY_ATTEMPT];
+    return {
+        method: String(own(config, "method") ?? "get").toUpperCase(),
+        url: end === -1 ? url : url.slice(0, end),
+        ...(typeof attempt === "number" ? { attempt } : {}),
+    };
+}
+/**
+ * Measures the time around `next` and calls `onTiming` once per request with the method, URL,
+ * duration and status or error. Installed before `retry`, the duration covers every try;
+ * installed after it, each try is reported. The response is returned unchanged. If `onTiming`
+ * throws while reporting a failure, the request still rejects with its own error; while
+ * reporting a success, its error rejects the request.
+ */
+export function timing(onTiming) {
+    return definePlugin({
+        name: "timing",
+        middleware: async (ctx, next) => {
+            const start = now();
+            let response;
+            try {
+                response = await next(ctx);
+            }
+            catch (error) {
+                try {
+                    onTiming({ ...describe(ctx), durationMs: now() - start, error });
+                }
+                catch {
+                    // The request's own error matters more than the observer's; keep it.
+                }
+                throw error;
+            }
+            // Outside the try, so an onTiming that throws isn't reported as a failed request.
+            onTiming({ ...describe(ctx), durationMs: now() - start, status: response.status });
+            return response;
+        },
+    });
+}
+//# sourceMappingURL=timing.js.map

package/dist/lib/plugins/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../src/lib/plugins/timing.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,aAAa,iCAAiC;AAErD,OAAO,KAAK,oBAAoB;AAChC,OAAO,EAAE,aAAa,EAAE,qBAAqB;AAC7C,OAAO,EAAE,YAAY,EAAE,0BAA0B;AAmBjD,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;AAExF,MAAM,GAAG,GAAG,CAAsC,MAAS,EAAE,GAAM,EAAoB,EAAE,CACvF,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAE5D,gGAAgG;AAChG,wFAAwF;AACxF,SAAS,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAiB;IAChD,4EAA4E;IAC5E,MAAM,IAAI,GAAY,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAClH,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE;QAC5D,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACzC,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,QAAsC;IAC3D,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;YACpB,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnE,CAAC;gBACD,MAAM,CAAC;oBACL,qEAAqE;gBACvE,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,kFAAkF;YAClF,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACnF,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/types/standard-schema.d.ts

@@ -35,3 +35,4 @@ export declare namespace StandardSchemaV1 {
     type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
     type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 }
+//# sourceMappingURL=standard-schema.d.ts.map

package/dist/lib/types/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../../src/lib/types/standard-schema.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAIH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,UAAU,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QAC7C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACtC,QAAQ,CAAC,QAAQ,EAAE,CACjB,KAAK,EAAE,OAAO,KACX,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;KAC/C;IAED,UAAU,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB;IAED,KAAK,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;IAE5D,UAAU,aAAa,CAAC,MAAM;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;KAC7B;IAED,UAAU,aAAa;QACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;KACvC;IAED,UAAU,KAAK;QACb,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EACV,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,GACxC,SAAS,CAAC;KACf;IAED,UAAU,WAAW;QACnB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;KAC3B;IAED,KAAK,UAAU,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CAC5D,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,OAAO,CAAC,CAAC;IAEX,KAAK,WAAW,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CAC7D,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,QAAQ,CAAC,CAAC;CACb"}

package/dist/lib/types.d.ts

@@ -1,3 +1,4 @@
+import type { FaxiosHeadersInstance } from "./core/FaxiosHeaders.js";
 import type { StandardSchemaV1 } from "./types/standard-schema.js";
 export type StringLiteralsOrString<Literals extends string> = Literals | (string & {});
 export type FaxiosHeaderValue = string | Array<string> | number | boolean | null;
@@ -6,13 +7,25 @@ export interface RawFaxiosHeaders {
 }
 type UppercaseMethod = "GET" | "DELETE" | "HEAD" | "OPTIONS" | "POST" | "PUT" | "PATCH" | "PURGE" | "LINK" | "UNLINK" | "QUERY";
 export type Method = UppercaseMethod | Lowercase<UppercaseMethod>;
-type CommonRequestHeadersList = "Accept" | "Content-Length" | "User-Agent" | "Content-Encoding" | "Authorization" | "Location";
-type ContentType = FaxiosHeaderValue | "text/html" | "text/plain" | "multipart/form-data" | "application/json" | "application/x-www-form-urlencoded" | "application/octet-stream";
-export type RawFaxiosRequestHeaders = Partial<RawFaxiosHeaders & {
-    [Key in CommonRequestHeadersList]: FaxiosHeaderValue;
+type CommonRequestHeadersList = "Accept" | "Accept-Encoding" | "Accept-Language" | "Authorization" | "Cache-Control" | "Content-Encoding" | "Content-Length" | "If-Match" | "If-Modified-Since" | "If-None-Match" | "Range" | "User-Agent" | "X-Requested-With";
+type ContentType = StringLiteralsOrString<"text/html" | "text/plain" | "multipart/form-data" | "application/json" | "application/x-www-form-urlencoded" | "application/octet-stream" | "application/problem+json" | "application/ld+json" | "text/event-stream" | "application/graphql-response+json" | "application/merge-patch+json" | "application/json-patch+json"> | Exclude<FaxiosHeaderValue, string>;
+/**
+ * A header bag: header names mapped to header values. Any header name is
+ * accepted in any casing; common names and `Content-Type` values are suggested.
+ *
+ * - Strings, numbers and string arrays are sent (numbers and `true` as strings).
+ * - `undefined` drops a value inherited from defaults or an outer config;
+ *   faxios may still set its own value (e.g. `Content-Type` for a JSON body).
+ * - `null` or `false` keeps the header off the request entirely; faxios does
+ *   not fill it in, and later merges keep it off unless they force an overwrite.
+ */
+export type RawFaxiosRequestHeaders = {
+    [header: string]: FaxiosHeaderValue | undefined;
 } & {
-    "Content-Type": ContentType;
-}>;
+    [Header in CommonRequestHeadersList]?: FaxiosHeaderValue;
+} & {
+    "Content-Type"?: ContentType;
+};
 export type ResponseType = "arraybuffer" | "blob" | "document" | "json" | "text" | "stream" | "formdata" | "response";
 type UppercaseResponseEncoding = "ASCII" | "ANSI" | "BINARY" | "BASE64" | "BASE64URL" | "HEX" | "LATIN1" | "UCS-2" | "UCS2" | "UTF-8" | "UTF8" | "UTF16LE";
 export type responseEncoding = UppercaseResponseEncoding | Lowercase<UppercaseResponseEncoding>;
@@ -20,7 +33,6 @@ export interface TransitionalOptions {
     silentJSONParsing?: boolean;
     forcedJSONParsing?: boolean;
     clarifyTimeoutError?: boolean;
-    legacyInterceptorReqResOrdering?: boolean;
     advertiseZstdAcceptEncoding?: boolean;
     validateStatusUndefinedResolves?: boolean;
 }
@@ -51,10 +63,12 @@ export interface SerializerOptions {
     dots?: boolean;
     metaTokens?: boolean;
     indexes?: boolean | null;
+    /** Maximum nesting depth to serialize; deeper objects throw `ERR_FORM_DATA_DEPTH_EXCEEDED`. `Infinity` disables the check. */
+    maxDepth?: number;
 }
 export type FormSerializerOptions = SerializerOptions;
 export interface ParamEncoder {
-    (value: unknown, defaultEncoder: (value: unknown) => unknown): unknown;
+    (value: string, defaultEncoder: (value: string) => string): string;
 }
 export interface CustomParamsSerializer {
     (params: Record<string, unknown>, options?: ParamsSerializerOptions): string;
@@ -82,10 +96,9 @@ export interface FaxiosBasicCredentials {
     password: string;
 }
 type HeaderMatcher = string | RegExp | ((value: string, name: string) => boolean);
-type HeaderRewrite = boolean | ((value: string, name: string) => boolean);
 type HeaderGetResult = string | Array<string> | Record<string, string> | RegExpExecArray | true | null | undefined;
 export type FaxiosRequestHeaders = Record<string, FaxiosHeaderValue> & {
-    set: (header: string | Record<string, unknown>, value?: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
+    set: (header: string | Record<string, unknown>, value?: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
     get: (header: string, parser?: boolean | RegExp) => HeaderGetResult;
     has: (header: string, matcher?: HeaderMatcher) => boolean;
     delete: (header: string | Array<string>, matcher?: HeaderMatcher) => boolean;
@@ -93,22 +106,22 @@ export type FaxiosRequestHeaders = Record<string, FaxiosHeaderValue> & {
     normalize: (format?: boolean) => FaxiosRequestHeaders;
     concat: (...targets: Array<unknown>) => FaxiosRequestHeaders;
     getContentType: (matcher?: HeaderMatcher) => HeaderGetResult;
-    setContentType: (value: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
+    setContentType: (value: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
     hasContentType: (matcher?: HeaderMatcher) => boolean;
     getContentLength: (matcher?: HeaderMatcher) => HeaderGetResult;
-    setContentLength: (value: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
+    setContentLength: (value: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
     hasContentLength: (matcher?: HeaderMatcher) => boolean;
     getAccept: (matcher?: HeaderMatcher) => HeaderGetResult;
-    setAccept: (value: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
+    setAccept: (value: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
     hasAccept: (matcher?: HeaderMatcher) => boolean;
+    getAcceptEncoding: (matcher?: HeaderMatcher) => HeaderGetResult;
+    setAcceptEncoding: (value: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
+    hasAcceptEncoding: (matcher?: HeaderMatcher) => boolean;
     getUserAgent: (matcher?: HeaderMatcher) => HeaderGetResult;
-    setUserAgent: (value: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
+    setUserAgent: (value: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
     hasUserAgent: (matcher?: HeaderMatcher) => boolean;
-    getContentEncoding: (matcher?: HeaderMatcher) => HeaderGetResult;
-    setContentEncoding: (value: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
-    hasContentEncoding: (matcher?: HeaderMatcher) => boolean;
     getAuthorization: (matcher?: HeaderMatcher) => HeaderGetResult;
-    setAuthorization: (value: FaxiosHeaderValue, rewrite?: HeaderRewrite) => FaxiosRequestHeaders;
+    setAuthorization: (value: FaxiosHeaderValue, rewrite?: boolean) => FaxiosRequestHeaders;
     hasAuthorization: (matcher?: HeaderMatcher) => boolean;
     toJSON: (asStrings?: boolean) => Record<string, FaxiosHeaderValue>;
 };
@@ -125,7 +138,7 @@ export interface FaxiosRequestConfig<D = unknown> {
     allowAbsoluteUrls?: boolean;
     transformRequest?: FaxiosRequestTransformer | Array<FaxiosRequestTransformer>;
     transformResponse?: FaxiosResponseTransformer | Array<FaxiosResponseTransformer>;
-    headers?: Record<string, unknown>;
+    headers?: FaxiosConfigHeaders;
     params?: Record<string, unknown> | URLSearchParams;
     paramsSerializer?: ParamsSerializerOptions | CustomParamsSerializer;
     data?: D;
@@ -145,10 +158,12 @@ export interface FaxiosRequestConfig<D = unknown> {
     transitional?: TransitionalOptions;
     signal?: AbortSignal | GenericAbortSignal;
     env?: {
-        FormData?: new (...args: Array<unknown>) => object;
+        /** Constructed with no arguments to serialize `multipart/form-data` payloads; `null` falls back to the global `FormData`. */
+        FormData?: (new () => object) | null;
         fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-        Request?: new (input: string | URL | Request, init?: RequestInit) => unknown;
-        Response?: new (...args: Array<unknown>) => unknown;
+        /** `null` disables the constructor, e.g. when a custom `fetch` is incompatible with the global one. */
+        Request?: (new (input: string | URL | Request, init?: RequestInit) => unknown) | null;
+        Response?: (new (...args: Array<unknown>) => unknown) | null;
     };
     formSerializer?: FormSerializerOptions;
     withXSRFToken?: boolean | ((config: InternalFaxiosRequestConfig) => boolean | undefined);
@@ -161,7 +176,18 @@ export interface FaxiosRequestConfig<D = unknown> {
     responseSchema?: StandardSchemaV1;
     requestSchema?: StandardSchemaV1;
     paramsSchema?: StandardSchemaV1;
+    /**
+     * Values for `{key}` placeholders in `url` (braces, not `:key`). Only own properties count.
+     * Each value goes through `String()` then `encodeURIComponent`. A placeholder whose key is
+     * missing, or whose value is `null` or `undefined`, rejects with `ERR_BAD_OPTION_VALUE`. Keys
+     * with no matching placeholder are ignored. Without `pathParams`, placeholders are sent literally.
+     */
     pathParams?: Record<string, unknown>;
+    /**
+     * Standard Schema that validates `pathParams` before substitution; its output replaces
+     * `pathParams`. Requires `pathParams`, or the request rejects with `ERR_BAD_OPTION_VALUE`.
+     * A validation failure, or output that isn't a plain object, rejects with `ERR_BAD_PATH_PARAMS_SCHEMA`.
+     */
     pathParamsSchema?: StandardSchemaV1<unknown, Record<string, unknown>>;
 }
 export type SchemaConfig<O, D = unknown> = FaxiosRequestConfig<D> & {
@@ -201,19 +227,84 @@ export interface HeadersDefaults {
 export interface FaxiosDefaults<D = unknown> extends Omit<FaxiosRequestConfig<D>, "headers"> {
     headers: HeadersDefaults;
 }
-export interface CreateFaxiosDefaults<D = unknown> extends Omit<FaxiosRequestConfig<D>, "headers"> {
-    headers?: RawFaxiosRequestHeaders | Partial<HeadersDefaults>;
+/**
+ * The `headers` option on every request config and on `create()`: a header
+ * bag, method header groups (a header bag under `common` or a method name,
+ * applied only to requests with that method), both mixed in one object, or a
+ * `FaxiosHeaders` instance.
+ */
+export type FaxiosConfigHeaders = RawFaxiosRequestHeaders | Partial<HeadersDefaults> | FaxiosHeadersInstance;
+/** Config accepted by `create()`; identical to a request config. */
+export type CreateFaxiosDefaults<D = unknown> = FaxiosRequestConfig<D>;
+interface ContextHeaders {
+    get headers(): FaxiosRequestHeaders;
+    set headers(value: FaxiosRequestHeaders | FaxiosHeadersInstance);
 }
-export interface FaxiosInterceptorOptions {
-    synchronous?: boolean;
-    runWhen?: ((config: InternalFaxiosRequestConfig) => boolean) | null;
+/**
+ * Per-request state passed through `.use()` middleware. Created once per
+ * request, after the request config is merged with the instance defaults.
+ */
+export interface FaxiosContext<TOptions = {}, TCapabilities = {}> {
+    /** The merged request config. `headers` is a `FaxiosHeaders` instance. */
+    config: Omit<InternalFaxiosRequestConfig, "headers"> & ContextHeaders & TOptions;
+    /** Null-prototype scratch space shared by middleware for this request only. */
+    state: Record<PropertyKey, unknown>;
+    /** Values provided by installed plugins, shared by every request of the instance. */
+    capabilities: TCapabilities;
 }
-export type FaxiosInterceptorFulfilled<T> = (value: T) => T | Promise<T>;
-export type FaxiosInterceptorRejected = (error: unknown) => unknown;
-export interface FaxiosInterceptorHandler<T> {
-    fulfilled: FaxiosInterceptorFulfilled<T>;
-    rejected?: FaxiosInterceptorRejected;
-    synchronous: boolean;
-    runWhen?: ((config: InternalFaxiosRequestConfig) => boolean) | null;
+/**
+ * Runs the rest of the middleware chain, then dispatches a copy of `ctx.config`. It takes the same
+ * context type the middleware received, so a middleware can't pass on fewer capabilities or
+ * options than later middleware expects.
+ */
+export type FaxiosNext<TOptions = {}, TCapabilities = {}> = (ctx: FaxiosContext<TOptions, TCapabilities>) => Promise<FaxiosResponse>;
+/**
+ * Onion-style lifecycle hook: code before `await next(ctx)` runs on the way in,
+ * code after it on the way out. Returning without calling `next` skips dispatch.
+ */
+export type FaxiosMiddleware<TOptions = {}, TCapabilities = {}> = (ctx: FaxiosContext<TOptions, TCapabilities>, next: FaxiosNext<TOptions, TCapabilities>) => Promise<FaxiosResponse>;
+/**
+ * The type slots of a `FaxiosPlugin`, all optional: `requires` holds the capabilities that must be
+ * installed before it, `provides` the capabilities it adds to `ctx.capabilities`, and `options`
+ * the request options it adds to every config-taking member.
+ */
+export interface FaxiosPluginSpec {
+    requires?: unknown;
+    provides?: unknown;
+    options?: unknown;
 }
+type PluginSlot<TSpec, K extends keyof FaxiosPluginSpec> = K extends keyof TSpec ? Required<TSpec>[K] : unknown;
+type OnlyPluginSlots<TSpec> = {
+    [K in Exclude<keyof TSpec, keyof FaxiosPluginSpec>]: never;
+};
+/**
+ * The parts of a plugin that `use()` reads its type parameters from. Internal: build plugins with
+ * `definePlugin()` or annotate them as `FaxiosPlugin`; `use()` infers `TRequires`, `TProvides`
+ * and `TOptions` through this.
+ */
+export interface FaxiosPluginBase<TRequires = unknown, TProvides = unknown, TOptions = unknown> {
+    name: string;
+    middleware: FaxiosMiddleware<TOptions, TRequires & TProvides>;
+    /** Internal, type-only marker that carries the type parameters for inference. Never set it. */
+    readonly "~plugin"?: {
+        readonly requires: TRequires;
+        readonly provides: TProvides;
+        readonly options: TOptions;
+    };
+}
+/**
+ * Middleware bundled with the capabilities it requires and provides, typed by one
+ * `FaxiosPluginSpec`: `FaxiosPlugin<{ requires?; provides?; options? }>`. Declaring `provides`
+ * makes the `provides` value required, so a plugin can't claim a capability it never supplies.
+ */
+export type FaxiosPlugin<TSpec extends FaxiosPluginSpec & OnlyPluginSlots<TSpec> = {}> = FaxiosPluginBase<PluginSlot<TSpec, "requires">, PluginSlot<TSpec, "provides">, PluginSlot<TSpec, "options">> & ([keyof PluginSlot<TSpec, "provides">] extends [never] ? {
+    provides?: PluginSlot<TSpec, "provides">;
+} : {
+    provides: PluginSlot<TSpec, "provides">;
+});
+/** What `use()` and `eject()` accept as a plugin: the base plus an optional `provides`. Internal. */
+export type FaxiosPluginArgument<TRequires = unknown, TProvides = unknown, TOptions = unknown> = FaxiosPluginBase<TRequires, TProvides, TOptions> & {
+    provides?: TProvides;
+};
 export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils.d.ts

@@ -141,3 +141,4 @@ declare const _default: {
     isSafeIterable: (thing: unknown) => boolean;
 };
 export default _default;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gcmdev/faxios",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Promise based, web-standard fetch HTTP client for the browser, Node.js, Deno and Bun",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -17,7 +17,8 @@
     "browser",
     "rest",
     "api",
-    "client"
+    "client",
+    "tanstack-intent"
   ],
   "author": "Adrian Elton-Browning",
   "contributors": [
@@ -40,20 +41,38 @@
   "bugs": {
     "url": "https://github.com/adrianbrowning/faxios/issues"
   },
-  "homepage": "https://faxios-http.com",
+  "homepage": "https://adrianbrowning.github.io/faxios/",
   "files": [
-    "dist/"
+    "dist/",
+    "src/**/*.ts",
+    "skills/configure-requests"
   ],
+  "scripts": {
+    "build": "zshy",
+    "bp": "pnpm build && pnpm pack",
+    "version": "pnpm run build && git add package.json",
+    "docs:dev": "cd docs && npm run docs:dev",
+    "lint": "pnpm lint:ts && pnpm lint:esl && pnpm lint:fix",
+    "lint:ts": "tsc --noEmit -p tsconfig.check.json",
+    "lint:esl": "eslint --config eslint.config.ts \"**/*.{j,t}s{,x}\" --cache --cache-strategy content --max-warnings=0",
+    "lint:s": "eslint --config eslint.config.style.ts \"**/*.{j,t}s{,x}\" --cache --cache-strategy content --max-warnings=0",
+    "lint:fix": "pnpm lint:s --fix",
+    "lint:e18e": "pnpm dlx @e18e/cli analyze"
+  },
   "devDependencies": {
-    "@gingacodemonkey/config": "^0.0.36",
+    "@gingacodemonkey/config": "^0.0.38",
     "eslint": "^9.39.4",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.62.1",
+    "typescript-eslint": "^8.71.0",
     "zshy": "latest"
   },
   "zshy": {
     "exports": {
       ".": "./src/index.ts",
+      "./plugins": "./src/lib/plugins/definePlugin.ts",
+      "./plugins/auth-bearer": "./src/lib/plugins/authBearer.ts",
+      "./plugins/retry": "./src/lib/plugins/retry.ts",
+      "./plugins/timing": "./src/lib/plugins/timing.ts",
       "./unsafe/core/buildFullPath.js": "./src/lib/core/buildFullPath.ts",
       "./unsafe/helpers/isAbsoluteURL.js": "./src/lib/helpers/isAbsoluteURL.ts",
       "./unsafe/helpers/buildURL.js": "./src/lib/helpers/buildURL.ts",
@@ -73,6 +92,22 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./plugins": {
+      "types": "./dist/lib/plugins/definePlugin.d.ts",
+      "default": "./dist/lib/plugins/definePlugin.js"
+    },
+    "./plugins/auth-bearer": {
+      "types": "./dist/lib/plugins/authBearer.d.ts",
+      "default": "./dist/lib/plugins/authBearer.js"
+    },
+    "./plugins/retry": {
+      "types": "./dist/lib/plugins/retry.d.ts",
+      "default": "./dist/lib/plugins/retry.js"
+    },
+    "./plugins/timing": {
+      "types": "./dist/lib/plugins/timing.d.ts",
+      "default": "./dist/lib/plugins/timing.js"
+    },
     "./unsafe/core/buildFullPath.js": {
       "types": "./dist/lib/core/buildFullPath.d.ts",
       "default": "./dist/lib/core/buildFullPath.js"
@@ -94,17 +129,5 @@
       "default": "./dist/lib/utils.js"
     },
     "./package.json": "./package.json"
-  },
-  "scripts": {
-    "build": "zshy",
-    "bp": "pnpm build && pnpm pack",
-    "version": "pnpm run build && git add package.json",
-    "docs:dev": "cd docs && npm run docs:dev",
-    "lint": "pnpm lint:ts; pnpm lint:fix",
-    "lint:ts": "tsc --noEmit -p tsconfig.check.json",
-    "lint:esl": "eslint --config eslint.config.ts \"**/*.{j,t}s{,x}\" --cache --cache-strategy content --max-warnings=0",
-    "lint:s": "eslint --config eslint.config.style.ts \"**/*.{j,t}s{,x}\" --cache --cache-strategy content --max-warnings=0",
-    "lint:fix": "pnpm lint:s --fix",
-    "lint:e18e": "pnpm dlx @e18e/cli analyze"
   }
-}
+}