@better-zap/cli 0.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Better Zap
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @better-zap/cli
+
+CLI helpers for Better Zap template generation.

package/dist/cli.cjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_template_generator = require("./template-generator-CQM-kLEi.cjs");
+let node_url = require("node:url");
+let node_process = require("node:process");
+node_process = require_template_generator.__toESM(node_process);
+//#region src/cli.ts
+function shouldPrintHelp(command, flags) {
+	return !command || command === "--help" || command === "-h" || Boolean(flags.help);
+}
+async function runCli(argv = node_process.default.argv.slice(2)) {
+	const { command, flags } = require_template_generator.parseCliArgs(argv);
+	const wantsHelp = shouldPrintHelp(command, flags);
+	if (!command || wantsHelp) {
+		printHelp();
+		return;
+	}
+	if (command !== "generate") throw new Error(`[better-zap] Unknown command "${command}". Supported commands: generate.`);
+	const options = await require_template_generator.resolveGenerateOptions({
+		cwd: node_process.default.cwd(),
+		env: node_process.default.env,
+		flags
+	});
+	const result = await require_template_generator.runGenerateCommand(options);
+	if (options.check) {
+		console.log(`[better-zap] ${result.output} is up to date (${result.templateCount} templates).`);
+		return;
+	}
+	console.log(`[better-zap] Generated ${result.templateCount} templates at ${result.output}.`);
+}
+function printHelp() {
+	console.log(`better-zap
+
+Usage:
+  better-zap generate [--access-token <token>] [--waba-id <id>] [--output <path>] [--api-version <version>] [--check]
+
+Options:
+  --access-token   Meta access token. Falls back to WHATSAPP_TOKEN or META_ACCESS_TOKEN.
+  --waba-id        WhatsApp Business Account ID. Falls back to WHATSAPP_BUSINESS_ACCOUNT_ID.
+  --output         Output path for the generated registry file.
+  --api-version    Graph API version. Defaults to v25.0.
+  --config         Optional config file path. Also auto-discovers better-zap.config.(mjs|js|json).
+  --check          Validate that the generated file is already up to date.
+  --help           Show this help message.
+`);
+}
+const entrypoint = node_process.default.argv[1];
+if (entrypoint && require("url").pathToFileURL(__filename).href === (0, node_url.pathToFileURL)(entrypoint).href) runCli().catch((error) => {
+	const message = error instanceof Error ? error.message : String(error);
+	console.error(message);
+	node_process.default.exitCode = 1;
+});
+//#endregion
+exports.runCli = runCli;
+exports.shouldPrintHelp = shouldPrintHelp;

package/dist/cli.d.cts

@@ -0,0 +1,5 @@
+//#region src/cli.d.ts
+declare function shouldPrintHelp(command: string | undefined, flags: Record<string, boolean | string>): boolean;
+declare function runCli(argv?: string[]): Promise<void>;
+//#endregion
+export { runCli, shouldPrintHelp };

package/dist/cli.d.mts

@@ -0,0 +1,5 @@
+//#region src/cli.d.ts
+declare function shouldPrintHelp(command: string | undefined, flags: Record<string, boolean | string>): boolean;
+declare function runCli(argv?: string[]): Promise<void>;
+//#endregion
+export { runCli, shouldPrintHelp };

