@shopify/hydrogen-react 2026.4.1 → 2026.4.2

package/dist/node-prod/flatten-connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"flatten-connection.js","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"],"names":[],"mappings":";;AASO,SAAS,kBAOd,YAuBU;AACV,MAAI,CAAC,YAAY;AACf,UAAM,kBAAkB,uEACtB,cAAc,EAChB;AAGO;AACL,cAAQ,MAAM,kBAAkB,2BAA2B;AAE3D,aAAO,CAAA;AAAA,IACT;AAAA,EACF;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;AASA,SAAO,CAAA;AACT;;"}
+{"version":3,"file":"flatten-connection.js","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;AAIC,UAAQ,MAAM,kBAAkB,4BAA4B;AAE5D,SAAO,EAAE;;AAIb,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;AAUJ,QAAO,EAAE"}

package/dist/node-prod/flatten-connection.mjs

@@ -1,27 +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.`;
-    {
-      console.error(noConnectionErr + ` Returning an empty array`);
-      return [];
-    }
-  }
-  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;
-    });
-  }
-  return [];
+	if (!connection) {
+		const noConnectionErr = `flattenConnection(): needs a 'connection' to flatten, but received '${connection ?? ""}' instead.`;
+		console.error(noConnectionErr + ` Returning an empty array`);
+		return [];
+	}
+	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;
+	});
+	return [];
 }
-export {
-  flattenConnection
-};
-//# sourceMappingURL=flatten-connection.mjs.map
+//#endregion
+export { flattenConnection };
+
+//# sourceMappingURL=flatten-connection.mjs.map

package/dist/node-prod/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 * @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"],"names":[],"mappings":"AASO,SAAS,kBAOd,YAuBU;AACV,MAAI,CAAC,YAAY;AACf,UAAM,kBAAkB,uEACtB,cAAc,EAChB;AAGO;AACL,cAAQ,MAAM,kBAAkB,2BAA2B;AAE3D,aAAO,CAAA;AAAA,IACT;AAAA,EACF;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;AASA,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;AAIC,UAAQ,MAAM,kBAAkB,4BAA4B;AAE5D,SAAO,EAAE;;AAIb,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;AAUJ,QAAO,EAAE"}

package/dist/node-prod/getProductOptions.js

@@ -1,251 +1,275 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const optionValueDecoder = require("./optionValueDecoder.js");
+const require_optionValueDecoder = require("./optionValueDecoder.js");
+//#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 = optionValueDecoder.isOptionValueCombinationInEncodedVariant(
-          topDownKey,
-          encodedVariantExistence || ""
-        );
-        const available = optionValueDecoder.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 = require_optionValueDecoder.isOptionValueCombinationInEncodedVariant(topDownKey, encodedVariantExistence || "");
+				const available = require_optionValueDecoder.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
+				};
+			})
+		};
+	});
 }
-exports.checkProductParam = checkProductParam;
+//#endregion
 exports.getAdjacentAndFirstAvailableVariants = getAdjacentAndFirstAvailableVariants;
 exports.getProductOptions = getProductOptions;
 exports.mapSelectedProductOptionToObject = mapSelectedProductOptionToObject;
-//# sourceMappingURL=getProductOptions.js.map
+
+//# sourceMappingURL=getProductOptions.js.map