@hot-updater/cli-tools 0.21.8

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+import { banner, link, printBanner } from "./banner.cjs";
+import { BuildType, ConfigBuilder, IConfigBuilder, ImportInfo, ProviderConfig } from "./ConfigBuilder.cjs";
+import { colors } from "./colors.cjs";
+import { copyDirToTmp } from "./copyDirToTmp.cjs";
+import { createTarBr, createTarBrTargetFiles } from "./createTarBr.cjs";
+import { createTarGz, createTarGzTargetFiles } from "./createTarGz.cjs";
+import { createZip, createZipTargetFiles } from "./createZip.cjs";
+import { decryptJson, encryptJson } from "./crypto.cjs";
+import { getCwd } from "./cwd.cjs";
+import { getAndroidSdkPath } from "./getAndroidSdkPath.cjs";
+import { ConfigResponse, HotUpdaterConfigOptions, loadConfig, loadConfigSync } from "./loadConfig.cjs";
+import { log } from "./log.cjs";
+import { makeEnv } from "./makeEnv.cjs";
+import { p } from "./prompts.cjs";
+import { transformEnv } from "./transformEnv.cjs";
+import { transformTemplate } from "./transformTemplate.cjs";
+export { BuildType, ConfigBuilder, ConfigResponse, HotUpdaterConfigOptions, IConfigBuilder, ImportInfo, ProviderConfig, banner, colors, copyDirToTmp, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, getAndroidSdkPath, getCwd, link, loadConfig, loadConfigSync, log, makeEnv, p, printBanner, transformEnv, transformTemplate };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { banner, link, printBanner } from "./banner.js";
+import { BuildType, ConfigBuilder, IConfigBuilder, ImportInfo, ProviderConfig } from "./ConfigBuilder.js";
+import { colors } from "./colors.js";
+import { copyDirToTmp } from "./copyDirToTmp.js";
+import { createTarBr, createTarBrTargetFiles } from "./createTarBr.js";
+import { createTarGz, createTarGzTargetFiles } from "./createTarGz.js";
+import { createZip, createZipTargetFiles } from "./createZip.js";
+import { decryptJson, encryptJson } from "./crypto.js";
+import { getCwd } from "./cwd.js";
+import { getAndroidSdkPath } from "./getAndroidSdkPath.js";
+import { ConfigResponse, HotUpdaterConfigOptions, loadConfig, loadConfigSync } from "./loadConfig.js";
+import { log } from "./log.js";
+import { makeEnv } from "./makeEnv.js";
+import { p } from "./prompts.js";
+import { transformEnv } from "./transformEnv.js";
+import { transformTemplate } from "./transformTemplate.js";
+export { BuildType, ConfigBuilder, ConfigResponse, HotUpdaterConfigOptions, IConfigBuilder, ImportInfo, ProviderConfig, banner, colors, copyDirToTmp, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, getAndroidSdkPath, getCwd, link, loadConfig, loadConfigSync, log, makeEnv, p, printBanner, transformEnv, transformTemplate };

package/dist/index.js

@@ -0,0 +1,18 @@
+import { banner, link, printBanner } from "./banner.js";
+import { ConfigBuilder } from "./ConfigBuilder.js";
+import { colors } from "./colors.js";
+import { getCwd } from "./cwd.js";
+import { copyDirToTmp } from "./copyDirToTmp.js";
+import { createTarBr, createTarBrTargetFiles } from "./createTarBr.js";
+import { createTarGz, createTarGzTargetFiles } from "./createTarGz.js";
+import { createZip, createZipTargetFiles } from "./createZip.js";
+import { decryptJson, encryptJson } from "./crypto.js";
+import { getAndroidSdkPath } from "./getAndroidSdkPath.js";
+import { loadConfig, loadConfigSync } from "./loadConfig.js";
+import { log } from "./log.js";
+import { makeEnv } from "./makeEnv.js";
+import { p } from "./prompts.js";
+import { transformEnv } from "./transformEnv.js";
+import { transformTemplate } from "./transformTemplate.js";
+
+export { ConfigBuilder, banner, colors, copyDirToTmp, createTarBr, createTarBrTargetFiles, createTarGz, createTarGzTargetFiles, createZip, createZipTargetFiles, decryptJson, encryptJson, getAndroidSdkPath, getCwd, link, loadConfig, loadConfigSync, log, makeEnv, p, printBanner, transformEnv, transformTemplate };

