@cloudbase/auth 3.3.5 → 3.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/auth",
-  "version": "3.3.5",
+  "version": "3.3.7",
   "description": "cloudbase javascript sdk auth componets",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -32,14 +32,14 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@cloudbase/adapter-wx_mp": "^1.3.1",
-    "@cloudbase/oauth": "3.3.5",
-    "@cloudbase/utilities": "3.3.5"
+    "@cloudbase/oauth": "3.3.7",
+    "@cloudbase/utilities": "3.3.7"
   },
   "devDependencies": {
-    "@cloudbase/types": "3.3.5",
+    "@cloudbase/types": "3.3.7",
     "@types/node": "^22.1.0",
     "terser-webpack-plugin": "^3.0.2",
     "webpack-bundle-analyzer": "^4.9.1"
   },
-  "gitHead": "c49e85b029e204845cc7e402aef4ca7af89b7875"
+  "gitHead": "5672a09a1ff61507bc68dc5ba405434680bf4297"
 }

package/src/index.ts

@@ -152,6 +152,7 @@ export class User implements IUser {
   public locale?: string
   public sub?: string
   public createdFrom?: string
+  public open_id?: string
 
   private cache: ICloudbaseCache
   private oauthInstance: CloudbaseOAuth // CloudbaseOAuth 类型
@@ -332,6 +333,7 @@ export class User implements IUser {
       'providers',
       'username',
       'created_at',
+      'open_id',
     ].forEach((infoKey) => {
       this[infoKey] = userInfo[infoKey]
     })
@@ -401,11 +403,26 @@ class Auth extends AuthV1Compat {
   // ========== new auth api methods merged below ==========
 
   /**
-   * https://supabase.com/docs/reference/javascript/auth-signinanonymously
-   * Sign in a user anonymously.
+   * 匿名登录。无需用户注册即可使用应用功能。
+   *
+   * **前置条件**：需要在云开发控制台开启「匿名登录」。
+   *
+   * **重要**：匿名登录必须在使用 watch() 等实时数据库功能之前完成，
+   * 否则 WebSocket 连接会因缺少认证信息而失败。
+   *
+   * @see https://supabase.com/docs/reference/javascript/auth-signinanonymously
+   *
+   * @example
+   * ```typescript
    * const { data, error } = await auth.signInAnonymously();
-   * @param params
-   * @returns  Promise<SignInRes>
+   * if (!error) {
+   *   console.log('用户ID:', data.user.id, '是否匿名:', data.user.is_anonymous);
+   *   // 现在可以使用 watch() 等实时功能
+   * }
+   * ```
+   *
+   * @param params 可选参数
+   * @returns 登录结果，成功时 data 包含 user 和 session
    */
   async signInAnonymously(params: SignInAnonymouslyReq): Promise<SignInRes> {
     try {
@@ -2512,6 +2529,7 @@ class Auth extends AuthV1Compat {
         avatarUrl: userInfo.avatarUrl || userInfo.picture,
         location: userInfo.location,
         hasPassword: userInfo.hasPassword,
+        open_id: userInfo?.open_id,
       },
       identities:
         userInfo?.providers?.map(p => ({

package/src/type.ts

@@ -312,6 +312,8 @@ export interface SignInWithOtpRes {
 
 export interface SignUpRes {
   data: {
+    user?: User // 用户信息（手机号验证码注册直接返回）
+    session?: Session // 会话信息（手机号验证码注册直接返回）
     verifyOtp?: OtpCallback // 验证码回调函数，支持messageId参数
   }
   error: AuthError | null

package/src/v1-compat.ts

@@ -240,7 +240,8 @@ export abstract class AuthV1Compat {
 
   /**
    * v1 API: 发送手机验证码
-   * @deprecated 建议使用 auth.signInWithOtp({ phone }) 或 auth.getVerification({ phone_number }) 替代。
+   * @deprecated 推荐使用 auth.signInWithOtp({ phone }) 替代，可获得"发送→验证→登录"完整流程。
+   * 此方法仅发送验证码并返回 boolean，不会返回 verifyOtp 回调。
    */
   public async sendPhoneCode(phoneNumber: string): Promise<boolean> {
     if (typeof phoneNumber !== 'string') {
@@ -255,7 +256,7 @@ export abstract class AuthV1Compat {
 
   /**
    * v1 API: 手机号注册（支持短信验证码+密码方式）
-   * @deprecated 建议使用 auth.signUp({ phone_number, verification_code, password? }) 替代。
+   * @deprecated 推荐使用 auth.signUp({ phone, password? }) 替代，支持验证码验证一体化流程。
    */
   public async signUpWithPhoneCode(phoneNumber: string, phoneCode: string, password?: string): Promise<any> {
     if (typeof phoneNumber !== 'string') {
@@ -278,8 +279,8 @@ export abstract class AuthV1Compat {
 
   /**
    * v1 API: 手机号登录（支持短信验证码 or 密码方式）
-   * @deprecated 密码方式建议使用 auth.signInWithPassword({ phone, password }) 替代；
-   * 验证码方式建议使用 auth.signInWithOtp({ phone }) 替代。
+   * @deprecated 密码方式推荐 auth.signInWithPassword({ phone, password })；
+   * 验证码方式推荐 auth.signInWithOtp({ phone })，返回 verifyOtp 回调完成验证。
    */
   public async signInWithPhoneCodeOrPassword(params: {
     phoneNumber: string