@faremeter/test-harness 0.16.0

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,41 @@
+# @faremeter/test-harness
+
+In-process test harness for x402 protocol testing without network calls.
+
+## Installation
+
+```bash
+pnpm install @faremeter/test-harness
+```
+
+## Features
+
+- In-process testing - No network calls or external services
+- Interceptor pattern - Inject failures, delays, and custom responses
+- Composable - Combine interceptors for complex scenarios
+- Test scheme - Simple payment scheme for protocol validation
+- Framework agnostic - Works with any test runner
+
+## API Reference
+
+<!-- TSDOC_START -->
+
+<!-- TSDOC_END -->
+
+## Examples
+
+See integration tests in the [faremeter repository](https://github.com/faremeter/faremeter/tree/main/tests):
+
+- [Success flow](https://github.com/faremeter/faremeter/blob/main/tests/x402v1/success.test.ts)
+- [Verification failures](https://github.com/faremeter/faremeter/blob/main/tests/x402v1/verification-failures.test.ts)
+- [Settlement failures](https://github.com/faremeter/faremeter/blob/main/tests/x402v1/settlement-failures.test.ts)
+
+## Related Packages
+
+- [@faremeter/fetch](https://www.npmjs.com/package/@faremeter/fetch) - Client-side fetch wrapper
+- [@faremeter/middleware](https://www.npmjs.com/package/@faremeter/middleware) - Server-side middleware
+- [@faremeter/facilitator](https://www.npmjs.com/package/@faremeter/facilitator) - Payment facilitator service
+
+## License
+
+LGPL-3.0-only

package/dist/src/choosers.d.ts

@@ -0,0 +1,12 @@
+import type { PaymentExecer } from "@faremeter/types/client";
+export declare function chooseFirst(execers: PaymentExecer[]): PaymentExecer;
+export declare function chooseCheapest(execers: PaymentExecer[]): PaymentExecer;
+export declare function chooseMostExpensive(execers: PaymentExecer[]): PaymentExecer;
+export declare function chooseByAsset(asset: string): (execers: PaymentExecer[]) => PaymentExecer;
+export declare function chooseByNetwork(network: string): (execers: PaymentExecer[]) => PaymentExecer;
+export declare function chooseByScheme(scheme: string): (execers: PaymentExecer[]) => PaymentExecer;
+export declare function chooseByIndex(index: number): (execers: PaymentExecer[]) => PaymentExecer;
+export declare function chooseNone(): never;
+export declare function chooseWithInspection(inspector: (execers: PaymentExecer[]) => void, inner: (execers: PaymentExecer[]) => PaymentExecer): (execers: PaymentExecer[]) => PaymentExecer;
+export declare function chooseWithFilter(filter: (execer: PaymentExecer) => boolean, inner: (execers: PaymentExecer[]) => PaymentExecer): (execers: PaymentExecer[]) => PaymentExecer;
+//# sourceMappingURL=choosers.d.ts.map

package/dist/src/choosers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choosers.d.ts","sourceRoot":"","sources":["../../src/choosers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,CASnE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,CAUtE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,CAU3E;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GACZ,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,CAU7C;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GACd,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,CAU7C;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GACb,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,CAU7C;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GACZ,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,CAU7C;AAED,wBAAgB,UAAU,IAAI,KAAK,CAElC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,IAAI,EAC7C,KAAK,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,GACjD,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,CAK7C;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,EAC1C,KAAK,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,GACjD,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,CAK7C"}

package/dist/src/choosers.js

@@ -0,0 +1,79 @@
+export function chooseFirst(execers) {
+    if (execers.length === 0) {
+        throw new Error("No payment options available");
+    }
+    const first = execers[0];
+    if (!first) {
+        throw new Error("No payment options available");
+    }
+    return first;
+}
+export function chooseCheapest(execers) {
+    if (execers.length === 0) {
+        throw new Error("No payment options available");
+    }
+    return execers.reduce((cheapest, current) => BigInt(current.requirements.maxAmountRequired) <
+        BigInt(cheapest.requirements.maxAmountRequired)
+        ? current
+        : cheapest);
+}
+export function chooseMostExpensive(execers) {
+    if (execers.length === 0) {
+        throw new Error("No payment options available");
+    }
+    return execers.reduce((expensive, current) => BigInt(current.requirements.maxAmountRequired) >
+        BigInt(expensive.requirements.maxAmountRequired)
+        ? current
+        : expensive);
+}
+export function chooseByAsset(asset) {
+    return (execers) => {
+        const match = execers.find((e) => e.requirements.asset.toLowerCase() === asset.toLowerCase());
+        if (!match) {
+            throw new Error(`No payment option for asset: ${asset}`);
+        }
+        return match;
+    };
+}
+export function chooseByNetwork(network) {
+    return (execers) => {
+        const match = execers.find((e) => e.requirements.network.toLowerCase() === network.toLowerCase());
+        if (!match) {
+            throw new Error(`No payment option for network: ${network}`);
+        }
+        return match;
+    };
+}
+export function chooseByScheme(scheme) {
+    return (execers) => {
+        const match = execers.find((e) => e.requirements.scheme.toLowerCase() === scheme.toLowerCase());
+        if (!match) {
+            throw new Error(`No payment option for scheme: ${scheme}`);
+        }
+        return match;
+    };
+}
+export function chooseByIndex(index) {
+    return (execers) => {
+        const execer = execers[index];
+        if (!execer) {
+            throw new Error(`Index ${index} out of bounds (${execers.length} options available)`);
+        }
+        return execer;
+    };
+}
+export function chooseNone() {
+    throw new Error("No suitable payment option");
+}
+export function chooseWithInspection(inspector, inner) {
+    return (execers) => {
+        inspector(execers);
+        return inner(execers);
+    };
+}
+export function chooseWithFilter(filter, inner) {
+    return (execers) => {
+        const filtered = execers.filter(filter);
+        return inner(filtered);
+    };
+}

package/dist/src/harness/config.d.ts

@@ -0,0 +1,38 @@
+import type { FacilitatorHandler } from "@faremeter/types/facilitator";
+import type { PaymentHandler } from "@faremeter/types/client";
+import type { x402PaymentRequirements } from "@faremeter/types/x402";
+import type { Interceptor } from "../interceptors/types.js";
+export type SettleMode = "settle-only" | "verify-then-settle";
+export type TestHarnessConfig = {
+    /**
+     * Payment requirements the middleware accepts.
+     * Uses Partial because the facilitator will fill in missing fields.
+     */
+    accepts: Partial<x402PaymentRequirements>[];
+    /**
+     * Facilitator handlers to register.
+     * Multiple handlers can be provided for different schemes.
+     */
+    facilitatorHandlers: FacilitatorHandler[];
+    /**
+     * Client payment handlers.
+     * Multiple handlers can be provided for different schemes.
+     */
+    clientHandlers: PaymentHandler[];
+    /**
+     * Settlement mode for the middleware.
+     * @default "settle-only"
+     */
+    settleMode?: SettleMode;
+    /**
+     * Interceptors between test code and middleware.
+     * These see all requests from the wrapped fetch to the Hono app.
+     */
+    clientInterceptors?: Interceptor[];
+    /**
+     * Interceptors between middleware and facilitator.
+     * These see requests from middleware to facilitator endpoints.
+     */
+    middlewareInterceptors?: Interceptor[];
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/src/harness/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/harness/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,oBAAoB,CAAC;AAE9D,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;IAE5C;;;OAGG;IACH,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAE1C;;;OAGG;IACH,cAAc,EAAE,cAAc,EAAE,CAAC;IAEjC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAC;IAEnC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,WAAW,EAAE,CAAC;CACxC,CAAC"}

package/dist/src/harness/config.js

@@ -0,0 +1 @@
+export {};

package/dist/src/harness/defaults.d.ts

@@ -0,0 +1,8 @@
+import type { x402PaymentRequirements } from "@faremeter/types/x402";
+/**
+ * Creates a payment requirements object with test defaults.
+ * Override specific fields by passing a partial:
+ *   accepts({ maxAmountRequired: "500" })
+ */
+export declare function accepts(overrides?: Partial<x402PaymentRequirements>): x402PaymentRequirements;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/src/harness/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/harness/defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC3C,uBAAuB,CAazB"}

package/dist/src/harness/defaults.js

@@ -0,0 +1,20 @@
+import { TEST_SCHEME, TEST_NETWORK, TEST_ASSET } from "../scheme/constants.js";
+/**
+ * Creates a payment requirements object with test defaults.
+ * Override specific fields by passing a partial:
+ *   accepts({ maxAmountRequired: "500" })
+ */
+export function accepts(overrides) {
+    return {
+        scheme: TEST_SCHEME,
+        network: TEST_NETWORK,
+        maxAmountRequired: "100",
+        resource: "http://example.com/test",
+        description: "Test resource",
+        mimeType: "application/json",
+        payTo: "test-receiver",
+        maxTimeoutSeconds: 30,
+        asset: TEST_ASSET,
+        ...overrides,
+    };
+}

package/dist/src/harness/harness.d.ts

@@ -0,0 +1,70 @@
+import { Hono } from "hono";
+import type { PaymentExecer } from "@faremeter/types/client";
+import type { Interceptor } from "../interceptors/types.js";
+import type { TestHarnessConfig } from "./config.js";
+import type { ResourceHandler } from "./resource.js";
+/**
+ * TestHarness provides an in-process test environment for the x402 protocol.
+ *
+ * It connects client, middleware, and facilitator using function adapters
+ * instead of HTTP, allowing full protocol testing without network calls.
+ */
+export declare class TestHarness {
+    /**
+     * The internal Hono app containing facilitator and middleware routes.
+     */
+    readonly app: Hono;
+    private readonly config;
+    private readonly settleMode;
+    private resourceHandler;
+    private clientInterceptors;
+    private middlewareInterceptors;
+    /**
+     * Base URL used for internal routing.
+     */
+    private readonly baseUrl;
+    constructor(config: TestHarnessConfig);
+    /**
+     * Create the internal Hono app with facilitator and resource routes.
+     */
+    private createApp;
+    /**
+     * Create a fetch function for middleware->facilitator calls.
+     * This applies middleware interceptors and routes to the Hono app.
+     */
+    private createMiddlewareFetch;
+    /**
+     * Create a fetch function for client->middleware calls.
+     * This applies client interceptors and routes to the Hono app.
+     */
+    private createClientFetch;
+    /**
+     * Set the resource handler that responds after successful payment.
+     */
+    setResourceHandler(handler: ResourceHandler): void;
+    /**
+     * Create a fetch function that handles the full x402 payment flow.
+     *
+     * @param opts.payerChooser - Function to choose which payment option to use
+     */
+    createFetch(opts?: {
+        payerChooser?: ((execers: PaymentExecer[]) => PaymentExecer | Promise<PaymentExecer>) | undefined;
+    }): typeof fetch;
+    /**
+     * Add an interceptor to the client chain (between test code and middleware).
+     */
+    addClientInterceptor(interceptor: Interceptor): void;
+    /**
+     * Add an interceptor to the middleware chain (between middleware and facilitator).
+     */
+    addMiddlewareInterceptor(interceptor: Interceptor): void;
+    /**
+     * Clear all interceptors added after construction.
+     */
+    clearInterceptors(): void;
+    /**
+     * Reset harness state (interceptors, resource handler).
+     */
+    reset(): void;
+}
+//# sourceMappingURL=harness.d.ts.map

package/dist/src/harness/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/harness/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQ7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAanE;;;;;GAKG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,sBAAsB,CAAqB;IAEnD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,MAAM,EAAE,iBAAiB;IASrC;;OAEG;IACH,OAAO,CAAC,SAAS;IAiGjB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIlD;;;;OAIG;IACH,WAAW,CAAC,IAAI,CAAC,EAAE;QACjB,YAAY,CAAC,EACT,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,GACtE,SAAS,CAAC;KACf,GAAG,OAAO,KAAK;IAgBhB;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAIpD;;OAEG;IACH,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAIxD;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAOzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/src/harness/harness.js

@@ -0,0 +1,205 @@
+import { Hono } from "hono";
+import { createFacilitatorRoutes } from "@faremeter/facilitator";
+import { wrap } from "@faremeter/fetch";
+import { handleMiddlewareRequest, getPaymentRequiredResponse, } from "@faremeter/middleware/common";
+import { composeInterceptors } from "../interceptors/types.js";
+import { getURLFromRequestInfo } from "../interceptors/utils.js";
+import { defaultResourceHandler } from "./resource.js";
+/**
+ * TestHarness provides an in-process test environment for the x402 protocol.
+ *
+ * It connects client, middleware, and facilitator using function adapters
+ * instead of HTTP, allowing full protocol testing without network calls.
+ */
+export class TestHarness {
+    /**
+     * The internal Hono app containing facilitator and middleware routes.
+     */
+    app;
+    config;
+    settleMode;
+    resourceHandler = defaultResourceHandler;
+    clientInterceptors = [];
+    middlewareInterceptors = [];
+    /**
+     * Base URL used for internal routing.
+     */
+    baseUrl = "http://test-harness";
+    constructor(config) {
+        this.config = config;
+        this.settleMode = config.settleMode ?? "settle-only";
+        this.clientInterceptors = [...(config.clientInterceptors ?? [])];
+        this.middlewareInterceptors = [...(config.middlewareInterceptors ?? [])];
+        this.app = this.createApp();
+    }
+    /**
+     * Create the internal Hono app with facilitator and resource routes.
+     */
+    createApp() {
+        const app = new Hono();
+        // Suppress error logging in test harness - errors are expected in tests
+        // and should be converted to 500 responses without stack traces
+        app.onError((err, c) => {
+            return c.json({ error: err.message }, 500);
+        });
+        // Mount facilitator routes
+        const facilitatorRoutes = createFacilitatorRoutes({
+            handlers: this.config.facilitatorHandlers,
+        });
+        app.route("/facilitator", facilitatorRoutes);
+        // Resource routes are handled dynamically via the middleware
+        // We use a catch-all that applies payment middleware
+        app.all("/*", async (c) => {
+            // Create a fetch for middleware->facilitator calls that:
+            // 1. Applies middleware interceptors
+            // 2. Routes to the Hono app
+            const middlewareFetch = this.createMiddlewareFetch();
+            // Track state for resource handler
+            const state = {};
+            const result = await handleMiddlewareRequest({
+                facilitatorURL: `${this.baseUrl}/facilitator`,
+                accepts: this.config.accepts,
+                resource: c.req.url,
+                fetch: middlewareFetch,
+                getHeader: (key) => c.req.header(key),
+                getPaymentRequiredResponse,
+                sendJSONResponse: (status, body) => {
+                    c.status(status);
+                    return c.json(body);
+                },
+                body: async (context) => {
+                    const { paymentRequirements, paymentPayload, settle, verify } = context;
+                    // Store for resource handler
+                    state.paymentRequirements = paymentRequirements;
+                    state.paymentPayload = paymentPayload;
+                    if (this.settleMode === "verify-then-settle") {
+                        const verifyResult = await verify();
+                        if (!verifyResult.success) {
+                            return verifyResult.errorResponse;
+                        }
+                        state.verifyResponse = verifyResult.facilitatorResponse;
+                        const settleResult = await settle();
+                        if (!settleResult.success) {
+                            return settleResult.errorResponse;
+                        }
+                        state.settleResponse = settleResult.facilitatorResponse;
+                    }
+                    else {
+                        const settleResult = await settle();
+                        if (!settleResult.success) {
+                            return settleResult.errorResponse;
+                        }
+                        state.settleResponse = settleResult.facilitatorResponse;
+                    }
+                    // Payment successful - call resource handler
+                    const ctx = {
+                        resource: c.req.url,
+                        request: c.req.raw,
+                        paymentRequirements,
+                        paymentPayload,
+                        settleResponse: state.settleResponse,
+                        verifyResponse: state.verifyResponse,
+                    };
+                    const resourceResult = await this.resourceHandler(ctx);
+                    // Set response headers
+                    if (resourceResult.headers) {
+                        for (const [key, value] of Object.entries(resourceResult.headers)) {
+                            c.header(key, value);
+                        }
+                    }
+                    c.status(resourceResult.status);
+                    return c.json(resourceResult.body);
+                },
+            });
+            return result;
+        });
+        return app;
+    }
+    /**
+     * Create a fetch function for middleware->facilitator calls.
+     * This applies middleware interceptors and routes to the Hono app.
+     */
+    createMiddlewareFetch() {
+        const baseFetch = async (input, init) => {
+            const url = getURLFromRequestInfo(input);
+            // Route to our Hono app
+            const path = url.replace(this.baseUrl, "");
+            return this.app.request(path, init);
+        };
+        if (this.middlewareInterceptors.length === 0) {
+            return baseFetch;
+        }
+        return composeInterceptors(...this.middlewareInterceptors)(baseFetch);
+    }
+    /**
+     * Create a fetch function for client->middleware calls.
+     * This applies client interceptors and routes to the Hono app.
+     */
+    createClientFetch() {
+        const baseFetch = async (input, init) => {
+            const url = getURLFromRequestInfo(input);
+            // Route to our Hono app - strip any base URL
+            let path = url;
+            if (path.startsWith("http://") || path.startsWith("https://")) {
+                const urlObj = new URL(path);
+                path = urlObj.pathname + urlObj.search;
+            }
+            return this.app.request(path, init);
+        };
+        if (this.clientInterceptors.length === 0) {
+            return baseFetch;
+        }
+        return composeInterceptors(...this.clientInterceptors)(baseFetch);
+    }
+    /**
+     * Set the resource handler that responds after successful payment.
+     */
+    setResourceHandler(handler) {
+        this.resourceHandler = handler;
+    }
+    /**
+     * Create a fetch function that handles the full x402 payment flow.
+     *
+     * @param opts.payerChooser - Function to choose which payment option to use
+     */
+    createFetch(opts) {
+        const clientFetch = this.createClientFetch();
+        const payerChooser = opts?.payerChooser;
+        return wrap(clientFetch, {
+            handlers: this.config.clientHandlers,
+            ...(payerChooser
+                ? {
+                    payerChooser: async (execers) => payerChooser(execers),
+                }
+                : {}),
+        });
+    }
+    /**
+     * Add an interceptor to the client chain (between test code and middleware).
+     */
+    addClientInterceptor(interceptor) {
+        this.clientInterceptors.push(interceptor);
+    }
+    /**
+     * Add an interceptor to the middleware chain (between middleware and facilitator).
+     */
+    addMiddlewareInterceptor(interceptor) {
+        this.middlewareInterceptors.push(interceptor);
+    }
+    /**
+     * Clear all interceptors added after construction.
+     */
+    clearInterceptors() {
+        this.clientInterceptors = [...(this.config.clientInterceptors ?? [])];
+        this.middlewareInterceptors = [
+            ...(this.config.middlewareInterceptors ?? []),
+        ];
+    }
+    /**
+     * Reset harness state (interceptors, resource handler).
+     */
+    reset() {
+        this.clearInterceptors();
+        this.resourceHandler = defaultResourceHandler;
+    }
+}

package/dist/src/harness/harness.test.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env pnpm tsx
+export {};
+//# sourceMappingURL=harness.test.d.ts.map

package/dist/src/harness/harness.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.test.d.ts","sourceRoot":"","sources":["../../../src/harness/harness.test.ts"],"names":[],"mappings":""}