@kodelyth/zalo 2026.5.39 → 2026.5.42

package/dist/setup-core-Dr75wK6l.js

@@ -0,0 +1,287 @@
+import { createAccountListHelpers, resolveMergedAccountConfig } from "klaw/plugin-sdk/account-helpers";
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "klaw/plugin-sdk/account-id";
+import { normalizeOptionalString } from "klaw/plugin-sdk/string-coerce-runtime";
+import { tryReadSecretFileSync } from "klaw/plugin-sdk/core";
+import { resolveAccountEntry } from "klaw/plugin-sdk/routing";
+import { buildSecretInputSchema, normalizeResolvedSecretInputString, normalizeSecretInputString } from "klaw/plugin-sdk/secret-input";
+import { DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$1, addWildcardAllowFrom, createDelegatedSetupWizardProxy, createPatchedAccountSetupAdapter, createSetupInputPresenceValidator, createSetupTranslator, formatDocsLink, mergeAllowFromEntries, normalizeAccountId as normalizeAccountId$1 } from "klaw/plugin-sdk/setup";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region extensions/zalo/src/token.ts
+function readTokenFromFile(tokenFile) {
+	return tryReadSecretFileSync(tokenFile, "Zalo token file", { rejectSymlink: true }) ?? "";
+}
+function resolveZaloToken(config, accountId, options) {
+	const resolvedAccountId = normalizeAccountId(accountId ?? config?.defaultAccount);
+	const isDefaultAccount = resolvedAccountId === DEFAULT_ACCOUNT_ID;
+	const baseConfig = config;
+	const accountConfig = resolveAccountEntry(baseConfig?.accounts, normalizeAccountId(resolvedAccountId));
+	const accountHasBotToken = Boolean(accountConfig && Object.prototype.hasOwnProperty.call(accountConfig, "botToken"));
+	if (accountConfig && accountHasBotToken) {
+		const token = options?.allowUnresolvedSecretRef ? normalizeSecretInputString(accountConfig.botToken) : normalizeResolvedSecretInputString({
+			value: accountConfig.botToken,
+			path: `channels.zalo.accounts.${resolvedAccountId}.botToken`
+		});
+		if (token) return {
+			token,
+			source: "config"
+		};
+		const fileToken = readTokenFromFile(accountConfig.tokenFile);
+		if (fileToken) return {
+			token: fileToken,
+			source: "configFile"
+		};
+	}
+	if (!accountHasBotToken) {
+		const fileToken = readTokenFromFile(accountConfig?.tokenFile);
+		if (fileToken) return {
+			token: fileToken,
+			source: "configFile"
+		};
+	}
+	if (!accountHasBotToken) {
+		const token = options?.allowUnresolvedSecretRef ? normalizeSecretInputString(baseConfig?.botToken) : normalizeResolvedSecretInputString({
+			value: baseConfig?.botToken,
+			path: "channels.zalo.botToken"
+		});
+		if (token) return {
+			token,
+			source: "config"
+		};
+		const fileToken = readTokenFromFile(baseConfig?.tokenFile);
+		if (fileToken) return {
+			token: fileToken,
+			source: "configFile"
+		};
+	}
+	if (isDefaultAccount) {
+		const envToken = process.env.ZALO_BOT_TOKEN?.trim();
+		if (envToken) return {
+			token: envToken,
+			source: "env"
+		};
+	}
+	return {
+		token: "",
+		source: "none"
+	};
+}
+//#endregion
+//#region extensions/zalo/src/accounts.ts
+var accounts_exports = /* @__PURE__ */ __exportAll({
+	listEnabledZaloAccounts: () => listEnabledZaloAccounts,
+	listZaloAccountIds: () => listZaloAccountIds,
+	resolveDefaultZaloAccountId: () => resolveDefaultZaloAccountId,
+	resolveZaloAccount: () => resolveZaloAccount
+});
+const { listAccountIds: listZaloAccountIds, resolveDefaultAccountId: resolveDefaultZaloAccountId } = createAccountListHelpers("zalo", { implicitDefaultAccount: {
+	channelKeys: ["botToken", "tokenFile"],
+	envVars: ["ZALO_BOT_TOKEN"]
+} });
+function mergeZaloAccountConfig(cfg, accountId) {
+	return resolveMergedAccountConfig({
+		channelConfig: cfg.channels?.zalo,
+		accounts: (cfg.channels?.zalo)?.accounts,
+		accountId,
+		omitKeys: ["defaultAccount"]
+	});
+}
+function resolveZaloAccount(params) {
+	const accountId = normalizeAccountId(params.accountId ?? (params.cfg.channels?.zalo)?.defaultAccount);
+	const baseEnabled = (params.cfg.channels?.zalo)?.enabled !== false;
+	const merged = mergeZaloAccountConfig(params.cfg, accountId);
+	const accountEnabled = merged.enabled !== false;
+	const enabled = baseEnabled && accountEnabled;
+	const tokenResolution = resolveZaloToken(params.cfg.channels?.zalo, accountId, { allowUnresolvedSecretRef: params.allowUnresolvedSecretRef });
+	return {
+		accountId,
+		name: normalizeOptionalString(merged.name),
+		enabled,
+		token: tokenResolution.token,
+		tokenSource: tokenResolution.source,
+		config: merged
+	};
+}
+function listEnabledZaloAccounts(cfg) {
+	return listZaloAccountIds(cfg).map((accountId) => resolveZaloAccount({
+		cfg,
+		accountId
+	})).filter((account) => account.enabled);
+}
+//#endregion
+//#region extensions/zalo/src/setup-allow-from.ts
+const t$1 = createSetupTranslator();
+async function noteZaloTokenHelp(prompter) {
+	await prompter.note([
+		t$1("wizard.zalo.helpOpenPlatform"),
+		t$1("wizard.zalo.helpCreateBot"),
+		t$1("wizard.zalo.helpTokenFormat"),
+		t$1("wizard.zalo.helpEnvTip"),
+		`Docs: ${formatDocsLink("/channels/zalo", "zalo")}`
+	].join("\n"), t$1("wizard.zalo.botTokenTitle"));
+}
+async function promptZaloAllowFrom(params) {
+	const { cfg, prompter } = params;
+	const accountId = params.accountId ?? resolveDefaultZaloAccountId(cfg);
+	const existingAllowFrom = resolveZaloAccount({
+		cfg,
+		accountId
+	}).config.allowFrom ?? [];
+	const unique = mergeAllowFromEntries(existingAllowFrom, [(await prompter.text({
+		message: t$1("wizard.zalo.allowFromPrompt"),
+		placeholder: "123456789",
+		initialValue: existingAllowFrom[0] ? String(existingAllowFrom[0]) : void 0,
+		validate: (value) => {
+			const raw = (value ?? "").trim();
+			if (!raw) return t$1("common.required");
+			if (!/^\d+$/.test(raw)) return t$1("wizard.zalo.allowFromNumeric");
+		}
+	})).trim()]);
+	if (accountId === DEFAULT_ACCOUNT_ID$1) return {
+		...cfg,
+		channels: {
+			...cfg.channels,
+			zalo: {
+				...cfg.channels?.zalo,
+				enabled: true,
+				dmPolicy: "allowlist",
+				allowFrom: unique
+			}
+		}
+	};
+	const currentAccount = cfg.channels?.zalo?.accounts?.[accountId];
+	return {
+		...cfg,
+		channels: {
+			...cfg.channels,
+			zalo: {
+				...cfg.channels?.zalo,
+				enabled: true,
+				accounts: {
+					...cfg.channels?.zalo?.accounts,
+					[accountId]: {
+						...currentAccount,
+						enabled: currentAccount?.enabled ?? true,
+						dmPolicy: "allowlist",
+						allowFrom: unique
+					}
+				}
+			}
+		}
+	};
+}
+//#endregion
+//#region extensions/zalo/src/setup-core.ts
+const t = createSetupTranslator();
+const channel = "zalo";
+const zaloSetupAdapter = createPatchedAccountSetupAdapter({
+	channelKey: channel,
+	validateInput: createSetupInputPresenceValidator({
+		defaultAccountOnlyEnvError: "ZALO_BOT_TOKEN can only be used for the default account.",
+		whenNotUseEnv: [{
+			someOf: ["token", "tokenFile"],
+			message: "Zalo requires token or --token-file (or --use-env)."
+		}]
+	}),
+	buildPatch: (input) => input.useEnv ? {} : input.tokenFile ? { tokenFile: input.tokenFile } : input.token ? { botToken: input.token } : {}
+});
+const zaloDmPolicy = {
+	label: "Zalo",
+	channel,
+	policyKey: "channels.zalo.dmPolicy",
+	allowFromKey: "channels.zalo.allowFrom",
+	resolveConfigKeys: (cfg, accountId) => (accountId ?? resolveDefaultZaloAccountId(cfg)) !== DEFAULT_ACCOUNT_ID$1 ? {
+		policyKey: `channels.zalo.accounts.${accountId ?? resolveDefaultZaloAccountId(cfg)}.dmPolicy`,
+		allowFromKey: `channels.zalo.accounts.${accountId ?? resolveDefaultZaloAccountId(cfg)}.allowFrom`
+	} : {
+		policyKey: "channels.zalo.dmPolicy",
+		allowFromKey: "channels.zalo.allowFrom"
+	},
+	getCurrent: (cfg, accountId) => resolveZaloAccount({
+		cfg,
+		accountId: accountId ?? resolveDefaultZaloAccountId(cfg)
+	}).config.dmPolicy ?? "pairing",
+	setPolicy: (cfg, policy, accountId) => {
+		const resolvedAccountId = accountId && normalizeAccountId$1(accountId) ? normalizeAccountId$1(accountId) ?? DEFAULT_ACCOUNT_ID$1 : resolveDefaultZaloAccountId(cfg);
+		const resolved = resolveZaloAccount({
+			cfg,
+			accountId: resolvedAccountId
+		});
+		if (resolvedAccountId === DEFAULT_ACCOUNT_ID$1) return {
+			...cfg,
+			channels: {
+				...cfg.channels,
+				zalo: {
+					...cfg.channels?.zalo,
+					enabled: true,
+					dmPolicy: policy,
+					...policy === "open" ? { allowFrom: addWildcardAllowFrom(resolved.config.allowFrom) } : {}
+				}
+			}
+		};
+		const currentAccount = cfg.channels?.zalo?.accounts?.[resolvedAccountId];
+		return {
+			...cfg,
+			channels: {
+				...cfg.channels,
+				zalo: {
+					...cfg.channels?.zalo,
+					enabled: true,
+					accounts: {
+						...cfg.channels?.zalo?.accounts,
+						[resolvedAccountId]: {
+							...currentAccount,
+							enabled: currentAccount?.enabled ?? true,
+							dmPolicy: policy,
+							...policy === "open" ? { allowFrom: addWildcardAllowFrom(resolved.config.allowFrom) } : {}
+						}
+					}
+				}
+			}
+		};
+	},
+	promptAllowFrom: async ({ cfg, prompter, accountId }) => promptZaloAllowFrom({
+		cfg,
+		prompter,
+		accountId: accountId ?? resolveDefaultZaloAccountId(cfg)
+	})
+};
+function createZaloSetupWizardProxy(loadWizard) {
+	return createDelegatedSetupWizardProxy({
+		channel,
+		loadWizard,
+		status: {
+			configuredLabel: t("wizard.channels.statusConfigured"),
+			unconfiguredLabel: t("wizard.channels.statusNeedsToken"),
+			configuredHint: t("wizard.channels.statusRecommendedConfigured"),
+			unconfiguredHint: t("wizard.channels.statusRecommendedNewcomerFriendly"),
+			configuredScore: 1,
+			unconfiguredScore: 10
+		},
+		credentials: [],
+		delegateFinalize: true,
+		dmPolicy: zaloDmPolicy,
+		disable: (cfg) => ({
+			...cfg,
+			channels: {
+				...cfg.channels,
+				zalo: {
+					...cfg.channels?.zalo,
+					enabled: false
+				}
+			}
+		})
+	});
+}
+//#endregion
+export { promptZaloAllowFrom as a, listZaloAccountIds as c, resolveZaloToken as d, buildSecretInputSchema as f, noteZaloTokenHelp as i, resolveDefaultZaloAccountId as l, zaloDmPolicy as n, accounts_exports as o, normalizeSecretInputString as p, zaloSetupAdapter as r, listEnabledZaloAccounts as s, createZaloSetupWizardProxy as t, resolveZaloAccount as u };

