@alexasomba/better-auth-paystack 0.0.4

package/README.md

@@ -0,0 +1,218 @@
+# Better Auth Paystack Plugin
+
+Better Auth plugin that integrates Paystack for customer creation, checkout, and Paystack-native subscription flows.
+
+## Features
+
+- Optional Paystack customer creation on sign up (`createCustomerOnSignUp`)
+- Paystack checkout via transaction initialize + verify (redirect-first)
+- Paystack webhook signature verification (`x-paystack-signature`, HMAC-SHA512)
+- Local subscription records stored in your Better Auth database
+- Subscription management endpoints using Paystack’s email-token flows (`/subscription/enable` + `/subscription/disable`)
+- Reference ID support (user by default; org/team via `referenceId` + `authorizeReference`)
+
+## Installation
+
+### Install packages
+
+```bash
+npm install better-auth @alexasomba/better-auth-paystack
+```
+
+If you want strict typing and the recommended server SDK client:
+
+```bash
+npm install @alexasomba/paystack-node
+```
+
+If your app has separate client + server bundles, install the plugin in both.
+
+### Configure the server plugin
+
+```ts
+import { betterAuth } from "better-auth";
+import { paystack } from "@alexasomba/better-auth-paystack";
+import { createPaystack } from "@alexasomba/paystack-node";
+
+const paystackClient = createPaystack({
+  secretKey: process.env.PAYSTACK_SECRET_KEY!,
+});
+
+export const auth = betterAuth({
+  plugins: [
+    paystack({
+      paystackClient,
+      paystackWebhookSecret: process.env.PAYSTACK_WEBHOOK_SECRET!,
+      createCustomerOnSignUp: true,
+      subscription: {
+        enabled: true,
+        plans: [
+          {
+            name: "starter",
+            amount: 500000,
+            currency: "NGN",
+            // If you use Paystack Plans, prefer planCode + (optional) invoiceLimit.
+            // planCode: "PLN_...",
+            // invoiceLimit: 12,
+          },
+        ],
+        authorizeReference: async ({ user, referenceId, action }, ctx) => {
+          // Allow only the current user by default; authorize org/team IDs here.
+          // return await canUserManageOrg(user.id, referenceId)
+          return referenceId === user.id;
+        },
+      },
+    }),
+  ],
+});
+```
+
+### Configure the client plugin
+
+```ts
+import { createAuthClient } from "better-auth/client";
+import { paystackClient } from "@alexasomba/better-auth-paystack/client";
+
+export const client = createAuthClient({
+  plugins: [paystackClient({ subscription: true })],
+});
+```
+
+### Migrate / generate schema
+
+The plugin adds fields/tables to your Better Auth database. Run the Better Auth CLI migration/generate step you already use in your project.
+
+## Webhooks
+
+### Endpoint URL
+
+The plugin exposes a webhook endpoint at:
+
+```
+{AUTH_BASE}/paystack/webhook
+```
+
+Where `{AUTH_BASE}` is your Better Auth server base path (commonly `/api/auth`).
+
+### Signature verification
+
+Paystack sends `x-paystack-signature` which is an HMAC-SHA512 of the raw payload signed with your secret key. The plugin verifies this using `paystackWebhookSecret`.
+
+### Recommended events
+
+At minimum, enable the events your app depends on. For subscription flows, Paystack documents these as relevant:
+
+- `charge.success`
+- `subscription.create`
+- `subscription.disable`
+- `subscription.not_renew`
+
+The plugin forwards all webhook payloads to `onEvent` (if provided) after signature verification.
+
+## Usage
+
+### Defining plans
+
+Plans are referenced by their `name` (stored lowercased). For Paystack-native subscriptions you can either:
+
+- Use `planCode` (Paystack plan code). When `planCode` is provided, Paystack invalidates `amount` during transaction initialization.
+- Or use `amount` (smallest currency unit) for simple payments.
+
+### Frontend checkout (redirect)
+
+This flow matches Paystack’s transaction initialize/verify APIs:
+
+1. Call `POST {AUTH_BASE}/paystack/transaction/initialize`
+2. Redirect the user to the returned Paystack `url`
+3. On your callback route/page, call `GET {AUTH_BASE}/paystack/transaction/verify?reference=...`
+
+Example (framework-agnostic):
+
+```ts
+// Start checkout
+const initRes = await fetch("/api/auth/paystack/transaction/initialize", {
+  method: "POST",
+  headers: { "content-type": "application/json" },
+  body: JSON.stringify({
+    plan: "starter",
+    callbackURL: `${window.location.origin}/billing/paystack/callback`,
+    // Optional for org/team billing (requires authorizeReference)
+    // referenceId: "org_123",
+  }),
+});
+
+const init = await initRes.json();
+// { url, reference, accessCode, redirect: true }
+if (init?.url) window.location.href = init.url;
+
+// On your callback page/route
+const reference = new URLSearchParams(window.location.search).get("reference");
+if (reference) {
+  await fetch(
+    `/api/auth/paystack/transaction/verify?reference=${encodeURIComponent(reference)}`,
+  );
+}
+```
+
+### Inline modal checkout (optional)
+
+If you prefer an inline checkout experience, initialize the transaction the same way and use `@alexasomba/paystack-browser` in your UI. This plugin does not render UI — it only provides server endpoints.
+
+### Listing local subscriptions
+
+List subscription rows stored by this plugin:
+
+`GET {AUTH_BASE}/paystack/subscription/list-local`
+
+You can optionally pass `referenceId` as a query param (requires `authorizeReference` when it’s not the current user):
+
+`GET {AUTH_BASE}/paystack/subscription/list-local?referenceId=org_123`
+
+### Enabling / disabling a subscription
+
+Paystack requires both the subscription code and the email token.
+
+For convenience, the plugin lets you omit `emailToken` and will attempt to fetch it from Paystack using the subscription code (via Subscription fetch, with a fallback to Manage Link).
+
+- `POST {AUTH_BASE}/paystack/subscription/enable` with `{ subscriptionCode, emailToken? }`
+- `POST {AUTH_BASE}/paystack/subscription/disable` with `{ subscriptionCode, emailToken? }`
+
+Paystack documents these as `code` + `token`. If the server cannot fetch `emailToken`, you can still provide it explicitly (e.g., from the Subscription API or your Paystack dashboard).
+
+## Schema
+
+The plugin adds:
+
+- `user.paystackCustomerCode?: string`
+- `subscription` table with fields like: `plan`, `referenceId`, `paystackCustomerCode`, `paystackSubscriptionCode`, `paystackTransactionReference`, `status`, and optional period/trial fields.
+
+## Options
+
+Main options:
+
+- `paystackClient` (recommended: `createPaystack({ secretKey })`)
+- `paystackWebhookSecret`
+- `createCustomerOnSignUp?`
+- `onCustomerCreate?`, `getCustomerCreateParams?`
+- `onEvent?`
+- `schema?` (override/mapping)
+
+Subscription options (when `subscription.enabled: true`):
+
+- `plans` (array or async function)
+- `requireEmailVerification?`
+- `authorizeReference?`
+- `onSubscriptionComplete?`, `onSubscriptionUpdate?`, `onSubscriptionDelete?`
+
+## Troubleshooting
+
+- Webhook signature mismatch: ensure your server receives the raw body, and `PAYSTACK_WEBHOOK_SECRET` matches the secret key used by Paystack to sign events.
+- Subscription list returns empty: verify you’re passing the correct `referenceId`, and that `authorizeReference` allows it.
+- Transaction initializes but verify doesn’t update: ensure you call the verify endpoint after redirect, and confirm Paystack returns `status: "success"` for the reference.
+
+## Links
+
+- Paystack Webhooks: https://paystack.com/docs/payments/webhooks/
+- Paystack Transaction API: https://paystack.com/docs/api/transaction/
+- Paystack Subscription API: https://paystack.com/docs/api/subscription/
+- Paystack Plan API: https://paystack.com/docs/api/plan/

