@bacano/sdk 1.2.1 → 1.2.3

package/react.cjs

@@ -1998,7 +1998,7 @@ var RECONCILE_PAYMENT_SESSION = (
     $orderId: uuid!
     $publicOrderToken: String!
     $paymentSessionId: uuid!
-    $gatewayTransactionId: String!
+    $gatewayTransactionId: String
   ) {
     websiteReconcilePaymentSession(
       order_id: $orderId
@@ -5105,6 +5105,61 @@ function matchesCanonicalMarketingHost(canonicalDomain, currentHostname) {
   }
 }
 
+// libs/sdk/src/marketing/gtm.ts
+var CONTAINER_ID = /^GTM-[A-Z0-9]{4,32}$/;
+var preparedQueues = /* @__PURE__ */ new WeakMap();
+function prepareGtm(containerId) {
+  const target = marketingWindow();
+  if (!target || !CONTAINER_ID.test(containerId)) return;
+  target.dataLayer ??= [];
+  const containers = preparedQueues.get(target.dataLayer) ?? /* @__PURE__ */ new Set();
+  if (containers.has(containerId)) return;
+  target.dataLayer.push({ "gtm.start": Date.now(), event: "gtm.js" });
+  containers.add(containerId);
+  preparedQueues.set(target.dataLayer, containers);
+}
+function loadGtmScript(containerId, onError) {
+  const target = marketingWindow();
+  if (!target || typeof document === "undefined" || !CONTAINER_ID.test(containerId))
+    return;
+  const id = `bacano-gtm-${containerId}`;
+  if (document.getElementById(id)) return;
+  prepareGtm(containerId);
+  const script = document.createElement("script");
+  script.id = id;
+  script.async = true;
+  script.src = `https://www.googletagmanager.com/gtm.js?id=${encodeURIComponent(containerId)}`;
+  script.referrerPolicy = "strict-origin-when-cross-origin";
+  script.onerror = () => onError();
+  document.head.appendChild(script);
+}
+function sendGtm(event) {
+  const target = marketingWindow();
+  if (!target?.dataLayer) return;
+  target.dataLayer.push({ bacano: null });
+  target.dataLayer.push({
+    event: `bacano_${event.eventName}`,
+    bacano: {
+      schema_version: event.schemaVersion,
+      event_name: event.eventName,
+      event_id: event.eventId,
+      ...interactionParameters(event),
+      page_location: event.pageLocation,
+      currency: event.currency,
+      value: event.value,
+      items: mapGa4Items(event.items),
+      item_list_id: event.itemListId,
+      item_list_name: event.itemListName,
+      shipping_tier: event.shippingTier,
+      payment_type: event.paymentType,
+      method: event.contactMethod,
+      contact_placement: event.eventName === "contact" && WEBSITE_MARKETING_CONTACT_PLACEMENTS.some(
+        (value) => value === event.contactPlacement
+      ) ? event.contactPlacement : void 0
+    }
+  });
+}
+
 // libs/sdk/src/marketing/runtime.ts
 function createWebsiteMarketingRuntime(options) {
   let destroyed = false;
@@ -5125,7 +5180,7 @@ function createWebsiteMarketingRuntime(options) {
       target.location.hostname
     )
   ) && Boolean(
-    options.config.destinations.ga4 || options.config.destinations.meta || options.config.destinations.clarity
+    options.config.destinations.ga4 || options.config.destinations.meta || options.config.destinations.clarity || options.config.destinations.gtm
   );
   if (!enabled)
     diagnostic({
@@ -5166,6 +5221,10 @@ function createWebsiteMarketingRuntime(options) {
         const { projectId } = options.config.destinations.clarity;
         guard("Clarity", () => prepareClarity(projectId));
       }
+      if (options.config.destinations.gtm) {
+        const { containerId } = options.config.destinations.gtm;
+        guard("GTM", () => prepareGtm(containerId));
+      }
       cancelScheduledLoad = scheduleScriptLoad(() => {
         if (destroyed) return;
         if (options.config.destinations.ga4) {
@@ -5181,6 +5240,10 @@ function createWebsiteMarketingRuntime(options) {
             () => loadClarityScript(projectId, scriptError("Clarity"))
           );
         }
+        if (options.config.destinations.gtm) {
+          const { containerId } = options.config.destinations.gtm;
+          guard("GTM", () => loadGtmScript(containerId, scriptError("GTM")));
+        }
       }, options.scriptLoadStrategy);
       captureWebsiteMarketingAttribution(
         options.websiteId,
@@ -5300,6 +5363,9 @@ function createWebsiteMarketingRuntime(options) {
       if (options.config.destinations.clarity) {
         dispatch("Clarity", () => sendClarityEvent(event.eventName));
       }
+      if (options.config.destinations.gtm && /^GTM-[A-Z0-9]{4,32}$/.test(options.config.destinations.gtm.containerId)) {
+        dispatch("GTM", () => sendGtm(event));
+      }
     },
     captureAttribution() {
       if (!enabled || destroyed) return null;
@@ -5392,6 +5458,52 @@ function BacanoMarketingProvider({
 // libs/sdk/src/react/provider.tsx
 var import_react6 = require("react");
 
+// libs/sdk/src/flows.ts
+function createFlowsClient(config) {
+  const base = config.apiUrl.replace(/\/+$/, "") + "/api/v1/website/flows";
+  async function request(path, body, binary = false) {
+    const token = await config.getAccessToken?.();
+    const response = await fetch(base + path, {
+      method: body === void 0 ? "GET" : "POST",
+      cache: "no-store",
+      headers: {
+        ...token ? { Authorization: `Bearer ${token}` } : {},
+        ...body !== void 0 ? { "Content-Type": "application/json" } : {},
+        ...config.websiteSlug ? { "x-bacano-website-slug": config.websiteSlug } : {}
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    if (!response.ok) {
+      const result = await response.json().catch(() => ({ error: "FLOW_REQUEST_FAILED" }));
+      throw new WebsiteError(
+        result.error ?? "FLOW_REQUEST_FAILED",
+        result.error ?? "FLOW_REQUEST_FAILED"
+      );
+    }
+    return binary ? await response.blob() : await response.json();
+  }
+  const stepPath = (caseId, stepId) => `/cases/${encodeURIComponent(caseId)}/steps/${encodeURIComponent(stepId)}`;
+  return {
+    /** Only the explicitly enabled local demo gateway accepts these credentials. */
+    localDemoLogin: (email, password) => request("/local-session", { email, password }),
+    logout: () => request("/logout", {}),
+    listCases: () => request("/cases"),
+    getJourney: (caseId) => request(`/cases/${encodeURIComponent(caseId)}`),
+    getContent: (caseId, stepId) => request(stepPath(caseId, stepId) + "/content"),
+    getForm: (caseId, stepId) => request(stepPath(caseId, stepId) + "/form"),
+    getResponse: (caseId, stepId) => request(stepPath(caseId, stepId) + "/response"),
+    getFile: (caseId, stepId, fileId) => request(
+      stepPath(caseId, stepId) + `/files/${encodeURIComponent(fileId)}`,
+      void 0,
+      true
+    ),
+    act: (caseId, command) => request(
+      `/cases/${encodeURIComponent(caseId)}/actions`,
+      command
+    )
+  };
+}
+
 // libs/sdk/src/modules/auth.ts
 function createAuthHeaders(accessToken) {
   return accessToken ? { Authorization: `Bearer ${accessToken}` } : {};
@@ -5574,7 +5686,8 @@ async function getWebsitePublicConfig(options) {
           pixelId: marketing.destinations.meta.pixel_id,
           diagnosticMode: marketing.destinations.meta.diagnostic_mode ?? false
         } : null,
-        clarity: marketing.destinations.clarity ? { projectId: marketing.destinations.clarity.project_id } : null
+        clarity: marketing.destinations.clarity ? { projectId: marketing.destinations.clarity.project_id } : null,
+        ...marketing.destinations.gtm ? { gtm: { containerId: marketing.destinations.gtm.container_id } } : {}
       }
     },
     legal: {
@@ -7415,6 +7528,7 @@ function createBacanoClient(config) {
       await initialization;
     },
     getContext,
+    flows: createFlowsClient(config),
     auth: {
       async getAccessToken() {
         return config.getAccessToken ? await config.getAccessToken() : null;

package/react.js

@@ -1941,7 +1941,7 @@ var RECONCILE_PAYMENT_SESSION = (
     $orderId: uuid!
     $publicOrderToken: String!
     $paymentSessionId: uuid!
-    $gatewayTransactionId: String!
+    $gatewayTransactionId: String
   ) {
     websiteReconcilePaymentSession(
       order_id: $orderId
@@ -5052,6 +5052,61 @@ function matchesCanonicalMarketingHost(canonicalDomain, currentHostname) {
   }
 }
 
+// libs/sdk/src/marketing/gtm.ts
+var CONTAINER_ID = /^GTM-[A-Z0-9]{4,32}$/;
+var preparedQueues = /* @__PURE__ */ new WeakMap();
+function prepareGtm(containerId) {
+  const target = marketingWindow();
+  if (!target || !CONTAINER_ID.test(containerId)) return;
+  target.dataLayer ??= [];
+  const containers = preparedQueues.get(target.dataLayer) ?? /* @__PURE__ */ new Set();
+  if (containers.has(containerId)) return;
+  target.dataLayer.push({ "gtm.start": Date.now(), event: "gtm.js" });
+  containers.add(containerId);
+  preparedQueues.set(target.dataLayer, containers);
+}
+function loadGtmScript(containerId, onError) {
+  const target = marketingWindow();
+  if (!target || typeof document === "undefined" || !CONTAINER_ID.test(containerId))
+    return;
+  const id = `bacano-gtm-${containerId}`;
+  if (document.getElementById(id)) return;
+  prepareGtm(containerId);
+  const script = document.createElement("script");
+  script.id = id;
+  script.async = true;
+  script.src = `https://www.googletagmanager.com/gtm.js?id=${encodeURIComponent(containerId)}`;
+  script.referrerPolicy = "strict-origin-when-cross-origin";
+  script.onerror = () => onError();
+  document.head.appendChild(script);
+}
+function sendGtm(event) {
+  const target = marketingWindow();
+  if (!target?.dataLayer) return;
+  target.dataLayer.push({ bacano: null });
+  target.dataLayer.push({
+    event: `bacano_${event.eventName}`,
+    bacano: {
+      schema_version: event.schemaVersion,
+      event_name: event.eventName,
+      event_id: event.eventId,
+      ...interactionParameters(event),
+      page_location: event.pageLocation,
+      currency: event.currency,
+      value: event.value,
+      items: mapGa4Items(event.items),
+      item_list_id: event.itemListId,
+      item_list_name: event.itemListName,
+      shipping_tier: event.shippingTier,
+      payment_type: event.paymentType,
+      method: event.contactMethod,
+      contact_placement: event.eventName === "contact" && WEBSITE_MARKETING_CONTACT_PLACEMENTS.some(
+        (value) => value === event.contactPlacement
+      ) ? event.contactPlacement : void 0
+    }
+  });
+}
+
 // libs/sdk/src/marketing/runtime.ts
 function createWebsiteMarketingRuntime(options) {
   let destroyed = false;
@@ -5072,7 +5127,7 @@ function createWebsiteMarketingRuntime(options) {
       target.location.hostname
     )
   ) && Boolean(
-    options.config.destinations.ga4 || options.config.destinations.meta || options.config.destinations.clarity
+    options.config.destinations.ga4 || options.config.destinations.meta || options.config.destinations.clarity || options.config.destinations.gtm
   );
   if (!enabled)
     diagnostic({
@@ -5113,6 +5168,10 @@ function createWebsiteMarketingRuntime(options) {
         const { projectId } = options.config.destinations.clarity;
         guard("Clarity", () => prepareClarity(projectId));
       }
+      if (options.config.destinations.gtm) {
+        const { containerId } = options.config.destinations.gtm;
+        guard("GTM", () => prepareGtm(containerId));
+      }
       cancelScheduledLoad = scheduleScriptLoad(() => {
         if (destroyed) return;
         if (options.config.destinations.ga4) {
@@ -5128,6 +5187,10 @@ function createWebsiteMarketingRuntime(options) {
             () => loadClarityScript(projectId, scriptError("Clarity"))
           );
         }
+        if (options.config.destinations.gtm) {
+          const { containerId } = options.config.destinations.gtm;
+          guard("GTM", () => loadGtmScript(containerId, scriptError("GTM")));
+        }
       }, options.scriptLoadStrategy);
       captureWebsiteMarketingAttribution(
         options.websiteId,
@@ -5247,6 +5310,9 @@ function createWebsiteMarketingRuntime(options) {
       if (options.config.destinations.clarity) {
         dispatch("Clarity", () => sendClarityEvent(event.eventName));
       }
+      if (options.config.destinations.gtm && /^GTM-[A-Z0-9]{4,32}$/.test(options.config.destinations.gtm.containerId)) {
+        dispatch("GTM", () => sendGtm(event));
+      }
     },
     captureAttribution() {
       if (!enabled || destroyed) return null;
@@ -5339,6 +5405,52 @@ function BacanoMarketingProvider({
 // libs/sdk/src/react/provider.tsx
 import { useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
 
+// libs/sdk/src/flows.ts
+function createFlowsClient(config) {
+  const base = config.apiUrl.replace(/\/+$/, "") + "/api/v1/website/flows";
+  async function request(path, body, binary = false) {
+    const token = await config.getAccessToken?.();
+    const response = await fetch(base + path, {
+      method: body === void 0 ? "GET" : "POST",
+      cache: "no-store",
+      headers: {
+        ...token ? { Authorization: `Bearer ${token}` } : {},
+        ...body !== void 0 ? { "Content-Type": "application/json" } : {},
+        ...config.websiteSlug ? { "x-bacano-website-slug": config.websiteSlug } : {}
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    if (!response.ok) {
+      const result = await response.json().catch(() => ({ error: "FLOW_REQUEST_FAILED" }));
+      throw new WebsiteError(
+        result.error ?? "FLOW_REQUEST_FAILED",
+        result.error ?? "FLOW_REQUEST_FAILED"
+      );
+    }
+    return binary ? await response.blob() : await response.json();
+  }
+  const stepPath = (caseId, stepId) => `/cases/${encodeURIComponent(caseId)}/steps/${encodeURIComponent(stepId)}`;
+  return {
+    /** Only the explicitly enabled local demo gateway accepts these credentials. */
+    localDemoLogin: (email, password) => request("/local-session", { email, password }),
+    logout: () => request("/logout", {}),
+    listCases: () => request("/cases"),
+    getJourney: (caseId) => request(`/cases/${encodeURIComponent(caseId)}`),
+    getContent: (caseId, stepId) => request(stepPath(caseId, stepId) + "/content"),
+    getForm: (caseId, stepId) => request(stepPath(caseId, stepId) + "/form"),
+    getResponse: (caseId, stepId) => request(stepPath(caseId, stepId) + "/response"),
+    getFile: (caseId, stepId, fileId) => request(
+      stepPath(caseId, stepId) + `/files/${encodeURIComponent(fileId)}`,
+      void 0,
+      true
+    ),
+    act: (caseId, command) => request(
+      `/cases/${encodeURIComponent(caseId)}/actions`,
+      command
+    )
+  };
+}
+
 // libs/sdk/src/modules/auth.ts
 function createAuthHeaders(accessToken) {
   return accessToken ? { Authorization: `Bearer ${accessToken}` } : {};
@@ -5521,7 +5633,8 @@ async function getWebsitePublicConfig(options) {
           pixelId: marketing.destinations.meta.pixel_id,
           diagnosticMode: marketing.destinations.meta.diagnostic_mode ?? false
         } : null,
-        clarity: marketing.destinations.clarity ? { projectId: marketing.destinations.clarity.project_id } : null
+        clarity: marketing.destinations.clarity ? { projectId: marketing.destinations.clarity.project_id } : null,
+        ...marketing.destinations.gtm ? { gtm: { containerId: marketing.destinations.gtm.container_id } } : {}
       }
     },
     legal: {
@@ -7362,6 +7475,7 @@ function createBacanoClient(config) {
       await initialization;
     },
     getContext,
+    flows: createFlowsClient(config),
     auth: {
       async getAccessToken() {
         return config.getAccessToken ? await config.getAccessToken() : null;

package/skills/bacano-web/SKILL.md

@@ -52,6 +52,8 @@ aplicar obligatoriamente `STOREFRONT_CONTENT_LOCATOR.md`; añadir
 `AUTHENTICATION.md`, `STOREFRONT_LEADS.md`, `STOREFRONT_CLARITY.md` y
 otros contratos únicamente cuando esas capacidades existan. Leer
 `STOREFRONT_CONSTRUCTION.md` cuando el website permita ocultarse temporalmente.
+Si la tienda acepta pagos, leer obligatoriamente `STOREFRONT_PAYMENTS.md` antes
+de implementar, depurar o auditar checkout, retorno, reintentos o webhooks.
 Si existen formularios administrados desde Bacano, leer obligatoriamente
 `STOREFRONT_FORMS.md` y
 [references/forms.md](references/forms.md) antes de auditarlos o modificarlos.

package/skills/bacano-web/references/storefront.md

@@ -54,6 +54,8 @@ Aplicar además de los controles comunes.
 
 ## Pagos y pedidos
 
+- Leer y aplicar `STOREFRONT_PAYMENTS.md`; no reconstruir en la tienda URLs,
+  credenciales ni payloads privados de Wompi, Mercado Pago o Addi.
 - Ejecutar al menos un happy path real o sandbox por cada método crítico
   publicado. Probar pago inmediato, transferencia, Wompi y contraentrega solo
   si están activos; los estados alternos de cada proveedor quedan en su matriz

package/transport/documents.d.ts

@@ -33,7 +33,7 @@ export declare const VALIDATE_COUPON = "\n  mutation ValidateCoupon(\n    $order
 export declare const APPLY_COUPON = "\n  mutation ApplyCoupon($orderId: uuid!, $cartToken: String!, $code: String!) {\n    websiteApplyCoupon(\n      order_id: $orderId\n      cart_token: $cartToken\n      code: $code\n    ) {\n      success\n      order_id\n      coupon_id\n      code\n      name\n      coupon_type\n      discount_amount\n      eligible_subtotal\n      message\n      cart {\n        id\n        status\n        discount\n        total_without_tax\n        tax\n        total_with_tax\n        total_with_discount\n        created_at\n        updated_at\n        items {\n          id\n          product_variant_id\n          quantity\n          product_variant {\n            id\n            sku\n            product {\n              id\n              name\n            }\n            prices {\n              id\n              price\n              price_type\n              chain_id\n            }\n          }\n        }\n      }\n      errors\n    }\n  }\n";
 export declare const REMOVE_COUPON = "\n  mutation RemoveCoupon(\n    $orderId: uuid!\n    $cartToken: String!\n    $couponId: uuid!\n  ) {\n    websiteRemoveCoupon(\n      order_id: $orderId\n      cart_token: $cartToken\n      coupon_id: $couponId\n    ) {\n      success\n      order_id\n      coupon_id\n      code\n      name\n      coupon_type\n      discount_amount\n      eligible_subtotal\n      message\n      cart {\n        id\n        status\n        discount\n        total_without_tax\n        tax\n        total_with_tax\n        total_with_discount\n        created_at\n        updated_at\n        items {\n          id\n          product_variant_id\n          quantity\n          product_variant {\n            id\n            sku\n            product {\n              id\n              name\n            }\n            prices {\n              id\n              price\n              price_type\n              chain_id\n            }\n          }\n        }\n      }\n      errors\n    }\n  }\n";
 export declare const CREATE_PAYMENT_SESSION = "\n  mutation CreatePaymentSession(\n    $orderId: uuid!\n    $cartToken: String\n    $publicOrderToken: String\n    $paymentMethodId: uuid!\n    $returnUrl: String!\n  ) {\n    websiteCreatePaymentSession(\n      order_id: $orderId\n      cart_token: $cartToken\n      public_order_token: $publicOrderToken\n      payment_method_id: $paymentMethodId\n      return_url: $returnUrl\n    ) {\n      success\n      order_id\n      payment_method_id\n      payment_session_id\n      gateway_code\n      integration_mode\n      status\n      redirect_url\n      public_payload\n      errors\n    }\n  }\n";
-export declare const RECONCILE_PAYMENT_SESSION = "\n  mutation ReconcilePaymentSession(\n    $orderId: uuid!\n    $publicOrderToken: String!\n    $paymentSessionId: uuid!\n    $gatewayTransactionId: String!\n  ) {\n    websiteReconcilePaymentSession(\n      order_id: $orderId\n      public_order_token: $publicOrderToken\n      payment_session_id: $paymentSessionId\n      gateway_transaction_id: $gatewayTransactionId\n    ) {\n      success\n      order_id\n      payment_method_id\n      payment_session_id\n      gateway_code\n      integration_mode\n      status\n      redirect_url\n      public_payload\n      errors\n    }\n  }\n";
+export declare const RECONCILE_PAYMENT_SESSION = "\n  mutation ReconcilePaymentSession(\n    $orderId: uuid!\n    $publicOrderToken: String!\n    $paymentSessionId: uuid!\n    $gatewayTransactionId: String\n  ) {\n    websiteReconcilePaymentSession(\n      order_id: $orderId\n      public_order_token: $publicOrderToken\n      payment_session_id: $paymentSessionId\n      gateway_transaction_id: $gatewayTransactionId\n    ) {\n      success\n      order_id\n      payment_method_id\n      payment_session_id\n      gateway_code\n      integration_mode\n      status\n      redirect_url\n      public_payload\n      errors\n    }\n  }\n";
 export declare const GET_ORDERS = "\n  query GetOrders($limit: Int = 20, $offset: Int = 0) {\n    orders(\n      where: { order_number: { _is_null: false } }\n      order_by: { created_at: desc }\n      limit: $limit\n      offset: $offset\n    ) {\n      id\n      order_number\n      status\n      fulfillment_family\n      discount\n      tax\n      total_without_tax\n      total_with_tax\n      total_with_discount\n      created_at\n      updated_at\n      order_product_variants {\n        id\n        product_variant_id\n        quantity\n        product_variant {\n          sku\n          product {\n            id\n            name\n          }\n        }\n      }\n    }\n  }\n";
 export declare const GET_ORDER_BY_PK = "\n  query GetOrderByPk($orderId: uuid!) {\n    orders(where: { id: { _eq: $orderId } }) {\n      id\n      order_number\n      status\n      fulfillment_family\n      discount\n      tax\n      total_without_tax\n      total_with_tax\n      total_with_discount\n      created_at\n      updated_at\n      order_product_variants {\n        id\n        product_variant_id\n        quantity\n        product_variant {\n          sku\n          product {\n            id\n            name\n          }\n        }\n      }\n    }\n  }\n";
 export declare const GET_PUBLIC_ORDER = "\n  mutation GetPublicOrder($websiteId: uuid!, $orderId: uuid!, $token: String!) {\n    websiteGetPublicOrder(\n      website_id: $websiteId\n      order_id: $orderId\n      token: $token\n    ) {\n      success\n      order {\n        order_id\n        order_number\n        status\n        payment_status\n        fulfillment_family\n        delivery {\n          fulfillment_family\n          shipping {\n            label\n            amount\n            method_type\n            collection_mode\n            total_policy\n            address\n          }\n          pickup {\n            label\n          }\n        }\n        payment {\n          mode\n          label\n          method {\n            id\n            label\n            payment_method_type\n            gateway_code\n            requires_payment_session\n          }\n          initial_payment {\n            amount\n            payment_method_id\n            method_label\n            payment_method_type\n            gateway_code\n            requires_payment_session\n          }\n          requires_payment_session\n          next_action\n          session {\n            id\n            gateway_code\n            integration_mode\n            status\n            reference\n            amount\n            currency\n            gateway_transaction_id\n            error_message\n            expires_at\n            created_at\n            updated_at\n          }\n        }\n        totals {\n          subtotal\n          tax\n          discount\n          total\n          total_with_discount\n        }\n        items {\n          id\n          product_variant_id\n          sku\n          name\n          image_file_id\n          quantity\n          unit_price\n          line_total\n        }\n        next_steps\n        created_at\n        updated_at\n      }\n      errors\n    }\n  }\n";

package/types.d.ts

@@ -151,7 +151,7 @@ export interface WebsiteCampaignCaptureResult {
 }
 export type WebsiteFormAction = "STORE_RESPONSE" | "CAPTURE_LEAD";
 export type WebsiteFormStatus = "ACTIVE" | "PAUSED";
-export type WebsiteFormFieldType = "text" | "textarea" | "email" | "phone" | "number" | "date" | "select" | "radio" | "multi_select" | "checkbox";
+export type WebsiteFormFieldType = "text" | "textarea" | "email" | "phone" | "number" | "scale" | "date" | "select" | "radio" | "multi_select" | "checkbox";
 export interface WebsiteFormOption {
     value: string;
     label: string;
@@ -164,10 +164,23 @@ export type WebsiteFormOptionSource = {
     listKey: string;
 };
 export interface WebsiteFormField {
+    /** A single-choice question may reveal one branch, recursively. */
+    branches?: Array<{
+        value: string;
+        fields: WebsiteFormField[];
+    }>;
     key: string;
     label: string;
     type: WebsiteFormFieldType;
     required: boolean;
+    /** Discrete integer scale; submitted as a string, stored as a number. */
+    scale?: {
+        min: number;
+        max: number;
+        display: "numbers" | "stars";
+        minLabel?: string;
+        maxLabel?: string;
+    };
     placeholder?: string | null;
     helpText?: string | null;
     optionSource?: WebsiteFormOptionSource | null;
@@ -267,6 +280,10 @@ export interface WebsiteMarketingPublicConfig {
         clarity?: {
             projectId: string;
         } | null;
+        /** Optional web container. Does not replace native GA4/Meta destinations. */
+        gtm?: {
+            containerId: string;
+        } | null;
     };
 }
 export type WebsiteCustomerIdentifierType = "AUTO" | "EMAIL" | "PHONE" | "DOCUMENT";