Skip to main content

​
🔴 Massive Release v2.473.4

⭐⭐⭐ Complex • 8 commits • 114 files changed
This release brings critical improvements to widget reliability for merchants using identity authentication, powerful new bulk-editing tools for game configuration, and expanded theming controls for community customization. Enterprise customers using JWT-based identity verification now see dramatically improved widget stability, while community managers gain fine-grained control over card appearance and can efficiently manage game text across multiple languages or versions.

​
What’s New

  • Widget JWT Authentication Resilience – Merchants using identity JWT authentication now get graceful recovery when tokens expire or fail verification instead of a blank widget
  • Game Text Bulk Import/Export – Download, edit offline, and upload game configuration text as JSON with field-by-field diff preview before applying changes
  • Custom Bordered Card Border Width – Fine-tune the visual weight of bordered cards with precision control from 0–48px border width
  • Admin Preview Loading States – Clear loading indicators when switching between Widget and Hub preview modes in the admin dashboard
  • Community Identity Privacy – Internal community identity information now hidden from user-facing detail surfaces

​
Apps Updated

User App

✓ Updated - Widget JWT recovery, theme customization, identity privacy

API

✓ Updated - Schema updates for bordered card width, game text handling

Admin

✓ Updated - Game text import/export UI, loading indicators, theme controls

MCP Server

— No changes

Games

— No changes

​
Detailed Changes

  • Widget JWT Recovery (NJ-1908) – When an identity JWT fails verification, the widget automatically requests a fresh token (if a callback is configured) and retries. If that fails, it gracefully falls back to sign-in or guest mode instead of disappearing. Includes secure context warnings for non-HTTPS pages.
  • Community Identity Privacy (WS-611) – Internal community identity data is no longer exposed in user-facing surfaces like post details and branding layouts
  • Custom Bordered Card Width – Theme CSS generation now supports variable border widths for bordered cards (0–48px), with proper CSS variable resolution
  • Theme Provider Enhancements – Updated both community and organisation theme providers to handle the new bordered card border width property
  • Theme Schema Extensions – Added borderedCardBorderWidth field (0–48, nullable) to both community and organisation theme schemas
  • Admin API Schema Updates – Updated admin schema to expose bordered card border width in theming configuration endpoints
  • Integration API Schema Updates – Updated integration schema to support the new bordered card customization
  • Theme DTO Models – Updated ThemeDTO models to include the bordered card border width property with validation
  • Game Text Validation – New helpers and validators for JSON import/export round-trip validation and field consistency checks
  • Game Text JSON Import/Export (NJ-1871) – New bulk edit UI allowing admins to download all game configuration text as JSON, edit offline, and upload with a field-by-field diff preview. Comprehensive test coverage with 800+ test cases validates round-trip fidelity and error handling.
  • JSON Diff Preview Component – Visual comparison showing old vs. new values for each field being updated, with safety-gated confirmation before applying
  • Custom Bordered Card Border Width (WS-614) – New bordered card border width control in the Card Styling section of Branding & Appearance settings. Admins can set precise widths from 0–48px to match their visual design
  • Admin Preview Loading Indicator (NJ-1910) – Loading states now display when switching between Widget and Hub preview modes instead of a frozen UI
  • Theme Settings Updates – Schema updates support the new card border width configuration

​
Admin Highlights

  • Game Text JSON Import/Export – Download all game configuration text as JSON, edit offline with translation tools or spreadsheets, preview field-by-field changes before applying
  • Custom Bordered Card Border Width – Set precise border widths (0–48px) for bordered card styles to match your visual design language
  • Bulk Content Updates – Batch-update game text across all questions, answers, and descriptions with automatic field mapping and conflict detection
  • Admin Preview Loading Feedback – Clear loading indicators when switching preview modes provide immediate visual feedback

​
User Highlights

  • Improved Widget Stability – Merchants using identity JWT authentication can now rotate and refresh tokens without the widget disappearing
  • Seamless Token Rotation – Fresh JWT callbacks are automatically requested and retried on token failure, with intelligent fallback handling
  • HTTPS Security Guidance – Clear console warnings help developers troubleshoot authentication issues faster
  • Privacy Improvements – Community identity information hidden from user-facing surfaces

​
Technical Notes

​
Widget JWT Recovery Protocol (NJ-1908)

The embed.js script implements a two-stage JWT recovery mechanism:
  1. Stage 1: Callback-based refresh – If userJwt is a function, invoke it to obtain a fresh token and retry. If the fresh token is identical, skip the retry.
  2. Stage 2: Fallback to no-JWT mode – If Stage 1 fails or userJwt was a static string, re-request without a JWT. Server responds with guest mode or sign-in drawer.
  3. Security – Session cookies require HTTPS; console warnings alert developers when embedding on insecure pages.

​
Game Text JSON Schema

Game text export produces a flat JSON structure with all configurable strings, ensuring round-trip fidelity through comprehensive field validation and diff-aware comparison.

​
Bordered Card Border Width

The theming system validates the border width value (0–48 pixels, nullable) during schema resolution and generates corresponding CSS applied to all bordered cards in the widget.

​
Database Changes

  • Added borderedCardBorderWidth field to community and organisation theme schemas
  • Updated DTOs to support the new border width property with validation
  • Migration included to populate existing themed communities with default values

​
Contributors

dch@wenudj.comdch@wenudj.com4 commits • +4127/-314 lines • 102 files
solicshop@gmail.comsolicshop@gmail.com2 commits • +2359/-34 lines • 11 files
HienHHienH1 commit • +18/-4 lines • 1 file

​
Release Stats

v2.473.4 deployed on August 7, 2026