@content-island/mcp 0.2.0 → 0.2.2

package/dist/index.js

@@ -1,38 +1,38 @@
-import { z as i } from "zod";
+import { z as a } from "zod";
 import { McpServer as w } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { createClient as v } from "@content-island/api-client";
+import { createClient as v, isApiClientError as R } from "@content-island/api-client";
 import { readFile as S } from "node:fs/promises";
-import { basename as A, extname as R } from "node:path";
-import { StdioServerTransport as O } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { basename as A, extname as O } from "node:path";
+import { StdioServerTransport as x } from "@modelcontextprotocol/sdk/server/stdio.js";
 const f = {
   CONTENT_ISLAND_ACCESS_TOKEN: process.env.CONTENT_ISLAND_ACCESS_TOKEN,
   CONTENT_ISLAND_DOMAIN: process.env.CONTENT_ISLAND_DOMAIN,
   CONTENT_ISLAND_SECURE_PROTOCOL: process.env.CONTENT_ISLAND_SECURE_PROTOCOL !== "false",
   CONTENT_ISLAND_API_VERSION: process.env.CONTENT_ISLAND_API_VERSION
-}, I = "PREVIEW_", x = (e) => e.startsWith(I) ? e : `${I}${e}`, g = () => v({
-  accessToken: x(f.CONTENT_ISLAND_ACCESS_TOKEN),
+}, T = "PREVIEW_", L = (e) => e.startsWith(T) ? e : `${T}${e}`, g = () => v({
+  accessToken: L(f.CONTENT_ISLAND_ACCESS_TOKEN),
   domain: f.CONTENT_ISLAND_DOMAIN,
   secureProtocol: f.CONTENT_ISLAND_SECURE_PROTOCOL,
   apiVersion: f.CONTENT_ISLAND_API_VERSION
-}), L = "0.2.0", k = {
-  version: L
+}), k = "0.2.2", P = {
+  version: k
 }, u = new w({
   name: "Content Island",
-  version: k.version
+  version: P.version
 }), j = () => {
   u.prompt(
     "create-content-island-project",
     "Professional MCP Server prompt for creating modern frontend projects integrated with Content Island CMS",
     {
-      framework: i.string().describe("Framework choice (Next.js, Astro, Nuxt, etc.)"),
-      pages: i.string().describe("Pages needed (Homepage, Blog, Contact, etc.)"),
-      location: i.string().describe("Project location (root directory or subfolder name)"),
-      styling: i.string().describe("Styling preference (Tailwind CSS or custom)"),
-      design: i.string().describe("Design assets (mockups, wireframes, or none)")
+      framework: a.string().describe("Framework choice (Next.js, Astro, Nuxt, etc.)"),
+      pages: a.string().describe("Pages needed (Homepage, Blog, Contact, etc.)"),
+      location: a.string().describe("Project location (root directory or subfolder name)"),
+      styling: a.string().describe("Styling preference (Tailwind CSS or custom)"),
+      design: a.string().describe("Design assets (mockups, wireframes, or none)")
     },
     async (e) => {
-      const { framework: t, pages: a, location: n, styling: o, design: s } = e;
-      return t && a && n && o && s ? {
+      const { framework: t, pages: i, location: n, styling: o, design: r } = e;
+      return t && i && n && o && r ? {
         description: "Content Island project generator",
         messages: [
           {
@@ -45,10 +45,10 @@ I'll create a professional ${t} application integrated with your Content Island
 
 **Configuration:**
 - Framework: **${t}**
-- Pages: ${a}
+- Pages: ${i}
 - Location: ${n}
 - Styling: ${o}
-- Design: ${s}
+- Design: ${r}
 
 # CRITICAL IMPLEMENTATION INSTRUCTIONS - FOLLOW EXACTLY
 
@@ -141,9 +141,9 @@ ${t === "Nuxt" ? `
 ### STEP 6: PROJECT STRUCTURE GENERATION (FRAMEWORK-SPECIFIC)
 - Framework: ${t}
 - Location: ${n}
-- Pages requested: ${a}
+- Pages requested: ${i}
 - Styling: ${o}
-- Design approach: ${s}
+- Design approach: ${r}
 
 #### FRAMEWORK-SPECIFIC REQUIREMENTS:
 ${t === "Next.js" ? `
@@ -273,7 +273,7 @@ ${t === "Nuxt" ? `
 □ All content types have corresponding API functions using official client
 `}
 □ TypeScript interfaces exactly match project structure
-□ All requested pages (${a}) are implemented
+□ All requested pages (${i}) are implemented
 □ Error handling implemented for all API calls
 □ Loading states implemented for all data fetching
 □ Responsive design implemented
@@ -319,34 +319,22 @@ Please provide all this information so I can create your project.`
       };
     }
   );
-}, P = () => {
+}, U = () => {
   j();
-}, U = {
-  401: "Invalid or expired token. Check your CONTENT_ISLAND_ACCESS_TOKEN configuration.",
-  403: "This token does not have write permissions. Configure a write token in CONTENT_ISLAND_ACCESS_TOKEN.",
-  404: "Resource not found. Verify that the content type, content ID, or project exists."
-}, M = (e) => {
-  const t = U[e.status] ?? `API error: ${e.status} ${e.statusText}`;
-  if (!e.body)
-    return t;
-  const a = [];
-  if (e.body.error && a.push(e.body.error), e.body.fieldErrors)
-    for (const [n, o] of Object.entries(e.body.fieldErrors)) {
-      const s = typeof o == "string" ? o : JSON.stringify(o);
-      a.push(`  - ${n}: ${s}`);
-    }
-  return a.length > 0 ? `${t}
-${a.join(`
-`)}` : t;
-}, h = (e) => {
-  let t = e instanceof Error ? e.message : String(e);
-  try {
-    const a = JSON.parse(t);
-    t = M(a);
-  } catch {
-  }
-  return { content: [{ type: "text", text: t }], isError: !0 };
-}, F = () => {
+}, D = {
+  UNAUTHORIZED: "Invalid or expired token. Check your CONTENT_ISLAND_ACCESS_TOKEN configuration.",
+  FORBIDDEN: "This token does not have write permissions. Configure a write token in CONTENT_ISLAND_ACCESS_TOKEN.",
+  NOT_FOUND: "Resource not found. Verify that the content type, content ID, or project exists.",
+  VALIDATION_ERROR: "Invalid input. See details below.",
+  NETWORK_ERROR: "Could not reach Content Island. Check your network and the API endpoint configuration."
+}, F = (e) => D[e.code] ?? `API error: ${e.status} ${e.code}`, M = (e) => {
+  const t = e.details?.fields;
+  return Array.isArray(t) ? t.map((i) => `  - ${i.field}: ${i.message}`) : [];
+}, _ = (e) => {
+  const t = [F(e), e.message, ...M(e)];
+  return e.requestId && t.push(`(requestId: ${e.requestId})`), t.join(`
+`);
+}, h = (e) => R(e) ? { content: [{ type: "text", text: _(e) }], isError: !0 } : { content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }], isError: !0 }, $ = () => {
   u.tool(
     "create-content-island-content",
     `Create a new content entry in the Content Island project. Requires a write token.
@@ -398,21 +386,21 @@ If the user asks you to create content from a web URL, follow this workflow:
 4. Replace every original image URL in the extracted content with the "url" returned by upload-content-island-media. Never leave the original external URLs — they may become broken links if the source site removes them.
 5. Only then call this tool with the fully processed payload.`,
     {
-      contentType: i.string().describe(
+      contentType: a.string().describe(
         'The content type name (e.g. "post", "page"). Must match an existing content type name exactly. Use get-content-island-project to discover available content types.'
       ),
-      name: i.string().describe("Display name for the new content entry."),
-      content: i.array(
-        i.object({
-          language: i.string().optional().describe(
+      name: a.string().describe("Display name for the new content entry."),
+      content: a.array(
+        a.object({
+          language: a.string().optional().describe(
             `Language code (e.g. "en", "es"). Must be one of the languages from the project. Defaults to the project's first language if omitted.`
           ),
-          fields: i.array(
-            i.object({
-              name: i.string().describe(
+          fields: a.array(
+            a.object({
+              name: a.string().describe(
                 "Field name exactly as defined in the content type schema from get-content-island-project."
               ),
-              value: i.any().describe(
+              value: a.any().describe(
                 "Field value. Must match the type and constraints of the field as described in the tool description above."
               )
             })
@@ -422,18 +410,18 @@ If the user asks you to create content from a web URL, follow this workflow:
         "Content entries per language. Provide one entry per language in the project. If omitted, creates an empty content with no field values."
       )
     },
-    async ({ contentType: e, name: t, content: a }) => {
+    async ({ contentType: e, name: t, content: i }) => {
       try {
-        const n = g(), o = { contentType: e, name: t, content: a }, s = await n.createContent(o);
+        const n = g(), o = { contentType: e, name: t, content: i }, r = await n.createContent(o);
         return {
-          content: [{ type: "text", text: JSON.stringify(s, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify(r, null, 2) }]
         };
       } catch (n) {
         return h(n);
       }
     }
   );
-}, D = () => {
+}, V = () => {
   u.tool(
     "get-content-island-project",
     `Get the user's Content Island project schema (languages and contentTypes).
@@ -457,7 +445,7 @@ The "languages" array at the project root lists every language the project suppo
       };
     }
   );
-}, m = 25, y = 100, _ = () => {
+}, m = 25, y = 100, q = () => {
   u.tool(
     "list-content-island-contents",
     `List content entries of the Content Island project. Returns the raw content structure with all fieldValues (each one carries its fieldName, language and value), so you can inspect every translation in one call. Drafts and unpublished values are included.
@@ -483,33 +471,33 @@ Sort (optional): object with any of:
 - contentType: "asc" | "desc"
 - lastUpdate: "asc" | "desc"`,
     {
-      contentType: i.string().optional().describe("Filter by content type name. Must match an existing content type from get-content-island-project."),
-      id: i.union([i.string(), i.array(i.string())]).optional().describe("A single content id, or an array of ids to fetch a specific subset of contents."),
-      language: i.string().optional().describe(
+      contentType: a.string().optional().describe("Filter by content type name. Must match an existing content type from get-content-island-project."),
+      id: a.union([a.string(), a.array(a.string())]).optional().describe("A single content id, or an array of ids to fetch a specific subset of contents."),
+      language: a.string().optional().describe(
         'Language code (e.g. "en", "es"). Restricts which fieldValues are included inside each content. Does not remove contents that lack a translation in the given language.'
       ),
-      status: i.union([i.enum(["draft", "changed", "published"]), i.array(i.enum(["draft", "changed", "published"]))]).optional().describe(
+      status: a.union([a.enum(["draft", "changed", "published"]), a.array(a.enum(["draft", "changed", "published"]))]).optional().describe(
         'Filter by publication state. Pass a single value (e.g. "draft") or an array (e.g. ["draft", "changed"]) to find contents with unpublished data.'
       ),
-      includeRelatedContent: i.boolean().optional().describe("When true, related content references are expanded inline in fieldValues."),
-      sort: i.object({
-        contentType: i.enum(["asc", "desc"]).optional(),
-        lastUpdate: i.enum(["asc", "desc"]).optional()
+      includeRelatedContent: a.boolean().optional().describe("When true, related content references are expanded inline in fieldValues."),
+      sort: a.object({
+        contentType: a.enum(["asc", "desc"]).optional(),
+        lastUpdate: a.enum(["asc", "desc"]).optional()
       }).optional().describe('Sort order. Each field is independently set to "asc" or "desc".'),
-      take: i.number().int().min(1).max(y).optional().describe(`Maximum number of items to return. Default ${m}, maximum ${y}.`),
-      skip: i.number().int().min(0).optional().describe("Number of items to skip from the start of the result set. Use for pagination.")
+      take: a.number().int().min(1).max(y).optional().describe(`Maximum number of items to return. Default ${m}, maximum ${y}.`),
+      skip: a.number().int().min(0).optional().describe("Number of items to skip from the start of the result set. Use for pagination.")
     },
-    async ({ contentType: e, id: t, language: a, status: n, includeRelatedContent: o, sort: s, take: r, skip: d }) => {
+    async ({ contentType: e, id: t, language: i, status: n, includeRelatedContent: o, sort: r, take: s, skip: d }) => {
       try {
-        const l = g(), c = r ?? m, E = d ?? 0, p = {
+        const l = g(), c = s ?? m, E = d ?? 0, p = {
           pagination: { take: c, skip: E }
         };
-        e !== void 0 && (p.contentType = e), t !== void 0 && (p.id = Array.isArray(t) ? { in: t } : t), a !== void 0 && (p.language = a), n !== void 0 && (p.status = Array.isArray(n) ? { in: n } : n), o !== void 0 && (p.includeRelatedContent = o), s !== void 0 && (p.sort = s);
-        const T = await l.getRawContentList(p), C = {
-          items: T,
+        e !== void 0 && (p.contentType = e), t !== void 0 && (p.id = Array.isArray(t) ? { in: t } : t), i !== void 0 && (p.language = i), n !== void 0 && (p.status = Array.isArray(n) ? { in: n } : n), o !== void 0 && (p.includeRelatedContent = o), r !== void 0 && (p.sort = r);
+        const I = await l.getRawContentList(p), C = {
+          items: I,
           skip: E,
           take: c,
-          hasMore: T.length === c
+          hasMore: I.length === c
         };
         return {
           content: [{ type: "text", text: JSON.stringify(C, null, 2) }]
@@ -519,63 +507,63 @@ Sort (optional): object with any of:
       }
     }
   );
-}, $ = (e) => e?.type === "entity", b = (e) => !!(e == null || typeof e == "string" && e === "" || Array.isArray(e) && e.length === 0), N = (e, t) => t && Array.isArray(e) || typeof e == "string" ? e.length : null, V = (e) => {
+}, K = (e) => e?.type === "entity", N = (e) => !!(e == null || typeof e == "string" && e === "" || Array.isArray(e) && e.length === 0), b = (e, t) => t && Array.isArray(e) || typeof e == "string" ? e.length : null, W = (e) => {
   const t = e.lastIndexOf(".");
   return t === -1 ? null : e.slice(t);
-}, q = (e, t) => {
-  const a = typeof e == "string" ? e : e?.url;
-  if (typeof a != "string")
+}, B = (e, t) => {
+  const i = typeof e == "string" ? e : e?.url;
+  if (typeof i != "string")
     return !1;
-  const n = V(a);
+  const n = W(i);
   return n !== null && t.includes(n);
-}, K = (e, t, a) => {
+}, H = (e, t, i) => {
   switch (e.name) {
     case "required":
     case "unique":
       return null;
     case "min-length": {
-      const n = N(t, a.isArray), o = e.customArgs?.length;
+      const n = b(t, i.isArray), o = e.customArgs?.length;
       return n === null || typeof o != "number" ? null : n < o ? `expected min length ${o}, got ${n}` : null;
     }
     case "max-length": {
-      const n = N(t, a.isArray), o = e.customArgs?.length;
+      const n = b(t, i.isArray), o = e.customArgs?.length;
       return n === null || typeof o != "number" ? null : n > o ? `expected max length ${o}, got ${n}` : null;
     }
     case "media-type": {
-      const n = (e.customArgs?.allowedExtensions ?? []).map((r) => r.name);
-      return n.length === 0 ? null : (a.isArray && Array.isArray(t) ? t : [t]).some((r) => !q(r, n)) ? `media file extension not in allowed list (${n.join(", ")})` : null;
+      const n = (e.customArgs?.allowedExtensions ?? []).map((s) => s.name);
+      return n.length === 0 ? null : (i.isArray && Array.isArray(t) ? t : [t]).some((s) => !B(s, n)) ? `media file extension not in allowed list (${n.join(", ")})` : null;
     }
     default:
       return null;
   }
-}, W = (e, t) => {
-  const a = (e.contentTypes ?? []).find((r) => $(r) && r.name === t.contentType.name);
-  if (!a)
+}, Y = (e, t) => {
+  const i = (e.contentTypes ?? []).find((s) => K(s) && s.name === t.contentType.name);
+  if (!i)
     return {
       ok: !1,
       errors: [`content type "${t.contentType.name}" not found in project schema`]
     };
-  const n = [], o = e.languages ?? [], s = t.fields ?? [];
-  for (const r of a.fields)
-    if (r.isRequired)
+  const n = [], o = e.languages ?? [], r = t.fields ?? [];
+  for (const s of i.fields)
+    if (s.isRequired)
       for (const d of o) {
-        const l = s.find((c) => c.name === r.name && c.language === d);
-        (!l || b(l.value)) && n.push(`required field "${r.name}" is empty in language "${d}"`);
+        const l = r.find((c) => c.name === s.name && c.language === d);
+        (!l || N(l.value)) && n.push(`required field "${s.name}" is empty in language "${d}"`);
       }
-  for (const r of s) {
-    const d = a.fields.find((l) => l.name === r.name);
-    if (!(!d || b(r.value)))
+  for (const s of r) {
+    const d = i.fields.find((l) => l.name === s.name);
+    if (!(!d || N(s.value)))
       for (const l of d.validations ?? []) {
-        const c = K(l, r.value, d);
-        c && n.push(`field "${r.name}" [${r.language}]: ${c}`);
+        const c = H(l, s.value, d);
+        c && n.push(`field "${s.name}" [${s.language}]: ${c}`);
       }
   }
   return n.length === 0 ? { ok: !0 } : { ok: !1, errors: n };
-}, B = (e) => `Cannot publish content — preflight validation failed:
+}, G = (e) => `Cannot publish content — preflight validation failed:
 ${e.map((t) => `  - ${t}`).join(`
 `)}
 
-Fix the issues (e.g. via update-content-island-field-value) and retry. Use list-content-island-contents with the content id to inspect the current draft state.`, Y = () => {
+Fix the issues (e.g. via update-content-island-field-value) and retry. Use list-content-island-contents with the content id to inspect the current draft state.`, X = () => {
   u.tool(
     "publish-content-island-content",
     `Publish an existing content in the Content Island project. This promotes the current draft state to the live state visible to consumers without the PREVIEW_ token prefix. Requires a write token.
@@ -604,19 +592,19 @@ Errors:
 - 404 if the contentId does not exist.
 - 401/403 if the configured token is not a write token.`,
     {
-      contentId: i.string().describe("The id of the existing content entry to publish.")
+      contentId: a.string().describe("The id of the existing content entry to publish.")
     },
     async ({ contentId: e }) => {
       try {
-        const t = g(), [a, n] = await Promise.all([t.getProject(), t.getRawContent({ id: e })]);
+        const t = g(), [i, n] = await Promise.all([t.getProject(), t.getRawContent({ id: e })]);
         if (!n)
           return {
             content: [{ type: "text", text: `Content "${e}" not found.` }],
             isError: !0
           };
-        const o = W(a, n);
+        const o = Y(i, n);
         return o.ok === !1 ? {
-          content: [{ type: "text", text: B(o.errors) }],
+          content: [{ type: "text", text: G(o.errors) }],
           isError: !0
         } : (await t.publishContent(e), {
           content: [{ type: "text", text: JSON.stringify({ contentId: e, status: "published" }, null, 2) }]
@@ -626,7 +614,7 @@ Errors:
       }
     }
   );
-}, G = () => {
+}, z = () => {
   u.tool(
     "update-content-island-field-value",
     `Update or add a single field value of an existing content in the Content Island project. Requires a write token.
@@ -669,18 +657,18 @@ Fields whose "type" contains "|" (e.g. "abc123|Foo") are either ENUMS or RELATIO
 
 The tool always identifies the field by its name within the content type. If the field is renamed in the schema between calls, this tool will return a 404; refresh the schema with get-content-island-project and retry.`,
     {
-      contentId: i.string().describe("The id of the existing content entry to update."),
-      fieldName: i.string().describe("Name of the field as defined in the content type schema (from get-content-island-project)."),
-      language: i.string().describe('Language code of the field value (e.g. "en", "es"). Must be one of the project languages.'),
-      value: i.any().describe(
+      contentId: a.string().describe("The id of the existing content entry to update."),
+      fieldName: a.string().describe("Name of the field as defined in the content type schema (from get-content-island-project)."),
+      language: a.string().describe('Language code of the field value (e.g. "en", "es"). Must be one of the project languages.'),
+      value: a.any().describe(
         "The new field value. Must match the type and isArray of the field as described in the tool description above."
       )
     },
-    async ({ contentId: e, fieldName: t, language: a, value: n }) => {
+    async ({ contentId: e, fieldName: t, language: i, value: n }) => {
       try {
-        return await g().updateContentFieldValue(e, { fieldName: t, language: a }, n), {
+        return await g().updateContentFieldValue(e, { fieldName: t, language: i }, n), {
           content: [
-            { type: "text", text: JSON.stringify({ contentId: e, fieldName: t, language: a, status: "updated" }, null, 2) }
+            { type: "text", text: JSON.stringify({ contentId: e, fieldName: t, language: i, status: "updated" }, null, 2) }
           ]
         };
       } catch (o) {
@@ -688,7 +676,7 @@ The tool always identifies the field by its name within the content type. If the
       }
     }
   );
-}, H = {
+}, J = {
   ".png": "image/png",
   ".jpg": "image/jpeg",
   ".jpeg": "image/jpeg",
@@ -702,42 +690,42 @@ The tool always identifies the field by its name within the content type. If the
   ".mov": "video/quicktime",
   ".mp3": "audio/mpeg",
   ".wav": "audio/wav"
-}, J = (e) => /^https?:\/\//i.test(e), X = async (e) => {
+}, Q = (e) => /^https?:\/\//i.test(e), Z = async (e) => {
   const t = await fetch(e);
   if (!t.ok)
     throw new Error(`Failed to fetch ${e}: ${t.status} ${t.statusText}`);
-  const a = await t.blob(), n = new URL(e).pathname, o = A(n) || "download";
-  return { blob: a, fileName: o };
-}, z = async (e) => {
-  const t = await S(e), a = R(e).toLowerCase(), n = H[a] ?? "application/octet-stream", o = new Blob([t], { type: n }), s = A(e);
-  return { blob: o, fileName: s };
-}, Q = () => {
+  const i = await t.blob(), n = new URL(e).pathname, o = A(n) || "download";
+  return { blob: i, fileName: o };
+}, ee = async (e) => {
+  const t = await S(e), i = O(e).toLowerCase(), n = J[i] ?? "application/octet-stream", o = new Blob([t], { type: n }), r = A(e);
+  return { blob: o, fileName: r };
+}, te = () => {
   u.tool(
     "upload-content-island-media",
     "Upload a media file to the Content Island project. Accepts a local file path or a URL (http/https). Requires a write token. Note: file attachments in the chat cannot be uploaded directly — provide the file path on disk or a public URL instead.",
     {
-      source: i.string().describe(
+      source: a.string().describe(
         'Path to a local file or a URL (http/https) pointing to the media to upload. Examples: "./assets/hero.png", "https://example.com/photo.jpg". File attachments in the conversation cannot be used directly — ask the user for the file path or URL.'
       ),
-      fileName: i.string().optional().describe(
+      fileName: a.string().optional().describe(
         "Override the file name used in Content Island. Defaults to the file name from the source path or URL."
       )
     },
     async ({ source: e, fileName: t }) => {
       try {
-        const { blob: a, fileName: n } = J(e) ? await X(e) : await z(e), s = await g().uploadMedia({ file: a, fileName: t ?? n });
+        const { blob: i, fileName: n } = Q(e) ? await Z(e) : await ee(e), r = await g().uploadMedia({ file: i, fileName: t ?? n });
         return {
-          content: [{ type: "text", text: JSON.stringify(s, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify(r, null, 2) }]
         };
-      } catch (a) {
-        return h(a);
+      } catch (i) {
+        return h(i);
       }
     }
   );
-}, Z = () => {
-  D(), _(), F(), G(), Y(), Q();
+}, ne = () => {
+  V(), q(), $(), z(), X(), te();
 };
-P();
-Z();
-const ee = new O();
-await u.connect(ee);
+U();
+ne();
+const ae = new x();
+await u.connect(ae);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@content-island/mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Content Island - MCP (Model Context Protocol) server",
   "private": false,
   "sideEffects": false,
@@ -33,7 +33,7 @@
     "type-check": "tsc --noEmit --preserveWatchOutput"
   },
   "dependencies": {
-    "@content-island/api-client": "0.19.0",
+    "@content-island/api-client": "0.21.0",
     "@modelcontextprotocol/sdk": "1.13.3",
     "zod": "3.25.71"
   },