@dineway-ai/plugin-payment 0.2.2 → 0.2.4

package/src/admin.tsx

@@ -1,18 +1,18 @@
 import * as React from "react";
 
-import type { PaymentStripeConfiguration } from "./configuration/service.js";
 import { postPaymentRoute } from "./admin/api.js";
 import {
 	buildPaymentSettingsUpdate,
 	paymentSettingsForm,
 	type PaymentSettingsForm,
 } from "./admin/form.js";
+import { PaymentSubscriptionsPage } from "./admin/subscriptions.js";
+import type { PaymentStripeConfiguration } from "./configuration/service.js";
 
 type CredentialName = "secretKey" | "webhookSecret";
 
 export function PaymentSettingsPage() {
-	const [configuration, setConfiguration] =
-		React.useState<PaymentStripeConfiguration | null>(null);
+	const [configuration, setConfiguration] = React.useState<PaymentStripeConfiguration | null>(null);
 	const [form, setForm] = React.useState<PaymentSettingsForm | null>(null);
 	const [loading, setLoading] = React.useState(true);
 	const [pending, setPending] = React.useState(false);
@@ -26,9 +26,7 @@ export function PaymentSettingsPage() {
 
 	React.useEffect(() => {
 		let cancelled = false;
-		void postPaymentRoute<{ configuration: PaymentStripeConfiguration }>(
-			"stripe/configuration/get",
-		)
+		void postPaymentRoute<{ configuration: PaymentStripeConfiguration }>("stripe/configuration/get")
 			.then((response) => {
 				if (!cancelled) applyConfiguration(response.configuration);
 				return undefined;
@@ -94,58 +92,220 @@ export function PaymentSettingsPage() {
 
 	if (loading) return <p className="text-sm text-kumo-subtle">Loading payment settings…</p>;
 	if (!configuration || !form) {
-		return <p className="rounded-lg bg-kumo-danger/10 p-4 text-sm text-kumo-danger">{error ?? "Payment configuration is unavailable."}</p>;
+		return (
+			<p className="rounded-lg bg-kumo-danger/10 p-4 text-sm text-kumo-danger">
+				{error ?? "Payment configuration is unavailable."}
+			</p>
+		);
 	}
 	const canTest = Boolean(
 		configuration.settings.publishableKey &&
-			configuration.secretKey &&
-			form.mode === configuration.settings.mode &&
-			form.publishableKey.trim() === configuration.settings.publishableKey &&
-			!form.secretKey.trim(),
+		configuration.secretKey &&
+		form.mode === configuration.settings.mode &&
+		form.publishableKey.trim() === configuration.settings.publishableKey &&
+		!form.secretKey.trim(),
 	);
 
 	return (
 		<div className="space-y-6">
 			<header className="flex flex-wrap items-start justify-between gap-3">
-				<div><h1 className="text-2xl font-semibold">Payments</h1><p className="mt-1 text-sm text-kumo-subtle">Shared Stripe account and encrypted credentials for every transactional plugin.</p></div>
-				<span className="rounded-full bg-kumo-tint px-3 py-1 text-xs font-semibold uppercase">{configuration.settings.configurationStatus}</span>
+				<div>
+					<h1 className="text-2xl font-semibold">Payments</h1>
+					<p className="mt-1 text-sm text-kumo-subtle">
+						Shared Stripe account and encrypted credentials for every transactional plugin.
+					</p>
+				</div>
+				<span className="rounded-full bg-kumo-tint px-3 py-1 text-xs font-semibold uppercase">
+					{configuration.settings.configurationStatus}
+				</span>
 			</header>
 			<Readiness configuration={configuration} />
-			{error ? <p className="rounded-lg bg-kumo-danger/10 p-3 text-sm text-kumo-danger" role="alert">{error}</p> : null}
-			{notice ? <p className="rounded-lg bg-kumo-success/10 p-3 text-sm text-kumo-success" role="status">{notice}</p> : null}
-			<form className="grid max-w-3xl gap-5 rounded-xl border border-kumo-line p-5" onSubmit={(event) => void save(event)}>
-				<fieldset className="grid gap-2" disabled={pending}><legend className="mb-2 text-sm font-medium">Stripe mode</legend><div className="flex gap-2">{(["test", "live"] as const).map((mode) => <button type="button" key={mode} className={`rounded-lg border px-4 py-2 text-sm ${form.mode === mode ? "border-kumo-contrast bg-kumo-contrast text-kumo-base" : "border-kumo-line"}`} onClick={() => setForm({ ...form, mode })}>{mode === "test" ? "Test" : "Live"}</button>)}</div></fieldset>
-				<Field label="Publishable key" value={form.publishableKey} onChange={(value) => setForm({ ...form, publishableKey: value })} placeholder={form.mode === "test" ? "pk_test_…" : "pk_live_…"} />
-				<Field label="Secret key" value={form.secretKey} onChange={(value) => setForm({ ...form, secretKey: value })} placeholder={configuration.secretKey ? "Leave blank to keep the current key" : form.mode === "test" ? "sk_test_…" : "sk_live_…"} type="password" />
-				<Credential label="Secret key" present={Boolean(configuration.secretKey)} fingerprint={configuration.secretKey?.fingerprint ?? null} onRemove={() => void removeCredential("secretKey")} disabled={pending} />
-				<Field label="Webhook signing secret" value={form.webhookSecret} onChange={(value) => setForm({ ...form, webhookSecret: value })} placeholder={configuration.webhookSecret ? "Leave blank to keep the current secret" : "whsec_…"} type="password" />
-				<Credential label="Webhook secret" present={Boolean(configuration.webhookSecret)} fingerprint={configuration.webhookSecret?.fingerprint ?? null} onRemove={() => void removeCredential("webhookSecret")} disabled={pending} />
-				<div className="flex flex-wrap gap-2"><button className="rounded-lg bg-kumo-contrast px-4 py-2 text-sm font-medium text-kumo-base" disabled={pending}>{pending ? "Saving…" : "Save account"}</button><button type="button" className="rounded-lg border border-kumo-line px-4 py-2 text-sm font-medium" disabled={!canTest || pending} onClick={() => void testConnection()}>{pending ? "Working…" : "Test connection"}</button></div>
+			{error ? (
+				<p className="rounded-lg bg-kumo-danger/10 p-3 text-sm text-kumo-danger" role="alert">
+					{error}
+				</p>
+			) : null}
+			{notice ? (
+				<p className="rounded-lg bg-kumo-success/10 p-3 text-sm text-kumo-success" role="status">
+					{notice}
+				</p>
+			) : null}
+			<form
+				className="grid max-w-3xl gap-5 rounded-xl border border-kumo-line p-5"
+				onSubmit={(event) => void save(event)}
+			>
+				<fieldset className="grid gap-2" disabled={pending}>
+					<legend className="mb-2 text-sm font-medium">Stripe mode</legend>
+					<div className="flex gap-2">
+						{(["test", "live"] as const).map((mode) => (
+							<button
+								type="button"
+								key={mode}
+								className={`rounded-lg border px-4 py-2 text-sm ${form.mode === mode ? "border-kumo-contrast bg-kumo-contrast text-kumo-base" : "border-kumo-line"}`}
+								onClick={() => setForm({ ...form, mode })}
+							>
+								{mode === "test" ? "Test" : "Live"}
+							</button>
+						))}
+					</div>
+				</fieldset>
+				<Field
+					label="Publishable key"
+					value={form.publishableKey}
+					onChange={(value) => setForm({ ...form, publishableKey: value })}
+					placeholder={form.mode === "test" ? "pk_test_…" : "pk_live_…"}
+				/>
+				<Field
+					label="Secret key"
+					value={form.secretKey}
+					onChange={(value) => setForm({ ...form, secretKey: value })}
+					placeholder={
+						configuration.secretKey
+							? "Leave blank to keep the current key"
+							: form.mode === "test"
+								? "sk_test_…"
+								: "sk_live_…"
+					}
+					type="password"
+				/>
+				<Credential
+					label="Secret key"
+					present={Boolean(configuration.secretKey)}
+					fingerprint={configuration.secretKey?.fingerprint ?? null}
+					onRemove={() => void removeCredential("secretKey")}
+					disabled={pending}
+				/>
+				<Field
+					label="Webhook signing secret"
+					value={form.webhookSecret}
+					onChange={(value) => setForm({ ...form, webhookSecret: value })}
+					placeholder={
+						configuration.webhookSecret ? "Leave blank to keep the current secret" : "whsec_…"
+					}
+					type="password"
+				/>
+				<Credential
+					label="Webhook secret"
+					present={Boolean(configuration.webhookSecret)}
+					fingerprint={configuration.webhookSecret?.fingerprint ?? null}
+					onRemove={() => void removeCredential("webhookSecret")}
+					disabled={pending}
+				/>
+				<div className="flex flex-wrap gap-2">
+					<button
+						className="rounded-lg bg-kumo-contrast px-4 py-2 text-sm font-medium text-kumo-base"
+						disabled={pending}
+					>
+						{pending ? "Saving…" : "Save account"}
+					</button>
+					<button
+						type="button"
+						className="rounded-lg border border-kumo-line px-4 py-2 text-sm font-medium"
+						disabled={!canTest || pending}
+						onClick={() => void testConnection()}
+					>
+						{pending ? "Working…" : "Test connection"}
+					</button>
+				</div>
 			</form>
-			<section className="max-w-3xl rounded-xl bg-kumo-tint/40 p-5 text-sm text-kumo-subtle"><h2 className="font-semibold text-kumo-default">Webhook endpoint</h2><p className="mt-2">Configure Stripe to send domain events to the webhook shown by each installed transactional plugin. Venue and Restaurant validate exact request bytes with this shared signing secret.</p></section>
+			<section className="max-w-3xl rounded-xl bg-kumo-tint/40 p-5 text-sm text-kumo-subtle">
+				<h2 className="font-semibold text-kumo-default">Webhook endpoint</h2>
+				<p className="mt-2">
+					Configure Stripe to send domain events to the webhook shown by each installed
+					transactional plugin. Venue and Restaurant validate exact request bytes with this shared
+					signing secret.
+				</p>
+			</section>
 		</div>
 	);
 }
 
 function Readiness({ configuration }: { configuration: PaymentStripeConfiguration }) {
 	const settings = configuration.settings;
-	return <div className="grid gap-3 md:grid-cols-4"><Metric label="Account" value={settings.stripeAccountId ?? "Not verified"} /><Metric label="Charges" value={settings.chargesEnabled === null ? "Unknown" : settings.chargesEnabled ? "Enabled" : "Restricted"} /><Metric label="Tax" value={settings.taxStatus} /><Metric label="Connection" value={settings.connectStatus} /></div>;
+	return (
+		<div className="grid gap-3 md:grid-cols-4">
+			<Metric label="Account" value={settings.stripeAccountId ?? "Not verified"} />
+			<Metric
+				label="Charges"
+				value={
+					settings.chargesEnabled === null
+						? "Unknown"
+						: settings.chargesEnabled
+							? "Enabled"
+							: "Restricted"
+				}
+			/>
+			<Metric label="Tax" value={settings.taxStatus} />
+			<Metric label="Connection" value={settings.connectStatus} />
+		</div>
+	);
 }
 
 function Metric({ label, value }: { label: string; value: string }) {
-	return <div className="rounded-xl border border-kumo-line p-4"><div className="text-xs font-medium uppercase text-kumo-subtle">{label}</div><div className="mt-1 truncate font-semibold">{value}</div></div>;
+	return (
+		<div className="rounded-xl border border-kumo-line p-4">
+			<div className="text-xs font-medium uppercase text-kumo-subtle">{label}</div>
+			<div className="mt-1 truncate font-semibold">{value}</div>
+		</div>
+	);
 }
 
-function Field(props: { label: string; value: string; onChange: (value: string) => void; placeholder: string; type?: string }) {
-	return <label className="grid gap-1 text-sm font-medium">{props.label}<input className="rounded-lg border border-kumo-line bg-transparent px-3 py-2 font-normal" type={props.type ?? "text"} value={props.value} onChange={(event) => props.onChange(event.target.value)} placeholder={props.placeholder} autoComplete="off" disabled={false} /></label>;
+function Field(props: {
+	label: string;
+	value: string;
+	onChange: (value: string) => void;
+	placeholder: string;
+	type?: string;
+}) {
+	return (
+		<label className="grid gap-1 text-sm font-medium">
+			{props.label}
+			<input
+				className="rounded-lg border border-kumo-line bg-transparent px-3 py-2 font-normal"
+				type={props.type ?? "text"}
+				value={props.value}
+				onChange={(event) => props.onChange(event.target.value)}
+				placeholder={props.placeholder}
+				autoComplete="off"
+				disabled={false}
+			/>
+		</label>
+	);
 }
 
-function Credential(props: { label: string; present: boolean; fingerprint: string | null; onRemove: () => void; disabled: boolean }) {
-	return <div className="flex flex-wrap items-center justify-between gap-3 rounded-lg bg-kumo-tint/50 px-3 py-2 text-sm"><span>{props.present ? `${props.label} stored · ${props.fingerprint ?? "encrypted"}` : `${props.label} not stored`}</span>{props.present ? <button type="button" className="text-kumo-danger underline" onClick={props.onRemove} disabled={props.disabled}>Remove</button> : null}</div>;
+function Credential(props: {
+	label: string;
+	present: boolean;
+	fingerprint: string | null;
+	onRemove: () => void;
+	disabled: boolean;
+}) {
+	return (
+		<div className="flex flex-wrap items-center justify-between gap-3 rounded-lg bg-kumo-tint/50 px-3 py-2 text-sm">
+			<span>
+				{props.present
+					? `${props.label} stored · ${props.fingerprint ?? "encrypted"}`
+					: `${props.label} not stored`}
+			</span>
+			{props.present ? (
+				<button
+					type="button"
+					className="text-kumo-danger underline"
+					onClick={props.onRemove}
+					disabled={props.disabled}
+				>
+					Remove
+				</button>
+			) : null}
+		</div>
+	);
 }
 
 function message(value: unknown): string {
 	return value instanceof Error ? value.message : "Payment request failed";
 }
 
-export const pages = { "/payments": PaymentSettingsPage };
+export const pages = {
+	"/payments": PaymentSettingsPage,
+	"/payments/subscriptions": PaymentSubscriptionsPage,
+};

package/src/configuration/repository.ts

@@ -34,15 +34,11 @@ export class PaymentStripeConfigurationRepository {
 	): Promise<PaymentStripeSettings> {
 		const update: Updateable<Database["payment_stripe_settings"]> = {
 			...(input.mode === undefined ? {} : { mode: input.mode }),
-			...(input.publishableKey === undefined
-				? {}
-				: { publishable_key: input.publishableKey }),
+			...(input.publishableKey === undefined ? {} : { publishable_key: input.publishableKey }),
 			...(input.configurationStatus === undefined
 				? {}
 				: { configuration_status: input.configurationStatus }),
-			...(input.stripeAccountId === undefined
-				? {}
-				: { stripe_account_id: input.stripeAccountId }),
+			...(input.stripeAccountId === undefined ? {} : { stripe_account_id: input.stripeAccountId }),
 			...(input.chargesEnabled === undefined
 				? {}
 				: { charges_enabled: optionalBoolean(input.chargesEnabled) }),
@@ -53,12 +49,8 @@ export class PaymentStripeConfigurationRepository {
 			...(input.validationErrorCode === undefined
 				? {}
 				: { validation_error_code: input.validationErrorCode }),
-			...(input.lastValidatedAt === undefined
-				? {}
-				: { last_validated_at: input.lastValidatedAt }),
-			...(input.connectStatus === undefined
-				? {}
-				: { connect_status: input.connectStatus }),
+			...(input.lastValidatedAt === undefined ? {} : { last_validated_at: input.lastValidatedAt }),
+			...(input.connectStatus === undefined ? {} : { connect_status: input.connectStatus }),
 			version: expectedVersion + 1,
 			updated_at: new Date().toISOString(),
 		};

package/src/configuration/secrets.ts

@@ -10,10 +10,12 @@ import { PAYMENT_PLUGIN_ID } from "../constants.js";
 
 export const PAYMENT_STRIPE_SECRET_KEY = "stripe_secret_key";
 export const PAYMENT_STRIPE_WEBHOOK_SECRET = "stripe_webhook_secret";
+export const PAYMENT_STRIPE_SUBSCRIPTION_WEBHOOK_SECRET = "stripe_subscription_webhook_secret";
 
 export type PaymentStripeSecretName =
 	| typeof PAYMENT_STRIPE_SECRET_KEY
-	| typeof PAYMENT_STRIPE_WEBHOOK_SECRET;
+	| typeof PAYMENT_STRIPE_WEBHOOK_SECRET
+	| typeof PAYMENT_STRIPE_SUBSCRIPTION_WEBHOOK_SECRET;
 
 export class PaymentStripeSecretStore {
 	private readonly store: PluginSecretStore;

package/src/configuration/service.ts

@@ -1,8 +1,4 @@
-import type {
-	Database,
-	PluginSecretStatus,
-	PluginSecretStoreOptions,
-} from "dineway";
+import type { Database, PluginSecretStatus, PluginSecretStoreOptions } from "dineway";
 import type { Kysely, Transaction } from "kysely";
 
 import type { StripeAccountProbe, StripeMode } from "../types.js";
@@ -103,7 +99,9 @@ export async function updatePaymentStripeConfiguration(
 						taxStatus: "unknown" as const,
 						validationErrorCode: null,
 						lastValidatedAt: null,
-						connectStatus: credentialsComplete ? ("restricted" as const) : ("not_configured" as const),
+						connectStatus: credentialsComplete
+							? ("restricted" as const)
+							: ("not_configured" as const),
 					}
 				: {}),
 		});
@@ -143,28 +141,31 @@ export async function testPaymentStripeConnection(
 
 	return db.transaction().execute(async (trx) => {
 		const repository = new PaymentStripeConfigurationRepository(trx);
-		await repository.updateSettings(before.version, result.ok
-			? {
-					configurationStatus: "valid",
-					stripeAccountId: result.accountId,
-					chargesEnabled: result.chargesEnabled,
-					detailsSubmitted: result.detailsSubmitted,
-					taxStatus: result.taxStatus,
-					validationErrorCode: null,
-					lastValidatedAt: new Date().toISOString(),
-					connectStatus:
-						result.chargesEnabled && result.detailsSubmitted ? "ready" : "restricted",
-				}
-			: {
-					configurationStatus: "invalid",
-					stripeAccountId: null,
-					chargesEnabled: null,
-					detailsSubmitted: null,
-					taxStatus: "unknown",
-					validationErrorCode: result.errorCode,
-					lastValidatedAt: new Date().toISOString(),
-					connectStatus: "restricted",
-				});
+		await repository.updateSettings(
+			before.version,
+			result.ok
+				? {
+						configurationStatus: "valid",
+						stripeAccountId: result.accountId,
+						chargesEnabled: result.chargesEnabled,
+						detailsSubmitted: result.detailsSubmitted,
+						taxStatus: result.taxStatus,
+						validationErrorCode: null,
+						lastValidatedAt: new Date().toISOString(),
+						connectStatus:
+							result.chargesEnabled && result.detailsSubmitted ? "ready" : "restricted",
+					}
+				: {
+						configurationStatus: "invalid",
+						stripeAccountId: null,
+						chargesEnabled: null,
+						detailsSubmitted: null,
+						taxStatus: "unknown",
+						validationErrorCode: result.errorCode,
+						lastValidatedAt: new Date().toISOString(),
+						connectStatus: "restricted",
+					},
+		);
 		return loadConfiguration(trx, secretOptions);
 	});
 }
@@ -196,7 +197,10 @@ async function updateSecret(
 	await store.set(name, value.trim());
 }
 
-function normalizeOptionalKey(value: string | null | undefined, current: string | null): string | null {
+function normalizeOptionalKey(
+	value: string | null | undefined,
+	current: string | null,
+): string | null {
 	if (value === undefined) return current;
 	if (value === null) return null;
 	return value.trim() || null;
@@ -211,7 +215,11 @@ function validateUpdate(input: UpdatePaymentStripeConfigurationInput): void {
 	if (!Number.isSafeInteger(input.expectedVersion) || input.expectedVersion < 1) {
 		throw new PaymentConfigurationError("VALIDATION_ERROR", "Expected version is invalid");
 	}
-	if (input.publishableKey !== undefined && input.publishableKey !== null && input.publishableKey.length > 512) {
+	if (
+		input.publishableKey !== undefined &&
+		input.publishableKey !== null &&
+		input.publishableKey.length > 512
+	) {
 		throw new PaymentConfigurationError("VALIDATION_ERROR", "Publishable key is too long");
 	}
 	if (input.secretKey !== undefined && input.secretKey !== null && input.secretKey.length > 512) {
@@ -233,9 +241,6 @@ function validateModeKeys(
 		);
 	}
 	if (validateSecret && secretKey && !secretKey.startsWith(`sk_${keyMode}_`)) {
-		throw new PaymentConfigurationError(
-			"VALIDATION_ERROR",
-			`Secret key must match ${mode} mode`,
-		);
+		throw new PaymentConfigurationError("VALIDATION_ERROR", `Secret key must match ${mode} mode`);
 	}
 }

package/src/configuration/types.ts

@@ -1,10 +1,6 @@
 import type { StripeMode, StripeTaxStatus } from "../types.js";
 
-export type PaymentStripeConfigurationStatus =
-	| "unconfigured"
-	| "unverified"
-	| "valid"
-	| "invalid";
+export type PaymentStripeConfigurationStatus = "unconfigured" | "unverified" | "valid" | "invalid";
 export type PaymentStripeConnectStatus = "not_configured" | "restricted" | "ready";
 
 export interface PaymentStripeSettings {

package/src/index.ts

@@ -5,12 +5,17 @@ import { version as packageVersion } from "../package.json";
 import { PaymentStripeConfigurationRepository } from "./configuration/repository.js";
 import { PAYMENT_PLUGIN_ID } from "./constants.js";
 import { createPaymentRoutes } from "./routes/index.js";
+import { createSubscriptionRoutes } from "./subscriptions/routes.js";
+import type { SubscriptionOptions } from "./subscriptions/types.js";
 
 const PAYMENT_ADMIN_ENTRY = "@dineway-ai/plugin-payment/admin";
-const PAYMENT_ADMIN_PAGES = [{ path: "/payments", label: "Payments", icon: "credit-card" }] as const;
+const PAYMENT_ADMIN_PAGES = [
+	{ path: "/payments", label: "Payments", icon: "credit-card" },
+] as const;
 
 export interface PaymentPluginOptions {
 	appName?: string;
+	subscriptions?: SubscriptionOptions;
 }
 
 export function paymentPlugin(
@@ -22,14 +27,19 @@ export function paymentPlugin(
 		format: "native",
 		entrypoint: "@dineway-ai/plugin-payment",
 		adminEntry: PAYMENT_ADMIN_ENTRY,
-		adminPages: [...PAYMENT_ADMIN_PAGES],
+		adminPages: [
+			...PAYMENT_ADMIN_PAGES,
+			...(options.subscriptions
+				? [{ path: "/payments/subscriptions", label: "Subscriptions", icon: "credit-card" }]
+				: []),
+		],
 		options,
 		capabilities: ["network:request:unrestricted"],
 		allowedHosts: ["api.stripe.com"],
 	};
 }
 
-export function createPlugin(_options: PaymentPluginOptions = {}): ResolvedPlugin {
+export function createPlugin(options: PaymentPluginOptions = {}): ResolvedPlugin {
 	const ensurePaymentFoundation = async () => {
 		await new PaymentStripeConfigurationRepository(await getDb()).ensureDefaults();
 	};
@@ -42,9 +52,20 @@ export function createPlugin(_options: PaymentPluginOptions = {}): ResolvedPlugi
 		version: packageVersion,
 		capabilities: ["network:request:unrestricted"],
 		allowedHosts: ["api.stripe.com"],
-		admin: { entry: PAYMENT_ADMIN_ENTRY, pages: [...PAYMENT_ADMIN_PAGES] },
+		admin: {
+			entry: PAYMENT_ADMIN_ENTRY,
+			pages: [
+				...PAYMENT_ADMIN_PAGES,
+				...(options.subscriptions
+					? [{ path: "/payments/subscriptions", label: "Subscriptions", icon: "credit-card" }]
+					: []),
+			],
+		},
 		hooks,
-		routes: createPaymentRoutes(),
+		routes: {
+			...createPaymentRoutes(),
+			...(options.subscriptions ? createSubscriptionRoutes(options.subscriptions) : {}),
+		},
 	});
 }
 

package/src/routes/index.ts

@@ -31,7 +31,9 @@ export interface PaymentRouteOptions {
 	secretOptions?: PluginSecretStoreOptions;
 }
 
-export function createPaymentRoutes(options: PaymentRouteOptions = {}): Record<string, PluginRoute> {
+export function createPaymentRoutes(
+	options: PaymentRouteOptions = {},
+): Record<string, PluginRoute> {
 	const probe = options.accountProbe ?? new StripeNodeAccountProbe();
 	return {
 		"stripe/configuration/get": route(getPaymentStripeConfigurationSchema, async () => ({
@@ -48,11 +50,7 @@ export function createPaymentRoutes(options: PaymentRouteOptions = {}): Record<s
 			}),
 		),
 		"stripe/configuration/test": route(testPaymentStripeConnectionSchema, async () => ({
-			configuration: await testPaymentStripeConnection(
-				await getDb(),
-				probe,
-				options.secretOptions,
-			),
+			configuration: await testPaymentStripeConnection(await getDb(), probe, options.secretOptions),
 		})),
 	};
 }

package/src/stripe/account-probe.ts

@@ -1,11 +1,11 @@
 import Stripe from "stripe";
 
-import { stripeProviderFailure } from "./errors.js";
 import type {
 	StripeAccountProbe,
 	StripeAccountProbeInput,
 	StripeAccountProbeResult,
 } from "../types.js";
+import { stripeProviderFailure } from "./errors.js";
 
 export interface StripeAccountProbeClient {
 	retrieveCurrentAccount(): Promise<{

package/src/stripe/checkout-provider.ts

@@ -360,7 +360,11 @@ function stripeAddress(address: StripeAddress) {
 }
 
 function assertTaxCalculationInput(input: StripeTaxCalculationInput): void {
-	if (!input.secretKey.trim() || !input.idempotencyKey.trim() || !CURRENCY_PATTERN.test(input.currency)) {
+	if (
+		!input.secretKey.trim() ||
+		!input.idempotencyKey.trim() ||
+		!CURRENCY_PATTERN.test(input.currency)
+	) {
 		throw new Error("Stripe Tax credentials or currency are invalid");
 	}
 	if (input.lines.length === 0 || input.lines.length > 100) {
@@ -399,7 +403,10 @@ function assertTaxCalculationResponse(
 		}
 	}
 	const responseLines = new Map(response.lineItems.map((line) => [line.reference, line] as const));
-	if (response.lineItems.length !== input.lines.length || responseLines.size !== input.lines.length) {
+	if (
+		response.lineItems.length !== input.lines.length ||
+		responseLines.size !== input.lines.length
+	) {
 		throw new Error("Stripe Tax response line set does not match the request");
 	}
 	let calculatedTaxMinor = 0;
@@ -459,7 +466,10 @@ function assertPaymentIntentResponse(
 }
 
 function assertOperationInput(
-	input: StripeCancelPaymentIntentInput | StripeCapturePaymentIntentInput | StripeIncrementAuthorizationInput,
+	input:
+		| StripeCancelPaymentIntentInput
+		| StripeCapturePaymentIntentInput
+		| StripeIncrementAuthorizationInput,
 	requireAmount: boolean,
 ): void {
 	if (
@@ -517,7 +527,10 @@ function assertCancelResponse(
 }
 
 function assertMatchingOperationResponse(
-	input: StripeCancelPaymentIntentInput | StripeCapturePaymentIntentInput | StripeIncrementAuthorizationInput,
+	input:
+		| StripeCancelPaymentIntentInput
+		| StripeCapturePaymentIntentInput
+		| StripeIncrementAuthorizationInput,
 	response: StripeCheckoutPaymentIntentResponse,
 ): void {
 	if (
@@ -553,7 +566,8 @@ function validMetadata(metadata: Record<string, string> | undefined): boolean {
 	return (
 		entries.length <= 50 &&
 		entries.every(
-			([key, value]) => key.length > 0 && key.length <= 40 && value.length > 0 && value.length <= 500,
+			([key, value]) =>
+				key.length > 0 && key.length <= 40 && value.length > 0 && value.length <= 500,
 		)
 	);
 }

package/src/stripe/refund-provider.ts

@@ -125,7 +125,8 @@ function validMetadata(metadata: Record<string, string> | undefined): boolean {
 	return (
 		entries.length <= 50 &&
 		entries.every(
-			([key, value]) => key.length > 0 && key.length <= 40 && value.length > 0 && value.length <= 500,
+			([key, value]) =>
+				key.length > 0 && key.length <= 40 && value.length > 0 && value.length <= 500,
 		)
 	);
 }

package/src/stripe/webhook-verifier.ts

@@ -85,6 +85,14 @@ function projectEvent(event: Stripe.Event, rawBody: Uint8Array): StripeWebhookEv
 	const objectRecord = asRecord(event.data.object as unknown);
 	const objectType = optionalSafeString(objectRecord?.object, 128);
 	const objectId = optionalSafeString(objectRecord?.id, 255);
+	const subscriptionRelation =
+		objectType === "subscription"
+			? objectId
+			: objectType === "checkout.session"
+				? objectRecord?.subscription
+				: objectType === "invoice"
+					? asRecord(asRecord(objectRecord?.parent)?.subscription_details)?.subscription
+					: null;
 	if ((objectType === null) !== (objectId === null)) throw new Error("Incomplete Stripe object");
 
 	return {
@@ -96,8 +104,10 @@ function projectEvent(event: Stripe.Event, rawBody: Uint8Array): StripeWebhookEv
 		payloadSha256: `sha256:${createHash("sha256").update(rawBody).digest("hex")}`,
 		objectType,
 		objectId,
-		paymentIntent:
-			objectType === "payment_intent" ? projectPaymentIntent(objectRecord) : null,
+		...(subscriptionRelation
+			? { subscriptionId: requiredRelationId(subscriptionRelation, "sub_") }
+			: {}),
+		paymentIntent: objectType === "payment_intent" ? projectPaymentIntent(objectRecord) : null,
 		refund: objectType === "refund" ? projectRefund(objectRecord) : null,
 	};
 }