@better-auth/core 1.4.0-beta.7 → 1.4.0-beta.9

package/src/types/plugin-client.ts

@@ -0,0 +1,69 @@
+import type { BetterAuthPlugin } from "./plugin";
+import type {
+	BetterFetch,
+	BetterFetchOption,
+	BetterFetchPlugin,
+} from "@better-fetch/fetch";
+import type { LiteralString } from "./helper";
+import type { BetterAuthOptions } from "./init-options";
+import type { WritableAtom, Atom } from "nanostores";
+
+export interface ClientStore {
+	notify: (signal: string) => void;
+	listen: (signal: string, listener: () => void) => void;
+	atoms: Record<string, WritableAtom<any>>;
+}
+
+export type ClientAtomListener = {
+	matcher: (path: string) => boolean;
+	signal: "$sessionSignal" | Omit<string, "$sessionSignal">;
+};
+
+export interface BetterAuthClientOptions {
+	fetchOptions?: BetterFetchOption;
+	plugins?: BetterAuthClientPlugin[];
+	baseURL?: string;
+	basePath?: string;
+	disableDefaultFetchPlugins?: boolean;
+	$InferAuth?: BetterAuthOptions;
+}
+
+export interface BetterAuthClientPlugin {
+	id: LiteralString;
+	/**
+	 * only used for type inference. don't pass the
+	 * actual plugin
+	 */
+	$InferServerPlugin?: BetterAuthPlugin;
+	/**
+	 * Custom actions
+	 */
+	getActions?: (
+		$fetch: BetterFetch,
+		$store: ClientStore,
+		/**
+		 * better-auth client options
+		 */
+		options: BetterAuthClientOptions | undefined,
+	) => Record<string, any>;
+	/**
+	 * State atoms that'll be resolved by each framework
+	 * auth store.
+	 */
+	getAtoms?: ($fetch: BetterFetch) => Record<string, Atom<any>>;
+	/**
+	 * specify path methods for server plugin inferred
+	 * endpoints to force a specific method.
+	 */
+	pathMethods?: Record<string, "POST" | "GET">;
+	/**
+	 * Better fetch plugins
+	 */
+	fetchPlugins?: BetterFetchPlugin[];
+	/**
+	 * a list of recaller based on a matcher function.
+	 * The signal name needs to match a signal in this
+	 * plugin or any plugin the user might have added.
+	 */
+	atomListeners?: ClientAtomListener[];
+}

package/src/types/plugin.ts

@@ -0,0 +1,134 @@
+import type { Migration } from "kysely";
+import type { AuthContext } from "./context";
+import type {
+	Endpoint,
+	EndpointContext,
+	InputContext,
+	Middleware,
+} from "better-call";
+import type { BetterAuthPluginDBSchema } from "../db";
+import type { LiteralString } from "./helper";
+import type { BetterAuthOptions } from "./init-options";
+import type { AuthMiddleware } from "../middleware";
+
+type Awaitable<T> = T | Promise<T>;
+type DeepPartial<T> = T extends Function
+	? T
+	: T extends object
+		? { [K in keyof T]?: DeepPartial<T[K]> }
+		: T;
+
+type HookEndpointContext = EndpointContext<string, any> &
+	Omit<InputContext<string, any>, "method"> & {
+		context: AuthContext & {
+			returned?: unknown;
+			responseHeaders?: Headers;
+		};
+		headers?: Headers;
+	};
+
+export type BetterAuthPlugin = {
+	id: LiteralString;
+	/**
+	 * The init function is called when the plugin is initialized.
+	 * You can return a new context or modify the existing context.
+	 */
+	init?: (ctx: AuthContext) =>
+		| Awaitable<{
+				context?: DeepPartial<Omit<AuthContext, "options">>;
+				options?: Partial<BetterAuthOptions>;
+		  }>
+		| void
+		| Promise<void>;
+	endpoints?: {
+		[key: string]: Endpoint;
+	};
+	middlewares?: {
+		path: string;
+		middleware: Middleware;
+	}[];
+	onRequest?: (
+		request: Request,
+		ctx: AuthContext,
+	) => Promise<
+		| {
+				response: Response;
+		  }
+		| {
+				request: Request;
+		  }
+		| void
+	>;
+	onResponse?: (
+		response: Response,
+		ctx: AuthContext,
+	) => Promise<{
+		response: Response;
+	} | void>;
+	hooks?: {
+		before?: {
+			matcher: (context: HookEndpointContext) => boolean;
+			handler: AuthMiddleware;
+		}[];
+		after?: {
+			matcher: (context: HookEndpointContext) => boolean;
+			handler: AuthMiddleware;
+		}[];
+	};
+	/**
+	 * Schema the plugin needs
+	 *
+	 * This will also be used to migrate the database. If the fields are dynamic from the plugins
+	 * configuration each time the configuration is changed a new migration will be created.
+	 *
+	 * NOTE: If you want to create migrations manually using
+	 * migrations option or any other way you
+	 * can disable migration per table basis.
+	 *
+	 * @example
+	 * ```ts
+	 * schema: {
+	 * 	user: {
+	 * 		fields: {
+	 * 			email: {
+	 * 				 type: "string",
+	 * 			},
+	 * 			emailVerified: {
+	 * 				type: "boolean",
+	 * 				defaultValue: false,
+	 * 			},
+	 * 		},
+	 * 	}
+	 * } as AuthPluginSchema
+	 * ```
+	 */
+	schema?: BetterAuthPluginDBSchema;
+	/**
+	 * The migrations of the plugin. If you define schema that will automatically create
+	 * migrations for you.
+	 *
+	 * ⚠️ Only uses this if you dont't want to use the schema option and you disabled migrations for
+	 * the tables.
+	 */
+	migrations?: Record<string, Migration>;
+	/**
+	 * The options of the plugin
+	 */
+	options?: Record<string, any> | undefined;
+	/**
+	 * types to be inferred
+	 */
+	$Infer?: Record<string, any>;
+	/**
+	 * The rate limit rules to apply to specific paths.
+	 */
+	rateLimit?: {
+		window: number;
+		max: number;
+		pathMatcher: (path: string) => boolean;
+	}[];
+	/**
+	 * The error codes returned by the plugin
+	 */
+	$ERROR_CODES?: Record<string, string>;
+};

