@applift/core 0.0.0-stage → 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,382 @@
+import { A as StoresSchema, B as BundleIds, C as GlobalConfig, D as StoreConfig, E as ProjectConfigSchema, F as ChannelRegistry, G as electronAdapter, H as Platform, I as ReleasePlanEntry, J as nativeAndroidAdapter, K as findArtifacts, L as ReviewStatus, M as ChannelCapabilities, N as ChannelContext, O as StoreConfigSchema, P as ChannelEvent, Q as tauriAdapter, R as StageResult, S as CredentialsProfileSchema, T as ProjectConfig, U as detectBundleIds, V as FrameworkAdapter, W as detectFramework, X as nativeIosAdapter, Y as nativeHarmonyAdapter, Z as rnAdapter, _ as appendEntry, a as QypubUserConfig, b as CredentialsFileSchema, c as PipelineInput, d as runStage, f as runSubmit, g as HistoryQuery, h as HistoryEvent, i as QypubPlugin, j as Channel, k as Stores, l as PipelineSummary, m as HistoryEntry, n as PluginHookName, o as defineConfig, p as HISTORY_PATH, q as flutterAdapter, r as PluginHost, s as resolvePlugins, t as HookContext, u as PipelineSummaryEntry, v as readEntries, w as GlobalConfigSchema, x as CredentialsProfile, y as CredentialsFile, z as SubmitResult } from "./plugin-T6zXsmt1.mjs";
+//#region src/registry.d.ts
+export declare class DefaultChannelRegistry implements ChannelRegistry {
+  private readonly channels;
+  register(channel: Channel): void;
+  get(id: string): Channel | undefined;
+  all(): Channel[];
+}
+/** 全局默认注册表（CLI/测试均可注入独立实例） */
+export declare const registry: DefaultChannelRegistry;
+//#endregion
+//#region src/config/loader.d.ts
+export declare const APPLIFT_HOME: string;
+export declare const CREDENTIALS_PATH: string;
+export declare const GLOBAL_CONFIG_PATH: string;
+/** 项目级凭据目录（<project>/.applift/credentials.toml；gitignore 由用户决定：私有仓可提交，公开仓 ignore） */
+export declare function projectCredentialsPath(projectRoot: string): string;
+/** 从 startDir 逐层向上找第一个存在的路径（monorepo 子包向上借用根配置/凭据）；找不到返回 null */
+export declare function findUp(startDir: string, relative: string): string | null;
+/**
+ * 逐级凭据加载：项目 <root>/.applift/credentials.toml（就近，逐键优先）→ 全局 ~/.applift/（逐键回退）。
+ * 场景：私有仓提交凭据进仓库；或公开仓 .applift/ 进 gitignore 由成员各自维护。
+ * profile 合并：项目同名 profile 逐键覆盖全局；仅全局有则用全局。
+ */
+export declare function loadCredentialsLayered(projectRoot?: string, globalPath?: string): CredentialsFile;
+/** 读取并校验 credentials.toml；不存在返回空 profiles；强制 0600 */
+export declare function loadCredentials(filePath?: string): CredentialsFile;
+/** 按项目 profile 取凭据；profile 不存在时报错并列出可用 profiles。
+ * 环境变量覆盖（CI 场景）：APPLIFT_<KEY> 前缀优先（如 APPLIFT_PGYER_API_KEY）；
+ * knownKeys 提供时其裸键名（如 PGYER_API_KEY）也认（向后兼容），未提供的裸大写键不捡（避免误吸无关变量）。
+ */
+export declare function resolveProfile(creds: CredentialsFile, profile: string, knownKeys?: string[]): Record<string, string>;
+/** 全局配置装载（缺失/损坏降级默认值并警告，不阻断） */
+export declare function loadGlobalConfig(filePath?: string): GlobalConfig;
+/** 写凭据（目录自动创建，文件强制 0600） */
+export declare function saveCredentials(data: CredentialsFile, filePath?: string): void;
+//#endregion
+//#region src/config/project.d.ts
+export interface LoadedProjectConfig {
+  config: ProjectConfig;
+  /**
+   * c12 原始配置（保留 plugins 等 schema 外键）——插件发现（resolvePlugins）用；
+   * 业务字段一律以 config（zod 解析后）为准。
+   */
+  raw: QypubUserConfig;
+  /** 配置文件所在目录（解析相对路径用），无配置文件时为 cwd */
+  cwd: string;
+}
+export declare function loadProjectConfig(cwd: string): Promise<LoadedProjectConfig>;
+//#endregion
+//#region src/config/profile-map.d.ts
+export declare const PROJECTS_MAP_PATH: string;
+/** 读取映射；不存在/损坏 JSON/顶层非对象/值非字符串 → {}（个人偏好缺失或损坏不阻断发版） */
+export declare function loadProjectProfileMap(filePath?: string): Record<string, string>;
+/** 覆盖写整个映射（目录自动创建；非凭据，无敏感值，默认权限即可） */
+export declare function saveProjectProfileMap(map: Record<string, string>, filePath?: string): void;
+/** 记录某项目使用的 profile（键统一绝对路径；合并保留其他项目的条目） */
+export declare function setProjectProfile(cwd: string, profile: string, filePath?: string): void;
+/**
+ * 解析项目生效 profile：projects.json 个人选择 > 项目配置 profile（团队默认）> 'default' 全局默认。
+ * CLI 的 --profile 旗标在调用方以 `opts.profile ?? resolveProfileFor(...)` 再盖一层（最高优先级）。
+ */
+export declare function resolveProfileFor(cwd: string, projectCfgProfile?: string, filePath?: string): string;
+//#endregion
+//#region src/channels/shared/sign.d.ts
+export declare function sortedQueryString(params: Record<string, string | number | undefined | null>): string;
+export declare function hmacSign(secret: string, params: Record<string, string | number | undefined | null>): string;
+export declare function tsSeconds(): string;
+export declare function tsMillis(): string;
+export declare function md5String(s: string): string;
+/** 分块计算文件 MD5（apk 较大，8MB 分块避免整读） */
+export declare function md5File(filePath: string): string;
+/** POST application/x-www-form-urlencoded */
+export declare function formPost<T = unknown>(url: string, params: Record<string, string>, { timeout }?: {
+  timeout?: number;
+}): Promise<T>;
+//#endregion
+//#region src/channels/pgyer.d.ts
+export declare class PgyerChannel implements Channel {
+  readonly id = "pgyer";
+  readonly label = "蒲公英";
+  readonly capabilities: ChannelCapabilities;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  submit(): Promise<SubmitResult>;
+  status(): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/listing.d.ts
+/** listing 输入（基础值 + 按渠道覆盖） */
+export interface ListingInput {
+  /** 应用简介（一句话，商店列表页展示） */
+  brief?: string;
+  /** 应用描述（长文案，详情页） */
+  description?: string;
+  /** 图标文件绝对/相对路径 */
+  iconPath?: string;
+  /** 截图文件路径列表 */
+  screenshots?: string[];
+  /** 渠道级覆盖：键=渠道 id，值为该渠道生效的字段覆盖 */
+  stores?: Record<string, Partial<Omit<ListingInput, "stores">>>;
+}
+/** listing 更新结果（单渠道） */
+export interface ListingResult {
+  ok: boolean;
+  store: string;
+  /** 已写入渠道的字段名 */
+  updated: string[];
+  /** 输入存在但渠道跳过（不支持/未验证）的字段名 */
+  skipped: string[];
+  error?: string;
+}
+/** 渠道可选能力：更新商店应用信息（listing） */
+export interface ListingCapableChannel {
+  /** 更新商店 listing；实现方自报 updated/skipped 字段 */
+  updateListing(ctx: Pick<ChannelContext, "credentials" | "target" | "emit">, listing: ListingInput): Promise<ListingResult>;
+}
+/** 合并基础值与渠道覆盖（覆盖优先，仅取显式传入的键） */
+export declare function resolveListing(listing: ListingInput, store: string): ListingInput;
+/**
+ * 装载 listing 配置文件（TS：`export default { brief, description, stores: {...} }`）。
+ * 相对路径基于文件所在目录解析为绝对路径（iconPath/screenshots）。
+ */
+export declare function loadListingFile(filePath: string): Promise<ListingInput>;
+/** 校验 listing 引用的本地文件存在（icon/截图）；dry-run 也校验，避免发到一半才失败 */
+export declare function assertListingFiles(listing: ListingInput): void;
+//#endregion
+//#region src/channels/huawei.d.ts
+export declare const WAIT_BEFORE_SUBMIT_MS = 120000;
+export declare class HuaweiAndroidChannel implements Channel, ListingCapableChannel {
+  readonly id = "huawei";
+  readonly label = "华为应用市场";
+  readonly capabilities: ChannelCapabilities;
+  readonly errorHints: {
+    "204144719": string;
+    "204144727": string;
+    "204144660": string;
+    "1003": string;
+    "204144702": string;
+    "204144677": string;
+  };
+  private authHeaders;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * 更新商店应用信息：简介/描述走 v3 app-language-info（briefInfo/appDesc）。
+   * 图标/截图：华为 v3 app-file-info 的 fileType 取值未在官方文档确证（软件包=5 已验证，图标清单值不确定），
+   * 未经真机验证前只上传 OBS 不做 file-info 绑定（skip 并在结果中标注），避免误写损坏草稿。
+   */
+  updateListing(ctx: Pick<ChannelContext, "credentials" | "target" | "emit">, listing: ListingInput): Promise<ListingResult>;
+  /**
+   * 审核状态查询: GET /api/publish/v2/app-info → appInfo.releaseState。
+   * releaseState 全表 —— 对拍 python/android-publish hw_query.py（真机验证权威）:
+   *   0=已上架 1=审核不通过 2=已下架 3=待上架 4=审核中 5=升级审核中
+   *   7=草稿 8=升级审核不通过 11=撤销上架
+   * （apkgo huawei.go 交叉验证一致，另收录 6=申请下架 9=下架审核不通过 10=开发者下架 12=预审中 13=预审不通过）
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/channels/shared/agc-token.d.ts
+/** 华为 AGC token（安卓/鸿蒙同源）——自 v1 lib/agc.mjs 迁移 */
+export declare function getAgcToken({ clientId, clientSecret }: {
+  clientId: string;
+  clientSecret: string;
+}): Promise<string>;
+//#endregion
+//#region src/channels/xiaomi.d.ts
+export declare class XiaomiChannel implements Channel {
+  readonly id = "xiaomi";
+  readonly label = "小米应用商店";
+  readonly capabilities: ChannelCapabilities;
+  plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  /** 小米不支持只传包：push 接口上传即提审 */
+  stage(_ctx: ChannelContext): Promise<StageResult>;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * 审核状态查询: POST /dev/query（SIG 同 push，RequestData={userName,packageName}）。
+   * 小米无专用审核接口，返回含 status 字段但取值文档缺失 → 统一 unknown+raw 透出原始响应。
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/channels/oppo.d.ts
+export declare class OppoChannel implements Channel {
+  readonly id = "oppo";
+  readonly label = "OPPO 应用市场";
+  readonly capabilities: ChannelCapabilities;
+  readonly errorHints: {
+    "911215": string;
+    "911216": string;
+    "800002": string;
+  };
+  /** stage 产物暂存（apkUrl/md5），submit 按 pkgName 取回 */
+  private readonly staged;
+  private required;
+  private auth;
+  plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  /**
+   * 上传 APK 到 OPPO 文件服务器（get-upload-url → multipart），返回 apkUrl/md5。
+   * stage 与 submit 回退共用；app/info 有频控且仅 submit 复用线上字段需要，stage 不查。
+   */
+  private uploadApk;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * 审核状态查询: GET /resource/v1/app/info（公共参数 + api_sign，同 stage）
+   * → data.audit_status（android-publish oppo_query.py: 1=待提审 2=审核中 3=通过 4=驳回）。
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/channels/vivo.d.ts
+export declare class VivoChannel implements Channel {
+  readonly id = "vivo";
+  readonly label = "vivo 应用市场";
+  readonly capabilities: ChannelCapabilities;
+  readonly errorHints: {
+    "1002": string;
+    "46001": string;
+  };
+  /**
+   * stage→submit 之间传递上传结果：Channel 接口不透传 ref，
+   * 常规编排为同一进程内先 stage 后 submit，用实例字段承接；
+   * 直接 submit（跳过 stage）时回退为现场上传。
+   * 对拍 python upload_apk：serialnumber/versionCode 均取自上传响应，提审都要回传。
+   */
+  private lastUpload?;
+  private creds;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  /** 查应用详情（提审复用 compatibleDevice/onlineType；审核状态 auditStatus 也出于此） */
+  private queryDetails;
+  /** 普通 JSON 接口（签名覆盖公共+业务参数） */
+  private vivoApi;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * 审核状态查询: 复用 app.query.details 的 data.auditStatus（对拍 python vivo_query.py；
+   * 未确证的 app.audit.status method 已删——python/apkgo 均无此调用）。
+   * 映射 0=审核通过 1=审核中 2=驳回 沿自 v1，待真机校准；
+   * 交叉见证：apkgo vivo.go 读 data.status 且编号不同（1草稿/2待审核/3通过/4不通过/5撤销），冲突以真机为准。
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+  /** 驳回原因字段名文档未明确，按常见命名兜底取（auditMessage/auditMsg） */
+  private auditReason;
+}
+//#endregion
+//#region src/channels/honor.d.ts
+export declare class HonorChannel implements Channel {
+  readonly id = "honor";
+  readonly label = "荣耀应用市场";
+  readonly capabilities: ChannelCapabilities;
+  readonly errorHints: {
+    "100030001": string;
+    "100030002": string;
+  };
+  private fetchToken;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/channels/yyb.d.ts
+export declare class YybChannel implements Channel {
+  readonly id = "yyb";
+  readonly label = "腾讯应用宝";
+  readonly capabilities: ChannelCapabilities;
+  /** stage 产物暂存（serial_number + md5），submit 按 appId 取回 */
+  private readonly staged;
+  private required;
+  private creds;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * 审核状态查询: POST /query_app_update_status（pkg_name+app_id）→ audit_status + audit_reason。
+   * —— 对拍 python/android-publish query_status.py: 1=审核中 2=驳回 3=通过 8=撤销。
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/channels/agc-harmony.d.ts
+/**
+ * 按 bundleName 查鸿蒙应用 appId（packageTypes=7 为鸿蒙过滤值）—— v1 agc.mjs getHarmonyAppId 原样。
+ * appId 缺省时由渠道内部调用，也可独立复用。
+ */
+export declare function getHarmonyAppId(opts: {
+  clientId: string;
+  token: string;
+  bundleName: string;
+}): Promise<string>;
+export declare class AgcHarmonyChannel implements Channel {
+  readonly id = "agc-harmony";
+  readonly label = "华为 AGC(鸿蒙)";
+  readonly capabilities: ChannelCapabilities;
+  readonly errorHints: {
+    "204144719": string;
+    "204144727": string;
+    "204144660": string;
+    "1003": string;
+    "204144702": string;
+    "204144677": string;
+  };
+  private authHeaders;
+  /** appId 缺省时按 bundleName 查（v1 全链路 step 0，可选） */
+  private resolveAppId;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  /** stage = 上传+绑定（不提审）：正式 .app 走 v3 绑定；ctx.target.releaseType==='6' 走测试发布（.hap） */
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  /** submit = v1 releaseHarmonyApp 完整链路：上传+绑定+文案 → 等编译轮询 → 提审（带重试） */
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  status(): Promise<ReviewStatus>;
+  /** v1 releaseHarmonyApp step 1-4：.app 校验 → 上传地址 → PUT 整包 → v3 绑定（releaseType=1）→ 文案（不阻断） */
+  private uploadFormal;
+  /** v1 uploadToAgc（releaseType=6 测试发布）：上传 → 绑定（不阻断）→ 文案（不阻断），不提审 */
+  private uploadBeta;
+  /** v1 更新文案段（releaseHarmonyApp step 4 / uploadToAgc 尾段）：查默认语言 → 写 newFeatures，失败仅警告不阻断 */
+  private updateReleaseNotes;
+}
+//#endregion
+//#region src/channels/asc.d.ts
+export declare class AscChannel implements Channel {
+  readonly id = "asc";
+  readonly label = "App Store Connect";
+  readonly capabilities: ChannelCapabilities;
+  plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  /** 凭据三元组（Key ID / Issuer ID / p8 路径，缺任一抛错） */
+  private resolveAuth;
+  /**
+   * 上传 ipa 到 App Store Connect（TestFlight / 正式皆走此入口）。
+   * 来源: v1 tools/publish/lib/asc.mjs 的 uploadIpaToAsc（逻辑不变；v1 经 run 继承 stdio 输出，
+   * v2 输出统一走 ctx.emit，故改为捕获后透传，失败语义与 v1 run 一致）
+   */
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  /**
+   * 提审 App Store —— 按 ASC 官方文档新实现，未经真实链路验证。
+   * 文档: appStoreVersionSubmissions / Create a Version Submission
+   *   https://developer.apple.com/documentation/appstoreconnectapi
+   * 链路: 查 app（bundleId → 数字 id）→ 查最新已处理(VALID)构建 → 读取/创建 appStoreVersion
+   *   （releaseType 默认 MANUAL，ctx.releaseTime 提供时 SCHEDULED + earlyReleaseDate）
+   *   → 绑定构建到版本 → POST appStoreVersionSubmissions 进入审核
+   */
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  status(): Promise<ReviewStatus>;
+}
+//#endregion
+//#region src/channels/googleplay.d.ts
+export declare class GooglePlayChannel implements Channel {
+  readonly id = "googleplay";
+  readonly label = "Google Play";
+  readonly capabilities: ChannelCapabilities;
+  plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /** 上传 + 部署到指定轨道 + commit，返回 `editId:versionCode` */
+  private uploadAndAssign;
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+  private requirePkgName;
+}
+//#endregion
+//#region src/util.d.ts
+/** 分块计算文件 SHA256（产物可达上百 MB，8MB 分块避免整读内存，同 sign.ts md5File 先例） */
+export declare function sha256File(filePath: string): string;
+//#endregion
+//#region src/channels/shared/error-codes.d.ts
+/**
+ * 错误码人话化：消费各渠道自带 errorHints（平台内聚——表与渠道实现同文件）。
+ */
+export declare function humanizeError(hints: Record<string, string> | undefined, message: string): string;
+//#endregion
+//#region src/version.d.ts
+export interface ArtifactVersion {
+  versionName?: string;
+  versionCode?: string;
+  /** 读取方式说明（doctor 展示溯源） */
+  source: string;
+}
+export declare function readArtifactVersion(artifactPath: string): ArtifactVersion | undefined;
+//#endregion
+export { BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, FrameworkAdapter, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, QypubPlugin, QypubUserConfig, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, appendEntry, defineConfig, detectBundleIds, detectFramework, electronAdapter, findArtifacts, flutterAdapter, nativeAndroidAdapter, nativeHarmonyAdapter, nativeIosAdapter, readEntries, resolvePlugins, rnAdapter, runStage, runSubmit, tauriAdapter };