package/dist/isObject.cjs

@@ -0,0 +1,8 @@
+
+//#region src/isObject.ts
+const isObject = (value) => {
+	return !!value && value.constructor === Object;
+};
+
+//#endregion
+exports.isObject = isObject;

package/dist/isObject.js

@@ -0,0 +1,7 @@
+//#region src/isObject.ts
+const isObject = (value) => {
+	return !!value && value.constructor === Object;
+};
+
+//#endregion
+export { isObject };

package/dist/loadConfig.cjs

@@ -0,0 +1,100 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_cwd = require('./cwd.cjs');
+let path = require("path");
+path = require_rolldown_runtime.__toESM(path);
+let cosmiconfig = require("cosmiconfig");
+cosmiconfig = require_rolldown_runtime.__toESM(cosmiconfig);
+let cosmiconfig_typescript_loader = require("cosmiconfig-typescript-loader");
+cosmiconfig_typescript_loader = require_rolldown_runtime.__toESM(cosmiconfig_typescript_loader);
+let es_toolkit = require("es-toolkit");
+es_toolkit = require_rolldown_runtime.__toESM(es_toolkit);
+let fast_glob = require("fast-glob");
+fast_glob = require_rolldown_runtime.__toESM(fast_glob);
+
+//#region src/loadConfig.ts
+const getDefaultPlatformConfig = () => {
+	let infoPlistPaths = [];
+	try {
+		const plistFiles = fast_glob.default.sync("**/Info.plist", {
+			cwd: path.default.join(require_cwd.getCwd(), "ios"),
+			absolute: false,
+			onlyFiles: true,
+			ignore: [
+				"**/Pods/**",
+				"**/build/**",
+				"**/Build/**",
+				"**/*.app/**",
+				"**/*.xcarchive/**"
+			]
+		});
+		if (plistFiles.length > 0) infoPlistPaths = plistFiles.map((file) => `ios/${file}`);
+	} catch {}
+	let stringResourcePaths = [];
+	try {
+		const stringsFiles = fast_glob.default.sync(path.default.join("**", "strings.xml"), {
+			cwd: path.default.join(require_cwd.getCwd(), "android"),
+			absolute: false,
+			onlyFiles: true
+		});
+		if (stringsFiles.length > 0) stringResourcePaths = stringsFiles.map((file) => path.default.join("android", file));
+	} catch {}
+	return {
+		android: { stringResourcePaths },
+		ios: { infoPlistPaths }
+	};
+};
+const getDefaultConfig = () => {
+	return {
+		releaseChannel: "production",
+		updateStrategy: "appVersion",
+		compressStrategy: "zip",
+		fingerprint: { extraSources: [] },
+		console: { port: 1422 },
+		platform: getDefaultPlatformConfig(),
+		nativeBuild: { android: {
+			aab: true,
+			variant: "Release",
+			appModuleName: "app"
+		} },
+		build: () => {
+			throw new Error("build plugin is required");
+		},
+		storage: () => {
+			throw new Error("storage plugin is required");
+		},
+		database: () => {
+			throw new Error("database plugin is required");
+		}
+	};
+};
+const configOptions = {
+	stopDir: require_cwd.getCwd(),
+	searchPlaces: [
+		"hot-updater.config.js",
+		"hot-updater.config.cjs",
+		"hot-updater.config.ts",
+		"hot-updater.config.cts",
+		"hot-updater.config.cjs",
+		"hot-updater.config.mts"
+	],
+	ignoreEmptySearchPlaces: false,
+	loaders: {
+		".ts": (0, cosmiconfig_typescript_loader.TypeScriptLoader)(),
+		".mts": (0, cosmiconfig_typescript_loader.TypeScriptLoader)(),
+		".cts": (0, cosmiconfig_typescript_loader.TypeScriptLoader)()
+	}
+};
+const ensureConfig = (result, options) => {
+	const config = typeof result?.config === "function" ? result.config(options) : result?.config;
+	return (0, es_toolkit.merge)(getDefaultConfig(), config ?? {});
+};
+const loadConfig = async (options) => {
+	return ensureConfig(await (0, cosmiconfig.cosmiconfig)("hot-updater", configOptions).search(), options);
+};
+const loadConfigSync = (options) => {
+	return ensureConfig((0, cosmiconfig.cosmiconfigSync)("hot-updater", configOptions).search(), options);
+};
+
+//#endregion
+exports.loadConfig = loadConfig;
+exports.loadConfigSync = loadConfigSync;

