@adsim/wordpress-mcp-server 4.5.1 → 5.1.0

package/tests/unit/tools/schema.test.js

@@ -0,0 +1,477 @@
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+
+vi.mock('node-fetch', () => ({ default: vi.fn() }));
+
+import fetch from 'node-fetch';
+import { handleToolCall } from '../../../index.js';
+import { mockSuccess, mockError, getAuditLogs, makeRequest, parseResult } from '../../helpers/mockWpRequest.js';
+
+function call(name, args = {}) {
+  return handleToolCall(makeRequest(name, args));
+}
+
+function mockFetchJson(data, status = 200) {
+  return Promise.resolve({
+    ok: status >= 200 && status < 400,
+    status,
+    headers: { get: (h) => h === 'content-type' ? 'application/json' : null },
+    json: () => Promise.resolve(data),
+    text: () => Promise.resolve(typeof data === 'string' ? data : JSON.stringify(data))
+  });
+}
+
+function mockFetchText(text, status = 200) {
+  return Promise.resolve({
+    ok: status >= 200 && status < 400,
+    status,
+    headers: { get: (h) => h === 'content-type' ? 'text/html' : null },
+    json: () => Promise.reject(new Error('not json')),
+    text: () => Promise.resolve(text)
+  });
+}
+
+let consoleSpy;
+const envBackup = {};
+
+beforeEach(() => {
+  fetch.mockReset();
+  consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+  envBackup.WP_READ_ONLY = process.env.WP_READ_ONLY;
+  delete process.env.WP_READ_ONLY;
+});
+afterEach(() => {
+  consoleSpy.mockRestore();
+  if (envBackup.WP_READ_ONLY === undefined) delete process.env.WP_READ_ONLY;
+  else process.env.WP_READ_ONLY = envBackup.WP_READ_ONLY;
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_generate_schema_article
+// ════════════════════════════════════════════════════════════
+
+describe('wp_generate_schema_article', () => {
+  it('generates Article schema with all fields', async () => {
+    fetch.mockImplementation((url) => {
+      if (url.toString().includes('/posts/42')) {
+        return mockFetchJson({
+          id: 42, title: { rendered: 'My Post' }, excerpt: { rendered: '<p>Excerpt here</p>' },
+          date: '2024-01-01T00:00:00', modified: '2024-06-01T00:00:00', link: 'https://example.com/my-post',
+          _embedded: {
+            author: [{ name: 'John Doe', link: 'https://example.com/author/john' }],
+            'wp:featuredmedia': [{ source_url: 'https://example.com/img.jpg', media_details: { width: 1200, height: 630 } }]
+          }
+        });
+      }
+      if (url.toString().includes('/settings')) {
+        return mockFetchJson({ title: 'My Site', site_icon_url: 'https://example.com/icon.png' });
+      }
+      return mockFetchJson({});
+    });
+    const res = await call('wp_generate_schema_article', { post_id: 42 });
+    const data = parseResult(res);
+    expect(data.jsonld['@type']).toBe('Article');
+    expect(data.jsonld.headline).toBe('My Post');
+    expect(data.jsonld.author.name).toBe('John Doe');
+    expect(data.jsonld.image.url).toBe('https://example.com/img.jpg');
+    expect(data.jsonld.publisher.name).toBe('My Site');
+    expect(data.fields_missing).toHaveLength(0);
+  });
+
+  it('reports missing fields gracefully', async () => {
+    fetch.mockImplementation((url) => {
+      if (url.toString().includes('/posts/99')) {
+        return mockFetchJson({
+          id: 99, title: { rendered: 'Minimal' }, excerpt: { rendered: '' },
+          date: '2024-01-01T00:00:00', _embedded: {}
+        });
+      }
+      return mockFetchJson({}, 403);
+    });
+    const res = await call('wp_generate_schema_article', { post_id: 99 });
+    const data = parseResult(res);
+    expect(data.jsonld['@type']).toBe('Article');
+    expect(data.fields_missing).toContain('description');
+    expect(data.fields_missing).toContain('author');
+    expect(data.fields_missing).toContain('image');
+  });
+
+  it('handles 404 post not found', async () => {
+    fetch.mockImplementation(() => mockFetchJson({ code: 'rest_post_invalid_id', message: 'Invalid post ID.' }, 404));
+    const res = await call('wp_generate_schema_article', { post_id: 999 });
+    expect(res.isError).toBe(true);
+  });
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_generate_schema_faq
+// ════════════════════════════════════════════════════════════
+
+describe('wp_generate_schema_faq', () => {
+  const faqPost = (content) => ({ id: 10, title: { rendered: 'FAQ' }, content: { rendered: content }, excerpt: { rendered: '' } });
+
+  it('detects Gutenberg FAQ blocks', async () => {
+    fetch.mockImplementation(() => mockFetchJson(faqPost(
+      '<div class="wp-block-faq"><div class="faq-question">Q1?</div><div class="faq-answer">A1.</div></div>' +
+      '<div class="wp-block-faq"><div class="faq-question">Q2?</div><div class="faq-answer">A2.</div></div>'
+    )));
+    const res = await call('wp_generate_schema_faq', { post_id: 10 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('gutenberg_faq_block');
+    expect(data.qa_count).toBe(2);
+    expect(data.jsonld['@type']).toBe('FAQPage');
+    expect(data.jsonld.mainEntity[0].name).toBe('Q1?');
+  });
+
+  it('detects RankMath FAQ blocks', async () => {
+    fetch.mockImplementation(() => mockFetchJson(faqPost(
+      '<div class="rank-math-faq-block"><div class="faq-question">RQ?</div><div class="faq-answer">RA.</div></div></div>'
+    )));
+    const res = await call('wp_generate_schema_faq', { post_id: 10 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('rankmath_faq');
+    expect(data.qa_count).toBe(1);
+  });
+
+  it('detects AIOSEO FAQ blocks', async () => {
+    fetch.mockImplementation(() => mockFetchJson(faqPost(
+      '<div class="aioseo-faq"><div class="faq-question">AQ?</div><div class="faq-answer">AA.</div></div></div>'
+    )));
+    const res = await call('wp_generate_schema_faq', { post_id: 10 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('aioseo_faq');
+  });
+
+  it('detects <details><summary> pattern', async () => {
+    fetch.mockImplementation(() => mockFetchJson(faqPost(
+      '<details><summary>What is this?</summary><p>This is that.</p></details>' +
+      '<details><summary>How does it work?</summary><p>Like this.</p></details>'
+    )));
+    const res = await call('wp_generate_schema_faq', { post_id: 10 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('details_summary');
+    expect(data.qa_count).toBe(2);
+  });
+
+  it('falls back to H3 + paragraph', async () => {
+    fetch.mockImplementation(() => mockFetchJson(faqPost(
+      '<h3>Why use this?</h3><p>Because it is useful.</p><h3>Is it free?</h3><p>Yes.</p>'
+    )));
+    const res = await call('wp_generate_schema_faq', { post_id: 10 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('h3_paragraph');
+    expect(data.qa_count).toBe(2);
+  });
+
+  it('returns empty FAQ when no Q&A detected', async () => {
+    fetch.mockImplementation(() => mockFetchJson(faqPost('<p>Just a paragraph.</p>')));
+    const res = await call('wp_generate_schema_faq', { post_id: 10 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('none');
+    expect(data.qa_count).toBe(0);
+  });
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_generate_schema_howto
+// ════════════════════════════════════════════════════════════
+
+describe('wp_generate_schema_howto', () => {
+  const htPost = (content) => ({ id: 20, title: { rendered: 'How to Cook' }, content: { rendered: content }, excerpt: { rendered: '' } });
+
+  it('detects ordered list steps', async () => {
+    fetch.mockImplementation(() => mockFetchJson(htPost(
+      '<ol class="wp-block-list"><li>Boil water</li><li>Add pasta</li><li>Drain and serve</li></ol>'
+    )));
+    const res = await call('wp_generate_schema_howto', { post_id: 20 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('ordered_list_gutenberg');
+    expect(data.step_count).toBe(3);
+    expect(data.jsonld['@type']).toBe('HowTo');
+    expect(data.jsonld.step[0].name).toBe('Boil water');
+    expect(data.jsonld.step[0].position).toBe(1);
+  });
+
+  it('detects numbered headings', async () => {
+    fetch.mockImplementation(() => mockFetchJson(htPost(
+      '<h3>Step 1: Prepare</h3><p>Get ingredients ready.</p><h3>Step 2: Mix</h3><p>Combine all.</p>'
+    )));
+    const res = await call('wp_generate_schema_howto', { post_id: 20 });
+    const data = parseResult(res);
+    expect(data.detection_method).toBe('numbered_headings');
+    expect(data.step_count).toBe(2);
+  });
+
+  it('extracts totalTime if present', async () => {
+    fetch.mockImplementation(() => mockFetchJson(htPost(
+      '<p>Total time: PT30M</p><ol><li>Do this</li></ol>'
+    )));
+    const res = await call('wp_generate_schema_howto', { post_id: 20 });
+    const data = parseResult(res);
+    expect(data.has_total_time).toBe(true);
+    expect(data.jsonld.totalTime).toBe('PT30M');
+  });
+
+  it('extracts estimatedCost if present', async () => {
+    fetch.mockImplementation(() => mockFetchJson(htPost(
+      '<p>Cost: $25.00</p><ol><li>Buy materials</li></ol>'
+    )));
+    const res = await call('wp_generate_schema_howto', { post_id: 20 });
+    const data = parseResult(res);
+    expect(data.has_estimated_cost).toBe(true);
+  });
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_generate_schema_localbusiness
+// ════════════════════════════════════════════════════════════
+
+describe('wp_generate_schema_localbusiness', () => {
+  it('generates from WP options fallback', async () => {
+    fetch.mockImplementation((url) => {
+      if (url.toString().includes('/settings')) {
+        return mockFetchJson({ title: 'My Biz', email: 'info@biz.com', url: 'https://biz.com' });
+      }
+      return mockFetchJson({}, 404);
+    });
+    const res = await call('wp_generate_schema_localbusiness', {});
+    const data = parseResult(res);
+    expect(data.jsonld['@type']).toBe('LocalBusiness');
+    expect(data.jsonld.name).toBe('My Biz');
+    expect(data.sources).toContain('wp_options');
+    expect(data.fields_missing).toContain('address');
+    expect(data.fields_missing).toContain('telephone');
+  });
+
+  it('generates from post ACF fields', async () => {
+    fetch.mockImplementation((url) => {
+      if (url.toString().includes('/posts/55')) {
+        return mockFetchJson({
+          id: 55, acf: { business_name: 'ACF Biz', address: '123 Main St', phone: '+1234', email: 'acf@biz.com', opening_hours: 'Mo-Fr 9-17' }
+        });
+      }
+      if (url.toString().includes('/settings')) {
+        return mockFetchJson({ title: 'Site', url: 'https://site.com' });
+      }
+      return mockFetchJson({}, 404);
+    });
+    const res = await call('wp_generate_schema_localbusiness', { target: '55' });
+    const data = parseResult(res);
+    expect(data.jsonld.name).toBe('ACF Biz');
+    expect(data.jsonld.telephone).toBe('+1234');
+    expect(data.sources).toContain('acf');
+  });
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_generate_schema_breadcrumb
+// ════════════════════════════════════════════════════════════
+
+describe('wp_generate_schema_breadcrumb', () => {
+  it('builds breadcrumb for post with category', async () => {
+    fetch.mockImplementation((url) => {
+      const u = url.toString();
+      if (u.includes('/posts/30')) {
+        return mockFetchJson({ id: 30, title: { rendered: 'My Article' }, link: 'https://example.com/my-article', categories: [5], type: 'post' });
+      }
+      if (u.includes('/categories/5')) {
+        return mockFetchJson({ id: 5, name: 'Tech', link: 'https://example.com/category/tech', parent: 0 });
+      }
+      return mockFetchJson({}, 404);
+    });
+    const res = await call('wp_generate_schema_breadcrumb', { post_id: 30 });
+    const data = parseResult(res);
+    expect(data.jsonld['@type']).toBe('BreadcrumbList');
+    expect(data.item_count).toBe(3); // Home > Tech > My Article
+    expect(data.path).toBe('Home > Tech > My Article');
+    expect(data.jsonld.itemListElement[0].position).toBe(1);
+    expect(data.jsonld.itemListElement[0].name).toBe('Home');
+  });
+
+  it('builds breadcrumb for page with parent', async () => {
+    let callCount = 0;
+    fetch.mockImplementation((url) => {
+      const u = url.toString();
+      // First call to /posts/{id} should 404, second to /pages/{id} succeeds
+      if (u.includes('/posts/40') && !u.includes('pages')) {
+        return mockFetchJson({ code: 'rest_post_invalid_id' }, 404);
+      }
+      if (u.includes('/pages/40')) {
+        return mockFetchJson({ id: 40, title: { rendered: 'Child Page' }, link: 'https://example.com/parent/child', parent: 20, type: 'page' });
+      }
+      if (u.includes('/pages/20')) {
+        return mockFetchJson({ id: 20, title: { rendered: 'Parent Page' }, link: 'https://example.com/parent', parent: 0, type: 'page' });
+      }
+      return mockFetchJson({}, 404);
+    });
+    const res = await call('wp_generate_schema_breadcrumb', { post_id: 40 });
+    const data = parseResult(res);
+    expect(data.item_count).toBe(3); // Home > Parent Page > Child Page
+    expect(data.path).toContain('Parent Page');
+    expect(data.path).toContain('Child Page');
+  });
+
+  it('handles post not found', async () => {
+    fetch.mockImplementation(() => mockFetchJson({ code: 'rest_post_invalid_id' }, 404));
+    const res = await call('wp_generate_schema_breadcrumb', { post_id: 9999 });
+    expect(res.isError).toBe(true);
+  });
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_inject_schema
+// ════════════════════════════════════════════════════════════
+
+describe('wp_inject_schema', () => {
+  it('dry_run=true returns preview without injecting', async () => {
+    fetch.mockImplementation((url) => {
+      if (url.toString().includes('/posts/42')) {
+        return mockFetchJson({
+          id: 42, title: { rendered: 'Post' }, excerpt: { rendered: '<p>Ex</p>' },
+          date: '2024-01-01', _embedded: { author: [{ name: 'A' }] }
+        });
+      }
+      if (url.toString().includes('/settings')) {
+        return mockFetchJson({ title: 'Site' });
+      }
+      return mockFetchJson({});
+    });
+    const res = await call('wp_inject_schema', { post_id: 42, schema_type: 'article', dry_run: true });
+    const data = parseResult(res);
+    expect(data.dry_run).toBe(true);
+    expect(data.status).toBe('preview');
+    expect(data.jsonld['@type']).toBe('Article');
+  });
+
+  it('dry_run=true bypasses WP_READ_ONLY', async () => {
+    process.env.WP_READ_ONLY = 'true';
+    fetch.mockImplementation((url) => {
+      if (url.toString().includes('/posts/42')) {
+        return mockFetchJson({
+          id: 42, title: { rendered: 'Post' }, excerpt: { rendered: '' },
+          date: '2024-01-01', _embedded: {}
+        });
+      }
+      return mockFetchJson({}, 404);
+    });
+    const res = await call('wp_inject_schema', { post_id: 42, schema_type: 'article', dry_run: true });
+    const data = parseResult(res);
+    expect(data.dry_run).toBe(true);
+    expect(res.isError).toBeUndefined();
+  });
+
+  it('blocks when WP_READ_ONLY and dry_run=false', async () => {
+    process.env.WP_READ_ONLY = 'true';
+    const res = await call('wp_inject_schema', { post_id: 42, schema_type: 'article' });
+    expect(res.isError).toBe(true);
+    expect(res.content[0].text).toContain('READ-ONLY');
+  });
+
+  it('returns error if meta exists and override=false', async () => {
+    fetch.mockImplementation((url) => {
+      const u = url.toString();
+      // First: generate the article schema (wpApiCall for /posts/42)
+      if (u.includes('/posts/42') && !u.includes('schema')) {
+        return mockFetchJson({
+          id: 42, title: { rendered: 'Post' }, excerpt: { rendered: '' },
+          date: '2024-01-01', _embedded: {}
+        });
+      }
+      // Settings call
+      if (u.includes('/settings')) {
+        return mockFetchJson({}, 404);
+      }
+      // Schema endpoint check: existing meta
+      if (u.includes('/schema/42') && !u.includes('POST')) {
+        return mockFetchJson({ post_id: 42, schema: '{"@type":"Article"}' });
+      }
+      return mockFetchJson({});
+    });
+    const res = await call('wp_inject_schema', { post_id: 42, schema_type: 'article', override: false });
+    expect(res.isError).toBe(true);
+    expect(res.content[0].text).toContain('already exists');
+  });
+
+  it('injects successfully with override=true', async () => {
+    fetch.mockImplementation((url, opts) => {
+      const u = url.toString();
+      if (u.includes('/posts/42') && (!opts || opts.method !== 'POST')) {
+        return mockFetchJson({
+          id: 42, title: { rendered: 'Post' }, excerpt: { rendered: '<p>Ex</p>' },
+          date: '2024-01-01', _embedded: { author: [{ name: 'Auth' }] }
+        });
+      }
+      if (u.includes('/settings')) return mockFetchJson({ title: 'Site' });
+      if (u.includes('/schema/42') && opts?.method === 'POST') return mockFetchJson({ status: 'saved' });
+      if (u.includes('/schema/42')) return mockFetchJson({ post_id: 42, schema: '{"old":true}' });
+      return mockFetchJson({});
+    });
+    const res = await call('wp_inject_schema', { post_id: 42, schema_type: 'article', override: true });
+    const data = parseResult(res);
+    expect(data.status).toBe('injected');
+    expect(data.jsonld['@type']).toBe('Article');
+  });
+});
+
+// ════════════════════════════════════════════════════════════
+// wp_validate_schema_live
+// ════════════════════════════════════════════════════════════
+
+describe('wp_validate_schema_live', () => {
+  it('validates a page with valid Article schema', async () => {
+    const html = `<html><head><script type="application/ld+json">{"@context":"https://schema.org","@type":"Article","headline":"Test","author":{"name":"A"}}</script></head><body></body></html>`;
+    fetch.mockImplementation(() => mockFetchText(html));
+    const res = await call('wp_validate_schema_live', { url: 'https://example.com/post' });
+    const data = parseResult(res);
+    expect(data.total_schemas).toBe(1);
+    expect(data.schemas_found[0].type).toBe('Article');
+    expect(data.schemas_found[0].valid).toBe(true);
+    expect(data.rich_results_eligible.article).toBe(true);
+  });
+
+  it('detects invalid FAQ (missing mainEntity)', async () => {
+    const html = `<html><head><script type="application/ld+json">{"@context":"https://schema.org","@type":"FAQPage"}</script></head><body></body></html>`;
+    fetch.mockImplementation(() => mockFetchText(html));
+    const res = await call('wp_validate_schema_live', { url: 'https://example.com/faq' });
+    const data = parseResult(res);
+    expect(data.schemas_found[0].type).toBe('FAQPage');
+    expect(data.schemas_found[0].valid).toBe(false);
+    expect(data.schemas_found[0].errors).toContain('Missing required field: mainEntity');
+  });
+
+  it('handles page with no schema', async () => {
+    fetch.mockImplementation(() => mockFetchText('<html><head></head><body>Hello</body></html>'));
+    const res = await call('wp_validate_schema_live', { url: 'https://example.com/plain' });
+    const data = parseResult(res);
+    expect(data.total_schemas).toBe(0);
+    expect(data.recommendations).toContain('No JSON-LD schemas found. Add structured data to improve SEO.');
+  });
+
+  it('detects common errors: relative URL, bad date', async () => {
+    const html = `<html><head><script type="application/ld+json">{"@context":"https://schema.org","@type":"Article","headline":"T","author":{"name":"A"},"url":"/relative","datePublished":"not-a-date"}</script></head><body></body></html>`;
+    fetch.mockImplementation(() => mockFetchText(html));
+    const res = await call('wp_validate_schema_live', { url: 'https://example.com/bad' });
+    const data = parseResult(res);
+    expect(data.schemas_found[0].warnings).toEqual(
+      expect.arrayContaining([
+        expect.stringContaining('Relative URL'),
+        expect.stringContaining('Invalid datePublished'),
+      ])
+    );
+  });
+
+  it('handles @graph arrays', async () => {
+    const html = `<html><head><script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem"}]},{"@type":"Article","headline":"T","author":{"name":"A"}}]}</script></head><body></body></html>`;
+    fetch.mockImplementation(() => mockFetchText(html));
+    const res = await call('wp_validate_schema_live', { url: 'https://example.com/graph' });
+    const data = parseResult(res);
+    expect(data.schemas_found.length).toBe(2);
+    expect(data.rich_results_eligible.breadcrumb).toBe(true);
+    expect(data.rich_results_eligible.article).toBe(true);
+  });
+
+  it('handles fetch failure', async () => {
+    fetch.mockImplementation(() => mockFetchText('', 500));
+    const res = await call('wp_validate_schema_live', { url: 'https://example.com/err' });
+    expect(res.isError).toBe(true);
+  });
+});