multisite-cms-mcp 1.2.2 → 1.2.4

package/dist/index.js

@@ -127,6 +127,7 @@ const TOOLS = [
                         'featured_posts',
                         'parent_context',
                         'equality_comparison',
+                        'youtube_embed',
                     ],
                     description: 'The type of example to retrieve',
                 },
@@ -192,7 +193,7 @@ const TOOLS = [
     },
     {
         name: 'deploy_package',
-        description: 'Deploy a website package (.zip file) to Fast Mode. Can deploy to an existing project or create a new one. Opens browser for authentication if not already logged in. Use list_projects first to see existing projects.',
+        description: 'Deploy a website package (.zip file) to Fast Mode. Will check for GitHub sync and block deployment if connected (to prevent conflicts). Use force:true to override. Opens browser for authentication if not already logged in.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -208,6 +209,10 @@ const TOOLS = [
                     type: 'string',
                     description: 'Optional: Create a new project with this name and deploy to it. Required if projectId is not provided and no projects exist.',
                 },
+                force: {
+                    type: 'boolean',
+                    description: 'Optional: Skip GitHub connection check and deploy anyway. Use with caution - may cause conflicts if GitHub auto-deploy is enabled.',
+                },
             },
             required: ['packagePath'],
         },
@@ -345,7 +350,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 result = await (0, create_site_1.createSite)(params.name, params.subdomain);
                 break;
             case 'deploy_package':
-                result = await (0, deploy_package_1.deployPackage)(params.packagePath, params.projectId, params.projectName);
+                result = await (0, deploy_package_1.deployPackage)(params.packagePath, params.projectId, params.projectName, params.force);
                 break;
             case 'get_field_types':
                 result = await (0, get_field_types_1.getFieldTypes)();

package/dist/tools/deploy-package.d.ts

@@ -4,6 +4,7 @@
  * @param packagePath - Path to the zip file
  * @param projectId - Optional: Deploy to existing project with this ID
  * @param projectName - Optional: Create new project with this name
+ * @param force - Optional: Skip GitHub connection check and deploy anyway
  */
-export declare function deployPackage(packagePath: string, projectId?: string, projectName?: string): Promise<string>;
+export declare function deployPackage(packagePath: string, projectId?: string, projectName?: string, force?: boolean): Promise<string>;
 //# sourceMappingURL=deploy-package.d.ts.map

package/dist/tools/deploy-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-package.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-package.ts"],"names":[],"mappings":"AA+MA;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA0IjB"}
+{"version":3,"file":"deploy-package.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-package.ts"],"names":[],"mappings":"AAmRA;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,CAwJjB"}

package/dist/tools/deploy-package.js

@@ -49,6 +49,60 @@ async function listExistingProjects() {
     }
     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
+`;
+}
 /**
  * Create a new site/project
  */
@@ -176,8 +230,9 @@ deploy_package(
  * @param packagePath - Path to the zip file
  * @param projectId - Optional: Deploy to existing project with this ID
  * @param projectName - Optional: Create new project with this name
+ * @param force - Optional: Skip GitHub connection check and deploy anyway
  */
-async function deployPackage(packagePath, projectId, projectName) {
+async function deployPackage(packagePath, projectId, projectName, force) {
     // Check authentication
     if (await (0, api_client_1.needsAuthentication)()) {
         const authResult = await (0, device_flow_1.ensureAuthenticated)();
@@ -263,6 +318,14 @@ Please try again or create the project manually at app.fastmode.ai
         const project = projects.find(p => p.id === targetProjectId);
         subdomain = project?.subdomain || '';
     }
+    // Check for GitHub connection (unless force is true or it's a new project)
+    if (!force && !projectName && targetProjectId) {
+        const githubStatus = await checkGitHubConnection(targetProjectId);
+        if (githubStatus?.connected && githubStatus.repo) {
+            // GitHub is connected - block deployment
+            return formatGitHubBlockMessage(githubStatus.repo, githubStatus.branch || 'main', subdomain);
+        }
+    }
     // Upload the package
     console.error(`Deploying to ${subdomain}.fastmode.ai...`);
     const uploadResult = await uploadPackage(targetProjectId, zipBuffer);

package/dist/tools/get-example.d.ts

@@ -1,4 +1,4 @@
-type ExampleType = 'manifest_basic' | 'manifest_custom_paths' | 'manifest_minimal_with_ui' | 'blog_index_template' | 'blog_post_template' | 'team_template' | 'downloads_template' | 'authors_template' | 'author_detail_template' | 'custom_collection_template' | 'form_handling' | 'asset_paths' | 'image_handling' | 'relation_fields' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison';
+type ExampleType = 'manifest_basic' | 'manifest_custom_paths' | 'manifest_minimal_with_ui' | 'blog_index_template' | 'blog_post_template' | 'team_template' | 'downloads_template' | 'authors_template' | 'author_detail_template' | 'custom_collection_template' | 'form_handling' | 'asset_paths' | 'image_handling' | 'relation_fields' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison' | 'youtube_embed';
 /**
  * Returns example code for a specific pattern
  */

package/dist/tools/get-example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,4BAA4B,GAC5B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,CAAC;AA0pC1B;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}
+{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,4BAA4B,GAC5B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,CAAC;AAsvCpB;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}

package/dist/tools/get-example.js

@@ -1155,6 +1155,97 @@ The most common pattern for "Related Posts" or "Other Items" sections:
 - Filter by current author/category - use \`{{#if (eq author.slug ../slug)}}\`
 - Highlight active items - use \`{{#if (eq ...)}}\`
 - Show badges for specific statuses - use \`{{#eq status "value"}}\``,
