commerce-sdk - npm Package Versions

v4.1.0

Enchancements

• Support Node 22 #412

API Changes

Shopper Products

• The expand query parameter now includes a new argument, page_meta_tags

Shopper Search

• The expand query parameter now includes a new argument, page_meta_tags

Shopper Context

• X-Geolocation header was added to Shopper Context

CDN Zones API

• Endpoints added | Endpoint Name | Description | | ------------- |-----------------------------------| | getCodeUploadCertificates | Returns all the mTLS certificates for the account | | createCodeUploadCertificate | Set up two-factor mTLS certificates for the account and associate the staging zone code upload hostname | | getCodeUploadCertificate | Returns the mTLS certificate for the given account's mTLS certificate ID | | deleteCodeUploadCertificate | Successfully deleted the mTLS certificate from the account |

v4.0.0

:warning: Planned API Changes :warning:

Shopper Context

Starting July 31st 2024, all endpoints in the Shopper context API will require the siteId parameter for new customers. This field is marked as optional for backward compatibility and will be changed to mandatory tentatively by January 2025. You can read more about the planned change here in the notes section.

Shopper Login (SLAS)

SLAS will soon require new tenants to pass channel_id as an argument for retrieving guest access tokens. You can read more about the planned change here.

Please be aware that existing tenants are on a temporary allow list and will see no immediate disruption to service. We do ask that all users seek to adhere to the channel_id requirement before the end of August to enhance your security posture before the holiday peak season.

In practice, we recommend that customers using the SLAS helper functions upgrade to v4.0.0 of the commerce-sdk.

Enchancements

• Update SLAS helper function loginGuestUserPrivate to require channel_id and loginGuestUser to pass in channel_id to SLAS through clientConfig.parameters.siteId #406

API Changes

CDN Zones API

• Endpoints added | Endpoint Name | Description | | ------------- |-----------------------------------| | getOwaspWafPackage | Get a OWASP ModSecurity Core Rule Set. | | patchOwaspWafPackage | Patch a OWASP ModSecurity Core Rule Set. | | getWafManagedRulesInRuleset | Retrieves all rules in the specified WAFv2 managed ruleset. | | updateWafManagedRuleInRuleset | Updates a WAF managed rule in the specified WAFv2 managed ruleset. | | migrateZoneToWafV2 | Migrates a zone to WAFv2. Only applicable for existing zones using WAFv1. | | upsertOriginHeaderModification | Upsert origin header modification. | | getOriginHeaderModification | Get origin header modification associated with a zone. | | deleteOriginHeaderModification | Delete the origin header modification associated with a zone. |

• BREAKING: Removed deprecated endpoints

  • getFirewallRules
  • createFirewallRule
  • getFirewallRule
  • updateFirewallRule
  • deleteFirewallRule

  NOTE: As of February 6th, 2024, firewall rules are deprecated and customers can use eCDN custom rules moving forward.

v3.1.0

API Changes

Shopper Baskets

| Endpoint Name | Description | | ------------- |-----------------------------------| | updateItemsInBasket | Updates multiple items in a basket. |

v3.0.0

API Changes

Shopper Customers

• Removal of deprecated endpoints:
  • invalidateCustomerAuth
  • authorizeCustomer
  • authorizeTrustedSystem

Shopper Orders

| Endpoint Name | Description | | ------------- |-------------| | guestOrderLookup | Lookup a guest order |

Customers

| Endpoint Name | Description | | ------------- |-------------| | searchCustomerGroup | Search for customer groups in a given Site Id |

Coupons

| Endpoint Name | Description | | ------------- |-------------| | redeemCoupon | Redeems a coupon code for an existing coupon within the selected site. The coupon code must be redeemable. |

Enchancements

• Add helper function customApiHelper.callCustomEndpoint to call Custom APIs - #402

Other Changes

• Removal of deprecated helper function getShopperToken

v2.15.0

API Changes

• Update APIs for Shopper Search

• New Endpoints

  | Endpoint Name | Description | | ------------- |-----------------------------------| | getWafManagedRulesets | Retrieves WAFv2 managed rulesets. | | updateWafManagedRuleset | Updates WAFv2 managed ruleset. |

v2.14.0

• Shopper SEO API*

• New Endpoints

  | Endpoint Name | Description | | ------------- |-------------| | getUrlMapping | Gets URL mapping information for a URL that a shopper clicked or typed in. The mapping information is based on URL rules and redirects set up in Business Manager. For more information about prerequisites and sample usage, see URL Resolution. You can customize the behavior of this endpoint by using hooks. See the hooks for getUrlMapping in the Hook List.|

v2.13.0

Enchancements

• Add support for custom query parameters #396

v2.12.0

New APIs

• Shopper Experience has been added to the SDK.

v2.11.2

Bug fixes

• Mark expand query parameter for getProduct endpoint as optional instead of required

v2.11.1

Bug fixes

• Fix expand query parameter for shopper-products
• Remove retrieveCredQualityUserInfo endpoint from shopper-login as this functionality was removed from SLAS