package/dist/setup-entry.js

@@ -0,0 +1,15 @@
+import { defineBundledChannelSetupEntry } from "klaw/plugin-sdk/channel-entry-contract";
+//#region extensions/zalo/setup-entry.ts
+var setup_entry_default = defineBundledChannelSetupEntry({
+	importMetaUrl: import.meta.url,
+	plugin: {
+		specifier: "./api.js",
+		exportName: "zaloPlugin"
+	},
+	secrets: {
+		specifier: "./secret-contract-api.js",
+		exportName: "channelSecrets"
+	}
+});
+//#endregion
+export { setup_entry_default as default };

package/dist/setup-surface-C8zxrnzG.js

@@ -0,0 +1,216 @@
+import { a as promptZaloAllowFrom, i as noteZaloTokenHelp, n as zaloDmPolicy, u as resolveZaloAccount } from "./setup-core-Dr75wK6l.js";
+import { DEFAULT_ACCOUNT_ID, buildSingleChannelSecretPromptState, createSetupTranslator, createStandardChannelSetupStatus, hasConfiguredSecretInput, promptSingleChannelSecretInput, runSingleChannelSecretStep } from "klaw/plugin-sdk/setup";
+//#region extensions/zalo/src/setup-surface.ts
+const t = createSetupTranslator();
+const channel = "zalo";
+function setZaloUpdateMode(cfg, accountId, mode, webhookUrl, webhookSecret, webhookPath) {
+	const isDefault = accountId === DEFAULT_ACCOUNT_ID;
+	if (mode === "polling") {
+		if (isDefault) {
+			const { webhookUrl: _url, webhookSecret: _secret, webhookPath: _path, ...rest } = cfg.channels?.zalo ?? {};
+			return {
+				...cfg,
+				channels: {
+					...cfg.channels,
+					zalo: rest
+				}
+			};
+		}
+		const accounts = { ...cfg.channels?.zalo?.accounts };
+		const { webhookUrl: _url, webhookSecret: _secret, webhookPath: _path, ...rest } = accounts[accountId] ?? {};
+		accounts[accountId] = rest;
+		return {
+			...cfg,
+			channels: {
+				...cfg.channels,
+				zalo: {
+					...cfg.channels?.zalo,
+					accounts
+				}
+			}
+		};
+	}
+	if (isDefault) return {
+		...cfg,
+		channels: {
+			...cfg.channels,
+			zalo: {
+				...cfg.channels?.zalo,
+				webhookUrl,
+				webhookSecret,
+				webhookPath
+			}
+		}
+	};
+	const accounts = { ...cfg.channels?.zalo?.accounts };
+	accounts[accountId] = {
+		...accounts[accountId],
+		webhookUrl,
+		webhookSecret,
+		webhookPath
+	};
+	return {
+		...cfg,
+		channels: {
+			...cfg.channels,
+			zalo: {
+				...cfg.channels?.zalo,
+				accounts
+			}
+		}
+	};
+}
+const zaloSetupWizard = {
+	channel,
+	status: createStandardChannelSetupStatus({
+		channelLabel: "Zalo",
+		configuredLabel: t("wizard.channels.statusConfigured"),
+		unconfiguredLabel: t("wizard.channels.statusNeedsToken"),
+		configuredHint: t("wizard.channels.statusRecommendedConfigured"),
+		unconfiguredHint: t("wizard.channels.statusRecommendedNewcomerFriendly"),
+		configuredScore: 1,
+		unconfiguredScore: 10,
+		includeStatusLine: true,
+		resolveConfigured: ({ cfg, accountId }) => {
+			const account = resolveZaloAccount({
+				cfg,
+				accountId,
+				allowUnresolvedSecretRef: true
+			});
+			return Boolean(account.token) || hasConfiguredSecretInput(account.config.botToken) || Boolean(account.config.tokenFile?.trim());
+		}
+	}),
+	credentials: [],
+	finalize: async ({ cfg, accountId, forceAllowFrom, options, prompter }) => {
+		let next = cfg;
+		const resolvedAccount = resolveZaloAccount({
+			cfg: next,
+			accountId,
+			allowUnresolvedSecretRef: true
+		});
+		const accountConfigured = Boolean(resolvedAccount.token);
+		const allowEnv = accountId === DEFAULT_ACCOUNT_ID;
+		const hasConfigToken = Boolean(hasConfiguredSecretInput(resolvedAccount.config.botToken) || resolvedAccount.config.tokenFile);
+		next = (await runSingleChannelSecretStep({
+			cfg: next,
+			prompter,
+			providerHint: "zalo",
+			credentialLabel: t("wizard.zalo.botToken"),
+			secretInputMode: options?.secretInputMode,
+			accountConfigured,
+			hasConfigToken,
+			allowEnv,
+			envValue: process.env.ZALO_BOT_TOKEN,
+			envPrompt: t("wizard.zalo.tokenEnvPrompt"),
+			keepPrompt: t("wizard.zalo.tokenKeep"),
+			inputPrompt: t("wizard.zalo.tokenInput"),
+			preferredEnvVar: "ZALO_BOT_TOKEN",
+			onMissingConfigured: async () => await noteZaloTokenHelp(prompter),
+			applyUseEnv: async (currentCfg) => accountId === DEFAULT_ACCOUNT_ID ? {
+				...currentCfg,
+				channels: {
+					...currentCfg.channels,
+					zalo: {
+						...currentCfg.channels?.zalo,
+						enabled: true
+					}
+				}
+			} : currentCfg,
+			applySet: async (currentCfg, value) => accountId === DEFAULT_ACCOUNT_ID ? {
+				...currentCfg,
+				channels: {
+					...currentCfg.channels,
+					zalo: {
+						...currentCfg.channels?.zalo,
+						enabled: true,
+						botToken: value
+					}
+				}
+			} : {
+				...currentCfg,
+				channels: {
+					...currentCfg.channels,
+					zalo: {
+						...currentCfg.channels?.zalo,
+						enabled: true,
+						accounts: {
+							...currentCfg.channels?.zalo?.accounts,
+							[accountId]: {
+								...currentCfg.channels?.zalo?.accounts?.[accountId],
+								enabled: true,
+								botToken: value
+							}
+						}
+					}
+				}
+			}
+		})).cfg;
+		if (await prompter.confirm({
+			message: t("wizard.zalo.webhookModePrompt"),
+			initialValue: Boolean(resolvedAccount.config.webhookUrl)
+		})) {
+			const webhookUrl = (await prompter.text({
+				message: t("wizard.zalo.webhookUrlPrompt"),
+				initialValue: resolvedAccount.config.webhookUrl,
+				validate: (value) => value?.trim()?.startsWith("https://") ? void 0 : "HTTPS URL required"
+			})).trim();
+			const defaultPath = (() => {
+				try {
+					return new URL(webhookUrl).pathname || "/zalo-webhook";
+				} catch {
+					return "/zalo-webhook";
+				}
+			})();
+			let webhookSecretResult = await promptSingleChannelSecretInput({
+				cfg: next,
+				prompter,
+				providerHint: "zalo-webhook",
+				credentialLabel: t("wizard.zalo.webhookSecret"),
+				secretInputMode: options?.secretInputMode,
+				...buildSingleChannelSecretPromptState({
+					accountConfigured: hasConfiguredSecretInput(resolvedAccount.config.webhookSecret),
+					hasConfigToken: hasConfiguredSecretInput(resolvedAccount.config.webhookSecret),
+					allowEnv: false
+				}),
+				envPrompt: "",
+				keepPrompt: t("wizard.zalo.webhookSecretKeep"),
+				inputPrompt: t("wizard.zalo.webhookSecretInput"),
+				preferredEnvVar: "ZALO_WEBHOOK_SECRET"
+			});
+			while (webhookSecretResult.action === "set" && typeof webhookSecretResult.value === "string" && (webhookSecretResult.value.length < 8 || webhookSecretResult.value.length > 256)) {
+				await prompter.note(t("wizard.zalo.webhookSecretLength"), t("wizard.zalo.webhookTitle"));
+				webhookSecretResult = await promptSingleChannelSecretInput({
+					cfg: next,
+					prompter,
+					providerHint: "zalo-webhook",
+					credentialLabel: t("wizard.zalo.webhookSecret"),
+					secretInputMode: options?.secretInputMode,
+					...buildSingleChannelSecretPromptState({
+						accountConfigured: false,
+						hasConfigToken: false,
+						allowEnv: false
+					}),
+					envPrompt: "",
+					keepPrompt: t("wizard.zalo.webhookSecretKeep"),
+					inputPrompt: t("wizard.zalo.webhookSecretInput"),
+					preferredEnvVar: "ZALO_WEBHOOK_SECRET"
+				});
+			}
+			const webhookSecret = webhookSecretResult.action === "set" ? webhookSecretResult.value : resolvedAccount.config.webhookSecret;
+			const webhookPath = (await prompter.text({
+				message: t("wizard.zalo.webhookPathPrompt"),
+				initialValue: resolvedAccount.config.webhookPath ?? defaultPath
+			})).trim();
+			next = setZaloUpdateMode(next, accountId, "webhook", webhookUrl, webhookSecret, webhookPath || void 0);
+		} else next = setZaloUpdateMode(next, accountId, "polling");
+		if (forceAllowFrom) next = await promptZaloAllowFrom({
+			cfg: next,
+			prompter,
+			accountId
+		});
+		return { cfg: next };
+	},
+	dmPolicy: zaloDmPolicy
+};
+//#endregion
+export { zaloSetupWizard };

