better-ship 0.20.0 → 0.22.0

package/dist/stripe/request.d.ts

@@ -0,0 +1,9 @@
+//#region src/infrastructure/stripe/request.d.ts
+/**
+ * Invoke one SDK operation; the SDK owns retries configured on its client or request.
+ * Convert every Stripe error to PaymentServiceError without logging; preserve the original error in cause.
+ * Non-Stripe failures propagate unchanged.
+ */
+export declare function stripeRequest<T>(operation: string, work: () => Promise<T>): Promise<T>;
+//#endregion
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","names":[],"sources":["../../src/infrastructure/stripe/request.ts"],"mappings":";;;;;;wBASsB,cAAc,GAAG,mBAAmB,YAAY,QAAQ,KAAK,QAAQ"}

package/dist/stripe/request.js

@@ -0,0 +1,21 @@
+import { PaymentServiceError } from "./payment-service.error.js";
+import Stripe from "stripe";
+
+//#region src/infrastructure/stripe/request.ts
+/**
+* Invoke one SDK operation; the SDK owns retries configured on its client or request.
+* Convert every Stripe error to PaymentServiceError without logging; preserve the original error in cause.
+* Non-Stripe failures propagate unchanged.
+*/
+async function stripeRequest(operation, work) {
+	try {
+		return await work();
+	} catch (cause) {
+		if (!(cause instanceof Stripe.errors.StripeError)) throw cause;
+		throw new PaymentServiceError(operation, cause);
+	}
+}
+
+//#endregion
+export { stripeRequest };
+//# sourceMappingURL=request.js.map

