@masheev/better-auth 0.0.0-stage → 1.7.5

package/dist/db/field.d.mts

@@ -0,0 +1,41 @@
+import { DBFieldAttribute, InferDBValueType } from "@better-auth/core/db";
+
+//#region src/db/field.d.ts
+type InferFieldsOutput<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]: InferFieldOutput<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]?: InferFieldOutput<Fields[key]> | null } : never;
+/**
+ * For client will add "?" on optional fields
+ */
+type InferFieldsInputClient<Fields extends Record<string, DBFieldAttribute>> = Fields extends Record<infer Key, DBFieldAttribute> ? { [key in Key as Fields[key]["required"] extends false ? never : Fields[key]["defaultValue"] extends string | number | boolean | Date ? never : Fields[key]["input"] extends false ? never : key]: InferFieldInput<Fields[key]> } & { [key in Key as Fields[key]["input"] extends false ? never : Fields[key]["required"] extends false ? key : Fields[key]["defaultValue"] extends string | number | boolean | Date ? key : never]?: InferFieldInput<Fields[key]> | undefined | null } : never;
+type InferFieldOutput<T extends DBFieldAttribute> = T["returned"] extends false ? never : T["required"] extends false ? InferDBValueType<T["type"]> | undefined | null : InferDBValueType<T["type"]>;
+/**
+ * Converts a Record<string, DBFieldAttribute> to an object type
+ * with keys and value types inferred from DBFieldAttribute["type"].
+ */
+type FieldAttributeToObject<Fields extends Record<string, DBFieldAttribute>> = AddOptionalFields<{ [K in keyof Fields]: InferDBValueType<Fields[K]["type"]> }, Fields>;
+type AddOptionalFields<T extends Record<string, any>, Fields extends Record<keyof T, DBFieldAttribute>> = { [K in keyof T as Fields[K] extends {
+  required: false;
+} ? never : K]: T[K] } & { [K in keyof T as Fields[K] extends {
+  required: false;
+} ? K : never]?: T[K] };
+/**
+ * Infer the additional fields from the plugin options.
+ * For example, you can infer the additional fields of the org plugin's organization schema like this:
+ * ```ts
+ * type AdditionalFields = InferAdditionalFieldsFromPluginOptions<"organization", OrganizationOptions>
+ * ```
+ *
+ * @param isClientSide - When `true` (default), filters out `input: false` fields (clients can't send these).
+ *   When `false`, includes all fields (for internal/server-side use).
+ */
+type InferAdditionalFieldsFromPluginOptions<SchemaName extends string, Options extends {
+  schema?: { [key in SchemaName]?: {
+    additionalFields?: Record<string, DBFieldAttribute>;
+  } } | undefined;
+}, isClientSide extends boolean = true> = Options["schema"] extends { [key in SchemaName]?: {
+  additionalFields: infer Field extends Record<string, DBFieldAttribute>;
+} } ? isClientSide extends true ? FieldAttributeToObject<RemoveFieldsWithInputFalse<Field>> : FieldAttributeToObject<Field> : {};
+type RemoveFieldsWithInputFalse<T extends Record<string, DBFieldAttribute>> = { [K in keyof T as T[K]["input"] extends false ? never : K]: T[K] };
+type RemoveFieldsWithReturnedFalse<T extends Record<string, DBFieldAttribute>> = { [K in keyof T as T[K]["returned"] extends false ? never : K]: T[K] };
+type InferFieldInput<T extends DBFieldAttribute> = InferDBValueType<T["type"]>;
+//#endregion
+export { FieldAttributeToObject, InferAdditionalFieldsFromPluginOptions, InferFieldsInputClient, InferFieldsOutput, RemoveFieldsWithReturnedFalse };

package/dist/db/get-migration.d.mts

@@ -0,0 +1,56 @@
+import { BetterAuthOptions } from "@better-auth/core";
+import { DBFieldAttribute, DBFieldType } from "@better-auth/core/db";
+import { BetterAuthError } from "@better-auth/core/error";
+import { KyselyDatabaseType } from "@better-auth/kysely-adapter";
+import { ResolvedDBTableIndex } from "@better-auth/core/db/internal";
+
+//#region src/db/get-migration.d.ts
+/**
+ * Thrown when {@link getMigrations} refuses to add a required column with no
+ * default value to a populated table. Distinct from the plain
+ * {@link BetterAuthError} thrown for index-definition conflicts, so callers
+ * can tell the two apart without matching on message text.
+ */
+declare class UnsafeMigrationError extends BetterAuthError {}
+declare function matchType(columnDataType: string, fieldType: DBFieldType, dbType: KyselyDatabaseType): boolean;
+/**
+ * Build the migration plan that `auth migrate` executes and `auth generate`
+ * prints for the Kysely adapter.
+ *
+ * Adding a required column without a default to a populated table is refused:
+ * existing rows have no value to backfill. `throwOnUnsafe` picks how that
+ * refusal is delivered: executing callers get an {@link UnsafeMigrationError},
+ * read-only callers get the plan plus the same message in `unsafeChanges`.
+ *
+ * @throws {UnsafeMigrationError} when a required column cannot be migrated
+ * safely and `throwOnUnsafe` is left on.
+ * @throws {BetterAuthError} when an index definition conflicts with an
+ * existing or already-planned index.
+ */
+declare function getMigrations(config: BetterAuthOptions, {
+  throwOnUnsafe
+}?: {
+  throwOnUnsafe?: boolean;
+}): Promise<{
+  toBeCreated: {
+    table: string;
+    fields: Record<string, DBFieldAttribute>;
+    order: number;
+  }[];
+  toBeAdded: {
+    table: string;
+    fields: Record<string, DBFieldAttribute>;
+    order: number;
+  }[];
+  toBeAddedIndexes: {
+    table: string;
+    index: ResolvedDBTableIndex;
+    name: string;
+  }[];
+  unsafeChanges: string[];
+  schemaProblems: string[];
+  runMigrations: () => Promise<void>;
+  compileMigrations: () => Promise<string>;
+}>;
+//#endregion
+export { UnsafeMigrationError, getMigrations, matchType };