@revealui/auth 0.0.1-pre.0

package/dist/better-auth/plugin/types.d.ts

@@ -0,0 +1,429 @@
+import type { UnionToIntersection, betterAuth } from 'better-auth';
+import type { DBFieldAttribute } from 'better-auth/db';
+import type { BetterAuthOptions as BetterAuthOptionsType, BetterAuthPlugin as BetterAuthPluginType, InferAPI, InferPluginTypes } from 'better-auth/types';
+import type { BasePayload, CollectionConfig, Config, Endpoint, Field, Payload, PayloadRequest } from 'payload';
+import type { ModelKey } from '../generated-types';
+import { adminRoutes, baPluginSlugs, loginMethods, socialProviders } from './constants';
+/**
+ * BetterAuth options with the following caveats:
+ * - The `database` option is removed as it is configured internally
+ * - The `user` `modelName` and `fields` is removed as it is configured internally
+ * - The `account` `modelName` and `fields` is removed as it is configured internally
+ * - The `session` `modelName` and `fields` is removed as it is configured internally
+ * - The `verification` `modelName` and `fields` is removed as it is configured internally
+ *
+ * @see https://www.better-auth.com/docs/reference/options
+ */
+export interface BetterAuthOptions extends Omit<BetterAuthOptionsType, 'database' | 'user' | 'account' | 'verification' | 'session' | 'advanced'> {
+    user?: Omit<NonNullable<BetterAuthOptionsType['user']>, 'modelName' | 'fields'> | undefined;
+    account?: Omit<NonNullable<BetterAuthOptionsType['account']>, 'modelName' | 'fields'> | undefined;
+    session?: Omit<NonNullable<BetterAuthOptionsType['session']>, 'modelName' | 'fields'> | undefined;
+    verification?: Omit<NonNullable<BetterAuthOptionsType['verification']>, 'modelName' | 'fields'> | undefined;
+    advanced?: Omit<NonNullable<BetterAuthOptionsType['advanced']>, 'generateId'> | undefined;
+}
+export interface SanitizedBetterAuthOptions extends Omit<BetterAuthOptionsType, 'database'> {
+}
+export type SocialProvider = (typeof socialProviders)[number];
+export type LoginMethod = (typeof loginMethods)[number];
+type PluginCollectionOverrides = {
+    [K in keyof typeof baPluginSlugs]?: (options: {
+        collection: CollectionConfig;
+    }) => CollectionConfig;
+};
+export interface BetterAuthPluginOptions {
+    /**
+     * Disable the plugin
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Disable the default payload auth
+     *
+     * This will ensure that better-auth handles both admin and frontend auth
+     *
+     * Admin will make use of custom admin routes for auth and give you more control
+     *
+     * Note: This will override the option passed in the users collection config
+     *
+     * Read about this more in the docs
+     * @see https://www.payloadauth.com/docs/better-auth#disable-default-payload-auth
+     *
+     * @default false
+     */
+    disableDefaultPayloadAuth?: boolean;
+    /**
+     * Custom admin components when disableDefaultPayloadAuth is true
+     *
+     * These components will be used to render the login, create first admin, and other auth-related views
+     */
+    admin?: {
+        /**
+         * Override which social buttons are shown in the Payload Login / Sign Up view.
+         *
+         * Provide an array of LoginMethod keys.
+         */
+        loginMethods?: LoginMethod[];
+    };
+    /**
+     * Debug options
+     */
+    debug?: {
+        /**
+         * Enable debug logs
+         * @default false
+         */
+        enableDebugLogs?: boolean;
+        /**
+         * Log the tables that are needed for better-auth on init
+         * @default false
+         */
+        logTables?: boolean;
+    };
+    /**
+     * Hide the better-authplugin collections from the payload admin UI
+     * @default false
+     */
+    hidePluginCollections?: boolean;
+    /**
+     * Defines the admin group for collections.
+     * @default "Auth"
+     */
+    collectionAdminGroup?: string;
+    /**
+     * Require a valid admin invitation for any *public* sign‑up.
+     *
+     * – Applies to both email/password and social‑provider flows.
+     * – Existing users can still sign in; admins can still create users via
+     *   the Payload UI or server‑side calls.
+     * – Ignores provider‑level `disableImplicitSignUp` and `disableSignUp`:
+     *   with a valid invite the sign‑up proceeds, without one it's blocked.
+     * – Also sets `disableImplicitSignUp` for all providers, requiring `requestSignUp` to be true for all `authClient.signIn.social` calls when creating a new account with a provider.
+     *
+     * Enable when you want OAuth for internal/admin use only and no public
+     * registrations at all.
+     *
+     * @default false
+     */
+    requireAdminInviteForSignUp?: boolean;
+    /**
+     * BetterAuth options with the following caveats:
+     * - The `database` option is removed as it is configured internally
+     * - The `user` `modelName` and `fields` is removed as it is configured internally
+     * - The `account` `modelName` and `fields` is removed as it is configured internally
+     * - The `session` `modelName` and `fields` is removed as it is configured internally
+     * - The `verification` `modelName` and `fields` is removed as it is configured internally
+     *
+     * @see https://www.better-auth.com/docs/reference/options
+     */
+    betterAuthOptions?: BetterAuthOptions;
+    /**
+     * Override plugin configurations
+     *
+     * Note: TypeScript cannot enforce that only enabled plugins are configured
+     * at compile time, but this will be validated at runtime.
+     */
+    pluginCollectionOverrides?: PluginCollectionOverrides;
+    /**
+     * Configure the Users collections:
+     */
+    users?: {
+        /**
+         * Will set the `modelName` for the `user` table in better-auth
+         *
+         * and the `slug` for the `users` collection in payload
+         *
+         * @default 'users'
+         */
+        slug?: string | undefined;
+        /**
+         * The default role for users
+         *
+         * This will be used as the default role for the role field in the users collection
+         *
+         * If you define this you must also have this role in the roles array
+         *
+         * This will also be used as the defaultRole option in the better-auth admin plugin if present
+         * @see https://www.better-auth.com/docs/plugins/admin#default-role
+         * @default "user"
+         */
+        defaultRole?: string;
+        /**
+         * The default role for admins
+         *
+         * This will be used as the default role for when admins sign up in the create first admin view or when inviting new admins
+         *
+         *
+         * @default "admin"
+         */
+        defaultAdminRole?: string;
+        /**
+         * All roles for the users collection
+         *
+         * These will be used to define all the options in the user collection role field
+         *
+         * Will be merged with the adminRoles array, no need to worry about redefining in adminRoles or duplicates
+         *
+         * This should match the roles in the better-auth admin plugin if you are using it
+         * @see https://www.better-auth.com/docs/plugins/admin#access-control
+         *
+         * @default ["user"]
+         */
+        roles?: string[];
+        /**
+         * Define admin roles for the users collection
+         *
+         * These roles will be given admin access to all auth collections created by this plugin
+         *
+         * Note: Will be merged with the roles array, no need to worry about redefining in roles or duplicates
+         *
+         * Will be also used as the adminRoles option in the better-auth admin plugin if present
+         *
+         * @see https://www.better-auth.com/docs/plugins/admin#admin-roles
+         *
+         * @default ["admin"]
+         */
+        adminRoles?: string[];
+        /**
+         * Hide the `users` collection from the payload admin UI
+         *
+         * This will be overwritten if you change the value in the collection overrides option
+         */
+        hidden?: boolean | undefined;
+        /**
+         * Define which fields users can update themselves
+         *
+         * Password field is automatically included and doesn't need to be specified here
+         *
+         * @example ['name', 'dateOfBirth', 'phoneNumber']
+         * @default ['name']
+         */
+        allowedFields?: string[] | undefined;
+        /**
+         * Function to override the collection configuration
+         *
+         * This allows modifying the collection config after it has been built
+         * Example use cases include adding saveToJwt to specific fields or
+         * modifying field descriptions
+         *
+         * @param options Object containing the collection config and potentially additional parameters
+         * @returns Modified collection config
+         */
+        collectionOverrides?: (options: {
+            collection: CollectionConfig;
+        }) => CollectionConfig;
+        /**
+         * This will block the first on sign up verification email from better-auth.
+         * If you are using Payload's userCollection.verify option, you will want to set this to true.
+         * Function that will be blocked: options.emailVerificationsendVerificationEmail
+         * @default false
+         */
+        blockFirstBetterAuthVerificationEmail?: boolean;
+    };
+    /**
+     * Configure the Accounts collections:
+     */
+    accounts?: {
+        /**
+         * Will set the `modelName` for the `account` table in better-auth
+         *
+         * and the `slug` for the `accounts` collection in payload
+         *
+         * @default 'accounts'
+         */
+        slug?: string | undefined;
+        /**
+         * Hide the `accounts` collection from the payload admin UI
+         */
+        hidden?: boolean | undefined;
+        /**
+         * Function to override the collection configuration
+         *
+         * This allows modifying the collection config after it has been built
+         *
+         * @param options Object containing the collection config and potentially additional parameters
+         * @returns Modified collection config
+         */
+        collectionOverrides?: (options: {
+            collection: CollectionConfig;
+        }) => CollectionConfig;
+    };
+    /**
+     * Configure the Sessions collections:
+     */
+    sessions?: {
+        /**
+         * Will set the `modelName` for the `session` table in better-auth
+         *
+         * and the `slug` for the `sessions` collection in payload
+         *
+         * @default 'sessions'
+         */
+        slug?: string | undefined;
+        /**
+         * Hide the `sessions` collection from the payload admin UI
+         */
+        hidden?: boolean | undefined;
+        /**
+         * Function to override the collection configuration
+         *
+         * This allows modifying the collection config after it has been built
+         *
+         * @param options Object containing the collection config and potentially additional parameters
+         * @returns Modified collection config
+         */
+        collectionOverrides?: (options: {
+            collection: CollectionConfig;
+        }) => CollectionConfig;
+    };
+    /**
+     * Configure the Verifications collections:
+     */
+    verifications?: {
+        /**
+         * Will set the `modelName` for the `verification` table in better-auth
+         *
+         * and the `slug` for the `verifications` collection in payload
+         *
+         * @default 'verifications'
+         */
+        slug?: string | undefined;
+        /**
+         * Hide the `verifications` collection from the payload admin UI
+         */
+        hidden?: boolean | undefined;
+        /**
+         * Function to override the collection configuration
+         *
+         * This allows modifying the collection config after it has been built
+         *
+         * @param options Object containing the collection config and potentially additional parameters
+         * @returns Modified collection config
+         */
+        collectionOverrides?: (options: {
+            collection: CollectionConfig;
+        }) => CollectionConfig;
+    };
+    /**
+     * Configure the Admin Invitations collections:
+     */
+    adminInvitations?: {
+        /**
+         * Will set the `slug` for the `admin-invitations` collection in payload
+         *
+         * @default 'admin-invitations'
+         */
+        slug?: string | undefined;
+        /**
+         * Hide the `admin-invitations` collection from the payload admin UI
+         */
+        hidden?: boolean | undefined;
+        /**
+         * This will be used to generate the admin invite url
+         *
+         * @param options Object containing payload and the token
+         * @returns The admin invite url
+         */
+        generateInviteUrl?: GenerateAdminInviteUrlFn;
+        /**
+         * This will be used to send the admin invite email
+         *
+         * @param options Object containing payload, email and the url
+         * @returns The admin invite url
+         */
+        sendInviteEmail?: SendAdminInviteEmailFn;
+        /**
+         * Function to override the collection configuration
+         *
+         * This allows modifying the collection config after it has been built
+         *
+         * @param options Object containing the collection config and potentially additional parameters
+         * @returns Modified collection config
+         */
+        collectionOverrides?: (options: {
+            collection: CollectionConfig;
+        }) => CollectionConfig;
+    };
+}
+export type SendAdminInviteEmailFn = (options: {
+    payload: Payload;
+    email: string;
+    url: string;
+}) => Promise<{
+    success: true;
+    message?: string;
+} | {
+    success: false;
+    message: string;
+}>;
+export type GenerateAdminInviteUrlFn = (options: {
+    payload: Payload;
+    token: string;
+}) => string;
+export type ConfigAdminCustom = {
+    betterAuth: {
+        adminRoutes: {
+            [key in keyof typeof adminRoutes]: string;
+        };
+    };
+};
+export interface BetterAuthPlugin {
+    (config: Config): Config;
+    pluginOptions: BetterAuthPluginOptions;
+}
+export interface PayloadRequestWithBetterAuth<TPlugins extends BetterAuthPluginType[] = []> extends PayloadRequest {
+    payload: BasePayload & {
+        betterAuth: BetterAuthReturn<TPlugins>;
+    };
+}
+export type CollectionHookWithBetterAuth<T extends (args: any) => any> = T extends (args: infer A) => infer R ? (args: Omit<A, 'req'> & {
+    req: PayloadRequestWithBetterAuth;
+}) => R : never;
+export type EndpointWithBetterAuth = Omit<Endpoint, 'handler'> & {
+    handler: (req: PayloadRequestWithBetterAuth) => Promise<Response> | Response;
+};
+export type ExtractEndpoints<T> = T extends BetterAuthPlugin ? T extends {
+    endpoints?: infer E;
+} ? E : Record<string, never> : Record<string, never>;
+export type TPlugins<TPlugins extends BetterAuthPluginType[] = BetterAuthPluginType[]> = TPlugins;
+export type PluginInferTypes<T extends TPlugins> = {
+    [K in keyof InferPluginTypes<{
+        plugins: T;
+    }>]: InferPluginTypes<{
+        plugins: T;
+    }>[K];
+};
+export type BetterAuthReturn<T extends TPlugins> = Omit<ReturnType<typeof betterAuth>, '$Infer'> & {
+    api: T extends (infer P)[] ? InferAPI<UnionToIntersection<ExtractEndpoints<P>>> : Record<string, never>;
+    $Infer: ReturnType<typeof betterAuth>['$Infer'] & PluginInferTypes<T>;
+};
+export type BetterAuthFunctionOptions<P extends TPlugins> = Omit<BetterAuthOptions, 'database' | 'plugins'> & {
+    enableDebugLogs?: boolean;
+    plugins: P;
+};
+export interface BuiltBetterAuthSchema {
+    modelName: string;
+    fields: Record<string, DBFieldAttribute>;
+    order: number;
+}
+export type BetterAuthSchemas = Record<ModelKey, BuiltBetterAuthSchema>;
+export interface BuildCollectionProps {
+    resolvedSchemas: BetterAuthSchemas;
+    pluginOptions: BetterAuthPluginOptions;
+    incomingCollections: CollectionConfig[];
+}
+export type FieldOverrides<K extends string = string> = {
+    [Key in K]?: (field: DBFieldAttribute) => Partial<Field>;
+} & {
+    [key: string]: (field: DBFieldAttribute) => Partial<Field>;
+};
+export type FieldWithIds = {
+    name?: string;
+    custom?: {
+        betterAuthFieldKey?: string;
+    };
+};
+export type FieldRule = {
+    condition?: (field: DBFieldAttribute) => boolean;
+    transform: (field: DBFieldAttribute) => Record<string, unknown>;
+};
+export {};

