@deiondz/better-auth-razorpay 2.0.12 → 2.0.14

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}`)
   },
@@ -341,7 +354,7 @@ All endpoints are prefixed with `/api/auth/razorpay/` (or your configured `baseP
 | Cancel | `POST` | `subscription/cancel` | Cancel by local subscription ID. Body: `subscriptionId`, `immediately?`. |
 | Restore | `POST` | `subscription/restore` | Restore a subscription scheduled to cancel. Body: `subscriptionId`. |
 | List | `GET` | `subscription/list` | List active/trialing subscriptions. Query: `referenceId?` (default: current user). |
-| Get plans | `GET` | `get-plans` | Return configured plans (name, monthlyPlanId, annualPlanId, limits, freeTrial). |
+| Get plans | `GET` | `get-plans` | Return configured plans with price details (name, monthlyPlanId, annualPlanId, limits, freeTrial, monthly/annual amount, currency, period from Razorpay). |
 | Webhook | `POST` | `webhook` | Razorpay webhook URL; configure in Razorpay Dashboard. |
 
 ### 1. Get Plans
@@ -350,6 +363,8 @@ Retrieve all configured subscription plans (from plugin config; no Razorpay API
 
 **Endpoint:** `GET /api/auth/razorpay/get-plans`
 
+Each plan in the response includes optional **price details** (`monthly`, `annual`) when available from Razorpay: `amount` (smallest currency unit, e.g. paise/cents), `currency`, `period` (e.g. monthly, yearly), and `interval`. Omitted if the plan fetch fails or the variant is not configured.
+
 **Authentication:** Not required (public endpoint)
 
 **Response:**
@@ -357,7 +372,7 @@ Retrieve all configured subscription plans (from plugin config; no Razorpay API
 ```typescript
 {
   success: true,
-  data: Array<{ name: string; monthlyPlanId: string; annualPlanId?: string; limits?: Record<string, number>; freeTrial?: { days: number } }>
+  data: Array<{ name: string; monthlyPlanId: string; annualPlanId?: string; limits?: Record<string, number>; freeTrial?: { days: number }; monthly?: { amount: number; currency: string; period: string; interval?: number }; annual?: { amount: number; currency: string; period: string; interval?: number } }>
 }
 ```
 

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-3dNrA0qB.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-CKR2ILS1.js';
+export { G as GetPlansResponse, i as RazorpayApiError, R as RazorpayApiResult, j as RazorpayClientActions } from '../types-CKR2ILS1.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-3dNrA0qB.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-CKR2ILS1.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-3dNrA0qB.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-3dNrA0qB.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,
@@ -4427,24 +4481,48 @@ import { createAuthEndpoint as createAuthEndpoint3 } from "better-auth/api";
 async function resolvePlans2(plans) {
   return typeof plans === "function" ? plans() : plans;
 }
-var getPlans = (options) => createAuthEndpoint3("/razorpay/get-plans", { method: "GET" }, async (_ctx) => {
+async function fetchPlanPrice(razorpay, planId) {
+  try {
+    const plan = await razorpay.plans.fetch(planId);
+    const item = plan?.item;
+    if (item && typeof item.amount === "number" && typeof item.currency === "string") {
+      return {
+        amount: item.amount,
+        currency: item.currency,
+        period: typeof plan.period === "string" ? plan.period : "monthly",
+        interval: typeof plan.interval === "number" ? plan.interval : void 0
+      };
+    }
+  } catch {
+  }
+  return void 0;
+}
+var getPlans = (razorpay, options) => createAuthEndpoint3("/razorpay/get-plans", { method: "GET" }, async (_ctx) => {
   try {
     const subOpts = options.subscription;
     if (!subOpts?.enabled) {
       return { success: true, data: [] };
     }
     const plans = await resolvePlans2(subOpts.plans);
-    return {
-      success: true,
-      data: plans.map((p) => ({
-        name: p.name,
-        monthlyPlanId: p.monthlyPlanId,
-        annualPlanId: p.annualPlanId,
-        description: p.description,
-        limits: p.limits,
-        freeTrial: p.freeTrial ? { days: p.freeTrial.days } : void 0
-      }))
-    };
+    const data = await Promise.all(
+      plans.map(async (p) => {
+        const [monthly, annual] = await Promise.all([
+          fetchPlanPrice(razorpay, p.monthlyPlanId),
+          p.annualPlanId ? fetchPlanPrice(razorpay, p.annualPlanId) : Promise.resolve(void 0)
+        ]);
+        return {
+          name: p.name,
+          monthlyPlanId: p.monthlyPlanId,
+          annualPlanId: p.annualPlanId,
+          description: p.description,
+          limits: p.limits,
+          freeTrial: p.freeTrial ? { days: p.freeTrial.days } : void 0,
+          monthly,
+          annual
+        };
+      })
+    );
+    return { success: true, data };
   } catch (error) {
     return handleRazorpayError(error);
   }
@@ -4855,6 +4933,7 @@ var razorpayPlugin = (options) => {
     razorpayKeySecret,
     razorpayWebhookSecret,
     createCustomerOnSignUp = false,
+    trialOnSignUp,
     onCustomerCreate,
     getCustomerCreateParams,
     subscription: subOpts,
@@ -4912,7 +4991,7 @@ var razorpayPlugin = (options) => {
       "subscription/cancel": cancelSubscription(razorpay),
       "subscription/restore": restoreSubscription(razorpay),
       "subscription/list": listSubscriptions({ subscription: subOpts }),
-      "get-plans": getPlans({ subscription: subOpts }),
+      "get-plans": getPlans(razorpay, { subscription: subOpts }),
       ...razorpayKeySecret ? { "verify-payment": verifyPayment(razorpayKeySecret) } : {},
       webhook: webhook(razorpayWebhookSecret, options.onWebhookEvent ?? void 0, {
         subscription: subOpts,
@@ -4951,6 +5030,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);
             }