package/src/utils/error-codes.ts

@@ -0,0 +1,51 @@
+type UpperLetter =
+	| "A"
+	| "B"
+	| "C"
+	| "D"
+	| "E"
+	| "F"
+	| "G"
+	| "H"
+	| "I"
+	| "J"
+	| "K"
+	| "L"
+	| "M"
+	| "N"
+	| "O"
+	| "P"
+	| "Q"
+	| "R"
+	| "S"
+	| "T"
+	| "U"
+	| "V"
+	| "W"
+	| "X"
+	| "Y"
+	| "Z";
+type SpecialCharacter = "_";
+
+type IsValidUpperSnakeCase<S extends string> = S extends `${infer F}${infer R}`
+	? F extends UpperLetter | SpecialCharacter
+		? IsValidUpperSnakeCase<R>
+		: false
+	: true;
+
+type InvalidKeyError<K extends string> =
+	`Invalid error code key: "${K}" - must only contain uppercase letters (A-Z) and underscores (_)`;
+
+type ValidateErrorCodes<T> = {
+	[K in keyof T]: K extends string
+		? IsValidUpperSnakeCase<K> extends false
+			? InvalidKeyError<K>
+			: T[K]
+		: T[K];
+};
+
+export function defineErrorCodes<const T extends Record<string, string>>(
+	codes: ValidateErrorCodes<T>,
+): T {
+	return codes as T;
+}

package/src/utils/index.ts

@@ -0,0 +1 @@
+export { defineErrorCodes } from "./error-codes";

package/dist/shared/core.CnvFgghY.d.cts

