@better-auth/core 1.3.23 → 1.3.24

package/.turbo/turbo-build.log

@@ -1,21 +1,22 @@
 
-> @better-auth/core@1.3.23 build /home/runner/work/better-auth/better-auth/packages/core
+> @better-auth/core@1.3.24 build /home/runner/work/better-auth/better-auth/packages/core
 > unbuild --clean
 
 [info] Building core
 [info] Cleaning dist directory: `./dist`
 Generated an empty chunk: "index".
+Generated an empty chunk: "db/index".
 Generated an empty chunk: "index".
+Generated an empty chunk: "db/index".
 Generated an empty chunk: "index".
 Generated an empty chunk: "index".
 Generated an empty chunk: "index".
 [success] Build succeeded for core
 [log]   dist/index.cjs (total size: 15 B, chunk size: 15 B)
 
+[log]   dist/db/index.cjs (total size: 15 B, chunk size: 15 B)
 [log]   dist/index.mjs (total size: 1 B, chunk size: 1 B)
 
-Σ Total dist size (byte size): 55 B
+[log]   dist/db/index.mjs (total size: 1 B, chunk size: 1 B)
+Σ Total dist size (byte size): 11.1 kB
 [log]
-[warn] Build is done with some warnings:
-
-- Potential missing package.json files: dist/index.d.cjs

package/build.config.ts

@@ -8,5 +8,5 @@ export default defineBuildConfig({
 	outDir: "dist",
 	clean: true,
 	failOnWarn: false,
-	entries: ["./src/index.ts"],
+	entries: ["./src/index.ts", "./src/db/index.ts"],
 });

package/dist/db/index.cjs

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/db/index.d.cts

@@ -0,0 +1,130 @@
+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.d.mts

@@ -0,0 +1,130 @@
+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.d.ts

@@ -0,0 +1,130 @@
+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

@@ -0,0 +1 @@
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-auth/core",
-  "version": "1.3.23",
+  "version": "1.3.24",
   "description": "The most comprehensive authentication library for TypeScript.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -12,21 +12,38 @@
         "default": "./dist/index.mjs"
       },
       "require": {
-        "types": "./dist/index.d.cjs",
+        "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./db": {
+      "import": {
+        "types": "./dist/db/index.d.ts",
+        "default": "./dist/db/index.mjs"
+      },
+      "require": {
+        "types": "./dist/db/index.d.cts",
+        "default": "./dist/db/index.cjs"
+      }
     }
   },
   "typesVersions": {
     "*": {
       "index": [
         "dist/index.d.ts"
+      ],
+      "db": [
+        "dist/db.d.ts"
       ]
     }
   },
   "devDependencies": {
     "unbuild": "3.6.1"
   },
+  "dependencies": {
+    "better-call": "1.0.19",
+    "zod": "^4.1.5"
+  },
   "scripts": {
     "build": "unbuild --clean",
     "stub": "unbuild --stub",

package/src/db/index.ts

@@ -0,0 +1,36 @@
+import type {
+	DBFieldAttribute,
+	DBFieldAttributeConfig,
+	DBFieldType,
+	DBPrimitive,
+	BetterAuthDBSchema,
+} from "./type";
+
+export type {
+	DBFieldAttribute,
+	DBFieldAttributeConfig,
+	DBFieldType,
+	DBPrimitive,
+	BetterAuthDBSchema,
+};
+
+/**
+ * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
+ */
+export type FieldAttribute = DBFieldAttribute;
+/**
+ * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
+ */
+export type FieldAttributeConfig = DBFieldAttributeConfig;
+/**
+ * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
+ */
+export type FieldType = DBFieldType;
+/**
+ * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
+ */
+export type Primitive = DBPrimitive;
+/**
+ * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
+ */
+export type BetterAuthDbSchema = BetterAuthDBSchema;

package/src/db/type.ts

@@ -0,0 +1,133 @@
+import type { ZodType } from "zod";
+import type { LiteralString } from "../types";
+
+export type DBFieldType =
+	| "string"
+	| "number"
+	| "boolean"
+	| "date"
+	| "json"
+	| `${"string" | "number"}[]`
+	| Array<LiteralString>;
+
+export type DBPrimitive =
+	| string
+	| number
+	| boolean
+	| Date
+	| null
+	| undefined
+	| string[]
+	| number[];
+
+export 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;
+};
+
+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;
+		/**
+		 * The order of the table
+		 */
+		order?: number;
+	}
+>;

package/src/types/helper.ts

@@ -0,0 +1 @@
+export type LiteralString = "" | (string & Record<never, never>);

package/src/types/index.ts

@@ -0,0 +1 @@
+export * from "./helper";