@nuskin/contentstack-lib 2.1.0-pa-1117.8 → 2.1.0-pa-1117.9

package/__tests__/api.spec.js

@@ -87,7 +87,8 @@ const addressFormFieldEntries = [
     editable: true,
     max_length: '40',
     required: true,
-    api_mappings: ['address1']
+    api_mappings: ['address1'],
+    autocomplete_token: 'address-line1'
   },
   {
     field: 'postalCode',
@@ -95,7 +96,8 @@ const addressFormFieldEntries = [
     editable: false,
     max_length: '10',
     required: false,
-    api_mappings: ['postalCode']
+    api_mappings: ['postalCode'],
+    validation_message: 'Invalid postal code'
   }
 ];
 
@@ -174,7 +176,8 @@ describe("ContentstackApi", () => {
         editable: true,
         max_length: 40,
         required: true,
-        api_mappings: ['address1']
+        api_mappings: ['address1'],
+        autocomplete_token: 'address-line1'
       },
       {
         field: 'postalCode',
@@ -182,7 +185,8 @@ describe("ContentstackApi", () => {
         editable: false,
         max_length: 10,
         required: false,
-        api_mappings: ['postalCode']
+        api_mappings: ['postalCode'],
+        validation_message: 'Invalid postal code'
       }
     ]);
   });
@@ -197,7 +201,8 @@ describe("ContentstackApi", () => {
         editable: true,
         maxLength: 40,
         required: true,
-        apiMappings: ['address1']
+        apiMappings: ['address1'],
+        autocompleteToken: 'address-line1'
       },
       {
         field: 'postalCode',
@@ -205,7 +210,8 @@ describe("ContentstackApi", () => {
         editable: false,
         maxLength: 10,
         required: false,
-        apiMappings: ['postalCode']
+        apiMappings: ['postalCode'],
+        validationMessage: 'Invalid postal code'
       }
     ]);
   });
@@ -223,7 +229,8 @@ describe("ContentstackApi", () => {
         address_elements: addressFormFieldEntries,
         postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
         verify_after_autocomplete: true,
-        wrap_address1_to_address2: false
+        wrap_address1_to_address2: false,
+        allowed_countries: ['US', 'CA']
       }
     ]]);
     const {getStack} = require('../src/api');
@@ -237,7 +244,8 @@ describe("ContentstackApi", () => {
             editable: true,
             max_length: 40,
             required: true,
-            api_mappings: ['address1']
+            api_mappings: ['address1'],
+            autocomplete_token: 'address-line1'
           },
           {
             field: 'postalCode',
@@ -245,12 +253,14 @@ describe("ContentstackApi", () => {
             editable: false,
             max_length: 10,
             required: false,
-            api_mappings: ['postalCode']
+            api_mappings: ['postalCode'],
+            validation_message: 'Invalid postal code'
           }
         ],
         postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
         verify_after_autocomplete: true,
-        wrap_address1_to_address2: false
+        wrap_address1_to_address2: false,
+        allowed_countries: ['US', 'CA']
       }
     ]);
   });
@@ -261,7 +271,8 @@ describe("ContentstackApi", () => {
         address_elements: addressFormFieldEntries,
         postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
         verify_after_autocomplete: true,
-        wrap_address1_to_address2: false
+        wrap_address1_to_address2: false,
+        allowed_countries: ['US', 'CA']
       }
     ]]);
     const {getStack} = require('../src/api');
@@ -275,7 +286,8 @@ describe("ContentstackApi", () => {
             editable: true,
             maxLength: 40,
             required: true,
-            apiMappings: ['address1']
+            apiMappings: ['address1'],
+            autocompleteToken: 'address-line1'
           },
           {
             field: 'postalCode',
@@ -283,12 +295,14 @@ describe("ContentstackApi", () => {
             editable: false,
             maxLength: 10,
             required: false,
-            apiMappings: ['postalCode']
+            apiMappings: ['postalCode'],
+            validationMessage: 'Invalid postal code'
           }
         ],
         postalCodeRegex: '^[0-9]{5}(?:-[0-9]{4})?$',
         verifyAfterAutocomplete: true,
-        wrapAddress1ToAddress2: false
+        wrapAddress1ToAddress2: false,
+        allowedCountries: ['US', 'CA']
       }
     ]);
   });
