@talqui-oss/template-builder 0.0.0-stage → 0.1.0-beta.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Talqui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapters/meta.cjs

@@ -0,0 +1,242 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/meta.ts
+var meta_exports = {};
+__export(meta_exports, {
+  meta: () => meta
+});
+module.exports = __toCommonJS(meta_exports);
+
+// src/validate/text.ts
+var PLACEHOLDER = /\{\{(.*?)\}\}/g;
+var VARIABLE_NAME = /^[a-z][a-z0-9_]*$/;
+function placeholders(text) {
+  return [...text.matchAll(PLACEHOLDER)].map((match) => {
+    const name = match[1] ?? "";
+    return { raw: match[0], name, valid: VARIABLE_NAME.test(name) };
+  });
+}
+
+// src/adapters/types.ts
+function defineAdapter(definition) {
+  return (...[options]) => ({
+    name: definition.name,
+    toRequests: (template) => definition.toRequests(template, options ?? {})
+  });
+}
+var UnsupportedByProviderError = class extends Error {
+  constructor(provider, path, message) {
+    super(`${provider}: ${message} (${path})`);
+    this.provider = provider;
+    this.path = path;
+    this.name = "UnsupportedByProviderError";
+  }
+  provider;
+  path;
+  code = "UNSUPPORTED_BY_PROVIDER";
+};
+function unsupported(provider, path, what) {
+  throw new UnsupportedByProviderError(
+    provider,
+    path,
+    `${what} is not supported by this provider.`
+  );
+}
+
+// src/adapters/meta.ts
+var NAME = "meta";
+var MEDIA_HANDLE = "$MEDIA_HANDLE";
+var meta = defineAdapter({
+  name: NAME,
+  toRequests(template, {
+    wabaId = "$WABA_ID",
+    accessToken = "$META_ACCESS_TOKEN",
+    apiVersion = "v26.0"
+  }) {
+    const body2 = template.category === "AUTHENTICATION" ? authentication(template) : standard(template);
+    const media = mediaUrls(template);
+    return [
+      {
+        method: "POST",
+        url: `https://graph.facebook.com/${apiVersion}/${wabaId}/message_templates`,
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          "Content-Type": "application/json"
+        },
+        body: body2,
+        comments: media.length > 0 ? [
+          `Upload each sample file with the Resumable Upload API and set ${MEDIA_HANDLE} to the handle it returns:`,
+          "https://developers.facebook.com/docs/graph-api/guides/upload",
+          ...media.map((url) => `- ${url}`)
+        ] : void 0
+      }
+    ];
+  }
+});
+function standard(t) {
+  if (t.displayFormat)
+    unsupported(NAME, "displayFormat", "The ORDER_DETAILS display format");
+  return {
+    name: t.name,
+    language: t.language,
+    category: t.category,
+    parameter_format: "NAMED",
+    message_send_ttl_seconds: t.messageSendTtlSeconds,
+    components: [
+      t.header && header(t.header, t.variables),
+      t.limitedTimeOffer && {
+        type: "LIMITED_TIME_OFFER",
+        limited_time_offer: {
+          text: t.limitedTimeOffer.text,
+          has_expiration: t.limitedTimeOffer.hasExpiration ?? false
+        }
+      },
+      body(t.body.text, t.variables),
+      t.footer && { type: "FOOTER", text: t.footer.text },
+      t.buttons?.length && buttons(t.buttons, t.variables, "buttons"),
+      t.carousel && {
+        type: "CAROUSEL",
+        cards: t.carousel.cards.map(
+          (card, index) => carouselCard(card, t.variables, `carousel.cards.${index}`)
+        )
+      },
+      t.callPermissionRequest && { type: "CALL_PERMISSION_REQUEST" }
+    ].filter(Boolean)
+  };
+}
+function authentication(t) {
+  const button = t.button;
+  return {
+    name: t.name,
+    language: t.language,
+    category: t.category,
+    message_send_ttl_seconds: t.messageSendTtlSeconds,
+    components: [
+      {
+        type: "BODY",
+        add_security_recommendation: t.body?.addSecurityRecommendation
+      },
+      t.footer?.codeExpirationMinutes !== void 0 && {
+        type: "FOOTER",
+        code_expiration_minutes: t.footer.codeExpirationMinutes
+      },
+      {
+        type: "BUTTONS",
+        buttons: [
+          {
+            type: "OTP",
+            otp_type: button.otpType,
+            text: button.text,
+            autofill_text: button.autofillText,
+            supported_apps: button.supportedApps?.map((app) => ({
+              package_name: app.packageName,
+              signature_hash: app.signatureHash
+            })),
+            zero_tap_terms_accepted: button.zeroTapTermsAccepted
+          }
+        ]
+      }
+    ].filter(Boolean)
+  };
+}
+var namedParams = (text, variables = {}) => [...new Set(placeholders(text).map((p) => p.name))].map((name) => ({
+  param_name: name,
+  example: variables[name]?.example ?? ""
+}));
+function header(h, variables) {
+  if (h.type === "PRODUCT")
+    return unsupported(NAME, "header", "A PRODUCT header");
+  if (h.type === "LOCATION") return { type: "HEADER", format: "LOCATION" };
+  if (h.type !== "TEXT")
+    return {
+      type: "HEADER",
+      format: h.type,
+      example: { header_handle: [MEDIA_HANDLE] }
+    };
+  const params = namedParams(h.text, variables);
+  return {
+    type: "HEADER",
+    format: "TEXT",
+    text: h.text,
+    example: params.length ? { header_text_named_params: params } : void 0
+  };
+}
+function body(text, variables) {
+  const params = namedParams(text, variables);
+  return {
+    type: "BODY",
+    text,
+    example: params.length ? { body_text_named_params: params } : void 0
+  };
+}
+function buttons(list, variables = {}, path) {
+  return {
+    type: "BUTTONS",
+    buttons: list.map((b, index) => {
+      switch (b.type) {
+        case "QUICK_REPLY":
+          return { type: b.type, text: b.text };
+        case "URL": {
+          const [param] = placeholders(b.url);
+          return {
+            type: b.type,
+            text: b.text,
+            url: param ? b.url.replace(param.raw, "{{1}}") : b.url,
+            example: param ? [b.url.replace(param.raw, variables[param.name]?.example ?? "")] : void 0
+          };
+        }
+        case "PHONE_NUMBER":
+          return { type: b.type, text: b.text, phone_number: b.phoneNumber };
+        case "VOICE_CALL":
+          return { type: b.type, text: b.text, ttl_minutes: b.ttlMinutes };
+        case "COPY_CODE":
+          return { type: b.type, example: b.example };
+        default:
+          return unsupported(NAME, `${path}.${index}`, `The ${b.type} button`);
+      }
+    })
+  };
+}
+function carouselCard(card, variables = {}, path) {
+  if (card.header.type === "PRODUCT")
+    unsupported(NAME, `${path}.header`, "A PRODUCT card header");
+  return {
+    components: [
+      {
+        type: "HEADER",
+        format: card.header.type,
+        example: { header_handle: [MEDIA_HANDLE] }
+      },
+      card.body && body(card.body.text, variables),
+      card.buttons?.length && buttons(card.buttons, variables, `${path}.buttons`)
+    ].filter(Boolean)
+  };
+}
+function mediaUrls(t) {
+  if (t.category === "AUTHENTICATION") return [];
+  const urls = t.header && "url" in t.header ? [t.header.url] : [];
+  for (const card of t.carousel?.cards ?? [])
+    if ("url" in card.header) urls.push(card.header.url);
+  return urls;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  meta
+});

