@kbzowski/mcp-inbox 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -327,6 +327,27 @@ If your password contains `$`, `` ` ``, `!`, or a backslash, put it in an env fi
327
327
 
328
328
  The first `npx -y @kbzowski/mcp-inbox` invocation downloads the package. Subsequent runs are cached. If it looks hung on first boot, check your network.
329
329
 
330
+ ### "mcp-inbox requires Node.js 24 or later"
331
+
332
+ The server requires Node 24 because `node:sqlite` (the built-in SQLite module it uses) gained its full API in Node 24. If you see this message the binary ran under an older Node.
333
+
334
+ **proto users** — proto resolves the Node version from the nearest `.prototools` file. When a client (Claude Desktop, Cursor, etc.) runs `npx @kbzowski/mcp-inbox` or `pnpx @kbzowski/mcp-inbox`, the working directory is the client's process directory, not your project. If you have no global default set, proto may fall back to an older version. Fix:
335
+
336
+ ```bash
337
+ # one-time — sets Node 24 as the global proto default
338
+ proto pin node 24 --global
339
+ ```
340
+
341
+ Or add a line to `~/.prototools`:
342
+
343
+ ```toml
344
+ node = "24"
345
+ ```
346
+
347
+ After that, `node --version` in any directory should print `v24.x`.
348
+
349
+ **nvm / fnm / volta users** — same idea: make sure the global default is Node 24 (`nvm alias default 24`, `fnm default 24`, or Volta's `package.json` `volta.node` field).
350
+
330
351
  ### Verify the connection manually
331
352
 
332
353
  From any shell, set the env vars and run:
package/dist/index.js CHANGED
@@ -25,5 +25,17 @@ process.on("warning", (w) => {
25
25
  });
26
26
 
27
27
  // src/index.ts
28
+ var [nodeMajor] = process.versions.node.split(".").map(Number);
29
+ if (nodeMajor < 24) {
30
+ process.stderr.write(
31
+ `mcp-inbox requires Node.js 24 or later (running ${process.version}).
32
+ \u2022 npx users: npx is usually fine \u2014 check 'node --version' first.
33
+ \u2022 proto users: run 'proto pin node 24 --global' once to set the global default.
34
+ \u2022 pnpm dlx / pnpx: if proto shims resolve to an older version outside your
35
+ project directory, set a global default or use 'npx -y @kbzowski/mcp-inbox'.
36
+ `
37
+ );
38
+ process.exit(1);
39
+ }
28
40
  await import("./app.js");
29
41
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/utils/suppress-sqlite-warning.ts", "../src/index.ts"],
4
- "sourcesContent": ["// Side-effect-only module. Must be imported before anything that touches\n// `node:sqlite` (directly or via drizzle-orm/node-sqlite). ESM evaluates\n// imports depth-first, so importing this first guarantees process.emitWarning\n// is patched before the sqlite module loads and emits its\n// ExperimentalWarning at init time.\n\nconst originalEmitWarning = process.emitWarning.bind(process);\n\ntype EmitWarningArgs = Parameters<typeof process.emitWarning>;\n\nprocess.emitWarning = ((...args: EmitWarningArgs) => {\n const [warning, typeOrOpts] = args;\n const name =\n typeof typeOrOpts === 'string'\n ? typeOrOpts\n : (typeOrOpts as { type?: string } | undefined)?.type;\n const text =\n typeof warning === 'string' ? warning : ((warning as Error | undefined)?.message ?? '');\n if (name === 'ExperimentalWarning' && /SQLite is an experimental feature/i.test(text)) {\n return;\n }\n return originalEmitWarning(...args);\n}) as typeof process.emitWarning;\n\n// Also drop any listener Node's bootstrap installed before us.\nfor (const listener of process.listeners('warning')) {\n process.removeListener('warning', listener);\n}\nprocess.on('warning', (w) => {\n if (w.name === 'ExperimentalWarning' && /SQLite is an experimental feature/i.test(w.message)) {\n return;\n }\n process.stderr.write(`${w.stack ?? w.message}\\n`);\n});\n", "// Tiny ESM entry point. The only thing it does synchronously is install\n// the warning filter so node:sqlite's ExperimentalWarning is swallowed\n// before anything else loads it. Then it dynamically imports the app,\n// which is what pulls in drizzle-orm/node-sqlite (and therefore\n// node:sqlite itself).\n//\n// Static ESM imports are hoisted above top-level statements, so the\n// override cannot go here as a normal import statement - the sqlite\n// module would load first. A dynamic import() runs after the preamble.\n\nimport './utils/suppress-sqlite-warning';\n\n// The `.js` extension is required at runtime (esbuild emits dist/app.js).\n// TS `moduleResolution: Bundler` lets us write it this way in source.\nawait import('./app.js');\n"],
5
- "mappings": ";;;;;AAMA,IAAM,sBAAsB,QAAQ,YAAY,KAAK,OAAO;AAI5D,QAAQ,eAAe,IAAI,SAA0B;AACnD,QAAM,CAAC,SAAS,UAAU,IAAI;AAC9B,QAAM,OACJ,OAAO,eAAe,WAClB,aACC,YAA8C;AACrD,QAAM,OACJ,OAAO,YAAY,WAAW,UAAY,SAA+B,WAAW;AACtF,MAAI,SAAS,yBAAyB,qCAAqC,KAAK,IAAI,GAAG;AACrF;AAAA,EACF;AACA,SAAO,oBAAoB,GAAG,IAAI;AACpC;AAGA,WAAW,YAAY,QAAQ,UAAU,SAAS,GAAG;AACnD,UAAQ,eAAe,WAAW,QAAQ;AAC5C;AACA,QAAQ,GAAG,WAAW,CAAC,MAAM;AAC3B,MAAI,EAAE,SAAS,yBAAyB,qCAAqC,KAAK,EAAE,OAAO,GAAG;AAC5F;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,GAAG,EAAE,SAAS,EAAE,OAAO;AAAA,CAAI;AAClD,CAAC;;;ACnBD,MAAM,OAAO,UAAU;",
4
+ "sourcesContent": ["// Side-effect-only module. Must be imported before anything that touches\n// `node:sqlite` (directly or via drizzle-orm/node-sqlite). ESM evaluates\n// imports depth-first, so importing this first guarantees process.emitWarning\n// is patched before the sqlite module loads and emits its\n// ExperimentalWarning at init time.\n\nconst originalEmitWarning = process.emitWarning.bind(process);\n\ntype EmitWarningArgs = Parameters<typeof process.emitWarning>;\n\nprocess.emitWarning = ((...args: EmitWarningArgs) => {\n const [warning, typeOrOpts] = args;\n const name =\n typeof typeOrOpts === 'string'\n ? typeOrOpts\n : (typeOrOpts as { type?: string } | undefined)?.type;\n const text =\n typeof warning === 'string' ? warning : ((warning as Error | undefined)?.message ?? '');\n if (name === 'ExperimentalWarning' && /SQLite is an experimental feature/i.test(text)) {\n return;\n }\n return originalEmitWarning(...args);\n}) as typeof process.emitWarning;\n\n// Also drop any listener Node's bootstrap installed before us.\nfor (const listener of process.listeners('warning')) {\n process.removeListener('warning', listener);\n}\nprocess.on('warning', (w) => {\n if (w.name === 'ExperimentalWarning' && /SQLite is an experimental feature/i.test(w.message)) {\n return;\n }\n process.stderr.write(`${w.stack ?? w.message}\\n`);\n});\n", "// Tiny ESM entry point. The only thing it does synchronously is install\n// the warning filter so node:sqlite's ExperimentalWarning is swallowed\n// before anything else loads it. Then it dynamically imports the app,\n// which is what pulls in drizzle-orm/node-sqlite (and therefore\n// node:sqlite itself).\n//\n// Static ESM imports are hoisted above top-level statements, so the\n// override cannot go here as a normal import statement - the sqlite\n// module would load first. A dynamic import() runs after the preamble.\n\n// Must run before anything that imports node:sqlite (drizzle-orm/node-sqlite\n// calls StatementSync.setReturnArrays which only exists in Node 24+).\nconst [nodeMajor] = process.versions.node.split('.').map(Number);\nif (nodeMajor! < 24) {\n process.stderr.write(\n `mcp-inbox requires Node.js 24 or later (running ${process.version}).\\n` +\n ` \u2022 npx users: npx is usually fine \u2014 check 'node --version' first.\\n` +\n ` \u2022 proto users: run 'proto pin node 24 --global' once to set the global default.\\n` +\n ` \u2022 pnpm dlx / pnpx: if proto shims resolve to an older version outside your\\n` +\n ` project directory, set a global default or use 'npx -y @kbzowski/mcp-inbox'.\\n`,\n );\n process.exit(1);\n}\n\nimport './utils/suppress-sqlite-warning';\n\n// The `.js` extension is required at runtime (esbuild emits dist/app.js).\n// TS `moduleResolution: Bundler` lets us write it this way in source.\nawait import('./app.js');\n"],
5
+ "mappings": ";;;;;AAMA,IAAM,sBAAsB,QAAQ,YAAY,KAAK,OAAO;AAI5D,QAAQ,eAAe,IAAI,SAA0B;AACnD,QAAM,CAAC,SAAS,UAAU,IAAI;AAC9B,QAAM,OACJ,OAAO,eAAe,WAClB,aACC,YAA8C;AACrD,QAAM,OACJ,OAAO,YAAY,WAAW,UAAY,SAA+B,WAAW;AACtF,MAAI,SAAS,yBAAyB,qCAAqC,KAAK,IAAI,GAAG;AACrF;AAAA,EACF;AACA,SAAO,oBAAoB,GAAG,IAAI;AACpC;AAGA,WAAW,YAAY,QAAQ,UAAU,SAAS,GAAG;AACnD,UAAQ,eAAe,WAAW,QAAQ;AAC5C;AACA,QAAQ,GAAG,WAAW,CAAC,MAAM;AAC3B,MAAI,EAAE,SAAS,yBAAyB,qCAAqC,KAAK,EAAE,OAAO,GAAG;AAC5F;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,GAAG,EAAE,SAAS,EAAE,OAAO;AAAA,CAAI;AAClD,CAAC;;;ACrBD,IAAM,CAAC,SAAS,IAAI,QAAQ,SAAS,KAAK,MAAM,GAAG,EAAE,IAAI,MAAM;AAC/D,IAAI,YAAa,IAAI;AACnB,UAAQ,OAAO;AAAA,IACb,mDAAmD,QAAQ,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpE;AACA,UAAQ,KAAK,CAAC;AAChB;AAMA,MAAM,OAAO,UAAU;",
6
6
  "names": []
7
7
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kbzowski/mcp-inbox",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "MCP server exposing IMAP/SMTP email over a fast local cache. Read, search, compose, and manage email from any IMAP provider with near-instant response times via background sync and IDLE push.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",