@heybox/hb-sdk 0.8.0 → 0.8.1-alpha.10

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

@@ -1,4 +1,5 @@
 import { type MiniappPermissionDeclarations } from './permissions';
+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];
@@ -8,6 +9,7 @@ export interface MiniappManifest {
     version: string;
     platforms: readonly MiniappPlatform[];
     permissions?: MiniappPermissionDeclarations;
+    companions?: MiniappCompanionManifestDeclarations;
 }
 export interface ParseMiniappManifestResult {
     manifest: MiniappManifest;
@@ -19,7 +21,8 @@ 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): {
-    permissions?: Partial<Record<"userInfo" | "steamLibrary" | "share" | "storage" | "filesystem" | "clipboard" | "leaderboard", import("./permissions").SimpleMiniappPermissionDeclaration> & {
+    companions?: MiniappCompanionManifestDeclarations | undefined;
+    permissions?: Partial<Record<"userInfo" | "steamLibrary" | "share" | "storage" | "filesystem" | "clipboard" | "leaderboard" | "companion", import("./permissions").SimpleMiniappPermissionDeclaration> & {
         network: import("./permissions").NetworkMiniappPermissionDeclaration;
     }> | undefined;
     version: string;
@@ -27,4 +30,5 @@ export declare function validateMiniappManifestForDeploy(manifest: MiniappManife
     platforms: readonly ("android" | "ios" | "ohos" | "windows" | "macos" | "linux")[];
 };
 export declare function validateMiniappPlatforms(platforms: unknown, sourceLabel?: string): readonly MiniappPlatform[];
+export declare function areMiniappPlatformsEqual(left: readonly MiniappPlatform[], right: readonly MiniappPlatform[]): boolean;
 export declare function validateSdkVersion(version: unknown, sourceLabel?: string): string;

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

@@ -2,6 +2,8 @@ export declare const MINIAPP_UPLOAD_SCOPE = "activity";
 export declare const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
 export declare const MINIAPP_UPLOAD_BATCH_SIZE = 50;
 export declare const MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES: number;
+/** 与 Activity 上传后端合同一致的 Companion 归档总大小上限。 */
+export declare const MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES: number;
 export declare const USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = "/mall/developer/user_miniprogram/access_status";
 export declare const DEVELOPER_ENTITY_LIST_API_PATH = "/mall/developer/entity/list";
 export declare const DEVELOPER_ENTITY_SWITCH_API_PATH = "/mall/developer/entity/switch";
@@ -51,6 +53,10 @@ export interface ValidateUploadTotalSizeOptions {
     limitBytes?: number;
 }
 export declare function validateUploadTotalSize(items: UploadSizeItem[], options?: ValidateUploadTotalSizeOptions): "构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy" | undefined;
+export declare function validateMiniappUploadSizeBudgets(items: UploadSizeItem[], options?: {
+    webLimitBytes?: number;
+    companionLimitBytes?: number;
+}): "构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy" | "Companion 归档总大小超过 500MiB 上限，请缩减归档后重新 deploy" | undefined;
 export declare function shouldUploadDistFile(relativePath: string): boolean;
 /** 参与整包签名和上传会话映射的构建产物文件。 */
 export interface MiniappArtifactFile {
@@ -59,6 +65,11 @@ export interface MiniappArtifactFile {
     /** 文件字节数。 */
     size: number;
 }
+/** 上传会话 v1 使用的逐文件完整性凭据。 */
+export interface MiniappArtifactFileReceipt extends MiniappArtifactFile {
+    /** 文件内容 SHA-256，小写十六进制。 */
+    sha256: string;
+}
 /** 服务端上传会话返回的文件映射。 */
 export interface MiniappUploadSessionFile {
     /** 与创建会话时提交值一致的相对路径。 */
@@ -67,6 +78,8 @@ export interface MiniappUploadSessionFile {
     key: string;
     /** 服务端记录的文件字节数。 */
     size: number;
+    /** 服务端固化的文件内容 SHA-256。 */
+    sha256: string;
 }
 /**
  * 校验构建产物路径和大小，并按路径 UTF-8 字节序排序。
@@ -118,14 +131,16 @@ export declare function resolveMiniappUploadSessionFiles<T extends MiniappArtifa
     files: {
         file: T & {
             relativePath: string;
-        };
+        } & Record<"sha256", unknown>;
         key: string;
     }[];
     missingFiles: {
         file: T & {
             relativePath: string;
-        };
+        } & Record<"sha256", unknown>;
         key: string;
     }[];
     uploadedKeys: string[];
 };
+/** 校验 Manifest 中所有 Companion 归档都精确属于当前上传 receipt。 */
+export declare function validateMiniappCompanionFileReceipts(companions: unknown, files: readonly MiniappArtifactFileReceipt[]): void;

package/types/modules/companion/index.d.ts

@@ -0,0 +1,57 @@
+import { type CompanionCapability, type CompanionExit, type CompanionInfo, type CompanionNotificationCategory, type CompanionPreparationStatus, type CompanionPrepareProgress, type CompanionTarget } from '@heybox/hb-sdk-protocol';
+import type { MiniProgramOperationRequester } from '../../core/client';
+import type { MiniProgramEventHandler, MiniProgramEventName } from '../../protocol/types';
+import type { FileHandle } from '../files';
+interface CompanionRequester extends MiniProgramOperationRequester {
+    on<T extends MiniProgramEventName>(eventName: T, handler: MiniProgramEventHandler<T>): () => void;
+}
+export interface CompanionPrepareOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: CompanionPrepareProgress) => void;
+}
+export type CompanionOutputHandler = (data: Uint8Array) => void;
+export type CompanionExitHandler = (exit: CompanionExit) => void;
+export type CompanionOwnershipLostHandler = () => void;
+export type CompanionState = 'running' | 'exited';
+export type CompanionStateChangeHandler = (state: CompanionState) => void;
+export interface CompanionNotification {
+    category: CompanionNotificationCategory;
+}
+export interface CompanionStdio {
+    write(data: Uint8Array): Promise<void>;
+    closeStdin(): Promise<void>;
+    onStdout(handler: CompanionOutputHandler): () => void;
+    onStderr(handler: CompanionOutputHandler): () => void;
+}
+export interface CompanionAttachments {
+    open(id: string): Promise<FileHandle>;
+}
+export interface CompanionNotifications {
+    show(input: CompanionNotification): Promise<void>;
+}
+export interface CompanionSession {
+    readonly id: string;
+    readonly alias: string;
+    readonly target: CompanionTarget;
+    readonly capabilities: readonly CompanionCapability[];
+    readonly state: CompanionState;
+    readonly stdio?: CompanionStdio;
+    readonly attachments?: CompanionAttachments;
+    readonly notifications?: CompanionNotifications;
+    terminate(): Promise<void>;
+    waitForExit(): Promise<CompanionExit>;
+    onStateChange(handler: CompanionStateChangeHandler): () => void;
+    onExit(handler: CompanionExitHandler): () => void;
+    onOwnershipLost(handler: CompanionOwnershipLostHandler): () => void;
+}
+export interface MiniProgramCompanionModule {
+    getInfo(alias: string): Promise<CompanionInfo>;
+    getPreparationStatus(alias: string): Promise<CompanionPreparationStatus>;
+    prepare(alias: string, options?: CompanionPrepareOptions): Promise<CompanionInfo>;
+    cancelPreparation(alias: string): Promise<void>;
+    launch(alias: string): Promise<CompanionSession>;
+    getActiveSession(alias: string): Promise<CompanionSession | undefined>;
+}
+/** 创建当前 SDK session 的 companion 模块。 */
+export declare function createCompanionModule(requester: CompanionRequester): MiniProgramCompanionModule;
+export type { CompanionCapability, CompanionExit, CompanionInfo, CompanionNotificationCategory, CompanionPreparationStatus, CompanionPrepareProgress, CompanionTarget, };

package/types/modules/environment/index.d.ts

@@ -0,0 +1,70 @@
+import type { MiniProgramOperatingSystemName, MiniProgramRuntimeMode } from '@heybox/hb-sdk-protocol';
+/** 小程序环境信息中的运行模式。 */
+export type { MiniProgramRuntimeMode } from '@heybox/hb-sdk-protocol';
+/** 小程序环境信息中的操作系统名称。 */
+export type { MiniProgramOperatingSystemName } from '@heybox/hb-sdk-protocol';
+/** 当前小程序实例的只读环境快照。 */
+export interface MiniProgramEnvironmentInfo {
+    readonly runtime: {
+        readonly mode: MiniProgramRuntimeMode;
+    };
+    readonly host: {
+        readonly appVersion: string | null;
+    };
+    readonly miniProgram: {
+        readonly id: string | null;
+        readonly version: string | null;
+    };
+    readonly operatingSystem: {
+        readonly name: MiniProgramOperatingSystemName;
+        readonly version: string | null;
+    };
+    readonly sdk: {
+        readonly version: string;
+    };
+}
+/** SDK 内部读取环境快照所需的最小能力。 */
+export interface MiniProgramEnvironmentReader {
+    getEnvironmentInfo(): Promise<MiniProgramEnvironmentInfo>;
+    getEnvironmentInfoSync(): MiniProgramEnvironmentInfo;
+}
+/** 外部小程序可调用的 environment 模块。 */
+export interface MiniProgramEnvironmentModule {
+    /**
+     * 获取当前小程序实例的环境快照，并在必要时自动等待 SDK 握手。
+     *
+     * @since 0.8.1-alpha.2
+     * @hbPlatform android
+     * @hbPlatform ios
+     * @hbPlatform ohos
+     * @hbPlatform windows
+     * @hbPlatform macos
+     * @hbClient android none
+     * @hbClient ios none
+     * @hbClient ohos none
+     * @hbClient windows none
+     * @hbClient macos none
+     */
+    getInfo(): Promise<MiniProgramEnvironmentInfo>;
+    /**
+     * 同步读取握手完成后缓存的环境快照。
+     *
+     * @throws {@link HbMiniProgramSDKError} SDK 尚未 ready 时抛出 `ENVIRONMENT_NOT_READY`。
+     * @since 0.8.1-alpha.2
+     * @hbPlatform android
+     * @hbPlatform ios
+     * @hbPlatform ohos
+     * @hbPlatform windows
+     * @hbPlatform macos
+     * @hbClient android none
+     * @hbClient ios none
+     * @hbClient ohos none
+     * @hbClient windows none
+     * @hbClient macos none
+     */
+    getInfoSync(): MiniProgramEnvironmentInfo;
+}
+/** 创建环境信息模块。 */
+export declare function createEnvironmentModule(reader: MiniProgramEnvironmentReader): MiniProgramEnvironmentModule;
+/** 将不可信 wire 值逐字段降级为固定、深度冻结的公开快照。 */
+export declare function normalizeMiniProgramEnvironmentInfo(value: unknown): MiniProgramEnvironmentInfo;

package/types/modules/network/index.d.ts

@@ -38,8 +38,6 @@ export interface MiniProgramNetworkRequestConfig {
     headers?: MiniProgramNetworkHeaders;
     /** 超时时间，单位毫秒。 */
     timeout?: number;
-    /** 是否携带凭据意图；具体策略由宿主运行时决定。 */
-    withCredentials?: boolean;
     /** SDK 侧状态校验；不会跨 bridge 传输函数值。 */
     validateStatus?: MiniProgramNetworkValidateStatus;
 }
@@ -54,7 +52,6 @@ export interface DownloadBaseOptions {
     params?: MiniProgramNetworkParams;
     headers?: MiniProgramNetworkHeaders;
     timeout?: number;
-    withCredentials?: boolean;
     maxBytes?: number;
     signal?: AbortSignal;
     onProgress?: (progress: DownloadProgress) => void;
@@ -82,7 +79,6 @@ export interface NetworkRequestPayload {
     data?: unknown;
     headers?: MiniProgramNetworkHeaders;
     timeout?: number;
-    withCredentials?: boolean;
 }
 /**
  * bridge / runtime 返回的标准化 HTTP 响应。
@@ -114,6 +110,7 @@ export interface MiniProgramNetworkModule {
      * @returns 标准化网络响应；HTTP 2xx 默认返回 resolve。
      * @throws 当请求已完成但 HTTP 状态不满足 `validateStatus` 时抛出 `HbMiniProgramNetworkError`。
      * @throws 当 bridge、运行时或宿主能力调用失败时抛出 `HbMiniProgramSDKError`。
+     * @deprecated Since 0.8.1-alpha.7. 暂无替代接口；现有调用仍可使用，请移除 withCredentials 配置。Native Cookie 由 Host 按目标域名决定。
      * @since 0.2.0-alpha.0
      * @hbPlatform android
      * @hbPlatform ios

package/types/modules/network/observability.d.ts

@@ -12,7 +12,6 @@ export interface NetworkRequestFailureLog {
     headers?: MiniProgramNetworkHeaders;
     dataPreview?: unknown;
     timeout?: number;
-    withCredentials?: boolean;
 }
 /**
  * 记录 `network.request` 失败，保证异常路径在开发者控制台可观测。

package/types/protocol/dev-session.d.ts

@@ -12,7 +12,8 @@ export declare const MINI_PROGRAM_DEV_LAUNCH_SCHEMA_VERSION: 1;
 /** Browser Dev Host 创建 Dev Session 时接收的请求。 */
 export interface MiniProgramDevSessionCreatePayload {
     mini_url_origin: string;
-    runtime_permissions: MiniProgramRuntimePermissionsSnapshot;
+    /** 仅用于兼容旧 Node 服务；当前服务端忽略该字段并自行读取远端权限。 */
+    runtime_permissions?: MiniProgramRuntimePermissionsSnapshot;
 }
 /** Browser Dev Host 创建 Dev Session 后返回的短期引用。 */
 export interface MiniProgramDevSessionCreateResult {
@@ -33,6 +34,12 @@ export interface MiniProgramDevLaunchSnapshot {
     sdk_version?: string;
     mini_program_id?: string;
     local_dev_launch_token?: string;
+    /** CLI 进程身份，重启后变化；不作为授权凭据。 */
+    dev_session_id?: string;
+    /** 启动票过期时间，Unix 毫秒。 */
+    expires_at?: number;
+    companion_manifest_sha256?: string;
+    companion_artifact_access_token?: string;
     dev_context_url?: string;
     runtime_permissions?: MiniProgramRuntimePermissionsSnapshot;
 }

package/types/protocol.d.ts

@@ -1,5 +1,5 @@
 export { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_DOWNLOAD_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramByteArray, isMiniProgramBridgeMessage, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions, } from '@heybox/hb-sdk-protocol';
-export type { AuthorizedUserInfo, ClosePayload, CloseResult, CopyLinkPayload, CopyLinkResult, DirectoryCreatePayload, DirectoryCreateResult, DirectoryExistsPayload, DirectoryExistsResult, DirectoryListPayload, DirectoryListResult, DirectoryRemovePayload, DirectoryRemoveResult, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, GetWindowInfoPayload, GetWindowInfoResult, DownloadProgressPayload, HideLoadingPayload, HideLoadingResult, FileCreatePayload, FileCreateResult, FileExistsPayload, FileExistsResult, FileReadBytesPayload, FileReadBytesResult, FileReadTextPayload, FileReadTextResult, FileRemovePayload, FileRemoveResult, FileStatPayload, FileStatResult, FileWriteBytesPayload, FileWriteBytesResult, FileWriteTextPayload, FileWriteTextResult, LeaderboardEntry, LeaderboardOrder, LoginPayload, LoginResult, LoginScope, MiniProgramAuthMethod, MiniProgramBridgeError, MiniProgramBridgeCancelMessage, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeProgressMessage, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectoryDescriptor, MiniProgramDirectoryMethod, MiniProgramDirectoryRef, MiniProgramDirectDirectoryRef, MiniProgramDirectFileRef, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramFileDescriptor, MiniProgramFileMode, MiniProgramFileMethod, MiniProgramFileRef, MiniProgramFilesMethod, MiniProgramFileStat, MiniProgramFileSystemEntityDescriptor, MiniProgramFileSystemEntityRef, MiniProgramPathRootRef, MiniProgramSandboxRootRef, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationMethod, MiniProgramNetworkHeaders, MiniProgramNetworkMethod, MiniProgramNetworkParams, MiniProgramNetworkRequestMethod, MiniProgramRuntimePermissionEntry, MiniProgramRuntimePermissionsSnapshot, MiniProgramRuntimePermissionStatus, MiniProgramSafeArea, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareMethod, MiniProgramSharePostOptions, MiniProgramStorageMethod, MiniProgramToastStatus, MiniProgramUiMethod, MiniProgramUserInfoResult, MiniProgramUserMethod, MiniProgramVibrateIntensity, MiniProgramViewportMethod, MiniProgramWindowInfoResult, NetworkRequestPayload, NetworkResponsePayload, NetworkDownloadPayload, NetworkDownloadResult, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenPostDetailAppPagePayload, OpenUserDetailAppPagePayload, PickDirectoryPayload, PickDirectoryResult, PickFilesPayload, PickFilesResult, ParsedMiniProgramRuntimePermissions, ReloadPayload, ReloadResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, RuntimeLocationProbePayload, ScreenshotPayload, ScreenshotResult, SaveFilePayload, SaveFileResult, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKLocationReportPayload, SDKLocationReportTrigger, SetClipboardPayload, SetClipboardResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, VibratePayload, VibrateResult, } from '@heybox/hb-sdk-protocol';
+export type { AuthorizedUserInfo, ClosePayload, CloseResult, CopyLinkPayload, CopyLinkResult, DirectoryCreatePayload, DirectoryCreateResult, DirectoryExistsPayload, DirectoryExistsResult, DirectoryListPayload, DirectoryListResult, DirectoryRemovePayload, DirectoryRemoveResult, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, GetWindowInfoPayload, GetWindowInfoResult, DownloadProgressPayload, HideLoadingPayload, HideLoadingResult, FileCreatePayload, FileCreateResult, FileExistsPayload, FileExistsResult, FileReadBytesPayload, FileReadBytesResult, FileReadTextPayload, FileReadTextResult, FileRemovePayload, FileRemoveResult, FileStatPayload, FileStatResult, FileWriteBytesPayload, FileWriteBytesResult, FileWriteTextPayload, FileWriteTextResult, LeaderboardEntry, LeaderboardOrder, LoginPayload, LoginResult, LoginScope, MiniProgramAuthMethod, MiniProgramBridgeError, MiniProgramBridgeCancelMessage, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeProgressMessage, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectoryDescriptor, MiniProgramDirectoryMethod, MiniProgramDirectoryRef, MiniProgramDirectDirectoryRef, MiniProgramDirectFileRef, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramFileDescriptor, MiniProgramFileMode, MiniProgramFileMethod, MiniProgramFileRef, MiniProgramFilesMethod, MiniProgramFileStat, MiniProgramFileSystemEntityDescriptor, MiniProgramFileSystemEntityRef, MiniProgramPathRootRef, MiniProgramSandboxRootRef, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationMethod, MiniProgramNetworkHeaders, MiniProgramNetworkMethod, MiniProgramNetworkParams, MiniProgramNetworkRequestMethod, MiniProgramOperatingSystemName, MiniProgramRuntimePermissionEntry, MiniProgramRuntimeEnvironmentInfo, MiniProgramRuntimeMode, MiniProgramRuntimePermissionsSnapshot, MiniProgramRuntimePermissionStatus, MiniProgramSafeArea, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareMethod, MiniProgramSharePostOptions, MiniProgramStorageMethod, MiniProgramToastStatus, MiniProgramUiMethod, MiniProgramUserInfoResult, MiniProgramUserMethod, MiniProgramVibrateIntensity, MiniProgramViewportMethod, MiniProgramWindowInfoResult, NetworkRequestPayload, NetworkResponsePayload, NetworkDownloadPayload, NetworkDownloadResult, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenPostDetailAppPagePayload, OpenUserDetailAppPagePayload, PickDirectoryPayload, PickDirectoryResult, PickFilesPayload, PickFilesResult, ParsedMiniProgramRuntimePermissions, ReloadPayload, ReloadResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, RuntimeLocationProbePayload, ScreenshotPayload, ScreenshotResult, SaveFilePayload, SaveFileResult, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKHandshakeResult, SDKLocationReportPayload, SDKLocationReportTrigger, SetClipboardPayload, SetClipboardResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, VibratePayload, VibrateResult, } from '@heybox/hb-sdk-protocol';
 export type { LoginOptions } from './modules/auth';
 export type { GetSteamGameListOptions } from './modules/user';
 export type { MiniProgramEventHandler } from './protocol/types';

package/types/vite/index.d.ts

@@ -1,3 +1,4 @@
+import type { IncomingMessage, Server, ServerResponse } from 'node:http';
 import { MINIAPP_PLATFORM_VALUES, type MiniappPlatform } from '../miniapp-manifest/schema';
 export interface MiniappManifestPlugin {
     name: string;
@@ -5,11 +6,19 @@ export interface MiniappManifestPlugin {
         command: 'build' | 'serve';
     }) => MiniappManifestUserConfig | void;
     configResolved: (resolved: MiniappManifestResolvedConfig) => void;
+    configureServer: (server: MiniappManifestDevServer) => void;
     /** Rollup 在构建失败后仍会跑 closeBundle；用 buildEnd 记录真实错误，避免二次校验掩盖原因。 */
     buildEnd: (error?: Error) => void;
     transformIndexHtml: (html: string) => string;
     closeBundle: (this: MiniappManifestPluginContext) => Promise<void>;
 }
+export interface MiniappManifestDevServer {
+    httpServer?: Server | null;
+    restart?: (forceOptimize?: boolean) => Promise<void>;
+    middlewares: {
+        use: (handler: (request: IncomingMessage, response: ServerResponse, next: () => void) => void) => void;
+    };
+}
 export interface MiniappManifestUserConfig {
     base?: string;
     define?: Record<string, string>;
@@ -40,7 +49,5 @@ export interface MiniappManifestResolvedConfig {
 }
 export { MINIAPP_PLATFORM_VALUES };
 export type { MiniappPlatform };
-export interface MiniappManifestOptions {
-    platforms: readonly MiniappPlatform[];
-}
-export declare function miniappManifest(options: MiniappManifestOptions): MiniappManifestPlugin;
+export declare const HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV = "HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN";
+export declare function miniappManifest(): MiniappManifestPlugin;