@masheev/better-auth 0.0.0-stage → 1.7.5

package/dist/plugins/phone-number/client.d.mts

@@ -0,0 +1,31 @@
+import { PhoneNumberOptions, UserWithPhoneNumber } from "./types.mjs";
+import { phoneNumber } from "./index.mjs";
+import { PHONE_NUMBER_ERROR_CODES } from "./error-codes.mjs";
+import * as _$_better_auth_core_utils_error_codes0 from "@better-auth/core/utils/error-codes";
+
+//#region src/plugins/phone-number/client.d.ts
+declare const phoneNumberClient: () => {
+  id: "phoneNumber";
+  version: string;
+  $InferServerPlugin: ReturnType<typeof phoneNumber>;
+  atomListeners: {
+    matcher(path: string): path is "/phone-number/verify" | "/sign-in/phone-number" | "/phone-number/update";
+    signal: "$sessionSignal";
+  }[];
+  $ERROR_CODES: {
+    OTP_EXPIRED: _$_better_auth_core_utils_error_codes0.RawError<"OTP_EXPIRED">;
+    INVALID_OTP: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_OTP">;
+    TOO_MANY_ATTEMPTS: _$_better_auth_core_utils_error_codes0.RawError<"TOO_MANY_ATTEMPTS">;
+    INVALID_PHONE_NUMBER: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_PHONE_NUMBER">;
+    PHONE_NUMBER_EXIST: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_EXIST">;
+    PHONE_NUMBER_NOT_EXIST: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_NOT_EXIST">;
+    INVALID_PHONE_NUMBER_OR_PASSWORD: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_PHONE_NUMBER_OR_PASSWORD">;
+    UNEXPECTED_ERROR: _$_better_auth_core_utils_error_codes0.RawError<"UNEXPECTED_ERROR">;
+    OTP_NOT_FOUND: _$_better_auth_core_utils_error_codes0.RawError<"OTP_NOT_FOUND">;
+    PHONE_NUMBER_NOT_VERIFIED: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_NOT_VERIFIED">;
+    PHONE_NUMBER_CANNOT_BE_UPDATED: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_CANNOT_BE_UPDATED">;
+    SEND_OTP_NOT_IMPLEMENTED: _$_better_auth_core_utils_error_codes0.RawError<"SEND_OTP_NOT_IMPLEMENTED">;
+  };
+};
+//#endregion
+export { phoneNumberClient };

package/dist/plugins/phone-number/client.mjs

@@ -0,0 +1,19 @@
+import { PACKAGE_VERSION } from "../../version.mjs";
+import { PHONE_NUMBER_ERROR_CODES } from "./error-codes.mjs";
+//#region src/plugins/phone-number/client.ts
+const phoneNumberClient = () => {
+	return {
+		id: "phoneNumber",
+		version: PACKAGE_VERSION,
+		$InferServerPlugin: {},
+		atomListeners: [{
+			matcher(path) {
+				return path === "/phone-number/update" || path === "/phone-number/verify" || path === "/sign-in/phone-number";
+			},
+			signal: "$sessionSignal"
+		}],
+		$ERROR_CODES: PHONE_NUMBER_ERROR_CODES
+	};
+};
+//#endregion
+export { phoneNumberClient };

package/dist/plugins/phone-number/error-codes.d.mts

@@ -0,0 +1,19 @@
+import * as _$_better_auth_core_utils_error_codes0 from "@better-auth/core/utils/error-codes";
+
+//#region src/plugins/phone-number/error-codes.d.ts
+declare const PHONE_NUMBER_ERROR_CODES: {
+  OTP_EXPIRED: _$_better_auth_core_utils_error_codes0.RawError<"OTP_EXPIRED">;
+  INVALID_OTP: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_OTP">;
+  TOO_MANY_ATTEMPTS: _$_better_auth_core_utils_error_codes0.RawError<"TOO_MANY_ATTEMPTS">;
+  INVALID_PHONE_NUMBER: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_PHONE_NUMBER">;
+  PHONE_NUMBER_EXIST: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_EXIST">;
+  PHONE_NUMBER_NOT_EXIST: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_NOT_EXIST">;
+  INVALID_PHONE_NUMBER_OR_PASSWORD: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_PHONE_NUMBER_OR_PASSWORD">;
+  UNEXPECTED_ERROR: _$_better_auth_core_utils_error_codes0.RawError<"UNEXPECTED_ERROR">;
+  OTP_NOT_FOUND: _$_better_auth_core_utils_error_codes0.RawError<"OTP_NOT_FOUND">;
+  PHONE_NUMBER_NOT_VERIFIED: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_NOT_VERIFIED">;
+  PHONE_NUMBER_CANNOT_BE_UPDATED: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_CANNOT_BE_UPDATED">;
+  SEND_OTP_NOT_IMPLEMENTED: _$_better_auth_core_utils_error_codes0.RawError<"SEND_OTP_NOT_IMPLEMENTED">;
+};
+//#endregion
+export { PHONE_NUMBER_ERROR_CODES };

