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

package/dist/prod/metafield-parser.mjs

@@ -0,0 +1,116 @@
+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.`;
+    {
+      console.error(`${noTypeError} Returning 'parsedValue' of 'null'`);
+      return {
+        ...metafield,
+        parsedValue: null
+      };
+    }
+  }
+  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.`;
+        {
+          console.error(`${parseError} Returning 'null' for 'parsedValue'`);
+        }
+        parsedValue = null;
+      }
+      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.`;
+      {
+        console.error(
+          `${typeNotFoundError}  Returning 'parsedValue' of 'null'`
+        );
+        return {
+          ...metafield,
+          parsedValue: null
+        };
+      }
+    }
+  }
+}
+expectType_1(true);
+export {
+  metafieldParser
+};
+//# sourceMappingURL=metafield-parser.mjs.map

package/dist/prod/metafield-parser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metafield-parser.mjs","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":["expectType"],"mappings":";;;AAyBO,SAAS,gBACd,WACe;;AACX,MAAA,CAAC,UAAU,MAAM;AACnB,UAAM,cAAc;AAGb;AACG,cAAA,MAAM,GAAG,+CAA+C;AACzD,aAAA;AAAA,QACL,GAAG;AAAA,QACH,aAAa;AAAA,MAAA;AAAA,IAEjB;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,sBAAA,WAAU,eAAU,UAAV,YAAmB,EAAE;AAAA,eACtC;AACP,cAAM,aAAa;AAGZ;AACG,kBAAA,MAAM,GAAG,+CAA+C;AAAA,QAClE;AACc,sBAAA;AAAA,MAChB;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,iBAAiB,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,aAAa,mBAAkB,eAAU,eAAV,YAAwB,MAAS;AAAA,MAAA;AAAA,IAGpE,SAAS;AACD,YAAA,oBAAoB,uFAAuF,UAAU;AAGpH;AACG,gBAAA;AAAA,UACN,GAAG;AAAA,QAAA;AAEE,eAAA;AAAA,UACL,GAAG;AAAA,UACH,aAAa;AAAA,QAAA;AAAA,MAEjB;AAAA,IACF;AAAA,EACF;AACF;AA0IAA,aAAkE,IAAI;"}

package/dist/prod/node_modules/ts-expect/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const index = require("../../../_virtual/index.js");
+Object.defineProperty(index.__exports, "__esModule", { value: true });
+index.__exports.expectNever = exports.expectType = index.__exports.expectType = void 0;
+const expectType = (value) => void 0;
+exports.expectType = index.__exports.expectType = expectType;
+const expectNever = (value) => {
+  throw new TypeError("Unexpected value: " + value);
+};
+index.__exports.expectNever = expectNever;
+exports.default = index.__exports;
+//# sourceMappingURL=index.js.map

package/dist/prod/node_modules/ts-expect/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../../node_modules/ts-expect/dist/index.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.expectNever = exports.expectType = void 0;\n/**\n * Asserts the `value` type is assignable to the generic `Type`.\n *\n * ```ts\n * expectType<number>(123);\n * expectType<boolean>(true);\n * ```\n */\nconst expectType = (value) => void 0;\nexports.expectType = expectType;\n/**\n * Asserts the `value` type is `never`, i.e. this function should never be called.\n * If it is called at runtime, it will throw a `TypeError`. The return type is\n * `never` to support returning in exhaustive type checks.\n *\n * ```ts\n * return expectNever(value);\n * ```\n */\nconst expectNever = (value) => {\n    throw new TypeError(\"Unexpected value: \" + value);\n};\nexports.expectNever = expectNever;\n//# sourceMappingURL=index.js.map"],"names":["dist","expectType_1"],"mappings":";;;AACA,OAAO,eAAeA,MAAAA,WAAS,cAAc,EAAE,OAAO,KAAI,CAAE;AAC5DA,MAAA,UAAA,cAAsBC,QAAA,aAAAD,gBAAA,aAAqB;AAS3C,MAAM,aAAa,CAAC,UAAU;AACZC,QAAAA,aAAAD,MAAAA,UAAA,aAAG;AAUrB,MAAM,cAAc,CAAC,UAAU;AAC3B,QAAM,IAAI,UAAU,uBAAuB,KAAK;AACpD;AACmBA,MAAA,UAAA,cAAG;;"}

package/dist/prod/node_modules/ts-expect/dist/index.mjs

@@ -0,0 +1,15 @@
+import { __exports as dist } from "../../../_virtual/index.mjs";
+import { __exports } from "../../../_virtual/index.mjs";
+Object.defineProperty(dist, "__esModule", { value: true });
+dist.expectNever = expectType_1 = dist.expectType = void 0;
+const expectType = (value) => void 0;
+var expectType_1 = dist.expectType = expectType;
+const expectNever = (value) => {
+  throw new TypeError("Unexpected value: " + value);
+};
+dist.expectNever = expectNever;
+export {
+  __exports as default,
+  expectType_1 as expectType
+};
+//# sourceMappingURL=index.mjs.map

package/dist/prod/node_modules/ts-expect/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../../../../node_modules/ts-expect/dist/index.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.expectNever = exports.expectType = void 0;\n/**\n * Asserts the `value` type is assignable to the generic `Type`.\n *\n * ```ts\n * expectType<number>(123);\n * expectType<boolean>(true);\n * ```\n */\nconst expectType = (value) => void 0;\nexports.expectType = expectType;\n/**\n * Asserts the `value` type is `never`, i.e. this function should never be called.\n * If it is called at runtime, it will throw a `TypeError`. The return type is\n * `never` to support returning in exhaustive type checks.\n *\n * ```ts\n * return expectNever(value);\n * ```\n */\nconst expectNever = (value) => {\n    throw new TypeError(\"Unexpected value: \" + value);\n};\nexports.expectNever = expectNever;\n//# sourceMappingURL=index.js.map"],"names":[],"mappings":";;AACA,OAAO,eAAe,MAAS,cAAc,EAAE,OAAO,KAAI,CAAE;AAC5D,KAAA,cAAsB,eAAA,KAAA,aAAqB;AAS3C,MAAM,aAAa,CAAC,UAAU;AACZ,IAAA,eAAA,KAAA,aAAG;AAUrB,MAAM,cAAc,CAAC,UAAU;AAC3B,QAAM,IAAI,UAAU,uBAAuB,KAAK;AACpD;AACmB,KAAA,cAAG;"}

package/dist/prod/node_modules/use-sync-external-store/shim/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const index = require("../../../_virtual/index.js");
+const index = require("../../../_virtual/index2.js");
 const useSyncExternalStoreShim_production_min = require("../cjs/use-sync-external-store-shim.production.min.js");
 const useSyncExternalStoreShim_development = require("../cjs/use-sync-external-store-shim.development.js");
 var hasRequiredShim;

package/dist/prod/node_modules/use-sync-external-store/shim/index.mjs

@@ -1,4 +1,4 @@
-import { s as shim } from "../../../_virtual/index.mjs";
+import { s as shim } from "../../../_virtual/index2.mjs";
 import { __require as requireUseSyncExternalStoreShim_production_min } from "../cjs/use-sync-external-store-shim.production.min.mjs";
 import { __require as requireUseSyncExternalStoreShim_development } from "../cjs/use-sync-external-store-shim.development.mjs";
 var hasRequiredShim;

package/dist/types/Metafield.d.ts

@@ -22,6 +22,8 @@ export declare function Metafield<ComponentGeneric extends ElementType>(props: M
  * The `parseMetafield` utility transforms a [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield)
  * into a new object whose `values` have been parsed according to the metafield `type`.
  * If the metafield is `null`, then it returns `null` back.
+ *
+ * Note that `parseMetafield()` will have a breaking change in a future version; it will change to behave like `metafieldParser()`.
  */
 export declare function parseMetafield(
 /** A [Metafield](https://shopify.dev/api/storefront/reference/common-objects/Metafield) or null */
@@ -32,6 +34,7 @@ metafield: PartialDeep<MetafieldType, {
 }> | null;
 /**
  * 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`.
