@adsim/wordpress-mcp-server 4.4.0 → 4.5.1

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);
+  });
+});