package/dist/test-api.js

@@ -0,0 +1,2 @@
+import { n as resolveZaloRuntimeGroupPolicy } from "./group-access-DTQVR6Nd.js";
+export { resolveZaloRuntimeGroupPolicy };

package/index.test.ts

@@ -0,0 +1,15 @@
+import { assertBundledChannelEntries } from "klaw/plugin-sdk/channel-test-helpers";
+import { describe } from "vitest";
+import entry from "./index.js";
+import setupEntry from "./setup-entry.js";
+
+describe("zalo bundled entries", () => {
+  assertBundledChannelEntries({
+    entry,
+    expectedId: "zalo",
+    expectedName: "Zalo",
+    setupEntry,
+    channelMessage: "declares the channel plugin without a runtime-barrel cycle",
+    setupMessage: "declares the setup plugin without a runtime-barrel cycle",
+  });
+});

package/index.ts

@@ -0,0 +1,20 @@
+import { defineBundledChannelEntry } from "klaw/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelEntry({
+  id: "zalo",
+  name: "Zalo",
+  description: "Zalo channel plugin",
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./channel-plugin-api.js",
+    exportName: "zaloPlugin",
+  },
+  secrets: {
+    specifier: "./secret-contract-api.js",
+    exportName: "channelSecrets",
+  },
+  runtime: {
+    specifier: "./runtime-api.js",
+    exportName: "setZaloRuntime",
+  },
+});