package/dist/cli.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { a as resolveGenerateOptions, i as parseCliArgs, o as runGenerateCommand } from "./template-generator-DQI3p1ce.mjs";
+import { pathToFileURL } from "node:url";
+import process from "node:process";
+//#region src/cli.ts
+function shouldPrintHelp(command, flags) {
+	return !command || command === "--help" || command === "-h" || Boolean(flags.help);
+}
+async function runCli(argv = process.argv.slice(2)) {
+	const { command, flags } = parseCliArgs(argv);
+	const wantsHelp = shouldPrintHelp(command, flags);
+	if (!command || wantsHelp) {
+		printHelp();
+		return;
+	}
+	if (command !== "generate") throw new Error(`[better-zap] Unknown command "${command}". Supported commands: generate.`);
+	const options = await resolveGenerateOptions({
+		cwd: process.cwd(),
+		env: process.env,
+		flags
+	});
+	const result = await runGenerateCommand(options);
+	if (options.check) {
+		console.log(`[better-zap] ${result.output} is up to date (${result.templateCount} templates).`);
+		return;
+	}
+	console.log(`[better-zap] Generated ${result.templateCount} templates at ${result.output}.`);
+}
+function printHelp() {
+	console.log(`better-zap
+
+Usage:
+  better-zap generate [--access-token <token>] [--waba-id <id>] [--output <path>] [--api-version <version>] [--check]
+
+Options:
+  --access-token   Meta access token. Falls back to WHATSAPP_TOKEN or META_ACCESS_TOKEN.
+  --waba-id        WhatsApp Business Account ID. Falls back to WHATSAPP_BUSINESS_ACCOUNT_ID.
+  --output         Output path for the generated registry file.
+  --api-version    Graph API version. Defaults to v25.0.
+  --config         Optional config file path. Also auto-discovers better-zap.config.(mjs|js|json).
+  --check          Validate that the generated file is already up to date.
+  --help           Show this help message.
+`);
+}
+const entrypoint = process.argv[1];
+if (entrypoint && import.meta.url === pathToFileURL(entrypoint).href) runCli().catch((error) => {
+	const message = error instanceof Error ? error.message : String(error);
+	console.error(message);
+	process.exitCode = 1;
+});
+//#endregion
+export { runCli, shouldPrintHelp };

package/dist/index.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_template_generator = require("./template-generator-CQM-kLEi.cjs");
+exports.fetchAllMetaTemplates = require_template_generator.fetchAllMetaTemplates;
+exports.generateTemplateRegistryFileContent = require_template_generator.generateTemplateRegistryFileContent;
+exports.normalizeMetaTemplates = require_template_generator.normalizeMetaTemplates;
+exports.parseCliArgs = require_template_generator.parseCliArgs;
+exports.resolveGenerateOptions = require_template_generator.resolveGenerateOptions;
+exports.runGenerateCommand = require_template_generator.runGenerateCommand;
+exports.writeGeneratedTemplateFile = require_template_generator.writeGeneratedTemplateFile;

package/dist/index.d.cts

@@ -0,0 +1,75 @@
+import { TemplateRegistry } from "better-zap";
+
+//#region src/template-generator.d.ts
+type CliFlagValue = boolean | string;
+type CliFlags = Record<string, CliFlagValue>;
+type GenerateOptions = {
+  accessToken?: string;
+  apiVersion?: string;
+  check?: boolean;
+  fetchImpl?: typeof fetch;
+  output: string;
+  wabaId?: string;
+};
+type ResolveGenerateOptionsInput = {
+  cwd: string;
+  env: NodeJS.ProcessEnv;
+  flags: CliFlags;
+};
+type MetaTemplateButton = {
+  type?: string;
+  phone_number?: string;
+  text?: string;
+  url?: string;
+};
+type MetaTemplateComponent = {
+  type?: string;
+  format?: string;
+  text?: string;
+  url?: string;
+  buttons?: MetaTemplateButton[];
+};
+type MetaTemplate = {
+  name?: string;
+  language?: string;
+  components?: MetaTemplateComponent[];
+};
+declare function parseCliArgs(argv: string[]): {
+  command: string | undefined;
+  flags: CliFlags;
+};
+declare function resolveGenerateOptions({
+  cwd,
+  env,
+  flags
+}: ResolveGenerateOptionsInput): Promise<GenerateOptions>;
+declare function fetchAllMetaTemplates({
+  accessToken,
+  apiVersion,
+  fetchImpl,
+  wabaId
+}: Required<Pick<GenerateOptions, "accessToken" | "wabaId">> & Pick<GenerateOptions, "apiVersion" | "fetchImpl">): Promise<MetaTemplate[]>;
+declare function normalizeMetaTemplates(metaTemplates: MetaTemplate[]): TemplateRegistry;
+declare function generateTemplateRegistryFileContent(registry: TemplateRegistry): string;
+declare function writeGeneratedTemplateFile({
+  check,
+  content,
+  output
+}: {
+  check?: boolean;
+  content: string;
+  output: string;
+}): Promise<void>;
+declare function runGenerateCommand({
+  accessToken,
+  apiVersion,
+  check,
+  fetchImpl,
+  output,
+  wabaId
+}: GenerateOptions): Promise<{
+  output: string;
+  templateCount: number;
+}>;
+//#endregion
+export { fetchAllMetaTemplates, generateTemplateRegistryFileContent, normalizeMetaTemplates, parseCliArgs, resolveGenerateOptions, runGenerateCommand, writeGeneratedTemplateFile };

