Birthday Rewards, Deep Widget Linking, & Stability Refinements

​

What’s New in v2.278.9

​

🎂 Birthday Rewards: Celebrate Member Milestones

• Birthday configuration dashboard — Admins define birthday reward amounts (points/coins), eligibility rules (tenure, tier), and distribution timing (day-of or advance notice)
• Automatic birthday detection — System tracks member birthdays from signup profiles and securely issues rewards without manual intervention
• Scheduled distribution — Birthdays are queued as rewards events, respecting timezone settings, with full audit trails and completion tracking
• Recipient controls — Members can opt in/out of birthday rewards; admins see distribution status and can retry failed deliveries
• Shopify integration — Birthday config is synced to Shopify admin, allowing merchants to manage birthday rewards from their store without leaving their workflow

• Community managers — Celebrate members with automatic birthday gifts; deepens engagement and retention
• Platform admins — Birthday rewards are fully configurable per community, with timezone support and compliance logging
• Enterprise customers — Birthday reward distribution integrates with existing referral reward system; no breaking changes

​

🔗 Widget Deep Linking: Direct to Where Users Want to Go

• Direct page routing — Links like /embed?page=ways-to-earn or /embed?page=account jump users directly to that section instead of the dashboard home
• Consistent initialization — Deep links work whether the widget is loading for the first time or already cached; full async state handling
• Campaign & email integration — Link directly to your rewards catalog from marketing emails, loyalty program CTAs, or in-store signage
• Performance boost — Loyalty hub now pre-fetches critical sections in parallel, reducing perceived load time by ~30-40%
• Cross-domain support — Deep links work when embedding the widget on multiple subdomains or partner sites

• Merchants — Drive traffic directly to specific loyalty sections (redeem rewards, view ways to earn) from marketing campaigns
• End users — Seamless experience clicking links and landing exactly where emails promised
• Performance-conscious deployments — 30-40% faster initial hub load through optimized data fetching

​

📱 Mobile & Desktop Experience Refinements

• Mobile sign-in drawer stays put — When users open the keyboard to sign in on mobile, the sign-in drawer no longer expands, covering the input field
• Search & input focus locked — Admin search fields and text inputs no longer lose focus when users type; no more re-opening dropdowns mid-keystroke
• Challenge creation modal fixed — The “choose creation method” modal now appears reliably when starting a new challenge (was intermittently skipped)
• Admin upload UI polished — Challenge image upload section no longer has visual overflow or gap issues; icons and buttons align properly
• Game responsiveness — Catch game falling items now scale correctly on all screen sizes (was breaking on mobile)

• Mobile users — Smoother sign-in and challenge participation flows
• Community managers — Admin dashboard feels more responsive; no focus-loss frustration when searching or filtering
• Game players — Mobile games render correctly without layout shifts

​

Detailed Changes

• Birthday rewards card — New community settings tab to configure birthday reward amounts, eligibility rules, and distribution timing
• Birthday-triggered distribution — Automated queue-based processing; system securely issues rewards on member birthdays
• Timezone-aware scheduling — Birthday rewards respect organization timezone settings; no manual timezone management needed
• Distribution audit trail — View sent, pending, and failed birthday reward deliveries per member
• Retry mechanism — One-click retry for failed birthday distributions; track completion status in real-time
• Shopify sync — Birthday config automatically syncs to Shopify admin for merchant visibility and control

• Search & filter stability — Text inputs no longer lose focus during typing; admin search works smoothly without re-opening dropdowns
• Challenge creation flow — “Choose creation method” modal now appears reliably; no more skipped steps
• Upload UI polish — Challenge image upload section renders correctly; icon overflow and gap issues resolved
• Game config accuracy — Game text search matches saved values, not defaults; game previews show actual error messages
• Admin load optimization — Parallel data fetching on dashboard; 50-100ms faster page loads

• Birthday gifts await — Members receive surprise birthday rewards automatically; opt-in/opt-out controls available in account settings
• Direct widget navigation — Loyalty widget now supports deep links to specific pages (rewards, ways to earn, account) from emails or menus

• Mobile sign-in works smoothly — Sign-in drawer stays in place when opening the keyboard; easier to enter credentials on mobile
• Responsive game play — Catch game and other interactive games now render correctly on all screen sizes; no layout shifts or clipped content
• Smooth admin workflows — Faster page loads and responsive interactions across dashboard, challenges, and user management

​

Technical Details

​

Birthday Reward Distribution System

