@namiml/web-sdk

# Nami Web SDK Changelog ## 1.7.7 **Release Date:** December 17, 2025 ### Bug Fixes - Ensure page-changed event escapes shadow DOM when CustomEvent polyfill is present ## 1.7.6 **Release Date:** December 16, 2025 ### Bug Fixes - Fix padding issues in toggle and list components - Fix gradient background issue ### New Features - Add radio and standard toggle button components ### Enhancements - Support disabled button properties ## 1.7.5 **Release Date:** November 19, 2025 ### Enhancements - Support using launch context custom attributes in flow analytics - Initial support for a progress indicator component ### Bug Fixes - Resolve an issue where a user's signed in state wasn't reflected on the paywall properly - Resolve an issue with content padding on certain components - Resolve an ssue where CMS settings for video player audio playback was not honored ## 1.7.4 **Release Date:** October 30, 2025 ### Bug Fixes - Fix an issue where if device registration failed, user was stuck in anonymous mode ### Enhancements - Support for legacy browsers ## 1.7.3 **Release Date:** October 13, 2025 ### Bug Fixes - Fix issue with hidden components not being hidden - Fix issue with deeplink handler - Fix issue preventing black bar and double scrolling in certain situations ### Enhancements - Swipe and animation improements - Support for custom carousel indicators - Add support for launch id to group flow transitions - Add support for disabled field on toggle switch - Add `NamiCampaignManager.isFlow` for checking if a placement is a flow or not ## 1.7.2 **Release Date:** September 17, 2025 ### Enhancements - Improve handling of device creation failures and latency - Add `disableCampaignUpdates` namiCommand - Add forced A/B testing via `splitPosition` namiCommand - Standardize `NamiPaywallManager.emitter` - Support smart variables derived from URL query parameters and related analytics ### Bug Fixes - Fix CTV scaling and spacing issues - Styling improvements ## 1.7.1 **Release Date:** September 3, 2025 ### Enhancements - Add `NamiFlowManager.pause` method - Add component animations (pulse/wave) ### Bug Fixes - Completed Flows will no longer call registered paywall close handlers ## 1.7.0 **Release Date:** August 27, 2025 ### Enhancements - Add new components (Form container, Toggle switch, Radio button) - Support Flow Smart Text Variables - Support Flow animations / transitions - Smart TV Back button support - Support for buy / select sku Flow handoffs ### Bug Fixes - QR Code component (scaling and non-hex colors) ## 1.6.4 **Release Date:** August 6, 2025 ### Enhancements - Improved directional navigation support for TV and custom Nami components - Pass launch context in flows for better paywall context handling ### Bug Fixes - Prevent scrolling on TV form factor (Content and Background containers) - Fix for handling unexpected SKU smart text variables ## 1.6.3 **Release Date:** July 29, 2025 ### Enhancements - Improved television layout scaling for various viewport sizes ## 1.6.2 **Release Date:** July 28, 2025 ### New Features - `Nami.sdkVersion` method to get the internal SDK version - Support for QR Code components - On Device Segment Selection for A/B testing - Support Base64, Gzipped Initial Configurations - Support Fully Uppercase Text Components ### Enhancements - Paywall actions will now trigger if no flow action for a button is defined ### Bug Fixes - Dynamic widths on Responsive Grid components ## 1.6.1 **Release Date:** July 13, 2025 ### Improvements - Fix type exports in declaration files ## 1.6.0 **Release Date:** July 10, 2025 ### New Features - Introduced `NamiFlowManager` for orchestrating multi-page flows - `NamiFlowManager.registerStepHandoff`: callback when a flow is handed off - `NamiFlowManager.registerEventHandler`: callback for flow analytics - `NamiFlowManager.resume`: resume a handed-off flow ### UI Enhancements - Default Focused Buttons - Blur Properties ### Accessibility - Screenreader support for videos - Screenreader hints added ### Performance - Better support handling multiple `Nami.configure` calls - General stability fixes ## 1.5.12 **Release Date:** July 30, 2025 ### Bug Fixes - Fix race condition when local storage fails ## 1.5.11 **Release Date:** June 18, 2025 ### Enhancements - Performance improvements for form factor lookups ### Bug Fixes - Fix uninterpolated smart text - Fix fallback to in-memory storage on localStorage write failures ## 1.5.10 **Release Date:** May 22, 2025 ### Enhancements - Support focused styling on buttons and toggle - Support tab key focus for collapsible component - Support alt tags on images ### Bug Fixes - Fix toggle switch not preserving state on re-render - Fix additional spacing in text list items - Fix issue with screenreader and collapsed content ## 1.5.9 **Release Date:** April 2, 2025 ### Bug Fixes - Resolve incorrect downscaling on 720p TV devices ## 1.5.8 **Release Date:** April 1, 2025 ### Bug Fixes - Resolve issue where toggle component event was firing twice - Fix toggle switch state re-rendering due to parent page - Remove additional unintended spacing ## 1.5.7 **Release Date:** February 20, 2025 ### Bug Fixes - Resolve additional type issue encountered with certain initial config files ## 1.5.6 **Release Date:** February 19, 2025 ### Bug Fixes - Resolve type issue encountered with certain initial config files ## 1.5.5 **Release Date:** January 16, 2025 ### Enhancements - Add optional `purchaseChannel` to `NamiConfiguration` to pass through to `NamiPaywallEvent` analytics ## 1.5.4 **Release Date:** November 29, 2024 ### Bug Fixes - Resolve issue with TV focus on containers and product buttons on first load ## 1.5.3 **Release Date:** November 21, 2024 ### Bug Fixes - Fix collapse component caret icon not updating when expanded ### Enhancements - Support scaling on TV devices (720p, 1080p, 4K, and 8K) ## 1.5.2 **Release Date:** October 24, 2024 ### Bug Fixes - Fix wrong campaign rule used for placement labels - Fix initial config campaign rule mapping - Fix background video fullscreen on mobile - Fix focus events on connected TV - Fix login/logout state handling - Fix display of free trials and promotional offers - Fix multiple UI issues in carousel and stack components ## 1.5.1 **Release Date:** October 2, 2024 ### Enhancements - Add `TOGGLE_CHANGE` and `PAGE_CHANGE` paywall events ### Bug Fixes - Fix carousel component swiper - Fix flex alignment issues - Fix Safari rendering for hero video ## 1.5.0 **Release Date:** September 26, 2024 ### New Features - Advanced video feature support - Carousel component support ### Enhancements - Improve fallback data handling - Support repeatable lists inside collapse components - Support vertical alignment in product container - Align `removeAllListeners` behavior with RN SDK ### Bug Fixes - Fix segment picker cursor behavior - Fix hidden component visibility - Fix responsive grid spacing and scrolling - Fix background video gradient and position ## 1.4.0 **Release Date:** September 5, 2024 ### New Features - HLS support in Video component - Responsive Grid component support - `NamiCustomerManager.deviceId` added - `NamiCustomerManager.registerJourneyStateHandler` and `journeyState` (subscription management) - `NamiEntitlementManager.clearProvisionalEntitlementGrants` (subscription management) ### Enhancements - Pass product groups to paywall via campaign launch ### Bug Fixes - Find product by ID instead of name - Fix spacing in text component ### Improvements - Update type definitions across paywall manager and customer manager APIs ## 1.3.2 **Release Date:** August 14, 2024 ### Bug Fixes - Conditional component rendering based on product entitlement and product groups ## 1.3.1 **Release Date:** August 12, 2024 ### Bug Fixes - Fix `SHOW_PAYWALL` event being triggered as `UNKNOWN` ## 1.3.0 **Release Date:** August 12, 2024 ### New Features - `NamiEntitlementManager` to manage entitlements - `active`, `isEntitlementActive`, `refresh`, `registerActiveEntitlementsHandler` - `NamiEntitlement` object model - Hidden component support - New components: Video and collapsible - Timeout and error handling improvements ### Bug Fixes - Typing improvements across SDKs - ECMAScript 2021 support ### Breaking Changes - `appPlatformId` renamed to `appPlatformID` in `NamiConfiguration` - `NamiPaywallManager.buySkuComplete` interface simplified ## 1.2.0 **Release Date:** July 26, 2024 ### New Features - `NamiCampaignManager.launch`: supports `paywallLaunchContext` - `NamiPaywallManager.buySKUCancel` and `buySKUComplete` - Paywall impression and conversion reporting - Faster paywall render time ### Bug Fixes - Consistent typing and API alignment across SDKs ## 1.1.0 **Release Date:** June 24, 2024 ### New Features - `NamiCustomerManager.setAnonymousMode` - `NamiCampaignManager.launch` with `paywallActionHandler` - `NamiPaywallManager.registerBuySkuHandler` ### Bug Fixes - Lit component compatibility and SSR fixes - Subscription pricing rendering fixes - Custom API host connectivity fixes - Icon display improvements ### Known Issues - `buySkuComplete`, `buySkuCancel` not fully implemented - Impression/conversion reporting and launch context not implemented ## 1.0.0 **Release Date:** June 13, 2024 ### New Features - Core SDK: `Nami`, `Nami.configure`, `NamiConfiguration`, `NamiLanguageCodes` - `NamiCampaignManager` for campaign management - `NamiCustomerManager` for customer state and attributes - `NamiPaywallManager` for paywall and event handler management ### Known Issues - Paywall event callbacks not firing - `buySkuComplete`, `buySkuCancel`, and `setAnonymousMode` partially implemented - Impression/conversion reporting and launch context not yet available ### Additional Notes Refer to the documentation for detailed usage instructions and integration examples.