package/dist/index.d.mts

@@ -0,0 +1,75 @@
+import { TemplateRegistry } from "better-zap";
+
+//#region src/template-generator.d.ts
+type CliFlagValue = boolean | string;
+type CliFlags = Record<string, CliFlagValue>;
+type GenerateOptions = {
+  accessToken?: string;
+  apiVersion?: string;
+  check?: boolean;
+  fetchImpl?: typeof fetch;
+  output: string;
+  wabaId?: string;
+};
+type ResolveGenerateOptionsInput = {
+  cwd: string;
+  env: NodeJS.ProcessEnv;
+  flags: CliFlags;
+};
+type MetaTemplateButton = {
+  type?: string;
+  phone_number?: string;
+  text?: string;
+  url?: string;
+};
+type MetaTemplateComponent = {
+  type?: string;
+  format?: string;
+  text?: string;
+  url?: string;
+  buttons?: MetaTemplateButton[];
+};
+type MetaTemplate = {
+  name?: string;
+  language?: string;
+  components?: MetaTemplateComponent[];
+};
+declare function parseCliArgs(argv: string[]): {
+  command: string | undefined;
+  flags: CliFlags;
+};
+declare function resolveGenerateOptions({
+  cwd,
+  env,
+  flags
+}: ResolveGenerateOptionsInput): Promise<GenerateOptions>;
+declare function fetchAllMetaTemplates({
+  accessToken,
+  apiVersion,
+  fetchImpl,
+  wabaId
+}: Required<Pick<GenerateOptions, "accessToken" | "wabaId">> & Pick<GenerateOptions, "apiVersion" | "fetchImpl">): Promise<MetaTemplate[]>;
+declare function normalizeMetaTemplates(metaTemplates: MetaTemplate[]): TemplateRegistry;
+declare function generateTemplateRegistryFileContent(registry: TemplateRegistry): string;
+declare function writeGeneratedTemplateFile({
+  check,
+  content,
+  output
+}: {
+  check?: boolean;
+  content: string;
+  output: string;
+}): Promise<void>;
+declare function runGenerateCommand({
+  accessToken,
+  apiVersion,
+  check,
+  fetchImpl,
+  output,
+  wabaId
+}: GenerateOptions): Promise<{
+  output: string;
+  templateCount: number;
+}>;
+//#endregion
+export { fetchAllMetaTemplates, generateTemplateRegistryFileContent, normalizeMetaTemplates, parseCliArgs, resolveGenerateOptions, runGenerateCommand, writeGeneratedTemplateFile };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as resolveGenerateOptions, i as parseCliArgs, n as generateTemplateRegistryFileContent, o as runGenerateCommand, r as normalizeMetaTemplates, s as writeGeneratedTemplateFile, t as fetchAllMetaTemplates } from "./template-generator-DQI3p1ce.mjs";
+export { fetchAllMetaTemplates, generateTemplateRegistryFileContent, normalizeMetaTemplates, parseCliArgs, resolveGenerateOptions, runGenerateCommand, writeGeneratedTemplateFile };

package/dist/template-generator-CQM-kLEi.cjs

