@guilhermejansen/better-auth-waitlist 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guilherme Jansen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,322 @@
+# @guilhermejansen/better-auth-waitlist
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@guilhermejansen/better-auth-waitlist"><img src="https://img.shields.io/npm/v/@guilhermejansen/better-auth-waitlist?style=flat-square&color=cb3837&label=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@guilhermejansen/better-auth-waitlist"><img src="https://img.shields.io/npm/dm/@guilhermejansen/better-auth-waitlist?style=flat-square&color=blue" alt="npm downloads"></a>
+  <a href="https://github.com/guilhermejansen/better-auth-waitlist/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@guilhermejansen/better-auth-waitlist?style=flat-square&color=green" alt="license"></a>
+  <a href="https://github.com/guilhermejansen/better-auth-waitlist/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/guilhermejansen/better-auth-waitlist/ci.yml?branch=main&style=flat-square&label=CI" alt="CI"></a>
+  <br>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.9+-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript"></a>
+  <a href="https://www.better-auth.com"><img src="https://img.shields.io/badge/Better_Auth-^1.0.0-6c47ff?style=flat-square" alt="Better Auth"></a>
+  <a href="https://bundlephobia.com/package/@guilhermejansen/better-auth-waitlist"><img src="https://img.shields.io/bundlephobia/minzip/@guilhermejansen/better-auth-waitlist?style=flat-square&label=bundle%20size&color=e8590c" alt="bundle size"></a>
+  <a href="https://github.com/guilhermejansen/better-auth-waitlist"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square" alt="PRs Welcome"></a>
+</p>
+
+A [Better Auth](https://www.better-auth.com) community plugin that adds **waitlist and early-access gating** to your authentication system. Intercepts all registration paths and gates sign-ups behind an invite-based waitlist.
+
+## Features
+
+- **Intercepts all registration paths** -- email/password, OAuth, magic link, OTP, phone, anonymous, one-tap, and SIWE are all gated automatically
+- **Dual-layer protection** -- hooks intercept requests before processing _and_ database hooks block user creation as a safety net
+- **Admin dashboard endpoints** -- approve, reject, bulk approve, list entries, and view statistics
+- **Invite code system** -- unique codes with configurable expiration (default 48 hours)
+- **Auto-approve mode** -- pass `true` to approve everyone, or a function for conditional logic
+- **Bulk approve** -- approve specific emails or the next N entries in the queue
+- **Referral tracking** -- track referrals and attach arbitrary JSON metadata to entries
+- **Lifecycle callbacks** -- `onJoinWaitlist`, `onApproved`, `onRejected`, and `sendInviteEmail` for email notifications
+- **Full TypeScript support** -- type-safe client and server APIs with inference
+- **Works with any Better Auth adapter** -- Prisma 5/6/7, Drizzle, MongoDB, SQLite, MySQL, PostgreSQL, and more
+- **Framework agnostic** -- Next.js 14-16, Nuxt, SvelteKit, Solid, Remix, Hono, Express, and any other framework Better Auth supports
+
+## Requirements
+
+- `better-auth` >= 1.0.0
+- Node.js >= 18 (or Bun, Deno, etc.)
+
+## Installation
+
+```bash
+npm install @guilhermejansen/better-auth-waitlist
+```
+
+```bash
+pnpm add @guilhermejansen/better-auth-waitlist
+```
+
+```bash
+bun add @guilhermejansen/better-auth-waitlist
+```
+
+```bash
+yarn add @guilhermejansen/better-auth-waitlist
+```
+
+## Quick Start
+
+### Server Setup
+
+```typescript
+import { betterAuth } from "better-auth";
+import { admin } from "better-auth/plugins/admin";
+import { waitlist } from "@guilhermejansen/better-auth-waitlist";
+
+export const auth = betterAuth({
+  // ... your config
+  plugins: [
+    admin(), // Required for admin role checking
+    waitlist({
+      requireInviteCode: true,
+      sendInviteEmail: async ({ email, inviteCode, expiresAt }) => {
+        await sendEmail({
+          to: email,
+          subject: "You're invited!",
+          body: `Use code: ${inviteCode}`,
+        });
+      },
+    }),
+  ],
+});
+```
+
+### Client Setup
+
+```typescript
+import { createAuthClient } from "better-auth/client";
+import { waitlistClient } from "@guilhermejansen/better-auth-waitlist/client";
+
+export const authClient = createAuthClient({
+  plugins: [waitlistClient()],
+});
+```
+
+## API Reference
+
+### Public Endpoints
+
+These endpoints are available without authentication.
+
+#### Join the Waitlist
+
+```typescript
+const { data, error } = await authClient.waitlist.join({
+  email: "user@example.com",
+  referredBy: "friend-id", // optional
+  metadata: { source: "landing-page" }, // optional
+});
+// data: { id, email, status, position, createdAt }
+```
+
+#### Check Waitlist Status
+
+```typescript
+const { data } = await authClient.waitlist.status({
+  email: "user@example.com",
+});
+// data: { status: "pending" | "approved" | "rejected" | "registered", position: number }
+```
+
+#### Verify Invite Code
+
+```typescript
+const { data } = await authClient.waitlist.verifyInvite({
+  inviteCode: "abc-123-def",
+});
+// data: { valid: boolean, email: string | null }
+```
+
+#### Register with Invite Code
+
+When `requireInviteCode` is enabled, pass the invite code during sign-up:
+
+```typescript
+const { data } = await authClient.signUp.email({
+  email: "user@example.com",
+  password: "securepassword",
+  name: "User",
+  inviteCode: "abc-123-def", // Required when requireInviteCode is true
+});
+```
+
+Or via header:
+
+```typescript
+const { data } = await authClient.signUp.email(
+  { email: "user@example.com", password: "securepassword", name: "User" },
+  { headers: { "x-invite-code": "abc-123-def" } },
+);
+```
+
+### Admin Endpoints
+
+All admin endpoints require an authenticated session with an admin role.
+
+#### Approve Entry
+
+```typescript
+await auth.api.approveEntry({
+  body: { email: "user@example.com" },
+});
+```
+
+#### Reject Entry
+
+```typescript
+await auth.api.rejectEntry({
+  body: { email: "user@example.com", reason: "Not qualified" },
+});
+```
+
+#### Bulk Approve
+
+```typescript
+// Approve specific emails
+await auth.api.bulkApprove({
+  body: { emails: ["a@test.com", "b@test.com"] },
+});
+
+// Approve next N entries in the queue (ordered by position)
+await auth.api.bulkApprove({
+  body: { count: 10 },
+});
+```
+
+#### List Entries
+
+```typescript
+const data = await auth.api.listWaitlist({
+  query: {
+    status: "pending", // optional: filter by status
+    page: 1,
+    limit: 20,
+    sortBy: "createdAt", // "createdAt" | "position" | "email" | "status"
+    sortDirection: "desc", // "asc" | "desc"
+  },
+});
+// data: { entries: WaitlistEntry[], total: number, page: number, totalPages: number }
+```
+
+#### Get Statistics
+
+```typescript
+const stats = await auth.api.getWaitlistStats();
+// stats: { total, pending, approved, rejected, registered }
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | `boolean` | `true` | Enable or disable the waitlist gate |
+| `requireInviteCode` | `boolean` | `false` | Require an invite code during registration |
+| `inviteCodeExpiration` | `number` | `172800` | Invite code TTL in seconds (48 hours) |
+| `maxWaitlistSize` | `number` | `undefined` | Maximum number of entries allowed on the waitlist |
+| `skipAnonymous` | `boolean` | `false` | Skip waitlist checks for anonymous sign-ins |
+| `autoApprove` | `boolean \| (email: string) => boolean \| Promise<boolean>` | `undefined` | Auto-approve entries on join. Pass `true` for all, or a function for conditional logic |
+| `interceptPaths` | `string[]` | All registration paths | Override which Better Auth paths are intercepted |
+| `adminRoles` | `string[]` | `["admin"]` | Roles that are allowed to perform admin actions |
+| `onJoinWaitlist` | `(entry: WaitlistEntry) => void \| Promise<void>` | `undefined` | Called after an entry joins the waitlist |
+| `onApproved` | `(entry: WaitlistEntry) => void \| Promise<void>` | `undefined` | Called after an entry is approved |
+| `onRejected` | `(entry: WaitlistEntry) => void \| Promise<void>` | `undefined` | Called after an entry is rejected |
+| `sendInviteEmail` | `(data: { email, inviteCode, expiresAt }) => void \| Promise<void>` | `undefined` | Called on approval to deliver the invite code |
+| `schema` | `object` | `undefined` | Customize table and field names |
+
+### Default Intercepted Paths
+
+When `interceptPaths` is not set, these registration paths are intercepted:
+
+- `/sign-up/email`
+- `/callback/` (OAuth)
+- `/oauth2/callback/` (OAuth2)
+- `/magic-link/verify`
+- `/sign-in/email-otp`
+- `/email-otp/verify-email`
+- `/phone-number/verify`
+- `/sign-in/anonymous`
+- `/one-tap/callback`
+- `/siwe/verify`
+
+## Database Schema
+
+The plugin creates a `waitlist` table with the following fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Primary key |
+| `email` | `string` | Email address (unique, indexed) |
+| `status` | `string` | `pending` / `approved` / `rejected` / `registered` |
+| `inviteCode` | `string?` | Unique invite code (generated on approval) |
+| `inviteExpiresAt` | `date?` | Invite code expiration timestamp |
+| `position` | `number?` | Queue position (assigned on join) |
+| `referredBy` | `string?` | Referral identifier |
+| `metadata` | `string?` | JSON-serialized metadata |
+| `approvedAt` | `date?` | Approval timestamp |
+| `rejectedAt` | `date?` | Rejection timestamp |
+| `registeredAt` | `date?` | Registration timestamp |
+| `createdAt` | `date` | Created timestamp |
+| `updatedAt` | `date` | Updated timestamp |
+
+## How It Works
+
+The plugin uses a dual-layer interception strategy to ensure no unapproved user can register, regardless of which authentication method they use:
+
+1. **Hooks Layer** -- `hooks.before` intercepts registration endpoints and validates waitlist status _before_ the request is processed. This catches email/password sign-ups, OTP, magic links, and any path that includes the email in the request body.
+
+2. **Database Hooks Layer** -- `databaseHooks.user.create.before` acts as a safety net, blocking user creation at the database level if the email does not have an approved waitlist entry. This catches OAuth callbacks and any other flow where the email is not available in the request body.
+
+3. **Post-Registration** -- `databaseHooks.user.create.after` automatically marks the waitlist entry as `registered` after successful sign-up, preventing the invite code from being reused.
+
+## Schema Customization
+
+You can customize the table and field names to match your existing database conventions:
+
+```typescript
+waitlist({
+  schema: {
+    waitlist: {
+      modelName: "WaitlistEntry", // Custom table name
+      fields: {
+        email: "emailAddress", // Custom field names
+      },
+    },
+  },
+});
+```
+
+## Error Codes
+
+The plugin exports `WAITLIST_ERROR_CODES` for programmatic error handling:
+
+| Code | Message |
+|------|---------|
+| `EMAIL_ALREADY_IN_WAITLIST` | This email is already on the waitlist |
+| `WAITLIST_ENTRY_NOT_FOUND` | Waitlist entry not found |
+| `NOT_APPROVED` | You must be approved from the waitlist to register |
+| `INVALID_INVITE_CODE` | Invalid or expired invite code |
+| `INVITE_CODE_REQUIRED` | An invite code is required to register |
+| `ALREADY_REGISTERED` | This waitlist entry has already been used for registration |
+| `WAITLIST_FULL` | The waitlist is currently full |
+| `UNAUTHORIZED_ADMIN_ACTION` | You are not authorized to perform this action |
+
+```typescript
+import { WAITLIST_ERROR_CODES } from "@guilhermejansen/better-auth-waitlist";
+
+if (error.message === WAITLIST_ERROR_CODES.NOT_APPROVED) {
+  // Handle not approved
+}
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how to contribute to this project.
+
+## License
+
+[MIT](./LICENSE) -- Guilherme Jansen
+
+---
+
+<p align="center">
+  <sub>Built with love for the open source community by <a href="https://github.com/guilhermejansen">Guilherme Jansen</a>.</sub>
+  <br>
+  <sub>I built this plugin because manually implementing waitlist gating for every SaaS project was a recurring pain point. Now I use it in production across all my projects, including <a href="https://insightzap.setupautomatizado.com.br">InsightZap</a>. I hope it saves you time too.</sub>
+</p>

package/dist/client.d.mts

@@ -0,0 +1,89 @@
+import { n as WaitlistClientOptions, r as WaitlistEntry } from "./error-codes-DCX2o7NB.mjs";
+import { waitlist } from "./index.mjs";
+import * as better_auth_client0 from "better-auth/client";
+import * as nanostores from "nanostores";
+
+//#region src/client.d.ts
+interface WaitlistStats {
+  total: number;
+  pending: number;
+  approved: number;
+  rejected: number;
+  registered: number;
+}
+declare const waitlistClient: (_options?: WaitlistClientOptions) => {
+  id: "waitlist";
+  $InferServerPlugin: ReturnType<typeof waitlist>;
+  getActions: ($fetch: better_auth_client0.BetterFetch) => {
+    waitlist: {
+      join: (data: {
+        email: string;
+        referredBy?: string;
+        metadata?: Record<string, unknown>;
+      }, fetchOptions?: RequestInit) => Promise<{
+        data: unknown;
+        error: null;
+      } | {
+        data: null;
+        error: {
+          message?: string | undefined;
+          status: number;
+          statusText: string;
+        };
+      }>;
+      status: (data: {
+        email: string;
+      }, fetchOptions?: RequestInit) => Promise<{
+        data: unknown;
+        error: null;
+      } | {
+        data: null;
+        error: {
+          message?: string | undefined;
+          status: number;
+          statusText: string;
+        };
+      }>;
+      verifyInvite: (data: {
+        inviteCode: string;
+      }, fetchOptions?: RequestInit) => Promise<{
+        data: unknown;
+        error: null;
+      } | {
+        data: null;
+        error: {
+          message?: string | undefined;
+          status: number;
+          statusText: string;
+        };
+      }>;
+    };
+    $Infer: {
+      WaitlistEntry: WaitlistEntry;
+    };
+  };
+  getAtoms($fetch: better_auth_client0.BetterFetch): {
+    $waitlistSignal: nanostores.PreinitializedWritableAtom<boolean> & object;
+    waitlistStats: better_auth_client0.AuthQueryAtom<WaitlistStats>;
+  };
+  pathMethods: {
+    "/waitlist/join": "POST";
+    "/waitlist/status": "GET";
+    "/waitlist/verify-invite": "POST";
+    "/waitlist/approve": "POST";
+    "/waitlist/reject": "POST";
+    "/waitlist/bulk-approve": "POST";
+    "/waitlist/list": "GET";
+    "/waitlist/stats": "GET";
+  };
+  atomListeners: ({
+    matcher(path: string): path is "/waitlist/approve" | "/waitlist/reject" | "/waitlist/bulk-approve";
+    signal: "$waitlistSignal";
+  } | {
+    matcher: (path: string) => path is "/waitlist/join";
+    signal: "$waitlistSignal";
+  })[];
+};
+//#endregion
+export { type WaitlistClientOptions, type WaitlistEntry, waitlistClient };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.mjs

@@ -0,0 +1,66 @@
+import { useAuthQuery } from "better-auth/client";
+import { atom } from "nanostores";
+
+//#region src/client.ts
+const waitlistClient = (_options) => {
+	const $waitlistSignal = atom(false);
+	return {
+		id: "waitlist",
+		$InferServerPlugin: {},
+		getActions: ($fetch) => ({
+			waitlist: {
+				join: async (data, fetchOptions) => {
+					return $fetch("/waitlist/join", {
+						method: "POST",
+						body: data,
+						...fetchOptions
+					});
+				},
+				status: async (data, fetchOptions) => {
+					return $fetch("/waitlist/status", {
+						method: "GET",
+						query: data,
+						...fetchOptions
+					});
+				},
+				verifyInvite: async (data, fetchOptions) => {
+					return $fetch("/waitlist/verify-invite", {
+						method: "POST",
+						body: data,
+						...fetchOptions
+					});
+				}
+			},
+			$Infer: {}
+		}),
+		getAtoms($fetch) {
+			return {
+				$waitlistSignal,
+				waitlistStats: useAuthQuery($waitlistSignal, "/waitlist/stats", $fetch, { method: "GET" })
+			};
+		},
+		pathMethods: {
+			"/waitlist/join": "POST",
+			"/waitlist/status": "GET",
+			"/waitlist/verify-invite": "POST",
+			"/waitlist/approve": "POST",
+			"/waitlist/reject": "POST",
+			"/waitlist/bulk-approve": "POST",
+			"/waitlist/list": "GET",
+			"/waitlist/stats": "GET"
+		},
+		atomListeners: [{
+			matcher(path) {
+				return path === "/waitlist/approve" || path === "/waitlist/reject" || path === "/waitlist/bulk-approve";
+			},
+			signal: "$waitlistSignal"
+		}, {
+			matcher: (path) => path === "/waitlist/join",
+			signal: "$waitlistSignal"
+		}]
+	};
+};
+
+//#endregion
+export { waitlistClient };
+//# 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/client\";\nimport { useAuthQuery } from \"better-auth/client\";\nimport { atom } from \"nanostores\";\nimport type { waitlist } from \"./index\";\nimport type { WaitlistClientOptions, WaitlistEntry } from \"./types\";\n\ninterface WaitlistStats {\n\ttotal: number;\n\tpending: number;\n\tapproved: number;\n\trejected: number;\n\tregistered: number;\n}\n\nexport const waitlistClient = (_options?: WaitlistClientOptions) => {\n\tconst $waitlistSignal = atom<boolean>(false);\n\n\treturn {\n\t\tid: \"waitlist\",\n\t\t$InferServerPlugin: {} as ReturnType<typeof waitlist>,\n\t\tgetActions: ($fetch) => ({\n\t\t\twaitlist: {\n\t\t\t\tjoin: async (\n\t\t\t\t\tdata: {\n\t\t\t\t\t\temail: string;\n\t\t\t\t\t\treferredBy?: string;\n\t\t\t\t\t\tmetadata?: Record<string, unknown>;\n\t\t\t\t\t},\n\t\t\t\t\tfetchOptions?: RequestInit,\n\t\t\t\t) => {\n\t\t\t\t\treturn $fetch(\"/waitlist/join\", {\n\t\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\t\tbody: data,\n\t\t\t\t\t\t...fetchOptions,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tstatus: async (data: { email: string }, fetchOptions?: RequestInit) => {\n\t\t\t\t\treturn $fetch(\"/waitlist/status\", {\n\t\t\t\t\t\tmethod: \"GET\",\n\t\t\t\t\t\tquery: data,\n\t\t\t\t\t\t...fetchOptions,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tverifyInvite: async (\n\t\t\t\t\tdata: { inviteCode: string },\n\t\t\t\t\tfetchOptions?: RequestInit,\n\t\t\t\t) => {\n\t\t\t\t\treturn $fetch(\"/waitlist/verify-invite\", {\n\t\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\t\tbody: data,\n\t\t\t\t\t\t...fetchOptions,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t},\n\t\t\t$Infer: {} as {\n\t\t\t\tWaitlistEntry: WaitlistEntry;\n\t\t\t},\n\t\t}),\n\t\tgetAtoms($fetch) {\n\t\t\tconst waitlistStats = useAuthQuery<WaitlistStats>(\n\t\t\t\t$waitlistSignal,\n\t\t\t\t\"/waitlist/stats\",\n\t\t\t\t$fetch,\n\t\t\t\t{\n\t\t\t\t\tmethod: \"GET\",\n\t\t\t\t},\n\t\t\t);\n\t\t\treturn {\n\t\t\t\t$waitlistSignal,\n\t\t\t\twaitlistStats,\n\t\t\t};\n\t\t},\n\t\tpathMethods: {\n\t\t\t\"/waitlist/join\": \"POST\",\n\t\t\t\"/waitlist/status\": \"GET\",\n\t\t\t\"/waitlist/verify-invite\": \"POST\",\n\t\t\t\"/waitlist/approve\": \"POST\",\n\t\t\t\"/waitlist/reject\": \"POST\",\n\t\t\t\"/waitlist/bulk-approve\": \"POST\",\n\t\t\t\"/waitlist/list\": \"GET\",\n\t\t\t\"/waitlist/stats\": \"GET\",\n\t\t},\n\t\tatomListeners: [\n\t\t\t{\n\t\t\t\tmatcher(path) {\n\t\t\t\t\treturn (\n\t\t\t\t\t\tpath === \"/waitlist/approve\" ||\n\t\t\t\t\t\tpath === \"/waitlist/reject\" ||\n\t\t\t\t\t\tpath === \"/waitlist/bulk-approve\"\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\tsignal: \"$waitlistSignal\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatcher: (path) => path === \"/waitlist/join\",\n\t\t\t\tsignal: \"$waitlistSignal\",\n\t\t\t},\n\t\t],\n\t} satisfies BetterAuthClientPlugin;\n};\n\nexport type { WaitlistClientOptions, WaitlistEntry } from \"./types\";\n"],"mappings":";;;;AAcA,MAAa,kBAAkB,aAAqC;CACnE,MAAM,kBAAkB,KAAc,MAAM;AAE5C,QAAO;EACN,IAAI;EACJ,oBAAoB,EAAE;EACtB,aAAa,YAAY;GACxB,UAAU;IACT,MAAM,OACL,MAKA,iBACI;AACJ,YAAO,OAAO,kBAAkB;MAC/B,QAAQ;MACR,MAAM;MACN,GAAG;MACH,CAAC;;IAEH,QAAQ,OAAO,MAAyB,iBAA+B;AACtE,YAAO,OAAO,oBAAoB;MACjC,QAAQ;MACR,OAAO;MACP,GAAG;MACH,CAAC;;IAEH,cAAc,OACb,MACA,iBACI;AACJ,YAAO,OAAO,2BAA2B;MACxC,QAAQ;MACR,MAAM;MACN,GAAG;MACH,CAAC;;IAEH;GACD,QAAQ,EAAE;GAGV;EACD,SAAS,QAAQ;AAShB,UAAO;IACN;IACA,eAVqB,aACrB,iBACA,mBACA,QACA,EACC,QAAQ,OACR,CACD;IAIA;;EAEF,aAAa;GACZ,kBAAkB;GAClB,oBAAoB;GACpB,2BAA2B;GAC3B,qBAAqB;GACrB,oBAAoB;GACpB,0BAA0B;GAC1B,kBAAkB;GAClB,mBAAmB;GACnB;EACD,eAAe,CACd;GACC,QAAQ,MAAM;AACb,WACC,SAAS,uBACT,SAAS,sBACT,SAAS;;GAGX,QAAQ;GACR,EACD;GACC,UAAU,SAAS,SAAS;GAC5B,QAAQ;GACR,CACD;EACD"}

package/dist/error-codes-DCX2o7NB.d.mts

@@ -0,0 +1,84 @@
+//#region src/types.d.ts
+type WaitlistStatus = "pending" | "approved" | "rejected" | "registered";
+interface WaitlistEntry {
+  id: string;
+  email: string;
+  status: WaitlistStatus;
+  inviteCode: string | null;
+  inviteExpiresAt: Date | null;
+  position: number | null;
+  referredBy: string | null;
+  metadata: string | null;
+  approvedAt: Date | null;
+  rejectedAt: Date | null;
+  registeredAt: Date | null;
+  createdAt: Date;
+  updatedAt: Date;
+}
+interface WaitlistOptions {
+  /** Whether the waitlist gate is active. Defaults to true. */
+  enabled?: boolean;
+  /** Require an invite code to register instead of just being approved. */
+  requireInviteCode?: boolean;
+  /** Invite code TTL in seconds. Defaults to 172800 (48 hours). */
+  inviteCodeExpiration?: number;
+  /** Maximum number of entries allowed on the waitlist. */
+  maxWaitlistSize?: number;
+  /** Skip waitlist checks for anonymous sign-ins. Defaults to false. */
+  skipAnonymous?: boolean;
+  /**
+   * Automatically approve entries when they join.
+   * Pass `true` to auto-approve all, or a function for conditional logic.
+   */
+  autoApprove?: boolean | ((email: string) => boolean | Promise<boolean>);
+  /**
+   * List of Better Auth paths to intercept. Defaults to all registration paths.
+   */
+  interceptPaths?: string[];
+  /**
+   * Roles that are allowed to perform admin actions.
+   * Defaults to ["admin"].
+   */
+  adminRoles?: string[];
+  /** Called after an entry joins the waitlist. */
+  onJoinWaitlist?: (entry: WaitlistEntry) => void | Promise<void>;
+  /** Called after an entry is approved. */
+  onApproved?: (entry: WaitlistEntry) => void | Promise<void>;
+  /** Called after an entry is rejected. */
+  onRejected?: (entry: WaitlistEntry) => void | Promise<void>;
+  /**
+   * Called when an entry is approved to send the invite email.
+   * You must implement this to deliver invite codes to users.
+   */
+  sendInviteEmail?: (data: {
+    email: string;
+    inviteCode: string;
+    expiresAt: Date;
+  }) => void | Promise<void>;
+  /** Customise table and field names for the waitlist schema. */
+  schema?: {
+    waitlist?: {
+      modelName?: string;
+      fields?: Record<string, string>;
+    };
+  };
+}
+interface WaitlistClientOptions {
+  /** Base URL override for waitlist API calls. */
+  baseURL?: string;
+}
+//#endregion
+//#region src/error-codes.d.ts
+declare const WAITLIST_ERROR_CODES: {
+  readonly EMAIL_ALREADY_IN_WAITLIST: "This email is already on the waitlist";
+  readonly WAITLIST_ENTRY_NOT_FOUND: "Waitlist entry not found";
+  readonly NOT_APPROVED: "You must be approved from the waitlist to register";
+  readonly INVALID_INVITE_CODE: "Invalid or expired invite code";
+  readonly INVITE_CODE_REQUIRED: "An invite code is required to register";
+  readonly ALREADY_REGISTERED: "This waitlist entry has already been used for registration";
+  readonly WAITLIST_FULL: "The waitlist is currently full";
+  readonly UNAUTHORIZED_ADMIN_ACTION: "You are not authorized to perform this action";
+};
+//#endregion
+export { WaitlistStatus as a, WaitlistOptions as i, WaitlistClientOptions as n, WaitlistEntry as r, WAITLIST_ERROR_CODES as t };
+//# sourceMappingURL=error-codes-DCX2o7NB.d.mts.map