@enfyra/mcp-server 0.1.13 → 0.1.15

package/dist/lib/fetch.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HTTP client module for Enfyra MCP Server
+ * Handles API requests with auth, timeout, and error handling
+ */
+type FetchApiOptions = RequestInit & {
+    headers?: Record<string, string>;
+};
+/**
+ * Make HTTP request to Enfyra API
+ * @param {string} apiUrl - Base API URL
+ * @param {string} path - Request path
+ * @param {object} options - Fetch options
+ * @returns {Promise<any>} Response data
+ */
+export declare function fetchAPI(apiUrl: string, path: string, options?: FetchApiOptions): Promise<any>;
+/**
+ * Validate filter JSON and check for injection patterns
+ * @param {string} filterStr - Filter JSON string
+ * @returns {object|null} Parsed filter object
+ */
+export declare function validateFilter(filterStr: string): any;
+/**
+ * Validate table name (alphanumeric, underscores only)
+ * @param {string} tableName - Table name to validate
+ * @returns {string} Validated table name
+ */
+export declare function validateTableName(tableName: string): string;
+export {};

package/dist/lib/fetch.js

@@ -0,0 +1,106 @@
+/**
+ * HTTP client module for Enfyra MCP Server
+ * Handles API requests with auth, timeout, and error handling
+ */
+import { getValidToken, hasApiToken, resetTokens } from './auth.js';
+// Timeout configuration
+const FETCH_TIMEOUT = 30000; // 30 seconds
+/**
+ * Make HTTP request to Enfyra API
+ * @param {string} apiUrl - Base API URL
+ * @param {string} path - Request path
+ * @param {object} options - Fetch options
+ * @returns {Promise<any>} Response data
+ */
+export async function fetchAPI(apiUrl, path, options = {}) {
+    const url = `${apiUrl}${path}`;
+    async function requestWithCurrentToken() {
+        const token = await getValidToken(apiUrl);
+        const headersList = [
+            ['Content-Type', 'application/json'],
+            ['Authorization', `Bearer ${token}`],
+        ];
+        if (options.headers) {
+            const optHeaders = options.headers;
+            for (const key of Object.keys(optHeaders)) {
+                const existingIdx = headersList.findIndex(h => h[0] === key);
+                if (existingIdx >= 0) {
+                    headersList[existingIdx] = [key, optHeaders[key]];
+                }
+                else {
+                    headersList.push([key, optHeaders[key]]);
+                }
+            }
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT);
+        try {
+            const res = await fetch(url, {
+                ...options,
+                headers: headersList,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return res;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${FETCH_TIMEOUT}ms`);
+            }
+            throw error;
+        }
+    }
+    let res = await requestWithCurrentToken();
+    if ((res.status === 401 || res.status === 403) && hasApiToken()) {
+        resetTokens();
+        res = await requestWithCurrentToken();
+    }
+    if (!res.ok) {
+        const error = await res.text().catch(() => res.statusText);
+        throw new Error(`API error (${res.status}): ${error}`);
+    }
+    return res.json();
+}
+/**
+ * Validate filter JSON and check for injection patterns
+ * @param {string} filterStr - Filter JSON string
+ * @returns {object|null} Parsed filter object
+ */
+export function validateFilter(filterStr) {
+    if (!filterStr)
+        return null;
+    try {
+        const parsed = JSON.parse(filterStr);
+        // Check depth limit (max 10 levels)
+        function checkDepth(obj, depth = 0) {
+            if (depth > 10) {
+                throw new Error('Filter depth exceeds maximum of 10 levels');
+            }
+            if (obj && typeof obj === 'object') {
+                for (const key of Object.keys(obj)) {
+                    checkDepth(obj[key], depth + 1);
+                }
+            }
+        }
+        checkDepth(parsed);
+        return parsed;
+    }
+    catch (e) {
+        if (e.message.includes('depth'))
+            throw e;
+        throw new Error(`Invalid filter JSON: ${e.message}`);
+    }
+}
+/**
+ * Validate table name (alphanumeric, underscores only)
+ * @param {string} tableName - Table name to validate
+ * @returns {string} Validated table name
+ */
+export function validateTableName(tableName) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(tableName)) {
+        throw new Error(`Invalid table name: ${tableName}. Must start with letter/underscore and contain only alphanumeric characters and underscores.`);
+    }
+    return tableName;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/lib/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/lib/fetch.ts"],"names":[],"mappings":"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"}

package/dist/lib/mcp-examples.d.ts

@@ -0,0 +1,99 @@
+export declare const EXAMPLE_REASONING_GUIDE: string[];
+export declare const EXAMPLE_CATEGORIES: {
+    'ssr-app-auth': {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    'oauth-setup': {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    'schema-relations': {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    'queries-deep': {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    'handlers-hooks': {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    'permissions-rls': {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    websocket: {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    flows: {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    files: {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+    extensions: {
+        title: string;
+        useWhen: string;
+        examples: {
+            name: string;
+            code: string;
+            notes: string[];
+        }[];
+    };
+};
+export declare function listExampleCategories(): {
+    key: string;
+    title: string;
+    useWhen: string;
+}[];
+export declare function getExamples(category: any): any;