multisite-cms-mcp 1.0.13 → 1.0.16

package/dist/tools/get-schema.js

@@ -84,6 +84,94 @@ Downloadable files and documents.
 
 ---
 
+## Custom Collections
+
+Custom collections are tenant-defined content types created in the CMS dashboard. Each custom collection has its own slug and user-defined fields.
+
+**Token syntax:** Same as built-in collections
+- \`{{fieldSlug}}\` for text, number, boolean, image, url, date, select fields
+- \`{{{fieldSlug}}}\` for richText fields (MUST use triple braces)
+
+**Built-in tokens for all custom collections:**
+- \`{{slug}}\` - Item URL slug (if collection has slugs enabled)
+- \`{{url}}\` - Full item URL (e.g., /services/my-service)
+- \`{{publishedAt}}\` - Publish date (if collection has publish dates enabled)
+
+**Example - A "Services" collection with fields: title, image, description (richText), price:**
+\`\`\`html
+<section class="services">
+  {{#each services}}
+  <div class="service-card">
+    <img src="{{image}}" alt="{{title}}">
+    <h2><a href="{{url}}">{{title}}</a></h2>
+    {{{description}}}
+    <p class="price">\${{price}}</p>
+  </div>
+  {{/each}}
+</section>
+\`\`\`
+
+**Example - A "Testimonials" collection with fields: quote (richText), author, company, rating:**
+\`\`\`html
+<section class="testimonials">
+  {{#each testimonials limit=6}}
+  <blockquote class="testimonial">
+    {{{quote}}}
+    <cite>
+      <strong>{{author}}</strong>
+      {{#if company}}<span>{{company}}</span>{{/if}}
+    </cite>
+  </blockquote>
+  {{/each}}
+</section>
+\`\`\`
+
+**To see exact fields for a tenant's custom collections, use the \`get_tenant_schema\` tool.**
+
+---
+
+## Custom Fields on Built-in Collections
+
+Tenants can add custom fields to Blog Posts, Authors, Team Members, and Downloads. These custom fields work exactly like built-in fields.
+
+**Token syntax:**
+- \`{{customFieldSlug}}\` for text, number, boolean, image, url, date, select
+- \`{{{customFieldSlug}}}\` for richText fields
+
+**Example - "category" field added to blogs:**
+\`\`\`html
+{{#each blogs}}
+<article class="post-card">
+  <h2>{{name}}</h2>
+  {{#if category}}
+    <span class="category-badge">{{category}}</span>
+  {{/if}}
+  <p>{{postSummary}}</p>
+</article>
+{{/each}}
+\`\`\`
+
+**Example - "department" and "linkedinUrl" fields added to team:**
+\`\`\`html
+{{#each team sort="order" order="asc"}}
+<div class="team-member">
+  <img src="{{photo}}" alt="{{name}}">
+  <h3>{{name}}</h3>
+  <p class="role">{{role}}</p>
+  {{#if department}}
+    <p class="department">{{department}}</p>
+  {{/if}}
+  {{#if linkedinUrl}}
+    <a href="{{linkedinUrl}}">LinkedIn</a>
+  {{/if}}
+</div>
+{{/each}}
+\`\`\`
+
+**To see exact custom fields for a tenant, use the \`get_tenant_schema\` tool.**
+
+---
+
 ## Template Syntax Reference
 
 ### Loops
@@ -103,6 +191,7 @@ Downloadable files and documents.
 
 ### Conditionals
 \`\`\`html
+<!-- Check if a field has a value -->
 {{#if mainImage}}
   <img src="{{mainImage}}" alt="{{name}}">
 {{else}}
@@ -114,6 +203,50 @@ Downloadable files and documents.
 {{/unless}}
 \`\`\`
 
+### Collection Empty Checks (Page Level)
+Check if a collection has items - useful for "No posts yet" fallbacks:
+
+\`\`\`html
+{{#each blogs}}
+  <article>{{name}}</article>
+{{/each}}
+
+{{#unless blogs}}
+  <p>No posts yet. Check back soon!</p>
+{{/unless}}
+\`\`\`
+
+**Important:** The \`{{#if blogs}}\` and \`{{#unless blogs}}\` syntax checks if the collection has any published items. Use this OUTSIDE of \`{{#each}}\` loops for empty state handling.
+
+### Equality Comparisons in Conditionals
+Compare two field values using the \`(eq field1 field2)\` helper:
+
+\`\`\`html
+<!-- Show content when fields ARE equal -->
+{{#if (eq author.slug ../slug)}}
+  <span>This is your post!</span>
+{{/if}}
+
+<!-- Show content when fields are NOT equal -->
+{{#unless (eq slug ../slug)}}
+  <a href="{{url}}">{{name}}</a>
+{{/unless}}
+\`\`\`
+
+**Common use case - Related Posts (exclude current):**
+\`\`\`html
+<h3>Other Posts</h3>
+{{#each blogs limit=3}}
+  {{#unless (eq slug ../slug)}}
+    <article>
+      <a href="{{url}}">{{name}}</a>
+    </article>
+  {{/unless}}
+{{/each}}
+\`\`\`
+
+This pattern is essential for "Related Posts" sections where you want to show other posts but NOT the current one.
+
 ### Loop Variables
 Inside \`{{#each}}\` blocks:
 - \`{{@first}}\` - true for first item
@@ -149,17 +282,24 @@ Inside loops, access the parent scope (page's current item) using \`../\`:
 - Category pages: filter items by current category
 - Related items: match based on current detail page
 
-### Equality Comparisons
-Compare two values in conditionals:
+### Equality Helpers Summary
 
+| Syntax | When to use | Shows content when... |
+|--------|-------------|----------------------|
+| \`{{#if (eq field1 field2)}}\` | Compare two fields | Fields ARE equal |
+| \`{{#unless (eq field1 field2)}}\` | Exclude matches | Fields are NOT equal |
+| \`{{#eq field "value"}}\` | Compare to string | Field equals string |
+
+**Examples:**
 \`\`\`html
-{{#if (eq author.name ../name)}}
-  <!-- True when fields match -->
-{{/if}}
+<!-- Show only when author matches current page -->
+{{#if (eq author.slug ../slug)}}...{{/if}}
+
+<!-- Show all EXCEPT current item (Related Posts pattern) -->
+{{#unless (eq slug ../slug)}}...{{/unless}}
 
-{{#eq status "published"}}
-  <!-- Compare field to literal string -->
-{{/eq}}
+<!-- Compare field to a literal value -->
+{{#eq status "published"}}...{{/eq}}
 \`\`\`
 
 ### Rich Text (Triple Braces)

package/dist/tools/get-tenant-schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fetches the complete schema for a specific project including:
+ * - Built-in collections with their standard fields
+ * - Custom fields added to built-in collections
+ * - Custom collections with all their fields
+ *
+ * Uses stored credentials or triggers device flow for authentication.
+ *
+ * @param projectId - Project ID (UUID) or project name
+ */
+export declare function getTenantSchema(projectId: string): Promise<string>;
+//# sourceMappingURL=get-tenant-schema.d.ts.map

package/dist/tools/get-tenant-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tenant-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-tenant-schema.ts"],"names":[],"mappings":"AA2EA;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFxE"}

package/dist/tools/get-tenant-schema.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTenantSchema = getTenantSchema;
+const api_client_1 = require("../lib/api-client");
+const device_flow_1 = require("../lib/device-flow");
+/**
+ * Resolve a project identifier to a tenant ID
+ * Accepts either a UUID or a project name
+ */
+async function resolveProjectId(projectIdentifier) {
+    // Check if it looks like a UUID
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidPattern.test(projectIdentifier)) {
+        // It's already a UUID, use it directly
+        return { tenantId: projectIdentifier };
+    }
+    // Otherwise, look up by name using /api/tenants
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        return { error: `Failed to look up project: ${response.error}` };
+    }
+    const projects = response.data;
+    // Find by exact name match (case-insensitive)
+    const match = projects.find(p => p.name.toLowerCase() === projectIdentifier.toLowerCase());
+    if (match) {
+        return { tenantId: match.id };
+    }
+    // Try partial match
+    const partialMatch = projects.find(p => p.name.toLowerCase().includes(projectIdentifier.toLowerCase()));
+    if (partialMatch) {
+        return { tenantId: partialMatch.id };
+    }
+    // List available projects for the user
+    const availableProjects = projects.map(p => `- ${p.name} (${p.id})`).join('\n');
+    return {
+        error: `Project "${projectIdentifier}" not found.\n\nAvailable projects:\n${availableProjects || 'None'}\n\nUse list_projects to see all your projects.`
+    };
+}
+/**
+ * Fetches the complete schema for a specific project including:
+ * - Built-in collections with their standard fields
+ * - Custom fields added to built-in collections
+ * - Custom collections with all their fields
+ *
+ * Uses stored credentials or triggers device flow for authentication.
+ *
+ * @param projectId - Project ID (UUID) or project name
+ */
+async function getTenantSchema(projectId) {
+    // Check if we need to authenticate
+    if (await (0, api_client_1.needsAuthentication)()) {
+        const authResult = await (0, device_flow_1.ensureAuthenticated)();
+        if (!authResult.authenticated) {
+            return authResult.message;
+        }
+    }
+    // Resolve project identifier to tenant ID
+    const resolved = await resolveProjectId(projectId);
+    if ('error' in resolved) {
+        return `# Project Not Found
+
+${resolved.error}
+`;
+    }
+    const { tenantId } = resolved;
+    const apiUrl = (0, api_client_1.getApiUrl)();
+    // Fetch the AI prompt for this tenant
+    const response = await (0, api_client_1.apiRequest)('/api/cms/ai-prompt', {
+        tenantId,
+    });
+    if ((0, api_client_1.isApiError)(response)) {
+        // If auth error, try to re-authenticate
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated) {
+                return authResult.message;
+            }
+            // Retry the request
+            const retryResponse = await (0, api_client_1.apiRequest)('/api/cms/ai-prompt', {
+                tenantId,
+            });
+            if ((0, api_client_1.isApiError)(retryResponse)) {
+                return `# API Error
+
+Failed to fetch project schema: ${retryResponse.error}
+
+**Project ID:** ${tenantId}
+**Status:** ${retryResponse.statusCode}
+
+Please try authenticating again.
+`;
+            }
+            return formatSchemaResponse(retryResponse.data, tenantId);
+        }
+        if (response.statusCode === 403) {
+            return `# Authorization Error
+
+You don't have permission to access this project's schema.
+
+**Project ID:** ${tenantId}
+
+Make sure:
+1. You have membership in this project
+2. Try running \`list_projects\` to see your accessible projects
+`;
+        }
+        return `# API Error
+
+Failed to fetch project schema: ${response.error}
+
+**Project ID:** ${tenantId}
+**API URL:** ${apiUrl}
+**Status:** ${response.statusCode}
+
+Please verify:
+1. The project ID is correct
+2. You have network connectivity
+`;
+    }
+    return formatSchemaResponse(response.data, tenantId);
+}
+/**
+ * Format the schema response for display
+ */
+function formatSchemaResponse(data, tenantId) {
+    if (!data?.prompt) {
+        return `# Unexpected Response
+
+The API returned a successful response but the prompt data was missing.
+
+**Project ID:** ${tenantId}
+**Response:** ${JSON.stringify(data, null, 2).slice(0, 500)}
+`;
+    }
+    // Return the full AI prompt which includes all schema information
+    return `# Project Schema
+
+**Project ID:** \`${tenantId}\`
+
+The following schema is specific to this project and includes all custom collections and custom fields.
+
+---
+
+${data.prompt}
+`;
+}

