@better-auth/core 1.3.26 → 1.4.0-beta.10

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/tsdown.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+	dts: true,
+	format: ["esm", "cjs"],
+	entry: [
+		"./src/index.ts",
+		"./src/db/index.ts",
+		"./src/db/adapter/index.ts",
+		"./src/async_hooks/index.ts",
+		"./src/env/index.ts",
+		"./src/oauth2/index.ts",
+		"./src/middleware/index.ts",
+		"./src/social-providers/index.ts",
+		"./src/utils/index.ts",
+		"./src/error/index.ts",
+	],
+	clean: true,
+});

package/build.config.ts

@@ -1,16 +0,0 @@
-import { defineBuildConfig } from "unbuild";
-
-export default defineBuildConfig({
-	rollup: {
-		emitCJS: true,
-	},
-	declaration: true,
-	outDir: "dist",
-	clean: true,
-	failOnWarn: false,
-	entries: [
-		"./src/index.ts",
-		"./src/db/index.ts",
-		"./src/async_hooks/index.ts",
-	],
-});

package/dist/async_hooks/index.d.mts

@@ -1,10 +0,0 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-export { AsyncLocalStorage } from 'node:async_hooks';
-
-/**
- * AsyncLocalStorage will be import directly in 1.5.x
- */
-
-declare function getAsyncLocalStorage(): Promise<typeof AsyncLocalStorage>;
-
-export { getAsyncLocalStorage };

package/dist/async_hooks/index.mjs

@@ -1,25 +0,0 @@
-let moduleName = "node:async_hooks";
-const AsyncLocalStoragePromise = import(
-  /* @vite-ignore */
-  /* webpackIgnore: true */
-  moduleName
-).then((mod) => mod.AsyncLocalStorage).catch((err) => {
-  if ("AsyncLocalStorage" in globalThis) {
-    return globalThis.AsyncLocalStorage;
-  }
-  console.warn(
-    "[better-auth] Warning: AsyncLocalStorage is not available in this environment. Some features may not work as expected."
-  );
-  console.warn(
-    "[better-auth] Please read more about this warning at https://better-auth.com/docs/installation#mount-handler"
-  );
-  console.warn(
-    "[better-auth] If you are using Cloudflare Workers, please see: https://developers.cloudflare.com/workers/configuration/compatibility-flags/#nodejs-compatibility-flag"
-  );
-  throw err;
-});
-async function getAsyncLocalStorage() {
-  return AsyncLocalStoragePromise;
-}
-
-export { getAsyncLocalStorage };

package/dist/db/index.d.mts

@@ -1,130 +0,0 @@
-import { ZodType } from 'zod';
-
-type LiteralString = "" | (string & Record<never, never>);
-
-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;
-}>;
-
-/**
- * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
- */
-type FieldAttribute = DBFieldAttribute;
-/**
- * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
- */
-type FieldAttributeConfig = DBFieldAttributeConfig;
-/**
- * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
- */
-type FieldType = DBFieldType;
-/**
- * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
- */
-type Primitive = DBPrimitive;
-/**
- * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
- */
-type BetterAuthDbSchema = BetterAuthDBSchema;
-
-export type { BetterAuthDBSchema, BetterAuthDbSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, FieldAttribute, FieldAttributeConfig, FieldType, Primitive };

package/dist/db/index.mjs

@@ -1 +0,0 @@
-

package/dist/index.d.mts

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

package/dist/index.mjs

@@ -1 +0,0 @@
-