multisite-cms-mcp 1.7.0 → 1.7.1

package/dist/tools/get-conversion-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAooCtK;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+F1E"}
+{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAotCtK;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+F1E"}

package/dist/tools/get-conversion-guide.js

@@ -744,7 +744,7 @@ Forms are automatically captured by the CMS.
 ## Basic Form Setup
 
 \`\`\`html
-<form data-form-name="contact">
+<form data-form-name="contact" action="/_forms/contact" method="POST">
   <input type="text" name="name" required>
   <input type="email" name="email" required>
   <textarea name="message" required></textarea>
@@ -755,6 +755,8 @@ Forms are automatically captured by the CMS.
 ## Required Attributes
 
 - \`data-form-name="xxx"\` on the form element
+- \`action="/_forms/xxx"\` pointing to the form endpoint (MUST match data-form-name)
+- \`method="POST"\` for form submission
 - \`name="fieldName"\` on each input
 
 ## Form Handler Script
@@ -787,6 +789,60 @@ document.querySelectorAll('form[data-form-name]').forEach(form => {
 
 **CRITICAL:** The form endpoint is \`/_forms/{formName}\` - NOT \`/api/forms/submit\`
 
+---
+
+## CRITICAL: Remove Original Form Handlers
+
+**If the source site has JavaScript that handles form submissions, you MUST modify or remove it!**
+
+The original site's JavaScript often does:
+- \`e.preventDefault()\` - blocks the actual form submission
+- Shows a "fake" success toast/message - but data goes nowhere
+- Never actually submits to a server
+
+### What to Look For in Original JS
+
+\`\`\`javascript
+// PROBLEM: This blocks real submissions!
+form.addEventListener('submit', (e) => {
+  e.preventDefault();
+  // ... validation ...
+  showToast('Message sent!');  // FAKE! Data not saved!
+});
+\`\`\`
+
+### What You Must Do
+
+**Option A: Use Native Form Submission (Simplest)**
+\`\`\`html
+<form data-form-name="contact" action="/_forms/contact" method="POST">
+  <input type="text" name="name" required>
+  <input type="email" name="email" required>
+  <button type="submit">Send</button>
+</form>
+\`\`\`
+Then **remove** the original JavaScript form handler entirely.
+
+**Option B: Keep JS but POST to Fast Mode**
+Replace the original handler with one that actually submits:
+\`\`\`javascript
+form.addEventListener('submit', async (e) => {
+  e.preventDefault();
+  const formName = form.dataset.formName;
+  const response = await fetch('/_forms/' + formName, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(Object.fromEntries(new FormData(form)))
+  });
+  if (response.ok) {
+    showToast('Message sent!');  // NOW it's real!
+    form.reset();
+  }
+});
+\`\`\`
+
+---
+
 ## Naming Conventions
 
 - Contact form → \`contact\`
@@ -1016,13 +1072,13 @@ assets/
 **CORRECT:**
 \`\`\`
 public/
-├── css/style.css    ← Served at /css/style.css
-└── js/main.js       ← Served at /js/main.js
+├── css/style.css    ← Reference as /public/css/style.css in HTML
+└── js/main.js       ← Reference as /public/js/main.js in HTML
 \`\`\`
 
 If CSS/JS isn't loading, check that:
-- Files are in \`public/\` folder
-- HTML references use paths like \`/css/style.css\` (not \`/public/css/style.css\`)
+- Files are in \`public/\` folder (NOT \`assets/\`)
+- HTML references use \`/public/css/style.css\` (WITH the /public/ prefix)
 
 ---
 
@@ -1132,6 +1188,30 @@ If external CSS/JS absolutely won't load, you can inline them in manifest.json:
 
 ---
 
+## 8. Keeping Original Form Handlers
+
+The source site often has JavaScript that "handles" form submissions with fake success messages.
+
+**WRONG (original site's JS):**
+\`\`\`javascript
+form.addEventListener('submit', (e) => {
+  e.preventDefault();
+  showToast('Message sent!');  // FAKE! Data goes nowhere!
+});
+\`\`\`
+
+**CORRECT (submit to Fast Mode):**
+\`\`\`html
+<form data-form-name="contact" action="/_forms/contact" method="POST">
+  <!-- inputs -->
+</form>
+\`\`\`
+Then REMOVE the original JavaScript handler, or replace it with one that actually POSTs to \`/_forms/{formName}\`.
+
+**See \`get_conversion_guide(section: "forms")\` for detailed form handling instructions.**
+
+---
+
 ## Validation Workflow
 
 Before deploying, ALWAYS run:

package/dist/tools/get-field-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-field-types.d.ts","sourceRoot":"","sources":["../../src/tools/get-field-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,EAqE5C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAqDrD"}
+{"version":3,"file":"get-field-types.d.ts","sourceRoot":"","sources":["../../src/tools/get-field-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,EA0E5C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAqDrD"}

package/dist/tools/get-field-types.js

@@ -51,6 +51,11 @@ exports.AVAILABLE_FIELD_TYPES = [
         label: 'Image',
         description: 'Image file or URL. Supports direct file uploads to storage. Use for photos, thumbnails, hero images.'
     },
+    {
+        value: 'file',
+        label: 'File',
+        description: 'Downloadable file (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ZIP, MP3, MP4, etc.). Max 10MB. Use in templates as a download link: <a href="{{field}}" download>Download</a>'
+    },
     {
         value: 'url',
         label: 'URL',

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

@@ -1 +1 @@
-{"version":3,"file":"get-started.d.ts","sourceRoot":"","sources":["../../src/tools/get-started.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsiBD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4FxE"}
+{"version":3,"file":"get-started.d.ts","sourceRoot":"","sources":["../../src/tools/get-started.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmjBD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA4FxE"}

package/dist/tools/get-started.js

@@ -376,20 +376,33 @@ create_site(name: "New Website Name")
 
 ---
 
-## Website Conversion Workflow
+## ⚠️ REQUIRED: Read Before Building
 
-### Step 1: Get the conversion guide
+**DO NOT SKIP THIS STEP.** The conversion guide contains CRITICAL information that prevents common failures:
+
+### Step 1: Read common mistakes FIRST
+\`\`\`
+get_conversion_guide(section: "common_mistakes")
+\`\`\`
+
+This section covers:
+- **Asset paths** - Why CSS/JS might 404 (MUST use /public/ prefix!)
+- **Form handling** - Why forms might not work (MUST remove original handlers!)
+- **data-edit-key** - Why text won't be editable (REQUIRED for static pages!)
+
+### Step 2: Read the full guide
 \`\`\`
 get_conversion_guide(section: "full")
 \`\`\`
 
-Or get specific sections:
+All sections:
 - \`first_steps\` - Required initial setup
 - \`structure\` - Package folder structure  
 - \`manifest\` - manifest.json configuration
 - \`templates\` - Template creation patterns
 - \`tokens\` - CMS token reference
-- \`common_mistakes\` - Avoid these errors!
+- \`forms\` - Form submission setup
+- \`common_mistakes\` - Critical errors to avoid
 
 ### Step 2: Build and validate as you go
 \`\`\`

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

@@ -1 +1 @@
-{"version":3,"file":"validate-package.d.ts","sourceRoot":"","sources":["../../src/tools/validate-package.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,eAAe,EAAE,MAAM,EACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CA8TjB"}
+{"version":3,"file":"validate-package.d.ts","sourceRoot":"","sources":["../../src/tools/validate-package.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,eAAe,EAAE,MAAM,EACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CA4VjB"}

package/dist/tools/validate-package.js

@@ -257,6 +257,34 @@ Reference in HTML as: /images/${fileName}
 Files outside public/ will not be served and will cause 404 errors.`);
         }
     }