@@ -333,10 +347,12 @@ describe("ContentstackApi", () => {
             address_elements: addressFormFieldEntries,
             postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
             verify_after_autocomplete: true,
-            wrap_address1_to_address2: false
+            wrap_address1_to_address2: false,
+            allowed_countries: ['US', 'CA']
           }
         ],
-        post_address_fields: [addressFormFieldEntries[1]]
+        post_address_fields: [addressFormFieldEntries[1]],
+        display_name: 'North America'
       }
     ]]);
     const {getStack} = require('../src/api');
@@ -360,7 +376,8 @@ describe("ContentstackApi", () => {
             editable: true,
             max_length: 40,
             required: true,
-            api_mappings: ['address1']
+            api_mappings: ['address1'],
+            autocomplete_token: 'address-line1'
           }
         ],
         address_form: {
@@ -371,7 +388,8 @@ describe("ContentstackApi", () => {
               editable: true,
               max_length: 40,
               required: true,
-              api_mappings: ['address1']
+              api_mappings: ['address1'],
+              autocomplete_token: 'address-line1'
             },
             {
               field: 'postalCode',
@@ -379,12 +397,14 @@ describe("ContentstackApi", () => {
               editable: false,
               max_length: 10,
               required: false,
-              api_mappings: ['postalCode']
+              api_mappings: ['postalCode'],
+              validation_message: 'Invalid postal code'
             }
           ],
           postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
           verify_after_autocomplete: true,
-          wrap_address1_to_address2: false
+          wrap_address1_to_address2: false,
+          allowed_countries: ['US', 'CA']
         },
         post_address_fields: [
           {
@@ -393,9 +413,11 @@ describe("ContentstackApi", () => {
             editable: false,
             max_length: 10,
             required: false,
-            api_mappings: ['postalCode']
+            api_mappings: ['postalCode'],
+            validation_message: 'Invalid postal code'
           }
-        ]
+        ],
+        display_name: 'North America'
       }
     ]);
   });
@@ -425,10 +447,12 @@ describe("ContentstackApi", () => {
             address_elements: addressFormFieldEntries,
             postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
             verify_after_autocomplete: true,
-            wrap_address1_to_address2: false
+            wrap_address1_to_address2: false,
+            allowed_countries: ['US', 'CA']
           }
         ],
-        post_address_fields: [addressFormFieldEntries[1]]
+        post_address_fields: [addressFormFieldEntries[1]],
+        display_name: 'North America'
       }
     ]]);
     const {getStack} = require('../src/api');
@@ -452,7 +476,8 @@ describe("ContentstackApi", () => {
             editable: true,
             maxLength: 40,
             required: true,
-            apiMappings: ['address1']
+            apiMappings: ['address1'],
+            autocompleteToken: 'address-line1'
           }
         ],
         addressForm: {
@@ -463,7 +488,8 @@ describe("ContentstackApi", () => {
               editable: true,
               maxLength: 40,
               required: true,
-              apiMappings: ['address1']
+              apiMappings: ['address1'],
+              autocompleteToken: 'address-line1'
             },
             {
               field: 'postalCode',
@@ -471,12 +497,14 @@ describe("ContentstackApi", () => {
               editable: false,
               maxLength: 10,
               required: false,
-              apiMappings: ['postalCode']
+              apiMappings: ['postalCode'],
+              validationMessage: 'Invalid postal code'
             }
           ],
           postalCodeRegex: '^[0-9]{5}(?:-[0-9]{4})?$',
           verifyAfterAutocomplete: true,
-          wrapAddress1ToAddress2: false
+          wrapAddress1ToAddress2: false,
+          allowedCountries: ['US', 'CA']
         },
         postAddressFields: [
           {
@@ -485,9 +513,11 @@ describe("ContentstackApi", () => {
             editable: false,
             maxLength: 10,
             required: false,
-            apiMappings: ['postalCode']
+            apiMappings: ['postalCode'],
+            validationMessage: 'Invalid postal code'
           }
-        ]
+        ],
+        displayName: 'North America'
       }
     ]);
   });

package/docs/CHANGELOG.md

