@bacano/sdk 1.0.1 → 1.1.0

package/skills/bacano-web/scripts/cli.mjs

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+
+import { createHash } from "node:crypto";
+import {
+  cpSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  readlinkSync,
+  rmSync,
+  symlinkSync,
+} from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+
+const scriptDirectory = dirname(fileURLToPath(import.meta.url));
+const sourceSkill = resolve(scriptDirectory, "..");
+const sourceSkillFile = resolve(sourceSkill, "SKILL.md");
+const projectRoot = process.cwd();
+const canonicalSkill = resolve(projectRoot, ".agents", "skills", "bacano-web");
+
+const adapterPaths = {
+  antigravity: canonicalSkill,
+  claude: resolve(projectRoot, ".claude", "skills", "bacano-web"),
+  codex: resolve(projectRoot, ".codex", "skills", "bacano-web"),
+};
+
+function usage() {
+  console.log(`Bacano Web readiness skill
+
+Usage:
+  bacano-web install [--agent antigravity|claude|codex|all] [--force]
+  bacano-web check
+
+The canonical project copy lives at .agents/skills/bacano-web.
+Claude and Codex receive links to that same copy.`);
+}
+
+function option(name) {
+  const index = process.argv.indexOf(name);
+  return index >= 0 ? process.argv[index + 1] : null;
+}
+
+function hash(file) {
+  return createHash("sha256").update(readFileSync(file)).digest("hex");
+}
+
+function skillFile(directory) {
+  return resolve(directory, "SKILL.md");
+}
+
+function relativeDisplay(path) {
+  const value = relative(projectRoot, path);
+  return value || ".";
+}
+
+function removeExisting(path, force) {
+  if (!existsSync(path)) return;
+  if (!force) {
+    throw new Error(
+      `${relativeDisplay(path)} ya existe. Usa --force para reemplazarlo.`,
+    );
+  }
+  rmSync(path, { recursive: true, force: true });
+}
+
+function installCanonical(force) {
+  if (resolve(sourceSkill) === canonicalSkill) return;
+
+  if (existsSync(skillFile(canonicalSkill))) {
+    if (hash(skillFile(canonicalSkill)) === hash(sourceSkillFile)) return;
+    removeExisting(canonicalSkill, force);
+  } else if (existsSync(canonicalSkill)) {
+    removeExisting(canonicalSkill, force);
+  }
+
+  mkdirSync(dirname(canonicalSkill), { recursive: true });
+  cpSync(sourceSkill, canonicalSkill, { recursive: true });
+}
+
+function installAdapter(agent, force) {
+  const target = adapterPaths[agent];
+  if (!target || target === canonicalSkill) return;
+
+  if (existsSync(target)) {
+    const stat = lstatSync(target);
+    if (stat.isSymbolicLink()) {
+      const resolvedLink = resolve(dirname(target), readlinkSync(target));
+      if (resolvedLink === canonicalSkill) return;
+    }
+    removeExisting(target, force);
+  }
+
+  mkdirSync(dirname(target), { recursive: true });
+  const targetReference =
+    process.platform === "win32"
+      ? canonicalSkill
+      : relative(dirname(target), canonicalSkill);
+  symlinkSync(
+    targetReference,
+    target,
+    process.platform === "win32" ? "junction" : "dir",
+  );
+}
+
+async function chooseAgent() {
+  const explicit = option("--agent");
+  if (explicit) return explicit;
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error(
+      "Indica --agent antigravity, --agent claude, --agent codex o --agent all.",
+    );
+  }
+
+  const prompt = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  const answer = await prompt.question(
+    "¿Qué agente usará la skill? [1] Antigravity [2] Claude Code [3] Codex [4] Todos: ",
+  );
+  prompt.close();
+
+  return (
+    { 1: "antigravity", 2: "claude", 3: "codex", 4: "all" }[answer.trim()] ??
+    answer.trim().toLowerCase()
+  );
+}
+
+function validateAgent(agent) {
+  if (!["antigravity", "claude", "codex", "all"].includes(agent)) {
+    throw new Error(`Agente no reconocido: ${agent || "(vacío)"}.`);
+  }
+}
+
+async function install() {
+  const agent = await chooseAgent();
+  validateAgent(agent);
+  const force = process.argv.includes("--force");
+
+  installCanonical(force);
+  if (agent === "all") {
+    installAdapter("claude", force);
+    installAdapter("codex", force);
+  } else {
+    installAdapter(agent, force);
+  }
+
+  console.log("Skill Bacano Web instalada.");
+  console.log(`Fuente canónica: ${relativeDisplay(canonicalSkill)}`);
+  if (agent === "claude" || agent === "all") {
+    console.log(`Claude Code: ${relativeDisplay(adapterPaths.claude)}`);
+  }
+  if (agent === "codex" || agent === "all") {
+    console.log(`Codex: ${relativeDisplay(adapterPaths.codex)}`);
+  }
+  console.log("Ejecuta bacano-web check para verificarla.");
+}
+
+function checkPath(name, path) {
+  if (!existsSync(path))
+    return { name, path: relativeDisplay(path), status: "missing" };
+  const file = skillFile(path);
+  if (!existsSync(file)) {
+    return { name, path: relativeDisplay(path), status: "invalid" };
+  }
+  return {
+    name,
+    path: relativeDisplay(path),
+    status: hash(file) === hash(sourceSkillFile) ? "current" : "outdated",
+    link: lstatSync(path).isSymbolicLink(),
+  };
+}
+
+function check() {
+  const results = [
+    checkPath("canonical", canonicalSkill),
+    checkPath("antigravity", adapterPaths.antigravity),
+    checkPath("claude", adapterPaths.claude),
+    checkPath("codex", adapterPaths.codex),
+  ];
+  const unique = results.filter(
+    (result, index) =>
+      results.findIndex((candidate) => candidate.path === result.path) ===
+      index,
+  );
+
+  console.table(unique);
+  const canonical = results[0];
+  if (canonical.status !== "current") {
+    console.error(
+      "Bacano Web no está instalada o está desactualizada. Ejecuta bacano-web install.",
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const adapters = results
+    .slice(2)
+    .filter((result) => result.status !== "missing");
+  if (adapters.some((result) => !result.link)) {
+    console.warn(
+      "Se detectaron copias físicas en adaptadores. Reinstala con --force para evitar divergencias.",
+    );
+  }
+  if (unique.some((result) => result.status === "outdated"))
+    process.exitCode = 1;
+}
+
+const command = process.argv[2] ?? "help";
+
+try {
+  if (command === "install") await install();
+  else if (command === "check") check();
+  else usage();
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}

package/skills/bacano-web/scripts/postinstall.mjs

@@ -0,0 +1,8 @@
+if (!process.env.CI && process.env.BACANO_SDK_HIDE_SKILL_NOTICE !== "1") {
+  console.log(`
+@bacano/sdk incluye la skill Bacano Web para evaluar sitios antes de producción.
+Instálala una vez:       pnpm exec bacano-web install --agent all
+Verifica su estado:      pnpm exec bacano-web check
+Luego invócala desde tu agente para iniciar la auditoría.
+`);
+}

package/transport/documents.d.ts

@@ -12,13 +12,14 @@ export declare const WEBSITE_GET_PRODUCT_RECOMMENDATIONS = "\n  mutation Website
 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 CHECK_AVAILABILITY = "\n  query CheckAvailability($variantIds: [uuid!]!, $chainId: uuid!) {\n    websiteProductAvailability(\n      product_variant_ids: $variantIds\n      chain_id: $chainId\n    ) {\n      product_variant_id\n      in_stock\n      label\n    }\n  }\n";
+export declare const CHECK_AVAILABILITY = "\n  query CheckAvailability($variantIds: [uuid!]!, $chainId: uuid!) {\n    websiteProductAvailability(\n      product_variant_ids: $variantIds\n      chain_id: $chainId\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    ) {\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        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 GET_CART = "\n  mutation GetCart($orderId: uuid!, $cartToken: String!) {\n    websiteGetCart(order_id: $orderId, cart_token: $cartToken) {\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        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 START_GUEST_CHECKOUT = "\n  mutation StartGuestCheckout(\n    $websiteId: uuid!\n    $cartToken: String\n    $contact: WebsiteGuestContactInput!\n    $items: [WebsiteCheckoutItemInput!]!\n    $fulfillmentFamily: String\n  ) {\n    websiteStartGuestCheckout(\n      website_id: $websiteId\n      cart_token: $cartToken\n      contact: $contact\n      items: $items\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        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 START_GUEST_CHECKOUT = "\n  mutation StartGuestCheckout(\n    $websiteId: uuid!\n    $cartToken: String\n    $contact: WebsiteGuestContactInput!\n    $items: [WebsiteCheckoutItemInput!]!\n    $fulfillmentFamily: String\n    $marketingAttribution: WebsiteMarketingAttributionInput\n  ) {\n    websiteStartGuestCheckout(\n      website_id: $websiteId\n      cart_token: $cartToken\n      contact: $contact\n      items: $items\n      fulfillment_family: $fulfillmentFamily\n      marketing_attribution: $marketingAttribution\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        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 SET_CART_ITEM = "\n  mutation SetCartItem(\n    $orderId: uuid!\n    $cartToken: String!\n    $variantId: uuid!\n    $quantity: numeric!\n  ) {\n    websiteSetCartItem(\n      order_id: $orderId\n      cart_token: $cartToken\n      product_variant_id: $variantId\n      quantity: $quantity\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        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_CART_ITEM = "\n  mutation RemoveCartItem(\n    $orderId: uuid!\n    $cartToken: String!\n    $itemId: uuid!\n  ) {\n    websiteRemoveCartItem(\n      order_id: $orderId\n      cart_token: $cartToken\n      item_id: $itemId\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        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 CHECKOUT = "\n  mutation Checkout(\n    $orderId: uuid!\n    $cartToken: String!\n    $contact: WebsiteGuestContactInput!\n    $fulfillmentFamily: String\n    $address: WebsiteAddressInput\n    $shippingQuoteId: uuid\n    $paymentMode: String\n    $paymentMethodId: uuid\n    $buyerAccountOptIn: Boolean\n    $initialPayment: WebsiteInitialPaymentInput\n  ) {\n    websiteCheckout(\n      order_id: $orderId\n      cart_token: $cartToken\n      contact: $contact\n      fulfillment_family: $fulfillmentFamily\n      address: $address\n      shipping_quote_id: $shippingQuoteId\n      payment_mode: $paymentMode\n      payment_method_id: $paymentMethodId\n      buyer_account_opt_in: $buyerAccountOptIn\n      initial_payment: $initialPayment\n    ) {\n      success\n      order_id\n      order_number\n      payment_method_id\n      public_order_token\n      requires_payment_session\n      buyer_account_invitation_requested\n      errors\n    }\n  }\n";
+export declare const CHECKOUT = "\n  mutation Checkout(\n    $orderId: uuid!\n    $cartToken: String!\n    $contact: WebsiteGuestContactInput!\n    $fulfillmentFamily: String\n    $address: WebsiteAddressInput\n    $shippingQuoteId: uuid\n    $paymentMode: String\n    $paymentMethodId: uuid\n    $buyerAccountOptIn: Boolean\n    $initialPayment: WebsiteInitialPaymentInput\n    $marketingAttribution: WebsiteMarketingAttributionInput\n    $advertisingConsent: WebsiteAdvertisingConsentInput\n  ) {\n    websiteCheckout(\n      order_id: $orderId\n      cart_token: $cartToken\n      contact: $contact\n      fulfillment_family: $fulfillmentFamily\n      address: $address\n      shipping_quote_id: $shippingQuoteId\n      payment_mode: $paymentMode\n      payment_method_id: $paymentMethodId\n      buyer_account_opt_in: $buyerAccountOptIn\n      initial_payment: $initialPayment\n      marketing_attribution: $marketingAttribution\n      advertising_consent: $advertisingConsent\n    ) {\n      success\n      order_id\n      order_number\n      payment_method_id\n      public_order_token\n      requires_payment_session\n      buyer_account_invitation_requested\n      errors\n    }\n  }\n";
 export declare const GET_LOCATION_OPTIONS = "\n  mutation GetLocationOptions($websiteId: uuid!) {\n    websiteGetLocationOptions(website_id: $websiteId) {\n      success\n      country_code\n      departments {\n        department_id\n        department_name\n        department_code\n        municipalities {\n          municipality_id\n          municipality_name\n          municipality_code\n          department_id\n          department_code\n        }\n      }\n      errors\n    }\n  }\n";
 export declare const GET_DELIVERY_OPTIONS = "\n  mutation GetDeliveryOptions($websiteId: uuid!) {\n    websiteGetDeliveryOptions(website_id: $websiteId) {\n      success\n      delivery_options {\n        id\n        fulfillment_family\n        label\n        description\n        is_enabled\n        pickup_info {\n          label\n          address\n          schedule\n          notes\n        }\n      }\n      errors\n    }\n  }\n";
 export declare const GET_SHIPPING_QUOTES = "\n  mutation GetShippingQuotes(\n    $websiteId: uuid!\n    $orderId: uuid\n    $cartToken: String\n    $items: [WebsiteCheckoutItemInput!]\n    $address: WebsiteAddressInput!\n  ) {\n    websiteGetShippingQuotes(\n      website_id: $websiteId\n      order_id: $orderId\n      cart_token: $cartToken\n      items: $items\n      address: $address\n    ) {\n      success\n      quotes {\n        quote_id\n        shipping_service_id\n        label\n        service_name\n        base_amount\n        amount\n        currency\n        collection_mode\n        total_policy\n        estimated_delivery\n        free_shipping_eligible\n        free_shipping_applied\n        free_shipping_threshold\n        free_shipping_remaining\n        free_shipping_eligible_subtotal\n      }\n      errors\n    }\n  }\n";
@@ -53,17 +54,18 @@ export declare const documents: {
     readonly WEBSITE_GET_CATALOG_PAGE: "\n  mutation WebsiteGetCatalogPage(\n    $websiteId: uuid!\n    $categoryListKey: String!\n    $attributeListKey: String!\n    $filters: WebsiteCatalogPageFiltersInput\n    $include: WebsiteCatalogPageIncludeInput\n  ) {\n    result: websiteGetCatalogPage(\n      website_id: $websiteId\n      category_list_key: $categoryListKey\n      attribute_list_key: $attributeListKey\n      filters: $filters\n      include: $include\n    ) {\n      success\n      products\n      category_list\n      attribute_list\n      filters\n      brands\n      pagination\n      applied_filters\n      debug\n      errors\n    }\n  }\n";
     readonly WEBSITE_GET_PRODUCT_RECOMMENDATIONS: "\n  mutation WebsiteGetProductRecommendations(\n    $websiteId: uuid!\n    $productId: uuid!\n    $limit: Int\n  ) {\n    result: websiteGetProductRecommendations(\n      website_id: $websiteId\n      product_id: $productId\n      limit: $limit\n    ) {\n      success\n      products\n      strategy\n      errors\n    }\n  }\n";
     readonly 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";
-    readonly CHECK_AVAILABILITY: "\n  query CheckAvailability($variantIds: [uuid!]!, $chainId: uuid!) {\n    websiteProductAvailability(\n      product_variant_ids: $variantIds\n      chain_id: $chainId\n    ) {\n      product_variant_id\n      in_stock\n      label\n    }\n  }\n";
+    readonly CHECK_AVAILABILITY: "\n  query CheckAvailability($variantIds: [uuid!]!, $chainId: uuid!) {\n    websiteProductAvailability(\n      product_variant_ids: $variantIds\n      chain_id: $chainId\n    ) {\n      product_variant_id\n      in_stock\n      label\n      max_purchasable_quantity\n    }\n  }\n";
+    readonly 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    ) {\n      product_variant_id\n      in_stock\n      label\n      max_purchasable_quantity\n    }\n  }\n";
     readonly GET_PRODUCT_FILTERS: "\n  query GetProductFilters(\n    $companyId: uuid!\n    $chainId: uuid!\n    $where: products_bool_exp = {}\n    $attributeListKey: String!\n  ) {\n    products(\n      where: {\n        _and: [\n          { company_id: { _eq: $companyId } }\n          {\n            chain_products: {\n              chain_id: { _eq: $chainId }\n              is_enabled: { _eq: true }\n              status: { _eq: active }\n            }\n          }\n          $where\n        ]\n      }\n    ) {\n      id\n      category\n      subcategory\n      color\n      brand {\n        id\n        name\n      }\n      product_attributes {\n        id\n        value\n        attribute_value {\n          id\n          code\n          sort_order\n          metadata\n        }\n        attribute {\n          id\n          name\n        }\n      }\n      product_variants(where: { is_disabled: { _eq: false } }) {\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        product_variant_attributes(order_by: { order: asc }) {\n          id\n          value\n          order\n          attribute_value {\n            id\n            code\n            sort_order\n            metadata\n          }\n          attribute {\n            id\n            name\n          }\n        }\n      }\n    }\n    catalog_attribute_lists(\n      where: {\n        company_id: { _eq: $companyId }\n        key: { _eq: $attributeListKey }\n        status: { _eq: published }\n      }\n      limit: 1\n    ) {\n      id\n      key\n      name\n      description\n      status\n      items(\n        where: { is_visible: { _eq: true } }\n        order_by: [{ sort_order: asc }, { public_label: asc }]\n      ) {\n        id\n        attribute_id\n        public_label\n        public_slug\n        sort_order\n        attribute {\n          id\n          name\n          type\n        }\n        values(\n          where: { is_visible: { _eq: true } }\n          order_by: [{ sort_order: asc }, { public_label: asc }]\n        ) {\n          id\n          attribute_value_id\n          public_label\n          public_slug\n          sort_order\n          attribute_value {\n            id\n            code\n            metadata\n          }\n        }\n      }\n    }\n  }\n";
     readonly GET_SEARCH_SUGGESTIONS: "\n  query GetSearchSuggestions(\n    $companyId: uuid!\n    $chainId: uuid!\n    $term: String!\n    $productLimit: Int = 5\n    $brandLimit: Int = 3\n  ) {\n    products(\n      where: {\n        company_id: { _eq: $companyId }\n        chain_products: {\n          chain_id: { _eq: $chainId }\n          is_enabled: { _eq: true }\n          status: { _eq: active }\n        }\n        name: { _ilike: $term }\n      }\n      limit: $productLimit\n      order_by: { name: asc }\n    ) {\n      id\n      name\n    }\n    brands(\n      where: {\n        company_id: { _eq: $companyId }\n        name: { _ilike: $term }\n        products: {\n          chain_products: {\n            chain_id: { _eq: $chainId }\n            is_enabled: { _eq: true }\n            status: { _eq: active }\n          }\n        }\n      }\n      limit: $brandLimit\n      order_by: { name: asc }\n    ) {\n      id\n      name\n    }\n  }\n";
     readonly 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";
     readonly 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";
     readonly 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        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";
     readonly GET_CART: "\n  mutation GetCart($orderId: uuid!, $cartToken: String!) {\n    websiteGetCart(order_id: $orderId, cart_token: $cartToken) {\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        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";
-    readonly START_GUEST_CHECKOUT: "\n  mutation StartGuestCheckout(\n    $websiteId: uuid!\n    $cartToken: String\n    $contact: WebsiteGuestContactInput!\n    $items: [WebsiteCheckoutItemInput!]!\n    $fulfillmentFamily: String\n  ) {\n    websiteStartGuestCheckout(\n      website_id: $websiteId\n      cart_token: $cartToken\n      contact: $contact\n      items: $items\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        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";
+    readonly START_GUEST_CHECKOUT: "\n  mutation StartGuestCheckout(\n    $websiteId: uuid!\n    $cartToken: String\n    $contact: WebsiteGuestContactInput!\n    $items: [WebsiteCheckoutItemInput!]!\n    $fulfillmentFamily: String\n    $marketingAttribution: WebsiteMarketingAttributionInput\n  ) {\n    websiteStartGuestCheckout(\n      website_id: $websiteId\n      cart_token: $cartToken\n      contact: $contact\n      items: $items\n      fulfillment_family: $fulfillmentFamily\n      marketing_attribution: $marketingAttribution\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        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";
     readonly SET_CART_ITEM: "\n  mutation SetCartItem(\n    $orderId: uuid!\n    $cartToken: String!\n    $variantId: uuid!\n    $quantity: numeric!\n  ) {\n    websiteSetCartItem(\n      order_id: $orderId\n      cart_token: $cartToken\n      product_variant_id: $variantId\n      quantity: $quantity\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        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";
     readonly REMOVE_CART_ITEM: "\n  mutation RemoveCartItem(\n    $orderId: uuid!\n    $cartToken: String!\n    $itemId: uuid!\n  ) {\n    websiteRemoveCartItem(\n      order_id: $orderId\n      cart_token: $cartToken\n      item_id: $itemId\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        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";
-    readonly CHECKOUT: "\n  mutation Checkout(\n    $orderId: uuid!\n    $cartToken: String!\n    $contact: WebsiteGuestContactInput!\n    $fulfillmentFamily: String\n    $address: WebsiteAddressInput\n    $shippingQuoteId: uuid\n    $paymentMode: String\n    $paymentMethodId: uuid\n    $buyerAccountOptIn: Boolean\n    $initialPayment: WebsiteInitialPaymentInput\n  ) {\n    websiteCheckout(\n      order_id: $orderId\n      cart_token: $cartToken\n      contact: $contact\n      fulfillment_family: $fulfillmentFamily\n      address: $address\n      shipping_quote_id: $shippingQuoteId\n      payment_mode: $paymentMode\n      payment_method_id: $paymentMethodId\n      buyer_account_opt_in: $buyerAccountOptIn\n      initial_payment: $initialPayment\n    ) {\n      success\n      order_id\n      order_number\n      payment_method_id\n      public_order_token\n      requires_payment_session\n      buyer_account_invitation_requested\n      errors\n    }\n  }\n";
+    readonly CHECKOUT: "\n  mutation Checkout(\n    $orderId: uuid!\n    $cartToken: String!\n    $contact: WebsiteGuestContactInput!\n    $fulfillmentFamily: String\n    $address: WebsiteAddressInput\n    $shippingQuoteId: uuid\n    $paymentMode: String\n    $paymentMethodId: uuid\n    $buyerAccountOptIn: Boolean\n    $initialPayment: WebsiteInitialPaymentInput\n    $marketingAttribution: WebsiteMarketingAttributionInput\n    $advertisingConsent: WebsiteAdvertisingConsentInput\n  ) {\n    websiteCheckout(\n      order_id: $orderId\n      cart_token: $cartToken\n      contact: $contact\n      fulfillment_family: $fulfillmentFamily\n      address: $address\n      shipping_quote_id: $shippingQuoteId\n      payment_mode: $paymentMode\n      payment_method_id: $paymentMethodId\n      buyer_account_opt_in: $buyerAccountOptIn\n      initial_payment: $initialPayment\n      marketing_attribution: $marketingAttribution\n      advertising_consent: $advertisingConsent\n    ) {\n      success\n      order_id\n      order_number\n      payment_method_id\n      public_order_token\n      requires_payment_session\n      buyer_account_invitation_requested\n      errors\n    }\n  }\n";
     readonly GET_LOCATION_OPTIONS: "\n  mutation GetLocationOptions($websiteId: uuid!) {\n    websiteGetLocationOptions(website_id: $websiteId) {\n      success\n      country_code\n      departments {\n        department_id\n        department_name\n        department_code\n        municipalities {\n          municipality_id\n          municipality_name\n          municipality_code\n          department_id\n          department_code\n        }\n      }\n      errors\n    }\n  }\n";
     readonly GET_DELIVERY_OPTIONS: "\n  mutation GetDeliveryOptions($websiteId: uuid!) {\n    websiteGetDeliveryOptions(website_id: $websiteId) {\n      success\n      delivery_options {\n        id\n        fulfillment_family\n        label\n        description\n        is_enabled\n        pickup_info {\n          label\n          address\n          schedule\n          notes\n        }\n      }\n      errors\n    }\n  }\n";
     readonly GET_SHIPPING_POLICY: "\n  mutation GetShippingPolicy($websiteId: uuid!) {\n    websiteGetShippingPolicy(website_id: $websiteId) {\n      success\n      policy {\n        free_shipping_enabled\n        free_shipping_threshold\n        currency\n      }\n      errors\n    }\n  }\n";

package/transport/graphql.d.ts

@@ -1,7 +1,19 @@
 export type RequestHeaders = Record<string, string>;
 export type RequestHeadersProvider = () => RequestHeaders | Promise<RequestHeaders>;
+export interface GraphQLRetryOptions {
+    /** Total attempts, including the initial request. */
+    maxAttempts?: number;
+    /** Maximum cumulative wait accepted from the server. */
+    maxTotalWaitMs?: number;
+    /** Adds delay without ever retrying before Retry-After. */
+    jitterRatio?: number;
+}
+export interface GraphQLRequestOptions {
+    /** Disabled by default. Enable only for idempotent reads. */
+    retry?: GraphQLRetryOptions;
+}
 /**
  * Minimal fetch-based GraphQL executor.
  * Zero dependencies — uses the native `fetch` API.
  */
-export declare function executeGraphQL<T = Record<string, unknown>>(url: string, query: string, variables?: Record<string, unknown>, headers?: RequestHeaders | RequestHeadersProvider): Promise<T>;
+export declare function executeGraphQL<T = Record<string, unknown>>(url: string, query: string, variables?: Record<string, unknown>, headers?: RequestHeaders | RequestHeadersProvider, options?: GraphQLRequestOptions): Promise<T>;

package/types.d.ts

@@ -1,8 +1,14 @@
+import type { WebsiteAdvertisingConsent, WebsiteMarketingAttribution } from "./marketing/types";
 export interface BacanoClientConfig {
     /** Bacano public API URL (e.g., https://api.bacanoerp.com) */
     apiUrl: string;
     /** Website slug — required tenant context for every storefront request. */
     websiteSlug: string;
+    /**
+     * Browser-safe website context already returned by `public-config`.
+     * Passing it avoids resolving the same website again through GraphQL.
+     */
+    initialContext?: BacanoClientContext;
     /** Cart session storage strategy (default: 'localStorage') */
     tokenStorage?: "localStorage" | "cookie" | "memory";
     /**
@@ -18,12 +24,134 @@ export type AccessTokenProvider = () => string | null | Promise<string | null>;
 export interface WebsitePublicConfig {
     websiteId: string;
     companyId: string;
+    /** Versioned marker for the website context embedded in public-config. */
+    contextSchemaVersion?: 1 | null;
+    chainId?: string | null;
     slug: string;
     name: string;
     domain: string | null;
+    config?: Record<string, unknown> | null;
     buyerAccountsEnabled: boolean;
     clerkPublishableKey: string | null;
     customerIdentification: WebsiteCustomerIdentificationPolicy;
+    marketing: WebsiteMarketingPublicConfig;
+    /**
+     * Optional on caller-constructed configs for compatibility with SDK 1.0.10.
+     * `getWebsitePublicConfig()` always returns this block.
+     */
+    legal?: WebsiteLegalPublicConfig;
+    /**
+     * Optional on caller-constructed configs. `getWebsitePublicConfig()` always
+     * resolves this block, including a safe disabled fallback.
+     */
+    construction?: WebsiteConstructionPublicConfig;
+}
+export interface WebsiteConstructionMedia {
+    fileId: string;
+    name: string | null;
+    altText: string | null;
+    width: number | null;
+    height: number | null;
+    originalUrl: string;
+    heroUrl: string;
+    responsiveSources: Array<{
+        width: number;
+        url: string;
+    }>;
+}
+export interface WebsiteConstructionPublicConfig {
+    schemaVersion: 1;
+    enabled: boolean;
+    /** True only on the canonical production domain without a valid preview. */
+    enforced: boolean;
+    previewAccessGranted: boolean;
+    title: string | null;
+    message: string | null;
+    desktopImage: WebsiteConstructionMedia | null;
+    mobileImage: WebsiteConstructionMedia | null;
+}
+export interface WebsiteLegalPublicConfig {
+    schemaVersion: 1;
+    version: number;
+    contentHash: string | null;
+    documents: {
+        terms: Record<string, unknown> | null;
+        /** Present in public-config from SDK 1.0.12; optional for older fixtures. */
+        shipping?: Record<string, unknown> | null;
+        /** Present in public-config from SDK 1.0.12; optional for older fixtures. */
+        returns?: Record<string, unknown> | null;
+        privacy: Record<string, unknown> | null;
+        cookies: Record<string, unknown> | null;
+    };
+    inquiriesChannel: string | null;
+    directMarketingConsent: {
+        version: number;
+        statement: string;
+        statementHash: string;
+    } | null;
+    cookieNotice: {
+        enabled: boolean;
+        message: string;
+        buttonLabel: string;
+    };
+}
+export type WebsiteCampaignCaptureSource = "WEBSITE" | "QR";
+export interface WebsiteCampaignCaptureContact {
+    partyKind?: "PERSON" | "COMPANY";
+    firstName?: string | null;
+    lastName?: string | null;
+    legalName?: string | null;
+    commercialName?: string | null;
+    email?: string | null;
+    phone?: string | null;
+}
+export interface WebsiteCampaignCaptureInput {
+    /** Stable public key configured for the campaign in Bacano. */
+    campaignKey: string;
+    /** Stable per-submission key. Reusing it is safe and does not duplicate data. */
+    idempotencyKey: string;
+    /** Use QR only when the current form was reached through a QR entry point. */
+    source?: WebsiteCampaignCaptureSource;
+    /** Must reflect an explicit acceptance of the website's current statement. */
+    commercialConsent: true;
+    contact: WebsiteCampaignCaptureContact;
+    /** Storefront-defined answers. Bacano stores these as an immutable snapshot. */
+    answers?: Record<string, unknown>;
+}
+export interface WebsiteCampaignCaptureResult {
+    accepted: boolean;
+    message: string;
+}
+export type ResolvedWebsitePublicConfig = WebsitePublicConfig & {
+    legal: WebsiteLegalPublicConfig;
+    construction: WebsiteConstructionPublicConfig;
+};
+export interface WebsiteMarketingPublicConfig {
+    schemaVersion: 1;
+    enabled: boolean;
+    currencyCode: string;
+    timeZone: string;
+    attributionWindowDays: number;
+    consentPolicy: {
+        id: string;
+        version: number;
+        statement: string;
+        statementHash: string;
+    } | null;
+    destinations: {
+        ga4: {
+            measurementId: string;
+            diagnosticMode: boolean;
+        } | null;
+        meta: {
+            pixelId: string;
+            diagnosticMode: boolean;
+        } | null;
+        /** Browser-only Microsoft Clarity destination; absent in SDK <= 1.0.14. */
+        clarity?: {
+            projectId: string;
+        } | null;
+    };
 }
 export type WebsiteCustomerIdentifierType = "AUTO" | "EMAIL" | "PHONE" | "DOCUMENT";
 export interface WebsiteCustomerDocumentType {
@@ -49,6 +177,11 @@ export interface GetWebsitePublicConfigOptions {
      * header automatically and should omit this option.
      */
     origin?: string;
+    /**
+     * Short-lived signed token generated by Bacano. Storefronts should normally
+     * let `BacanoWebsiteGate` discover and manage it automatically.
+     */
+    previewToken?: string;
 }
 export interface BacanoClientContext {
     websiteId: string;
@@ -79,6 +212,11 @@ export interface Product {
     createdAt: string;
     updatedAt: string;
     variants: ProductVariant[];
+    /**
+     * Variants visible on a product detail page. Unlike `variants`, this list
+     * also preserves enabled public-price variants that are currently sold out.
+     */
+    detailVariants?: ProductVariant[];
     media: ProductMedia[];
     attributes: ProductAttribute[];
     relatedProducts: ProductRelatedProduct[];
@@ -138,6 +276,11 @@ export interface ProductMedia {
     thumbnailUrl: string;
     cardUrl: string;
     detailUrl: string;
+    /** Width-labelled WebP candidates for responsive storefront images. */
+    responsiveSources?: Array<{
+        width: number;
+        url: string;
+    }>;
     mediaKind: ProductMediaKind;
     mimeType: string | null;
     fileName: string | null;
@@ -300,6 +443,16 @@ export interface ProductAvailability {
     productVariantId: string;
     inStock: boolean;
     label: string;
+    /** Current public purchase limit, net of active stock reservations. */
+    maxPurchasableQuantity: number;
+}
+export interface ProductVariantLiveState {
+    productVariantId: string;
+    inStock: boolean;
+    availabilityLabel: string;
+    /** Current public purchase limit, net of active stock reservations. */
+    maxPurchasableQuantity: number;
+    pricing: ProductVariantPricing;
 }
 export type ProductSortBy = "name_asc" | "name_desc" | "price_asc" | "price_desc" | "newest";
 export interface GetProductsOptions {
@@ -370,6 +523,8 @@ export interface GetProductFiltersOptions {
 }
 export interface CatalogPageIncludeOptions {
     products?: boolean;
+    /** Include sold-out public variants for statically generated detail pages. */
+    detailVariants?: boolean;
     categories?: boolean;
     attributes?: boolean;
     filters?: boolean;
@@ -443,6 +598,38 @@ export interface CatalogPageResult {
     appliedFilters: Record<string, unknown>;
     debug: CatalogPageDebug | null;
 }
+export interface GetStaticCatalogSnapshotOptions {
+    categoryListKey: string;
+    attributeListKey: string;
+    /** Products fetched per gateway request. Defaults to the server maximum. */
+    pageSize?: number;
+    /** Safety ceiling for a single build. Defaults to 10,000 products. */
+    maxProducts?: number;
+}
+export interface GetStaticCatalogBootstrapOptions extends GetStaticCatalogSnapshotOptions {
+    /** Products exposed in the initial static catalog page. Defaults to 24. */
+    initialPageSize?: number;
+    /** Stable order used by both the snapshot and its initial page. */
+    sortBy?: ProductSortBy;
+}
+export interface StaticCatalogSnapshot {
+    schemaVersion: 1;
+    snapshotId: string;
+    generatedAt: string;
+    websiteId: string;
+    products: Product[];
+    total: number;
+    pageSize: number;
+    pageCount: number;
+}
+/**
+ * Complete build snapshot plus the first renderable catalog page and facets.
+ * This avoids a second catalog request while statically generating a store.
+ */
+export interface StaticCatalogBootstrap extends StaticCatalogSnapshot {
+    bootstrapSchemaVersion: 1;
+    initialPage: CatalogPageResult;
+}
 export type ProductRecommendationSource = "manual" | "subcategory" | "category" | "attributes" | "fallback";
 export interface ProductRecommendationPricing {
     currentPriceMin: number;
@@ -482,6 +669,18 @@ export interface ContentMedia {
     thumbnailUrl?: string | null;
     cardUrl?: string | null;
     detailUrl?: string | null;
+    /** Optimized full-width editorial source, capped at the original width. */
+    heroUrl?: string | null;
+    /** Width-labelled WebP candidates for responsive storefront images. */
+    responsiveSources?: Array<{
+        width: number;
+        url: string;
+    }>;
+    /** Intrinsic dimensions of the original image when available. */
+    originalWidth?: number | null;
+    originalHeight?: number | null;
+    /** @deprecated Use originalUrl/cardUrl/detailUrl/heroUrl for the rendering context. */
+    src?: string | null;
     /** @deprecated Use originalUrl/cardUrl/detailUrl based on the rendering context. */
     url?: string | null;
 }
@@ -628,6 +827,7 @@ export interface StartGuestCheckoutInput {
     contact: WebsiteGuestContact;
     items: WebsiteCheckoutItem[];
     fulfillmentFamily?: WebsiteFulfillmentFamily;
+    marketingAttribution?: WebsiteMarketingAttribution;
 }
 export interface CheckoutSubmission {
     contact: WebsiteGuestContact;
@@ -636,6 +836,8 @@ export interface CheckoutSubmission {
     shippingQuoteId?: string;
     paymentMode?: WebsitePaymentMode;
     paymentMethodId?: string;
+    marketingAttribution?: WebsiteMarketingAttribution;
+    advertisingConsent?: WebsiteAdvertisingConsent;
     /**
      * Request an account activation email after Bacano creates a valid guest order.
      * Delivery does not depend on the order being paid.