package/dist/better-auth/plugin/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/better-auth/plugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/better-auth/plugin/types.ts"],"sourcesContent":["import type { UnionToIntersection, betterAuth } from 'better-auth';\nimport type { DBFieldAttribute } from 'better-auth/db';\nimport type {\n  BetterAuthOptions as BetterAuthOptionsType,\n  BetterAuthPlugin as BetterAuthPluginType,\n  InferAPI,\n  InferPluginTypes,\n} from 'better-auth/types';\nimport type {\n  BasePayload,\n  CollectionConfig,\n  Config,\n  Endpoint,\n  Field,\n  Payload,\n  PayloadRequest,\n} from 'payload';\nimport type { ModelKey } from '../generated-types';\nimport { adminRoutes, baPluginSlugs, loginMethods, socialProviders } from './constants';\n\n/**\n * BetterAuth options with the following caveats:\n * - The `database` option is removed as it is configured internally\n * - The `user` `modelName` and `fields` is removed as it is configured internally\n * - The `account` `modelName` and `fields` is removed as it is configured internally\n * - The `session` `modelName` and `fields` is removed as it is configured internally\n * - The `verification` `modelName` and `fields` is removed as it is configured internally\n *\n * @see https://www.better-auth.com/docs/reference/options\n */\nexport interface BetterAuthOptions\n  extends Omit<\n    BetterAuthOptionsType,\n    'database' | 'user' | 'account' | 'verification' | 'session' | 'advanced'\n  > {\n  user?: Omit<NonNullable<BetterAuthOptionsType['user']>, 'modelName' | 'fields'> | undefined;\n  account?: Omit<NonNullable<BetterAuthOptionsType['account']>, 'modelName' | 'fields'> | undefined;\n  session?: Omit<NonNullable<BetterAuthOptionsType['session']>, 'modelName' | 'fields'> | undefined;\n  verification?:\n    | Omit<NonNullable<BetterAuthOptionsType['verification']>, 'modelName' | 'fields'>\n    | undefined;\n  advanced?: Omit<NonNullable<BetterAuthOptionsType['advanced']>, 'generateId'> | undefined;\n}\n\nexport interface SanitizedBetterAuthOptions extends Omit<BetterAuthOptionsType, 'database'> {}\n\nexport type SocialProvider = (typeof socialProviders)[number];\n\nexport type LoginMethod = (typeof loginMethods)[number];\n\ntype PluginCollectionOverrides = {\n  [K in keyof typeof baPluginSlugs]?: (options: {\n    collection: CollectionConfig;\n  }) => CollectionConfig;\n};\n\nexport interface BetterAuthPluginOptions {\n  /**\n   * Disable the plugin\n   * @default false\n   */\n  disabled?: boolean;\n  /**\n   * Disable the default payload auth\n   *\n   * This will ensure that better-auth handles both admin and frontend auth\n   *\n   * Admin will make use of custom admin routes for auth and give you more control\n   *\n   * Note: This will override the option passed in the users collection config\n   *\n   * Read about this more in the docs\n   * @see https://www.payloadauth.com/docs/better-auth#disable-default-payload-auth\n   *\n   * @default false\n   */\n  disableDefaultPayloadAuth?: boolean;\n  /**\n   * Custom admin components when disableDefaultPayloadAuth is true\n   *\n   * These components will be used to render the login, create first admin, and other auth-related views\n   */\n  admin?: {\n    /**\n     * Override which social buttons are shown in the Payload Login / Sign Up view.\n     *\n     * Provide an array of LoginMethod keys.\n     */\n    loginMethods?: LoginMethod[];\n  };\n  /**\n   * Debug options\n   */\n  debug?: {\n    /**\n     * Enable debug logs\n     * @default false\n     */\n    enableDebugLogs?: boolean;\n    /**\n     * Log the tables that are needed for better-auth on init\n     * @default false\n     */\n    logTables?: boolean;\n  };\n  /**\n   * Hide the better-authplugin collections from the payload admin UI\n   * @default false\n   */\n  hidePluginCollections?: boolean;\n  /**\n   * Defines the admin group for collections.\n   * @default \"Auth\"\n   */\n  collectionAdminGroup?: string;\n  /**\n   * Require a valid admin invitation for any *public* sign‑up.\n   *\n   * – Applies to both email/password and social‑provider flows.\n   * – Existing users can still sign in; admins can still create users via\n   *   the Payload UI or server‑side calls.\n   * – Ignores provider‑level `disableImplicitSignUp` and `disableSignUp`:\n   *   with a valid invite the sign‑up proceeds, without one it's blocked.\n   * – Also sets `disableImplicitSignUp` for all providers, requiring `requestSignUp` to be true for all `authClient.signIn.social` calls when creating a new account with a provider.\n   *\n   * Enable when you want OAuth for internal/admin use only and no public\n   * registrations at all.\n   *\n   * @default false\n   */\n  requireAdminInviteForSignUp?: boolean;\n  /**\n   * BetterAuth options with the following caveats:\n   * - The `database` option is removed as it is configured internally\n   * - The `user` `modelName` and `fields` is removed as it is configured internally\n   * - The `account` `modelName` and `fields` is removed as it is configured internally\n   * - The `session` `modelName` and `fields` is removed as it is configured internally\n   * - The `verification` `modelName` and `fields` is removed as it is configured internally\n   *\n   * @see https://www.better-auth.com/docs/reference/options\n   */\n  betterAuthOptions?: BetterAuthOptions;\n  /**\n   * Override plugin configurations\n   *\n   * Note: TypeScript cannot enforce that only enabled plugins are configured\n   * at compile time, but this will be validated at runtime.\n   */\n  pluginCollectionOverrides?: PluginCollectionOverrides;\n  /**\n   * Configure the Users collections:\n   */\n  users?: {\n    /**\n     * Will set the `modelName` for the `user` table in better-auth\n     *\n     * and the `slug` for the `users` collection in payload\n     *\n     * @default 'users'\n     */\n    slug?: string | undefined;\n    /**\n     * The default role for users\n     *\n     * This will be used as the default role for the role field in the users collection\n     *\n     * If you define this you must also have this role in the roles array\n     *\n     * This will also be used as the defaultRole option in the better-auth admin plugin if present\n     * @see https://www.better-auth.com/docs/plugins/admin#default-role\n     * @default \"user\"\n     */\n    defaultRole?: string;\n    /**\n     * The default role for admins\n     *\n     * This will be used as the default role for when admins sign up in the create first admin view or when inviting new admins\n     *\n     *\n     * @default \"admin\"\n     */\n    defaultAdminRole?: string;\n    /**\n     * All roles for the users collection\n     *\n     * These will be used to define all the options in the user collection role field\n     *\n     * Will be merged with the adminRoles array, no need to worry about redefining in adminRoles or duplicates\n     *\n     * This should match the roles in the better-auth admin plugin if you are using it\n     * @see https://www.better-auth.com/docs/plugins/admin#access-control\n     *\n     * @default [\"user\"]\n     */\n    roles?: string[];\n    /**\n     * Define admin roles for the users collection\n     *\n     * These roles will be given admin access to all auth collections created by this plugin\n     *\n     * Note: Will be merged with the roles array, no need to worry about redefining in roles or duplicates\n     *\n     * Will be also used as the adminRoles option in the better-auth admin plugin if present\n     *\n     * @see https://www.better-auth.com/docs/plugins/admin#admin-roles\n     *\n     * @default [\"admin\"]\n     */\n    adminRoles?: string[];\n    /**\n     * Hide the `users` collection from the payload admin UI\n     *\n     * This will be overwritten if you change the value in the collection overrides option\n     */\n    hidden?: boolean | undefined;\n    /**\n     * Define which fields users can update themselves\n     *\n     * Password field is automatically included and doesn't need to be specified here\n     *\n     * @example ['name', 'dateOfBirth', 'phoneNumber']\n     * @default ['name']\n     */\n    allowedFields?: string[] | undefined;\n    /**\n     * Function to override the collection configuration\n     *\n     * This allows modifying the collection config after it has been built\n     * Example use cases include adding saveToJwt to specific fields or\n     * modifying field descriptions\n     *\n     * @param options Object containing the collection config and potentially additional parameters\n     * @returns Modified collection config\n     */\n    collectionOverrides?: (options: { collection: CollectionConfig }) => CollectionConfig;\n    /**\n     * This will block the first on sign up verification email from better-auth.\n     * If you are using Payload's userCollection.verify option, you will want to set this to true.\n     * Function that will be blocked: options.emailVerificationsendVerificationEmail\n     * @default false\n     */\n    blockFirstBetterAuthVerificationEmail?: boolean;\n  };\n  /**\n   * Configure the Accounts collections:\n   */\n  accounts?: {\n    /**\n     * Will set the `modelName` for the `account` table in better-auth\n     *\n     * and the `slug` for the `accounts` collection in payload\n     *\n     * @default 'accounts'\n     */\n    slug?: string | undefined;\n    /**\n     * Hide the `accounts` collection from the payload admin UI\n     */\n    hidden?: boolean | undefined;\n    /**\n     * Function to override the collection configuration\n     *\n     * This allows modifying the collection config after it has been built\n     *\n     * @param options Object containing the collection config and potentially additional parameters\n     * @returns Modified collection config\n     */\n    collectionOverrides?: (options: { collection: CollectionConfig }) => CollectionConfig;\n  };\n  /**\n   * Configure the Sessions collections:\n   */\n  sessions?: {\n    /**\n     * Will set the `modelName` for the `session` table in better-auth\n     *\n     * and the `slug` for the `sessions` collection in payload\n     *\n     * @default 'sessions'\n     */\n    slug?: string | undefined;\n    /**\n     * Hide the `sessions` collection from the payload admin UI\n     */\n    hidden?: boolean | undefined;\n    /**\n     * Function to override the collection configuration\n     *\n     * This allows modifying the collection config after it has been built\n     *\n     * @param options Object containing the collection config and potentially additional parameters\n     * @returns Modified collection config\n     */\n    collectionOverrides?: (options: { collection: CollectionConfig }) => CollectionConfig;\n  };\n  /**\n   * Configure the Verifications collections:\n   */\n  verifications?: {\n    /**\n     * Will set the `modelName` for the `verification` table in better-auth\n     *\n     * and the `slug` for the `verifications` collection in payload\n     *\n     * @default 'verifications'\n     */\n    slug?: string | undefined;\n    /**\n     * Hide the `verifications` collection from the payload admin UI\n     */\n    hidden?: boolean | undefined;\n    /**\n     * Function to override the collection configuration\n     *\n     * This allows modifying the collection config after it has been built\n     *\n     * @param options Object containing the collection config and potentially additional parameters\n     * @returns Modified collection config\n     */\n    collectionOverrides?: (options: { collection: CollectionConfig }) => CollectionConfig;\n  };\n  /**\n   * Configure the Admin Invitations collections:\n   */\n  adminInvitations?: {\n    /**\n     * Will set the `slug` for the `admin-invitations` collection in payload\n     *\n     * @default 'admin-invitations'\n     */\n    slug?: string | undefined;\n    /**\n     * Hide the `admin-invitations` collection from the payload admin UI\n     */\n    hidden?: boolean | undefined;\n    /**\n     * This will be used to generate the admin invite url\n     *\n     * @param options Object containing payload and the token\n     * @returns The admin invite url\n     */\n    generateInviteUrl?: GenerateAdminInviteUrlFn;\n    /**\n     * This will be used to send the admin invite email\n     *\n     * @param options Object containing payload, email and the url\n     * @returns The admin invite url\n     */\n    sendInviteEmail?: SendAdminInviteEmailFn;\n    /**\n     * Function to override the collection configuration\n     *\n     * This allows modifying the collection config after it has been built\n     *\n     * @param options Object containing the collection config and potentially additional parameters\n     * @returns Modified collection config\n     */\n    collectionOverrides?: (options: { collection: CollectionConfig }) => CollectionConfig;\n  };\n}\n\nexport type SendAdminInviteEmailFn = (options: {\n  payload: Payload;\n  email: string;\n  url: string;\n}) => Promise<{ success: true; message?: string } | { success: false; message: string }>;\n\nexport type GenerateAdminInviteUrlFn = (options: { payload: Payload; token: string }) => string;\n\nexport type ConfigAdminCustom = {\n  betterAuth: {\n    adminRoutes: {\n      [key in keyof typeof adminRoutes]: string;\n    };\n  };\n};\n\nexport interface BetterAuthPlugin {\n  (config: Config): Config;\n  pluginOptions: BetterAuthPluginOptions;\n}\n\nexport interface PayloadRequestWithBetterAuth<TPlugins extends BetterAuthPluginType[] = []>\n  extends PayloadRequest {\n  payload: BasePayload & {\n    betterAuth: BetterAuthReturn<TPlugins>;\n  };\n}\n\nexport type CollectionHookWithBetterAuth<T extends (args: any) => any> = T extends (\n  args: infer A\n) => infer R\n  ? (args: Omit<A, 'req'> & { req: PayloadRequestWithBetterAuth }) => R\n  : never;\n\nexport type EndpointWithBetterAuth = Omit<Endpoint, 'handler'> & {\n  handler: (req: PayloadRequestWithBetterAuth) => Promise<Response> | Response;\n};\n\nexport type ExtractEndpoints<T> = T extends BetterAuthPlugin\n  ? T extends { endpoints?: infer E }\n    ? E\n    : Record<string, never>\n  : Record<string, never>;\n\nexport type TPlugins<TPlugins extends BetterAuthPluginType[] = BetterAuthPluginType[]> = TPlugins;\n\nexport type PluginInferTypes<T extends TPlugins> = {\n  [K in keyof InferPluginTypes<{ plugins: T }>]: InferPluginTypes<{\n    plugins: T;\n  }>[K];\n};\n\nexport type BetterAuthReturn<T extends TPlugins> = Omit<ReturnType<typeof betterAuth>, '$Infer'> & {\n  api: T extends (infer P)[] ? InferAPI<UnionToIntersection<ExtractEndpoints<P>>> : Record<string, never>;\n  $Infer: ReturnType<typeof betterAuth>['$Infer'] & PluginInferTypes<T>;\n};\n\nexport type BetterAuthFunctionOptions<P extends TPlugins> = Omit<\n  BetterAuthOptions,\n  'database' | 'plugins'\n> & {\n  enableDebugLogs?: boolean;\n  plugins: P;\n};\n\nexport interface BuiltBetterAuthSchema {\n  modelName: string;\n  fields: Record<string, DBFieldAttribute>;\n  order: number;\n}\n\nexport type BetterAuthSchemas = Record<ModelKey, BuiltBetterAuthSchema>;\n\nexport interface BuildCollectionProps {\n  resolvedSchemas: BetterAuthSchemas;\n  pluginOptions: BetterAuthPluginOptions;\n  incomingCollections: CollectionConfig[];\n}\n\nexport type FieldOverrides<K extends string = string> = {\n  [Key in K]?: (field: DBFieldAttribute) => Partial<Field>;\n} & {\n  [key: string]: (field: DBFieldAttribute) => Partial<Field>;\n};\n\nexport type FieldWithIds = { name?: string; custom?: { betterAuthFieldKey?: string } };\n\nexport type FieldRule = {\n  condition?: (field: DBFieldAttribute) => boolean;\n  transform: (field: DBFieldAttribute) => Record<string, unknown>;\n};\n"],"names":[],"mappings":"AAgcA,WAGE"}

