@wix/mcp 1.0.4 → 1.0.6

package/build/logger.js

@@ -1,61 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { homedir } from 'os';
-const createNullLogger = () => {
-    return {
-        log: () => { },
-        error: () => { }
-    };
-};
-const createStdErrLogger = () => {
-    return {
-        log: (data) => {
-            console.error(data);
-        },
-        error: (data) => {
-            console.error(data);
-        }
-    };
-};
-const createMcpServerLogger = (server) => {
-    return {
-        log: (data) => {
-            server.server.sendLoggingMessage({ level: 'info', data });
-        },
-        error: (data) => {
-            server.server.sendLoggingMessage({ level: 'error', data });
-        }
-    };
-};
-const createFileLogger = () => {
-    const filePath = path.join(homedir(), 'wix-mcp-log.txt');
-    const date = new Date()
-        .toLocaleString('en-US', { timeZone: 'Asia/Jerusalem' })
-        .replace(/,/g, '');
-    return {
-        log: (...data) => {
-            const message = `[info] ${date} - ${data.join(' ')}`;
-            fs.appendFile(filePath, `${message}\n`);
-        },
-        error: (...data) => {
-            const message = `[error] ${date} - ${data.join(' ')}`;
-            fs.appendFile(filePath, `${message}\n`);
-        }
-    };
-};
-export const logger = createNullLogger();
-export const attachMcpServerLogger = (server) => {
-    const mcpLogger = createMcpServerLogger(server);
-    logger.log = mcpLogger.log;
-    logger.error = mcpLogger.error;
-};
-export const attachStdErrLogger = () => {
-    const stdErrLogger = createStdErrLogger();
-    logger.log = stdErrLogger.log;
-    logger.error = stdErrLogger.error;
-};
-export const attachFileLogger = () => {
-    const fileLogger = createFileLogger();
-    logger.log = fileLogger.log;
-    logger.error = fileLogger.error;
-};

package/build/resources/docs.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare const addDocsResources: (server: McpServer, portals: string[]) => Promise<void>;

package/build/resources/docs.js

@@ -1,45 +0,0 @@
-import { logger } from '../logger.js';
-const getPortalIndex = async (portalName) => {
-    const response = await fetch(`https://dev.wix.com/digor/api/portal-index?portalName=${portalName}`);
-    const data = await response.json();
-    return data;
-};
-const addPortalResources = async (server, portalName) => {
-    // get portal index:
-    const portalIndexResponse = await getPortalIndex(portalName);
-    logger.log(`portalIndexResponse for ${portalName}`, JSON.stringify(portalIndexResponse, null, 2));
-    // for each portalIndex entry, add a resource to the server:
-    for (const entry of portalIndexResponse.portalIndex) {
-        logger.log(`entry ${JSON.stringify(entry, null, 2)}`);
-        const name = entry.url;
-        const uri = entry.url.replace('https://dev.wix.com/docs/', 'wix-docs://');
-        logger.log(`adding resource ${name} ${uri}`);
-        server.resource(name, uri, async (uri) => {
-            logger.log(`fetching resource ${uri}`);
-            const docsURL = uri
-                .toString()
-                .replace('wix-docs://', 'https://dev.wix.com/docs/');
-            const response = await fetch(`https://dev.wix.com/digor/api/get-article-content?articleUrl=${encodeURIComponent(docsURL)}`);
-            const data = await response.json();
-            return {
-                contents: [
-                    {
-                        uri: uri.href,
-                        text: data.articleContent || 'No content found'
-                    }
-                ]
-            };
-        });
-    }
-};
-export const addDocsResources = async (server, portals) => {
-    for (const portal of portals) {
-        try {
-            logger.log(`Processing portal: ${portal}`);
-            await addPortalResources(server, portal);
-        }
-        catch (error) {
-            logger.error(`Error processing portal ${portal}:`, error);
-        }
-    }
-};

package/build/sentry.d.ts

@@ -1 +0,0 @@
-export {};

package/build/sentry.js

