better-ship 0.43.0 → 0.44.0

package/dist/stripe/event-map.d.ts

@@ -4,10 +4,12 @@ type EventObject<K extends Stripe.Event['type']> = Extract<Stripe.Event, {
   type: K;
 }>['data']['object'];
 /**
- * Convert verified Stripe events with callbacks typed to each event's object.
- * Unmapped events return undefined. Applications own validation and payment policy.
+ * Convert one verified Stripe event with callbacks typed to that event's object.
+ * An entry is one callback or an array of callbacks. Results stay in entry order.
+ * A callback returns `undefined` to ignore the event; the result omits it.
+ * An unmapped event returns `[]`. Applications own validation and payment policy.
  */
-export declare function stripeEventMap<T>(map: { [K in Stripe.Event['type']]?: (object: EventObject<K>) => T; }): (event: Stripe.Event) => T | undefined;
+export declare function stripeEventMap<T>(map: { [K in Stripe.Event['type']]?: ((object: EventObject<K>) => T | undefined) | readonly ((object: EventObject<K>) => T | undefined)[]; }): (event: Stripe.Event) => T[];
 /** Identify one Stripe event delivery; different events for one payment retain different IDs. */
 export declare function stripeEventId(event: Stripe.Event): string;
 //#endregion

package/dist/stripe/event-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-map.d.ts","names":[],"sources":["../../src/infrastructure/stripe/event-map.ts"],"mappings":";;KAEK,YAAY,UAAU,OAAO,iBAAiB,QACjD,OAAO;EACL,MAAM;;;;;;wBAOM,eAAe,GAAG,QAC/B,KAAK,OAAO,kBAAkB,QAAQ,YAAY,OAAO,QACvD,OAAO,OAAO,UAAU;;wBASb,cAAc,OAAO,OAAO"}
+{"version":3,"file":"event-map.d.ts","names":[],"sources":["../../src/infrastructure/stripe/event-map.ts"],"mappings":";;KAEK,YAAY,UAAU,OAAO,iBAAiB,QACjD,OAAO;EACL,MAAM;;;;;;;;wBAWM,eAAe,GAAG,QAC/B,KAAK,OAAO,mBACP,QAAQ,YAAY,OAAO,4BAClB,QAAQ,YAAY,OAAO,uBACvC,OAAO,OAAO,UAAU;;wBAwBb,cAAc,OAAO,OAAO"}

package/dist/stripe/event-map.js

@@ -1,14 +1,24 @@
 //#region src/infrastructure/stripe/event-map.ts
 /**
-* Convert verified Stripe events with callbacks typed to each event's object.
-* Unmapped events return undefined. Applications own validation and payment policy.
+* Convert one verified Stripe event with callbacks typed to that event's object.
+* An entry is one callback or an array of callbacks. Results stay in entry order.
+* A callback returns `undefined` to ignore the event; the result omits it.
+* An unmapped event returns `[]`. Applications own validation and payment policy.
 */
 function stripeEventMap(map) {
 	const handlers = map;
 	return (event) => {
-		return handlers[event.type]?.(event.data.object);
+		const entry = handlers[event.type];
+		if (entry === void 0) return [];
+		return (isCallbackList(entry) ? entry : [entry]).flatMap((callback) => {
+			const result = callback(event.data.object);
+			return result === void 0 ? [] : [result];
+		});
 	};
 }
