@heybox/hb-sdk 0.2.0-alpha.2 → 0.3.2

package/types/core/client.d.ts

@@ -1,3 +1,4 @@
+import type { MiniProgramBridgeMethod, MiniProgramCapabilityPayload, MiniProgramCapabilityResult } from '../protocol/capabilities';
 import type { MiniProgramEventHandler, MiniProgramEventName } from '../protocol/types';
 /**
  * 创建 SDK bridge client 的配置项。
@@ -17,22 +18,11 @@ export interface MiniProgramSDKOptions {
     /** 精准 postMessage 目标 origin；未传时尝试推断，失败则回退为 `*`。 */
     targetOrigin?: string;
 }
-/**
- * 模块 API 发起请求所需的最小能力。
- *
- * @remarks
- * 各公开模块只依赖该最小接口发起 bridge 请求，以保持模块层与底层实现解耦。
- */
+type MiniProgramRequesterArgs<Method extends MiniProgramBridgeMethod> = MiniProgramCapabilityPayload<Method> extends void ? [payload?: MiniProgramCapabilityPayload<Method>] : [payload: MiniProgramCapabilityPayload<Method>];
+/** 模块 API 发起请求所需的最小能力。 */
 export interface MiniProgramRequester {
-    /**
-     * 向父容器调用指定开放能力。
-     *
-     * @typeParam T 标准化后的返回值类型。
-     * @param method bridge method 名称。
-     * @param payload 可序列化请求载荷。
-     * @returns 由父容器返回的标准化结果。
-     */
-    request<T>(method: string, payload?: unknown): Promise<T>;
+    /** 向父容器调用指定开放能力。 */
+    request<Method extends MiniProgramBridgeMethod>(method: Method, ...args: MiniProgramRequesterArgs<Method>): Promise<MiniProgramCapabilityResult<Method>>;
 }
 /** 底层 bridge client，负责握手、请求响应、事件分发与超时清理。 */
 export declare class MiniProgramBridgeClient implements MiniProgramRequester {
@@ -60,7 +50,7 @@ export declare class MiniProgramBridgeClient implements MiniProgramRequester {
     /** 移除小程序事件监听。 */
     off<T extends MiniProgramEventName>(eventName: T, handler: MiniProgramEventHandler<T>): void;
     /** 调用父容器开放能力。 */
-    request<T>(method: string, payload?: unknown): Promise<T>;
+    request<Method extends MiniProgramBridgeMethod>(method: Method, ...args: MiniProgramRequesterArgs<Method>): Promise<MiniProgramCapabilityResult<Method>>;
     /** 销毁 SDK 实例，并拒绝尚未完成的请求。 */
     destroy(): void;
     private ensureStarted;
@@ -74,3 +64,4 @@ export declare class MiniProgramBridgeClient implements MiniProgramRequester {
     private clearReadyTimers;
     private rejectAllPending;
 }
+export {};

package/types/index.d.ts

@@ -1,12 +1,8 @@
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
-export type { MiniProgramRequester, MiniProgramSDKOptions } from './core/client';
+export type { MiniProgramSDKOptions } from './core/client';
 export { ready, on, off, auth, user, share, viewport, storage, network } from './core/singleton';
-export { MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, SDK_HANDSHAKE_METHOD, } from './protocol/constants';
-export { isMiniProgramBridgeMessage } from './protocol/guards';
-export type { MiniProgramBridgeError, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
-export { AUTH_LOGIN_METHOD, NETWORK_REQUEST_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, } from './protocol/capabilities';
-export type { MiniProgramAuthMethod, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramNetworkMethod, MiniProgramShareMethod, MiniProgramStorageMethod, MiniProgramUserMethod, MiniProgramViewportMethod, } from './protocol/capabilities';
+export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 export type { GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, } from './modules/user';
 export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, MiniProgramShowShareMenuOptions, ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult, } from './modules/share';

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

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './node';

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

@@ -0,0 +1 @@
+export declare function readMiniappVersionFromPackageJson(root: string): string;

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

@@ -0,0 +1,14 @@
+export declare const MINIAPP_TEMPLATE_VERSION = "0.0.0";
+export interface MiniappManifest {
+    [key: string]: unknown;
+    version: string;
+}
+export interface ParseMiniappManifestResult {
+    manifest: MiniappManifest;
+    hadBom: boolean;
+}
+export declare function isValidMiniappManifestVersion(version: string): boolean;
+export declare function getMiniappManifestBuildWarning(version: string): string | undefined;
+export declare function renderMiniappManifest(manifest: MiniappManifest): string;
+export declare function parseMiniappManifestJson(raw: string, sourceLabel?: string): ParseMiniappManifestResult;
+export declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): string;

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

@@ -1,7 +1,7 @@
 export declare const MINIAPP_UPLOAD_SCOPE = "activity";
 export declare const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
 export declare const PUBLISH_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/publish";
-export declare function isValidVersion(version: string): boolean;
+export { isValidMiniappManifestVersion as isValidVersion } from '../miniapp-manifest/schema';
 export declare function normalizeRelativePath(relativePath: string): string;
 export declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
 export declare function getMiniProgramUploadAlias(miniProgramId: string): string;

package/types/skill-metadata.d.ts

@@ -0,0 +1,6 @@
+export declare const HB_SDK_PACKAGE_NAME = "@heybox/hb-sdk";
+export declare const HB_SDK_SKILL_NAME = "hb-sdk";
+export declare const HB_SDK_AGENT_SKILLS_BASE_URL = "https://open.xiaoheihe.cn/agent-skills";
+export declare const HB_SDK_SKILL_SOURCE = "https://open.xiaoheihe.cn/agent-skills/hb-sdk";
+export declare const HB_SDK_SKILL_INDEX_URL = "https://open.xiaoheihe.cn/agent-skills/.well-known/agent-skills/index.json";
+export declare const HB_SDK_SKILL_INSTALL_COMMAND = "npx skills add https://open.xiaoheihe.cn/agent-skills/hb-sdk";