@reactionary/feeds 0.10.54 → 0.10.56

package/cli.cjs

@@ -37222,6 +37222,9 @@ var init_product_model = __esm({
       weee_symbol: boolean2().default(false).meta({ description: "Indicates whether the WEEE symbol can be shown on the product" }),
       energy_class: string2().optional().meta({ description: "The energy class of the product, as required by EU regulations. A,B,C,D,E,F,G, etc" }),
       garan_duration: number2().optional().meta({ description: "The duration of the guarantee in months as by the EU Garan scheme. Only set if above 24." }),
+      energy_class_range: string2().optional().meta({ description: 'The scale the energy class belongs to, e.g. "A-G", "A++-G" or "A+++-D". Needed to render the EU class arrow, because the same class letter is drawn differently on different scales.' }),
+      eprel_registration_number: string2().optional().meta({ description: "The EPREL registration number of the product model (digits only, up to 19). Together with eprel_product_group it identifies the official EU energy label and class arrow." }),
+      eprel_product_group: string2().optional().meta({ description: 'The EPREL product group URL code the model is registered under, e.g. "spaceheaters" or "localspaceheaters".' }),
       safety_warnings: string2().optional().meta({ description: "Any safety warnings associated with the product as required by EU regulations." }),
       composition: string2().optional().meta({ description: "The composition of the product as required by EU regulations." }),
       additional_disclosures: string2().optional().meta({ description: "Any additional disclosures associated with the product as required by EU regulations." }),
@@ -37314,6 +37317,9 @@ var init_product_search_model = __esm({
       weee_symbol: boolean2().default(false).meta({ description: "Indicates whether the WEEE symbol can be shown on the product" }),
       energy_class: string2().optional().meta({ description: "The energy class of the product, as required by EU regulations. A,B,C,D,E,F,G, etc" }),
       garan_duration: number2().optional().meta({ description: "The duration of the guarantee in months as by the EU Garan scheme. Only set if above 24." }),
+      energy_class_range: string2().optional().meta({ description: 'The scale the energy class belongs to, e.g. "A-G", "A++-G" or "A+++-D". Needed to render the EU class arrow, because the same class letter is drawn differently on different scales.' }),
+      eprel_registration_number: string2().optional().meta({ description: "The EPREL registration number of the product model (digits only, up to 19). Together with eprel_product_group it identifies the official EU energy label and class arrow." }),
+      eprel_product_group: string2().optional().meta({ description: 'The EPREL product group URL code the model is registered under, e.g. "spaceheaters" or "localspaceheaters".' }),
       is_organic: boolean2().optional().meta({ description: "Indicates whether the product is organic" }),
       organic_certification_type: string2().optional().meta({ description: "The type of organic certification, e.g., EU_ORGANIC_LEAF, GOTS, ECOCERT." })
     });
@@ -37422,7 +37428,7 @@ var init_profile_model = __esm({
 });
 
 // packages/core/src/schemas/models/shipping-method.model.ts
-var ShippingFulfillmentTypeSchema, ShippingProtocolDataSchema, PickupPointSchema, ShippingMethodSchema, ShippingInstructionSchema;
+var ShippingFulfillmentTypeSchema, ShippingProtocolDataSchema, SHIPPING_PROTOCOL_DATA_KEYS, PickupPointSchema, ShippingMethodSchema, ShippingInstructionSchema;
 var init_shipping_method_model = __esm({
   "packages/core/src/schemas/models/shipping-method.model.ts"() {
     "use strict";
@@ -37436,6 +37442,13 @@ var init_shipping_method_model = __esm({
       key: string2().meta({ description: 'The protocol-specific key, e.g. "timeSlotId".' }),
       value: union([string2(), record(string2(), json())]).meta({ description: "The protocol-specific value: either a plain string, or a JSON-serializable object for richer structures." })
     });
+    SHIPPING_PROTOCOL_DATA_KEYS = {
+      /**
+       * The identifier (Store.identifier.key) of the brand's own store an
+       * in-store pickup (BOPIS) shipping method is fulfilled from.
+       */
+      pickupStore: "pickup_store"
+    };
     PickupPointSchema = looseObject({
       identifier: object({
         key: string2()
@@ -37457,7 +37470,7 @@ var init_shipping_method_model = __esm({
       deliveryTime: string2(),
       carrier: string2().optional(),
       fulfillmentType: ShippingFulfillmentTypeSchema.optional().meta({ description: `How this shipping method fulfills the order: "delivery" for shipment to an address (including third-party carrier service points selected via the shipping instruction's pickupPoint), "pickup" for collection at one of the brand's own stores (BOPIS). When absent, "delivery" can be assumed.` }),
-      protocolData: array(ShippingProtocolDataSchema).optional().meta({ description: "Additional provider-populated, protocol-specific data for this shipping method, e.g. available pickup time slots." })
+      protocolData: array(ShippingProtocolDataSchema).optional().meta({ description: `Additional provider-populated, protocol-specific data for this shipping method, e.g. available pickup time slots. Conventional keys (see SHIPPING_PROTOCOL_DATA_KEYS) include "pickup_store": the identifier of the brand's own store a pickup method is fulfilled from.` })
     });
     ShippingInstructionSchema = BaseModelSchema.extend({
       shippingMethod: ShippingMethodIdentifierSchema,
@@ -159542,17 +159555,17 @@ var init_checkout_capability5 = __esm({
        *
        * example: this.includedFields = [includedFields, '+discounts.*'].join(',');
        */
-      includedFields = ["+items.*", "+order.id", "+order.display_id", "+order.custom_display_id"].join(",");
+      includedFields = ["+items.*", "+order.id", "+order.display_id", "+order.custom_display_id", "+shipping_methods.data"].join(",");
       /**
        * This controls which fields are requested for the cart's shipping options.
        * You can override this in a subclass to add more fields as needed.
        *
        * The service zone's fulfillment set tells us whether an option is in-store
-       * pickup (BOPIS) or a delivery, and the option metadata lets medusa-side
-       * providers push additional data that is mapped to the shipping method's
-       * protocolData.
+       * pickup (BOPIS) or a delivery, and the option data is the fulfillment
+       * provider's payload (e.g. nShift option/carrier ids) that is mapped to the
+       * shipping method's protocolData.
        */
-      shippingOptionFields = ["*service_zone.fulfillment_set", "+metadata"].join(",");
+      shippingOptionFields = ["*service_zone.fulfillment_set", "+data"].join(",");
       initiateCheckoutForCartPayload(payload) {
         return {
           billing_address: payload.billingAddress ? this.mapAddressToStoreAddress(payload.billingAddress) : void 0,
@@ -159757,12 +159770,19 @@ var init_checkout_capability5 = __esm({
         throw new Error("Method not implemented.");
       }
       setShippingInstructionPayload(payload) {
+        const data = {
+          consent_for_unattended_delivery: payload.shippingInstruction.consentForUnattendedDelivery + "",
+          instructions: payload.shippingInstruction.instructions || ""
+        };
+        for (const entry of payload.shippingInstruction.protocolData ?? []) {
+          data[entry.key] = entry.value;
+        }
+        if (payload.shippingInstruction.pickupPoint) {
+          data["pickup_point"] = payload.shippingInstruction.pickupPoint;
+        }
         return {
           option_id: payload.shippingInstruction.shippingMethod.key,
-          data: {
-            consent_for_unattended_delivery: payload.shippingInstruction.consentForUnattendedDelivery + "",
-            instructions: payload.shippingInstruction.instructions || ""
-          }
+          data
         };
       }
       /**
@@ -161428,6 +161448,18 @@ var init_product_search_capability6 = __esm({
 });
 
 // packages/medusa/src/utils/product-compliance.ts
+function parseEnergyClassRange(value) {
+  const text2 = safeStringConvert(value)?.trim();
+  return text2 && /^[A-Za-z0-9+\-–_ ]{1,20}$/.test(text2) ? text2 : void 0;
+}
+function parseEprelRegistrationNumber(value) {
+  const text2 = safeStringConvert(value)?.trim();
+  return text2 && /^\d{1,19}$/.test(text2) ? text2 : void 0;
+}
+function parseEprelProductGroup(value) {
+  const text2 = safeStringConvert(value)?.trim().toLowerCase();
+  return text2 && /^[a-z0-9]{1,64}$/.test(text2) ? text2 : void 0;
+}
 function parseProductSearchComplianceData(product) {
   if (!product.metadata) {
     return ProductSearchResultItemComplianceDataSchema.parse({});
@@ -161438,7 +161470,10 @@ function parseProductSearchComplianceData(product) {
     ce_marking: safeBoolConvert(metadata["compliance_data_ce_marking"]),
     weee_symbol: safeBoolConvert(metadata["compliance_data_weee_symbol"]),
     energy_class: safeStringConvert(metadata["compliance_data_energy_class"]),
+    energy_class_range: parseEnergyClassRange(metadata["compliance_data_energy_class_range"]),
     garan_duration: duration3 === void 0 || !Number.isFinite(Number(duration3)) ? void 0 : Number(duration3),
+    eprel_registration_number: parseEprelRegistrationNumber(metadata["compliance_data_eprel_registration_number"]),
+    eprel_product_group: parseEprelProductGroup(metadata["compliance_data_eprel_product_group"]),
     is_organic: safeBoolConvert(metadata["compliance_data_organic_is_organic"]),
     organic_certification_type: safeStringConvert(metadata["compliance_data_organic_certification_type"])
   });
@@ -162658,7 +162693,7 @@ var init_checkout_factory5 = __esm({
             instructions = sm.data["instructions"] != null ? String(sm.data["instructions"]) : "";
             consentForUnattendedDelivery = sm.data["consent_for_unattended_delivery"] === "true";
             pickupStore = sm.data["pickup_store"] != null && sm.data["pickup_store"] !== "" ? String(sm.data["pickup_store"]) : void 0;
-            protocolData = this.parseShippingProtocolData(sm.data["shipping_protocol_data"]);
+            protocolData = this.parseInstructionProtocolData(sm.data);
           }
           if (!pickupPoint) {
             pickupPoint = backupPickupPoint || "";
@@ -162746,11 +162781,46 @@ var init_checkout_factory5 = __esm({
             currency: data.calculated_price.currency_code?.toUpperCase() || _context.languageContext.currencyCode
           }),
           deliveryTime: "",
+          carrier: this.parseShippingMethodCarrier(_context, data),
           fulfillmentType: this.parseFulfillmentType(_context, data),
-          protocolData: this.parseShippingMethodProtocolData(_context, data)
+          protocolData: this.mergeShippingMethodProtocolData(
+            this.parseShippingMethodProtocolData(_context, data),
+            this.parseShippingMethodStoreReference(_context, data)
+          )
         };
         return this.shippingMethodSchema.parse(sm);
       }
+      /**
+       * Appends a conventional entry to the provider-derived protocol data,
+       * unless the provider data already carries the same key (explicit provider
+       * data wins).
+       */
+      mergeShippingMethodProtocolData(protocolData, entry) {
+        if (!entry) {
+          return protocolData;
+        }
+        if ((protocolData ?? []).some((existing) => existing.key === entry.key)) {
+          return protocolData;
+        }
+        return [...protocolData ?? [], entry];
+      }
+      /**
+       * Extension point emitting the conventional "pickup_store" protocol data
+       * entry for in-store pickup options: the stock location id of the service
+       * zone's fulfillment set, which equals the store capability's
+       * Store.identifier.key. Delivery options also carry a location (the
+       * warehouse), so the entry is emitted for pickup options only.
+       */
+      parseShippingMethodStoreReference(_context, data) {
+        if (this.parseFulfillmentType(_context, data) !== "pickup") {
+          return void 0;
+        }
+        const locationId = data.service_zone?.fulfillment_set?.location?.id;
+        if (!locationId) {
+          return void 0;
+        }
+        return { key: SHIPPING_PROTOCOL_DATA_KEYS.pickupStore, value: locationId };
+      }
       /**
        * Extension point to control how a Medusa shipping option maps to the core
        * fulfillment type. A shipping option belonging to a fulfillment set of type
@@ -162760,18 +162830,33 @@ var init_checkout_factory5 = __esm({
         return data.service_zone?.fulfillment_set?.type === "pickup" ? "pickup" : "delivery";
       }
       /**
-       * Extension point mapping a Medusa shipping option's metadata to the
-       * shipping method's protocolData, so medusa-side providers can push
-       * additional data (e.g. available pickup time slots) that reaches the
-       * client. String and JSON-object values are kept as-is, other primitives
-       * are stringified, and arrays/null entries are skipped.
+       * Extension point mapping a Medusa shipping option's `data` - the payload
+       * the fulfillment provider works with (e.g. nShift's option/carrier ids) -
+       * to the shipping method's protocolData, so provider-protocol data reaches
+       * the client. String and JSON-object values are kept as-is, other
+       * primitives are stringified, and arrays/null entries are skipped.
+       *
+       * Option `metadata` is deliberately NOT mapped: it is merchant free-form
+       * annotation, not protocol data. Override this hook to surface it.
        */
       parseShippingMethodProtocolData(_context, data) {
-        if (!data.metadata) {
+        if (!data.data) {
           return void 0;
         }
+        const entries = this.convertToProtocolDataEntries(data.data);
+        return entries.length > 0 ? entries : void 0;
+      }
+      /**
+       * Converts a Medusa key-value record into protocol data entries: string and
+       * JSON-object values are kept as-is, other primitives are stringified, and
+       * arrays/null entries are skipped. Keys listed in skipKeys are left out.
+       */
+      convertToProtocolDataEntries(record2, skipKeys = []) {
         const entries = [];
-        for (const [key, value] of Object.entries(data.metadata)) {
+        for (const [key, value] of Object.entries(record2)) {
+          if (skipKeys.includes(key)) {
+            continue;
+          }
           if (typeof value === "string") {
             entries.push({ key, value });
           } else if (typeof value === "number" || typeof value === "boolean") {
@@ -162780,6 +162865,49 @@ var init_checkout_factory5 = __esm({
             entries.push({ key, value });
           }
         }
+        return entries;
+      }
+      /**
+       * Extension point resolving the carrier of a shipping option from its
+       * provider data (e.g. nShift's carrier_id), when present.
+       */
+      parseShippingMethodCarrier(_context, data) {
+        const carrierId = data.data?.["carrier_id"];
+        return typeof carrierId === "string" && carrierId.length > 0 ? carrierId : void 0;
+      }
+      /**
+       * The persisted shipping method data keys that are NOT surfaced as
+       * instruction protocol data: keys already represented as first-class
+       * instruction fields, the legacy JSON blob, and provider-side values that
+       * would mislead (nShift's data.price is not the charged amount).
+       */
+      instructionProtocolDataSkipKeys = [
+        "pickup_store",
+        "pickup_point",
+        "instructions",
+        "consent_for_unattended_delivery",
+        "shipping_protocol_data",
+        "price",
+        "currency_code"
+      ];
+      /**
+       * Builds the shipping instruction's protocolData from the persisted
+       * shipping method data: the provider payload enriched by the backend (e.g.
+       * nShift's session_id, carrier ids and optional delivery_time) merged with
+       * whatever the client sent when setting the instruction. First-class and
+       * misleading keys are skipped; the legacy shipping_protocol_data JSON blob
+       * still contributes entries whose keys are not already present.
+       */
+      parseInstructionProtocolData(smData) {
+        const entries = this.convertToProtocolDataEntries(
+          smData,
+          this.instructionProtocolDataSkipKeys
+        );
+        for (const legacyEntry of this.parseShippingProtocolData(smData["shipping_protocol_data"]) ?? []) {
+          if (!entries.some((entry) => entry.key === legacyEntry.key)) {
+            entries.push(legacyEntry);
+          }
+        }
         return entries.length > 0 ? entries : void 0;
       }
       /**
@@ -163528,7 +163656,10 @@ var init_product_factory5 = __esm({
           ce_marking: shared.ce_marking,
           weee_symbol: shared.weee_symbol,
           energy_class: shared.energy_class,
+          energy_class_range: shared.energy_class_range,
           garan_duration: shared.garan_duration,
+          eprel_registration_number: shared.eprel_registration_number,
+          eprel_product_group: shared.eprel_product_group,
           safety_warnings: safeStringConvert(body.metadata?.["compliance_data_safety_warnings"]),
           composition: safeStringConvert(body.metadata?.["compliance_data_composition"]),
           additional_disclosures: safeStringConvert(body.metadata?.["compliance_data_additional_disclosures"]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactionary/feeds",
-  "version": "0.10.54",
+  "version": "0.10.56",
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts",
@@ -12,14 +12,14 @@
     "url": "git+https://github.com/Solteq/reactionary.git"
   },
   "dependencies": {
-    "@reactionary/algolia": "0.10.54",
-    "@reactionary/commercetools": "0.10.54",
-    "@reactionary/core": "0.10.54",
-    "@reactionary/fake": "0.10.54",
-    "@reactionary/magento": "0.10.54",
-    "@reactionary/medusa": "0.10.54",
-    "@reactionary/meilisearch": "0.10.54",
-    "@reactionary/unomi": "0.10.54",
+    "@reactionary/algolia": "0.10.56",
+    "@reactionary/commercetools": "0.10.56",
+    "@reactionary/core": "0.10.56",
+    "@reactionary/fake": "0.10.56",
+    "@reactionary/magento": "0.10.56",
+    "@reactionary/medusa": "0.10.56",
+    "@reactionary/meilisearch": "0.10.56",
+    "@reactionary/unomi": "0.10.56",
     "commander": "^15.0.0",
     "dotenv": "^17.2.2",
     "sitemap": "^9.0.1",