Product Quantity Feed — Create vs Update Differentiation

Latest Updates

Version 2.2.5 - April 16, 2026

Product Quantity Feed — Create vs Update Differentiation

What's Changed

• The product quantity feed job now separates newly created products from updated products, sending each with the correct webhook event type (create vs update)
• The x-fw-webhook-event header is now dynamic instead of hardcoded to update, enabling the Firework backend to handle create and update events differently
• Batch-sending logic extracted into a reusable sendBatches() function to eliminate code duplication
• Enhanced logging to report created and updated product counts separately
• Bumped cartridge version to v2.2.5

Details

Previously, all modified products detected within the 2-hour window were sent to Firework with a hardcoded update event. With this release, products with a creationDate within the window are now sent as create, while inventory/price/attribute changes continue as update. This allows the Firework backend to trigger different workflows for new product ingestion vs existing product updates.

Files Changed

• productquantityfeed.js — Split product collection into createProductDataObj and updateProductDataObj; extracted batch logic into sendBatches()
• jobInit.js — Made x-fw-webhook-event header dynamic via args.webhookEvent (defaults to update for backward compatibility)
• dashboard.properties — Version bump to v2.2.5

SFCC Multi-Currency Hydration

Latest Updates

Version 2.2.4 - March 06, 2026

Multi-Currency Hydration Support

This release adds multi-currency support to product hydration and improves locale handling across all Firework widgets.

New Features

• Multi-Currency Support: Added currency_code field to product and variant data in the product detail hydration endpoint, enabling proper currency display in Firework widgets.

Bug Fixes

• Fixed missing return statement in defaultVariants function when calling serializeVariants for products with variants.
• Fixed original_product_amount to use actual product price instead of hardcoded "9999" value.

Improvements

• Refactored ISML templates (storyBlock, carouselWidget, floatingPlayer, gridLayout) with proper CommonJS require() imports instead of direct dw.* references.
• Improved locale handling in widget templates — dynamically resolves current locale and updates product/cart URLs accordingly.
• Added null-safety for OAuth custom object access in widget templates.
• Moved Firework script tags outside the component figure element for cleaner HTML structure.

Token Refresh Fix

Latest Updates

Version 2.1.4 - February 18, 2026

Token Refresh Fix

This release addresses critical issues with the OAuth token refresh mechanism that were causing authentication failures in the scheduled refresh token job.

Bug Fixes

• Fixed JSON parsing errors that occurred when reading stored token data from custom objects
• Resolved double-stringified data issues where token data was being wrapped in quotes multiple times, causing parse failures
• Fixed data storage format - tokens are now stored as raw JSON strings to prevent serialization issues
• Fixed URL regex pattern that was failing to properly clean callback URLs when the ;site= parameter was not present
• Added validation checks to ensure both access_token and refresh_token are present before storing

Improvements

• Added comprehensive error handling throughout OAuth and Firework API scripts
• Standardized error response format with error flag and descriptive messages
• Added debug logging for OAuth callback URL processing and token data troubleshooting

Upgrade Notes

• No configuration changes required
• Existing OAuth connections will continue to work
• If tokens were previously corrupted, re-authentication via the OAuth flow may be needed

GTIN Support

What's Changed

• [CS-9709] Avoid Updating Metadata for Store by @ruturaj-kalal in #2
• [CS-10360] Parse BM url and Batch product update by @ruturaj-kalal in #3
• [CS-10269] SFCC GTIN Support by @ruturaj-kalal in #4

Full Changelog: v2.1.2...2.1.3

v2.1.2

Page Designer Enhancement

• Implemented pagination to fetch all Channels, Playlists and Videos on Page Designer component

v2.1.1

Version 2.1.1 - November 02, 2023

Custom Object Enhancements

• Custom object configure is updated, replication of custom object from staging to prod is disabled.

v2.1.0

Enhanced Widgets and Configuration

Widget Improvements

• Fixed a bug in the Page Designer widget to support the player placement attribute.
• Deprecated the Floating Button Widget.
• Fixed a bug related to Specific Video attachments on Storyblock and Floating Player.

Configuration Enhancements

• Added default locale values when locale is not set up in custom preferences.
• Added default values for imageViewTypes when view types are not configured in custom preferences.
• Now displaying the version number on the Setup and Configuration page.
• Product Hydration support medium, large, small viewTypes.