@enfyra/mcp-server 0.1.33 → 0.1.35

package/dist/mcp-server-entry.js

@@ -32,6 +32,27 @@ function normalizeSortParam(sort) {
         .filter(Boolean)
         .join(',');
 }
+function normalizeFieldSelection(fields) {
+    return (fields || [])
+        .flatMap((field) => String(field).split(','))
+        .map((field) => field.trim())
+        .filter(Boolean);
+}
+function assertExtensionReadFields(tableName, fields) {
+    if (tableName !== 'enfyra_extension')
+        return;
+    const requestedFields = normalizeFieldSelection(fields);
+    const requestsSourceCode = requestedFields.some((field) => field === 'sourceCode' || field.endsWith('.sourceCode'));
+    if (!requestsSourceCode)
+        return;
+    throw new Error([
+        'enfyra_extension stores editable Vue SFC extension source in `code`, not `sourceCode`.',
+        '`sourceCode` belongs to dynamic server script records such as handlers, hooks, flow steps, websocket handlers, GraphQL resolvers, and bootstrap scripts.',
+        'For admin UI lookup, use search_admin_extensions(mode="search") then search_admin_extensions(mode="inspect").',
+        'For focused extension edits, use patch_extension_code or update_extension_code.',
+        'If you intentionally read raw extension records, request fields such as ["id","name","type","version","code"].',
+    ].join(' '));
+}
 // Import modules
 import { exchangeApiToken, getValidToken, getTokenExpiry, initAuth } from './lib/auth.js';
 import { fetchAPI, validateFilter, validateTableName } from './lib/fetch.js';
@@ -1281,7 +1302,7 @@ server.tool('discover_script_contexts', [
             },
             socketInHttpOrFlow: 'HTTP/flow context can emitToUser/emitToRoom/emitToGateway/broadcast and roomSize, but cannot reply/join/leave/disconnect/emitToCurrentRoom/broadcastToRoom because there is no bound socket. emitToRoom requires an explicit gateway path: emitToRoom(path, room, event, data). roomSize(room) counts sockets in that room across registered gateways.',
             packages: 'Server packages installed through install_package are exposed as $ctx.$pkgs.packageName in server scripts.',
-            files: 'Upload helpers are on $storage; raw create_records on enfyra_file is not equivalent to multipart upload/storage rollback. For multipart request files, pass file: @UPLOADED_FILE to @STORAGE.$upload/@STORAGE.$update so Enfyra streams from disk-backed temp storage. Use @STORAGE.$registerFile only when the object already exists in storage and the script should create the enfyra_file record without uploading bytes. Use buffer only for small generated files.',
+            files: 'Upload helpers are on $storage; raw create_records on enfyra_file is not equivalent to multipart upload/storage rollback. For multipart request files, pass file: @UPLOADED_FILE to @STORAGE.$upload/@STORAGE.$update so Enfyra streams from disk-backed temp storage. Use onProgress on $upload or blob-replacing $update when scripts need live progress; it receives raw storage storing progress from 0 to 100 and can emit custom @SOCKET events. Use @STORAGE.$registerFile only when the object already exists in storage and the script should create the enfyra_file record without uploading bytes. Use buffer only for small generated files.',
         },
         adminTesting: {
             flowStep: 'Use test_flow_step or run_admin_test(kind=flow_step).',
@@ -1324,7 +1345,7 @@ server.tool('get_enfyra_api_context', [
     };
     return jsonContent(payload);
 });
-server.tool('query_table', 'Query any route-backed table. Response is minimal unless fields is explicit. Every call must pass either limit or all=true. Use count_records or meta=filterCount/totalCount for counts; call discover_query_capabilities before using aggregate objects instead of guessing _sum/_count operators.', {
+server.tool('query_table', 'Query any route-backed table. Response is minimal unless fields is explicit. Every call must pass either limit or all=true. Use count_records or meta=filterCount/totalCount for counts; call discover_query_capabilities before using aggregate objects instead of guessing _sum/_count operators. For enfyra_extension, editable extension source is `code`, not `sourceCode`; prefer search_admin_extensions and patch_extension_code/update_extension_code for admin UI.', {
     tableName: z.string().describe('Table name to query'),
     filter: jsonObjectParam(z, 'Filter object').optional().describe('Filter object. Example: {"status": {"_eq": "active"}}.'),
     sort: z.string().optional().describe('Sort field. Prefix with - for descending (e.g., "createdAt", "-id")'),
@@ -1343,6 +1364,7 @@ server.tool('query_table', 'Query any route-backed table. Response is minimal un
         throw new Error('query_table accepts either all=true or limit, not both.');
     }
     validateTableName(tableName);
+    assertExtensionReadFields(tableName, fields);
     const filterParam = stringifyJsonArg(filter);
     const deepParam = stringifyJsonArg(deep);
     const aggregateParam = stringifyJsonArg(aggregate);
@@ -1431,13 +1453,14 @@ server.tool('count_records', [
     };
     return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
 });
-server.tool('find_one_record', 'Find a single record by ID or filter. By ID uses GET with filter (Enfyra has no GET /table/:id route).', {
+server.tool('find_one_record', 'Find a single record by ID or filter. By ID uses GET with filter (Enfyra has no GET /table/:id route). For enfyra_extension, editable extension source is `code`, not `sourceCode`; prefer search_admin_extensions and patch_extension_code/update_extension_code for admin UI.', {
     tableName: z.string().describe('Table name'),
     id: z.string().optional().describe('Record ID'),
     filter: jsonObjectParam(z, 'Filter object').optional().describe('Filter object to find by.'),
     fields: z.array(z.string()).optional().describe('Fields to select. If omitted, returns only the primary key.'),
 }, async ({ tableName, id, filter, fields }) => {
     validateTableName(tableName);
+    assertExtensionReadFields(tableName, fields);
     const primaryKey = await getPrimaryFieldName(tableName);
     const selectedFields = fields && fields.length > 0 ? fields : [primaryKey];
     if (id) {