@depup/better-auth__core 1.6.23-depup.2

package/src/db/schema/user.ts

@@ -0,0 +1,31 @@
+import * as z from "zod";
+import type { BetterAuthOptions, Prettify } from "../../types";
+import type {
+	InferDBFieldsFromOptions,
+	InferDBFieldsFromPlugins,
+} from "../type";
+import { coreSchema } from "./shared";
+
+export const userSchema = coreSchema.extend({
+	// TODO(#9124): widen to nullish in v2. OAuth providers (Discord phone-only,
+	// Apple subsequent sign-ins, etc.) can legitimately omit email; identity
+	// must key on (providerId, accountId) per OpenID Connect Core §5.7.
+	email: z.string().transform((val) => val.toLowerCase()),
+	emailVerified: z.boolean().default(false),
+	name: z.string(),
+	image: z.string().nullish(),
+});
+
+export type BaseUser = z.infer<typeof userSchema>;
+
+/**
+ * User schema type used by better-auth, note that it's possible that user could have additional fields
+ */
+export type User<
+	DBOptions extends BetterAuthOptions["user"] = BetterAuthOptions["user"],
+	Plugins extends BetterAuthOptions["plugins"] = BetterAuthOptions["plugins"],
+> = Prettify<
+	BaseUser &
+		InferDBFieldsFromOptions<DBOptions> &
+		InferDBFieldsFromPlugins<"user", Plugins>
+>;

package/src/db/schema/verification.ts

@@ -0,0 +1,28 @@
+import * as z from "zod";
+import type { BetterAuthOptions, Prettify } from "../../types";
+import type {
+	InferDBFieldsFromOptions,
+	InferDBFieldsFromPlugins,
+} from "../type";
+import { coreSchema } from "./shared";
+
+export const verificationSchema = coreSchema.extend({
+	value: z.string(),
+	expiresAt: z.date(),
+	identifier: z.string(),
+});
+
+export type BaseVerification = z.infer<typeof verificationSchema>;
+
+/**
+ * Verification schema type used by better-auth, note that it's possible that verification could have additional fields
+ */
+export type Verification<
+	DBOptions extends
+		BetterAuthOptions["verification"] = BetterAuthOptions["verification"],
+	Plugins extends BetterAuthOptions["plugins"] = BetterAuthOptions["plugins"],
+> = Prettify<
+	BaseVerification &
+		InferDBFieldsFromOptions<DBOptions> &
+		InferDBFieldsFromPlugins<"verification", Plugins>
+>;

package/src/db/type.ts