package/dist/client.d.mts

@@ -0,0 +1,30 @@
+import { n as paystack, r as PaystackNodeClient } from "./index-CZ3Le7Er.mjs";
+
+//#region src/client.d.ts
+declare const paystackClient: <O extends {
+  subscription: boolean;
+}>(_options?: O | undefined) => {
+  id: "paystack-client";
+  $InferServerPlugin: ReturnType<typeof paystack<PaystackNodeClient, O["subscription"] extends true ? {
+    paystackClient: PaystackNodeClient;
+    paystackWebhookSecret: string;
+    subscription: {
+      enabled: true;
+      plans: [];
+    };
+  } : {
+    paystackClient: PaystackNodeClient;
+    paystackWebhookSecret: string;
+  }>>;
+  pathMethods: {
+    "/paystack/webhook": "POST";
+    "/paystack/transaction/initialize": "POST";
+    "/paystack/transaction/verify": "GET";
+    "/paystack/subscription/list-local": "GET";
+    "/paystack/subscription/disable": "POST";
+    "/paystack/subscription/enable": "POST";
+  };
+};
+//#endregion
+export { paystackClient };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;cAIa;EAAA,YAAA,EAAA,OAoCZ;CA/Bc,CAAA,CAAA,QAAA,CAAA,EAAA,CAAA,GAAA,SAAA,EAAA,GAAA;EAMC,EAAA,EAAA,iBAAA;EACA,kBAAA,EAHkB,UAGlB,CAAA,OAFG,QAEH,CADA,kBACA,EAAA,CAAA,CAAA,cAAA,CAAA,SAAA,IAAA,GAAA;IAEoB,cAAA,EAAA,kBAAA;IAQA,qBAAA,EAAA,MAAA;IAZjB,YAAA,EAAA;MADe,OAAA,EAAA,IAAA;MAAU,KAAA,EAAA,EAAA;;;oBAaR"}

