@agent-score/commerce 2.0.2 → 2.1.1

package/dist/payment/index.js

@@ -25,7 +25,10 @@ __export(payment_exports, {
   USDC: () => USDC,
   X402_SUPPORTED_BASE_NETWORKS: () => X402_SUPPORTED_BASE_NETWORKS,
   aliasAmountFields: () => aliasAmountFields,
+  asHeaders: () => asHeaders,
+  buildDefaultCheckoutRails: () => buildDefaultCheckoutRails,
   buildIdempotencyKey: () => buildIdempotencyKey,
+  buildMppxComposeRails: () => buildMppxComposeRails,
   buildPaymentDirective: () => buildPaymentDirective,
   buildPaymentHeaders: () => buildPaymentHeaders,
   buildPaymentRequestBlob: () => buildPaymentRequestBlob,
@@ -41,6 +44,11 @@ __export(payment_exports, {
   extractPaymentSignerFromAuth: () => extractPaymentSignerFromAuth,
   extractSignerForPrecheck: () => extractSignerForPrecheck,
   formatUsdCents: () => formatUsdCents,
+  hasMppxHeader: () => hasMppxHeader,
+  hasPaymentHeader: () => hasPaymentHeader,
+  hasX402Header: () => hasX402Header,
+  isEvmNetwork: () => isEvmNetwork,
+  isSolanaNetwork: () => isSolanaNetwork,
   lazyMppxServer: () => lazyMppxServer,
   lazyX402Server: () => lazyX402Server,
   loadSolanaFeePayer: () => loadSolanaFeePayer,
@@ -52,9 +60,11 @@ __export(payment_exports, {
   paymentRequiredHeader: () => paymentRequiredHeader,
   processX402Settle: () => processX402Settle,
   rails: () => rails,
+  readHeader: () => readHeader,
   readX402PaymentHeader: () => readX402PaymentHeader,
   registerX402SchemesV1V2: () => registerX402SchemesV1V2,
   resolveRecipient: () => resolveRecipient,
+  runWithMppxFailureCapture: () => runWithMppxFailureCapture,
   settlementOverrideHeader: () => settlementOverrideHeader,
   usdToAtomic: () => usdToAtomic,
   validateX402NetworkConfig: () => validateX402NetworkConfig,
@@ -632,6 +642,9 @@ async function verifyX402Request({
   return { ok: true, payload, signedNetwork, signedPayTo };
 }
 
+// src/payment/mppx_server.ts
+var import_node_async_hooks = require("async_hooks");
+
 // src/stripe-multichain/mppx_stripe.ts
 async function createMppxStripe({
   profileId,
@@ -666,7 +679,8 @@ function isSolanaMppRailSpec(s) {
   return s.network?.startsWith("solana:") ?? false;
 }
 function solanaNetworkFromCAIP2(caip2) {
-  if (caip2 === networks.solana.devnet.caip2) return "devnet";
+  if (caip2 === "devnet" || caip2 === networks.solana.devnet.caip2) return "devnet";
+  if (caip2 === "localnet") return "localnet";
   return "mainnet-beta";
 }
 function solanaDefaultRpcUrl(network) {
@@ -809,6 +823,31 @@ function wrapSolanaChargeWithFinalizedBlockhash(baseMethod, rpcUrl) {
     }
   };
 }
+var mppxCapture = new import_node_async_hooks.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");
@@ -817,6 +856,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);
@@ -825,6 +865,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) => {
@@ -853,17 +909,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
@@ -953,6 +1024,13 @@ function clampKey(key) {
   return key;
 }
 
+// src/_headers.ts
+function normalizeHeadersToLowercase(headers) {
+  const out = {};
+  for (const [k, v] of Object.entries(headers)) out[k.toLowerCase()] = v;
+  return out;
+}
+
 // src/signer.ts
 var TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
 var TOKEN_2022_PROGRAM = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
@@ -1035,13 +1113,8 @@ async function extractPaymentSignerFromAuth(authHeader, x402PaymentHeader) {
 function readX402PaymentHeader(request) {
   return request.headers.get("payment-signature") ?? request.headers.get("x-payment") ?? void 0;
 }
-function lowerHeaders(headers) {
-  const out = {};
-  for (const [k, v] of Object.entries(headers)) out[k.toLowerCase()] = v;
-  return out;
-}
 async function extractSignerForPrecheck(headers) {
-  const lower = lowerHeaders(headers);
+  const lower = normalizeHeadersToLowercase(headers);
   const x402 = lower["payment-signature"] ?? lower["x-payment"];
   if (x402) {
     const signer = await extractPaymentSignerFromAuth(void 0, x402);
@@ -1098,8 +1171,8 @@ function usdToAtomic(usd, opts) {
   }
   return result;
 }
-function formatUsdCents(cents) {
-  return (cents / 100).toFixed(2);
+function formatUsdCents(cents, decimals = 2) {
+  return (cents / 100).toFixed(decimals);
 }
 
 // src/payment/zero-settle.ts
@@ -1235,6 +1308,126 @@ 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) {
+    rails2.push(["tempo/charge", {
+      amount: opts.amountUsd,
+      currency: opts.tempoTokenAddress ?? USDC.tempo.mainnet.address,
+      decimals: 6,
+      recipient: opts.tempoRecipient
+    }]);
+  }
+  if (opts.solanaRecipient) {
+    const atomic = usdToAtomic(opts.amountUsd, { decimals: 6 });
+    rails2.push(["solana/charge", {
+      amount: atomic.toString(),
+      currency: opts.solanaTokenMint ?? USDC.solana.mainnet.mint,
+      decimals: 6,
+      recipient: opts.solanaRecipient,
+      network: opts.solanaNetwork ?? "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
+    }]);
+  }
+  if (opts.includeStripe !== false) {
+    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;
+}
+
+// src/payment/default_rails.ts
+function buildDefaultCheckoutRails(opts) {
+  const out = {};
+  if (opts.tempo) {
+    out.tempo = { recipient: "", ...RAIL_SPEC_DEFAULTS.tempo, ...opts.tempo };
+  }
+  if (opts.x402Base) {
+    const merged = { recipient: "", ...RAIL_SPEC_DEFAULTS.x402Base, ...opts.x402Base };
+    if (merged.network === networks.base.sepolia.caip2) {
+      if (opts.x402Base.chainId === void 0) merged.chainId = networks.base.sepolia.chainId;
+      if (opts.x402Base.token === void 0) merged.token = USDC.base.sepolia.address;
+    } else if (merged.network === networks.base.mainnet.caip2) {
+      if (opts.x402Base.chainId === void 0) merged.chainId = networks.base.mainnet.chainId;
+      if (opts.x402Base.token === void 0) merged.token = USDC.base.mainnet.address;
+    }
+    out.x402_base = merged;
+  }
+  if (opts.solanaMpp) {
+    const merged = { recipient: "", ...RAIL_SPEC_DEFAULTS.solanaMpp, ...opts.solanaMpp };
+    const isDevnet = merged.network === "devnet" || merged.network === networks.solana.devnet.caip2;
+    if (isDevnet && opts.solanaMpp.token === void 0) {
+      merged.token = USDC.solana.devnet.mint;
+    }
+    out.solana_mpp = merged;
+  }
+  if (opts.stripe) {
+    out.stripe = { ...RAIL_SPEC_DEFAULTS.stripe, ...opts.stripe };
+  }
+  return out;
+}
+
+// src/payment/payment_header.ts
+function toTitleCase(name) {
+  return name.replace(/(^|-)([a-z])/g, (_m, sep, c) => sep + c.toUpperCase());
+}
+function readHeader(headers, name) {
+  if (typeof headers.get === "function") {
+    return headers.get(name);
+  }
+  const rec = headers;
+  const v = rec[name] ?? rec[name.toLowerCase()] ?? rec[toTitleCase(name)];
+  if (typeof v === "string") return v;
+  if (Array.isArray(v) && typeof v[0] === "string") return v[0];
+  return null;
+}
+function asHeaders(input) {
+  return typeof input.headers === "object" && input instanceof Request ? input.headers : input;
+}
+function hasPaymentHeader(input) {
+  const headers = asHeaders(input);
+  return Boolean(
+    readHeader(headers, "payment-signature") || readHeader(headers, "x-payment") || readHeader(headers, "authorization")?.startsWith("Payment ")
+  );
+}
+function hasX402Header(input) {
+  const headers = asHeaders(input);
+  return Boolean(readHeader(headers, "payment-signature") || readHeader(headers, "x-payment"));
+}
+function hasMppxHeader(input) {
+  const headers = asHeaders(input);
+  return Boolean(readHeader(headers, "authorization")?.startsWith("Payment "));
+}
+
+// src/payment/network_kind.ts
+function readNetwork(input) {
+  if (typeof input === "string") return input;
+  if (input && typeof input === "object") {
+    const network = input.network;
+    return typeof network === "string" ? network : "";
+  }
+  return "";
+}
+function isEvmNetwork(input) {
+  return readNetwork(input).startsWith("eip155:");
+}
+function isSolanaNetwork(input) {
+  return readNetwork(input).startsWith("solana:");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   RAIL_SPEC_DEFAULTS,
@@ -1242,7 +1435,10 @@ async function loadSolanaFeePayer(opts) {
   USDC,
   X402_SUPPORTED_BASE_NETWORKS,
   aliasAmountFields,
+  asHeaders,
+  buildDefaultCheckoutRails,
   buildIdempotencyKey,
+  buildMppxComposeRails,
   buildPaymentDirective,
   buildPaymentHeaders,
   buildPaymentRequestBlob,
@@ -1258,6 +1454,11 @@ async function loadSolanaFeePayer(opts) {
   extractPaymentSignerFromAuth,
   extractSignerForPrecheck,
   formatUsdCents,
+  hasMppxHeader,
+  hasPaymentHeader,
+  hasX402Header,
+  isEvmNetwork,
+  isSolanaNetwork,
   lazyMppxServer,
   lazyX402Server,
   loadSolanaFeePayer,
@@ -1269,9 +1470,11 @@ async function loadSolanaFeePayer(opts) {
   paymentRequiredHeader,
   processX402Settle,
   rails,
+  readHeader,
   readX402PaymentHeader,
   registerX402SchemesV1V2,
   resolveRecipient,
+  runWithMppxFailureCapture,
   settlementOverrideHeader,
   usdToAtomic,
   validateX402NetworkConfig,