@@ -1,10 +0,0 @@
-import * as Sentry from '@sentry/node';
-Sentry.init({
-    dsn: 'https://583c5af58c664fd1977d638a693b0ada@sentry-next.wixpress.com/20924',
-    tracesSampleRate: 1.0,
-    initialScope: {
-        tags: {
-            fullArtifactId: 'com.wixpress.spartans.wix-mcp'
-        }
-    }
-});

package/build/support/index.d.ts

@@ -1,2 +0,0 @@
-import { WixMcpServer } from '../wix-mcp-server.js';
-export declare function addSupportTool(server: WixMcpServer): void;

package/build/support/index.js

@@ -1,32 +0,0 @@
-import { z } from 'zod';
-export function addSupportTool(server) {
-    server.tool('SupportAndFeedback', [
-        'If the user would like to provide Wix with some feedback (good or bad), about the tools in Wix MCP,',
-        'for example they used the tools provided, and they reflected satisfaction or dissatisfaction with the tools.',
-        'Also, if you encounter too many errors tyring to call the Wix API, you can also suggest the user to provide feedback to Wix using this tool.',
-        '**IMPORTANT NOTE**',
-        'This tool is not sending the message, but formats it in order to another tool to actually send it'
-    ].join('\n'), {
-        requestId: z
-            .string()
-            .optional()
-            .describe('request id if returned from the server in a failed API call to Wix'),
-        message: z.string().describe('The message to send to Wix')
-    }, async ({ requestId, message }) => {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `${message} ${requestId ? `request id: ${requestId}` : ''}`
-                },
-                {
-                    type: 'text',
-                    text: 'You should present the user with the formatted message above and ask if they would like to send it to Wix.' +
-                        'If the user confirms, you can get the details about send feedback API from the article `https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_send_mcp_feedback_to_wix_from_user`.' +
-                        'You can use the `ReadFullDocsArticle` tool to fetch the article and get the details about the API call.' +
-                        'Once you have the details, you can use the `ManageWixSite` (if site id is in context) or `CallWixSiteAPI` (if site id is not in context) tool to call the API and send the feedback to Wix.'
-                }
-            ]
-        };
-    });
-}

package/build/tool-utils.d.ts

@@ -1 +0,0 @@
-export declare const handleWixAPIResponse: <T = any>(response: Response) => Promise<T>;

package/build/tool-utils.js

@@ -1,29 +0,0 @@
-const safeParseJSON = (text) => {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return text;
-    }
-};
-export const handleWixAPIResponse = async (response) => {
-    const responseText = await response.text();
-    const responseData = safeParseJSON(responseText);
-    if (!response.ok) {
-        const requestId = response.headers.get('x-wix-request-id');
-        const errorDetails = typeof responseData === 'object'
-            ? JSON.stringify(responseData)
-            : responseData;
-        throw new Error([
-            `Failed to call Wix API: ${response.status} ${response.statusText}.`,
-            requestId ? `request id: ${requestId}` : '',
-            // Wix 404 for API does not exist is huge (generic 404 page) and loaded to the context
-            response.status === 404 && errorDetails.includes('<html')
-                ? 'Not found'
-                : errorDetails
-        ]
-            .filter((str) => !!str)
-            .join('\n'));
-    }
-    return responseData;
-};

package/build/tool-utils.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/build/tool-utils.spec.js

