@deiondz/better-auth-razorpay 2.0.5 → 2.0.8

package/dist/types-B25gyPpX.d.ts

@@ -0,0 +1,208 @@
+import * as razorpay from 'razorpay';
+
+/**
+ * Razorpay subscription response from the Razorpay API.
+ */
+interface RazorpaySubscription {
+    id: string;
+    entity: string;
+    plan_id: string;
+    status: string;
+    current_start: number;
+    current_end: number;
+    ended_at: number | null;
+    quantity: number;
+    notes: Record<string, string> | null;
+    charge_at: number;
+    start_at: number;
+    end_at: number;
+    auth_attempts: number;
+    total_count: number;
+    paid_count: number;
+    customer_notify: boolean;
+    created_at: number;
+    expire_by: number | null;
+    short_url: string;
+    has_scheduled_changes: boolean;
+    change_scheduled_at: number | null;
+    source: string;
+    offer_id: string | null;
+    remaining_count: string;
+}
+/** Local subscription status aligned with Razorpay and plugin lifecycle. */
+type SubscriptionStatus = 'created' | 'active' | 'pending' | 'halted' | 'cancelled' | 'completed' | 'expired' | 'trialing';
+/** Local subscription record stored in the auth adapter. */
+interface SubscriptionRecord {
+    id: string;
+    plan: string;
+    referenceId: string;
+    razorpayCustomerId?: string | null;
+    razorpaySubscriptionId?: string | null;
+    status: SubscriptionStatus;
+    trialStart?: Date | null;
+    trialEnd?: Date | null;
+    periodStart?: Date | null;
+    periodEnd?: Date | null;
+    cancelAtPeriodEnd: boolean;
+    seats: number;
+    groupId?: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Plan limits (customizable per plan). */
+interface PlanLimits {
+    [key: string]: number;
+}
+/** Free trial configuration for a plan. */
+interface PlanFreeTrial {
+    days: number;
+    onTrialStart?: (subscription: SubscriptionRecord) => Promise<void>;
+    onTrialEnd?: (args: {
+        subscription: SubscriptionRecord;
+    }) => Promise<void>;
+}
+/** Named plan with monthly/annual Razorpay plan IDs and optional trial. */
+interface RazorpayPlan {
+    name: string;
+    monthlyPlanId: string;
+    annualPlanId?: string;
+    description?: string;
+    limits?: PlanLimits;
+    freeTrial?: PlanFreeTrial;
+}
+/** Subscription plugin options (plans, callbacks, authorization). */
+interface SubscriptionOptions {
+    enabled: boolean;
+    plans: RazorpayPlan[] | (() => Promise<RazorpayPlan[]>);
+    requireEmailVerification?: boolean;
+    authorizeReference?: (args: {
+        user: {
+            id: string;
+            email?: string;
+            name?: string;
+            [key: string]: unknown;
+        };
+        referenceId: string;
+        action: string;
+    }) => Promise<boolean>;
+    getSubscriptionCreateParams?: (args: {
+        user: {
+            id: string;
+            email?: string;
+            name?: string;
+            [key: string]: unknown;
+        };
+        session: unknown;
+        plan: RazorpayPlan;
+        subscription: SubscriptionRecord;
+    }) => Promise<{
+        params?: Record<string, unknown>;
+    }>;
+    onSubscriptionCreated?: (args: {
+        razorpaySubscription: RazorpaySubscription;
+        subscription: SubscriptionRecord;
+        plan: RazorpayPlan;
+    }) => Promise<void>;
+    onSubscriptionActivated?: (args: {
+        event: string;
+        razorpaySubscription: RazorpaySubscription;
+        subscription: SubscriptionRecord;
+        plan: RazorpayPlan;
+    }) => Promise<void>;
+    onSubscriptionUpdate?: (args: {
+        event: string;
+        subscription: SubscriptionRecord;
+    }) => Promise<void>;
+    onSubscriptionCancel?: (args: {
+        event: string;
+        razorpaySubscription: RazorpaySubscription;
+        subscription: SubscriptionRecord;
+    }) => Promise<void>;
+}
+/** User record shape used by the Razorpay plugin (customer ID on user). */
+interface RazorpayUserRecord {
+    id: string;
+    email?: string;
+    name?: string;
+    razorpayCustomerId?: string | null;
+    [key: string]: unknown;
+}
+/** Razorpay webhook event types. */
+type RazorpayWebhookEvent = 'subscription.authenticated' | 'subscription.activated' | 'subscription.charged' | 'subscription.cancelled' | 'subscription.paused' | 'subscription.resumed' | 'subscription.pending' | 'subscription.halted' | 'subscription.expired';
+interface RazorpayWebhookPayload {
+    event: RazorpayWebhookEvent;
+    subscription: {
+        id: string;
+        plan_id: string;
+        status: string;
+        current_start?: number;
+        current_end?: number;
+        [key: string]: unknown;
+    };
+    payment?: {
+        id: string;
+        amount: number;
+        currency: string;
+        [key: string]: unknown;
+    };
+}
+interface RazorpayWebhookContext {
+    userId: string;
+    user: {
+        id: string;
+        email?: string;
+        name?: string;
+        [key: string]: unknown;
+    };
+}
+type OnWebhookEventCallback = (payload: RazorpayWebhookPayload, context: RazorpayWebhookContext) => Promise<void>;
+/** Main plugin options: client, webhook secret, customer creation, subscription config, callbacks. */
+interface RazorpayPluginOptions {
+    /** Initialized Razorpay client instance. */
+    razorpayClient: razorpay;
+    /** Webhook secret for signature verification. */
+    razorpayWebhookSecret?: string;
+    /** API key secret for payment signature verification. When set, enables POST /razorpay/verify-payment (same secret as Razorpay client, not webhook secret). */
+    razorpayKeySecret?: string;
+    /** Create Razorpay customer when user signs up. Default: false. */
+    createCustomerOnSignUp?: boolean;
+    /** Called after a Razorpay customer is created. */
+    onCustomerCreate?: (args: {
+        user: RazorpayUserRecord;
+        razorpayCustomer: {
+            id: string;
+            [key: string]: unknown;
+        };
+    }) => Promise<void>;
+    /** Custom params (e.g. notes) when creating Razorpay customer. */
+    getCustomerCreateParams?: (args: {
+        user: RazorpayUserRecord;
+        session: unknown;
+    }) => Promise<{
+        params?: Record<string, unknown>;
+    }>;
+    /** Subscription feature config (plans, callbacks). */
+    subscription?: SubscriptionOptions;
+    /** Global callback for all processed webhook events. */
+    onEvent?: (event: {
+        event: string;
+        [key: string]: unknown;
+    }) => Promise<void>;
+    /** Legacy: callback after webhook events are processed (payload + context). */
+    onWebhookEvent?: OnWebhookEventCallback;
+}
+interface RazorpaySuccessResponse<T = unknown> {
+    success: true;
+    data: T;
+}
+interface RazorpayErrorResponse {
+    success: false;
+    error: {
+        code: string;
+        description: string;
+        [key: string]: unknown;
+    };
+}
+type RazorpayApiResponse<T = unknown> = RazorpaySuccessResponse<T> | RazorpayErrorResponse;
+
+export type { OnWebhookEventCallback as O, RazorpayPluginOptions as R, SubscriptionRecord as S, RazorpayApiResponse as a, RazorpayErrorResponse as b, RazorpayPlan as c, RazorpaySubscription as d, RazorpaySuccessResponse as e, RazorpayUserRecord as f, RazorpayWebhookContext as g, RazorpayWebhookEvent as h, RazorpayWebhookPayload as i, SubscriptionStatus as j };

package/dist/types-C0_Sreb6.d.ts

@@ -0,0 +1,146 @@
+import { S as SubscriptionRecord } from './types-B25gyPpX.js';
+
+/**
+ * Client-side types for Razorpay plugin hooks and API responses.
+ */
+
+/** Plan summary returned by GET /razorpay/get-plans (client-safe shape). */
+interface PlanSummary {
+    name: string;
+    monthlyPlanId: string;
+    annualPlanId?: string;
+    limits?: Record<string, number>;
+    freeTrial?: {
+        days: number;
+    };
+}
+/** Response shape for get-plans (success). */
+interface GetPlansResponse {
+    success: true;
+    data: PlanSummary[];
+}
+/** Response shape for subscription/list (success). */
+interface ListSubscriptionsResponse {
+    success: true;
+    data: SubscriptionRecord[];
+}
+/** Response shape for create-or-update (success). */
+interface CreateOrUpdateSubscriptionResponse {
+    success: true;
+    data: {
+        checkoutUrl: string;
+        subscriptionId: string;
+        razorpaySubscriptionId: string;
+    };
+}
+/** Response shape for cancel (success). */
+interface CancelSubscriptionResponse {
+    success: true;
+    data: {
+        id: string;
+        status: string;
+        plan_id: string;
+        current_end?: number;
+        ended_at?: number | null;
+    };
+}
+/** Response shape for restore (success). */
+interface RestoreSubscriptionResponse {
+    success: true;
+    data: {
+        id: string;
+        status: string;
+    };
+}
+/** Error shape from plugin API. */
+interface RazorpayApiError {
+    success: false;
+    error: {
+        code: string;
+        description: string;
+        [key: string]: unknown;
+    };
+}
+/** Any plugin API response (success or error). */
+type RazorpayApiResult<T = unknown> = {
+    success: true;
+    data: T;
+} | RazorpayApiError;
+/** Razorpay API actions from the client plugin (authClient.razorpay). Use these so requests hit the correct paths. */
+interface RazorpayClientActions {
+    getPlans: (fetchOptions?: {
+        query?: Record<string, string>;
+    }) => Promise<RazorpayApiResult<PlanSummary[]>>;
+    listSubscriptions: (input?: ListSubscriptionsInput, fetchOptions?: {
+        query?: Record<string, string>;
+    }) => Promise<RazorpayApiResult<ListSubscriptionsResponse['data']>>;
+    createOrUpdateSubscription: (input: CreateOrUpdateSubscriptionInput, fetchOptions?: {
+        body?: Record<string, unknown>;
+    }) => Promise<RazorpayApiResult<CreateOrUpdateSubscriptionResponse['data']>>;
+    cancelSubscription: (input: CancelSubscriptionInput, fetchOptions?: {
+        body?: Record<string, unknown>;
+    }) => Promise<RazorpayApiResult<CancelSubscriptionResponse['data']>>;
+    restoreSubscription: (input: RestoreSubscriptionInput, fetchOptions?: {
+        body?: Record<string, unknown>;
+    }) => Promise<RazorpayApiResult<RestoreSubscriptionResponse['data']>>;
+    verifyPayment: (input: VerifyPaymentInput, fetchOptions?: {
+        body?: Record<string, unknown>;
+    }) => Promise<RazorpayApiResult<VerifyPaymentResponse['data']>>;
+}
+/**
+ * Minimal auth client interface for Razorpay hooks.
+ * Primary: razorpay is set when razorpayClientPlugin() is used in createAuthClient({ plugins: [...] }); prefer it so requests hit the correct paths.
+ * Fallback: api is optional for custom clients that implement path-based api.get/api.post.
+ */
+interface RazorpayAuthClient {
+    /** Set when razorpayClientPlugin() is used in createAuthClient({ plugins: [razorpayClientPlugin()] }). Prefer these methods over api.get/post. */
+    razorpay?: RazorpayClientActions;
+    /** Optional; for custom clients that implement path-based api.get/post. */
+    api?: {
+        get: (path: string, options?: {
+            query?: Record<string, string>;
+        }) => Promise<RazorpayApiResult<unknown>>;
+        post: (path: string, options?: {
+            body?: Record<string, unknown>;
+        }) => Promise<RazorpayApiResult<unknown>>;
+    };
+}
+/** Input for create-or-update subscription. */
+interface CreateOrUpdateSubscriptionInput {
+    plan: string;
+    annual?: boolean;
+    seats?: number;
+    subscriptionId?: string;
+    successUrl?: string;
+    disableRedirect?: boolean;
+}
+/** Input for cancel subscription. */
+interface CancelSubscriptionInput {
+    subscriptionId: string;
+    immediately?: boolean;
+}
+/** Input for restore subscription. */
+interface RestoreSubscriptionInput {
+    subscriptionId: string;
+}
+/** Input for list subscriptions (query). */
+interface ListSubscriptionsInput {
+    referenceId?: string;
+}
+/** Input for verify-payment (Razorpay checkout success callback payload). */
+interface VerifyPaymentInput {
+    razorpay_payment_id: string;
+    razorpay_subscription_id: string;
+    razorpay_signature: string;
+}
+/** Response shape for verify-payment (success). */
+interface VerifyPaymentResponse {
+    success: true;
+    data: {
+        message: string;
+        payment_id: string;
+        subscription_id: string;
+    };
+}
+
+export type { CreateOrUpdateSubscriptionInput as C, GetPlansResponse as G, ListSubscriptionsInput as L, PlanSummary as P, RazorpayApiResult as R, VerifyPaymentInput as V, CancelSubscriptionInput as a, RestoreSubscriptionInput as b, RazorpayAuthClient as c, CancelSubscriptionResponse as d, CreateOrUpdateSubscriptionResponse as e, RestoreSubscriptionResponse as f, ListSubscriptionsResponse as g, VerifyPaymentResponse as h, RazorpayApiError as i, RazorpayClientActions as j };

package/package.json

@@ -1,68 +1,67 @@
-{
-  "name": "@deiondz/better-auth-razorpay",
-  "version": "2.0.5",
-  "description": "Better Auth plugin for Razorpay subscriptions and payments",
-  "type": "module",
-  "main": "./index.ts",
-  "types": "./index.ts",
-  "exports": {
-    ".": {
-      "types": "./index.ts",
-      "import": "./index.ts",
-      "default": "./index.ts"
-    },
-    "./client": {
-      "types": "./client.ts",
-      "import": "./client.ts",
-      "default": "./client.ts"
-    },
-    "./hooks": {
-      "types": "./client/hooks.ts",
-      "import": "./client/hooks.ts",
-      "default": "./client/hooks.ts"
-    }
-  },
-  "files": [
-    "index.ts",
-    "client.ts",
-    "client",
-    "api",
-    "lib",
-    "README.md",
-    "RAZORPAY_PLUGIN.md"
-  ],
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck"
-  },
-  "keywords": [
-    "better-auth",
-    "razorpay",
-    "plugin",
-    "subscriptions",
-    "payments",
-    "authentication"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/deiondz/better-auth-razorpay.git"
-  },
-  "peerDependencies": {
-    "@tanstack/react-query": "^5.0.0",
-    "better-auth": "^1.0.0",
-    "react": "^18.0.0 || ^19.0.0"
-  },
-  "dependencies": {
-    "razorpay": "^2.9.2",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@tanstack/react-query": "^5.0.0",
-    "react": "^18.0.0",
-    "typescript": "^5.0.0"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "@deiondz/better-auth-razorpay",
+  "version": "2.0.8",
+  "description": "Better Auth plugin for Razorpay subscriptions and payments",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./hooks": {
+      "types": "./dist/client/hooks.d.ts",
+      "import": "./dist/client/hooks.js",
+      "default": "./dist/client/hooks.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "RAZORPAY_PLUGIN.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run typecheck"
+  },
+  "keywords": [
+    "better-auth",
+    "razorpay",
+    "plugin",
+    "subscriptions",
+    "payments",
+    "authentication"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deiondz/better-auth-razorpay.git"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "better-auth": "^1.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "razorpay": "^2.9.2",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "@types/react": "^19.2.10",
+    "react": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/api/cancel-subscription.ts

@@ -1,90 +0,0 @@
-import { createAuthEndpoint, sessionMiddleware } from 'better-auth/api'
-import type Razorpay from 'razorpay'
-import {
-  cancelSubscriptionSchema,
-  handleRazorpayError,
-  type RazorpaySubscription,
-  type SubscriptionRecord,
-} from '../lib'
-
-/**
- * POST /api/auth/razorpay/subscription/cancel
- * Cancels subscription by local subscription ID. Optionally cancel immediately.
- */
-export const cancelSubscription = (razorpay: Razorpay) =>
-  createAuthEndpoint(
-    '/razorpay/subscription/cancel',
-    { method: 'POST', use: [sessionMiddleware] },
-    async (ctx) => {
-      try {
-        const body = cancelSubscriptionSchema.parse(ctx.body)
-        const userId = ctx.context.session?.user?.id
-        if (!userId) {
-          return {
-            success: false,
-            error: { code: 'UNAUTHORIZED', description: 'User not authenticated' },
-          }
-        }
-
-        const record = (await ctx.context.adapter.findOne({
-          model: 'subscription',
-          where: [{ field: 'id', value: body.subscriptionId }],
-        })) as SubscriptionRecord | null
-
-        if (!record) {
-          return {
-            success: false,
-            error: { code: 'SUBSCRIPTION_NOT_FOUND', description: 'Subscription not found' },
-          }
-        }
-        if (record.referenceId !== userId) {
-          return {
-            success: false,
-            error: { code: 'FORBIDDEN', description: 'Subscription does not belong to you' },
-          }
-        }
-
-        const rpId = record.razorpaySubscriptionId
-        if (!rpId) {
-          return {
-            success: false,
-            error: { code: 'INVALID_STATE', description: 'No Razorpay subscription linked' },
-          }
-        }
-
-        // cancel_at_cycle_end: true = cancel at period end, false = cancel immediately
-        const subscription = (await razorpay.subscriptions.cancel(
-          rpId,
-          !body.immediately
-        )) as RazorpaySubscription
-
-        await ctx.context.adapter.update({
-          model: 'subscription',
-          where: [{ field: 'id', value: body.subscriptionId }],
-          update: {
-            data: {
-              status: 'cancelled',
-              cancelAtPeriodEnd: !body.immediately,
-              periodEnd: subscription.current_end
-                ? new Date(subscription.current_end * 1000)
-                : record.periodEnd,
-              updatedAt: new Date(),
-            },
-          },
-        })
-
-        return {
-          success: true,
-          data: {
-            id: subscription.id,
-            status: subscription.status,
-            plan_id: subscription.plan_id,
-            current_end: subscription.current_end,
-            ended_at: subscription.ended_at,
-          },
-        }
-      } catch (error) {
-        return handleRazorpayError(error)
-      }
-    }
-  )