mppx 0.6.20 → 0.6.21

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # mppx
 
+## 0.6.21
+
+### Patch Changes
+
+- d752fb5: Added typed client payment events for challenge handling, credential creation, payment responses, and failures.
+- 55a5b8f: Added typed server events for payment challenges, failed payments, and verified payments.
+
 ## 0.6.20
 
 ### Patch Changes

package/dist/client/Mppx.d.ts

@@ -5,6 +5,7 @@ import type * as z from '../zod.js';
 import * as Fetch from './internal/Fetch.js';
 import * as Transport from './Transport.js';
 export type Methods = readonly (Method.AnyClient | readonly Method.AnyClient[])[];
+type EventResponseOf<transport extends Transport.Transport> = Response | Transport.ResponseOf<transport>;
 /**
  * Client-side payment handler.
  */
@@ -19,6 +20,16 @@ export type Mppx<methods extends Methods = Methods, transport extends Transport.
     transport: transport;
     /** Creates a credential from a payment-required response by routing to the correct method. */
     createCredential: (response: Transport.ResponseOf<transport>, context?: AnyContextFor<FlattenMethods<methods>> | undefined, options?: createCredential.Options | undefined) => Promise<string>;
+    /** Register a client event handler by canonical event name. */
+    on<name extends Fetch.ClientEventName<FlattenMethods<methods>, EventResponseOf<transport>>>(name: name, handler: Fetch.ClientEventHandler<FlattenMethods<methods>, name, EventResponseOf<transport>>): Fetch.Unsubscribe;
+    /** Register a handler for received payment challenges. */
+    onChallengeReceived(handler: Fetch.ClientEventHandler<FlattenMethods<methods>, 'challenge.received', EventResponseOf<transport>>): Fetch.Unsubscribe;
+    /** Register a handler for created credentials. */
+    onCredentialCreated(handler: Fetch.ClientEventHandler<FlattenMethods<methods>, 'credential.created', EventResponseOf<transport>>): Fetch.Unsubscribe;
+    /** Register a handler for failed automatic payment handling. */
+    onPaymentFailed(handler: Fetch.ClientEventHandler<FlattenMethods<methods>, 'payment.failed', EventResponseOf<transport>>): Fetch.Unsubscribe;
+    /** Register a handler for payment retry responses. */
+    onPaymentResponse(handler: Fetch.ClientEventHandler<FlattenMethods<methods>, 'payment.response', EventResponseOf<transport>>): Fetch.Unsubscribe;
 };
 /**
  * Creates a client-side payment handler from an array of methods.
@@ -69,7 +80,7 @@ export declare namespace create {
         acceptPaymentPolicy?: Fetch.from.Config['acceptPaymentPolicy'] | undefined;
         /** Custom fetch function to wrap. Defaults to `globalThis.fetch`. */
         fetch?: typeof globalThis.fetch;
-        /** Called when a 402 challenge is received, before credential creation. */
+        /** Called when a 402 challenge is received and no event handler supplies a credential. */
         onChallenge?: ((challenge: Challenge.Challenge, helpers: {
             createCredential: (context?: AnyContextFor<FlattenMethods<methods>>) => Promise<string>;
         }) => Promise<string | undefined>) | undefined;

package/dist/client/Mppx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mppx.d.ts","sourceRoot":"","sources":["../../src/client/Mppx.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Mppx.d.ts","sourceRoot":"","sources":["../../src/client/Mppx.ts"],"names":[],"mappings":"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"}

package/dist/client/Mppx.js

