@hot-updater/cli-tools 1.0.0-rc.0 → 1.0.0-rc.2

package/dist/index.d.mts

@@ -2,8 +2,6 @@ import { Readable } from "stream";
 import { Key as Key$1 } from "node:readline";
 import { Readable as Readable$1, Writable } from "node:stream";
 import { Bundle, BundleSigningPlugin, ConfigInput, LocalSigningConfig, Platform, RequiredDeep, SigningConfig, StoragePluginWith, StoragePutResult } from "@hot-updater/plugin-core";
-import * as _$_hot_updater_core0 from "@hot-updater/core";
-
 //#region src/BuildLogger.d.ts
 type LinePattern = string | RegExp;
 interface BuildLoggerConfig {
@@ -47,10 +45,13 @@ interface BundleSigningSession {
   readonly publicKey: string;
   readonly signFileHash: (fileHash: string) => Promise<string>;
 }
+declare const readBundleSigningPublicKeyFile: (publicKeyPath: string, options?: {
+  readonly cwd?: string;
+}) => Promise<string>;
 declare const prepareBundleSigning: (signing: SigningConfig | undefined, options?: {
   readonly cwd?: string;
 }) => Promise<BundleSigningSession | null>;
-/** Resolves the native trust anchor without calling a remote signing provider. */
+/** Resolves the public identity of the configured bundle signer. */
 declare const getBundleSigningPublicKey: (signing: SigningConfig | undefined, options?: {
   readonly cwd?: string;
 }) => Promise<string | null>;
@@ -162,63 +163,42 @@ declare const copyDirToTmp: (dir: string, childDirname?: string) => Promise<{
 }>;
 //#endregion
 //#region src/createTarBr.d.ts
-declare const createTarBrTargetFiles: ({
-  outfile,
-  targetFiles
-}: {
+declare const createTarBrTargetFiles: ({ outfile, targetFiles }: {
   targetFiles: {
     path: string;
     name: string;
   }[];
   outfile: string;
 }) => Promise<string>;
-declare const createTarBr: ({
-  outfile,
-  targetDir,
-  excludeExts
-}: {
+declare const createTarBr: ({ outfile, targetDir, excludeExts }: {
   targetDir: string;
   outfile: string;
   excludeExts?: string[];
 }) => Promise<string>;
 //#endregion
 //#region src/createTarGz.d.ts
-declare const createTarGzTargetFiles: ({
-  outfile,
-  targetFiles
-}: {
+declare const createTarGzTargetFiles: ({ outfile, targetFiles }: {
   targetFiles: {
     path: string;
     name: string;
   }[];
   outfile: string;
 }) => Promise<string>;
-declare const createTarGz: ({
-  outfile,
-  targetDir,
-  excludeExts
-}: {
+declare const createTarGz: ({ outfile, targetDir, excludeExts }: {
   targetDir: string;
   outfile: string;
   excludeExts?: string[];
 }) => Promise<string>;
 //#endregion
 //#region src/createZip.d.ts
-declare const createZipTargetFiles: ({
-  outfile,
-  targetFiles
-}: {
+declare const createZipTargetFiles: ({ outfile, targetFiles }: {
   targetFiles: {
     path: string;
     name: string;
   }[];
   outfile: string;
 }) => Promise<string>;
-declare const createZip: ({
-  outfile,
-  targetDir,
-  excludeExts
-}: {
+declare const createZip: ({ outfile, targetDir, excludeExts }: {
   targetDir: string;
   outfile: string;
   excludeExts?: string[];
@@ -300,18 +280,8 @@ type WriteHotUpdaterConfigResult = {
   path: string;
   reason?: string;
 };
-declare const createHotUpdaterConfigScaffold: ({
-  build,
-  storage,
-  database,
-  extraImports,
-  helperStatements,
-  updateStrategy
-}: CreateHotUpdaterConfigScaffoldOptions) => HotUpdaterConfigScaffold;
-declare const createHotUpdaterConfigScaffoldFromBuilder: (builder: ConfigBuilder, {
-  helperStatements,
-  updateStrategy
-}?: CreateHotUpdaterConfigScaffoldFromBuilderOptions) => HotUpdaterConfigScaffold;
+declare const createHotUpdaterConfigScaffold: ({ build, storage, database, extraImports, helperStatements, updateStrategy }: CreateHotUpdaterConfigScaffoldOptions) => HotUpdaterConfigScaffold;
+declare const createHotUpdaterConfigScaffoldFromBuilder: (builder: ConfigBuilder, { helperStatements, updateStrategy }?: CreateHotUpdaterConfigScaffoldFromBuilderOptions) => HotUpdaterConfigScaffold;
 declare const writeHotUpdaterConfig: (scaffold: HotUpdaterConfigScaffold, filePath?: string) => Promise<WriteHotUpdaterConfigResult>;
 //#endregion
 //#region src/hotUpdaterEnv.d.ts
@@ -320,10 +290,7 @@ type HotUpdaterInitEnv = {
   readonly inputEnv?: Readonly<Record<string, string>>;
   readonly managedEnv: Readonly<Record<string, string>>;
 };
-declare const getHotUpdaterInitInputEnv: ({
-  env,
-  managedEnv
-}: HotUpdaterInitEnv, nonInteractive: boolean) => Readonly<Record<string, string>>;
+declare const getHotUpdaterInitInputEnv: ({ env, managedEnv }: HotUpdaterInitEnv, nonInteractive: boolean) => Readonly<Record<string, string>>;
 declare const readHotUpdaterInitEnv: (cwd: string, envFile?: string) => Promise<HotUpdaterInitEnv>;
 declare const readHotUpdaterEnv: (cwd: string) => Promise<Readonly<Record<string, string>>>;
 declare const getHotUpdaterEnvValue: (env: Readonly<Record<string, string>>, key: string) => string | undefined;
@@ -335,41 +302,25 @@ declare const HotUpdateDirUtil: {
   readonly logDirName: "log";
   readonly outputGitignorePath: ".hot-updater/output";
   readonly logGitignorePath: ".hot-updater/log";
-  readonly getDirPath: ({
-    cwd
-  }: {
+  readonly getDirPath: ({ cwd }: {
     cwd: string;
   }) => string;
-  readonly getDefaultOutputPath: ({
-    cwd
-  }: {
+  readonly getDefaultOutputPath: ({ cwd }: {
     cwd: string;
   }) => string;
-  readonly getLogDirPath: ({
-    cwd
-  }: {
+  readonly getLogDirPath: ({ cwd }: {
     cwd: string;
   }) => string;
 };
 //#endregion
 //#region src/infrastructureGeneration.d.ts
 type Fetch = typeof fetch;
-declare const assertInfrastructureGenerationPayload: ({
-  payload,
-  provider,
-  resource
-}: {
+declare const assertInfrastructureGenerationPayload: ({ payload, provider, resource }: {
   readonly payload: unknown;
   readonly provider: string;
   readonly resource: string;
 }) => void;
-declare const assertInfrastructureGenerationAtUrl: ({
-  fetchImpl,
-  legacyStatuses,
-  provider,
-  resource,
-  versionUrl
-}: {
+declare const assertInfrastructureGenerationAtUrl: ({ fetchImpl, legacyStatuses, provider, resource, versionUrl }: {
   readonly fetchImpl?: Fetch;
   readonly legacyStatuses?: readonly number[];
   readonly provider: string;
@@ -407,10 +358,7 @@ type InitProviderDefinition<TInputs extends InitProviderInputsDefinition = InitP
   readonly label: string;
 };
 declare const defineInitProvider: <const TInputs extends InitProviderInputsDefinition>(provider: InitProviderDefinition<TInputs>) => InitProviderDefinition<TInputs>;
-declare const shouldAutoSelectOnlyInitResource: ({
-  availableResourceCount,
-  savedIdentifier
-}: {
+declare const shouldAutoSelectOnlyInitResource: ({ availableResourceCount, savedIdentifier }: {
   readonly availableResourceCount: number;
   readonly savedIdentifier?: string;
 }) => boolean;
@@ -420,40 +368,23 @@ declare const getInitProviderTextPromptValues: (prompt: InitProviderTextPromptDe
 };
 declare const resolveInitProviderInput: (env: Readonly<Record<string, string>>, input: InitProviderInputDefinition) => string | undefined;
 declare const resolveInitProviderInputs: (env: Readonly<Record<string, string>>, provider: InitProviderDefinition) => Readonly<Record<string, string | undefined>>;
-declare const getMissingInitProviderInputs: ({
-  inputs,
-  preflightOnly,
-  provider
-}: {
+declare const getMissingInitProviderInputs: ({ inputs, preflightOnly, provider }: {
   readonly inputs: Readonly<Record<string, string | undefined>>;
   readonly preflightOnly?: boolean;
   readonly provider: InitProviderDefinition;
 }) => readonly string[];
-declare const assertInitProviderInputs: <TInputs extends InitProviderInputsDefinition>({
-  inputs,
-  provider,
-  strict
-}: {
+declare const assertInitProviderInputs: <TInputs extends InitProviderInputsDefinition>({ inputs, provider, strict }: {
   readonly inputs: Readonly<Record<string, string | undefined>>;
   readonly provider: InitProviderDefinition<TInputs>;
   readonly strict?: boolean;
 }) => void;
-declare const confirmInitInputPersistence: <TInputs extends InitProviderInputsDefinition>({
-  existingEnv,
-  inputs,
-  nonInteractive,
-  provider
-}: {
+declare const confirmInitInputPersistence: <TInputs extends InitProviderInputsDefinition>({ existingEnv, inputs, nonInteractive, provider }: {
   readonly existingEnv: Readonly<Record<string, string>>;
   readonly inputs: Readonly<Record<string, string | undefined>>;
   readonly nonInteractive: boolean;
   readonly provider: InitProviderDefinition<TInputs>;
 }) => Promise<boolean>;
-declare const getInitProviderEnvVars: <TInputs extends InitProviderInputsDefinition>({
-  includeConsentInputs,
-  inputs,
-  provider
-}: {
+declare const getInitProviderEnvVars: <TInputs extends InitProviderInputsDefinition>({ includeConsentInputs, inputs, provider }: {
   readonly includeConsentInputs: boolean;
   readonly inputs: Readonly<Record<string, string | undefined>>;
   readonly provider: InitProviderDefinition<TInputs>;
@@ -479,10 +410,7 @@ declare class LegacyInfrastructureError extends InitError {
   readonly name = "LegacyInfrastructureError";
   constructor(provider: string, resource: string);
 }
-declare const assertInitInputs: ({
-  inputs,
-  strict
-}: {
+declare const assertInitInputs: ({ inputs, strict }: {
   readonly inputs: Readonly<Record<string, string | undefined>>;
   readonly strict?: boolean;
 }) => void;
@@ -496,10 +424,7 @@ type HotUpdaterLogWriter = {
   close: () => Promise<void>;
 };
 declare const stripAnsi: (value: string) => string;
-declare const createLogWriter: ({
-  prefix,
-  logFilePath
-}: {
+declare const createLogWriter: ({ prefix, logFilePath }: {
   prefix: string;
   logFilePath?: string;
 }) => Promise<HotUpdaterLogWriter>;
@@ -542,12 +467,7 @@ declare const makeEnv: (newEnvVars: Record<string, EnvVarValue>, filePath?: stri
 //#region src/promoteBundle.d.ts
 type PromoteStoragePlugin = StoragePluginWith<"get" | "put" | "exists" | "delete">;
 declare const LEGACY_BUNDLE_ERROR = "This OTA bundle was created by a version that does not support manifest.json. Copy bundle is not available.";
-declare function createCopiedBundleArchive({
-  bundle,
-  config,
-  nextBundleId,
-  storagePlugin
-}: {
+declare function createCopiedBundleArchive({ bundle, config, nextBundleId, storagePlugin }: {
   bundle: Bundle;
   config: ConfigResponse;
   nextBundleId: string;
@@ -558,12 +478,12 @@ declare function createCopiedBundleArchive({
     archiveByteSize: number;
     storageUri: string;
     fileHash: string;
-    metadata: _$_hot_updater_core0.BundleMetadata | undefined;
+    metadata: import("@hot-updater/core").BundleMetadata | undefined;
     assetBaseStorageUri: string;
     patches: never[];
     manifestFileHash: string;
     manifestStorageUri: string;
-    platform: _$_hot_updater_core0.Platform;
+    platform: import("@hot-updater/core").Platform;
     gitCommitHash: string | null;
   };
   uploadedStorageUris: string[];
@@ -622,12 +542,18 @@ interface ClackSettings {
    * Date prompt localization
    */
   date?: {
-    /** Month names for validation messages (January, February, ...) */monthNames?: string[];
+    /** Month names for validation messages (January, February, ...) */
+    monthNames?: string[];
     messages?: {
-      /** Shown when date is missing */required?: string; /** Shown when month > 12 */
-      invalidMonth?: string; /** (days, monthName) => message for invalid day */
-      invalidDay?: (days: number, month: string) => string; /** (min) => message when date is before minDate */
-      afterMin?: (min: Date) => string; /** (max) => message when date is after maxDate */
+      /** Shown when date is missing */
+      required?: string;
+      /** Shown when month > 12 */
+      invalidMonth?: string;
+      /** (days, monthName) => message for invalid day */
+      invalidDay?: (days: number, month: string) => string;
+      /** (min) => message when date is before minDate */
+      afterMin?: (min: Date) => string;
+      /** (max) => message when date is after maxDate */
       beforeMax?: (max: Date) => string;
     };
   };
@@ -746,12 +672,6 @@ declare namespace StandardSchemaV1 {
  * ```
  */
 type Validate<TValue> = ((value: TValue | undefined) => string | Error | undefined) | StandardSchemaV1<TValue | undefined, unknown>;
-/**
- * Runs the `validate()` option and normalizes the result
- * @param validate - The validate option
- * @param value - The user input
- * @returns the validation result
- */
 interface PromptOptions<TValue, Self extends Prompt<TValue>> {
   render(this: Omit<Self, 'prompt'>): string | undefined;
   initialValue?: any;
@@ -1243,12 +1163,12 @@ interface DateOptions extends CommonOptions {
  * ```
  */
 declare const date: (opts: DateOptions) => Promise<Date | symbol>;
-type Prettify<T> = { [P in keyof T]: T[P] } & {};
+type Prettify<T> = { [P in keyof T]: T[P]; } & {};
 /**
  * The return type of a {@link PromptGroup}.
  * Resolves all prompt results, excluding the cancel symbol.
  */
-type PromptGroupAwaitedReturn<T> = { [P in keyof T]: Exclude<Awaited<T[P]>, symbol> };
+type PromptGroupAwaitedReturn<T> = { [P in keyof T]: Exclude<Awaited<T[P]>, symbol>; };
 /**
  * Options for the {@link group} utility.
  */
@@ -1266,7 +1186,7 @@ interface PromptGroupOptions<T> {
  */
 type PromptGroup<T> = { [P in keyof T]: (opts: {
   results: Prettify<Partial<PromptGroupAwaitedReturn<Omit<T, P>>>>;
-}) => undefined | Promise<T[P] | undefined> };
+}) => undefined | Promise<T[P] | undefined>; };
 /**
  * The `group` utility provides a consistent way to combine a series of prompts,
  * combining each answer into one object. Each prompt receives the results of
@@ -1424,32 +1344,19 @@ interface LimitOptionsParams<TOption> extends CommonOptions {
  * });
  * ```
  */
-declare const limitOptions: <TOption>({
-  cursor,
-  options,
-  style,
-  output,
-  maxItems,
-  columnPadding,
-  rowPadding
-}: LimitOptionsParams<TOption>) => string[];
+declare const limitOptions: <TOption>({ cursor, options, style, output, maxItems, columnPadding, rowPadding }: LimitOptionsParams<TOption>) => string[];
 interface LogMessageOptions extends CommonOptions {
   symbol?: string;
   spacing?: number;
   secondarySymbol?: string;
 }
 declare const log$1: {
-  message: (message?: string | string[], {
-    symbol,
-    secondarySymbol,
-    output,
-    spacing,
-    withGuide
-  }?: LogMessageOptions) => void;
+  message: (message?: string | string[], { symbol, secondarySymbol, output, spacing, withGuide }?: LogMessageOptions) => void;
   info: (message: string, opts?: LogMessageOptions) => void;
   success: (message: string, opts?: LogMessageOptions) => void;
   step: (message: string, opts?: LogMessageOptions) => void;
-  warn: (message: string, opts?: LogMessageOptions) => void; /** alias for `log.warn()`. */
+  warn: (message: string, opts?: LogMessageOptions) => void;
+  /** alias for `log.warn()`. */
   warning: (message: string, opts?: LogMessageOptions) => void;
   error: (message: string, opts?: LogMessageOptions) => void;
 };
@@ -1709,17 +1616,7 @@ interface SpinnerResult {
   clear(): void;
   readonly isCancelled: boolean;
 }
-declare const spinner: ({
-  indicator,
-  onCancel,
-  output,
-  cancelMessage,
-  errorMessage,
-  frames,
-  delay,
-  signal,
-  ...opts
-}?: SpinnerOptions) => SpinnerResult;
+declare const spinner: ({ indicator, onCancel, output, cancelMessage, errorMessage, frames, delay, signal, ...opts }?: SpinnerOptions) => SpinnerResult;
 interface ProgressOptions extends SpinnerOptions {
   style?: 'light' | 'heavy' | 'block';
   max?: number;
@@ -1728,12 +1625,7 @@ interface ProgressOptions extends SpinnerOptions {
 interface ProgressResult extends SpinnerResult {
   advance(step?: number, msg?: string): void;
 }
-declare function progress({
-  style,
-  max: userMax,
-  size: userSize,
-  ...spinnerOptions
-}?: ProgressOptions): ProgressResult;
+declare function progress({ style, max: userMax, size: userSize, ...spinnerOptions }?: ProgressOptions): ProgressResult;
 interface SelectKeyOptions<Value extends string> extends CommonOptions {
   message: string;
   options: Option<Value>[];
@@ -1742,13 +1634,12 @@ interface SelectKeyOptions<Value extends string> extends CommonOptions {
 }
 declare const selectKey: <Value extends string>(opts: SelectKeyOptions<Value>) => Promise<Value | symbol>;
 declare const stream: {
-  message: (iterable: Iterable<string> | AsyncIterable<string>, {
-    symbol
-  }?: LogMessageOptions) => Promise<void>;
+  message: (iterable: Iterable<string> | AsyncIterable<string>, { symbol }?: LogMessageOptions) => Promise<void>;
   info: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>;
   success: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>;
   step: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>;
-  warn: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>; /** alias for `log.warn()`. */
+  warn: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>;
+  /** alias for `log.warn()`. */
   warning: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>;
   error: (iterable: Iterable<string> | AsyncIterable<string>) => Promise<void>;
 };
@@ -1830,7 +1721,7 @@ declare const transformEnv: <T extends Record<string, string>>(filename: string,
 //#endregion
 //#region src/transformTemplate.d.ts
 type ExtractPlaceholders<T extends string> = T extends `${infer _Start}%%${infer Key}%%${infer Rest}` ? Key | ExtractPlaceholders<Rest> : never;
-type TransformTemplateArgs<T extends string> = { [Key in ExtractPlaceholders<T>]: string };
+type TransformTemplateArgs<T extends string> = { [Key in ExtractPlaceholders<T>]: string; };
 /**
  * Replaces placeholders in the format %%key%% in a template string with values from the values object.
  * Uses generic type T to automatically infer placeholder keys from the template string to ensure type safety.
@@ -1842,4 +1733,4 @@ type TransformTemplateArgs<T extends string> = { [Key in ExtractPlaceholders<T>]
  */
 declare function transformTemplate<T extends string>(templateString: T, values: TransformTemplateArgs<T>): string;
 //#endregion
-export { BuildLogger, BuildLoggerConfig, BuildType, BundleSigningSession, ConfigBuilder, ConfigBuilderScaffold, ConfigResponse, CreateHotUpdaterConfigScaffoldFromBuilderOptions, CreateHotUpdaterConfigScaffoldOptions, HOT_UPDATER_SERVER_PACKAGE_VERSION_ENV, HotUpdateDirUtil, HotUpdaterConfigOptions, HotUpdaterConfigScaffold, HotUpdaterInitEnv, HotUpdaterLogWriter, IConfigBuilder, ImportInfo, InitEnvFileError, InitError, InitProviderDefinition, InitProviderInputDefinition, InitProviderInputPersistence, LEGACY_BUNDLE_ERROR, LegacyInfrastructureError, ManagedHelperStatement, ManagedHelperStrategy, MissingInitInputsError, PromptProgress, PromptSpinner, ProviderConfig, ReactNativeMetadata, ReadPackageUpResult, RunInitOptions, WriteHotUpdaterConfigResult, assertInfrastructureGenerationAtUrl, assertInfrastructureGenerationPayload, assertInitInputs, assertInitProviderInputs, banner, typedColors as colors, confirmInitInputPersistence, copyDirToTmp, createCopiedBundleArchive, createHotUpdaterConfigScaffold, createHotUpdaterConfigScaffoldFromBuilder, createLogWriter, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, defineInitProvider, encryptJson, ensureInstallPackages, formatApiKeyNote, getAndroidSdkPath, getBundleSigningPublicKey, getCwd, getHotUpdaterEnvValue, getHotUpdaterInitInputEnv, getInitProviderEnvVars, getInitProviderTextPromptValues, getMissingInitInputs, getMissingInitProviderInputs, getPackageManager, getReactNativeMetadatas, getStorageFileByteSize, link, loadConfig, log, makeEnv, p, prepareBundleSigning, printBanner, putStorageFile, readHotUpdaterEnv, readHotUpdaterInitEnv, readPackageUp, renderImportStatements, resolveHotUpdaterServerVersion, resolveInitProviderInput, resolveInitProviderInputs, resolvePackageVersion, shouldAutoSelectOnlyInitResource, stripAnsi, transformEnv, transformTemplate, writeHotUpdaterConfig, writeStorageFile, writeStorageResponseFile };
+export { BuildLogger, BuildLoggerConfig, BuildType, BundleSigningSession, ConfigBuilder, ConfigBuilderScaffold, ConfigResponse, CreateHotUpdaterConfigScaffoldFromBuilderOptions, CreateHotUpdaterConfigScaffoldOptions, HOT_UPDATER_SERVER_PACKAGE_VERSION_ENV, HotUpdateDirUtil, HotUpdaterConfigOptions, HotUpdaterConfigScaffold, HotUpdaterInitEnv, HotUpdaterLogWriter, IConfigBuilder, ImportInfo, InitEnvFileError, InitError, InitProviderDefinition, InitProviderInputDefinition, InitProviderInputPersistence, LEGACY_BUNDLE_ERROR, LegacyInfrastructureError, ManagedHelperStatement, ManagedHelperStrategy, MissingInitInputsError, PromptProgress, PromptSpinner, ProviderConfig, ReactNativeMetadata, ReadPackageUpResult, RunInitOptions, WriteHotUpdaterConfigResult, assertInfrastructureGenerationAtUrl, assertInfrastructureGenerationPayload, assertInitInputs, assertInitProviderInputs, banner, typedColors as colors, confirmInitInputPersistence, copyDirToTmp, createCopiedBundleArchive, createHotUpdaterConfigScaffold, createHotUpdaterConfigScaffoldFromBuilder, createLogWriter, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, defineInitProvider, encryptJson, ensureInstallPackages, formatApiKeyNote, getAndroidSdkPath, getBundleSigningPublicKey, getCwd, getHotUpdaterEnvValue, getHotUpdaterInitInputEnv, getInitProviderEnvVars, getInitProviderTextPromptValues, getMissingInitInputs, getMissingInitProviderInputs, getPackageManager, getReactNativeMetadatas, getStorageFileByteSize, link, loadConfig, log, makeEnv, p, prepareBundleSigning, printBanner, putStorageFile, readBundleSigningPublicKeyFile, readHotUpdaterEnv, readHotUpdaterInitEnv, readPackageUp, renderImportStatements, resolveHotUpdaterServerVersion, resolveInitProviderInput, resolveInitProviderInputs, resolvePackageVersion, shouldAutoSelectOnlyInitResource, stripAnsi, transformEnv, transformTemplate, writeHotUpdaterConfig, writeStorageFile, writeStorageResponseFile };