@better-auth/stripe 1.2.6-beta.6 → 1.2.6

package/.turbo/turbo-build.log

@@ -1,17 +1,17 @@
 
-> @better-auth/stripe@1.2.6-beta.6 build /home/runner/work/better-auth/better-auth/packages/stripe
+> @better-auth/stripe@1.2.6 build /home/runner/work/better-auth/better-auth/packages/stripe
 > unbuild
 
 [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: 33.6 kB, chunk size: 33.6 kB, exports: stripe)
+[log]   dist/index.cjs (total size: 36.9 kB, chunk size: 36.9 kB, exports: stripe)
 
 [log]   dist/client.cjs (total size: 160 B, chunk size: 160 B, exports: stripeClient)
 
-[log]   dist/index.mjs (total size: 33.3 kB, chunk size: 33.3 kB, exports: stripe)
+[log]   dist/index.mjs (total size: 36.6 kB, chunk size: 36.6 kB, exports: stripe)
 
 [log]   dist/client.mjs (total size: 133 B, chunk size: 133 B, exports: stripeClient)
 
-Σ Total dist size (byte size): 184 kB
+Σ Total dist size (byte size): 199 kB
 [log]

package/dist/index.cjs

@@ -36,7 +36,7 @@ async function onCheckoutSessionCompleted(ctx, options, event) {
     const priceId = subscription.items.data[0]?.price.id;
     const plan = await getPlanByPriceId(options, priceId);
     if (plan) {
-      const referenceId = checkoutSession?.metadata?.referenceId;
+      const referenceId = checkoutSession?.client_reference_id || checkoutSession?.metadata?.referenceId;
       const subscriptionId = checkoutSession?.metadata?.subscriptionId;
       const seats = subscription.items.data[0].quantity;
       if (referenceId && subscriptionId) {
@@ -288,7 +288,9 @@ const STRIPE_ERROR_CODES = {
   SUBSCRIPTION_PLAN_NOT_FOUND: "Subscription plan not found",
   ALREADY_SUBSCRIBED_PLAN: "You're already subscribed to this plan",
   UNABLE_TO_CREATE_CUSTOMER: "Unable to create customer",
-  EMAIL_VERIFICATION_REQUIRED: "Email verification is required before you can subscribe to a plan"
+  EMAIL_VERIFICATION_REQUIRED: "Email verification is required before you can subscribe to a plan",
+  SUBSCRIPTION_NOT_ACTIVE: "Subscription is not active",
+  SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION: "Subscription is not scheduled for cancellation"
 };
 const getUrl = (ctx, url) => {
   if (url.startsWith("http")) {
@@ -304,6 +306,14 @@ const stripe = (options) => {
       throw new api.APIError("UNAUTHORIZED");
     }
     const referenceId = ctx.body?.referenceId || ctx.query?.referenceId || session.user.id;
+    if (ctx.body?.referenceId && !options.subscription?.authorizeReference) {
+      betterAuth.logger.error(
+        `Passing referenceId into a subscription action isn't allowed if subscription.authorizeReference isn't defined in your stripe plugin config.`
+      );
+      throw new api.APIError("BAD_REQUEST", {
+        message: "Reference id is not allowed. Read server logs for more details."
+      });
+    }
     const isAuthorized = ctx.body?.referenceId ? await options.subscription?.authorizeReference?.({
       user: session.user,
       session: session.session,
@@ -762,6 +772,88 @@ const stripe = (options) => {
         };
       }
     ),
+    restoreSubscription: plugins.createAuthEndpoint(
+      "/subscription/restore",
+      {
+        method: "POST",
+        body: zod.z.object({
+          referenceId: zod.z.string().optional(),
+          subscriptionId: zod.z.string().optional()
+        }),
+        use: [api.sessionMiddleware, referenceMiddleware("restore-subscription")]
+      },
+      async (ctx) => {
+        const referenceId = ctx.body?.referenceId || ctx.context.session.user.id;
+        const subscription = ctx.body.subscriptionId ? await ctx.context.adapter.findOne({
+          model: "subscription",
+          where: [
+            {
+              field: "id",
+              value: ctx.body.subscriptionId
+            }
+          ]
+        }) : await ctx.context.adapter.findOne({
+          model: "subscription",
+          where: [
+            {
+              field: "referenceId",
+              value: referenceId
+            }
+          ]
+        });
+        if (!subscription || !subscription.stripeCustomerId) {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_FOUND
+          });
+        }
+        if (subscription.status != "active" && subscription.status != "trialing") {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_ACTIVE
+          });
+        }
+        if (!subscription.cancelAtPeriodEnd) {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION
+          });
+        }
+        const activeSubscription = await client.subscriptions.list({
+          customer: subscription.stripeCustomerId,
+          status: "active"
+        }).then((res) => res.data[0]);
+        if (!activeSubscription) {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_FOUND
+          });
+        }
+        try {
+          const newSub = await client.subscriptions.update(
+            activeSubscription.id,
+            {
+              cancel_at_period_end: false
+            }
+          );
+          await ctx.context.adapter.update({
+            model: "subscription",
+            update: {
+              cancelAtPeriodEnd: false,
+              updatedAt: /* @__PURE__ */ new Date()
+            },
+            where: [
+              {
+                field: "id",
+                value: subscription.id
+              }
+            ]
+          });
+          return ctx.json(newSub);
+        } catch (error) {
+          ctx.context.logger.error("Error restoring subscription", error);
+          throw new api.APIError("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.UNABLE_TO_CREATE_CUSTOMER
+          });
+        }
+      }
+    ),
     listActiveSubscriptions: plugins.createAuthEndpoint(
       "/subscription/list",
       {

package/dist/index.d.cts

@@ -297,7 +297,7 @@ interface StripeOptions {
             user: User & Record<string, any>;
             session: Session & Record<string, any>;
             referenceId: string;
-            action: "upgrade-subscription" | "list-subscription" | "cancel-subscription";
+            action: "upgrade-subscription" | "list-subscription" | "cancel-subscription" | "restore-subscription";
         }, request?: Request) => Promise<boolean>;
         /**
          * A callback to run after a user has deleted their subscription
@@ -786,6 +786,74 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
             };
             path: "/subscription/cancel";
         };
+        readonly restoreSubscription: {
+            <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0: {
+                body: {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                };
+            } & {
+                method?: "POST" | undefined;
+            } & {
+                query?: Record<string, any> | undefined;
+            } & {
+                params?: Record<string, any>;
+            } & {
+                request?: Request;
+            } & {
+                headers?: HeadersInit;
+            } & {
+                asResponse?: boolean;
+                returnHeaders?: boolean;
+                use?: better_call.Middleware[];
+                path?: string;
+            } & {
+                asResponse?: AsResponse | undefined;
+                returnHeaders?: ReturnHeaders | undefined;
+            }): Promise<[AsResponse] extends [true] ? Response : [ReturnHeaders] extends [true] ? {
+                headers: Headers;
+                response: Stripe.Response<Stripe.Subscription>;
+            } : Stripe.Response<Stripe.Subscription>>;
+            options: {
+                method: "POST";
+                body: z.ZodObject<{
+                    referenceId: z.ZodOptional<z.ZodString>;
+                    subscriptionId: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                }, {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                }>;
+                use: (((inputContext: better_call.MiddlewareInputContext<better_call.MiddlewareOptions>) => Promise<{
+                    session: {
+                        session: Record<string, any> & {
+                            id: string;
+                            createdAt: Date;
+                            updatedAt: Date;
+                            userId: string;
+                            expiresAt: Date;
+                            token: string;
+                            ipAddress?: string | null | undefined;
+                            userAgent?: string | null | undefined;
+                        };
+                        user: Record<string, any> & {
+                            id: string;
+                            name: string;
+                            email: string;
+                            emailVerified: boolean;
+                            createdAt: Date;
+                            updatedAt: Date;
+                            image?: string | null | undefined;
+                        };
+                    };
+                }>) | ((inputContext: better_call.MiddlewareInputContext<better_call.MiddlewareOptions>) => Promise<void>))[];
+            } & {
+                use: any[];
+            };
+            path: "/subscription/restore";
+        };
         readonly listActiveSubscriptions: {
             <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0?: ({
                 body?: undefined;

package/dist/index.d.mts

@@ -297,7 +297,7 @@ interface StripeOptions {
             user: User & Record<string, any>;
             session: Session & Record<string, any>;
             referenceId: string;
-            action: "upgrade-subscription" | "list-subscription" | "cancel-subscription";
+            action: "upgrade-subscription" | "list-subscription" | "cancel-subscription" | "restore-subscription";
         }, request?: Request) => Promise<boolean>;
         /**
          * A callback to run after a user has deleted their subscription
@@ -786,6 +786,74 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
             };
             path: "/subscription/cancel";
         };
+        readonly restoreSubscription: {
+            <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0: {
+                body: {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                };
+            } & {
+                method?: "POST" | undefined;
+            } & {
+                query?: Record<string, any> | undefined;
+            } & {
+                params?: Record<string, any>;
+            } & {
+                request?: Request;
+            } & {
+                headers?: HeadersInit;
+            } & {
+                asResponse?: boolean;
+                returnHeaders?: boolean;
+                use?: better_call.Middleware[];
+                path?: string;
+            } & {
+                asResponse?: AsResponse | undefined;
+                returnHeaders?: ReturnHeaders | undefined;
+            }): Promise<[AsResponse] extends [true] ? Response : [ReturnHeaders] extends [true] ? {
+                headers: Headers;
+                response: Stripe.Response<Stripe.Subscription>;
+            } : Stripe.Response<Stripe.Subscription>>;
+            options: {
+                method: "POST";
+                body: z.ZodObject<{
+                    referenceId: z.ZodOptional<z.ZodString>;
+                    subscriptionId: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                }, {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                }>;
+                use: (((inputContext: better_call.MiddlewareInputContext<better_call.MiddlewareOptions>) => Promise<{
+                    session: {
+                        session: Record<string, any> & {
+                            id: string;
+                            createdAt: Date;
+                            updatedAt: Date;
+                            userId: string;
+                            expiresAt: Date;
+                            token: string;
+                            ipAddress?: string | null | undefined;
+                            userAgent?: string | null | undefined;
+                        };
+                        user: Record<string, any> & {
+                            id: string;
+                            name: string;
+                            email: string;
+                            emailVerified: boolean;
+                            createdAt: Date;
+                            updatedAt: Date;
+                            image?: string | null | undefined;
+                        };
+                    };
+                }>) | ((inputContext: better_call.MiddlewareInputContext<better_call.MiddlewareOptions>) => Promise<void>))[];
+            } & {
+                use: any[];
+            };
+            path: "/subscription/restore";
+        };
         readonly listActiveSubscriptions: {
             <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0?: ({
                 body?: undefined;

package/dist/index.d.ts

@@ -297,7 +297,7 @@ interface StripeOptions {
             user: User & Record<string, any>;
             session: Session & Record<string, any>;
             referenceId: string;
-            action: "upgrade-subscription" | "list-subscription" | "cancel-subscription";
+            action: "upgrade-subscription" | "list-subscription" | "cancel-subscription" | "restore-subscription";
         }, request?: Request) => Promise<boolean>;
         /**
          * A callback to run after a user has deleted their subscription
@@ -786,6 +786,74 @@ declare const stripe: <O extends StripeOptions>(options: O) => {
             };
             path: "/subscription/cancel";
         };
+        readonly restoreSubscription: {
+            <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0: {
+                body: {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                };
+            } & {
+                method?: "POST" | undefined;
+            } & {
+                query?: Record<string, any> | undefined;
+            } & {
+                params?: Record<string, any>;
+            } & {
+                request?: Request;
+            } & {
+                headers?: HeadersInit;
+            } & {
+                asResponse?: boolean;
+                returnHeaders?: boolean;
+                use?: better_call.Middleware[];
+                path?: string;
+            } & {
+                asResponse?: AsResponse | undefined;
+                returnHeaders?: ReturnHeaders | undefined;
+            }): Promise<[AsResponse] extends [true] ? Response : [ReturnHeaders] extends [true] ? {
+                headers: Headers;
+                response: Stripe.Response<Stripe.Subscription>;
+            } : Stripe.Response<Stripe.Subscription>>;
+            options: {
+                method: "POST";
+                body: z.ZodObject<{
+                    referenceId: z.ZodOptional<z.ZodString>;
+                    subscriptionId: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                }, {
+                    referenceId?: string | undefined;
+                    subscriptionId?: string | undefined;
+                }>;
+                use: (((inputContext: better_call.MiddlewareInputContext<better_call.MiddlewareOptions>) => Promise<{
+                    session: {
+                        session: Record<string, any> & {
+                            id: string;
+                            createdAt: Date;
+                            updatedAt: Date;
+                            userId: string;
+                            expiresAt: Date;
+                            token: string;
+                            ipAddress?: string | null | undefined;
+                            userAgent?: string | null | undefined;
+                        };
+                        user: Record<string, any> & {
+                            id: string;
+                            name: string;
+                            email: string;
+                            emailVerified: boolean;
+                            createdAt: Date;
+                            updatedAt: Date;
+                            image?: string | null | undefined;
+                        };
+                    };
+                }>) | ((inputContext: better_call.MiddlewareInputContext<better_call.MiddlewareOptions>) => Promise<void>))[];
+            } & {
+                use: any[];
+            };
+            path: "/subscription/restore";
+        };
         readonly listActiveSubscriptions: {
             <AsResponse extends boolean = false, ReturnHeaders extends boolean = false>(inputCtx_0?: ({
                 body?: undefined;

package/dist/index.mjs

@@ -34,7 +34,7 @@ async function onCheckoutSessionCompleted(ctx, options, event) {
     const priceId = subscription.items.data[0]?.price.id;
     const plan = await getPlanByPriceId(options, priceId);
     if (plan) {
-      const referenceId = checkoutSession?.metadata?.referenceId;
+      const referenceId = checkoutSession?.client_reference_id || checkoutSession?.metadata?.referenceId;
       const subscriptionId = checkoutSession?.metadata?.subscriptionId;
       const seats = subscription.items.data[0].quantity;
       if (referenceId && subscriptionId) {
@@ -286,7 +286,9 @@ const STRIPE_ERROR_CODES = {
   SUBSCRIPTION_PLAN_NOT_FOUND: "Subscription plan not found",
   ALREADY_SUBSCRIBED_PLAN: "You're already subscribed to this plan",
   UNABLE_TO_CREATE_CUSTOMER: "Unable to create customer",
-  EMAIL_VERIFICATION_REQUIRED: "Email verification is required before you can subscribe to a plan"
+  EMAIL_VERIFICATION_REQUIRED: "Email verification is required before you can subscribe to a plan",
+  SUBSCRIPTION_NOT_ACTIVE: "Subscription is not active",
+  SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION: "Subscription is not scheduled for cancellation"
 };
 const getUrl = (ctx, url) => {
   if (url.startsWith("http")) {
@@ -302,6 +304,14 @@ const stripe = (options) => {
       throw new APIError("UNAUTHORIZED");
     }
     const referenceId = ctx.body?.referenceId || ctx.query?.referenceId || session.user.id;
+    if (ctx.body?.referenceId && !options.subscription?.authorizeReference) {
+      logger.error(
+        `Passing referenceId into a subscription action isn't allowed if subscription.authorizeReference isn't defined in your stripe plugin config.`
+      );
+      throw new APIError("BAD_REQUEST", {
+        message: "Reference id is not allowed. Read server logs for more details."
+      });
+    }
     const isAuthorized = ctx.body?.referenceId ? await options.subscription?.authorizeReference?.({
       user: session.user,
       session: session.session,
@@ -760,6 +770,88 @@ const stripe = (options) => {
         };
       }
     ),
+    restoreSubscription: createAuthEndpoint(
+      "/subscription/restore",
+      {
+        method: "POST",
+        body: z.object({
+          referenceId: z.string().optional(),
+          subscriptionId: z.string().optional()
+        }),
+        use: [sessionMiddleware, referenceMiddleware("restore-subscription")]
+      },
+      async (ctx) => {
+        const referenceId = ctx.body?.referenceId || ctx.context.session.user.id;
+        const subscription = ctx.body.subscriptionId ? await ctx.context.adapter.findOne({
+          model: "subscription",
+          where: [
+            {
+              field: "id",
+              value: ctx.body.subscriptionId
+            }
+          ]
+        }) : await ctx.context.adapter.findOne({
+          model: "subscription",
+          where: [
+            {
+              field: "referenceId",
+              value: referenceId
+            }
+          ]
+        });
+        if (!subscription || !subscription.stripeCustomerId) {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_FOUND
+          });
+        }
+        if (subscription.status != "active" && subscription.status != "trialing") {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_ACTIVE
+          });
+        }
+        if (!subscription.cancelAtPeriodEnd) {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION
+          });
+        }
+        const activeSubscription = await client.subscriptions.list({
+          customer: subscription.stripeCustomerId,
+          status: "active"
+        }).then((res) => res.data[0]);
+        if (!activeSubscription) {
+          throw ctx.error("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_FOUND
+          });
+        }
+        try {
+          const newSub = await client.subscriptions.update(
+            activeSubscription.id,
+            {
+              cancel_at_period_end: false
+            }
+          );
+          await ctx.context.adapter.update({
+            model: "subscription",
+            update: {
+              cancelAtPeriodEnd: false,
+              updatedAt: /* @__PURE__ */ new Date()
+            },
+            where: [
+              {
+                field: "id",
+                value: subscription.id
+              }
+            ]
+          });
+          return ctx.json(newSub);
+        } catch (error) {
+          ctx.context.logger.error("Error restoring subscription", error);
+          throw new APIError("BAD_REQUEST", {
+            message: STRIPE_ERROR_CODES.UNABLE_TO_CREATE_CUSTOMER
+          });
+        }
+      }
+    ),
     listActiveSubscriptions: createAuthEndpoint(
       "/subscription/list",
       {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@better-auth/stripe",
   "author": "Bereket Engida",
-  "version": "1.2.6-beta.6",
+  "version": "1.2.6",
   "main": "dist/index.cjs",
   "license": "MIT",
   "keywords": [
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "zod": "^3.24.1",
-    "better-auth": "^1.2.6-beta.6"
+    "better-auth": "^1.2.6"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",

package/src/hooks.ts

@@ -20,7 +20,9 @@ export async function onCheckoutSessionCompleted(
 		const priceId = subscription.items.data[0]?.price.id;
 		const plan = await getPlanByPriceId(options, priceId as string);
 		if (plan) {
-			const referenceId = checkoutSession?.metadata?.referenceId;
+			const referenceId =
+				checkoutSession?.client_reference_id ||
+				checkoutSession?.metadata?.referenceId;
 			const subscriptionId = checkoutSession?.metadata?.subscriptionId;
 			const seats = subscription.items.data[0].quantity;
 			if (referenceId && subscriptionId) {

package/src/index.ts

@@ -35,6 +35,9 @@ const STRIPE_ERROR_CODES = {
 	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",
+	SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION:
+		"Subscription is not scheduled for cancellation",
 } as const;
 
 const getUrl = (ctx: GenericEndpointContext, url: string) => {
@@ -53,7 +56,8 @@ export const stripe = <O extends StripeOptions>(options: O) => {
 		action:
 			| "upgrade-subscription"
 			| "list-subscription"
-			| "cancel-subscription",
+			| "cancel-subscription"
+			| "restore-subscription",
 	) =>
 		createAuthMiddleware(async (ctx) => {
 			const session = ctx.context.session;
@@ -62,6 +66,16 @@ export const stripe = <O extends StripeOptions>(options: O) => {
 			}
 			const referenceId =
 				ctx.body?.referenceId || ctx.query?.referenceId || session.user.id;
+
+			if (ctx.body?.referenceId && !options.subscription?.authorizeReference) {
+				logger.error(
+					`Passing referenceId into a subscription action isn't allowed if subscription.authorizeReference isn't defined in your stripe plugin config.`,
+				);
+				throw new APIError("BAD_REQUEST", {
+					message:
+						"Reference id is not allowed. Read server logs for more details.",
+				});
+			}
 			const isAuthorized = ctx.body?.referenceId
 				? await options.subscription?.authorizeReference?.({
 						user: session.user,
@@ -611,6 +625,102 @@ export const stripe = <O extends StripeOptions>(options: O) => {
 				};
 			},
 		),
+		restoreSubscription: createAuthEndpoint(
+			"/subscription/restore",
+			{
+				method: "POST",
+				body: z.object({
+					referenceId: z.string().optional(),
+					subscriptionId: z.string().optional(),
+				}),
+				use: [sessionMiddleware, referenceMiddleware("restore-subscription")],
+			},
+			async (ctx) => {
+				const referenceId =
+					ctx.body?.referenceId || ctx.context.session.user.id;
+
+				const subscription = ctx.body.subscriptionId
+					? await ctx.context.adapter.findOne<Subscription>({
+							model: "subscription",
+							where: [
+								{
+									field: "id",
+									value: ctx.body.subscriptionId,
+								},
+							],
+						})
+					: await ctx.context.adapter.findOne<Subscription>({
+							model: "subscription",
+							where: [
+								{
+									field: "referenceId",
+									value: referenceId,
+								},
+							],
+						});
+				if (!subscription || !subscription.stripeCustomerId) {
+					throw ctx.error("BAD_REQUEST", {
+						message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+					});
+				}
+				if (
+					subscription.status != "active" &&
+					subscription.status != "trialing"
+				) {
+					throw ctx.error("BAD_REQUEST", {
+						message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_ACTIVE,
+					});
+				}
+				if (!subscription.cancelAtPeriodEnd) {
+					throw ctx.error("BAD_REQUEST", {
+						message:
+							STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION,
+					});
+				}
+
+				const activeSubscription = await client.subscriptions
+					.list({
+						customer: subscription.stripeCustomerId,
+						status: "active",
+					})
+					.then((res) => res.data[0]);
+				if (!activeSubscription) {
+					throw ctx.error("BAD_REQUEST", {
+						message: STRIPE_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+					});
+				}
+
+				try {
+					const newSub = await client.subscriptions.update(
+						activeSubscription.id,
+						{
+							cancel_at_period_end: false,
+						},
+					);
+
+					await ctx.context.adapter.update({
+						model: "subscription",
+						update: {
+							cancelAtPeriodEnd: false,
+							updatedAt: new Date(),
+						},
+						where: [
+							{
+								field: "id",
+								value: subscription.id,
+							},
+						],
+					});
+
+					return ctx.json(newSub);
+				} catch (error) {
+					ctx.context.logger.error("Error restoring subscription", error);
+					throw new APIError("BAD_REQUEST", {
+						message: STRIPE_ERROR_CODES.UNABLE_TO_CREATE_CUSTOMER,
+					});
+				}
+			},
+		),
 		listActiveSubscriptions: createAuthEndpoint(
 			"/subscription/list",
 			{

package/src/stripe.test.ts

@@ -32,6 +32,7 @@ describe("stripe", async () => {
 		subscriptions: {
 			retrieve: vi.fn(),
 			list: vi.fn().mockResolvedValue({ data: [] }),
+			update: vi.fn(),
 		},
 		webhooks: {
 			constructEvent: vi.fn(),
@@ -243,19 +244,15 @@ describe("stripe", async () => {
 	});
 
 	it("should handle subscription webhook events", async () => {
-		const testSubscriptionId = "sub_123456";
-		const testReferenceId = "user_123";
-		await ctx.adapter.create({
+		const { id: testReferenceId } = await ctx.adapter.create({
 			model: "user",
 			data: {
-				id: testReferenceId,
 				email: "test@email.com",
 			},
 		});
-		await ctx.adapter.create({
+		const { id: testSubscriptionId } = await ctx.adapter.create({
 			model: "subscription",
 			data: {
-				id: testSubscriptionId,
 				referenceId: testReferenceId,
 				stripeCustomerId: "cus_mock123",
 				status: "active",
@@ -353,22 +350,19 @@ describe("stripe", async () => {
 		});
 	});
 
+	const { id: userId } = await ctx.adapter.create({
+		model: "user",
+		data: {
+			email: "delete-test@email.com",
+		},
+	});
+
 	it("should handle subscription deletion webhook", async () => {
-		const userId = "test_user";
 		const subId = "test_sub_delete";
 
-		await ctx.adapter.create({
-			model: "user",
-			data: {
-				id: userId,
-				email: "delete-test@email.com",
-			},
-		});
-
 		await ctx.adapter.create({
 			model: "subscription",
 			data: {
-				id: subId,
 				referenceId: userId,
 				stripeCustomerId: "cus_delete_test",
 				status: "active",
@@ -501,7 +495,6 @@ describe("stripe", async () => {
 		};
 
 		const mockSubscription = {
-			id: "sub_123",
 			status: "active",
 			items: {
 				data: [{ price: { id: process.env.STRIPE_PRICE_ID_1 } }],
@@ -532,11 +525,10 @@ describe("stripe", async () => {
 			plugins: [stripe(eventTestOptions)],
 		});
 
-		await ctx.adapter.create({
+		const { id: testSubscriptionId } = await ctx.adapter.create({
 			model: "subscription",
 			data: {
-				id: "sub_123",
-				referenceId: "user_123",
+				referenceId: userId,
 				stripeCustomerId: "cus_123",
 				stripeSubscriptionId: "sub_123",
 				status: "incomplete",
@@ -570,7 +562,7 @@ describe("stripe", async () => {
 			type: "customer.subscription.updated",
 			data: {
 				object: {
-					id: "sub_123",
+					id: testSubscriptionId,
 					customer: "cus_123",
 					status: "active",
 					items: {
@@ -608,7 +600,7 @@ describe("stripe", async () => {
 			type: "customer.subscription.updated",
 			data: {
 				object: {
-					id: "sub_123",
+					id: testSubscriptionId,
 					customer: "cus_123",
 					status: "active",
 					cancel_at_period_end: true,
@@ -644,7 +636,7 @@ describe("stripe", async () => {
 			type: "customer.subscription.updated",
 			data: {
 				object: {
-					id: "sub_123",
+					id: testSubscriptionId,
 					customer: "cus_123",
 					status: "active",
 					cancel_at_period_end: true,
@@ -679,12 +671,12 @@ describe("stripe", async () => {
 			type: "customer.subscription.deleted",
 			data: {
 				object: {
-					id: "sub_123",
+					id: testSubscriptionId,
 					customer: "cus_123",
 					status: "canceled",
 					metadata: {
-						referenceId: "user_123",
-						subscriptionId: "sub_123",
+						referenceId: userId,
+						subscriptionId: testSubscriptionId,
 					},
 				},
 			},

package/src/types.ts

@@ -269,7 +269,8 @@ export interface StripeOptions {
 				action:
 					| "upgrade-subscription"
 					| "list-subscription"
-					| "cancel-subscription";
+					| "cancel-subscription"
+					| "restore-subscription";
 			},
 			request?: Request,
 		) => Promise<boolean>;