@faremeter/test-harness 0.16.0

package/dist/src/interceptors/responses.d.ts

@@ -0,0 +1,11 @@
+import type { x402PaymentRequirements } from "@faremeter/types/x402";
+export declare function jsonResponse(status: number, body: object): Response;
+export declare function verifyFailedResponse(reason: string): Response;
+export declare function verifySuccessResponse(): Response;
+export declare function settleFailedResponse(error: string): Response;
+export declare function settleSuccessResponse(txHash: string, networkId: string): Response;
+export declare function paymentRequiredResponse(accepts: x402PaymentRequirements[]): Response;
+export declare function networkError(message?: string): Error;
+export declare function timeoutError(): Error;
+export declare function httpError(status: number, message: string): Response;
+//# sourceMappingURL=responses.d.ts.map

package/dist/src/interceptors/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../src/interceptors/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAKnE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAK7D;AAED,wBAAgB,qBAAqB,IAAI,QAAQ,CAIhD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAO5D;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,QAAQ,CAMV;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAAE,GACjC,QAAQ,CAKV;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAkB,GAAG,KAAK,CAE7D;AAED,wBAAgB,YAAY,IAAI,KAAK,CAEpC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEnE"}

package/dist/src/interceptors/responses.js

@@ -0,0 +1,47 @@
+export function jsonResponse(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+export function verifyFailedResponse(reason) {
+    return jsonResponse(200, {
+        isValid: false,
+        invalidReason: reason,
+    });
+}
+export function verifySuccessResponse() {
+    return jsonResponse(200, {
+        isValid: true,
+    });
+}
+export function settleFailedResponse(error) {
+    return jsonResponse(200, {
+        success: false,
+        error,
+        txHash: null,
+        networkId: null,
+    });
+}
+export function settleSuccessResponse(txHash, networkId) {
+    return jsonResponse(200, {
+        success: true,
+        txHash,
+        networkId,
+    });
+}
+export function paymentRequiredResponse(accepts) {
+    return jsonResponse(402, {
+        x402Version: 1,
+        accepts,
+    });
+}
+export function networkError(message = "Network error") {
+    return new Error(message);
+}
+export function timeoutError() {
+    return new Error("Request timed out");
+}
+export function httpError(status, message) {
+    return jsonResponse(status, { error: message });
+}

package/dist/src/interceptors/types.d.ts

@@ -0,0 +1,20 @@
+export type Interceptor = (fetch: typeof globalThis.fetch) => typeof globalThis.fetch;
+/**
+ * Compose multiple interceptors into a single interceptor.
+ *
+ * Interceptors are applied right-to-left (last interceptor wraps innermost).
+ * This means the first interceptor in the array sees the request first and
+ * the response last.
+ *
+ * @example
+ * ```ts
+ * const composed = composeInterceptors(
+ *   loggingInterceptor,    // Sees request first, response last
+ *   failureInterceptor,    // Sees request second
+ *   delayInterceptor,      // Innermost - closest to actual fetch
+ * );
+ * ```
+ */
+export declare function composeInterceptors(...interceptors: Interceptor[]): Interceptor;
+export type RequestMatcher = (url: string, init?: RequestInit) => boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/interceptors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/interceptors/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,KAC3B,OAAO,UAAU,CAAC,KAAK,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,YAAY,EAAE,WAAW,EAAE,GAC7B,WAAW,CAMb;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC"}

package/dist/src/interceptors/types.js

@@ -0,0 +1,19 @@
+/**
+ * Compose multiple interceptors into a single interceptor.
+ *
+ * Interceptors are applied right-to-left (last interceptor wraps innermost).
+ * This means the first interceptor in the array sees the request first and
+ * the response last.
+ *
+ * @example
+ * ```ts
+ * const composed = composeInterceptors(
+ *   loggingInterceptor,    // Sees request first, response last
+ *   failureInterceptor,    // Sees request second
+ *   delayInterceptor,      // Innermost - closest to actual fetch
+ * );
+ * ```
+ */
+export function composeInterceptors(...interceptors) {
+    return (baseFetch) => interceptors.reduceRight((fetch, interceptor) => interceptor(fetch), baseFetch);
+}

package/dist/src/interceptors/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getURLFromRequestInfo(input: RequestInfo | URL | string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/interceptors/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/interceptors/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,GAAG,GAAG,GAAG,MAAM,GAChC,MAAM,CAUR"}

package/dist/src/interceptors/utils.js

@@ -0,0 +1,9 @@
+export function getURLFromRequestInfo(input) {
+    if (typeof input === "string") {
+        return input;
+    }
+    if (input instanceof URL) {
+        return input.href;
+    }
+    return input.url;
+}

package/dist/src/scheme/client.d.ts

@@ -0,0 +1,16 @@
+import type { PaymentHandler } from "@faremeter/types/client";
+import type { x402PaymentRequirements } from "@faremeter/types/x402";
+import { type TestPaymentPayload } from "./types.js";
+export type CreateTestPaymentHandlerOpts = {
+    onMatch?: (requirements: x402PaymentRequirements) => void;
+    onExec?: (requirements: x402PaymentRequirements, payload: TestPaymentPayload) => void;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Create a test payment handler.
+ *
+ * This handler creates simple test payment payloads without any cryptographic
+ * operations, making it suitable for testing the x402 protocol flow.
+ */
+export declare function createTestPaymentHandler(opts?: CreateTestPaymentHandlerOpts): PaymentHandler;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/scheme/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/scheme/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC1D,MAAM,CAAC,EAAE,CACP,YAAY,EAAE,uBAAuB,EACrC,OAAO,EAAE,kBAAkB,KACxB,IAAI,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,4BAAiC,GACtC,cAAc,CAiChB"}

package/dist/src/scheme/client.js

@@ -0,0 +1,38 @@
+import { TEST_SCHEME, TEST_NETWORK } from "./constants.js";
+import { generateTestId } from "./types.js";
+function isMatchingRequirement(req) {
+    return (req.scheme.toLowerCase() === TEST_SCHEME.toLowerCase() &&
+        req.network.toLowerCase() === TEST_NETWORK.toLowerCase());
+}
+/**
+ * Create a test payment handler.
+ *
+ * This handler creates simple test payment payloads without any cryptographic
+ * operations, making it suitable for testing the x402 protocol flow.
+ */
+export function createTestPaymentHandler(opts = {}) {
+    const { onMatch, onExec, metadata } = opts;
+    return async function handlePayment(_context, accepts) {
+        const compatibleRequirements = accepts.filter(isMatchingRequirement);
+        return compatibleRequirements.map((requirements) => {
+            if (onMatch) {
+                onMatch(requirements);
+            }
+            return {
+                requirements,
+                exec: async () => {
+                    const payload = {
+                        testId: generateTestId(),
+                        amount: requirements.maxAmountRequired,
+                        timestamp: Date.now(),
+                        metadata,
+                    };
+                    if (onExec) {
+                        onExec(requirements, payload);
+                    }
+                    return { payload };
+                },
+            };
+        });
+    };
+}

package/dist/src/scheme/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const TEST_SCHEME = "test";
+export declare const TEST_NETWORK = "test-local";
+export declare const TEST_ASSET = "TEST";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/scheme/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/scheme/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,eAAO,MAAM,UAAU,SAAS,CAAC"}

package/dist/src/scheme/constants.js

@@ -0,0 +1,3 @@
+export const TEST_SCHEME = "test";
+export const TEST_NETWORK = "test-local";
+export const TEST_ASSET = "TEST";

package/dist/src/scheme/facilitator.d.ts

@@ -0,0 +1,16 @@
+import type { x402PaymentRequirements, x402PaymentPayload } from "@faremeter/types/x402";
+import type { FacilitatorHandler } from "@faremeter/types/facilitator";
+import type { TestPaymentPayload } from "./types.js";
+export type CreateTestFacilitatorHandlerOpts = {
+    payTo: string;
+    onVerify?: (requirements: x402PaymentRequirements, payload: x402PaymentPayload, testPayload: TestPaymentPayload) => void;
+    onSettle?: (requirements: x402PaymentRequirements, payload: x402PaymentPayload, testPayload: TestPaymentPayload) => void;
+};
+/**
+ * Create a test facilitator handler.
+ *
+ * This handler validates protocol structure without any cryptographic
+ * operations, making it suitable for testing the x402 protocol flow.
+ */
+export declare function createTestFacilitatorHandler(opts: CreateTestFacilitatorHandlerOpts): FacilitatorHandler;
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/src/scheme/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../src/scheme/facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAInB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,CACT,YAAY,EAAE,uBAAuB,EACrC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,kBAAkB,KAC5B,IAAI,CAAC;IACV,QAAQ,CAAC,EAAE,CACT,YAAY,EAAE,uBAAuB,EACrC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,kBAAkB,KAC5B,IAAI,CAAC;CACX,CAAC;AAuCF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,gCAAgC,GACrC,kBAAkB,CAiHpB"}

package/dist/src/scheme/facilitator.js

@@ -0,0 +1,121 @@
+import { TEST_SCHEME, TEST_NETWORK, TEST_ASSET } from "./constants.js";
+function isMatchingRequirement(req) {
+    return (req.scheme.toLowerCase() === TEST_SCHEME.toLowerCase() &&
+        req.network.toLowerCase() === TEST_NETWORK.toLowerCase());
+}
+function validateTestPayload(payload) {
+    const p = payload;
+    if (typeof p.testId !== "string" || p.testId.length === 0) {
+        return { valid: false, error: "Missing or invalid testId" };
+    }
+    if (typeof p.amount !== "string" || p.amount.length === 0) {
+        return { valid: false, error: "Missing or invalid amount" };
+    }
+    if (typeof p.timestamp !== "number" || p.timestamp <= 0) {
+        return { valid: false, error: "Missing or invalid timestamp" };
+    }
+    return {
+        valid: true,
+        payload: {
+            testId: p.testId,
+            amount: p.amount,
+            timestamp: p.timestamp,
+            metadata: p.metadata,
+        },
+    };
+}
+/**
+ * Create a test facilitator handler.
+ *
+ * This handler validates protocol structure without any cryptographic
+ * operations, making it suitable for testing the x402 protocol flow.
+ */
+export function createTestFacilitatorHandler(opts) {
+    const { payTo, onVerify, onSettle } = opts;
+    const getSupported = () => {
+        return [
+            Promise.resolve({
+                x402Version: 1,
+                scheme: TEST_SCHEME,
+                network: TEST_NETWORK,
+            }),
+        ];
+    };
+    const getRequirements = async (req) => {
+        return req.filter(isMatchingRequirement).map((r) => ({
+            ...r,
+            asset: r.asset || TEST_ASSET,
+            payTo: r.payTo || payTo,
+            maxTimeoutSeconds: r.maxTimeoutSeconds || 300,
+        }));
+    };
+    const handleVerify = async (requirements, payment) => {
+        if (!isMatchingRequirement(requirements)) {
+            return null; // Not for us, let another handler try
+        }
+        const result = validateTestPayload(payment.payload);
+        if (!result.valid) {
+            return { isValid: false, invalidReason: result.error };
+        }
+        const testPayload = result.payload;
+        // Verify amount matches
+        if (testPayload.amount !== requirements.maxAmountRequired) {
+            return { isValid: false, invalidReason: "Amount mismatch" };
+        }
+        // Verify payment is to the correct address
+        if (requirements.payTo.toLowerCase() !== payTo.toLowerCase()) {
+            return { isValid: false, invalidReason: "Payment to wrong address" };
+        }
+        if (onVerify) {
+            onVerify(requirements, payment, testPayload);
+        }
+        return { isValid: true };
+    };
+    const handleSettle = async (requirements, payment) => {
+        if (!isMatchingRequirement(requirements)) {
+            return null; // Not for us, let another handler try
+        }
+        const result = validateTestPayload(payment.payload);
+        if (!result.valid) {
+            return {
+                success: false,
+                error: result.error,
+                txHash: null,
+                networkId: null,
+            };
+        }
+        const testPayload = result.payload;
+        // Verify amount matches
+        if (testPayload.amount !== requirements.maxAmountRequired) {
+            return {
+                success: false,
+                error: "Amount mismatch",
+                txHash: null,
+                networkId: null,
+            };
+        }
+        // Verify payment is to the correct address
+        if (requirements.payTo.toLowerCase() !== payTo.toLowerCase()) {
+            return {
+                success: false,
+                error: "Payment to wrong address",
+                txHash: null,
+                networkId: null,
+            };
+        }
+        if (onSettle) {
+            onSettle(requirements, payment, testPayload);
+        }
+        return {
+            success: true,
+            txHash: `test-tx-${testPayload.testId}`,
+            networkId: TEST_NETWORK,
+        };
+    };
+    return {
+        getSupported,
+        getRequirements,
+        handleVerify,
+        handleSettle,
+    };
+}

package/dist/src/scheme/types.d.ts

@@ -0,0 +1,8 @@
+export type TestPaymentPayload = {
+    testId: string;
+    amount: string;
+    timestamp: number;
+    metadata?: Record<string, unknown> | undefined;
+};
+export declare function generateTestId(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/scheme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/scheme/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAChD,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/src/scheme/types.js

@@ -0,0 +1,3 @@
+export function generateTestId() {
+    return `test-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}

package/dist/src/testing/console.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Suppresses console.error output during tests.
+ * Returns a restore function to be called in teardown.
+ *
+ * Usage with tap:
+ *   t.teardown(suppressConsoleErrors());
+ */
+export declare function suppressConsoleErrors(): () => void;
+//# sourceMappingURL=console.d.ts.map

package/dist/src/testing/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/testing/console.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,IAAI,CAMlD"}

package/dist/src/testing/console.js

@@ -0,0 +1,15 @@
+/* eslint-disable no-console, @typescript-eslint/no-empty-function */
+/**
+ * Suppresses console.error output during tests.
+ * Returns a restore function to be called in teardown.
+ *
+ * Usage with tap:
+ *   t.teardown(suppressConsoleErrors());
+ */
+export function suppressConsoleErrors() {
+    const original = console.error;
+    console.error = () => { };
+    return () => {
+        console.error = original;
+    };
+}