package/dist/tools/list-projects.d.ts

@@ -0,0 +1,5 @@
+/**
+ * List all FastMode projects the authenticated user has access to
+ */
+export declare function listProjects(): Promise<string>;
+//# sourceMappingURL=list-projects.d.ts.map

package/dist/tools/list-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.d.ts","sourceRoot":"","sources":["../../src/tools/list-projects.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAkDpD"}

package/dist/tools/list-projects.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listProjects = listProjects;
+const api_client_1 = require("../lib/api-client");
+const device_flow_1 = require("../lib/device-flow");
+/**
+ * List all FastMode projects the authenticated user has access to
+ */
+async function listProjects() {
+    // Check if we need to authenticate
+    if (await (0, api_client_1.needsAuthentication)()) {
+        const authResult = await (0, device_flow_1.ensureAuthenticated)();
+        if (!authResult.authenticated) {
+            return authResult.message;
+        }
+    }
+    // Fetch user's tenants/projects
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        // If auth error, try to re-authenticate
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated) {
+                return authResult.message;
+            }
+            // Retry the request
+            const retryResponse = await (0, api_client_1.apiRequest)('/api/tenants');
+            if ((0, api_client_1.isApiError)(retryResponse)) {
+                return `# API Error
+
+Failed to fetch projects: ${retryResponse.error}
+
+**Status:** ${retryResponse.statusCode}
+
+Please try authenticating again.
+`;
+            }
+            return formatProjectList(retryResponse.data);
+        }
+        return `# API Error
+
+Failed to fetch projects: ${response.error}
+
+**Status:** ${response.statusCode}
+
+Please check:
+1. Your authentication is valid
+2. The API URL is correct
+3. You have network connectivity
+`;
+    }
+    return formatProjectList(response.data);
+}
+/**
+ * Format the project list for display
+ */
+function formatProjectList(projects) {
+    if (!projects || projects.length === 0) {
+        return `# No Projects Found
+
+You don't have access to any FastMode projects.
+
+**To create a project:**
+1. Go to app.fastmode.ai
+2. Click "Create New Project"
+3. Run \`list_projects\` again to see it here
+`;
+    }
+    // Format the project list
+    let output = `# Your FastMode Projects
+
+Found ${projects.length} project${projects.length > 1 ? 's' : ''}:
+
+`;
+    projects.forEach((project, index) => {
+        const siteStatus = project.site?.status || 'pending';
+        output += `## ${index + 1}. ${project.name}
+
+- **Project ID:** \`${project.id}\`
+- **Subdomain:** ${project.subdomain}.fastmode.ai
+${project.customDomain ? `- **Custom Domain:** ${project.customDomain}\n` : ''}- **Your Role:** ${project.role}
+- **Site Status:** ${siteStatus}
+
+`;
+    });
+    output += `---
+
+## How to Use
+
+To get the schema for a project, use:
+\`\`\`
+get_tenant_schema(projectId: "${projects[0]?.id || 'project-id-here'}")
+\`\`\`
+
+Or use the project name:
+\`\`\`
+get_tenant_schema(projectId: "${projects[0]?.name || 'Project Name'}")
+\`\`\`
+`;
+    return output;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.0.13",
+  "version": "1.0.16",
   "description": "MCP server for AI-assisted website conversion to CMS format. Provides validation, examples, and schema tools.",
   "main": "dist/index.js",
   "bin": {