package/dist/adapters/meta.d.cts

@@ -0,0 +1,15 @@
+import { Adapter } from '../index.cjs';
+
+type MetaOptions = {
+    /** WhatsApp Business Account ID. Default: `$WABA_ID`. */
+    wabaId?: string;
+    /** Default: `$META_ACCESS_TOKEN`. */
+    accessToken?: string;
+    /** Graph API version. Default: `v26.0`. */
+    apiVersion?: string;
+};
+/** Meta Cloud API: `POST /{WABA_ID}/message_templates`. */
+declare const meta: (options?: MetaOptions | undefined) => Adapter;
+
+export { meta };
+export type { MetaOptions };

package/dist/adapters/meta.d.ts

@@ -0,0 +1,15 @@
+import { Adapter } from '../index.js';
+
+type MetaOptions = {
+    /** WhatsApp Business Account ID. Default: `$WABA_ID`. */
+    wabaId?: string;
+    /** Default: `$META_ACCESS_TOKEN`. */
+    accessToken?: string;
+    /** Graph API version. Default: `v26.0`. */
+    apiVersion?: string;
+};
+/** Meta Cloud API: `POST /{WABA_ID}/message_templates`. */
+declare const meta: (options?: MetaOptions | undefined) => Adapter;
+
+export { meta };
+export type { MetaOptions };

package/dist/adapters/meta.js

