mcp-magento-cms 1.0.0

package/src/magentoClient.js

@@ -0,0 +1,165 @@
+/**
+ * Magento REST client (Integration Access Token as Bearer).
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export function loadDotEnv() {
+  const envPath = path.join(__dirname, '..', '.env');
+  if (!fs.existsSync(envPath)) return;
+  const text = fs.readFileSync(envPath, 'utf8');
+  for (const line of text.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eq = trimmed.indexOf('=');
+    if (eq === -1) continue;
+    const key = trimmed.slice(0, eq).trim();
+    let val = trimmed.slice(eq + 1).trim();
+    if (
+      (val.startsWith('"') && val.endsWith('"')) ||
+      (val.startsWith("'") && val.endsWith("'"))
+    ) {
+      val = val.slice(1, -1);
+    }
+    if (process.env[key] === undefined) {
+      process.env[key] = val;
+    }
+  }
+}
+
+export class MagentoClient {
+  constructor({ baseUrl, token, storeCode = '', adminPath = 'admin' } = {}) {
+    this.baseUrl = String(baseUrl || '').replace(/\/+$/, '');
+    this.token = String(token || '').trim();
+    this.storeCode = String(storeCode || '').trim();
+    this.adminPath = String(adminPath || 'admin').replace(/^\/+|\/+$/g, '');
+  }
+
+  static fromEnv() {
+    loadDotEnv();
+    return new MagentoClient({
+      baseUrl: process.env.MAGENTO_BASE_URL,
+      token: process.env.MAGENTO_ACCESS_TOKEN,
+      storeCode: process.env.MAGENTO_STORE_CODE || '',
+      adminPath: process.env.MAGENTO_ADMIN_PATH || 'admin',
+    });
+  }
+
+  ensureConfig() {
+    if (!this.baseUrl) {
+      throw new Error('MAGENTO_BASE_URL is not set');
+    }
+    if (!this.token) {
+      throw new Error('MAGENTO_ACCESS_TOKEN is not set');
+    }
+  }
+
+  restPath(apiPath) {
+    let p = apiPath.startsWith('/') ? apiPath : `/${apiPath}`;
+    // Normalize to path after /V1
+    if (p.startsWith('/V1')) {
+      p = p.slice(3);
+    }
+    if (!p.startsWith('/')) {
+      p = `/${p}`;
+    }
+    if (this.storeCode) {
+      return `${this.baseUrl}/rest/${this.storeCode}/V1${p}`;
+    }
+    return `${this.baseUrl}/rest/V1${p}`;
+  }
+
+  async request(method, apiPath, body) {
+    this.ensureConfig();
+    const url = this.restPath(apiPath);
+    const headers = {
+      Authorization: `Bearer ${this.token}`,
+      Accept: 'application/json',
+      'Content-Type': 'application/json',
+    };
+    const res = await fetch(url, {
+      method,
+      headers,
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    const text = await res.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      data = text;
+    }
+    if (!res.ok) {
+      const msg =
+        typeof data === 'object' && data?.message
+          ? data.message
+          : typeof data === 'string'
+            ? data
+            : res.statusText;
+      throw new Error(`Magento ${method} ${url} failed (${res.status}): ${msg}`);
+    }
+    return data;
+  }
+
+  async get(apiPath) {
+    return this.request('GET', apiPath);
+  }
+
+  async post(apiPath, body) {
+    return this.request('POST', apiPath, body);
+  }
+
+  async put(apiPath, body) {
+    return this.request('PUT', apiPath, body);
+  }
+
+  pageEditUrl(pageId) {
+    return `${this.baseUrl}/${this.adminPath}/cms/page/edit/page_id/${pageId}`;
+  }
+
+  blockEditUrl(blockId) {
+    return `${this.baseUrl}/${this.adminPath}/cms/block/edit/block_id/${blockId}`;
+  }
+
+  async health() {
+    this.ensureConfig();
+    const result = await this.get(
+      '/cmsPage/search?searchCriteria[pageSize]=1&searchCriteria[currentPage]=1'
+    );
+    return {
+      ok: true,
+      baseUrl: this.baseUrl,
+      totalPagesSample: result?.total_count ?? null,
+    };
+  }
+
+  async getPage(pageId) {
+    return this.get(`/cmsPage/${pageId}`);
+  }
+
+  async createPage(page) {
+    return this.post('/cmsPage', { page });
+  }
+
+  async updatePage(pageId, page) {
+    return this.put(`/cmsPage/${pageId}`, { page: { ...page, id: Number(pageId) } });
+  }
+
+  async getBlock(blockId) {
+    return this.get(`/cmsBlock/${blockId}`);
+  }
+
+  async createBlock(block) {
+    return this.post('/cmsBlock', { block });
+  }
+
+  async updateBlock(blockId, block) {
+    return this.put(`/cmsBlock/${blockId}`, {
+      block: { ...block, id: Number(blockId) },
+    });
+  }
+}

package/src/pageBuilder.js

@@ -0,0 +1,108 @@
+/**
+ * Page Builder simple text: Row (contained) → Text
+ * Matches Brainvire_CmsContentStudio SimpleTextComposer.
+ */
+
+function escapeHtml(value) {
+  return String(value)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;');
+}
+
+function looksLikeHtml(value) {
+  return /<[^>]+>/.test(value);
+}
+
+function plainTextToParagraphs(text) {
+  const parts = String(text)
+    .split(/\r\n|\r|\n/)
+    .map((l) => l.trim())
+    .filter(Boolean)
+    .map((l) => `<p>${escapeHtml(l)}</p>`);
+  return parts.length ? parts.join('') : '<p></p>';
+}
+
+function normalizeInnerHtml(htmlContent) {
+  const t = String(htmlContent || '').trim();
+  if (!t) return '<p></p>';
+  if (!looksLikeHtml(t)) return plainTextToParagraphs(t);
+  return t;
+}
+
+function generateStyleId(prefix) {
+  const random = [...Array(12)]
+    .map(() => Math.floor(Math.random() * 16).toString(16))
+    .join('');
+  return `${prefix}${random}`.toUpperCase();
+}
+
+/**
+ * @param {string} htmlContent
+ * @returns {string}
+ */
+export function composePageBuilderSimpleText(htmlContent) {
+  const inner = normalizeInnerHtml(htmlContent);
+  const rowStyleId = generateStyleId('R');
+  const textStyleId = generateStyleId('T');
+
+  return (
+    `<div data-content-type="row" data-appearance="contained" data-element="main">` +
+    `<div data-enable-parallax="0" data-parallax-speed="0.5" data-background-images="{}"` +
+    ` data-background-type="image" data-video-loop="true" data-video-play-only-visible="true"` +
+    ` data-video-lazy-load="true" data-video-fallback-src="" data-element="inner"` +
+    ` data-pb-style="${rowStyleId}"` +
+    ` style="justify-content: flex-start; display: flex; flex-direction: column;` +
+    ` background-position: left top; background-size: cover; background-repeat: no-repeat;` +
+    ` background-attachment: scroll; border-style: none; border-width: 1px; border-radius: 0px;` +
+    ` margin: 0px 0px 10px; padding: 10px;">` +
+    `<div data-content-type="text" data-appearance="default" data-element="main"` +
+    ` data-pb-style="${textStyleId}" class="bypass-html-filter"` +
+    ` style="border-style: none; border-width: 1px; border-radius: 0px; margin: 0px; padding: 0px;">` +
+    `${inner}` +
+    `</div></div></div>` +
+    `<style>` +
+    `#html-body [data-pb-style=${rowStyleId}]{justify-content:flex-start;display:flex;flex-direction:column;` +
+    `background-position:left top;background-size:cover;background-repeat:no-repeat;` +
+    `background-attachment:scroll}` +
+    `#html-body [data-pb-style=${textStyleId}]{border-style:none}` +
+    `</style>`
+  );
+}
+
+/**
+ * @param {{ content?: string, headline?: string, subheadline?: string }} fields
+ */
+export function composeFromFields(fields = {}) {
+  const chunks = [];
+  const headline = (fields.headline || '').trim();
+  const subheadline = (fields.subheadline || '').trim();
+  const content = (fields.content || fields.source_content || '').trim();
+
+  if (headline) chunks.push(`<h2>${escapeHtml(headline)}</h2>`);
+  if (subheadline) chunks.push(`<p><strong>${escapeHtml(subheadline)}</strong></p>`);
+  if (content) {
+    chunks.push(looksLikeHtml(content) ? content : plainTextToParagraphs(content));
+  }
+
+  return composePageBuilderSimpleText(chunks.length ? chunks.join('') : '<p></p>');
+}
+
+export function generateIdentifier(title) {
+  const value = String(title || '')
+    .toLowerCase()
+    .trim()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+  return value || `page-${Date.now()}`;
+}
+
+export function validatePageBuilderHtml(html) {
+  return (
+    typeof html === 'string' &&
+    html.includes('data-content-type="row"') &&
+    html.includes('data-content-type="text"')
+  );
+}