@deiondz/better-auth-razorpay 2.0.12 → 2.0.13

package/README.md

@@ -219,6 +219,7 @@ interface RazorpayPluginOptions {
   razorpayKeySecret?: string     // Optional: Razorpay API key secret; required when razorpayClient is not provided; when set, enables POST /razorpay/verify-payment
   razorpayWebhookSecret?: string // Optional: Webhook secret for signature verification
   createCustomerOnSignUp?: boolean // Optional: Create Razorpay customer on user sign-up (default: false)
+  trialOnSignUp?: { days: number; planName?: string } // Optional: When set with createCustomerOnSignUp, creates an app-level trial subscription at sign-up. Omit for no sign-up trial.
   onCustomerCreate?: (args) => Promise<void>
   getCustomerCreateParams?: (args) => Promise<{ params?: Record<string, unknown> }>
   subscription?: SubscriptionOptions // Optional: { enabled, plans, callbacks, authorizeReference, ... }
@@ -227,6 +228,17 @@ interface RazorpayPluginOptions {
 }
 ```
 
+### Optional: Trial on sign-up
+
+When you want new users to get a **free trial** without adding a payment method first (e.g. 14 days, then they must subscribe):
+
+- Set **both** `createCustomerOnSignUp: true` and `trialOnSignUp: { days: 14, planName: 'Trial' }` (or any `days` and display `planName`).
+- On sign-up, the plugin creates a Razorpay customer and **one local subscription** with `status: 'trialing'`, `trialStart` / `trialEnd`, and no `razorpaySubscriptionId` (no Razorpay subscription until they subscribe).
+- **Subscription list** returns this record; your app can show "Free trial — ends &lt;trialEnd&gt;" and gate features when `trialEnd < now`.
+- The user can **subscribe anytime** via create-or-update (choose a plan, get checkout URL); the same record is updated to a paid subscription (plan, `razorpaySubscriptionId`, status from Razorpay).
+
+**Configurable:** Omit `trialOnSignUp` for products that do not want sign-up trials (e.g. checkout-first or plan-based trial only). If `trialOnSignUp` is not set, behavior is unchanged.
+
 ### Callback functions
 
 The plugin supports the same callback hooks as the [community plugin](https://github.com/iamjasonkendrick/better-auth-razorpay). You can use them for emails, analytics, external systems, or custom logic.
@@ -254,6 +266,7 @@ razorpayPlugin({
   razorpayWebhookSecret: process.env.RAZORPAY_WEBHOOK_SECRET,
   razorpayKeySecret: process.env.RAZORPAY_KEY_SECRET, // optional: enables verify-payment endpoint
   createCustomerOnSignUp: true,
+  trialOnSignUp: { days: 14, planName: 'Trial' }, // optional: app-level trial at sign-up
   onCustomerCreate: async ({ user, razorpayCustomer }) => {
     console.log(`Razorpay customer created for user ${user.id}: ${razorpayCustomer.id}`)
   },

package/dist/client/hooks.d.ts

@@ -1,10 +1,10 @@
-import { S as SubscriptionRecord } from '../types-VZW_XCzQ.js';
+import { S as SubscriptionRecord } from '../types-BC0odu_S.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { c as RazorpayAuthClient, d as CancelSubscriptionResponse, a as CancelSubscriptionInput, e as CreateOrUpdateSubscriptionResponse, C as CreateOrUpdateSubscriptionInput, P as PlanSummary, f as RestoreSubscriptionResponse, b as RestoreSubscriptionInput, g as ListSubscriptionsResponse, h as VerifyPaymentResponse, V as VerifyPaymentInput, L as ListSubscriptionsInput } from '../types-BGWv0IJy.js';
-export { G as GetPlansResponse, i as RazorpayApiError, R as RazorpayApiResult, j as RazorpayClientActions } from '../types-BGWv0IJy.js';
+import { c as RazorpayAuthClient, d as CancelSubscriptionResponse, a as CancelSubscriptionInput, e as CreateOrUpdateSubscriptionResponse, C as CreateOrUpdateSubscriptionInput, P as PlanSummary, f as RestoreSubscriptionResponse, b as RestoreSubscriptionInput, g as ListSubscriptionsResponse, h as VerifyPaymentResponse, V as VerifyPaymentInput, L as ListSubscriptionsInput } from '../types-B91GdcpF.js';
+export { G as GetPlansResponse, i as RazorpayApiError, R as RazorpayApiResult, j as RazorpayClientActions } from '../types-B91GdcpF.js';
 import 'razorpay';
 
 /**

package/dist/client.d.ts

@@ -1,6 +1,6 @@
-import { S as SubscriptionRecord } from './types-VZW_XCzQ.js';
+import { S as SubscriptionRecord } from './types-BC0odu_S.js';
 import { razorpayPlugin } from './index.js';
-import { R as RazorpayApiResult, P as PlanSummary, L as ListSubscriptionsInput, C as CreateOrUpdateSubscriptionInput, a as CancelSubscriptionInput, b as RestoreSubscriptionInput, V as VerifyPaymentInput } from './types-BGWv0IJy.js';
+import { R as RazorpayApiResult, P as PlanSummary, L as ListSubscriptionsInput, C as CreateOrUpdateSubscriptionInput, a as CancelSubscriptionInput, b as RestoreSubscriptionInput, V as VerifyPaymentInput } from './types-B91GdcpF.js';
 import 'razorpay';
 import 'better-auth';
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { BetterAuthPlugin } from 'better-auth';
-import { R as RazorpayPluginOptions } from './types-VZW_XCzQ.js';
-export { O as OnWebhookEventCallback, a as RazorpayApiResponse, b as RazorpayErrorResponse, c as RazorpayPlan, d as RazorpaySubscription, e as RazorpaySuccessResponse, f as RazorpayUserRecord, g as RazorpayWebhookContext, h as RazorpayWebhookEvent, i as RazorpayWebhookPayload, S as SubscriptionRecord, j as SubscriptionStatus } from './types-VZW_XCzQ.js';
+import { R as RazorpayPluginOptions } from './types-BC0odu_S.js';
+export { O as OnWebhookEventCallback, a as RazorpayApiResponse, b as RazorpayErrorResponse, c as RazorpayPlan, d as RazorpaySubscription, e as RazorpaySuccessResponse, f as RazorpayUserRecord, g as RazorpayWebhookContext, h as RazorpayWebhookEvent, i as RazorpayWebhookPayload, S as SubscriptionRecord, j as SubscriptionStatus } from './types-BC0odu_S.js';
 import 'razorpay';
 
 interface WebhookResult {
@@ -23,6 +23,7 @@ interface WebhookResult {
  * @param options.razorpayKeySecret - Razorpay API key secret (required when razorpayClient is not provided; when set, also enables POST /razorpay/verify-payment)
  * @param options.razorpayWebhookSecret - Webhook secret for signature verification
  * @param options.createCustomerOnSignUp - Create Razorpay customer when user signs up (default: false)
+ * @param options.trialOnSignUp - Optional. When set with createCustomerOnSignUp, creates an app-level trial subscription at sign-up. { days, planName? }. Omit for no sign-up trial.
  * @param options.onCustomerCreate - Callback after customer is created
  * @param options.getCustomerCreateParams - Custom params when creating customer
  * @param options.subscription - Subscription config (enabled, plans, callbacks, authorizeReference)

package/dist/index.js

@@ -4334,8 +4334,15 @@ var createOrUpdateSubscription = (razorpay, options) => createAuthEndpoint2(
         "created",
         "halted"
       ];
-      const hasActiveSubscription = (existingSubs ?? []).filter((s) => activeStatuses.includes(s.status)).length > 0;
-      if (hasActiveSubscription) {
+      const subs = existingSubs ?? [];
+      const activePaidSubs = subs.filter(
+        (s) => activeStatuses.includes(s.status) && s.razorpaySubscriptionId
+      );
+      const appTrialSubs = subs.filter(
+        (s) => s.status === "trialing" && !s.razorpaySubscriptionId
+      );
+      const appTrialSub = appTrialSubs.length === 1 ? appTrialSubs[0] : null;
+      if (activePaidSubs.length > 0) {
         return {
           success: false,
           error: {
@@ -4354,7 +4361,7 @@ var createOrUpdateSubscription = (razorpay, options) => createAuthEndpoint2(
       };
       if (subOpts.getSubscriptionCreateParams) {
         const tempSub = {
-          id: "",
+          id: appTrialSub?.id ?? "",
           plan: plan.name,
           referenceId: userId,
           status: "created",
@@ -4379,17 +4386,64 @@ var createOrUpdateSubscription = (razorpay, options) => createAuthEndpoint2(
       const rpSubscription = await razorpay.subscriptions.create(
         subscriptionPayload
       );
+      const periodStart = rpSubscription.current_start ? new Date(rpSubscription.current_start * 1e3) : null;
+      const periodEnd = rpSubscription.current_end ? new Date(rpSubscription.current_end * 1e3) : null;
+      const newStatus = toLocalStatus(rpSubscription.status);
+      if (appTrialSub) {
+        await ctx.context.adapter.update({
+          model: "subscription",
+          where: [{ field: "id", value: appTrialSub.id }],
+          update: {
+            data: {
+              plan: plan.name,
+              razorpaySubscriptionId: rpSubscription.id,
+              status: newStatus,
+              trialEnd: now,
+              periodStart,
+              periodEnd,
+              seats: body.seats,
+              updatedAt: now
+            }
+          }
+        });
+        if (subOpts.onSubscriptionCreated) {
+          const updatedRecord = {
+            ...appTrialSub,
+            plan: plan.name,
+            razorpaySubscriptionId: rpSubscription.id,
+            status: newStatus,
+            trialEnd: now,
+            periodStart,
+            periodEnd,
+            seats: body.seats,
+            updatedAt: now
+          };
+          await subOpts.onSubscriptionCreated({
+            razorpaySubscription: rpSubscription,
+            subscription: updatedRecord,
+            plan
+          });
+        }
+        const data2 = {
+          subscriptionId: appTrialSub.id,
+          razorpaySubscriptionId: rpSubscription.id
+        };
+        if (!body.embed) {
+          data2.checkoutUrl = body.disableRedirect ? rpSubscription.short_url : body.successUrl ? `${rpSubscription.short_url}?redirect=${encodeURIComponent(body.successUrl)}` : rpSubscription.short_url;
+        }
+        return { success: true, data: data2 };
+      }
       const subscriptionRecord = {
         id: localId,
         plan: plan.name,
         referenceId: userId,
         razorpayCustomerId: user.razorpayCustomerId ?? null,
         razorpaySubscriptionId: rpSubscription.id,
-        status: toLocalStatus(rpSubscription.status),
+        status: newStatus,
         trialStart: null,
         trialEnd: null,
-        periodStart: rpSubscription.current_start ? new Date(rpSubscription.current_start * 1e3) : null,
-        periodEnd: rpSubscription.current_end ? new Date(rpSubscription.current_end * 1e3) : null,
+        periodStart,
+        periodEnd,
         cancelAtPeriodEnd: false,
         seats: body.seats,
         groupId: null,
@@ -4855,6 +4909,7 @@ var razorpayPlugin = (options) => {
     razorpayKeySecret,
     razorpayWebhookSecret,
     createCustomerOnSignUp = false,
+    trialOnSignUp,
     onCustomerCreate,
     getCustomerCreateParams,
     subscription: subOpts,
@@ -4951,6 +5006,34 @@ var razorpayPlugin = (options) => {
                   razorpayCustomer: { id: customer.id, ...customer }
                 });
               }
+              if (trialOnSignUp && typeof trialOnSignUp.days === "number" && trialOnSignUp.days > 0 && adapter.create) {
+                const now = /* @__PURE__ */ new Date();
+                const trialEnd = new Date(now.getTime() + trialOnSignUp.days * 24 * 60 * 60 * 1e3);
+                const planName = trialOnSignUp.planName ?? "Trial";
+                const localId = `sub_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+                const subscriptionRecord = {
+                  id: localId,
+                  plan: planName,
+                  referenceId: user.id,
+                  razorpayCustomerId: customer.id,
+                  razorpaySubscriptionId: null,
+                  status: "trialing",
+                  trialStart: now,
+                  trialEnd,
+                  periodStart: null,
+                  periodEnd: null,
+                  cancelAtPeriodEnd: false,
+                  seats: 1,
+                  groupId: null,
+                  createdAt: now,
+                  updatedAt: now
+                };
+                await adapter.create({
+                  model: "subscription",
+                  data: subscriptionRecord,
+                  forceAllowId: true
+                });
+              }
             } catch (err) {
               console.error("[better-auth-razorpay] Create customer on sign-up failed:", err);
             }