@bacano/sdk 1.2.7 → 1.2.9

package/index.cjs

@@ -3338,6 +3338,78 @@ function hasRecoverableCartSessionError(errors) {
   );
 }
 
+// libs/sdk/src/modules/checkout-contact.ts
+var EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var PHONE_PATTERN = /^\+?\d{7,15}$/;
+function validEmail(value) {
+  if (value.length > 320 || !EMAIL_PATTERN.test(value)) return false;
+  const [local, domain] = value.split("@");
+  if (!local || !domain || local.length > 64 || domain.length > 255 || local.startsWith(".") || local.endsWith(".") || local.includes("..")) {
+    return false;
+  }
+  return domain.split(".").every((label) => /^[a-z\d](?:[a-z\d-]*[a-z\d])?$/i.test(label));
+}
+function normalizePhone(value) {
+  return value.trim().replace(/[\s().-]/g, "");
+}
+function invalidContact(field) {
+  const messages = {
+    email: "Revisa el correo electr\xF3nico: debe estar completo y sin espacios.",
+    phone: "Revisa el n\xFAmero de tel\xE9fono: usa entre 7 y 15 d\xEDgitos.",
+    contact: "Ingresa un correo electr\xF3nico o un n\xFAmero de tel\xE9fono v\xE1lido."
+  };
+  return new WebsiteError(
+    messages[field],
+    `INVALID_CHECKOUT_${field.toUpperCase()}`
+  );
+}
+function normalizeCheckoutContact(contact, mode) {
+  const email = contact.email?.trim() || void 0;
+  const phone = contact.phone ? normalizePhone(contact.phone) : void 0;
+  const cellphone = contact.cellphone ? normalizePhone(contact.cellphone) : void 0;
+  const emailValid = !email || validEmail(email);
+  const phoneValid = !phone || PHONE_PATTERN.test(phone);
+  const cellphoneValid = !cellphone || PHONE_PATTERN.test(cellphone);
+  if (mode === "submit") {
+    if (!emailValid) throw invalidContact("email");
+    if (!phoneValid || !cellphoneValid) throw invalidContact("phone");
+  }
+  const normalized = {
+    ...contact,
+    name: contact.name?.trim() || void 0,
+    firstName: contact.firstName?.trim() || void 0,
+    lastName: contact.lastName?.trim() || void 0,
+    email: emailValid ? email : void 0,
+    phone: phoneValid ? phone : void 0,
+    cellphone: cellphoneValid ? cellphone : void 0
+  };
+  if ((normalized.name?.length ?? 0) > 160 || (normalized.firstName?.length ?? 0) > 80 || (normalized.lastName?.length ?? 0) > 80) {
+    throw new WebsiteError(
+      "Revisa los datos de contacto: el nombre es demasiado largo.",
+      "INVALID_CHECKOUT_CONTACT"
+    );
+  }
+  if (!normalized.email && !normalized.phone && !normalized.cellphone) {
+    throw invalidContact(
+      !emailValid ? "email" : !phoneValid || !cellphoneValid ? "phone" : "contact"
+    );
+  }
+  return normalized;
+}
+function explainCheckoutRequestError(error) {
+  if (error instanceof GraphQLRequestError && error.graphqlErrors.some(
+    (item) => /invalid request payload|hay un error en los datos del pedido/i.test(
+      item.message
+    )
+  )) {
+    throw new WebsiteError(
+      "Hay un error en los datos del pedido. Rev\xEDsalos e intenta de nuevo.",
+      "INVALID_CHECKOUT_DATA"
+    );
+  }
+  throw error;
+}
+
 // libs/sdk/src/modules/cart.ts
 function mapCartItem(raw) {
   return {
@@ -3413,6 +3485,15 @@ function requireCartSession(storage) {
   return session;
 }
 function createCartModule(graphqlUrl, getHeaders, getContext, cartSessionStorage) {
+  let pendingCartSessionOperation = Promise.resolve();
+  function enqueueCartSessionOperation(run) {
+    const operation = pendingCartSessionOperation.then(run, run);
+    pendingCartSessionOperation = operation.then(
+      () => void 0,
+      () => void 0
+    );
+    return operation;
+  }
   async function fetchCart(orderId, cartToken) {
     const data = await executeGraphQL(graphqlUrl, GET_CART, { orderId, cartToken }, getHeaders);
     const result = data.websiteGetCart;
@@ -3435,72 +3516,80 @@ function createCartModule(graphqlUrl, getHeaders, getContext, cartSessionStorage
   }
   return {
     async getOrCreate(contact, fulfillmentFamily) {
-      const ctx = getContext();
-      if (!ctx.chainId) {
-        throw new WebsiteError(
-          "This website has no chain configured. Cart requires a chain_id.",
-          "NO_CHAIN"
-        );
-      }
-      const existing = cartSessionStorage.get();
-      const data = await executeGraphQL(
-        graphqlUrl,
-        CREATE_CART,
-        {
-          websiteId: ctx.websiteId,
-          cartToken: existing?.cartToken,
-          contact,
-          fulfillmentFamily
-        },
-        getHeaders
-      );
-      const result = data.websiteCreateCart;
-      assertActionSuccess(result, "CART_CREATE_ERROR");
-      cartSessionStorage.set({
-        orderId: result.order_id,
-        cartToken: result.cart_token
-      });
-      return mapCart(result.cart, result.cart_token);
-    },
-    async startCheckout(input) {
-      const ctx = getContext();
-      if (!ctx.chainId) {
-        throw new WebsiteError(
-          "This website has no chain configured. Checkout requires a chain_id.",
-          "NO_CHAIN"
-        );
-      }
-      const requestStartCheckout = async (cartToken) => {
+      return enqueueCartSessionOperation(async () => {
+        const normalizedContact = contact ? normalizeCheckoutContact(contact, "draft") : void 0;
+        const ctx = getContext();
+        if (!ctx.chainId) {
+          throw new WebsiteError(
+            "This website has no chain configured. Cart requires a chain_id.",
+            "NO_CHAIN"
+          );
+        }
+        const existing = cartSessionStorage.get();
         const data = await executeGraphQL(
           graphqlUrl,
-          START_GUEST_CHECKOUT,
+          CREATE_CART,
           {
             websiteId: ctx.websiteId,
-            cartToken,
-            contact: input.contact,
-            fulfillmentFamily: input.fulfillmentFamily,
-            items: input.items.map((item) => ({
-              product_variant_id: item.productVariantId,
-              quantity: item.quantity
-            })),
-            marketingAttribution: input.marketingAttribution ? serializeWebsiteMarketingAttribution(input.marketingAttribution) : void 0
+            cartToken: existing?.cartToken,
+            contact: normalizedContact,
+            fulfillmentFamily
           },
           getHeaders
-        );
-        return data.websiteStartGuestCheckout;
-      };
-      const existing = cartSessionStorage.get();
-      let result = await requestStartCheckout(existing?.cartToken);
-      if (existing && !result.success && hasRecoverableCartSessionError(result.errors)) {
-        cartSessionStorage.clear();
-        result = await requestStartCheckout();
-      }
-      assertActionSuccess(result, "CHECKOUT_START_ERROR");
-      cartSessionStorage.set({
-        orderId: result.order_id,
-        cartToken: result.cart_token
+        ).catch(explainCheckoutRequestError);
+        const result = data.websiteCreateCart;
+        assertActionSuccess(result, "CART_CREATE_ERROR");
+        cartSessionStorage.set({
+          orderId: result.order_id,
+          cartToken: result.cart_token
+        });
+        return mapCart(result.cart, result.cart_token);
+      });
+    },
+    async startCheckout(input) {
+      return enqueueCartSessionOperation(async () => {
+        const contact = normalizeCheckoutContact(input.contact, "draft");
+        const ctx = getContext();
+        if (!ctx.chainId) {
+          throw new WebsiteError(
+            "This website has no chain configured. Checkout requires a chain_id.",
+            "NO_CHAIN"
+          );
+        }
+        const requestStartCheckout = async (cartToken) => {
+          const data = await executeGraphQL(
+            graphqlUrl,
+            START_GUEST_CHECKOUT,
+            {
+              websiteId: ctx.websiteId,
+              cartToken,
+              contact,
+              fulfillmentFamily: input.fulfillmentFamily,
+              items: input.items.map((item) => ({
+                product_variant_id: item.productVariantId,
+                quantity: item.quantity
+              })),
+              marketingAttribution: input.marketingAttribution ? serializeWebsiteMarketingAttribution(
+                input.marketingAttribution
+              ) : void 0
+            },
+            getHeaders
+          ).catch(explainCheckoutRequestError);
+          return data.websiteStartGuestCheckout;
+        };
+        const existing = cartSessionStorage.get();
+        let result = await requestStartCheckout(existing?.cartToken);
+        if (existing && !result.success && hasRecoverableCartSessionError(result.errors)) {
+          cartSessionStorage.clear();
+          result = await requestStartCheckout();
+        }
+        assertActionSuccess(result, "CHECKOUT_START_ERROR");
+        cartSessionStorage.set({
+          orderId: result.order_id,
+          cartToken: result.cart_token
+        });
+        return mapCart(result.cart, result.cart_token);
       });
-      return mapCart(result.cart, result.cart_token);
     },
     async get() {
       const session = cartSessionStorage.get();
@@ -5599,6 +5688,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
       return mapCouponResult(data.websiteRemoveCoupon);
     },
     async submit(input) {
+      const contact = normalizeCheckoutContact(input.contact, "submit");
       const session = requireCartSession2(cartSessionStorage);
       const data = await executeGraphQL(
         graphqlUrl,
@@ -5606,7 +5696,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
         {
           orderId: session.orderId,
           cartToken: session.cartToken,
-          contact: input.contact,
+          contact,
           fulfillmentFamily: input.fulfillmentFamily,
           address: input.address,
           shippingQuoteId: input.shippingQuoteId,
@@ -5626,7 +5716,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
           } : void 0
         },
         getHeaders
-      );
+      ).catch(explainCheckoutRequestError);
       const result = data.websiteCheckout;
       if (!result.success && result.errors && result.errors.length > 0) {
         throw new CheckoutError(result.errors);
@@ -5667,7 +5757,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
           returnUrl: input.returnUrl
         },
         getHeaders
-      );
+      ).catch(explainCheckoutRequestError);
       const result = data.websiteCreatePaymentSession;
       if (result.success && result.payment_session_id && (result.integration_mode !== "redirect" || !result.redirect_url)) {
         throw new WebsiteError(
@@ -5702,7 +5792,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
           gatewayTransactionId: input.gatewayTransactionId
         },
         getHeaders
-      );
+      ).catch(explainCheckoutRequestError);
       const result = data.websiteReconcilePaymentSession;
       return {
         success: result.success,

package/index.js

@@ -3277,6 +3277,78 @@ function hasRecoverableCartSessionError(errors) {
   );
 }
 
+// libs/sdk/src/modules/checkout-contact.ts
+var EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var PHONE_PATTERN = /^\+?\d{7,15}$/;
+function validEmail(value) {
+  if (value.length > 320 || !EMAIL_PATTERN.test(value)) return false;
+  const [local, domain] = value.split("@");
+  if (!local || !domain || local.length > 64 || domain.length > 255 || local.startsWith(".") || local.endsWith(".") || local.includes("..")) {
+    return false;
+  }
+  return domain.split(".").every((label) => /^[a-z\d](?:[a-z\d-]*[a-z\d])?$/i.test(label));
+}
+function normalizePhone(value) {
+  return value.trim().replace(/[\s().-]/g, "");
+}
+function invalidContact(field) {
+  const messages = {
+    email: "Revisa el correo electr\xF3nico: debe estar completo y sin espacios.",
+    phone: "Revisa el n\xFAmero de tel\xE9fono: usa entre 7 y 15 d\xEDgitos.",
+    contact: "Ingresa un correo electr\xF3nico o un n\xFAmero de tel\xE9fono v\xE1lido."
+  };
+  return new WebsiteError(
+    messages[field],
+    `INVALID_CHECKOUT_${field.toUpperCase()}`
+  );
+}
+function normalizeCheckoutContact(contact, mode) {
+  const email = contact.email?.trim() || void 0;
+  const phone = contact.phone ? normalizePhone(contact.phone) : void 0;
+  const cellphone = contact.cellphone ? normalizePhone(contact.cellphone) : void 0;
+  const emailValid = !email || validEmail(email);
+  const phoneValid = !phone || PHONE_PATTERN.test(phone);
+  const cellphoneValid = !cellphone || PHONE_PATTERN.test(cellphone);
+  if (mode === "submit") {
+    if (!emailValid) throw invalidContact("email");
+    if (!phoneValid || !cellphoneValid) throw invalidContact("phone");
+  }
+  const normalized = {
+    ...contact,
+    name: contact.name?.trim() || void 0,
+    firstName: contact.firstName?.trim() || void 0,
+    lastName: contact.lastName?.trim() || void 0,
+    email: emailValid ? email : void 0,
+    phone: phoneValid ? phone : void 0,
+    cellphone: cellphoneValid ? cellphone : void 0
+  };
+  if ((normalized.name?.length ?? 0) > 160 || (normalized.firstName?.length ?? 0) > 80 || (normalized.lastName?.length ?? 0) > 80) {
+    throw new WebsiteError(
+      "Revisa los datos de contacto: el nombre es demasiado largo.",
+      "INVALID_CHECKOUT_CONTACT"
+    );
+  }
+  if (!normalized.email && !normalized.phone && !normalized.cellphone) {
+    throw invalidContact(
+      !emailValid ? "email" : !phoneValid || !cellphoneValid ? "phone" : "contact"
+    );
+  }
+  return normalized;
+}
+function explainCheckoutRequestError(error) {
+  if (error instanceof GraphQLRequestError && error.graphqlErrors.some(
+    (item) => /invalid request payload|hay un error en los datos del pedido/i.test(
+      item.message
+    )
+  )) {
+    throw new WebsiteError(
+      "Hay un error en los datos del pedido. Rev\xEDsalos e intenta de nuevo.",
+      "INVALID_CHECKOUT_DATA"
+    );
+  }
+  throw error;
+}
+
 // libs/sdk/src/modules/cart.ts
 function mapCartItem(raw) {
   return {
@@ -3352,6 +3424,15 @@ function requireCartSession(storage) {
   return session;
 }
 function createCartModule(graphqlUrl, getHeaders, getContext, cartSessionStorage) {
+  let pendingCartSessionOperation = Promise.resolve();
+  function enqueueCartSessionOperation(run) {
+    const operation = pendingCartSessionOperation.then(run, run);
+    pendingCartSessionOperation = operation.then(
+      () => void 0,
+      () => void 0
+    );
+    return operation;
+  }
   async function fetchCart(orderId, cartToken) {
     const data = await executeGraphQL(graphqlUrl, GET_CART, { orderId, cartToken }, getHeaders);
     const result = data.websiteGetCart;
@@ -3374,72 +3455,80 @@ function createCartModule(graphqlUrl, getHeaders, getContext, cartSessionStorage
   }
   return {
     async getOrCreate(contact, fulfillmentFamily) {
-      const ctx = getContext();
-      if (!ctx.chainId) {
-        throw new WebsiteError(
-          "This website has no chain configured. Cart requires a chain_id.",
-          "NO_CHAIN"
-        );
-      }
-      const existing = cartSessionStorage.get();
-      const data = await executeGraphQL(
-        graphqlUrl,
-        CREATE_CART,
-        {
-          websiteId: ctx.websiteId,
-          cartToken: existing?.cartToken,
-          contact,
-          fulfillmentFamily
-        },
-        getHeaders
-      );
-      const result = data.websiteCreateCart;
-      assertActionSuccess(result, "CART_CREATE_ERROR");
-      cartSessionStorage.set({
-        orderId: result.order_id,
-        cartToken: result.cart_token
-      });
-      return mapCart(result.cart, result.cart_token);
-    },
-    async startCheckout(input) {
-      const ctx = getContext();
-      if (!ctx.chainId) {
-        throw new WebsiteError(
-          "This website has no chain configured. Checkout requires a chain_id.",
-          "NO_CHAIN"
-        );
-      }
-      const requestStartCheckout = async (cartToken) => {
+      return enqueueCartSessionOperation(async () => {
+        const normalizedContact = contact ? normalizeCheckoutContact(contact, "draft") : void 0;
+        const ctx = getContext();
+        if (!ctx.chainId) {
+          throw new WebsiteError(
+            "This website has no chain configured. Cart requires a chain_id.",
+            "NO_CHAIN"
+          );
+        }
+        const existing = cartSessionStorage.get();
         const data = await executeGraphQL(
           graphqlUrl,
-          START_GUEST_CHECKOUT,
+          CREATE_CART,
           {
             websiteId: ctx.websiteId,
-            cartToken,
-            contact: input.contact,
-            fulfillmentFamily: input.fulfillmentFamily,
-            items: input.items.map((item) => ({
-              product_variant_id: item.productVariantId,
-              quantity: item.quantity
-            })),
-            marketingAttribution: input.marketingAttribution ? serializeWebsiteMarketingAttribution(input.marketingAttribution) : void 0
+            cartToken: existing?.cartToken,
+            contact: normalizedContact,
+            fulfillmentFamily
           },
           getHeaders
-        );
-        return data.websiteStartGuestCheckout;
-      };
-      const existing = cartSessionStorage.get();
-      let result = await requestStartCheckout(existing?.cartToken);
-      if (existing && !result.success && hasRecoverableCartSessionError(result.errors)) {
-        cartSessionStorage.clear();
-        result = await requestStartCheckout();
-      }
-      assertActionSuccess(result, "CHECKOUT_START_ERROR");
-      cartSessionStorage.set({
-        orderId: result.order_id,
-        cartToken: result.cart_token
+        ).catch(explainCheckoutRequestError);
+        const result = data.websiteCreateCart;
+        assertActionSuccess(result, "CART_CREATE_ERROR");
+        cartSessionStorage.set({
+          orderId: result.order_id,
+          cartToken: result.cart_token
+        });
+        return mapCart(result.cart, result.cart_token);
+      });
+    },
+    async startCheckout(input) {
+      return enqueueCartSessionOperation(async () => {
+        const contact = normalizeCheckoutContact(input.contact, "draft");
+        const ctx = getContext();
+        if (!ctx.chainId) {
+          throw new WebsiteError(
+            "This website has no chain configured. Checkout requires a chain_id.",
+            "NO_CHAIN"
+          );
+        }
+        const requestStartCheckout = async (cartToken) => {
+          const data = await executeGraphQL(
+            graphqlUrl,
+            START_GUEST_CHECKOUT,
+            {
+              websiteId: ctx.websiteId,
+              cartToken,
+              contact,
+              fulfillmentFamily: input.fulfillmentFamily,
+              items: input.items.map((item) => ({
+                product_variant_id: item.productVariantId,
+                quantity: item.quantity
+              })),
+              marketingAttribution: input.marketingAttribution ? serializeWebsiteMarketingAttribution(
+                input.marketingAttribution
+              ) : void 0
+            },
+            getHeaders
+          ).catch(explainCheckoutRequestError);
+          return data.websiteStartGuestCheckout;
+        };
+        const existing = cartSessionStorage.get();
+        let result = await requestStartCheckout(existing?.cartToken);
+        if (existing && !result.success && hasRecoverableCartSessionError(result.errors)) {
+          cartSessionStorage.clear();
+          result = await requestStartCheckout();
+        }
+        assertActionSuccess(result, "CHECKOUT_START_ERROR");
+        cartSessionStorage.set({
+          orderId: result.order_id,
+          cartToken: result.cart_token
+        });
+        return mapCart(result.cart, result.cart_token);
       });
-      return mapCart(result.cart, result.cart_token);
     },
     async get() {
       const session = cartSessionStorage.get();
@@ -5538,6 +5627,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
       return mapCouponResult(data.websiteRemoveCoupon);
     },
     async submit(input) {
+      const contact = normalizeCheckoutContact(input.contact, "submit");
       const session = requireCartSession2(cartSessionStorage);
       const data = await executeGraphQL(
         graphqlUrl,
@@ -5545,7 +5635,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
         {
           orderId: session.orderId,
           cartToken: session.cartToken,
-          contact: input.contact,
+          contact,
           fulfillmentFamily: input.fulfillmentFamily,
           address: input.address,
           shippingQuoteId: input.shippingQuoteId,
@@ -5565,7 +5655,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
           } : void 0
         },
         getHeaders
-      );
+      ).catch(explainCheckoutRequestError);
       const result = data.websiteCheckout;
       if (!result.success && result.errors && result.errors.length > 0) {
         throw new CheckoutError(result.errors);
@@ -5606,7 +5696,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
           returnUrl: input.returnUrl
         },
         getHeaders
-      );
+      ).catch(explainCheckoutRequestError);
       const result = data.websiteCreatePaymentSession;
       if (result.success && result.payment_session_id && (result.integration_mode !== "redirect" || !result.redirect_url)) {
         throw new WebsiteError(
@@ -5641,7 +5731,7 @@ function createCheckoutModule(graphqlUrl, getHeaders, getContext, cartSessionSto
           gatewayTransactionId: input.gatewayTransactionId
         },
         getHeaders
-      );
+      ).catch(explainCheckoutRequestError);
       const result = data.websiteReconcilePaymentSession;
       return {
         success: result.success,

package/modules/checkout-contact.d.ts

@@ -0,0 +1,4 @@
+import type { WebsiteGuestContact } from "../types";
+/** Drafts can use the valid contact channel while the buyer edits the other one. */
+export declare function normalizeCheckoutContact(contact: WebsiteGuestContact, mode: "draft" | "submit"): WebsiteGuestContact;
+export declare function explainCheckoutRequestError(error: unknown): never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacano/sdk",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "TypeScript SDK for building websites on the Bacano ERP",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -33,6 +33,11 @@
       "import": "./content-management.js",
       "require": "./content-management.cjs"
     },
+    "./catalog-management": {
+      "types": "./catalog-management.d.ts",
+      "import": "./catalog-management.js",
+      "require": "./catalog-management.cjs"
+    },
     "./react": {
       "types": "./react.d.ts",
       "import": "./react.js",