@tencent-ai/workbuddy-cloud-sdk 0.1.0-dev.bc6bd2a.202608212343 → 0.1.1-dev.2eb913e.202609082341

package/README.md

@@ -0,0 +1,28 @@
+# WorkBuddy Cloud SDK
+
+通过 WorkBuddy 云服务的 `publicConfig` 访问 Auth、Database、Storage 和 LLM。
+
+## 微信小程序
+
+在小程序项目的 `package.json` 所在目录安装依赖：
+
+```sh
+npm install @tencent-ai/workbuddy-cloud-sdk@dev
+```
+
+然后在微信开发者工具中执行「工具 → 构建 npm」，确认生成
+`miniprogram_npm/@tencent-ai/workbuddy-cloud-sdk/miniprogram.js`，再点击「编译」。
+仅写入 `package.json` 不会安装依赖；升级 SDK 后也需要重新构建 npm。
+
+```js
+const { createMiniProgramWorkBuddyCloud } = require('@tencent-ai/workbuddy-cloud-sdk/miniprogram');
+
+const cloud = createMiniProgramWorkBuddyCloud({
+    endpoint: publicConfig.endpoint,
+    publishableKey: publicConfig.publishableKey,
+});
+```
+
+SDK 通过 `package.json#miniprogram` 提供微信专用的 CommonJS `.js` 产物，
+其中已打包运行时依赖。现有 Web / Node 的根入口和 `/miniprogram` 子入口保持不变。
+WorkBuddy H5 预览会注入 SDK，预览成功不能替代微信项目的安装、构建 npm 验证。

package/lib/index.cjs