package/dist/plugins/phone-number/error-codes.mjs

@@ -0,0 +1,18 @@
+import { defineErrorCodes } from "@better-auth/core/utils/error-codes";
+//#region src/plugins/phone-number/error-codes.ts
+const PHONE_NUMBER_ERROR_CODES = defineErrorCodes({
+	INVALID_PHONE_NUMBER: "Invalid phone number",
+	PHONE_NUMBER_EXIST: "Phone number already exists",
+	PHONE_NUMBER_NOT_EXIST: "phone number isn't registered",
+	INVALID_PHONE_NUMBER_OR_PASSWORD: "Invalid phone number or password",
+	UNEXPECTED_ERROR: "Unexpected error",
+	OTP_NOT_FOUND: "OTP not found",
+	OTP_EXPIRED: "OTP expired",
+	INVALID_OTP: "Invalid OTP",
+	PHONE_NUMBER_NOT_VERIFIED: "Phone number not verified",
+	PHONE_NUMBER_CANNOT_BE_UPDATED: "Phone number cannot be updated",
+	SEND_OTP_NOT_IMPLEMENTED: "sendOTP not implemented",
+	TOO_MANY_ATTEMPTS: "Too many attempts"
+});
+//#endregion
+export { PHONE_NUMBER_ERROR_CODES };

package/dist/plugins/phone-number/index.d.mts

