With the release of version 1.12.0 of our JavaScript SDK, we are presenting a comprehensive further development that focuses on modern technologies, stable processes and a significantly improved user experience. This update is aimed at both developers who rely on robust, maintainable integration and users who benefit from precise and convenient address input.
Technological basis modernized
The entire toolchain of the SDK has been fundamentally renewed. The build pipeline is now based on Webpack 5 and is fully compatible with Node.js 20, eliminating all previous dependencies on legacy runtimes. This change not only ensures better performance, but also makes the code more future-proof and easier to maintain.
New architecture with a focus on stability
A central aim of the release was to avoid race conditions and unpredictable states. The SDK was therefore completely converted to async/await. A newly introduced process manager organizes all address checks in an orderly, conflict-free sequence. The central form handler and a coordinated submit process also ensure stable and consistent validation - even in more complex form structures.
Improved user guidance when entering addresses
Particular attention has been paid to interaction with the end user. Two new start modes ("edit" and "review") enable precise control of user guidance - either with direct input instructions or via modal dialogs. This is complemented by a significantly faster autocomplete function, which is cached on the client side and avoids redundant API calls.
In addition, address validation has been tightened up: an incorrect address can no longer be bypassed by simple navigation - it must be actively corrected or confirmed. This increases data quality and prevents incorrect orders or deliveries.
New functions and expansion options
With the update to 1.12.0, the SDK receives significant functional enhancements:
- The field
additionalInfois now supported throughout and also insplitStreetandaddressChecktaken into account. - Resolver functions have access to the complete subscriber context, which makes country-specific logic - for example for federal states or regions - much easier.
- Two new persistence hooks enable precise control of when address data should be processed before or after saving in the UI - ideal for synchronization with address books, for example.
- The new demo application based on Express.js makes it possible to use a single command (
npm run demo) to test various integration scenarios locally.
In addition, the code has been consolidated and improved in quality through common linting rules. New auxiliary functions such as updateDOMValue or hasSubscribedField support secure and efficient DOM manipulation.
Notes on Breaking Changes
Some adjustments require changes to existing integrations:
- The
initAMS-function has been restructured and now expects an object with field selectors instead of a prefix. - Obsolete fields such as
streetFullChunkhave been removed - corresponding references must be adapted. - The status display for invalid addresses has been revised so that fewer but more precise modals are used.
Further details can be found in the official release notes. Examples for the migration of existing projects will follow soon!
