@delmaredigital/payload-better-auth 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+export { PayloadAdapterConfig, payloadAdapter } from './adapter/index.js';
+import { CollectionConfig, Plugin, BasePayload } from 'payload';
+import { BetterAuthOptions } from 'better-auth';
+export { Auth, BetterAuthPluginOptions, BetterAuthStrategyOptions, CreateAuthFunction, PayloadWithAuth, betterAuthStrategy, createBetterAuthPlugin, resetAuthInstance } from './plugin/index.js';
+
+/**
+ * Auto-generate Payload collections from Better Auth schema
+ *
+ * @packageDocumentation
+ */
+
+type BetterAuthCollectionsOptions = {
+    /**
+     * Better Auth options. Pass the same options you use for betterAuth().
+     * The plugin reads the schema to generate collections.
+     */
+    betterAuthOptions?: BetterAuthOptions;
+    /**
+     * Override collection slugs (e.g., { user: 'users', session: 'sessions' })
+     */
+    slugOverrides?: Record<string, string>;
+    /**
+     * Collections to skip (they already exist in your config)
+     * Default: ['user'] - assumes you have a Users collection
+     */
+    skipCollections?: string[];
+    /**
+     * Admin group name for generated collections
+     * Default: 'Auth'
+     */
+    adminGroup?: string;
+    /**
+     * Custom access control for generated collections.
+     * By default, only admins can read/delete, and create/update are disabled.
+     */
+    access?: CollectionConfig['access'];
+};
+/**
+ * Payload plugin that auto-generates collections from Better Auth schema.
+ *
+ * @example
+ * ```ts
+ * import { betterAuthCollections } from '@delmare/payload-better-auth'
+ *
+ * export default buildConfig({
+ *   plugins: [
+ *     betterAuthCollections({
+ *       betterAuthOptions: { ... },
+ *       skipCollections: ['user'], // Define Users yourself
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare function betterAuthCollections(options?: BetterAuthCollectionsOptions): Plugin;
+
+/**
+ * Server-side session utilities
+ *
+ * @packageDocumentation
+ */
+
+type Session = {
+    user: {
+        id: string;
+        email: string;
+        name?: string;
+        image?: string;
+        [key: string]: unknown;
+    };
+    session: {
+        id: string;
+        expiresAt: Date;
+        [key: string]: unknown;
+    };
+};
+/**
+ * Get the current session from headers.
+ *
+ * @example
+ * ```ts
+ * import { headers } from 'next/headers'
+ * import { getServerSession } from '@delmare/payload-better-auth'
+ *
+ * export default async function Page() {
+ *   const headersList = await headers()
+ *   const session = await getServerSession(payload, headersList)
+ *
+ *   if (!session) {
+ *     redirect('/login')
+ *   }
+ *
+ *   return <div>Hello {session.user.name}</div>
+ * }
+ * ```
+ */
+declare function getServerSession(payload: BasePayload, headers: Headers): Promise<Session | null>;
+/**
+ * Get the current user from the session.
+ *
+ * @example
+ * ```ts
+ * import { headers } from 'next/headers'
+ * import { getServerUser } from '@delmare/payload-better-auth'
+ *
+ * export default async function Page() {
+ *   const headersList = await headers()
+ *   const user = await getServerUser(payload, headersList)
+ *
+ *   if (!user) {
+ *     redirect('/login')
+ *   }
+ *
+ *   return <div>Hello {user.name}</div>
+ * }
+ * ```
+ */
+declare function getServerUser(payload: BasePayload, headers: Headers): Promise<Session['user'] | null>;
+
+export { type BetterAuthCollectionsOptions, type Session, betterAuthCollections, getServerSession, getServerUser };