@huoye/app-ship 0.1.2 → 0.2.1

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 /**
  * 上传配置接口
- */
-interface UploadConfig {
+ */ interface UploadConfig {
     /** 应用 ID */
     appId?: string;
     /** 版本号 */
@@ -406,8 +405,8 @@ interface UploadConfig {
             };
             /** 包名 */
             packageName?: string;
-            /** 发布轨道：internal | alpha | beta | production */
-            track?: 'internal' | 'alpha' | 'beta' | 'production';
+            /** 发布轨道；首版只支持 internal */
+            track?: 'internal';
         };
         /** 未来扩展的其他平台 */
         [key: string]: any;
@@ -415,8 +414,7 @@ interface UploadConfig {
 }
 /**
  * 应用元数据接口
- */
-interface AppMetadata {
+ */ interface AppMetadata {
     /** 版本号 */
     version: string;
     /** 应用名称 */
@@ -439,8 +437,7 @@ interface AppMetadata {
 }
 /**
  * 上传结果接口
- */
-interface UploadResult {
+ */ interface UploadResult {
     /** 平台名称 */
     platform: string;
     /** 是否成功 */
@@ -469,8 +466,7 @@ interface UploadResult {
 }
 /**
  * 上传器接口
- */
-interface IUploader {
+ */ interface IUploader {
     /** 上传器名称 */
     name: string;
     /**
@@ -491,8 +487,7 @@ interface IUploader {
 }
 /**
  * 构建结果接口
- */
-interface BuildResult {
+ */ interface BuildResult {
     /** 是否成功 */
     success: boolean;
     /**
@@ -521,6 +516,12 @@ declare class ConfigValidator {
      * @param filePath 配置文件路径
      */
     static loadAndValidate(filePath: string): UploadConfig | null;
+    /**
+     * 只收集本次实际启用配置中的环境变量，避免禁用平台阻塞其它上传任务。
+     */
+    private static collectRequiredEnvVars;
+    /** 在内存中递归解析环境变量，不重新拼接 YAML，避免密钥字符破坏 YAML 结构。 */
+    private static resolveEnvVars;
     /**
      * 验证配置 Schema
      * @param config 配置对象
@@ -1162,6 +1163,44 @@ declare class TencentUploader implements IUploader {
     private submitModifyAppInfo;
 }
 
+interface GooglePlayHttpResponse<T = any> {
+    data: T;
+}
+interface GooglePlayHttpClient {
+    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 {
+    serviceAccountJsonPath?: string;
+    serviceAccountJsonContent?: string;
+}
+interface GooglePlayUploaderDependencies {
+    httpClient?: GooglePlayHttpClient;
+    getAccessToken?: (auth: GooglePlayAuthConfig) => Promise<string>;
+}
+/**
+ * Google Play 上传器。
+ *
+ * 首版能力刻意限制为：上传一个 AAB 到内部测试轨道并保留为 draft。
+ * 配置层与 Google Play API 都使用 internal 作为内部测试轨道标识。
+ * 创建应用、填写商店资料、提交审核和生产发布均不在此适配器范围内。
+ */
+declare class GooglePlayUploader implements IUploader {
+    name: string;
+    private readonly httpClient;
+    private readonly getAccessToken;
+    constructor(dependencies?: GooglePlayUploaderDependencies);
+    validateConfig(config: any): boolean;
+    canHandle(filePath: string): boolean;
+    upload(filePath: string, config: any, _metadata: AppMetadata): Promise<UploadResult>;
+    private createAccessToken;
+    private deleteEditBestEffort;
+    private describeError;
+    private redactAndTruncate;
+    private failure;
+}
+
 interface RetryConfig {
     maxRetries?: number;
     initialDelayMs?: number;
@@ -1306,7 +1345,7 @@ declare class UploadManager {
     /**
      * 重试失败的平台
      */
-    retryFailedPlatforms(failedPlatforms: string[], filePath: string, config: any, metadata: AppMetadata): Promise<UploadReport>;
+    retryFailedPlatforms(failedPlatforms: string[], filePath: string | string[], config: any, metadata: AppMetadata): Promise<UploadReport>;
 }
 /**
  * 创建上传管理器实例
@@ -1401,4 +1440,88 @@ interface ParseOptions {
  */
 declare function parsePackageInfo(filePath: string, options?: ParseOptions): Promise<PackageInfo | null>;
 
-export { AdHocUploader, type AppMetadata, AppleJWTGenerator, AppleStoreUploader, type BuildResult, ConfigValidator, DEFAULT_RETRY_CONFIG, EnvValidator, ErrorCategory, HarmonyUploader, HuaweiUploader, type IUploader, OppoUploader, type PackageInfo, type ParseOptions, PgyerUploader, type RetryConfig, type RetryResult, RetryStrategy, TencentUploader, TestFlightUploader, type UploadConfig, UploadManager, type UploadManagerConfig, type UploadReport, type UploadResult, VivoUploader, XiaomiUploader, createUploadManager, createUploadRetryStrategy, parsePackageInfo };
+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;
+    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 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;
+}
+declare function createProjectKey(projectRoot: string): string;
+
+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 };

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 /**
  * 上传配置接口
- */
-interface UploadConfig {
+ */ interface UploadConfig {
     /** 应用 ID */
     appId?: string;
     /** 版本号 */
@@ -406,8 +405,8 @@ interface UploadConfig {
             };
             /** 包名 */
             packageName?: string;
-            /** 发布轨道：internal | alpha | beta | production */
-            track?: 'internal' | 'alpha' | 'beta' | 'production';
+            /** 发布轨道；首版只支持 internal */
+            track?: 'internal';
         };
         /** 未来扩展的其他平台 */
         [key: string]: any;
@@ -415,8 +414,7 @@ interface UploadConfig {
 }
 /**
  * 应用元数据接口
- */
-interface AppMetadata {
+ */ interface AppMetadata {
     /** 版本号 */
     version: string;
     /** 应用名称 */
@@ -439,8 +437,7 @@ interface AppMetadata {
 }
 /**
  * 上传结果接口
- */
-interface UploadResult {
+ */ interface UploadResult {
     /** 平台名称 */
     platform: string;
     /** 是否成功 */
@@ -469,8 +466,7 @@ interface UploadResult {
 }
 /**
  * 上传器接口
- */
-interface IUploader {
+ */ interface IUploader {
     /** 上传器名称 */
     name: string;
     /**
@@ -491,8 +487,7 @@ interface IUploader {
 }
 /**
  * 构建结果接口
- */
-interface BuildResult {
+ */ interface BuildResult {
     /** 是否成功 */
     success: boolean;
     /**
@@ -521,6 +516,12 @@ declare class ConfigValidator {
      * @param filePath 配置文件路径
      */
     static loadAndValidate(filePath: string): UploadConfig | null;
+    /**
+     * 只收集本次实际启用配置中的环境变量，避免禁用平台阻塞其它上传任务。
+     */
+    private static collectRequiredEnvVars;
+    /** 在内存中递归解析环境变量，不重新拼接 YAML，避免密钥字符破坏 YAML 结构。 */
+    private static resolveEnvVars;
     /**
      * 验证配置 Schema
      * @param config 配置对象
@@ -1162,6 +1163,44 @@ declare class TencentUploader implements IUploader {
     private submitModifyAppInfo;
 }
 
+interface GooglePlayHttpResponse<T = any> {
+    data: T;
+}
+interface GooglePlayHttpClient {
+    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 {
+    serviceAccountJsonPath?: string;
+    serviceAccountJsonContent?: string;
+}
+interface GooglePlayUploaderDependencies {
+    httpClient?: GooglePlayHttpClient;
+    getAccessToken?: (auth: GooglePlayAuthConfig) => Promise<string>;
+}
+/**
+ * Google Play 上传器。
+ *
+ * 首版能力刻意限制为：上传一个 AAB 到内部测试轨道并保留为 draft。
+ * 配置层与 Google Play API 都使用 internal 作为内部测试轨道标识。
+ * 创建应用、填写商店资料、提交审核和生产发布均不在此适配器范围内。
+ */
+declare class GooglePlayUploader implements IUploader {
+    name: string;
+    private readonly httpClient;
+    private readonly getAccessToken;
+    constructor(dependencies?: GooglePlayUploaderDependencies);
+    validateConfig(config: any): boolean;
+    canHandle(filePath: string): boolean;
+    upload(filePath: string, config: any, _metadata: AppMetadata): Promise<UploadResult>;
+    private createAccessToken;
+    private deleteEditBestEffort;
+    private describeError;
+    private redactAndTruncate;
+    private failure;
+}
+
 interface RetryConfig {
     maxRetries?: number;
     initialDelayMs?: number;
@@ -1306,7 +1345,7 @@ declare class UploadManager {
     /**
      * 重试失败的平台
      */
-    retryFailedPlatforms(failedPlatforms: string[], filePath: string, config: any, metadata: AppMetadata): Promise<UploadReport>;
+    retryFailedPlatforms(failedPlatforms: string[], filePath: string | string[], config: any, metadata: AppMetadata): Promise<UploadReport>;
 }
 /**
  * 创建上传管理器实例
@@ -1401,4 +1440,88 @@ interface ParseOptions {
  */
 declare function parsePackageInfo(filePath: string, options?: ParseOptions): Promise<PackageInfo | null>;
 
-export { AdHocUploader, type AppMetadata, AppleJWTGenerator, AppleStoreUploader, type BuildResult, ConfigValidator, DEFAULT_RETRY_CONFIG, EnvValidator, ErrorCategory, HarmonyUploader, HuaweiUploader, type IUploader, OppoUploader, type PackageInfo, type ParseOptions, PgyerUploader, type RetryConfig, type RetryResult, RetryStrategy, TencentUploader, TestFlightUploader, type UploadConfig, UploadManager, type UploadManagerConfig, type UploadReport, type UploadResult, VivoUploader, XiaomiUploader, createUploadManager, createUploadRetryStrategy, parsePackageInfo };
+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;
+    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 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;
+}
+declare function createProjectKey(projectRoot: string): string;
+
+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 };