package/dist/better-auth/plugin/utils/set.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Deep-sets a value on an object using a dotted-path string.
+ *
+ * **Path syntax**
+ * ──────────────────────────────────────────────────────────
+ *   token        action
+ *   ------------ ------------------------------------------
+ *   `foo.bar`    create/read plain nested objects
+ *   `foo.bar[]`  *append* `value` to array `foo.bar`
+ *   `foo.[]bar`  *prepend* `value` to array `foo.bar`
+ *   `foo.bar[2]` replace item `2` of `foo.bar`, creating
+ *                empty slots if the index is out of bounds
+ *
+ * Missing objects/arrays are created on the fly.
+ * The function mutates `target` in place and returns it so
+ * you can chain calls.
+ *
+ * @typeParam T – target object type
+ * @typeParam V – value type
+ * @param target   Object to mutate
+ * @param rawPath  Dotted path string (see syntax table)
+ * @param value    Value to set / append / prepend
+ * @returns        The original `target` reference
+ *
+ * @example
+ * const o: Record<string, unknown> = {};
+ * set(o, 'alpha.beta[2].gamma', 42);
+ * // o →
+ * // {
+ * //   alpha: {
+ * //     beta: [
+ * //       ,               // <-- empty slot #0
+ * //       ,               // <-- empty slot #1
+ * //       { gamma: 42 }   // <-- slot #2
+ * //     ]
+ * //   }
+ * // }
+ */
+export declare function set<T extends Record<string, unknown>, V = unknown>(target: T, rawPath: string, value: V): T;

