Bloqr Compiler — Operations & Troubleshooting KB
Bloqr Compiler — Operations & Troubleshooting KB
This directory contains the Knowledge Base (KB) troubleshooting series for the bloqr-backend Cloudflare Worker and its supporting services.
Each article follows a consistent structure: symptom, diagnostic commands, root cause decision tree, and resolution summary.
Table of Contents
| Article | Title | Status |
|---|---|---|
| KB-001 | ”Getting API is not available” on the main page | ✅ Active |
| KB-002 | Hyperdrive binding connected but database service reports down | ✅ Active |
| KB-003 | Database Down After Deploy — Live Debugging Session (2026-03-25) | ✅ Active |
| KB-004 | Prisma WASM binary not found in Cloudflare Workers | ✅ Active |
| KB-005 | Better Auth Cloudflare integration — Worker CPU timeout & rate limiting | ✅ Active |
| KB-006 | D1 Authorization Error (7403) — API Token Missing D1:Edit Permission | ✅ Active |
| KB-007 | Production Debugging Session — Sign-up 500 / curl 403 / Migration Drift (2026-04) | ✅ Active |
| KB-008 | Prisma 7 + Cloudflare Workers: WebAssembly.Module() Disallowed by Embedder | ✅ Active |
Contributing
If you encounter a new failure mode not covered by an existing article, please open an issue tagged troubleshooting and documentation in jaypatrick/bloqr-compiler. Include:
- The symptom observed
- Any diagnostic output (curl responses, wrangler tail logs, etc.)
- The root cause if identified
- The fix applied
New KB articles should be named KB-NNN-short-description.md and added to the table above.