@@ -0,0 +1,185 @@
+import {
+  defineAdapter,
+  placeholders,
+  unsupported
+} from "../chunk-ULTGMISN.js";
+
+// src/adapters/meta.ts
+var NAME = "meta";
+var MEDIA_HANDLE = "$MEDIA_HANDLE";
+var meta = defineAdapter({
+  name: NAME,
+  toRequests(template, {
+    wabaId = "$WABA_ID",
+    accessToken = "$META_ACCESS_TOKEN",
+    apiVersion = "v26.0"
+  }) {
+    const body2 = template.category === "AUTHENTICATION" ? authentication(template) : standard(template);
+    const media = mediaUrls(template);
+    return [
+      {
+        method: "POST",
+        url: `https://graph.facebook.com/${apiVersion}/${wabaId}/message_templates`,
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          "Content-Type": "application/json"
+        },
+        body: body2,
+        comments: media.length > 0 ? [
+          `Upload each sample file with the Resumable Upload API and set ${MEDIA_HANDLE} to the handle it returns:`,
+          "https://developers.facebook.com/docs/graph-api/guides/upload",
+          ...media.map((url) => `- ${url}`)
+        ] : void 0
+      }
+    ];
+  }
+});
+function standard(t) {
+  if (t.displayFormat)
+    unsupported(NAME, "displayFormat", "The ORDER_DETAILS display format");
+  return {
+    name: t.name,
+    language: t.language,
+    category: t.category,
+    parameter_format: "NAMED",
+    message_send_ttl_seconds: t.messageSendTtlSeconds,
+    components: [
+      t.header && header(t.header, t.variables),
+      t.limitedTimeOffer && {
+        type: "LIMITED_TIME_OFFER",
+        limited_time_offer: {
+          text: t.limitedTimeOffer.text,
+          has_expiration: t.limitedTimeOffer.hasExpiration ?? false
+        }
+      },
+      body(t.body.text, t.variables),
+      t.footer && { type: "FOOTER", text: t.footer.text },
+      t.buttons?.length && buttons(t.buttons, t.variables, "buttons"),
+      t.carousel && {
+        type: "CAROUSEL",
+        cards: t.carousel.cards.map(
+          (card, index) => carouselCard(card, t.variables, `carousel.cards.${index}`)
+        )
+      },
+      t.callPermissionRequest && { type: "CALL_PERMISSION_REQUEST" }
+    ].filter(Boolean)
+  };
+}
+function authentication(t) {
+  const button = t.button;
+  return {
+    name: t.name,
+    language: t.language,
+    category: t.category,
+    message_send_ttl_seconds: t.messageSendTtlSeconds,
+    components: [
+      {
+        type: "BODY",
+        add_security_recommendation: t.body?.addSecurityRecommendation
+      },
+      t.footer?.codeExpirationMinutes !== void 0 && {
+        type: "FOOTER",
+        code_expiration_minutes: t.footer.codeExpirationMinutes
+      },
+      {
+        type: "BUTTONS",
+        buttons: [
+          {
+            type: "OTP",
+            otp_type: button.otpType,
+            text: button.text,
+            autofill_text: button.autofillText,
+            supported_apps: button.supportedApps?.map((app) => ({
+              package_name: app.packageName,
+              signature_hash: app.signatureHash
+            })),
+            zero_tap_terms_accepted: button.zeroTapTermsAccepted
+          }
+        ]
+      }
+    ].filter(Boolean)
+  };
+}
+var namedParams = (text, variables = {}) => [...new Set(placeholders(text).map((p) => p.name))].map((name) => ({
+  param_name: name,
+  example: variables[name]?.example ?? ""
+}));
+function header(h, variables) {
+  if (h.type === "PRODUCT")
+    return unsupported(NAME, "header", "A PRODUCT header");
+  if (h.type === "LOCATION") return { type: "HEADER", format: "LOCATION" };
+  if (h.type !== "TEXT")
+    return {
+      type: "HEADER",
+      format: h.type,
+      example: { header_handle: [MEDIA_HANDLE] }
+    };
+  const params = namedParams(h.text, variables);
+  return {
+    type: "HEADER",
+    format: "TEXT",
+    text: h.text,
+    example: params.length ? { header_text_named_params: params } : void 0
+  };
+}
+function body(text, variables) {
+  const params = namedParams(text, variables);
+  return {
+    type: "BODY",
+    text,
+    example: params.length ? { body_text_named_params: params } : void 0
+  };
+}
+function buttons(list, variables = {}, path) {
+  return {
+    type: "BUTTONS",
+    buttons: list.map((b, index) => {
+      switch (b.type) {
+        case "QUICK_REPLY":
+          return { type: b.type, text: b.text };
+        case "URL": {
+          const [param] = placeholders(b.url);
+          return {
+            type: b.type,
+            text: b.text,
+            url: param ? b.url.replace(param.raw, "{{1}}") : b.url,
+            example: param ? [b.url.replace(param.raw, variables[param.name]?.example ?? "")] : void 0
+          };
+        }
+        case "PHONE_NUMBER":
+          return { type: b.type, text: b.text, phone_number: b.phoneNumber };
+        case "VOICE_CALL":
+          return { type: b.type, text: b.text, ttl_minutes: b.ttlMinutes };
+        case "COPY_CODE":
+          return { type: b.type, example: b.example };
+        default:
+          return unsupported(NAME, `${path}.${index}`, `The ${b.type} button`);
+      }
+    })
+  };
+}
+function carouselCard(card, variables = {}, path) {
+  if (card.header.type === "PRODUCT")
+    unsupported(NAME, `${path}.header`, "A PRODUCT card header");
+  return {
+    components: [
+      {
+        type: "HEADER",
+        format: card.header.type,
+        example: { header_handle: [MEDIA_HANDLE] }
+      },
+      card.body && body(card.body.text, variables),
+      card.buttons?.length && buttons(card.buttons, variables, `${path}.buttons`)
+    ].filter(Boolean)
+  };
+}
+function mediaUrls(t) {
+  if (t.category === "AUTHENTICATION") return [];
+  const urls = t.header && "url" in t.header ? [t.header.url] : [];
+  for (const card of t.carousel?.cards ?? [])
+    if ("url" in card.header) urls.push(card.header.url);
+  return urls;
+}
+export {
+  meta
+};