@@ -109,11 +109,11 @@ function resolveFetch(candidate) {
 __name(resolveFetch, "resolveFetch");
 function resolveRuntimeConfig(options) {
   if (!options || typeof options !== "object") {
-    throw new WorkBuddyCloudConfigError("createWorkBuddyCloud requires oauthRelayBaseUrl and publishableKey.");
+    throw new WorkBuddyCloudConfigError("createWorkBuddyCloud requires publishableKey.");
   }
   return Object.freeze({
     endpoint: resolveEndpoint(options.endpoint),
-    oauthRelayBaseUrl: normalizeHttpUrl(options.oauthRelayBaseUrl, "oauthRelayBaseUrl"),
+    oauthRelayBaseUrl: options.oauthRelayBaseUrl ? normalizeHttpUrl(options.oauthRelayBaseUrl, "oauthRelayBaseUrl") : "",
     publishableKey: normalizePublishableKey(options.publishableKey),
     fetch: resolveFetch(options.fetch)
   });
@@ -157,6 +157,8 @@ var AUTH_PATHS = {
   signInWithProvider: "/v1/signin/with/provider",
   /** 本地续期端点（服务端不转发上游）。 */
   token: "/v1/token",
+  /** 小程序微信登录：本地认人后仍需用 custom 票据换取 TCB session。 */
+  loginWechat: "/v1/login-wechat",
   signOut: "/v1/user/signout",
   userMe: "/v1/user/me",
   /** 发码。 */
@@ -582,15 +584,34 @@ var AuthModule = class {
       password: credentials.password
     });
   }
+  /**
+   * 小程序 wx.login 的 code 换 Genie session。
+   * 试用与正式是两套独立小程序，必须带当前账号的 appid
+   *（`wx.getAccountInfoSync().miniProgram.appId`）。
+   */
+  async signInWithWechat(code, appid) {
+    if (!code) {
+      return fail(badRequest("signInWithWechat requires code"));
+    }
+    if (!appid) {
+      return fail(badRequest("signInWithWechat requires appid"));
+    }
+    return this.postForSession(AUTH_PATHS.loginWechat, {
+      code,
+      appid
+    });
+  }
   /**
    * 注册。
    *
    * 上游要求先完成验证码验证，所以必须带一个 `verificationToken`（来自
    * `verifyOtp`）。只有用户名+密码的注册会被上游明确拒绝。
+   *
+   * 账号标识用 `email` 或 `phone`（二选一，与发码渠道一致）。
    */
   async signUp(credentials) {
-    if (!credentials.email) {
-      return fail(badRequest("signUp requires email"));
+    if (!credentials.email && !credentials.phone) {
+      return fail(badRequest("signUp requires email or phone"));
     }
     if (!credentials.verificationToken) {
       return fail(badRequest("signUp requires a verificationToken; run sendOtp + verifyOtp first (the provider rejects username+password-only signup)"));
@@ -598,28 +619,40 @@ var AuthModule = class {
     const body = {
       verification_token: credentials.verificationToken
     };
-    body.email = credentials.email;
+    if (credentials.phone) body.phone_number = credentials.phone;
+    if (credentials.email) body.email = credentials.email;
     if (credentials.password) body.password = credentials.password;
     return this.postForSession(AUTH_PATHS.signUp, body);
   }
   /**
-   * 发邮箱验证码。
+   * 发验证码（邮箱或短信，由 `credentials` 传的字段决定）。
    *
    * 这一步**不产生会话**，只返回一个 `verificationId`。发码由上游完成，
    * 我方不实现发码逻辑。
    *
    * 返回的 `isExistingUser` 决定验码之后走登录还是注册 —— 该判断由上游给出，
    * SDK 不猜。
+   *
+   * 两条渠道的请求体差异是刻意的（runtime-auth-design §3.1）：
+   * - 邮箱：`{ email, usage: 'EMAIL' }`
+   * - 手机：`{ phone_number, target: 'ANY' }` —— **不带 `usage`**（普通短信登录
+   *   发码时省略即可，上游没有对应的短信枚举值），`target: 'ANY'` 表示新老用户
+   *   都允许发码。
    */
   async sendOtp(credentials) {
-    if (!credentials.email) {
-      return fail(badRequest("sendOtp requires email"));
+    const body = {};
+    if (credentials.phone) {
+      body.phone_number = credentials.phone;
+      body.target = "ANY";
+    } else if (credentials.email) {
+      body.email = credentials.email;
+      body.usage = "EMAIL";
+      if (credentials.emailRedirectTo) {
+        body.email_redirect_to = credentials.emailRedirectTo;
+      }
+    } else {
+      return fail(badRequest("sendOtp requires email or phone"));
     }
-    const body = {
-      email: credentials.email,
-      usage: "EMAIL"
-    };
-    if (credentials.emailRedirectTo) body.email_redirect_to = credentials.emailRedirectTo;
     const res = await this.request(AUTH_PATHS.verification, {
       method: "POST",
       body
@@ -648,11 +681,13 @@ var AuthModule = class {
       verificationId,
       isExistingUser,
       isUser: isExistingUser,
-      verify: /* @__PURE__ */ __name(({ token }) => this.verifyOtp({
+      verify: /* @__PURE__ */ __name(({ token, password }) => this.verifyOtp({
         verificationId,
         token,
         email: credentials.email,
-        isExistingUser
+        phone: credentials.phone,
+        isExistingUser,
+        password
       }), "verify")
     });
   }
@@ -665,10 +700,14 @@ var AuthModule = class {
    * 走登录还是注册由 `isExistingUser` 决定（`sendOtp` 的返回值）。刻意不做
    * 「先试登录失败再试注册」的兜底：那会把「密码错」这类真实错误掩盖成一次
    * 莫名的注册尝试。
+   *
+   * 登录侧邮箱与手机号共用 `username` 字段 —— 上游 `SignInRequest.username`
+   * 承载邮箱/手机/用户名三种形态（runtime-auth-design §3.2）。
    */
   async verifyOtp(params) {
-    if (!params.verificationId || !params.token || !params.email) {
-      return fail(badRequest("verifyOtp requires verificationId, token and email"));
+    const identifier = params.phone ?? params.email ?? "";
+    if (!params.verificationId || !params.token || !identifier) {
+      return fail(badRequest("verifyOtp requires verificationId, token and either email or phone"));
     }
     const verified = await this.request(AUTH_PATHS.verificationVerify, {
       method: "POST",
@@ -687,12 +726,13 @@ var AuthModule = class {
     }
     if (params.isExistingUser) {
       return this.postForSession(AUTH_PATHS.signIn, {
-        username: params.email,
+        username: identifier,
         verification_token: verificationToken
       });
     }
     return this.signUp({
       email: params.email,
+      phone: params.phone,
       password: params.password ?? "",
       verificationToken
     });
@@ -709,8 +749,13 @@ var AuthModule = class {
    *
    * SDK 不自己跳转（不写 `location.href`）：跳转时机应由应用决定 —— 有的要
    * 先存草稿，有的在 iframe 里要开弹窗。返回 url 交调用方处置。
+   *
+   * @deprecated Google 登录已下线，新应用不应再调用该方法。
    */
   async signInWithOAuth(options) {
+    if (!this.oauthRelayBaseUrl) {
+      return fail(badRequest("signInWithOAuth requires oauthRelayBaseUrl"));
+    }
     if (options.provider !== "google") {
       return fail(badRequest("signInWithOAuth currently supports only google"));
     }
@@ -725,6 +770,8 @@ var AuthModule = class {
    *
    * 在回调落地页调一次即可。`code` 缺失时返回 `null` 数据而**不是**错误 ——
    * 落地页可能被直接访问（用户收藏了它），那不是失败。
+   *
+   * @deprecated Google 登录已下线，新应用不应再调用该方法。
    */
   async handleOAuthCallback(search) {
     const callbackInput = search ?? currentPageSearch();
@@ -959,7 +1006,11 @@ var AuthModule = class {
   // ------------------------------------------------------------------
   // 内部
   // ------------------------------------------------------------------
-  /** 拼出平台 Relay 授权地址；state 由 Relay 自己签发、校验并一次性消费。 */
+  /**
+   * 拼出平台 Relay 授权地址；state 由 Relay 自己签发、校验并一次性消费。
+   *
+   * @deprecated Google 登录已下线，仅保留给存量应用的回调落地页。
+   */
   async startRelayOAuth(options, redirectTo) {
     const callback = new URL(redirectTo);
     const relay = new URL(`${this.oauthRelayBaseUrl}/authorize`);