@thehammer/schema-mcp-server 1.0.3 → 1.0.5

package/dist/api-client.js

@@ -15,10 +15,17 @@ if (!SCHEMA_ID) {
     console.error("SCHEMA_DEFINITION_ID is required");
     process.exit(1);
 }
-async function apiRequest(method, path, body) {
+/** Default timeout for API requests (30s). Preview endpoints get longer. */
+const DEFAULT_TIMEOUT_MS = 30_000;
+const PREVIEW_TIMEOUT_MS = 60_000;
+async function apiRequest(method, path, body, timeoutMs) {
     const url = `${API_URL}/api/${path}`;
+    const controller = new AbortController();
+    const resolvedTimeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const timer = setTimeout(() => controller.abort(), resolvedTimeout);
     const options = {
         method,
+        signal: controller.signal,
         headers: {
             Authorization: `Bearer ${API_TOKEN}`,
             "Content-Type": "application/json",
@@ -28,13 +35,24 @@ async function apiRequest(method, path, body) {
     if (body && method !== "GET") {
         options.body = JSON.stringify(body);
     }
-    const response = await fetch(url, options);
-    const json = (await response.json());
-    if (!response.ok) {
-        const errorMessage = json.message || json.error || `HTTP ${response.status}`;
-        throw new Error(`API Error: ${errorMessage}`);
+    try {
+        const response = await fetch(url, options);
+        const json = (await response.json());
+        if (!response.ok) {
+            const errorMessage = json.message || json.error || `HTTP ${response.status}`;
+            throw new Error(`API Error: ${errorMessage}`);
+        }
+        return json;
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new Error(`API timeout: ${method} ${path} did not respond within ${resolvedTimeout / 1000}s`);
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timer);
     }
-    return json;
 }
 // --- Schema MCP Endpoints ---
 export function mcpPath(endpoint) {
@@ -136,13 +154,13 @@ export async function getTemplatePreview(templateId, teamObjectId, message) {
     return apiRequest("POST", mcpPath(`templates/${templateId}/preview`), {
         ...(teamObjectId ? { team_object_id: teamObjectId } : {}),
         ...(message ? { message } : {}),
-    });
+    }, PREVIEW_TIMEOUT_MS);
 }
 export async function getTemplatePreviewHtml(templateId, teamObjectId, message) {
     return apiRequest("POST", mcpPath(`templates/${templateId}/preview-html`), {
         ...(teamObjectId ? { team_object_id: teamObjectId } : {}),
         ...(message ? { message } : {}),
-    });
+    }, PREVIEW_TIMEOUT_MS);
 }
 // --- Style Library Endpoints ---
 export async function getStyleList() {

package/dist/index.js

@@ -413,7 +413,7 @@ if (shouldRegister("directive_create"))
         data_fragment_selector: z
             .record(z.string(), z.unknown())
             .optional()
-            .describe("Fragment selector for which fields to extract (DataExtraction only). Auto-generated if omitted."),
+            .describe("Fragment selector for which fields to extract (DataExtraction only). REQUIRED for DataExtraction directives — must explicitly list every field this directive extracts. Not auto-generated."),
         prompt: z
             .string()
             .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/schema-mcp-server",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for Schema Builder - translates Claude Code tool calls into Laravel API requests",
   "license": "MIT",
   "repository": {