Feat/points

.cursorrules

@@ -1,7 +1,25 @@
 # @dev Add cursor rules here. This goes in the LLM context window on every query when using cursor.
 
+## Random
+
+- never open SVG files, it crashes you. Only read jpeg, png, gif, or webp.
+- never run jq command, it crashes you.
+
+## Code quality
+
 - Use explicit imports where possible
 - Make a best effort to keep code quality high. Reuse existing components and functions, dont hardcode hacky solutions.
 - When making changes, ensure you're not breaking existing functionality, and if there's a risk, explicitly WARN about it.
 - If you notice an opportunity to refactor or improve existing code, mention it. DO NOT make any changes you were not explicitly told to do. Only mention the potential change to the user.
 - Performance is important. Cache where possible, make sure to not make unnecessary re-renders or data fetching.
+- Separate business logic from interface. This is important for readability, debugging and testability.
+
+## Testing
+
+- Where tests make sense, test new code. Especially with fast unit tests.
+- tests should live where the code they test is, not in a separate folder
+
+## Documentation
+
+- document major changes in docs.md/CHANGELOG.md
+- if you add any other documentation, the best place for it to live is usually docs/

.gitignore

@@ -5,6 +5,8 @@ docs/PR.md
 
 **.patch
 
+PR.md
+
 # dependencies
 /node_modules
 /.pnp

WARP.md

@@ -0,0 +1 @@
+.cursorrules

docs/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes should be documented in this file. Be concise.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- **Points System V2** with tier-based progression (0-4 Tier)
+- **QR Payment Perks** with tier-based eligibility and merchant promotions
+- Hold-to-claim interaction for perks with progressive screen shake animation
+- PWA haptic feedback that intensifies during perk claiming
+- Activity feed perk indicators with yellow star icons and strikethrough amounts
+- Transaction details "Peanut got you!" banner for claimed perks
+- Dev tools page (`/dev/shake-test`) for testing animations and haptics
+
+### Changed
+- QR payment flow now fetches payment locks in parallel with KYC checks for latency reduction
+- Perk claiming uses optimistic UI updates for instant feedback (claim happens in background)
+- Dev pages excluded from production builds for faster compile times
+- Removed Points V1 legacy fields from `Account` and `IUserProfile` interfaces
+
+### Fixed
+- BigInt type handling in points balance calculations (backend)
+- Perk status now correctly reflects `PENDING_CLAIM` vs `CLAIMED` states in activity feed
+- Modal focus outline artifacts on initial load
+- `crypto.randomUUID` polyfill for older Node.js environments in SSR

instrumentation.ts

@@ -1,5 +1,15 @@
 export async function register() {
     if (process.env.NEXT_RUNTIME === 'nodejs') {
+        // Polyfill crypto.randomUUID for Node.js SSR (required by DaimoPayProvider)
+        const nodeCrypto = await import('crypto')
+        if (!globalThis.crypto) {
+            // @ts-ignore - polyfill for SSR
+            globalThis.crypto = nodeCrypto.webcrypto
+        }
+        if (!globalThis.crypto.randomUUID) {
+            globalThis.crypto.randomUUID = nodeCrypto.randomUUID
+        }
+
         await import('./sentry.server.config')
     }