• Birthday Config Service (packages/services/birthday-reward) — Manages configuration, validation, and state transitions
• Birthday Write-back Handler — Idempotent helper ensuring single-pass delivery even with retries
• Distribution Queue — Async queue (QueueNameEnum.BirthdayRewardTrigger) for scheduled birthday processing
• Admin tRPC Endpoints — update-birthday-config, assign-birthday-distribution, get-birthday-config, sync-birthday-cron
• Shopify Integration — api.birthday-config route syncs config to Shopify admin; api.quick-actions-save updated to handle birthday rewards

• Timezone support — Birthday rewards issued at midnight in the organization’s configured timezone
• Eligibility rules — Configurable tenure thresholds and member tier filters
• Audit trail — Full logging of distribution attempts, retries, and completions
• Compliance — GDPR-compliant birthday data handling; members can delete or opt out

• 427+ unit tests covering distribution logic, config validation, edge cases (leap years, timezone transitions)
• 438+ integration tests for tRPC endpoints and API workflows

​

Widget Deep Linking & Loyalty Hub Performance

• Deep link parameter parsing — Embed script now accepts page query param; routes to specific sections
• Loyalty hub pre-fetching — Parallel data loading for account, ways-to-earn, and rewards sections; ~30-40% faster perceived load time
• Async state handling — Deep links work whether widget is initializing or already cached; graceful fallback to home on invalid pages
• Cross-domain support — Deep links work with multiple widget instances on different subdomains
• Embed script enhancement — Updated nudj-loyalty-account.js and nudj-ways-to-earn.js to support deep link resolution

​

Mobile & UI Stability Fixes

• Removed keyboard event listener that was expanding drawer height
• Fixed height now respects viewport constraints
• Sign-in flow no longer interrupted by keyboard repositioning

• Root cause: Form state reset on every keystroke triggering re-render
• Fix: Memoized input component with stable callbacks
• Impact: Dropdowns stay open, focus preserved during multi-character searches

• Modal trigger state now derived from existing game config data
• Prevents modal from being skipped in creation flow
• Proper state synchronization between form steps

• Fixed CSS overflow on challenge image upload section
• Added missing gaps between icon and label
• Proper alignment of button and preview components

• Catch game falling items now scale relative to viewport width/height
• Removed hardcoded pixel values; added responsive calculations
• Mobile, tablet, and desktop all render correctly

​

Database & Infrastructure Improvements

• gdpr_requests migration now idempotent; safe to re-run without side effects
• Sparse unique index fixed; respects shard key requirements
• Full compliance audit in docs/analysis/birthday-reward-feature-analysis.md

• notification_logs unique index now includes shard key prefix (location, organisationId)
• Proper MongoDB sharding compliance; no more sparse index issues

• Cache invalidation now triggered on pipeline domain updates
• Prevents stale config from being served after DNS changes

• organisations collection now included in daily parquet drop export
• Better data warehouse alignment for reporting and analytics

​

Logging & Observability Overhaul

• Replaced Pino logger with Logtail across all Node.js services
• Standardized logger argument order: log.info("message", { context }) everywhere
• Auto-trace correlation: all logs tagged with trace_id / span_id from active OTel span
• Shopify app structured logging now wired to BetterStack (NUDJ-5482)

• Unified log sink across API, admin, user, MCP, and Shopify apps
• Request-scoped trace context automatically attached to all logs
• Better debugging: follow request → see all logs from that request across layers
• Zero configuration: works automatically once OTel span is active

​

Platform Stability & Build Improvements

• Migrated to next build --turbo for faster production builds
• Removed obsolete check-build-config rule; functionality now in Turbopack
• ~30% faster CI build times

• Resolved all Biome lint warnings in admin and MCP packages
• Better type safety; no more suppressions or workarounds

• Guard added for undefined action.hints in participation validation
• Prevents crashes when action validation encounters malformed hints

• Repeatability toggle state now derived from existing game config data
• Prevents silent data loss when editing game repeatability settings

​

Playwright & Testing

• Bumped @playwright/test to ^1.59.1 with latest browser engines
• Better mobile device emulation; improved E2E test reliability

​

Breaking Changes

​

Migration Guide

# Standard deployment
vercel deploy

# Or if using Docker
docker pull nudj:v2.278.9
docker run nudj:v2.278.9

​

Related Features

• Birthday Reward Configuration Guide — Set up and manage birthday rewards for your community
• Widget Deep Linking — Embed direct links to loyalty pages in marketing campaigns
• Loyalty Hub Performance Tuning — Optimize widget load times for large merchant catalogs
• GDPR Compliance & Birthday Data — Birthday data handling and member privacy controls
• Timezone Configuration — Ensure birthday rewards issue at the correct local time

​

Contributors

​

Release Stats