@applift/core 0.4.0 → 0.6.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as rnAdapter, A as StoreConfigSchema, B as StageResult, C as CredentialsProfile, D as ProjectConfig, E as GlobalConfigSchema, F as ChannelContext, G as detectBundleIds, H as BundleIds, I as ChannelEvent, J as findArtifacts, K as detectFramework, L as ChannelRegistry, M as StoresSchema, N as Channel, O as ProjectConfigSchema, P as ChannelCapabilities, Q as nativeIosAdapter, R as ReleasePlanEntry, S as CredentialsFileSchema, T as GlobalConfig, U as FrameworkAdapter, V as SubmitResult, W as Platform, X as nativeAndroidAdapter, Y as flutterAdapter, Z as nativeHarmonyAdapter, _ as appendEntry, a as QypubUserConfig, b as BetaConfigSchema, c as PipelineInput, d as runStage, et as tauriAdapter, f as runSubmit, g as HistoryQuery, h as HistoryEvent, i as QypubPlugin, j as Stores, k as StoreConfig, l as PipelineSummary, m as HistoryEntry, n as PluginHookName, o as defineConfig, p as HISTORY_PATH, q as electronAdapter, r as PluginHost, s as resolvePlugins, t as HookContext, u as PipelineSummaryEntry, v as readEntries, w as CredentialsProfileSchema, x as CredentialsFile, y as BetaConfig, z as ReviewStatus } from "./plugin-DzhwzVfu.mjs";
+import { $ as electronAdapter, A as ReleaseConfigSchema, B as ChannelCapabilities, C as CredentialsProfile, D as ProjectConfig, E as GlobalConfigSchema, F as VersionCodeConfig, G as ReviewStatus, H as ChannelEvent, I as VersionCodeConfigSchema, J as BundleIds, K as StageResult, L as VersionConfig, M as StoreConfigSchema, N as Stores, O as ProjectConfigSchema, P as StoresSchema, Q as detectFramework, R as VersionConfigSchema, S as CredentialsFileSchema, T as GlobalConfig, U as ChannelRegistry, V as ChannelContext, W as ReleasePlanEntry, X as Platform, Y as FrameworkAdapter, Z as detectBundleIds, _ as appendEntry, a as PluginHost, at as rnAdapter, b as BetaConfigSchema, c as PipelineInput, d as runStage, et as findArtifacts, f as runSubmit, g as HistoryQuery, h as HistoryEvent, i as PluginHookName, it as nativeIosAdapter, j as StoreConfig, k as ReleaseConfig, l as PipelineSummary, m as HistoryEntry, n as AppliftUserConfig, nt as nativeAndroidAdapter, o as defineConfig, ot as tauriAdapter, p as HISTORY_PATH, q as SubmitResult, r as HookContext, rt as nativeHarmonyAdapter, s as resolvePlugins, t as AppliftPlugin, tt as flutterAdapter, u as PipelineSummaryEntry, v as readEntries, w as CredentialsProfileSchema, x as CredentialsFile, y as BetaConfig, z as Channel } from "./plugin-B2GGlI_2.mjs";
 //#region src/registry.d.ts
 export declare class DefaultChannelRegistry implements ChannelRegistry {
   private readonly channels;
@@ -30,8 +30,13 @@ export declare function loadCredentials(filePath?: string): CredentialsFile;
  * knownKeys 提供时其裸键名（如 PGYER_API_KEY）也认（向后兼容），未提供的裸大写键不捡（避免误吸无关变量）。
  */
 export declare function resolveProfile(creds: CredentialsFile, profile: string, knownKeys?: string[]): Record<string, string>;
-/** 全局配置装载（缺失/损坏降级默认值并警告，不阻断） */
-export declare function loadGlobalConfig(filePath?: string): GlobalConfig;
+export interface GlobalConfigLoadResult {
+  config: GlobalConfig;
+  /** 配置文件损坏降级默认值时的警告（调用方决定呈现方式；core 保持 headless 不写 stderr） */
+  warning?: string;
+}
+/** 全局配置装载（缺失/损坏降级默认值；警告经返回值交给调用方，不阻断） */
+export declare function loadGlobalConfig(filePath?: string): GlobalConfigLoadResult;
 /** 写凭据（目录自动创建，文件强制 0600） */
 export declare function saveCredentials(data: CredentialsFile, filePath?: string): void;
 //#endregion
@@ -42,7 +47,7 @@ export interface LoadedProjectConfig {
    * c12 原始配置（保留 plugins 等 schema 外键）——插件发现（resolvePlugins）用；
    * 业务字段一律以 config（zod 解析后）为准。
    */
-  raw: QypubUserConfig;
+  raw: AppliftUserConfig;
   /** 配置文件所在目录（解析相对路径用），无配置文件时为 cwd */
   cwd: string;
 }
@@ -80,6 +85,10 @@ export declare class PgyerChannel implements Channel {
   readonly id = "pgyer";
   readonly label = "蒲公英";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（1247：源码注释已证 = buildKey 尚未就绪/COS 仍在入库） */
+  readonly errorHints: {
+    "1247": string;
+  };
   plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
   stage(ctx: ChannelContext): Promise<StageResult>;
   submit(): Promise<SubmitResult>;
@@ -172,6 +181,11 @@ export declare class XiaomiChannel implements Channel {
   readonly id = "xiaomi";
   readonly label = "小米应用商店";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（result 码：依据为本仓测试已固化的真实失败路径文案） */
+  readonly errorHints: {
+    "401": string;
+    "1005": string;
+  };
   plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
   /** 小米不支持只传包：push 接口上传即提审 */
   stage(_ctx: ChannelContext): Promise<StageResult>;
@@ -286,6 +300,10 @@ export declare class YybChannel implements Channel {
   readonly id = "yyb";
   readonly label = "腾讯应用宝";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（ret 码：依据为本仓测试已固化的真实失败路径） */
+  readonly errorHints: {
+    "10010": string;
+  };
   /** stage 产物暂存（serial_number + md5），submit 按 appId 取回 */
   private readonly staged;
   private required;
@@ -384,11 +402,24 @@ export declare class GooglePlayChannel implements Channel {
   readonly id = "googleplay";
   readonly label = "Google Play";
   readonly capabilities: ChannelCapabilities;
+  /** 平台错误码 → 人话（HTTP 状态：依据为本仓测试已固化的失败路径） */
+  readonly errorHints: {
+    "403": string;
+  };
   plan(_ctx: ChannelContext): Promise<ReleasePlanEntry>;
   stage(ctx: ChannelContext): Promise<StageResult>;
-  submit(ctx: ChannelContext): Promise<SubmitResult>;
+  submit(ctx: ChannelContext, stagedRef?: string): Promise<SubmitResult>;
+  /** 复用 stage 已上传的 versionCode：开新 edit（仍需 auth）→ 部署 production → commit，跳过上传 */
+  private assignExisting;
   /** 上传 + 部署到指定轨道 + commit，返回 `editId:versionCode` */
   private uploadAndAssign;
+  /**
+   * 部署 versionCode 到指定轨道并 commit：
+   * 先 GET 轨道现有 releases 再合并 PUT——目标 release（同 status=completed 配置）追加新 versionCode，
+   * 其余 releases 原样保留（status/userFraction 不变），避免整轨覆盖把旧版本从轨道剔除；
+   * :commit 冒号语法（对拍 apkgo googleplay.go 权威；对 production 含提交审核语义，internal 即生效）
+   */
+  private deployAndCommit;
   status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
   private requirePkgName;
 }
@@ -400,10 +431,197 @@ export declare function sha256File(filePath: string): string;
 //#region src/channels/shared/error-codes.d.ts
 /**
  * 错误码人话化：消费各渠道自带 errorHints（平台内聚——表与渠道实现同文件）。
+ * 网络类故障（AbortSignal 超时/断连/DNS）渠道层不转译，统一在此兜底提示。
  */
 export declare function humanizeError(hints: Record<string, string> | undefined, message: string): string;
 //#endregion
-//#region src/version.d.ts
+//#region src/channels/shared/redact.d.ts
+/**
+ * 文本脱敏（三层层叠，逐层尝试）：
+ *   1) http(s) URL 带 query/userinfo → query 按名脱敏 + 剥 userinfo
+ *   2) { / [ 开头且整串为合法 JSON → 递归按键名脱敏
+ *   3) 其余 → name=value 正则扫（错误消息等无结构文本）
+ */
+export declare function redactText(v: string): string;
+//#endregion
+//#region src/version/project.d.ts
+export type VersionFileKind = "gradle" | "pbxproj" | "app-json5" | "pubspec" | "package-json" | "tauri" | "expo-app-json";
+export interface PlatformVersionInfo {
+  platform: string;
+  versionName?: string;
+  versionCode?: string;
+  file: string;
+  kind: VersionFileKind;
+  /** 非标准形态说明（读出但不代写，提示改造） */
+  problem?: string;
+}
+export interface VersionWrite {
+  platform: string;
+  versionName: string;
+  versionCode: number;
+}
+/** 各端版本实况（按框架布局；未识别框架时尝试全部标准位置） */
+export declare function readProjectVersions(cwd: string, framework: FrameworkAdapter | null): PlatformVersionInfo[];
+/**
+ * 写回各端版本（多端 versionName 同步、versionCode 各端独立）。
+ * 返回实际改动的文件列表（commit 范围）。problem 端跳过并在返回中列出（不阻断其他端）。
+ */
+export declare function writeProjectVersions(cwd: string, framework: FrameworkAdapter | null, writes: VersionWrite[]): {
+  changed: string[];
+  skipped: Array<{
+    platform: string;
+    reason: string;
+  }>;
+};
+//#endregion
+//#region src/version/infer.d.ts
+export type BumpLevel = "major" | "minor" | "patch";
+export interface InferResult {
+  level: BumpLevel;
+  /** 展示用判定说明（中文，CLI 直接输出） */
+  reason: string;
+  total: number;
+  breaking: number;
+  feat: number;
+  fix: number;
+}
+/** conventional commits → bump level：BREAKING > feat(minor) > fix(patch)；无可识别提交 → patch */
+export declare function inferBumpLevel(messages: string[]): InferResult;
+export interface DecideOptions {
+  /** 显式 level：major | minor | patch | prerelease */
+  level?: string;
+  /** prerelease 标识（beta | rc…），与 level 组合或延续当前 */
+  pre?: string;
+}
+export interface DecideResult {
+  /** 完整 semver（可含 prerelease，tag 与 changelog 用） */
+  next: string;
+  /** 判定说明 */
+  reason: string;
+}
+/**
+ * 从当前版本决定下一版本（纯函数）。
+ * - 显式 level：semver.inc；当前是 prerelease 且不带 --pre → 剥离转正式（4.0.0-beta.3 + patch → 4.0.0）
+ * - 无 level：用 infer 结果
+ * - prerelease level：当前有 pre → 同基线递进（beta.3 → beta.4）；无 pre → 报错（应使用 --pre 进入）
+ * - --pre：从 level 出发挂 prerelease（4.0.0 + minor + beta → 4.1.0-beta.1）
+ * current 非 semver 时抛错（调用方要求显式指定或先手动规范化）。
+ */
+export declare function decideNextVersion(current: string, opts: DecideOptions, infer?: InferResult): DecideResult;
+/** 工程文件写入用的三段数字 versionName（prerelease 只留在 tag，不进商店） */
+export declare function storeVersionName(full: string): string;
+//#endregion
+//#region src/version/bump.d.ts
+export interface BumpOptions {
+  cwd: string;
+  framework: FrameworkAdapter | null;
+  /** major | minor | patch | prerelease | <semver>；缺省走推断 */
+  level?: string;
+  /** prerelease 标识（beta | rc…） */
+  pre?: string;
+  versionCode?: VersionCodeConfig;
+  /** 仅限端（缺省全端）；平台名 = android/ios/harmony/flutter/js/tauri/expo */
+  platforms?: string[];
+}
+export interface BumpPlan {
+  anchorTag?: string;
+  /** 疑似失败重跑（HEAD 是 release commit 且锚点后无新业务提交）——CLI 在 --yes 且无显式 level 时拒绝 */
+  suspectRerun?: boolean;
+  /** 基线版本（多端中最大 semver） */
+  base: string;
+  currentVersions: PlatformVersionInfo[];
+  /** 完整 semver（tag/changelog 用，可含 prerelease） */
+  nextVersion: string;
+  /** 商店 versionName（三段数字，工程文件用） */
+  storeName: string;
+  reason: string;
+  infer?: InferResult;
+  commits: string[];
+  writes: VersionWrite[];
+  versionCodeNote: string;
+}
+export declare function planBump(opts: BumpOptions): BumpPlan;
+export interface ApplyOptions {
+  /** 代 commit（默认 true；--no-commit 跳过） */
+  commit: boolean;
+  /** 代打 tag（默认 true；--no-tag 跳过） */
+  tag: boolean;
+}
+export interface ApplyResult {
+  changedFiles: string[];
+  skipped: Array<{
+    platform: string;
+    reason: string;
+  }>;
+  changelogFile?: string;
+  committed: boolean;
+  tagged: boolean;
+  /** commit/tag 失败原因（降级不阻断：文件已写好，提示用户手动收尾） */
+  warnings: string[];
+}
+export declare function applyBump(cwd: string, plan: BumpPlan, framework: FrameworkAdapter | null, opts: ApplyOptions): ApplyResult;
+//#endregion
+//#region src/version/version-code.d.ts
+/**
+ * versionCode 计算：默认递增 +1；可配公式（如 major*1000000+minor*1000+patch）。
+ * 实际写入 = max(公式值, 现值+1)——公式在同 versionName 重发时算出同值，
+ * +1 兜底保证单调（AGC 同版本不能重复提交 / Google Play 单调 / App Store 单调）。
+ */
+/** 公式白名单求值（仅支持 + - * ( ) 数字 与 major/minor/patch 变量；不 eval） */
+export declare function evalVersionCodeFormula(formula: string, v: {
+  major: number;
+  minor: number;
+  patch: number;
+}): number | undefined;
+/**
+ * 下一 versionCode：max(公式值, 现值+1)。
+ * - 无现值（首接工程无该字段）：公式值，否则 1
+ * - 有现值：至少现值+1（吞 3052/4000000 等任意历史值，首次 bump 即归一）
+ */
+export declare function nextVersionCode(current: number | undefined, formulaValue: number | undefined): number;
+//#endregion
+//#region src/version/changelog.d.ts
+export interface ChangelogEntry {
+  type: string;
+  scope?: string;
+  subject: string;
+  breaking: boolean;
+  hash?: string;
+}
+/** raw commit messages → 结构化条目（feat/fix/BREAKING 之外的 type 也保留，渲染时归类） */
+export declare function toChangelogEntries(messages: string[]): ChangelogEntry[];
+/** 渲染单个版本段落（## [4.1.0] - 2026-10-17） */
+export declare function renderChangelogSection(version: string, date: string, entries: ChangelogEntry[]): string;
+/**
+ * 插入/替换 CHANGELOG.md 的版本段落（幂等）：
+ * - 已有 `## [version]` → 整段替换为最新渲染
+ * - 否则插到首个 # Changelog 标题之后；无标题/无文件 → 新建带标题
+ * 返回写入路径；entries 为空也写入 heading（bump 闭环保持 tag ↔ changelog 对齐）。
+ */
+export declare function upsertChangelog(cwd: string, version: string, section: string): string;
+//#endregion
+//#region src/version/git.d.ts
+export interface GitResult {
+  ok: boolean;
+  stdout: string;
+  stderr: string;
+}
+export declare function git(cwd: string, args: string[]): GitResult;
+export declare function isGitRepo(cwd: string): boolean;
+/** 宽松 semver 解析（可选 v/前缀，如 v4.1.0 / 4.1.0-beta.3 / release-4.1.0 里取 semver 部分） */
+export declare function looseSemver(tag: string): string | undefined;
+/**
+ * 最新 semver tag（按版本序取最大，非创建时间——修复补打旧版本 tag 的场景更稳）。
+ * 无 tag / 非 git 仓库返回 undefined。
+ */
+export declare function latestSemverTag(cwd: string): string | undefined;
+/** 锚点 tag..HEAD 的完整 commit messages（%B 含 footer，NUL 分隔——body 内建换行安全） */
+export declare function commitsSince(cwd: string, ref?: string): string[];
+/** 工作区状态（--porcelain）。注意：不走通用 git()——其 stdout.trim() 会剥掉首行前导空格，
+ *  破坏 porcelain 的两列状态位（" M file" → "M file"），此处保留原始行仅去行尾。 */
+export declare function statusShort(cwd: string): string[];
+//#endregion
+//#region src/version/artifact.d.ts
 export interface ArtifactVersion {
   versionName?: string;
   versionCode?: string;
@@ -412,4 +630,4 @@ export interface ArtifactVersion {
 }
 export declare function readArtifactVersion(artifactPath: string): ArtifactVersion | undefined;
 //#endregion
-export { BetaConfig, BetaConfigSchema, 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 };
+export { AppliftPlugin, AppliftUserConfig, BetaConfig, BetaConfigSchema, 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, ReleaseConfig, ReleaseConfigSchema, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, VersionCodeConfig, VersionCodeConfigSchema, VersionConfig, VersionConfigSchema, appendEntry, defineConfig, detectBundleIds, detectFramework, electronAdapter, findArtifacts, flutterAdapter, nativeAndroidAdapter, nativeHarmonyAdapter, nativeIosAdapter, readEntries, resolvePlugins, rnAdapter, runStage, runSubmit, tauriAdapter };