@heybox/hb-sdk 0.2.0-alpha.1 → 0.3.1

package/skill/references/api-root.md

@@ -6,69 +6,36 @@
 
 - packages/hb-sdk/package.json
 - packages/hb-sdk/src/index.ts
+- packages/hb-sdk/src/vite/index.ts
 - packages/hb-sdk/README.md
 
 ## Contents
 
 - [Package metadata](#package-metadata)
 - [Public root entrypoint](#public-root-entrypoint)
+- [Vite plugin export](#vite-plugin-export)
 - [App-facing concepts](#app-facing-concepts)
 - [Public modules](#public-modules)
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.2.0-alpha.1`
+- Version at generation time: `0.3.1`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
+- Vite plugin export: `@heybox/hb-sdk/vite`
 
 ## Public root entrypoint
 
 ```ts
 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 { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 export type {
   GetUserInfoPayload,
@@ -130,6 +97,94 @@ const hbSDK = {
 export default hbSDK;
 ```
 
+## Vite plugin export
+
+Use `@heybox/hb-sdk/vite` only in `vite.config.ts`. Do not import it from iframe mini-program business code.
+
+```ts
+import { mkdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import {
+  getMiniappManifestBuildWarning,
+  renderMiniappManifest,
+} from '../miniapp-manifest/schema';
+import { readMiniappVersionFromPackageJson } from '../miniapp-manifest/node';
+
+type MiniappManifestPlugin = {
+  name: string;
+  apply: 'build';
+  configResolved: (resolved: MiniappManifestResolvedConfig) => void;
+  writeBundle: (this: MiniappManifestPluginContext) => void;
+};
+
+interface MiniappManifestPluginContext {
+  warn: (message: string) => void;
+}
+
+interface MiniappManifestResolvedConfig {
+  root: string;
+  build: {
+    outDir: string;
+  };
+}
+
+export function miniappManifest(): MiniappManifestPlugin {
+  let root = process.cwd();
+  let outDir = 'dist';
+
+  return {
+    name: 'heybox-miniapp-manifest',
+    apply: 'build',
+    configResolved(resolved) {
+      root = resolved.root;
+      outDir = resolved.build.outDir;
+    },
+    writeBundle() {
+      const version = readMiniappVersionFromPackageJson(root);
+      const warning = getMiniappManifestBuildWarning(version);
+
+      if (warning) {
+        this.warn(warning);
+      }
+
+      const manifestPath = path.resolve(root, outDir, 'manifest.json');
+      mkdirSync(path.dirname(manifestPath), { recursive: true });
+      writeFileSync(manifestPath, renderMiniappManifest({ version }));
+    },
+  };
+}
+```
+
+## Manifest
+
+`@heybox/hb-sdk/vite` 提供构建时插件 `miniappManifest()`。Vite 项目完成 `vite build` 后，会在输出目录写入 `manifest.json`：
+
+```json
+{
+  "version": "1.2.3"
+}
+```
+
+`version` 来自小程序项目自身的 `package.json.version`。`hb-sdk create` 生成的模板默认已注册插件；现有 Vite 项目可以在 `vite.config.ts` 中手动接入：
+
+```ts
+import { miniappManifest } from '@heybox/hb-sdk/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [miniappManifest()],
+});
+```
+
+失败与警告语义：
+
+- 读取 `package.json` 失败或 JSON 解析失败：`vite build` 直接失败，并输出具体原因。
+- `package.json.version` 不是非空字符串：`vite build` 直接失败。
+- `package.json.version` 仍是模板默认值 `0.0.0`：`vite build` 输出 warning 并写入 manifest；`hb-sdk deploy` 会拒绝发布，必须改成实际 `x.y.z` 版本。
+- 版本号不满足极简 semver 形态 `x.y.z`：只输出 Rollup/Vite warning，仍会写入 manifest。
+
+`manifest.json` 不部署到 CDN，只交给发布流水线读取后上送后台；Host 通过后台 API 间接读取版本信息。第一阶段只支持 Vite 项目，非 Vite 打包器未来通过其他子入口扩展。
+
 ## App-facing concepts
 
 ## 快速开始

package/skill/references/cli.md

@@ -37,6 +37,7 @@ The CLI, templates, and mock host are owned by `@heybox/hb-sdk`. Do not create a
 ```ts
 import { Command, CommanderError, InvalidArgumentError } from 'commander';
 import { runCreateCommand as defaultRunCreateCommand } from './commands/create';
+import { runDeployCommand as defaultRunDeployCommand } from './commands/deploy';
 import { runDevCommand as defaultRunDevCommand } from './commands/dev';
 import { runDoctorCommand as defaultRunDoctorCommand } from './commands/doctor';
 import {
@@ -54,6 +55,7 @@ export interface CliCommandHandlers {
   printLoginStatus: typeof defaultPrintLoginStatus;
   printUpdateReminder: typeof defaultPrintUpdateReminder;
   runCreateCommand: typeof defaultRunCreateCommand;
+  runDeployCommand: typeof defaultRunDeployCommand;
   runDevCommand: typeof defaultRunDevCommand;
   runDoctorCommand: typeof defaultRunDoctorCommand;
 }
@@ -90,6 +92,7 @@ export function createCliProgram(overrides: Partial<CliCommandHandlers> = {}) {
     printLoginStatus: defaultPrintLoginStatus,
     printUpdateReminder: defaultPrintUpdateReminder,
     runCreateCommand: defaultRunCreateCommand,
+    runDeployCommand: defaultRunDeployCommand,
     runDevCommand: defaultRunDevCommand,
     runDoctorCommand: defaultRunDoctorCommand,
     ...overrides,
@@ -126,6 +129,16 @@ export function createCliProgram(overrides: Partial<CliCommandHandlers> = {}) {
       }, handlers.printUpdateReminder),
     );
 
+  program
+    .command('deploy')
+    .description('构建并发布当前小程序到 Heybox 后台')
+    .option('--skip-build', '跳过 build，直接读 dist 目录上传并发布')
+    .action(
+      withUpdateReminder(async (options) => {
+        await handlers.runDeployCommand({ skipBuild: Boolean(options.skipBuild) });
+      }, handlers.printUpdateReminder),
+    );
+
   program
     .command('doctor')
     .description('诊断 hb-sdk 本地环境和 Agent Skill 版本')
@@ -298,7 +311,7 @@ Agent rules:
 
 ## 版本提醒
 
-`hb-sdk` CLI 会在命令成功执行后检查 npm registry 上 `@heybox/hb-sdk` 的 `latest` 版本。检查结果会缓存 24 小时；检查失败会静默跳过；`CI=true` 时会跳过检查，避免污染 CI 日志。本地可通过 `HB_SDK_NO_UPDATE_CHECK=1` 禁用检查。
+`hb-sdk create`、`hb-sdk dev`、`hb-sdk login`、`hb-sdk login status`、`hb-sdk login clear` 会在命令成功执行后检查 npm registry 上 `@heybox/hb-sdk` 的 `latest` 版本。检查结果会缓存 24 小时；检查失败会静默跳过；`CI=true` 时会跳过检查，避免污染 CI 日志。`hb-sdk doctor` 不会附带版本提醒，避免把 skill 诊断输出和升级提示混在一起。本地可通过 `HB_SDK_NO_UPDATE_CHECK=1` 禁用检查。
 
 ## Repository validation commands
 
@@ -308,10 +321,13 @@ Agent rules:
 pnpm --filter @heybox/hb-sdk run test:unit
 pnpm --filter @heybox/hb-sdk run build:package
 pnpm --filter @heybox/hb-sdk run check:boundary
+pnpm --filter @heybox/hb-sdk run check:docs-sync
 ```
 
 `check:boundary` 用于保护 SDK、CLI、mock host 与 runtime 之间的依赖边界。调整 CLI、mock 或协议导出时应一起运行。
 
+`check:docs-sync` 用于校验 `README`、文档站 llms 镜像、skill references 与公开 `agent-skills` payload 没有漏同步。维护清单见 `packages/hb-sdk/DOC_SYNC_CHECKLIST.md`。
+
 ## Generated template README
 
 ````md
@@ -327,12 +343,14 @@ npm run dev
 npm run typecheck
 npm run test:unit
 npm run build
+npm run deploy
 ```
 
 ## 开发模式
 
 - `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面。
 - `npm run build`：先执行 TypeScript 检查，再构建生产产物。
+- `npm run deploy`：构建并发布当前小程序。发布前需要先把 `package.json` 中的 `heybox.miniProgramId` 改成后台分配的真实小程序 id，并执行过 `npx hb-sdk login`。
 
 ## 更多能力
 

package/skill/references/examples.md

@@ -96,6 +96,17 @@ hb-sdk login status
 hb-sdk login clear
 ```
 
+### Vite manifest plugin
+
+```ts
+import { miniappManifest } from '@heybox/hb-sdk/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [miniappManifest()],
+});
+```
+
 ## Negative examples
 
 - Do not import from internal hb-sdk implementation paths.
@@ -105,3 +116,4 @@ hb-sdk login clear
 - Do not pass raw internal share/network protocol fields from mini-program code.
 - Do not treat `hb-sdk login` as iframe SDK authentication state.
 - Do not create a second mock runtime package when `hb-sdk dev` is the supported local mock workflow.
+- Do not import `@heybox/hb-sdk/vite` from iframe business code or fetch a deployed `manifest.json` directly.

package/skill/references/safety-boundaries.md

@@ -16,6 +16,7 @@
 - `network.request()` 的 `validateStatus` 只在 SDK 本地执行，不会被序列化给父容器。
 - `on()` 返回取消监听函数；组件卸载或页面销毁时应主动取消监听。
 - 使用 `createMiniProgramSDK()` 创建独立实例后，不再需要时应调用 `destroy()`。
+- 构建产物可以包含 `dist/manifest.json`，业务代码不应自行 fetch 已部署的 manifest；这个文件由发布流水线读取并上送后台。
 
 ## Agent rules
 
@@ -25,4 +26,5 @@
 - Do not use storage delete, clear, info listing, V2, or global Heybox client storage access.
 - Do not pass host-only protocol fields through `network.request`.
 - Do not build raw `postMessage` bridge flows in iframe business code.
+- Do not fetch deployed `dist/manifest.json` from business code; it is a build artifact for the release pipeline, not a CDN runtime asset.
 - Do not import from internal hb-sdk implementation paths; only use documented package entrypoints.

package/skill/scripts/skill-metadata.mjs

@@ -2,7 +2,10 @@ import { createHash } from 'node:crypto';
 
 export const HB_SDK_SKILL_NAME = 'hb-sdk';
 export const HB_SDK_PACKAGE_NAME = '@heybox/hb-sdk';
-export const HB_SDK_SKILL_SOURCE = 'https://open.xiaoheihe.cn/agent-skills/hb-sdk';
+export const HB_SDK_AGENT_SKILLS_BASE_URL = 'https://open.xiaoheihe.cn/agent-skills';
+export const HB_SDK_SKILL_SOURCE = `${HB_SDK_AGENT_SKILLS_BASE_URL}/${HB_SDK_SKILL_NAME}`;
+export const HB_SDK_SKILL_INDEX_URL = `${HB_SDK_AGENT_SKILLS_BASE_URL}/.well-known/agent-skills/index.json`;
+export const HB_SDK_SKILL_INSTALL_COMMAND = `npx skills add ${HB_SDK_SKILL_SOURCE}`;
 
 export function createSkillContentHash(fileEntries) {
   const hash = createHash('sha256');

package/skill/scripts/sync-references.mjs

@@ -173,6 +173,7 @@ function createCurrentSkillManifest(generatedReferences) {
 const packageJson = JSON.parse(read('packages/hb-sdk/package.json'));
 const rootEntry = read('packages/hb-sdk/src/index.ts');
 const protocolEntry = read('packages/hb-sdk/src/protocol.ts');
+const viteEntry = read('packages/hb-sdk/src/vite/index.ts');
 const cliEntry = read('packages/hb-sdk/src/cli/index.ts');
 const cliTemplateReadme = read('packages/hb-sdk/src/cli/templates/vue3-vite-ts/README.md.ejs');
 const readme = read('packages/hb-sdk/README.md');
@@ -193,6 +194,7 @@ const lifecycleEvents = extractSection(readme, '## 生命周期事件');
 const standardErrors = extractSection(readme, '## 错误处理');
 const sdkRuntimeRelation = extractSection(readme, '## SDK 与 Runtime');
 const capabilityBoundaries = extractSection(readme, '## 能力边界');
+const manifestSection = extractSection(readme, '## Manifest');
 const cliSummarySection = extractSection(readme, '## CLI');
 const repositoryDevelopment = extractSection(readme, '## 本仓库开发');
 const cliCreateSection = extractSection(cliGuide, '## 创建外部小程序模板');
@@ -209,10 +211,12 @@ const files = new Map();
 files.set('api-root.md', `${header('Root API reference', [
   'packages/hb-sdk/package.json',
   'packages/hb-sdk/src/index.ts',
+  'packages/hb-sdk/src/vite/index.ts',
   'packages/hb-sdk/README.md',
 ])}${contents([
   ['Package metadata', 'package-metadata'],
   ['Public root entrypoint', 'public-root-entrypoint'],
+  ['Vite plugin export', 'vite-plugin-export'],
   ['App-facing concepts', 'app-facing-concepts'],
   ['Public modules', 'public-modules'],
 ])}## Package metadata
@@ -221,11 +225,20 @@ files.set('api-root.md', `${header('Root API reference', [
 - Version at generation time: \`${packageJson.version}\`
 - Public root export: \`@heybox/hb-sdk\`
 - Protocol export: \`@heybox/hb-sdk/protocol\`
+- Vite plugin export: \`@heybox/hb-sdk/vite\`
 
 ## Public root entrypoint
 
 ${fenced('ts', rootEntry)}
 
+## Vite plugin export
+
+Use \`@heybox/hb-sdk/vite\` only in \`vite.config.ts\`. Do not import it from iframe mini-program business code.
+
+${fenced('ts', viteEntry)}
+
+${manifestSection}
+
 ## App-facing concepts
 
 ${quickStartSection}
@@ -404,6 +417,7 @@ ${capabilityBoundaries}
 - Do not use storage delete, clear, info listing, V2, or global Heybox client storage access.
 - Do not pass host-only protocol fields through \`network.request\`.
 - Do not build raw \`postMessage\` bridge flows in iframe business code.
+- Do not fetch deployed \`dist/manifest.json\` from business code; it is a build artifact for the release pipeline, not a CDN runtime asset.
 - Do not import from internal hb-sdk implementation paths; only use documented package entrypoints.
 `);
 
@@ -498,6 +512,15 @@ ${fenced('bash', `hb-sdk login
 hb-sdk login status
 hb-sdk login clear`)}
 
+### Vite manifest plugin
+
+${fenced('ts', `import { miniappManifest } from '@heybox/hb-sdk/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [miniappManifest()],
+});`)}
+
 ## Negative examples
 
 - Do not import from internal hb-sdk implementation paths.
@@ -507,6 +530,7 @@ hb-sdk login clear`)}
 - Do not pass raw internal share/network protocol fields from mini-program code.
 - Do not treat \`hb-sdk login\` as iframe SDK authentication state.
 - Do not create a second mock runtime package when \`hb-sdk dev\` is the supported local mock workflow.
+- Do not import \`@heybox/hb-sdk/vite\` from iframe business code or fetch a deployed \`manifest.json\` directly.
 `);
 
 const skillManifest = normalizeSkillManifest(createCurrentSkillManifest(files));

package/skill/scripts/validate-skill.mjs

@@ -184,8 +184,10 @@ for (const file of textFiles) {
     fail(`Removed API guidance found in ${relative}: use auth.login() instead of user.login().`);
   }
 
-  if (new RegExp(`${HB_SDK_PACKAGE_NAME.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\/(?!protocol\\b)[A-Za-z0-9_./-]+`).test(content)) {
-    fail(`Deep/internal hb-sdk import guidance found in ${relative}. Only @heybox/hb-sdk and @heybox/hb-sdk/protocol are allowed.`);
+  if (new RegExp(`${HB_SDK_PACKAGE_NAME.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\/(?!(?:protocol|vite|miniapp-publish)\\b)[A-Za-z0-9_./-]+`).test(content)) {
+    fail(
+      `Deep/internal hb-sdk import guidance found in ${relative}. Only @heybox/hb-sdk, @heybox/hb-sdk/protocol, @heybox/hb-sdk/vite, and @heybox/hb-sdk/miniapp-publish are allowed.`,
+    );
   }
 
   const lines = content.split('\n');

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.2.0-alpha.1+skill.66c7559e5e13",
+  "skillVersion": "0.3.1+skill.3af1f225a627",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.2.0-alpha.1",
-    "compatibility": "0.2.0-alpha.1"
+    "version": "0.3.1",
+    "compatibility": "0.3.1"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-66c7559e5e13eaaefc9718b0f643dffd5853c864913e57e5a65ab0c663553797"
+  "integrity": "sha256-3af1f225a627e3a1f6f4e01a98cc4e38bc571cb911a0e27cf0919784c6b9014f"
 }

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

@@ -0,0 +1,23 @@
+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 { 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;
+export interface MiniappUploadKeyInput {
+    miniProgramId: string;
+    version: string;
+    relativePath: string;
+}
+export declare function getMiniappUploadKey(input: MiniappUploadKeyInput): string;
+export interface UploadPathItem {
+    relativePath: string;
+}
+export interface ValidateUploadPathsOptions {
+    miniProgramId: string;
+    version: string;
+    maxLength?: number;
+}
+export declare function validateUploadPaths(items: UploadPathItem[], options: ValidateUploadPathsOptions): string | undefined;
+export declare function shouldUploadDistFile(relativePath: string): boolean;

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";

package/types/vite/index.d.ts

@@ -0,0 +1,17 @@
+type MiniappManifestPlugin = {
+    name: string;
+    apply: 'build';
+    configResolved: (resolved: MiniappManifestResolvedConfig) => void;
+    writeBundle: (this: MiniappManifestPluginContext) => void;
+};
+interface MiniappManifestPluginContext {
+    warn: (message: string) => void;
+}
+interface MiniappManifestResolvedConfig {
+    root: string;
+    build: {
+        outDir: string;
+    };
+}
+export declare function miniappManifest(): MiniappManifestPlugin;
+export {};