@heybox/hb-sdk 0.8.1-alpha.3 → 0.8.1-alpha.7

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/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

@@ -33,6 +33,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/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,4 +49,5 @@ export interface MiniappManifestResolvedConfig {
 }
 export { MINIAPP_PLATFORM_VALUES };
 export type { MiniappPlatform };
+export declare const HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV = "HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN";
 export declare function miniappManifest(): MiniappManifestPlugin;