@heybox/hb-sdk-protocol 0.8.1 → 0.8.2-alpha.1

package/dist/index.cjs.js

@@ -593,8 +593,8 @@ function isOperationList(value) {
         new Set(value).size === value.length);
 }
 
-/** 当前用户信息与登录能力支持的完整 scope 目录。 */
-const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile'];
+/** 当前用户信息与登录能力支持的完整 scope 目录（canonical 顺序）。 */
+const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile', 'steam_account'];
 /** Companion alias 的跨构建、Runtime 与 Host 规范。 */
 const COMPANION_ALIAS_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
 /** Companion Host 可跨 bridge 保留的稳定领域错误码。 */

package/dist/index.esm.js

@@ -591,8 +591,8 @@ function isOperationList(value) {
         new Set(value).size === value.length);
 }
 
-/** 当前用户信息与登录能力支持的完整 scope 目录。 */
-const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile'];
+/** 当前用户信息与登录能力支持的完整 scope 目录（canonical 顺序）。 */
+const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile', 'steam_account'];
 /** Companion alias 的跨构建、Runtime 与 Host 规范。 */
 const COMPANION_ALIAS_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
 /** Companion Host 可跨 bridge 保留的稳定领域错误码。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk-protocol",
-  "version": "0.8.1",
+  "version": "0.8.2-alpha.1",
   "description": "Heybox mini-program iframe bridge wire contracts.",
   "sideEffects": false,
   "exports": {

package/src/payloads.ts

@@ -1,5 +1,5 @@
-/** 当前用户信息与登录能力支持的完整 scope 目录。 */
-export const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile'] as const;
+/** 当前用户信息与登录能力支持的完整 scope 目录（canonical 顺序）。 */
+export const USER_INFO_AUTHORIZATION_SCOPES = ['identity', 'profile', 'steam_account'] as const;
 
 /** 用户信息授权 scope。 */
 export type UserInfoAuthorizationScope = (typeof USER_INFO_AUTHORIZATION_SCOPES)[number];
@@ -16,10 +16,19 @@ export interface LoginResult {
 /** 用户资料授权状态。 */
 export type UserInfoAuthorizationStatus = 'not_required' | 'not_requested' | 'granted' | 'denied';
 
-type CanonicalUserInfoAuthorization = Record<UserInfoAuthorizationScope, UserInfoAuthorizationStatus>;
-
-/** 当前小程序对 canonical 用户信息 scope 的授权状态。 */
-export interface UserInfoAuthorization extends CanonicalUserInfoAuthorization {}
+/**
+ * 当前小程序对 canonical 用户信息 scope 的授权状态。
+ *
+ * @remarks
+ * `steam_account` 是可选键：新能力版本的 Runtime 必定返回，legacy Runtime/Version 可以
+ * 缺失。已授权不代表当前一定已绑定 Steam，只有 {@link AuthorizedUserInfo.steam_id}
+ * 存在才表示当前有主绑定。
+ */
+export interface UserInfoAuthorization {
+  identity: UserInfoAuthorizationStatus;
+  profile: UserInfoAuthorizationStatus;
+  steam_account?: UserInfoAuthorizationStatus;
+}
 
 /**
  * 已获准向当前小程序披露的用户资料。
@@ -43,6 +52,14 @@ export interface AuthorizedUserInfo {
   app_user_id: string;
   /** `profile` 已授权时返回昵称与头像；当前 Heybox Runtime 在无网络模式下隐式授予该 scope。 */
   profile: { nickname: string; avatar: string } | null;
+  /**
+   * `steam_account` 已授权且当前已绑定 Steam 时返回 canonical SteamID64。
+   *
+   * @remarks
+   * 始终表示为 string，禁止作为 JSON number 使用；未绑定时省略该字段，不返回空字符串或
+   * `null`。只返回主绑定 SteamID64，不包含 Steam 昵称、头像、好友码、公开状态或绑定来源。
+   */
+  steam_id?: string;
 }
 
 /**

package/types/payloads.d.ts

@@ -1,5 +1,5 @@
-/** 当前用户信息与登录能力支持的完整 scope 目录。 */
-export declare const USER_INFO_AUTHORIZATION_SCOPES: readonly ["identity", "profile"];
+/** 当前用户信息与登录能力支持的完整 scope 目录（canonical 顺序）。 */
+export declare const USER_INFO_AUTHORIZATION_SCOPES: readonly ["identity", "profile", "steam_account"];
 /** 用户信息授权 scope。 */
 export type UserInfoAuthorizationScope = (typeof USER_INFO_AUTHORIZATION_SCOPES)[number];
 /** 登录请求使用与用户信息授权相同的 canonical scope。 */
@@ -14,9 +14,18 @@ export interface LoginResult {
 }
 /** 用户资料授权状态。 */
 export type UserInfoAuthorizationStatus = 'not_required' | 'not_requested' | 'granted' | 'denied';
-type CanonicalUserInfoAuthorization = Record<UserInfoAuthorizationScope, UserInfoAuthorizationStatus>;
-/** 当前小程序对 canonical 用户信息 scope 的授权状态。 */
-export interface UserInfoAuthorization extends CanonicalUserInfoAuthorization {
+/**
+ * 当前小程序对 canonical 用户信息 scope 的授权状态。
+ *
+ * @remarks
+ * `steam_account` 是可选键：新能力版本的 Runtime 必定返回，legacy Runtime/Version 可以
+ * 缺失。已授权不代表当前一定已绑定 Steam，只有 {@link AuthorizedUserInfo.steam_id}
+ * 存在才表示当前有主绑定。
+ */
+export interface UserInfoAuthorization {
+    identity: UserInfoAuthorizationStatus;
+    profile: UserInfoAuthorizationStatus;
+    steam_account?: UserInfoAuthorizationStatus;
 }
 /**
  * 已获准向当前小程序披露的用户资料。
@@ -43,6 +52,14 @@ export interface AuthorizedUserInfo {
         nickname: string;
         avatar: string;
     } | null;
+    /**
+     * `steam_account` 已授权且当前已绑定 Steam 时返回 canonical SteamID64。
+     *
+     * @remarks
+     * 始终表示为 string，禁止作为 JSON number 使用；未绑定时省略该字段，不返回空字符串或
+     * `null`。只返回主绑定 SteamID64，不包含 Steam 昵称、头像、好友码、公开状态或绑定来源。
+     */
+    steam_id?: string;
 }
 /**
  * 当前黑盒 APP 登录态、授权状态和已获准披露的用户资料。