@gcmdev/faxios 0.1.0 → 0.2.0

package/dist/lib/faxios.js

@@ -2,7 +2,7 @@
 "use strict";
 import CanceledError from "./cancel/CanceledError.js";
 import isCancel from "./cancel/isCancel.js";
-import Faxios from "./core/Faxios.js";
+import Faxios, { ejectMiddleware, useMiddleware } from "./core/Faxios.js";
 import FaxiosError from "./core/FaxiosError.js";
 import FaxiosHeaders from "./core/FaxiosHeaders.js";
 import mergeConfig from "./core/mergeConfig.js";
@@ -29,13 +29,25 @@ function createInstance(defaultConfig) {
     utils.extend(target, Faxios.prototype, context, { allOwnKeys: true });
     // Copy context to instance
     utils.extend(target, context, null, { allOwnKeys: true });
+    // use() and eject() aren't Faxios members, so the instance gets them here. use() returns the
+    // callable instance for chaining. At runtime it only registers the middleware; the plugin rules
+    // live in FaxiosInstance["use"], so the cast is the single place the phantom TOpts/TCaps
+    // refinement meets the untyped registry.
+    const use = (middleware) => {
+        useMiddleware(context, middleware);
+        return instance;
+    };
+    instance.use = use;
+    instance.eject = (middleware) => {
+        ejectMiddleware(context, middleware);
+    };
     // Factory for creating new instances
     instance.create = function create(instanceConfig) {
         return createInstance(mergeConfig(defaultConfig, instanceConfig));
     };
     return instance;
 }
-// Create the default instance to be exported
+// Create the default instance to be exported; the statics are attached below.
 const faxios = createInstance(defaults);
 // Expose Faxios class to allow class inheritance
 faxios.Faxios = Faxios;

package/dist/lib/faxios.js.map

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

package/dist/lib/helpers/FaxiosURLSearchParams.d.ts

@@ -1,7 +1,8 @@
+import type { ParamEncoder } from "../types.js";
 declare class FaxiosURLSearchParams {
     #private;
     constructor(params?: unknown, options?: unknown);
     append(name: string, value: unknown): void;
-    toString(encoder?: (value: string, encode: (v: string) => string) => string): string;
+    toString(encoder?: ParamEncoder): string;
 }
 export default FaxiosURLSearchParams;