package/dist/loadConfig.d.cts

@@ -0,0 +1,12 @@
+import { ConfigInput, Platform, RequiredDeep } from "@hot-updater/plugin-core";
+
+//#region src/loadConfig.d.ts
+type HotUpdaterConfigOptions = {
+  platform: Platform;
+  channel: string;
+} | null;
+type ConfigResponse = RequiredDeep<ConfigInput>;
+declare const loadConfig: (options: HotUpdaterConfigOptions) => Promise<ConfigResponse>;
+declare const loadConfigSync: (options: HotUpdaterConfigOptions) => ConfigResponse;
+//#endregion
+export { ConfigResponse, HotUpdaterConfigOptions, loadConfig, loadConfigSync };

package/dist/loadConfig.d.ts

@@ -0,0 +1,12 @@
+import { ConfigInput, Platform, RequiredDeep } from "@hot-updater/plugin-core";
+
+//#region src/loadConfig.d.ts
+type HotUpdaterConfigOptions = {
+  platform: Platform;
+  channel: string;
+} | null;
+type ConfigResponse = RequiredDeep<ConfigInput>;
+declare const loadConfig: (options: HotUpdaterConfigOptions) => Promise<ConfigResponse>;
+declare const loadConfigSync: (options: HotUpdaterConfigOptions) => ConfigResponse;
+//#endregion
+export { ConfigResponse, HotUpdaterConfigOptions, loadConfig, loadConfigSync };

package/dist/loadConfig.js

@@ -0,0 +1,93 @@
+import { getCwd } from "./cwd.js";
+import path from "path";
+import { cosmiconfig, cosmiconfigSync } from "cosmiconfig";
+import { TypeScriptLoader } from "cosmiconfig-typescript-loader";
+import { merge } from "es-toolkit";
+import fg from "fast-glob";
+
+//#region src/loadConfig.ts
+const getDefaultPlatformConfig = () => {
+	let infoPlistPaths = [];
+	try {
+		const plistFiles = fg.sync("**/Info.plist", {
+			cwd: path.join(getCwd(), "ios"),
+			absolute: false,
+			onlyFiles: true,
+			ignore: [
+				"**/Pods/**",
+				"**/build/**",
+				"**/Build/**",
+				"**/*.app/**",
+				"**/*.xcarchive/**"
+			]
+		});
+		if (plistFiles.length > 0) infoPlistPaths = plistFiles.map((file) => `ios/${file}`);
+	} catch {}
+	let stringResourcePaths = [];
+	try {
+		const stringsFiles = fg.sync(path.join("**", "strings.xml"), {
+			cwd: path.join(getCwd(), "android"),
+			absolute: false,
+			onlyFiles: true
+		});
+		if (stringsFiles.length > 0) stringResourcePaths = stringsFiles.map((file) => path.join("android", file));
+	} catch {}
+	return {
+		android: { stringResourcePaths },
+		ios: { infoPlistPaths }
+	};
+};
+const getDefaultConfig = () => {
+	return {
+		releaseChannel: "production",
+		updateStrategy: "appVersion",
+		compressStrategy: "zip",
+		fingerprint: { extraSources: [] },
+		console: { port: 1422 },
+		platform: getDefaultPlatformConfig(),
+		nativeBuild: { android: {
+			aab: true,
+			variant: "Release",
+			appModuleName: "app"
+		} },
+		build: () => {
+			throw new Error("build plugin is required");
+		},
+		storage: () => {
+			throw new Error("storage plugin is required");
+		},
+		database: () => {
+			throw new Error("database plugin is required");
+		}
+	};
+};
+const configOptions = {
+	stopDir: getCwd(),
+	searchPlaces: [
+		"hot-updater.config.js",
+		"hot-updater.config.cjs",
+		"hot-updater.config.ts",
+		"hot-updater.config.cts",
+		"hot-updater.config.cjs",
+		"hot-updater.config.mts"
+	],
+	ignoreEmptySearchPlaces: false,
+	loaders: {
+		".ts": TypeScriptLoader(),
+		".mts": TypeScriptLoader(),
+		".cts": TypeScriptLoader()
+	}
+};
+const ensureConfig = (result, options) => {
+	const config = typeof result?.config === "function" ? result.config(options) : result?.config;
+	return merge(getDefaultConfig(), config ?? {});
+};
+const loadConfig = async (options) => {
+	return ensureConfig(await cosmiconfig("hot-updater", configOptions).search(), options);
+};
+const loadConfigSync = (options) => {
+	return ensureConfig(cosmiconfigSync("hot-updater", configOptions).search(), options);
+};
+
+//#endregion
+export { loadConfig, loadConfigSync };

