@karedo-hq/agents 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karedo-hq/agents",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Centralized agent skills, rules, and commands for our engineering team",
   "type": "module",
   "bin": {

package/rules/web/data-fetching-and-server-actions.mdc

@@ -28,24 +28,39 @@ alwaysApply: false
 
 ### Error Handling
 
-Use `parseApiResponse` from `@/lib/utils/parse-api-response` to safely parse API responses. This handles HTML error pages from proxies/load balancers gracefully (prevents cryptic "Unexpected token '<'" errors in production).
+- API errors (`!res.ok`): use `resJSON.message` directly
+- Catch block: use `getErrorMessage(error)` from `@/lib/utils/get-error-message`
+- Never use `getErrorMessage()` on strings (causes double-quoting)
+
+### Safe JSON Parsing
+
+Always use `safeJson()` from `@/lib/utils/safe-json` instead of raw `.json()`:
 
 ```typescript
-const { data, errorMessage } = await parseApiResponse<ResponseType>(
-  response,
-  'Fallback error message',
-);
+import { safeJson, SERVER_UNAVAILABLE_MESSAGE } from "@/lib/utils/safe-json";
+
+// Error path
+if (!res.ok) {
+  const errorResult = await safeJson<{ message?: string }>(res);
+  const errorMessage = errorResult.isSuccess
+    ? errorResult.data.message || "Fallback message"
+    : SERVER_UNAVAILABLE_MESSAGE;
+  return { isSuccess: false, isError: true, errorMessage };
+}
 
-if (errorMessage) {
+// Success path
+const result = await safeJson<ExpectedType>(res);
+if (!result.isSuccess) {
   return {
     isSuccess: false,
     isError: true,
-    errorMessage,
+    errorMessage: SERVER_UNAVAILABLE_MESSAGE,
   };
 }
+const data = result.data;
 ```
 
-**Catch block:** Use `getErrorMessage(error)` from `@/lib/utils/get-error-message`. Never use `getErrorMessage()` on strings (causes double-quoting).
+**Why:** When infrastructure (load balancers, CDN) returns HTML error pages (502, 503), raw `.json()` throws cryptic "Unexpected token '<'" errors. `safeJson()` handles this gracefully with user-friendly German messages.
 
 ### Fetch Headers