@@ -0,0 +1,360 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type {
+	Awaitable,
+	BetterAuthOptions,
+	LiteralString,
+	UnionToIntersection,
+} from "../types";
+
+export type BaseModelNames = "user" | "account" | "session" | "verification";
+
+export type ModelNames<T extends string = LiteralString> =
+	| BaseModelNames
+	| T
+	| "rate-limit";
+
+export type InferDBValueType<T extends DBFieldType> = T extends "string"
+	? string
+	: T extends "number"
+		? number
+		: T extends "boolean"
+			? boolean
+			: T extends "date"
+				? Date
+				: T extends "json"
+					? Record<string, any>
+					: T extends `${infer U}[]`
+						? U extends "string"
+							? string[]
+							: number[]
+						: T extends Array<any>
+							? T[number]
+							: never;
+
+export type InferDBFieldOutput<T extends DBFieldAttribute> =
+	T["returned"] extends false
+		? never
+		: T["required"] extends false
+			? InferDBValueType<T["type"]> | undefined | null
+			: InferDBValueType<T["type"]>;
+
+export type InferDBFieldInput<T extends DBFieldAttribute> = InferDBValueType<
+	T["type"]
+>;
+
+export type InferDBFieldsInput<Field> =
+	Field extends Record<infer Key, DBFieldAttribute>
+		? {
+				[key in Key as Field[key]["required"] extends false
+					? never
+					: Field[key]["defaultValue"] extends string | number | boolean | Date
+						? never
+						: Field[key]["input"] extends false
+							? never
+							: key]: InferDBFieldInput<Field[key]>;
+			} & {
+				[key in Key as Field[key]["input"] extends false ? never : key]?:
+					| InferDBFieldInput<Field[key]>
+					| undefined
+					| null;
+			}
+		: {};
+
+export type InferDBFieldsOutput<
+	Fields extends Record<string, DBFieldAttribute>,
+> =
+	Fields extends Record<infer Key, DBFieldAttribute>
+		? {
+				[key in Key as Fields[key]["returned"] extends false
+					? never
+					: Fields[key]["required"] extends false
+						? Fields[key]["defaultValue"] extends
+								| boolean
+								| string
+								| number
+								| Date
+							? key
+							: never
+						: key]: InferDBFieldOutput<Fields[key]>;
+			} & {
+				[key in Key as Fields[key]["returned"] extends false
+					? never
+					: Fields[key]["required"] extends false
+						? Fields[key]["defaultValue"] extends
+								| boolean
+								| string
+								| number
+								| Date
+							? never
+							: key
+						: never]?: InferDBFieldOutput<Fields[key]> | null;
+			}
+		: never;
+
+export type InferDBFieldsFromOptionsInput<
+	DBOptions extends
+		| BetterAuthOptions["session"]
+		| BetterAuthOptions["user"]
+		| BetterAuthOptions["verification"]
+		| BetterAuthOptions["account"]
+		| BetterAuthOptions["rateLimit"],
+> = DBOptions extends {
+	additionalFields: Record<string, DBFieldAttribute>;
+}
+	? InferDBFieldsInput<DBOptions["additionalFields"]>
+	: {};
+
+export type InferDBFieldsFromOptions<
+	DBOptions extends
+		| BetterAuthOptions["session"]
+		| BetterAuthOptions["user"]
+		| BetterAuthOptions["verification"]
+		| BetterAuthOptions["account"]
+		| BetterAuthOptions["rateLimit"],
+> = DBOptions extends {
+	additionalFields: Record<string, DBFieldAttribute>;
+}
+	? InferDBFieldsOutput<DBOptions["additionalFields"]>
+	: {};
+
+export type InferDBFieldsFromPluginsInput<
+	ModelName extends string,
+	Plugins extends unknown[] | undefined,
+> = Plugins extends []
+	? {}
+	: Plugins extends [infer P, ...infer Rest]
+		? P extends {
+				schema: {
+					[key in ModelName]: {
+						fields: infer Fields;
+					};
+				};
+			}
+			? Fields extends Record<string, DBFieldAttribute>
+				? UnionToIntersection<
+						InferDBFieldsInput<Fields> &
+							InferDBFieldsFromPluginsInput<ModelName, Rest>
+					>
+				: InferDBFieldsFromPluginsInput<ModelName, Rest>
+			: InferDBFieldsFromPluginsInput<ModelName, Rest>
+		: {};
+
+export type InferDBFieldsFromPlugins<
+	ModelName extends string,
+	Plugins extends unknown[] | undefined,
+> = Plugins extends []
+	? {}
+	: Plugins extends [infer P, ...infer Rest]
+		? P extends {
+				schema: {
+					[key in ModelName]: {
+						fields: infer Fields;
+					};
+				};
+			}
+			? Fields extends Record<string, DBFieldAttribute>
+				? UnionToIntersection<
+						InferDBFieldsOutput<Fields> &
+							InferDBFieldsFromPlugins<ModelName, Rest>
+					>
+				: InferDBFieldsFromPlugins<ModelName, Rest>
+			: InferDBFieldsFromPlugins<ModelName, Rest>
+		: {};
+
+export type DBFieldType =
+	| "string"
+	| "number"
+	| "boolean"
+	| "date"
+	| "json"
+	| `${"string" | "number"}[]`
+	| Array<LiteralString>;
+
+export type DBPrimitive =
+	| string
+	| number
+	| boolean
+	| Date
+	| null
+	| undefined
+	| string[]
+	| number[]
+	| (Record<string, unknown> | unknown[]);
+
+export type DBFieldAttributeConfig = {
+	/**
+	 * If the field should be required on a new record.
+	 * @default true
+	 */
+	required?: boolean | undefined;
+	/**
+	 * If the value should be returned on a response body.
+	 * @default true
+	 */
+	returned?: boolean | undefined;
+	/**
+	 * If a value should be provided when creating a new record.
+	 * @default true
+	 */
+	input?: boolean | undefined;
+	/**
+	 * 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)) | undefined;
+	/**
+	 * 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) | undefined;
+	/**
+	 * transform the value before storing it.
+	 */
+	transform?:
+		| {
+				input?: (value: DBPrimitive) => Awaitable<DBPrimitive>;
+				output?: (value: DBPrimitive) => Awaitable<DBPrimitive>;
+		  }
+		| undefined;
+	/**
+	 * 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";
+		  }
+		| undefined;
+	unique?: boolean | undefined;
+	/**
+	 * If the field should be a bigint on the database instead of integer.
+	 */
+	bigint?: boolean | undefined;
+	/**
+	 * A zod schema to validate the value.
+	 */
+	validator?:
+		| {
+				input?: StandardSchemaV1;
+				output?: StandardSchemaV1;
+		  }
+		| undefined;
+	/**
+	 * The name of the field on the database.
+	 */
+	fieldName?: string | undefined;
+	/**
+	 * If the field should be sortable.
+	 *
+	 * applicable only for `text` type.
+	 * It's useful to mark fields varchar instead of text.
+	 */
+	sortable?: boolean | undefined;
+	/**
+	 * If the field should be indexed.
+	 * @default false
+	 */
+	index?: boolean | undefined;
+};
+
+export type DBFieldAttribute<T extends DBFieldType = DBFieldType> = {
+	type: T;
+} & DBFieldAttributeConfig;
+
+export 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 | undefined;
+		/**
+		 * The order of the table
+		 */
+		order?: number | undefined;
+	}
+>;
+
+export interface SecondaryStorage {
+	/**
+	 *
+	 * @param key - Key to get
+	 * @returns - Value of the key
+	 */
+	get: (key: string) => Awaitable<unknown>;
+	/**
+	 * Atomically get a value and delete it from storage.
+	 *
+	 * This is optional for backwards compatibility with existing secondary
+	 * storage implementations. Single-use credential consumers use it when
+	 * present to avoid a read-then-delete race.
+	 *
+	 * TODO(secondary-storage-atomic-consume): make this required in the next
+	 * breaking release, or require database-backed verification storage for
+	 * security-sensitive consume paths.
+	 */
+	getAndDelete?: (key: string) => Awaitable<unknown>;
+	/**
+	 * Atomically increment the counter at `key` by one, returning the
+	 * post-increment value.
+	 *
+	 * When the key is absent, it is created with a value of `1` and the given
+	 * `ttl` (in SECONDS). The TTL is applied only on creation; later increments
+	 * never extend it, so the counter expires a fixed window after it was first
+	 * created.
+	 *
+	 * This is optional for backwards compatibility with existing secondary
+	 * storage implementations. TODO(secondary-storage-increment-required): make
+	 * this required for secondary-storage-backed rate limiting in the next minor
+	 * on `next`.
+	 */
+	increment?: (key: string, ttl: number) => Awaitable<number>;
+	set: (
+		/**
+		 * Key to store
+		 */
+		key: string,
+		/**
+		 * Value to store
+		 */
+		value: string,
+		/**
+		 * Time to live in seconds
+		 */
+		ttl?: number | undefined,
+	) => Awaitable<void | null | unknown>;
+	/**
+	 *
+	 * @param key - Key to delete
+	 */
+	delete: (key: string) => Awaitable<void | null | string>;
+}

