@adsim/wordpress-mcp-server 4.5.0 → 4.6.0

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

@@ -0,0 +1,342 @@
+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, makeRequest, parseResult } from '../../helpers/mockWpRequest.js';
+
+function call(name, args = {}) {
+  return handleToolCall(makeRequest(name, args));
+}
+
+let consoleSpy;
+beforeEach(() => { fetch.mockReset(); consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {}); });
+afterEach(() => { consoleSpy.mockRestore(); });
+
+// ── Mock data factories ──
+
+const mockPage = { id: 10, title: { rendered: 'About' }, slug: 'about', status: 'publish', date: '2024-01-01', link: 'https://test.example.com/about', parent: 0, menu_order: 1, template: '', excerpt: { rendered: 'About page' } };
+
+const mockMedia = { id: 1, title: { rendered: 'Logo' }, date: '2024-01-01', mime_type: 'image/png', source_url: 'https://test.example.com/logo.png', alt_text: 'Site logo', media_details: { width: 200, height: 100 } };
+
+const mockComment = { id: 100, post: 5, parent: 0, author_name: 'Alice', date: '2024-02-01', status: 'approved', content: { rendered: '<p>Great post!</p>' }, link: 'https://test.example.com/post#comment-100' };
+
+const mockCategory = { id: 5, name: 'Tech', slug: 'tech', description: 'Tech articles', parent: 0, count: 12 };
+
+const mockTag = { id: 7, name: 'javascript', slug: 'javascript', count: 8 };
+
+const mockUser = { id: 1, name: 'Admin', slug: 'admin', link: 'https://test.example.com/author/admin', roles: ['administrator'], avatar_urls: { '96': 'https://test.example.com/avatar.jpg' } };
+
+const mockCustomPost = { id: 42, title: { rendered: 'Portfolio Item' }, slug: 'portfolio-item', status: 'publish', date: '2024-03-01', link: 'https://test.example.com/portfolio/portfolio-item', type: 'portfolio', meta: {} };
+
+const mockPlugin = { plugin: 'akismet/akismet.php', name: 'Akismet', version: '5.3', status: 'active', author: { rendered: 'Automattic' }, description: { rendered: 'Anti-spam' }, plugin_uri: 'https://akismet.com', requires_wp: '6.0', requires_php: '7.4', network_only: false, textdomain: 'akismet' };
+
+const mockTheme = { stylesheet: 'twentytwentyfour', template: 'twentytwentyfour', name: { rendered: 'Twenty Twenty-Four' }, description: { rendered: 'Default theme' }, status: 'active', version: '1.2', author: { rendered: 'WordPress' }, author_uri: '', theme_uri: '', requires_wp: '6.4', requires_php: '7.0', tags: { rendered: ['blog'] } };
+
+const mockRevision = { id: 200, parent: 5, date: '2024-04-01', date_gmt: '2024-04-01T00:00:00', modified: '2024-04-01', modified_gmt: '2024-04-01T00:00:00', author: 1, title: { rendered: 'Draft v2' }, excerpt: { rendered: 'Updated excerpt' }, slug: '5-revision-v1' };
+
+const mockTypes = { portfolio: { slug: 'portfolio', name: 'Portfolio', rest_base: 'portfolio' } };
+
+// =========================================================================
+// wp_list_pages
+// =========================================================================
+
+describe('wp_list_pages — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPage]));
+    const data = parseResult(await call('wp_list_pages', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([10]);
+    expect(data.pages).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPage]));
+    const data = parseResult(await call('wp_list_pages', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.pages[0]).toEqual({ id: 10, title: 'About', slug: 'about', status: 'publish', link: 'https://test.example.com/about', parent: 0 });
+    expect(data.pages[0].menu_order).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPage]));
+    const data = parseResult(await call('wp_list_pages'));
+    expect(data.mode).toBeUndefined();
+    expect(data.pages[0].menu_order).toBe(1);
+    expect(data.pages[0].template).toBe('');
+  });
+});
+
+// =========================================================================
+// wp_list_media
+// =========================================================================
+
+describe('wp_list_media — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockMedia]));
+    const data = parseResult(await call('wp_list_media', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([1]);
+    expect(data.media).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockMedia]));
+    const data = parseResult(await call('wp_list_media', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.media[0]).toEqual({ id: 1, title: 'Logo', mime_type: 'image/png', source_url: 'https://test.example.com/logo.png', alt_text: 'Site logo' });
+    expect(data.media[0].width).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockMedia]));
+    const data = parseResult(await call('wp_list_media'));
+    expect(data.mode).toBeUndefined();
+    expect(data.media[0].width).toBe(200);
+    expect(data.media[0].height).toBe(100);
+  });
+});
+
+// =========================================================================
+// wp_list_comments
+// =========================================================================
+
+describe('wp_list_comments — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockComment]));
+    const data = parseResult(await call('wp_list_comments', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([100]);
+    expect(data.comments).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockComment]));
+    const data = parseResult(await call('wp_list_comments', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.comments[0]).toEqual({ id: 100, post: 5, author_name: 'Alice', date: '2024-02-01', status: 'approved' });
+    expect(data.comments[0].content).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockComment]));
+    const data = parseResult(await call('wp_list_comments'));
+    expect(data.mode).toBeUndefined();
+    expect(data.comments[0].content).toBeDefined();
+    expect(data.comments[0].link).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_categories
+// =========================================================================
+
+describe('wp_list_categories — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockCategory]));
+    const data = parseResult(await call('wp_list_categories', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([5]);
+    expect(data.categories).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockCategory]));
+    const data = parseResult(await call('wp_list_categories', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.categories[0]).toEqual({ id: 5, name: 'Tech', slug: 'tech', count: 12, parent: 0 });
+    expect(data.categories[0].description).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockCategory]));
+    const data = parseResult(await call('wp_list_categories'));
+    expect(data.mode).toBeUndefined();
+    expect(data.categories[0].description).toBe('Tech articles');
+  });
+});
+
+// =========================================================================
+// wp_list_tags
+// =========================================================================
+
+describe('wp_list_tags — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTag]));
+    const data = parseResult(await call('wp_list_tags', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([7]);
+    expect(data.tags).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTag]));
+    const data = parseResult(await call('wp_list_tags', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.tags[0]).toEqual({ id: 7, name: 'javascript', slug: 'javascript', count: 8 });
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTag]));
+    const data = parseResult(await call('wp_list_tags'));
+    expect(data.mode).toBeUndefined();
+    expect(data.tags[0].id).toBe(7);
+    expect(data.tags[0].count).toBe(8);
+  });
+});
+
+// =========================================================================
+// wp_list_users
+// =========================================================================
+
+describe('wp_list_users — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockUser]));
+    const data = parseResult(await call('wp_list_users', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([1]);
+    expect(data.users).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockUser]));
+    const data = parseResult(await call('wp_list_users', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.users[0]).toEqual({ id: 1, name: 'Admin', slug: 'admin', roles: ['administrator'] });
+    expect(data.users[0].avatar).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockUser]));
+    const data = parseResult(await call('wp_list_users'));
+    expect(data.mode).toBeUndefined();
+    expect(data.users[0].link).toBeDefined();
+    expect(data.users[0].avatar).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_custom_posts
+// =========================================================================
+
+describe('wp_list_custom_posts — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    mockSuccess(mockTypes);
+    mockSuccess([mockCustomPost]);
+    const data = parseResult(await call('wp_list_custom_posts', { post_type: 'portfolio', mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([42]);
+    expect(data.posts).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    mockSuccess(mockTypes);
+    mockSuccess([mockCustomPost]);
+    const data = parseResult(await call('wp_list_custom_posts', { post_type: 'portfolio', mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.posts[0]).toEqual({ id: 42, title: 'Portfolio Item', slug: 'portfolio-item', date: '2024-03-01', status: 'publish', link: 'https://test.example.com/portfolio/portfolio-item' });
+    expect(data.posts[0].type).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    mockSuccess(mockTypes);
+    mockSuccess([mockCustomPost]);
+    const data = parseResult(await call('wp_list_custom_posts', { post_type: 'portfolio' }));
+    expect(data.mode).toBeUndefined();
+    expect(data.posts[0].type).toBe('portfolio');
+    expect(data.posts[0].meta).toEqual({});
+  });
+});
+
+// =========================================================================
+// wp_list_plugins
+// =========================================================================
+
+describe('wp_list_plugins — output compression', () => {
+  it('mode=ids_only returns flat plugin slug array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPlugin]));
+    const data = parseResult(await call('wp_list_plugins', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual(['akismet/akismet.php']);
+    expect(data.plugins).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPlugin]));
+    const data = parseResult(await call('wp_list_plugins', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.plugins[0]).toEqual({ plugin: 'akismet/akismet.php', name: 'Akismet', status: 'active', version: '5.3' });
+    expect(data.plugins[0].author).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPlugin]));
+    const data = parseResult(await call('wp_list_plugins'));
+    expect(data.mode).toBeUndefined();
+    expect(data.active).toBe(1);
+    expect(data.inactive).toBe(0);
+    expect(data.plugins[0].author).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_themes
+// =========================================================================
+
+describe('wp_list_themes — output compression', () => {
+  it('mode=ids_only returns flat stylesheet array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTheme]));
+    const data = parseResult(await call('wp_list_themes', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual(['twentytwentyfour']);
+    expect(data.themes).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTheme]));
+    const data = parseResult(await call('wp_list_themes', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.themes[0]).toEqual({ stylesheet: 'twentytwentyfour', name: 'Twenty Twenty-Four', status: 'active', version: '1.2' });
+    expect(data.themes[0].author).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTheme]));
+    const data = parseResult(await call('wp_list_themes'));
+    expect(data.mode).toBeUndefined();
+    expect(data.active_theme).toBe('Twenty Twenty-Four');
+    expect(data.themes[0].author).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_revisions
+// =========================================================================
+
+describe('wp_list_revisions — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockRevision]));
+    const data = parseResult(await call('wp_list_revisions', { post_id: 5, mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([200]);
+    expect(data.revisions).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockRevision]));
+    const data = parseResult(await call('wp_list_revisions', { post_id: 5, mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.revisions[0]).toEqual({ id: 200, date: '2024-04-01', author: 1 });
+    expect(data.revisions[0].slug).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockRevision]));
+    const data = parseResult(await call('wp_list_revisions', { post_id: 5 }));
+    expect(data.mode).toBeUndefined();
+    expect(data.note).toBeDefined();
+    expect(data.revisions[0].slug).toBe('5-revision-v1');
+    expect(data.revisions[0].author).toBe(1);
+  });
+});

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