@@ -1,117 +0,0 @@
-import { ZodType } from 'zod';
-
-type Primitive = string | number | symbol | bigint | boolean | null | undefined;
-type LiteralString = "" | (string & Record<never, never>);
-type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
-
-declare module "../index" {
-    interface BetterAuthMutators<O, C> {
-        "better-auth/db": {};
-    }
-}
-type Models = "user" | "account" | "session" | "verification" | "rate-limit" | "organization" | "member" | "invitation" | "jwks" | "passkey" | "two-factor";
-type DBFieldType = "string" | "number" | "boolean" | "date" | "json" | `${"string" | "number"}[]` | Array<LiteralString>;
-type DBPrimitive = string | number | boolean | Date | null | undefined | string[] | number[];
-type DBFieldAttributeConfig = {
-    /**
-     * If the field should be required on a new record.
-     * @default true
-     */
-    required?: boolean;
-    /**
-     * If the value should be returned on a response body.
-     * @default true
-     */
-    returned?: boolean;
-    /**
-     * If a value should be provided when creating a new record.
-     * @default true
-     */
-    input?: boolean;
-    /**
-     * Default value for the field
-     *
-     * Note: This will not create a default value on the database level. It will only
-     * be used when creating a new record.
-     */
-    defaultValue?: DBPrimitive | (() => DBPrimitive);
-    /**
-     * Update value for the field
-     *
-     * Note: This will create an onUpdate trigger on the database level for supported adapters.
-     * It will be called when updating a record.
-     */
-    onUpdate?: () => DBPrimitive;
-    /**
-     * transform the value before storing it.
-     */
-    transform?: {
-        input?: (value: DBPrimitive) => DBPrimitive | Promise<DBPrimitive>;
-        output?: (value: DBPrimitive) => DBPrimitive | Promise<DBPrimitive>;
-    };
-    /**
-     * Reference to another model.
-     */
-    references?: {
-        /**
-         * The model to reference.
-         */
-        model: string;
-        /**
-         * The field on the referenced model.
-         */
-        field: string;
-        /**
-         * The action to perform when the reference is deleted.
-         * @default "cascade"
-         */
-        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
-    };
-    unique?: boolean;
-    /**
-     * If the field should be a bigint on the database instead of integer.
-     */
-    bigint?: boolean;
-    /**
-     * A zod schema to validate the value.
-     */
-    validator?: {
-        input?: ZodType;
-        output?: ZodType;
-    };
-    /**
-     * The name of the field on the database.
-     */
-    fieldName?: string;
-    /**
-     * If the field should be sortable.
-     *
-     * applicable only for `text` type.
-     * It's useful to mark fields varchar instead of text.
-     */
-    sortable?: boolean;
-};
-type DBFieldAttribute<T extends DBFieldType = DBFieldType> = {
-    type: T;
-} & DBFieldAttributeConfig;
-type BetterAuthDBSchema = Record<string, {
-    /**
-     * The name of the table in the database
-     */
-    modelName: string;
-    /**
-     * The fields of the table
-     */
-    fields: Record<string, DBFieldAttribute>;
-    /**
-     * Whether to disable migrations for this table
-     * @default false
-     */
-    disableMigrations?: boolean;
-    /**
-     * The order of the table
-     */
-    order?: number;
-}>;
-
-export type { BetterAuthDBSchema as B, DBFieldAttribute as D, LiteralUnion as L, Models as M, LiteralString as a, DBFieldAttributeConfig as b, DBFieldType as c, DBPrimitive as d };

package/dist/shared/core.CnvFgghY.d.mts

@@ -1,117 +0,0 @@
-import { ZodType } from 'zod';
-
-type Primitive = string | number | symbol | bigint | boolean | null | undefined;
-type LiteralString = "" | (string & Record<never, never>);
-type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
-
-declare module "../index" {
-    interface BetterAuthMutators<O, C> {
-        "better-auth/db": {};
-    }
-}
-type Models = "user" | "account" | "session" | "verification" | "rate-limit" | "organization" | "member" | "invitation" | "jwks" | "passkey" | "two-factor";
-type DBFieldType = "string" | "number" | "boolean" | "date" | "json" | `${"string" | "number"}[]` | Array<LiteralString>;
-type DBPrimitive = string | number | boolean | Date | null | undefined | string[] | number[];
-type DBFieldAttributeConfig = {
-    /**
-     * If the field should be required on a new record.
-     * @default true
-     */
-    required?: boolean;
-    /**
-     * If the value should be returned on a response body.
-     * @default true
-     */
-    returned?: boolean;
-    /**
-     * If a value should be provided when creating a new record.
-     * @default true
-     */
-    input?: boolean;
-    /**
-     * Default value for the field
-     *
-     * Note: This will not create a default value on the database level. It will only
-     * be used when creating a new record.
-     */
-    defaultValue?: DBPrimitive | (() => DBPrimitive);
-    /**
-     * Update value for the field
-     *
-     * Note: This will create an onUpdate trigger on the database level for supported adapters.
-     * It will be called when updating a record.
-     */
-    onUpdate?: () => DBPrimitive;
-    /**
-     * transform the value before storing it.
-     */
-    transform?: {
-        input?: (value: DBPrimitive) => DBPrimitive | Promise<DBPrimitive>;
-        output?: (value: DBPrimitive) => DBPrimitive | Promise<DBPrimitive>;
-    };
-    /**
-     * Reference to another model.
-     */
-    references?: {
-        /**
-         * The model to reference.
-         */
-        model: string;
-        /**
-         * The field on the referenced model.
-         */
-        field: string;
-        /**
-         * The action to perform when the reference is deleted.
-         * @default "cascade"
-         */
-        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
-    };
-    unique?: boolean;
-    /**
-     * If the field should be a bigint on the database instead of integer.
-     */
-    bigint?: boolean;
-    /**
-     * A zod schema to validate the value.
-     */
-    validator?: {
-        input?: ZodType;
-        output?: ZodType;
-    };
-    /**
-     * The name of the field on the database.
-     */
-    fieldName?: string;
-    /**
-     * If the field should be sortable.
-     *
-     * applicable only for `text` type.
-     * It's useful to mark fields varchar instead of text.
-     */
-    sortable?: boolean;
-};
-type DBFieldAttribute<T extends DBFieldType = DBFieldType> = {
-    type: T;
-} & DBFieldAttributeConfig;
-type BetterAuthDBSchema = Record<string, {
-    /**
-     * The name of the table in the database
-     */
-    modelName: string;
-    /**
-     * The fields of the table
-     */
-    fields: Record<string, DBFieldAttribute>;
-    /**
-     * Whether to disable migrations for this table
-     * @default false
-     */
-    disableMigrations?: boolean;
-    /**
-     * The order of the table
-     */
-    order?: number;
-}>;
-
-export type { BetterAuthDBSchema as B, DBFieldAttribute as D, LiteralUnion as L, Models as M, LiteralString as a, DBFieldAttributeConfig as b, DBFieldType as c, DBPrimitive as d };