+ * @deprecated `parseMetafieldValue()` is unsupported and will be removed in a future version.
  */
 export declare function parseMetafieldValue(metafield: PartialDeep<MetafieldType, {
     recurseIntoArrays: true;

package/dist/types/index.d.cts

@@ -4,6 +4,7 @@ export { ExternalVideo } from './ExternalVideo.js';
 export { flattenConnection } from './flatten-connection.js';
 export { Image } from './Image.js';
 export { MediaFile } from './MediaFile.js';
+export { metafieldParser, type ParsedMetafields } from './metafield-parser.js';
 export { Metafield, parseMetafield, parseMetafieldValue } from './Metafield.js';
 export { ModelViewer } from './ModelViewer.js';
 export { Money } from './Money.js';

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ export { ExternalVideo } from './ExternalVideo.js';
 export { flattenConnection } from './flatten-connection.js';
 export { Image } from './Image.js';
 export { MediaFile } from './MediaFile.js';
+export { metafieldParser, type ParsedMetafields } from './metafield-parser.js';
 export { Metafield, parseMetafield, parseMetafieldValue } from './Metafield.js';
 export { ModelViewer } from './ModelViewer.js';
 export { Money } from './Money.js';

package/dist/types/metafield-parser.d.ts

@@ -0,0 +1,222 @@
+import type { Collection, GenericFile, Metafield as MetafieldBaseType, MoneyV2, Page, Product, ProductVariant } from './storefront-api-types.js';
+import type { PartialDeep, Simplify } from 'type-fest';
+/**
+ * A temporary function that will be renamed to `parseMetafield()` in a future release.
+ *
+ * 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`
+ *
+ * TypeScript developers can use the type `ParsedMetafields` from this package to get the returned object's type correct. For example:
+ *
+ * ```
+ * metafieldParser<ParsedMetafields['boolean']>({type: 'boolean', value: 'false'}
+ * ```
+ */
+export declare function metafieldParser<ReturnGeneric>(metafield: PartialDeep<MetafieldBaseType, {
+    recurseIntoArrays: true;
+}>): ReturnGeneric;
+export declare const allMetafieldTypesArray: readonly ["boolean", "collection_reference", "color", "date", "date_time", "dimension", "file_reference", "json", "money", "multi_line_text_field", "number_decimal", "number_integer", "page_reference", "product_reference", "rating", "single_line_text_field", "url", "variant_reference", "volume", "weight", "list.collection_reference", "list.color", "list.date", "list.date_time", "list.dimension", "list.file_reference", "list.number_integer", "list.number_decimal", "list.page_reference", "list.product_reference", "list.rating", "list.single_line_text_field", "list.url", "list.variant_reference", "list.volume", "list.weight"];
+/** A union of all the supported `metafield.type`s */
+export declare type MetafieldTypeTypes = typeof allMetafieldTypesArray[number];
+/**
+ * A mapping of a Metafield's `type` to the TypeScript type that is returned from `metafieldParser()`
+ * For example, when using `metafieldParser()`, the type will be correctly returned when used like the following:
+ *
+ * ```
+ * const parsedMetafield = metafieldParser<ParsedMetafields['boolean']>(metafield);`
+ * ```
+ * `parsedMetafield.parsedValue`'s type is now `boolean`
+ */
+export declare type ParsedMetafields<ExtraTypeGeneric = void> = {
+    /** A Metafield that's been parsed, with a `parsedValue` of `boolean` */
+    boolean: Simplify<BooleanParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of a `Collection` object (as defined by the Storefront API) */
+    collection_reference: Simplify<CollectionParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `string` */
+    color: Simplify<ColorParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Date` */
+    date: Simplify<DatesParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Date` */
+    date_time: Simplify<DatesParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */
+    dimension: Simplify<MeasurementParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of a `GenericFile` object (as defined by the Storefront API) */
+    file_reference: Simplify<FileRefParsedMetafield>;
+    /**
+     * A Metafield that's been parsed, with a `parsedValue` of type `unknown`, unless you pass in the type as a generic. For example:
+     *
+     * ```
+     * ParsedMetafields<MyJsonType>['json']
+     * ```
+     */
+    json: Simplify<JsonParsedMetafield<ExtraTypeGeneric>>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Money` */
+    money: Simplify<MoneyParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `string` */
+    multi_line_text_field: Simplify<TextParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `number` */
+    number_decimal: Simplify<NumberParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `number` */
+    number_integer: Simplify<NumberParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of a `Page` object (as defined by the Storefront API) */
+    page_reference: Simplify<PageParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of a `Product` object (as defined by the Storefront API) */
+    product_reference: Simplify<ProductParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Rating` */
+    rating: Simplify<RatingParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `string` */
+    single_line_text_field: Simplify<TextParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `string` */
+    url: Simplify<TextParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of a `ProductVariant` object (as defined by the Storefront API) */
+    variant_reference: Simplify<VariantParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */
+    volume: Simplify<MeasurementParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */
+    weight: Simplify<MeasurementParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Collection` objects (as defined by the Storefront API) */
+    'list.collection_reference': Simplify<CollectionListParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */
+    'list.color': Simplify<ColorListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of Date objects */
+    'list.date': Simplify<DatesListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of Date objects */
+    'list.date_time': Simplify<DatesListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Measurement` objects */
+    'list.dimension': Simplify<MeasurementListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `GenericFile` objects (as defined by the Storefront API) */
+    'list.file_reference': Simplify<FileListParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of numbers */
+    'list.number_integer': Simplify<NumberListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of numbers */
+    'list.number_decimal': Simplify<NumberListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Page` objects (as defined by the Storefront API) */
+    'list.page_reference': Simplify<PageListParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Product` objects (as defined by the Storefront API) */
+    'list.product_reference': Simplify<ProductListParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Rating`s */
+    'list.rating': Simplify<RatingListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */
+    'list.single_line_text_field': Simplify<TextListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */
+    'list.url': Simplify<TextListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `ProductVariant` objects (as defined by the Storefront API) */
+    'list.variant_reference': Simplify<VariantListParsedRefMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Measurement`s */
+    'list.volume': Simplify<MeasurementListParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Measurement`s */
+    'list.weight': Simplify<MeasurementListParsedMetafield>;
+};
+interface ParsedBase extends MetafieldBaseType {
+    type: MetafieldTypeTypes;
+    parsedValue: unknown;
+}
+interface BooleanParsedMetafield extends ParsedBase {
+    type: 'boolean';
+    parsedValue: boolean | null;
+}
+declare type CollectionParsedRefMetafield = MetafieldBaseType & {
+    type: 'collection_reference';
+    parsedValue: Collection | null;
+};
+declare type ColorParsedMetafield = MetafieldBaseType & {
+    type: 'color';
+    parsedValue: string | null;
+};
+declare type DatesParsedMetafield = MetafieldBaseType & {
+    type: 'date' | 'date_time';
+    parsedValue: Date | null;
+};
+declare type MeasurementParsedMetafield = MetafieldBaseType & {
+    type: 'dimension' | 'weight' | 'volume';
+    parsedValue: Measurement | null;
+};
+declare type FileRefParsedMetafield = MetafieldBaseType & {
+    type: 'file_reference';
+    parsedValue: GenericFile | null;
+};
+declare type JsonParsedMetafield<JsonTypeGeneric = void> = MetafieldBaseType & {
+    type: 'json';
+    parsedValue: JsonTypeGeneric extends void ? unknown : JsonTypeGeneric | null;
+};
+declare type MoneyParsedMetafield = MetafieldBaseType & {
+    type: 'money';
+    parsedValue: MoneyV2 | null;
+};
+declare type TextParsedMetafield = MetafieldBaseType & {
+    type: 'single_line_text_field' | 'multi_line_text_field' | 'url';
+    parsedValue: string | null;
+};
+declare type NumberParsedMetafield = MetafieldBaseType & {
+    type: 'number_decimal' | 'number_integer';
+    parsedValue: number | null;
+};
+declare type PageParsedRefMetafield = MetafieldBaseType & {
+    type: 'page_reference';
+    parsedValue: Page | null;
+};
+declare type ProductParsedRefMetafield = MetafieldBaseType & {
+    type: 'product_reference';
+    parsedValue: Product | null;
+};
+declare type RatingParsedMetafield = MetafieldBaseType & {
+    type: 'rating';
+    parsedValue: Rating | null;
+};
+declare type VariantParsedRefMetafield = MetafieldBaseType & {
+    type: 'variant_reference';
+    parsedValue: ProductVariant | null;
+};
+declare type CollectionListParsedRefMetafield = MetafieldBaseType & {
+    type: 'list.collection_reference';
+    parsedValue: Array<Collection> | null;
+};
+declare type ColorListParsedMetafield = MetafieldBaseType & {
+    type: 'list.color';
+    parsedValue: Array<string> | null;
+};
+declare type DatesListParsedMetafield = MetafieldBaseType & {
+    type: 'list.date' | 'list.date_time';
+    parsedValue: Array<Date> | null;
+};
+declare type MeasurementListParsedMetafield = MetafieldBaseType & {
+    type: 'list.dimension' | 'list.weight' | 'list.volume';
+    parsedValue: Array<Measurement> | null;
+};
+declare type FileListParsedRefMetafield = MetafieldBaseType & {
+    type: 'list.file_reference';
+    parsedValue: Array<GenericFile> | null;
+};
+declare type TextListParsedMetafield = MetafieldBaseType & {
+    type: 'list.single_line_text_field' | 'list.url';
+    parsedValue: Array<string> | null;
+};
+declare type NumberListParsedMetafield = MetafieldBaseType & {
+    type: 'list.number_decimal' | 'list.number_integer';
+    parsedValue: Array<number> | null;
+};
+declare type PageListParsedRefMetafield = MetafieldBaseType & {
+    type: 'list.page_reference';
+    parsedValue: Array<Page> | null;
+};
+declare type ProductListParsedRefMetafield = MetafieldBaseType & {
+    type: 'list.product_reference';
+    parsedValue: Array<Product> | null;
+};
+declare type RatingListParsedMetafield = MetafieldBaseType & {
+    type: 'list.rating';
+    parsedValue: Array<Rating> | null;
+};
+declare type VariantListParsedRefMetafield = MetafieldBaseType & {
+    type: 'list.variant_reference';
+    parsedValue: Array<ProductVariant> | null;
+};
+export declare type Measurement = {
+    unit: string;
+    value: number;
+};
+export interface Rating {
+    value: number;
+    scale_min: number;
+    scale_max: number;
+}
+export {};

package/dist/umd/hydrogen-react.dev.js

@@ -2548,6 +2548,9 @@ fragment ImageFragment on Image {
     }, (_i = parsedMetafield.value) == null ? void 0 : _i.toString());
   }
   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`);
@@ -2563,6 +2566,9 @@ fragment ImageFragment on Image {
     };
   }
   function parseMetafieldValue(metafield) {
+    {
+      console.info(`'parseMetafieldValue()' will be removed in a future version`);
+    }
     if (!metafield) {
       return null;
     }
@@ -2690,6 +2696,113 @@ fragment ImageFragment on Image {
         throw new Error(`Unit not supported: ${unit}`);
     }
   }
+  var dist = {};
+  Object.defineProperty(dist, "__esModule", { value: true });
+  dist.expectNever = expectType_1 = dist.expectType = void 0;
+  const expectType = (value) => void 0;
+  var expectType_1 = dist.expectType = expectType;
+  const expectNever = (value) => {
+    throw new TypeError("Unexpected value: " + value);
+  };
+  dist.expectNever = expectNever;
+  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);
   function useMoney(money) {
     const {
       locale
@@ -3167,6 +3280,7 @@ fragment ImageFragment on Image {
   exports2.Video = Video;
   exports2.createStorefrontClient = createStorefrontClient;
   exports2.flattenConnection = flattenConnection;
+  exports2.metafieldParser = metafieldParser;
   exports2.parseMetafield = parseMetafield;
   exports2.parseMetafieldValue = parseMetafieldValue;
   exports2.useCart = useCart;