package/dist/better-auth/plugin/utils/set.js

@@ -0,0 +1,103 @@
+/**
+ * Deep-sets a value on an object using a dotted-path string.
+ *
+ * **Path syntax**
+ * ──────────────────────────────────────────────────────────
+ *   token        action
+ *   ------------ ------------------------------------------
+ *   `foo.bar`    create/read plain nested objects
+ *   `foo.bar[]`  *append* `value` to array `foo.bar`
+ *   `foo.[]bar`  *prepend* `value` to array `foo.bar`
+ *   `foo.bar[2]` replace item `2` of `foo.bar`, creating
+ *                empty slots if the index is out of bounds
+ *
+ * Missing objects/arrays are created on the fly.
+ * The function mutates `target` in place and returns it so
+ * you can chain calls.
+ *
+ * @typeParam T – target object type
+ * @typeParam V – value type
+ * @param target   Object to mutate
+ * @param rawPath  Dotted path string (see syntax table)
+ * @param value    Value to set / append / prepend
+ * @returns        The original `target` reference
+ *
+ * @example
+ * const o: Record<string, unknown> = {};
+ * set(o, 'alpha.beta[2].gamma', 42);
+ * // o →
+ * // {
+ * //   alpha: {
+ * //     beta: [
+ * //       ,               // <-- empty slot #0
+ * //       ,               // <-- empty slot #1
+ * //       { gamma: 42 }   // <-- slot #2
+ * //     ]
+ * //   }
+ * // }
+ */ export function set(target, rawPath, value) {
+    if (!rawPath) return target;
+    const tokens = rawPath.split('.');
+    // Using any because node can be any nested object/array structure as we traverse the path
+    // biome-ignore lint/suspicious/noExplicitAny: node can be any nested object/array structure
+    let node = target;
+    for(let i = 0; i < tokens.length; i += 1){
+        const raw = tokens[i];
+        if (!raw) continue;
+        const prepend = raw.startsWith('[]');
+        const append = raw.endsWith('[]');
+        const idxMatch = raw.match(/\[(\d+)]$/);
+        const hasIndex = Boolean(idxMatch);
+        const index = hasIndex ? Number(idxMatch[1]) : -1;
+        const key = prepend ? raw.slice(2) : append ? raw.slice(0, -2) : hasIndex ? raw.slice(0, raw.length - idxMatch[0].length) : raw;
+        const last = i === tokens.length - 1;
+        /* ----- prepend / append ------------------------------------------------ */ if (prepend || append) {
+            if (!Array.isArray(node[key])) node[key] = [];
+            if (last) {
+                // Using any[] because array can contain any value types as we traverse nested structures
+                if (prepend) {
+                    // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types
+                    node[key].unshift(value);
+                } else {
+                    // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types
+                    node[key].push(value);
+                }
+                return target;
+            }
+            const next = {};
+            // Using any[] because array can contain any value types as we traverse nested structures
+            if (prepend) {
+                // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types
+                node[key].unshift(next);
+            } else {
+                // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types
+                node[key].push(next);
+            }
+            node = next;
+            continue;
+        }
+        /* ----- explicit numeric index ----------------------------------------- */ if (hasIndex) {
+            if (!Array.isArray(node[key])) node[key] = [];
+            // Using any[] because array can contain any value types as we traverse nested structures
+            // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types
+            const arr = node[key];
+            while(arr.length <= index)arr.push(undefined);
+            if (last) {
+                arr[index] = value;
+                return target;
+            }
+            if (arr[index] === undefined) arr[index] = {};
+            node = arr[index];
+            continue;
+        }
+        /* ----- plain object step ---------------------------------------------- */ if (last) {
+            node[key] = value;
+            return target;
+        }
+        if (node[key] === undefined) node[key] = {};
+        node = node[key];
+    }
+    return target;
+}
+
+//# sourceMappingURL=set.js.map

