ofw-mcp 2.3.2 → 2.4.1

package/dist/validate.js

@@ -0,0 +1,35 @@
+/**
+ * Validate an OFW API response against a zod schema at the call site.
+ *
+ * Every OFW endpoint is reverse-engineered and undocumented, so a backend
+ * change on their side would otherwise flow `undefined` silently into the
+ * SQLite cache and persist (issue #83). Schemas are `.looseObject(...)`
+ * covering ONLY the fields the code actually reads — cosmetic API additions
+ * pass through untouched (and stay present in the parsed output, which
+ * matters for `listData`/`metadata` blobs cached verbatim).
+ *
+ * Two modes, chosen per call site:
+ *  - `'lenient'` (default) — read/sync paths. On mismatch, log a structured
+ *    warning to stderr naming the endpoint and fields, then return the RAW
+ *    response unchanged so the existing `??` fallbacks keep the tool useful.
+ *  - `'strict'` — write paths (send/save_draft verification, upload). On
+ *    mismatch, throw: proceeding on an unverifiable response risks deleting
+ *    a draft, mis-reporting a send, or caching an unusable fileId.
+ *
+ * The error/warning text is deliberately precise ("date.dateTime: expected
+ * string…") — it's the failure signal a maintainer (human or Claude) fixes
+ * in one session, vs. "some messages show the wrong date sometimes".
+ */
+export function parseOFW(schema, raw, ctx, mode = 'lenient') {
+    const result = schema.safeParse(raw);
+    if (result.success)
+        return result.data;
+    const issues = result.error.issues
+        .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)
+        .join('; ');
+    const message = `OFW response for ${ctx} failed validation: ${issues}`;
+    if (mode === 'strict')
+        throw new Error(message);
+    console.error(`[ofw-mcp] WARNING: ${message} — continuing with the raw response; fields derived from it may be missing or wrong.`);
+    return raw;
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "ofw-mcp",
-  "version": "2.3.2",
+  "version": "2.4.1",
+  "license": "MIT",
   "mcpName": "io.github.chrischall/ofw-mcp",
   "description": "OurFamilyWizard MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -9,6 +10,9 @@
     "url": "git+https://github.com/chrischall/ofw-mcp.git"
   },
   "type": "module",
+  "engines": {
+    "node": ">=22.5.0"
+  },
   "bin": {
     "ofw-mcp": "dist/index.js"
   },

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/ofw-mcp",
     "source": "github"
   },
-  "version": "2.3.2",
+  "version": "2.4.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ofw-mcp",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },
@@ -28,6 +28,12 @@
           "isRequired": false,
           "format": "string",
           "isSecret": true
+        },
+        {
+          "name": "OFW_WRITE_MODE",
+          "description": "Write-tool gate: \"none\" registers no write tools; \"drafts\" registers draft-level writes only (save/delete drafts, upload attachments); \"all\" registers everything (default). Unrecognized values fail closed to \"none\".",
+          "isRequired": false,
+          "format": "string"
         }
       ]
     }