package/src/env/color-depth.ts

@@ -0,0 +1,172 @@
+// Source code copied & modified from node internals: https://github.com/nodejs/node/blob/5b32bb1573dace2dd058c05ac4fab1e4e446c775/lib/internal/tty.js#L123
+import { env, getEnvVar } from "./env-impl";
+
+const COLORS_2 = 1;
+const COLORS_16 = 4;
+const COLORS_256 = 8;
+const COLORS_16m = 24;
+
+const TERM_ENVS: Record<string, number> = {
+	eterm: COLORS_16,
+	cons25: COLORS_16,
+	console: COLORS_16,
+	cygwin: COLORS_16,
+	dtterm: COLORS_16,
+	gnome: COLORS_16,
+	hurd: COLORS_16,
+	jfbterm: COLORS_16,
+	konsole: COLORS_16,
+	kterm: COLORS_16,
+	mlterm: COLORS_16,
+	mosh: COLORS_16m,
+	putty: COLORS_16,
+	st: COLORS_16,
+	// http://lists.schmorp.de/pipermail/rxvt-unicode/2016q2/002261.html
+	"rxvt-unicode-24bit": COLORS_16m,
+	// https://bugs.launchpad.net/terminator/+bug/1030562
+	terminator: COLORS_16m,
+	"xterm-kitty": COLORS_16m,
+};
+
+const CI_ENVS_MAP = new Map(
+	Object.entries({
+		APPVEYOR: COLORS_256,
+		BUILDKITE: COLORS_256,
+		CIRCLECI: COLORS_16m,
+		DRONE: COLORS_256,
+		GITEA_ACTIONS: COLORS_16m,
+		GITHUB_ACTIONS: COLORS_16m,
+		GITLAB_CI: COLORS_256,
+		TRAVIS: COLORS_256,
+	}),
+);
+
+const TERM_ENVS_REG_EXP = [
+	/ansi/,
+	/color/,
+	/linux/,
+	/direct/,
+	/^con[0-9]*x[0-9]/,
+	/^rxvt/,
+	/^screen/,
+	/^xterm/,
+	/^vt100/,
+	/^vt220/,
+];
+
+// The `getColorDepth` API got inspired by multiple sources such as
+// https://github.com/chalk/supports-color,
+// https://github.com/isaacs/color-support.
+export function getColorDepth(): number {
+	// Use level 0-3 to support the same levels as `chalk` does. This is done for
+	// consistency throughout the ecosystem.
+	if (getEnvVar("FORCE_COLOR") !== undefined) {
+		switch (getEnvVar("FORCE_COLOR")) {
+			case "":
+			case "1":
+			case "true":
+				return COLORS_16;
+			case "2":
+				return COLORS_256;
+			case "3":
+				return COLORS_16m;
+			default:
+				return COLORS_2;
+		}
+	}
+
+	if (
+		(getEnvVar("NODE_DISABLE_COLORS") !== undefined &&
+			getEnvVar("NODE_DISABLE_COLORS") !== "") ||
+		// See https://no-color.org/
+		(getEnvVar("NO_COLOR") !== undefined && getEnvVar("NO_COLOR") !== "") ||
+		// The "dumb" special terminal, as defined by terminfo, doesn't support
+		// ANSI color control codes.
+		// See https://invisible-island.net/ncurses/terminfo.ti.html#toc-_Specials
+		getEnvVar("TERM") === "dumb"
+	) {
+		return COLORS_2;
+	}
+
+	// Edge runtime doesn't support `process?.platform` syntax
+	// if (typeof process !== "undefined" && process?.platform === "win32") {
+	// 	// Windows 10 build 14931 (from 2016) has true color support
+	// 	return COLORS_16m;
+	// }
+
+	if (getEnvVar("TMUX")) {
+		return COLORS_16m;
+	}
+
+	// Azure DevOps
+	if ("TF_BUILD" in env && "AGENT_NAME" in env) {
+		return COLORS_16;
+	}
+
+	if ("CI" in env) {
+		for (const { 0: envName, 1: colors } of CI_ENVS_MAP) {
+			if (envName in env) {
+				return colors;
+			}
+		}
+		if (getEnvVar("CI_NAME") === "codeship") {
+			return COLORS_256;
+		}
+		return COLORS_2;
+	}
+
+	if ("TEAMCITY_VERSION" in env) {
+		return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.exec(
+			getEnvVar("TEAMCITY_VERSION"),
+		) !== null
+			? COLORS_16
+			: COLORS_2;
+	}
+
+	switch (getEnvVar("TERM_PROGRAM")) {
+		case "iTerm.app":
+			if (
+				!getEnvVar("TERM_PROGRAM_VERSION") ||
+				/^[0-2]\./.exec(getEnvVar("TERM_PROGRAM_VERSION")) !== null
+			) {
+				return COLORS_256;
+			}
+			return COLORS_16m;
+		case "HyperTerm":
+		case "MacTerm":
+			return COLORS_16m;
+		case "Apple_Terminal":
+			return COLORS_256;
+	}
+
+	if (
+		getEnvVar("COLORTERM") === "truecolor" ||
+		getEnvVar("COLORTERM") === "24bit"
+	) {
+		return COLORS_16m;
+	}
+
+	if (getEnvVar("TERM")) {
+		if (/truecolor/.exec(getEnvVar("TERM")) !== null) {
+			return COLORS_16m;
+		}
+
+		if (/^xterm-256/.exec(getEnvVar("TERM")) !== null) {
+			return COLORS_256;
+		}
+
+		const termEnv = getEnvVar("TERM").toLowerCase();
+
+		if (TERM_ENVS[termEnv]) {
+			return TERM_ENVS[termEnv];
+		}
+		if (TERM_ENVS_REG_EXP.some((term) => term.exec(termEnv) !== null)) {
+			return COLORS_16;
+		}
+	}
+	// Move 16 color COLORTERM below 16m and 256
+	if (getEnvVar("COLORTERM")) {
+		return COLORS_16;
+	}
+	return COLORS_2;
+}

