mppx 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # mppx
 
+## 0.9.2
+
+### Patch Changes
+
+- 14e8b25: Added CLI support for selecting and paying x402 payment challenges.
+- 5cbc5e4: Added request-scoped PaymentIntent customer, receipt email, and Tax calculation options, with fallback recording without rejected optional fields for completed crypto payments.
+- b12e65b: Fixed framework adapters to preserve multi-method intent challenges.
+- f13f800: Added a machine-payment metadata field to every Stripe PaymentIntent created by mppx.
+- 9dd9969: Added opt-in Stripe-hosted Tempo fee sponsorship to `stripe.create()` using the configured Stripe client.
+
+## 0.9.1
+
+### Patch Changes
+
+- a33ff0a: Added MACH as a charge currency with stablecoin gas fallback and preserved session recovery.
+- c74d2ce: Added request-scoped PaymentIntent metadata to Stripe machine payment charge handlers, and exposed pre-transform request input to payment-success callbacks.
+- 2735c65: Fixed MCP payment errors to use the specification-defined JSON-RPC codes and retry verification challenges.
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -109,6 +109,9 @@ mppx account create
 # make request - automatic payment handling, curl-like api
 mppx example.com
 
+# pay an x402 offer on a server that advertises both protocols
+mppx example.com --protocol x402
+
 # open another session instead of reusing the preferred channel
 mppx example.com --session new
 
@@ -131,6 +134,10 @@ its configured custom escrow in the payment challenge, but the client rejects it
 that do not support custom escrows should leave it unset. See the
 [session escrow trust documentation](./src/tempo/session/README.md#escrow-configuration-and-trust).
 
+`--protocol auto` is the default: MPP is preferred when available, and x402 is used otherwise.
+Pass `mpp` or `x402` to require one protocol. x402 payments use the same EVM account as EVM
+charges, so `MPPX_PRIVATE_KEY` or a stored account works for both.
+
 You can also install globally to use the `mppx` CLI from anywhere:
 
 ```bash

package/dist/Errors.d.ts

@@ -95,6 +95,16 @@ export declare namespace VerificationFailedError {
         reason?: string;
     };
 }
+/**
+ * Payment processing failed because of an unexpected internal error.
+ */
+export declare class InternalPaymentError extends PaymentError {
+    readonly name = "InternalPaymentError";
+    readonly title = "Internal Payment Error";
+    readonly status = 500;
+    readonly type = "https://paymentauth.org/problems/internal-payment-error";
+    constructor();
+}
 /**
  * Payment requires additional action (e.g., 3DS authentication).
  */

package/dist/Errors.js

@@ -74,6 +74,18 @@ export class VerificationFailedError extends PaymentError {
         });
     }
 }
+/**
+ * Payment processing failed because of an unexpected internal error.
+ */
+export class InternalPaymentError extends PaymentError {
+    name = 'InternalPaymentError';
+    title = 'Internal Payment Error';
+    status = 500;
+    type = 'https://paymentauth.org/problems/internal-payment-error';
+    constructor() {
+        super('An internal payment error occurred.');
+    }
+}
 /**
  * Payment requires additional action (e.g., 3DS authentication).
  */

package/dist/Mcp.d.ts

@@ -1,12 +1,20 @@
 import type * as Challenge from './Challenge.js';
 import type * as Credential from './Credential.js';
-import type * as Errors from './Errors.js';
+import * as Errors from './Errors.js';
 import type { OneOf } from './internal/types.js';
 import type * as core_Receipt from './Receipt.js';
 /** MCP JSON-RPC error code for payment required. */
 export declare const paymentRequiredCode = -32042;
 /** MCP JSON-RPC error code for payment verification failed. */
 export declare const paymentVerificationFailedCode = -32043;
+/** JSON-RPC error code for invalid parameters. */
+export declare const invalidParamsCode = -32602;
+/** JSON-RPC error code for internal errors. */
+export declare const internalErrorCode = -32603;
+/**
+ * Maps a payment error to its MCP JSON-RPC error code.
+ */
+export declare function errorCode(error?: Errors.PaymentError): number;
 /** MCP metadata key for credentials. */
 export declare const credentialMetaKey = "org.paymentauth/credential";
 /** MCP metadata key for payment-required tool results. */

package/dist/Mcp.js

@@ -1,7 +1,25 @@
+import * as Errors from './Errors.js';
 /** MCP JSON-RPC error code for payment required. */
 export const paymentRequiredCode = -32042;
 /** MCP JSON-RPC error code for payment verification failed. */
 export const paymentVerificationFailedCode = -32043;
+/** JSON-RPC error code for invalid parameters. */
+export const invalidParamsCode = -32602;
+/** JSON-RPC error code for internal errors. */
+export const internalErrorCode = -32603;
+/**
+ * Maps a payment error to its MCP JSON-RPC error code.
+ */
+export function errorCode(error) {
+    if (!error || error instanceof Errors.PaymentRequiredError)
+        return paymentRequiredCode;
+    if (error instanceof Errors.MalformedCredentialError ||
+        error instanceof Errors.InvalidPayloadError)
+        return invalidParamsCode;
+    if (error instanceof Errors.InternalPaymentError)
+        return internalErrorCode;
+    return paymentVerificationFailedCode;
+}
 /** MCP metadata key for credentials. */
 export const credentialMetaKey = 'org.paymentauth/credential';
 /** MCP metadata key for payment-required tool results. */

package/dist/Method.d.ts

@@ -187,7 +187,14 @@ export type CanOfferFn<method extends Method> = (parameters: {
 export type OnPaymentSuccessFn<method extends Method> = (parameters: {
     input?: globalThis.Request;
     receipt: DeepReadonly<Receipt.Receipt>;
+    /** Canonical payment request included in the challenge. */
     request: DeepReadonly<z.output<method['schema']['request']>>;
+    /**
+     * Server-side request after defaults and request hooks, before the method
+     * request schema's output transforms. Absent during standalone credential
+     * verification when no route options are supplied.
+     */
+    requestInput?: DeepReadonly<z.input<method['schema']['request']>> | undefined;
 }) => MaybePromise<void>;
 export type ComposableHooks<method extends Method> = {
     /** Decides whether this method's configured offer is available for an HTTP request. */

package/dist/cli/cli.d.ts

@@ -21,6 +21,7 @@ declare const cli: Cli.Cli<{
             methodOpt?: string[] | undefined;
             network?: "mainnet" | "testnet" | undefined;
             payWith?: string | undefined;
+            protocol: "auto" | "mpp" | "x402";
             rpcUrl?: string | undefined;
             session: string;
             silent: boolean;