@better-auth/stripe 1.3.8-beta.5 → 1.3.8-beta.8

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @better-auth/stripe@1.3.8-beta.5 build /home/runner/work/better-auth/better-auth/packages/stripe
+> @better-auth/stripe@1.3.8-beta.8 build /home/runner/work/better-auth/better-auth/packages/stripe
 > unbuild
 
 Browserslist: caniuse-lite is outdated. Please run:
@@ -8,13 +8,13 @@ Browserslist: caniuse-lite is outdated. Please run:
 [info] Automatically detected entries: src/index, src/client [esm] [cjs] [dts]
 [info] Building stripe
 [success] Build succeeded for stripe
-[log]   dist/index.cjs (total size: 43.5 kB, chunk size: 43.5 kB, exports: stripe)
+[log]   dist/index.cjs (total size: 43.9 kB, chunk size: 43.9 kB, exports: stripe)
 
 [log]   dist/client.cjs (total size: 224 B, chunk size: 224 B, exports: stripeClient)
 
-[log]   dist/index.mjs (total size: 42.7 kB, chunk size: 42.7 kB, exports: stripe)
+[log]   dist/index.mjs (total size: 43 kB, chunk size: 43 kB, exports: stripe)
 
 [log]   dist/client.mjs (total size: 197 B, chunk size: 197 B, exports: stripeClient)
 
-Σ Total dist size (byte size): 222 kB
+Σ Total dist size (byte size): 224 kB
 [log]

package/dist/index.cjs

@@ -272,6 +272,14 @@ const subscriptions = {
         type: "date",
         required: false
       },