@@ -1 +1 @@
-# [2.1.0-pa-1117.8](https://code.tls.nuskin.io/ns-am/utility/npm/contentstack-lib/compare/v2.1.0-pa-1117.7...v2.1.0-pa-1117.8) (2026-05-08)
+# [2.1.0-pa-1117.9](https://code.tls.nuskin.io/ns-am/utility/npm/contentstack-lib/compare/v2.1.0-pa-1117.8...v2.1.0-pa-1117.9) (2026-05-18)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuskin/contentstack-lib",
-  "version": "2.1.0-pa-1117.8",
+  "version": "2.1.0-pa-1117.9",
   "description": "This project contains configuration and api code to access Contentstack, to be shared between the backend (AWS Lambda) and frontend (Vue, etc).",
   "main": "src/index.js",
   "scripts": {

package/src/api.js

@@ -22,6 +22,22 @@ const COMMON_LANGUAGES = {
   'tr': 'tr-tr'
 };
 
+const CONTENTSTACK_SYSTEM_FIELDS = new Set([
+  '_content_type_uid',
+  'uid',
+  'title',
+  'tags',
+  'locale',
+  'created_by',
+  'updated_by',
+  'created_at',
+  'updated_at',
+  'ACL',
+  '_version',
+  '_in_progress',
+  'publish_details'
+]);
+
 /**
  * Gets the correct contentstack config settings
  * @param {string} env
@@ -195,6 +211,18 @@ const _getMultiEntries = async (contentType, includeRefs, values) => {
   }
 }
 
+/**
+ * Removes Contentstack-managed metadata fields while preserving custom content fields.
+ * @param {Object} entry
+ * @return {Object}
+ * @private
+ */
+const _omitContentstackSystemFields = (entry = {}) => {
+  return Object.fromEntries(
+    Object.entries(entry).filter(([key]) => !CONTENTSTACK_SYSTEM_FIELDS.has(key))
+  );
+}
+
 /**
  * Maps address form field entries into a small normalized dataset.
  * @param {Object[]} addressFormFields
@@ -202,14 +230,15 @@ const _getMultiEntries = async (contentType, includeRefs, values) => {
  * @private
  */
 const _extractAddressFormFields = (addressFormFields = [], camelcase = false) => {
-  const mappedFields = addressFormFields.map(({field, width, editable, max_length, required, api_mappings}) => ({
-    field,
-    width,
-    editable,
-    max_length: Number(max_length),
-    required,
-    api_mappings
-  }));
+  const mappedFields = addressFormFields.map((addressFormField) => {
+    const mappedField = _omitContentstackSystemFields(addressFormField);
+
+    if (mappedField.max_length !== undefined && mappedField.max_length !== null) {
+      mappedField.max_length = Number(mappedField.max_length);
+    }
+
+    return mappedField;
+  });
 
   return camelcase ? _snakeObjectToCamel(mappedFields) : mappedFields;
 }
@@ -219,12 +248,8 @@ const _extractAddressForm = (addressForm, camelcase = false) => {
     return addressForm;
   }
 
-  const mappedForm = {
-    address_elements: _extractAddressFormFields(addressForm.address_elements, camelcase),
-    postal_code_regex: addressForm.postal_code_regex,
-    verify_after_autocomplete: addressForm.verify_after_autocomplete,
-    wrap_address1_to_address2: addressForm.wrap_address1_to_address2
-  };
+  const mappedForm = _omitContentstackSystemFields(addressForm);
+  mappedForm.address_elements = _extractAddressFormFields(addressForm.address_elements, camelcase);
 
   return camelcase ? _snakeObjectToCamel(mappedForm) : mappedForm;
 }
@@ -244,12 +269,14 @@ const getShippingAddressForms = async (forms, camelcase = false) => {
     ['countries', 'pre_address_fields', 'address_form', 'address_form.address_elements', 'post_address_fields'],
     forms
   );
-  const mappedResults = (results || []).map((result) => ({
-    countries: _extractShippingCountries(result.countries),
-    pre_address_fields: _extractAddressFormFields(result.pre_address_fields, camelcase),
-    address_form: _extractAddressForm(result.address_form[0], camelcase),
-    post_address_fields: _extractAddressFormFields(result.post_address_fields, camelcase)
-  }));
+  const mappedResults = (results || []).map((result) => {
+    const mappedResult = _omitContentstackSystemFields(result);
+    mappedResult.countries = _extractShippingCountries(result.countries);
+    mappedResult.pre_address_fields = _extractAddressFormFields(result.pre_address_fields, camelcase);
+    mappedResult.address_form = _extractAddressForm(result.address_form[0], camelcase);
+    mappedResult.post_address_fields = _extractAddressFormFields(result.post_address_fields, camelcase);
+    return mappedResult;
+  });
 
   return camelcase ? _snakeObjectToCamel(mappedResults) : mappedResults;
 }