@agent-score/commerce 2.1.0 → 2.1.1

package/dist/payment/index.mjs

@@ -565,6 +565,9 @@ async function verifyX402Request({
   return { ok: true, payload, signedNetwork, signedPayTo };
 }
 
+// src/payment/mppx_server.ts
+import { AsyncLocalStorage } from "async_hooks";
+
 // src/stripe-multichain/mppx_stripe.ts
 async function createMppxStripe({
   profileId,
@@ -743,6 +746,31 @@ function wrapSolanaChargeWithFinalizedBlockhash(baseMethod, rpcUrl) {
     }
   };
 }
+var mppxCapture = new AsyncLocalStorage();
+var consoleErrorPatched = false;
+function ensureConsoleErrorPatch() {
+  if (consoleErrorPatched) return;
+  consoleErrorPatched = true;
+  const original = console.error.bind(console);
+  console.error = function captureMppxInternal(...args) {
+    if (args[0] === "mppx: internal verification error" && args[1] !== void 0) {
+      const ctx = mppxCapture.getStore();
+      if (ctx) {
+        const e = args[1];
+        const reason = typeof e?.shortMessage === "string" ? e.shortMessage : typeof e?.message === "string" ? e.message : String(args[1]);
+        const details = e?.details;
+        ctx.reason = typeof details === "string" && details.length > 0 ? `${reason} (${details})` : reason;
+      }
+    }
+    return original(...args);
+  };
+}
+async function runWithMppxFailureCapture(fn) {
+  ensureConsoleErrorPatch();
+  const ctx = { reason: null };
+  const result = await mppxCapture.run(ctx, fn);
+  return { result, failureReason: ctx.reason };
+}
 async function composeMppxRequest(mppx, intents, request) {
   if (!mppx || typeof mppx !== "object" || !("compose" in mppx)) {
     throw new Error("composeMppxRequest: argument is not an mppx server instance");
@@ -751,6 +779,7 @@ async function composeMppxRequest(mppx, intents, request) {
   if (typeof compose !== "function") {
     throw new Error("composeMppxRequest: mppx.compose is not a function");
   }
+  ensureConsoleErrorPatch();
   const typedCompose = compose;
   const handler = typedCompose.apply(mppx, [...intents]);
   return handler(request);
@@ -759,6 +788,22 @@ function mppxChallengeHeaders(result) {
   return Object.fromEntries(result.challenge.headers);
 }
 
+// src/errors.ts
+var CheckoutValidationError = class extends Error {
+  code;
+  action;
+  status;
+  extra;
+  constructor(opts) {
+    super(opts.message);
+    this.name = "CheckoutValidationError";
+    this.code = opts.code;
+    this.action = opts.action ?? "fix_request";
+    this.status = opts.status ?? 400;
+    this.extra = opts.extra;
+  }
+};
+
 // src/payment/dispatch.ts
 function detectRailFromHeaders(headers) {
   const get = (name) => {
@@ -787,17 +832,32 @@ async function dispatchSettlementByNetwork(payload, handlers) {
   const network = payload.accepted.network;
   if (network.startsWith("eip155:")) {
     if (!handlers.evm) {
-      throw new Error(`No EVM settlement handler registered (network: ${network})`);
+      throw new CheckoutValidationError({
+        code: "payment_provider_unavailable",
+        message: `No EVM settlement handler registered (network: ${network})`,
+        action: "retry_later",
+        status: 503
+      });
     }
     return handlers.evm(payload);
   }
   if (network.startsWith("solana:")) {
     if (!handlers.svm) {
-      throw new Error(`No Solana settlement handler registered (network: ${network})`);
+      throw new CheckoutValidationError({
+        code: "payment_provider_unavailable",
+        message: `No Solana settlement handler registered (network: ${network})`,
+        action: "retry_later",
+        status: 503
+      });
     }
     return handlers.svm(payload);
   }
-  throw new Error(`Unrecognized network in settlement payload: ${network}`);
+  throw new CheckoutValidationError({
+    code: "payment_provider_unavailable",
+    message: `Unrecognized network in settlement payload: ${network}`,
+    action: "retry_later",
+    status: 503
+  });
 }
 
 // src/payment/wwwauthenticate.ts
@@ -1172,7 +1232,11 @@ async function loadSolanaFeePayer(opts) {
   return kit.createKeyPairSignerFromPrivateKeyBytes(bytes);
 }
 
+// src/payment/constants.ts
+var STRIPE_MIN_CHARGE_USD = 0.5;
+
 // src/payment/compose_rails.ts
+var warnedStripeBelowMinimum = false;
 function buildMppxComposeRails(opts) {
   const rails2 = [];
   if (opts.tempoRecipient) {
@@ -1194,7 +1258,17 @@ function buildMppxComposeRails(opts) {
     }]);
   }
   if (opts.includeStripe !== false) {
-    rails2.push(["stripe/charge", { amount: opts.amountUsd, currency: "usd", decimals: 2 }]);
+    const amountUsdNumeric = Number(opts.amountUsd);
+    if (Number.isFinite(amountUsdNumeric) && amountUsdNumeric < STRIPE_MIN_CHARGE_USD) {
+      if (!warnedStripeBelowMinimum) {
+        warnedStripeBelowMinimum = true;
+        console.warn(
+          `[buildMppxComposeRails] Dropping stripe/charge rail: amountUsd=${opts.amountUsd} is below Stripe's $${STRIPE_MIN_CHARGE_USD.toFixed(2)} USD minimum. Stripe's fixed ~$0.30 fee makes sub-50-cent charges unprofitable (and many accounts reject PI creation with amount_too_small below this floor). Pass includeStripe: false to suppress this warning.`
+        );
+      }
+    } else {
+      rails2.push(["stripe/charge", { amount: opts.amountUsd, currency: "usd", decimals: 2 }]);
+    }
   }
   return rails2;
 }
@@ -1322,6 +1396,7 @@ export {
   readX402PaymentHeader,
   registerX402SchemesV1V2,
   resolveRecipient,
+  runWithMppxFailureCapture,
   settlementOverrideHeader,
   usdToAtomic,
   validateX402NetworkConfig,