fastmode-mcp 1.0.0

package/dist/tools/deploy-package.js

@@ -0,0 +1,434 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployPackage = deployPackage;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const api_client_1 = require("../lib/api-client");
+const device_flow_1 = require("../lib/device-flow");
+const credentials_1 = require("../lib/credentials");
+const validate_package_1 = require("./validate-package");
+/**
+ * List existing projects for the authenticated user
+ */
+async function listExistingProjects() {
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data;
+}
+/**
+ * Check if a project has GitHub connected
+ */
+async function checkGitHubConnection(tenantId) {
+    const response = await (0, api_client_1.apiRequest)('/api/github/site-connection', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        // If we can't check, assume not connected (fail open for better UX)
+        return null;
+    }
+    return response.data;
+}
+/**
+ * Format the GitHub blocking message
+ */
+function formatGitHubBlockMessage(repo, branch, subdomain) {
+    return `# ⚠️ GitHub Sync Detected
+
+This project has GitHub connected and will auto-deploy from:
+- **Repository:** ${repo}
+- **Branch:** ${branch}
+
+## Why This Matters
+
+Deploying via MCP while GitHub is connected can cause conflicts:
+- Your MCP changes could be overwritten on the next GitHub push
+- Or this deploy could overwrite changes from GitHub
+
+## Options
+
+### Option 1: Push to GitHub Instead (Recommended)
+Push your changes to the connected repository and let GitHub handle the deploy:
+\`\`\`bash
+git push origin ${branch}
+\`\`\`
+
+### Option 2: Disconnect GitHub First
+Go to **app.fastmode.ai** → Settings → GitHub and disconnect the repository.
+
+### Option 3: Force Deploy Anyway
+If you understand the risks and want to proceed:
+\`\`\`
+deploy_package(
+  packagePath: "./your-site.zip",
+  projectId: "...",
+  force: true
+)
+\`\`\`
+
+---
+
+**Dashboard:** https://app.fastmode.ai
+**Site:** https://${subdomain}.fastmode.ai
+`;
+}
+/**
+ * Upload a package to a specific tenant
+ */
+async function uploadPackage(tenantId, zipBuffer) {
+    const credentials = await (0, credentials_1.getValidCredentials)();
+    if (!credentials) {
+        return { error: 'Not authenticated' };
+    }
+    const apiUrl = (0, api_client_1.getApiUrl)();
+    const url = `${apiUrl}/api/upload/package`;
+    // Generate a unique boundary for multipart form data
+    const boundary = `----FormBoundary${Date.now().toString(16)}`;
+    // Build multipart form data manually
+    const header = Buffer.from(`--${boundary}\r\n` +
+        `Content-Disposition: form-data; name="package"; filename="package.zip"\r\n` +
+        `Content-Type: application/zip\r\n\r\n`);
+    const footer = Buffer.from(`\r\n--${boundary}--\r\n`);
+    const body = Buffer.concat([header, zipBuffer, footer]);
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${credentials.accessToken}`,
+                'X-Tenant-Id': tenantId,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+            },
+            body: body,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            return { error: data.error || `Upload failed with status ${response.status}` };
+        }
+        return data.data;
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : 'Upload failed' };
+    }
+}
+/**
+ * Read a package from path (zip file or directory)
+ */
+async function readPackage(packagePath) {
+    const absolutePath = path.resolve(packagePath);
+    // Check if path exists
+    if (!fs.existsSync(absolutePath)) {
+        return { error: `Path not found: ${absolutePath}` };
+    }
+    const stats = fs.statSync(absolutePath);
+    if (stats.isFile()) {
+        // It's a file - check if it's a zip
+        if (!absolutePath.endsWith('.zip')) {
+            return { error: 'File must be a .zip archive' };
+        }
+        return fs.readFileSync(absolutePath);
+    }
+    // It's a directory - we need to zip it
+    // For now, require a zip file
+    return { error: 'Please provide a .zip file. Directory upload is not yet supported.' };
+}
+/**
+ * Format project list for user selection
+ */
+function formatProjectChoice(projects, packagePath) {
+    let output = `# Project Required
+
+You need to specify which project to deploy to.
+
+## Your Projects
+
+`;
+    if (projects.length > 0) {
+        projects.forEach((project, index) => {
+            const url = project.customDomain || `${project.subdomain}.fastmode.ai`;
+            output += `${index + 1}. **${project.name}**
+   - ID: \`${project.id}\`
+   - URL: ${url}
+   - Status: ${project.site?.status || 'pending'}
+
+`;
+        });
+        output += `---
+
+## ACTION REQUIRED
+
+**Ask the user:** "Which project should I deploy to? You can choose from the list above, or I can create a new project for you."
+
+### To deploy to an existing project:
+\`\`\`
+deploy_package(
+  packagePath: "${packagePath}",
+  projectId: "${projects[0]?.id || 'project-id-here'}"
+)
+\`\`\`
+
+### To create a NEW project first:
+\`\`\`
+create_site(name: "Project Name")
+\`\`\`
+Then deploy with the returned project ID.
+`;
+    }
+    else {
+        output += `You don't have any projects yet.
+
+---
+
+## ACTION REQUIRED
+
+**Ask the user:** "What would you like to name your new project?"
+
+Then create the project:
+\`\`\`
+create_site(name: "User's Project Name")
+\`\`\`
+
+And deploy with the returned project ID:
+\`\`\`
+deploy_package(
+  packagePath: "${packagePath}",
+  projectId: "returned-project-id"
+)
+\`\`\`
+`;
+    }
+    return output;
+}
+/**
+ * Deploy a website package to Fast Mode
+ *
+ * @param packagePath - Path to the zip file
+ * @param projectId - Project ID to deploy to (use list_projects to find, or create_site to create new)
+ * @param force - Optional: Skip GitHub connection check and deploy anyway
+ */
+async function deployPackage(packagePath, projectId, force) {
+    // Check authentication
+    if (await (0, api_client_1.needsAuthentication)()) {
+        const authResult = await (0, device_flow_1.ensureAuthenticated)();
+        if (!authResult.authenticated) {
+            return authResult.message;
+        }
+    }
+    // If no projectId specified, list projects and prompt for selection
+    if (!projectId) {
+        const projects = await listExistingProjects();
+        return formatProjectChoice(projects, packagePath);
+    }
+    // Read the package first
+    const packageResult = await readPackage(packagePath);
+    if ('error' in packageResult) {
+        return `# Package Error
+
+${packageResult.error}
+
+Please provide a valid .zip file path.
+`;
+    }
+    const zipBuffer = packageResult;
+    // Get subdomain for the project
+    const projects = await listExistingProjects();
+    const project = projects.find(p => p.id === projectId);
+    const subdomain = project?.subdomain || '';
+    if (!project) {
+        return `# Project Not Found
+
+Could not find project with ID: \`${projectId}\`
+
+Use \`list_projects\` to see available projects, or \`create_site\` to create a new one.
+`;
+    }
+    // Check for GitHub connection (unless force is true)
+    if (!force) {
+        const githubStatus = await checkGitHubConnection(projectId);
+        if (githubStatus?.connected && githubStatus.repo) {
+            // GitHub is connected - block deployment
+            return formatGitHubBlockMessage(githubStatus.repo, githubStatus.branch || 'main', subdomain);
+        }
+    }
+    // ============ PRE-DEPLOY VALIDATION GATE ============
+    // Validate the package BEFORE uploading to catch errors early
+    try {
+        const zip = new adm_zip_1.default(zipBuffer);
+        const entries = zip.getEntries();
+        // Build file list from zip
+        const fileList = entries.map(e => e.entryName);
+        // Find and read manifest.json
+        const manifestEntry = entries.find(e => e.entryName === 'manifest.json' ||
+            e.entryName.endsWith('/manifest.json'));
+        if (!manifestEntry) {
+            return `# DEPLOYMENT BLOCKED
+
+**Reason:** Missing manifest.json
+
+Every Fast Mode package requires a manifest.json at the root.
+
+Run \`get_example("manifest_basic")\` to see the required format.
+
+## Expected Package Structure
+
+\`\`\`
+your-site.zip
+├── manifest.json      <- REQUIRED
+├── pages/
+│   ├── index.html
+│   └── ...
+├── public/
+│   └── css/, js/, images/
+└── templates/         (optional, for CMS)
+\`\`\`
+`;
+        }
+        const manifestContent = manifestEntry.getData().toString('utf8');
+        // Collect template contents for validation
+        const templateContents = {};
+        for (const entry of entries) {
+            if (entry.entryName.endsWith('.html') && !entry.isDirectory) {
+                try {
+                    templateContents[entry.entryName] = entry.getData().toString('utf8');
+                }
+                catch {
+                    // Skip files that can't be read
+                }
+            }
+        }
+        // Run full package validation
+        const validationResult = await (0, validate_package_1.validatePackage)(fileList, manifestContent, templateContents);
+        // Only block on actual ERRORS, not warnings
+        if (validationResult.includes('HAS ERRORS') || validationResult.includes('INVALID')) {
+            return `# DEPLOYMENT BLOCKED
+
+Your package has validation errors that must be fixed before deployment.
+
+---
+
+${validationResult}
+
+---
+
+## Next Steps
+
+1. Fix the errors listed above
+2. Rebuild your .zip package
+3. Run \`deploy_package\` again
+
+Use \`validate_template\` and \`validate_manifest\` to check individual files.
+`;
+        }
+        // Validation passed - include summary in success response later
+        console.error('Pre-deploy validation passed');
+    }
+    catch (validationError) {
+        // If validation itself fails (e.g., corrupt zip), log but continue
+        // The upload will fail with a more specific error if the package is truly broken
+        console.error('Pre-deploy validation error:', validationError);
+    }
+    // Upload the package
+    console.error(`Deploying to ${subdomain}.fastmode.ai...`);
+    const uploadResult = await uploadPackage(projectId, zipBuffer);
+    if ('error' in uploadResult) {
+        // Check if it's an auth error
+        if ((0, api_client_1.needsAuthError)({ success: false, error: uploadResult.error, statusCode: 401 })) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated) {
+                return authResult.message;
+            }
+            // Retry upload
+            const retryResult = await uploadPackage(projectId, zipBuffer);
+            if ('error' in retryResult) {
+                return `# Upload Failed
+
+${retryResult.error}
+
+Please check:
+1. The package is a valid .zip file
+2. It contains manifest.json, pages/, and public/ folders
+3. Try again or upload manually at app.fastmode.ai
+`;
+            }
+            return formatSuccess(subdomain, retryResult);
+        }
+        return `# Upload Failed
+
+${uploadResult.error}
+
+Please check:
+1. The package is a valid .zip file
+2. It contains manifest.json, pages/, and public/ folders
+3. Try again or upload manually at app.fastmode.ai
+`;
+    }
+    return formatSuccess(subdomain, uploadResult);
+}
+/**
+ * Format success message
+ */
+function formatSuccess(subdomain, result) {
+    return `# Deployment Successful!
+
+**Package deployed!**
+
+## Live Site
+
+**URL:** https://${subdomain}.fastmode.ai
+
+## Details
+
+- **Files Uploaded:** ${result.filesUploaded}
+- **Pages:** ${result.pages}
+- **Version:** ${result.site.packageVersion}
+- **Status:** ${result.site.status}
+
+## Next Steps
+
+1. **View your site:** https://${subdomain}.fastmode.ai
+2. **Edit content:** Go to app.fastmode.ai to manage your CMS
+3. **Connect GitHub:** For automatic deploys on push
+
+---
+
+To update this site later:
+\`\`\`
+deploy_package(packagePath: "./updated-site.zip", projectId: "${result.site.id}")
+\`\`\`
+`;
+}

package/dist/tools/generate-samples.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generate Sample Items Tool
+ *
+ * Generates sample items for collections with automatic dependency ordering.
+ * Handles relation fields by generating parent collections first.
+ * Requires authentication.
+ */
+interface GenerateSamplesInput {
+    projectId: string;
+    collectionSlugs?: string[];
+}
+/**
+ * Generate sample items for collections
+ *
+ * @param input - The input with projectId and optional collectionSlugs
+ */
+export declare function generateSampleItems(input: GenerateSamplesInput): Promise<string>;
+export {};
+//# sourceMappingURL=generate-samples.d.ts.map

package/dist/tools/generate-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-samples.d.ts","sourceRoot":"","sources":["../../src/tools/generate-samples.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAmID;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoLtF"}