@@ -1,119 +0,0 @@
-import { handleWixAPIResponse } from './tool-utils.js';
-import { expect, test, vi, describe, beforeEach } from 'vitest';
-// Mock the global fetch function
-global.fetch = vi.fn();
-describe('handleWixAPIResponse', () => {
-    beforeEach(() => {
-        // Reset the mock before each test
-        global.fetch.mockClear();
-    });
-    describe('safeParseJSON', () => {
-        test('should parse valid JSON string', async () => {
-            const jsonString = '{"key": "value", "number": 123}';
-            global.fetch.mockResolvedValueOnce(new Response(jsonString, { status: 200 }));
-            const result = await handleWixAPIResponse(new Response(jsonString, { status: 200 }));
-            expect(result).toEqual({ key: 'value', number: 123 });
-        });
-        test('should return the original string if parsing fails', async () => {
-            const invalidJSONString = 'this is not valid json';
-            global.fetch.mockResolvedValueOnce(new Response(invalidJSONString, { status: 200 }));
-            const result = await handleWixAPIResponse(new Response(invalidJSONString, { status: 200 }));
-            expect(result).toBe(invalidJSONString);
-        });
-        test('should return an empty string if the response text is empty', async () => {
-            global.fetch.mockResolvedValueOnce(new Response('', { status: 200 }));
-            const result = await handleWixAPIResponse(new Response('', { status: 200 }));
-            expect(result).toBe('');
-        });
-    });
-    test('should return parsed JSON data for a successful response', async () => {
-        const mockData = { message: 'Success!' };
-        global.fetch.mockResolvedValueOnce(new Response(JSON.stringify(mockData), {
-            status: 200,
-            statusText: 'OK',
-            headers: new Headers({ 'Content-Type': 'application/json' })
-        }));
-        const response = new Response(JSON.stringify(mockData), {
-            status: 200,
-            statusText: 'OK',
-            headers: new Headers({ 'Content-Type': 'application/json' })
-        });
-        const result = await handleWixAPIResponse(response);
-        expect(result).toEqual(mockData);
-    });
-    test('should return the original string if the successful response is not JSON', async () => {
-        const mockData = 'This is plain text';
-        global.fetch.mockResolvedValueOnce(new Response(mockData, { status: 200, statusText: 'OK' }));
-        const response = new Response(mockData, { status: 200, statusText: 'OK' });
-        const result = await handleWixAPIResponse(response);
-        expect(result).toBe(mockData);
-    });
-    test('should throw an error for a failed response with JSON error details', async () => {
-        const mockError = { error: 'Something went wrong', code: 500 };
-        const mockRequestId = 'some-request-id';
-        global.fetch.mockResolvedValueOnce(new Response(JSON.stringify(mockError), {
-            status: 500,
-            statusText: 'Internal Server Error',
-            headers: new Headers({ 'x-wix-request-id': mockRequestId })
-        }));
-        const response = new Response(JSON.stringify(mockError), {
-            status: 500,
-            statusText: 'Internal Server Error',
-            headers: new Headers({ 'x-wix-request-id': mockRequestId })
-        });
-        await expect(handleWixAPIResponse(response)).rejects.toThrowError([
-            'Failed to call Wix API: 500 Internal Server Error.',
-            `request id: ${mockRequestId}`,
-            '{"error":"Something went wrong","code":500}'
-        ].join('\n'));
-    });
-    test('should throw an error for a failed response with non-JSON error details', async () => {
-        const mockError = 'Internal server error occurred.';
-        global.fetch.mockResolvedValueOnce(new Response(mockError, {
-            status: 503,
-            statusText: 'Service Unavailable'
-        }));
-        const response = new Response(mockError, {
-            status: 503,
-            statusText: 'Service Unavailable'
-        });
-        await expect(handleWixAPIResponse(response)).rejects.toThrowError(['Failed to call Wix API: 503 Service Unavailable.', mockError].join('\n'));
-    });
-    test('should include the request ID in the error message if present', async () => {
-        const mockError = { message: 'Unauthorized' };
-        const mockRequestId = 'another-id';
-        global.fetch.mockResolvedValueOnce(new Response(JSON.stringify(mockError), {
-            status: 401,
-            statusText: 'Unauthorized',
-            headers: new Headers({ 'x-wix-request-id': mockRequestId })
-        }));
-        const response = new Response(JSON.stringify(mockError), {
-            status: 401,
-            statusText: 'Unauthorized',
-            headers: new Headers({ 'x-wix-request-id': mockRequestId })
-        });
-        await expect(handleWixAPIResponse(response)).rejects.toThrowError([
-            'Failed to call Wix API: 401 Unauthorized.',
-            `request id: ${mockRequestId}`,
-            '{"message":"Unauthorized"}'
-        ].join('\n'));
-    });
-    test('should return "Not found" in the error message for a 404 with HTML content', async () => {
-        const mockHtmlError = '<html><body><h1>404 Not Found</h1></body></html>';
-        global.fetch.mockResolvedValueOnce(new Response(mockHtmlError, { status: 404, statusText: 'Not Found' }));
-        const response = new Response(mockHtmlError, {
-            status: 404,
-            statusText: 'Not Found'
-        });
-        await expect(handleWixAPIResponse(response)).rejects.toThrowError(['Failed to call Wix API: 404 Not Found.', 'Not found'].join('\n'));
-    });
-    test('should include the HTML content in the error message for a 404 without typical HTML structure', async () => {
-        const mockNonHtmlError = 'Resource not found on the server.';
-        global.fetch.mockResolvedValueOnce(new Response(mockNonHtmlError, { status: 404, statusText: 'Not Found' }));
-        const response = new Response(mockNonHtmlError, {
-            status: 404,
-            statusText: 'Not Found'
-        });
-        await expect(handleWixAPIResponse(response)).rejects.toThrowError(['Failed to call Wix API: 404 Not Found.', mockNonHtmlError].join('\n'));
-    });
-});