@@ -30,37 +30,85 @@ export function create(config) {
     const rawFetch = config.fetch ?? globalThis.fetch;
     const methods = config.methods.flat();
     const acceptPayment = AcceptPayment.resolve(methods, config.paymentPreferences);
+    const events = Fetch.createEventDispatcher();
     const resolvedOnChallenge = onChallenge;
     const config_fetch = {
         acceptPayment,
         acceptPaymentPolicy,
         ...(config.fetch && { fetch: config.fetch }),
+        eventDispatcher: events,
         ...(resolvedOnChallenge && { onChallenge: resolvedOnChallenge }),
         methods,
     };
     const fetch = Fetch.from(config_fetch);
     if (polyfill)
         Fetch.polyfill(config_fetch);
+    function onChallengeReceived(handler) {
+        return events.on('challenge.received', handler);
+    }
+    function onCredentialCreated(handler) {
+        return events.on('credential.created', handler);
+    }
+    function onPaymentFailed(handler) {
+        return events.on('payment.failed', handler);
+    }
+    function onPaymentResponse(handler) {
+        return events.on('payment.response', handler);
+    }
     return {
         fetch,
         rawFetch,
         methods,
         transport,
+        on: events.on,
+        onChallengeReceived,
+        onCredentialCreated,
+        onPaymentFailed,
+        onPaymentResponse,
         async createCredential(response, context, options) {
             const challenges = transport.getChallenges
                 ? transport.getChallenges(response)
                 : [transport.getChallenge(response)];
             const preferences = resolveChallengePreferences(acceptPayment.entries, options?.acceptPayment);
-            const selected = AcceptPayment.selectChallenge(challenges, methods, preferences);
-            if (!selected)
-                throw new Error(`No method found for challenges: ${challenges.map((challenge) => `${challenge.method}.${challenge.intent}`).join(', ')}. Available: ${methods.map((m) => `${m.name}.${m.intent}`).join(', ')}`);
-            const { challenge, method: mi } = selected;
-            if (challenge.expires)
-                Expires.assert(challenge.expires, challenge.id);
-            const parsedContext = mi.context && context !== undefined ? mi.context.parse(context) : undefined;
-            return mi.createCredential(parsedContext !== undefined
-                ? { challenge, context: parsedContext }
-                : { challenge });
+            let challenge;
+            let mi;
+            try {
+                const selected = AcceptPayment.selectChallenge(challenges, methods, preferences);
+                if (!selected)
+                    throw new Error(`No method found for challenges: ${challenges.map((challenge) => `${challenge.method}.${challenge.intent}`).join(', ')}. Available: ${methods.map((m) => `${m.name}.${m.intent}`).join(', ')}`);
+                const selectedChallenge = selected.challenge;
+                challenge = selectedChallenge;
+                mi = selected.method;
+                if (challenge.expires)
+                    Expires.assert(challenge.expires, challenge.id);
+                const createCredential = memoizeCreateCredential((overrideContext) => createCredentialForMethod(selectedChallenge, mi, overrideContext ?? context));
+                const eventCredential = await events.emit('challenge.received', createChallengeReceivedPayload({
+                    challenge: selectedChallenge,
+                    challenges,
+                    createCredential,
+                    method: mi,
+                    response,
+                }));
+                const credential = eventCredential ?? (await createCredential());
+                Fetch.validateCredentialHeaderValue(credential);
+                await events.emit('credential.created', createCredentialCreatedPayload({
+                    challenge: selectedChallenge,
+                    credential,
+                    method: mi,
+                    response,
+                }));
+                return credential;
+            }
+            catch (error) {
+                await events.emit('payment.failed', createPaymentFailedPayload({
+                    challenge,
+                    challenges,
+                    error,
+                    method: mi,
+                    response,
+                }));
+                throw error;
+            }
         },
     };
 }