+    youtube_embed: `# YouTube Video Embeds
+
+**IMPORTANT:** YouTube iframes require specific attributes to work correctly. Missing attributes will cause Error 150/153 "Video player configuration error".
+
+## Correct YouTube Embed Format
+
+\`\`\`html
+<iframe 
+  src="{{videoUrl}}" 
+  title="{{name}}"
+  frameborder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 
+  referrerpolicy="strict-origin-when-cross-origin"
+  allowfullscreen
+></iframe>
+\`\`\`
+
+## Required Attributes
+
+| Attribute | Required | Why |
+|-----------|----------|-----|
+| \`referrerpolicy="strict-origin-when-cross-origin"\` | **YES** | YouTube blocks embeds without this |
+| \`allowfullscreen\` | Recommended | Enables fullscreen button |
+| \`allow="..."\` | Recommended | Enables player features |
+| \`frameborder="0"\` | Recommended | Removes border |
+| \`title="..."\` | Recommended | Accessibility for screen readers |
+
+## Common Mistake (Causes Error 153)
+
+\`\`\`html
+<!-- ❌ WRONG - Missing referrerpolicy -->
+<iframe src="{{videoUrl}}" allowfullscreen></iframe>
+
+<!-- ✅ CORRECT - All required attributes -->
+<iframe 
+  src="{{videoUrl}}" 
+  referrerpolicy="strict-origin-when-cross-origin"
+  allowfullscreen
+></iframe>
+\`\`\`
+
+## Video URL Format
+
+Store YouTube URLs in embed format:
+\`\`\`
+https://www.youtube.com/embed/VIDEO_ID
+\`\`\`
+
+**NOT** watch format:
+\`\`\`
+https://www.youtube.com/watch?v=VIDEO_ID  ❌
+\`\`\`
+
+## Full Example with Conditional
+
+\`\`\`html
+<div class="video-container">
+  {{#if videoUrl}}
+    <iframe 
+      src="{{videoUrl}}" 
+      title="{{name}}"
+      frameborder="0"
+      allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 
+      referrerpolicy="strict-origin-when-cross-origin"
+      allowfullscreen
+    ></iframe>
+  {{else}}
+    <div class="video-placeholder">
+      <p>Video coming soon</p>
+    </div>
+  {{/if}}
+</div>
+\`\`\`
+
+## Responsive Video CSS
+
+\`\`\`css
+.video-container {
+  position: relative;
+  width: 100%;
+  padding-bottom: 56.25%; /* 16:9 aspect ratio */
+}
+
+.video-container iframe {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+}
+\`\`\``,
 };
 /**
  * Returns example code for a specific pattern

package/dist/tools/validate-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AA6O7J;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA4ZjB"}
+{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AA6O7J;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAubjB"}

package/dist/tools/validate-template.js

@@ -302,6 +302,28 @@ async function validateTemplate(html, templateType, collectionSlug, projectId) {
     if (wrongAssetPaths.length > 5) {
         warnings.push(`- ...and ${wrongAssetPaths.length - 5} more asset paths that may need /public/ prefix`);
     }
+    // Check YouTube iframes for required attributes
+    // Match all iframes - we'll check if they're video embeds
+    const allIframes = html.match(/<iframe[^>]*>/gi) || [];
+    for (const iframe of allIframes) {
+        // Check if it's likely a video embed (YouTube URL or template token in src)
+        const isYouTubeEmbed = /youtube\.com|youtu\.be/i.test(iframe);
+        const hasTemplateSrc = /src=["'][^"']*\{\{[^}]+\}\}[^"']*["']/i.test(iframe);
+        if (isYouTubeEmbed || hasTemplateSrc) {
+            // Check for referrerpolicy
+            if (!/referrerpolicy/i.test(iframe)) {
+                errors.push(`- YouTube iframe missing referrerpolicy attribute. Add: referrerpolicy="strict-origin-when-cross-origin" (without this, YouTube will show Error 153)`);
+            }
+            // Check for allowfullscreen
+            if (!/allowfullscreen/i.test(iframe)) {
+                warnings.push(`- iframe missing allowfullscreen attribute - fullscreen button won't work`);
+            }
+            // Check for title (accessibility)
+            if (!/title=/i.test(iframe)) {
+                suggestions.push(`- Consider adding a title attribute to iframe for accessibility`);
+            }
+        }
+    }
     // Validate site tokens
     const siteTokens = html.match(/\{\{site\.(\w+)\}\}/g) || [];
     for (const token of siteTokens) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "MCP server for Fast Mode CMS. Convert websites, validate packages, and deploy directly to Fast Mode. Includes authentication, project creation, schema sync, and one-click deployment.",
   "main": "dist/index.js",
   "bin": {