package/dist/log.cjs

@@ -0,0 +1,16 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let picocolors = require("picocolors");
+picocolors = require_rolldown_runtime.__toESM(picocolors);
+
+//#region src/log.ts
+const log = {
+	normal: (message) => console.log(message),
+	success: (message) => console.log(picocolors.default.green(message)),
+	info: (message) => console.log(picocolors.default.blue(message)),
+	error: (message) => console.log(picocolors.default.red(message)),
+	warn: (message) => console.log(picocolors.default.yellow(message)),
+	debug: (message) => console.log(picocolors.default.gray(message))
+};
+
+//#endregion
+exports.log = log;

package/dist/log.d.cts

@@ -0,0 +1,11 @@
+//#region src/log.d.ts
+declare const log: {
+  normal: (message: string | number | null | undefined) => void;
+  success: (message: string | number | null | undefined) => void;
+  info: (message: string | number | null | undefined) => void;
+  error: (message: string | number | null | undefined) => void;
+  warn: (message: string | number | null | undefined) => void;
+  debug: (message: string | number | null | undefined) => void;
+};
+//#endregion
+export { log };

package/dist/log.d.ts

@@ -0,0 +1,11 @@
+//#region src/log.d.ts
+declare const log: {
+  normal: (message: string | number | null | undefined) => void;
+  success: (message: string | number | null | undefined) => void;
+  info: (message: string | number | null | undefined) => void;
+  error: (message: string | number | null | undefined) => void;
+  warn: (message: string | number | null | undefined) => void;
+  debug: (message: string | number | null | undefined) => void;
+};
+//#endregion
+export { log };

package/dist/log.js

@@ -0,0 +1,14 @@
+import picocolors from "picocolors";
+
+//#region src/log.ts
+const log = {
+	normal: (message) => console.log(message),
+	success: (message) => console.log(picocolors.green(message)),
+	info: (message) => console.log(picocolors.blue(message)),
+	error: (message) => console.log(picocolors.red(message)),
+	warn: (message) => console.log(picocolors.yellow(message)),
+	debug: (message) => console.log(picocolors.gray(message))
+};
+
+//#endregion
+export { log };

package/dist/makeEnv.cjs

@@ -0,0 +1,57 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let fs_promises = require("fs/promises");
+fs_promises = require_rolldown_runtime.__toESM(fs_promises);
+
+//#region src/makeEnv.ts
+const makeEnv = async (newEnvVars, filePath = ".env.hotupdater") => {
+	try {
+		const existingContent = await fs_promises.default.readFile(filePath, "utf-8").catch(() => "");
+		const lines = existingContent ? existingContent.split("\n") : [];
+		const processedKeys = /* @__PURE__ */ new Set();
+		const updatedLines = [];
+		for (let i = 0; i < lines.length; i++) {
+			const line = lines[i] ?? "";
+			const trimmedLine = line.trim();
+			if (trimmedLine === "") {
+				updatedLines.push(line);
+				continue;
+			}
+			if (trimmedLine.startsWith("#")) {
+				if (i + 1 < lines.length) {
+					const nextLine = (lines[i + 1] ?? "").trim();
+					if (nextLine && !nextLine.startsWith("#") && nextLine.includes("=")) {
+						const [possibleKey = ""] = nextLine.split("=");
+						if (Object.hasOwn(newEnvVars, possibleKey.trim())) continue;
+					}
+				}
+				updatedLines.push(line);
+				continue;
+			}
+			if (trimmedLine.includes("=")) {
+				const [keyPart] = line.split("=");
+				const key = keyPart?.trim() ?? "";
+				if (Object.hasOwn(newEnvVars, key)) {
+					processedKeys.add(key);
+					const newValue = newEnvVars[key];
+					if (typeof newValue === "object" && newValue !== null) {
+						updatedLines.push(`# ${newValue.comment}`);
+						updatedLines.push(`${key}=${newValue.value}`);
+					} else updatedLines.push(`${key}=${newValue}`);
+				} else updatedLines.push(line);
+			} else updatedLines.push(line);
+		}
+		for (const [key, val] of Object.entries(newEnvVars)) if (!processedKeys.has(key)) if (typeof val === "object" && val !== null) {
+			updatedLines.push(`# ${val.comment}`);
+			updatedLines.push(`${key}=${val.value}`);
+		} else updatedLines.push(`${key}=${val}`);
+		const updatedContent = updatedLines.join("\n");
+		await fs_promises.default.writeFile(filePath, updatedContent, "utf-8");
+		return updatedContent;
+	} catch (error) {
+		console.error("Error while updating .env.hotupdater file:", error);
+		throw error;
+	}
+};
+
+//#endregion
+exports.makeEnv = makeEnv;

