@bacano/sdk 1.2.2 → 1.2.4

package/react.js

@@ -1065,6 +1065,35 @@ var WEBSITE_GET_PRODUCT_CONTENT = (
   }
 `
 );
+var WEBSITE_GET_PRODUCT_CONTENT_BATCH = (
+  /* GraphQL */
+  `
+  mutation WebsiteGetProductContentBatch(
+    $websiteId: uuid!
+    $productIds: [uuid!]!
+    $locale: String
+  ) {
+    result: websiteGetProductContentBatch(
+      website_id: $websiteId
+      product_ids: $productIds
+      locale: $locale
+    ) {
+      success
+      errors
+      blocks {
+        id
+        product_id
+        locale
+        content_json
+        resolved_fields
+        sort_order
+        updated_at
+        content_type { id key name kind }
+      }
+    }
+  }
+`
+);
 var CHECK_AVAILABILITY = (
   /* GraphQL */
   `
@@ -1941,7 +1970,7 @@ var RECONCILE_PAYMENT_SESSION = (
     $orderId: uuid!
     $publicOrderToken: String!
     $paymentSessionId: uuid!
-    $gatewayTransactionId: String!
+    $gatewayTransactionId: String
   ) {
     websiteReconcilePaymentSession(
       order_id: $orderId
@@ -5405,6 +5434,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}` } : {};
@@ -6715,6 +6790,33 @@ function createContentModule(graphqlUrl, getHeaders, getContext, storageUrl) {
       return (data.result.blocks ?? []).map(
         (block) => mapProductContentBlock(block, storageUrl)
       );
+    },
+    async getForProducts(productIds, opts) {
+      const uniqueIds = [...new Set(productIds.map((id) => id.toLowerCase()))];
+      const blocksByProduct = Object.fromEntries(uniqueIds.map((id) => [id, []]));
+      if (uniqueIds.length === 0) return blocksByProduct;
+      const ctx = getContext();
+      for (let start = 0; start < uniqueIds.length; start += 50) {
+        const batch = uniqueIds.slice(start, start + 50);
+        const data = await executeGraphQL(
+          graphqlUrl,
+          WEBSITE_GET_PRODUCT_CONTENT_BATCH,
+          {
+            websiteId: ctx.websiteId,
+            productIds: batch,
+            locale: opts?.locale ?? DEFAULT_LOCALE
+          },
+          getHeaders
+        );
+        if (!data.result?.success) continue;
+        for (const block of data.result.blocks ?? []) {
+          const id = block.product_id.toLowerCase();
+          if (Object.prototype.hasOwnProperty.call(blocksByProduct, id)) {
+            blocksByProduct[id].push(mapProductContentBlock(block, storageUrl));
+          }
+        }
+      }
+      return blocksByProduct;
     }
   };
 }
@@ -7429,6 +7531,7 @@ function createBacanoClient(config) {
       await initialization;
     },
     getContext,
+    flows: createFlowsClient(config),
     auth: {
       async getAccessToken() {
         return config.getAccessToken ? await config.getAccessToken() : null;
@@ -7461,7 +7564,8 @@ function createBacanoClient(config) {
       getByKey: contentModule.getByKey.bind(contentModule),
       getByCategory: contentModule.getByCategory.bind(contentModule),
       getByTag: contentModule.getByTag.bind(contentModule),
-      getForProduct: contentModule.getForProduct.bind(contentModule)
+      getForProduct: contentModule.getForProduct.bind(contentModule),
+      getForProducts: contentModule.getForProducts.bind(contentModule)
     },
     forms: {
       getDefinition: formsModule.getDefinition.bind(formsModule),

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

@@ -13,6 +13,7 @@ export declare const WEBSITE_GET_PRODUCT_SPECIFICATIONS = "\n  mutation WebsiteG
 export declare const GET_BRANDS = "\n  query GetBrands($companyId: uuid!, $chainId: uuid!) {\n    brands(\n      where: {\n        company_id: { _eq: $companyId }\n        products: {\n          chain_products: {\n            chain_id: { _eq: $chainId }\n            is_enabled: { _eq: true }\n            status: { _eq: active }\n          }\n        }\n      }\n      order_by: { name: asc }\n    ) {\n      id\n      name\n    }\n  }\n";
 export declare const WEBSITE_GET_CONTENT = "\n  mutation WebsiteGetContent(\n    $websiteId: uuid!\n    $key: String\n    $categoryKey: String\n    $tag: String\n    $locale: String\n  ) {\n    result: websiteGetContent(\n      website_id: $websiteId\n      key: $key\n      category_key: $categoryKey\n      tag: $tag\n      locale: $locale\n    ) {\n      success\n      errors\n      entries {\n        \n  id\n  key\n  category_key\n  name\n  locale\n  status\n  tags\n  content_json\n  resolved_fields\n  published_at\n  updated_at\n  content_type {\n    id\n    key\n    name\n    kind\n  }\n\n      }\n    }\n  }\n";
 export declare const WEBSITE_GET_PRODUCT_CONTENT = "\n  mutation WebsiteGetProductContent(\n    $websiteId: uuid!\n    $productId: uuid!\n    $locale: String\n  ) {\n    result: websiteGetProductContent(\n      website_id: $websiteId\n      product_id: $productId\n      locale: $locale\n    ) {\n      success\n      errors\n      blocks {\n        id\n        product_id\n        locale\n        content_json\n        resolved_fields\n        sort_order\n        updated_at\n        content_type {\n          id\n          key\n          name\n          kind\n        }\n      }\n    }\n  }\n";
+export declare const WEBSITE_GET_PRODUCT_CONTENT_BATCH = "\n  mutation WebsiteGetProductContentBatch(\n    $websiteId: uuid!\n    $productIds: [uuid!]!\n    $locale: String\n  ) {\n    result: websiteGetProductContentBatch(\n      website_id: $websiteId\n      product_ids: $productIds\n      locale: $locale\n    ) {\n      success\n      errors\n      blocks {\n        id\n        product_id\n        locale\n        content_json\n        resolved_fields\n        sort_order\n        updated_at\n        content_type { id key name kind }\n      }\n    }\n  }\n";
 export declare const CHECK_AVAILABILITY = "\n  query CheckAvailability(\n    $variantIds: [uuid!]!\n    $chainId: uuid!\n    $websiteId: uuid\n  ) {\n    websiteProductAvailability(\n      product_variant_ids: $variantIds\n      chain_id: $chainId\n      website_id: $websiteId\n    ) {\n      product_variant_id\n      in_stock\n      label\n      max_purchasable_quantity\n    }\n  }\n";
 export declare const GET_PRODUCT_LIVE_STATE = "\n  query GetProductLiveState(\n    $variantIds: [uuid!]!\n    $companyId: uuid!\n    $chainId: uuid!\n    $websiteId: uuid!\n  ) {\n    product_variants(\n      where: {\n        id: { _in: $variantIds }\n        is_disabled: { _eq: false }\n        product: {\n          company_id: { _eq: $companyId }\n          product_website_publications: {\n            website_id: { _eq: $websiteId }\n            is_visible: { _eq: true }\n          }\n          chain_products: {\n            chain_id: { _eq: $chainId }\n            is_enabled: { _eq: true }\n            status: { _eq: active }\n          }\n        }\n      }\n    ) {\n      id\n      product_variant_prices(\n        where: {\n          price_type: { _in: [CLIENT, SALE, WHOLESALE, WHOLESALE_2] }\n          _or: [\n            { chain_id: { _eq: $chainId } }\n            { chain_id: { _is_null: true } }\n          ]\n        }\n      ) {\n        id\n        price\n        price_type\n        chain_id\n      }\n    }\n    websiteProductAvailability(\n      product_variant_ids: $variantIds\n      chain_id: $chainId\n      website_id: $websiteId\n    ) {\n      product_variant_id\n      in_stock\n      label\n      max_purchasable_quantity\n    }\n  }\n";
 export declare const CREATE_CART = "\n  mutation CreateCart(\n    $websiteId: uuid!\n    $cartToken: String\n    $contact: WebsiteGuestContactInput\n    $fulfillmentFamily: String\n  ) {\n    websiteCreateCart(\n      website_id: $websiteId\n      cart_token: $cartToken\n      contact: $contact\n      fulfillment_family: $fulfillmentFamily\n    ) {\n      success\n      order_id\n      cart_token\n      cart {\n        id\n        status\n        discount\n        tax\n        total_without_tax\n        total_with_tax\n        total_with_discount\n        created_at\n        updated_at\n        volume_pricing {\n          enabled\n          eligibleQuantity\n          appliedPriceType\n          appliedMinQuantity\n          nextPriceType\n          nextMinQuantity\n          remainingQuantity\n          totalSavings\n        }\n        items {\n          id\n          product_variant_id\n          quantity\n          unit_price\n          line_total\n          base_unit_price\n          unit_savings\n          line_savings\n          volume_pricing_eligible\n          resolved_price_type\n          volume_pricing_min_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";
@@ -33,7 +34,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;