@@ -0,0 +1,307 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let node_url = require("node:url");
+//#region src/template-generator.ts
+const DEFAULT_API_VERSION = "v25.0";
+const DEFAULT_CONFIG_FILES = [
+	"better-zap.config.mjs",
+	"better-zap.config.js",
+	"better-zap.config.json"
+];
+function parseCliArgs(argv) {
+	const args = [...argv];
+	const command = args.shift();
+	const flags = {};
+	while (args.length > 0) {
+		const current = args.shift();
+		if (!current?.startsWith("--")) continue;
+		const flagName = current.slice(2);
+		const next = args[0];
+		if (!next || next.startsWith("--")) {
+			flags[flagName] = true;
+			continue;
+		}
+		const value = args.shift();
+		if (value) flags[flagName] = value;
+	}
+	return {
+		command,
+		flags
+	};
+}
+async function resolveGenerateOptions({ cwd, env, flags }) {
+	const configPath = typeof flags.config === "string" ? node_path.default.resolve(cwd, flags.config) : await findDefaultConfigPath(cwd);
+	const fileConfig = configPath ? await loadConfigFile(configPath) : {};
+	const templatesConfig = fileConfig.templates ?? fileConfig.whatsappTemplates ?? fileConfig;
+	const outputValue = firstDefined(asString(flags.output), templatesConfig.output, env.BETTER_ZAP_TEMPLATE_OUTPUT) ?? "";
+	const output = outputValue ? node_path.default.resolve(cwd, outputValue) : "";
+	return {
+		accessToken: firstDefined(asString(flags["access-token"]), templatesConfig.accessToken, env.WHATSAPP_TOKEN, env.META_ACCESS_TOKEN),
+		wabaId: firstDefined(asString(flags["waba-id"]), templatesConfig.wabaId, env.WHATSAPP_BUSINESS_ACCOUNT_ID),
+		apiVersion: firstDefined(asString(flags["api-version"]), templatesConfig.apiVersion, DEFAULT_API_VERSION),
+		output,
+		check: Boolean(flags.check)
+	};
+}
+async function fetchAllMetaTemplates({ accessToken, apiVersion, fetchImpl = fetch, wabaId }) {
+	let nextUrl = `https://graph.facebook.com/${apiVersion ?? DEFAULT_API_VERSION}/${wabaId}/message_templates?limit=100`;
+	const templates = [];
+	while (nextUrl) {
+		const response = await fetchImpl(nextUrl, { headers: { Authorization: `Bearer ${accessToken}` } });
+		if (!response.ok) {
+			const errorPayload = await response.json().catch(() => ({ error: { message: `HTTP ${response.status}` } }));
+			throw new Error(`[better-zap generate] Meta request failed: ${errorPayload.error?.message ?? `HTTP ${response.status}`}`);
+		}
+		const payload = await response.json();
+		templates.push(...payload.data ?? []);
+		nextUrl = payload.paging?.next ?? null;
+	}
+	return templates;
+}
+function normalizeMetaTemplates(metaTemplates) {
+	const normalizedEntries = metaTemplates.map((template) => [template.name, normalizeMetaTemplate(template)]).sort(([left], [right]) => (left ?? "").localeCompare(right ?? ""));
+	return Object.fromEntries(normalizedEntries);
+}
+function generateTemplateRegistryFileContent(registry) {
+	return `/* eslint-disable */
+// Generated by better-zap generate. Edit the source templates in Meta and re-run the generator.
+
+import { defineTemplates } from "better-zap";
+
+export const whatsappTemplates = defineTemplates(${JSON.stringify(registry, null, 2)} as const);
+
+export type AppWhatsAppTemplates = typeof whatsappTemplates;
+`;
+}
+async function writeGeneratedTemplateFile({ check = false, content, output }) {
+	let currentContent = "";
+	try {
+		currentContent = await node_fs_promises.default.readFile(output, "utf8");
+	} catch (error) {
+		if (!(error instanceof Error) || !error.code || error.code !== "ENOENT") throw error;
+	}
+	if (check) {
+		if (currentContent !== content) throw new Error(`[better-zap generate] ${output} is out of date. Re-run the generator.`);
+		return;
+	}
+	await node_fs_promises.default.mkdir(node_path.default.dirname(output), { recursive: true });
+	await node_fs_promises.default.writeFile(output, content, "utf8");
+}
+async function runGenerateCommand({ accessToken, apiVersion = DEFAULT_API_VERSION, check = false, fetchImpl = fetch, output, wabaId }) {
+	if (!accessToken || !wabaId || !output) throw new Error("[better-zap generate] Missing required options. Expected access token, WABA ID, and output path.");
+	const registry = normalizeMetaTemplates(await fetchAllMetaTemplates({
+		accessToken,
+		apiVersion,
+		fetchImpl,
+		wabaId
+	}));
+	await writeGeneratedTemplateFile({
+		check,
+		content: generateTemplateRegistryFileContent(registry),
+		output
+	});
+	return {
+		output,
+		templateCount: Object.keys(registry).length
+	};
+}
+async function findDefaultConfigPath(cwd) {
+	for (const configFile of DEFAULT_CONFIG_FILES) {
+		const absolutePath = node_path.default.resolve(cwd, configFile);
+		try {
+			await node_fs_promises.default.access(absolutePath);
+			return absolutePath;
+		} catch {}
+	}
+	return null;
+}
+async function loadConfigFile(configPath) {
+	if (configPath.endsWith(".json")) {
+		const rawConfig = await node_fs_promises.default.readFile(configPath, "utf8");
+		return JSON.parse(rawConfig);
+	}
+	const module = await import((0, node_url.pathToFileURL)(configPath).href);
+	return module.default ?? module;
+}
+function normalizeMetaTemplate(template) {
+	if (!template.name || !template.language) throw new Error("[better-zap generate] Template entry is missing name or language.");
+	const normalizedComponents = [];
+	for (const component of template.components ?? []) {
+		const type = toUpper(component.type);
+		if (type === "BODY") {
+			normalizedComponents.push(normalizeBodyComponent(component));
+			continue;
+		}
+		if (type === "HEADER") {
+			normalizedComponents.push(normalizeHeaderComponent(component));
+			continue;
+		}
+		if (type === "BUTTONS") {
+			normalizedComponents.push(...normalizeButtonsComponent(component));
+			continue;
+		}
+		if (type === "FOOTER") continue;
+		throw new Error(`[better-zap generate] Unsupported template component type "${component.type}" in "${template.name}".`);
+	}
+	return {
+		language: template.language,
+		components: normalizedComponents
+	};
+}
+function normalizeBodyComponent(component) {
+	return {
+		type: "body",
+		parameters: extractPlaceholderTokens(component.text).map((token, index) => ({
+			name: createTextParameterName("body", token, index + 1),
+			type: "text"
+		}))
+	};
+}
+function normalizeHeaderComponent(component) {
+	const format = toUpper(component.format ?? "TEXT");
+	if (format === "LOCATION") return {
+		type: "header",
+		parameters: [{
+			name: "header_location",
+			type: "location"
+		}]
+	};
+	if (format === "TEXT") return {
+		type: "header",
+		parameters: extractPlaceholderTokens(component.text).map((token, index) => ({
+			name: createTextParameterName("header", token, index + 1),
+			type: "text"
+		}))
+	};
+	if (format === "IMAGE" || format === "VIDEO" || format === "DOCUMENT") return {
+		type: "header",
+		parameters: [{
+			name: `header_${format.toLowerCase()}`,
+			type: format.toLowerCase()
+		}]
+	};
+	throw new Error(`[better-zap generate] Unsupported header format "${component.format}".`);
+}
+function normalizeButtonsComponent(component) {
+	return (component.buttons ?? []).map((button, index) => normalizeButton(button, index));
+}
+function normalizeButton(button, index) {
+	const type = toUpper(button.type);
+	if (type === "QUICK_REPLY") return {
+		type: "button",
+		subType: "quick_reply",
+		index: String(index),
+		parameters: [{
+			name: `button_${index}_payload`,
+			type: "payload"
+		}]
+	};
+	if (type === "URL") {
+		const tokens = extractPlaceholderTokens(button.url);
+		return {
+			type: "button",
+			subType: "url",
+			index: String(index),
+			parameters: tokens.map((token, tokenIndex) => ({
+				name: createTextParameterName(`button_${index}_text`, token, tokenIndex + 1),
+				type: "text"
+			}))
+		};
+	}
+	throw new Error(`[better-zap generate] Unsupported button type "${button.type}" at index ${index}.`);
+}
+function extractPlaceholderTokens(value) {
+	if (typeof value !== "string" || value.length === 0) return [];
+	const tokens = [];
+	for (const match of value.matchAll(/\{\{\s*([A-Za-z0-9_]+)\s*\}\}/g)) tokens.push(match[1]);
+	return tokens;
+}
+function createTextParameterName(prefix, token, position) {
+	if (token && !/^\d+$/.test(token)) return `${prefix}_${sanitizeName(token)}`;
+	return `${prefix}_${position}`;
+}
+function sanitizeName(value) {
+	return value.toLowerCase().replace(/[^a-z0-9_]+/g, "_");
+}
+function toUpper(value) {
+	return typeof value === "string" ? value.toUpperCase() : "";
+}
+function firstDefined(...values) {
+	return values.find((value) => typeof value === "string" && value.length > 0);
+}
+function asString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "fetchAllMetaTemplates", {
+	enumerable: true,
+	get: function() {
+		return fetchAllMetaTemplates;
+	}
+});
+Object.defineProperty(exports, "generateTemplateRegistryFileContent", {
+	enumerable: true,
+	get: function() {
+		return generateTemplateRegistryFileContent;
+	}
+});
+Object.defineProperty(exports, "normalizeMetaTemplates", {
+	enumerable: true,
+	get: function() {
+		return normalizeMetaTemplates;
+	}
+});
+Object.defineProperty(exports, "parseCliArgs", {
+	enumerable: true,
+	get: function() {
+		return parseCliArgs;
+	}
+});
+Object.defineProperty(exports, "resolveGenerateOptions", {
+	enumerable: true,
+	get: function() {
+		return resolveGenerateOptions;
+	}
+});
+Object.defineProperty(exports, "runGenerateCommand", {
+	enumerable: true,
+	get: function() {
+		return runGenerateCommand;
+	}
+});
+Object.defineProperty(exports, "writeGeneratedTemplateFile", {
+	enumerable: true,
+	get: function() {
+		return writeGeneratedTemplateFile;
+	}
+});