package/dist/makeEnv.d.cts

@@ -0,0 +1,8 @@
+//#region src/makeEnv.d.ts
+type EnvVarValue = string | {
+  comment: string;
+  value: string;
+};
+declare const makeEnv: (newEnvVars: Record<string, EnvVarValue>, filePath?: string) => Promise<string>;
+//#endregion
+export { makeEnv };

package/dist/makeEnv.d.ts

@@ -0,0 +1,8 @@
+//#region src/makeEnv.d.ts
+type EnvVarValue = string | {
+  comment: string;
+  value: string;
+};
+declare const makeEnv: (newEnvVars: Record<string, EnvVarValue>, filePath?: string) => Promise<string>;
+//#endregion
+export { makeEnv };

package/dist/makeEnv.js

@@ -0,0 +1,55 @@
+import fs from "fs/promises";
+
+//#region src/makeEnv.ts
+const makeEnv = async (newEnvVars, filePath = ".env.hotupdater") => {
+	try {
+		const existingContent = await fs.readFile(filePath, "utf-8").catch(() => "");
+		const lines = existingContent ? existingContent.split("\n") : [];
+		const processedKeys = /* @__PURE__ */ new Set();
+		const updatedLines = [];
+		for (let i = 0; i < lines.length; i++) {
+			const line = lines[i] ?? "";
+			const trimmedLine = line.trim();
+			if (trimmedLine === "") {
+				updatedLines.push(line);
+				continue;
+			}
+			if (trimmedLine.startsWith("#")) {
+				if (i + 1 < lines.length) {
+					const nextLine = (lines[i + 1] ?? "").trim();
+					if (nextLine && !nextLine.startsWith("#") && nextLine.includes("=")) {
+						const [possibleKey = ""] = nextLine.split("=");
+						if (Object.hasOwn(newEnvVars, possibleKey.trim())) continue;
+					}
+				}
+				updatedLines.push(line);
+				continue;
+			}
+			if (trimmedLine.includes("=")) {
+				const [keyPart] = line.split("=");
+				const key = keyPart?.trim() ?? "";
+				if (Object.hasOwn(newEnvVars, key)) {
+					processedKeys.add(key);
+					const newValue = newEnvVars[key];
+					if (typeof newValue === "object" && newValue !== null) {
+						updatedLines.push(`# ${newValue.comment}`);
+						updatedLines.push(`${key}=${newValue.value}`);
+					} else updatedLines.push(`${key}=${newValue}`);
+				} else updatedLines.push(line);
+			} else updatedLines.push(line);
+		}
+		for (const [key, val] of Object.entries(newEnvVars)) if (!processedKeys.has(key)) if (typeof val === "object" && val !== null) {
+			updatedLines.push(`# ${val.comment}`);
+			updatedLines.push(`${key}=${val.value}`);
+		} else updatedLines.push(`${key}=${val}`);
+		const updatedContent = updatedLines.join("\n");
+		await fs.writeFile(filePath, updatedContent, "utf-8");
+		return updatedContent;
+	} catch (error) {
+		console.error("Error while updating .env.hotupdater file:", error);
+		throw error;
+	}
+};
+
+//#endregion
+export { makeEnv };

package/dist/prompts.d.cts

@@ -0,0 +1,2 @@
+import * as p from "@clack/prompts";
+export { p };

package/dist/prompts.d.ts

