Release v2.378.20

​

🔴 Massive Release v2.378.20

​

What’s New

• Wallet Performance Boost — User wallet page now loads 30% faster by eliminating blocking pre-checks and reducing unnecessary API calls
• Admin Landing Page Stability — Fixed critical 500 error and org-selection flow errors that prevented admin access
• Shopify Game Toggle Persistence — “Ways to Earn” game preferences now persist across page reloads for stable loyalty campaign configuration
• Rewards Data Integrity — Admin panel now enforces integer pricing and prevents fractional supply values, eliminating invalid reward configurations
• Game Asset Quality Control — Sprite upload validation prevents transparent background assets, ensuring crisp game ball and hoop rendering
• Analytics Privacy Enhancements — Improved consent handling with OneTrust integration and new kill-switch controls for cookie banners and telemetry
• Event Processing Resilience — Added timeout protection to webhook and event handlers to prevent stuck requests from blocking service processing

​

Apps Updated

​

Detailed Changes

​

Admin Highlights

• Integer Reward Pricing – Rewards now require whole-number prices, preventing decimal values that cause rounding confusion in customer communications
• Fractional Supply Blocking – Supply quantities must be integers, eliminating partial-unit inventory edge cases
• Game Sprite Transparency Validation – Ball and hoop asset uploads are now validated to reject transparent backgrounds, ensuring crisp game rendering
• Admin Dashboard Stability – Landing page 500 errors fixed with improved error boundaries and org-selection flow handling
• Emergency Analytics Kill Switch – Kill switches added for cookie banner and telemetry, giving admins temporary control during privacy compliance reviews

​

User Highlights

• Faster Wallet Loading – Wallet page loads 30% faster with eliminated blocking checks and optimized carousel rendering
• Game Theme Consistency – Game completion screens now properly inherit community theming for a seamless visual experience
• Loyalty Game Persistence – “Ways to Earn” game preferences stay enabled/disabled across page reloads, maintaining your campaign configuration
• Better Privacy Controls – Analytics gating now works reliably with OneTrust consent managers, respecting user privacy choices

​

Breaking Changes

​

Technical Notes

• Wallet page eliminated blocking pre-check phase that was delaying initial render
• Carousel components now apply item-count caps, reducing re-render overhead on large datasets
• Removed 86 lines of unnecessary fetch logic while preserving feature parity

• Reward model now uses Zod schema to enforce integer validation at the DTO boundary
• Supply and price fields are non-nullable integers with explicit parse errors for decimal input
• Admin form step-validation prevents form submission on invalid data

• Webhook handler and event service both now use Promise.race with timeout-promise, catching hangs within 30 seconds
• Admin landing page now renders a default community redirect component with fallback UI for edge cases
• OneTrust integration moved to server-side context instead of client-side DOM sniff, eliminating race conditions

• Analytics consent now gates on OneTrustContext.ready() before firing any PostHog/Google Analytics events
• New analyticsKillSwitch env flag allows admins to silence all telemetry collection server-side without requiring SDK config changes
• MCP Server instance detection improved to respect kill switches on customer-facing apps

​

Usage Examples

// Creating a zero-cost giveaway entry (API v2)
POST /api/v2/admin/challenges/{challengeId}/giveaway-entries
{
  "cost": 0,
  "userId": "user-123",
  "quantity": 1
}
// Previously: would fail if user balance was below a threshold
// Now: succeeds regardless of balance, enabling true free promotions

​

Related Features

• Reward Management — Create and configure rewards with validated pricing
• Games & Challenges — Build gamified campaigns using game completion screens
• Ways to Earn — Shopify loyalty section integration
• Analytics & Privacy — First-party consent and telemetry controls
• Webhook Events — Event delivery reliability guarantees

​

Contributors

@erek_d5 commits • +1,395/-394 lines

@jamescockayne4 commits • +1,461/-126 lines

@solicshop4 commits • +1,221/-132 lines

@dch4 commits • +145/-98 lines

@ZuhayrK003 commits • +437/-267 lines

​

Release Stats