@shopify/hydrogen-react 0.0.0-next-3eab955 → 0.0.0-next-aac51f0

package/dist/dev/Metafield.js

@@ -145,6 +145,9 @@ function Metafield(props) {
   });
 }
 function parseMetafield(metafield) {
+  {
+    console.info(`'parseMetafield()' will have a breaking change in a future version; its behavior will match that of 'metafieldParser()'`);
+  }
   if (!metafield) {
     {
       console.warn(`'parseMetafield' was not passed any value for the 'metafield' argument`);
@@ -160,6 +163,9 @@ function parseMetafield(metafield) {
   };
 }
 function parseMetafieldValue(metafield) {
+  {
+    console.info(`'parseMetafieldValue()' will be removed in a future version`);
+  }
   if (!metafield) {
     return null;
   }

package/dist/dev/Metafield.js.map

@@ -1 +1 @@
-{"version":3,"file":"Metafield.js","sources":["../../src/Metafield.tsx"],"sourcesContent":["import {type ElementType, useMemo, type ComponentPropsWithoutRef} from 'react';\nimport {useShop} from './ShopifyProvider.js';\nimport {Image} from './Image.js';\nimport type {\n  MediaImage,\n  Page,\n  ProductVariant,\n  Product,\n  GenericFile,\n  Video as VideoType,\n  Metafield as MetafieldType,\n} from './storefront-api-types.js';\nimport {Video} from './Video.js';\nimport {flattenConnection} from './flatten-connection.js';\nimport type {PartialDeep, JsonValue} from 'type-fest';\n\ninterface BaseProps<ComponentGeneric extends ElementType> {\n  /** An object with fields that correspond to the Storefront API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield). */\n  data: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null;\n  /** An HTML tag or React component to be rendered as the base element wrapper. The default value varies depending on [metafield.type](https://shopify.dev/apps/metafields/types). */\n  as?: ComponentGeneric;\n}\n\nexport type MetafieldProps<ComponentGeneric extends ElementType> =\n  ComponentPropsWithoutRef<ComponentGeneric> & BaseProps<ComponentGeneric>;\n\n/**\n * The `Metafield` component renders the value of a Storefront\n * API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield).\n * Relies on the `locale` property of the `useShop()` hook, so it must be a desendent of `<ShopifyProvider/>`\n *\n * Renders a smart default of the Metafield's `value`. For more information, refer to the [Default output](#default-output) section.\n */\nexport function Metafield<ComponentGeneric extends ElementType>(\n  props: MetafieldProps<ComponentGeneric>\n) {\n  const {data, as, ...passthroughProps} = props;\n  const {locale} = useShop();\n\n  const parsedMetafield = useMemo(() => parseMetafield(data), [data]);\n\n  if (!parsedMetafield) {\n    const noDataPropWarning = `<Metafield/>: nothing was passed to the data prop 'data'. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noDataPropWarning);\n    } else {\n      console.warn(noDataPropWarning);\n    }\n    return null;\n  }\n\n  if (parsedMetafield.value === null || parsedMetafield.value === undefined) {\n    const noValueWarning = `<Metafield/>: No metafield value for metafield ${\n      parsedMetafield.id ?? parsedMetafield.key\n    }. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noValueWarning);\n    } else {\n      console.warn(noValueWarning);\n    }\n    return null;\n  }\n\n  switch (parsedMetafield.type) {\n    case 'date': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleDateString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'date_time': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'weight':\n    case 'dimension':\n    case 'volume': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {getMeasurementAsString(parsedMetafield.value as Measurement, locale)}\n        </Wrapper>\n      );\n    }\n    case 'rating': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Rating).value}\n        </Wrapper>\n      );\n    }\n    case 'single_line_text_field': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{__html: parsedMetafield.value as string}}\n        />\n      );\n    }\n    case 'multi_line_text_field': {\n      const Wrapper = as ?? 'div';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{\n            __html: (parsedMetafield.value as string).split('\\n').join('<br/>'),\n          }}\n        />\n      );\n    }\n    case 'url': {\n      const protocolLessUrl = new URL(parsedMetafield.value as string);\n      return (\n        <a\n          href={protocolLessUrl.href.replace(protocolLessUrl.protocol, '')}\n          {...passthroughProps}\n        >\n          {parsedMetafield.value as string}\n        </a>\n      );\n    }\n    case 'json': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {JSON.stringify(parsedMetafield.value)}\n        </Wrapper>\n      );\n    }\n    case 'product_reference':\n    case 'variant_reference':\n    case 'page_reference': {\n      const Wrapper = as ?? 'span';\n      const ref = parsedMetafield.reference as Page | ProductVariant | Product;\n      return (\n        <Wrapper {...passthroughProps}>{ref?.title ?? ref?.id ?? ''}</Wrapper>\n      );\n    }\n    case 'list.single_line_text_field': {\n      const Wrapper = as ?? 'ul';\n\n      const refArray = parsedMetafield.references\n        ? (flattenConnection(parsedMetafield.references) as string[])\n        : [];\n      return (\n        <Wrapper {...passthroughProps}>\n          {refArray.map((ref, index) => (\n            // there's no unique way to identify these strings, so we do our best by combining the string with the index for the key\n            // eslint-disable-next-line react/no-array-index-key\n            <li key={`${ref ?? ''}-${index}`}>{ref}</li>\n          ))}\n        </Wrapper>\n      );\n    }\n    case 'file_reference': {\n      if (parsedMetafield.reference?.__typename === 'MediaImage') {\n        const ref = parsedMetafield.reference as MediaImage;\n        return ref.image ? (\n          <Image data={ref.image} {...passthroughProps} />\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'GenericFile') {\n        const ref = parsedMetafield.reference as GenericFile;\n        return ref.previewImage ? (\n          <a href={parsedMetafield.reference?.url ?? ''} {...passthroughProps}>\n            <Image data={ref.previewImage} />\n          </a>\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'Video') {\n        const ref = parsedMetafield.reference as VideoType;\n        return <Video {...passthroughProps} data={ref} />;\n      }\n    }\n  }\n\n  const Wrapper = as ?? 'span';\n  return (\n    <Wrapper {...passthroughProps}>{parsedMetafield.value?.toString()}</Wrapper>\n  );\n}\n\n/**\n * The `parseMetafield` utility transforms a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield)\n * into a new object whose `values` have been parsed according to the metafield `type`.\n * If the metafield is `null`, then it returns `null` back.\n */\nexport function parseMetafield(\n  /** A [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield) or null */\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): PartialDeep<ParsedMetafield, {recurseIntoArrays: true}> | null {\n  if (!metafield) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafield' was not passed any value for the 'metafield' argument`\n      );\n    }\n    return null;\n  }\n  if (\n    __HYDROGEN_DEV__ &&\n    (metafield.value === null || metafield.value === undefined)\n  ) {\n    console.warn(\n      `'parseMetafield()' was passed ${metafield.value} for 'metafield.value'`\n    );\n  }\n\n  return {\n    ...metafield,\n    value: parseMetafieldValue(metafield),\n  };\n}\n\n/**\n * The `parseMetafieldValue` function parses a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `value` from a string into a sensible type corresponding to the [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `type`.\n */\nexport function parseMetafieldValue(\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): ParsedMetafield['value'] {\n  if (!metafield) {\n    return null;\n  }\n\n  if (metafield.value === null || metafield.value === undefined) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafieldValue()' was passed ${metafield.value} for 'metafield.value'`\n      );\n    }\n    return metafield.value;\n  }\n\n  switch (metafield.type) {\n    case 'boolean':\n      return metafield.value === 'true';\n    case 'number_integer':\n      return parseInt(metafield.value);\n    case 'number_decimal':\n      return parseFloat(metafield.value);\n    case 'date':\n    case 'date_time':\n      return new Date(metafield.value);\n    case 'json':\n    case 'weight':\n    case 'dimension':\n    case 'volume':\n    case 'rating':\n      return parseJSON(metafield.value);\n    case 'color':\n    case 'single_line_text_field':\n    case 'multi_line_text_field':\n    case 'product_reference':\n    case 'page_reference':\n    case 'variant_reference':\n    case 'file_reference':\n    case 'url':\n    default:\n      return metafield.value;\n  }\n}\n\n/**\n * Parses a JSON string while preventing prototype injection attacks.\n */\nexport function parseJSON(json: string) {\n  if (String(json).includes('__proto__')) {\n    return JSON.parse(json, (k, v) => {\n      if (k !== '__proto__') return v;\n    });\n  }\n\n  return JSON.parse(json);\n}\n\nconst UNIT_MAPPING: Record<string, string> = {\n  // Dimension\n  mm: 'millimeter',\n  cm: 'centimeter',\n  m: 'meter',\n  in: 'inch',\n  ft: 'foot',\n  yd: 'yard',\n  // Volume\n  ml: 'milliliter',\n  l: 'liter',\n  us_fl_oz: 'fluid-ounce',\n  us_gal: 'gallon',\n  // Weight\n  kg: 'kilogram',\n  g: 'gram',\n  lb: 'pound',\n  oz: 'ounce',\n};\n\nexport function getMeasurementAsString(\n  measurement: Measurement,\n  locale = 'en-us',\n  options: Intl.NumberFormatOptions = {}\n) {\n  let measure: {value: number; unit: string} = {\n    value: measurement.value,\n    unit: UNIT_MAPPING[measurement.unit],\n  };\n\n  if (measure.unit == null) {\n    measure = convertToSupportedUnit(measurement.value, measurement.unit);\n  }\n\n  return new Intl.NumberFormat(locale, {\n    ...options,\n    unit: measure.unit,\n    style: 'unit',\n  }).format(measure.value);\n}\n\nfunction convertToSupportedUnit(value: number, unit: string) {\n  switch (unit) {\n    case 'cl':\n      return {\n        value: value / 1000,\n        unit: 'liter',\n      };\n    case 'm3':\n      return {\n        value: value * 1000,\n        unit: 'liter',\n      };\n    case 'us_pt':\n      return {\n        value: value * 0.125,\n        unit: 'gallon',\n      };\n    case 'us_qt':\n      return {\n        value: value * 0.5,\n        unit: 'gallon',\n      };\n    case 'us_oz':\n      return {\n        value: value / 128,\n        unit: 'gallon',\n      };\n    case 'imp_pt':\n      return {\n        value: value / 6.661, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_qt':\n      return {\n        value: value / 3.331, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_gal':\n      return {\n        value: value / 1.201, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_fl_oz':\n      return {\n        value: value * 0.96076, // approximate conversion\n        unit: 'fluid-ounce',\n      };\n    default:\n      throw new Error(`Unit not supported: ${unit}`);\n  }\n}\n\ntype ParsedMetafield = Omit<\n  PartialDeep<MetafieldType, {recurseIntoArrays: true}>,\n  'value'\n> & {\n  value?: string | number | boolean | JsonValue | Date | Rating | Measurement;\n};\n\nexport interface Rating {\n  value: number;\n  scale_min: number;\n  scale_max: number;\n}\n\ninterface Measurement {\n  unit: string;\n  value: number;\n}\n"],"names":["Metafield","props","data","as","passthroughProps","locale","useShop","parsedMetafield","useMemo","parseMetafield","noDataPropWarning","Error","value","undefined","noValueWarning","id","key","type","Wrapper","toLocaleDateString","toLocaleString","getMeasurementAsString","__html","split","join","protocolLessUrl","URL","href","replace","protocol","JSON","stringify","ref","reference","title","refArray","references","flattenConnection","map","index","__typename","image","_jsx","Image","previewImage","url","Video","toString","metafield","console","warn","parseMetafieldValue","parseInt","parseFloat","Date","parseJSON","json","String","includes","parse","k","v","UNIT_MAPPING","mm","cm","m","in","ft","yd","ml","l","us_fl_oz","us_gal","kg","g","lb","oz","measurement","options","measure","unit","convertToSupportedUnit","Intl","NumberFormat","style","format"],"mappings":"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"}
+{"version":3,"file":"Metafield.js","sources":["../../src/Metafield.tsx"],"sourcesContent":["import {type ElementType, useMemo, type ComponentPropsWithoutRef} from 'react';\nimport {useShop} from './ShopifyProvider.js';\nimport {Image} from './Image.js';\nimport type {\n  MediaImage,\n  Page,\n  ProductVariant,\n  Product,\n  GenericFile,\n  Video as VideoType,\n  Metafield as MetafieldType,\n} from './storefront-api-types.js';\nimport {Video} from './Video.js';\nimport {flattenConnection} from './flatten-connection.js';\nimport type {PartialDeep, JsonValue} from 'type-fest';\n\ninterface BaseProps<ComponentGeneric extends ElementType> {\n  /** An object with fields that correspond to the Storefront API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield). */\n  data: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null;\n  /** An HTML tag or React component to be rendered as the base element wrapper. The default value varies depending on [metafield.type](https://shopify.dev/apps/metafields/types). */\n  as?: ComponentGeneric;\n}\n\nexport type MetafieldProps<ComponentGeneric extends ElementType> =\n  ComponentPropsWithoutRef<ComponentGeneric> & BaseProps<ComponentGeneric>;\n\n/**\n * The `Metafield` component renders the value of a Storefront\n * API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield).\n * Relies on the `locale` property of the `useShop()` hook, so it must be a desendent of `<ShopifyProvider/>`\n *\n * Renders a smart default of the Metafield's `value`. For more information, refer to the [Default output](#default-output) section.\n */\nexport function Metafield<ComponentGeneric extends ElementType>(\n  props: MetafieldProps<ComponentGeneric>\n) {\n  const {data, as, ...passthroughProps} = props;\n  const {locale} = useShop();\n\n  const parsedMetafield = useMemo(() => parseMetafield(data), [data]);\n\n  if (!parsedMetafield) {\n    const noDataPropWarning = `<Metafield/>: nothing was passed to the data prop 'data'. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noDataPropWarning);\n    } else {\n      console.warn(noDataPropWarning);\n    }\n    return null;\n  }\n\n  if (parsedMetafield.value === null || parsedMetafield.value === undefined) {\n    const noValueWarning = `<Metafield/>: No metafield value for metafield ${\n      parsedMetafield.id ?? parsedMetafield.key\n    }. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noValueWarning);\n    } else {\n      console.warn(noValueWarning);\n    }\n    return null;\n  }\n\n  switch (parsedMetafield.type) {\n    case 'date': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleDateString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'date_time': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'weight':\n    case 'dimension':\n    case 'volume': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {getMeasurementAsString(parsedMetafield.value as Measurement, locale)}\n        </Wrapper>\n      );\n    }\n    case 'rating': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Rating).value}\n        </Wrapper>\n      );\n    }\n    case 'single_line_text_field': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{__html: parsedMetafield.value as string}}\n        />\n      );\n    }\n    case 'multi_line_text_field': {\n      const Wrapper = as ?? 'div';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{\n            __html: (parsedMetafield.value as string).split('\\n').join('<br/>'),\n          }}\n        />\n      );\n    }\n    case 'url': {\n      const protocolLessUrl = new URL(parsedMetafield.value as string);\n      return (\n        <a\n          href={protocolLessUrl.href.replace(protocolLessUrl.protocol, '')}\n          {...passthroughProps}\n        >\n          {parsedMetafield.value as string}\n        </a>\n      );\n    }\n    case 'json': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {JSON.stringify(parsedMetafield.value)}\n        </Wrapper>\n      );\n    }\n    case 'product_reference':\n    case 'variant_reference':\n    case 'page_reference': {\n      const Wrapper = as ?? 'span';\n      const ref = parsedMetafield.reference as Page | ProductVariant | Product;\n      return (\n        <Wrapper {...passthroughProps}>{ref?.title ?? ref?.id ?? ''}</Wrapper>\n      );\n    }\n    case 'list.single_line_text_field': {\n      const Wrapper = as ?? 'ul';\n\n      const refArray = parsedMetafield.references\n        ? (flattenConnection(parsedMetafield.references) as string[])\n        : [];\n      return (\n        <Wrapper {...passthroughProps}>\n          {refArray.map((ref, index) => (\n            // there's no unique way to identify these strings, so we do our best by combining the string with the index for the key\n            // eslint-disable-next-line react/no-array-index-key\n            <li key={`${ref ?? ''}-${index}`}>{ref}</li>\n          ))}\n        </Wrapper>\n      );\n    }\n    case 'file_reference': {\n      if (parsedMetafield.reference?.__typename === 'MediaImage') {\n        const ref = parsedMetafield.reference as MediaImage;\n        return ref.image ? (\n          <Image data={ref.image} {...passthroughProps} />\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'GenericFile') {\n        const ref = parsedMetafield.reference as GenericFile;\n        return ref.previewImage ? (\n          <a href={parsedMetafield.reference?.url ?? ''} {...passthroughProps}>\n            <Image data={ref.previewImage} />\n          </a>\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'Video') {\n        const ref = parsedMetafield.reference as VideoType;\n        return <Video {...passthroughProps} data={ref} />;\n      }\n    }\n  }\n\n  const Wrapper = as ?? 'span';\n  return (\n    <Wrapper {...passthroughProps}>{parsedMetafield.value?.toString()}</Wrapper>\n  );\n}\n\n/**\n * The `parseMetafield` utility transforms a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield)\n * into a new object whose `values` have been parsed according to the metafield `type`.\n * If the metafield is `null`, then it returns `null` back.\n *\n * Note that `parseMetafield()` will have a breaking change in a future version; it will change to behave like `metafieldParser()`.\n */\nexport function parseMetafield(\n  /** A [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield) or null */\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): PartialDeep<ParsedMetafield, {recurseIntoArrays: true}> | null {\n  if (__HYDROGEN_DEV__) {\n    console.info(\n      `'parseMetafield()' will have a breaking change in a future version; its behavior will match that of 'metafieldParser()'`\n    );\n  }\n\n  if (!metafield) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafield' was not passed any value for the 'metafield' argument`\n      );\n    }\n    return null;\n  }\n  if (\n    __HYDROGEN_DEV__ &&\n    (metafield.value === null || metafield.value === undefined)\n  ) {\n    console.warn(\n      `'parseMetafield()' was passed ${metafield.value} for 'metafield.value'`\n    );\n  }\n\n  return {\n    ...metafield,\n    value: parseMetafieldValue(metafield),\n  };\n}\n\n/**\n * The `parseMetafieldValue` function parses a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `value` from a string into a sensible type corresponding to the [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `type`.\n * @deprecated `parseMetafieldValue()` is unsupported and will be removed in a future version.\n */\nexport function parseMetafieldValue(\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): ParsedMetafield['value'] {\n  if (__HYDROGEN_DEV__) {\n    console.info(`'parseMetafieldValue()' will be removed in a future version`);\n  }\n\n  if (!metafield) {\n    return null;\n  }\n\n  if (metafield.value === null || metafield.value === undefined) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafieldValue()' was passed ${metafield.value} for 'metafield.value'`\n      );\n    }\n    return metafield.value;\n  }\n\n  switch (metafield.type) {\n    case 'boolean':\n      return metafield.value === 'true';\n    case 'number_integer':\n      return parseInt(metafield.value);\n    case 'number_decimal':\n      return parseFloat(metafield.value);\n    case 'date':\n    case 'date_time':\n      return new Date(metafield.value);\n    case 'json':\n    case 'weight':\n    case 'dimension':\n    case 'volume':\n    case 'rating':\n      return parseJSON(metafield.value);\n    case 'color':\n    case 'single_line_text_field':\n    case 'multi_line_text_field':\n    case 'product_reference':\n    case 'page_reference':\n    case 'variant_reference':\n    case 'file_reference':\n    case 'url':\n    default:\n      return metafield.value;\n  }\n}\n\n/**\n * Parses a JSON string while preventing prototype injection attacks.\n */\nexport function parseJSON(json: string) {\n  if (String(json).includes('__proto__')) {\n    return JSON.parse(json, (k, v) => {\n      if (k !== '__proto__') return v;\n    });\n  }\n\n  return JSON.parse(json);\n}\n\nconst UNIT_MAPPING: Record<string, string> = {\n  // Dimension\n  mm: 'millimeter',\n  cm: 'centimeter',\n  m: 'meter',\n  in: 'inch',\n  ft: 'foot',\n  yd: 'yard',\n  // Volume\n  ml: 'milliliter',\n  l: 'liter',\n  us_fl_oz: 'fluid-ounce',\n  us_gal: 'gallon',\n  // Weight\n  kg: 'kilogram',\n  g: 'gram',\n  lb: 'pound',\n  oz: 'ounce',\n};\n\nexport function getMeasurementAsString(\n  measurement: Measurement,\n  locale = 'en-us',\n  options: Intl.NumberFormatOptions = {}\n) {\n  let measure: Measurement = {\n    value: measurement.value,\n    unit: UNIT_MAPPING[measurement.unit],\n  };\n\n  if (measure.unit == null) {\n    measure = convertToSupportedUnit(measurement.value, measurement.unit);\n  }\n\n  return new Intl.NumberFormat(locale, {\n    ...options,\n    unit: measure.unit,\n    style: 'unit',\n  }).format(measure.value);\n}\n\nfunction convertToSupportedUnit(value: number, unit: string): Measurement {\n  switch (unit) {\n    case 'cl':\n      return {\n        value: value / 1000,\n        unit: 'liter',\n      };\n    case 'm3':\n      return {\n        value: value * 1000,\n        unit: 'liter',\n      };\n    case 'us_pt':\n      return {\n        value: value * 0.125,\n        unit: 'gallon',\n      };\n    case 'us_qt':\n      return {\n        value: value * 0.5,\n        unit: 'gallon',\n      };\n    case 'us_oz':\n      return {\n        value: value / 128,\n        unit: 'gallon',\n      };\n    case 'imp_pt':\n      return {\n        value: value / 6.661, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_qt':\n      return {\n        value: value / 3.331, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_gal':\n      return {\n        value: value / 1.201, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_fl_oz':\n      return {\n        value: value * 0.96076, // approximate conversion\n        unit: 'fluid-ounce',\n      };\n    default:\n      throw new Error(`Unit not supported: ${unit}`);\n  }\n}\n\ntype ParsedMetafield = Omit<\n  PartialDeep<MetafieldType, {recurseIntoArrays: true}>,\n  'value'\n> & {\n  value?: string | number | boolean | JsonValue | Date | Rating | Measurement;\n};\n\nexport interface Rating {\n  value: number;\n  scale_min: number;\n  scale_max: number;\n}\n\ninterface Measurement {\n  unit: string;\n  value: number;\n}\n"],"names":["Metafield","props","data","as","passthroughProps","locale","useShop","parsedMetafield","useMemo","parseMetafield","noDataPropWarning","Error","value","undefined","noValueWarning","id","key","type","Wrapper","toLocaleDateString","toLocaleString","getMeasurementAsString","__html","split","join","protocolLessUrl","URL","href","replace","protocol","JSON","stringify","ref","reference","title","refArray","references","flattenConnection","map","index","__typename","image","_jsx","Image","previewImage","url","Video","toString","metafield","console","info","warn","parseMetafieldValue","parseInt","parseFloat","Date","parseJSON","json","String","includes","parse","k","v","UNIT_MAPPING","mm","cm","m","in","ft","yd","ml","l","us_fl_oz","us_gal","kg","g","lb","oz","measurement","options","measure","unit","convertToSupportedUnit","Intl","NumberFormat","style","format"],"mappings":"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"}

package/dist/dev/Metafield.mjs

@@ -143,6 +143,9 @@ function Metafield(props) {
   });
 }
 function parseMetafield(metafield) {
+  {
+    console.info(`'parseMetafield()' will have a breaking change in a future version; its behavior will match that of 'metafieldParser()'`);
+  }
   if (!metafield) {
     {
       console.warn(`'parseMetafield' was not passed any value for the 'metafield' argument`);
@@ -158,6 +161,9 @@ function parseMetafield(metafield) {
   };
 }
 function parseMetafieldValue(metafield) {
+  {
+    console.info(`'parseMetafieldValue()' will be removed in a future version`);
+  }
   if (!metafield) {
     return null;
   }

package/dist/dev/Metafield.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Metafield.mjs","sources":["../../src/Metafield.tsx"],"sourcesContent":["import {type ElementType, useMemo, type ComponentPropsWithoutRef} from 'react';\nimport {useShop} from './ShopifyProvider.js';\nimport {Image} from './Image.js';\nimport type {\n  MediaImage,\n  Page,\n  ProductVariant,\n  Product,\n  GenericFile,\n  Video as VideoType,\n  Metafield as MetafieldType,\n} from './storefront-api-types.js';\nimport {Video} from './Video.js';\nimport {flattenConnection} from './flatten-connection.js';\nimport type {PartialDeep, JsonValue} from 'type-fest';\n\ninterface BaseProps<ComponentGeneric extends ElementType> {\n  /** An object with fields that correspond to the Storefront API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield). */\n  data: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null;\n  /** An HTML tag or React component to be rendered as the base element wrapper. The default value varies depending on [metafield.type](https://shopify.dev/apps/metafields/types). */\n  as?: ComponentGeneric;\n}\n\nexport type MetafieldProps<ComponentGeneric extends ElementType> =\n  ComponentPropsWithoutRef<ComponentGeneric> & BaseProps<ComponentGeneric>;\n\n/**\n * The `Metafield` component renders the value of a Storefront\n * API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield).\n * Relies on the `locale` property of the `useShop()` hook, so it must be a desendent of `<ShopifyProvider/>`\n *\n * Renders a smart default of the Metafield's `value`. For more information, refer to the [Default output](#default-output) section.\n */\nexport function Metafield<ComponentGeneric extends ElementType>(\n  props: MetafieldProps<ComponentGeneric>\n) {\n  const {data, as, ...passthroughProps} = props;\n  const {locale} = useShop();\n\n  const parsedMetafield = useMemo(() => parseMetafield(data), [data]);\n\n  if (!parsedMetafield) {\n    const noDataPropWarning = `<Metafield/>: nothing was passed to the data prop 'data'. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noDataPropWarning);\n    } else {\n      console.warn(noDataPropWarning);\n    }\n    return null;\n  }\n\n  if (parsedMetafield.value === null || parsedMetafield.value === undefined) {\n    const noValueWarning = `<Metafield/>: No metafield value for metafield ${\n      parsedMetafield.id ?? parsedMetafield.key\n    }. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noValueWarning);\n    } else {\n      console.warn(noValueWarning);\n    }\n    return null;\n  }\n\n  switch (parsedMetafield.type) {\n    case 'date': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleDateString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'date_time': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'weight':\n    case 'dimension':\n    case 'volume': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {getMeasurementAsString(parsedMetafield.value as Measurement, locale)}\n        </Wrapper>\n      );\n    }\n    case 'rating': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Rating).value}\n        </Wrapper>\n      );\n    }\n    case 'single_line_text_field': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{__html: parsedMetafield.value as string}}\n        />\n      );\n    }\n    case 'multi_line_text_field': {\n      const Wrapper = as ?? 'div';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{\n            __html: (parsedMetafield.value as string).split('\\n').join('<br/>'),\n          }}\n        />\n      );\n    }\n    case 'url': {\n      const protocolLessUrl = new URL(parsedMetafield.value as string);\n      return (\n        <a\n          href={protocolLessUrl.href.replace(protocolLessUrl.protocol, '')}\n          {...passthroughProps}\n        >\n          {parsedMetafield.value as string}\n        </a>\n      );\n    }\n    case 'json': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {JSON.stringify(parsedMetafield.value)}\n        </Wrapper>\n      );\n    }\n    case 'product_reference':\n    case 'variant_reference':\n    case 'page_reference': {\n      const Wrapper = as ?? 'span';\n      const ref = parsedMetafield.reference as Page | ProductVariant | Product;\n      return (\n        <Wrapper {...passthroughProps}>{ref?.title ?? ref?.id ?? ''}</Wrapper>\n      );\n    }\n    case 'list.single_line_text_field': {\n      const Wrapper = as ?? 'ul';\n\n      const refArray = parsedMetafield.references\n        ? (flattenConnection(parsedMetafield.references) as string[])\n        : [];\n      return (\n        <Wrapper {...passthroughProps}>\n          {refArray.map((ref, index) => (\n            // there's no unique way to identify these strings, so we do our best by combining the string with the index for the key\n            // eslint-disable-next-line react/no-array-index-key\n            <li key={`${ref ?? ''}-${index}`}>{ref}</li>\n          ))}\n        </Wrapper>\n      );\n    }\n    case 'file_reference': {\n      if (parsedMetafield.reference?.__typename === 'MediaImage') {\n        const ref = parsedMetafield.reference as MediaImage;\n        return ref.image ? (\n          <Image data={ref.image} {...passthroughProps} />\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'GenericFile') {\n        const ref = parsedMetafield.reference as GenericFile;\n        return ref.previewImage ? (\n          <a href={parsedMetafield.reference?.url ?? ''} {...passthroughProps}>\n            <Image data={ref.previewImage} />\n          </a>\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'Video') {\n        const ref = parsedMetafield.reference as VideoType;\n        return <Video {...passthroughProps} data={ref} />;\n      }\n    }\n  }\n\n  const Wrapper = as ?? 'span';\n  return (\n    <Wrapper {...passthroughProps}>{parsedMetafield.value?.toString()}</Wrapper>\n  );\n}\n\n/**\n * The `parseMetafield` utility transforms a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield)\n * into a new object whose `values` have been parsed according to the metafield `type`.\n * If the metafield is `null`, then it returns `null` back.\n */\nexport function parseMetafield(\n  /** A [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield) or null */\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): PartialDeep<ParsedMetafield, {recurseIntoArrays: true}> | null {\n  if (!metafield) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafield' was not passed any value for the 'metafield' argument`\n      );\n    }\n    return null;\n  }\n  if (\n    __HYDROGEN_DEV__ &&\n    (metafield.value === null || metafield.value === undefined)\n  ) {\n    console.warn(\n      `'parseMetafield()' was passed ${metafield.value} for 'metafield.value'`\n    );\n  }\n\n  return {\n    ...metafield,\n    value: parseMetafieldValue(metafield),\n  };\n}\n\n/**\n * The `parseMetafieldValue` function parses a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `value` from a string into a sensible type corresponding to the [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `type`.\n */\nexport function parseMetafieldValue(\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): ParsedMetafield['value'] {\n  if (!metafield) {\n    return null;\n  }\n\n  if (metafield.value === null || metafield.value === undefined) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafieldValue()' was passed ${metafield.value} for 'metafield.value'`\n      );\n    }\n    return metafield.value;\n  }\n\n  switch (metafield.type) {\n    case 'boolean':\n      return metafield.value === 'true';\n    case 'number_integer':\n      return parseInt(metafield.value);\n    case 'number_decimal':\n      return parseFloat(metafield.value);\n    case 'date':\n    case 'date_time':\n      return new Date(metafield.value);\n    case 'json':\n    case 'weight':\n    case 'dimension':\n    case 'volume':\n    case 'rating':\n      return parseJSON(metafield.value);\n    case 'color':\n    case 'single_line_text_field':\n    case 'multi_line_text_field':\n    case 'product_reference':\n    case 'page_reference':\n    case 'variant_reference':\n    case 'file_reference':\n    case 'url':\n    default:\n      return metafield.value;\n  }\n}\n\n/**\n * Parses a JSON string while preventing prototype injection attacks.\n */\nexport function parseJSON(json: string) {\n  if (String(json).includes('__proto__')) {\n    return JSON.parse(json, (k, v) => {\n      if (k !== '__proto__') return v;\n    });\n  }\n\n  return JSON.parse(json);\n}\n\nconst UNIT_MAPPING: Record<string, string> = {\n  // Dimension\n  mm: 'millimeter',\n  cm: 'centimeter',\n  m: 'meter',\n  in: 'inch',\n  ft: 'foot',\n  yd: 'yard',\n  // Volume\n  ml: 'milliliter',\n  l: 'liter',\n  us_fl_oz: 'fluid-ounce',\n  us_gal: 'gallon',\n  // Weight\n  kg: 'kilogram',\n  g: 'gram',\n  lb: 'pound',\n  oz: 'ounce',\n};\n\nexport function getMeasurementAsString(\n  measurement: Measurement,\n  locale = 'en-us',\n  options: Intl.NumberFormatOptions = {}\n) {\n  let measure: {value: number; unit: string} = {\n    value: measurement.value,\n    unit: UNIT_MAPPING[measurement.unit],\n  };\n\n  if (measure.unit == null) {\n    measure = convertToSupportedUnit(measurement.value, measurement.unit);\n  }\n\n  return new Intl.NumberFormat(locale, {\n    ...options,\n    unit: measure.unit,\n    style: 'unit',\n  }).format(measure.value);\n}\n\nfunction convertToSupportedUnit(value: number, unit: string) {\n  switch (unit) {\n    case 'cl':\n      return {\n        value: value / 1000,\n        unit: 'liter',\n      };\n    case 'm3':\n      return {\n        value: value * 1000,\n        unit: 'liter',\n      };\n    case 'us_pt':\n      return {\n        value: value * 0.125,\n        unit: 'gallon',\n      };\n    case 'us_qt':\n      return {\n        value: value * 0.5,\n        unit: 'gallon',\n      };\n    case 'us_oz':\n      return {\n        value: value / 128,\n        unit: 'gallon',\n      };\n    case 'imp_pt':\n      return {\n        value: value / 6.661, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_qt':\n      return {\n        value: value / 3.331, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_gal':\n      return {\n        value: value / 1.201, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_fl_oz':\n      return {\n        value: value * 0.96076, // approximate conversion\n        unit: 'fluid-ounce',\n      };\n    default:\n      throw new Error(`Unit not supported: ${unit}`);\n  }\n}\n\ntype ParsedMetafield = Omit<\n  PartialDeep<MetafieldType, {recurseIntoArrays: true}>,\n  'value'\n> & {\n  value?: string | number | boolean | JsonValue | Date | Rating | Measurement;\n};\n\nexport interface Rating {\n  value: number;\n  scale_min: number;\n  scale_max: number;\n}\n\ninterface Measurement {\n  unit: string;\n  value: number;\n}\n"],"names":["Metafield","props","data","as","passthroughProps","locale","useShop","parsedMetafield","useMemo","parseMetafield","noDataPropWarning","Error","value","undefined","noValueWarning","id","key","type","Wrapper","toLocaleDateString","toLocaleString","getMeasurementAsString","__html","split","join","protocolLessUrl","URL","href","replace","protocol","JSON","stringify","ref","reference","title","refArray","references","flattenConnection","map","index","__typename","image","_jsx","previewImage","url","toString","metafield","console","warn","parseMetafieldValue","parseInt","parseFloat","Date","parseJSON","json","String","includes","parse","k","v","UNIT_MAPPING","mm","cm","m","in","ft","yd","ml","l","us_fl_oz","us_gal","kg","g","lb","oz","measurement","options","measure","unit","convertToSupportedUnit","Intl","NumberFormat","style","format"],"mappings":"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"}
+{"version":3,"file":"Metafield.mjs","sources":["../../src/Metafield.tsx"],"sourcesContent":["import {type ElementType, useMemo, type ComponentPropsWithoutRef} from 'react';\nimport {useShop} from './ShopifyProvider.js';\nimport {Image} from './Image.js';\nimport type {\n  MediaImage,\n  Page,\n  ProductVariant,\n  Product,\n  GenericFile,\n  Video as VideoType,\n  Metafield as MetafieldType,\n} from './storefront-api-types.js';\nimport {Video} from './Video.js';\nimport {flattenConnection} from './flatten-connection.js';\nimport type {PartialDeep, JsonValue} from 'type-fest';\n\ninterface BaseProps<ComponentGeneric extends ElementType> {\n  /** An object with fields that correspond to the Storefront API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield). */\n  data: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null;\n  /** An HTML tag or React component to be rendered as the base element wrapper. The default value varies depending on [metafield.type](https://shopify.dev/apps/metafields/types). */\n  as?: ComponentGeneric;\n}\n\nexport type MetafieldProps<ComponentGeneric extends ElementType> =\n  ComponentPropsWithoutRef<ComponentGeneric> & BaseProps<ComponentGeneric>;\n\n/**\n * The `Metafield` component renders the value of a Storefront\n * API's [Metafield object](https://shopify.dev/api/storefront/reference/common-objects/metafield).\n * Relies on the `locale` property of the `useShop()` hook, so it must be a desendent of `<ShopifyProvider/>`\n *\n * Renders a smart default of the Metafield's `value`. For more information, refer to the [Default output](#default-output) section.\n */\nexport function Metafield<ComponentGeneric extends ElementType>(\n  props: MetafieldProps<ComponentGeneric>\n) {\n  const {data, as, ...passthroughProps} = props;\n  const {locale} = useShop();\n\n  const parsedMetafield = useMemo(() => parseMetafield(data), [data]);\n\n  if (!parsedMetafield) {\n    const noDataPropWarning = `<Metafield/>: nothing was passed to the data prop 'data'. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noDataPropWarning);\n    } else {\n      console.warn(noDataPropWarning);\n    }\n    return null;\n  }\n\n  if (parsedMetafield.value === null || parsedMetafield.value === undefined) {\n    const noValueWarning = `<Metafield/>: No metafield value for metafield ${\n      parsedMetafield.id ?? parsedMetafield.key\n    }. Rendering 'null'`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noValueWarning);\n    } else {\n      console.warn(noValueWarning);\n    }\n    return null;\n  }\n\n  switch (parsedMetafield.type) {\n    case 'date': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleDateString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'date_time': {\n      const Wrapper = as ?? 'time';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Date).toLocaleString(locale)}\n        </Wrapper>\n      );\n    }\n    case 'weight':\n    case 'dimension':\n    case 'volume': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {getMeasurementAsString(parsedMetafield.value as Measurement, locale)}\n        </Wrapper>\n      );\n    }\n    case 'rating': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {(parsedMetafield.value as Rating).value}\n        </Wrapper>\n      );\n    }\n    case 'single_line_text_field': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{__html: parsedMetafield.value as string}}\n        />\n      );\n    }\n    case 'multi_line_text_field': {\n      const Wrapper = as ?? 'div';\n      return (\n        <Wrapper\n          {...passthroughProps}\n          dangerouslySetInnerHTML={{\n            __html: (parsedMetafield.value as string).split('\\n').join('<br/>'),\n          }}\n        />\n      );\n    }\n    case 'url': {\n      const protocolLessUrl = new URL(parsedMetafield.value as string);\n      return (\n        <a\n          href={protocolLessUrl.href.replace(protocolLessUrl.protocol, '')}\n          {...passthroughProps}\n        >\n          {parsedMetafield.value as string}\n        </a>\n      );\n    }\n    case 'json': {\n      const Wrapper = as ?? 'span';\n      return (\n        <Wrapper {...passthroughProps}>\n          {JSON.stringify(parsedMetafield.value)}\n        </Wrapper>\n      );\n    }\n    case 'product_reference':\n    case 'variant_reference':\n    case 'page_reference': {\n      const Wrapper = as ?? 'span';\n      const ref = parsedMetafield.reference as Page | ProductVariant | Product;\n      return (\n        <Wrapper {...passthroughProps}>{ref?.title ?? ref?.id ?? ''}</Wrapper>\n      );\n    }\n    case 'list.single_line_text_field': {\n      const Wrapper = as ?? 'ul';\n\n      const refArray = parsedMetafield.references\n        ? (flattenConnection(parsedMetafield.references) as string[])\n        : [];\n      return (\n        <Wrapper {...passthroughProps}>\n          {refArray.map((ref, index) => (\n            // there's no unique way to identify these strings, so we do our best by combining the string with the index for the key\n            // eslint-disable-next-line react/no-array-index-key\n            <li key={`${ref ?? ''}-${index}`}>{ref}</li>\n          ))}\n        </Wrapper>\n      );\n    }\n    case 'file_reference': {\n      if (parsedMetafield.reference?.__typename === 'MediaImage') {\n        const ref = parsedMetafield.reference as MediaImage;\n        return ref.image ? (\n          <Image data={ref.image} {...passthroughProps} />\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'GenericFile') {\n        const ref = parsedMetafield.reference as GenericFile;\n        return ref.previewImage ? (\n          <a href={parsedMetafield.reference?.url ?? ''} {...passthroughProps}>\n            <Image data={ref.previewImage} />\n          </a>\n        ) : null;\n      } else if (parsedMetafield.reference?.__typename === 'Video') {\n        const ref = parsedMetafield.reference as VideoType;\n        return <Video {...passthroughProps} data={ref} />;\n      }\n    }\n  }\n\n  const Wrapper = as ?? 'span';\n  return (\n    <Wrapper {...passthroughProps}>{parsedMetafield.value?.toString()}</Wrapper>\n  );\n}\n\n/**\n * The `parseMetafield` utility transforms a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield)\n * into a new object whose `values` have been parsed according to the metafield `type`.\n * If the metafield is `null`, then it returns `null` back.\n *\n * Note that `parseMetafield()` will have a breaking change in a future version; it will change to behave like `metafieldParser()`.\n */\nexport function parseMetafield(\n  /** A [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield) or null */\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): PartialDeep<ParsedMetafield, {recurseIntoArrays: true}> | null {\n  if (__HYDROGEN_DEV__) {\n    console.info(\n      `'parseMetafield()' will have a breaking change in a future version; its behavior will match that of 'metafieldParser()'`\n    );\n  }\n\n  if (!metafield) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafield' was not passed any value for the 'metafield' argument`\n      );\n    }\n    return null;\n  }\n  if (\n    __HYDROGEN_DEV__ &&\n    (metafield.value === null || metafield.value === undefined)\n  ) {\n    console.warn(\n      `'parseMetafield()' was passed ${metafield.value} for 'metafield.value'`\n    );\n  }\n\n  return {\n    ...metafield,\n    value: parseMetafieldValue(metafield),\n  };\n}\n\n/**\n * The `parseMetafieldValue` function parses a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `value` from a string into a sensible type corresponding to the [Metafield](https://shopify.dev/api/storefront/reference/common-objects/metafield)'s `type`.\n * @deprecated `parseMetafieldValue()` is unsupported and will be removed in a future version.\n */\nexport function parseMetafieldValue(\n  metafield: PartialDeep<MetafieldType, {recurseIntoArrays: true}> | null\n): ParsedMetafield['value'] {\n  if (__HYDROGEN_DEV__) {\n    console.info(`'parseMetafieldValue()' will be removed in a future version`);\n  }\n\n  if (!metafield) {\n    return null;\n  }\n\n  if (metafield.value === null || metafield.value === undefined) {\n    if (__HYDROGEN_DEV__) {\n      console.warn(\n        `'parseMetafieldValue()' was passed ${metafield.value} for 'metafield.value'`\n      );\n    }\n    return metafield.value;\n  }\n\n  switch (metafield.type) {\n    case 'boolean':\n      return metafield.value === 'true';\n    case 'number_integer':\n      return parseInt(metafield.value);\n    case 'number_decimal':\n      return parseFloat(metafield.value);\n    case 'date':\n    case 'date_time':\n      return new Date(metafield.value);\n    case 'json':\n    case 'weight':\n    case 'dimension':\n    case 'volume':\n    case 'rating':\n      return parseJSON(metafield.value);\n    case 'color':\n    case 'single_line_text_field':\n    case 'multi_line_text_field':\n    case 'product_reference':\n    case 'page_reference':\n    case 'variant_reference':\n    case 'file_reference':\n    case 'url':\n    default:\n      return metafield.value;\n  }\n}\n\n/**\n * Parses a JSON string while preventing prototype injection attacks.\n */\nexport function parseJSON(json: string) {\n  if (String(json).includes('__proto__')) {\n    return JSON.parse(json, (k, v) => {\n      if (k !== '__proto__') return v;\n    });\n  }\n\n  return JSON.parse(json);\n}\n\nconst UNIT_MAPPING: Record<string, string> = {\n  // Dimension\n  mm: 'millimeter',\n  cm: 'centimeter',\n  m: 'meter',\n  in: 'inch',\n  ft: 'foot',\n  yd: 'yard',\n  // Volume\n  ml: 'milliliter',\n  l: 'liter',\n  us_fl_oz: 'fluid-ounce',\n  us_gal: 'gallon',\n  // Weight\n  kg: 'kilogram',\n  g: 'gram',\n  lb: 'pound',\n  oz: 'ounce',\n};\n\nexport function getMeasurementAsString(\n  measurement: Measurement,\n  locale = 'en-us',\n  options: Intl.NumberFormatOptions = {}\n) {\n  let measure: Measurement = {\n    value: measurement.value,\n    unit: UNIT_MAPPING[measurement.unit],\n  };\n\n  if (measure.unit == null) {\n    measure = convertToSupportedUnit(measurement.value, measurement.unit);\n  }\n\n  return new Intl.NumberFormat(locale, {\n    ...options,\n    unit: measure.unit,\n    style: 'unit',\n  }).format(measure.value);\n}\n\nfunction convertToSupportedUnit(value: number, unit: string): Measurement {\n  switch (unit) {\n    case 'cl':\n      return {\n        value: value / 1000,\n        unit: 'liter',\n      };\n    case 'm3':\n      return {\n        value: value * 1000,\n        unit: 'liter',\n      };\n    case 'us_pt':\n      return {\n        value: value * 0.125,\n        unit: 'gallon',\n      };\n    case 'us_qt':\n      return {\n        value: value * 0.5,\n        unit: 'gallon',\n      };\n    case 'us_oz':\n      return {\n        value: value / 128,\n        unit: 'gallon',\n      };\n    case 'imp_pt':\n      return {\n        value: value / 6.661, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_qt':\n      return {\n        value: value / 3.331, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_gal':\n      return {\n        value: value / 1.201, // approximate conversion\n        unit: 'gallon',\n      };\n    case 'imp_fl_oz':\n      return {\n        value: value * 0.96076, // approximate conversion\n        unit: 'fluid-ounce',\n      };\n    default:\n      throw new Error(`Unit not supported: ${unit}`);\n  }\n}\n\ntype ParsedMetafield = Omit<\n  PartialDeep<MetafieldType, {recurseIntoArrays: true}>,\n  'value'\n> & {\n  value?: string | number | boolean | JsonValue | Date | Rating | Measurement;\n};\n\nexport interface Rating {\n  value: number;\n  scale_min: number;\n  scale_max: number;\n}\n\ninterface Measurement {\n  unit: string;\n  value: number;\n}\n"],"names":["Metafield","props","data","as","passthroughProps","locale","useShop","parsedMetafield","useMemo","parseMetafield","noDataPropWarning","Error","value","undefined","noValueWarning","id","key","type","Wrapper","toLocaleDateString","toLocaleString","getMeasurementAsString","__html","split","join","protocolLessUrl","URL","href","replace","protocol","JSON","stringify","ref","reference","title","refArray","references","flattenConnection","map","index","__typename","image","_jsx","previewImage","url","toString","metafield","console","info","warn","parseMetafieldValue","parseInt","parseFloat","Date","parseJSON","json","String","includes","parse","k","v","UNIT_MAPPING","mm","cm","m","in","ft","yd","ml","l","us_fl_oz","us_gal","kg","g","lb","oz","measurement","options","measure","unit","convertToSupportedUnit","Intl","NumberFormat","style","format"],"mappings":";;;;;;AAiCO,SAASA,UACdC,OACA;;AACM,QAAA;AAAA,IAACC;AAAAA,IAAMC;AAAAA,OAAOC;AAAAA,EAAoBH,IAAAA;AAClC,QAAA;AAAA,IAACI;AAAAA,MAAUC,QAAjB;AAEMC,QAAAA,kBAAkBC,QAAQ,MAAMC,eAAeP,IAAD,GAAQ,CAACA,IAAD,CAA7B;AAE/B,MAAI,CAACK,iBAAiB;AACpB,UAAMG,oBAAqB;AACL;AACd,YAAA,IAAIC,MAAMD,iBAAV;AAAA,IAGP;AAAA,EAEF;AAED,MAAIH,gBAAgBK,UAAU,QAAQL,gBAAgBK,UAAUC,QAAW;AACzE,UAAMC,iBAAkB,mDACtBP,qBAAgBQ,OAAhBR,YAAsBA,gBAAgBS;AAElB;AACd,YAAA,IAAIL,MAAMG,cAAV;AAAA,IAGP;AAAA,EAEF;AAED,UAAQP,gBAAgBU,MAAxB;AAAA,IACE,KAAK,QAAQ;AACX,YAAMC,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,UACIG,gBAAgBK,MAAeO,mBAAmBd,MAAnD;AAAA,MAAA,CAFL;AAAA,IAKD;AAAA,IACD,KAAK,aAAa;AAChB,YAAMa,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,UACIG,gBAAgBK,MAAeQ,eAAef,MAA/C;AAAA,MAAA,CAFL;AAAA,IAKD;AAAA,IACD,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,UAAU;AACb,YAAMa,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,UACGiB,uBAAuBd,gBAAgBK,OAAsBP,MAAvC;AAAA,MAAA,CAF3B;AAAA,IAKD;AAAA,IACD,KAAK,UAAU;AACb,YAAMa,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,UACIG,gBAAgBK,MAAiBA;AAAAA,MAAAA,CAFvC;AAAA,IAKD;AAAA,IACD,KAAK,0BAA0B;AAC7B,YAAMM,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GACMd;AAAAA,QACJ,yBAAyB;AAAA,UAACkB,QAAQf,gBAAgBK;AAAAA,QAAzB;AAAA,MAAA,CAH7B;AAAA,IAMD;AAAA,IACD,KAAK,yBAAyB;AAC5B,YAAMM,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GACMd;AAAAA,QACJ,yBAAyB;AAAA,UACvBkB,QAASf,gBAAgBK,MAAiBW,MAAM,IAAxC,EAA8CC,KAAK,OAAnD;AAAA,QADe;AAAA,MAAA,CAH7B;AAAA,IAQD;AAAA,IACD,KAAK,OAAO;AACV,YAAMC,kBAAkB,IAAIC,IAAInB,gBAAgBK,KAAhD;AACA,iCACE,KAAA;AAAA,QACE,MAAMa,gBAAgBE,KAAKC,QAAQH,gBAAgBI,UAAU,EAAvD;AAAA,QADR,GAEMzB;AAAAA,QAFN,UAIGG,gBAAgBK;AAAAA,MAAAA,CALrB;AAAA,IAQD;AAAA,IACD,KAAK,QAAQ;AACX,YAAMM,WAAUf,kBAAM;AACtB,iCACGe,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,UACG0B,KAAKC,UAAUxB,gBAAgBK,KAA/B;AAAA,MAAA,CAFL;AAAA,IAKD;AAAA,IACD,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,kBAAkB;AACrB,YAAMM,WAAUf,kBAAM;AACtB,YAAM6B,MAAMzB,gBAAgB0B;AAC5B,iCACGf,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,WAAgC4B,sCAAKE,UAALF,YAAcA,2BAAKjB,OAAnBiB,YAAyB;AAAA,MAAA,CAD3D;AAAA,IAGD;AAAA,IACD,KAAK,+BAA+B;AAClC,YAAMd,WAAUf,kBAAM;AAEtB,YAAMgC,WAAW5B,gBAAgB6B,aAC5BC,kBAAkB9B,gBAAgB6B,UAAjB,IAClB;AACJ,iCACGlB,UAAD;AAAA,QAAA,GAAad;AAAAA,QAAb,UACG+B,SAASG,IAAI,CAACN,KAAKO,8BAGlB,MAAA;AAAA,UAAA,UAAmCP;AAAAA,QAAAA,GAAzB,GAAEA,oBAAO,MAAMO,OAAzB,CAHD;AAAA,MAAA,CAFL;AAAA,IASD;AAAA,IACD,KAAK,kBAAkB;AACjBhC,YAAAA,qBAAgB0B,cAAhB1B,mBAA2BiC,gBAAe,cAAc;AAC1D,cAAMR,MAAMzB,gBAAgB0B;AACrBD,eAAAA,IAAIS,QACTC,oBAAC,OAAD;AAAA,UAAO,MAAMV,IAAIS;AAAAA,UAAjB,GAA4BrC;AAAAA,QAA5B,CAAA,IACE;AAAA,MACKG,aAAAA,qBAAgB0B,cAAhB1B,mBAA2BiC,gBAAe,eAAe;AAClE,cAAMR,MAAMzB,gBAAgB0B;AACrBD,eAAAA,IAAIW,eACTD,oBAAA,KAAA;AAAA,UAAG,OAAMnC,2BAAgB0B,cAAhB1B,mBAA2BqC,QAA3BrC,YAAkC;AAAA,UAA3C,GAAmDH;AAAAA,UAAnD,8BACG,OAAD;AAAA,YAAO,MAAM4B,IAAIW;AAAAA,UAAAA,CAAjB;AAAA,QADF,CAAA,IAGE;AAAA,MACKpC,aAAAA,qBAAgB0B,cAAhB1B,mBAA2BiC,gBAAe,SAAS;AAC5D,cAAMR,MAAMzB,gBAAgB0B;AAC5B,mCAAQ,OAAD;AAAA,UAAA,GAAW7B;AAAAA,UAAkB,MAAM4B;AAAAA,QAAAA,CAA1C;AAAA,MACD;AAAA,IACF;AAAA,EApHH;AAuHA,QAAMd,UAAUf,kBAAM;AACtB,6BACG,SAAD;AAAA,IAAA,GAAaC;AAAAA,IAAb,WAAgCG,qBAAgBK,UAAhBL,mBAAuBsC;AAAAA,EAAvB,CADlC;AAGD;AASM,SAASpC,eAEdqC,WACgE;AAC1C;AACpBC,YAAQC,KACL,yHADH;AAAA,EAGD;AAED,MAAI,CAACF,WAAW;AACQ;AACpBC,cAAQE,KACL,wEADH;AAAA,IAGD;AACM,WAAA;AAAA,EACR;AACD,MAEGH,UAAUlC,UAAU,QAAQkC,UAAUlC,UAAUC,QACjD;AACQoC,YAAAA,KACL,iCAAgCH,UAAUlC,6BAD7C;AAAA,EAGD;AAEM,SAAA;AAAA,IACL,GAAGkC;AAAAA,IACHlC,OAAOsC,oBAAoBJ,SAAD;AAAA,EAAA;AAE7B;AAMM,SAASI,oBACdJ,WAC0B;AACJ;AACpBC,YAAQC,KAAM,6DAAd;AAAA,EACD;AAED,MAAI,CAACF,WAAW;AACP,WAAA;AAAA,EACR;AAED,MAAIA,UAAUlC,UAAU,QAAQkC,UAAUlC,UAAUC,QAAW;AACvC;AACZoC,cAAAA,KACL,sCAAqCH,UAAUlC,6BADlD;AAAA,IAGD;AACD,WAAOkC,UAAUlC;AAAAA,EAClB;AAED,UAAQkC,UAAU7B,MAAlB;AAAA,IACE,KAAK;AACH,aAAO6B,UAAUlC,UAAU;AAAA,IAC7B,KAAK;AACIuC,aAAAA,SAASL,UAAUlC,KAAX;AAAA,IACjB,KAAK;AACIwC,aAAAA,WAAWN,UAAUlC,KAAX;AAAA,IACnB,KAAK;AAAA,IACL,KAAK;AACI,aAAA,IAAIyC,KAAKP,UAAUlC,KAAnB;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACI0C,aAAAA,UAAUR,UAAUlC,KAAX;AAAA,IAClB,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL;AACE,aAAOkC,UAAUlC;AAAAA,EAzBrB;AA2BD;AAKM,SAAS0C,UAAUC,MAAc;AACtC,MAAIC,OAAOD,IAAD,EAAOE,SAAS,WAAtB,GAAoC;AACtC,WAAO3B,KAAK4B,MAAMH,MAAM,CAACI,GAAGC,MAAM;AAChC,UAAID,MAAM;AAAoBC,eAAAA;AAAAA,IAAAA,CADzB;AAAA,EAGR;AAEM9B,SAAAA,KAAK4B,MAAMH,IAAX;AACR;AAED,MAAMM,eAAuC;AAAA,EAE3CC,IAAI;AAAA,EACJC,IAAI;AAAA,EACJC,GAAG;AAAA,EACHC,IAAI;AAAA,EACJC,IAAI;AAAA,EACJC,IAAI;AAAA,EAEJC,IAAI;AAAA,EACJC,GAAG;AAAA,EACHC,UAAU;AAAA,EACVC,QAAQ;AAAA,EAERC,IAAI;AAAA,EACJC,GAAG;AAAA,EACHC,IAAI;AAAA,EACJC,IAAI;AAjBuC;AAoBtC,SAAStD,uBACduD,aACAvE,SAAS,SACTwE,UAAoC,CAAA,GACpC;AACA,MAAIC,UAAuB;AAAA,IACzBlE,OAAOgE,YAAYhE;AAAAA,IACnBmE,MAAMlB,aAAae,YAAYG;AAAAA,EAAAA;AAG7BD,MAAAA,QAAQC,QAAQ,MAAM;AACxBD,cAAUE,uBAAuBJ,YAAYhE,OAAOgE,YAAYG,IAAhC;AAAA,EACjC;AAEM,SAAA,IAAIE,KAAKC,aAAa7E,QAAQ;AAAA,IACnC,GAAGwE;AAAAA,IACHE,MAAMD,QAAQC;AAAAA,IACdI,OAAO;AAAA,EAHF,CAAA,EAIJC,OAAON,QAAQlE,KAJX;AAKR;AAED,SAASoE,uBAAuBpE,OAAemE,MAA2B;AACxE,UAAQA,MAAR;AAAA,IACE,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV,KAAK;AACI,aAAA;AAAA,QACLnE,OAAOA,QAAQ;AAAA,QACfmE,MAAM;AAAA,MAAA;AAAA,IAEV;AACQ,YAAA,IAAIpE,MAAO,uBAAsBoE,MAAjC;AAAA,EA/CV;AAiDD;"}

package/dist/dev/_virtual/index.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-var shim = { exports: {} };
-exports.shim = shim;
+var dist = {};
+exports.__exports = dist;
 //# sourceMappingURL=index.js.map

package/dist/dev/_virtual/index.mjs

@@ -1,5 +1,5 @@
-var shim = { exports: {} };
+var dist = {};
 export {
-  shim as s
+  dist as __exports
 };
 //# sourceMappingURL=index.mjs.map

package/dist/dev/_virtual/index2.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+var shim = { exports: {} };
+exports.shim = shim;
+//# sourceMappingURL=index2.js.map

package/dist/dev/_virtual/index2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index2.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/dev/_virtual/index2.mjs

@@ -0,0 +1,5 @@
+var shim = { exports: {} };
+export {
+  shim as s
+};
+//# sourceMappingURL=index2.mjs.map

package/dist/dev/_virtual/index2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index2.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/dev/index.js

@@ -5,6 +5,7 @@ const ExternalVideo = require("./ExternalVideo.js");
 const flattenConnection = require("./flatten-connection.js");
 const Image = require("./Image.js");
 const MediaFile = require("./MediaFile.js");
+const metafieldParser = require("./metafield-parser.js");
 const Metafield = require("./Metafield.js");
 const ModelViewer = require("./ModelViewer.js");
 const Money = require("./Money.js");
@@ -21,6 +22,7 @@ exports.ExternalVideo = ExternalVideo.ExternalVideo;
 exports.flattenConnection = flattenConnection.flattenConnection;
 exports.Image = Image.Image;
 exports.MediaFile = MediaFile.MediaFile;
+exports.metafieldParser = metafieldParser.metafieldParser;
 exports.Metafield = Metafield.Metafield;
 exports.parseMetafield = Metafield.parseMetafield;
 exports.parseMetafieldValue = Metafield.parseMetafieldValue;

package/dist/dev/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/dev/index.mjs

@@ -3,6 +3,7 @@ import { ExternalVideo } from "./ExternalVideo.mjs";
 import { flattenConnection } from "./flatten-connection.mjs";
 import { Image } from "./Image.mjs";
 import { MediaFile } from "./MediaFile.mjs";
+import { metafieldParser } from "./metafield-parser.mjs";
 import { Metafield, parseMetafield, parseMetafieldValue } from "./Metafield.mjs";
 import { ModelViewer } from "./ModelViewer.mjs";
 import { Money } from "./Money.mjs";
@@ -28,6 +29,7 @@ export {
   Video,
   createStorefrontClient,
   flattenConnection,
+  metafieldParser,
   parseMetafield,
   parseMetafieldValue,
   useCart,

package/dist/dev/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/dist/dev/metafield-parser.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const Metafield = require("./Metafield.js");
+const index = require("./node_modules/ts-expect/dist/index.js");
+const flattenConnection = require("./flatten-connection.js");
+function metafieldParser(metafield) {
+  var _a, _b, _c, _d;
+  if (!metafield.type) {
+    const noTypeError = `metafieldParser(): The 'type' field is required in order to parse the Metafield.`;
+    {
+      throw new Error(noTypeError);
+    }
+  }
+  switch (metafield.type) {
+    case "boolean":
+      return {
+        ...metafield,
+        parsedValue: metafield.value === "true"
+      };
+    case "collection_reference":
+    case "file_reference":
+    case "page_reference":
+    case "product_reference":
+    case "variant_reference":
+      return {
+        ...metafield,
+        parsedValue: metafield.reference
+      };
+    case "color":
+    case "multi_line_text_field":
+    case "single_line_text_field":
+    case "url":
+      return {
+        ...metafield,
+        parsedValue: metafield.value
+      };
+    case "dimension":
+    case "money":
+    case "json":
+    case "rating":
+    case "volume":
+    case "weight":
+    case "list.color":
+    case "list.dimension":
+    case "list.number_integer":
+    case "list.number_decimal":
+    case "list.rating":
+    case "list.single_line_text_field":
+    case "list.url":
+    case "list.volume":
+    case "list.weight": {
+      let parsedValue = null;
+      try {
+        parsedValue = Metafield.parseJSON((_a = metafield.value) != null ? _a : "");
+      } catch (err) {
+        const parseError = `metafieldParser(): attempted to JSON.parse the 'metafield.value' property, but failed.`;
+        {
+          throw new Error(parseError);
+        }
+      }
+      return {
+        ...metafield,
+        parsedValue
+      };
+    }
+    case "date":
+    case "date_time":
+      return {
+        ...metafield,
+        parsedValue: new Date((_b = metafield.value) != null ? _b : "")
+      };
+    case "list.date":
+    case "list.date_time": {
+      const jsonParseValue = Metafield.parseJSON((_c = metafield == null ? void 0 : metafield.value) != null ? _c : "");
+      return {
+        ...metafield,
+        parsedValue: jsonParseValue.map((dateString) => new Date(dateString))
+      };
+    }
+    case "number_decimal":
+    case "number_integer":
+      return {
+        ...metafield,
+        parsedValue: Number(metafield.value)
+      };
+    case "list.collection_reference":
+    case "list.file_reference":
+    case "list.page_reference":
+    case "list.product_reference":
+    case "list.variant_reference":
+      return {
+        ...metafield,
+        parsedValue: flattenConnection.flattenConnection((_d = metafield.references) != null ? _d : void 0)
+      };
+    default: {
+      const typeNotFoundError = `metafieldParser(): the 'metafield.type' you passed in is not supported. Your type: "${metafield.type}". If you believe this is an error, please open an issue on GitHub.`;
+      {
+        throw new Error(typeNotFoundError);
+      }
+    }
+  }
+}
+index.expectType(true);
+exports.metafieldParser = metafieldParser;
+//# sourceMappingURL=metafield-parser.js.map

package/dist/dev/metafield-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metafield-parser.js","sources":["../../src/metafield-parser.ts"],"sourcesContent":["import type {\n  Collection,\n  GenericFile,\n  Metafield as MetafieldBaseType,\n  MoneyV2,\n  Page,\n  Product,\n  ProductVariant,\n} from './storefront-api-types.js';\nimport type {PartialDeep, Simplify} from 'type-fest';\nimport {parseJSON} from './Metafield.js';\nimport {TypeEqual, expectType} from 'ts-expect';\nimport {flattenConnection} from './flatten-connection.js';\n\n/**\n * A temporary function that will be renamed to `parseMetafield()` in a future release.\n *\n * A function that uses `metafield.type` to parse the Metafield's `value` or `reference` or `references` (depending on the `type`) and put it in `metafield.parsedValue`\n *\n * TypeScript developers can use the type `ParsedMetafields` from this package to get the returned object's type correct. For example:\n *\n * ```\n * metafieldParser<ParsedMetafields['boolean']>({type: 'boolean', value: 'false'}\n * ```\n */\nexport function metafieldParser<ReturnGeneric>(\n  metafield: PartialDeep<MetafieldBaseType, {recurseIntoArrays: true}>\n): ReturnGeneric {\n  if (!metafield.type) {\n    const noTypeError = `metafieldParser(): The 'type' field is required in order to parse the Metafield.`;\n    if (__HYDROGEN_DEV__) {\n      throw new Error(noTypeError);\n    } else {\n      console.error(`${noTypeError} Returning 'parsedValue' of 'null'`);\n      return {\n        ...metafield,\n        parsedValue: null,\n      } as ReturnGeneric;\n    }\n  }\n\n  switch (metafield.type) {\n    case 'boolean':\n      return {\n        ...metafield,\n        parsedValue: metafield.value === 'true',\n      } as ReturnGeneric;\n\n    case 'collection_reference':\n    case 'file_reference':\n    case 'page_reference':\n    case 'product_reference':\n    case 'variant_reference':\n      return {\n        ...metafield,\n        parsedValue: metafield.reference,\n      } as ReturnGeneric;\n\n    case 'color':\n    case 'multi_line_text_field':\n    case 'single_line_text_field':\n    case 'url':\n      return {\n        ...metafield,\n        parsedValue: metafield.value,\n      } as ReturnGeneric;\n\n    // TODO: 'money' should probably be parsed even further to like `useMoney()`, but that logic needs to be extracted first so it's not a hook\n    case 'dimension':\n    case 'money':\n    case 'json':\n    case 'rating':\n    case 'volume':\n    case 'weight':\n    case 'list.color':\n    case 'list.dimension':\n    case 'list.number_integer':\n    case 'list.number_decimal':\n    case 'list.rating':\n    case 'list.single_line_text_field':\n    case 'list.url':\n    case 'list.volume':\n    case 'list.weight': {\n      let parsedValue = null;\n      try {\n        parsedValue = parseJSON(metafield.value ?? '');\n      } catch (err) {\n        const parseError = `metafieldParser(): attempted to JSON.parse the 'metafield.value' property, but failed.`;\n        if (__HYDROGEN_DEV__) {\n          throw new Error(parseError);\n        } else {\n          console.error(`${parseError} Returning 'null' for 'parsedValue'`);\n        }\n        parsedValue = null;\n      }\n      return {\n        ...metafield,\n        parsedValue,\n      } as ReturnGeneric;\n    }\n\n    case 'date':\n    case 'date_time':\n      return {\n        ...metafield,\n        parsedValue: new Date(metafield.value ?? ''),\n      } as ReturnGeneric;\n\n    case 'list.date':\n    case 'list.date_time': {\n      const jsonParseValue = parseJSON(metafield?.value ?? '') as string[];\n      return {\n        ...metafield,\n        parsedValue: jsonParseValue.map((dateString) => new Date(dateString)),\n      } as ReturnGeneric;\n    }\n\n    case 'number_decimal':\n    case 'number_integer':\n      return {\n        ...metafield,\n        parsedValue: Number(metafield.value),\n      } as ReturnGeneric;\n\n    case 'list.collection_reference':\n    case 'list.file_reference':\n    case 'list.page_reference':\n    case 'list.product_reference':\n    case 'list.variant_reference':\n      return {\n        ...metafield,\n        parsedValue: flattenConnection(metafield.references ?? undefined),\n      } as ReturnGeneric;\n\n    default: {\n      const typeNotFoundError = `metafieldParser(): the 'metafield.type' you passed in is not supported. Your type: \"${metafield.type}\". If you believe this is an error, please open an issue on GitHub.`;\n      if (__HYDROGEN_DEV__) {\n        throw new Error(typeNotFoundError);\n      } else {\n        console.error(\n          `${typeNotFoundError}  Returning 'parsedValue' of 'null'`\n        );\n        return {\n          ...metafield,\n          parsedValue: null,\n        } as ReturnGeneric;\n      }\n    }\n  }\n}\n\n// taken from https://shopify.dev/apps/metafields/types\nexport const allMetafieldTypesArray = [\n  'boolean',\n  'collection_reference',\n  'color',\n  'date',\n  'date_time',\n  'dimension',\n  'file_reference',\n  'json',\n  'money',\n  'multi_line_text_field',\n  'number_decimal',\n  'number_integer',\n  'page_reference',\n  'product_reference',\n  'rating',\n  'single_line_text_field',\n  'url',\n  'variant_reference',\n  'volume',\n  'weight',\n  // list metafields\n  'list.collection_reference',\n  'list.color',\n  'list.date',\n  'list.date_time',\n  'list.dimension',\n  'list.file_reference',\n  'list.number_integer',\n  'list.number_decimal',\n  'list.page_reference',\n  'list.product_reference',\n  'list.rating',\n  'list.single_line_text_field',\n  'list.url',\n  'list.variant_reference',\n  'list.volume',\n  'list.weight',\n] as const;\n\n/** A union of all the supported `metafield.type`s */\nexport type MetafieldTypeTypes = typeof allMetafieldTypesArray[number];\n\n/**\n * A mapping of a Metafield's `type` to the TypeScript type that is returned from `metafieldParser()`\n * For example, when using `metafieldParser()`, the type will be correctly returned when used like the following:\n *\n * ```\n * const parsedMetafield = metafieldParser<ParsedMetafields['boolean']>(metafield);`\n * ```\n * `parsedMetafield.parsedValue`'s type is now `boolean`\n */\nexport type ParsedMetafields<ExtraTypeGeneric = void> = {\n  /** A Metafield that's been parsed, with a `parsedValue` of `boolean` */\n  boolean: Simplify<BooleanParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of a `Collection` object (as defined by the Storefront API) */\n  collection_reference: Simplify<CollectionParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `string` */\n  color: Simplify<ColorParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Date` */\n  date: Simplify<DatesParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Date` */\n  date_time: Simplify<DatesParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */\n  dimension: Simplify<MeasurementParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of a `GenericFile` object (as defined by the Storefront API) */\n  file_reference: Simplify<FileRefParsedMetafield>;\n  /**\n   * A Metafield that's been parsed, with a `parsedValue` of type `unknown`, unless you pass in the type as a generic. For example:\n   *\n   * ```\n   * ParsedMetafields<MyJsonType>['json']\n   * ```\n   */\n  json: Simplify<JsonParsedMetafield<ExtraTypeGeneric>>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Money` */\n  money: Simplify<MoneyParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `string` */\n  multi_line_text_field: Simplify<TextParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `number` */\n  number_decimal: Simplify<NumberParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `number` */\n  number_integer: Simplify<NumberParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of a `Page` object (as defined by the Storefront API) */\n  page_reference: Simplify<PageParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of a `Product` object (as defined by the Storefront API) */\n  product_reference: Simplify<ProductParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Rating` */\n  rating: Simplify<RatingParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `string` */\n  single_line_text_field: Simplify<TextParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `string` */\n  url: Simplify<TextParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of a `ProductVariant` object (as defined by the Storefront API) */\n  variant_reference: Simplify<VariantParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */\n  volume: Simplify<MeasurementParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */\n  weight: Simplify<MeasurementParsedMetafield>;\n  // list metafields\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Collection` objects (as defined by the Storefront API) */\n  'list.collection_reference': Simplify<CollectionListParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */\n  'list.color': Simplify<ColorListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of Date objects */\n  'list.date': Simplify<DatesListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of Date objects */\n  'list.date_time': Simplify<DatesListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Measurement` objects */\n  'list.dimension': Simplify<MeasurementListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `GenericFile` objects (as defined by the Storefront API) */\n  'list.file_reference': Simplify<FileListParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of numbers */\n  'list.number_integer': Simplify<NumberListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of numbers */\n  'list.number_decimal': Simplify<NumberListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Page` objects (as defined by the Storefront API) */\n  'list.page_reference': Simplify<PageListParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Product` objects (as defined by the Storefront API) */\n  'list.product_reference': Simplify<ProductListParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Rating`s */\n  'list.rating': Simplify<RatingListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */\n  'list.single_line_text_field': Simplify<TextListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */\n  'list.url': Simplify<TextListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `ProductVariant` objects (as defined by the Storefront API) */\n  'list.variant_reference': Simplify<VariantListParsedRefMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Measurement`s */\n  'list.volume': Simplify<MeasurementListParsedMetafield>;\n  /** A Metafield that's been parsed, with a `parsedValue` of an array of `Measurement`s */\n  'list.weight': Simplify<MeasurementListParsedMetafield>;\n};\n\n// This test is to ensure that ParsedMetafields has a key for every item in 'allMetafieldsTypesArray'\nexpectType<TypeEqual<keyof ParsedMetafields, MetafieldTypeTypes>>(true);\n\ninterface ParsedBase extends MetafieldBaseType {\n  type: MetafieldTypeTypes;\n  parsedValue: unknown;\n}\n\ninterface BooleanParsedMetafield extends ParsedBase {\n  type: 'boolean';\n  parsedValue: boolean | null;\n}\ntype CollectionParsedRefMetafield = MetafieldBaseType & {\n  type: 'collection_reference';\n  parsedValue: Collection | null;\n};\ntype ColorParsedMetafield = MetafieldBaseType & {\n  type: 'color';\n  parsedValue: string | null;\n};\ntype DatesParsedMetafield = MetafieldBaseType & {\n  type: 'date' | 'date_time';\n  parsedValue: Date | null;\n};\n\ntype MeasurementParsedMetafield = MetafieldBaseType & {\n  type: 'dimension' | 'weight' | 'volume';\n  parsedValue: Measurement | null;\n};\n\ntype FileRefParsedMetafield = MetafieldBaseType & {\n  type: 'file_reference';\n  parsedValue: GenericFile | null;\n};\n\ntype JsonParsedMetafield<JsonTypeGeneric = void> = MetafieldBaseType & {\n  type: 'json';\n  parsedValue: JsonTypeGeneric extends void ? unknown : JsonTypeGeneric | null;\n};\n\ntype MoneyParsedMetafield = MetafieldBaseType & {\n  type: 'money';\n  parsedValue: MoneyV2 | null;\n};\n\ntype TextParsedMetafield = MetafieldBaseType & {\n  type: 'single_line_text_field' | 'multi_line_text_field' | 'url';\n  parsedValue: string | null;\n};\n\ntype NumberParsedMetafield = MetafieldBaseType & {\n  type: 'number_decimal' | 'number_integer';\n  parsedValue: number | null;\n};\n\ntype PageParsedRefMetafield = MetafieldBaseType & {\n  type: 'page_reference';\n  parsedValue: Page | null;\n};\n\ntype ProductParsedRefMetafield = MetafieldBaseType & {\n  type: 'product_reference';\n  parsedValue: Product | null;\n};\n\ntype RatingParsedMetafield = MetafieldBaseType & {\n  type: 'rating';\n  parsedValue: Rating | null;\n};\n\ntype VariantParsedRefMetafield = MetafieldBaseType & {\n  type: 'variant_reference';\n  parsedValue: ProductVariant | null;\n};\n\ntype CollectionListParsedRefMetafield = MetafieldBaseType & {\n  type: 'list.collection_reference';\n  parsedValue: Array<Collection> | null;\n};\n\ntype ColorListParsedMetafield = MetafieldBaseType & {\n  type: 'list.color';\n  parsedValue: Array<string> | null;\n};\n\ntype DatesListParsedMetafield = MetafieldBaseType & {\n  type: 'list.date' | 'list.date_time';\n  parsedValue: Array<Date> | null;\n};\n\ntype MeasurementListParsedMetafield = MetafieldBaseType & {\n  type: 'list.dimension' | 'list.weight' | 'list.volume';\n  parsedValue: Array<Measurement> | null;\n};\n\ntype FileListParsedRefMetafield = MetafieldBaseType & {\n  type: 'list.file_reference';\n  parsedValue: Array<GenericFile> | null;\n};\n\ntype TextListParsedMetafield = MetafieldBaseType & {\n  type: 'list.single_line_text_field' | 'list.url';\n  parsedValue: Array<string> | null;\n};\n\ntype NumberListParsedMetafield = MetafieldBaseType & {\n  type: 'list.number_decimal' | 'list.number_integer';\n  parsedValue: Array<number> | null;\n};\n\ntype PageListParsedRefMetafield = MetafieldBaseType & {\n  type: 'list.page_reference';\n  parsedValue: Array<Page> | null;\n};\n\ntype ProductListParsedRefMetafield = MetafieldBaseType & {\n  type: 'list.product_reference';\n  parsedValue: Array<Product> | null;\n};\n\ntype RatingListParsedMetafield = MetafieldBaseType & {\n  type: 'list.rating';\n  parsedValue: Array<Rating> | null;\n};\n\ntype VariantListParsedRefMetafield = MetafieldBaseType & {\n  type: 'list.variant_reference';\n  parsedValue: Array<ProductVariant> | null;\n};\n\nexport type Measurement = {\n  unit: string;\n  value: number;\n};\n\nexport interface Rating {\n  value: number;\n  scale_min: number;\n  scale_max: number;\n}\n"],"names":["parseJSON","flattenConnection","expectType"],"mappings":";;;;;AAyBO,SAAS,gBACd,WACe;;AACX,MAAA,CAAC,UAAU,MAAM;AACnB,UAAM,cAAc;AACE;AACd,YAAA,IAAI,MAAM,WAAW;AAAA,IAO7B;AAAA,EACF;AAEA,UAAQ,UAAU,MAAM;AAAA,IACtB,KAAK;AACI,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa,UAAU,UAAU;AAAA,MAAA;AAAA,IAGrC,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACI,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa,UAAU;AAAA,MAAA;AAAA,IAG3B,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACI,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa,UAAU;AAAA,MAAA;AAAA,IAI3B,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,eAAe;AAClB,UAAI,cAAc;AACd,UAAA;AACY,sBAAAA,UAAAA,WAAU,eAAU,UAAV,YAAmB,EAAE;AAAA,eACtC;AACP,cAAM,aAAa;AACG;AACd,gBAAA,IAAI,MAAM,UAAU;AAAA,QAG5B;AAAA,MAEF;AACO,aAAA;AAAA,QACL,GAAG;AAAA,QACH;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK;AAAA,IACL,KAAK;AACI,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa,IAAI,MAAK,eAAU,UAAV,YAAmB,EAAE;AAAA,MAAA;AAAA,IAG/C,KAAK;AAAA,IACL,KAAK,kBAAkB;AACrB,YAAM,iBAAiBA,UAAA,WAAU,4CAAW,UAAX,YAAoB,EAAE;AAChD,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa,eAAe,IAAI,CAAC,eAAe,IAAI,KAAK,UAAU,CAAC;AAAA,MAAA;AAAA,IAExE;AAAA,IAEA,KAAK;AAAA,IACL,KAAK;AACI,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa,OAAO,UAAU,KAAK;AAAA,MAAA;AAAA,IAGvC,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACI,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAaC,kBAAAA,mBAAkB,eAAU,eAAV,YAAwB,MAAS;AAAA,MAAA;AAAA,IAGpE,SAAS;AACD,YAAA,oBAAoB,uFAAuF,UAAU;AACrG;AACd,cAAA,IAAI,MAAM,iBAAiB;AAAA,MASnC;AAAA,IACF;AAAA,EACF;AACF;AA0IAC,MAAA,WAAkE,IAAI;;"}

package/dist/dev/metafield-parser.mjs

@@ -0,0 +1,105 @@
+import { parseJSON } from "./Metafield.mjs";
+import { expectType as expectType_1 } from "./node_modules/ts-expect/dist/index.mjs";
+import { flattenConnection } from "./flatten-connection.mjs";
+function metafieldParser(metafield) {
+  var _a, _b, _c, _d;
+  if (!metafield.type) {
+    const noTypeError = `metafieldParser(): The 'type' field is required in order to parse the Metafield.`;
+    {
+      throw new Error(noTypeError);
+    }
+  }
+  switch (metafield.type) {
+    case "boolean":
+      return {
+        ...metafield,
+        parsedValue: metafield.value === "true"
+      };
+    case "collection_reference":
+    case "file_reference":
+    case "page_reference":
+    case "product_reference":
+    case "variant_reference":
+      return {
+        ...metafield,
+        parsedValue: metafield.reference
+      };
+    case "color":
+    case "multi_line_text_field":
+    case "single_line_text_field":
+    case "url":
+      return {
+        ...metafield,
+        parsedValue: metafield.value
+      };
+    case "dimension":
+    case "money":
+    case "json":
+    case "rating":
+    case "volume":
+    case "weight":
+    case "list.color":
+    case "list.dimension":
+    case "list.number_integer":
+    case "list.number_decimal":
+    case "list.rating":
+    case "list.single_line_text_field":
+    case "list.url":
+    case "list.volume":
+    case "list.weight": {
+      let parsedValue = null;
+      try {
+        parsedValue = parseJSON((_a = metafield.value) != null ? _a : "");
+      } catch (err) {
+        const parseError = `metafieldParser(): attempted to JSON.parse the 'metafield.value' property, but failed.`;
+        {
+          throw new Error(parseError);
+        }
+      }
+      return {
+        ...metafield,
+        parsedValue
+      };
+    }
+    case "date":
+    case "date_time":
+      return {
+        ...metafield,
+        parsedValue: new Date((_b = metafield.value) != null ? _b : "")
+      };
+    case "list.date":
+    case "list.date_time": {
+      const jsonParseValue = parseJSON((_c = metafield == null ? void 0 : metafield.value) != null ? _c : "");
+      return {
+        ...metafield,
+        parsedValue: jsonParseValue.map((dateString) => new Date(dateString))
+      };
+    }
+    case "number_decimal":
+    case "number_integer":
+      return {
+        ...metafield,
+        parsedValue: Number(metafield.value)
+      };
+    case "list.collection_reference":
+    case "list.file_reference":
+    case "list.page_reference":
+    case "list.product_reference":
+    case "list.variant_reference":
+      return {
+        ...metafield,
+        parsedValue: flattenConnection((_d = metafield.references) != null ? _d : void 0)
+      };
+    default: {
+      const typeNotFoundError = `metafieldParser(): the 'metafield.type' you passed in is not supported. Your type: "${metafield.type}". If you believe this is an error, please open an issue on GitHub.`;
+      {
+        throw new Error(typeNotFoundError);
+      }
+    }
+  }
+}
+expectType_1(true);
+export {
+  metafieldParser
+};
+//# sourceMappingURL=metafield-parser.mjs.map