package/src/env/env-impl.ts

@@ -0,0 +1,123 @@
+/// <reference types="node" />
+/// <reference types="bun" />
+//https://github.com/unjs/std-env/blob/main/src/env.ts
+
+const _envShim = Object.create(null);
+
+export type EnvObject = Record<string, string | undefined>;
+
+const _getEnv = (useShim?: boolean) =>
+	globalThis.process?.env ||
+	//@ts-expect-error
+	globalThis.Deno?.env.toObject() ||
+	//@ts-expect-error
+	globalThis.__env__ ||
+	(useShim ? _envShim : globalThis);
+
+export const env = new Proxy<EnvObject>(_envShim, {
+	get(_, prop) {
+		const env = _getEnv();
+		return env[prop as any] ?? _envShim[prop];
+	},
+	has(_, prop) {
+		const env = _getEnv();
+		return prop in env || prop in _envShim;
+	},
+	set(_, prop, value) {
+		const env = _getEnv(true);
+		env[prop as any] = value;
+		return true;
+	},
+	deleteProperty(_, prop) {
+		if (!prop) {
+			return false;
+		}
+		const env = _getEnv(true);
+		delete env[prop as any];
+		return true;
+	},
+	ownKeys() {
+		const env = _getEnv(true);
+		return Object.keys(env);
+	},
+});
+
+function toBoolean(val: boolean | string | undefined) {
+	return val ? val !== "false" : false;
+}
+
+export const nodeENV = env.NODE_ENV ?? "";
+
+/** Detect if `NODE_ENV` environment variable is `production` */
+export const isProduction = nodeENV === "production";
+
+/** Detect if `NODE_ENV` environment variable is `dev` or `development` */
+export const isDevelopment = () =>
+	nodeENV === "dev" || nodeENV === "development";
+
+/** Detect if `NODE_ENV` environment variable is `test` */
+export const isTest = () => nodeENV === "test" || toBoolean(env.TEST);
+
+/**
+ * Get environment variable with fallback
+ */
+export function getEnvVar<Fallback extends string>(
+	key: string,
+	fallback?: Fallback,
+): Fallback extends string ? string : string | undefined {
+	if (typeof process !== "undefined" && process.env) {
+		return process.env[key] ?? (fallback as any);
+	}
+
+	// @ts-expect-error deno
+	if (typeof Deno !== "undefined") {
+		// @ts-expect-error deno
+		return Deno.env.get(key) ?? (fallback as string);
+	}
+
+	// Handle Bun
+	if (typeof Bun !== "undefined") {
+		return Bun.env[key] ?? (fallback as string);
+	}
+
+	return fallback as any;
+}
+
+/**
+ * Get boolean environment variable
+ */
+export function getBooleanEnvVar(key: string, fallback = true): boolean {
+	const value = getEnvVar(key);
+	if (!value) return fallback;
+	return value !== "0" && value.toLowerCase() !== "false" && value !== "";
+}
+
+/**
+ * Common environment variables used in Better Auth
+ */
+export const ENV = Object.freeze({
+	get BETTER_AUTH_SECRET() {
+		return getEnvVar("BETTER_AUTH_SECRET");
+	},
+	get AUTH_SECRET() {
+		return getEnvVar("AUTH_SECRET");
+	},
+	get BETTER_AUTH_TELEMETRY() {
+		return getEnvVar("BETTER_AUTH_TELEMETRY");
+	},
+	get BETTER_AUTH_TELEMETRY_ID() {
+		return getEnvVar("BETTER_AUTH_TELEMETRY_ID");
+	},
+	get NODE_ENV() {
+		return getEnvVar("NODE_ENV", "development");
+	},
+	get PACKAGE_VERSION() {
+		return getEnvVar("PACKAGE_VERSION", "0.0.0");
+	},
+	get BETTER_AUTH_TELEMETRY_ENDPOINT(): string | undefined {
+		return getEnvVar(
+			"BETTER_AUTH_TELEMETRY_ENDPOINT",
+			import.meta.env.BETTER_AUTH_TELEMETRY_ENDPOINT,
+		);
+	},
+});