+    // 9. Check JS files for potential form handler conflicts
+    if (templateContents) {
+        for (const [path, content] of Object.entries(templateContents)) {
+            if (path.endsWith('.js')) {
+                // Check for form submit handlers that might block CMS form submission
+                const hasSubmitListener = content.includes('addEventListener') && content.includes('submit');
+                const hasPreventDefault = content.includes('preventDefault');
+                const hasFormsEndpoint = content.includes('/_forms/');
+                if (hasSubmitListener && hasPreventDefault && !hasFormsEndpoint) {
+                    warnings.push(`POTENTIAL FORM ISSUE: ${path} has form handlers with preventDefault() but no /_forms/ endpoint.
+
+This JavaScript may block form submissions from reaching Fast Mode!
+
+LOOK FOR patterns like:
+  form.addEventListener('submit', (e) => {
+    e.preventDefault();
+    showToast('Message sent!');  // FAKE - data not saved!
+  });
+
+FIX BY either:
+1. Remove the original handler entirely (use native form submission)
+2. Update handler to POST to /_forms/{formName}
+
+See get_conversion_guide(section: "forms") for proper form setup.`);
+                }
+            }
+        }
+    }
     // Build result
     let output = '';
     if (errors.length === 0) {

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,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAuTrE;;;;;;;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,CA6kBjB"}
+{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAmUrE;;;;;;;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,CA8kBjB"}

package/dist/tools/validate-template.js

@@ -121,16 +121,30 @@ function validateForms(html) {
         const hasLegacyDataFormName = /data-form-name=["'][^"']+["']/i.test(formTag);
         if (hasDataForm) {
             formsWithDataForm++;
+            // Check if form has proper action attribute pointing to /_forms/
+            if (!formTag.includes('action=')) {
+                errors.push(`- Form has data-form but no action attribute. Add action="/_forms/formname" for the form to work.`);
+            }
+            else if (!formTag.includes('/_forms/')) {
+                warnings.push(`- Form has action but it doesn't point to /_forms/. Fast Mode forms must submit to /_forms/{formName}.`);
+            }
         }
         else if (hasLegacyDataFormName) {
             formsWithLegacyAttr++;
             warnings.push(`- Form uses deprecated data-form-name attribute. Migrate to data-form="formname" for consistency.`);
+            // Also check action for legacy forms
+            if (!formTag.includes('action=')) {
+                errors.push(`- Form has data-form-name but no action attribute. Add action="/_forms/formname" for the form to work.`);
+            }
+            else if (!formTag.includes('/_forms/')) {
+                warnings.push(`- Form has action but it doesn't point to /_forms/. Fast Mode forms must submit to /_forms/{formName}.`);
+            }
         }
         else {
             // Form without any data-form attribute - check if it looks like a CMS form
-            // Don't error on forms that might be external (like search forms)
+            // Don't error on forms that might be external (like search forms, login forms)
             if (!formTag.includes('action=')) {
-                errors.push(`- Form is missing data-form attribute. Add data-form="formname" to identify the form for CMS submission.`);
+                errors.push(`- Form is missing data-form attribute. Add data-form="formname" and action="/_forms/formname" to identify the form for CMS submission.`);
             }
         }
     }
@@ -351,19 +365,20 @@ Without tokens, every item page will show the same static content.`);
         const hasHeadings = /<h[1-6][^>]*>[^<]+<\/h[1-6]>/gi.test(html);
         const hasParagraphs = /<p[^>]*>[^<]+<\/p>/gi.test(html);
         if (editKeys.length === 0 && (hasHeadings || hasParagraphs)) {
-            warnings.push(`MISSING INLINE EDITING: No data-edit-key attributes found.
+            errors.push(`MISSING INLINE EDITING: Static page has no data-edit-key attributes.
 
 Without data-edit-key, users CANNOT edit text content in the visual editor!
 
 WRONG (no inline editing):
-<h1>{{page_title}}</h1>
-<p>{{intro_text}}</p>
+<h1>Welcome</h1>
+<p>Introduction text here.</p>
 
 CORRECT (enables inline editing):
-<h1 data-edit-key="page_title">{{page_title}}</h1>
-<p data-edit-key="intro_text">{{intro_text}}</p>
+<h1 data-edit-key="hero-title">Welcome</h1>
+<p data-edit-key="hero-subtitle">Introduction text here.</p>
 
-Add data-edit-key to any text element the user should be able to edit.`);
+REQUIRED: Add data-edit-key="unique-name" to each text element that should be editable.
+Every heading, paragraph, button label, etc. needs its own unique key.`);
         }
         else if (editKeys.length > 0) {
             suggestions.push(`- Found ${editKeys.length} inline editing point(s) with data-edit-key`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "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": {