paybridge 0.2.1 → 0.2.3

package/README.md

@@ -3,6 +3,7 @@
 > **One API. Every payment provider. 🌍**
 
 [![npm version](https://img.shields.io/npm/v/paybridge.svg)](https://www.npmjs.com/package/paybridge)
+[![CI](https://github.com/kobie3717/paybridge/actions/workflows/test.yml/badge.svg)](https://github.com/kobie3717/paybridge/actions/workflows/test.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/Y2jCXNGgE)

package/dist/crypto/moonpay.js

@@ -10,6 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MoonPayProvider = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 class MoonPayProvider extends base_1.CryptoRampProvider {
     constructor(config) {
         super();
@@ -25,14 +26,26 @@ class MoonPayProvider extends base_1.CryptoRampProvider {
             : 'https://buy.moonpay.com';
     }
     async getQuote(direction, fiatAmount, fiatCurrency, cryptoAsset, _network) {
-        const params = new URLSearchParams({
-            apiKey: this.apiKey,
-            baseCurrencyCode: fiatCurrency.toLowerCase(),
-            quoteCurrencyCode: cryptoAsset.toLowerCase(),
-            baseCurrencyAmount: fiatAmount.toString(),
-        });
-        const url = `${this.baseUrl}/v3/currencies/${cryptoAsset.toLowerCase()}/quote?${params}`;
-        const response = await fetch(url);
+        const endpoint = direction === 'on' ? 'quote' : 'sell_quote';
+        let params;
+        if (direction === 'on') {
+            params = new URLSearchParams({
+                apiKey: this.apiKey,
+                baseCurrencyCode: fiatCurrency.toLowerCase(),
+                quoteCurrencyCode: cryptoAsset.toLowerCase(),
+                baseCurrencyAmount: fiatAmount.toString(),
+            });
+        }
+        else {
+            params = new URLSearchParams({
+                apiKey: this.apiKey,
+                baseCurrencyCode: cryptoAsset.toLowerCase(),
+                quoteCurrencyCode: fiatCurrency.toLowerCase(),
+                baseCurrencyAmount: fiatAmount.toString(),
+            });
+        }
+        const url = `${this.baseUrl}/v3/currencies/${cryptoAsset.toLowerCase()}/${endpoint}?${params}`;
+        const response = await (0, fetch_1.timedFetch)(url);
         if (!response.ok) {
             throw new Error(`MoonPay quote failed: ${response.status}`);
         }
@@ -80,10 +93,7 @@ class MoonPayProvider extends base_1.CryptoRampProvider {
         if (params.sourceWallet) {
             (0, base_1.validateWalletAddress)(params.sourceWallet, params.network);
         }
-        // TODO: verify endpoint - use /v3/currencies/{code}/sell_quote?baseCurrencyAmount=...
-        // For now, use getQuote with 'off' direction
-        const quote = await this.getQuote('off', 0, // Will be calculated from crypto amount
-        params.fiatCurrency, params.asset, params.network);
+        const quote = await this.getQuote('off', params.cryptoAmount, params.fiatCurrency, params.asset, params.network);
         const sellWidgetUrl = this.sandbox
             ? 'https://sell-sandbox.moonpay.com'
             : 'https://sell.moonpay.com';
@@ -110,7 +120,7 @@ class MoonPayProvider extends base_1.CryptoRampProvider {
         };
     }
     async getRamp(id) {
-        const response = await fetch(`${this.baseUrl}/v3/transactions/${id}`, {
+        const response = await (0, fetch_1.timedFetch)(`${this.baseUrl}/v3/transactions/${id}`, {
             headers: {
                 Authorization: `Bearer ${this.secretKey}`,
             },

package/dist/crypto/yellowcard.js

@@ -24,6 +24,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.YellowCardProvider = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 /**
  * Yellow Card crypto on/off-ramp provider.
  *
@@ -263,7 +264,7 @@ class YellowCardProvider extends base_1.CryptoRampProvider {
         // Current: X-API-Key, X-Timestamp, X-Signature
         // Common alternatives: X-YC-API-Key, X-YC-Timestamp, X-YC-Signature
         // Or: Authorization header + separate X-Signature
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetch)(url, {
             method,
             headers: {
                 'Content-Type': 'application/json',

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { PaymentProvider } from './providers/base';
 import { PayBridgeConfig, CreatePaymentParams, PaymentResult, CreateSubscriptionParams, SubscriptionResult, RefundParams, RefundResult, WebhookEvent } from './types';
 export * from './types';
 export * from './utils/currency';
+export * from './utils/fetch';
 export * from './routing-types';
 export * from './circuit-breaker';
 export * from './circuit-breaker-store';

package/dist/index.js

@@ -31,6 +31,7 @@ const paystack_1 = require("./providers/paystack");
 const flutterwave_1 = require("./providers/flutterwave");
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils/currency"), exports);
+__exportStar(require("./utils/fetch"), exports);
 __exportStar(require("./routing-types"), exports);
 __exportStar(require("./circuit-breaker"), exports);
 __exportStar(require("./circuit-breaker-store"), exports);

package/dist/providers/flutterwave.js

@@ -41,6 +41,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlutterwaveProvider = void 0;
 const crypto = __importStar(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 class FlutterwaveProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -53,7 +54,7 @@ class FlutterwaveProvider extends base_1.PaymentProvider {
     }
     async apiRequest(method, path, data) {
         const url = `${this.baseUrl}${path}`;
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetch)(url, {
             method,
             headers: {
                 Authorization: `Bearer ${this.apiKey}`,

package/dist/providers/ozow.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OzowProvider = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 class OzowProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -83,16 +84,12 @@ class OzowProvider extends base_1.PaymentProvider {
     }
     async getPayment(id) {
         const url = `${this.baseUrl}/GetTransactionByReference?siteCode=${this.siteCode}&transactionReference=${encodeURIComponent(id)}`;
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(url, {
             method: 'GET',
             headers: {
                 'ApiKey': this.apiKey,
             },
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Ozow getPayment failed: ${response.status} - ${errorText}`);
-        }
         const data = (await response.json());
         if (!Array.isArray(data) || data.length === 0) {
             throw new Error('Transaction not found');

package/dist/providers/payfast.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PayFastProvider = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 class PayFastProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -143,7 +144,7 @@ class PayFastProvider extends base_1.PaymentProvider {
         headers['signature'] = this.generateApiSignature(headers);
         const testingParam = this.sandbox ? '?testing=true' : '';
         const url = `${this.apiBaseUrl}/query/fetch${testingParam}`;
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(url, {
             method: 'POST',
             headers: {
                 ...headers,
@@ -153,10 +154,6 @@ class PayFastProvider extends base_1.PaymentProvider {
                 m_payment_id: id,
             }),
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`PayFast getPayment failed: ${response.status} - ${errorText}`);
-        }
         const data = (await response.json());
         const status = this.mapPayFastStatus(data.status);
         return {

package/dist/providers/paystack.js

@@ -42,6 +42,7 @@ exports.PayStackProvider = void 0;
 const crypto = __importStar(require("crypto"));
 const base_1 = require("./base");
 const currency_1 = require("../utils/currency");
+const fetch_1 = require("../utils/fetch");
 class PayStackProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -54,7 +55,7 @@ class PayStackProvider extends base_1.PaymentProvider {
     }
     async apiRequest(method, path, data) {
         const url = `${this.baseUrl}${path}`;
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetch)(url, {
             method,
             headers: {
                 Authorization: `Bearer ${this.apiKey}`,

package/dist/providers/peach.js

@@ -41,6 +41,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PeachProvider = void 0;
 const crypto = __importStar(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 class PeachProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -76,7 +77,7 @@ class PeachProvider extends base_1.PaymentProvider {
             const bodyData = { entityId: this.entityId, ...data };
             body = this.buildFormData(bodyData);
         }
-        const response = await fetch(finalUrl, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(finalUrl, {
             method,
             headers: {
                 Authorization: `Bearer ${this.accessToken}`,
@@ -84,10 +85,6 @@ class PeachProvider extends base_1.PaymentProvider {
             },
             body,
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Peach Payments API error (${method} ${path}): ${response.status} - ${errorText}`);
-        }
         return (await response.json());
     }
     mapPeachStatus(code) {

package/dist/providers/softycomp.js

@@ -10,6 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SoftyCompProvider = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const base_1 = require("./base");
+const fetch_1 = require("../utils/fetch");
 class SoftyCompProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -36,7 +37,7 @@ class SoftyCompProvider extends base_1.PaymentProvider {
         if (this.token && Date.now() < this.tokenExpiry - 60000) {
             return this.token;
         }
-        const response = await fetch(`${this.baseUrl}/api/auth/generatetoken`, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(`${this.baseUrl}/api/auth/generatetoken`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
@@ -44,10 +45,6 @@ class SoftyCompProvider extends base_1.PaymentProvider {
                 apiSecret: this.secretKey,
             }),
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`SoftyComp authentication failed: ${response.status} - ${errorText}`);
-        }
         const data = (await response.json());
         this.token = data.token;
         this.tokenExpiry = new Date(data.expiration).getTime();
@@ -56,7 +53,7 @@ class SoftyCompProvider extends base_1.PaymentProvider {
     async apiRequest(method, path, data) {
         const token = await this.authenticate();
         const url = `${this.baseUrl}${path}`;
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(url, {
             method,
             headers: {
                 Authorization: `Bearer ${token}`,
@@ -64,10 +61,6 @@ class SoftyCompProvider extends base_1.PaymentProvider {
             },
             body: data ? JSON.stringify(data) : undefined,
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`SoftyComp API error (${method} ${path}): ${response.status} - ${errorText}`);
-        }
         const contentType = response.headers.get('content-type');
         if (contentType && contentType.includes('application/json')) {
             return (await response.json());

package/dist/providers/stripe.js

@@ -42,6 +42,7 @@ exports.StripeProvider = void 0;
 const crypto = __importStar(require("crypto"));
 const base_1 = require("./base");
 const currency_1 = require("../utils/currency");
+const fetch_1 = require("../utils/fetch");
 class StripeProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -70,7 +71,7 @@ class StripeProvider extends base_1.PaymentProvider {
     async apiRequest(method, path, data) {
         const url = `${this.baseUrl}${path}`;
         const body = data ? this.buildFormData(data) : undefined;
-        const response = await fetch(url, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(url, {
             method,
             headers: {
                 Authorization: `Bearer ${this.apiKey}`,
@@ -78,10 +79,6 @@ class StripeProvider extends base_1.PaymentProvider {
             },
             body,
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Stripe API error (${method} ${path}): ${response.status} - ${errorText}`);
-        }
         return (await response.json());
     }
     async createPayment(params) {

package/dist/providers/yoco.js

@@ -12,6 +12,7 @@ exports.YocoProvider = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const base_1 = require("./base");
 const currency_1 = require("../utils/currency");
+const fetch_1 = require("../utils/fetch");
 class YocoProvider extends base_1.PaymentProvider {
     constructor(config) {
         super();
@@ -41,7 +42,7 @@ class YocoProvider extends base_1.PaymentProvider {
                 ...params.metadata,
             },
         };
-        const response = await fetch(`${this.baseUrl}/checkouts`, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(`${this.baseUrl}/checkouts`, {
             method: 'POST',
             headers: {
                 'Authorization': `Bearer ${this.apiKey}`,
@@ -50,10 +51,6 @@ class YocoProvider extends base_1.PaymentProvider {
             },
             body: JSON.stringify(requestBody),
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Yoco API error (POST /checkouts): ${response.status} - ${errorText}`);
-        }
         const data = await response.json();
         return {
             id: data.id,
@@ -76,17 +73,13 @@ class YocoProvider extends base_1.PaymentProvider {
         throw new Error('Yoco does not support subscriptions. Use the Yoco Recurring Billing API directly or choose another provider.');
     }
     async getPayment(id) {
-        const response = await fetch(`${this.baseUrl}/checkouts/${id}`, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(`${this.baseUrl}/checkouts/${id}`, {
             method: 'GET',
             headers: {
                 'Authorization': `Bearer ${this.apiKey}`,
                 'Content-Type': 'application/json',
             },
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Yoco API error (GET /checkouts/${id}): ${response.status} - ${errorText}`);
-        }
         const data = await response.json();
         return {
             id: data.id,
@@ -110,7 +103,7 @@ class YocoProvider extends base_1.PaymentProvider {
         if (params.reason) {
             requestBody.metadata = { reason: params.reason };
         }
-        const response = await fetch(`${this.baseUrl}/refunds`, {
+        const response = await (0, fetch_1.timedFetchOrThrow)(`${this.baseUrl}/refunds`, {
             method: 'POST',
             headers: {
                 'Authorization': `Bearer ${this.apiKey}`,
@@ -119,10 +112,6 @@ class YocoProvider extends base_1.PaymentProvider {
             },
             body: JSON.stringify(requestBody),
         });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Yoco API error (POST /refunds): ${response.status} - ${errorText}`);
-        }
         const data = await response.json();
         const status = this.mapYocoStatus(data.status);
         const refundStatus = status === 'completed' ? 'completed' :

package/dist/router.js

@@ -7,6 +7,7 @@ exports.PayBridgeRouter = void 0;
 const routing_types_1 = require("./routing-types");
 const strategies_1 = require("./strategies");
 const circuit_breaker_1 = require("./circuit-breaker");
+const fetch_1 = require("./utils/fetch");
 function sanitizeErrorMessage(msg) {
     if (!msg)
         return 'unknown error';
@@ -94,15 +95,32 @@ class PayBridgeRouter {
             catch (error) {
                 const latencyMs = Date.now() - startTime;
                 lastError = error;
-                if (breaker)
-                    await breaker.recordFailure();
-                attempts.push({
-                    provider: providerName,
-                    status: 'failed',
-                    errorCode: error.code,
-                    errorMessage: sanitizeErrorMessage(error.message),
-                    latencyMs,
-                });
+                const isRateLimited = error instanceof fetch_1.HttpError &&
+                    (error.status === 429 || (error.status === 503 && error.retryAfterMs !== undefined));
+                if (isRateLimited) {
+                    attempts.push({
+                        provider: providerName,
+                        status: 'failed',
+                        errorCode: 'RATE_LIMITED',
+                        errorMessage: sanitizeErrorMessage(error.message),
+                        latencyMs,
+                    });
+                }
+                else {
+                    if (breaker)
+                        await breaker.recordFailure();
+                    let errorCode = error.code;
+                    if (error instanceof fetch_1.FetchTimeoutError) {
+                        errorCode = 'TIMEOUT';
+                    }
+                    attempts.push({
+                        provider: providerName,
+                        status: 'failed',
+                        errorCode,
+                        errorMessage: sanitizeErrorMessage(error.message),
+                        latencyMs,
+                    });
+                }
                 if (!this.fallback.enabled || attempts.length >= (this.fallback.maxAttempts ?? 3)) {
                     break;
                 }
@@ -156,15 +174,32 @@ class PayBridgeRouter {
             catch (error) {
                 const latencyMs = Date.now() - startTime;
                 lastError = error;
-                if (breaker)
-                    await breaker.recordFailure();
-                attempts.push({
-                    provider: providerName,
-                    status: 'failed',
-                    errorCode: error.code,
-                    errorMessage: sanitizeErrorMessage(error.message),
-                    latencyMs,
-                });
+                const isRateLimited = error instanceof fetch_1.HttpError &&
+                    (error.status === 429 || (error.status === 503 && error.retryAfterMs !== undefined));
+                if (isRateLimited) {
+                    attempts.push({
+                        provider: providerName,
+                        status: 'failed',
+                        errorCode: 'RATE_LIMITED',
+                        errorMessage: sanitizeErrorMessage(error.message),
+                        latencyMs,
+                    });
+                }
+                else {
+                    if (breaker)
+                        await breaker.recordFailure();
+                    let errorCode = error.code;
+                    if (error instanceof fetch_1.FetchTimeoutError) {
+                        errorCode = 'TIMEOUT';
+                    }
+                    attempts.push({
+                        provider: providerName,
+                        status: 'failed',
+                        errorCode,
+                        errorMessage: sanitizeErrorMessage(error.message),
+                        latencyMs,
+                    });
+                }
                 if (!this.fallback.enabled || attempts.length >= (this.fallback.maxAttempts ?? 3)) {
                     break;
                 }

package/dist/utils/fetch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Fetch utilities with timeout and HTTP error handling
+ */
+export interface FetchOptions extends RequestInit {
+    timeoutMs?: number;
+}
+export declare class FetchTimeoutError extends Error {
+    readonly name = "FetchTimeoutError";
+    readonly url: string;
+    readonly timeoutMs: number;
+    constructor(url: string, timeoutMs: number);
+}
+export declare class HttpError extends Error {
+    readonly name = "HttpError";
+    readonly status: number;
+    readonly retryAfterMs?: number;
+    readonly body?: string;
+    constructor(status: number, message: string, opts?: {
+        retryAfterMs?: number;
+        body?: string;
+    });
+}
+export declare function timedFetch(url: string, opts?: FetchOptions): Promise<Response>;
+export declare function timedFetchOrThrow(url: string, opts?: FetchOptions): Promise<Response>;

package/dist/utils/fetch.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Fetch utilities with timeout and HTTP error handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = exports.FetchTimeoutError = void 0;
+exports.timedFetch = timedFetch;
+exports.timedFetchOrThrow = timedFetchOrThrow;
+class FetchTimeoutError extends Error {
+    constructor(url, timeoutMs) {
+        super(`Request to ${url} timed out after ${timeoutMs}ms`);
+        this.name = 'FetchTimeoutError';
+        this.url = url;
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.FetchTimeoutError = FetchTimeoutError;
+class HttpError extends Error {
+    constructor(status, message, opts = {}) {
+        super(message);
+        this.name = 'HttpError';
+        this.status = status;
+        this.retryAfterMs = opts.retryAfterMs;
+        this.body = opts.body;
+    }
+}
+exports.HttpError = HttpError;
+const DEFAULT_TIMEOUT_MS = 30000;
+async function timedFetch(url, opts = {}) {
+    const { timeoutMs = DEFAULT_TIMEOUT_MS, signal: callerSignal, ...rest } = opts;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    if (callerSignal) {
+        if (callerSignal.aborted)
+            controller.abort();
+        else
+            callerSignal.addEventListener('abort', () => controller.abort(), { once: true });
+    }
+    try {
+        return await fetch(url, { ...rest, signal: controller.signal });
+    }
+    catch (err) {
+        if (err?.name === 'AbortError') {
+            throw new FetchTimeoutError(url, timeoutMs);
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+async function timedFetchOrThrow(url, opts = {}) {
+    const response = await timedFetch(url, opts);
+    if (!response.ok) {
+        let body = '';
+        try {
+            body = await response.text();
+        }
+        catch { }
+        const retryAfterHeader = response.headers.get('retry-after');
+        const retryAfterMs = retryAfterHeader ? parseRetryAfter(retryAfterHeader) : undefined;
+        throw new HttpError(response.status, `HTTP ${response.status}: ${body.slice(0, 200) || response.statusText}`, { retryAfterMs, body });
+    }
+    return response;
+}
+function parseRetryAfter(value) {
+    const seconds = parseInt(value, 10);
+    if (!isNaN(seconds))
+        return seconds * 1000;
+    const dateMs = Date.parse(value);
+    if (!isNaN(dateMs))
+        return Math.max(0, dateMs - Date.now());
+    return undefined;
+}

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "paybridge",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "One API for fiat + crypto payments. Multi-provider routing, automatic failover, MoonPay on/off-ramp. SA-first, global-ready.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
+    "prepack": "npm run clean && npm run build",
     "prepublishOnly": "npm run clean && npm run build",
-    "test": "tsc && node --test dist/tests/*.test.js",
+    "test": "tsc && tsc --project tsconfig.test.json && node --test 'dist-test/**/*.test.js'",
     "test:e2e:moonpay": "tsx tests/e2e/moonpay-sandbox.ts",
     "test:e2e:yellowcard": "tsx tests/e2e/yellowcard-sandbox.ts"
   },