+      trialStart: {
+        type: "date",
+        required: false
+      },
+      trialEnd: {
+        type: "date",
+        required: false
+      },
       cancelAtPeriodEnd: {
         type: "boolean",
         required: false,
@@ -1135,6 +1143,9 @@ const stripe = (options) => {
       {
         method: "POST",
         body: z__namespace.object({
+          locale: z__namespace.custom((localization) => {
+            return typeof localization === "string";
+          }).optional(),
           referenceId: z__namespace.string().optional(),
           returnUrl: z__namespace.string().default("/")
         }),
@@ -1171,6 +1182,7 @@ const stripe = (options) => {
         }
         try {
           const { url } = await client.billingPortal.sessions.create({
+            locale: ctx.body.locale,
             customer: customerId,
             return_url: getUrl(ctx, ctx.body.returnUrl)
           });

package/dist/index.d.cts

@@ -35,6 +35,14 @@ declare const subscriptions: {
                 type: "date";
                 required: false;
             };
+            trialStart: {
+                type: "date";
+                required: false;
+            };
+            trialEnd: {
+                type: "date";
+                required: false;
+            };
             cancelAtPeriodEnd: {
                 type: "boolean";
                 required: false;
@@ -988,6 +996,7 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
         readonly createBillingPortal: {
             <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0: {
                 body: {
+                    locale?: Stripe.Checkout.Session.Locale | undefined;
                     referenceId?: string | undefined;
                     returnUrl?: string | undefined;
                 };
@@ -1022,6 +1031,7 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
             options: {
                 method: "POST";
                 body: z.ZodObject<{
+                    locale: z.ZodOptional<z.ZodCustom<Stripe.Checkout.Session.Locale, Stripe.Checkout.Session.Locale>>;
                     referenceId: z.ZodOptional<z.ZodString>;
                     returnUrl: z.ZodDefault<z.ZodString>;
                 }, z.core.$strip>;

package/dist/index.d.mts

@@ -35,6 +35,14 @@ declare const subscriptions: {
                 type: "date";
                 required: false;
             };
+            trialStart: {
+                type: "date";
+                required: false;
+            };
+            trialEnd: {
+                type: "date";
+                required: false;
+            };
             cancelAtPeriodEnd: {
                 type: "boolean";
                 required: false;
@@ -988,6 +996,7 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
         readonly createBillingPortal: {
             <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0: {
                 body: {
+                    locale?: Stripe.Checkout.Session.Locale | undefined;
                     referenceId?: string | undefined;
                     returnUrl?: string | undefined;
                 };
@@ -1022,6 +1031,7 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
             options: {
                 method: "POST";
                 body: z.ZodObject<{
+                    locale: z.ZodOptional<z.ZodCustom<Stripe.Checkout.Session.Locale, Stripe.Checkout.Session.Locale>>;
                     referenceId: z.ZodOptional<z.ZodString>;
                     returnUrl: z.ZodDefault<z.ZodString>;
                 }, z.core.$strip>;

package/dist/index.d.ts

@@ -35,6 +35,14 @@ declare const subscriptions: {
                 type: "date";
                 required: false;
             };
+            trialStart: {
+                type: "date";
+                required: false;
+            };
+            trialEnd: {
+                type: "date";
+                required: false;
+            };
             cancelAtPeriodEnd: {
                 type: "boolean";
                 required: false;
@@ -988,6 +996,7 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
         readonly createBillingPortal: {
             <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0: {
                 body: {
+                    locale?: Stripe.Checkout.Session.Locale | undefined;
                     referenceId?: string | undefined;
                     returnUrl?: string | undefined;
                 };
@@ -1022,6 +1031,7 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
             options: {
                 method: "POST";
                 body: z.ZodObject<{
+                    locale: z.ZodOptional<z.ZodCustom<Stripe.Checkout.Session.Locale, Stripe.Checkout.Session.Locale>>;
                     referenceId: z.ZodOptional<z.ZodString>;
                     returnUrl: z.ZodDefault<z.ZodString>;
                 }, z.core.$strip>;

package/dist/index.mjs

@@ -256,6 +256,14 @@ const subscriptions = {
         type: "date",
         required: false
       },
+      trialStart: {
+        type: "date",
+        required: false
+      },
+      trialEnd: {
+        type: "date",
+        required: false
+      },
       cancelAtPeriodEnd: {
         type: "boolean",
         required: false,
@@ -1119,6 +1127,9 @@ const stripe = (options) => {
       {
         method: "POST",
         body: z.object({
+          locale: z.custom((localization) => {
+            return typeof localization === "string";
+          }).optional(),
           referenceId: z.string().optional(),
           returnUrl: z.string().default("/")
         }),
@@ -1155,6 +1166,7 @@ const stripe = (options) => {
         }
         try {
           const { url } = await client.billingPortal.sessions.create({
+            locale: ctx.body.locale,
             customer: customerId,
             return_url: getUrl(ctx, ctx.body.returnUrl)
           });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@better-auth/stripe",
   "author": "Bereket Engida",
-  "version": "1.3.8-beta.5",
+  "version": "1.3.8-beta.8",
   "main": "dist/index.cjs",
   "license": "MIT",
   "keywords": [
@@ -37,17 +37,16 @@
     }
   },
   "dependencies": {
-    "zod": "^4.0.0",
-    "better-auth": "^1.3.8-beta.5"
+    "zod": "^4.0.0"
   },
   "peerDependencies": {
-    "stripe": "^18"
+    "stripe": "^18",
+    "better-auth": "1.3.8-beta.8"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.12",
     "better-call": "1.0.15",
-    "better-sqlite3": "^11.6.0",
-    "stripe": "^18.0.0"
+    "stripe": "^18.0.0",
+    "better-auth": "1.3.8-beta.8"
   },
   "scripts": {
     "test": "vitest",

package/src/index.ts

@@ -5,6 +5,7 @@ import {
 } from "better-auth";
 import { createAuthEndpoint, createAuthMiddleware } from "better-auth/plugins";
 import Stripe from "stripe";
+import { type Stripe as StripeType } from "stripe";
 import * as z from "zod/v4";
 import {
 	sessionMiddleware,
@@ -1039,6 +1040,11 @@ export const stripe = <O extends StripeOptions>(options: O) => {
 			{
 				method: "POST",
 				body: z.object({
+					locale: z
+						.custom<StripeType.Checkout.Session.Locale>((localization) => {
+							return typeof localization === "string";
+						})
+						.optional(),
 					referenceId: z.string().optional(),
 					returnUrl: z.string().default("/"),
 				}),
@@ -1082,6 +1088,7 @@ export const stripe = <O extends StripeOptions>(options: O) => {
 
 				try {
 					const { url } = await client.billingPortal.sessions.create({
+						locale: ctx.body.locale,
 						customer: customerId,
 						return_url: getUrl(ctx, ctx.body.returnUrl),
 					});

package/src/schema.ts

@@ -33,6 +33,14 @@ export const subscriptions = {
 				type: "date",
 				required: false,
 			},
+			trialStart: {
+				type: "date",
+				required: false,
+			},
+			trialEnd: {
+				type: "date",
+				required: false,
+			},
 			cancelAtPeriodEnd: {
 				type: "boolean",
 				required: false,

package/src/stripe.test.ts

@@ -181,6 +181,8 @@ describe("stripe", async () => {
 			status: "incomplete",
 			periodStart: undefined,
 			cancelAtPeriodEnd: undefined,
+			trialStart: undefined,
+			trialEnd: undefined,
 		});
 	});
 
@@ -356,6 +358,117 @@ describe("stripe", async () => {
 		});
 	});
 
+	it("should handle subscription webhook events with trial", async () => {
+		const { id: testReferenceId } = await ctx.adapter.create({
+			model: "user",
+			data: {
+				email: "test@email.com",
+			},
+		});
+		const { id: testSubscriptionId } = await ctx.adapter.create({
+			model: "subscription",
+			data: {
+				referenceId: testReferenceId,
+				stripeCustomerId: "cus_mock123",
+				status: "incomplete",
+				plan: "starter",
+			},
+		});
+		const mockCheckoutSessionEvent = {
+			type: "checkout.session.completed",
+			data: {
+				object: {
+					mode: "subscription",
+					subscription: testSubscriptionId,
+					metadata: {
+						referenceId: testReferenceId,
+						subscriptionId: testSubscriptionId,
+					},
+				},
+			},
+		};
+
+		const mockSubscription = {
+			id: testSubscriptionId,
+			status: "active",
+			items: {
+				data: [
+					{
+						price: { id: process.env.STRIPE_PRICE_ID_1 },
+						quantity: 1,
+					},
+				],
+			},
+			current_period_start: Math.floor(Date.now() / 1000),
+			current_period_end: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60,
+			trial_start: Math.floor(Date.now() / 1000),
+			trial_end: Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60,
+		};
+
+		const stripeForTest = {
+			...stripeOptions.stripeClient,
+			subscriptions: {
+				...stripeOptions.stripeClient.subscriptions,
+				retrieve: vi.fn().mockResolvedValue(mockSubscription),
+			},
+			webhooks: {
+				constructEventAsync: vi
+					.fn()
+					.mockResolvedValue(mockCheckoutSessionEvent),
+			},
+		};
+
+		const testOptions = {
+			...stripeOptions,
+			stripeClient: stripeForTest as unknown as Stripe,
+			stripeWebhookSecret: "test_secret",
+		};
+
+		const testAuth = betterAuth({
+			baseURL: "http://localhost:3000",
+			database: memory,
+			emailAndPassword: {
+				enabled: true,
+			},
+			plugins: [stripe(testOptions)],
+		});
+
+		const testCtx = await testAuth.$context;
+
+		const mockRequest = new Request(
+			"http://localhost:3000/api/auth/stripe/webhook",
+			{
+				method: "POST",
+				headers: {
+					"stripe-signature": "test_signature",
+				},
+				body: JSON.stringify(mockCheckoutSessionEvent),
+			},
+		);
+		const response = await testAuth.handler(mockRequest);
+		expect(response.status).toBe(200);
+
+		const updatedSubscription = await testCtx.adapter.findOne<Subscription>({
+			model: "subscription",
+			where: [
+				{
+					field: "id",
+					value: testSubscriptionId,
+				},
+			],
+		});
+
+		expect(updatedSubscription).toMatchObject({
+			id: testSubscriptionId,
+			status: "active",
+			periodStart: expect.any(Date),
+			periodEnd: expect.any(Date),
+			plan: "starter",
+			trialStart: expect.any(Date),
+			trialEnd: expect.any(Date),
+		});
+	});
+
 	const { id: userId } = await ctx.adapter.create({
 		model: "user",
 		data: {