package/dist/lib/helpers/FaxiosURLSearchParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"FaxiosURLSearchParams.js","sourceRoot":"","sources":["../../../src/lib/helpers/FaxiosURLSearchParams.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,UAAU,wBAAwB;AAEzC;;;;;;;GAOG;AACH,SAAS,MAAM,CAAC,GAAW;IACzB,MAAM,OAAO,GAA2B;QACtC,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,GAAG;KACX,CAAC;IACF,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,QAAQ,CAAC,KAAa;QACpF,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,qBAAqB;IACzB,MAAM,GAA6B,EAAE,CAAC;IAEtC,YAAY,MAAgB,EAAE,OAAiB;QAC7C,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,OAAkC,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAc;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAE,IAAI,EAAE,KAAK,CAAE,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,CAAC,OAAkE;QACzE,MAAM,OAAO,GAAG,OAAO;YACrB,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC;YAC3D,CAAC,CAAC,MAAM,CAAC;QAEX,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAC,SAAS,IAAI,CAAC,IAAuB;YACxC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACpE,CAAC,EAAE,EAAE,CAAC;aACL,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"FaxiosURLSearchParams.js","sourceRoot":"","sources":["../../../src/lib/helpers/FaxiosURLSearchParams.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,UAAU,wBAAwB;AAEzC;;;;;;;GAOG;AACH,SAAS,MAAM,CAAC,GAAW;IACzB,MAAM,OAAO,GAA2B;QACtC,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,GAAG;KACX,CAAC;IACF,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,QAAQ,CAAC,KAAa;QACpF,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,qBAAqB;IACzB,MAAM,GAA6B,EAAE,CAAC;IAEtC,YAAY,MAAgB,EAAE,OAAiB;QAC7C,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,OAAkC,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAc;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAE,IAAI,EAAE,KAAK,CAAE,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,CAAC,OAAsB;QAC7B,MAAM,OAAO,GAAG,OAAO;YACrB,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC;YAC3D,CAAC,CAAC,MAAM,CAAC;QAEX,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAC,SAAS,IAAI,CAAC,IAAuB;YACxC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACpE,CAAC,EAAE,EAAE,CAAC;aACL,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/lib/helpers/buildURL.js

@@ -16,6 +16,11 @@ export function encode(val) {
         .replace(/%2C/gi, ",")
         .replace(/%20/g, "+");
 }
+// The request path validates `paramsSerializer.encode` as a function; this
+// guard narrows the untyped option to ParamEncoder without asserting it.
+function isParamEncoder(value) {
+    return typeof value === "function";
+}
 /**
  * Build a URL by appending params to the end
  *
@@ -37,7 +42,8 @@ export default function buildURL(url, params, options) {
     // Read serializer options pollution-safely: own properties and methods on a
     // class/template prototype are honored, but values injected onto a polluted
     // Object.prototype are ignored.
-    const _encode = utils.getSafeProp(_options, "encode") || encode;
+    const customEncode = utils.getSafeProp(_options, "encode");
+    const _encode = isParamEncoder(customEncode) ? customEncode : encode;
     const serializeFn = utils.getSafeProp(_options, "serialize");
     let serializedParams;
     if (serializeFn) {

package/dist/lib/helpers/buildURL.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildURL.js","sourceRoot":"","sources":["../../../src/lib/helpers/buildURL.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,oBAAoB;AAChC,OAAO,qBAAqB,mCAAmC;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,kBAAkB,CAAC,GAAG,CAAC;SAC3B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAgB,EAAE,OAAiB;IAC/E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACxC,CAAC,CAAC;YACA,SAAS,EAAE,OAAO;SACnB;QACD,CAAC,CAAC,OAAO,CAAC;IAEZ,4EAA4E;IAC5E,4EAA4E;IAC5E,gCAAgC;IAChC,MAAM,OAAO,GAAI,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAA2C,IAAI,MAAM,CAAC;IAC3G,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAgE,CAAC;IAE5H,IAAI,gBAAoC,CAAC;IAEzC,IAAI,WAAW,EAAE,CAAC;QAChB,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;SACI,CAAC;QACJ,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAChD,CAAC,CAAE,MAAsC,CAAC,QAAQ,EAAE;YACpD,CAAC,CAAC,IAAK,qBAAwI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxL,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;IAClE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"buildURL.js","sourceRoot":"","sources":["../../../src/lib/helpers/buildURL.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,KAAK,oBAAoB;AAChC,OAAO,qBAAqB,mCAAmC;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,kBAAkB,CAAC,GAAG,CAAC;SAC3B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,2EAA2E;AAC3E,yEAAyE;AACzE,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAgB,EAAE,OAAiB;IAC/E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACxC,CAAC,CAAC;YACA,SAAS,EAAE,OAAO;SACnB;QACD,CAAC,CAAC,OAAO,CAAC;IAEZ,4EAA4E;IAC5E,4EAA4E;IAC5E,gCAAgC;IAChC,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAiB,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAgE,CAAC;IAE5H,IAAI,gBAAoC,CAAC;IAEzC,IAAI,WAAW,EAAE,CAAC;QAChB,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;SACI,CAAC;QACJ,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAChD,CAAC,CAAE,MAAsC,CAAC,QAAQ,EAAE;YACpD,CAAC,CAAC,IAAI,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;IAClE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/helpers/cloneConfig.d.ts

@@ -0,0 +1,3 @@
+import type { FaxiosRequestConfig } from "../types.js";
+export declare const DANGEROUS_KEYS: Set<string>;
+export default function cloneConfig<T extends FaxiosRequestConfig>(src: T): T & Record<string, unknown>;

package/dist/lib/helpers/cloneConfig.js

@@ -0,0 +1,21 @@
+export const DANGEROUS_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+// ponytail: null-proto shallow clone; replaces mergeConfig({}, config) which ran the full
+// two-config merge machinery just to get a defensive copy. Security invariants preserved:
+// null-proto so fetch.ts destructuring can't inherit Object.prototype gadgets, and
+// dangerous keys filtered to block prototype-pollution write paths.
+export default function cloneConfig(src) {
+    const dst = Object.create(null);
+    Object.defineProperty(dst, "hasOwnProperty", Object.assign(Object.create(null), {
+        value: Object.prototype.hasOwnProperty,
+        writable: true,
+        configurable: true,
+        enumerable: false,
+    }));
+    for (const key of Object.keys(src)) {
+        if (!DANGEROUS_KEYS.has(key)) {
+            dst[key] = src[key];
+        }
+    }
+    return dst;
+}
+//# sourceMappingURL=cloneConfig.js.map

package/dist/lib/helpers/cloneConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneConfig.js","sourceRoot":"","sources":["../../../src/lib/helpers/cloneConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAE,WAAW,EAAE,aAAa,EAAE,WAAW,CAAE,CAAC,CAAC;AAEnF,0FAA0F;AAC1F,0FAA0F;AAC1F,mFAAmF;AACnF,oEAAoE;AACpE,MAAM,CAAC,OAAO,UAAU,WAAW,CAAgC,GAAM;IACvE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAgC,CAAC;IAC/D,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAuB,EAAE;QACpG,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc;QACtC,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC,CAAC;IACJ,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,GAA+B,CAAC,GAAG,CAAC,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/helpers/composeSignals.js

@@ -39,7 +39,14 @@ const composeSignals = (signals, timeout, timeoutMessage) => {
         });
         activeSignals = null;
     };
-    activeSignals.forEach(signal => signal.addEventListener("abort", onabort));
+    // An already-aborted input never fires "abort" again, so propagate it now.
+    for (const signal of activeSignals) {
+        if (signal.aborted) {
+            onabort.call(signal, signal.reason);
+            break;
+        }
+        signal.addEventListener("abort", onabort);
+    }
     const { signal } = controller;
     signal.unsubscribe = () => utils.asap(unsubscribe);
     return signal;

package/dist/lib/helpers/composeSignals.js.map

@@ -1 +1 @@
-{"version":3,"file":"composeSignals.js","sourceRoot":"","sources":["../../../src/lib/helpers/composeSignals.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,mCAAmC;AACvD,OAAO,WAAW,+BAA+B;AACjD,OAAO,KAAK,oBAAoB;AAahC,MAAM,cAAc,GAAG,CAAC,OAA0C,EAAE,OAAgB,EAAE,cAAuB,EAAmC,EAAE;IAChJ,IAAI,aAAa,GAA6B,OAAO,CAAC,CAAC,CAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5G,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,OAAO,GAAiB,UAAqD,MAAe;QAChG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3D,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,GAA0B,CAAC;YAChF,MAAM,QAAQ,GAAG,GAAG,YAAY,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACpG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,KAAK,GACP,OAAO;QACL,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;YAChB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,WAAW,CAAC,cAAc,IAAI,cAAc,OAAO,aAAa,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;QAChI,CAAC,EAAE,OAAO,CAAC;QACX,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,CAAC,aAAa,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAC/B,IAAI,KAAK,EAAE,CAAC;YAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QACnC,KAAK,GAAG,IAAI,CAAC;QACb,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YAC7B,MAAM,CAAC,WAAW;gBAChB,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;gBAC/B,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC,CAAC;IAEF,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAE7B,MAA8B,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE5E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"composeSignals.js","sourceRoot":"","sources":["../../../src/lib/helpers/composeSignals.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,mCAAmC;AACvD,OAAO,WAAW,+BAA+B;AACjD,OAAO,KAAK,oBAAoB;AAahC,MAAM,cAAc,GAAG,CAAC,OAA0C,EAAE,OAAgB,EAAE,cAAuB,EAAmC,EAAE;IAChJ,IAAI,aAAa,GAA6B,OAAO,CAAC,CAAC,CAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5G,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,OAAO,GAAiB,UAAqD,MAAe;QAChG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3D,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,GAA0B,CAAC;YAChF,MAAM,QAAQ,GAAG,GAAG,YAAY,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACpG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,KAAK,GACP,OAAO;QACL,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;YAChB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,WAAW,CAAC,cAAc,IAAI,cAAc,OAAO,aAAa,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;QAChI,CAAC,EAAE,OAAO,CAAC;QACX,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,CAAC,aAAa,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAC/B,IAAI,KAAK,EAAE,CAAC;YAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QACnC,KAAK,GAAG,IAAI,CAAC;QACb,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YAC7B,MAAM,CAAC,WAAW;gBAChB,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;gBAC/B,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC,CAAC;IAEF,2EAA2E;IAC3E,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,MAAgC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM;QACR,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAE7B,MAA8B,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE5E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/lib/helpers/isFaxiosError.d.ts

@@ -1,8 +1,13 @@
+import type FaxiosError from "../core/FaxiosError.js";
 /**
- * Determines whether the payload is an error thrown by Faxios
+ * Determines whether the payload is an error thrown by Faxios.
+ *
+ * Checks the `isFaxiosError` brand, not `instanceof`, so errors from another
+ * copy of faxios still match. `T` and `D` type `response.data` and
+ * `config.data`; they are not checked at runtime.
  *
  * @param {*} payload The value to test
  *
  * @returns {boolean} True if the payload is an error thrown by Faxios, otherwise false
  */
-export default function isFaxiosError(payload: unknown): boolean;
+export default function isFaxiosError<T = unknown, D = unknown>(payload: unknown): payload is FaxiosError<T, D>;

package/dist/lib/helpers/isFaxiosError.js

@@ -1,7 +1,11 @@
 "use strict";
 import utils from "../utils.js";
 /**
- * Determines whether the payload is an error thrown by Faxios
+ * Determines whether the payload is an error thrown by Faxios.
+ *
+ * Checks the `isFaxiosError` brand, not `instanceof`, so errors from another
+ * copy of faxios still match. `T` and `D` type `response.data` and
+ * `config.data`; they are not checked at runtime.
  *
  * @param {*} payload The value to test
  *

package/dist/lib/helpers/isFaxiosError.js.map

@@ -1 +1 @@
-{"version":3,"file":"isFaxiosError.js","sourceRoot":"","sources":["../../../src/lib/helpers/isFaxiosError.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,oBAAoB;AAEhC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,OAAgB;IACpD,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAK,OAAmC,CAAC,aAAa,KAAK,IAAI,CAAC;AAChG,CAAC"}
+{"version":3,"file":"isFaxiosError.js","sourceRoot":"","sources":["../../../src/lib/helpers/isFaxiosError.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,KAAK,oBAAoB;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAA2B,OAAgB;IAC9E,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAK,OAAmC,CAAC,aAAa,KAAK,IAAI,CAAC;AAChG,CAAC"}

package/dist/lib/platform.d.ts

@@ -6,7 +6,7 @@ declare const _default: {
             new (init?: string[][] | Record<string, string> | string | URLSearchParams): URLSearchParams;
             prototype: URLSearchParams;
         } | typeof FaxiosURLSearchParams;
-        FormData: (new (...args: Array<unknown>) => object) | null;
+        FormData: (new () => object) | null;
         Blob: (new (...args: Array<unknown>) => object) | null;
     };
     protocols: string[];

package/dist/lib/plugins/attempt.d.ts

@@ -0,0 +1 @@
+export declare const RETRY_ATTEMPT: unique symbol;

package/dist/lib/plugins/attempt.js

@@ -0,0 +1,4 @@
+// Shared only by the built-in plugins; not exported from any entry point. retry writes the number
+// of the try it is about to make under this key of ctx.state, and timing reads it.
+export const RETRY_ATTEMPT = Symbol("faxios.retry.attempt");
+//# sourceMappingURL=attempt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../../src/lib/plugins/attempt.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/lib/plugins/authBearer.d.ts

@@ -0,0 +1,30 @@
+import type { FaxiosPlugin } from "../types.js";
+/** What `authBearer` provides to plugins installed after it. */
+export type AuthBearerCapability = {
+    auth: {
+        getToken: () => Promise<string>;
+    };
+};
+export type AuthBearerOptions = {
+    /** Replace a header the request already has. Default `false`: an explicit header is kept. */
+    overwrite?: boolean;
+    /** Put before the token, separated by a space. Default `"Bearer"`; `""` sends the bare token. */
+    scheme?: string;
+    /** The header to set. Default `"Authorization"`. */
+    header?: string;
+    /**
+     * The origins (`"https://api.example.com"`) that get the token, replacing the default rule:
+     * with an absolute `baseURL`, only its origin; otherwise only relative request URLs.
+     */
+    origins?: Array<string>;
+};
+/**
+ * Sets `Authorization: Bearer <token>` on requests to the API it guards, asking `getToken` each
+ * time, and provides the `auth` capability so later plugins (for example a token-refresh plugin)
+ * can ask for a token too. A header the request already has is kept unless `overwrite` is set.
+ * The token goes only to the `baseURL` origin when `baseURL` is absolute, otherwise only to
+ * relative request URLs; `origins` replaces that rule.
+ */
+export declare function authBearer(getToken: () => string | Promise<string>, options?: AuthBearerOptions): FaxiosPlugin<{
+    provides: AuthBearerCapability;
+}>;

package/dist/lib/plugins/authBearer.js

@@ -0,0 +1,99 @@
+// @ts-self-types="./authBearer.d.ts" — required for Deno: maps built .js to adjacent .d.ts in dist/
+import buildFullPath from "../core/buildFullPath.js";
+import FaxiosError from "../core/FaxiosError.js";
+import FaxiosHeaders from "../core/FaxiosHeaders.js";
+import isAbsoluteURL from "../helpers/isAbsoluteURL.js";
+import validator from "../helpers/validator.js";
+import utils from "../utils.js";
+import { definePlugin } from "./definePlugin.js";
+// A header name is a token (RFC 9110 §5.6.2).
+const TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+// A bare origin, optionally with a trailing slash. A path would look like a narrower limit than
+// the origin the token is really sent to.
+function originOf(value) {
+    if (typeof value !== "string")
+        return null;
+    try {
+        const { origin } = new URL(value);
+        return origin !== "null" && (value === origin || value === `${origin}/`) ? origin : null;
+    }
+    catch {
+        return null;
+    }
+}
+const optionsSchema = {
+    overwrite: validator.validators["boolean"],
+    scheme: (value) => (typeof value === "string" && !/[\r\n]/.test(value)) || "a string without line breaks",
+    header: (value) => (typeof value === "string" && TOKEN.test(value)) || "a header name",
+    origins: (value) => (Array.isArray(value) && value.every(o => originOf(o) !== null)) || "an array of origins such as \"https://api.example.com\"",
+};
+const own = (source, key) => (utils.hasOwnProp(source, key) ? source[key] : undefined);
+// Resolves a relative URL the way a page would, without ever matching a real origin, so a URL
+// that leaves the page (`//host`, `/\host`) is told apart from one that stays on it.
+const SAME_ORIGIN = "https://same-origin.invalid";
+function resolvedOrigin(url, base) {
+    try {
+        return new URL(url, base).origin;
+    }
+    catch {
+        return null;
+    }
+}
+// A relative URL goes to the page's origin, which only a browser has.
+function pageHref() {
+    const location = "location" in globalThis ? globalThis.location : undefined;
+    if (location && typeof location === "object" && "href" in location && typeof location.href === "string")
+        return location.href;
+    return undefined;
+}
+function sendsTokenTo(config, origins) {
+    const baseURL = own(config, "baseURL");
+    const url = buildFullPath(baseURL, own(config, "url"), own(config, "allowAbsoluteUrls"), config);
+    if (origins) {
+        const origin = resolvedOrigin(url, isAbsoluteURL(url) ? undefined : pageHref());
+        return origin !== null && origins.includes(origin);
+    }
+    if (typeof baseURL === "string" && isAbsoluteURL(baseURL)) {
+        return resolvedOrigin(url, baseURL) === resolvedOrigin(baseURL, undefined);
+    }
+    return !isAbsoluteURL(url) && resolvedOrigin(url, SAME_ORIGIN) === SAME_ORIGIN;
+}
+/**
+ * Sets `Authorization: Bearer <token>` on requests to the API it guards, asking `getToken` each
+ * time, and provides the `auth` capability so later plugins (for example a token-refresh plugin)
+ * can ask for a token too. A header the request already has is kept unless `overwrite` is set.
+ * The token goes only to the `baseURL` origin when `baseURL` is absolute, otherwise only to
+ * relative request URLs; `origins` replaces that rule.
+ */
+export function authBearer(getToken, options = {}) {
+    if (typeof getToken !== "function") {
+        throw new FaxiosError("authBearer: getToken must be a function", FaxiosError.ERR_BAD_OPTION_VALUE);
+    }
+    // Callers without TypeScript can pass anything.
+    const given = options;
+    if (given === null || typeof given !== "object") {
+        throw new FaxiosError("authBearer options must be an object", FaxiosError.ERR_BAD_OPTION_VALUE);
+    }
+    validator.assertOptions(options, optionsSchema, false);
+    const overwrite = own(options, "overwrite") ?? false;
+    const scheme = own(options, "scheme") ?? "Bearer";
+    const header = own(options, "header") ?? "Authorization";
+    const origins = own(options, "origins")?.map(o => originOf(o)) ?? null;
+    const auth = { getToken: async () => getToken() };
+    return definePlugin({
+        name: "authBearer",
+        provides: { auth },
+        middleware: async (ctx, next) => {
+            if ((!overwrite && ctx.config.headers.has(header)) || !sendsTokenTo(ctx.config, origins))
+                return next(ctx);
+            const token = await auth.getToken();
+            // On a copy: middleware that calls next() again (retry installed before this plugin) comes
+            // back through here without the header, so every try asks for a fresh token.
+            const headers = new FaxiosHeaders(ctx.config.headers).set(header, scheme ? `${scheme} ${token}` : token, true);
+            const config = { ...ctx.config };
+            config.headers = headers;
+            return next({ ...ctx, config });
+        },
+    });
+}
+//# sourceMappingURL=authBearer.js.map

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

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

package/dist/lib/plugins/definePlugin.d.ts

@@ -0,0 +1,21 @@
+import type { FaxiosMiddleware, FaxiosPlugin } from "../types.js";
+type Slot<T> = [keyof T] extends [never] ? unknown : T;
+type RequiredCapabilities<TCapabilities, TProvides> = [keyof TProvides] extends [never] ? Slot<TCapabilities> : Slot<{
+    [K in keyof TCapabilities as K extends keyof TProvides ? never : K]: TCapabilities[K];
+}>;
+/**
+ * Builds a plugin for `use()` and infers its `FaxiosPlugin` slots from the object: `provides` from
+ * the `provides` value, `options` and `requires` from the context type the middleware annotates
+ * (`ctx: FaxiosContext<Options, Capabilities>`). Capabilities the plugin provides itself don't
+ * count as required. Returns the same object.
+ */
+export declare function definePlugin<TProvides = {}, TOptions = {}, TCapabilities = TProvides>(plugin: {
+    name: string;
+    provides?: TProvides & NoInfer<Pick<TCapabilities, keyof TProvides & keyof TCapabilities>>;
+    middleware: FaxiosMiddleware<TOptions, TCapabilities>;
+}): FaxiosPlugin<{
+    requires: RequiredCapabilities<TCapabilities, TProvides>;
+    provides: Slot<TProvides>;
+    options: Slot<TOptions>;
+}>;
+export {};

package/dist/lib/plugins/definePlugin.js

@@ -0,0 +1,14 @@
+// @ts-self-types="./definePlugin.d.ts" — required for Deno: maps built .js to adjacent .d.ts in dist/
+// The `@gcmdev/faxios/plugins` entry point. The built-in plugins have their own subpaths.
+/**
+ * Builds a plugin for `use()` and infers its `FaxiosPlugin` slots from the object: `provides` from
+ * the `provides` value, `options` and `requires` from the context type the middleware annotates
+ * (`ctx: FaxiosContext<Options, Capabilities>`). Capabilities the plugin provides itself don't
+ * count as required. Returns the same object.
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- `{}`: no capabilities or options, as in FaxiosContext
+export function definePlugin(plugin) {
+    // Only the types change: use() reads the fields at install time, as it does for any plugin.
+    return plugin;
+}
+//# sourceMappingURL=definePlugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definePlugin.js","sourceRoot":"","sources":["../../../src/lib/plugins/definePlugin.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,0FAA0F;AAY1F;;;;;GAKG;AACH,4HAA4H;AAC5H,MAAM,UAAU,YAAY,CAA2D,MAMtF;IAKC,4FAA4F;IAC5F,OAAO,MAAe,CAAC;AACzB,CAAC"}

package/dist/lib/plugins/retry.d.ts

@@ -0,0 +1,65 @@
+import type { FaxiosPlugin, Method } from "../types.js";
+export type RetryOptions = {
+    /** Total tries, counting the first request. Default 3. */
+    attempts?: number;
+    /**
+     * Whether the try that just failed should be retried. `attempt` counts from 1.
+     * Default: network errors, timeouts and the `statuses`; never a cancellation. A custom `retryOn`
+     * replaces that whole predicate, so `statuses` is ignored when both are set. retryOn decides
+     * only within `methods`; to retry POST, list it in `methods`.
+     */
+    retryOn?: (error: unknown, attempt: number) => boolean;
+    /**
+     * Response statuses the default predicate retries. Default 408, 429, 500, 502, 503 and 504.
+     * Ignored when `retryOn` is set.
+     */
+    statuses?: ReadonlyArray<number>;
+    /**
+     * Milliseconds to wait before the next try, or a function of the try that failed. Default 100ms,
+     * doubling. Capped at `maxDelay`, then jittered. A 429 or 503 with a `Retry-After` header waits
+     * that long instead, unless `respectRetryAfter` is `false`.
+     */
+    delay?: number | ((attempt: number, error: unknown) => number);
+    /** The most the computed backoff waits, in milliseconds. Default 30 000. Doesn't apply to `Retry-After`. */
+    maxDelay?: number;
+    /**
+     * `"full"` (default) waits a random time between 0 and the capped backoff, so clients that failed
+     * together don't retry together; `"none"` waits the capped backoff. Doesn't apply to `Retry-After`.
+     */
+    jitter?: "full" | "none";
+    /**
+     * The longest `Retry-After` (seconds or an HTTP date, on a 429 or 503) to wait, in milliseconds.
+     * Default 300 000 (5 minutes). A longer one rejects with the response's error instead of retrying.
+     * Ignored when `respectRetryAfter` is `false`.
+     */
+    maxRetryAfter?: number;
+    /**
+     * Whether a 429 or 503's `Retry-After` header sets the wait. Default `true`. With `false`, every
+     * retry waits the computed backoff and `maxRetryAfter` doesn't apply; which requests retry doesn't
+     * change. Turn it off when another plugin, such as a queue throttle, honours `Retry-After` itself.
+     */
+    respectRetryAfter?: boolean;
+    /**
+     * Called before each wait with the error, the try that failed and the wait in milliseconds. If it
+     * throws, the request rejects with that error and stops retrying.
+     */
+    onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
+    /**
+     * HTTP methods that may be retried, in any case. Default: GET, HEAD, OPTIONS, PUT, DELETE and
+     * QUERY. POST and PATCH aren't idempotent, so add them only if your API dedupes repeats. A request
+     * whose method isn't listed is never retried, whatever `retryOn` or `statuses` say.
+     */
+    methods?: ReadonlyArray<Method>;
+};
+/** Per-request override: `false` turns retries off, an object overrides the plugin's options. */
+export type RetryRequestOptions = {
+    retry?: RetryOptions | false;
+};
+/**
+ * Retries failed requests by calling `next` again. Each `next` dispatches its own copy of the
+ * config, so every try starts from the same input. Install it inside middleware that should run
+ * once per request (for example `timing` installed first measures all tries together).
+ */
+export declare function retry(options?: RetryOptions): FaxiosPlugin<{
+    options: RetryRequestOptions;
+}>;