package/dist/better-auth/plugin/utils/set.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/better-auth/plugin/utils/set.ts"],"sourcesContent":["/**\n * Deep-sets a value on an object using a dotted-path string.\n *\n * **Path syntax**\n * ──────────────────────────────────────────────────────────\n *   token        action\n *   ------------ ------------------------------------------\n *   `foo.bar`    create/read plain nested objects\n *   `foo.bar[]`  *append* `value` to array `foo.bar`\n *   `foo.[]bar`  *prepend* `value` to array `foo.bar`\n *   `foo.bar[2]` replace item `2` of `foo.bar`, creating\n *                empty slots if the index is out of bounds\n *\n * Missing objects/arrays are created on the fly.\n * The function mutates `target` in place and returns it so\n * you can chain calls.\n *\n * @typeParam T – target object type\n * @typeParam V – value type\n * @param target   Object to mutate\n * @param rawPath  Dotted path string (see syntax table)\n * @param value    Value to set / append / prepend\n * @returns        The original `target` reference\n *\n * @example\n * const o: Record<string, unknown> = {};\n * set(o, 'alpha.beta[2].gamma', 42);\n * // o →\n * // {\n * //   alpha: {\n * //     beta: [\n * //       ,               // <-- empty slot #0\n * //       ,               // <-- empty slot #1\n * //       { gamma: 42 }   // <-- slot #2\n * //     ]\n * //   }\n * // }\n */\nexport function set<T extends Record<string, unknown>, V = unknown>(\n  target: T,\n  rawPath: string,\n  value: V\n): T {\n  if (!rawPath) return target;\n\n  const tokens = rawPath.split('.');\n  // Using any because node can be any nested object/array structure as we traverse the path\n  // biome-ignore lint/suspicious/noExplicitAny: node can be any nested object/array structure\n  let node: any = target;\n\n  for (let i = 0; i < tokens.length; i += 1) {\n    const raw = tokens[i];\n    if (!raw) continue;\n    const prepend = raw.startsWith('[]');\n    const append = raw.endsWith('[]');\n    const idxMatch = raw.match(/\\[(\\d+)]$/);\n    const hasIndex = Boolean(idxMatch);\n    const index = hasIndex ? Number(idxMatch![1]) : -1;\n    const key = prepend\n      ? raw.slice(2)\n      : append\n        ? raw.slice(0, -2)\n        : hasIndex\n          ? raw.slice(0, raw.length - idxMatch![0].length)\n          : raw;\n    const last = i === tokens.length - 1;\n\n    /* ----- prepend / append ------------------------------------------------ */\n    if (prepend || append) {\n      if (!Array.isArray(node[key])) node[key] = [];\n      if (last) {\n        // Using any[] because array can contain any value types as we traverse nested structures\n        if (prepend) {\n          // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types\n          (node[key] as any[]).unshift(value);\n        } else {\n          // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types\n          (node[key] as any[]).push(value);\n        }\n        return target;\n      }\n      const next: Record<string, unknown> = {};\n      // Using any[] because array can contain any value types as we traverse nested structures\n      if (prepend) {\n        // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types\n        (node[key] as any[]).unshift(next);\n      } else {\n        // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types\n        (node[key] as any[]).push(next);\n      }\n      node = next;\n      continue;\n    }\n\n    /* ----- explicit numeric index ----------------------------------------- */\n    if (hasIndex) {\n      if (!Array.isArray(node[key])) node[key] = [];\n      // Using any[] because array can contain any value types as we traverse nested structures\n      // biome-ignore lint/suspicious/noExplicitAny: array can contain any value types\n      const arr: any[] = node[key] as any[];\n      while (arr.length <= index) arr.push(undefined);\n      if (last) {\n        arr[index] = value;\n        return target;\n      }\n      if (arr[index] === undefined) arr[index] = {};\n      node = arr[index];\n      continue;\n    }\n\n    /* ----- plain object step ---------------------------------------------- */\n    if (last) {\n      node[key] = value;\n      return target;\n    }\n    if (node[key] === undefined) node[key] = {};\n    node = node[key];\n  }\n\n  return target;\n}\n"],"names":["set","target","rawPath","value","tokens","split","node","i","length","raw","prepend","startsWith","append","endsWith","idxMatch","match","hasIndex","Boolean","index","Number","key","slice","last","Array","isArray","unshift","push","next","arr","undefined"],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCC,GACD,OAAO,SAASA,IACdC,MAAS,EACTC,OAAe,EACfC,KAAQ;IAER,IAAI,CAACD,SAAS,OAAOD;IAErB,MAAMG,SAASF,QAAQG,KAAK,CAAC;IAC7B,0FAA0F;IAC1F,4FAA4F;IAC5F,IAAIC,OAAYL;IAEhB,IAAK,IAAIM,IAAI,GAAGA,IAAIH,OAAOI,MAAM,EAAED,KAAK,EAAG;QACzC,MAAME,MAAML,MAAM,CAACG,EAAE;QACrB,IAAI,CAACE,KAAK;QACV,MAAMC,UAAUD,IAAIE,UAAU,CAAC;QAC/B,MAAMC,SAASH,IAAII,QAAQ,CAAC;QAC5B,MAAMC,WAAWL,IAAIM,KAAK,CAAC;QAC3B,MAAMC,WAAWC,QAAQH;QACzB,MAAMI,QAAQF,WAAWG,OAAOL,QAAS,CAAC,EAAE,IAAI,CAAC;QACjD,MAAMM,MAAMV,UACRD,IAAIY,KAAK,CAAC,KACVT,SACEH,IAAIY,KAAK,CAAC,GAAG,CAAC,KACdL,WACEP,IAAIY,KAAK,CAAC,GAAGZ,IAAID,MAAM,GAAGM,QAAS,CAAC,EAAE,CAACN,MAAM,IAC7CC;QACR,MAAMa,OAAOf,MAAMH,OAAOI,MAAM,GAAG;QAEnC,2EAA2E,GAC3E,IAAIE,WAAWE,QAAQ;YACrB,IAAI,CAACW,MAAMC,OAAO,CAAClB,IAAI,CAACc,IAAI,GAAGd,IAAI,CAACc,IAAI,GAAG,EAAE;YAC7C,IAAIE,MAAM;gBACR,yFAAyF;gBACzF,IAAIZ,SAAS;oBACX,gFAAgF;oBAC/EJ,IAAI,CAACc,IAAI,CAAWK,OAAO,CAACtB;gBAC/B,OAAO;oBACL,gFAAgF;oBAC/EG,IAAI,CAACc,IAAI,CAAWM,IAAI,CAACvB;gBAC5B;gBACA,OAAOF;YACT;YACA,MAAM0B,OAAgC,CAAC;YACvC,yFAAyF;YACzF,IAAIjB,SAAS;gBACX,gFAAgF;gBAC/EJ,IAAI,CAACc,IAAI,CAAWK,OAAO,CAACE;YAC/B,OAAO;gBACL,gFAAgF;gBAC/ErB,IAAI,CAACc,IAAI,CAAWM,IAAI,CAACC;YAC5B;YACArB,OAAOqB;YACP;QACF;QAEA,0EAA0E,GAC1E,IAAIX,UAAU;YACZ,IAAI,CAACO,MAAMC,OAAO,CAAClB,IAAI,CAACc,IAAI,GAAGd,IAAI,CAACc,IAAI,GAAG,EAAE;YAC7C,yFAAyF;YACzF,gFAAgF;YAChF,MAAMQ,MAAatB,IAAI,CAACc,IAAI;YAC5B,MAAOQ,IAAIpB,MAAM,IAAIU,MAAOU,IAAIF,IAAI,CAACG;YACrC,IAAIP,MAAM;gBACRM,GAAG,CAACV,MAAM,GAAGf;gBACb,OAAOF;YACT;YACA,IAAI2B,GAAG,CAACV,MAAM,KAAKW,WAAWD,GAAG,CAACV,MAAM,GAAG,CAAC;YAC5CZ,OAAOsB,GAAG,CAACV,MAAM;YACjB;QACF;QAEA,0EAA0E,GAC1E,IAAII,MAAM;YACRhB,IAAI,CAACc,IAAI,GAAGjB;YACZ,OAAOF;QACT;QACA,IAAIK,IAAI,CAACc,IAAI,KAAKS,WAAWvB,IAAI,CAACc,IAAI,GAAG,CAAC;QAC1Cd,OAAOA,IAAI,CAACc,IAAI;IAClB;IAEA,OAAOnB;AACT"}

package/dist/better-auth/scripts/generate-types.d.ts

@@ -0,0 +1 @@
+export {};