package/dist/client.mjs

@@ -0,0 +1,19 @@
+//#region src/client.ts
+const paystackClient = (_options) => {
+	return {
+		id: "paystack-client",
+		$InferServerPlugin: {},
+		pathMethods: {
+			"/paystack/webhook": "POST",
+			"/paystack/transaction/initialize": "POST",
+			"/paystack/transaction/verify": "GET",
+			"/paystack/subscription/list-local": "GET",
+			"/paystack/subscription/disable": "POST",
+			"/paystack/subscription/enable": "POST"
+		}
+	};
+};
+
+//#endregion
+export { paystackClient };
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { BetterAuthClientPlugin } from \"better-auth\";\nimport type { paystack } from \"./index\";\nimport type { PaystackNodeClient } from \"./types\";\n\nexport const paystackClient = <\n    O extends {\n        subscription: boolean;\n    },\n>(\n    _options?: O | undefined,\n) => {\n    return {\n        id: \"paystack-client\",\n        $InferServerPlugin: {} as ReturnType<\n            typeof paystack<\n                PaystackNodeClient,\n                O[\"subscription\"] extends true\n                ? {\n                    paystackClient: PaystackNodeClient;\n                    paystackWebhookSecret: string;\n                    subscription: {\n                        enabled: true;\n                        plans: [];\n                    };\n                }\n                : {\n                    paystackClient: PaystackNodeClient;\n                    paystackWebhookSecret: string;\n                }\n            >\n        >,\n        pathMethods: {\n            \"/paystack/webhook\": \"POST\",\n            \"/paystack/transaction/initialize\": \"POST\",\n            \"/paystack/transaction/verify\": \"GET\",\n            \"/paystack/subscription/list-local\": \"GET\",\n            \"/paystack/subscription/disable\": \"POST\",\n            \"/paystack/subscription/enable\": \"POST\",\n        },\n    } satisfies BetterAuthClientPlugin;\n};\n"],"mappings":";AAIA,MAAa,kBAKT,aACC;AACD,QAAO;EACH,IAAI;EACJ,oBAAoB,EAAE;EAkBtB,aAAa;GACT,qBAAqB;GACrB,oCAAoC;GACpC,gCAAgC;GAChC,qCAAqC;GACrC,kCAAkC;GAClC,iCAAiC;GACpC;EACJ"}

package/dist/index-CZ3Le7Er.d.mts

