mppx 0.1.0 → 0.2.0

package/dist/stripe/client/Charge.d.ts

@@ -1,20 +1,31 @@
-import * as MethodIntent from '../../MethodIntent.js';
+import type * as Challenge from '../../Challenge.js';
+import * as Method from '../../Method.js';
 import * as z from '../../zod.js';
+import type { StripeJs } from '../internal/types.js';
+import * as Methods from '../Methods.js';
 /**
  * Creates a Stripe charge method intent for usage on the client.
  *
- * Accepts a `createSpt` callback that handles SPT creation (requires
- * a secret key, so typically proxied through a server endpoint).
+ * Accepts a `createToken` callback that handles SPT creation (requires
+ * a secret key, so typically proxied through a server endpoint) and
+ * returns a credential for retrying the request.
  *
  * The `paymentMethod` (e.g. from Stripe Elements) can be provided at
  * initialization or at credential-creation time via `context`.
  *
+ * Optionally accepts a `client` (a Stripe.js instance from `@stripe/stripe-js`)
+ * which is forwarded to the `createToken` callback for use with Elements.
+ *
  * @example
  * ```ts
+ * import { loadStripe } from '@stripe/stripe-js'
  * import { stripe } from 'mppx/client'
  *
+ * const stripeJs = await loadStripe('pk_...')
+ *
  * const charge = stripe.charge({
- *   createSpt: async ({ paymentMethod, amount, currency, networkId, expiresAt, metadata }) => {
+ *   client: stripeJs,
+ *   createToken: async ({ amount, currency, expiresAt, metadata, networkId, paymentMethod }) => {
  *     const res = await fetch('/api/create-spt', {
  *       method: 'POST',
  *       headers: { 'Content-Type': 'application/json' },
@@ -24,17 +35,18 @@ import * as z from '../../zod.js';
  *     return spt
  *   },
  * })
- *
- * // paymentMethod comes from Stripe Elements at credential-creation time
- * const credential = await charge.createCredential({
- *   challenge,
- *   context: { paymentMethod: 'pm_xxx' },
- * })
  * ```
  */
