@forestadmin/mcp-server 1.21.0 → 1.22.0

package/dist/utils/load-file-uploads.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = loadFileUploads;
+const path = __importStar(require("path"));
+// A module is free to throw a non-Error, and reading .message off it yields undefined.
+const describe = (error) => (error instanceof Error ? error.message : String(error));
+// Attached rather than passed to the constructor: the error cause option needs a newer lib than
+// this package targets, while Node itself carries the property fine.
+const withCause = (message, cause) => Object.assign(new Error(message), { cause });
+/**
+ * Loads the `fileUploads` options of the standalone server from a module on disk.
+ *
+ * A storage backend is an object with methods, so it cannot travel through an environment
+ * variable like every other standalone option. Without this, file uploads would be reachable
+ * only by embedding the server in an agent or by writing a custom entry point.
+ *
+ * The module default-exports the options, or a function returning them:
+ *
+ *   module.exports = { storage: myS3Storage, maxBytes: 50 * 1024 * 1024 };
+ */
+async function loadFileUploads(modulePath) {
+    if (!modulePath)
+        return undefined;
+    const resolved = path.resolve(process.cwd(), modulePath);
+    let loaded;
+    try {
+        // require rather than import(): this package is CommonJS, and Node handles an ESM module here
+        // too, whereas a file:// specifier breaks under the test runner.
+        // eslint-disable-next-line global-require, import/no-dynamic-require, @typescript-eslint/no-var-requires
+        loaded = require(resolved);
+    }
+    catch (error) {
+        // "cannot find it" and "it ran and failed" send the operator to different places, and only the
+        // first is about the path they configured.
+        const absent = error?.code === 'MODULE_NOT_FOUND' &&
+            String(error?.message).includes(resolved);
+        throw withCause(absent
+            ? `FOREST_MCP_UPLOAD_STORAGE_MODULE "${modulePath}" was not found (resolved to ${resolved}).`
+            : `FOREST_MCP_UPLOAD_STORAGE_MODULE "${modulePath}" failed while loading: ${describe(error)}`, error);
+    }
+    const exported = loaded?.default ?? loaded;
+    let options;
+    try {
+        options = (typeof exported === 'function' ? await exported() : exported);
+    }
+    catch (error) {
+        // The sync path above is wrapped; a rejecting factory would otherwise surface with no mention
+        // of the module it came from.
+        throw withCause(`FOREST_MCP_UPLOAD_STORAGE_MODULE "${modulePath}" failed while building the options: ${describe(error)}`, error);
+    }
+    // An object without a storage key is legitimate — it selects the in-memory store. Nothing at all
+    // is a mistake, most likely a module that forgot to export.
+    if (!options || typeof options !== 'object') {
+        throw new Error(`FOREST_MCP_UPLOAD_STORAGE_MODULE "${modulePath}" must export the fileUploads options, or a ` +
+            'function returning them. See the fileUploads section of the mcp-server README.');
+    }
+    // Whoever sets this variable did it *for* the storage: a bad import or a factory that returned
+    // early leaves `{ storage: undefined }`, which the server would silently replace with the
+    // in-memory store — putting a deliberately replicated deployment on the one backend that cannot
+    // serve it. A missing method fails later, on the first user's upload, so it is checked here too.
+    if ('storage' in options) {
+        const storage = options.storage;
+        const missing = ['createUploadUrl', 'download', 'getSize'].filter(method => typeof storage?.[method] !== 'function');
+        if (missing.length) {
+            throw new Error(`FOREST_MCP_UPLOAD_STORAGE_MODULE "${modulePath}" exports a storage missing ` +
+                `${missing.join(', ')}. An UploadStorage implements createUploadUrl, download and ` +
+                'getSize. Omit the storage entirely to use the in-memory store on purpose.');
+        }
+    }
+    return options;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZC1maWxlLXVwbG9hZHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvbG9hZC1maWxlLXVwbG9hZHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFzQkEsa0NBMkVDO0FBL0ZELDJDQUE2QjtBQUU3Qix1RkFBdUY7QUFDdkYsTUFBTSxRQUFRLEdBQUcsQ0FBQyxLQUFjLEVBQUUsRUFBRSxDQUFDLENBQUMsS0FBSyxZQUFZLEtBQUssQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUM7QUFFOUYsZ0dBQWdHO0FBQ2hHLHFFQUFxRTtBQUNyRSxNQUFNLFNBQVMsR0FBRyxDQUFDLE9BQWUsRUFBRSxLQUFjLEVBQUUsRUFBRSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLEVBQUUsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO0FBRXBHOzs7Ozs7Ozs7O0dBVUc7QUFDWSxLQUFLLFVBQVUsZUFBZSxDQUMzQyxVQUFtQjtJQUVuQixJQUFJLENBQUMsVUFBVTtRQUFFLE9BQU8sU0FBUyxDQUFDO0lBRWxDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLEdBQUcsRUFBRSxFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBQ3pELElBQUksTUFBdUQsQ0FBQztJQUU1RCxJQUFJLENBQUM7UUFDSCw4RkFBOEY7UUFDOUYsaUVBQWlFO1FBQ2pFLHlHQUF5RztRQUN6RyxNQUFNLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzdCLENBQUM7SUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1FBQ2YsK0ZBQStGO1FBQy9GLDJDQUEyQztRQUMzQyxNQUFNLE1BQU0sR0FDVCxLQUErQixFQUFFLElBQUksS0FBSyxrQkFBa0I7WUFDN0QsTUFBTSxDQUFFLEtBQWUsRUFBRSxPQUFPLENBQUMsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLENBQUM7UUFFdkQsTUFBTSxTQUFTLENBQ2IsTUFBTTtZQUNKLENBQUMsQ0FBQyxxQ0FBcUMsVUFBVSxnQ0FBZ0MsUUFBUSxJQUFJO1lBQzdGLENBQUMsQ0FBQyxxQ0FBcUMsVUFBVSwyQkFBMkIsUUFBUSxDQUNoRixLQUFLLENBQ04sRUFBRSxFQUNQLEtBQUssQ0FDTixDQUFDO0lBQ0osQ0FBQztJQUVELE1BQU0sUUFBUSxHQUFHLE1BQU0sRUFBRSxPQUFPLElBQUksTUFBTSxDQUFDO0lBQzNDLElBQUksT0FBdUMsQ0FBQztJQUU1QyxJQUFJLENBQUM7UUFDSCxPQUFPLEdBQUcsQ0FBQyxPQUFPLFFBQVEsS0FBSyxVQUFVLENBQUMsQ0FBQyxDQUFDLE1BQU0sUUFBUSxFQUFFLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBdUIsQ0FBQztJQUNqRyxDQUFDO0lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztRQUNmLDhGQUE4RjtRQUM5Riw4QkFBOEI7UUFDOUIsTUFBTSxTQUFTLENBQ2IscUNBQXFDLFVBQVUsd0NBQXdDLFFBQVEsQ0FDN0YsS0FBSyxDQUNOLEVBQUUsRUFDSCxLQUFLLENBQ04sQ0FBQztJQUNKLENBQUM7SUFFRCxpR0FBaUc7SUFDakcsNERBQTREO0lBQzVELElBQUksQ0FBQyxPQUFPLElBQUksT0FBTyxPQUFPLEtBQUssUUFBUSxFQUFFLENBQUM7UUFDNUMsTUFBTSxJQUFJLEtBQUssQ0FDYixxQ0FBcUMsVUFBVSw4Q0FBOEM7WUFDM0YsZ0ZBQWdGLENBQ25GLENBQUM7SUFDSixDQUFDO0lBRUQsK0ZBQStGO0lBQy9GLDBGQUEwRjtJQUMxRixnR0FBZ0c7SUFDaEcsaUdBQWlHO0lBQ2pHLElBQUksU0FBUyxJQUFJLE9BQU8sRUFBRSxDQUFDO1FBQ3pCLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUF5RCxDQUFDO1FBQ2xGLE1BQU0sT0FBTyxHQUFHLENBQUMsaUJBQWlCLEVBQUUsVUFBVSxFQUFFLFNBQVMsQ0FBQyxDQUFDLE1BQU0sQ0FDL0QsTUFBTSxDQUFDLEVBQUUsQ0FBQyxPQUFPLE9BQU8sRUFBRSxDQUFDLE1BQU0sQ0FBQyxLQUFLLFVBQVUsQ0FDbEQsQ0FBQztRQUVGLElBQUksT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ25CLE1BQU0sSUFBSSxLQUFLLENBQ2IscUNBQXFDLFVBQVUsOEJBQThCO2dCQUMzRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLDhEQUE4RDtnQkFDbkYsMkVBQTJFLENBQzlFLENBQUM7UUFDSixDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU8sT0FBTyxDQUFDO0FBQ2pCLENBQUMifQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forestadmin/mcp-server",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Model Context Protocol server for Forest Admin with OAuth authentication",
   "main": "dist/index.js",
   "bin": {
@@ -16,8 +16,8 @@
     "directory": "packages/mcp-server"
   },
   "dependencies": {
-    "@forestadmin/agent-client": "1.13.0",
-    "@forestadmin/forestadmin-client": "1.41.3",
+    "@forestadmin/agent-client": "1.14.0",
+    "@forestadmin/forestadmin-client": "1.42.1",
     "@modelcontextprotocol/sdk": "^1.28.0",
     "cors": "^2.8.5",
     "express": "^5.2.1",