package/build/wix-mcp-server.d.ts

@@ -1,13 +0,0 @@
-import type { z, ZodRawShape, ZodTypeAny } from 'zod';
-import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-type WixRequestHandlerExtra = RequestHandlerExtra & {};
-type WixToolCallback<Args extends undefined | ZodRawShape = undefined> = Args extends ZodRawShape ? (args: z.objectOutputType<Args, ZodTypeAny>, extra: WixRequestHandlerExtra) => CallToolResult | Promise<CallToolResult> : (extra: WixRequestHandlerExtra) => CallToolResult | Promise<CallToolResult>;
-export declare class WixMcpServer extends McpServer {
-    tool(name: string, cb: WixToolCallback): void;
-    tool(name: string, description: string, cb: WixToolCallback): void;
-    tool<Args extends ZodRawShape>(name: string, paramsSchema: Args, cb: WixToolCallback<Args>): void;
-    tool<Args extends ZodRawShape>(name: string, description: string, paramsSchema: Args, cb: WixToolCallback<Args>): void;
-}
-export {};

package/build/wix-mcp-server.js

@@ -1,51 +0,0 @@
-// import type { PanoramaClientForComponent } from '@wix/panorama-client-node';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-//import { globalConfig, panoramaFactory } from './panorama.js';
-import { captureException } from '@sentry/node';
-export class WixMcpServer extends McpServer {
-    tool(...args) {
-        const cbIndex = args.findIndex((arg) => typeof arg === 'function');
-        if (cbIndex !== -1) {
-            const originalCb = args[cbIndex];
-            const toolName = args[0];
-            const panoramaComponentId = toolName;
-            /*const panorama = panoramaFactory.client({
-              baseParams: {
-                componentId: panoramaComponentId
-              }
-            });*/
-            /*setTags({
-              panoramaSessionId: globalConfig.getSessionId()
-            });*/
-            const wrappedCb = async (...cbArgs) => {
-                const argsBeforeExtra = cbArgs.slice(0, cbArgs.length - 1);
-                const extra = cbArgs[cbArgs.length - 1];
-                const wrappedExtra = {
-                    ...extra
-                    // panorama: panorama.createClientForComponent()
-                };
-                //panorama.transaction(toolName).start();
-                try {
-                    const cbResult = await originalCb(...argsBeforeExtra, wrappedExtra);
-                    //panorama.transaction(toolName).finish();
-                    return cbResult;
-                }
-                catch (e) {
-                    //panorama.errorMonitor().reportError(e as Error);
-                    captureException(e, {
-                        tags: {
-                            componentId: panoramaComponentId,
-                            toolName
-                        }
-                    });
-                    return {
-                        isError: true,
-                        content: [{ type: 'text', text: e.message }]
-                    };
-                }
-            };
-            args[cbIndex] = wrappedCb;
-        }
-        return super.tool.apply(this, args);
-    }
-}