@@ -0,0 +1,274 @@
+import * as better_auth0 from "better-auth";
+import { GenericEndpointContext, InferOptionSchema, Session, User } from "better-auth";
+import { createPaystack } from "@alexasomba/paystack-node";
+
+//#region src/schema.d.ts
+declare const subscriptions: {
+  subscription: {
+    fields: {
+      plan: {
+        type: "string";
+        required: true;
+      };
+      referenceId: {
+        type: "string";
+        required: true;
+      };
+      paystackCustomerCode: {
+        type: "string";
+        required: false;
+      };
+      paystackSubscriptionCode: {
+        type: "string";
+        required: false;
+      };
+      paystackTransactionReference: {
+        type: "string";
+        required: false;
+      };
+      status: {
+        type: "string";
+        defaultValue: string;
+      };
+      periodStart: {
+        type: "date";
+        required: false;
+      };
+      periodEnd: {
+        type: "date";
+        required: false;
+      };
+      trialStart: {
+        type: "date";
+        required: false;
+      };
+      trialEnd: {
+        type: "date";
+        required: false;
+      };
+      cancelAtPeriodEnd: {
+        type: "boolean";
+        required: false;
+        defaultValue: false;
+      };
+      groupId: {
+        type: "string";
+        required: false;
+      };
+      seats: {
+        type: "number";
+        required: false;
+      };
+    };
+  };
+};
+declare const user: {
+  user: {
+    fields: {
+      paystackCustomerCode: {
+        type: "string";
+        required: false;
+      };
+    };
+  };
+};
+//#endregion
+//#region src/types.d.ts
+type PaystackNodeClient = ReturnType<typeof createPaystack>;
+type PaystackOpenApiFetchResponse<T = unknown> = {
+  data?: T;
+  error?: unknown;
+  response?: Response;
+};
+type PaystackApiResult<T = unknown> = Promise<T | PaystackOpenApiFetchResponse<T>>;
+type PaystackClientLike = {
+  customer_create?: (init?: {
+    body?: any;
+  } | undefined) => PaystackApiResult<any>;
+  transaction_initialize?: (init?: {
+    body?: any;
+  } | undefined) => PaystackApiResult<any>;
+  transaction_verify?: (init: {
+    params: {
+      path: {
+        reference: string;
+      };
+    };
+  }) => PaystackApiResult<any>;
+  subscription_fetch?: (init: any) => PaystackApiResult<any>;
+  subscription_disable?: (init?: {
+    body?: {
+      code: string;
+      token: string;
+    };
+  } | undefined) => PaystackApiResult<any>;
+  subscription_enable?: (init?: {
+    body?: {
+      code: string;
+      token: string;
+    };
+  } | undefined) => PaystackApiResult<any>;
+  subscription_manage_link?: (init: {
+    params: {
+      path: {
+        code: string;
+      };
+    };
+  }) => PaystackApiResult<any>;
+  customer?: {
+    create?: (params: any) => Promise<any>;
+  };
+  transaction?: {
+    initialize?: (params: any) => Promise<any>;
+    verify?: (reference: string) => Promise<any>;
+  };
+  subscription?: {
+    fetch?: (idOrCode: string) => Promise<any>;
+    disable?: (params: any) => Promise<any>;
+    enable?: (params: any) => Promise<any>;
+    manage?: {
+      link?: (code: string) => Promise<any>;
+    };
+  };
+};
+type NoInfer<T> = [T][T extends any ? 0 : never];
+type AuthSession = {
+  user: User;
+  session: Session;
+} & Record<string, any>;
+type PaystackPlan = {
+  /** Human name stored in DB (lowercased). */
+  name: string;
+  /** Paystack plan code (if you use Paystack plans). */
+  planCode?: string | undefined;
+  /** Amount in the smallest currency unit (e.g. kobo). */
+  amount?: number | undefined;
+  /** Currency ISO code (e.g. NGN). */
+  currency?: string | undefined;
+  /** Paystack interval keyword (when using Paystack plans). */
+  interval?: "daily" | "weekly" | "monthly" | "quarterly" | "biannually" | "annually" | undefined;
+  /** Optional invoice limit; Paystack uses `invoice_limit` during init. */
+  invoiceLimit?: number | undefined;
+  /** Arbitrary limits (stored/consumed by your app). */
+  limits?: Record<string, unknown> | undefined;
+  /** Optional free trial config, if your app supports it. */
+  freeTrial?: {
+    days: number;
+  } | undefined;
+};
+interface Subscription {
+  id: string;
+  plan: string;
+  referenceId: string;
+  paystackCustomerCode?: string | undefined;
+  paystackSubscriptionCode?: string | undefined;
+  paystackTransactionReference?: string | undefined;
+  status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "paused" | "trialing" | "unpaid";
+  periodStart?: Date | undefined;
+  periodEnd?: Date | undefined;
+  trialStart?: Date | undefined;
+  trialEnd?: Date | undefined;
+  cancelAtPeriodEnd?: boolean | undefined;
+  groupId?: string | undefined;
+  seats?: number | undefined;
+}
+type SubscriptionOptions = {
+  plans: PaystackPlan[] | (() => PaystackPlan[] | Promise<PaystackPlan[]>);
+  requireEmailVerification?: boolean | undefined;
+  authorizeReference?: ((data: {
+    user: User;
+    session: AuthSession;
+    referenceId: string;
+    action: "initialize-transaction" | "verify-transaction" | "list-subscriptions" | "disable-subscription" | "enable-subscription";
+  }, ctx: GenericEndpointContext) => Promise<boolean>) | undefined;
+  onSubscriptionComplete?: ((data: {
+    event: any;
+    subscription: Subscription;
+    plan: PaystackPlan;
+  }, ctx: GenericEndpointContext) => Promise<void>) | undefined;
+  onSubscriptionUpdate?: ((data: {
+    event: any;
+    subscription: Subscription;
+  }, ctx: GenericEndpointContext) => Promise<void>) | undefined;
+  onSubscriptionDelete?: ((data: {
+    event: any;
+    subscription: Subscription;
+  }, ctx: GenericEndpointContext) => Promise<void>) | undefined;
+};
+interface PaystackOptions<TPaystackClient extends PaystackClientLike = PaystackNodeClient> {
+  /** Paystack SDK instance (recommended: `@alexasomba/paystack-node` via `createPaystack({ secretKey })`). */
+  paystackClient: NoInfer<TPaystackClient>;
+  /** Paystack webhook secret used to verify `x-paystack-signature`. */
+  paystackWebhookSecret: string;
+  /** Enable customer creation on Better Auth sign up. */
+  createCustomerOnSignUp?: boolean | undefined;
+  onCustomerCreate?: ((data: {
+    paystackCustomer: any;
+    user: User & {
+      paystackCustomerCode: string;
+    };
+  }, ctx: GenericEndpointContext) => Promise<void>) | undefined;
+  getCustomerCreateParams?: ((user: User, ctx: GenericEndpointContext) => Promise<Record<string, any>>) | undefined;
+  subscription?: ({
+    enabled: false;
+  } | ({
+    enabled: true;
+  } & SubscriptionOptions)) | undefined;
+  onEvent?: ((event: any) => Promise<void>) | undefined;
+  schema?: InferOptionSchema<typeof subscriptions & typeof user> | undefined;
+}
+//#endregion
+//#region src/index.d.ts
+declare const paystack: <TPaystackClient extends PaystackClientLike = PaystackNodeClient, O extends PaystackOptions<TPaystackClient> = PaystackOptions<TPaystackClient>>(options: O) => {
+  id: "paystack";
+  endpoints: {
+    paystackWebhook: better_auth0.StrictEndpoint<"/paystack/webhook", {
+      method: "POST";
+      metadata: {
+        openapi: {
+          operationId: string;
+        };
+        scope: "server";
+      };
+      cloneRequest: true;
+      disableBody: true;
+    }, {
+      received: boolean;
+    }>;
+  };
+  init(ctx: better_auth0.AuthContext<better_auth0.BetterAuthOptions>): {
+    options: {
+      databaseHooks: {
+        user: {
+          create: {
+            after(user: {
+              id: string;
+              createdAt: Date;
+              updatedAt: Date;
+              email: string;
+              emailVerified: boolean;
+              name: string;
+              image?: string | null | undefined;
+            } & Record<string, unknown>, hookCtx: better_auth0.GenericEndpointContext<better_auth0.BetterAuthOptions> | null): Promise<void>;
+          };
+        };
+      };
+    };
+  };
+  schema: better_auth0.BetterAuthPluginDBSchema;
+  $ERROR_CODES: {
+    readonly SUBSCRIPTION_NOT_FOUND: "Subscription not found";
+    readonly SUBSCRIPTION_PLAN_NOT_FOUND: "Subscription plan not found";
+    readonly UNABLE_TO_CREATE_CUSTOMER: "Unable to create customer";
+    readonly FAILED_TO_INITIALIZE_TRANSACTION: "Failed to initialize transaction";
+    readonly FAILED_TO_VERIFY_TRANSACTION: "Failed to verify transaction";
+    readonly FAILED_TO_DISABLE_SUBSCRIPTION: "Failed to disable subscription";
+    readonly FAILED_TO_ENABLE_SUBSCRIPTION: "Failed to enable subscription";
+    readonly EMAIL_VERIFICATION_REQUIRED: "Email verification is required before you can subscribe to a plan";
+  };
+};
+type PaystackClientFromOptions<O extends PaystackOptions<any>> = O extends PaystackOptions<infer TClient> ? TClient : PaystackNodeClient;
+type PaystackPlugin<O extends PaystackOptions<any> = PaystackOptions> = ReturnType<typeof paystack<PaystackClientFromOptions<O>, O>>;
+//#endregion
+export { PaystackPlan as a, PaystackOptions as i, paystack as n, Subscription as o, PaystackNodeClient as r, SubscriptionOptions as s, PaystackPlugin as t };
+//# sourceMappingURL=index-CZ3Le7Er.d.mts.map