@@ -0,0 +1,360 @@
+import { PhoneNumberOptions, UserWithPhoneNumber } from "./types.mjs";
+import * as _$_better_auth_core0 from "@better-auth/core";
+import * as _$_better_auth_core_utils_error_codes0 from "@better-auth/core/utils/error-codes";
+import * as _$better_call0 from "better-call";
+import * as _$zod from "zod";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region src/plugins/phone-number/index.d.ts
+declare module "@better-auth/core" {
+  interface BetterAuthPluginRegistry<AuthOptions, Options> {
+    "phone-number": {
+      creator: typeof phoneNumber;
+    };
+  }
+}
+declare const phoneNumber: (options?: PhoneNumberOptions | undefined) => {
+  id: "phone-number";
+  version: string;
+  init(): {
+    options: {
+      databaseHooks: {
+        user: {
+          update: {
+            before(data: Partial<{
+              id: string;
+              createdAt: Date;
+              updatedAt: Date;
+              email: string;
+              emailVerified: boolean;
+              name: string;
+              image?: string | null | undefined;
+            }> & Record<string, unknown>): Promise<{
+              data: {
+                [x: string]: unknown;
+                id?: string | undefined;
+                createdAt?: Date | undefined;
+                updatedAt?: Date | undefined;
+                email?: string | undefined;
+                emailVerified?: boolean | undefined;
+                name?: string | undefined;
+                image?: string | null | undefined;
+              };
+            } | undefined>;
+          };
+        };
+      };
+    };
+  };
+  hooks: {
+    before: {
+      matcher: (ctx: _$_better_auth_core0.HookEndpointContext) => boolean;
+      handler: _$better_call0.Middleware<_$better_call0.MiddlewareOptions, (inputContext: _$better_call0.MiddlewareInputContext<_$better_call0.MiddlewareOptions>) => Promise<never>>;
+    }[];
+  };
+  endpoints: {
+    signInPhoneNumber: _$better_call0.StrictEndpoint<"/sign-in/phone-number", {
+      method: "POST";
+      body: _$zod.ZodObject<{
+        phoneNumber: _$zod.ZodString;
+        password: _$zod.ZodString;
+        rememberMe: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      }, _$zod_v4_core0.$strip>;
+      metadata: {
+        openapi: {
+          summary: string;
+          description: string;
+          responses: {
+            200: {
+              description: string;
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object";
+                    properties: {
+                      user: {
+                        $ref: string;
+                      };
+                      session: {
+                        $ref: string;
+                      };
+                    };
+                  };
+                };
+              };
+            };
+            400: {
+              description: string;
+            };
+          };
+        };
+      };
+    }, {
+      token: string;
+      user: UserWithPhoneNumber;
+    }>;
+    sendPhoneNumberOTP: _$better_call0.StrictEndpoint<"/phone-number/send-otp", {
+      method: "POST";
+      body: _$zod.ZodObject<{
+        phoneNumber: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+      metadata: {
+        openapi: {
+          summary: string;
+          description: string;
+          responses: {
+            200: {
+              description: string;
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object";
+                    properties: {
+                      message: {
+                        type: string;
+                      };
+                    };
+                  };
+                };
+              };
+            };
+          };
+        };
+      };
+    }, {
+      message: string;
+    }>;
+    consumePhoneNumberOTP: _$better_call0.StrictEndpoint<string, {
+      method: "POST";
+      body: _$zod.ZodObject<{
+        phoneNumber: _$zod.ZodString;
+        code: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+      metadata: {
+        readonly scope: "server";
+      };
+    }, {
+      status: boolean;
+    }>;
+    verifyPhoneNumber: _$better_call0.StrictEndpoint<"/phone-number/verify", {
+      method: "POST";
+      body: _$zod.ZodIntersection<_$zod.ZodObject<{
+        phoneNumber: _$zod.ZodString;
+        code: _$zod.ZodString;
+        disableSession: _$zod.ZodOptional<_$zod.ZodBoolean>;
+        updatePhoneNumber: _$zod.ZodOptional<_$zod.ZodBoolean>;
+      }, _$zod_v4_core0.$strip>, _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodAny>>;
+      metadata: {
+        openapi: {
+          summary: string;
+          description: string;
+          responses: {
+            "200": {
+              description: string;
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object";
+                    properties: {
+                      status: {
+                        type: string;
+                        description: string;
+                        enum: boolean[];
+                      };
+                      token: {
+                        type: string;
+                        nullable: boolean;
+                        description: string;
+                      };
+                      user: {
+                        type: string;
+                        nullable: boolean;
+                        properties: {
+                          id: {
+                            type: string;
+                            description: string;
+                          };
+                          email: {
+                            type: string;
+                            format: string;
+                            nullable: boolean;
+                            description: string;
+                          };
+                          emailVerified: {
+                            type: string;
+                            nullable: boolean;
+                            description: string;
+                          };
+                          name: {
+                            type: string;
+                            nullable: boolean;
+                            description: string;
+                          };
+                          image: {
+                            type: string;
+                            format: string;
+                            nullable: boolean;
+                            description: string;
+                          };
+                          phoneNumber: {
+                            type: string;
+                            description: string;
+                          };
+                          phoneNumberVerified: {
+                            type: string;
+                            description: string;
+                          };
+                          createdAt: {
+                            type: string;
+                            format: string;
+                            description: string;
+                          };
+                          updatedAt: {
+                            type: string;
+                            format: string;
+                            description: string;
+                          };
+                        };
+                        required: string[];
+                        description: string;
+                      };
+                    };
+                    required: string[];
+                  };
+                };
+              };
+            };
+            400: {
+              description: string;
+            };
+          };
+        };
+      };
+    }, {
+      status: boolean;
+      token: string;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      } & UserWithPhoneNumber;
+    } | {
+      status: boolean;
+      token: null;
+      user: UserWithPhoneNumber;
+    }>;
+    requestPasswordResetPhoneNumber: _$better_call0.StrictEndpoint<"/phone-number/request-password-reset", {
+      method: "POST";
+      body: _$zod.ZodObject<{
+        phoneNumber: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+      metadata: {
+        openapi: {
+          description: string;
+          responses: {
+            "200": {
+              description: string;
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object";
+                    properties: {
+                      status: {
+                        type: string;
+                        description: string;
+                        enum: boolean[];
+                      };
+                    };
+                    required: string[];
+                  };
+                };
+              };
+            };
+          };
+        };
+      };
+    }, {
+      status: boolean;
+    }>;
+    resetPasswordPhoneNumber: _$better_call0.StrictEndpoint<"/phone-number/reset-password", {
+      method: "POST";
+      body: _$zod.ZodObject<{
+        otp: _$zod.ZodString;
+        phoneNumber: _$zod.ZodString;
+        newPassword: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>;
+      metadata: {
+        openapi: {
+          description: string;
+          responses: {
+            "200": {
+              description: string;
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object";
+                    properties: {
+                      status: {
+                        type: string;
+                        description: string;
+                        enum: boolean[];
+                      };
+                    };
+                    required: string[];
+                  };
+                };
+              };
+            };
+          };
+        };
+      };
+    }, {
+      status: boolean;
+    }>;
+  };
+  schema: {
+    user: {
+      fields: {
+        phoneNumber: {
+          type: "string";
+          required: false;
+          unique: true;
+          sortable: true;
+          returned: true;
+        };
+        phoneNumberVerified: {
+          type: "boolean";
+          required: false;
+          returned: true;
+          input: false;
+        };
+      };
+    };
+  };
+  rateLimit: {
+    pathMatcher(path: string): boolean;
+    window: number;
+    max: number;
+  }[];
+  options: PhoneNumberOptions | undefined;
+  $ERROR_CODES: {
+    OTP_EXPIRED: _$_better_auth_core_utils_error_codes0.RawError<"OTP_EXPIRED">;
+    INVALID_OTP: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_OTP">;
+    TOO_MANY_ATTEMPTS: _$_better_auth_core_utils_error_codes0.RawError<"TOO_MANY_ATTEMPTS">;
+    INVALID_PHONE_NUMBER: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_PHONE_NUMBER">;
+    PHONE_NUMBER_EXIST: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_EXIST">;
+    PHONE_NUMBER_NOT_EXIST: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_NOT_EXIST">;
+    INVALID_PHONE_NUMBER_OR_PASSWORD: _$_better_auth_core_utils_error_codes0.RawError<"INVALID_PHONE_NUMBER_OR_PASSWORD">;
+    UNEXPECTED_ERROR: _$_better_auth_core_utils_error_codes0.RawError<"UNEXPECTED_ERROR">;
+    OTP_NOT_FOUND: _$_better_auth_core_utils_error_codes0.RawError<"OTP_NOT_FOUND">;
+    PHONE_NUMBER_NOT_VERIFIED: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_NOT_VERIFIED">;
+    PHONE_NUMBER_CANNOT_BE_UPDATED: _$_better_auth_core_utils_error_codes0.RawError<"PHONE_NUMBER_CANNOT_BE_UPDATED">;
+    SEND_OTP_NOT_IMPLEMENTED: _$_better_auth_core_utils_error_codes0.RawError<"SEND_OTP_NOT_IMPLEMENTED">;
+  };
+};
+//#endregion
+export { type PhoneNumberOptions, type UserWithPhoneNumber, phoneNumber };

