@hot-updater/cli-tools 0.31.1 → 0.31.3

package/dist/{chunk-BEJ448es.mjs → chunk-hT5z_Zn9.mjs}

@@ -6,7 +6,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 import { Readable } from "stream";
 import { Key as Key$1 } from "node:readline";
 import { Readable as Readable$1, Writable } from "node:stream";
-import * as _$_hot_updater_core0 from "@hot-updater/core";
 import { Bundle, ConfigInput, DatabasePlugin, NodeStoragePlugin, Platform, RequiredDeep } from "@hot-updater/plugin-core";
 
 //#region src/BuildLogger.d.ts
@@ -90,9 +89,9 @@ declare class ConfigBuilder implements IConfigBuilder {
   getResult(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/types.d.ts
+//#region src/colors.d.ts
 type Formatter = (input: string | number | null | undefined) => string;
-interface Colors {
+type Colors = {
   isColorSupported: boolean;
   reset: Formatter;
   bold: Formatter;
@@ -135,12 +134,8 @@ interface Colors {
   bgMagentaBright: Formatter;
   bgCyanBright: Formatter;
   bgWhiteBright: Formatter;
-}
-//#endregion
-//#region ../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.d.ts
-declare const picocolors: Colors & {
-  createColors: (enabled?: boolean) => Colors;
 };
+declare const typedColors: Colors;
 //#endregion
 //#region src/copyDirToTmp.d.ts
 declare const copyDirToTmp: (dir: string, childDirname?: string) => Promise<{
@@ -398,7 +393,7 @@ declare function createCopiedBundleArchive({
     channel: string;
     storageUri: string;
     fileHash: string;
-    metadata: _$_hot_updater_core0.BundleMetadata | undefined;
+    metadata: import("@hot-updater/core").BundleMetadata | undefined;
     assetBaseStorageUri: string;
     patches: never[];
     patchBaseBundleId: null;
@@ -407,7 +402,7 @@ declare function createCopiedBundleArchive({
     patchBaseFileHash: null;
     patchFileHash: null;
     patchStorageUri: null;
-    platform: _$_hot_updater_core0.Platform;
+    platform: import("@hot-updater/core").Platform;
     shouldForceUpdate: boolean;
     enabled: boolean;
     gitCommitHash: string | null;
@@ -986,4 +981,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, ConfigBuilder, ConfigBuilderScaffold, ConfigResponse, CreateHotUpdaterConfigScaffoldFromBuilderOptions, CreateHotUpdaterConfigScaffoldOptions, HOT_UPDATER_SERVER_PACKAGE_VERSION_ENV, HotUpdateDirUtil, HotUpdaterConfigOptions, HotUpdaterConfigScaffold, HotUpdaterLogWriter, IConfigBuilder, ImportInfo, LEGACY_BUNDLE_ERROR, ManagedHelperStatement, ManagedHelperStrategy, PromoteBundleDependencies, PromoteBundleInput, PromptProgress, PromptSpinner, ProviderConfig, ReactNativeMetadata, ReadPackageUpResult, WriteHotUpdaterConfigResult, banner, picocolors as colors, copyDirToTmp, createCopiedBundleArchive, createHotUpdaterConfigScaffold, createHotUpdaterConfigScaffoldFromBuilder, createLogWriter, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, ensureInstallPackages, getAndroidSdkPath, getCwd, getPackageManager, getReactNativeMetadatas, link, loadConfig, log, makeEnv, index_d_exports as p, printBanner, promoteBundle, readPackageUp, renderImportStatements, resolveHotUpdaterServerVersion, resolvePackageVersion, stripAnsi, transformEnv, transformTemplate, writeHotUpdaterConfig };
+export { BuildLogger, BuildLoggerConfig, BuildType, ConfigBuilder, ConfigBuilderScaffold, ConfigResponse, CreateHotUpdaterConfigScaffoldFromBuilderOptions, CreateHotUpdaterConfigScaffoldOptions, HOT_UPDATER_SERVER_PACKAGE_VERSION_ENV, HotUpdateDirUtil, HotUpdaterConfigOptions, HotUpdaterConfigScaffold, HotUpdaterLogWriter, IConfigBuilder, ImportInfo, LEGACY_BUNDLE_ERROR, ManagedHelperStatement, ManagedHelperStrategy, PromoteBundleDependencies, PromoteBundleInput, PromptProgress, PromptSpinner, ProviderConfig, ReactNativeMetadata, ReadPackageUpResult, WriteHotUpdaterConfigResult, banner, typedColors as colors, copyDirToTmp, createCopiedBundleArchive, createHotUpdaterConfigScaffold, createHotUpdaterConfigScaffoldFromBuilder, createLogWriter, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, ensureInstallPackages, getAndroidSdkPath, getCwd, getPackageManager, getReactNativeMetadatas, link, loadConfig, log, makeEnv, index_d_exports as p, printBanner, promoteBundle, readPackageUp, renderImportStatements, resolveHotUpdaterServerVersion, resolvePackageVersion, stripAnsi, transformEnv, transformTemplate, writeHotUpdaterConfig };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./chunk-BEJ448es.mjs";
+import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./chunk-hT5z_Zn9.mjs";
 import { createRequire } from "node:module";
 import path, { dirname, parse } from "path";
 import { createInterface } from "readline";
@@ -105,6 +105,7 @@ var import_picocolors = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin((
 	module.exports = createColors();
 	module.exports.createColors = createColors;
 })))(), 1);
+const typedColors = import_picocolors.default;
 //#endregion
 //#region ../../node_modules/.pnpm/workspace-tools@0.36.4/node_modules/workspace-tools/lib/graph/getPackageDependencies.js
 var require_getPackageDependencies = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3017,6 +3018,9 @@ var require_constants$3 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		CHAR_VERTICAL_LINE: 124,
 		CHAR_ZERO_WIDTH_NOBREAK_SPACE: 65279,
 		SEP: path$12.sep,
+		/**
+		* Create EXTGLOB_CHARS
+		*/
 		extglobChars(chars) {
 			return {
 				"!": {
@@ -3046,6 +3050,9 @@ var require_constants$3 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				}
 			};
 		},
+		/**
+		* Create GLOB_CHARS
+		*/
 		globChars(win32) {
 			return win32 === true ? WINDOWS_CHARS : POSIX_CHARS;
 		}
@@ -18491,7 +18498,7 @@ var import_lib$1 = (/* @__PURE__ */ __commonJSMin(((exports) => {
 	__exportStar(require_listOfWorkspacePackageNames(), exports);
 	__exportStar(require_getAllPackageJsonFiles(), exports);
 })))();
-const getCwd = () => (0, import_lib$1.findPackageRoot)(process.cwd());
+const getCwd = () => (0, import_lib$1.findPackageRoot)(process.cwd()) ?? process.cwd();
 //#endregion
 //#region ../../node_modules/.pnpm/@clack+core@1.0.1/node_modules/@clack/core/dist/index.mjs
 var import_src = (/* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -19013,7 +19020,8 @@ var Vt$1 = class extends x$1 {
 			this.#s = e;
 			const s = this.options;
 			e ? this.filteredOptions = s.filter((n) => this.#i(e, n)) : this.filteredOptions = [...s];
-			this.#t = B(wt$1(this.focusedValue, this.filteredOptions), 0, this.filteredOptions);
+			const i = wt$1(this.focusedValue, this.filteredOptions);
+			this.#t = B(i, 0, this.filteredOptions);
 			const r = this.filteredOptions[this.#t];
 			r && !r.disabled ? this.focusedValue = r.value : this.focusedValue = void 0, this.multiple || (this.focusedValue !== void 0 ? this.toggleSelected(this.focusedValue) : this.deselectAll());
 		}
@@ -19052,7 +19060,10 @@ var yt$1 = class extends x$1 {
 		if (this.value === void 0 && (this.value = []), e.group === !0) {
 			const s = e.value, i = this.getGroupItems(s);
 			this.isGroupSelected(s) ? this.value = this.value.filter((r) => i.findIndex((n) => n.value === r) === -1) : this.value = [...this.value, ...i.map((r) => r.value)], this.value = Array.from(new Set(this.value));
-		} else this.value = this.value.includes(e.value) ? this.value.filter((i) => i !== e.value) : [...this.value, e.value];
+		} else {
+			const s = this.value.includes(e.value);
+			this.value = s ? this.value.filter((i) => i !== e.value) : [...this.value, e.value];
+		}
 	}
 	constructor(e) {
 		super(e, !1);
@@ -19097,17 +19108,19 @@ var Lt$1 = class extends x$1 {
 		return this.options.filter((e) => e.disabled !== !0);
 	}
 	toggleAll() {
-		const e = this._enabledOptions;
-		this.value = this.value !== void 0 && this.value.length === e.length ? [] : e.map((i) => i.value);
+		const e = this._enabledOptions, s = this.value !== void 0 && this.value.length === e.length;
+		this.value = s ? [] : e.map((i) => i.value);
 	}
 	toggleInvert() {
 		const e = this.value;
 		if (!e) return;
-		this.value = this._enabledOptions.filter((i) => !e.includes(i.value)).map((i) => i.value);
+		const s = this._enabledOptions.filter((i) => !e.includes(i.value));
+		this.value = s.map((i) => i.value);
 	}
 	toggleValue() {
 		this.value === void 0 && (this.value = []);
-		this.value = this.value.includes(this._value) ? this.value.filter((s) => s !== this._value) : [...this.value, this._value];
+		const e = this.value.includes(this._value);
+		this.value = e ? this.value.filter((s) => s !== this._value) : [...this.value, this._value];
 	}
 	constructor(e) {
 		super(e, !1), this.options = e.options, this.value = [...e.initialValues ?? []];
@@ -20516,6 +20529,7 @@ const resolveNextCompletedStage = ({ line, progressStages, completedStages }) =>
 	return nextCompletedStages;
 };
 var BuildLogger = class {
+	config;
 	state = createInitialState();
 	logWriter;
 	promptProgress;
@@ -20615,7 +20629,7 @@ var BuildLogger = class {
 	showLogFileLocation() {
 		if (!this.logWriter?.logFilePath) return;
 		const relativePath = path.relative(getCwd(), this.logWriter.logFilePath);
-		const highlightedPath = import_picocolors.default.blueBright(relativePath);
+		const highlightedPath = typedColors.blueBright(relativePath);
 		R.info(`Build log stored at ${highlightedPath}`);
 	}
 };
@@ -23823,8 +23837,10 @@ var Header = class {
 			this.devmaj = decNumber(buf, off + 329, 8) ?? 0;
 			this.devmin = decNumber(buf, off + 337, 8) ?? 0;
 			/* c8 ignore stop */
-			if (buf[off + 475] !== 0) this.path = decString(buf, off + 345, 155) + "/" + this.path;
-			else {
+			if (buf[off + 475] !== 0) {
+				const prefix = decString(buf, off + 345, 155);
+				this.path = prefix + "/" + this.path;
+			} else {
 				const prefix = decString(buf, off + 345, 130);
 				if (prefix) this.path = prefix + "/" + this.path;
 				this.atime = decDate(buf, off + 476, 12);
@@ -23993,7 +24009,9 @@ var Pax = class Pax {
 		const buf = Buffer.allocUnsafe(bufLen);
 		for (let i = 0; i < 512; i++) buf[i] = 0;
 		new Header({
+			/* c8 ignore start */
 			path: ("PaxHeader/" + basename(this.path ?? "")).slice(0, 99),
+			/* c8 ignore stop */
 			mode: this.mode || 420,
 			uid: this.uid,
 			gid: this.gid,
@@ -24406,6 +24424,7 @@ while (this[PROCESSENTRY](this[QUEUE$1].shift()));
 				ex.linkpath = this[META].replace(/\0.*/, "");
 				break;
 			}
+			/* c8 ignore start */
 			default: throw new Error("unknown meta: " + entry.type);
 		}
 	}
@@ -24542,6 +24561,7 @@ while (this[PROCESSENTRY](this[QUEUE$1].shift()));
 			case "meta":
 				position += this[CONSUMEMETA](chunk, position);
 				break;
+			/* c8 ignore start */
 			default: throw new Error("invalid state: " + this[STATE]);
 		}
 		if (position < length) if (this[BUFFER]) this[BUFFER] = Buffer.concat([chunk.subarray(position), this[BUFFER]]);
@@ -24848,6 +24868,7 @@ var WriteEntry = class extends Minipass {
 			gid: this.portable ? void 0 : this.stat.gid,
 			size: this.stat.size,
 			mtime: this.noMtime ? void 0 : this.mtime || this.stat.mtime,
+			/* c8 ignore next */
 			type: this.type === "Unsupported" ? void 0 : this.type,
 			uname: this.portable ? void 0 : this.stat.uid === this.myuid ? this.myuser : "",
 			atime: this.portable ? void 0 : this.stat.atime,
@@ -27478,7 +27499,8 @@ var require__stream_writable = /* @__PURE__ */ __commonJSMin(((exports, module)
 		this.ended = false;
 		this.finished = false;
 		this.destroyed = false;
-		this.decodeStrings = !(options.decodeStrings === false);
+		var noDecode = options.decodeStrings === false;
+		this.decodeStrings = !noDecode;
 		this.defaultEncoding = options.defaultEncoding || "utf8";
 		this.length = 0;
 		this.writing = false;
@@ -28964,7 +28986,18 @@ var require_base64 = /* @__PURE__ */ __commonJSMin(((exports) => {
 //#region ../../node_modules/.pnpm/jszip@3.10.1/node_modules/jszip/lib/nodejsUtils.js
 var require_nodejsUtils = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {
+		/**
+		* True if this is running in Nodejs, will be undefined in a browser.
+		* In a browser, browserify won't include this file and the whole module
+		* will be resolved an empty object.
+		*/
 		isNode: typeof Buffer !== "undefined",
+		/**
+		* Create a new nodejs Buffer from an existing content.
+		* @param {Object} data the data to pass to the constructor.
+		* @param {String} encoding the encoding to use.
+		* @return {Buffer} a new Buffer.
+		*/
 		newBufferFrom: function(data, encoding) {
 			if (Buffer.from && Buffer.from !== Uint8Array.from) return Buffer.from(data, encoding);
 			else {
@@ -28972,6 +29005,11 @@ var require_nodejsUtils = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				return new Buffer(data, encoding);
 			}
 		},
+		/**
+		* Create a new nodejs Buffer with the specified size.
+		* @param {Integer} size the size of the buffer.
+		* @return {Buffer} a new Buffer.
+		*/
 		allocBuffer: function(size) {
 			if (Buffer.alloc) return Buffer.alloc(size);
 			else {
@@ -28980,6 +29018,11 @@ var require_nodejsUtils = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				return buf;
 			}
 		},
+		/**
+		* Find out if an object is a Buffer.
+		* @param {Object} b the object to test.
+		* @return {Boolean} true if the object is a Buffer, false otherwise.
+		*/
 		isBuffer: function(b) {
 			return Buffer.isBuffer(b);
 		},
@@ -29472,6 +29515,15 @@ var require_utils = /* @__PURE__ */ __commonJSMin(((exports) => {
 	* can be optimized by the browser JIT compiler.
 	*/
 	var arrayToStringHelper = {
+		/**
+		* Transform an array of int into a string, chunk by chunk.
+		* See the performances notes on arrayLikeToString.
+		* @param {Array|ArrayBuffer|Uint8Array|Buffer} array the array to transform.
+		* @param {String} type the type of the array.
+		* @param {Integer} chunk the chunk size.
+		* @return {String} the resulting string.
+		* @throws Error if the chunk is too big for the stack.
+		*/
 		stringifyByChunk: function(array, type, chunk) {
 			var result = [], k = 0, len = array.length;
 			if (len <= chunk) return String.fromCharCode.apply(null, array);
@@ -29482,12 +29534,22 @@ var require_utils = /* @__PURE__ */ __commonJSMin(((exports) => {
 			}
 			return result.join("");
 		},
+		/**
+		* Call String.fromCharCode on every item in the array.
+		* This is the naive implementation, which generate A LOT of intermediate string.
+		* This should be used when everything else fail.
+		* @param {Array|ArrayBuffer|Uint8Array|Buffer} array the array to transform.
+		* @return {String} the result.
+		*/
 		stringifyByChar: function(array) {
 			var resultStr = "";
 			for (var i = 0; i < array.length; i++) resultStr += String.fromCharCode(array[i]);
 			return resultStr;
 		},
 		applyCanBeUsed: {
+			/**
+			* true if the browser accepts to use String.fromCharCode on Uint8Array
+			*/
 			uint8array: (function() {
 				try {
 					return support.uint8array && String.fromCharCode.apply(null, new Uint8Array(1)).length === 1;
@@ -29495,6 +29557,9 @@ var require_utils = /* @__PURE__ */ __commonJSMin(((exports) => {
 					return false;
 				}
 			})(),
+			/**
+			* true if the browser accepts to use String.fromCharCode on nodejs Buffer.
+			*/
 			nodebuffer: (function() {
 				try {
 					return support.nodebuffer && String.fromCharCode.apply(null, nodejsUtils.allocBuffer(1)).length === 1;
@@ -29771,9 +29836,17 @@ var require_GenericWorker = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 		this.previous = null;
 	}
 	GenericWorker.prototype = {
+		/**
+		* Push a chunk to the next workers.
+		* @param {Object} chunk the chunk to push
+		*/
 		push: function(chunk) {
 			this.emit("data", chunk);
 		},
+		/**
+		* End the stream.
+		* @return {Boolean} true if this call ended the worker, false otherwise.
+		*/
 		end: function() {
 			if (this.isFinished) return false;
 			this.flush();
@@ -29786,6 +29859,11 @@ var require_GenericWorker = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 			}
 			return true;
 		},
+		/**
+		* End the stream with an error.
+		* @param {Error} e the error which caused the premature end.
+		* @return {Boolean} true if this call ended the worker with an error, false otherwise.
+		*/
 		error: function(e) {
 			if (this.isFinished) return false;
 			if (this.isPaused) this.generatedError = e;
@@ -29797,20 +29875,47 @@ var require_GenericWorker = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 			}
 			return true;
 		},
+		/**
+		* Add a callback on an event.
+		* @param {String} name the name of the event (data, end, error)
+		* @param {Function} listener the function to call when the event is triggered
+		* @return {GenericWorker} the current object for chainability
+		*/
 		on: function(name, listener) {
 			this._listeners[name].push(listener);
 			return this;
 		},
+		/**
+		* Clean any references when a worker is ending.
+		*/
 		cleanUp: function() {
 			this.streamInfo = this.generatedError = this.extraStreamInfo = null;
 			this._listeners = [];
 		},
+		/**
+		* Trigger an event. This will call registered callback with the provided arg.
+		* @param {String} name the name of the event (data, end, error)
+		* @param {Object} arg the argument to call the callback with.
+		*/
 		emit: function(name, arg) {
 			if (this._listeners[name]) for (var i = 0; i < this._listeners[name].length; i++) this._listeners[name][i].call(this, arg);
 		},
+		/**
+		* Chain a worker with an other.
+		* @param {Worker} next the worker receiving events from the current one.
+		* @return {worker} the next worker for chainability
+		*/
 		pipe: function(next) {
 			return next.registerPrevious(this);
 		},
+		/**
+		* Same as `pipe` in the other direction.
+		* Using an API with `pipe(next)` is very easy.
+		* Implementing the API with the point of view of the next one registering
+		* a source is easier, see the ZipFileWorker.
+		* @param {Worker} previous the previous worker, sending events to this one
+		* @return {Worker} the current worker for chainability
+		*/
 		registerPrevious: function(previous) {
 			if (this.isLocked) throw new Error("The stream '" + this + "' has already been used.");
 			this.streamInfo = previous.streamInfo;
@@ -29828,12 +29933,20 @@ var require_GenericWorker = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 			});
 			return this;
 		},
+		/**
+		* Pause the stream so it doesn't send events anymore.
+		* @return {Boolean} true if this call paused the worker, false otherwise.
+		*/
 		pause: function() {
 			if (this.isPaused || this.isFinished) return false;
 			this.isPaused = true;
 			if (this.previous) this.previous.pause();
 			return true;
 		},
+		/**
+		* Resume a paused stream.
+		* @return {Boolean} true if this call resumed the worker, false otherwise.
+		*/
 		resume: function() {
 			if (!this.isPaused || this.isFinished) return false;
 			this.isPaused = false;
@@ -29845,26 +29958,50 @@ var require_GenericWorker = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 			if (this.previous) this.previous.resume();
 			return !withError;
 		},
+		/**
+		* Flush any remaining bytes as the stream is ending.
+		*/
 		flush: function() {},
+		/**
+		* Process a chunk. This is usually the method overridden.
+		* @param {Object} chunk the chunk to process.
+		*/
 		processChunk: function(chunk) {
 			this.push(chunk);
 		},
+		/**
+		* Add a key/value to be added in the workers chain streamInfo once activated.
+		* @param {String} key the key to use
+		* @param {Object} value the associated value
+		* @return {Worker} the current worker for chainability
+		*/
 		withStreamInfo: function(key, value) {
 			this.extraStreamInfo[key] = value;
 			this.mergeStreamInfo();
 			return this;
 		},
+		/**
+		* Merge this worker's streamInfo into the chain's streamInfo.
+		*/
 		mergeStreamInfo: function() {
 			for (var key in this.extraStreamInfo) {
 				if (!Object.prototype.hasOwnProperty.call(this.extraStreamInfo, key)) continue;
 				this.streamInfo[key] = this.extraStreamInfo[key];
 			}
 		},
+		/**
+		* Lock the stream to prevent further updates on the workers chain.
+		* After calling this method, all calls to pipe will fail.
+		*/
 		lock: function() {
 			if (this.isLocked) throw new Error("The stream '" + this + "' has already been used.");
 			this.isLocked = true;
 			if (this.previous) this.previous.lock();
 		},
+		/**
+		*
+		* Pretty print the workers chain.
+		*/
 		toString: function() {
 			var me = "Worker " + this.name;
 			if (this.previous) return this.previous + " -> " + me;
@@ -30234,9 +30371,21 @@ var require_StreamHelper = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		}
 	}
 	StreamHelper.prototype = {
+		/**
+		* Listen a StreamHelper, accumulate its content and concatenate it into a
+		* complete block.
+		* @param {Function} updateCb the update callback.
+		* @return Promise the promise for the accumulation.
+		*/
 		accumulate: function(updateCb) {
 			return accumulate(this, updateCb);
 		},
+		/**
+		* Add a listener on an event triggered on a stream.
+		* @param {String} evt the name of the event
+		* @param {Function} fn the listener
+		* @return {StreamHelper} the current helper.
+		*/
 		on: function(evt, fn) {
 			var self = this;
 			if (evt === "data") this._worker.on(evt, function(chunk) {
@@ -30247,14 +30396,27 @@ var require_StreamHelper = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			});
 			return this;
 		},
+		/**
+		* Resume the flow of chunks.
+		* @return {StreamHelper} the current helper.
+		*/
 		resume: function() {
 			utils.delay(this._worker.resume, [], this._worker);
 			return this;
 		},
+		/**
+		* Pause the flow of chunks.
+		* @return {StreamHelper} the current helper.
+		*/
 		pause: function() {
 			this._worker.pause();
 			return this;
 		},
+		/**
+		* Return a nodejs stream for this helper.
+		* @param {Function} updateCb the update callback.
+		* @return {NodejsStreamOutputAdapter} the nodejs stream.
+		*/
 		toNodejsStream: function(updateCb) {
 			utils.checkSupport("nodestream");
 			if (this._outputType !== "nodebuffer") throw new Error(this._outputType + " is not supported by this method");
@@ -30490,6 +30652,10 @@ var require_compressedObject = /* @__PURE__ */ __commonJSMin(((exports, module)
 		this.compressedContent = data;
 	}
 	CompressedObject.prototype = {
+		/**
+		* Create a worker to get the uncompressed content.
+		* @return {GenericWorker} the worker.
+		*/
 		getContentWorker: function() {
 			var worker = new DataWorker(external.Promise.resolve(this.compressedContent)).pipe(this.compression.uncompressWorker()).pipe(new DataLengthProbe("data_length"));
 			var that = this;
@@ -30498,6 +30664,10 @@ var require_compressedObject = /* @__PURE__ */ __commonJSMin(((exports, module)
 			});
 			return worker;
 		},
+		/**
+		* Create a worker to get the compressed content.
+		* @return {GenericWorker} the worker.
+		*/
 		getCompressedWorker: function() {
 			return new DataWorker(external.Promise.resolve(this.compressedContent)).withStreamInfo("compressedSize", this.compressedSize).withStreamInfo("uncompressedSize", this.uncompressedSize).withStreamInfo("crc32", this.crc32).withStreamInfo("compression", this.compression);
 		}
@@ -30545,6 +30715,11 @@ var require_zipObject = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		};
 	};
 	ZipObject.prototype = {
+		/**
+		* Create an internal stream for the content of this object.
+		* @param {String} type the type of each chunk.
+		* @return StreamHelper the stream.
+		*/
 		internalStream: function(type) {
 			var result = null, outputType = "string";
 			try {
@@ -30562,12 +30737,31 @@ var require_zipObject = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			return new StreamHelper(result, outputType, "");
 		},
+		/**
+		* Prepare the content in the asked type.
+		* @param {String} type the type of the result.
+		* @param {Function} onUpdate a function to call on each internal update.
+		* @return Promise the promise of the result.
+		*/
 		async: function(type, onUpdate) {
 			return this.internalStream(type).accumulate(onUpdate);
 		},
+		/**
+		* Prepare the content as a nodejs stream.
+		* @param {String} type the type of each chunk.
+		* @param {Function} onUpdate a function to call on each internal update.
+		* @return Stream the stream.
+		*/
 		nodeStream: function(type, onUpdate) {
 			return this.internalStream(type || "nodebuffer").toNodejsStream(onUpdate);
 		},
+		/**
+		* Return a worker for the compressed content.
+		* @private
+		* @param {Object} compression the compression object to use.
+		* @param {Object} compressionOptions the options to use when compressing.
+		* @return Worker the worker.
+		*/
 		_compressWorker: function(compression, compressionOptions) {
 			if (this._data instanceof CompressedObject && this._data.compression.magic === compression.magic) return this._data.getCompressedWorker();
 			else {
@@ -30576,6 +30770,11 @@ var require_zipObject = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				return CompressedObject.createWorkerFrom(result, compression, compressionOptions);
 			}
 		},
+		/**
+		* Return a worker for the decompressed content.
+		* @private
+		* @return Worker the worker.
+		*/
 		_decompressWorker: function() {
 			if (this._data instanceof CompressedObject) return this._data.getContentWorker();
 			else if (this._data instanceof GenericWorker) return this._data;
@@ -35115,9 +35314,18 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		return Object.prototype.toString.call(object) === "[object RegExp]";
 	}
 	module.exports = {
+		/**
+		* @see loadAsync
+		*/
 		load: function() {
 			throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.");
 		},
+		/**
+		* Call a callback function for each entry at this folder level.
+		* @param {Function} cb the callback function:
+		* function (relativePath, file) {...}
+		* It takes 2 arguments : the relative path and the file.
+		*/
 		forEach: function(cb) {
 			var filename, relativePath, file;
 			for (filename in this.files) {
@@ -35126,6 +35334,13 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				if (relativePath && filename.slice(0, this.root.length) === this.root) cb(relativePath, file);
 			}
 		},
+		/**
+		* Filter nested files/folders with the specified function.
+		* @param {Function} search the predicate to use :
+		* function (relativePath, file) {...}
+		* It takes 2 arguments : the relative path and the file.
+		* @return {Array} An array of matching elements.
+		*/
 		filter: function(search) {
 			var result = [];
 			this.forEach(function(relativePath, entry) {
@@ -35133,6 +35348,15 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			});
 			return result;
 		},
+		/**
+		* Add a file to the zip file, or search a file.
+		* @param   {string|RegExp} name The name of the file to add (if data is defined),
+		* the name of the file to find (if no data) or a regex to match files.
+		* @param   {String|ArrayBuffer|Uint8Array|Buffer} data  The file data, either raw or base64 encoded
+		* @param   {Object} o     File options
+		* @return  {JSZip|Object|Array} this JSZip object (when adding a file),
+		* a file (when searching by string) or an array of files (when searching by regex).
+		*/
 		file: function(name, data, o) {
 			if (arguments.length === 1) if (isRegExp(name)) {
 				var regexp = name;
@@ -35150,6 +35374,11 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			return this;
 		},
+		/**
+		* Add a directory to the zip file, or search.
+		* @param   {String|RegExp} arg The name of the directory to add, or a regex to search folders.
+		* @return  {JSZip} an object with the new directory as the root, or an array containing matching folders.
+		*/
 		folder: function(arg) {
 			if (!arg) return this;
 			if (isRegExp(arg)) return this.filter(function(relativePath, file) {
@@ -35161,6 +35390,11 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			ret.root = newFolder.name;
 			return ret;
 		},
+		/**
+		* Delete a file, or a directory and all sub-files, from the zip
+		* @param {string} name the name of the file to delete
+		* @return {JSZip} this JSZip object
+		*/
 		remove: function(name) {
 			name = this.root + name;
 			var file = this.files[name];
@@ -35177,9 +35411,19 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			return this;
 		},
+		/**
+		* @deprecated This method has been removed in JSZip 3.0, please check the upgrade guide.
+		*/
 		generate: function() {
 			throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.");
 		},
+		/**
+		* Generate the complete zip file as an internal stream.
+		* @param {Object} options the options to generate the zip file :
+		* - compression, "STORE" by default.
+		* - type, "base64" by default. Values are : string, base64, uint8array, arraybuffer, blob.
+		* @return {StreamHelper} the streamed zip file.
+		*/
 		generateInternalStream: function(options) {
 			var worker, opts = {};
 			try {
@@ -35208,9 +35452,17 @@ var require_object = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			return new StreamHelper(worker, opts.type || "string", opts.mimeType);
 		},
+		/**
+		* Generate the complete zip file asynchronously.
+		* @see generateInternalStream
+		*/
 		generateAsync: function(options, onUpdate) {
 			return this.generateInternalStream(options).accumulate(onUpdate);
 		},
+		/**
+		* Generate the complete zip file asynchronously.
+		* @see generateInternalStream
+		*/
 		generateNodeStream: function(options, onUpdate) {
 			options = options || {};
 			if (!options.type) options.type = "nodebuffer";
@@ -35229,20 +35481,50 @@ var require_DataReader = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		this.zero = 0;
 	}
 	DataReader.prototype = {
+		/**
+		* Check that the offset will not go too far.
+		* @param {string} offset the additional offset to check.
+		* @throws {Error} an Error if the offset is out of bounds.
+		*/
 		checkOffset: function(offset) {
 			this.checkIndex(this.index + offset);
 		},
+		/**
+		* Check that the specified index will not be too far.
+		* @param {string} newIndex the index to check.
+		* @throws {Error} an Error if the index is out of bounds.
+		*/
 		checkIndex: function(newIndex) {
 			if (this.length < this.zero + newIndex || newIndex < 0) throw new Error("End of data reached (data length = " + this.length + ", asked index = " + newIndex + "). Corrupted zip ?");
 		},
+		/**
+		* Change the index.
+		* @param {number} newIndex The new index.
+		* @throws {Error} if the new index is out of the data.
+		*/
 		setIndex: function(newIndex) {
 			this.checkIndex(newIndex);
 			this.index = newIndex;
 		},
+		/**
+		* Skip the next n bytes.
+		* @param {number} n the number of bytes to skip.
+		* @throws {Error} if the new index is out of the data.
+		*/
 		skip: function(n) {
 			this.setIndex(this.index + n);
 		},
+		/**
+		* Get the byte at the specified index.
+		* @param {number} i the index to use.
+		* @return {number} a byte.
+		*/
 		byteAt: function() {},
+		/**
+		* Get the next number with a given byte size.
+		* @param {number} size the number of bytes to read.
+		* @return {number} the corresponding number.
+		*/
 		readInt: function(size) {
 			var result = 0, i;
 			this.checkOffset(size);
@@ -35250,12 +35532,36 @@ var require_DataReader = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			this.index += size;
 			return result;
 		},
+		/**
+		* Get the next string with a given byte size.
+		* @param {number} size the number of bytes to read.
+		* @return {string} the corresponding string.
+		*/
 		readString: function(size) {
 			return utils.transformTo("string", this.readData(size));
 		},
+		/**
+		* Get raw data without conversion, <size> bytes.
+		* @param {number} size the number of bytes to read.
+		* @return {Object} the raw data, implementation specific.
+		*/
 		readData: function() {},
+		/**
+		* Find the last occurrence of a zip signature (4 bytes).
+		* @param {string} sig the signature to find.
+		* @return {number} the index of the last occurrence, -1 if not found.
+		*/
 		lastIndexOfSignature: function() {},
+		/**
+		* Read the signature (4 bytes) at the current position and compare it with sig.
+		* @param {string} sig the expected signature
+		* @return {boolean} true if the signature matches, false otherwise.
+		*/
 		readAndCheckSignature: function() {},
+		/**
+		* Get the next date.
+		* @return {Date} the date.
+		*/
 		readDate: function() {
 			var dostime = this.readInt(4);
 			return new Date(Date.UTC((dostime >> 25 & 127) + 1980, (dostime >> 21 & 15) - 1, dostime >> 16 & 31, dostime >> 11 & 31, dostime >> 5 & 63, (dostime & 31) << 1));
@@ -35443,12 +35749,24 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		this.loadOptions = loadOptions;
 	}
 	ZipEntry.prototype = {
+		/**
+		* say if the file is encrypted.
+		* @return {boolean} true if the file is encrypted, false otherwise.
+		*/
 		isEncrypted: function() {
 			return (this.bitFlag & 1) === 1;
 		},
+		/**
+		* say if the file has utf-8 filename/comment.
+		* @return {boolean} true if the filename/comment is in utf-8, false otherwise.
+		*/
 		useUTF8: function() {
 			return (this.bitFlag & 2048) === 2048;
 		},
+		/**
+		* Read the local part of a zip file and add the info in this object.
+		* @param {DataReader} reader the reader to use.
+		*/
 		readLocalPart: function(reader) {
 			var compression, localExtraFieldsLength;
 			reader.skip(22);
@@ -35461,6 +35779,10 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			if (compression === null) throw new Error("Corrupted zip : compression " + utils.pretty(this.compressionMethod) + " unknown (inner file : " + utils.transformTo("string", this.fileName) + ")");
 			this.decompressed = new CompressedObject(this.compressedSize, this.uncompressedSize, this.crc32, compression, reader.readData(this.compressedSize));
 		},
+		/**
+		* Read the central part of a zip file and add the info in this object.
+		* @param {DataReader} reader the reader to use.
+		*/
 		readCentralPart: function(reader) {
 			this.versionMadeBy = reader.readInt(2);
 			reader.skip(2);
@@ -35483,6 +35805,9 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			this.parseZIP64ExtraField(reader);
 			this.fileComment = reader.readData(this.fileCommentLength);
 		},
+		/**
+		* Parse the external file attributes and get the unix/dos permissions.
+		*/
 		processAttributes: function() {
 			this.unixPermissions = null;
 			this.dosPermissions = null;
@@ -35492,6 +35817,10 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			if (madeBy === MADE_BY_UNIX) this.unixPermissions = this.externalFileAttributes >> 16 & 65535;
 			if (!this.dir && this.fileNameStr.slice(-1) === "/") this.dir = true;
 		},
+		/**
+		* Parse the ZIP64 extra field and merge the info in the current ZipEntry.
+		* @param {DataReader} reader the reader to use.
+		*/
 		parseZIP64ExtraField: function() {
 			if (!this.extraFields[1]) return;
 			var extraReader = readerFor(this.extraFields[1].value);
@@ -35500,6 +35829,10 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			if (this.localHeaderOffset === utils.MAX_VALUE_32BITS) this.localHeaderOffset = extraReader.readInt(8);
 			if (this.diskNumberStart === utils.MAX_VALUE_32BITS) this.diskNumberStart = extraReader.readInt(4);
 		},
+		/**
+		* Read the central part of a zip file and add the info in this object.
+		* @param {DataReader} reader the reader to use.
+		*/
 		readExtraFields: function(reader) {
 			var end = reader.index + this.extraFieldsLength, extraFieldId, extraFieldLength, extraFieldValue;
 			if (!this.extraFields) this.extraFields = {};
@@ -35515,6 +35848,9 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			reader.setIndex(end);
 		},
+		/**
+		* Apply an UTF8 transformation if needed.
+		*/
 		handleUTF8: function() {
 			var decodeParamType = support.uint8array ? "uint8array" : "array";
 			if (this.useUTF8()) {
@@ -35535,6 +35871,10 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				}
 			}
 		},
+		/**
+		* Find the unicode path declared in the extra field, if any.
+		* @return {String} the unicode path, null otherwise.
+		*/
 		findExtraFieldUnicodePath: function() {
 			var upathField = this.extraFields[28789];
 			if (upathField) {
@@ -35545,6 +35885,10 @@ var require_zipEntry = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			return null;
 		},
+		/**
+		* Find the unicode comment declared in the extra field, if any.
+		* @return {String} the unicode comment, null otherwise.
+		*/
 		findExtraFieldUnicodeComment: function() {
 			var ucommentField = this.extraFields[25461];
 			if (ucommentField) {
@@ -35576,6 +35920,11 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		this.loadOptions = loadOptions;
 	}
 	ZipEntries.prototype = {
+		/**
+		* Check that the reader is on the specified signature.
+		* @param {string} expectedSignature the expected signature.
+		* @throws {Error} if it is an other signature.
+		*/
 		checkSignature: function(expectedSignature) {
 			if (!this.reader.readAndCheckSignature(expectedSignature)) {
 				this.reader.index -= 4;
@@ -35583,6 +35932,12 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				throw new Error("Corrupted zip or bug: unexpected signature (" + utils.pretty(signature) + ", expected " + utils.pretty(expectedSignature) + ")");
 			}
 		},
+		/**
+		* Check if the given signature is at the given index.
+		* @param {number} askedIndex the index to check.
+		* @param {string} expectedSignature the signature to expect.
+		* @return {boolean} true if the signature is here, false otherwise.
+		*/
 		isSignature: function(askedIndex, expectedSignature) {
 			var currentIndex = this.reader.index;
 			this.reader.setIndex(askedIndex);
@@ -35590,6 +35945,9 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			this.reader.setIndex(currentIndex);
 			return result;
 		},
+		/**
+		* Read the end of the central directory.
+		*/
 		readBlockEndOfCentral: function() {
 			this.diskNumber = this.reader.readInt(2);
 			this.diskWithCentralDirStart = this.reader.readInt(2);
@@ -35603,6 +35961,12 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			var decodeContent = utils.transformTo(decodeParamType, zipComment);
 			this.zipComment = this.loadOptions.decodeFileName(decodeContent);
 		},
+		/**
+		* Read the end of the Zip 64 central directory.
+		* Not merged with the method readEndOfCentral :
+		* The end of central can coexist with its Zip64 brother,
+		* I don't want to read the wrong number of bytes !
+		*/
 		readBlockZip64EndOfCentral: function() {
 			this.zip64EndOfCentralSize = this.reader.readInt(8);
 			this.reader.skip(4);
@@ -35625,12 +35989,18 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				};
 			}
 		},
+		/**
+		* Read the end of the Zip 64 central directory locator.
+		*/
 		readBlockZip64EndOfCentralLocator: function() {
 			this.diskWithZip64CentralDirStart = this.reader.readInt(4);
 			this.relativeOffsetEndOfZip64CentralDir = this.reader.readInt(8);
 			this.disksCount = this.reader.readInt(4);
 			if (this.disksCount > 1) throw new Error("Multi-volumes zip are not supported");
 		},
+		/**
+		* Read the local files, based on the offset read in the central part.
+		*/
 		readLocalFiles: function() {
 			var i, file;
 			for (i = 0; i < this.files.length; i++) {
@@ -35642,6 +36012,9 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				file.processAttributes();
 			}
 		},
+		/**
+		* Read the central directory.
+		*/
 		readCentralDir: function() {
 			var file;
 			this.reader.setIndex(this.centralDirOffset);
@@ -35654,6 +36027,9 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				if (this.centralDirRecords !== 0 && this.files.length === 0) throw new Error("Corrupted zip or bug: expected " + this.centralDirRecords + " records in central dir, got " + this.files.length);
 			}
 		},
+		/**
+		* Read the end of central directory.
+		*/
 		readEndOfCentral: function() {
 			var offset = this.reader.lastIndexOfSignature(sig.CENTRAL_DIRECTORY_END);
 			if (offset < 0) if (!this.isSignature(0, sig.LOCAL_FILE_HEADER)) throw new Error("Can't find end of central directory : is this a zip file ? If it is, see https://stuk.github.io/jszip/documentation/howto/read_zip.html");
@@ -35689,6 +36065,10 @@ var require_zipEntries = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		prepareReader: function(data) {
 			this.reader = readerFor(data);
 		},
+		/**
+		* Read a zip file and create ZipEntries.
+		* @param {String|ArrayBuffer|Uint8Array|Buffer} data the binary string representing a zip file.
+		*/
 		load: function(data) {
 			this.prepareReader(data);
 			this.readEndOfCentral();
@@ -43372,5 +43752,4 @@ function transformTemplate(templateString, values) {
 	return result;
 }
 //#endregion
-var colors = import_picocolors.default;
-export { BuildLogger, ConfigBuilder, HOT_UPDATER_SERVER_PACKAGE_VERSION_ENV, HotUpdateDirUtil, LEGACY_BUNDLE_ERROR, banner, colors, copyDirToTmp, createCopiedBundleArchive, createHotUpdaterConfigScaffold, createHotUpdaterConfigScaffoldFromBuilder, createLogWriter, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, ensureInstallPackages, getAndroidSdkPath, getCwd, getPackageManager, getReactNativeMetadatas, link, loadConfig, log, makeEnv, dist_exports as p, printBanner, promoteBundle, readPackageUp, renderImportStatements, resolveHotUpdaterServerVersion, resolvePackageVersion, stripAnsi, transformEnv, transformTemplate, writeHotUpdaterConfig };
+export { BuildLogger, ConfigBuilder, HOT_UPDATER_SERVER_PACKAGE_VERSION_ENV, HotUpdateDirUtil, LEGACY_BUNDLE_ERROR, banner, typedColors as colors, copyDirToTmp, createCopiedBundleArchive, createHotUpdaterConfigScaffold, createHotUpdaterConfigScaffoldFromBuilder, createLogWriter, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, ensureInstallPackages, getAndroidSdkPath, getCwd, getPackageManager, getReactNativeMetadatas, link, loadConfig, log, makeEnv, dist_exports as p, printBanner, promoteBundle, readPackageUp, renderImportStatements, resolveHotUpdaterServerVersion, resolvePackageVersion, stripAnsi, transformEnv, transformTemplate, writeHotUpdaterConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/cli-tools",
-  "version": "0.31.1",
+  "version": "0.31.3",
   "type": "module",
   "engines": {
     "node": ">=20.19.0"
@@ -46,8 +46,8 @@
     "oxc-transform": "0.121.0",
     "typescript": "6.0.2",
     "unconfig": "7.5.0",
-    "@hot-updater/core": "0.31.1",
-    "@hot-updater/plugin-core": "0.31.1"
+    "@hot-updater/plugin-core": "0.31.3",
+    "@hot-updater/core": "0.31.3"
   },
   "devDependencies": {
     "@clack/prompts": "1.0.1",
@@ -62,7 +62,7 @@
     "semver": "^7.6.3",
     "tar": "^7.5.1",
     "workspace-tools": "^0.36.4",
-    "@hot-updater/test-utils": "0.31.1"
+    "@hot-updater/test-utils": "0.31.3"
   },
   "inlinedDependencies": {
     "@babel/code-frame": "7.29.0",