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

package/README.md

@@ -7,7 +7,6 @@ This project extends the Contentstack delivery sdk, to be shared between the bac
 getSingletonEntries TAKES AN OPTION CALLED mergeWithFallback.  IF THAT IS SET TO TRUE THEN IT WILL MERGE THE RESULTS
 FOR COMMON SPANISH AND MX-es FOR EXAMPLE.
 4. getSingletonEntries also allows you to convert the keys from snake case to camel case.
-5. It extends the stack with getAddressForms and getShippingAddressForms for address form content types.
 
 ## Installing
 
@@ -55,82 +54,6 @@ const [
     mergeWithFallback: true
   });
 
-// Get address forms for a list of countries.
-// By default the returned keys are snake_case.
-const addressForms = await Stack.getAddressForms(['United States']);
-
-// Example result:
-// [
-//   {
-//     address_elements: [
-//       {
-//         field: 'address1',
-//         width: 'full',
-//         editable: true,
-//         max_length: 40,
-//         required: true
-//       }
-//     ],
-//     postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-//     verify_after_autocomplete: true,
-//     wrap_address1_to_address2: false
-//   }
-// ]
-
-// Pass true as the second parameter to camelCase the returned keys.
-const camelizedAddressForms = await Stack.getAddressForms(['United States'], true);
-
-// Get shipping address forms with referenced address form fields expanded.
-// countries is normalized to a list of { code, name } objects.
-const shippingAddressForms = await Stack.getShippingAddressForms(['United States']);
-
-// Example result:
-// [
-//   {
-//     countries: [
-//       {
-//         code: 'US',
-//         name: 'United States'
-//       }
-//     ],
-//     pre_address_fields: [
-//       {
-//         field: 'givenName',
-//         width: 'half',
-//         editable: true,
-//         max_length: 30,
-//         required: true
-//       }
-//     ],
-//     address_form: {
-//       address_elements: [
-//         {
-//           field: 'address1',
-//           width: 'full',
-//           editable: true,
-//           max_length: 40,
-//           required: true
-//         }
-//       ],
-//       postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-//       verify_after_autocomplete: true,
-//       wrap_address1_to_address2: false
-//     },
-//     post_address_fields: [
-//       {
-//         field: 'mobilePhone',
-//         width: 'full',
-//         editable: true,
-//         max_length: 20,
-//         required: true
-//       }
-//     ]
-//   }
-// ]
-
-// Pass true as the second parameter to camelCase the returned keys.
-const camelizedShippingAddressForms = await Stack.getShippingAddressForms(['United States'], true);
-
 // We could possibly add functionality to return the list of regions markets and languages in a single object structure
 ```
 

package/__tests__/api.spec.js

@@ -80,25 +80,6 @@ const mockResults = () => {
   mockSinglePromiseResult.mockResolvedValueOnce(singleCheckoutCartStrings);
 }
 
-const addressFormFieldEntries = [
-  {
-    field: 'address1',
-    width: 'full',
-    editable: true,
-    max_length: '40',
-    required: true,
-    api_mappings: ['address1']
-  },
-  {
-    field: 'postalCode',
-    width: 'half',
-    editable: false,
-    max_length: '10',
-    required: false,
-    api_mappings: ['postalCode']
-  }
-];
-
 describe("ContentstackApi", () => {
   test("getSingletonEntries", async () => {
     mockResults();
@@ -164,142 +145,6 @@ describe("ContentstackApi", () => {
     });
   });
 
-  test('extractAddressFormFields maps address form field entries', () => {
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    expect(Stack.extractAddressFormFields(addressFormFieldEntries)).toStrictEqual([
-      {
-        field: 'address1',
-        width: 'full',
-        editable: true,
-        max_length: 40,
-        required: true,
-        api_mappings: ['address1']
-      },
-      {
-        field: 'postalCode',
-        width: 'half',
-        editable: false,
-        max_length: 10,
-        required: false,
-        api_mappings: ['postalCode']
-      }
-    ]);
-  });
-
-  test('extractAddressFormFields camelcases address form field entries', () => {
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    expect(Stack.extractAddressFormFields(addressFormFieldEntries, true)).toStrictEqual([
-      {
-        field: 'address1',
-        width: 'full',
-        editable: true,
-        maxLength: 40,
-        required: true,
-        apiMappings: ['address1']
-      },
-      {
-        field: 'postalCode',
-        width: 'half',
-        editable: false,
-        maxLength: 10,
-        required: false,
-        apiMappings: ['postalCode']
-      }
-    ]);
-  });
-
-  test('extractAddressFormFields returns an empty list when no entries are provided', () => {
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    expect(Stack.extractAddressFormFields()).toStrictEqual([]);
-  });
-
-  test('getAddressForms maps address_elements', async () => {
-    mockPromiseResult.mockResolvedValueOnce([[
-      {
-        title: 'United States',
-        address_elements: addressFormFieldEntries,
-        postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-        verify_after_autocomplete: true,
-        wrap_address1_to_address2: false
-      }
-    ]]);
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    await expect(Stack.getAddressForms(['United States'])).resolves.toStrictEqual([
-      {
-        address_elements: [
-          {
-            field: 'address1',
-            width: 'full',
-            editable: true,
-            max_length: 40,
-            required: true,
-            api_mappings: ['address1']
-          },
-          {
-            field: 'postalCode',
-            width: 'half',
-            editable: false,
-            max_length: 10,
-            required: false,
-            api_mappings: ['postalCode']
-          }
-        ],
-        postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-        verify_after_autocomplete: true,
-        wrap_address1_to_address2: false
-      }
-    ]);
-  });
-
-  test('getAddressForms camelcases returned field names', async () => {
-    mockPromiseResult.mockResolvedValueOnce([[
-      {
-        address_elements: addressFormFieldEntries,
-        postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-        verify_after_autocomplete: true,
-        wrap_address1_to_address2: false
-      }
-    ]]);
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    await expect(Stack.getAddressForms(['United States'], true)).resolves.toStrictEqual([
-      {
-        addressElements: [
-          {
-            field: 'address1',
-            width: 'full',
-            editable: true,
-            maxLength: 40,
-            required: true,
-            apiMappings: ['address1']
-          },
-          {
-            field: 'postalCode',
-            width: 'half',
-            editable: false,
-            maxLength: 10,
-            required: false,
-            apiMappings: ['postalCode']
-          }
-        ],
-        postalCodeRegex: '^[0-9]{5}(?:-[0-9]{4})?$',
-        verifyAfterAutocomplete: true,
-        wrapAddress1ToAddress2: false
-      }
-    ]);
-  });
-
-  test('getAddressForms returns an empty list when no forms are found', async () => {
-    mockPromiseResult.mockResolvedValueOnce([undefined]);
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    await expect(Stack.getAddressForms(['Unknown'])).resolves.toStrictEqual([]);
-  });
-
   test('getSingletonEntries maps language code in to id', async () => {
     mockSinglePromiseResult.mockResolvedValueOnce(singleCheckoutAdrStrings);
     const {getStack} = require('../src/api');
@@ -307,209 +152,4 @@ describe("ContentstackApi", () => {
     await Stack.getSingletonEntries({contentTypeUIDs: ['checkout_adr_strings'], language: 'in'});
     expect(mockSinglePromiseResult).toHaveBeenCalled();
   });
-
-  test('getShippingAddressForms maps nested address form fields', async () => {
-    mockPromiseResult.mockResolvedValueOnce([[
-      {
-        title: 'United States',
-        countries: [
-          {
-            countries: [
-              {
-                country_code: 'US',
-                country_name: 'United States'
-              },
-              {
-                country_code: 'CA',
-                country_name: 'Canada'
-              }
-            ]
-          }
-        ],
-        pre_address_fields: [addressFormFieldEntries[0]],
-        address_form: [
-          {
-            title: 'default',
-            address_elements: addressFormFieldEntries,
-            postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-            verify_after_autocomplete: true,
-            wrap_address1_to_address2: false
-          }
-        ],
-        post_address_fields: [addressFormFieldEntries[1]]
-      }
-    ]]);
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    await expect(Stack.getShippingAddressForms(['United States'])).resolves.toStrictEqual([
-      {
-        countries: [
-          {
-            code: 'US',
-            name: 'United States'
-          },
-          {
-            code: 'CA',
-            name: 'Canada'
-          }
-        ],
-        pre_address_fields: [
-          {
-            field: 'address1',
-            width: 'full',
-            editable: true,
-            max_length: 40,
-            required: true,
-            api_mappings: ['address1']
-          }
-        ],
-        address_form: {
-          address_elements: [
-            {
-              field: 'address1',
-              width: 'full',
-              editable: true,
-              max_length: 40,
-              required: true,
-              api_mappings: ['address1']
-            },
-            {
-              field: 'postalCode',
-              width: 'half',
-              editable: false,
-              max_length: 10,
-              required: false,
-              api_mappings: ['postalCode']
-            }
-          ],
-          postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-          verify_after_autocomplete: true,
-          wrap_address1_to_address2: false
-        },
-        post_address_fields: [
-          {
-            field: 'postalCode',
-            width: 'half',
-            editable: false,
-            max_length: 10,
-            required: false,
-            api_mappings: ['postalCode']
-          }
-        ]
-      }
-    ]);
-  });
-
-  test('getShippingAddressForms camelcases returned field names', async () => {
-    mockPromiseResult.mockResolvedValueOnce([[
-      {
-        title: 'United States',
-        countries: [
-          {
-            countries: [
-              {
-                country_code: 'US',
-                country_name: 'United States'
-              },
-              {
-                country_code: 'CA',
-                country_name: 'Canada'
-              }
-            ]
-          }
-        ],
-        pre_address_fields: [addressFormFieldEntries[0]],
-        address_form: [
-          {
-            title: 'default',
-            address_elements: addressFormFieldEntries,
-            postal_code_regex: '^[0-9]{5}(?:-[0-9]{4})?$',
-            verify_after_autocomplete: true,
-            wrap_address1_to_address2: false
-          }
-        ],
-        post_address_fields: [addressFormFieldEntries[1]]
-      }
-    ]]);
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    await expect(Stack.getShippingAddressForms(['United States'], true)).resolves.toStrictEqual([
-      {
-        countries: [
-          {
-            code: 'US',
-            name: 'United States'
-          },
-          {
-            code: 'CA',
-            name: 'Canada'
-          }
-        ],
-        preAddressFields: [
-          {
-            field: 'address1',
-            width: 'full',
-            editable: true,
-            maxLength: 40,
-            required: true,
-            apiMappings: ['address1']
-          }
-        ],
-        addressForm: {
-          addressElements: [
-            {
-              field: 'address1',
-              width: 'full',
-              editable: true,
-              maxLength: 40,
-              required: true,
-              apiMappings: ['address1']
-            },
-            {
-              field: 'postalCode',
-              width: 'half',
-              editable: false,
-              maxLength: 10,
-              required: false,
-              apiMappings: ['postalCode']
-            }
-          ],
-          postalCodeRegex: '^[0-9]{5}(?:-[0-9]{4})?$',
-          verifyAfterAutocomplete: true,
-          wrapAddress1ToAddress2: false
-        },
-        postAddressFields: [
-          {
-            field: 'postalCode',
-            width: 'half',
-            editable: false,
-            maxLength: 10,
-            required: false,
-            apiMappings: ['postalCode']
-          }
-        ]
-      }
-    ]);
-  });
-
-  test('getShippingAddressForms returns empty nested data when optional references are missing', async () => {
-    mockPromiseResult.mockResolvedValueOnce([[
-      {
-        countries: [],
-        pre_address_fields: undefined,
-        address_form: [],
-        post_address_fields: undefined
-      }
-    ]]);
-    const {getStack} = require('../src/api');
-    const Stack = getStack('dev');
-    await expect(Stack.getShippingAddressForms(['Unknown'])).resolves.toStrictEqual([
-      {
-        countries: [],
-        pre_address_fields: [],
-        address_form: undefined,
-        post_address_fields: []
-      }
-    ]);
-  });
 });

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.10](https://code.tls.nuskin.io/ns-am/utility/npm/contentstack-lib/compare/v2.1.0-pa-1117.9...v2.1.0-pa-1117.10) (2026-05-20)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuskin/contentstack-lib",
-  "version": "2.1.0-pa-1117.8",
+  "version": "2.1.0-pa-1117.10",
   "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

@@ -179,7 +179,7 @@ async function getSingletonEntries(options) {
  * @param {string[]} values
  * @return {Promise<{Object}>} config
  */
-const _getMultiEntries = async (contentType, includeRefs, values) => {
+const getMultiEntries = async (contentType, includeRefs, values) => {
   try {
     const [results] = await Stack
       .ContentType(contentType)
@@ -195,76 +195,10 @@ const _getMultiEntries = async (contentType, includeRefs, values) => {
   }
 }
 
-/**
- * Maps address form field entries into a small normalized dataset.
- * @param {Object[]} addressFormFields
- * @return {Object[]}
- * @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
-  }));
-
-  return camelcase ? _snakeObjectToCamel(mappedFields) : mappedFields;
-}
-
-const _extractAddressForm = (addressForm, camelcase = false) => {
-  if (!addressForm) {
-    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
-  };
-
-  return camelcase ? _snakeObjectToCamel(mappedForm) : mappedForm;
-}
-
-const _extractShippingCountries = (countries = []) => {
-  const shippingCountries = countries[0]?.countries ?? [];
-
-  return shippingCountries.map(({country_code, country_name}) => ({
-    code: country_code,
-    name: country_name
-  }));
-}
-
-const getShippingAddressForms = async (forms, camelcase = false) => {
-  const results = await _getMultiEntries(
-    'shipping_address_form',
-    ['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)
-  }));
-
-  return camelcase ? _snakeObjectToCamel(mappedResults) : mappedResults;
-}
-
-const getAddressForms = async (forms, camelcase = false) => {
-  const results = await _getMultiEntries('address_form', 'address_elements', forms);
-  const mappedResults = (results || []).map((result) => _extractAddressForm(result, camelcase));
-
-  return camelcase ? _snakeObjectToCamel(mappedResults) : mappedResults;
-}
-
 /**
  * Returns contentstack Stack object initialized with the api key, deliveryToken, and extended with custom functionality
  * @param {'dev' | 'test' | 'stage' | 'prod'} envrnmnt
- * @return {Object} Stack - contentstack Stack sdk object with additional getStrings function
+ * @return {Object} Stack - contentstack Stack sdk object with additional helper functions
  */
 function getStack(envrnmnt) {
   if (!envrnmnt) {
@@ -285,11 +219,7 @@ function getStack(envrnmnt) {
 
   // extend the Stack with a custom function to get translations
   Stack.getSingletonEntries = getSingletonEntries;
-  // extend the Stack with a custom function to get ShippingAddressForms
-  Stack.getAddressForms = getAddressForms;
-  // extend the Stack with a custom function to get ShippingAddressForms
-  Stack.getShippingAddressForms = getShippingAddressForms;
-  Stack.extractAddressFormFields = _extractAddressFormFields;
+  Stack.getMultiEntries = getMultiEntries;
 
   return Stack;
 }