-export declare function charge(parameters: charge.Parameters): MethodIntent.Client<MethodIntent.MethodIntent<{
-    readonly name: "charge";
+export declare function charge(parameters: charge.Parameters): Method.Client<{
+    readonly name: "stripe";
+    readonly intent: "charge";
     readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniObject<{
+                externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                spt: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+        };
         readonly request: z.ZodMiniPipe<z.ZodMiniObject<{
             amount: z.ZodMiniString<string>;
             currency: z.ZodMiniString<string>;
@@ -42,9 +54,17 @@ export declare function charge(parameters: charge.Parameters): MethodIntent.Clie
             description: z.ZodMiniOptional<z.ZodMiniString<string>>;
             expires: z.ZodMiniDefault<z.ZodMiniString<string>>;
             externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            metadata: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+            networkId: z.ZodMiniString<string>;
+            paymentMethodTypes: z.ZodMiniArray<z.ZodMiniString<string>>;
             recipient: z.ZodMiniOptional<z.ZodMiniString<string>>;
         }, z.core.$strip>, z.ZodMiniTransform<{
             amount: string;
+            methodDetails: {
+                metadata?: Record<string, string> | undefined;
+                networkId: string;
+                paymentMethodTypes: string[];
+            };
             currency: string;
             expires: string;
             description?: string | undefined;
@@ -55,60 +75,44 @@ export declare function charge(parameters: charge.Parameters): MethodIntent.Clie
             currency: string;
             decimals: number;
             expires: string;
+            networkId: string;
+            paymentMethodTypes: string[];
             description?: string | undefined;
             externalId?: string | undefined;
+            metadata?: Record<string, string> | undefined;
             recipient?: string | undefined;
         }>>;
     };
-}, {
-    readonly method: "stripe";
-    readonly schema: {
-        readonly credential: {
-            readonly payload: z.ZodMiniObject<{
-                spt: z.ZodMiniString<string>;
-                externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            }, z.core.$strip>;
-        };
-        readonly request: {
-            readonly methodDetails: z.ZodMiniObject<{
-                networkId: z.ZodMiniString<string>;
-                paymentMethodTypes: z.ZodMiniArray<z.ZodMiniString<string>>;
-                metadata: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-            }, z.core.$strip>;
-        };
-    };
-}>, z.ZodMiniObject<{
+}, z.ZodMiniObject<{
     paymentMethod: z.ZodMiniOptional<z.ZodMiniString<string>>;
 }, z.core.$strip>>;
 export declare namespace charge {
     type Parameters = {
-        /**
-         * Creates a Shared Payment Token (SPT) for the given parameters.
-         *
-         * SPT creation requires a Stripe secret key, so this typically
-         * proxies through a server endpoint (e.g. `POST /api/create-spt`).
-         * If you are running a client in an enviroment with a secret key, you can just create the
-         * SPT directly in this callback.
-         */
-        createSpt: (parameters: CreateSptParameters) => Promise<string>;
+        /** Stripe.js instance from `@stripe/stripe-js`. Forwarded to `createToken` for use with Elements. */
+        client?: StripeJs | undefined;
+        /** Called when a Stripe challenge is received. Create an SPT to retry. */
+        createToken: (parameters: OnChallengeParameters) => Promise<string>;
         /** Optional client-side external reference ID for the credential payload. */
         externalId?: string | undefined;
         /** Default payment method ID. Overridden by `context.paymentMethod`. */
         paymentMethod?: string | undefined;
     };
-    type CreateSptParameters = {
-        /** Stripe payment method ID (e.g. from Stripe Elements). */
-        paymentMethod: string;
+    type OnChallengeParameters = {
         /** Payment amount (in smallest currency unit). */
         amount: string;
+        challenge: Challenge.Challenge<z.output<typeof Methods.charge.schema.request>, typeof Methods.charge.intent, typeof Methods.charge.name>;
+        /** Stripe.js instance, if provided to `stripe.charge()`. */
+        client?: StripeJs | undefined;
         /** Three-letter ISO currency code. */
         currency: string;
-        /** Stripe Business Network profile ID. */
-        networkId: string | undefined;
         /** SPT expiration as a Unix timestamp (seconds). */
         expiresAt: number;
         /** Optional metadata to associate with the SPT. */
         metadata?: Record<string, string> | undefined;
+        /** Stripe Business Network profile ID. */
+        networkId: string | undefined;
+        /** Stripe payment method ID (e.g. from Stripe Elements). */
+        paymentMethod?: string | undefined;
     };
 }
 //# sourceMappingURL=Charge.d.ts.map

package/dist/stripe/client/Charge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/stripe/client/Charge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAGjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAgDnD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,UAAU,GAAG;QAChB;;;;;;;WAOG;QACH,SAAS,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QAC/D,6EAA6E;QAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,wEAAwE;QACxE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACnC,CAAA;IAED,KAAK,mBAAmB,GAAG;QACzB,4DAA4D;QAC5D,aAAa,EAAE,MAAM,CAAA;QACrB,kDAAkD;QAClD,MAAM,EAAE,MAAM,CAAA;QACd,sCAAsC;QACtC,QAAQ,EAAE,MAAM,CAAA;QAChB,0CAA0C;QAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,oDAAoD;QACpD,SAAS,EAAE,MAAM,CAAA;QACjB,mDAAmD;QACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAC9C,CAAA;CACF"}
+{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/stripe/client/Charge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAmDnD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,UAAU,GAAG;QAChB,qGAAqG;QACrG,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC7B,0EAA0E;QAC1E,WAAW,EAAE,CAAC,UAAU,EAAE,qBAAqB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QACnE,6EAA6E;QAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,wEAAwE;QACxE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACnC,CAAA;IAED,KAAK,qBAAqB,GAAG;QAC3B,kDAAkD;QAClD,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,SAAS,CAAC,SAAS,CAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,EAC5B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAC3B,CAAA;QACD,4DAA4D;QAC5D,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC7B,sCAAsC;QACtC,QAAQ,EAAE,MAAM,CAAA;QAChB,oDAAoD;QACpD,SAAS,EAAE,MAAM,CAAA;QACjB,mDAAmD;QACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;QAC7C,0CAA0C;QAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,4DAA4D;QAC5D,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACnC,CAAA;CACF"}

package/dist/stripe/client/Charge.js

@@ -1,22 +1,30 @@
 import * as Credential from '../../Credential.js';
-import * as MethodIntent from '../../MethodIntent.js';
+import * as Method from '../../Method.js';
 import * as z from '../../zod.js';
-import * as Intents from '../Intents.js';
+import * as Methods from '../Methods.js';
 /**
  * Creates a Stripe charge method intent for usage on the client.
  *
- * Accepts a `createSpt` callback that handles SPT creation (requires
- * a secret key, so typically proxied through a server endpoint).
+ * Accepts a `createToken` callback that handles SPT creation (requires
+ * a secret key, so typically proxied through a server endpoint) and
+ * returns a credential for retrying the request.
  *
  * The `paymentMethod` (e.g. from Stripe Elements) can be provided at
  * initialization or at credential-creation time via `context`.
  *
+ * Optionally accepts a `client` (a Stripe.js instance from `@stripe/stripe-js`)
+ * which is forwarded to the `createToken` callback for use with Elements.
+ *
  * @example
  * ```ts
+ * import { loadStripe } from '@stripe/stripe-js'
  * import { stripe } from 'mppx/client'
  *
+ * const stripeJs = await loadStripe('pk_...')
+ *
  * const charge = stripe.charge({
- *   createSpt: async ({ paymentMethod, amount, currency, networkId, expiresAt, metadata }) => {
+ *   client: stripeJs,
+ *   createToken: async ({ amount, currency, expiresAt, metadata, networkId, paymentMethod }) => {
  *     const res = await fetch('/api/create-spt', {
  *       method: 'POST',
  *       headers: { 'Content-Type': 'application/json' },
@@ -26,24 +34,19 @@ import * as Intents from '../Intents.js';
  *     return spt
  *   },
  * })
- *
- * // paymentMethod comes from Stripe Elements at credential-creation time
- * const credential = await charge.createCredential({
- *   challenge,
- *   context: { paymentMethod: 'pm_xxx' },
- * })
  * ```
  */
 export function charge(parameters) {
-    const { createSpt, externalId, paymentMethod: defaultPaymentMethod } = parameters;
-    return MethodIntent.toClient(Intents.charge, {
+    const { client, createToken, externalId, paymentMethod: defaultPaymentMethod } = parameters;
+    return Method.toClient(Methods.charge, {
         context: z.object({
             paymentMethod: z.optional(z.string()),
         }),
         async createCredential({ challenge, context }) {
             const paymentMethod = context?.paymentMethod ?? defaultPaymentMethod;
-            if (!paymentMethod)
+            if (!paymentMethod) {
                 throw new Error('paymentMethod is required (pass via context or parameters)');
+            }
             const amount = challenge.request.amount;
             const currency = challenge.request.currency;
             const networkId = challenge.request.methodDetails?.networkId;
@@ -56,13 +59,15 @@ export function charge(parameters) {
             const expiresAt = challenge.request.expires
                 ? Math.floor(new Date(challenge.request.expires).getTime() / 1000)
                 : Math.floor(Date.now() / 1000) + 3600;
-            const spt = await createSpt({
-                paymentMethod,
+            const spt = await createToken({
                 amount,
+                challenge,
+                client,
                 currency,
-                networkId,
                 expiresAt,
                 metadata,
+                networkId,
+                paymentMethod,
             });
             return Credential.serialize({
                 challenge,

package/dist/stripe/client/Charge.js.map

@@ -1 +1 @@
-{"version":3,"file":"Charge.js","sourceRoot":"","sources":["../../../src/stripe/client/Charge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,MAAM,CAAC,UAA6B;IAClD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,GAAG,UAAU,CAAA;IAEjF,OAAO,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE;QAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACtC,CAAC;QAEF,KAAK,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;YAC3C,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,oBAAoB,CAAA;YACpE,IAAI,CAAC,aAAa;gBAChB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;YAE/E,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAgB,CAAA;YACjD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,QAAkB,CAAA;YACrD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,SAA+B,CAAA;YAClF,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;YACnF,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,QAErC,CAAA;YACb,IAAI,QAAQ,EAAE,UAAU,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAA;YACH,CAAC;YAED,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO;gBACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAiB,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;gBAC5E,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;YAExC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC;gBAC1B,aAAa;gBACb,MAAM;gBACN,QAAQ;gBACR,SAAS;gBACT,SAAS;gBACT,QAAQ;aACT,CAAC,CAAA;YAEF,OAAO,UAAU,CAAC,SAAS,CAAC;gBAC1B,SAAS;gBACT,OAAO,EAAE;oBACP,GAAG;oBACH,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtC;aACF,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"Charge.js","sourceRoot":"","sources":["../../../src/stripe/client/Charge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAEjC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,MAAM,CAAC,UAA6B;IAClD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,GAAG,UAAU,CAAA;IAE3F,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACtC,CAAC;QAEF,KAAK,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;YAC3C,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,oBAAoB,CAAA;YACpE,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;YAC/E,CAAC;YAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAgB,CAAA;YACjD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,QAAkB,CAAA;YACrD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,SAA+B,CAAA;YAClF,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;YACnF,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,QAErC,CAAA;YACb,IAAI,QAAQ,EAAE,UAAU,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAA;YACH,CAAC;YAED,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO;gBACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAiB,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;gBAC5E,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;YAExC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC;gBAC5B,MAAM;gBACN,SAAS;gBACT,MAAM;gBACN,QAAQ;gBACR,SAAS;gBACT,QAAQ;gBACR,SAAS;gBACT,aAAa;aACd,CAAC,CAAA;YAEF,OAAO,UAAU,CAAC,SAAS,CAAC;gBAC1B,SAAS;gBACT,OAAO,EAAE;oBACP,GAAG;oBACH,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtC;aACF,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/stripe/client/{MethodIntents.d.ts → Methods.d.ts}

@@ -1,6 +1,6 @@
 import { charge as charge_ } from './Charge.js';
 /**
- * Creates a Stripe `charge` client method intent.
+ * Creates a Stripe `charge` client method.
  *
  * @example
  * ```ts
@@ -9,7 +9,7 @@ import { charge as charge_ } from './Charge.js';
  * const mppx = Mppx.create({
  *   methods: [
  *     stripe({
- *       createSpt: async (params) => {
+ *       createToken: async (params) => {
  *         const res = await fetch('/api/create-spt', {
  *           method: 'POST',
  *           headers: { 'Content-Type': 'application/json' },
@@ -24,9 +24,16 @@ import { charge as charge_ } from './Charge.js';
  * })
  * ```
  */
-export declare function stripe(parameters: stripe.Parameters): readonly [import("../../MethodIntent.js").Client<import("../../MethodIntent.js").MethodIntent<{
-    readonly name: "charge";
+export declare function stripe(parameters: stripe.Parameters): readonly [import("../../Method.js").Client<{
+    readonly name: "stripe";
+    readonly intent: "charge";
     readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniObject<{
+                externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                spt: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>;
+        };
         readonly request: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniObject<{
             amount: import("zod/mini").ZodMiniString<string>;
             currency: import("zod/mini").ZodMiniString<string>;
@@ -34,9 +41,17 @@ export declare function stripe(parameters: stripe.Parameters): readonly [import(
             description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
             expires: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniString<string>>;
             externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            metadata: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniString<string>>>;
+            networkId: import("zod/mini").ZodMiniString<string>;
+            paymentMethodTypes: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>;
             recipient: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
         }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniTransform<{
             amount: string;
+            methodDetails: {
+                metadata?: Record<string, string> | undefined;
+                networkId: string;
+                paymentMethodTypes: string[];
+            };
             currency: string;
             expires: string;
             description?: string | undefined;
@@ -47,34 +62,20 @@ export declare function stripe(parameters: stripe.Parameters): readonly [import(
             currency: string;
             decimals: number;
             expires: string;
+            networkId: string;
+            paymentMethodTypes: string[];
             description?: string | undefined;
             externalId?: string | undefined;
+            metadata?: Record<string, string> | undefined;
             recipient?: string | undefined;
         }>>;
     };
-}, {
-    readonly method: "stripe";
-    readonly schema: {
-        readonly credential: {
-            readonly payload: import("zod/mini").ZodMiniObject<{
-                spt: import("zod/mini").ZodMiniString<string>;
-                externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
-            }, import("zod/v4/core").$strip>;
-        };
-        readonly request: {
-            readonly methodDetails: import("zod/mini").ZodMiniObject<{
-                networkId: import("zod/mini").ZodMiniString<string>;
-                paymentMethodTypes: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>;
-                metadata: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniString<string>>>;
-            }, import("zod/v4/core").$strip>;
-        };
-    };
-}>, import("zod/mini").ZodMiniObject<{
+}, import("zod/mini").ZodMiniObject<{
     paymentMethod: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
 }, import("zod/v4/core").$strip>>];
 export declare namespace stripe {
     type Parameters = charge_.Parameters;
-    /** Creates a Stripe `charge` client method intent for SPT-based payments. */
+    /** Creates a Stripe `charge` client method for SPT-based payments. */
     const charge: typeof charge_;
 }
-//# sourceMappingURL=MethodIntents.d.ts.map
+//# sourceMappingURL=Methods.d.ts.map

package/dist/stripe/client/Methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Methods.d.ts","sourceRoot":"","sources":["../../../src/stripe/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAEnD;AAED,yBAAiB,MAAM,CAAC;IACtB,KAAY,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IAE3C,sEAAsE;IAC/D,MAAM,MAAM,gBAAU,CAAA;CAC9B"}

package/dist/stripe/client/{MethodIntents.js → Methods.js}

@@ -1,6 +1,6 @@
 import { charge as charge_ } from './Charge.js';
 /**
- * Creates a Stripe `charge` client method intent.
+ * Creates a Stripe `charge` client method.
  *
  * @example
  * ```ts
@@ -9,7 +9,7 @@ import { charge as charge_ } from './Charge.js';
  * const mppx = Mppx.create({
  *   methods: [
  *     stripe({
- *       createSpt: async (params) => {
+ *       createToken: async (params) => {
  *         const res = await fetch('/api/create-spt', {
  *           method: 'POST',
  *           headers: { 'Content-Type': 'application/json' },
@@ -28,7 +28,7 @@ export function stripe(parameters) {
     return [charge_(parameters)];
 }
 (function (stripe) {
-    /** Creates a Stripe `charge` client method intent for SPT-based payments. */
+    /** Creates a Stripe `charge` client method for SPT-based payments. */
     stripe.charge = charge_;
 })(stripe || (stripe = {}));
-//# sourceMappingURL=MethodIntents.js.map
+//# sourceMappingURL=Methods.js.map

package/dist/stripe/client/Methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Methods.js","sourceRoot":"","sources":["../../../src/stripe/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,MAAM,CAAC,UAA6B;IAClD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAU,CAAA;AACvC,CAAC;AAED,WAAiB,MAAM;IAGrB,sEAAsE;IACzD,aAAM,GAAG,OAAO,CAAA;AAC/B,CAAC,EALgB,MAAM,KAAN,MAAM,QAKtB"}

package/dist/stripe/client/index.d.ts

@@ -1,3 +1,3 @@
 export { charge } from './Charge.js';
-export { stripe } from './MethodIntents.js';
+export { stripe } from './Methods.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/stripe/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stripe/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stripe/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA"}

package/dist/stripe/client/index.js

@@ -1,3 +1,3 @@
 export { charge } from './Charge.js';
-export { stripe } from './MethodIntents.js';
+export { stripe } from './Methods.js';
 //# sourceMappingURL=index.js.map

package/dist/stripe/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stripe/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stripe/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA"}

package/dist/stripe/index.d.ts

@@ -1,2 +1,2 @@
-export * as MethodIntents from './Intents.js';
+export * as Methods from './Methods.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/stripe/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/dist/stripe/index.js

@@ -1,2 +1,2 @@
-export * as MethodIntents from './Intents.js';
+export * as Methods from './Methods.js';
 //# sourceMappingURL=index.js.map

package/dist/stripe/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/dist/stripe/internal/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Duck-typed interface for the Stripe Node SDK (`stripe` npm package).
+ * Matches the subset of the API used by mppx for server-side payment verification.
+ *
+ * Uses loose signatures so any Stripe SDK version is assignable.
+ */
+export type StripeClient = {
+    paymentIntents: {
+        create(...args: any[]): Promise<{
+            id: string;
+            status: string;
+        }>;
+    };
+};
+/**
+ * Duck-typed interface for Stripe.js (`@stripe/stripe-js`).
+ * Matches the subset of the API used by mppx for client-side payment method creation.
+ *
+ * Uses loose signatures so any Stripe.js version is assignable.
+ */
+export type StripeJs = {
+    createPaymentMethod(...args: any[]): Promise<Record<string, unknown>>;
+    elements(...args: any[]): unknown;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/stripe/internal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/stripe/internal/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE;QACd,MAAM,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAChE,CAAA;CACF,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,mBAAmB,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrE,QAAQ,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAA;CAClC,CAAA"}

package/dist/stripe/internal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/stripe/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/stripe/internal/types.ts"],"names":[],"mappings":""}

package/dist/stripe/server/Charge.d.ts

@@ -1,21 +1,42 @@
-import type { LooseOmit } from '../../internal/types.js';
-import * as MethodIntent from '../../MethodIntent.js';
-import * as Intents from '../Intents.js';
+import type { LooseOmit, OneOf } from '../../internal/types.js';
+import * as Method from '../../Method.js';
+import type { StripeClient } from '../internal/types.js';
+import * as Methods from '../Methods.js';
 /**
  * Creates a Stripe charge method intent for usage on the server.
  *
  * Verifies payment by creating a Stripe PaymentIntent with the provided SPT.
  *
+ * Accepts either a `client` (a pre-configured Stripe SDK instance) or a raw
+ * `secretKey`. Using `client` is recommended—it lets you configure retries,
+ * API version, and other options on the Stripe instance you control.
+ *
+ * @example
+ * ```ts
+ * import Stripe from 'stripe'
+ * import { stripe } from 'mppx/server'
+ *
+ * const stripeClient = new Stripe(process.env.STRIPE_SECRET_KEY!)
+ * const charge = stripe.charge({ client: stripeClient, networkId: 'internal', paymentMethodTypes: ['card'] })
+ * ```
+ *
  * @example
  * ```ts
  * import { stripe } from 'mppx/server'
  *
- * const charge = stripe.charge({ secretKey: 'sk_...' })
+ * const charge = stripe.charge({ secretKey: 'sk_...', networkId: 'internal', paymentMethodTypes: ['card'] })
  * ```
  */
-export declare function charge<const parameters extends charge.Parameters>(parameters: parameters): MethodIntent.Server<MethodIntent.MethodIntent<{
-    readonly name: "charge";
+export declare function charge<const parameters extends charge.Parameters>(parameters: parameters): Method.Server<{
+    readonly name: "stripe";
+    readonly intent: "charge";
     readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniObject<{
+                externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                spt: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>;
+        };
         readonly request: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniObject<{
             amount: import("zod/mini").ZodMiniString<string>;
             currency: import("zod/mini").ZodMiniString<string>;
@@ -23,9 +44,17 @@ export declare function charge<const parameters extends charge.Parameters>(param
             description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
             expires: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniString<string>>;
             externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            metadata: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniString<string>>>;
+            networkId: import("zod/mini").ZodMiniString<string>;
+            paymentMethodTypes: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>;
             recipient: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
         }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniTransform<{
             amount: string;
+            methodDetails: {
+                metadata?: Record<string, string> | undefined;
+                networkId: string;
+                paymentMethodTypes: string[];
+            };
             currency: string;
             expires: string;
             description?: string | undefined;
@@ -36,37 +65,27 @@ export declare function charge<const parameters extends charge.Parameters>(param
             currency: string;
             decimals: number;
             expires: string;
+            networkId: string;
+            paymentMethodTypes: string[];
             description?: string | undefined;
             externalId?: string | undefined;
+            metadata?: Record<string, string> | undefined;
             recipient?: string | undefined;
         }>>;
     };
-}, {
-    readonly method: "stripe";
-    readonly schema: {
-        readonly credential: {
-            readonly payload: import("zod/mini").ZodMiniObject<{
-                spt: import("zod/mini").ZodMiniString<string>;
-                externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
-            }, import("zod/v4/core").$strip>;
-        };
-        readonly request: {
-            readonly methodDetails: import("zod/mini").ZodMiniObject<{
-                networkId: import("zod/mini").ZodMiniString<string>;
-                paymentMethodTypes: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>;
-                metadata: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniString<string>>>;
-            }, import("zod/v4/core").$strip>;
-        };
-    };
-}>, charge.DeriveDefaults<parameters>, undefined>;
+}, charge.DeriveDefaults<parameters>, undefined>;
 export declare namespace charge {
-    type Defaults = LooseOmit<MethodIntent.RequestDefaults<typeof Intents.charge>, 'recipient'>;
+    type Defaults = LooseOmit<Method.RequestDefaults<typeof Methods.charge>, 'recipient'>;
     type Parameters = {
-        /** Stripe secret API key. */
-        secretKey: string;
         /** Optional metadata to include in SPT creation requests. */
         metadata?: Record<string, string> | undefined;
-    } & Defaults;
+    } & Defaults & OneOf<{
+        /** Pre-configured Stripe SDK instance. Any object matching the duck-typed `StripeClient` shape works. */
+        client: StripeClient;
+    } | {
+        /** Stripe secret API key. */
+        secretKey: string;
+    }>;
     type DeriveDefaults<parameters extends Parameters> = Pick<parameters, Extract<keyof parameters, keyof Defaults>> & {
         decimals: number;
     };

package/dist/stripe/server/Charge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/stripe/server/Charge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAmFxF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAA;IAE3F,KAAK,UAAU,GAAG;QAChB,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAA;QACjB,6DAA6D;QAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAC9C,GAAG,QAAQ,CAAA;IAEZ,KAAK,cAAc,CAAC,UAAU,SAAS,UAAU,IAAI,IAAI,CACvD,UAAU,EACV,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,QAAQ,CAAC,CAC1C,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CACzB"}
+{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/stripe/server/Charge.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAqExF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAA;IAErF,KAAK,UAAU,GAAG;QAChB,6DAA6D;QAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAC9C,GAAG,QAAQ,GACV,KAAK,CACD;QACE,yGAAyG;QACzG,MAAM,EAAE,YAAY,CAAA;KACrB,GACD;QACE,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAA;KAClB,CACJ,CAAA;IAEH,KAAK,cAAc,CAAC,UAAU,SAAS,UAAU,IAAI,IAAI,CACvD,UAAU,EACV,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,QAAQ,CAAC,CAC1C,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CACzB"}