@@ -0,0 +1,2 @@
+import * as p from "@clack/prompts";
+export { p };

package/dist/prompts.js

@@ -0,0 +1,3 @@
+import * as p from "@clack/prompts";
+
+export { p };

package/dist/transformEnv.cjs

@@ -0,0 +1,14 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let fs = require("fs");
+fs = require_rolldown_runtime.__toESM(fs);
+let oxc_transform = require("oxc-transform");
+oxc_transform = require_rolldown_runtime.__toESM(oxc_transform);
+
+//#region src/transformEnv.ts
+const transformEnv = (filename, env) => {
+	const code = fs.default.readFileSync(filename, "utf-8");
+	return (0, oxc_transform.transform)(filename, code, { define: Object.fromEntries(Object.entries(env).map(([key, value]) => [`HotUpdater.${key}`, JSON.stringify(value)])) })?.code || code;
+};
+
+//#endregion
+exports.transformEnv = transformEnv;

package/dist/transformEnv.d.cts

@@ -0,0 +1,4 @@
+//#region src/transformEnv.d.ts
+declare const transformEnv: <T extends Record<string, string>>(filename: string, env: T) => string;
+//#endregion
+export { transformEnv };

package/dist/transformEnv.d.ts

@@ -0,0 +1,4 @@
+//#region src/transformEnv.d.ts
+declare const transformEnv: <T extends Record<string, string>>(filename: string, env: T) => string;
+//#endregion
+export { transformEnv };

package/dist/transformEnv.js

@@ -0,0 +1,11 @@
+import fs from "fs";
+import { transform } from "oxc-transform";
+
+//#region src/transformEnv.ts
+const transformEnv = (filename, env) => {
+	const code = fs.readFileSync(filename, "utf-8");
+	return transform(filename, code, { define: Object.fromEntries(Object.entries(env).map(([key, value]) => [`HotUpdater.${key}`, JSON.stringify(value)])) })?.code || code;
+};
+
+//#endregion
+export { transformEnv };

package/dist/transformTemplate.cjs

@@ -0,0 +1,22 @@
+
+//#region src/transformTemplate.ts
+/**
+* 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.
+*
+* @example
+* const str = "Hello %%name%%, you are %%age%% years old."
+* const result = transformTemplate(str, { name: "John", age: "20" })
+* // Result: "Hello John, you are 20 years old."
+*/
+function transformTemplate(templateString, values) {
+	let result = templateString;
+	for (const key in values) {
+		const placeholder = `%%${key}%%`;
+		result = result.replace(new RegExp(placeholder, "g"), values[key]);
+	}
+	return result;
+}
+
+//#endregion
+exports.transformTemplate = transformTemplate;

package/dist/transformTemplate.d.cts

@@ -0,0 +1,15 @@
+//#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 };
+/**
+ * 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.
+ *
+ * @example
+ * const str = "Hello %%name%%, you are %%age%% years old."
+ * const result = transformTemplate(str, { name: "John", age: "20" })
+ * // Result: "Hello John, you are 20 years old."
+ */
+declare function transformTemplate<T extends string>(templateString: T, values: TransformTemplateArgs<T>): string;
+//#endregion
+export { transformTemplate };

package/dist/transformTemplate.d.ts

@@ -0,0 +1,15 @@
+//#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 };
+/**
+ * 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.
+ *
+ * @example
+ * const str = "Hello %%name%%, you are %%age%% years old."
+ * const result = transformTemplate(str, { name: "John", age: "20" })
+ * // Result: "Hello John, you are 20 years old."
+ */
+declare function transformTemplate<T extends string>(templateString: T, values: TransformTemplateArgs<T>): string;
+//#endregion
+export { transformTemplate };

package/dist/transformTemplate.js

@@ -0,0 +1,21 @@
+//#region src/transformTemplate.ts
+/**
+* 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.
+*
+* @example
+* const str = "Hello %%name%%, you are %%age%% years old."
+* const result = transformTemplate(str, { name: "John", age: "20" })
+* // Result: "Hello John, you are 20 years old."
+*/
+function transformTemplate(templateString, values) {
+	let result = templateString;
+	for (const key in values) {
+		const placeholder = `%%${key}%%`;
+		result = result.replace(new RegExp(placeholder, "g"), values[key]);
+	}
+	return result;
+}
+
+//#endregion
+export { transformTemplate };