package/dist/plugins/phone-number/index.mjs

@@ -0,0 +1,57 @@
+import { mergeSchema } from "../../db/schema.mjs";
+import { PACKAGE_VERSION } from "../../version.mjs";
+import { PHONE_NUMBER_ERROR_CODES } from "./error-codes.mjs";
+import { consumePhoneNumberOTP, requestPasswordResetPhoneNumber, resetPasswordPhoneNumber, sendPhoneNumberOTP, signInPhoneNumber, verifyPhoneNumber } from "./routes.mjs";
+import { schema } from "./schema.mjs";
+import { APIError } from "@better-auth/core/error";
+import { createAuthMiddleware } from "@better-auth/core/api";
+//#region src/plugins/phone-number/index.ts
+const phoneNumber = (options) => {
+	const opts = {
+		expiresIn: options?.expiresIn || 300,
+		otpLength: options?.otpLength || 6,
+		...options,
+		phoneNumber: "phoneNumber",
+		phoneNumberVerified: "phoneNumberVerified",
+		code: "code",
+		createdAt: "createdAt"
+	};
+	return {
+		id: "phone-number",
+		version: PACKAGE_VERSION,
+		init() {
+			return { options: { databaseHooks: { user: { update: { async before(data) {
+				if (opts.phoneNumber in data && data[opts.phoneNumber] === null) return { data: {
+					...data,
+					[opts.phoneNumberVerified]: false
+				} };
+			} } } } } };
+		},
+		hooks: { before: [{
+			matcher: (ctx) => ctx.path === "/update-user" && "phoneNumber" in ctx.body && ctx.body.phoneNumber !== null,
+			handler: createAuthMiddleware(async (_ctx) => {
+				throw APIError.from("BAD_REQUEST", PHONE_NUMBER_ERROR_CODES.PHONE_NUMBER_CANNOT_BE_UPDATED);
+			})
+		}] },
+		endpoints: {
+			signInPhoneNumber: signInPhoneNumber(opts),
+			sendPhoneNumberOTP: sendPhoneNumberOTP(opts),
+			consumePhoneNumberOTP: consumePhoneNumberOTP(opts),
+			verifyPhoneNumber: verifyPhoneNumber(opts),
+			requestPasswordResetPhoneNumber: requestPasswordResetPhoneNumber(opts),
+			resetPasswordPhoneNumber: resetPasswordPhoneNumber(opts)
+		},
+		schema: mergeSchema(schema, options?.schema),
+		rateLimit: [{
+			pathMatcher(path) {
+				return path.startsWith("/phone-number");
+			},
+			window: 60,
+			max: 10
+		}],
+		options,
+		$ERROR_CODES: PHONE_NUMBER_ERROR_CODES
+	};
+};
+//#endregion
+export { phoneNumber };