@merchi/cart 1.4.4

package/lib/utilities/address.js

@@ -0,0 +1,468 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.addressComponentsSettingsBackend = exports.addressComponentsSettings = void 0;
+exports.addressInOneLine = addressInOneLine;
+exports.geoSuggestResultAsNewAddress = geoSuggestResultAsNewAddress;
+exports.googlePlacesResultAsNewAddress = googlePlacesResultAsNewAddress;
+exports.makeAddress = makeAddress;
+exports.sanitizeAddressFields = sanitizeAddressFields;
+var _sdk = require("@merchi/sdk");
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var merchi = new _sdk.Merchi();
+function makeAddress(addressJson, makeDirty) {
+  var address = new merchi.Address();
+  return address.fromJson(addressJson, {
+    makeDirty: makeDirty
+  });
+}
+
+/** Plain address fields only — never reuse an existing address id (cart-token auth cannot PATCH it). */
+function sanitizeAddressFields(address) {
+  var a = address && _typeof(address) === 'object' ? address : {};
+  return {
+    city: a.city || '',
+    country: a.country || '',
+    lineOne: a.lineOne || '',
+    lineTwo: a.lineTwo || '',
+    postcode: a.postcode || '',
+    state: a.state || ''
+  };
+}
+var isoCountries = {
+  AF: "Afghanistan",
+  AX: "Aland Islands",
+  AL: "Albania",
+  DZ: "Algeria",
+  AS: "American Samoa",
+  AD: "Andorra",
+  AO: "Angola",
+  AI: "Anguilla",
+  AQ: "Antarctica",
+  AG: "Antigua And Barbuda",
+  AR: "Argentina",
+  AM: "Armenia",
+  AW: "Aruba",
+  AU: "Australia",
+  AT: "Austria",
+  AZ: "Azerbaijan",
+  BS: "Bahamas",
+  BH: "Bahrain",
+  BD: "Bangladesh",
+  BB: "Barbados",
+  BY: "Belarus",
+  BE: "Belgium",
+  BZ: "Belize",
+  BJ: "Benin",
+  BM: "Bermuda",
+  BT: "Bhutan",
+  BO: "Bolivia",
+  BA: "Bosnia And Herzegovina",
+  BW: "Botswana",
+  BV: "Bouvet Island",
+  BR: "Brazil",
+  IO: "British Indian Ocean Territory",
+  BN: "Brunei Darussalam",
+  BG: "Bulgaria",
+  BF: "Burkina Faso",
+  BI: "Burundi",
+  KH: "Cambodia",
+  CM: "Cameroon",
+  CA: "Canada",
+  CV: "Cape Verde",
+  KY: "Cayman Islands",
+  CF: "Central African Republic",
+  TD: "Chad",
+  CL: "Chile",
+  CN: "China",
+  CX: "Christmas Island",
+  CC: "Cocos (Keeling) Islands",
+  CO: "Colombia",
+  KM: "Comoros",
+  CG: "Congo",
+  CD: "Congo, Democratic Republic",
+  CK: "Cook Islands",
+  CR: "Costa Rica",
+  CI: "Cote D'Ivoire",
+  HR: "Croatia",
+  CU: "Cuba",
+  CY: "Cyprus",
+  CZ: "Czech Republic",
+  DK: "Denmark",
+  DJ: "Djibouti",
+  DM: "Dominica",
+  DO: "Dominican Republic",
+  EC: "Ecuador",
+  EG: "Egypt",
+  SV: "El Salvador",
+  GQ: "Equatorial Guinea",
+  ER: "Eritrea",
+  EE: "Estonia",
+  ET: "Ethiopia",
+  FK: "Falkland Islands (Malvinas)",
+  FO: "Faroe Islands",
+  FJ: "Fiji",
+  FI: "Finland",
+  FR: "France",
+  GF: "French Guiana",
+  PF: "French Polynesia",
+  TF: "French Southern Territories",
+  GA: "Gabon",
+  GM: "Gambia",
+  GE: "Georgia",
+  DE: "Germany",
+  GH: "Ghana",
+  GI: "Gibraltar",
+  GR: "Greece",
+  GL: "Greenland",
+  GD: "Grenada",
+  GP: "Guadeloupe",
+  GU: "Guam",
+  GT: "Guatemala",
+  GG: "Guernsey",
+  GN: "Guinea",
+  GW: "Guinea-Bissau",
+  GY: "Guyana",
+  HT: "Haiti",
+  HM: "Heard Island & Mcdonald Islands",
+  VA: "Holy See (Vatican City State)",
+  HN: "Honduras",
+  HK: "Hong Kong",
+  HU: "Hungary",
+  IS: "Iceland",
+  IN: "India",
+  ID: "Indonesia",
+  IR: "Iran, Islamic Republic Of",
+  IQ: "Iraq",
+  IE: "Ireland",
+  IM: "Isle Of Man",
+  IL: "Israel",
+  IT: "Italy",
+  JM: "Jamaica",
+  JP: "Japan",
+  JE: "Jersey",
+  JO: "Jordan",
+  KZ: "Kazakhstan",
+  KE: "Kenya",
+  KI: "Kiribati",
+  KR: "Korea",
+  KW: "Kuwait",
+  KG: "Kyrgyzstan",
+  LA: "Lao People's Democratic Republic",
+  LV: "Latvia",
+  LB: "Lebanon",
+  LS: "Lesotho",
+  LR: "Liberia",
+  LY: "Libyan Arab Jamahiriya",
+  LI: "Liechtenstein",
+  LT: "Lithuania",
+  LU: "Luxembourg",
+  MO: "Macao",
+  MK: "Macedonia",
+  MG: "Madagascar",
+  MW: "Malawi",
+  MY: "Malaysia",
+  MV: "Maldives",
+  ML: "Mali",
+  MT: "Malta",
+  MH: "Marshall Islands",
+  MQ: "Martinique",
+  MR: "Mauritania",
+  MU: "Mauritius",
+  YT: "Mayotte",
+  MX: "Mexico",
+  FM: "Micronesia, Federated States Of",
+  MD: "Moldova",
+  MC: "Monaco",
+  MN: "Mongolia",
+  ME: "Montenegro",
+  MS: "Montserrat",
+  MA: "Morocco",
+  MZ: "Mozambique",
+  MM: "Myanmar",
+  NA: "Namibia",
+  NR: "Nauru",
+  NP: "Nepal",
+  NL: "Netherlands",
+  AN: "Netherlands Antilles",
+  NC: "New Caledonia",
+  NZ: "New Zealand",
+  NI: "Nicaragua",
+  NE: "Niger",
+  NG: "Nigeria",
+  NU: "Niue",
+  NF: "Norfolk Island",
+  MP: "Northern Mariana Islands",
+  NO: "Norway",
+  OM: "Oman",
+  PK: "Pakistan",
+  PW: "Palau",
+  PS: "Palestinian Territory, Occupied",
+  PA: "Panama",
+  PG: "Papua New Guinea",
+  PY: "Paraguay",
+  PE: "Peru",
+  PH: "Philippines",
+  PN: "Pitcairn",
+  PL: "Poland",
+  PT: "Portugal",
+  PR: "Puerto Rico",
+  QA: "Qatar",
+  RE: "Reunion",
+  RO: "Romania",
+  RU: "Russian Federation",
+  RW: "Rwanda",
+  BL: "Saint Barthelemy",
+  SH: "Saint Helena",
+  KN: "Saint Kitts And Nevis",
+  LC: "Saint Lucia",
+  MF: "Saint Martin",
+  PM: "Saint Pierre And Miquelon",
+  VC: "Saint Vincent And Grenadines",
+  WS: "Samoa",
+  SM: "San Marino",
+  ST: "Sao Tome And Principe",
+  SA: "Saudi Arabia",
+  SN: "Senegal",
+  RS: "Serbia",
+  SC: "Seychelles",
+  SL: "Sierra Leone",
+  SG: "Singapore",
+  SK: "Slovakia",
+  SI: "Slovenia",
+  SB: "Solomon Islands",
+  SO: "Somalia",
+  ZA: "South Africa",
+  GS: "South Georgia And Sandwich Isl.",
+  ES: "Spain",
+  LK: "Sri Lanka",
+  SD: "Sudan",
+  SR: "Suriname",
+  SJ: "Svalbard And Jan Mayen",
+  SZ: "Swaziland",
+  SE: "Sweden",
+  CH: "Switzerland",
+  SY: "Syrian Arab Republic",
+  TW: "Taiwan",
+  TJ: "Tajikistan",
+  TZ: "Tanzania",
+  TH: "Thailand",
+  TL: "Timor-Leste",
+  TG: "Togo",
+  TK: "Tokelau",
+  TO: "Tonga",
+  TT: "Trinidad And Tobago",
+  TN: "Tunisia",
+  TR: "Turkey",
+  TM: "Turkmenistan",
+  TC: "Turks And Caicos Islands",
+  TV: "Tuvalu",
+  UG: "Uganda",
+  UA: "Ukraine",
+  AE: "United Arab Emirates",
+  GB: "United Kingdom",
+  US: "United States",
+  UM: "United States Outlying Islands",
+  UY: "Uruguay",
+  UZ: "Uzbekistan",
+  VU: "Vanuatu",
+  VE: "Venezuela",
+  VN: "Viet Nam",
+  VG: "Virgin Islands, British",
+  VI: "Virgin Islands, U.S.",
+  WF: "Wallis And Futuna",
+  EH: "Western Sahara",
+  YE: "Yemen",
+  ZM: "Zambia",
+  ZW: "Zimbabwe"
+};
+function addressInOneLine(address) {
+  var a = address ? address : {};
+  var city = a.city,
+    country = a.country,
+    lineOne = a.lineOne,
+    lineTwo = a.lineTwo,
+    postcode = a.postcode,
+    state = a.state;
+  var l1 = lineOne ? "".concat(lineOne, " ") : '';
+  var l2 = lineTwo ? "".concat(lineTwo, " ") : '';
+  var c = city ? "".concat(city, " ") : '';
+  var s = state ? "".concat(state, " ") : '';
+  var p = postcode ? "".concat(postcode, " ") : '';
+  var countryFull = country ? isoCountries[country] : '';
+  return l1 + l2 + c + s + p + countryFull;
+}
+var addressComponentsSettings = exports.addressComponentsSettings = {
+  administrative_area_level_1: 'short_name',
+  administrative_area_level_2: 'short_name',
+  country: 'short_name',
+  establishment: 'long_name',
+  floor: 'short_name',
+  locality: 'long_name',
+  postal_code: 'short_name',
+  premise: 'short_name',
+  room: 'long_name',
+  route: 'short_name',
+  street_number: 'short_name',
+  sublocality: 'long_name',
+  subpremise: 'short_name'
+};
+var addressComponentsSettingsBackend = exports.addressComponentsSettingsBackend = {
+  administrative_area_level_1: 'shortName',
+  administrative_area_level_2: 'shortName',
+  country: 'shortName',
+  establishment: 'longName',
+  floor: 'shortName',
+  locality: 'longName',
+  postal_code: 'shortName',
+  premise: 'shortName',
+  room: 'longName',
+  route: 'shortName',
+  street_number: 'shortName',
+  sublocality: 'longName',
+  subpremise: 'shortName'
+};
+function googlePlacesResultAsNewAddress(placeDetails) {
+  var addressComponents = (placeDetails === null || placeDetails === void 0 ? void 0 : placeDetails.addressComponents) || [];
+  var name = (placeDetails === null || placeDetails === void 0 ? void 0 : placeDetails.name) || '';
+  var address = {
+    city: '',
+    country: '',
+    lineOne: name ? name : '',
+    lineTwo: '',
+    postcode: '',
+    state: ''
+  };
+  if (addressComponents && addressComponents.length > 0) {
+    for (var i = 0; i < addressComponents.length; i++) {
+      var addrComponent = addressComponents[i];
+      var addrTypes = addrComponent.types;
+      var addrType = null;
+      var componentSetting = null;
+      var _iterator = _createForOfIteratorHelper(addrTypes),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var type = _step.value;
+          if (addressComponentsSettingsBackend[type]) {
+            addrType = type;
+            componentSetting = addressComponentsSettingsBackend[type];
+            break;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      if (componentSetting && addrType) {
+        var addressVal = addrComponent[componentSetting];
+        switch (addrType) {
+          case 'establishment':
+          case 'room':
+          case 'floor':
+          case 'street_number':
+          case 'premise':
+          case 'subpremise':
+          case 'route':
+            {
+              var oldLineOne = address.lineOne;
+              address.lineOne = oldLineOne.includes(addressVal) ? oldLineOne : "".concat(oldLineOne, " ").concat(addressVal).trim();
+            }
+            break;
+          case 'locality':
+          case 'sublocality':
+            {
+              var oldCity = address.city ? "".concat(address.city, " ") : '';
+              address.city = (oldCity + addressVal).trim();
+            }
+            break;
+          case 'administrative_area_level_1':
+            address.state = addressVal;
+            break;
+          case 'administrative_area_level_2':
+            break;
+          case 'country':
+            address.country = addressVal;
+            break;
+          case 'postal_code':
+            address.postcode = addressVal;
+            break;
+          default:
+            break;
+        }
+      }
+    }
+    if (!address.lineOne.trim() && placeDetails !== null && placeDetails !== void 0 && placeDetails.formattedAddress) {
+      var parts = placeDetails.formattedAddress.split(',');
+      if (parts.length > 0) {
+        address.lineOne = parts[0].trim();
+      }
+    }
+    return address;
+  }
+  return null;
+}
+
+/** @deprecated Legacy react-geosuggest parser; use googlePlacesResultAsNewAddress instead. */
+function geoSuggestResultAsNewAddress(resp) {
+  var addressComponents = resp && resp.gmaps ? resp.gmaps.address_components : null;
+  var name = resp && resp.gmaps && resp.gmaps.name;
+  var address = {
+    city: '',
+    country: '',
+    lineOne: name ? name : '',
+    lineTwo: '',
+    postcode: '',
+    state: ''
+  };
+  var i;
+  if (addressComponents) {
+    for (i = 0; i < addressComponents.length; i++) {
+      var addrComponent = addressComponents[i];
+      var addrTypes = addrComponent.types;
+      var addrType = addrTypes.length > 0 ? addrTypes[0] : null;
+      var componentSetting = addrType ? addressComponentsSettings[addrType] : null;
+      if (componentSetting) {
+        var addressVal = addrComponent[componentSetting];
+        switch (addrType) {
+          case 'establishment':
+          case 'room':
+          case 'floor':
+          case 'street_number':
+          case 'premise':
+          case 'subpremise':
+          case 'route':
+            var oldLineOne = address.lineOne;
+            address.lineOne = oldLineOne.includes(addressVal) ? oldLineOne : "".concat(oldLineOne, " ").concat(addressVal);
+            break;
+          case 'locality':
+          case 'sublocality':
+            var oldCity = address.city ? "".concat(address.city, " ") : '';
+            address.city = oldCity + addressVal;
+            break;
+          case 'administrative_area_level_1':
+            address.state = addressVal;
+            break;
+          case 'administrative_area_level_2':
+            break;
+          case 'country':
+            address.country = addressVal;
+            break;
+          case 'postal_code':
+            address.postcode = addressVal;
+            break;
+          default:
+            break;
+        }
+      }
+    }
+    return address;
+  }
+  return null;
+}

package/lib/utilities/area.d.ts

@@ -0,0 +1,77 @@
+/** Shared helpers for Area (height × width) variation fields. Stored value is always millimetres. */
+export type AreaUnit = 'mm' | 'cm' | 'm' | 'in' | 'ft';
+export type AreaInputType = 'input' | 'slider';
+export type DisplayModality = 'metric' | 'imperial';
+export declare function parseAreaValue(value: string | null | undefined): {
+    heightMm: number;
+    widthMm: number;
+} | null;
+export declare function formatAreaValue(heightMm: number, widthMm: number): string;
+export declare function isImperialUnit(unit: AreaUnit | string | null | undefined): boolean;
+export declare function normaliseAreaUnit(unit?: string | null): AreaUnit;
+/** Imperial for en-US / en-LR / en-MM; otherwise metric (incl. en-GB). */
+export declare function localePrefersImperial(locale?: string): boolean;
+/** Millimetres per one unit of the given area unit. */
+export declare function unitFactorMm(unit?: AreaUnit | string): number;
+/** @deprecated use unitFactorMm */
+export declare function metricUnitFactor(unit?: AreaUnit): number;
+export declare function mmToUnit(mm: number, unit?: AreaUnit | string): number;
+export declare function unitToMm(value: number, unit?: AreaUnit | string): number;
+/** @deprecated use mmToUnit */
+export declare function mmToMetricDisplay(mm: number, unit?: AreaUnit): number;
+/** @deprecated use unitToMm */
+export declare function metricDisplayToMm(value: number, unit?: AreaUnit): number;
+export declare function mmToInches(mm: number): number;
+export declare function inchesToMm(inches: number): number;
+/**
+ * Unit shown for the current buyer modality.
+ * Metric → field unit if metric, else mm.
+ * Imperial → field unit if imperial, else inches.
+ */
+export declare function activeDisplayUnit(modality: DisplayModality, areaUnit?: AreaUnit | string): AreaUnit;
+export declare function defaultModalityForAreaUnit(areaUnit?: AreaUnit | string): DisplayModality;
+export declare function mmToDisplay(mm: number, modality: DisplayModality, areaUnit?: AreaUnit | string): number;
+export declare function displayToMm(value: number, modality: DisplayModality, areaUnit?: AreaUnit | string): number;
+export declare function unitLabel(modality: DisplayModality, areaUnit?: AreaUnit | string): string;
+export declare function defaultAreaStep(unit?: AreaUnit | string): number;
+/**
+ * Step for inputs/sliders in the current display unit.
+ * `stepMm` is the admin-configured step stored in millimetres.
+ */
+export declare function stepInDisplayUnit(stepMm: number | null | undefined, modality: DisplayModality, areaUnit?: AreaUnit | string): number;
+/** Format a length in mm for buyer-facing summary. */
+export declare function formatLengthFromMm(mm: number, modality: DisplayModality, areaUnit?: AreaUnit | string): string;
+export declare function formatAreaParts(value: string | null | undefined, modality?: DisplayModality, areaUnit?: AreaUnit | string): {
+    width: string;
+    height: string;
+    areaLabel: string;
+} | null;
+export declare function formatAreaSummary(value: string | null | undefined, modality?: DisplayModality, areaUnit?: AreaUnit | string): string | null;
+export declare function clamp(n: number, min?: number | null, max?: number | null): number;
+/**
+ * Client-side Area cost estimate (pre-discount), matching API formula:
+ * onceOff = heightCost × widthCost × height_u × width_u
+ * unitCost = heightUnit × widthUnit × height_u × width_u
+ * (dimensions expressed in the field's areaUnit)
+ */
+export declare function estimateAreaCosts(variationField: any, value: string | null | undefined): {
+    onceOffCost: number;
+    unitCost: number;
+} | null;
+/**
+ * Keep width/height linked by aspectRatio (width/height).
+ * `changed` indicates which dimension the user edited.
+ */
+export declare function clampWithAspectRatio(args: {
+    heightMm: number;
+    widthMm: number;
+    changed: 'height' | 'width';
+    aspectRatio: number;
+    heightMin?: number | null;
+    heightMax?: number | null;
+    widthMin?: number | null;
+    widthMax?: number | null;
+}): {
+    heightMm: number;
+    widthMm: number;
+};