package/dist/template-generator-DQI3p1ce.mjs

@@ -0,0 +1,236 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+//#region src/template-generator.ts
+const DEFAULT_API_VERSION = "v25.0";
+const DEFAULT_CONFIG_FILES = [
+	"better-zap.config.mjs",
+	"better-zap.config.js",
+	"better-zap.config.json"
+];
+function parseCliArgs(argv) {
+	const args = [...argv];
+	const command = args.shift();
+	const flags = {};
+	while (args.length > 0) {
+		const current = args.shift();
+		if (!current?.startsWith("--")) continue;
+		const flagName = current.slice(2);
+		const next = args[0];
+		if (!next || next.startsWith("--")) {
+			flags[flagName] = true;
+			continue;
+		}
+		const value = args.shift();
+		if (value) flags[flagName] = value;
+	}
+	return {
+		command,
+		flags
+	};
+}
+async function resolveGenerateOptions({ cwd, env, flags }) {
+	const configPath = typeof flags.config === "string" ? path.resolve(cwd, flags.config) : await findDefaultConfigPath(cwd);
+	const fileConfig = configPath ? await loadConfigFile(configPath) : {};
+	const templatesConfig = fileConfig.templates ?? fileConfig.whatsappTemplates ?? fileConfig;
+	const outputValue = firstDefined(asString(flags.output), templatesConfig.output, env.BETTER_ZAP_TEMPLATE_OUTPUT) ?? "";
+	const output = outputValue ? path.resolve(cwd, outputValue) : "";
+	return {
+		accessToken: firstDefined(asString(flags["access-token"]), templatesConfig.accessToken, env.WHATSAPP_TOKEN, env.META_ACCESS_TOKEN),
+		wabaId: firstDefined(asString(flags["waba-id"]), templatesConfig.wabaId, env.WHATSAPP_BUSINESS_ACCOUNT_ID),
+		apiVersion: firstDefined(asString(flags["api-version"]), templatesConfig.apiVersion, DEFAULT_API_VERSION),
+		output,
+		check: Boolean(flags.check)
+	};
+}
+async function fetchAllMetaTemplates({ accessToken, apiVersion, fetchImpl = fetch, wabaId }) {
+	let nextUrl = `https://graph.facebook.com/${apiVersion ?? DEFAULT_API_VERSION}/${wabaId}/message_templates?limit=100`;
+	const templates = [];
+	while (nextUrl) {
+		const response = await fetchImpl(nextUrl, { headers: { Authorization: `Bearer ${accessToken}` } });
+		if (!response.ok) {
+			const errorPayload = await response.json().catch(() => ({ error: { message: `HTTP ${response.status}` } }));
+			throw new Error(`[better-zap generate] Meta request failed: ${errorPayload.error?.message ?? `HTTP ${response.status}`}`);
+		}
+		const payload = await response.json();
+		templates.push(...payload.data ?? []);
+		nextUrl = payload.paging?.next ?? null;
+	}
+	return templates;
+}
+function normalizeMetaTemplates(metaTemplates) {
+	const normalizedEntries = metaTemplates.map((template) => [template.name, normalizeMetaTemplate(template)]).sort(([left], [right]) => (left ?? "").localeCompare(right ?? ""));
+	return Object.fromEntries(normalizedEntries);
+}
+function generateTemplateRegistryFileContent(registry) {
+	return `/* eslint-disable */
+// Generated by better-zap generate. Edit the source templates in Meta and re-run the generator.
+
+import { defineTemplates } from "better-zap";
+
+export const whatsappTemplates = defineTemplates(${JSON.stringify(registry, null, 2)} as const);
+
+export type AppWhatsAppTemplates = typeof whatsappTemplates;
+`;
+}
+async function writeGeneratedTemplateFile({ check = false, content, output }) {
+	let currentContent = "";
+	try {
+		currentContent = await fs.readFile(output, "utf8");
+	} catch (error) {
+		if (!(error instanceof Error) || !error.code || error.code !== "ENOENT") throw error;
+	}
+	if (check) {
+		if (currentContent !== content) throw new Error(`[better-zap generate] ${output} is out of date. Re-run the generator.`);
+		return;
+	}
+	await fs.mkdir(path.dirname(output), { recursive: true });
+	await fs.writeFile(output, content, "utf8");
+}
+async function runGenerateCommand({ accessToken, apiVersion = DEFAULT_API_VERSION, check = false, fetchImpl = fetch, output, wabaId }) {
+	if (!accessToken || !wabaId || !output) throw new Error("[better-zap generate] Missing required options. Expected access token, WABA ID, and output path.");
+	const registry = normalizeMetaTemplates(await fetchAllMetaTemplates({
+		accessToken,
+		apiVersion,
+		fetchImpl,
+		wabaId
+	}));
+	await writeGeneratedTemplateFile({
+		check,
+		content: generateTemplateRegistryFileContent(registry),
+		output
+	});
+	return {
+		output,
+		templateCount: Object.keys(registry).length
+	};
+}
+async function findDefaultConfigPath(cwd) {
+	for (const configFile of DEFAULT_CONFIG_FILES) {
+		const absolutePath = path.resolve(cwd, configFile);
+		try {
+			await fs.access(absolutePath);
+			return absolutePath;
+		} catch {}
+	}
+	return null;
+}
+async function loadConfigFile(configPath) {
+	if (configPath.endsWith(".json")) {
+		const rawConfig = await fs.readFile(configPath, "utf8");
+		return JSON.parse(rawConfig);
+	}
+	const module = await import(pathToFileURL(configPath).href);
+	return module.default ?? module;
+}
+function normalizeMetaTemplate(template) {
+	if (!template.name || !template.language) throw new Error("[better-zap generate] Template entry is missing name or language.");
+	const normalizedComponents = [];
+	for (const component of template.components ?? []) {
+		const type = toUpper(component.type);
+		if (type === "BODY") {
+			normalizedComponents.push(normalizeBodyComponent(component));
+			continue;
+		}
+		if (type === "HEADER") {
+			normalizedComponents.push(normalizeHeaderComponent(component));
+			continue;
+		}
+		if (type === "BUTTONS") {
+			normalizedComponents.push(...normalizeButtonsComponent(component));
+			continue;
+		}
+		if (type === "FOOTER") continue;
+		throw new Error(`[better-zap generate] Unsupported template component type "${component.type}" in "${template.name}".`);
+	}
+	return {
+		language: template.language,
+		components: normalizedComponents
+	};
+}
+function normalizeBodyComponent(component) {
+	return {
+		type: "body",
+		parameters: extractPlaceholderTokens(component.text).map((token, index) => ({
+			name: createTextParameterName("body", token, index + 1),
+			type: "text"
+		}))
+	};
+}
+function normalizeHeaderComponent(component) {
+	const format = toUpper(component.format ?? "TEXT");
+	if (format === "LOCATION") return {
+		type: "header",
+		parameters: [{
+			name: "header_location",
+			type: "location"
+		}]
+	};
+	if (format === "TEXT") return {
+		type: "header",
+		parameters: extractPlaceholderTokens(component.text).map((token, index) => ({
+			name: createTextParameterName("header", token, index + 1),
+			type: "text"
+		}))
+	};
+	if (format === "IMAGE" || format === "VIDEO" || format === "DOCUMENT") return {
+		type: "header",
+		parameters: [{
+			name: `header_${format.toLowerCase()}`,
+			type: format.toLowerCase()
+		}]
+	};
+	throw new Error(`[better-zap generate] Unsupported header format "${component.format}".`);
+}
+function normalizeButtonsComponent(component) {
+	return (component.buttons ?? []).map((button, index) => normalizeButton(button, index));
+}
+function normalizeButton(button, index) {
+	const type = toUpper(button.type);
+	if (type === "QUICK_REPLY") return {
+		type: "button",
+		subType: "quick_reply",
+		index: String(index),
+		parameters: [{
+			name: `button_${index}_payload`,
+			type: "payload"
+		}]
+	};
+	if (type === "URL") {
+		const tokens = extractPlaceholderTokens(button.url);
+		return {
+			type: "button",
+			subType: "url",
+			index: String(index),
+			parameters: tokens.map((token, tokenIndex) => ({
+				name: createTextParameterName(`button_${index}_text`, token, tokenIndex + 1),
+				type: "text"
+			}))
+		};
+	}
+	throw new Error(`[better-zap generate] Unsupported button type "${button.type}" at index ${index}.`);
+}
+function extractPlaceholderTokens(value) {
+	if (typeof value !== "string" || value.length === 0) return [];
+	const tokens = [];
+	for (const match of value.matchAll(/\{\{\s*([A-Za-z0-9_]+)\s*\}\}/g)) tokens.push(match[1]);
+	return tokens;
+}
+function createTextParameterName(prefix, token, position) {
+	if (token && !/^\d+$/.test(token)) return `${prefix}_${sanitizeName(token)}`;
+	return `${prefix}_${position}`;
+}
+function sanitizeName(value) {
+	return value.toLowerCase().replace(/[^a-z0-9_]+/g, "_");
+}
+function toUpper(value) {
+	return typeof value === "string" ? value.toUpperCase() : "";
+}
+function firstDefined(...values) {
+	return values.find((value) => typeof value === "string" && value.length > 0);
+}
+function asString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+//#endregion
+export { resolveGenerateOptions as a, parseCliArgs as i, generateTemplateRegistryFileContent as n, runGenerateCommand as o, normalizeMetaTemplates as r, writeGeneratedTemplateFile as s, fetchAllMetaTemplates as t };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@better-zap/cli",
+  "version": "0.0.1",
+  "description": "CLI tools for Better Zap.",
+  "license": "ISC",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "better-zap": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "better-zap": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "tsdown": "^0.21.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}