@@ -81,9 +129,78 @@ export function create(config) {
 export function restore() {
     Fetch.restore();
 }
+function memoizeCreateCredential(createCredential) {
+    let promise;
+    return (context) => {
+        promise ??= createCredential(context);
+        return promise;
+    };
+}
+function createChallengeReceivedPayload(parameters) {
+    return Object.freeze({
+        challenge: snapshotValue(parameters.challenge),
+        challenges: parameters.challenges.map((challenge) => snapshotValue(challenge)),
+        createCredential: parameters.createCredential,
+        method: snapshotMethod(parameters.method),
+        response: snapshotResponse(parameters.response),
+    });
+}
+function createCredentialCreatedPayload(parameters) {
+    return Object.freeze({
+        challenge: snapshotValue(parameters.challenge),
+        credential: parameters.credential,
+        method: snapshotMethod(parameters.method),
+        response: snapshotResponse(parameters.response),
+    });
+}
+function createPaymentFailedPayload(parameters) {
+    return Object.freeze({
+        ...(parameters.challenge ? { challenge: snapshotValue(parameters.challenge) } : {}),
+        ...(parameters.challenges
+            ? { challenges: parameters.challenges.map((challenge) => snapshotValue(challenge)) }
+            : {}),
+        error: parameters.error,
+        ...(parameters.method ? { method: snapshotMethod(parameters.method) } : {}),
+        response: snapshotResponse(parameters.response),
+    });
+}
+function snapshotMethod(method) {
+    return freezeSnapshot(Object.assign({}, method));
+}
+function snapshotResponse(response) {
+    if (response instanceof Response)
+        return response.clone();
+    return snapshotValue(response);
+}
+function snapshotValue(value) {
+    try {
+        return deepFreeze(structuredClone(value));
+    }
+    catch {
+        return freezeSnapshot(value);
+    }
+}
+function deepFreeze(value) {
+    if (!value || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return value;
+}
+function freezeSnapshot(value) {
+    if (!value || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    return value;
+}
 function resolveChallengePreferences(fallback, override) {
     if (!override)
         return fallback;
     return typeof override === 'string' ? AcceptPayment.parse(override) : override;
 }
+async function createCredentialForMethod(challenge, mi, context) {
+    const parsedContext = mi.context && context !== undefined ? mi.context.parse(context) : undefined;
+    return mi.createCredential(parsedContext !== undefined ? { challenge, context: parsedContext } : { challenge });
+}
 //# sourceMappingURL=Mppx.js.map

package/dist/client/Mppx.js.map

@@ -1 +1 @@
-{"version":3,"file":"Mppx.js","sourceRoot":"","sources":["../../src/client/Mppx.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Mppx.js","sourceRoot":"","sources":["../../src/client/Mppx.ts"],"names":[],"mappings":"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"}

package/dist/client/internal/Fetch.d.ts

@@ -1,7 +1,63 @@
 import * as Challenge from '../../Challenge.js';
 import * as AcceptPayment from '../../internal/AcceptPayment.js';
+import type { MaybePromise } from '../../internal/types.js';
 import type * as Method from '../../Method.js';
 import type * as z from '../../zod.js';
+export type ClientEventMap<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = {
+    'challenge.received': ChallengeReceivedPayload<methods, response>;
+    'credential.created': CredentialCreatedPayload<methods, response>;
+    'payment.failed': PaymentFailedPayload<methods, response>;
+    'payment.response': PaymentResponsePayload<methods, response>;
+};
+export type ClientEventName<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = keyof ClientEventMap<methods, response> | '*';
+export type ClientEventEnvelope<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = {
+    [name in keyof ClientEventMap<methods, response>]: Readonly<{
+        name: name;
+        payload: ClientEventMap<methods, response>[name];
+    }>;
+}[keyof ClientEventMap<methods, response>];
+export type ClientEventPayload<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], name extends ClientEventName<methods> = ClientEventName<methods>, response = Response> = name extends '*' ? ClientEventEnvelope<methods, response> : name extends keyof ClientEventMap<methods, response> ? ClientEventMap<methods, response>[name] : never;
+export type ClientEventResult<methods extends readonly Method.AnyClient[], name extends ClientEventName<methods> = ClientEventName<methods>, _response = Response> = name extends 'challenge.received' ? string | undefined : void;
+export type ClientEventHandler<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], name extends ClientEventName<methods> = ClientEventName<methods>, response = Response> = (payload: ClientEventPayload<methods, name, response>) => MaybePromise<ClientEventResult<methods, name, response>>;
+export type Unsubscribe = () => void;
+export type ChallengeReceivedPayload<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = Readonly<{
+    challenge: Challenge.Challenge;
+    challenges: readonly Challenge.Challenge[];
+    createCredential: (context?: AnyContextFor<methods>) => Promise<string>;
+    init?: from.RequestInit<methods> | undefined;
+    input?: RequestInfo | URL | undefined;
+    method: methods[number];
+    response: response;
+}>;
+export type CredentialCreatedPayload<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = Readonly<{
+    challenge: Challenge.Challenge;
+    credential: string;
+    init?: from.RequestInit<methods> | undefined;
+    input?: RequestInfo | URL | undefined;
+    method: methods[number];
+    response?: response | undefined;
+}>;
+export type PaymentResponsePayload<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = Readonly<{
+    challenge: Challenge.Challenge;
+    credential: string;
+    init?: from.RequestInit<methods> | undefined;
+    input?: RequestInfo | URL | undefined;
+    method: methods[number];
+    response: response;
+}>;
+export type PaymentFailedPayload<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = Readonly<{
+    challenge?: Challenge.Challenge | undefined;
+    challenges?: readonly Challenge.Challenge[] | undefined;
+    error: unknown;
+    init?: from.RequestInit<methods> | undefined;
+    input?: RequestInfo | URL | undefined;
+    method?: methods[number] | undefined;
+    response?: response | undefined;
+}>;
+export type ClientEventDispatcher<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response> = {
+    emit<name extends Exclude<ClientEventName<methods, response>, '*'>>(name: name, payload: ClientEventMap<methods, response>[name]): Promise<ClientEventResult<methods, name, response>>;
+    on<name extends ClientEventName<methods, response>>(name: name, handler: ClientEventHandler<methods, name, response>): Unsubscribe;
+};
 /**
  * Creates a fetch wrapper that automatically handles 402 Payment Required responses.
  *
@@ -38,9 +94,11 @@ export declare namespace from {
         } | undefined;
         /** Custom fetch function to wrap. Defaults to `globalThis.fetch`. */
         fetch?: typeof globalThis.fetch;
+        /** Advanced shared event dispatcher. `challenge.received` handlers run before `onChallenge`; the first non-empty credential returned by a handler skips `onChallenge`. */
+        eventDispatcher?: ClientEventDispatcher<methods, any> | undefined;
         /** Array of methods to use. */
         methods: methods;
-        /** Called when a 402 challenge is received, before credential creation. */
+        /** Called when a 402 challenge is received and no event handler supplies a credential. */
         onChallenge?: ((challenge: Challenge.Challenge, helpers: {
             createCredential: (context?: AnyContextFor<methods>) => Promise<string>;
         }) => Promise<string | undefined>) | undefined;
@@ -92,5 +150,15 @@ export declare namespace polyfill {
 export declare function restore(): void;
 /** @internal Normalizes headers to a plain object for spreading. */
 export declare function normalizeHeaders(headers: unknown): Record<string, string>;
+/**
+ * Creates a typed client payment event dispatcher.
+ *
+ * `challenge.received` handlers run before `onChallenge`; the first non-empty
+ * credential returned by a handler wins. Observation handlers are isolated, so
+ * thrown listener errors do not stop sibling listeners or payment flow.
+ */
+export declare function createEventDispatcher<methods extends readonly Method.AnyClient[] = readonly Method.AnyClient[], response = Response>(): ClientEventDispatcher<methods, response>;
+/** @internal */
+export declare function validateCredentialHeaderValue(credential: string): void;
 export {};
 //# sourceMappingURL=Fetch.d.ts.map

package/dist/client/internal/Fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Fetch.d.ts","sourceRoot":"","sources":["../../../src/client/internal/Fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Fetch.d.ts","sourceRoot":"","sources":["../../../src/client/internal/Fetch.ts"],"names":[],"mappings":"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"}