package/dist/stripe/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","names":[],"sources":["../../src/infrastructure/stripe/request.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { PaymentServiceError } from './payment-service.error.ts'\n\n/**\n * Invoke one SDK operation; the SDK owns retries configured on its client or request.\n * Convert every Stripe error to PaymentServiceError without logging; preserve the original error in cause.\n * Non-Stripe failures propagate unchanged.\n */\nexport async function stripeRequest<T>(operation: string, work: () => Promise<T>): Promise<T> {\n  try {\n    return await work()\n  } catch (cause) {\n    if (!(cause instanceof Stripe.errors.StripeError)) throw cause\n    throw new PaymentServiceError(operation, cause)\n  }\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,cAAiB,WAAmB,MAAoC;CAC5F,IAAI;EACF,OAAO,MAAM,KAAK;CACpB,SAAS,OAAO;EACd,IAAI,EAAE,iBAAiB,OAAO,OAAO,cAAc,MAAM;EACzD,MAAM,IAAI,oBAAoB,WAAW,KAAK;CAChD;AACF"}

package/dist/tanstack.js

@@ -1,4 +1,4 @@
-import { H as StaleSessionError, R as ValidationError, W as AuthenticationError, nt as AppError, r as createLogger } from "./core-BT1dSEQI.js";
+import { H as StaleSessionError, R as ValidationError, W as AuthenticationError, nt as AppError, r as createLogger } from "./core-BIas38R0.js";
 import { z } from "zod";
 import { getReasonPhrase } from "http-status-codes";
 import { isNotFound, isRedirect, redirect } from "@tanstack/react-router";

package/dist/testing/outbox-repository.d.ts

@@ -1,5 +1,5 @@
 import { W as DomainEvent } from "../index-DUFS0SJ_.js";
-import { A as IOutboxRepository } from "../index-CYHXOH08.js";
+import { A as IOutboxRepository } from "../index-tNZHSCpJ.js";
 //#region src/infrastructure/testing/outbox-repository-contract.d.ts
 /** Stored fields observed by the adapter contract, independent of a database library. */
 export type OutboxContractRow = {

package/dist/testing/payment-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-service.d.ts","names":[],"sources":["../../src/infrastructure/testing/payment-service-contract.ts"],"mappings":";;;;;;;wBAUgB,uBACd,OAAO,cAAc,WAAW,wBAChC,SAAS,QAAQ,WAAW"}
+{"version":3,"file":"payment-service.d.ts","names":[],"sources":["../../src/infrastructure/testing/payment-service-contract.ts"],"mappings":";;;;;;;wBAYgB,uBACd,OAAO,cAAc,WAAW,wBAChC,SAAS,QAAQ,WAAW"}

package/dist/testing/payment-service.js

@@ -1,5 +1,7 @@
+import { PaymentServiceError } from "../stripe/payment-service.error.js";
+import { stripeFixture } from "./stripe.js";
 import Stripe from "stripe";
-import { deepStrictEqual, equal, rejects } from "node:assert/strict";
+import { deepStrictEqual, equal, ok, rejects } from "node:assert/strict";
 
 //#region src/infrastructure/testing/payment-service-contract.ts
 /**
@@ -39,7 +41,7 @@ function paymentServiceContract(test, create) {
 			status: "requires_capture"
 		});
 	});
-	test("card failures retain the native error contract", async () => {
+	test("card failures retain the native error in cause", async () => {
 		const fixture = paymentFixture(create, Response.json({ error: {
 			type: "card_error",
 			code: "authentication_required",
@@ -50,23 +52,21 @@ function paymentServiceContract(test, create) {
 			currency: "usd",
 			customer: "cus_contract",
 			payment_method: "pm_contract"
-		}, { idempotencyKey: "charge:contract" }), Stripe.errors.StripeCardError);
+		}, { idempotencyKey: "charge:contract" }), (error) => {
+			ok(error instanceof PaymentServiceError);
+			ok(error.cause instanceof Stripe.errors.StripeCardError);
+			equal(error.cause.code, "authentication_required");
+			return true;
+		});
 	});
 }
 function paymentFixture(create, response = Response.json({
 	id: "pi_contract",
 	status: "requires_capture"
 })) {
-	const requests = [];
+	const { stripe, requests } = stripeFixture(() => response.clone());
 	return {
-		service: create(new Stripe("sk_test_contract", { httpClient: Stripe.createFetchHttpClient(async (input, init) => {
-			const request = new Request(input, init);
-			requests.push({
-				headers: request.headers,
-				body: new URLSearchParams(new TextDecoder().decode(await request.arrayBuffer()))
-			});
-			return response.clone();
-		}) })),
+		service: create(stripe),
 		requests
 	};
 }

package/dist/testing/payment-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-service.js","names":[],"sources":["../../src/infrastructure/testing/payment-service-contract.ts"],"sourcesContent":["import { deepStrictEqual, equal, rejects } from 'node:assert/strict'\n\nimport Stripe from 'stripe'\n\nimport type { IPaymentService } from '../stripe/payment-service.ts'\n\n/**\n * Test a Stripe payment adapter through native fetch injection without live payments.\n * Each case constructs a fresh SDK instance and adapter; no Vitest dependency is required.\n */\nexport function paymentServiceContract(\n  test: (name: string, run: () => Promise<void>) => void,\n  create: (stripe: Stripe) => IPaymentService,\n): void {\n  test('payment checkout selects payment mode and retains the supplied key', async () => {\n    const fixture = paymentFixture(create)\n    await fixture.service.createCheckout(\n      { customer: 'cus_contract' },\n      { idempotencyKey: 'checkout:contract' },\n    )\n    equal(fixture.requests[0]?.body.get('mode'), 'payment')\n    equal(fixture.requests[0]?.headers.get('idempotency-key'), 'checkout:contract')\n  })\n\n  test('payment method setup selects setup mode', async () => {\n    const fixture = paymentFixture(create)\n    await fixture.service.setupPaymentMethod(\n      { customer: 'cus_contract' },\n      { idempotencyKey: 'setup:contract' },\n    )\n    equal(fixture.requests[0]?.body.get('mode'), 'setup')\n  })\n\n  test('saved method payments confirm off-session', async () => {\n    const fixture = paymentFixture(create)\n    await fixture.service.chargeSavedMethod(\n      { amount: 1000, currency: 'usd', customer: 'cus_contract', payment_method: 'pm_contract' },\n      { idempotencyKey: 'charge:contract' },\n    )\n    equal(fixture.requests[0]?.body.get('confirm'), 'true')\n    equal(fixture.requests[0]?.body.get('off_session'), 'true')\n  })\n\n  test('payment reads preserve native statuses and response fields', async () => {\n    const fixture = paymentFixture(create)\n    const payment = await fixture.service.getPayment('pi_contract')\n    deepStrictEqual(\n      { id: payment.id, status: payment.status },\n      { id: 'pi_contract', status: 'requires_capture' },\n    )\n  })\n\n  test('card failures retain the native error contract', async () => {\n    const response = Response.json(\n      {\n        error: {\n          type: 'card_error',\n          code: 'authentication_required',\n          message: 'Authentication required',\n        },\n      },\n      { status: 402 },\n    )\n    const fixture = paymentFixture(create, response)\n    await rejects(\n      fixture.service.chargeSavedMethod(\n        { amount: 1000, currency: 'usd', customer: 'cus_contract', payment_method: 'pm_contract' },\n        { idempotencyKey: 'charge:contract' },\n      ),\n      Stripe.errors.StripeCardError,\n    )\n  })\n}\n\nfunction paymentFixture(\n  create: (stripe: Stripe) => IPaymentService,\n  response = Response.json({ id: 'pi_contract', status: 'requires_capture' }),\n) {\n  const requests: { headers: Headers; body: URLSearchParams }[] = []\n  const stripe = new Stripe('sk_test_contract', {\n    httpClient: Stripe.createFetchHttpClient(async (input, init) => {\n      const request = new Request(input, init)\n      requests.push({\n        headers: request.headers,\n        body: new URLSearchParams(new TextDecoder().decode(await request.arrayBuffer())),\n      })\n      return response.clone()\n    }),\n  })\n  return { service: create(stripe), requests }\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,uBACd,MACA,QACM;CACN,KAAK,sEAAsE,YAAY;EACrF,MAAM,UAAU,eAAe,MAAM;EACrC,MAAM,QAAQ,QAAQ,eACpB,EAAE,UAAU,eAAe,GAC3B,EAAE,gBAAgB,oBAAoB,CACxC;EACA,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,MAAM,GAAG,SAAS;EACtD,MAAM,QAAQ,SAAS,EAAE,EAAE,QAAQ,IAAI,iBAAiB,GAAG,mBAAmB;CAChF,CAAC;CAED,KAAK,2CAA2C,YAAY;EAC1D,MAAM,UAAU,eAAe,MAAM;EACrC,MAAM,QAAQ,QAAQ,mBACpB,EAAE,UAAU,eAAe,GAC3B,EAAE,gBAAgB,iBAAiB,CACrC;EACA,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,MAAM,GAAG,OAAO;CACtD,CAAC;CAED,KAAK,6CAA6C,YAAY;EAC5D,MAAM,UAAU,eAAe,MAAM;EACrC,MAAM,QAAQ,QAAQ,kBACpB;GAAE,QAAQ;GAAM,UAAU;GAAO,UAAU;GAAgB,gBAAgB;EAAc,GACzF,EAAE,gBAAgB,kBAAkB,CACtC;EACA,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,SAAS,GAAG,MAAM;EACtD,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,aAAa,GAAG,MAAM;CAC5D,CAAC;CAED,KAAK,8DAA8D,YAAY;EAE7E,MAAM,UAAU,MADA,eAAe,MACH,CAAC,CAAC,QAAQ,WAAW,aAAa;EAC9D,gBACE;GAAE,IAAI,QAAQ;GAAI,QAAQ,QAAQ;EAAO,GACzC;GAAE,IAAI;GAAe,QAAQ;EAAmB,CAClD;CACF,CAAC;CAED,KAAK,kDAAkD,YAAY;EAWjE,MAAM,UAAU,eAAe,QAVd,SAAS,KACxB,EACE,OAAO;GACL,MAAM;GACN,MAAM;GACN,SAAS;EACX,EACF,GACA,EAAE,QAAQ,IAAI,CAE8B,CAAC;EAC/C,MAAM,QACJ,QAAQ,QAAQ,kBACd;GAAE,QAAQ;GAAM,UAAU;GAAO,UAAU;GAAgB,gBAAgB;EAAc,GACzF,EAAE,gBAAgB,kBAAkB,CACtC,GACA,OAAO,OAAO,eAChB;CACF,CAAC;AACH;AAEA,SAAS,eACP,QACA,WAAW,SAAS,KAAK;CAAE,IAAI;CAAe,QAAQ;AAAmB,CAAC,GAC1E;CACA,MAAM,WAA0D,CAAC;CAWjE,OAAO;EAAE,SAAS,OAAO,IAVN,OAAO,oBAAoB,EAC5C,YAAY,OAAO,sBAAsB,OAAO,OAAO,SAAS;GAC9D,MAAM,UAAU,IAAI,QAAQ,OAAO,IAAI;GACvC,SAAS,KAAK;IACZ,SAAS,QAAQ;IACjB,MAAM,IAAI,gBAAgB,IAAI,YAAY,CAAC,CAAC,OAAO,MAAM,QAAQ,YAAY,CAAC,CAAC;GACjF,CAAC;GACD,OAAO,SAAS,MAAM;EACxB,CAAC,EACH,CAC8B,CAAC;EAAG;CAAS;AAC7C"}
+{"version":3,"file":"payment-service.js","names":[],"sources":["../../src/infrastructure/testing/payment-service-contract.ts"],"sourcesContent":["import { deepStrictEqual, equal, ok, rejects } from 'node:assert/strict'\n\nimport Stripe from 'stripe'\n\nimport { PaymentServiceError } from '../stripe/payment-service.error.ts'\nimport type { IPaymentService } from '../stripe/payment-service.ts'\nimport { stripeFixture } from './stripe-fixture.ts'\n\n/**\n * Test a Stripe payment adapter through native fetch injection without live payments.\n * Each case constructs a fresh SDK instance and adapter; no Vitest dependency is required.\n */\nexport function paymentServiceContract(\n  test: (name: string, run: () => Promise<void>) => void,\n  create: (stripe: Stripe) => IPaymentService,\n): void {\n  test('payment checkout selects payment mode and retains the supplied key', async () => {\n    const fixture = paymentFixture(create)\n    await fixture.service.createCheckout(\n      { customer: 'cus_contract' },\n      { idempotencyKey: 'checkout:contract' },\n    )\n    equal(fixture.requests[0]?.body.get('mode'), 'payment')\n    equal(fixture.requests[0]?.headers.get('idempotency-key'), 'checkout:contract')\n  })\n\n  test('payment method setup selects setup mode', async () => {\n    const fixture = paymentFixture(create)\n    await fixture.service.setupPaymentMethod(\n      { customer: 'cus_contract' },\n      { idempotencyKey: 'setup:contract' },\n    )\n    equal(fixture.requests[0]?.body.get('mode'), 'setup')\n  })\n\n  test('saved method payments confirm off-session', async () => {\n    const fixture = paymentFixture(create)\n    await fixture.service.chargeSavedMethod(\n      { amount: 1000, currency: 'usd', customer: 'cus_contract', payment_method: 'pm_contract' },\n      { idempotencyKey: 'charge:contract' },\n    )\n    equal(fixture.requests[0]?.body.get('confirm'), 'true')\n    equal(fixture.requests[0]?.body.get('off_session'), 'true')\n  })\n\n  test('payment reads preserve native statuses and response fields', async () => {\n    const fixture = paymentFixture(create)\n    const payment = await fixture.service.getPayment('pi_contract')\n    deepStrictEqual(\n      { id: payment.id, status: payment.status },\n      { id: 'pi_contract', status: 'requires_capture' },\n    )\n  })\n\n  test('card failures retain the native error in cause', async () => {\n    const response = Response.json(\n      {\n        error: {\n          type: 'card_error',\n          code: 'authentication_required',\n          message: 'Authentication required',\n        },\n      },\n      { status: 402 },\n    )\n    const fixture = paymentFixture(create, response)\n    await rejects(\n      fixture.service.chargeSavedMethod(\n        { amount: 1000, currency: 'usd', customer: 'cus_contract', payment_method: 'pm_contract' },\n        { idempotencyKey: 'charge:contract' },\n      ),\n      (error) => {\n        ok(error instanceof PaymentServiceError)\n        ok(error.cause instanceof Stripe.errors.StripeCardError)\n        equal(error.cause.code, 'authentication_required')\n        return true\n      },\n    )\n  })\n}\n\nfunction paymentFixture(\n  create: (stripe: Stripe) => IPaymentService,\n  response = Response.json({ id: 'pi_contract', status: 'requires_capture' }),\n) {\n  const { stripe, requests } = stripeFixture(() => response.clone())\n  return { service: create(stripe), requests }\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,uBACd,MACA,QACM;CACN,KAAK,sEAAsE,YAAY;EACrF,MAAM,UAAU,eAAe,MAAM;EACrC,MAAM,QAAQ,QAAQ,eACpB,EAAE,UAAU,eAAe,GAC3B,EAAE,gBAAgB,oBAAoB,CACxC;EACA,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,MAAM,GAAG,SAAS;EACtD,MAAM,QAAQ,SAAS,EAAE,EAAE,QAAQ,IAAI,iBAAiB,GAAG,mBAAmB;CAChF,CAAC;CAED,KAAK,2CAA2C,YAAY;EAC1D,MAAM,UAAU,eAAe,MAAM;EACrC,MAAM,QAAQ,QAAQ,mBACpB,EAAE,UAAU,eAAe,GAC3B,EAAE,gBAAgB,iBAAiB,CACrC;EACA,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,MAAM,GAAG,OAAO;CACtD,CAAC;CAED,KAAK,6CAA6C,YAAY;EAC5D,MAAM,UAAU,eAAe,MAAM;EACrC,MAAM,QAAQ,QAAQ,kBACpB;GAAE,QAAQ;GAAM,UAAU;GAAO,UAAU;GAAgB,gBAAgB;EAAc,GACzF,EAAE,gBAAgB,kBAAkB,CACtC;EACA,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,SAAS,GAAG,MAAM;EACtD,MAAM,QAAQ,SAAS,EAAE,EAAE,KAAK,IAAI,aAAa,GAAG,MAAM;CAC5D,CAAC;CAED,KAAK,8DAA8D,YAAY;EAE7E,MAAM,UAAU,MADA,eAAe,MACH,CAAC,CAAC,QAAQ,WAAW,aAAa;EAC9D,gBACE;GAAE,IAAI,QAAQ;GAAI,QAAQ,QAAQ;EAAO,GACzC;GAAE,IAAI;GAAe,QAAQ;EAAmB,CAClD;CACF,CAAC;CAED,KAAK,kDAAkD,YAAY;EAWjE,MAAM,UAAU,eAAe,QAVd,SAAS,KACxB,EACE,OAAO;GACL,MAAM;GACN,MAAM;GACN,SAAS;EACX,EACF,GACA,EAAE,QAAQ,IAAI,CAE8B,CAAC;EAC/C,MAAM,QACJ,QAAQ,QAAQ,kBACd;GAAE,QAAQ;GAAM,UAAU;GAAO,UAAU;GAAgB,gBAAgB;EAAc,GACzF,EAAE,gBAAgB,kBAAkB,CACtC,IACC,UAAU;GACT,GAAG,iBAAiB,mBAAmB;GACvC,GAAG,MAAM,iBAAiB,OAAO,OAAO,eAAe;GACvD,MAAM,MAAM,MAAM,MAAM,yBAAyB;GACjD,OAAO;EACT,CACF;CACF,CAAC;AACH;AAEA,SAAS,eACP,QACA,WAAW,SAAS,KAAK;CAAE,IAAI;CAAe,QAAQ;AAAmB,CAAC,GAC1E;CACA,MAAM,EAAE,QAAQ,aAAa,oBAAoB,SAAS,MAAM,CAAC;CACjE,OAAO;EAAE,SAAS,OAAO,MAAM;EAAG;CAAS;AAC7C"}

package/dist/testing/stripe.d.ts

@@ -0,0 +1,21 @@
+import Stripe from "stripe";
+//#region src/infrastructure/testing/stripe-fixture.d.ts
+/** One SDK HTTP attempt; query and body expose Stripe's URL-encoded parameters. */
+export type StripeCall = {
+  readonly method: string;
+  readonly path: string;
+  readonly query: URLSearchParams;
+  readonly body: URLSearchParams;
+  readonly headers: Headers;
+};
+type StripeFixture = {
+  stripe: Stripe;
+  requests: readonly StripeCall[];
+};
+/**
+ * Construct the real SDK with a fake fetch transport and an ordered record of HTTP attempts.
+ * The responder receives an unread request. The shared client factory supplies retry defaults.
+ */
+export declare function stripeFixture(respond: (request: Request) => Response | Promise<Response>): StripeFixture;
+//#endregion
+//# sourceMappingURL=stripe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","names":[],"sources":["../../src/infrastructure/testing/stripe-fixture.ts"],"mappings":";;;YAKY;WACD;WACA;WACA,OAAO;WACP,MAAM;WACN,SAAS;;KAGf;EAAkB,QAAQ;EAAQ,mBAAmB;;;;;;wBAM1C,cACd,UAAU,SAAS,YAAY,WAAW,QAAQ,YACjD"}

package/dist/testing/stripe.js

@@ -0,0 +1,33 @@
+import { createStripeClient } from "../stripe/client.js";
+import Stripe from "stripe";
+
+//#region src/infrastructure/testing/stripe-fixture.ts
+/**
+* Construct the real SDK with a fake fetch transport and an ordered record of HTTP attempts.
+* The responder receives an unread request. The shared client factory supplies retry defaults.
+*/
+function stripeFixture(respond) {
+	const requests = [];
+	return {
+		stripe: createStripeClient("sk_test_fixture", { httpClient: Stripe.createFetchHttpClient(async (input, init) => {
+			const request = new Request(input, init);
+			const url = new URL(request.url);
+			const call = {
+				method: request.method,
+				path: url.pathname,
+				query: url.searchParams,
+				body: new URLSearchParams(),
+				headers: new Headers(request.headers)
+			};
+			requests.push(call);
+			const body = new TextDecoder().decode(await request.clone().arrayBuffer());
+			for (const [key, value] of new URLSearchParams(body)) call.body.append(key, value);
+			return respond(request);
+		}) }),
+		requests
+	};
+}
+
+//#endregion
+export { stripeFixture };
+//# sourceMappingURL=stripe.js.map

package/dist/testing/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","names":[],"sources":["../../src/infrastructure/testing/stripe-fixture.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { createStripeClient } from '../stripe/client.ts'\n\n/** One SDK HTTP attempt; query and body expose Stripe's URL-encoded parameters. */\nexport type StripeCall = {\n  readonly method: string\n  readonly path: string\n  readonly query: URLSearchParams\n  readonly body: URLSearchParams\n  readonly headers: Headers\n}\n\ntype StripeFixture = { stripe: Stripe; requests: readonly StripeCall[] }\n\n/**\n * Construct the real SDK with a fake fetch transport and an ordered record of HTTP attempts.\n * The responder receives an unread request. The shared client factory supplies retry defaults.\n */\nexport function stripeFixture(\n  respond: (request: Request) => Response | Promise<Response>,\n): StripeFixture {\n  const requests: StripeCall[] = []\n  const stripe = createStripeClient('sk_test_fixture', {\n    httpClient: Stripe.createFetchHttpClient(async (input, init) => {\n      const request = new Request(input, init)\n      const url = new URL(request.url)\n      const call: StripeCall = {\n        method: request.method,\n        path: url.pathname,\n        query: url.searchParams,\n        body: new URLSearchParams(),\n        headers: new Headers(request.headers),\n      }\n      requests.push(call)\n      const body = new TextDecoder().decode(await request.clone().arrayBuffer())\n      for (const [key, value] of new URLSearchParams(body)) call.body.append(key, value)\n      return respond(request)\n    }),\n  })\n  return { stripe, requests }\n}\n"],"mappings":";;;;;;;;AAmBA,SAAgB,cACd,SACe;CACf,MAAM,WAAyB,CAAC;CAkBhC,OAAO;EAAE,QAjBM,mBAAmB,mBAAmB,EACnD,YAAY,OAAO,sBAAsB,OAAO,OAAO,SAAS;GAC9D,MAAM,UAAU,IAAI,QAAQ,OAAO,IAAI;GACvC,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;GAC/B,MAAM,OAAmB;IACvB,QAAQ,QAAQ;IAChB,MAAM,IAAI;IACV,OAAO,IAAI;IACX,MAAM,IAAI,gBAAgB;IAC1B,SAAS,IAAI,QAAQ,QAAQ,OAAO;GACtC;GACA,SAAS,KAAK,IAAI;GAClB,MAAM,OAAO,IAAI,YAAY,CAAC,CAAC,OAAO,MAAM,QAAQ,MAAM,CAAC,CAAC,YAAY,CAAC;GACzE,KAAK,MAAM,CAAC,KAAK,UAAU,IAAI,gBAAgB,IAAI,GAAG,KAAK,KAAK,OAAO,KAAK,KAAK;GACjF,OAAO,QAAQ,OAAO;EACxB,CAAC,EACH,CACc;EAAG;CAAS;AAC5B"}

package/dist/{webhook-verification-qSFXv5H3.js → webhook-verification-CEUARY9X.js}

@@ -1,4 +1,4 @@
-import { nt as AppError } from "./core-BT1dSEQI.js";
+import { nt as AppError } from "./core-BIas38R0.js";
 
 //#region src/infrastructure/http/webhook-verification.ts
 /** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */
@@ -15,4 +15,4 @@ var WebhookVerificationError = class extends AppError {
 
 //#endregion
 export { WebhookVerificationError as t };
-//# sourceMappingURL=webhook-verification-qSFXv5H3.js.map
+//# sourceMappingURL=webhook-verification-CEUARY9X.js.map

package/dist/{webhook-verification-qSFXv5H3.js.map → webhook-verification-CEUARY9X.js.map}

@@ -1 +1 @@
-{"version":3,"file":"webhook-verification-qSFXv5H3.js","names":[],"sources":["../src/infrastructure/http/webhook-verification.ts"],"sourcesContent":["import { AppError } from '@/core'\n\n/** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */\nexport class WebhookVerificationError extends AppError {\n  readonly _tag = 'WebhookVerificationError'\n  readonly classification = 'terminal'\n\n  /** Keep secrets and payload details out of the public message. */\n  constructor(\n    readonly reason: 'missing_headers' | 'invalid_signature' | 'invalid_payload',\n    cause?: unknown,\n  ) {\n    super(`Webhook rejected: ${reason}`, { cause })\n  }\n}\n\n/** The provider owns signature verification, timestamp tolerance, and payload parsing. */\nexport interface WebhookVerifier<Verified> {\n  /**\n   * Verify the exact body before parsing it. Return null for an ignored webhook.\n   * @throws WebhookVerificationError when the request cannot be trusted or parsed.\n   */\n  verify(body: string, headers: Headers): Promise<Verified | null>\n}\n"],"mappings":";;;;AAGA,IAAa,2BAAb,cAA8C,SAAS;CAM1C;CALX,AAAS,OAAO;CAChB,AAAS,iBAAiB;;CAG1B,YACE,AAAS,QACT,OACA;EACA,MAAM,qBAAqB,UAAU,EAAE,MAAM,CAAC;EAHrC;CAIX;AACF"}
+{"version":3,"file":"webhook-verification-CEUARY9X.js","names":[],"sources":["../src/infrastructure/http/webhook-verification.ts"],"sourcesContent":["import { AppError } from '@/core'\n\n/** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */\nexport class WebhookVerificationError extends AppError {\n  readonly _tag = 'WebhookVerificationError'\n  readonly classification = 'terminal'\n\n  /** Keep secrets and payload details out of the public message. */\n  constructor(\n    readonly reason: 'missing_headers' | 'invalid_signature' | 'invalid_payload',\n    cause?: unknown,\n  ) {\n    super(`Webhook rejected: ${reason}`, { cause })\n  }\n}\n\n/** The provider owns signature verification, timestamp tolerance, and payload parsing. */\nexport interface WebhookVerifier<Verified> {\n  /**\n   * Verify the exact body before parsing it. Return null for an ignored webhook.\n   * @throws WebhookVerificationError when the request cannot be trusted or parsed.\n   */\n  verify(body: string, headers: Headers): Promise<Verified | null>\n}\n"],"mappings":";;;;AAGA,IAAa,2BAAb,cAA8C,SAAS;CAM1C;CALX,AAAS,OAAO;CAChB,AAAS,iBAAiB;;CAG1B,YACE,AAAS,QACT,OACA;EACA,MAAM,qBAAqB,UAAU,EAAE,MAAM,CAAC;EAHrC;CAIX;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "better-ship",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Foundation for applications on Cloudflare Workers: logger, errors, message bus, infrastructure adapters, and UI primitives",
   "license": "Apache-2.0",
   "repository": {
@@ -44,13 +44,17 @@
     "./sentry/client": "./dist/sentry/client.js",
     "./sentry/server": "./dist/sentry/server.js",
     "./sentry/vite": "./dist/sentry/vite.js",
+    "./stripe/client": "./dist/stripe/client.js",
+    "./stripe/event-map": "./dist/stripe/event-map.js",
     "./stripe/payment-service": "./dist/stripe/payment-service.js",
     "./stripe/payment-service.error": "./dist/stripe/payment-service.error.js",
     "./stripe/payment-webhook": "./dist/stripe/payment-webhook.js",
+    "./stripe/request": "./dist/stripe/request.js",
     "./tanstack": "./dist/tanstack.js",
     "./tanstack/server": "./dist/tanstack/server.js",
     "./testing/outbox-repository": "./dist/testing/outbox-repository.js",
     "./testing/payment-service": "./dist/testing/payment-service.js",
+    "./testing/stripe": "./dist/testing/stripe.js",
     "./ui": "./dist/ui.js",
     "./package.json": "./package.json"
   },

package/src/application/email-service.ts

@@ -32,6 +32,9 @@ export type OutboundEmail = {
   readonly attachments?: readonly EmailAttachment[]
 }
 
+/** Received email headers, without the body or attachments. */
+export type ReceivedEmail = { readonly headers: Readonly<Record<string, string>> }
+
 /** The provider accepted the email and assigned its id. */
 export type EmailAccepted = { readonly providerId: string }
 

package/src/application/index.ts

@@ -19,6 +19,7 @@ export {
   type EmailAttachment,
   type MimeType,
   type EmailAccepted,
+  type ReceivedEmail,
 } from './email-service.ts'
 export {
   recordEmailEvent,

package/src/core/email-service.error.ts

@@ -40,7 +40,7 @@ export class EmailServiceError extends AppError {
     readonly retryAfter: number | null
     readonly cause: unknown
   }) {
-    super(`Email send failed: ${args.provider} ${args.providerCode}`, { cause: args.cause })
+    super(`Email request failed: ${args.provider} ${args.providerCode}`, { cause: args.cause })
     this.reason = args.reason
     this.classification = CLASSIFICATION_BY_REASON[args.reason]
     this.provider = args.provider

package/src/infrastructure/resend/email-event.ts

@@ -37,6 +37,7 @@ const EMAIL_TYPES = {
 
 const BaseDataSchema = z.object({
   email_id: z.string().min(1),
+  message_id: z.string().min(1),
   to: z.array(EmailAddressSchema).min(1),
   subject: z.string(),
   tags: z.record(z.string(), z.string()).default({}),
@@ -67,6 +68,7 @@ const EmailPayloadSchema = z.discriminatedUnion('type', [
 type EmailEventBase = {
   readonly id: string
   readonly emailId: string
+  readonly messageId: string
   readonly recipients: readonly string[]
   readonly subject: string
   readonly tags: Readonly<Record<string, string>>
@@ -100,6 +102,7 @@ export function parseEmailEvent(payload: WebhookEventPayload, id: string): Email
   const base: EmailEventBase = {
     id,
     emailId: event.data.email_id,
+    messageId: event.data.message_id,
     recipients: event.data.to,
     subject: event.data.subject,
     tags: event.data.tags,

package/src/infrastructure/resend/index.ts

@@ -1,3 +1,3 @@
-export { ResendEmailService, type ResendEmailClient } from './resend-email-service.ts'
-export { ResendWebhook, type ResendWebhookClient } from './resend-webhook.ts'
+export { ResendEmailService } from './resend-email-service.ts'
+export { ResendWebhook } from './resend-webhook.ts'
 export type { EmailEvent, EmailEventType } from './email-event.ts'

package/src/infrastructure/resend/resend-email-service.ts

@@ -2,7 +2,13 @@ import { Buffer } from 'node:buffer'
 
 import type { Attachment, CreateEmailOptions, ErrorResponse, Resend } from 'resend'
 
-import type { EmailAccepted, EmailAttachment, IEmailService, OutboundEmail } from '@/application'
+import type {
+  EmailAccepted,
+  EmailAttachment,
+  IEmailService,
+  OutboundEmail,
+  ReceivedEmail,
+} from '@/application'
 import { EmailServiceError, type EmailSendFailureReason } from '@/core'
 
 // SDK additions must receive an explicit classification before the package builds.
@@ -67,37 +73,27 @@ function toAttachment(attachment: EmailAttachment): Attachment {
   return result
 }
 
-/** The SDK operations required by the adapter; a test factory can return a plain object. */
-export type ResendEmailClient = { readonly emails: Pick<Resend['emails'], 'send'> }
-
 /**
  * Send without package retries or logs. Ported from Suparelay's resend-email-service.ts.
  * The Resend SDK itself logs API errors outside production.
  */
 export class ResendEmailService implements IEmailService {
-  /** Load the SDK on the first send. Constructing the service does not load it. */
+  /** Load the SDK on the first email operation. Constructing the service does not load it. */
   static create(apiKey: string, fromAddress: string): ResendEmailService {
-    return new ResendEmailService(
-      () => import('resend').then(({ Resend }) => new Resend(apiKey)),
-      fromAddress,
-    )
+    return new ResendEmailService(apiKey, fromAddress)
   }
 
-  private client: Promise<ResendEmailClient> | undefined
+  private client: Resend | undefined
 
-  /** Supply an async factory. The service calls it once, on the first send, and keeps its promise. */
+  /** Store configuration. Load the SDK and create its client on the first email operation. */
   constructor(
-    private readonly createClient: () => Promise<ResendEmailClient>,
+    private readonly apiKey: string,
     private readonly fromAddress: string,
   ) {}
 
   /** Resolve after acceptance. Provider failures throw EmailServiceError; SDK defects retain their identity. */
   async sendEmail(email: OutboundEmail): Promise<EmailAccepted> {
-    if (this.client === undefined) {
-      // Cache synchronous factory throws as rejections too, so later sends cannot initialize again.
-      this.client = Promise.resolve().then(this.createClient)
-    }
-    const client = await this.client
+    const client = await this.getClient()
     const payload: CreateEmailOptions = {
       from: email.from ?? this.fromAddress,
       to: [email.to].flat(),
@@ -125,4 +121,30 @@ export class ResendEmailService implements IEmailService {
     }
     return { providerId: result.data.id }
   }
+
+  /** Retrieve headers by the received email's provider ID. Provider failures throw EmailServiceError. */
+  async getReceivedEmail(emailId: string): Promise<ReceivedEmail> {
+    const client = await this.getClient()
+    const result = await client.emails.receiving.get(emailId)
+    if (result.error !== null) {
+      throw new EmailServiceError({
+        reason: reasonFromResend(result.error),
+        provider: 'resend',
+        providerCode: result.error.name,
+        statusCode: result.error.statusCode,
+        retryAfter: retryAfterSeconds(result.headers?.['retry-after']),
+        cause: result.error,
+      })
+    }
+    return { headers: result.data.headers ?? {} }
+  }
+
+  private async getClient(): Promise<Resend> {
+    if (this.client === undefined) {
+      const { Resend } = await import('resend')
+      // Recheck after the import so concurrent calls share one client.
+      this.client ??= new Resend(this.apiKey)
+    }
+    return this.client
+  }
 }

package/src/infrastructure/resend/resend-webhook.ts

@@ -9,27 +9,17 @@ const SignatureErrorSchema = z
   .instanceof(Error)
   .refine((error) => error.name === 'WebhookVerificationError')
 
-/** The SDK's local signature verifier. It makes no API request. */
-export type ResendWebhookClient = Pick<Resend['webhooks'], 'verify'>
-
 /** Verify Svix signatures and map Resend email events. Ported from Typist's Resend route. */
 export class ResendWebhook implements WebhookVerifier<EmailEvent> {
   /** Load the SDK on the first verification. Only the webhook secret is required. */
   static create(webhookSecret: string): ResendWebhook {
-    return new ResendWebhook(webhookSecret, async () => {
-      const { Resend } = await import('resend')
-      // The SDK requires a nonempty key even though its local verifier never uses that key.
-      return new Resend('re_webhook_verification_only').webhooks
-    })
+    return new ResendWebhook(webhookSecret)
   }
 
-  private client: Promise<ResendWebhookClient> | undefined
+  private client: Resend['webhooks'] | undefined
 
-  /** Inject the local SDK verifier when testing. */
-  constructor(
-    private readonly webhookSecret: string,
-    private readonly verifier: () => Promise<ResendWebhookClient>,
-  ) {}
+  /** Store the webhook secret. Load the SDK on the first verification. */
+  constructor(private readonly webhookSecret: string) {}
 
   /** Verify the raw body and Svix headers. Invalid requests throw typed errors; other failures propagate. */
   async verify(body: string, headers: Headers): Promise<EmailEvent | null> {
@@ -37,8 +27,8 @@ export class ResendWebhook implements WebhookVerifier<EmailEvent> {
     const timestamp = headers.get('svix-timestamp')
     const signature = headers.get('svix-signature')
     if (!id || !timestamp || !signature) throw new WebhookVerificationError('missing_headers')
-    const client = await (this.client ??= this.verifier())
-    let payload: ReturnType<ResendWebhookClient['verify']>
+    const client = await this.getClient()
+    let payload: ReturnType<Resend['webhooks']['verify']>
     try {
       payload = client.verify({
         payload: body,
@@ -57,4 +47,13 @@ export class ResendWebhook implements WebhookVerifier<EmailEvent> {
       throw cause
     }
   }
+
+  private async getClient(): Promise<Resend['webhooks']> {
+    if (this.client === undefined) {
+      const { Resend } = await import('resend')
+      // The SDK requires a nonempty key even though its local verifier never uses that key.
+      this.client ??= new Resend('re_webhook_verification_only').webhooks
+    }
+    return this.client
+  }
 }

package/src/infrastructure/stripe/client.ts

@@ -0,0 +1,16 @@
+import Stripe from 'stripe'
+
+/** Default SDK retries; client configuration and individual requests can override this value. */
+export const STRIPE_REQUEST_OPTIONS = Object.freeze({ maxNetworkRetries: 2 })
+
+/**
+ * Construct a native Stripe client with fetch transport and two SDK retries by default.
+ * Native configuration overrides these defaults. Inject the client into application services.
+ */
+export function createStripeClient(secretKey: string, options: Stripe.StripeConfig = {}): Stripe {
+  return new Stripe(secretKey, {
+    httpClient: Stripe.createFetchHttpClient(),
+    ...STRIPE_REQUEST_OPTIONS,
+    ...options,
+  })
+}

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

@@ -0,0 +1,25 @@
+import type Stripe from 'stripe'
+
+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.
+ */
+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
+  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)
+  }
+}
+
+/** 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}`
+}

package/src/infrastructure/stripe/payment-service.error.ts

@@ -26,7 +26,8 @@ function classifyStripeError(error: Stripe.errors.StripeError): FailureClassific
     error instanceof Stripe.errors.StripeAuthenticationError ||
     error instanceof Stripe.errors.StripePermissionError ||
     error instanceof Stripe.errors.StripeInvalidRequestError ||
-    error instanceof Stripe.errors.StripeIdempotencyError
+    error instanceof Stripe.errors.StripeIdempotencyError ||
+    error instanceof Stripe.errors.StripeCardError
   )
     return 'terminal'
   if (error.headers?.['stripe-should-retry'] === 'true') return 'transient'

package/src/infrastructure/stripe/payment-service.ts

@@ -1,6 +1,6 @@
-import Stripe from 'stripe'
+import type Stripe from 'stripe'
 
-import { PaymentServiceError } from './payment-service.error.ts'
+import { stripeRequest } from './request.ts'
 
 /** Supply the same key and parameters when repeating one durable payment attempt. */
 export type PaymentRequestOptions = Stripe.RequestOptions &
@@ -24,7 +24,7 @@ export type PaymentResult = Awaited<ReturnType<Stripe['paymentIntents']['create'
 
 /**
  * Stripe payment operations, with native types and stable keys for mutations.
- * Rejects with PaymentServiceError or native StripeCardError; unexpected defects propagate.
+ * Rejects with PaymentServiceError for Stripe failures; non-Stripe failures propagate unchanged.
  */
 export interface IPaymentService {
   /** Create a customer; the application owns persistence and reuse of the customer link. */
@@ -36,7 +36,7 @@ export interface IPaymentService {
   createCheckout(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult>
   /** Create checkout in setup mode. The application records consent and verifies the saved method's owner. */
   setupPaymentMethod(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult>
-  /** Confirm a saved method off-session. Native card errors can require customer authentication. */
+  /** Confirm a saved method off-session. PaymentServiceError retains card errors in cause. */
   chargeSavedMethod(
     input: SavedMethodCharge,
     options: PaymentRequestOptions,
@@ -51,7 +51,7 @@ export interface IPaymentService {
 
 /**
  * Ported from Typist's StripeClient request boundary; the native SDK now owns retries.
- * Each request defaults to two SDK retries. Native request options can override retries and timeout.
+ * The injected client owns retry and timeout defaults. Native request options can override them.
  */
 export class StripePaymentService implements IPaymentService {
   /** Inject a native SDK instance; its transport, credentials, and API version remain caller-owned. */
@@ -62,18 +62,13 @@ export class StripePaymentService implements IPaymentService {
     input: Stripe.CustomerCreateParams,
     options: PaymentRequestOptions,
   ): Promise<CustomerResult> {
-    return this.request('customers.create', () =>
-      this.stripe.customers.create(input, { maxNetworkRetries: 2, ...options }),
-    )
+    return stripeRequest('customers.create', () => this.stripe.customers.create(input, options))
   }
 
   /** Force payment mode after caller parameters; return the native Checkout Session. */
   createCheckout(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult> {
-    return this.request('checkout.sessions.create', () =>
-      this.stripe.checkout.sessions.create(
-        { ...input, mode: 'payment' },
-        { maxNetworkRetries: 2, ...options },
-      ),
+    return stripeRequest('checkout.sessions.create', () =>
+      this.stripe.checkout.sessions.create({ ...input, mode: 'payment' }, options),
     )
   }
 
@@ -82,24 +77,18 @@ export class StripePaymentService implements IPaymentService {
     input: CheckoutInput,
     options: PaymentRequestOptions,
   ): Promise<CheckoutResult> {
-    return this.request('checkout.sessions.create', () =>
-      this.stripe.checkout.sessions.create(
-        { ...input, mode: 'setup' },
-        { maxNetworkRetries: 2, ...options },
-      ),
+    return stripeRequest('checkout.sessions.create', () =>
+      this.stripe.checkout.sessions.create({ ...input, mode: 'setup' }, options),
     )
   }
 
-  /** Force confirmation and off-session use; preserve native card failures for application handling. */
+  /** Force confirmation and off-session use; retain native card failures in PaymentServiceError.cause. */
   chargeSavedMethod(
     input: SavedMethodCharge,
     options: PaymentRequestOptions,
   ): Promise<PaymentResult> {
-    return this.request('paymentIntents.create', () =>
-      this.stripe.paymentIntents.create(
-        { ...input, confirm: true, off_session: true },
-        { maxNetworkRetries: 2, ...options },
-      ),
+    return stripeRequest('paymentIntents.create', () =>
+      this.stripe.paymentIntents.create({ ...input, confirm: true, off_session: true }, options),
     )
   }
 
@@ -109,21 +98,8 @@ export class StripePaymentService implements IPaymentService {
     params?: Stripe.PaymentIntentRetrieveParams,
     options?: Stripe.RequestOptions,
   ): Promise<PaymentResult> {
-    return this.request('paymentIntents.retrieve', () =>
-      this.stripe.paymentIntents.retrieve(paymentId, params, { maxNetworkRetries: 2, ...options }),
+    return stripeRequest('paymentIntents.retrieve', () =>
+      this.stripe.paymentIntents.retrieve(paymentId, params, options),
     )
   }
-
-  private async request<T>(operation: string, work: () => Promise<T>): Promise<T> {
-    try {
-      return await work()
-    } catch (cause) {
-      if (
-        !(cause instanceof Stripe.errors.StripeError) ||
-        cause instanceof Stripe.errors.StripeCardError
-      )
-        throw cause
-      throw new PaymentServiceError(operation, cause)
-    }
-  }
 }