@@ -80,7 +80,9 @@ describe('wp_site_info', () => {
 
     // Server info
     expect(data.server.mcp_version).toBeDefined();
-    expect(data.server.tools_count).toBe(85);
+    expect(data.server.tools_total).toBe(86);
+    expect(typeof data.server.tools_exposed).toBe('number');
+    expect(Array.isArray(data.server.filtered_out)).toBe(true);
   });
 
   it('SUCCESS — enterprise_controls reflect WP_READ_ONLY env var', async () => {

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

@@ -0,0 +1,101 @@
+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, makeRequest, parseResult, getAuditLogs } from '../../helpers/mockWpRequest.js';
+
+function call(name, args = {}) {
+  return handleToolCall(makeRequest(name, args));
+}
+
+let consoleSpy;
+const envBackup = {};
+
+function saveEnv(...keys) {
+  keys.forEach(k => { envBackup[k] = process.env[k]; });
+}
+function restoreEnv() {
+  Object.entries(envBackup).forEach(([k, v]) => {
+    if (v === undefined) delete process.env[k];
+    else process.env[k] = v;
+  });
+}
+
+beforeEach(() => {
+  fetch.mockReset();
+  consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+  saveEnv('WP_READ_ONLY');
+});
+afterEach(() => {
+  consoleSpy.mockRestore();
+  restoreEnv();
+});
+
+// ── Mock data ──
+
+const mockSettings = {
+  title: 'My Site',
+  description: 'Just another WordPress site',
+  url: 'https://test.example.com',
+  email: 'admin@test.example.com',
+  timezone_string: 'Europe/Brussels',
+  date_format: 'Y-m-d',
+  time_format: 'H:i',
+  language: 'en_US',
+  posts_per_page: 10,
+};
+
+// =========================================================================
+// wp_get_site_options
+// =========================================================================
+
+describe('wp_get_site_options', () => {
+  it('returns all options when no keys parameter', async () => {
+    fetch.mockResolvedValue(mockSuccess(mockSettings));
+    const data = parseResult(await call('wp_get_site_options'));
+    expect(data.title).toBe('My Site');
+    expect(data.description).toBe('Just another WordPress site');
+    expect(data.timezone_string).toBe('Europe/Brussels');
+    expect(Object.keys(data).length).toBe(Object.keys(mockSettings).length);
+  });
+
+  it('filters to requested keys only', async () => {
+    fetch.mockResolvedValue(mockSuccess(mockSettings));
+    const data = parseResult(await call('wp_get_site_options', { keys: ['title', 'language'] }));
+    expect(data.title).toBe('My Site');
+    expect(data.language).toBe('en_US');
+    expect(Object.keys(data)).toEqual(['title', 'language']);
+    expect(data.email).toBeUndefined();
+  });
+
+  it('handles 403 (insufficient permissions)', async () => {
+    mockError(403, '{"code":"rest_forbidden","message":"Sorry, you are not allowed to manage options."}');
+    const res = await call('wp_get_site_options');
+    expect(res.isError).toBe(true);
+    expect(res.content[0].text).toContain('403');
+  });
+
+  it('logs correct audit format to stderr', async () => {
+    fetch.mockResolvedValue(mockSuccess(mockSettings));
+    await call('wp_get_site_options', { keys: ['title'] });
+    const logs = getAuditLogs();
+    const entry = logs.find(l => l.tool === 'wp_get_site_options');
+    expect(entry).toBeDefined();
+    expect(entry.action).toBe('read_options');
+    expect(entry.status).toBe('success');
+    expect(typeof entry.latency_ms).toBe('number');
+    expect(entry.params.keys_requested).toBe(1);
+    expect(entry.params.keys_returned).toBe(1);
+  });
+
+  it('is NOT blocked by WP_READ_ONLY=true', async () => {
+    process.env.WP_READ_ONLY = 'true';
+    fetch.mockResolvedValue(mockSuccess(mockSettings));
+    const res = await call('wp_get_site_options');
+    expect(res.isError).toBeUndefined();
+    const data = parseResult(res);
+    expect(data.title).toBe('My Site');
+  });
+});