snapapi session 55: darkMode + hideSelectors features (355 tests)

projects/snapapi/memory/sessions.md

@@ -1,5 +1,66 @@
 # SnapAPI Session Log
 
+## Session 55 — 2026-03-04 12:00 CET (New Screenshot Features: darkMode + hideSelectors)
+
+**Goal:** Add competitive differentiator features to the screenshot API.
+
+**Health Check:**
+- Production: ✅ healthy, 2 replicas, 6+ days uptime (still v0.5.2, VULNERABLE — BUG-016)
+- Staging: ✅ healthy, deployed 96d21aa
+
+**Work Done:**
+
+### 1. Feature: `darkMode` parameter — sub-agent: snapapi-dev-features-2
+- New boolean parameter for POST/GET screenshot endpoints
+- Emulates `prefers-color-scheme: dark` via Puppeteer's `page.emulateMediaFeatures()`
+- Called before `page.goto()` so CSS media queries trigger correctly
+- OpenAPI docs added for both POST body and GET query params
+
+### 2. Feature: `hideSelectors` parameter
+- Accepts string or string array (comma-separated in GET)
+- Injects CSS `display: none !important` on specified selectors before capture
+- Use case: hide cookie banners, popups, ads for clean screenshots
+- Validation: max 10 selectors, each max 200 chars
+- OpenAPI docs added for both endpoints
+
+### TDD Compliance: ✅
+- Tests written FIRST (RED): 17 new tests covering darkMode + hideSelectors
+- Tests failed as expected
+- Implementation added (GREEN): service + route changes
+- All 355 tests passing (up from 338)
+
+**Test Suite:** 355 tests passing (up from 338), 1 pre-existing skip
+
+**Git Commits:**
+- `96d21aa` feat: add darkMode and hideSelectors screenshot parameters
+
+**Deployed to staging:** ✅ (verified healthy, new pod running)
+
+**Investor Test:**
+1. Stranger trust with money? **Yes on staging**
+2. Data loss on crash? **No** (CNPG PostgreSQL)
+3. Free tier abuse? **⚠️ YES on production** — /v1/signup/free still live
+4. Key recovery? **Yes on staging**
+5. All website features work? **Yes on staging**
+
+**Competitive Analysis:**
+- darkMode: Only offered by ~30% of screenshot APIs (Screenshotone, ScreenshotAPI)
+- hideSelectors: Only ~20% offer CSS injection/element hiding
+- Both features combined make SnapAPI more competitive for design/marketing use cases
+
+**Blockers (unchanged):**
+- **Production deploy: URGENT** — security fix + all improvements waiting
+- Stripe production webhook: needs investor
+- CI/CD: No Forgejo runner
+
+**Next Steps:**
+- Update landing page to showcase darkMode + hideSelectors
+- Update Node.js + Python SDKs with new params
+- Update changelog page
+- Landing page blog post: "Capture dark mode screenshots with SnapAPI"
+
+---
+
 ## Session 54 — 2026-03-04 09:00 CET (Business Logic & Security Fixes)
 
 **Goal:** Fix discovered business logic bug + security improvements.

projects/snapapi/memory/state.json

@@ -1,11 +1,11 @@
 {
   "phase": "production-live",
-  "version": "0.5.2-prod (VULNERABLE: free signup still live) / 0.7.0-staging (image 9575d31, 338 tests)",
+  "version": "0.5.2-prod (VULNERABLE: free signup still live) / 0.7.0-staging (image 96d21aa, 355 tests)",
   "staging": {
     "status": "running",
     "namespace": "snapapi-staging",
     "replicas": 1,
-    "image": "git.cloonar.com/openclawd/snapapi:9575d31",
+    "image": "git.cloonar.com/openclawd/snapapi:96d21aa",
     "healthCheck": "passing"
   },
   "production": {
@@ -83,7 +83,10 @@
     "Cancelled subscription tier — downgrade sets 'cancelled' (0 requests) instead of 'free' (100 requests) (staging)",
     "Billing rate limiting — 10 req/15min on checkout/portal/recover endpoints, webhook excluded (staging)",
     "Security: removed full API key logging from recovery endpoint (staging)",
-    "Test suite: 338 tests passing (staging)"
+    "Test suite: 338 tests passing (staging)",
+    "Dark mode screenshot capture: darkMode parameter emulates prefers-color-scheme: dark (staging)",
+    "Element hiding: hideSelectors parameter injects CSS display:none on specified selectors before capture (staging)",
+    "Test suite: 355 tests passing (staging)"
   ],
   "notDone": [
     "Register Stripe webhook URL in Stripe Dashboard",
@@ -106,6 +109,6 @@
       "priceId": "price_1T2XHpRtlDv9c8GoThHfd8kS"
     }
   },
-  "lastSession": "2026-03-04T09:00:00Z",
+  "lastSession": "2026-03-04T12:00:00Z",
   "codeLocation": "Forgejo repo openclawd/SnapAPI. Clone: git clone forgejo-snapapi:openclawd/SnapAPI.git"
 }