@heybox/hb-sdk 0.8.1-alpha.14 → 0.8.1-alpha.16

package/types/miniapp-manifest/index.d.ts

@@ -3,3 +3,4 @@ export * from './node';
 export * from './permissions';
 export * from './companions';
 export * from './companion-types';
+export * from './bindings';

package/types/miniapp-manifest/node.d.ts

@@ -17,4 +17,5 @@ export declare function readMiniappPlatformsFromPackageJson(root: string): reado
  */
 export declare function readMiniappWindowFromPackageJson(root: string): MiniappWindowDeclaration | undefined;
 export declare function readMiniappPermissionsFromPackageJson(root: string, sdkVersion: string): ParsedMiniappPermissions;
+export declare function readMiniappBindAppIdsFromPackageJson(root: string): readonly string[];
 export declare function resolveMiniappSdkVersion(): string;

package/types/miniapp-manifest/schema.d.ts

@@ -3,6 +3,16 @@ import type { MiniappCompanionManifestDeclarations } from './companion-types';
 export declare const MINIAPP_TEMPLATE_VERSION = "0.0.0";
 export declare const MINIAPP_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos", "linux"];
 export type MiniappPlatform = (typeof MINIAPP_PLATFORM_VALUES)[number];
+/** 平台声明硬切点：产物 hb-sdk 版本达到该值时，必须显式声明非空 `platforms`。 */
+export declare const MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION = "0.9.0";
+/**
+ * 历史移动端兼容平台集合。
+ *
+ * @remarks
+ * 仅在 `sdkVersion` 缺失或 SemVer precedence 低于 `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION`，
+ * 且 Manifest 完全没有 `platforms` 字段时生效，不是任何非法声明的兜底。
+ */
+export declare const MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES: readonly ["android", "ios", "ohos"];
 /** 窗口尺寸字段的脏值兜底上限；真正的上限是宿主侧显示器 workArea。 */
 export declare const MINIAPP_WINDOW_SIZE_MAX = 16384;
 /**
@@ -41,6 +51,7 @@ export interface MiniappManifest {
     permissions?: MiniappPermissionDeclarations;
     companions?: MiniappCompanionManifestDeclarations;
     window?: MiniappWindowDeclaration;
+    bindAppIds?: readonly string[];
 }
 export interface ParseMiniappManifestResult {
     manifest: MiniappManifest;
@@ -52,6 +63,7 @@ export declare function validateMiniappManifestVersion(version: unknown, sourceL
 export declare function renderMiniappManifest(manifest: MiniappManifest): string;
 export declare function parseMiniappManifestJson(raw: string, sourceLabel?: string): ParseMiniappManifestResult;
 export declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): {
+    bindAppIds?: readonly string[] | undefined;
     window?: MiniappWindowDeclaration | undefined;
     companions?: MiniappCompanionManifestDeclarations | undefined;
     permissions?: Partial<Record<"userInfo" | "steamLibrary" | "share" | "storage" | "filesystem" | "clipboard" | "leaderboard" | "companion", import("./permissions").SimpleMiniappPermissionDeclaration> & {
@@ -63,6 +75,42 @@ export declare function validateMiniappManifestForDeploy(manifest: MiniappManife
 };
 export declare function validateMiniappPlatforms(platforms: unknown, sourceLabel?: string): readonly MiniappPlatform[];
 export declare function areMiniappPlatformsEqual(left: readonly MiniappPlatform[], right: readonly MiniappPlatform[]): boolean;
+/** 平台解析策略：显式声明，或历史产物缺少声明时的移动端兼容。 */
+export type MiniappPlatformPolicy = 'explicit' | 'legacy_mobile_default';
+/**
+ * Manifest 平台解析结果，供 CLI、开放平台网页、后端与 Runtime 共用。
+ *
+ * @remarks
+ * `declared` 是规范化后的显式声明，历史兼容场景为空数组；`effective` 是用于展示与运行
+ * 判断的最终平台集合。调用方不得自行比较 `0.9.0` 或补默认值，只能消费该结果。
+ */
+export interface MiniappPlatformResolution {
+    /** 规范化后的显式平台声明；历史兼容场景为空数组。 */
+    readonly declared: readonly MiniappPlatform[];
+    /** 最终生效的平台集合：显式声明原样使用，历史产物为移动端兼容集合。 */
+    readonly effective: readonly MiniappPlatform[];
+    /** 是否显式声明了 `platforms`，用于区分显式移动端声明与历史移动端默认。 */
+    readonly platformsDeclared: boolean;
+    /** 本次解析采用的策略。 */
+    readonly policy: MiniappPlatformPolicy;
+}
+/**
+ * 解析 Manifest 平台声明，是 `0.9.0` 硬切规则的唯一实现。
+ *
+ * @remarks
+ * 规则与后端领域层保持一致：
+ * - 无 `platforms` 字段：`sdkVersion` 缺失或 SemVer precedence 低于
+ *   `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION` 时按历史移动端兼容；达到或高于硬切点即非法。
+ * - 有 `platforms` 字段：复用 `validateMiniappPlatforms` 校验并规范化顺序；任何非法值
+ *   （空数组、非数组、未知值、重复值）都不回退到历史兼容，即使 `sdkVersion < 0.9.0`。
+ * - 任何非法的 `sdkVersion` 都会抛出，不做字符串比较。
+ * @param sdkVersion - 产物 hb-sdk 版本；历史产物可能缺失。
+ * @param manifest - 待解析的 Manifest（不可信输入）。
+ * @returns 冻结的平台解析结果。
+ * @throws Manifest 不是对象、`sdkVersion` 不是合法 SemVer、达到硬切点仍缺失 `platforms`，
+ *   或 `platforms` 声明非法时抛出。
+ */
+export declare function resolveMiniappManifestPlatforms(sdkVersion: string | undefined, manifest: unknown): MiniappPlatformResolution;
 /**
  * 校验并归一化 `package.json#heybox.window` / `manifest.window` 声明。
  *

package/types/miniapp-publish/index.d.ts

@@ -27,6 +27,8 @@ export declare const REOPEN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_mi
 export declare const UPDATE_SQUARE_DISPLAY_API_PATH = "/mall/developer/user_miniprogram/square_display/update";
 export declare const LIST_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/list";
 export { isValidMiniappManifestVersion as isValidVersion } from '../miniapp-manifest/schema';
+export { MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, resolveMiniappManifestPlatforms, type MiniappPlatformPolicy, type MiniappPlatformResolution, } from '../miniapp-manifest/schema';
+export { parseMiniappBindAppIds, type ParseMiniappBindAppIdsOptions } from '../miniapp-manifest/bindings';
 export declare function normalizeRelativePath(relativePath: string): string;
 export declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
 export declare function getMiniProgramUploadAlias(miniProgramId: string): string;