@shopify/hydrogen-react 2026.4.0 → 2026.4.2

package/dist/browser-dev/cookies-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cookies-utils.mjs","sources":["../../src/cookies-utils.tsx"],"sourcesContent":["import {ShopifyCookies} from './analytics-types.js';\nimport {SHOPIFY_Y, SHOPIFY_S} from './cart-constants.js';\nimport {getTrackingValues} from './tracking-utils.js';\n\nconst tokenHash = 'xxxx-4xxx-xxxx-xxxxxxxxxxxx';\n\nexport function buildUUID(): string {\n  let hash = '';\n\n  try {\n    const crypto: Crypto = window.crypto;\n    const randomValuesArray = new Uint16Array(31);\n    crypto.getRandomValues(randomValuesArray);\n\n    // Generate a strong UUID\n    let i = 0;\n    hash = tokenHash\n      .replace(/[x]/g, (c: string): string => {\n        const r = randomValuesArray[i] % 16;\n        const v = c === 'x' ? r : (r & 0x3) | 0x8;\n        i++;\n        return v.toString(16);\n      })\n      .toUpperCase();\n  } catch (err) {\n    // crypto not available, generate weak UUID\n    hash = tokenHash\n      .replace(/[x]/g, (c: string): string => {\n        const r = (Math.random() * 16) | 0;\n        const v = c === 'x' ? r : (r & 0x3) | 0x8;\n        return v.toString(16);\n      })\n      .toUpperCase();\n  }\n\n  return `${hexTime()}-${hash}`;\n}\n\nexport function hexTime(): string {\n  // 32 bit representations of new Date().getTime() and performance.now()\n  let dateNumber = 0;\n  let perfNumber = 0;\n\n  // Result of zero-fill right shift is always positive\n  dateNumber = new Date().getTime() >>> 0;\n\n  try {\n    perfNumber = performance.now() >>> 0;\n  } catch (err) {\n    perfNumber = 0;\n  }\n\n  const output = Math.abs(dateNumber + perfNumber)\n    .toString(16)\n    .toLowerCase();\n\n  // Ensure the output is exactly 8 characters\n  return output.padStart(8, '0');\n}\n\n/**\n * Gets the values of _shopify_y and _shopify_s cookies from the provided cookie string.\n * @deprecated Use getTrackingValues instead.\n */\nexport function getShopifyCookies(cookies: string): ShopifyCookies {\n  // @ts-expect-error - Undeclared argument type\n  const trackingValues = getTrackingValues(cookies);\n\n  return {\n    [SHOPIFY_Y]: trackingValues.uniqueToken,\n    [SHOPIFY_S]: trackingValues.visitToken,\n  };\n}\n"],"names":[],"mappings":";;AAIA,MAAM,YAAY;AAEX,SAAS,YAAoB;AAClC,MAAI,OAAO;AAEX,MAAI;AACF,UAAM,SAAiB,OAAO;AAC9B,UAAM,oBAAoB,IAAI,YAAY,EAAE;AAC5C,WAAO,gBAAgB,iBAAiB;AAGxC,QAAI,IAAI;AACR,WAAO,UACJ,QAAQ,QAAQ,CAAC,MAAsB;AACtC,YAAM,IAAI,kBAAkB,CAAC,IAAI;AACjC,YAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC;AACA,aAAO,EAAE,SAAS,EAAE;AAAA,IACtB,CAAC,EACA,YAAA;AAAA,EACL,SAAS,KAAK;AAEZ,WAAO,UACJ,QAAQ,QAAQ,CAAC,MAAsB;AACtC,YAAM,IAAK,KAAK,OAAA,IAAW,KAAM;AACjC,YAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,aAAO,EAAE,SAAS,EAAE;AAAA,IACtB,CAAC,EACA,YAAA;AAAA,EACL;AAEA,SAAO,GAAG,QAAA,CAAS,IAAI,IAAI;AAC7B;AAEO,SAAS,UAAkB;AAEhC,MAAI,aAAa;AACjB,MAAI,aAAa;AAGjB,gBAAa,oBAAI,QAAO,QAAA,MAAc;AAEtC,MAAI;AACF,iBAAa,YAAY,UAAU;AAAA,EACrC,SAAS,KAAK;AACZ,iBAAa;AAAA,EACf;AAEA,QAAM,SAAS,KAAK,IAAI,aAAa,UAAU,EAC5C,SAAS,EAAE,EACX,YAAA;AAGH,SAAO,OAAO,SAAS,GAAG,GAAG;AAC/B;AAMO,SAAS,kBAAkB,SAAiC;AAEjE,QAAM,iBAAiB,kBAAkB,OAAO;AAEhD,SAAO;AAAA,IACL,CAAC,SAAS,GAAG,eAAe;AAAA,IAC5B,CAAC,SAAS,GAAG,eAAe;AAAA,EAAA;AAEhC;"}
+{"version":3,"file":"cookies-utils.mjs","names":[],"sources":["../../src/cookies-utils.tsx"],"sourcesContent":["import {ShopifyCookies} from './analytics-types.js';\nimport {SHOPIFY_Y, SHOPIFY_S} from './cart-constants.js';\nimport {getTrackingValues} from './tracking-utils.js';\n\nconst tokenHash = 'xxxx-4xxx-xxxx-xxxxxxxxxxxx';\n\nexport function buildUUID(): string {\n  let hash = '';\n\n  try {\n    const crypto: Crypto = window.crypto;\n    const randomValuesArray = new Uint16Array(31);\n    crypto.getRandomValues(randomValuesArray);\n\n    // Generate a strong UUID\n    let i = 0;\n    hash = tokenHash\n      .replace(/[x]/g, (c: string): string => {\n        const r = randomValuesArray[i] % 16;\n        const v = c === 'x' ? r : (r & 0x3) | 0x8;\n        i++;\n        return v.toString(16);\n      })\n      .toUpperCase();\n  } catch (err) {\n    // crypto not available, generate weak UUID\n    hash = tokenHash\n      .replace(/[x]/g, (c: string): string => {\n        const r = (Math.random() * 16) | 0;\n        const v = c === 'x' ? r : (r & 0x3) | 0x8;\n        return v.toString(16);\n      })\n      .toUpperCase();\n  }\n\n  return `${hexTime()}-${hash}`;\n}\n\nexport function hexTime(): string {\n  // 32 bit representations of new Date().getTime() and performance.now()\n  let dateNumber = 0;\n  let perfNumber = 0;\n\n  // Result of zero-fill right shift is always positive\n  dateNumber = new Date().getTime() >>> 0;\n\n  try {\n    perfNumber = performance.now() >>> 0;\n  } catch (err) {\n    perfNumber = 0;\n  }\n\n  const output = Math.abs(dateNumber + perfNumber)\n    .toString(16)\n    .toLowerCase();\n\n  // Ensure the output is exactly 8 characters\n  return output.padStart(8, '0');\n}\n\n/**\n * Gets the values of _shopify_y and _shopify_s cookies from the provided cookie string. If the Shopify cookies doesn't exist, this method will return an empty string for each missing cookie.\n * @deprecated Use getTrackingValues instead.\n * @publicDocs\n */\nexport function getShopifyCookies(cookies: string): ShopifyCookies {\n  // @ts-expect-error - Undeclared argument type\n  const trackingValues = getTrackingValues(cookies);\n\n  return {\n    [SHOPIFY_Y]: trackingValues.uniqueToken,\n    [SHOPIFY_S]: trackingValues.visitToken,\n  };\n}\n"],"mappings":";;;AAIA,IAAM,YAAY;AAElB,SAAgB,YAAoB;CAClC,IAAI,OAAO;AAEX,KAAI;EACF,MAAM,SAAiB,OAAO;EAC9B,MAAM,oBAAoB,IAAI,YAAY,GAAG;AAC7C,SAAO,gBAAgB,kBAAkB;EAGzC,IAAI,IAAI;AACR,SAAO,UACJ,QAAQ,SAAS,MAAsB;GACtC,MAAM,IAAI,kBAAkB,KAAK;GACjC,MAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC;AACA,UAAO,EAAE,SAAS,GAAG;IACrB,CACD,aAAa;UACT,KAAK;AAEZ,SAAO,UACJ,QAAQ,SAAS,MAAsB;GACtC,MAAM,IAAK,KAAK,QAAQ,GAAG,KAAM;AAEjC,WADU,MAAM,MAAM,IAAK,IAAI,IAAO,GAC7B,SAAS,GAAG;IACrB,CACD,aAAa;;AAGlB,QAAO,GAAG,SAAS,CAAC,GAAG;;AAGzB,SAAgB,UAAkB;CAEhC,IAAI,aAAa;CACjB,IAAI,aAAa;AAGjB,+BAAa,IAAI,MAAM,EAAC,SAAS,KAAK;AAEtC,KAAI;AACF,eAAa,YAAY,KAAK,KAAK;UAC5B,KAAK;AACZ,eAAa;;AAQf,QALe,KAAK,IAAI,aAAa,WAAW,CAC7C,SAAS,GAAG,CACZ,aAAa,CAGF,SAAS,GAAG,IAAI;;;;;;;AAQhC,SAAgB,kBAAkB,SAAiC;CAEjE,MAAM,iBAAiB,kBAAkB,QAAQ;AAEjD,QAAO;GACJ,YAAY,eAAe;GAC3B,YAAY,eAAe;EAC7B"}

package/dist/browser-dev/flatten-connection.mjs

@@ -1,31 +1,25 @@
+//#region src/flatten-connection.ts
+/**
+* The `flattenConnection` utility transforms a connection object from the Storefront API (for example, [Product-related connections](https://shopify.dev/api/storefront/reference/products/product)) into a flat array of nodes.
+* The utility works with either `nodes` or `edges.node`.
+*
+* If `connection` is null or undefined, will return an empty array instead in production. In development, an error will be thrown.
+* @publicDocs
+*/
 function flattenConnection(connection) {
-  if (!connection) {
-    const noConnectionErr = `flattenConnection(): needs a 'connection' to flatten, but received '${connection ?? ""}' instead.`;
-    {
-      throw new Error(noConnectionErr);
-    }
-  }
-  if ("nodes" in connection) {
-    return connection.nodes;
-  }
-  if ("edges" in connection && Array.isArray(connection.edges)) {
-    return connection.edges.map((edge) => {
-      if (!(edge == null ? void 0 : edge.node)) {
-        throw new Error(
-          "flattenConnection(): Connection edges must contain nodes"
-        );
-      }
-      return edge.node;
-    });
-  }
-  {
-    console.warn(
-      `flattenConnection(): The connection did not contain either "nodes" or "edges.node". Returning an empty array.`
-    );
-  }
-  return [];
+	if (!connection) {
+		const noConnectionErr = `flattenConnection(): needs a 'connection' to flatten, but received '${connection ?? ""}' instead.`;
+		throw new Error(noConnectionErr);
+	}
+	if ("nodes" in connection) return connection.nodes;
+	if ("edges" in connection && Array.isArray(connection.edges)) return connection.edges.map((edge) => {
+		if (!edge?.node) throw new Error("flattenConnection(): Connection edges must contain nodes");
+		return edge.node;
+	});
+	console.warn(`flattenConnection(): The connection did not contain either "nodes" or "edges.node". Returning an empty array.`);
+	return [];
 }
-export {
-  flattenConnection
-};
-//# sourceMappingURL=flatten-connection.mjs.map
+//#endregion
+export { flattenConnection };
+
+//# sourceMappingURL=flatten-connection.mjs.map

package/dist/browser-dev/flatten-connection.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"flatten-connection.mjs","sources":["../../src/flatten-connection.ts"],"sourcesContent":["import type {PartialDeep} from 'type-fest';\n\n/**\n * The `flattenConnection` utility transforms a connection object from the Storefront API (for example, [Product-related connections](https://shopify.dev/api/storefront/reference/products/product)) into a flat array of nodes.\n * The utility works with either `nodes` or `edges.node`.\n *\n * If `connection` is null or undefined, will return an empty array instead in production. In development, an error will be thrown.\n */\nexport function flattenConnection<\n  ConnectionGeneric extends\n    | PartialDeep<ConnectionEdges, {recurseIntoArrays: true}>\n    | PartialDeep<ConnectionNodes, {recurseIntoArrays: true}>\n    | ConnectionEdges\n    | ConnectionNodes,\n>(\n  connection?: ConnectionGeneric,\n): ConnectionGeneric extends\n  | {\n      edges: Array<{node: infer ConnectionBaseType}>;\n    }\n  | {\n      nodes: Array<infer ConnectionBaseType>;\n    }\n  ? // if it's not a PartialDeep, then return the infered type\n    ConnectionBaseType[]\n  : ConnectionGeneric extends\n        | PartialDeep<\n            {edges: {node: Array<infer ConnectionBaseType>}},\n            {recurseIntoArrays: true}\n          >\n        | PartialDeep<\n            {\n              nodes: Array<infer ConnectionBaseType>;\n            },\n            {recurseIntoArrays: true}\n          >\n    ? // if it is a PartialDeep, return a PartialDeep inferred type\n      PartialDeep<ConnectionBaseType[], {recurseIntoArrays: true}>\n    : never {\n  if (!connection) {\n    const noConnectionErr = `flattenConnection(): needs a 'connection' to flatten, but received '${\n      connection ?? ''\n    }' instead.`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noConnectionErr);\n    } else {\n      console.error(noConnectionErr + ` Returning an empty array`);\n      // @ts-expect-error We don't want to crash prod, so return an empty array\n      return [];\n    }\n  }\n\n  if ('nodes' in connection) {\n    // @ts-expect-error return type is failing\n    return connection.nodes;\n  }\n\n  if ('edges' in connection && Array.isArray(connection.edges)) {\n    // @ts-expect-error return type is failing\n    return connection.edges.map((edge) => {\n      if (!edge?.node) {\n        throw new Error(\n          'flattenConnection(): Connection edges must contain nodes',\n        );\n      }\n      return edge.node;\n    }) as Array<unknown>;\n  }\n\n  if (__HYDROGEN_DEV__) {\n    console.warn(\n      `flattenConnection(): The connection did not contain either \"nodes\" or \"edges.node\". Returning an empty array.`,\n    );\n  }\n\n  // @ts-expect-error We don't want to crash prod, so return an empty array\n  return [];\n}\n\ntype ConnectionEdges = {\n  edges: Array<{node: unknown}>;\n};\n\ntype ConnectionNodes = {\n  nodes: Array<unknown>;\n};\n\n// This is only for documentation purposes, and it is not used in the code.\nexport interface ConnectionGenericForDoc {\n  connection?: ConnectionEdges | ConnectionNodes;\n}\nexport type FlattenConnectionReturnForDoc = unknown[];\n"],"names":[],"mappings":"AAQO,SAAS,kBAOd,YAuBU;AACV,MAAI,CAAC,YAAY;AACf,UAAM,kBAAkB,uEACtB,cAAc,EAChB;AACsB;AACpB,YAAM,IAAI,MAAM,eAAe;AAAA,IACjC;AAAA,EAKF;AAEA,MAAI,WAAW,YAAY;AAEzB,WAAO,WAAW;AAAA,EACpB;AAEA,MAAI,WAAW,cAAc,MAAM,QAAQ,WAAW,KAAK,GAAG;AAE5D,WAAO,WAAW,MAAM,IAAI,CAAC,SAAS;AACpC,UAAI,EAAC,6BAAM,OAAM;AACf,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,aAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAEsB;AACpB,YAAQ;AAAA,MACN;AAAA,IAAA;AAAA,EAEJ;AAGA,SAAO,CAAA;AACT;"}
+{"version":3,"file":"flatten-connection.mjs","names":[],"sources":["../../src/flatten-connection.ts"],"sourcesContent":["import type {PartialDeep} from 'type-fest';\n\n/**\n * The `flattenConnection` utility transforms a connection object from the Storefront API (for example, [Product-related connections](https://shopify.dev/api/storefront/reference/products/product)) into a flat array of nodes.\n * The utility works with either `nodes` or `edges.node`.\n *\n * If `connection` is null or undefined, will return an empty array instead in production. In development, an error will be thrown.\n * @publicDocs\n */\nexport function flattenConnection<\n  ConnectionGeneric extends\n    | PartialDeep<ConnectionEdges, {recurseIntoArrays: true}>\n    | PartialDeep<ConnectionNodes, {recurseIntoArrays: true}>\n    | ConnectionEdges\n    | ConnectionNodes,\n>(\n  connection?: ConnectionGeneric,\n): ConnectionGeneric extends\n  | {\n      edges: Array<{node: infer ConnectionBaseType}>;\n    }\n  | {\n      nodes: Array<infer ConnectionBaseType>;\n    }\n  ? // if it's not a PartialDeep, then return the infered type\n    ConnectionBaseType[]\n  : ConnectionGeneric extends\n        | PartialDeep<\n            {edges: {node: Array<infer ConnectionBaseType>}},\n            {recurseIntoArrays: true}\n          >\n        | PartialDeep<\n            {\n              nodes: Array<infer ConnectionBaseType>;\n            },\n            {recurseIntoArrays: true}\n          >\n    ? // if it is a PartialDeep, return a PartialDeep inferred type\n      PartialDeep<ConnectionBaseType[], {recurseIntoArrays: true}>\n    : never {\n  if (!connection) {\n    const noConnectionErr = `flattenConnection(): needs a 'connection' to flatten, but received '${\n      connection ?? ''\n    }' instead.`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noConnectionErr);\n    } else {\n      console.error(noConnectionErr + ` Returning an empty array`);\n      // @ts-expect-error We don't want to crash prod, so return an empty array\n      return [];\n    }\n  }\n\n  if ('nodes' in connection) {\n    // @ts-expect-error return type is failing\n    return connection.nodes;\n  }\n\n  if ('edges' in connection && Array.isArray(connection.edges)) {\n    // @ts-expect-error return type is failing\n    return connection.edges.map((edge) => {\n      if (!edge?.node) {\n        throw new Error(\n          'flattenConnection(): Connection edges must contain nodes',\n        );\n      }\n      return edge.node;\n    }) as Array<unknown>;\n  }\n\n  if (__HYDROGEN_DEV__) {\n    console.warn(\n      `flattenConnection(): The connection did not contain either \"nodes\" or \"edges.node\". Returning an empty array.`,\n    );\n  }\n\n  // @ts-expect-error We don't want to crash prod, so return an empty array\n  return [];\n}\n\ntype ConnectionEdges = {\n  edges: Array<{node: unknown}>;\n};\n\ntype ConnectionNodes = {\n  nodes: Array<unknown>;\n};\n\n// This is only for documentation purposes, and it is not used in the code.\n/** @publicDocs */\nexport interface ConnectionGenericForDoc {\n  connection?: ConnectionEdges | ConnectionNodes;\n}\n/** @publicDocs */\nexport type FlattenConnectionReturnForDoc = unknown[];\n"],"mappings":";;;;;;;;AASA,SAAgB,kBAOd,YAuBU;AACV,KAAI,CAAC,YAAY;EACf,MAAM,kBAAkB,uEACtB,cAAc,GACf;AAEC,QAAM,IAAI,MAAM,gBAAgB;;AAQpC,KAAI,WAAW,WAEb,QAAO,WAAW;AAGpB,KAAI,WAAW,cAAc,MAAM,QAAQ,WAAW,MAAM,CAE1D,QAAO,WAAW,MAAM,KAAK,SAAS;AACpC,MAAI,CAAC,MAAM,KACT,OAAM,IAAI,MACR,2DACD;AAEH,SAAO,KAAK;GACZ;AAIF,SAAQ,KACN,gHACD;AAIH,QAAO,EAAE"}

package/dist/browser-dev/getProductOptions.mjs

@@ -1,251 +1,273 @@
 import { isOptionValueCombinationInEncodedVariant } from "./optionValueDecoder.mjs";
+//#region src/getProductOptions.ts
+/**
+* Creates a mapping of product options to their index for matching encoded values
+* For example, a product option of
+*  [
+*    \{
+*      name: 'Color',
+*      optionValues: [\{name: 'Red'\}, \{name: 'Blue'\}]
+*    \},
+*    \{
+*      name: 'Size',
+*      optionValues: [\{name: 'Small'\}, \{name: 'Medium'\}, \{name: 'Large'\}]
+*    \}
+*  ]
+* Would return
+*  \{
+*    'Color': \{Red: 0, Blue: 1\},
+*    'Size': \{Small: 0, Medium: 1, Large: 2\}
+*  \}
+*/
 function mapProductOptions(options) {
-  return Object.assign(
-    {},
-    ...options.map((option) => {
-      return {
-        [option.name]: Object.assign(
-          {},
-          ...(option == null ? void 0 : option.optionValues) ? option.optionValues.map((value, index) => {
-            return { [value.name]: index };
-          }) : []
-        )
-      };
-    })
-  );
+	return Object.assign({}, ...options.map((option) => {
+		return { [option.name]: Object.assign({}, ...option?.optionValues ? option.optionValues.map((value, index) => {
+			return { [value.name]: index };
+		}) : []) };
+	}));
 }
+/**
+* Converts the product option into an Object\<key, value\> for building query params
+* For example, a selected product option of
+*  [
+*    \{
+*      name: 'Color',
+*      value: 'Red',
+*    \},
+*    \{
+*      name: 'Size',
+*      value: 'Medium',
+*    \}
+*  ]
+* Would return
+*  \{
+*    Color: 'Red',
+*    Size: 'Medium',
+*  \}
+* @publicDocs
+*/
 function mapSelectedProductOptionToObject(options) {
-  return Object.assign(
-    {},
-    ...options.map((key) => {
-      return { [key.name]: key.value };
-    })
-  );
+	return Object.assign({}, ...options.map((key) => {
+		return { [key.name]: key.value };
+	}));
 }
+/**
+* Returns the JSON stringify result of mapSelectedProductOptionToObject
+*/
 function mapSelectedProductOptionToObjectAsString(options) {
-  return JSON.stringify(mapSelectedProductOptionToObject(options));
+	return JSON.stringify(mapSelectedProductOptionToObject(options));
 }
+/**
+* Encode the selected product option as a key for mapping to the encoded variants
+* For example, a selected product option of
+*  [
+*    \{
+*      name: 'Color',
+*      value: 'Red',
+*    \},
+*    \{
+*      name: 'Size',
+*      value: 'Medium',
+*    \}
+*  ]
+* Would return
+*  JSON.stringify(\{
+*    Color: 'Red',
+*    Size: 'Medium',
+*  \})
+*/
 function encodeSelectedProductOptionAsKey(selectedOption) {
-  if (Array.isArray(selectedOption)) {
-    return JSON.stringify(
-      Object.assign(
-        {},
-        ...selectedOption.map((option) => ({ [option.name]: option.value }))
-      )
-    );
-  } else {
-    return JSON.stringify(selectedOption);
-  }
+	if (Array.isArray(selectedOption)) return JSON.stringify(Object.assign({}, ...selectedOption.map((option) => ({ [option.name]: option.value }))));
+	else return JSON.stringify(selectedOption);
 }
+/**
+* Build the encoding array for the given selected options. For example, if we have
+* the following productOptionMappings:
+*
+*  \{
+*    'Color': \{Red: 0, Blue: 1\},
+*    'Size': \{Small: 0, Medium: 1, Large: 2\}
+*  \}
+*
+* A selectedOption of
+*
+* \{
+*    Color: 'Red',
+*    Size: 'Medium',
+* \}
+*
+* `buildEncodingArrayFromSelectedOptions` will produce
+*
+* [0,1]
+*
+* If in the case where a selected option doesn't exists in the mapping array, for example:
+*
+* \{
+*    Color: 'Red',
+*    Fabric: 'Cotton',
+*    Size: 'Medium',
+* \}
+*
+* `buildEncodingArrayFromSelectedOptions` will still produce
+*
+*  [0,1]
+*
+* This can be caused by when we do not have all the product
+* option information for the loading optimistic variant
+*/
 function buildEncodingArrayFromSelectedOptions(selectedOption, productOptionMappings) {
-  const encoding = Object.keys(selectedOption).map((key) => {
-    return productOptionMappings[key] ? productOptionMappings[key][selectedOption[key]] : null;
-  });
-  return encoding.filter((code) => code !== null);
+	return Object.keys(selectedOption).map((key) => {
+		return productOptionMappings[key] ? productOptionMappings[key][selectedOption[key]] : null;
+	}).filter((code) => code !== null);
 }
+/**
+* Takes an array of product variants and maps them to an object with the encoded selected option values as the key.
+* For example, a product variant of
+* [
+*  \{
+*    id: 1,
+*    selectedOptions: [
+*      \{name: 'Color', value: 'Red'\},
+*      \{name: 'Size', value: 'Small'\},
+*    ],
+*  \},
+*  \{
+*    id: 2,
+*    selectedOptions: [
+*      \{name: 'Color', value: 'Red'\},
+*      \{name: 'Size', value: 'Medium'\},
+*    ],
+*  \}
+* ]
+* Would return
+* \{
+*    '[0,0]': \{id: 1, selectedOptions: [\{name: 'Color', value: 'Red'\}, \{name: 'Size', value: 'Small'\}]\},
+*    '[0,1]': \{id: 2, selectedOptions: [\{name: 'Color', value: 'Red'\}, \{name: 'Size', value: 'Medium'\}]\},
+* \}
+*/
 function mapVariants(variants) {
-  return Object.assign(
-    {},
-    ...variants.map((variant) => {
-      const variantKey = encodeSelectedProductOptionAsKey(
-        variant.selectedOptions || []
-      );
-      return { [variantKey]: variant };
-    })
-  );
+	return Object.assign({}, ...variants.map((variant) => {
+		return { [encodeSelectedProductOptionAsKey(variant.selectedOptions || [])]: variant };
+	}));
 }
-const PRODUCT_INPUTS = [
-  "options",
-  "selectedOrFirstAvailableVariant",
-  "adjacentVariants"
+var PRODUCT_INPUTS = [
+	"options",
+	"selectedOrFirstAvailableVariant",
+	"adjacentVariants"
 ];
-const PRODUCT_INPUTS_EXTRA = [
-  "handle",
-  "encodedVariantExistence",
-  "encodedVariantAvailability"
+var PRODUCT_INPUTS_EXTRA = [
+	"handle",
+	"encodedVariantExistence",
+	"encodedVariantAvailability"
 ];
 function logErrorAndReturnFalse(key) {
-  console.error(
-    `[h2:error:getProductOptions] product.${key} is missing. Make sure you query for this field from the Storefront API.`
-  );
-  return false;
+	console.error(`[h2:error:getProductOptions] product.${key} is missing. Make sure you query for this field from the Storefront API.`);
+	return false;
 }
 function checkProductParam(product, checkAll = false) {
-  var _a;
-  let validParam = true;
-  const productKeys = Object.keys(product);
-  (checkAll ? [...PRODUCT_INPUTS, ...PRODUCT_INPUTS_EXTRA] : PRODUCT_INPUTS).forEach((key) => {
-    if (!productKeys.includes(key)) {
-      validParam = logErrorAndReturnFalse(key);
-    }
-  });
-  if (product.options) {
-    const firstOption = product == null ? void 0 : product.options[0];
-    if (checkAll && !(firstOption == null ? void 0 : firstOption.name)) {
-      validParam = logErrorAndReturnFalse("options.name");
-    }
-    if ((_a = product == null ? void 0 : product.options[0]) == null ? void 0 : _a.optionValues) {
-      let firstOptionValues = product.options[0].optionValues[0];
-      if (checkAll && !(firstOptionValues == null ? void 0 : firstOptionValues.name)) {
-        validParam = logErrorAndReturnFalse("options.optionValues.name");
-      }
-      firstOptionValues = product.options[0].optionValues.filter(
-        (value) => !!(value == null ? void 0 : value.firstSelectableVariant)
-      )[0];
-      if (firstOptionValues == null ? void 0 : firstOptionValues.firstSelectableVariant) {
-        validParam = checkProductVariantParam(
-          firstOptionValues.firstSelectableVariant,
-          "options.optionValues.firstSelectableVariant",
-          validParam,
-          checkAll
-        );
-      }
-    } else {
-      validParam = logErrorAndReturnFalse("options.optionValues");
-    }
-  }
-  if (product.selectedOrFirstAvailableVariant) {
-    validParam = checkProductVariantParam(
-      product.selectedOrFirstAvailableVariant,
-      "selectedOrFirstAvailableVariant",
-      validParam,
-      checkAll
-    );
-  }
-  if (!!product.adjacentVariants && product.adjacentVariants[0]) {
-    validParam = checkProductVariantParam(
-      product.adjacentVariants[0],
-      "adjacentVariants",
-      validParam,
-      checkAll
-    );
-  }
-  return validParam ? product : {};
+	let validParam = true;
+	const productKeys = Object.keys(product);
+	(checkAll ? [...PRODUCT_INPUTS, ...PRODUCT_INPUTS_EXTRA] : PRODUCT_INPUTS).forEach((key) => {
+		if (!productKeys.includes(key)) validParam = logErrorAndReturnFalse(key);
+	});
+	if (product.options) {
+		const firstOption = product?.options[0];
+		if (checkAll && !firstOption?.name) validParam = logErrorAndReturnFalse("options.name");
+		if (product?.options[0]?.optionValues) {
+			let firstOptionValues = product.options[0].optionValues[0];
+			if (checkAll && !firstOptionValues?.name) validParam = logErrorAndReturnFalse("options.optionValues.name");
+			firstOptionValues = product.options[0].optionValues.filter((value) => !!value?.firstSelectableVariant)[0];
+			if (firstOptionValues?.firstSelectableVariant) validParam = checkProductVariantParam(firstOptionValues.firstSelectableVariant, "options.optionValues.firstSelectableVariant", validParam, checkAll);
+		} else validParam = logErrorAndReturnFalse("options.optionValues");
+	}
+	if (product.selectedOrFirstAvailableVariant) validParam = checkProductVariantParam(product.selectedOrFirstAvailableVariant, "selectedOrFirstAvailableVariant", validParam, checkAll);
+	if (!!product.adjacentVariants && product.adjacentVariants[0]) validParam = checkProductVariantParam(product.adjacentVariants[0], "adjacentVariants", validParam, checkAll);
+	return validParam ? product : {};
 }
 function checkProductVariantParam(variant, key, currentValidParamState, checkAll) {
-  var _a;
-  let validParam = currentValidParamState;
-  if (checkAll && !((_a = variant.product) == null ? void 0 : _a.handle)) {
-    validParam = logErrorAndReturnFalse(`${key}.product.handle`);
-  }
-  if (variant.selectedOptions) {
-    const firstSelectedOption = variant.selectedOptions[0];
-    if (!(firstSelectedOption == null ? void 0 : firstSelectedOption.name)) {
-      validParam = logErrorAndReturnFalse(`${key}.selectedOptions.name`);
-    }
-    if (!(firstSelectedOption == null ? void 0 : firstSelectedOption.value)) {
-      validParam = logErrorAndReturnFalse(`${key}.selectedOptions.value`);
-    }
-  } else {
-    validParam = logErrorAndReturnFalse(`${key}.selectedOptions`);
-  }
-  return validParam;
+	let validParam = currentValidParamState;
+	if (checkAll && !variant.product?.handle) validParam = logErrorAndReturnFalse(`${key}.product.handle`);
+	if (variant.selectedOptions) {
+		const firstSelectedOption = variant.selectedOptions[0];
+		if (!firstSelectedOption?.name) validParam = logErrorAndReturnFalse(`${key}.selectedOptions.name`);
+		if (!firstSelectedOption?.value) validParam = logErrorAndReturnFalse(`${key}.selectedOptions.value`);
+	} else validParam = logErrorAndReturnFalse(`${key}.selectedOptions`);
+	return validParam;
 }
+/**
+* Finds all the variants provided by adjacentVariants, options.optionValues.firstAvailableVariant,
+* and selectedOrFirstAvailableVariant and return them in a single array
+* @publicDocs
+*/
 function getAdjacentAndFirstAvailableVariants(product) {
-  const checkedProduct = checkProductParam(product);
-  if (!checkedProduct.options) return [];
-  const availableVariants = {};
-  checkedProduct.options.map((option) => {
-    var _a;
-    (_a = option.optionValues) == null ? void 0 : _a.map((value) => {
-      if (value.firstSelectableVariant) {
-        const variantKey = mapSelectedProductOptionToObjectAsString(
-          value.firstSelectableVariant.selectedOptions
-        );
-        availableVariants[variantKey] = value.firstSelectableVariant;
-      }
-    });
-  });
-  checkedProduct.adjacentVariants.map((variant) => {
-    const variantKey = mapSelectedProductOptionToObjectAsString(
-      variant.selectedOptions
-    );
-    availableVariants[variantKey] = variant;
-  });
-  const selectedVariant = checkedProduct.selectedOrFirstAvailableVariant;
-  if (selectedVariant) {
-    const variantKey = mapSelectedProductOptionToObjectAsString(
-      selectedVariant.selectedOptions
-    );
-    availableVariants[variantKey] = selectedVariant;
-  }
-  return Object.values(availableVariants);
+	const checkedProduct = checkProductParam(product);
+	if (!checkedProduct.options) return [];
+	const availableVariants = {};
+	checkedProduct.options.map((option) => {
+		option.optionValues?.map((value) => {
+			if (value.firstSelectableVariant) {
+				const variantKey = mapSelectedProductOptionToObjectAsString(value.firstSelectableVariant.selectedOptions);
+				availableVariants[variantKey] = value.firstSelectableVariant;
+			}
+		});
+	});
+	checkedProduct.adjacentVariants.map((variant) => {
+		const variantKey = mapSelectedProductOptionToObjectAsString(variant.selectedOptions);
+		availableVariants[variantKey] = variant;
+	});
+	const selectedVariant = checkedProduct.selectedOrFirstAvailableVariant;
+	if (selectedVariant) {
+		const variantKey = mapSelectedProductOptionToObjectAsString(selectedVariant.selectedOptions);
+		availableVariants[variantKey] = selectedVariant;
+	}
+	return Object.values(availableVariants);
 }
+/**
+* Returns a product options array with its relevant information
+* about the variant
+* @publicDocs
+*/
 function getProductOptions(product) {
-  const checkedProduct = checkProductParam(product, true);
-  if (!checkedProduct.options) return [];
-  const {
-    options,
-    selectedOrFirstAvailableVariant: selectedVariant,
-    adjacentVariants,
-    encodedVariantExistence,
-    encodedVariantAvailability,
-    handle: productHandle
-  } = checkedProduct;
-  const selectedOptionKeys = selectedVariant == null ? void 0 : selectedVariant.selectedOptions.map(
-    (option) => option.name
-  );
-  const filteredOptions = options.filter((option) => {
-    return selectedOptionKeys && selectedOptionKeys.indexOf(option.name) >= 0;
-  });
-  const productOptionMappings = mapProductOptions(options);
-  const variants = mapVariants(
-    selectedVariant ? [selectedVariant, ...adjacentVariants] : adjacentVariants
-  );
-  const selectedOptions = mapSelectedProductOptionToObject(
-    selectedVariant ? selectedVariant.selectedOptions : []
-  );
-  const productOptions = filteredOptions.map((option, optionIndex) => {
-    return {
-      ...option,
-      optionValues: option.optionValues.map((value) => {
-        var _a;
-        const targetOptionParams = { ...selectedOptions };
-        targetOptionParams[option.name] = value.name;
-        const targetKey = encodeSelectedProductOptionAsKey(
-          targetOptionParams || []
-        );
-        const encodingKey = buildEncodingArrayFromSelectedOptions(
-          targetOptionParams || [],
-          productOptionMappings
-        );
-        const topDownKey = encodingKey.slice(0, optionIndex + 1);
-        const exists = isOptionValueCombinationInEncodedVariant(
-          topDownKey,
-          encodedVariantExistence || ""
-        );
-        const available = isOptionValueCombinationInEncodedVariant(
-          topDownKey,
-          encodedVariantAvailability || ""
-        );
-        const variant = variants[targetKey] || value.firstSelectableVariant;
-        let variantOptionParam = {};
-        if (variant) {
-          variantOptionParam = mapSelectedProductOptionToObject(
-            variant.selectedOptions || []
-          );
-        }
-        const searchParams = new URLSearchParams(variantOptionParam);
-        const handle = ((_a = variant == null ? void 0 : variant.product) == null ? void 0 : _a.handle) || productHandle;
-        return {
-          ...value,
-          variant,
-          handle,
-          variantUriQuery: searchParams.toString(),
-          selected: selectedOptions[option.name] === value.name,
-          exists,
-          available,
-          isDifferentProduct: handle !== productHandle
-        };
-      })
-    };
-  });
-  return productOptions;
+	const checkedProduct = checkProductParam(product, true);
+	if (!checkedProduct.options) return [];
+	const { options, selectedOrFirstAvailableVariant: selectedVariant, adjacentVariants, encodedVariantExistence, encodedVariantAvailability, handle: productHandle } = checkedProduct;
+	const selectedOptionKeys = selectedVariant?.selectedOptions.map((option) => option.name);
+	const filteredOptions = options.filter((option) => {
+		return selectedOptionKeys && selectedOptionKeys.indexOf(option.name) >= 0;
+	});
+	const productOptionMappings = mapProductOptions(options);
+	const variants = mapVariants(selectedVariant ? [selectedVariant, ...adjacentVariants] : adjacentVariants);
+	const selectedOptions = mapSelectedProductOptionToObject(selectedVariant ? selectedVariant.selectedOptions : []);
+	return filteredOptions.map((option, optionIndex) => {
+		return {
+			...option,
+			optionValues: option.optionValues.map((value) => {
+				const targetOptionParams = { ...selectedOptions };
+				targetOptionParams[option.name] = value.name;
+				const targetKey = encodeSelectedProductOptionAsKey(targetOptionParams || []);
+				const topDownKey = buildEncodingArrayFromSelectedOptions(targetOptionParams || [], productOptionMappings).slice(0, optionIndex + 1);
+				const exists = isOptionValueCombinationInEncodedVariant(topDownKey, encodedVariantExistence || "");
+				const available = isOptionValueCombinationInEncodedVariant(topDownKey, encodedVariantAvailability || "");
+				const variant = variants[targetKey] || value.firstSelectableVariant;
+				let variantOptionParam = {};
+				if (variant) variantOptionParam = mapSelectedProductOptionToObject(variant.selectedOptions || []);
+				const searchParams = new URLSearchParams(variantOptionParam);
+				const handle = variant?.product?.handle || productHandle;
+				return {
+					...value,
+					variant,
+					handle,
+					variantUriQuery: searchParams.toString(),
+					selected: selectedOptions[option.name] === value.name,
+					exists,
+					available,
+					isDifferentProduct: handle !== productHandle
+				};
+			})
+		};
+	});
 }
-export {
-  checkProductParam,
-  getAdjacentAndFirstAvailableVariants,
-  getProductOptions,
-  mapSelectedProductOptionToObject
-};
-//# sourceMappingURL=getProductOptions.mjs.map
+//#endregion
+export { getAdjacentAndFirstAvailableVariants, getProductOptions, mapSelectedProductOptionToObject };
+
+//# sourceMappingURL=getProductOptions.mjs.map