package/dist/index-CZ3Le7Er.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CZ3Le7Er.d.mts","names":["GenericEndpointContext","InferOptionSchema","Session","User","createPaystack","subscriptions","user","PaystackNodeClient","ReturnType","PaystackOpenApiFetchResponse","T","Response","PaystackApiResult","Promise","PaystackClientLike","NoInfer","AuthSession","Record","PaystackPlan","Subscription","Date","SubscriptionOptions","PaystackOptions","TPaystackClient","InputSubscription","Omit"],"sources":["../src/schema.ts","../src/types.d.ts","../src/index.ts"],"sourcesContent":["import type { GenericEndpointContext, InferOptionSchema, Session, User } from \"better-auth\";\nimport type { createPaystack } from \"@alexasomba/paystack-node\";\nimport type { subscriptions, user } from \"./schema\";\nexport type PaystackNodeClient = ReturnType<typeof createPaystack>;\nexport type PaystackOpenApiFetchResponse<T = unknown> = {\n    data?: T;\n    error?: unknown;\n    response?: Response;\n};\nexport type PaystackApiResult<T = unknown> = Promise<T | PaystackOpenApiFetchResponse<T>>;\nexport type PaystackClientLike = {\n    customer_create?: (init?: {\n        body?: any;\n    } | undefined) => PaystackApiResult<any>;\n    transaction_initialize?: (init?: {\n        body?: any;\n    } | undefined) => PaystackApiResult<any>;\n    transaction_verify?: (init: {\n        params: {\n            path: {\n                reference: string;\n            };\n        };\n    }) => PaystackApiResult<any>;\n    subscription_fetch?: (init: any) => PaystackApiResult<any>;\n    subscription_disable?: (init?: {\n        body?: {\n            code: string;\n            token: string;\n        };\n    } | undefined) => PaystackApiResult<any>;\n    subscription_enable?: (init?: {\n        body?: {\n            code: string;\n            token: string;\n        };\n    } | undefined) => PaystackApiResult<any>;\n    subscription_manage_link?: (init: {\n        params: {\n            path: {\n                code: string;\n            };\n        };\n    }) => PaystackApiResult<any>;\n    customer?: {\n        create?: (params: any) => Promise<any>;\n    };\n    transaction?: {\n        initialize?: (params: any) => Promise<any>;\n        verify?: (reference: string) => Promise<any>;\n    };\n    subscription?: {\n        fetch?: (idOrCode: string) => Promise<any>;\n        disable?: (params: any) => Promise<any>;\n        enable?: (params: any) => Promise<any>;\n        manage?: {\n            link?: (code: string) => Promise<any>;\n        };\n    };\n};\ntype NoInfer<T> = [T][T extends any ? 0 : never];\nexport type AuthSession = {\n    user: User;\n    session: Session;\n} & Record<string, any>;\nexport type PaystackPlan = {\n    /** Human name stored in DB (lowercased). */\n    name: string;\n    /** Paystack plan code (if you use Paystack plans). */\n    planCode?: string | undefined;\n    /** Amount in the smallest currency unit (e.g. kobo). */\n    amount?: number | undefined;\n    /** Currency ISO code (e.g. NGN). */\n    currency?: string | undefined;\n    /** Paystack interval keyword (when using Paystack plans). */\n    interval?: \"daily\" | \"weekly\" | \"monthly\" | \"quarterly\" | \"biannually\" | \"annually\" | undefined;\n    /** Optional invoice limit; Paystack uses `invoice_limit` during init. */\n    invoiceLimit?: number | undefined;\n    /** Arbitrary limits (stored/consumed by your app). */\n    limits?: Record<string, unknown> | undefined;\n    /** Optional free trial config, if your app supports it. */\n    freeTrial?: {\n        days: number;\n    } | undefined;\n};\nexport interface Subscription {\n    id: string;\n    plan: string;\n    referenceId: string;\n    paystackCustomerCode?: string | undefined;\n    paystackSubscriptionCode?: string | undefined;\n    paystackTransactionReference?: string | undefined;\n    status: \"active\" | \"canceled\" | \"incomplete\" | \"incomplete_expired\" | \"paused\" | \"trialing\" | \"unpaid\";\n    periodStart?: Date | undefined;\n    periodEnd?: Date | undefined;\n    trialStart?: Date | undefined;\n    trialEnd?: Date | undefined;\n    cancelAtPeriodEnd?: boolean | undefined;\n    groupId?: string | undefined;\n    seats?: number | undefined;\n}\nexport type SubscriptionOptions = {\n    plans: PaystackPlan[] | (() => PaystackPlan[] | Promise<PaystackPlan[]>);\n    requireEmailVerification?: boolean | undefined;\n    authorizeReference?: ((data: {\n        user: User;\n        session: AuthSession;\n        referenceId: string;\n        action: \"initialize-transaction\" | \"verify-transaction\" | \"list-subscriptions\" | \"disable-subscription\" | \"enable-subscription\";\n    }, ctx: GenericEndpointContext) => Promise<boolean>) | undefined;\n    onSubscriptionComplete?: ((data: {\n        event: any;\n        subscription: Subscription;\n        plan: PaystackPlan;\n    }, ctx: GenericEndpointContext) => Promise<void>) | undefined;\n    onSubscriptionUpdate?: ((data: {\n        event: any;\n        subscription: Subscription;\n    }, ctx: GenericEndpointContext) => Promise<void>) | undefined;\n    onSubscriptionDelete?: ((data: {\n        event: any;\n        subscription: Subscription;\n    }, ctx: GenericEndpointContext) => Promise<void>) | undefined;\n};\nexport interface PaystackOptions<TPaystackClient extends PaystackClientLike = PaystackNodeClient> {\n    /** Paystack SDK instance (recommended: `@alexasomba/paystack-node` via `createPaystack({ secretKey })`). */\n    paystackClient: NoInfer<TPaystackClient>;\n    /** Paystack webhook secret used to verify `x-paystack-signature`. */\n    paystackWebhookSecret: string;\n    /** Enable customer creation on Better Auth sign up. */\n    createCustomerOnSignUp?: boolean | undefined;\n    onCustomerCreate?: ((data: {\n        paystackCustomer: any;\n        user: User & {\n            paystackCustomerCode: string;\n        };\n    }, ctx: GenericEndpointContext) => Promise<void>) | undefined;\n    getCustomerCreateParams?: ((user: User, ctx: GenericEndpointContext) => Promise<Record<string, any>>) | undefined;\n    subscription?: ({\n        enabled: false;\n    } | ({\n        enabled: true;\n    } & SubscriptionOptions)) | undefined;\n    onEvent?: ((event: any) => Promise<void>) | undefined;\n    schema?: InferOptionSchema<typeof subscriptions & typeof user> | undefined;\n}\nexport interface InputSubscription extends Omit<Subscription, \"id\"> {\n}\nexport {};\n//# sourceMappingURL=types.d.ts.map"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { a as PaystackPlan, i as PaystackOptions, n as paystack, o as Subscription, s as SubscriptionOptions, t as PaystackPlugin } from "./index-CZ3Le7Er.mjs";
+export { PaystackOptions, PaystackPlan, PaystackPlugin, Subscription, SubscriptionOptions, paystack };