+function isCallbackList(entry) {
+	return Array.isArray(entry);
+}
 /** Identify one Stripe event delivery; different events for one payment retain different IDs. */
 function stripeEventId(event) {
 	return `stripe:event:${event.id}`;

package/dist/stripe/event-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-map.js","names":[],"sources":["../../src/infrastructure/stripe/event-map.ts"],"sourcesContent":["import type Stripe from 'stripe'\n\ntype EventObject<K extends Stripe.Event['type']> = Extract<\n  Stripe.Event,\n  { type: K }\n>['data']['object']\n\n/**\n * Convert verified Stripe events with callbacks typed to each event's object.\n * Unmapped events return undefined. Applications own validation and payment policy.\n */\nexport function stripeEventMap<T>(map: {\n  [K in Stripe.Event['type']]?: (object: EventObject<K>) => T\n}): (event: Stripe.Event) => T | undefined {\n  const handlers: Partial<Record<Stripe.Event['type'], (object: never) => T>> = map\n  return (event) => {\n    // SAFETY: The map binds each event type to its object; indexed lookup loses that correlation.\n    return handlers[event.type]?.(event.data.object as never)\n  }\n}\n\n/** Identify one Stripe event delivery; different events for one payment retain different IDs. */\nexport function stripeEventId(event: Stripe.Event): string {\n  return `stripe:event:${event.id}`\n}\n"],"mappings":";;;;;AAWA,SAAgB,eAAkB,KAES;CACzC,MAAM,WAAwE;CAC9E,QAAQ,UAAU;EAEhB,OAAO,SAAS,MAAM,KAAK,GAAG,MAAM,KAAK,MAAe;CAC1D;AACF;;AAGA,SAAgB,cAAc,OAA6B;CACzD,OAAO,gBAAgB,MAAM;AAC/B"}
+{"version":3,"file":"event-map.js","names":[],"sources":["../../src/infrastructure/stripe/event-map.ts"],"sourcesContent":["import type Stripe from 'stripe'\n\ntype EventObject<K extends Stripe.Event['type']> = Extract<\n  Stripe.Event,\n  { type: K }\n>['data']['object']\n\ntype EventCallback<T> = (object: never) => T | undefined\n\n/**\n * Convert one verified Stripe event with callbacks typed to that event's object.\n * An entry is one callback or an array of callbacks. Results stay in entry order.\n * A callback returns `undefined` to ignore the event; the result omits it.\n * An unmapped event returns `[]`. Applications own validation and payment policy.\n */\nexport function stripeEventMap<T>(map: {\n  [K in Stripe.Event['type']]?:\n    | ((object: EventObject<K>) => T | undefined)\n    | readonly ((object: EventObject<K>) => T | undefined)[]\n}): (event: Stripe.Event) => T[] {\n  const handlers: Partial<\n    Record<Stripe.Event['type'], EventCallback<T> | readonly EventCallback<T>[]>\n  > = map\n  return (event) => {\n    const entry = handlers[event.type]\n    if (entry === undefined) return []\n    const callbacks = isCallbackList(entry) ? entry : [entry]\n    return callbacks.flatMap((callback) => {\n      // SAFETY: The map binds each event type to its object; indexed lookup loses that correlation.\n      const result = callback(event.data.object as never)\n      return result === undefined ? [] : [result]\n    })\n  }\n}\n\n// Array.isArray widens to any[], so the predicate restores the callback list type.\nfunction isCallbackList<T>(\n  entry: EventCallback<T> | readonly EventCallback<T>[],\n): entry is readonly EventCallback<T>[] {\n  return Array.isArray(entry)\n}\n\n/** Identify one Stripe event delivery; different events for one payment retain different IDs. */\nexport function stripeEventId(event: Stripe.Event): string {\n  return `stripe:event:${event.id}`\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,eAAkB,KAID;CAC/B,MAAM,WAEF;CACJ,QAAQ,UAAU;EAChB,MAAM,QAAQ,SAAS,MAAM;EAC7B,IAAI,UAAU,QAAW,OAAO,CAAC;EAEjC,QADkB,eAAe,KAAK,IAAI,QAAQ,CAAC,KAAK,EACxC,CAAC,SAAS,aAAa;GAErC,MAAM,SAAS,SAAS,MAAM,KAAK,MAAe;GAClD,OAAO,WAAW,SAAY,CAAC,IAAI,CAAC,MAAM;EAC5C,CAAC;CACH;AACF;AAGA,SAAS,eACP,OACsC;CACtC,OAAO,MAAM,QAAQ,KAAK;AAC5B;;AAGA,SAAgB,cAAc,OAA6B;CACzD,OAAO,gBAAgB,MAAM;AAC/B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "better-ship",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "description": "Foundation for applications on Cloudflare Workers: logger, errors, message bus, infrastructure adapters, and UI primitives",
   "license": "Apache-2.0",
   "repository": {

package/src/infrastructure/stripe/event-map.ts

@@ -5,20 +5,41 @@ type EventObject<K extends Stripe.Event['type']> = Extract<
   { type: K }
 >['data']['object']
 
+type EventCallback<T> = (object: never) => T | undefined
+
 /**
- * Convert verified Stripe events with callbacks typed to each event's object.
- * Unmapped events return undefined. Applications own validation and payment policy.
+ * Convert one verified Stripe event with callbacks typed to that event's object.
+ * An entry is one callback or an array of callbacks. Results stay in entry order.
+ * A callback returns `undefined` to ignore the event; the result omits it.
+ * An unmapped event returns `[]`. Applications own validation and payment policy.
  */
 export function stripeEventMap<T>(map: {
-  [K in Stripe.Event['type']]?: (object: EventObject<K>) => T
-}): (event: Stripe.Event) => T | undefined {
-  const handlers: Partial<Record<Stripe.Event['type'], (object: never) => T>> = map
+  [K in Stripe.Event['type']]?:
+    | ((object: EventObject<K>) => T | undefined)
+    | readonly ((object: EventObject<K>) => T | undefined)[]
+}): (event: Stripe.Event) => T[] {
+  const handlers: Partial<
+    Record<Stripe.Event['type'], EventCallback<T> | readonly EventCallback<T>[]>
+  > = map
   return (event) => {
-    // SAFETY: The map binds each event type to its object; indexed lookup loses that correlation.
-    return handlers[event.type]?.(event.data.object as never)
+    const entry = handlers[event.type]
+    if (entry === undefined) return []
+    const callbacks = isCallbackList(entry) ? entry : [entry]
+    return callbacks.flatMap((callback) => {
+      // SAFETY: The map binds each event type to its object; indexed lookup loses that correlation.
+      const result = callback(event.data.object as never)
+      return result === undefined ? [] : [result]
+    })
   }
 }
 
+// Array.isArray widens to any[], so the predicate restores the callback list type.
+function isCallbackList<T>(
+  entry: EventCallback<T> | readonly EventCallback<T>[],
+): entry is readonly EventCallback<T>[] {
+  return Array.isArray(entry)
+}
+
 /** Identify one Stripe event delivery; different events for one payment retain different IDs. */
 export function stripeEventId(event: Stripe.Event): string {
   return `stripe:event:${event.id}`