fastmode-mcp 1.0.0

package/dist/lib/credentials.js

@@ -0,0 +1,196 @@
+"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.getCredentialsPath = getCredentialsPath;
+exports.loadCredentials = loadCredentials;
+exports.saveCredentials = saveCredentials;
+exports.deleteCredentials = deleteCredentials;
+exports.hasCredentials = hasCredentials;
+exports.isTokenExpired = isTokenExpired;
+exports.getApiUrl = getApiUrl;
+exports.refreshAccessToken = refreshAccessToken;
+exports.getValidCredentials = getValidCredentials;
+exports.getAuthToken = getAuthToken;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Get the path to the credentials file
+ */
+function getCredentialsPath() {
+    const configDir = path.join(os.homedir(), '.fastmode');
+    return path.join(configDir, 'credentials.json');
+}
+/**
+ * Ensure the config directory exists
+ */
+function ensureConfigDir() {
+    const configDir = path.dirname(getCredentialsPath());
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Load stored credentials from disk
+ */
+function loadCredentials() {
+    const credentialsPath = getCredentialsPath();
+    try {
+        if (!fs.existsSync(credentialsPath)) {
+            return null;
+        }
+        const content = fs.readFileSync(credentialsPath, 'utf-8');
+        const credentials = JSON.parse(content);
+        // Validate required fields
+        if (!credentials.accessToken || !credentials.refreshToken || !credentials.expiresAt || !credentials.email) {
+            return null;
+        }
+        return credentials;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save credentials to disk
+ */
+function saveCredentials(credentials) {
+    ensureConfigDir();
+    const credentialsPath = getCredentialsPath();
+    // Write with restricted permissions (owner read/write only)
+    fs.writeFileSync(credentialsPath, JSON.stringify(credentials, null, 2), { mode: 0o600 });
+}
+/**
+ * Delete stored credentials
+ */
+function deleteCredentials() {
+    const credentialsPath = getCredentialsPath();
+    try {
+        if (fs.existsSync(credentialsPath)) {
+            fs.unlinkSync(credentialsPath);
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Check if credentials exist
+ */
+function hasCredentials() {
+    return loadCredentials() !== null;
+}
+/**
+ * Check if the access token is expired or about to expire
+ */
+function isTokenExpired(credentials, bufferMinutes = 5) {
+    const expiresAt = new Date(credentials.expiresAt);
+    const bufferMs = bufferMinutes * 60 * 1000;
+    return Date.now() >= expiresAt.getTime() - bufferMs;
+}
+/**
+ * Get the API URL from environment or default
+ */
+function getApiUrl() {
+    return process.env.FASTMODE_API_URL || 'https://api.fastmode.ai';
+}
+/**
+ * Refresh the access token using the refresh token
+ */
+async function refreshAccessToken(credentials) {
+    const apiUrl = getApiUrl();
+    try {
+        const response = await fetch(`${apiUrl}/api/auth/device/refresh`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                refresh_token: credentials.refreshToken,
+                grant_type: 'refresh_token',
+            }),
+        });
+        if (!response.ok) {
+            // Refresh token is invalid or expired - need to re-authenticate
+            return null;
+        }
+        const data = await response.json();
+        if (!data.success || !data.data) {
+            return null;
+        }
+        const newCredentials = {
+            accessToken: data.data.access_token,
+            refreshToken: data.data.refresh_token,
+            expiresAt: new Date(Date.now() + data.data.expires_in * 1000).toISOString(),
+            email: data.data.email,
+            name: data.data.name,
+        };
+        // Save the new credentials
+        saveCredentials(newCredentials);
+        return newCredentials;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get valid credentials, refreshing if needed
+ * Returns null if no credentials or refresh fails
+ */
+async function getValidCredentials() {
+    const credentials = loadCredentials();
+    if (!credentials) {
+        return null;
+    }
+    // Check if token is expired or about to expire
+    if (isTokenExpired(credentials)) {
+        // Try to refresh
+        const newCredentials = await refreshAccessToken(credentials);
+        if (!newCredentials) {
+            // Refresh failed - credentials are invalid
+            deleteCredentials();
+            return null;
+        }
+        return newCredentials;
+    }
+    return credentials;
+}
+/**
+ * Get the current auth token (access token) if available and valid
+ */
+async function getAuthToken() {
+    const credentials = await getValidCredentials();
+    return credentials?.accessToken || null;
+}

package/dist/lib/device-flow.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Start the device authorization flow
+ * Returns a message describing the flow status
+ */
+export declare function startDeviceFlow(): Promise<string>;
+/**
+ * Check if device flow authentication is needed and perform it if so
+ * Returns the authentication result message
+ */
+export declare function ensureAuthenticated(): Promise<{
+    authenticated: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=device-flow.d.ts.map

package/dist/lib/device-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-flow.d.ts","sourceRoot":"","sources":["../../src/lib/device-flow.ts"],"names":[],"mappings":"AA0DA;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAqGvD;AA0ED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BhG"}

package/dist/lib/device-flow.js

@@ -0,0 +1,244 @@
+"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.startDeviceFlow = startDeviceFlow;
+exports.ensureAuthenticated = ensureAuthenticated;
+const child_process_1 = require("child_process");
+const credentials_1 = require("./credentials");
+/**
+ * Open a URL in the default browser
+ */
+function openBrowser(url) {
+    return new Promise((resolve) => {
+        // Determine the command based on platform
+        let command;
+        switch (process.platform) {
+            case 'darwin':
+                command = `open "${url}"`;
+                break;
+            case 'win32':
+                command = `start "" "${url}"`;
+                break;
+            default:
+                // Linux and others
+                command = `xdg-open "${url}"`;
+        }
+        (0, child_process_1.exec)(command, (error) => {
+            if (error) {
+                // Don't fail if browser can't open - user can manually navigate
+                resolve();
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+/**
+ * Start the device authorization flow
+ * Returns a message describing the flow status
+ */
+async function startDeviceFlow() {
+    const apiUrl = (0, credentials_1.getApiUrl)();
+    // Step 1: Request device authorization
+    let authResponse;
+    try {
+        const response = await fetch(`${apiUrl}/api/auth/device/authorize`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                clientName: 'FastMode MCP',
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+            return `# Authentication Error
+
+Failed to start device authorization: ${error.error || response.statusText}
+
+Please check:
+1. Your network connection
+2. The API URL is correct (${apiUrl})
+`;
+        }
+        const data = await response.json();
+        authResponse = data.data;
+    }
+    catch (error) {
+        return `# Network Error
+
+Unable to connect to FastMode API.
+
+**API URL:** ${apiUrl}
+**Error:** ${error instanceof Error ? error.message : 'Unknown error'}
+
+Please check your network connection and try again.
+`;
+    }
+    // Step 2: Open browser for user authorization
+    try {
+        await openBrowser(authResponse.verification_uri_complete);
+    }
+    catch {
+        // Browser failed to open - user will need to navigate manually
+    }
+    // Step 3: Poll for authorization
+    const pollInterval = (authResponse.interval || 5) * 1000; // seconds to ms
+    const expiresAt = Date.now() + authResponse.expires_in * 1000;
+    // Log instructions to stderr for user visibility
+    console.error(`
+# Device Authorization
+
+A browser window should open automatically.
+
+If it doesn't, please visit:
+${authResponse.verification_uri}
+
+And enter this code: ${authResponse.user_code}
+
+**Don't have a Fast Mode account?**
+Sign up at https://fastmode.ai first, then return here.
+
+Waiting for authorization...
+`);
+    // Start polling
+    const pollResult = await pollForToken(apiUrl, authResponse.device_code, pollInterval, expiresAt);
+    if (pollResult.success && pollResult.credentials) {
+        // Save credentials
+        (0, credentials_1.saveCredentials)(pollResult.credentials);
+        return `# Authentication Successful
+
+Logged in as: **${pollResult.credentials.email}**${pollResult.credentials.name ? ` (${pollResult.credentials.name})` : ''}
+
+Credentials saved to ~/.fastmode/credentials.json
+
+You can now use FastMode MCP tools.
+`;
+    }
+    else {
+        return `# Authentication Failed
+
+${pollResult.error || 'Authorization timed out or was denied.'}
+
+**Don't have an account?**
+Sign up at https://fastmode.ai and then try again.
+
+**To retry:** Call any authenticated tool like \`list_projects\` to start a new auth flow.
+`;
+    }
+}
+/**
+ * Poll the token endpoint until authorization is complete or timeout
+ */
+async function pollForToken(apiUrl, deviceCode, interval, expiresAt) {
+    while (Date.now() < expiresAt) {
+        // Wait for the polling interval
+        await new Promise(resolve => setTimeout(resolve, interval));
+        try {
+            const response = await fetch(`${apiUrl}/api/auth/device/token`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    device_code: deviceCode,
+                    grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+                }),
+            });
+            const data = await response.json();
+            if (response.ok && data.success && data.data) {
+                // Authorization successful!
+                const tokenData = data.data;
+                const credentials = {
+                    accessToken: tokenData.access_token,
+                    refreshToken: tokenData.refresh_token,
+                    expiresAt: new Date(Date.now() + tokenData.expires_in * 1000).toISOString(),
+                    email: tokenData.email,
+                    name: tokenData.name,
+                };
+                return { success: true, credentials };
+            }
+            // Check for specific error codes
+            if (data.error === 'authorization_pending') {
+                // User hasn't authorized yet - keep polling
+                continue;
+            }
+            if (data.error === 'slow_down') {
+                // Server is asking us to slow down
+                interval = Math.min(interval * 2, 30000); // Max 30 seconds
+                continue;
+            }
+            if (data.error === 'expired_token') {
+                return { success: false, error: 'The authorization request expired. Please try again.' };
+            }
+            if (data.error === 'access_denied') {
+                return { success: false, error: 'Authorization was denied. Please try again.' };
+            }
+            // Unknown error - keep polling
+        }
+        catch {
+            // Network error - keep trying
+        }
+    }
+    return { success: false, error: 'Authorization timed out. Please try again.' };
+}
+/**
+ * Check if device flow authentication is needed and perform it if so
+ * Returns the authentication result message
+ */
+async function ensureAuthenticated() {
+    // Import here to avoid circular dependency
+    const { getValidCredentials } = await Promise.resolve().then(() => __importStar(require('./credentials')));
+    const { waitForAuth } = await Promise.resolve().then(() => __importStar(require('./auth-state')));
+    // Wait for any startup auth that might be in progress
+    await waitForAuth();
+    const credentials = await getValidCredentials();
+    if (credentials) {
+        return {
+            authenticated: true,
+            message: `Authenticated as ${credentials.email}`,
+        };
+    }
+    // Need to authenticate
+    const result = await startDeviceFlow();
+    // Check if authentication was successful
+    const newCredentials = await getValidCredentials();
+    return {
+        authenticated: !!newCredentials,
+        message: result,
+    };
+}

package/dist/tools/cms-items.d.ts

@@ -0,0 +1,56 @@
+/**
+ * CMS Item Management Tools
+ *
+ * CRUD operations for managing items in CMS collections via the dashboard API.
+ */
+/**
+ * Create a new item in a CMS collection
+ */
+export declare function createCmsItem(params: {
+    projectId: string;
+    collectionSlug: string;
+    name: string;
+    slug?: string;
+    data: Record<string, unknown>;
+    publishedAt?: string;
+}): Promise<string>;
+/**
+ * List items in a CMS collection
+ */
+export declare function listCmsItems(params: {
+    projectId: string;
+    collectionSlug: string;
+    limit?: number;
+    sort?: string;
+    order?: 'asc' | 'desc';
+}): Promise<string>;
+/**
+ * Get a single item by slug
+ */
+export declare function getCmsItem(params: {
+    projectId: string;
+    collectionSlug: string;
+    itemSlug: string;
+}): Promise<string>;
+/**
+ * Update an existing item
+ */
+export declare function updateCmsItem(params: {
+    projectId: string;
+    collectionSlug: string;
+    itemSlug: string;
+    name?: string;
+    data?: Record<string, unknown>;
+    publishedAt?: string | null;
+}): Promise<string>;
+/**
+ * Delete an item from a collection
+ * REQUIRES confirmDelete: true to execute
+ */
+export declare function deleteCmsItem(params: {
+    projectId: string;
+    collectionSlug: string;
+    itemSlug: string;
+    confirmDelete: boolean;
+}): Promise<string>;
+//# sourceMappingURL=cms-items.d.ts.map

package/dist/tools/cms-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-items.d.ts","sourceRoot":"","sources":["../../src/tools/cms-items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqFH;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDlB;AAkBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AA4CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB;AAoBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ElB;AAkBD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwElB"}