@huoye/app-ship 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -1,3 +1,14 @@
+import * as url from 'url';
+import FormData from 'form-data';
+
+interface ReleaseProgress {
+    phase: 'artifact_check' | 'credentials' | 'channel_upload' | 'channel_processing' | 'channel_complete' | 'channel_failed' | 'receipt_store';
+    platform?: string;
+    loaded?: number;
+    total?: number;
+}
+type ReleaseProgressObserver = (event: ReleaseProgress) => void;
+
 /**
  * 上传配置接口
  */ interface UploadConfig {
@@ -5,6 +16,8 @@
     appId?: string;
     /** 版本号 */
     version?: string;
+    /** 同次发行按 BCP-47 语言标识共用的说明正文；省略时沿用入口单语言说明。 */
+    releaseNotes?: Record<string, string>;
     /** 构建相关配置 */
     build?: {
         /** Android 构建配置 */
@@ -167,24 +180,42 @@
         pgyer?: {
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile；配置后不再在 YAML 中保存秘密。 */
+            credentialProfile?: string;
             /** API 密钥 */
-            apiKey: string;
+            apiKey?: string;
             /** 版本描述 */
             description?: string;
+            /** 安装权限必须显式选择，禁止依赖平台默认公开。 */
+            access: {
+                type: 'public' | 'password' | 'invite';
+                /** 密码安装时必填；该值属于秘密，不得写入日志或回执。 */
+                password?: string;
+            };
         };
+        /** 新增 Android 商店仅开放传包或草稿，送审和发布不在本批执行。 */
+        honor?: AndroidStoreConfig;
+        meizu?: AndroidStoreConfig;
+        samsung?: AndroidStoreConfig;
         /** 华为应用市场配置 */
         huawei?: {
             /** 是否启用 */
             enable: boolean;
-            /** 认证信息 */
-            auth: {
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
+            /** API 客户端或安全库还原的 Service Account。 */
+            auth?: {
                 /** 客户端 ID */
-                clientId: string;
+                clientId?: string;
                 /** 客户端密钥 */
-                clientSecret: string;
+                clientSecret?: string;
+                /** 仅由本机安全库还原到执行内存；不得写入项目 YAML。 */
+                serviceAccountJsonContent?: string;
             };
             /** 应用 ID */
             appId: string;
+            /** Android 应用包名；用于上传前核对 APK/AAB 身份。 */
+            packageName?: string;
             /** 发布类型：草稿或提交审核 */
             releaseType?: 'draft' | 'submit';
             /**
@@ -209,14 +240,18 @@
         xiaomi?: {
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
             /** 认证信息 */
-            auth: {
+            auth?: {
                 /** 开发者账号邮箱 */
                 userName: string;
                 /** API 访问密码 (非登录密码) */
                 privateKey: string;
                 /** 小米分配的 RSA 公钥文件路径 */
                 publicKeyPath?: string;
+                /** 从 credentialProfile 解析到内存的 RSA 公钥内容；不得写回 YAML。 */
+                publicKeyContent?: string;
             };
             /** 应用包名 (可选, 不填则从 APK 推断) */
             packageName?: string;
@@ -248,27 +283,55 @@
                 /** 手机截图路径列表 (新增应用至少 3 张) */
                 screenshots?: string[];
             };
+            /**
+             * 2026-02-04 起小米自动发布接口采用的结构化测试账号。
+             * 账号、密码与验证码均按凭据处理，不得进入日志、回执或模型上下文。
+             */
+            testAccount?: {
+                accounts?: Array<{
+                    /** 1=账号密码，2=短信验证码 */
+                    t: 1 | 2;
+                    /** 账号或手机号 */
+                    a?: string;
+                    /** 密码或验证码 */
+                    p?: string;
+                    /** 注册码或准入码 */
+                    c?: string;
+                }>;
+                /** 审核补充说明，最多 500 字符 */
+                auditNotes?: string;
+            };
         };
         /** 鸿蒙应用市场配置 */
         harmony?: {
             /** 是否启用 */
             enable: boolean;
-            /** 认证信息 */
-            auth: {
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
+            /** API 客户端或安全库还原的 Service Account。 */
+            auth?: {
                 /** 客户端 ID */
-                clientId: string;
+                clientId?: string;
                 /** 客户端密钥 */
-                clientSecret: string;
+                clientSecret?: string;
+                /** 仅由本机安全库还原到执行内存；不得写入项目 YAML。 */
+                serviceAccountJsonContent?: string;
             };
             /** 应用 ID */
             appId: string;
-            /** 发布类型：草稿或提交审核 */
-            releaseType?: 'draft' | 'submit';
+            /** HarmonyOS bundleName；用于上传前核对 HAP/APP 身份。 */
+            packageName?: string;
+            /** 当前仅开放草稿；送审能力完成验证前不进入首版。 */
+            releaseType?: 'draft';
         };
         /** App Store 配置 */
         app_store?: {
+            /** 只读凭据核验使用的明确 Bundle ID；省略时不能开始自动配置，不影响原手动上传。 */
+            packageName?: string;
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
             /** 发布模式：app_store | testflight | adhoc */
             mode?: 'app_store' | 'testflight' | 'adhoc';
             /**
@@ -278,7 +341,7 @@
              */
             appId?: string;
             /** 认证信息（至少配置一种认证方式） */
-            auth: {
+            auth?: {
                 /**
                  * CLI 上传凭据（Apple ID + App-specific Password）
                  * 用于 Transporter / altool 上传 IPA
@@ -343,8 +406,10 @@
         oppo?: {
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
             /** 认证信息 */
-            auth: {
+            auth?: {
                 /** 客户端 ID (OPPO 开放平台分配) */
                 clientId: string;
                 /** 客户端密钥 */
@@ -358,13 +423,29 @@
              * 2: 定时发布
              */
             onlineType?: '1' | '2';
+            /** 缺少线上可复用值时必须显式提供的送审资料，禁止使用虚假兜底。 */
+            submission?: {
+                summary?: string;
+                detailDescription?: string;
+                privacyPolicyUrl?: string;
+                testDescription?: string;
+                businessContact?: {
+                    name?: string;
+                    email?: string;
+                    mobile?: string;
+                };
+                copyrightUrl?: string;
+                ageLevel?: string;
+            };
         };
         /** vivo 应用商店配置 */
         vivo?: {
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
             /** 认证信息 */
-            auth: {
+            auth?: {
                 /** Access Key (vivo 开放平台分配) */
                 accessKey: string;
                 /** Access Secret */
@@ -380,8 +461,10 @@
         tencent?: {
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
             /** 认证信息 */
-            auth: {
+            auth?: {
                 /** 开发者用户 ID (分配给开发者的数字 ID) */
                 userId: string;
                 /** 应用 ID (应用宝分配的应用标识) */
@@ -396,8 +479,10 @@
         google_play?: {
             /** 是否启用 */
             enable: boolean;
+            /** 本地安全存储中的凭据 Profile。 */
+            credentialProfile?: string;
             /** 认证信息 */
-            auth: {
+            auth?: {
                 /** 服务账号 JSON 文件路径 */
                 serviceAccountJsonPath?: string;
                 /** 服务账号 JSON 内容 */
@@ -405,8 +490,8 @@
             };
             /** 包名 */
             packageName?: string;
-            /** 发布轨道；首版只支持 internal */
-            track?: 'internal';
+            /** 保存草稿的轨道，默认 internal；production 也只保存草稿，不送审或上线。 */
+            track?: 'internal' | 'production';
         };
         /** 未来扩展的其他平台 */
         [key: string]: any;
@@ -419,13 +504,15 @@
     version: string;
     /** 应用名称 */
     appName?: string;
+    /** 应用包名或 Bundle ID */
+    packageName?: string;
     /** 构建号 */
     buildNumber: string;
     /** 更新日志 */
     changelog: string;
     /** 本次要上传到的平台列表 */
     platform?: string[];
-    /** 构建产物路径（apk/ipa，支持 Record<ABI, Path> 形式以适配多架构） */
+    /** 构建产物路径（apk/aab/hap/app/ipa，支持 Record<ABI, Path> 形式以适配多架构） */
     artifactPath?: string | Record<string, string>;
     /** 按平台保留的产物集合，供上传调度层选择单包或多架构组合 */
     platformArtifacts?: Record<string, string | Record<string, string>>;
@@ -455,8 +542,8 @@
     /** 二维码地址 */
     qrCode?: string;
     /**
-     * 原始错误对象 (可选)
-     * 仅用于调试，UI 不应直接展示此字段
+     * 已脱敏错误对象 (可选)
+     * 禁止返回含请求头、Token、签名参数或完整平台响应的原始错误。
      */
     error?: Error | any;
     /** 平台特有的响应数据 */
@@ -476,7 +563,7 @@
     /**
      * 上传产物
      */
-    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    upload(filePath: string, config: any, metadata: AppMetadata, onProgress?: ReleaseProgressObserver): Promise<UploadResult>;
     /**
      * 判断该上传器是否能处理指定文件
      * 用于多文件混合上传的智能分发
@@ -501,147 +588,860 @@
     /** 平台：android | ios | harmony */
     platform: 'android' | 'ios' | 'harmony';
 }
+/** 荣耀、魅族和三星共用的公开配置；私钥内容只在本机执行内存出现。 */
+interface AndroidStoreConfig {
+    enable: boolean;
+    credentialProfile?: string;
+    packageName: string;
+    appId?: string;
+    releaseType?: 'draft';
+    gms?: 'Y' | 'N';
+    binarySeq?: string;
+    auth?: {
+        clientId?: string;
+        clientSecret?: string;
+        serviceAccountId?: string;
+        privateKeyPath?: string;
+        privateKeyContent?: string;
+    };
+}
 
-declare class EnvValidator {
-    /**
-     * 验证环境变量
-     * @param requiredVars 必需的环境变量列表
-     */
-    static validate(requiredVars: string[]): boolean;
+/** App Ship 首版正式支持的平台标识。TestFlight 与 Ad Hoc 在验证完成前不进入此集合。 */
+type ReleasePlatform = 'pgyer' | 'huawei' | 'harmony' | 'xiaomi' | 'oppo' | 'vivo' | 'tencent' | 'app_store' | 'google_play' | 'honor' | 'meizu' | 'samsung';
+/** 平台真实动作，禁止再用 upload 统称所有远端副作用。 */
+type ReleaseAction = 'upload_build' | 'create_draft' | 'distribute_test_build' | 'submit_review' | 'submit_review_auto_release' | 'schedule_release_after_review';
+/** 发布目标的业务类型；构建产物可以来自任意技术栈。 */
+type ReleaseChannelKind = 'test_distribution' | 'store';
+type ReleaseResultingState = 'build_uploaded' | 'draft_created' | 'test_build_distributed' | 'review_submitted' | 'review_submitted_auto_release' | 'review_submitted_scheduled_release';
+type ReleaseAfterApproval = 'not_applicable' | 'manual_release' | 'auto_release' | 'scheduled_release' | 'platform_controlled';
+type ReleaseRiskLevel = 'low' | 'medium' | 'high' | 'critical';
+type ReleaseWithdrawal = 'not_applicable' | 'console_only' | 'api_supported' | 'not_verified' | 'unsupported';
+type ReleaseCancelUntil = 'before_remote_request' | 'before_distribution_created' | 'while_remote_draft_exists' | 'before_review_starts_if_platform_allows' | 'platform_controlled' | 'not_verified';
+interface ReleasePlatformCapability {
+    platform: ReleasePlatform;
+    channelKind: ReleaseChannelKind;
+    supportedActions: readonly ReleaseAction[];
+    defaultAction: ReleaseAction;
+    resultingState: ReleaseResultingState;
+    afterApproval: ReleaseAfterApproval;
+    cancelUntil: ReleaseCancelUntil;
+    withdrawal: ReleaseWithdrawal;
+    riskLevel: ReleaseRiskLevel;
+    /** 送审与直接分发动作默认禁止自动重试，避免重复版本或重复送审。 */
+    automaticRetry: 'allowed_for_pre_submission_steps' | 'disabled';
+    requiresExplicitConfirmation: boolean;
+    evidence: 'official_documentation' | 'code_observation' | 'official_and_code';
+    note: string;
+}
+/**
+ * 当前平台能力矩阵。
+ *
+ * OPPO、vivo、腾讯的动作结论来自当前适配器代码；字段级官方验证完成前维持最高风险。
+ */
+declare const RELEASE_PLATFORM_CAPABILITIES: Readonly<Record<ReleasePlatform, ReleasePlatformCapability>>;
+interface ReleaseArtifactBinding {
+    path: string;
+    sha256: string;
+    sizeBytes: number;
+}
+interface ReleasePlanInput {
+    platform: ReleasePlatform;
+    action: ReleaseAction;
+    packageName: string;
+    versionName: string;
+    buildNumber: string;
+    artifact: ReleaseArtifactBinding;
+    credentialProfile: string;
+    /** 蒲公英分发必须显式给出安装权限，禁止依赖平台默认公开。 */
+    distributionAccess?: 'public' | 'password' | 'invite';
+    scheduledReleaseAt?: string;
+    /** 新增商店的应用标识与公开配置指纹必须参与确认绑定。 */
+    targetAppId?: string;
+    targetConfiguration?: string;
 }
+interface ReleasePlan extends ReleasePlanInput {
+    schemaVersion: 1;
+    planId: string;
+    channelKind: ReleaseChannelKind;
+    resultingState: ReleaseResultingState;
+    afterApproval: ReleaseAfterApproval;
+    cancelUntil: ReleaseCancelUntil;
+    withdrawal: ReleaseWithdrawal;
+    riskLevel: ReleaseRiskLevel;
+    automaticRetry: ReleasePlatformCapability['automaticRetry'];
+    requiresExplicitConfirmation: boolean;
+}
+interface ReleaseConfirmation {
+    planId: string;
+    platform: ReleasePlatform;
+    action: ReleaseAction;
+    artifactSha256: string;
+    confirmedAt: string;
+}
+/** 创建不可含秘密的发布计划，并将平台、版本与产物 SHA-256 固定到 planId。 */
+declare function createReleasePlan(input: ReleasePlanInput): ReleasePlan;
+/** 验证逐平台确认是否仍与当前计划和产物完全一致。 */
+declare function assertReleaseConfirmation(plan: ReleasePlan, confirmation: ReleaseConfirmation | undefined): void;
+/** 用于 CLI/UI/MCP 预览；固定展示安全决策字段，不包含任何凭据值。 */
+declare function formatReleasePlan(plan: ReleasePlan): string;
+declare function isSubmissionAction(action: ReleaseAction): boolean;
 
-declare class ConfigValidator {
-    /**
-     * 加载并验证配置文件
-     * @param filePath 配置文件路径
-     */
-    static loadAndValidate(filePath: string): UploadConfig | null;
+type CredentialStorageKind = 'os_secure_storage' | 'encrypted_local_vault' | 'external_file';
+/** MCP 与模型允许读取的凭据元数据；禁止增加秘密值、路径或可还原摘要。 */
+interface CredentialProfileMetadata {
+    credentialProfile: string;
+    platform: ReleasePlatform;
+    configured: boolean;
+    verified: boolean;
+    storageKind: CredentialStorageKind;
+    verifiedAt?: string;
+}
+/** UI、CLI 和 MCP 可使用的只读目录接口。 */
+interface CredentialProfileCatalog {
+    listMetadata(): Promise<CredentialProfileMetadata[]>;
+    getMetadata(credentialProfile: string): Promise<CredentialProfileMetadata | undefined>;
+}
+/**
+ * 仅可信本机执行器与用户主动查看边界可使用的秘密材料。
+ *
+ * 文件型凭据可以返回已在本地安全读取的内容，也可以返回经过安全检查的外部路径；
+ * 该对象不得进入日志、回执、MCP 返回值或模型上下文。
+ */
+interface CredentialMaterial {
+    /** 档案的标量账号字段，仅保留在可信调用内存中。 */
+    fields: Readonly<Record<string, string>>;
+    /** 文件型账号材料；没有文件时省略，普通 local_display 不返回此字段。 */
+    files?: Readonly<Record<string, {
+        /** 安全读取或解密后的正文；未载入正文时省略。 */
+        content?: string;
+        /** 已通过存储边界检查的外部路径；文件内容已内存化时省略。 */
+        externalPath?: string;
+    }>>;
+}
+/** 受信任本机调用的明确用途；普通回显和用户主动查看文件分别授权。 */
+interface CredentialResolveRequest {
+    /** 本机安全库中已保存的账号引用。 */
+    credentialProfile: string;
+    /** 必须与该引用登记的平台相同。 */
+    platform: ReleasePlatform;
+    /** local_display 仅回显标量；local_view 仅用于用户主动查看文件；local_export 继续拒绝。 */
+    purpose: 'verify' | 'release_execution' | 'local_display' | 'local_view' | 'local_export';
+}
+/** 仅可信本地执行边界可注入此接口；不要把它暴露为 MCP Tool。 */
+interface CredentialResolver {
+    resolveForLocalExecution(request: CredentialResolveRequest): Promise<CredentialMaterial>;
+}
+/** 操作系统安全存储的最小边界；实现不得把秘密放入命令参数、日志或错误。 */
+interface SecretStore {
+    getSecret(account: string): Promise<string | undefined>;
+    setSecret(account: string, secret: string): Promise<void>;
+    deleteSecret(account: string): Promise<boolean>;
+}
+interface CredentialProfileWriteInput {
+    credentialProfile: string;
+    platform: ReleasePlatform;
+    material: CredentialMaterial;
+}
+/** CLI 管理凭据时使用的写接口，不得注册为 MCP Tool。 */
+interface CredentialProfileStore extends CredentialProfileCatalog, CredentialResolver {
+    saveProfile(input: CredentialProfileWriteInput, options?: {
+        overwrite?: boolean;
+    }): Promise<CredentialProfileMetadata>;
+    deleteProfile(credentialProfile: string): Promise<boolean>;
+}
+/** 防止实现方意外把秘密字段混入可公开元数据。 */
+declare function assertSafeCredentialMetadata(metadata: CredentialProfileMetadata): void;
+/** 限制 Profile 名进入文件、Keychain account 和日志标识后的字符边界。 */
+declare function assertCredentialProfileName(value: string): void;
+
+/** 这是当次只读鉴权结果，不能据此声称已经获得上传权限或完成分发。 */
+interface PgyerCredentialVerification {
+    platform: 'pgyer';
+    credentialProfile: string;
+    verified: boolean;
+    checkedAt: string;
+    code: 'verified' | 'credentials_unavailable' | 'invalid_credentials' | 'rejected' | 'network_unavailable' | 'invalid_response' | 'cancelled';
+}
+/** 固定 HTTPS 只读接口；禁止重定向、重试和原始错误输出，取消后不读取凭据。 */
+declare function verifyPgyerCredentialProfile(credentialProfile: string, store: CredentialResolver, signal?: AbortSignal, transport?: typeof fetch): Promise<PgyerCredentialVerification>;
+
+declare const PREFLIGHT_PLATFORMS: readonly ["huawei", "harmony", "pgyer", "honor", "meizu", "samsung", "xiaomi", "oppo", "vivo", "tencent", "app_store", "google_play"];
+/** 全部十二家只读凭据核验渠道，不含被阻断的历史上传目标。 */
+type PreflightPlatform = (typeof PREFLIGHT_PLATFORMS)[number];
+declare const PREFLIGHT_CODES: readonly ["verified", "credentials_unavailable", "invalid_credentials", "rejected", "application_not_found", "ambiguous_application", "application_mismatch", "network_unavailable", "invalid_response", "cancelled", "application_not_ready", "lookup_limit_exceeded", "unsupported_credential_method"];
+/** 核验允许对外公开的固定结果码，不含供应商原文。 */
+type PreflightCode = (typeof PREFLIGHT_CODES)[number];
+/** 核验只证明当次鉴权及应用查询；只读接口不能证明实际上传或送审权限。 */
+interface PublishPreflight {
+    /** 本次核验的固定商店渠道。 */
+    platform: PreflightPlatform;
+    /** 只解析当前平台的本机安全档案引用。 */
+    credentialProfile: string;
+    /** 明确的 Android 包名或 Apple Bundle ID，不从文件名猜测。 */
+    packageName: string;
+    /** 鉴权和适用的目标应用查询均通过时为 true。 */
+    verified: boolean;
+    /** 本次成功或失败的固定分类。 */
+    code: PreflightCode;
+    /** 本次核验时间，ISO 8601 格式。 */
+    checkedAt: string;
+    /** 当次鉴权阶段是否已经通过。 */
+    authentication: 'verified' | 'not_verified';
+    /** 应用查询是否匹配；蒲公英不预建应用，使用 not_required。 */
+    application: 'matched' | 'not_verified' | 'not_required';
+    /** 只读请求不证明上传权限，固定为 not_verified。 */
+    uploadPermission: 'not_verified';
+    /** 接口明确返回并核对的数字应用 ID；不返回 ID 的渠道省略。 */
+    appId?: string;
+}
+/**
+ * 校验明确目标标识，Apple 允许连字符，其余渠道沿用既有 Android 包名约束。
+ * @param value - 已保存的目标包名或 Bundle ID，最长 256 字符。
+ * @param platform - Apple 使用 app_store；省略时沿用 Android 包名规则。
+ */
+declare function assertPublishPackageName(value: string, platform?: string): void;
+/**
+ * 通过各平台固定只读接口核验账号与应用；不上传，也不自动更换已有目标。
+ * @param input - 已保存的明确渠道、Profile 与包名；可选 App ID 必须与查询结果一致。
+ * @param store - 本机可信凭据解析器，不回退到另一账号。
+ * @param signal - 可选取消信号；取消后不返回核验成功。
+ * @param transport - 可选 HTTP 边界，默认使用本机 fetch；全程限时 20 秒。
+ */
+declare function preflightPublish(input: {
+    /** 本次核验的固定商店渠道。 */
+    platform: PreflightPlatform;
+    /** 只解析当前平台的本机安全档案引用。 */
+    credentialProfile: string;
+    /** 明确的 Android 包名或 Apple Bundle ID，不从文件名猜测。 */
+    packageName: string;
+    /** 已保存的数字应用 ID；省略时由对应只读查询确定，不覆盖冲突目标。 */
+    appId?: string;
+}, store: CredentialResolver, signal?: AbortSignal, transport?: typeof fetch): Promise<PublishPreflight>;
+
+interface HuaweiServiceAccount {
+    key_id: string;
+    sub_account: string;
+    private_key: string;
+}
+/** 只接受完整的已有服务账号私钥；创建、扩权和密钥轮换由人处理。 */
+declare function parseHuaweiServiceAccount(content: string): HuaweiServiceAccount;
+/** JWT 只保留在执行内存，按官方规范使用固定 aud、3600 秒有效期及 32 字节 PSS 盐。 */
+declare function createHuaweiServiceAccountToken(content: string, now?: number): string;
+
+declare const CREDENTIAL_CONSOLES: {
+    readonly huawei: "https://developer.huawei.com/consumer/cn/hdc-console/index.html#/home/101653523124950083";
+    readonly harmony: "https://developer.huawei.com/consumer/cn/hdc-console/index.html#/home/101653523124950083";
+    readonly pgyer: "https://www.pgyer.com/account/api";
+    readonly honor: "https://developer.honor.com/cn/manageCenter";
+    readonly meizu: "https://developer.meizu.com/";
+    readonly samsung: "https://seller.samsungapps.com/";
+    readonly xiaomi: "https://dev.mi.com/distribute";
+    readonly oppo: "https://open.oppomobile.com/new/ecology/myApi";
+    readonly vivo: "https://dev.vivo.com.cn/personalCenter";
+    readonly tencent: "https://app.open.qq.com/p/app/list";
+    readonly app_store: "https://appstoreconnect.apple.com/access/integrations/api";
+    readonly google_play: "https://console.cloud.google.com/iam-admin/serviceaccounts";
+};
+/** 公开状态仅含调用关联、凭据引用及期限；不包含磁盘路径、秘密和浏览器原文。 */
+interface CredentialSetupStatus {
+    /** 十分钟采集任务的本机 UUID，不含材料。 */
+    setupId: string;
+    /** 当前任务固定的渠道，捕获后也不能改变。 */
+    platform: PreflightPlatform;
+    /** 当前任务保存或复用的安全档案名称。 */
+    credentialProfile: string;
+    /** 任务明确绑定的包名或 Bundle ID。 */
+    packageName: string;
+    /** 当前任务阶段；configured/cancelled 为终态，未完成任务到期后显示 expired。 */
+    status: 'waiting_for_browser' | 'captured' | 'configured' | 'expired' | 'cancelled';
+    /** 到期 Unix 时间，单位毫秒；完成后只作历史元数据。 */
+    expiresAt: number;
+    /** 打开供应商官方控制台的固定入口，不含认证字段。 */
+    consoleUrl: string;
+}
+/**
+ * 精确匹配官方 HTTPS 凭据页；华为及蒲公英新版只开放已核对的路由，不接受登录回调或任意控制台页。
+ * @param value - 浏览器当前标签页的完整地址；非法地址或不支持的页面返回 undefined。
+ */
+declare function credentialPagePlatform(value: string): PreflightPlatform | undefined;
+/** 仅操作当前用户私有请求目录；Native Host 与 MCP 复用同一个 Profile Store。 */
+declare class CredentialSetupService {
+    private readonly store;
+    private readonly directory;
+    private readonly transport;
+    private readonly now;
+    constructor(store: CredentialProfileStore, directory?: string, transport?: typeof fetch, now?: () => number);
+    private privateDirectory;
+    private readFile;
+    private filename;
+    /**
+     * 从私有目录读取并校验本机任务，不读取凭据。
+     * @param id - 当前任务的 UUID；不接受任意路径。
+     */
+    private load;
+    private status;
+    private save;
+    private locked;
+    /**
+     * 创建十分钟任务或复用已有 Profile；不读取浏览器、秘密或修改配置。
+     * @param input - 已保存的目标渠道与配置身份，不要求启用上传；更换账号须显式 refreshExisting。
+     */
+    begin(input: {
+        /** 当前项目已保存配置的绝对路径或相对当前进程的路径。 */
+        configPath: string;
+        /** 当前支持的十二渠道之一。 */
+        platform: PreflightPlatform;
+        /** 必须与配置完全相同的目标包名或 Bundle ID。 */
+        packageName: string;
+        /** 可选已有档案；省略时优先复用配置引用，再创建唯一名称。 */
+        credentialProfile?: string;
+        /** true 时创建新档案，核验成功前保留旧引用；默认 false。 */
+        refreshExisting?: boolean;
+    }): Promise<CredentialSetupStatus>;
+    /** 状态读取没有隐式保存、网络请求或补配副作用。 */
+    inspect(id: string): Promise<CredentialSetupStatus>;
+    /** 扩展只处理当前站点的唯一待采集请求，多请求时要求调用方明确选择。 */
+    pending(pageUrl: string): Promise<CredentialSetupStatus[]>;
+    /** 仅列出需要已有文件的六渠道待处理任务，不读取网页或密钥文件。 */
+    pendingImports(): Promise<CredentialSetupStatus[]>;
+    private waiting;
+    /** 仅供受信任 Native Host；材料不进入 MCP，且不能覆盖已有 Profile 或创建商店密钥。 */
+    capture(id: string, pageUrl: string, input: unknown): Promise<CredentialSetupStatus>;
+    /** 用户在扩展自身的文件选择器选择已有 JSON；材料不会进入商店页面或模型参数。 */
+    importServiceAccount(id: string, content: string): Promise<CredentialSetupStatus>;
+    /** 三星账号 ID 与已有私钥必须在同一任务中一起导入；不在网页上生成新密钥。 */
+    importSamsungPrivateKey(id: string, serviceAccountId: string, content: string): Promise<CredentialSetupStatus>;
+    /**
+     * 导入 Apple/Google/小米已有文件并配对账号字段；仅受信任 Native Host 调用。
+     * @param id - 当前等待采集的本机任务，平台不能由文件覆盖。
+     * @param content - 用户已下载文件的内存内容，不是路径或网络地址。
+     * @param fields - 当前平台所需的配对字段；Google 必须为空对象。
+     */
+    importCredentialFile(id: string, content: string, fields: Record<string, string>): Promise<CredentialSetupStatus>;
+    /**
+     * 校验平台专属字段并写入不可覆盖的安全档案，文件型渠道须使用导入入口。
+     * @param task - 已锁定且仍在等待采集的当前任务。
+     * @param input - 浏览器经本机管道提交的材料，不允许额外或被遮盖字段。
+     */
+    private saveCaptured;
+    /**
+     * 核验成功后补入 Profile/App ID 并同步已有表单快照；配置变化、冲突或取消停止写入。
+     * @param id - 本机采集任务标识，必须处于已采集状态或已经完成。
+     * @param signal - 可选取消信号，核验及配置落盘前再次检查。
+     * @param assertCurrent - 可选宿主检查，在原子替换前确认当前项目未改变。
+     */
+    complete(id: string, signal?: AbortSignal, assertCurrent?: () => void): Promise<{
+        code: string;
+        /** 十分钟采集任务的本机 UUID，不含材料。 */
+        setupId: string;
+        /** 当前任务固定的渠道，捕获后也不能改变。 */
+        platform: PreflightPlatform;
+        /** 当前任务保存或复用的安全档案名称。 */
+        credentialProfile: string;
+        /** 任务明确绑定的包名或 Bundle ID。 */
+        packageName: string;
+        /** 当前任务阶段；configured/cancelled 为终态，未完成任务到期后显示 expired。 */
+        status: "waiting_for_browser" | "captured" | "configured" | "expired" | "cancelled";
+        /** 到期 Unix 时间，单位毫秒；完成后只作历史元数据。 */
+        expiresAt: number;
+        /** 打开供应商官方控制台的固定入口，不含认证字段。 */
+        consoleUrl: string;
+    } | {
+        preflight: PublishPreflight;
+        /** 十分钟采集任务的本机 UUID，不含材料。 */
+        setupId: string;
+        /** 当前任务固定的渠道，捕获后也不能改变。 */
+        platform: PreflightPlatform;
+        /** 当前任务保存或复用的安全档案名称。 */
+        credentialProfile: string;
+        /** 任务明确绑定的包名或 Bundle ID。 */
+        packageName: string;
+        /** 当前任务阶段；configured/cancelled 为终态，未完成任务到期后显示 expired。 */
+        status: "waiting_for_browser" | "captured" | "configured" | "expired" | "cancelled";
+        /** 到期 Unix 时间，单位毫秒；完成后只作历史元数据。 */
+        expiresAt: number;
+        /** 打开供应商官方控制台的固定入口，不含认证字段。 */
+        consoleUrl: string;
+    }>;
+    /** 取消只关闭请求，已保存的 Profile 保留；绝不隐式删除用户凭据。 */
+    cancel(id: string): Promise<CredentialSetupStatus>;
+}
+
+declare const DEFAULT_CREDENTIAL_VAULT_PATH: string;
+interface SecurityCommandResult {
+    code: number;
+    stdout: string;
+}
+type SecurityCommandRunner = (args: string[], input?: string) => Promise<SecurityCommandResult>;
+/**
+ * macOS Keychain 适配器。
+ *
+ * 写入时让 `security` 从 stdin 读取秘密，避免秘密出现在进程参数或错误文本中。
+ */
+declare class MacOSKeychainSecretStore implements SecretStore {
+    private readonly service;
+    private readonly runner;
+    constructor(service?: string, runner?: SecurityCommandRunner);
+    getSecret(account: string): Promise<string | undefined>;
+    setSecret(account: string, secret: string): Promise<void>;
+    deleteSecret(account: string): Promise<boolean>;
+}
+/**
+ * 本地凭据 Profile 存储。
+ *
+ * 标量秘密保存在操作系统安全存储；文件型凭据使用 Keychain 主密钥进行
+ * AES-256-GCM 加密。Vault 明文区只保存允许 MCP 读取的元数据。
+ */
+declare class LocalCredentialProfileStore implements CredentialProfileStore {
+    private readonly secretStore;
+    private readonly vaultPath;
+    constructor(secretStore: SecretStore, vaultPath?: string);
+    listMetadata(): Promise<CredentialProfileMetadata[]>;
+    getMetadata(credentialProfile: string): Promise<CredentialProfileMetadata | undefined>;
+    saveProfile(input: CredentialProfileWriteInput, options?: {
+        overwrite?: boolean;
+    }): Promise<CredentialProfileMetadata>;
+    private saveProfileUnlocked;
+    deleteProfile(credentialProfile: string): Promise<boolean>;
+    private deleteProfileUnlocked;
+    /**
+     * 为可信本机调用读取当前平台材料；普通回显不解密文件，主动查看仅在本机返回内容。
+     * @param request - 明确平台、档案与用途；local_view 由用户点击查看触发，local_export 继续拒绝。
+     */
+    resolveForLocalExecution(request: CredentialResolveRequest): Promise<CredentialMaterial>;
+    private encryptFiles;
+    private decryptFiles;
+    private getOrCreateMasterKey;
+    private getMasterKey;
+    private restoreSecret;
+    private readDocument;
+    /** 多个 Native Host/CLI 进程共享同一安全库，读改写必须排他；冲突明确失败，不覆盖或自动重试。 */
+    private withWriteLock;
+    private writeDocument;
+}
+/** 创建当前平台已验证的默认凭据存储；其它平台必须显式失败。 */
+declare function createDefaultCredentialProfileStore(vaultPath?: string): LocalCredentialProfileStore;
+
+interface CredentialMigrationOptions {
+    profilePrefix?: string;
+    baseDirectory?: string;
+}
+interface CredentialMigrationResult {
+    config: UploadConfig;
+    migratedProfiles: string[];
+}
+/**
+ * 把旧 YAML 中的秘密迁移到本地 Profile，并返回不含秘密的新配置。
+ * 调用方负责将返回配置写入不同文件；本函数不会覆盖原配置。
+ */
+declare function migrateLegacyCredentials(source: UploadConfig, store: CredentialProfileStore, options?: CredentialMigrationOptions): Promise<CredentialMigrationResult>;
+/** 迁移必须可回滚；回滚不完整时提升为需要人工处理的安全错误。 */
+declare function rollbackCredentialProfiles(store: CredentialProfileStore, credentialProfiles: readonly string[]): Promise<void>;
+/** 仅在可信本地执行边界把 Profile 还原到内存配置，返回值不得记录或序列化。 */
+declare function hydrateCredentialProfiles(source: UploadConfig, store: CredentialResolver): Promise<UploadConfig>;
+/** 将当前可信宿主的临时账号转换为既有执行器材料；不持久化或读取文件内容。
+ * @param platform - 当前单一目标渠道。
+ * @param config - 该渠道的内存配置；秘密只进入本机执行器，不进入计划或日志。
+ * @param baseDirectory - 相对私密文件路径的绝对解析起点。
+ * @returns 有材料时返回字段/文件引用，未配置账号时返回 undefined。
+ */
+declare function resolveInlineCredentialMaterial(platform: ReleasePlatform, config: any, baseDirectory: string): CredentialMaterial | undefined;
+
+/**
+ * 上传管理器配置
+ */
+interface UploadManagerConfig {
+    maxConcurrent?: number;
+    continueOnError?: boolean;
+    verbose?: boolean;
+    cancellationToken?: {
+        isCancelled: boolean;
+    };
+}
+/**
+ * 聚合的上传结果报告
+ */
+interface UploadReport {
+    totalUploads: number;
+    successCount: number;
+    failureCount: number;
+    successPlatforms: string[];
+    failurePlatforms: string[];
+    results: UploadResult[];
+    totalDurationMs: number;
+    summary: string;
+}
+/**
+ * 上传管理器 - 处理多平台并行上传
+ */
+declare class UploadManager {
+    private uploaders;
+    private config;
+    constructor(config?: UploadManagerConfig);
     /**
-     * 只收集本次实际启用配置中的环境变量，避免禁用平台阻塞其它上传任务。
+     * 注册上传器
      */
-    private static collectRequiredEnvVars;
-    /** 在内存中递归解析环境变量，不重新拼接 YAML，避免密钥字符破坏 YAML 结构。 */
-    private static resolveEnvVars;
+    registerUploader(platform: string, uploader: IUploader): void;
     /**
-     * 验证配置 Schema
-     * @param config 配置对象
+     * 获取启用的平台列表（根据配置）
      */
-    private static validateSchema;
-}
-
-declare class PgyerUploader implements IUploader {
-    name: string;
-    private static UPLOAD_API;
+    getEnabledPlatforms(config: any): string[];
     /**
-     * 验证配置
-     * @param config 配置对象
+     * 获取可用的平台列表
      */
-    validateConfig(config: any): boolean;
+    getAvailablePlatforms(): string[];
     /**
-     * 判断是否支持该文件
-     * @param filePath 文件路径
+     * 执行并行上传（支持多文件智能分发）
      */
-    canHandle(filePath: string): boolean;
+    uploadToMultiplePlatforms(filePaths: string | string[], // 支持单文件或文件数组
+    config: any, metadata: AppMetadata, targetPlatforms?: string[], signal?: AbortSignal, onProgress?: ReleaseProgressObserver): Promise<UploadReport>;
     /**
-     * 上传文件到蒲公英
-     * @param filePath 文件路径
-     * @param config 配置
-     * @param metadata 元数据
+     * 上传到单个平台
      */
-    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    private uploadToPlatform;
     /**
-     * 执行实际上传操作
-     * @param filePath 文件路径
-     * @param apiKey API Key
-     * @param desc 描述
+     * 适配器结果是外部边界，默认只保留白名单远端标识。
+     * 完整响应与请求对象可能含 Token、签名或账号信息，不能进入上层 UI/MCP。
      */
-    private performUpload;
-}
-
-declare class HuaweiUploader implements IUploader {
-    name: string;
-    private static DEFAULT_API_BASE;
-    private static TOKEN_PATH;
-    private static PUBLISH_API_PATH;
-    /** 获取 API 基础地址 */
-    private getApiBase;
-    /** 获取 Token URL */
-    private getTokenUrl;
-    /** 获取 Publish API 根路径 */
-    private getApiRoot;
-    /** 创建 API 请求头（消除 7 处重复） */
-    private headers;
-    /** 检查 API 响应（消除 6 处重复） */
-    private checkResponse;
+    private sanitizeUploadResult;
+    private shouldGroupArtifacts;
+    private resolveArtifactSelection;
+    private buildArtifactMapFromFiles;
+    private inferArtifactKey;
+    private getRepresentativeFilePath;
+    private validateArtifactSelection;
     /**
-     * 验证配置
-     * @param config 配置对象
-     * @returns 是否有效
+     * 聚合上传结果
      */
-    validateConfig(config: any): boolean;
+    private aggregateResults;
     /**
-     * 判断是否支持该文件
-     * @param filePath 文件路径
-     * @returns 是否支持
+     * 输出上传报告
      */
-    canHandle(filePath: string): boolean;
+    private printReport;
     /**
-     * 执行上传
-     * @param filePath 文件路径
-     * @param config 配置
-     * @param metadata 元数据
+     * 格式化持续时间
      */
-    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    private formatDuration;
     /**
-     * 查询审核状态
-     * @param clientId 客户端 ID
-     * @param clientSecret 客户端密钥
-     * @param appId 应用 ID
-     * @param apiBaseUrl API 基础地址（可选）
+     * 获取可重试的失败平台
      */
-    queryReviewStatus(clientId: string, clientSecret: string, appId: string, apiBaseUrl?: string): Promise<any>;
+    getRetryablePlatforms(report: UploadReport): string[];
     /**
-     * 获取 Access Token
-     * @param tokenUrl Token URL
-     * @param clientId 客户端 ID
-     * @param clientSecret 客户端密钥
+     * 重试失败的平台
      */
-    private getAccessToken;
-    /** 获取上传 URL */
-    private getUploadUrl;
-    /** 通用文件上传（FormData 方式，无需 API 认证头） */
-    private executeUploadRequest;
-    /** 上传文件 (APK/AAB) */
-    private uploadFile;
-    /** 更新应用文件信息 */
-    private updateAppFileInfo;
-    /** 更新发布说明（支持多语言） */
-    private updateReleaseNotes;
-    /** 提交审核 */
-    private submitForReview;
-    /** 获取应用信息 */
-    private getAppInfo;
-    /** 上传商店素材（图标、截图、视频） */
-    private uploadStoreAssets;
-    /** 批量上传素材文件 */
-    private uploadAssetFiles;
-    /** 更新素材文件信息（关联到应用） */
-    private updateAssetFileInfo;
+    retryFailedPlatforms(failedPlatforms: string[], filePath: string | string[], config: any, metadata: AppMetadata): Promise<UploadReport>;
 }
-
 /**
- * 小米应用商店上传器
- *
- * 基于小米官方「应用自动发布接口」实现
- * 文档: https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1134
- *
- * 上传流程:
- * 1. 构建 RequestData JSON (userName, appInfo, synchroType)
- * 2. 计算所有参数的 MD5 (RequestData 字符串 + APK 文件)
- * 3. 拼接 SIG JSON, 用 RSA 公钥加密
- * 4. POST multipart/form-data 到 /dev/push
+ * 创建上传管理器实例
  */
-declare class XiaomiUploader implements IUploader {
+declare function createUploadManager(config?: UploadManagerConfig): UploadManager;
+
+declare const RELEASE_RECEIPT_SCHEMA_VERSION: 1;
+declare const DEFAULT_RELEASE_RECEIPT_LIMIT = 100;
+type ReleaseReceiptKind = 'build' | 'upload';
+type ReleaseReceiptOutcome = 'success' | 'partial' | 'failed' | 'cancelled';
+type ReleaseReceiptState = 'built' | 'uploaded' | 'draft_created' | 'review_submitted' | 'reviewing' | 'approved' | 'rejected' | 'released' | 'failed' | 'cancelled';
+interface ReleaseArtifactReceipt {
+    path: string;
+    name: string;
+    sizeBytes?: number;
+    sha256?: string;
+    available: boolean;
+}
+interface ReleaseRemoteReceipt {
+    consoleUrl?: string;
+    downloadUrl?: string;
+    identifiers?: Record<string, string | number | boolean>;
+}
+interface ReleaseTargetReceipt {
+    platform: string;
+    /** 绑定本次执行计划，便于把回执追溯到人工核对的动作和产物。 */
+    planId?: string;
+    channelKind?: ReleasePlan['channelKind'];
+    action?: ReleasePlan['action'];
+    resultingState?: ReleasePlan['resultingState'];
+    state: ReleaseReceiptState;
+    outcome: ReleaseReceiptOutcome;
+    message: string;
+    remote?: ReleaseRemoteReceipt;
+    lastKnownRemoteStatus?: string;
+    checkedAt?: string;
+}
+interface ReleaseReceipt {
+    schemaVersion: typeof RELEASE_RECEIPT_SCHEMA_VERSION;
+    id: string;
+    projectKey: string;
+    projectRoot: string;
+    kind: ReleaseReceiptKind;
+    appName?: string;
+    packageName?: string;
+    versionName?: string;
+    buildNumber?: string;
+    changelog?: string;
+    artifacts: ReleaseArtifactReceipt[];
+    targets: ReleaseTargetReceipt[];
+    outcome: ReleaseReceiptOutcome;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+}
+interface ReleaseReceiptInput {
+    projectRoot: string;
+    kind: ReleaseReceiptKind;
+    appName?: string;
+    packageName?: string;
+    versionName?: string;
+    buildNumber?: string | number;
+    changelog?: string;
+    artifactPaths?: unknown;
+    targets: ReleaseTargetReceipt[];
+    startedAt?: string | number | Date;
+    finishedAt?: string | number | Date;
+    outcome?: ReleaseReceiptOutcome;
+}
+interface ReleaseReceiptStoreOptions {
+    storageRoot?: string;
+    maxEntries?: number;
+}
+/** 解析发布回执所属项目；显式项目目录优先，未提供时才使用配置文件目录。 */
+declare function resolveReleaseProjectRoot(projectRoot: string | undefined, configPath: string): string;
+/** 将可能包含凭据的错误信息压缩为可安全持久化的短文本。 */
+declare function sanitizeReleaseMessage(value: unknown, maxLength?: number): string;
+/** 将上传结果转换为稳定、可公开展示的渠道状态。 */
+declare function createUploadTargets(results: UploadResult[]): ReleaseTargetReceipt[];
+/** 创建回执；只接受已经挑选过的业务字段，不接受完整配置或原始响应。 */
+declare function createReleaseReceipt(input: ReleaseReceiptInput): Promise<ReleaseReceipt>;
+/** 将回执转换为适合复制给客户或 AI 的纯文本摘要。 */
+declare function formatReleaseReceipt(receipt: ReleaseReceipt): string;
+/** 按项目保存脱敏回执；同一进程中的多个实例共享写入顺序，不提供跨进程互斥。 */
+declare class ReleaseReceiptStore {
+    /** 以规范化文件路径串行化读改写，完成后释放，防止并行商店覆盖彼此回执。 */
+    private static readonly pendingAppends;
+    /** 回执目录的绝对路径，默认位于用户目录下的 .flu-cli/release-receipts。 */
+    private readonly storageRoot;
+    /** 每个项目最多保留的回执条数，构造时至少为 1。 */
+    private readonly maxEntries;
+    /**
+     * 配置本地回执目录和保留数量，不在构造时读写文件。
+     * @param options - 可选存储设置；省略目录使用用户默认目录，省略数量保留 100 条。
+     */
+    constructor(options?: ReleaseReceiptStoreOptions);
+    /**
+     * 在同进程的项目文件写入队列中合并回执，再原子替换文件；失败不阻塞后续写入。
+     * @param receipt - 已脱敏并带有项目键的完整回执；相同 ID 替换旧记录。
+     */
+    append(receipt: ReleaseReceipt): Promise<void>;
+    /**
+     * 读取指定项目最近的回执，项目尚无文件时返回空列表。
+     * @param projectRoot - 项目目录，优先解析符号链接以统一项目身份。
+     * @param limit - 返回条数上限，默认 20，负数按 0 处理。
+     */
+    list(projectRoot: string, limit?: number): Promise<ReleaseReceipt[]>;
+    /**
+     * 生成脱敏回执并等待持久化完成；保存失败向调用方抛错。
+     * @param input - 应用、产物与渠道结果等允许记录的业务字段。
+     */
+    save(input: ReleaseReceiptInput): Promise<ReleaseReceipt>;
+    /**
+     * 返回项目回执文件路径，不在此创建文件。
+     * @param projectKey - 已按项目规范化路径生成的稳定哈希键。
+     */
+    private getFilePath;
+    /**
+     * 读取兼容的回执集合，仅文件不存在时按空集合处理。
+     * @param filePath - 当前项目的回执文件绝对路径。
+     * @param projectKey - 文件所属项目键，空文件集合也使用此键。
+     */
+    private readFile;
+}
+declare function createProjectKey(projectRoot: string): string;
+
+interface ReleaseExecutorDependencies {
+    /** 只允许执行器使用本机解析能力，不需要暴露 Profile 写入接口。 */
+    credentialStore: CredentialResolver;
+    uploadManager?: UploadManager;
+    receiptStore?: ReleaseReceiptStore;
+}
+interface ReleaseExecutionInput {
+    plan: ReleasePlan;
+    confirmation?: ReleaseConfirmation;
+    config: UploadConfig;
+    metadata?: Partial<AppMetadata>;
+    projectRoot: string;
+    dependencies: ReleaseExecutorDependencies;
+    /** 宿主取消在远端请求开始前生效；上传已开始时不承诺撤回远端副作用。 */
+    signal?: AbortSignal;
+    /** 可选只读进度，载荷不包含秘密、令牌或供应商原始正文。 */
+    onProgress?: ReleaseProgressObserver;
+    /** 受信任本机宿主在远端请求前复核磁盘配置或会话；不能用于代替人工确认。 */
+    beforeRemoteRequest?: () => Promise<void>;
+}
+interface ReleaseExecutionResult {
+    plan: ReleasePlan;
+    report: UploadReport;
+    receipt: ReleaseReceipt;
+}
+interface ReleaseBatchExecutionResult {
+    plans: readonly ReleasePlan[];
+    report: UploadReport;
+    receipt: ReleaseReceipt;
+}
+/**
+ * 可信本机发布执行边界。
+ *
+ * 调用方必须先提供与当前计划绑定的人工确认；执行器随后重新读取产物和
+ * credentialProfile，任何一步不一致都会在适配器发起网络请求前停止。
+ */
+declare function executeReleasePlan(input: ReleaseExecutionInput): Promise<ReleaseExecutionResult>;
+declare function executeReleasePlans(input: Omit<ReleaseExecutionInput, 'plan' | 'confirmation'> & {
+    plans: readonly ReleasePlan[];
+    confirmations?: readonly ReleaseConfirmation[];
+}): Promise<ReleaseBatchExecutionResult>;
+/** 重新核对计划绑定的普通文件、大小、摘要和安装包身份。 */
+declare function assertReleaseArtifactMatchesPlan(plan: ReleasePlan, metadata?: Partial<AppMetadata>): Promise<void>;
+
+declare class EnvValidator {
+    /**
+     * 验证环境变量
+     * @param requiredVars 必需的环境变量列表
+     */
+    static validate(requiredVars: string[]): boolean;
+}
+
+declare class ConfigValidator {
+    /**
+     * 加载并验证配置文件
+     * @param filePath 配置文件路径
+     */
+    static loadAndValidate(filePath: string): UploadConfig | null;
+    /** Profile 已在可信执行边界解析后，要求所有启用平台都具备真实认证材料。 */
+    static validateResolved(config: UploadConfig): boolean;
+    /**
+     * 只收集本次实际启用配置中的环境变量，避免禁用平台阻塞其它上传任务。
+     */
+    private static collectRequiredEnvVars;
+    /** 在内存中递归解析环境变量，不重新拼接 YAML，避免密钥字符破坏 YAML 结构。 */
+    private static resolveEnvVars;
+    /**
+     * 验证配置 Schema
+     * @param config 当前渠道配置及可选本地化发行说明。
+     * @param allowCredentialProfiles 是否允许仅保存本机凭据引用；执行前必须为 false。
+     */
+    private static validateSchema;
+}
+
+declare class PgyerUploader implements IUploader {
+    name: string;
+    private static UPLOAD_API;
+    /**
+     * 验证配置
+     * @param config 配置对象
+     */
+    validateConfig(config: any): boolean;
+    /**
+     * 判断是否支持该文件
+     * @param filePath 文件路径
+     */
+    canHandle(filePath: string): boolean;
+    /**
+     * 上传文件到蒲公英
+     * @param filePath 待分发的 APK 或 IPA 本地路径。
+     * @param config 已确认的蒲公英 API Key 和安装权限配置。
+     * @param metadata 本次版本信息与更新日志。
+     * @param onProgress 可选进度观察器，只报告本次上传与处理阶段。
+     */
+    upload(filePath: string, config: any, metadata: AppMetadata, onProgress?: ReleaseProgressObserver): Promise<UploadResult>;
+    /**
+     * 执行实际上传操作
+     * @param filePath 文件路径
+     * @param apiKey API Key
+     * @param desc 描述
+     */
+    private performUpload;
+}
+
+declare class HuaweiUploader implements IUploader {
+    name: string;
+    private static DEFAULT_API_BASE;
+    private static TOKEN_PATH;
+    private static PUBLISH_API_PATH;
+    /** 获取 API 基础地址 */
+    private getApiBase;
+    /** 获取 Token URL */
+    private getTokenUrl;
+    /** 获取 Publish API 根路径 */
+    private getApiRoot;
+    /** 创建 API 请求头（消除 7 处重复） */
+    private headers;
+    /** 检查 API 响应（消除 6 处重复） */
+    private checkResponse;
+    /**
+     * 验证配置
+     * @param config 配置对象
+     * @returns 是否有效
+     */
+    validateConfig(config: any): boolean;
+    /**
+     * 判断是否支持该文件
+     * @param filePath 文件路径
+     * @returns 是否支持
+     */
+    canHandle(filePath: string): boolean;
+    /**
+     * 执行上传
+     * @param filePath 已确认的正式安装包路径。
+     * @param config 当前渠道配置、内存认证材料及可选本地化说明。
+     * @param metadata 当前计划绑定的应用版本和旧入口单语言说明。
+     */
+    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    /**
+     * 查询审核状态
+     * @param clientId 客户端 ID
+     * @param clientSecret 客户端密钥
+     * @param appId 应用 ID
+     * @param apiBaseUrl API 基础地址（可选）
+     */
+    queryReviewStatus(clientId: string, clientSecret: string, appId: string, apiBaseUrl?: string): Promise<any>;
+    /**
+     * 获取 Access Token
+     * @param tokenUrl Token URL
+     * @param clientId 客户端 ID
+     * @param clientSecret 客户端密钥
+     */
+    private getAccessToken;
+    /** 获取上传 URL */
+    private getUploadUrl;
+    /** 通用文件上传（FormData 方式，无需 API 认证头） */
+    private executeUploadRequest;
+    /** 上传文件 (APK/AAB) */
+    private uploadFile;
+    /** 更新应用文件信息 */
+    private updateAppFileInfo;
+    /** 提交审核 */
+    private submitForReview;
+    /** 获取应用信息 */
+    private getAppInfo;
+    /** 上传商店素材（图标、截图、视频） */
+    private uploadStoreAssets;
+    /** 批量上传素材文件 */
+    private uploadAssetFiles;
+    /** 更新素材文件信息（关联到应用） */
+    private updateAssetFileInfo;
+}
+
+/**
+ * 小米应用商店上传器
+ *
+ * 基于小米官方「应用自动发布接口」实现
+ * 文档: https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1134
+ *
+ * 上传流程:
+ * 1. 构建 RequestData JSON (userName, appInfo, synchroType)
+ * 2. 计算所有参数的 MD5 (RequestData 字符串 + APK 文件)
+ * 3. 拼接 SIG JSON, 用 RSA 公钥加密
+ * 4. POST multipart/form-data 到 /dev/push
+ */
+declare class XiaomiUploader implements IUploader {
     name: string;
     private static readonly API_BASE;
     private static readonly PUSH_API;
@@ -687,13 +1487,11 @@ declare class XiaomiUploader implements IUploader {
     validateConfig(config: any): boolean;
     canHandle(filePath: string): boolean;
     /**
-     * 查询应用状态
-     * 使用 POST /dev/query 接口，需要 SIG 签名认证
-     *
-     * 返回值说明:
-     * - create: true → 需要通过新增方式上传 (synchroType=0)
-     * - updateVersion: true → 可以更新包 (synchroType=1)
-     * - updateInfo: true → 可以仅更新信息 (synchroType=2)
+     * 查询本账号包状态；仅成功响应的明确许可决定新增或更新，其余结果中止自动模式。
+     * @param userName 小米开发者账号邮箱。
+     * @param packageName 本次已确认的目标应用包名。
+     * @param privateKey API 访问密码，仅参与 SIG 加密，不是账号登录密码。
+     * @param publicKeyObj 平台公钥，用于加密查询 SIG。
      */
     private queryAppStatus;
     /**
@@ -704,7 +1502,17 @@ declare class XiaomiUploader implements IUploader {
         categoryId: number;
         categoryName: string;
     }[] | null>;
+    /**
+     * 按明确上传类型或查询许可提交本次安装包；自动查询失败不继续推送。
+     * @param filePath 单包默认路径，元数据产物字典存在时使用字典。
+     * @param config 已确认的小米目标配置、认证材料与可选首发资料。
+     * @param metadata 本次版本、更新日志及可选架构产物映射。
+     */
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    /**
+     * 组装已决定的上传动作、文件摘要与 RSA SIG，单次推送至小米审核接口。
+     * @param params 已确认的新增或更新动作、账号、公钥、安装包映射及可选商店资料；素材只按现有支持范围发送，不自动重试。
+     */
     private performUpload;
     /**
      * 解析公钥: 优先使用内容字段, 其次从文件路径读取
@@ -750,12 +1558,16 @@ declare class AppleStoreUploader implements IUploader {
      */
     canHandle(filePath: string): boolean;
     /**
-     * 执行上传流程
+     * 执行一次 IPA 上传；可选发行说明更新仍可重试，上传失败必须人工核对后另行执行。
+     * @param filePath 已确认的 IPA 本地路径。
+     * @param config App Store 配置、账号材料及发行说明请求的重试设置。
+     * @param metadata 本次版本信息与可选更新日志。
      */
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
     /**
-     * 使用可用的工具上传
-     * 策略: 优先 Transporter → 降级 altool → 都失败
+     * 先探测工具，再执行一次上传；探测失败可选备选工具，上传执行失败不得隐式二次上传。
+     * @param ipaPath 本次人工确认的 IPA 路径。
+     * @param auth 本次 Apple ID 与 App 专用密码，仅传递给选定工具。
      */
     private uploadWithAvailableTool;
     /**
@@ -765,233 +1577,48 @@ declare class AppleStoreUploader implements IUploader {
     /**
      * 通过 Transporter CLI 上传
      */
-    private uploadViaTransporter;
-    /**
-     * 通过 altool 上传
-     */
-    private uploadViaAltool;
-    /**
-     * 解析 altool/Transporter 错误信息，翻译为用户友好的语言
-     */
-    private parseAltoolError;
-    /**
-     * 检查是否配置了 API Key 凭据
-     */
-    private hasApiCredentials;
-    /**
-     * 创建 JWT 生成器
-     */
-    private createJWTGenerator;
-    /**
-     * 获取 API 请求头
-     */
-    private apiHeaders;
-    /**
-     * 尝试更新发行说明（失败不影响上传结果）
-     */
-    private tryUpdateReleaseNotes;
-    /**
-     * 获取处于"准备提交"状态的版本
-     * 只有此状态下的版本才能修改发行说明
-     */
-    private getPrepareForSubmissionVersion;
-    /**
-     * 获取版本的本地化信息列表
-     */
-    private getVersionLocalizations;
-    /**
-     * 更新本地化版本的 What's New 内容
-     */
-    private updateLocalizationWhatsNew;
-    /**
-     * 获取工具安装指引
-     */
-    private getToolInstallationGuide;
-}
-
-/**
- * TestFlight 上传器
- *
- * 用于上传应用到 TestFlight 进行 Beta 测试
- * 参考: https://developer.apple.com/documentation/appstoreconnectapi/build-beta-versions
- */
-declare class TestFlightUploader implements IUploader {
-    name: string;
-    private static readonly API_ROOT;
-    private static readonly API_TIMEOUT;
-    private static readonly BUILD_PROCESSING_TIMEOUT;
-    private static readonly BUILD_POLLING_INTERVAL;
-    /**
-     * 验证配置
-     * @param config 配置对象
-     */
-    validateConfig(config: any): boolean;
-    /**
-     * 判断是否支持该文件
-     * @param filePath 文件路径
-     */
-    canHandle(filePath: string): boolean;
-    /**
-     * 执行上传到 TestFlight
-     * @param filePath 文件路径
-     * @param config 配置
-     * @param metadata 元数据
-     */
-    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
-    /**
-     * 加载 JWT 生成器
-     * @param auth 认证信息
-     */
-    private loadJWTGenerator;
-    /**
-     * 提取 Bundle ID
-     * @param ipaPath IPA 路径
-     */
-    private extractBundleId;
-    /**
-     * 创建构建记录
-     * @param jwt JWT
-     * @param bundleId Bundle ID
-     * @param version 版本号
-     */
-    private createBuild;
-    /**
-     * 上传 IPA 文件
-     * @param jwt JWT
-     * @param buildId 构建 ID
-     * @param filePath 文件路径
-     */
-    private uploadIPAFile;
-    /**
-     * 等待构建处理
-     * @param jwt JWT
-     * @param buildId 构建 ID
-     * @param timeoutMs 超时时间
-     */
-    private waitForBuildProcessing;
-    /**
-     * 创建 Beta 版本（使其可测试）
-     * @param jwt JWT
-     * @param buildId 构建 ID
-     */
-    private createBetaBuildVersion;
-    /**
-     * Add beta testers to the build
-     */
-    private addBetaTesters;
-    /**
-     * 添加单个测试员到组
-     * @param jwt JWT
-     * @param testerEmail 测试员邮箱
-     * @param buildId 构建 ID
-     */
-    private addBetaTesterToGroup;
-    /**
-     * Add localization for beta build
-     */
-    private addBetaBuildLocalization;
-    /**
-     * Add single localization
-     */
-    private addLocalizationToBuilder;
-    /**
-     * 通知测试员
-     * @param jwt JWT
-     * @param buildId 构建 ID
-     * @param message 消息
-     */
-    private notifyBetaTesters;
-}
-
-/**
- * Ad Hoc 上传器
- *
- * 用于创建 Ad Hoc 分发包，供特定设备安装
- * Ad Hoc 允许在最多 100 个特定的 iOS 设备上安装应用
- *
- * 流程:
- * 1. 使用 Xcode 生成 Ad Hoc IPA（使用指定的 Provisioning Profile）
- * 2. 生成设备安装链接/二维码
- * 3. 支持通过蒲公英或其他分发平台
- */
-declare class AdHocUploader implements IUploader {
-    name: string;
-    /**
-     * 验证配置
-     * @param config 配置对象
-     * @returns 是否有效
-     */
-    validateConfig(config: any): boolean;
-    /**
-     * 判断是否支持该文件
-     * @param filePath 文件路径
-     * @returns 是否支持
-     */
-    canHandle(filePath: string): boolean;
+    private uploadViaTransporter;
     /**
-     * 执行上传（生成 Ad Hoc 分发包）
-     * @param filePath 文件路径
-     * @param config 配置
-     * @param metadata 元数据
+     * 通过 altool 上传
      */
-    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    private uploadViaAltool;
     /**
-     * 从 IPA 提取 Bundle ID
-     * @param ipaPath IPA 路径
+     * 解析 altool/Transporter 错误信息，翻译为用户友好的语言
      */
-    private extractBundleId;
+    private parseAltoolError;
     /**
-     * 验证 Provisioning Profile
-     * @param profileSpecifier Profile 名称
-     * @param teamId 团队 ID
+     * 检查是否配置了 API Key 凭据
      */
-    private verifyProvisioningProfile;
+    private hasApiCredentials;
     /**
-     * 创建 manifest.plist 文件
-     * @param ipaPath IPA 路径
-     * @param version 版本号
-     * @param bundleId Bundle ID
-     * @param changelog 更新日志
+     * 创建 JWT 生成器
      */
-    private createManifest;
+    private createJWTGenerator;
     /**
-     * 设置分发目录结构
-     * @param ipaPath IPA 路径
-     * @param manifestPath Manifest 路径
+     * 获取 API 请求头
      */
-    private setupDistributionDirectory;
+    private apiHeaders;
     /**
-     * 生成安装链接 (itms-services)
-     * @param distributionPath 分发目录
-     * @param bundleId Bundle ID
+     * 尝试更新发行说明（失败不影响上传结果）
      */
-    private generateInstallUrl;
+    private tryUpdateReleaseNotes;
     /**
-     * 生成二维码
-     * @param url 安装链接
-     * @param distributionPath 分发目录
+     * 获取处于"准备提交"状态的版本
+     * 只有此状态下的版本才能修改发行说明
      */
-    private generateQRCode;
+    private getPrepareForSubmissionVersion;
     /**
-     * 输出分发信息
-     * @param installUrl 安装链接
-     * @param qrCodePath 二维码路径
-     * @param distributionPath 分发目录
-     * @param profileInfo Profile 信息
+     * 获取版本的本地化信息列表
      */
-    private outputDistributionInfo;
+    private getVersionLocalizations;
     /**
-     * 检查是否安装了 Xcode
-     * @returns 是否安装
+     * 更新本地化版本的 What's New 内容
      */
-    private checkXcodeInstalled;
+    private updateLocalizationWhatsNew;
     /**
-     * 生成 Ad Hoc 导出选项 (ExportOptions.plist)
-     * @param teamId 团队 ID
-     * @param signingIdentity 签名证书
-     * @param provisioningProfile Profile 名称
+     * 获取工具安装指引
      */
-    private generateExportOptions;
+    private getToolInstallationGuide;
 }
 
 /**
@@ -1002,12 +1629,19 @@ declare class HarmonyUploader implements IUploader {
     name: string;
     private static TOKEN_URL;
     private static PUBLISH_API_ROOT;
+    private static PUBLISH_API_V3_ROOT;
     validateConfig(config: any): boolean;
     /**
      * 判断是否支持该文件
      * @param filePath 文件路径
      */
     canHandle(filePath: string): boolean;
+    /**
+     * 上传文件并关联鸿蒙草稿；不等待软件包解析，不执行送审。
+     * @param filePath 已确认的 APP 或兼容 HAP 本地路径。
+     * @param config 已确认的鸿蒙应用配置与内存认证材料。
+     * @param metadata 本次版本元数据及旧入口单语言说明；草稿关联不据此推断解析结果。
+     */
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
     /**
      * 获取 Access Token
@@ -1018,14 +1652,25 @@ declare class HarmonyUploader implements IUploader {
     /**
      * 获取上传 URL
      * @param token Token
+     * @param clientId 客户端 ID
      * @param appId 应用 ID
      * @param suffix 后缀
      */
     private getUploadUrl;
     private uploadFile;
+    /**
+     * 使用 HarmonyOS Upload Management API 上传 App Pack。
+     *
+     * 分片地址是华为返回的短时效签名地址，必须原样使用其请求头，并在合并时回传每片 ETag。
+     */
+    private uploadAppPack;
+    private parseUploadHeaders;
+    private assertHuaweiSuccess;
+    private updateHarmonyAppPackageInfo;
     /**
      * 更新应用文件信息
      * @param token Token
+     * @param clientId 客户端 ID
      * @param appId 应用 ID
      * @param authCode 授权码
      * @param filePath 文件路径
@@ -1094,28 +1739,73 @@ declare class OppoUploader implements IUploader {
      * 提交版本信息
      */
     private submitVersion;
-    /**
-     * 格式化错误信息
-     */
-    private formatError;
+    /** 只提取平台错误码与脱敏后的短消息，禁止传播完整响应。 */
+    private createApiError;
 }
 
-/**
- * vivo 应用商店上传器
- *
- * 基于 vivo 开放平台「应用分发 API」实现 (协议与腾讯开放平台 Open-QQ 规范一致)
- * 文档: https://dev.vivo.com.cn/documentCenter/doc/326
- */
+/** vivo 应用分发 API 适配器，成功仅表示审核已提交。 */
 declare class VivoUploader implements IUploader {
+    /** 上传管理器中的渠道名称。 */
     name: string;
-    /** vivo 开放 API 基础地址 */
+    /** 官方生产路由，隔离验证不向此地址发起真实请求。 */
     private static readonly API_BASE;
+    /**
+     * 按 ASCII 键序计算未编码参数的 HMAC-SHA256；文件内容不参与参数拼串。
+     * @param params 本次实际发送的参数，不包含 sign 与 file。
+     * @param accessSecret 当前账号的签名密钥，仅用于内存计算。
+     */
     private generateSign;
+    /**
+     * 校验渠道已启用且具备签名材料，返回是否可执行。
+     * @param config 内存中的完整发布配置。
+     */
     validateConfig(config: any): boolean;
+    /**
+     * 判断文件扩展名是否属于当前 APK 上传能力。
+     * @param filePath 待分配到该渠道的安装包路径，扩展名忽略大小写。
+     */
     canHandle(filePath: string): boolean;
+    /**
+     * 上传选定 APK 并同步更新；任一协议失败都返回失败，不继续报告审核成功。
+     * @param filePath 单包默认路径；元数据提供产物字典时使用该字典。
+     * @param config 已由调用方核对并确认的发布配置与账号材料。
+     * @param metadata 本次版本、更新日志及可选的架构产物映射。
+     */
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    /**
+     * 以流式读取计算上传文件的 MD5，文件错误交由调用方中止上传。
+     * @param filePath 已核对存在的 APK 路径。
+     */
     private calculateFileMD5;
+    /**
+     * 创建公共参数；按接入总表及 Java 示例使用 HMAC-SHA256，不因失败切换旧 hmac 重传。
+     * @param accessKey 当前 vivo 账号接入标识。
+     * @param method 当前普通包或分包的官方方法名称。
+     */
+    private commonParams;
+    /**
+     * 检查网关及业务返回码；可选 subCode 缺省视为无子错误，非零或畸形码均拒绝。
+     * @param data 平台原始响应，仅错误摘要会经过脱敏后输出。
+     * @param operation 当前失败阶段的可读名称。
+     */
+    private assertSuccess;
+    /**
+     * 使用对应 APK 方法上传并返回文件流水号，成功响应缺少流水号也必须中止。
+     * @param accessKey 当前 vivo 账号接入标识。
+     * @param accessSecret 本次请求签名密钥。
+     * @param filePath 待上传的 APK 普通文件路径。
+     * @param packageName 已核对的目标包名。
+     * @param fileMd5 本地 APK 的小写 MD5。
+     * @param kind 单包、32 位分包或 64 位分包，决定上传方法。
+     */
     private uploadApk;
+    /**
+     * 同步更新应用；普通包发送 apk、版本号与 MD5，分包发送 apk32/apk64。
+     * @param accessKey 当前 vivo 账号接入标识。
+     * @param accessSecret 本次请求签名密钥。
+     * @param data 已组装的包名、上线方式、设备及本次上传流水号。
+     * @param split 是否使用官方分包更新方法。
+     */
     private submitVersion;
 }
 
@@ -1144,6 +1834,12 @@ declare class TencentUploader implements IUploader {
     private generateSign;
     validateConfig(config: any): boolean;
     canHandle(filePath: string): boolean;
+    /**
+     * 上传本次产物并保留线上应用资料，包开关和流水号由本次选择重建。
+     * @param filePath 单包默认路径，元数据有产物字典时优先使用字典。
+     * @param config 已确认的应用宝配置和账号材料。
+     * @param metadata 本次版本、更新日志与可选架构映射。
+     */
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
     /**
      * 阶段 1: 获取文件上传信息
@@ -1158,7 +1854,11 @@ declare class TencentUploader implements IUploader {
      */
     private uploadToCos;
     /**
-     * 阶段 3: 提交流水号信息
+     * 保留应用资料并以本次上传结果重建包字段，防止线上旧架构继续参与送审。
+     * @param auth 已确认的 userId、appId 和签名密钥。
+     * @param data 线上应用资料与本次更新说明，所有 apk32/apk64 字段均忽略。
+     * @param packages 本次已上传的安装包；不能混入线上流水号。
+     * @param options 可选请求配置；timeout 为毫秒，缺省使用 Axios 默认超时。
      */
     private submitModifyAppInfo;
 }
@@ -1166,9 +1866,15 @@ declare class TencentUploader implements IUploader {
 interface GooglePlayHttpResponse<T = any> {
     data: T;
 }
+/** Google 官方 API 的最小 HTTP 边界，允许隔离验证远端副作用。 */
 interface GooglePlayHttpClient {
+    /** 只读查询轨道或包列表；配置只携带当前认证头。 */
+    get<T = any>(url: string, config?: any): Promise<GooglePlayHttpResponse<T>>;
+    /** 创建事务、上传包或提交已校验事务。 */
     post<T = any>(url: string, data?: any, config?: any): Promise<GooglePlayHttpResponse<T>>;
+    /** 保存完整轨道草稿配置，调用方保留旧发行条目。 */
     put<T = any>(url: string, data?: any, config?: any): Promise<GooglePlayHttpResponse<T>>;
+    /** 清理本次创建且尚未提交的事务。 */
     delete<T = any>(url: string, config?: any): Promise<GooglePlayHttpResponse<T>>;
 }
 interface GooglePlayAuthConfig {
@@ -1182,20 +1888,50 @@ interface GooglePlayUploaderDependencies {
 /**
  * Google Play 上传器。
  *
- * 首版能力刻意限制为：上传一个 AAB 到内部测试轨道并保留为 draft。
- * 配置层与 Google Play API 都使用 internal 作为内部测试轨道标识。
+ * 支持 internal 或 production 草稿，保留所选轨道已有的有效发行条目。
+ * production 草稿不等于提交审核或正式发布。
  * 创建应用、填写商店资料、提交审核和生产发布均不在此适配器范围内。
  */
 declare class GooglePlayUploader implements IUploader {
     name: string;
     private readonly httpClient;
     private readonly getAccessToken;
+    /**
+     * 注入正式 HTTP 或隔离测试边界，不在构造时读取凭据或访问远端。
+     * @param dependencies 可选 HTTP 与取令牌函数；省略时使用 Axios 和本机 GoogleAuth。
+     */
     constructor(dependencies?: GooglePlayUploaderDependencies);
+    /**
+     * 校验明确轨道和服务账号来源，不触发远端动作。
+     * @param config 当前发布配置；仅接受 internal 或 production 草稿。
+     */
     validateConfig(config: any): boolean;
+    /**
+     * 根据后缀选择 AAB 上传器；实际身份由执行边界另行核对。
+     * @param filePath 待上传的本地文件路径，不接受 APK。
+     */
     canHandle(filePath: string): boolean;
-    upload(filePath: string, config: any, _metadata: AppMetadata): Promise<UploadResult>;
+    /**
+     * 核对远端构建号，并在 production 事务预校验通过后发送 AAB；保留原发行及上传后的校验与回读。
+     * @param filePath 已确认身份和摘要的 AAB 路径。
+     * @param config 明确轨道、内存认证材料与可选 BCP-47 发行说明。
+     * @param metadata 当前计划绑定的应用版本和内部构建号。
+     * @returns 草稿受理和回读结果；失败保留是否已提交的事实，禁止自动重传。
+     */
+    upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
+    /**
+     * 核对回读保留旧版本及当前草稿正文，不接受静默丢失旧包或语言。
+     * @param actual 当前 GET 返回的轨道对象。
+     * @param expected 本次 PUT 的完整发行条目，包含原有条目和新草稿。
+     */
+    private assertDraftMatches;
     private createAccessToken;
     private deleteEditBestEffort;
+    /** 将HTTP或平台业务错误转为有阶段和轨道的脱敏说明，不把所有403归因于同一种权限。
+     * @param error - 当前请求捕获的供应商异常；原请求头和凭据不能进入结果。
+     * @param stage - 失败时的实际上传阶段，用于区分包接收、轨道更新及提交。
+     * @param track - 当前明确选择的internal或production草稿轨道。
+     */
     private describeError;
     private redactAndTruncate;
     private failure;
@@ -1268,90 +2004,6 @@ declare const DEFAULT_RETRY_CONFIG: RetryConfig;
  */
 declare function createUploadRetryStrategy(config?: RetryConfig): RetryStrategy;
 
-/**
- * 上传管理器配置
- */
-interface UploadManagerConfig {
-    maxConcurrent?: number;
-    continueOnError?: boolean;
-    verbose?: boolean;
-    cancellationToken?: {
-        isCancelled: boolean;
-    };
-}
-/**
- * 聚合的上传结果报告
- */
-interface UploadReport {
-    totalUploads: number;
-    successCount: number;
-    failureCount: number;
-    successPlatforms: string[];
-    failurePlatforms: string[];
-    results: UploadResult[];
-    totalDurationMs: number;
-    summary: string;
-}
-/**
- * 上传管理器 - 处理多平台并行上传
- */
-declare class UploadManager {
-    private uploaders;
-    private config;
-    constructor(config?: UploadManagerConfig);
-    /**
-     * 注册上传器
-     */
-    registerUploader(platform: string, uploader: IUploader): void;
-    /**
-     * 获取启用的平台列表（根据配置）
-     */
-    getEnabledPlatforms(config: any): string[];
-    /**
-     * 获取可用的平台列表
-     */
-    getAvailablePlatforms(): string[];
-    /**
-     * 执行并行上传（支持多文件智能分发）
-     */
-    uploadToMultiplePlatforms(filePaths: string | string[], // 支持单文件或文件数组
-    config: any, metadata: AppMetadata, targetPlatforms?: string[]): Promise<UploadReport>;
-    /**
-     * 上传到单个平台
-     */
-    private uploadToPlatform;
-    private shouldGroupArtifacts;
-    private resolveArtifactSelection;
-    private buildArtifactMapFromFiles;
-    private inferArtifactKey;
-    private getRepresentativeFilePath;
-    private validateArtifactSelection;
-    /**
-     * 聚合上传结果
-     */
-    private aggregateResults;
-    /**
-     * 输出上传报告
-     */
-    private printReport;
-    /**
-     * 格式化持续时间
-     */
-    private formatDuration;
-    /**
-     * 获取可重试的失败平台
-     */
-    getRetryablePlatforms(report: UploadReport): string[];
-    /**
-     * 重试失败的平台
-     */
-    retryFailedPlatforms(failedPlatforms: string[], filePath: string | string[], config: any, metadata: AppMetadata): Promise<UploadReport>;
-}
-/**
- * 创建上传管理器实例
- */
-declare function createUploadManager(config?: UploadManagerConfig): UploadManager;
-
 /**
  * Apple App Store Connect API JWT 生成器
  *
@@ -1431,97 +2083,223 @@ interface ParseOptions {
 /**
  * 从安装包文件中解析版本信息
  *
- * 支持三种格式：
- * - APK: 使用 aapt2/aapt（Android SDK 自带）
+ * 支持常见发布格式：
+ * - APK/AAB: 使用 aapt2/aapt（Android SDK 自带）
  * - IPA: 使用 unzip + plutil（macOS 原生）
- * - HAP: 使用 unzip（系统自带）
+ * - HAP/APP: 使用 unzip（系统自带）
  *
  * 解析失败时返回 null，不会抛出异常
  */
 declare function parsePackageInfo(filePath: string, options?: ParseOptions): Promise<PackageInfo | null>;
 
-declare const RELEASE_RECEIPT_SCHEMA_VERSION: 1;
-declare const DEFAULT_RELEASE_RECEIPT_LIMIT = 100;
-type ReleaseReceiptKind = 'build' | 'upload';
-type ReleaseReceiptOutcome = 'success' | 'partial' | 'failed' | 'cancelled';
-type ReleaseReceiptState = 'built' | 'uploaded' | 'draft_created' | 'review_submitted' | 'reviewing' | 'approved' | 'rejected' | 'released' | 'failed' | 'cancelled';
-interface ReleaseArtifactReceipt {
-    path: string;
-    name: string;
-    sizeBytes?: number;
-    sha256?: string;
-    available: boolean;
+/** 可信发布入口使用的格式限制，与 MCP 预览保持一致。 */
+declare function expectedFormatsForPlatform(platform: ReleasePlatform): string[];
+/** 上传前需要核对的产物平台。 */
+type ArtifactIdentityPlatform = 'android' | 'harmony' | 'ios';
+interface ArtifactIdentity {
+    platform: ArtifactIdentityPlatform;
+    artifactPath: string;
+    packageName: string;
+    source: 'apk' | 'aab' | 'hap' | 'app' | 'ipa';
+    packageInfo: PackageInfo;
 }
-interface ReleaseRemoteReceipt {
-    consoleUrl?: string;
-    downloadUrl?: string;
-    identifiers?: Record<string, string | number | boolean>;
+/**
+ * 根据上传平台返回产物身份平台。
+ * 蒲公英等分发平台没有自己的包格式约束，因此按实际后缀判断。
+ */
+declare function inferArtifactIdentityPlatform(uploadPlatform: string, artifactPath: string): ArtifactIdentityPlatform | null;
+/**
+ * 读取安装包内的真实应用身份。
+ * 解析失败必须抛错，由调用方在适配器发起任何网络请求前阻断上传。
+ */
+declare function inspectArtifactIdentity(artifactPath: string, platform: ArtifactIdentityPlatform, metadata?: Partial<AppMetadata>): Promise<ArtifactIdentity>;
+/**
+ * 解析单个平台配置中的包名。平台字段优先；只有历史上把顶层 appId
+ * 当作包名的分发平台才允许回退。Huawei/Harmony 的 appId 是商店应用 ID，
+ * 不能拿来和安装包内 bundle/package name 比较。
+ */
+declare function resolveExpectedArtifactPackageName(config: any, uploadPlatform: string): string | undefined;
+/**
+ * 对一个上传任务的所有候选产物执行身份核对。
+ * 没有配置平台包名时不自行推断，保留既有“由适配器或平台侧决定”的兼容行为。
+ */
+declare function assertArtifactIdentityMatches(uploadPlatform: string, artifactPaths: string[], config: any, metadata?: Partial<AppMetadata>): Promise<ArtifactIdentity[]>;
+
+/** 将可能含凭据的任意文本转换为可安全输出的短文本。 */
+declare function redactSecretText(value: unknown, maxLength?: number): string;
+/** 只保留安全消息与非敏感诊断字段，禁止把原始 HTTP 请求对象继续向上传递。 */
+declare function createRedactedError(error: unknown, fallback?: string): Error;
+
+declare const ADDITIONAL_STORES: readonly ["honor", "meizu", "samsung"];
+type AdditionalStore = (typeof ADDITIONAL_STORES)[number];
+type StoreFailureCode = 'invalid_credentials' | 'rejected' | 'application_not_found' | 'ambiguous_application' | 'application_mismatch' | 'invalid_response' | 'network_unavailable' | 'cancelled' | 'application_not_ready' | 'lookup_limit_exceeded';
+declare class StorePublishingError extends Error {
+    readonly code: StoreFailureCode;
+    constructor(code: StoreFailureCode);
 }
-interface ReleaseTargetReceipt {
-    platform: string;
-    state: ReleaseReceiptState;
-    outcome: ReleaseReceiptOutcome;
-    message: string;
-    remote?: ReleaseRemoteReceipt;
-    lastKnownRemoteStatus?: string;
-    checkedAt?: string;
+declare const storeRecord: (value: unknown) => Record<string, any>;
+declare function storeIdentifier(value: unknown): string;
+declare function credentialField(value: unknown): string;
+/** 三星私钥只在本机签名；只申请 publishing 范围，不请求统计或其他服务。 */
+declare function createSamsungJwt(accountId: string, privateKey: string, now?: number): string;
+/** 魅族签名按字段名排序并追加客户端密钥；不把秘密放到 URL 查询串。 */
+declare function createMeizuHeaders(clientId: string, clientSecret: string, uri: string, accessToken: string, timestamp?: string, traceId?: `${string}-${string}-${string}-${string}-${string}`): Record<string, string>;
+interface StoreApplication {
+    appId: string;
+    packageName: string;
+    /** 仅供本机上传适配器，严禁把应用详情直接投影到日志或模型。 */
+    detail?: Record<string, any>;
 }
-interface ReleaseReceipt {
-    schemaVersion: typeof RELEASE_RECEIPT_SCHEMA_VERSION;
-    id: string;
-    projectKey: string;
-    projectRoot: string;
-    kind: ReleaseReceiptKind;
-    appName?: string;
-    packageName?: string;
-    versionName?: string;
-    buildNumber?: string;
-    changelog?: string;
-    artifacts: ReleaseArtifactReceipt[];
-    targets: ReleaseTargetReceipt[];
-    outcome: ReleaseReceiptOutcome;
-    startedAt: string;
-    finishedAt: string;
-    durationMs: number;
+/** 固定域名上的有界 JSON 传输；上传文件由适配器的流式 multipart 边界负责。 */
+declare class StorePublishingClient {
+    readonly platform: AdditionalStore;
+    private readonly material;
+    private readonly transport;
+    private readonly signal?;
+    private token;
+    private authenticated;
+    constructor(platform: AdditionalStore, material: CredentialMaterial, transport?: typeof fetch, signal?: AbortSignal | undefined);
+    get authenticationVerified(): boolean;
+    headers(uri: string): Record<string, string>;
+    url(uri: string, query?: Record<string, string>): url.URL;
+    private request;
+    authenticate(): Promise<void>;
+    /** 通用请求仅接受本适配器固定域名上的相对路径。 */
+    json(uri: string, query?: Record<string, string>, body?: unknown): Promise<any>;
+    /** 精确包名匹配；列表不完整、多候选或既有应用 ID 冲突时均停止。 */
+    application(packageName: string, expectedAppId?: string): Promise<StoreApplication>;
 }
-interface ReleaseReceiptInput {
+
+/** 只摘要实际会改变上传目标/设备配置的公开字段，秘密及秘密摘要不进入计划。 */
+declare function storeTargetFingerprint(target: any): string;
+/** 计划使用 APK 内的包名和版本；同一计划只绑定一个具体 APK。 */
+declare function prepareStoreRelease(config: UploadConfig, platform: AdditionalStore, file: string, metadata?: Partial<AppMetadata>): Promise<ReleasePlan>;
+
+/** 私钥路径只在本机解析，限制普通文件和大小，不把原文拼进错误。 */
+declare function storeCredentialMaterial(auth: any): Promise<CredentialMaterial>;
+type StoreFileTransport = (url: string, form: FormData, options: {
+    headers: Record<string, string>;
+    onUploadProgress?: (event: {
+        loaded: number;
+        total?: number;
+    }) => void;
+}) => Promise<unknown>;
+declare class StoreUploader implements IUploader {
+    readonly platform: AdditionalStore;
+    private readonly transport;
+    private readonly fileTransport;
+    readonly name: string;
+    constructor(platform: AdditionalStore, transport?: typeof fetch, fileTransport?: StoreFileTransport);
+    canHandle(file: string): boolean;
+    validateConfig(config: any): boolean;
+    upload(filePath: string, config: any, _metadata: AppMetadata, onProgress?: ReleaseProgressObserver): Promise<UploadResult>;
+}
+
+/** 本次已支持原生确认的商店渠道，普通草稿渠道与既有新增商店共享可信执行器。 */
+type ConfirmedStorePlatform = AdditionalStore | 'huawei' | 'harmony' | 'google_play';
+/** 宿主未获得明确人工批准时的终止信号；不代表商店上传失败。 */
+declare class ReleaseConfirmationDeclinedError extends Error {
+    /** 创建未批准结果；此时尚未解析凭据或发送安装包。 */
+    constructor();
+}
+/** 将真实产物计划交给本机宿主确认，再执行并保存脱敏回执；取消不解析 Profile。
+ * @param input - 当前渠道配置、真实产物、可信人工确认回调及可选隔离测试依赖。
+ */
+declare function executeConfirmedStoreRelease(input: {
+    /** 本次渠道的独立配置快照，保留根本地化日志。 */
+    config: UploadConfig;
+    /** 本次明确选择的受支持商店。 */
+    platform: ConfirmedStorePlatform;
+    /** 当前一个具体安装包，不接受表单伪造的身份。 */
+    file: string;
+    /** 原项目绝对目录，用于回执和相对私密文件路径。 */
     projectRoot: string;
-    kind: ReleaseReceiptKind;
-    appName?: string;
-    packageName?: string;
-    versionName?: string;
-    buildNumber?: string | number;
-    changelog?: string;
-    artifactPaths?: unknown;
-    targets: ReleaseTargetReceipt[];
-    startedAt?: string | number | Date;
-    finishedAt?: string | number | Date;
-    outcome?: ReleaseReceiptOutcome;
+    /** 原配置路径；省略时没有磁盘配置可复验。 */
+    configPath?: string;
+    /** 可选日志和工具参数，实际版本仍以安装包为准。 */
+    metadata?: Partial<AppMetadata>;
+    /** 可选取消信号，在远端发送前生效。 */
+    signal?: AbortSignal;
+    /** 真实宿主向人展示绑定计划并返回明确选择，默认值不视为批准。 */
+    approve: (plan: ReleasePlan) => Promise<boolean>;
+    /** 可选可信依赖替身，只供受控本机或隔离测试。 */
+    dependencies?: ReleaseExecutorDependencies;
+}): Promise<ReleaseExecutionResult>;
+
+/**
+ * 按用户动作配置或核验项目凭据，不依赖上传开关；完成核验后才写入公开引用。
+ * @param input - 当前项目的凭据动作、配置路径或已有采集任务；不改变渠道启用状态。
+ * @param signal - 可选取消信号，向只读核验传递。
+ * @param assertCurrent - 可选宿主归属检查，在完成配置写入前调用。
+ */
+declare function runCredentialCommand(input: {
+    /** 本次明确发起的采集、查询、完成、取消或只读体检动作。 */
+    action: 'setup' | 'status' | 'complete' | 'cancel' | 'preflight';
+    /** 开始采集或体检必填的已保存项目配置路径，其余动作省略。 */
+    configPath?: string;
+    /** 开始采集或体检必填的商店渠道标识，其余动作省略。 */
+    platform?: string;
+    /** 查询、完成或取消时必填的本机采集任务标识。 */
+    setupId?: string;
+    /** 仅开始采集时有效，true 创建新档案，省略或 false 复用已有档案。 */
+    refreshExisting?: boolean;
+}, signal?: AbortSignal, assertCurrent?: () => void): Promise<PublishPreflight | CredentialSetupStatus>;
+
+/** 同一次发行按语言共用的说明正文；语言必须显式匹配商店的语言标识。 */
+type LocalizedReleaseNotes = Record<string, string>;
+/**
+ * 校验可选本地化说明；省略时保持旧调用不设置本地化正文的语义。
+ * @param value - 配置中的语言到正文映射；空映射、空正文与下划线语言标识均拒绝。
+ * @returns 独立的已校验映射；未配置时返回 undefined。
+ */
+declare function readLocalizedReleaseNotes(value: unknown): LocalizedReleaseNotes | undefined;
+
+/** 两个华为发布 API 共用的请求身份，仅在可信本机执行期间持有。 */
+interface HuaweiReleaseNotesContext {
+    /** 当前平台已选定的官方发布 API 根路径，Android 使用 v2，鸿蒙使用 v3。 */
+    apiRoot: string;
+    /** 已按包名核对的商店应用 ID。 */
+    appId: string;
+    /** 已鉴权的请求头；不得记录或持久化其中的令牌。 */
+    headers: Record<string, string>;
 }
-interface ReleaseReceiptStoreOptions {
-    storageRoot?: string;
-    maxEntries?: number;
+/** 回读确认后的版本说明，未配置的商店语言不会被创建。 */
+interface HuaweiReleaseNotesResult {
+    /** 远端已存在且本次正文回读一致的语言及正文。 */
+    verified: LocalizedReleaseNotes;
+    /** 输入提供但远端尚未配置的语言，不自动新增名称和描述。 */
+    unavailableLocales: string[];
 }
-/** 解析发布回执所属项目；显式项目目录优先，未提供时才使用配置文件目录。 */
-declare function resolveReleaseProjectRoot(projectRoot: string | undefined, configPath: string): string;
-/** 将可能包含凭据的错误信息压缩为可安全持久化的短文本。 */
-declare function sanitizeReleaseMessage(value: unknown, maxLength?: number): string;
-/** 将上传结果转换为稳定、可公开展示的渠道状态。 */
-declare function createUploadTargets(results: UploadResult[]): ReleaseTargetReceipt[];
-/** 创建回执；只接受已经挑选过的业务字段，不接受完整配置或原始响应。 */
-declare function createReleaseReceipt(input: ReleaseReceiptInput): Promise<ReleaseReceipt>;
-/** 将回执转换为适合复制给客户或 AI 的纯文本摘要。 */
-declare function formatReleaseReceipt(receipt: ReleaseReceipt): string;
-declare class ReleaseReceiptStore {
-    private readonly storageRoot;
-    private readonly maxEntries;
-    constructor(options?: ReleaseReceiptStoreOptions);
-    append(receipt: ReleaseReceipt): Promise<void>;
-    list(projectRoot: string, limit?: number): Promise<ReleaseReceipt[]>;
-    save(input: ReleaseReceiptInput): Promise<ReleaseReceipt>;
-    private getFilePath;
-    private readFile;
+/**
+ * 仅更新远端已有语言的 newFeatures，并逐项回读正文和原有素材字段。
+ * @param context - 当前平台的已鉴权官方 API 身份，函数不会修改该身份。
+ * @param configuredNotes - 按 BCP-47 显式配置的正文，省略时才使用旧单语言说明。
+ * @param legacyChangelog - 旧入口的单语言正文，仅写入远端默认语言；空值不发请求。
+ * @returns 已回读的语言正文及未配置语言；更新或回读失败直接抛错，不报告成功。
+ */
+declare function updateHuaweiReleaseNotes(context: HuaweiReleaseNotesContext, configuredNotes: unknown, legacyChangelog: string): Promise<HuaweiReleaseNotesResult>;
+
+/** 本次真实安装包的只读身份，版本与摘要均来自文件本身。 */
+interface InspectedArtifact {
+    /** 已解析的绝对普通文件路径。 */ path: string;
+    /** 安装包实际格式，不从表单覆盖。 */ format: string;
+    /** 包内实际应用标识。 */ packageName: string;
+    /** 包内非空用户版本。 */ versionName: string;
+    /** 包内非空构建号字符串。 */ buildNumber: string;
+    /** 读取完成时实际字节数。 */ sizeBytes: number;
+    /** 同一次文件读取的 SHA-256。 */ sha256: string;
 }
-declare function createProjectKey(projectRoot: string): string;
+/** 从普通安装包读取身份并校验读取期间未变化，不接受外部版本覆盖。
+ * @param artifactPath - 用户选定的本地安装包路径，解析为绝对路径后读取。
+ * @returns 包内身份、大小与同一次读取摘要。
+ */
+declare function inspectReleaseArtifact(artifactPath: string): Promise<InspectedArtifact>;
+/** 为现有产物生成与实际文件绑定的测试分发或商店计划，不读取账号。
+ * @param artifactPath - 需要检查的当前产物路径，不能用旧包代替。
+ * @param platform - 已明确选择的目标渠道。
+ * @param credentialProfile - 本次执行引用的本机 Profile 名称，不包含秘密。
+ * @param distributionAccess - 蒲公英安装权限；其他渠道或未指定时省略。
+ */
+declare function previewArtifactRelease(artifactPath: string, platform: ReleasePlatform, credentialProfile: string, distributionAccess?: 'public' | 'password' | 'invite'): Promise<ReleasePlan>;
 
-export { AdHocUploader, type AppMetadata, AppleJWTGenerator, AppleStoreUploader, type BuildResult, ConfigValidator, DEFAULT_RELEASE_RECEIPT_LIMIT, DEFAULT_RETRY_CONFIG, EnvValidator, ErrorCategory, GooglePlayUploader, type GooglePlayUploaderDependencies, HarmonyUploader, HuaweiUploader, type IUploader, OppoUploader, type PackageInfo, type ParseOptions, PgyerUploader, RELEASE_RECEIPT_SCHEMA_VERSION, type ReleaseArtifactReceipt, type ReleaseReceipt, type ReleaseReceiptInput, type ReleaseReceiptKind, type ReleaseReceiptOutcome, type ReleaseReceiptState, ReleaseReceiptStore, type ReleaseReceiptStoreOptions, type ReleaseRemoteReceipt, type ReleaseTargetReceipt, type RetryConfig, type RetryResult, RetryStrategy, TencentUploader, TestFlightUploader, type UploadConfig, UploadManager, type UploadManagerConfig, type UploadReport, type UploadResult, VivoUploader, XiaomiUploader, createProjectKey, createReleaseReceipt, createUploadManager, createUploadRetryStrategy, createUploadTargets, formatReleaseReceipt, parsePackageInfo, resolveReleaseProjectRoot, sanitizeReleaseMessage };
+export { ADDITIONAL_STORES, type AdditionalStore, type AndroidStoreConfig, type AppMetadata, AppleJWTGenerator, AppleStoreUploader, type ArtifactIdentity, type ArtifactIdentityPlatform, type BuildResult, CREDENTIAL_CONSOLES, ConfigValidator, type ConfirmedStorePlatform, type CredentialMaterial, type CredentialMigrationOptions, type CredentialMigrationResult, type CredentialProfileCatalog, type CredentialProfileMetadata, type CredentialProfileStore, type CredentialProfileWriteInput, type CredentialResolveRequest, type CredentialResolver, CredentialSetupService, type CredentialSetupStatus, type CredentialStorageKind, DEFAULT_CREDENTIAL_VAULT_PATH, DEFAULT_RELEASE_RECEIPT_LIMIT, DEFAULT_RETRY_CONFIG, EnvValidator, ErrorCategory, GooglePlayUploader, type GooglePlayUploaderDependencies, HarmonyUploader, type HuaweiReleaseNotesContext, type HuaweiReleaseNotesResult, HuaweiUploader, type IUploader, type InspectedArtifact, LocalCredentialProfileStore, type LocalizedReleaseNotes, MacOSKeychainSecretStore, OppoUploader, PREFLIGHT_CODES, PREFLIGHT_PLATFORMS, type PackageInfo, type ParseOptions, type PgyerCredentialVerification, PgyerUploader, type PreflightCode, type PreflightPlatform, type PublishPreflight, RELEASE_PLATFORM_CAPABILITIES, RELEASE_RECEIPT_SCHEMA_VERSION, type ReleaseAction, type ReleaseAfterApproval, type ReleaseArtifactBinding, type ReleaseArtifactReceipt, type ReleaseBatchExecutionResult, type ReleaseCancelUntil, type ReleaseChannelKind, type ReleaseConfirmation, ReleaseConfirmationDeclinedError, type ReleaseExecutionInput, type ReleaseExecutionResult, type ReleaseExecutorDependencies, type ReleasePlan, type ReleasePlanInput, type ReleasePlatform, type ReleasePlatformCapability, type ReleaseProgress, type ReleaseProgressObserver, type ReleaseReceipt, type ReleaseReceiptInput, type ReleaseReceiptKind, type ReleaseReceiptOutcome, type ReleaseReceiptState, ReleaseReceiptStore, type ReleaseReceiptStoreOptions, type ReleaseRemoteReceipt, type ReleaseResultingState, type ReleaseRiskLevel, type ReleaseTargetReceipt, type ReleaseWithdrawal, type RetryConfig, type RetryResult, RetryStrategy, type SecretStore, type SecurityCommandResult, type SecurityCommandRunner, type StoreApplication, type StoreFailureCode, type StoreFileTransport, StorePublishingClient, StorePublishingError, StoreUploader, TencentUploader, type UploadConfig, UploadManager, type UploadManagerConfig, type UploadReport, type UploadResult, VivoUploader, XiaomiUploader, assertArtifactIdentityMatches, assertCredentialProfileName, assertPublishPackageName, assertReleaseArtifactMatchesPlan, assertReleaseConfirmation, assertSafeCredentialMetadata, createDefaultCredentialProfileStore, createHuaweiServiceAccountToken, createMeizuHeaders, createProjectKey, createRedactedError, createReleasePlan, createReleaseReceipt, createSamsungJwt, createUploadManager, createUploadRetryStrategy, createUploadTargets, credentialField, credentialPagePlatform, executeConfirmedStoreRelease, executeReleasePlan, executeReleasePlans, expectedFormatsForPlatform, formatReleasePlan, formatReleaseReceipt, hydrateCredentialProfiles, inferArtifactIdentityPlatform, inspectArtifactIdentity, inspectReleaseArtifact, isSubmissionAction, migrateLegacyCredentials, parseHuaweiServiceAccount, parsePackageInfo, preflightPublish, prepareStoreRelease, previewArtifactRelease, readLocalizedReleaseNotes, redactSecretText, resolveExpectedArtifactPackageName, resolveInlineCredentialMaterial, resolveReleaseProjectRoot, rollbackCredentialProfiles, runCredentialCommand, sanitizeReleaseMessage, storeCredentialMaterial, storeIdentifier, storeRecord, storeTargetFingerprint, updateHuaweiReleaseNotes, verifyPgyerCredentialProfile };