@nuskin/shipping-address-form 1.5.1 → 1.7.0

package/dist/addressLookup/hooks/useSmartyUSLookup.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _smartyConfig = require("../utils/smartyConfig");
+var _useSmartyLookupBase = _interopRequireDefault(require("./useSmartyLookupBase"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const MIN_QUERY_LENGTH = 3;
+const CACHE_NAMESPACE = 'smarty-us-autocomplete';
+const CACHE_TTL_MS = 60 * 1000;
+const RATE_LIMIT_NAMESPACE = 'smarty-us-autocomplete';
+const RATE_LIMIT_CONFIG = {
+  limit: 15,
+  windowMs: 60 * 1000,
+  cooldownMs: 30 * 1000
+};
+const RATE_LIMIT_MESSAGE = 'Too many requests. Please wait a moment and try again.';
+const buildCacheKey = (trimmedQuery, selectedAddress) => JSON.stringify({
+  query: trimmedQuery,
+  selected: selectedAddress ? {
+    streetLine: selectedAddress.street_line,
+    secondary: selectedAddress.secondary,
+    entries: selectedAddress.entries,
+    city: selectedAddress.city,
+    region: selectedAddress.state,
+    postalCode: selectedAddress.zipcode
+  } : null
+});
+const buildLookupUrl = (trimmedQuery, selectedAddress) => {
+  let smartyUrl = 'https://us-autocomplete-pro.api.smarty.com/' + `lookup?key=${_smartyConfig.SMARTY_US_AUTOCOMPLETE_KEY}&search=${encodeURIComponent(trimmedQuery)}`;
+  if (selectedAddress) {
+    const selectedParam = `${selectedAddress.street_line} ` + `${selectedAddress.secondary} (${selectedAddress.entries}) ` + `${selectedAddress.city} ${selectedAddress.state} ${selectedAddress.zipcode}`;
+    smartyUrl += `&selected=${encodeURIComponent(selectedParam)}`;
+  }
+  return smartyUrl;
+};
+const transformSuggestions = (responseData = {}) => {
+  const results = responseData.suggestions || [];
+  return results.map(result => {
+    let whiteSpace = '';
+    let secondary = result.secondary || '';
+    if (secondary) {
+      if (result.entries > 1) {
+        secondary += ` (${result.entries} entries)`;
+      }
+      whiteSpace = ' ';
+    }
+    const displayText = `${result.street_line}${whiteSpace}${secondary} ${result.city}, ${result.state} ${result.zipcode}`;
+    return {
+      ...result,
+      displayText
+    };
+  });
+};
+const useSmartyUSLookup = (query, selectedAddress = null, debounceMs = 300) => {
+  const trimmedQuery = query.trim();
+  const isEnabled = Boolean(trimmedQuery && (selectedAddress || trimmedQuery.length >= MIN_QUERY_LENGTH));
+  const cacheKey = buildCacheKey(trimmedQuery, selectedAddress);
+  const requestUrl = isEnabled ? buildLookupUrl(trimmedQuery, selectedAddress) : '';
+  return (0, _useSmartyLookupBase.default)({
+    isEnabled,
+    debounceMs,
+    cacheNamespace: CACHE_NAMESPACE,
+    cacheTtlMs: CACHE_TTL_MS,
+    rateLimitNamespace: RATE_LIMIT_NAMESPACE,
+    rateLimitConfig: RATE_LIMIT_CONFIG,
+    cacheKey,
+    requestUrl,
+    transformResponse: transformSuggestions,
+    onError: err => {
+      console.error('Smarty US lookup failed:', err);
+    },
+    effectDeps: [query, selectedAddress]
+  });
+};
+var _default = exports.default = useSmartyUSLookup;
+//# sourceMappingURL=useSmartyUSLookup.js.map

package/dist/addressLookup/hooks/useSmartyUSLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSmartyUSLookup.js","names":["_smartyConfig","require","_useSmartyLookupBase","_interopRequireDefault","e","__esModule","default","MIN_QUERY_LENGTH","CACHE_NAMESPACE","CACHE_TTL_MS","RATE_LIMIT_NAMESPACE","RATE_LIMIT_CONFIG","limit","windowMs","cooldownMs","RATE_LIMIT_MESSAGE","buildCacheKey","trimmedQuery","selectedAddress","JSON","stringify","query","selected","streetLine","street_line","secondary","entries","city","region","state","postalCode","zipcode","buildLookupUrl","smartyUrl","SMARTY_US_AUTOCOMPLETE_KEY","encodeURIComponent","selectedParam","transformSuggestions","responseData","results","suggestions","map","result","whiteSpace","displayText","useSmartyUSLookup","debounceMs","trim","isEnabled","Boolean","length","cacheKey","requestUrl","useSmartyLookupBase","cacheNamespace","cacheTtlMs","rateLimitNamespace","rateLimitConfig","transformResponse","onError","err","console","error","effectDeps","_default","exports"],"sources":["../../../src/addressLookup/hooks/useSmartyUSLookup.jsx"],"sourcesContent":["import { SMARTY_US_AUTOCOMPLETE_KEY } from '../utils/smartyConfig';\nimport useSmartyLookupBase from './useSmartyLookupBase';\n\nconst MIN_QUERY_LENGTH = 3;\nconst CACHE_NAMESPACE = 'smarty-us-autocomplete';\nconst CACHE_TTL_MS = 60 * 1000;\nconst RATE_LIMIT_NAMESPACE = 'smarty-us-autocomplete';\nconst RATE_LIMIT_CONFIG = {\n  limit: 15,\n  windowMs: 60 * 1000,\n  cooldownMs: 30 * 1000\n};\nconst RATE_LIMIT_MESSAGE = 'Too many requests. Please wait a moment and try again.';\n\nconst buildCacheKey = (trimmedQuery, selectedAddress) => JSON.stringify({\n  query: trimmedQuery,\n  selected: selectedAddress ? {\n    streetLine: selectedAddress.street_line,\n    secondary: selectedAddress.secondary,\n    entries: selectedAddress.entries,\n    city: selectedAddress.city,\n    region: selectedAddress.state,\n    postalCode: selectedAddress.zipcode\n  } : null\n});\n\nconst buildLookupUrl = (trimmedQuery, selectedAddress) => {\n  let smartyUrl = 'https://us-autocomplete-pro.api.smarty.com/' +\n    `lookup?key=${SMARTY_US_AUTOCOMPLETE_KEY}&search=${encodeURIComponent(trimmedQuery)}`;\n\n  if (selectedAddress) {\n    const selectedParam = `${selectedAddress.street_line} ` +\n      `${selectedAddress.secondary} (${selectedAddress.entries}) ` +\n      `${selectedAddress.city} ${selectedAddress.state} ${selectedAddress.zipcode}`;\n    smartyUrl += `&selected=${encodeURIComponent(selectedParam)}`;\n  }\n\n  return smartyUrl;\n};\n\nconst transformSuggestions = (responseData = {}) => {\n  const results = responseData.suggestions || [];\n\n  return results.map((result) => {\n    let whiteSpace = '';\n    let secondary = result.secondary || '';\n\n    if (secondary) {\n      if (result.entries > 1) {\n        secondary += ` (${result.entries} entries)`;\n      }\n      whiteSpace = ' ';\n    }\n\n    const displayText = `${result.street_line}${whiteSpace}${secondary} ${result.city}, ${result.state} ${result.zipcode}`;\n\n    return {\n      ...result,\n      displayText\n    };\n  });\n};\n\nconst useSmartyUSLookup = (query, selectedAddress = null, debounceMs = 300) => {\n  const trimmedQuery = query.trim();\n  const isEnabled = Boolean(trimmedQuery && (selectedAddress || trimmedQuery.length >= MIN_QUERY_LENGTH));\n  const cacheKey = buildCacheKey(trimmedQuery, selectedAddress);\n  const requestUrl = isEnabled ? buildLookupUrl(trimmedQuery, selectedAddress) : '';\n\n  return useSmartyLookupBase({\n    isEnabled,\n    debounceMs,\n    cacheNamespace: CACHE_NAMESPACE,\n    cacheTtlMs: CACHE_TTL_MS,\n    rateLimitNamespace: RATE_LIMIT_NAMESPACE,\n    rateLimitConfig: RATE_LIMIT_CONFIG,\n    cacheKey,\n    requestUrl,\n    transformResponse: transformSuggestions,\n    onError: (err) => {\n      console.error('Smarty US lookup failed:', err);\n    },\n    effectDeps: [query, selectedAddress]\n  });\n};\n\nexport default useSmartyUSLookup;\n"],"mappings":"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","ignoreList":[]}

package/dist/addressLookup/hooks/useUSAddressValidation.js

@@ -0,0 +1,166 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _smartyConfig = require("../utils/smartyConfig");
+var _validators = require("../utils/validators");
+var _useAddressValidationBase = _interopRequireDefault(require("./useAddressValidationBase"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const VALID_DPV_CODES = new Set(['Y', 'S', 'D']);
+const CACHE_NAMESPACE = 'smarty-us-validation';
+const CACHE_TTL_MS = 60 * 1000;
+const RATE_LIMIT_NAMESPACE = 'smarty-us-validation';
+const RATE_LIMIT_CONFIG = {
+  limit: 5,
+  windowMs: 60 * 1000,
+  cooldownMs: 60 * 1000
+};
+const VALIDATION_URL = 'https://us-street.api.smarty.com/street-address';
+const parseDpvFootnotes = (footnotes = '') => {
+  const normalized = String(footnotes || '');
+  const result = new Set();
+  for (let index = 0; index < normalized.length; index += 2) {
+    const code = normalized.slice(index, index + 2);
+    if (code.length === 2) {
+      result.add(code);
+    }
+  }
+  return result;
+};
+const trimZipPlus4 = (value = '') => String(value).replace(/(\b\d{5})-\d{4}\b/g, '$1');
+const buildDisplayText = item => {
+  var _item$components, _item$components2, _item$components3;
+  const line1 = item.delivery_line_1;
+  const line2 = item.delivery_line_2;
+  const city = (_item$components = item.components) === null || _item$components === void 0 ? void 0 : _item$components.city_name;
+  const region = (_item$components2 = item.components) === null || _item$components2 === void 0 ? void 0 : _item$components2.state_abbreviation;
+  const postalCode = (_item$components3 = item.components) === null || _item$components3 === void 0 ? void 0 : _item$components3.zipcode;
+  const lastLine = city && region ? [city, region, postalCode].filter(Boolean).join(' ') : trimZipPlus4(item.last_line || '');
+  return [line1, line2, lastLine].filter(Boolean).join(', ');
+};
+const buildValidationSummary = item => {
+  const analysis = item.analysis || {};
+  const dpvMatchCode = analysis.dpv_match_code || '';
+  const footnotes = parseDpvFootnotes(analysis.dpv_footnotes);
+  const isVacant = analysis.dpv_vacant === 'Y';
+  const isNoStat = analysis.dpv_no_stat === 'Y';
+  if (dpvMatchCode === 'Y' && !isVacant && !isNoStat) {
+    return {
+      level: 'verified',
+      code: 'verified',
+      title: 'Verified',
+      message: 'This address is fully verified.',
+      sortPriority: 1
+    };
+  }
+  if (dpvMatchCode === 'S' && footnotes.has('CC')) {
+    return {
+      level: 'warning',
+      code: 'invalid-secondary-optional',
+      title: 'Unit not recognized',
+      message: 'The main address is valid, but the unit number was not recognized.',
+      sortPriority: 2
+    };
+  }
+  if (dpvMatchCode === 'D' || footnotes.has('N1')) {
+    return {
+      level: 'warning',
+      code: 'missing-secondary',
+      title: 'Apartment or suite needed',
+      message: 'The main address is valid, but a unit number is required.',
+      sortPriority: 3
+    };
+  }
+  if (dpvMatchCode === 'S' && footnotes.has('C1')) {
+    return {
+      level: 'warning',
+      code: 'invalid-secondary-required',
+      title: 'Apartment or suite not recognized',
+      message: 'The street address is valid, but the unit number was not recognized and is required.',
+      sortPriority: 4
+    };
+  }
+  if ((dpvMatchCode === 'Y' || dpvMatchCode === 'S' || dpvMatchCode === 'D') && isVacant) {
+    return {
+      level: 'warning',
+      code: 'vacant',
+      title: 'Verified, but marked vacant',
+      message: 'This address is valid but marked as vacant.',
+      sortPriority: 5
+    };
+  }
+  if ((dpvMatchCode === 'Y' || dpvMatchCode === 'S' || dpvMatchCode === 'D') && isNoStat) {
+    return {
+      level: 'warning',
+      code: 'no-stat',
+      title: 'Verified with caution',
+      message: 'This address is valid, but USPS indicates limited delivery status.',
+      sortPriority: 6
+    };
+  }
+  return {
+    level: 'invalid',
+    code: 'not-confirmed',
+    title: 'Not verified',
+    message: 'This address could not be confirmed.',
+    sortPriority: 7
+  };
+};
+const buildValidationParams = formData => {
+  const params = {
+    key: _smartyConfig.SMARTY_US_STREET_KEY,
+    street: formData.address1 || '',
+    secondary: formData.address2 || '',
+    city: formData.city || '',
+    state: formData.region || '',
+    zipcode: (0, _validators.normalizePostalCodeValue)(formData.postalCode || ''),
+    candidates: 10
+  };
+  Object.keys(params).forEach(key => {
+    if (params[key] === '' || params[key] === null || params[key] === undefined) {
+      delete params[key];
+    }
+  });
+  return params;
+};
+const buildRequestKey = formData => JSON.stringify({
+  street: formData.address1 || '',
+  secondary: formData.address2 || '',
+  city: formData.city || '',
+  state: formData.region || '',
+  zipcode: (0, _validators.normalizePostalCodeValue)(formData.postalCode || '')
+});
+const transformSuggestions = (responseData = []) => responseData.map(item => {
+  var _item$analysis, _item$metadata, _item$metadata2;
+  const dpvMatchCode = ((_item$analysis = item.analysis) === null || _item$analysis === void 0 ? void 0 : _item$analysis.dpv_match_code) || '';
+  return {
+    ...item,
+    dpvMatchCode,
+    isDeliverable: VALID_DPV_CODES.has(dpvMatchCode),
+    latitude: (_item$metadata = item.metadata) === null || _item$metadata === void 0 ? void 0 : _item$metadata.latitude,
+    longitude: (_item$metadata2 = item.metadata) === null || _item$metadata2 === void 0 ? void 0 : _item$metadata2.longitude,
+    displayText: buildDisplayText(item),
+    validationSummary: buildValidationSummary(item)
+  };
+}).sort((left, right) => left.validationSummary.sortPriority - right.validationSummary.sortPriority);
+const useUSAddressValidation = (formData, trigger) => {
+  const isEnabled = Boolean(trigger && trigger !== 0 && (formData === null || formData === void 0 ? void 0 : formData.address1));
+  const requestParams = buildValidationParams(formData);
+  const requestKey = `smarty-us-validation:${buildRequestKey(formData)}`;
+  return (0, _useAddressValidationBase.default)({
+    isEnabled,
+    cacheNamespace: CACHE_NAMESPACE,
+    cacheTtlMs: CACHE_TTL_MS,
+    rateLimitNamespace: RATE_LIMIT_NAMESPACE,
+    rateLimitConfig: RATE_LIMIT_CONFIG,
+    requestKey,
+    requestUrl: VALIDATION_URL,
+    requestParams,
+    transformResponse: transformSuggestions,
+    effectDeps: [trigger]
+  });
+};
+var _default = exports.default = useUSAddressValidation;
+//# sourceMappingURL=useUSAddressValidation.js.map

package/dist/addressLookup/hooks/useUSAddressValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUSAddressValidation.js","names":["_smartyConfig","require","_validators","_useAddressValidationBase","_interopRequireDefault","e","__esModule","default","VALID_DPV_CODES","Set","CACHE_NAMESPACE","CACHE_TTL_MS","RATE_LIMIT_NAMESPACE","RATE_LIMIT_CONFIG","limit","windowMs","cooldownMs","VALIDATION_URL","parseDpvFootnotes","footnotes","normalized","String","result","index","length","code","slice","add","trimZipPlus4","value","replace","buildDisplayText","item","_item$components","_item$components2","_item$components3","line1","delivery_line_1","line2","delivery_line_2","city","components","city_name","region","state_abbreviation","postalCode","zipcode","lastLine","filter","Boolean","join","last_line","buildValidationSummary","analysis","dpvMatchCode","dpv_match_code","dpv_footnotes","isVacant","dpv_vacant","isNoStat","dpv_no_stat","level","title","message","sortPriority","has","buildValidationParams","formData","params","key","SMARTY_US_STREET_KEY","street","address1","secondary","address2","state","normalizePostalCodeValue","candidates","Object","keys","forEach","undefined","buildRequestKey","JSON","stringify","transformSuggestions","responseData","map","_item$analysis","_item$metadata","_item$metadata2","isDeliverable","latitude","metadata","longitude","displayText","validationSummary","sort","left","right","useUSAddressValidation","trigger","isEnabled","requestParams","requestKey","useAddressValidationBase","cacheNamespace","cacheTtlMs","rateLimitNamespace","rateLimitConfig","requestUrl","transformResponse","effectDeps","_default","exports"],"sources":["../../../src/addressLookup/hooks/useUSAddressValidation.jsx"],"sourcesContent":["import { SMARTY_US_STREET_KEY } from '../utils/smartyConfig';\nimport { normalizePostalCodeValue } from '../utils/validators';\nimport useAddressValidationBase from './useAddressValidationBase';\n\nconst VALID_DPV_CODES = new Set(['Y', 'S', 'D']);\nconst CACHE_NAMESPACE = 'smarty-us-validation';\nconst CACHE_TTL_MS = 60 * 1000;\nconst RATE_LIMIT_NAMESPACE = 'smarty-us-validation';\nconst RATE_LIMIT_CONFIG = {\n  limit: 5,\n  windowMs: 60 * 1000,\n  cooldownMs: 60 * 1000\n};\nconst VALIDATION_URL = 'https://us-street.api.smarty.com/street-address';\n\nconst parseDpvFootnotes = (footnotes = '') => {\n  const normalized = String(footnotes || '');\n  const result = new Set();\n\n  for (let index = 0; index < normalized.length; index += 2) {\n    const code = normalized.slice(index, index + 2);\n    if (code.length === 2) {\n      result.add(code);\n    }\n  }\n\n  return result;\n};\n\nconst trimZipPlus4 = (value = '') => String(value).replace(/(\\b\\d{5})-\\d{4}\\b/g, '$1');\n\nconst buildDisplayText = (item) => {\n  const line1 = item.delivery_line_1;\n  const line2 = item.delivery_line_2;\n  const city = item.components?.city_name;\n  const region = item.components?.state_abbreviation;\n  const postalCode = item.components?.zipcode;\n\n  const lastLine = city && region ?\n    [city, region, postalCode].filter(Boolean).join(' ') :\n    trimZipPlus4(item.last_line || '');\n\n  return [\n    line1,\n    line2,\n    lastLine\n  ].filter(Boolean).join(', ');\n};\n\nconst buildValidationSummary = (item) => {\n  const analysis = item.analysis || {};\n  const dpvMatchCode = analysis.dpv_match_code || '';\n  const footnotes = parseDpvFootnotes(analysis.dpv_footnotes);\n  const isVacant = analysis.dpv_vacant === 'Y';\n  const isNoStat = analysis.dpv_no_stat === 'Y';\n\n  if (dpvMatchCode === 'Y' && !isVacant && !isNoStat) {\n    return {\n      level: 'verified',\n      code: 'verified',\n      title: 'Verified',\n      message: 'This address is fully verified.',\n      sortPriority: 1\n    };\n  }\n\n  if (dpvMatchCode === 'S' && footnotes.has('CC')) {\n    return {\n      level: 'warning',\n      code: 'invalid-secondary-optional',\n      title: 'Unit not recognized',\n      message: 'The main address is valid, but the unit number was not recognized.',\n      sortPriority: 2\n    };\n  }\n\n  if (dpvMatchCode === 'D' || footnotes.has('N1')) {\n    return {\n      level: 'warning',\n      code: 'missing-secondary',\n      title: 'Apartment or suite needed',\n      message: 'The main address is valid, but a unit number is required.',\n      sortPriority: 3\n    };\n  }\n\n  if (dpvMatchCode === 'S' && footnotes.has('C1')) {\n    return {\n      level: 'warning',\n      code: 'invalid-secondary-required',\n      title: 'Apartment or suite not recognized',\n      message: 'The street address is valid, but the unit number was not recognized and is required.',\n      sortPriority: 4\n    };\n  }\n\n  if ((dpvMatchCode === 'Y' || dpvMatchCode === 'S' || dpvMatchCode === 'D') && isVacant) {\n    return {\n      level: 'warning',\n      code: 'vacant',\n      title: 'Verified, but marked vacant',\n      message: 'This address is valid but marked as vacant.',\n      sortPriority: 5\n    };\n  }\n\n  if ((dpvMatchCode === 'Y' || dpvMatchCode === 'S' || dpvMatchCode === 'D') && isNoStat) {\n    return {\n      level: 'warning',\n      code: 'no-stat',\n      title: 'Verified with caution',\n      message: 'This address is valid, but USPS indicates limited delivery status.',\n      sortPriority: 6\n    };\n  }\n\n  return {\n    level: 'invalid',\n    code: 'not-confirmed',\n    title: 'Not verified',\n    message: 'This address could not be confirmed.',\n    sortPriority: 7\n  };\n};\n\nconst buildValidationParams = (formData) => {\n  const params = {\n    key: SMARTY_US_STREET_KEY,\n    street: formData.address1 || '',\n    secondary: formData.address2 || '',\n    city: formData.city || '',\n    state: formData.region || '',\n    zipcode: normalizePostalCodeValue(formData.postalCode || ''),\n    candidates: 10\n  };\n\n  Object.keys(params).forEach((key) => {\n    if (params[key] === '' || params[key] === null || params[key] === undefined) {\n      delete params[key];\n    }\n  });\n\n  return params;\n};\n\nconst buildRequestKey = (formData) => JSON.stringify({\n  street: formData.address1 || '',\n  secondary: formData.address2 || '',\n  city: formData.city || '',\n  state: formData.region || '',\n  zipcode: normalizePostalCodeValue(formData.postalCode || '')\n});\n\nconst transformSuggestions = (responseData = []) => responseData\n  .map((item) => {\n    const dpvMatchCode = item.analysis?.dpv_match_code || '';\n\n    return {\n      ...item,\n      dpvMatchCode,\n      isDeliverable: VALID_DPV_CODES.has(dpvMatchCode),\n      latitude: item.metadata?.latitude,\n      longitude: item.metadata?.longitude,\n      displayText: buildDisplayText(item),\n      validationSummary: buildValidationSummary(item)\n    };\n  })\n  .sort((left, right) => left.validationSummary.sortPriority - right.validationSummary.sortPriority);\n\nconst useUSAddressValidation = (formData, trigger) => {\n  const isEnabled = Boolean(trigger && trigger !== 0 && formData?.address1);\n  const requestParams = buildValidationParams(formData);\n  const requestKey = `smarty-us-validation:${buildRequestKey(formData)}`;\n\n  return useAddressValidationBase({\n    isEnabled,\n    cacheNamespace: CACHE_NAMESPACE,\n    cacheTtlMs: CACHE_TTL_MS,\n    rateLimitNamespace: RATE_LIMIT_NAMESPACE,\n    rateLimitConfig: RATE_LIMIT_CONFIG,\n    requestKey,\n    requestUrl: VALIDATION_URL,\n    requestParams,\n    transformResponse: transformSuggestions,\n    effectDeps: [trigger]\n  });\n};\n\nexport default useUSAddressValidation;\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AACA,IAAAC,WAAA,GAAAD,OAAA;AACA,IAAAE,yBAAA,GAAAC,sBAAA,CAAAH,OAAA;AAAkE,SAAAG,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAElE,MAAMG,eAAe,GAAG,IAAIC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAChD,MAAMC,eAAe,GAAG,sBAAsB;AAC9C,MAAMC,YAAY,GAAG,EAAE,GAAG,IAAI;AAC9B,MAAMC,oBAAoB,GAAG,sBAAsB;AACnD,MAAMC,iBAAiB,GAAG;EACxBC,KAAK,EAAE,CAAC;EACRC,QAAQ,EAAE,EAAE,GAAG,IAAI;EACnBC,UAAU,EAAE,EAAE,GAAG;AACnB,CAAC;AACD,MAAMC,cAAc,GAAG,iDAAiD;AAExE,MAAMC,iBAAiB,GAAGA,CAACC,SAAS,GAAG,EAAE,KAAK;EAC5C,MAAMC,UAAU,GAAGC,MAAM,CAACF,SAAS,IAAI,EAAE,CAAC;EAC1C,MAAMG,MAAM,GAAG,IAAIb,GAAG,CAAC,CAAC;EAExB,KAAK,IAAIc,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGH,UAAU,CAACI,MAAM,EAAED,KAAK,IAAI,CAAC,EAAE;IACzD,MAAME,IAAI,GAAGL,UAAU,CAACM,KAAK,CAACH,KAAK,EAAEA,KAAK,GAAG,CAAC,CAAC;IAC/C,IAAIE,IAAI,CAACD,MAAM,KAAK,CAAC,EAAE;MACrBF,MAAM,CAACK,GAAG,CAACF,IAAI,CAAC;IAClB;EACF;EAEA,OAAOH,MAAM;AACf,CAAC;AAED,MAAMM,YAAY,GAAGA,CAACC,KAAK,GAAG,EAAE,KAAKR,MAAM,CAACQ,KAAK,CAAC,CAACC,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC;AAEtF,MAAMC,gBAAgB,GAAIC,IAAI,IAAK;EAAA,IAAAC,gBAAA,EAAAC,iBAAA,EAAAC,iBAAA;EACjC,MAAMC,KAAK,GAAGJ,IAAI,CAACK,eAAe;EAClC,MAAMC,KAAK,GAAGN,IAAI,CAACO,eAAe;EAClC,MAAMC,IAAI,IAAAP,gBAAA,GAAGD,IAAI,CAACS,UAAU,cAAAR,gBAAA,uBAAfA,gBAAA,CAAiBS,SAAS;EACvC,MAAMC,MAAM,IAAAT,iBAAA,GAAGF,IAAI,CAACS,UAAU,cAAAP,iBAAA,uBAAfA,iBAAA,CAAiBU,kBAAkB;EAClD,MAAMC,UAAU,IAAAV,iBAAA,GAAGH,IAAI,CAACS,UAAU,cAAAN,iBAAA,uBAAfA,iBAAA,CAAiBW,OAAO;EAE3C,MAAMC,QAAQ,GAAGP,IAAI,IAAIG,MAAM,GAC7B,CAACH,IAAI,EAAEG,MAAM,EAAEE,UAAU,CAAC,CAACG,MAAM,CAACC,OAAO,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC,GACpDtB,YAAY,CAACI,IAAI,CAACmB,SAAS,IAAI,EAAE,CAAC;EAEpC,OAAO,CACLf,KAAK,EACLE,KAAK,EACLS,QAAQ,CACT,CAACC,MAAM,CAACC,OAAO,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,MAAME,sBAAsB,GAAIpB,IAAI,IAAK;EACvC,MAAMqB,QAAQ,GAAGrB,IAAI,CAACqB,QAAQ,IAAI,CAAC,CAAC;EACpC,MAAMC,YAAY,GAAGD,QAAQ,CAACE,cAAc,IAAI,EAAE;EAClD,MAAMpC,SAAS,GAAGD,iBAAiB,CAACmC,QAAQ,CAACG,aAAa,CAAC;EAC3D,MAAMC,QAAQ,GAAGJ,QAAQ,CAACK,UAAU,KAAK,GAAG;EAC5C,MAAMC,QAAQ,GAAGN,QAAQ,CAACO,WAAW,KAAK,GAAG;EAE7C,IAAIN,YAAY,KAAK,GAAG,IAAI,CAACG,QAAQ,IAAI,CAACE,QAAQ,EAAE;IAClD,OAAO;MACLE,KAAK,EAAE,UAAU;MACjBpC,IAAI,EAAE,UAAU;MAChBqC,KAAK,EAAE,UAAU;MACjBC,OAAO,EAAE,iCAAiC;MAC1CC,YAAY,EAAE;IAChB,CAAC;EACH;EAEA,IAAIV,YAAY,KAAK,GAAG,IAAInC,SAAS,CAAC8C,GAAG,CAAC,IAAI,CAAC,EAAE;IAC/C,OAAO;MACLJ,KAAK,EAAE,SAAS;MAChBpC,IAAI,EAAE,4BAA4B;MAClCqC,KAAK,EAAE,qBAAqB;MAC5BC,OAAO,EAAE,oEAAoE;MAC7EC,YAAY,EAAE;IAChB,CAAC;EACH;EAEA,IAAIV,YAAY,KAAK,GAAG,IAAInC,SAAS,CAAC8C,GAAG,CAAC,IAAI,CAAC,EAAE;IAC/C,OAAO;MACLJ,KAAK,EAAE,SAAS;MAChBpC,IAAI,EAAE,mBAAmB;MACzBqC,KAAK,EAAE,2BAA2B;MAClCC,OAAO,EAAE,2DAA2D;MACpEC,YAAY,EAAE;IAChB,CAAC;EACH;EAEA,IAAIV,YAAY,KAAK,GAAG,IAAInC,SAAS,CAAC8C,GAAG,CAAC,IAAI,CAAC,EAAE;IAC/C,OAAO;MACLJ,KAAK,EAAE,SAAS;MAChBpC,IAAI,EAAE,4BAA4B;MAClCqC,KAAK,EAAE,mCAAmC;MAC1CC,OAAO,EAAE,sFAAsF;MAC/FC,YAAY,EAAE;IAChB,CAAC;EACH;EAEA,IAAI,CAACV,YAAY,KAAK,GAAG,IAAIA,YAAY,KAAK,GAAG,IAAIA,YAAY,KAAK,GAAG,KAAKG,QAAQ,EAAE;IACtF,OAAO;MACLI,KAAK,EAAE,SAAS;MAChBpC,IAAI,EAAE,QAAQ;MACdqC,KAAK,EAAE,6BAA6B;MACpCC,OAAO,EAAE,6CAA6C;MACtDC,YAAY,EAAE;IAChB,CAAC;EACH;EAEA,IAAI,CAACV,YAAY,KAAK,GAAG,IAAIA,YAAY,KAAK,GAAG,IAAIA,YAAY,KAAK,GAAG,KAAKK,QAAQ,EAAE;IACtF,OAAO;MACLE,KAAK,EAAE,SAAS;MAChBpC,IAAI,EAAE,SAAS;MACfqC,KAAK,EAAE,uBAAuB;MAC9BC,OAAO,EAAE,oEAAoE;MAC7EC,YAAY,EAAE;IAChB,CAAC;EACH;EAEA,OAAO;IACLH,KAAK,EAAE,SAAS;IAChBpC,IAAI,EAAE,eAAe;IACrBqC,KAAK,EAAE,cAAc;IACrBC,OAAO,EAAE,sCAAsC;IAC/CC,YAAY,EAAE;EAChB,CAAC;AACH,CAAC;AAED,MAAME,qBAAqB,GAAIC,QAAQ,IAAK;EAC1C,MAAMC,MAAM,GAAG;IACbC,GAAG,EAAEC,kCAAoB;IACzBC,MAAM,EAAEJ,QAAQ,CAACK,QAAQ,IAAI,EAAE;IAC/BC,SAAS,EAAEN,QAAQ,CAACO,QAAQ,IAAI,EAAE;IAClClC,IAAI,EAAE2B,QAAQ,CAAC3B,IAAI,IAAI,EAAE;IACzBmC,KAAK,EAAER,QAAQ,CAACxB,MAAM,IAAI,EAAE;IAC5BG,OAAO,EAAE,IAAA8B,oCAAwB,EAACT,QAAQ,CAACtB,UAAU,IAAI,EAAE,CAAC;IAC5DgC,UAAU,EAAE;EACd,CAAC;EAEDC,MAAM,CAACC,IAAI,CAACX,MAAM,CAAC,CAACY,OAAO,CAAEX,GAAG,IAAK;IACnC,IAAID,MAAM,CAACC,GAAG,CAAC,KAAK,EAAE,IAAID,MAAM,CAACC,GAAG,CAAC,KAAK,IAAI,IAAID,MAAM,CAACC,GAAG,CAAC,KAAKY,SAAS,EAAE;MAC3E,OAAOb,MAAM,CAACC,GAAG,CAAC;IACpB;EACF,CAAC,CAAC;EAEF,OAAOD,MAAM;AACf,CAAC;AAED,MAAMc,eAAe,GAAIf,QAAQ,IAAKgB,IAAI,CAACC,SAAS,CAAC;EACnDb,MAAM,EAAEJ,QAAQ,CAACK,QAAQ,IAAI,EAAE;EAC/BC,SAAS,EAAEN,QAAQ,CAACO,QAAQ,IAAI,EAAE;EAClClC,IAAI,EAAE2B,QAAQ,CAAC3B,IAAI,IAAI,EAAE;EACzBmC,KAAK,EAAER,QAAQ,CAACxB,MAAM,IAAI,EAAE;EAC5BG,OAAO,EAAE,IAAA8B,oCAAwB,EAACT,QAAQ,CAACtB,UAAU,IAAI,EAAE;AAC7D,CAAC,CAAC;AAEF,MAAMwC,oBAAoB,GAAGA,CAACC,YAAY,GAAG,EAAE,KAAKA,YAAY,CAC7DC,GAAG,CAAEvD,IAAI,IAAK;EAAA,IAAAwD,cAAA,EAAAC,cAAA,EAAAC,eAAA;EACb,MAAMpC,YAAY,GAAG,EAAAkC,cAAA,GAAAxD,IAAI,CAACqB,QAAQ,cAAAmC,cAAA,uBAAbA,cAAA,CAAejC,cAAc,KAAI,EAAE;EAExD,OAAO;IACL,GAAGvB,IAAI;IACPsB,YAAY;IACZqC,aAAa,EAAEnF,eAAe,CAACyD,GAAG,CAACX,YAAY,CAAC;IAChDsC,QAAQ,GAAAH,cAAA,GAAEzD,IAAI,CAAC6D,QAAQ,cAAAJ,cAAA,uBAAbA,cAAA,CAAeG,QAAQ;IACjCE,SAAS,GAAAJ,eAAA,GAAE1D,IAAI,CAAC6D,QAAQ,cAAAH,eAAA,uBAAbA,eAAA,CAAeI,SAAS;IACnCC,WAAW,EAAEhE,gBAAgB,CAACC,IAAI,CAAC;IACnCgE,iBAAiB,EAAE5C,sBAAsB,CAACpB,IAAI;EAChD,CAAC;AACH,CAAC,CAAC,CACDiE,IAAI,CAAC,CAACC,IAAI,EAAEC,KAAK,KAAKD,IAAI,CAACF,iBAAiB,CAAChC,YAAY,GAAGmC,KAAK,CAACH,iBAAiB,CAAChC,YAAY,CAAC;AAEpG,MAAMoC,sBAAsB,GAAGA,CAACjC,QAAQ,EAAEkC,OAAO,KAAK;EACpD,MAAMC,SAAS,GAAGrD,OAAO,CAACoD,OAAO,IAAIA,OAAO,KAAK,CAAC,KAAIlC,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAEK,QAAQ,EAAC;EACzE,MAAM+B,aAAa,GAAGrC,qBAAqB,CAACC,QAAQ,CAAC;EACrD,MAAMqC,UAAU,GAAG,wBAAwBtB,eAAe,CAACf,QAAQ,CAAC,EAAE;EAEtE,OAAO,IAAAsC,iCAAwB,EAAC;IAC9BH,SAAS;IACTI,cAAc,EAAEhG,eAAe;IAC/BiG,UAAU,EAAEhG,YAAY;IACxBiG,kBAAkB,EAAEhG,oBAAoB;IACxCiG,eAAe,EAAEhG,iBAAiB;IAClC2F,UAAU;IACVM,UAAU,EAAE7F,cAAc;IAC1BsF,aAAa;IACbQ,iBAAiB,EAAE1B,oBAAoB;IACvC2B,UAAU,EAAE,CAACX,OAAO;EACtB,CAAC,CAAC;AACJ,CAAC;AAAC,IAAAY,QAAA,GAAAC,OAAA,CAAA3G,OAAA,GAEa6F,sBAAsB","ignoreList":[]}

package/dist/addressLookup/index.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "AddressLookup", {
+  enumerable: true,
+  get: function () {
+    return _AddressLookup.default;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_ADDRESS_FORM", {
+  enumerable: true,
+  get: function () {
+    return _addressForm.DEFAULT_ADDRESS_FORM;
+  }
+});
+Object.defineProperty(exports, "SUPPORTED_COUNTRIES", {
+  enumerable: true,
+  get: function () {
+    return _countries.SUPPORTED_COUNTRIES;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _AddressLookup.default;
+  }
+});
+Object.defineProperty(exports, "normalizeAddressForm", {
+  enumerable: true,
+  get: function () {
+    return _addressForm.normalizeAddressForm;
+  }
+});
+require("./styles/addressLookup.css");
+var _AddressLookup = _interopRequireDefault(require("./AddressLookup"));
+var _addressForm = require("./utils/addressForm");
+var _countries = require("./countries");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/dist/addressLookup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["require","_AddressLookup","_interopRequireDefault","_addressForm","_countries","e","__esModule","default"],"sources":["../../src/addressLookup/index.js"],"sourcesContent":["import './styles/addressLookup.css';\n\nexport { default as AddressLookup } from './AddressLookup';\nexport { default } from './AddressLookup';\nexport { normalizeAddressForm, DEFAULT_ADDRESS_FORM } from './utils/addressForm';\nexport { SUPPORTED_COUNTRIES } from './countries';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,OAAA;AAEA,IAAAC,cAAA,GAAAC,sBAAA,CAAAF,OAAA;AAEA,IAAAG,YAAA,GAAAH,OAAA;AACA,IAAAI,UAAA,GAAAJ,OAAA;AAAkD,SAAAE,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}