package/dist/shared/core.CnvFgghY.d.ts

@@ -1,117 +0,0 @@
-import { ZodType } from 'zod';
-
-type Primitive = string | number | symbol | bigint | boolean | null | undefined;
-type LiteralString = "" | (string & Record<never, never>);
-type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
-
-declare module "../index" {
-    interface BetterAuthMutators<O, C> {
-        "better-auth/db": {};
-    }
-}
-type Models = "user" | "account" | "session" | "verification" | "rate-limit" | "organization" | "member" | "invitation" | "jwks" | "passkey" | "two-factor";
-type DBFieldType = "string" | "number" | "boolean" | "date" | "json" | `${"string" | "number"}[]` | Array<LiteralString>;
-type DBPrimitive = string | number | boolean | Date | null | undefined | string[] | number[];
-type DBFieldAttributeConfig = {
-    /**
-     * If the field should be required on a new record.
-     * @default true
-     */
-    required?: boolean;
-    /**
-     * If the value should be returned on a response body.
-     * @default true
-     */
-    returned?: boolean;
-    /**
-     * If a value should be provided when creating a new record.
-     * @default true
-     */
-    input?: boolean;
-    /**
-     * Default value for the field
-     *
-     * Note: This will not create a default value on the database level. It will only
-     * be used when creating a new record.
-     */
-    defaultValue?: DBPrimitive | (() => DBPrimitive);
-    /**
-     * Update value for the field
-     *
-     * Note: This will create an onUpdate trigger on the database level for supported adapters.
-     * It will be called when updating a record.
-     */
-    onUpdate?: () => DBPrimitive;
-    /**
-     * transform the value before storing it.
-     */
-    transform?: {
-        input?: (value: DBPrimitive) => DBPrimitive | Promise<DBPrimitive>;
-        output?: (value: DBPrimitive) => DBPrimitive | Promise<DBPrimitive>;
-    };
-    /**
-     * Reference to another model.
-     */
-    references?: {
-        /**
-         * The model to reference.
-         */
-        model: string;
-        /**
-         * The field on the referenced model.
-         */
-        field: string;
-        /**
-         * The action to perform when the reference is deleted.
-         * @default "cascade"
-         */
-        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
-    };
-    unique?: boolean;
-    /**
-     * If the field should be a bigint on the database instead of integer.
-     */
-    bigint?: boolean;
-    /**
-     * A zod schema to validate the value.
-     */
-    validator?: {
-        input?: ZodType;
-        output?: ZodType;
-    };
-    /**
-     * The name of the field on the database.
-     */
-    fieldName?: string;
-    /**
-     * If the field should be sortable.
-     *
-     * applicable only for `text` type.
-     * It's useful to mark fields varchar instead of text.
-     */
-    sortable?: boolean;
-};
-type DBFieldAttribute<T extends DBFieldType = DBFieldType> = {
-    type: T;
-} & DBFieldAttributeConfig;
-type BetterAuthDBSchema = Record<string, {
-    /**
-     * The name of the table in the database
-     */
-    modelName: string;
-    /**
-     * The fields of the table
-     */
-    fields: Record<string, DBFieldAttribute>;
-    /**
-     * Whether to disable migrations for this table
-     * @default false
-     */
-    disableMigrations?: boolean;
-    /**
-     * The order of the table
-     */
-    order?: number;
-}>;
-
-export type { BetterAuthDBSchema as B, DBFieldAttribute as D, LiteralUnion as L, Models as M, LiteralString as a, DBFieldAttributeConfig as b, DBFieldType as c, DBPrimitive as d };