@better-auth/stripe 1.5.0-beta.18 → 1.5.0-beta.19

package/README.md

@@ -0,0 +1,17 @@
+# Better Auth Stripe Plugin
+
+Stripe plugin for [Better Auth](https://www.better-auth.com) — integrate Stripe billing with your authentication system.
+
+## Installation
+
+```bash
+npm install @better-auth/stripe
+```
+
+## Documentation
+
+For full documentation, visit [better-auth.com/docs/plugins/stripe](https://www.better-auth.com/docs/plugins/stripe).
+
+## License
+
+MIT

package/package.json

@@ -1,10 +1,8 @@
 {
   "name": "@better-auth/stripe",
-  "author": "Bereket Engida",
-  "version": "1.5.0-beta.18",
+  "version": "1.5.0-beta.19",
+  "description": "Stripe plugin for Better Auth",
   "type": "module",
-  "main": "dist/index.mjs",
-  "types": "dist/index.d.mts",
   "license": "MIT",
   "homepage": "https://www.better-auth.com/docs/plugins/stripe",
   "repository": {
@@ -12,16 +10,23 @@
     "url": "git+https://github.com/better-auth/better-auth.git",
     "directory": "packages/stripe"
   },
+  "author": "Bereket Engida",
   "keywords": [
     "stripe",
     "auth",
-    "stripe"
+    "payments",
+    "typescript",
+    "better-auth"
   ],
-  "module": "dist/index.mjs",
-  "description": "Stripe plugin for Better Auth",
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "dev-source": "./src/index.ts",
@@ -48,26 +53,26 @@
     "defu": "^6.1.4",
     "zod": "^4.3.6"
   },
-  "peerDependencies": {
-    "better-call": "1.3.2",
-    "stripe": "^18 || ^19 || ^20",
-    "@better-auth/core": "1.5.0-beta.18",
-    "better-auth": "1.5.0-beta.18"
-  },
   "devDependencies": {
     "better-call": "1.3.2",
     "stripe": "^20.2.0",
     "tsdown": "^0.20.3",
-    "@better-auth/core": "1.5.0-beta.18",
-    "better-auth": "1.5.0-beta.18"
+    "@better-auth/core": "1.5.0-beta.19",
+    "better-auth": "1.5.0-beta.19"
+  },
+  "peerDependencies": {
+    "better-call": "1.3.2",
+    "stripe": "^18 || ^19 || ^20",
+    "better-auth": "1.5.0-beta.19",
+    "@better-auth/core": "1.5.0-beta.19"
   },
   "scripts": {
-    "test": "vitest",
-    "coverage": "vitest run --coverage --coverage.provider=istanbul",
-    "lint:package": "publint run --strict",
-    "lint:types": "attw --profile esm-only --pack .",
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "typecheck": "tsc --project tsconfig.json"
+    "lint:package": "publint run --strict",
+    "lint:types": "attw --profile esm-only --pack .",
+    "typecheck": "tsc --project tsconfig.json",
+    "test": "vitest",
+    "coverage": "vitest run --coverage --coverage.provider=istanbul"
   }
 }

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @better-auth/stripe@1.5.0-beta.18 build /home/runner/work/better-auth/better-auth/packages/stripe
-> tsdown
-
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/better-auth/better-auth/packages/stripe/tsdown.config.ts 
-ℹ entry: src/index.ts, src/client.ts
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/index.mjs                      69.57 kB │ gzip: 13.19 kB
-ℹ dist/client.mjs                      0.43 kB │ gzip:  0.29 kB
-ℹ dist/index.mjs.map                 150.44 kB │ gzip: 29.40 kB
-ℹ dist/error-codes-CCosYkXx.mjs.map    2.43 kB │ gzip:  1.08 kB
-ℹ dist/error-codes-CCosYkXx.mjs        1.89 kB │ gzip:  0.85 kB
-ℹ dist/client.mjs.map                  1.26 kB │ gzip:  0.59 kB
-ℹ dist/index.d.mts                    19.78 kB │ gzip:  3.14 kB
-ℹ dist/client.d.mts                    4.80 kB │ gzip:  0.93 kB
-ℹ dist/types-OT6L84x4.d.mts           12.92 kB │ gzip:  2.96 kB
-ℹ 9 files, total: 263.52 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
-
-✔ Build complete in 43653ms

package/src/client.ts

@@ -1,37 +0,0 @@
-import type { BetterAuthClientPlugin } from "better-auth/client";
-import { STRIPE_ERROR_CODES } from "./error-codes";
-import type { StripePlan, stripe } from "./index";
-export const stripeClient = <
-	O extends {
-		subscription: boolean;
-	},
->(
-	options?: O | undefined,
-) => {
-	return {
-		id: "stripe-client",
-		$InferServerPlugin: {} as ReturnType<
-			typeof stripe<
-				O["subscription"] extends true
-					? {
-							stripeClient: any;
-							stripeWebhookSecret: string;
-							subscription: {
-								enabled: true;
-								plans: StripePlan[];
-							};
-						}
-					: {
-							stripeClient: any;
-							stripeWebhookSecret: string;
-						}
-			>
-		>,
-		pathMethods: {
-			"/subscription/billing-portal": "POST",
-			"/subscription/restore": "POST",
-		},
-		$ERROR_CODES: STRIPE_ERROR_CODES,
-	} satisfies BetterAuthClientPlugin;
-};
-export * from "./error-codes";

package/src/error-codes.ts

@@ -1,37 +0,0 @@
-import { defineErrorCodes } from "@better-auth/core/utils/error-codes";
-
-export const STRIPE_ERROR_CODES = defineErrorCodes({
-	UNAUTHORIZED: "Unauthorized access",
-	INVALID_REQUEST_BODY: "Invalid request body",
-	SUBSCRIPTION_NOT_FOUND: "Subscription not found",
-	SUBSCRIPTION_PLAN_NOT_FOUND: "Subscription plan not found",
-	ALREADY_SUBSCRIBED_PLAN: "You're already subscribed to this plan",
-	REFERENCE_ID_NOT_ALLOWED: "Reference id is not allowed",
-	CUSTOMER_NOT_FOUND: "Stripe customer not found for this user",
-	UNABLE_TO_CREATE_CUSTOMER: "Unable to create customer",
-	UNABLE_TO_CREATE_BILLING_PORTAL: "Unable to create billing portal session",
-	STRIPE_SIGNATURE_NOT_FOUND: "Stripe signature not found",
-	STRIPE_WEBHOOK_SECRET_NOT_FOUND: "Stripe webhook secret not found",
-	STRIPE_WEBHOOK_ERROR: "Stripe webhook error",
-	FAILED_TO_CONSTRUCT_STRIPE_EVENT: "Failed to construct Stripe event",
-	FAILED_TO_FETCH_PLANS: "Failed to fetch plans",
-	EMAIL_VERIFICATION_REQUIRED:
-		"Email verification is required before you can subscribe to a plan",
-	SUBSCRIPTION_NOT_ACTIVE: "Subscription is not active",
-	/**
-	 * @deprecated Use `SUBSCRIPTION_NOT_PENDING_CHANGE` instead.
-	 */
-	SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION:
-		"Subscription is not scheduled for cancellation",
-	SUBSCRIPTION_NOT_PENDING_CHANGE:
-		"Subscription has no pending cancellation or scheduled plan change",
-	ORGANIZATION_NOT_FOUND: "Organization not found",
-	ORGANIZATION_SUBSCRIPTION_NOT_ENABLED:
-		"Organization subscription is not enabled",
-	AUTHORIZE_REFERENCE_REQUIRED:
-		"Organization subscriptions require authorizeReference callback to be configured",
-	ORGANIZATION_HAS_ACTIVE_SUBSCRIPTION:
-		"Cannot delete organization with active subscription",
-	ORGANIZATION_REFERENCE_ID_REQUIRED:
-		"Reference ID is required. Provide referenceId or set activeOrganizationId in session",
-});

package/src/hooks.ts

@@ -1,479 +0,0 @@
-import type { GenericEndpointContext } from "@better-auth/core";
-import type { User } from "@better-auth/core/db";
-import type { Organization } from "better-auth/plugins/organization";
-import type Stripe from "stripe";
-import { subscriptionMetadata } from "./metadata";
-import type { CustomerType, StripeOptions, Subscription } from "./types";
-import {
-	isActiveOrTrialing,
-	isPendingCancel,
-	isStripePendingCancel,
-	resolvePlanItem,
-	resolveQuantity,
-} from "./utils";
-
-/**
- * Find organization or user by stripeCustomerId.
- * @internal
- */
-async function findReferenceByStripeCustomerId(
-	ctx: GenericEndpointContext,
-	options: StripeOptions,
-	stripeCustomerId: string,
-): Promise<{ customerType: CustomerType; referenceId: string } | null> {
-	if (options.organization?.enabled) {
-		const org = await ctx.context.adapter.findOne<Organization>({
-			model: "organization",
-			where: [{ field: "stripeCustomerId", value: stripeCustomerId }],
-		});
-		if (org) return { customerType: "organization", referenceId: org.id };
-	}
-
-	const user = await ctx.context.adapter.findOne<User>({
-		model: "user",
-		where: [{ field: "stripeCustomerId", value: stripeCustomerId }],
-	});
-	if (user) return { customerType: "user", referenceId: user.id };
-
-	return null;
-}
-
-export async function onCheckoutSessionCompleted(
-	ctx: GenericEndpointContext,
-	options: StripeOptions,
-	event: Stripe.Event,
-) {
-	try {
-		const client = options.stripeClient;
-		const checkoutSession = event.data.object as Stripe.Checkout.Session;
-		if (checkoutSession.mode === "setup" || !options.subscription?.enabled) {
-			return;
-		}
-		const subscription = await client.subscriptions.retrieve(
-			checkoutSession.subscription as string,
-		);
-		const resolved = await resolvePlanItem(options, subscription.items.data);
-		if (!resolved) {
-			ctx.context.logger.warn(
-				`Stripe webhook warning: Subscription ${subscription.id} has no items matching a configured plan`,
-			);
-			return;
-		}
-
-		const { item: subscriptionItem, plan } = resolved;
-		if (plan) {
-			const checkoutMeta = subscriptionMetadata.get(checkoutSession?.metadata);
-			const referenceId =
-				checkoutSession?.client_reference_id || checkoutMeta.referenceId;
-			const { subscriptionId } = checkoutMeta;
-			const seats = resolveQuantity(
-				subscription.items.data,
-				subscriptionItem,
-				plan.seatPriceId,
-			);
-			if (referenceId && subscriptionId) {
-				const trial =
-					subscription.trial_start && subscription.trial_end
-						? {
-								trialStart: new Date(subscription.trial_start * 1000),
-								trialEnd: new Date(subscription.trial_end * 1000),
-							}
-						: {};
-
-				let dbSubscription = await ctx.context.adapter.update<Subscription>({
-					model: "subscription",
-					update: {
-						...trial,
-						plan: plan.name.toLowerCase(),
-						status: subscription.status,
-						updatedAt: new Date(),
-						periodStart: new Date(subscriptionItem.current_period_start * 1000),
-						periodEnd: new Date(subscriptionItem.current_period_end * 1000),
-						stripeSubscriptionId: checkoutSession.subscription as string,
-						cancelAtPeriodEnd: subscription.cancel_at_period_end,
-						cancelAt: subscription.cancel_at
-							? new Date(subscription.cancel_at * 1000)
-							: null,
-						canceledAt: subscription.canceled_at
-							? new Date(subscription.canceled_at * 1000)
-							: null,
-						endedAt: subscription.ended_at
-							? new Date(subscription.ended_at * 1000)
-							: null,
-						seats: seats,
-						billingInterval: subscriptionItem.price.recurring?.interval,
-					},
-					where: [
-						{
-							field: "id",
-							value: subscriptionId,
-						},
-					],
-				});
-
-				if (trial.trialStart && plan.freeTrial?.onTrialStart) {
-					await plan.freeTrial.onTrialStart(dbSubscription as Subscription);
-				}
-
-				if (!dbSubscription) {
-					dbSubscription = await ctx.context.adapter.findOne<Subscription>({
-						model: "subscription",
-						where: [
-							{
-								field: "id",
-								value: subscriptionId,
-							},
-						],
-					});
-				}
-				await options.subscription?.onSubscriptionComplete?.(
-					{
-						event,
-						subscription: dbSubscription as Subscription,
-						stripeSubscription: subscription,
-						plan,
-					},
-					ctx,
-				);
-				return;
-			}
-		}
-	} catch (e: any) {
-		ctx.context.logger.error(`Stripe webhook failed. Error: ${e.message}`);
-	}
-}
-
-export async function onSubscriptionCreated(
-	ctx: GenericEndpointContext,
-	options: StripeOptions,
-	event: Stripe.Event,
-) {
-	try {
-		if (!options.subscription?.enabled) {
-			return;
-		}
-
-		const subscriptionCreated = event.data.object as Stripe.Subscription;
-		const stripeCustomerId = subscriptionCreated.customer?.toString();
-		if (!stripeCustomerId) {
-			ctx.context.logger.warn(
-				`Stripe webhook warning: customer.subscription.created event received without customer ID`,
-			);
-			return;
-		}
-
-		// Check if subscription already exists in database
-		const { subscriptionId } = subscriptionMetadata.get(
-			subscriptionCreated.metadata,
-		);
-		const existingSubscription =
-			await ctx.context.adapter.findOne<Subscription>({
-				model: "subscription",
-				where: subscriptionId
-					? [{ field: "id", value: subscriptionId }]
-					: [{ field: "stripeSubscriptionId", value: subscriptionCreated.id }], // Probably won't match since it's not set yet
-			});
-		if (existingSubscription) {
-			ctx.context.logger.info(
-				`Stripe webhook: Subscription already exists in database (id: ${existingSubscription.id}), skipping creation`,
-			);
-			return;
-		}
-
-		// Find reference
-		const reference = await findReferenceByStripeCustomerId(
-			ctx,
-			options,
-			stripeCustomerId,
-		);
-		if (!reference) {
-			ctx.context.logger.warn(
-				`Stripe webhook warning: No user or organization found with stripeCustomerId: ${stripeCustomerId}`,
-			);
-			return;
-		}
-		const { referenceId, customerType } = reference;
-
-		const resolved = await resolvePlanItem(
-			options,
-			subscriptionCreated.items.data,
-		);
-		if (!resolved) {
-			ctx.context.logger.warn(
-				`Stripe webhook warning: Subscription ${subscriptionCreated.id} has no items matching a configured plan`,
-			);
-			return;
-		}
-
-		const { item: subscriptionItem, plan } = resolved;
-		if (!plan) {
-			ctx.context.logger.warn(
-				`Stripe webhook warning: No matching plan found for priceId: ${subscriptionItem.price.id}`,
-			);
-			return;
-		}
-
-		const seats = resolveQuantity(
-			subscriptionCreated.items.data,
-			subscriptionItem,
-			plan.seatPriceId,
-		);
-		const periodStart = new Date(subscriptionItem.current_period_start * 1000);
-		const periodEnd = new Date(subscriptionItem.current_period_end * 1000);
-
-		const trial =
-			subscriptionCreated.trial_start && subscriptionCreated.trial_end
-				? {
-						trialStart: new Date(subscriptionCreated.trial_start * 1000),
-						trialEnd: new Date(subscriptionCreated.trial_end * 1000),
-					}
-				: {};
-
-		// Create the subscription in the database
-		const newSubscription = await ctx.context.adapter.create<Subscription>({
-			model: "subscription",
-			data: {
-				...trial,
-				...(plan.limits ? { limits: plan.limits } : {}),
-				referenceId,
-				stripeCustomerId,
-				stripeSubscriptionId: subscriptionCreated.id,
-				status: subscriptionCreated.status,
-				plan: plan.name.toLowerCase(),
-				periodStart,
-				periodEnd,
-				seats,
-				billingInterval: subscriptionItem.price.recurring?.interval,
-			},
-		});
-
-		ctx.context.logger.info(
-			`Stripe webhook: Created subscription ${subscriptionCreated.id} for ${customerType} ${referenceId} from dashboard`,
-		);
-
-		await options.subscription.onSubscriptionCreated?.({
-			event,
-			subscription: newSubscription,
-			stripeSubscription: subscriptionCreated,
-			plan,
-		});
-	} catch (error: any) {
-		ctx.context.logger.error(`Stripe webhook failed. Error: ${error}`);
-	}
-}
-
-export async function onSubscriptionUpdated(
-	ctx: GenericEndpointContext,
-	options: StripeOptions,
-	event: Stripe.Event,
-) {
-	try {
-		if (!options.subscription?.enabled) {
-			return;
-		}
-		const subscriptionUpdated = event.data.object as Stripe.Subscription;
-		const resolved = await resolvePlanItem(
-			options,
-			subscriptionUpdated.items.data,
-		);
-		if (!resolved) {
-			ctx.context.logger.warn(
-				`Stripe webhook warning: Subscription ${subscriptionUpdated.id} has no items matching a configured plan`,
-			);
-			return;
-		}
-
-		const { item: subscriptionItem, plan } = resolved;
-
-		const { subscriptionId } = subscriptionMetadata.get(
-			subscriptionUpdated.metadata,
-		);
-		const customerId = subscriptionUpdated.customer?.toString();
-		let subscription = await ctx.context.adapter.findOne<Subscription>({
-			model: "subscription",
-			where: subscriptionId
-				? [{ field: "id", value: subscriptionId }]
-				: [{ field: "stripeSubscriptionId", value: subscriptionUpdated.id }],
-		});
-		if (!subscription) {
-			const subs = await ctx.context.adapter.findMany<Subscription>({
-				model: "subscription",
-				where: [{ field: "stripeCustomerId", value: customerId }],
-			});
-			if (subs.length > 1) {
-				const activeSub = subs.find((sub: Subscription) =>
-					isActiveOrTrialing(sub),
-				);
-				if (!activeSub) {
-					ctx.context.logger.warn(
-						`Stripe webhook error: Multiple subscriptions found for customerId: ${customerId} and no active subscription is found`,
-					);
-					return;
-				}
-				subscription = activeSub;
-			} else {
-				subscription = subs[0]!;
-			}
-		}
-
-		const seats = plan
-			? resolveQuantity(
-					subscriptionUpdated.items.data,
-					subscriptionItem,
-					plan.seatPriceId,
-				)
-			: subscriptionItem.quantity;
-
-		const trial =
-			subscriptionUpdated.trial_start && subscriptionUpdated.trial_end
-				? {
-						trialStart: new Date(subscriptionUpdated.trial_start * 1000),
-						trialEnd: new Date(subscriptionUpdated.trial_end * 1000),
-					}
-				: {};
-
-		const updatedSubscription = await ctx.context.adapter.update<Subscription>({
-			model: "subscription",
-			update: {
-				...trial,
-				...(plan
-					? {
-							plan: plan.name.toLowerCase(),
-							limits: plan.limits,
-						}
-					: {}),
-				updatedAt: new Date(),
-				status: subscriptionUpdated.status,
-				periodStart: new Date(subscriptionItem.current_period_start * 1000),
-				periodEnd: new Date(subscriptionItem.current_period_end * 1000),
-				cancelAtPeriodEnd: subscriptionUpdated.cancel_at_period_end,
-				cancelAt: subscriptionUpdated.cancel_at
-					? new Date(subscriptionUpdated.cancel_at * 1000)
-					: null,
-				canceledAt: subscriptionUpdated.canceled_at
-					? new Date(subscriptionUpdated.canceled_at * 1000)
-					: null,
-				endedAt: subscriptionUpdated.ended_at
-					? new Date(subscriptionUpdated.ended_at * 1000)
-					: null,
-				seats,
-				stripeSubscriptionId: subscriptionUpdated.id,
-				billingInterval: subscriptionItem.price.recurring?.interval,
-				stripeScheduleId: subscriptionUpdated.schedule
-					? typeof subscriptionUpdated.schedule === "string"
-						? subscriptionUpdated.schedule
-						: subscriptionUpdated.schedule.id
-					: null,
-			},
-			where: [
-				{
-					field: "id",
-					value: subscription.id,
-				},
-			],
-		});
-		const isNewCancellation =
-			subscriptionUpdated.status === "active" &&
-			isStripePendingCancel(subscriptionUpdated) &&
-			!isPendingCancel(subscription);
-		if (isNewCancellation) {
-			await options.subscription.onSubscriptionCancel?.({
-				subscription,
-				cancellationDetails:
-					subscriptionUpdated.cancellation_details || undefined,
-				stripeSubscription: subscriptionUpdated,
-				event,
-			});
-		}
-		await options.subscription.onSubscriptionUpdate?.({
-			event,
-			subscription: updatedSubscription || subscription,
-		});
-		if (plan) {
-			if (
-				subscriptionUpdated.status === "active" &&
-				subscription.status === "trialing" &&
-				plan.freeTrial?.onTrialEnd
-			) {
-				await plan.freeTrial.onTrialEnd({ subscription }, ctx);
-			}
-			if (
-				subscriptionUpdated.status === "incomplete_expired" &&
-				subscription.status === "trialing" &&
-				plan.freeTrial?.onTrialExpired
-			) {
-				await plan.freeTrial.onTrialExpired(subscription, ctx);
-			}
-		}
-	} catch (error: any) {
-		ctx.context.logger.error(`Stripe webhook failed. Error: ${error}`);
-	}
-}
-
-export async function onSubscriptionDeleted(
-	ctx: GenericEndpointContext,
-	options: StripeOptions,
-	event: Stripe.Event,
-) {
-	if (!options.subscription?.enabled) {
-		return;
-	}
-	try {
-		const subscriptionDeleted = event.data.object as Stripe.Subscription;
-		const subscriptionId = subscriptionDeleted.id;
-		const subscription = await ctx.context.adapter.findOne<Subscription>({
-			model: "subscription",
-			where: [
-				{
-					field: "stripeSubscriptionId",
-					value: subscriptionId,
-				},
-			],
-		});
-		if (subscription) {
-			const trial =
-				subscriptionDeleted.trial_start && subscriptionDeleted.trial_end
-					? {
-							trialStart: new Date(subscriptionDeleted.trial_start * 1000),
-							trialEnd: new Date(subscriptionDeleted.trial_end * 1000),
-						}
-					: {};
-			await ctx.context.adapter.update({
-				model: "subscription",
-				where: [
-					{
-						field: "id",
-						value: subscription.id,
-					},
-				],
-				update: {
-					...trial,
-					status: "canceled",
-					updatedAt: new Date(),
-					cancelAtPeriodEnd: subscriptionDeleted.cancel_at_period_end,
-					cancelAt: subscriptionDeleted.cancel_at
-						? new Date(subscriptionDeleted.cancel_at * 1000)
-						: null,
-					canceledAt: subscriptionDeleted.canceled_at
-						? new Date(subscriptionDeleted.canceled_at * 1000)
-						: null,
-					endedAt: subscriptionDeleted.ended_at
-						? new Date(subscriptionDeleted.ended_at * 1000)
-						: null,
-					stripeScheduleId: null,
-				},
-			});
-			await options.subscription.onSubscriptionDeleted?.({
-				event,
-				stripeSubscription: subscriptionDeleted,
-				subscription,
-			});
-		} else {
-			ctx.context.logger.warn(
-				`Stripe webhook error: Subscription not found for subscriptionId: ${subscriptionId}`,
-			);
-		}
-	} catch (error: any) {
-		ctx.context.logger.error(`Stripe webhook failed. Error: ${error}`);
-	}
-}