@jgardner04/ghost-mcp-server 1.13.3 → 1.13.5

package/src/services/ghostServiceImproved.js

@@ -1,962 +1,89 @@
-import GhostAdminAPI from '@tryghost/admin-api';
-import dotenv from 'dotenv';
-import { promises as fs } from 'fs';
-import {
-  GhostAPIError,
-  ConfigurationError,
-  ValidationError,
-  NotFoundError,
-  ErrorHandler,
-  CircuitBreaker,
-  retryWithBackoff,
-} from '../errors/index.js';
-import { createContextLogger } from '../utils/logger.js';
-import { sanitizeNqlValue } from '../utils/nqlSanitizer.js';
-
-dotenv.config();
-
-const logger = createContextLogger('ghost-service-improved');
-
-const { GHOST_ADMIN_API_URL, GHOST_ADMIN_API_KEY } = process.env;
-
-// Validate configuration at startup
-if (!GHOST_ADMIN_API_URL || !GHOST_ADMIN_API_KEY) {
-  throw new ConfigurationError(
-    'Ghost Admin API configuration is incomplete',
-    ['GHOST_ADMIN_API_URL', 'GHOST_ADMIN_API_KEY'].filter((key) => !process.env[key])
-  );
-}
-
-// Configure the Ghost Admin API client
-const api = new GhostAdminAPI({
-  url: GHOST_ADMIN_API_URL,
-  key: GHOST_ADMIN_API_KEY,
-  version: 'v5.0',
-});
-
-// Circuit breaker for Ghost API
-const ghostCircuitBreaker = new CircuitBreaker({
-  failureThreshold: 5,
-  resetTimeout: 60000, // 1 minute
-  monitoringPeriod: 10000, // 10 seconds
-});
-
 /**
- * Enhanced handler for Ghost Admin API requests with proper error handling
- */
-const handleApiRequest = async (resource, action, data = {}, options = {}, config = {}) => {
-  // Validate inputs
-  if (!api[resource] || typeof api[resource][action] !== 'function') {
-    throw new ValidationError(`Invalid Ghost API resource or action: ${resource}.${action}`);
-  }
-
-  const operation = `${resource}.${action}`;
-  const maxRetries = config.maxRetries ?? 3;
-  const useCircuitBreaker = config.useCircuitBreaker ?? true;
-
-  // Main execution function
-  const executeRequest = async () => {
-    try {
-      console.error(`Executing Ghost API request: ${operation}`);
-
-      let result;
-
-      // Handle different action signatures
-      switch (action) {
-        case 'add':
-        case 'edit':
-          result = await api[resource][action](data, options);
-          break;
-        case 'upload':
-          result = await api[resource][action](data);
-          break;
-        case 'browse':
-        case 'read':
-          result = await api[resource][action](options, data);
-          break;
-        case 'delete':
-          result = await api[resource][action](data.id || data, options);
-          break;
-        default:
-          result = await api[resource][action](data);
-      }
-
-      console.error(`Successfully executed Ghost API request: ${operation}`);
-      return result;
-    } catch (error) {
-      // Transform Ghost API errors into our error types
-      throw ErrorHandler.fromGhostError(error, operation);
-    }
-  };
-
-  // Wrap with circuit breaker if enabled
-  const wrappedExecute = useCircuitBreaker
-    ? () => ghostCircuitBreaker.execute(executeRequest)
-    : executeRequest;
-
-  // Execute with retry logic
-  try {
-    return await retryWithBackoff(wrappedExecute, {
-      maxAttempts: maxRetries,
-      onRetry: (attempt, _error) => {
-        console.error(`Retrying ${operation} (attempt ${attempt}/${maxRetries})`);
-
-        // Log circuit breaker state if relevant
-        if (useCircuitBreaker) {
-          const state = ghostCircuitBreaker.getState();
-          console.error(`Circuit breaker state:`, state);
-        }
-      },
-    });
-  } catch (error) {
-    console.error(`Failed to execute ${operation} after ${maxRetries} attempts:`, error.message);
-    throw error;
-  }
-};
-
-/**
- * Input validation helpers
- */
-const validators = {
-  validateScheduledStatus(data, resourceLabel = 'Resource') {
-    const errors = [];
-
-    if (data.status === 'scheduled' && !data.published_at) {
-      errors.push({
-        field: 'published_at',
-        message: 'published_at is required when status is scheduled',
-      });
-    }
-
-    if (data.published_at) {
-      const publishDate = new Date(data.published_at);
-      if (isNaN(publishDate.getTime())) {
-        errors.push({ field: 'published_at', message: 'Invalid date format' });
-      } else if (data.status === 'scheduled' && publishDate <= new Date()) {
-        errors.push({ field: 'published_at', message: 'Scheduled date must be in the future' });
-      }
-    }
-
-    if (errors.length > 0) {
-      throw new ValidationError(`${resourceLabel} validation failed`, errors);
-    }
-  },
-
-  validatePostData(postData) {
-    const errors = [];
-
-    if (!postData.title || postData.title.trim().length === 0) {
-      errors.push({ field: 'title', message: 'Title is required' });
-    }
-
-    if (!postData.html && !postData.mobiledoc) {
-      errors.push({ field: 'content', message: 'Either html or mobiledoc content is required' });
-    }
-
-    if (postData.status && !['draft', 'published', 'scheduled'].includes(postData.status)) {
-      errors.push({
-        field: 'status',
-        message: 'Invalid status. Must be draft, published, or scheduled',
-      });
-    }
-
-    if (errors.length > 0) {
-      throw new ValidationError('Post validation failed', errors);
-    }
-
-    this.validateScheduledStatus(postData, 'Post');
-  },
-
-  validateTagData(tagData) {
-    const errors = [];
-
-    if (!tagData.name || tagData.name.trim().length === 0) {
-      errors.push({ field: 'name', message: 'Tag name is required' });
-    }
-
-    if (tagData.slug && !/^[a-z0-9-]+$/.test(tagData.slug)) {
-      errors.push({
-        field: 'slug',
-        message: 'Slug must contain only lowercase letters, numbers, and hyphens',
-      });
-    }
-
-    if (errors.length > 0) {
-      throw new ValidationError('Tag validation failed', errors);
-    }
-  },
-
-  validateTagUpdateData(updateData) {
-    const errors = [];
-
-    // Name is optional in updates, but if provided, it cannot be empty
-    if (updateData.name !== undefined && updateData.name.trim().length === 0) {
-      errors.push({ field: 'name', message: 'Tag name cannot be empty' });
-    }
-
-    // Validate slug format if provided
-    if (updateData.slug && !/^[a-z0-9-]+$/.test(updateData.slug)) {
-      errors.push({
-        field: 'slug',
-        message: 'Slug must contain only lowercase letters, numbers, and hyphens',
-      });
-    }
-
-    if (errors.length > 0) {
-      throw new ValidationError('Tag update validation failed', errors);
-    }
-  },
-
-  async validateImagePath(imagePath) {
-    if (!imagePath || typeof imagePath !== 'string') {
-      throw new ValidationError('Image path is required and must be a string');
-    }
-
-    // Check if file exists
-    try {
-      await fs.access(imagePath);
-    } catch {
-      throw new NotFoundError('Image file', imagePath);
-    }
-  },
-
-  validatePageData(pageData) {
-    const errors = [];
-
-    if (!pageData.title || pageData.title.trim().length === 0) {
-      errors.push({ field: 'title', message: 'Title is required' });
-    }
-
-    if (!pageData.html && !pageData.mobiledoc) {
-      errors.push({ field: 'content', message: 'Either html or mobiledoc content is required' });
-    }
-
-    if (pageData.status && !['draft', 'published', 'scheduled'].includes(pageData.status)) {
-      errors.push({
-        field: 'status',
-        message: 'Invalid status. Must be draft, published, or scheduled',
-      });
-    }
-
-    if (errors.length > 0) {
-      throw new ValidationError('Page validation failed', errors);
-    }
-
-    this.validateScheduledStatus(pageData, 'Page');
-  },
-
-  validateNewsletterData(newsletterData) {
-    const errors = [];
-
-    if (!newsletterData.name || newsletterData.name.trim().length === 0) {
-      errors.push({ field: 'name', message: 'Newsletter name is required' });
-    }
-
-    if (errors.length > 0) {
-      throw new ValidationError('Newsletter validation failed', errors);
-    }
-  },
-};
-
-/**
- * Shared CRUD helper: read a single resource by ID with 404→NotFoundError handling
- */
-async function readResource(resource, id, label, options = {}) {
-  if (!id) throw new ValidationError(`${label} ID is required`);
-  try {
-    return await handleApiRequest(resource, 'read', { id }, options);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 404) {
-      throw new NotFoundError(label, id);
-    }
-    throw error;
-  }
-}
-
-/**
- * Shared CRUD helper: update a resource with optimistic concurrency control (OCC)
- * Reads the current version, merges updated_at, then edits.
- */
-async function updateWithOCC(resource, id, updateData, options = {}, label = resource) {
-  const existing = await readResource(resource, id, label);
-  const editData = { ...updateData, updated_at: existing.updated_at };
-  try {
-    return await handleApiRequest(resource, 'edit', { id, ...editData }, options);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 404) {
-      throw new NotFoundError(label, id);
-    }
-    throw error;
-  }
-}
-
-/**
- * Shared CRUD helper: delete a resource by ID with 404→NotFoundError handling
- */
-async function deleteResource(resource, id, label) {
-  if (!id) throw new ValidationError(`${label} ID is required for deletion`);
-  try {
-    return await handleApiRequest(resource, 'delete', { id });
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 404) {
-      throw new NotFoundError(label, id);
-    }
-    throw error;
-  }
-}
-
-/**
- * Service functions with enhanced error handling
- */
-
-export async function getSiteInfo() {
-  try {
-    return await handleApiRequest('site', 'read');
-  } catch (error) {
-    console.error('Failed to get site info:', error);
-    throw error;
-  }
-}
-
-export async function createPost(postData, options = { source: 'html' }) {
-  // Validate input
-  validators.validatePostData(postData);
-
-  // Add defaults
-  const dataWithDefaults = {
-    status: 'draft',
-    ...postData,
-  };
-
-  // SECURITY: HTML must be sanitized before reaching this function. See htmlContentSchema in schemas/common.js
-
-  try {
-    return await handleApiRequest('posts', 'add', dataWithDefaults, options);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      // Transform Ghost validation errors into our format
-      throw new ValidationError('Post creation failed due to validation errors', [
-        { field: 'post', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-export async function updatePost(postId, updateData, options = {}) {
-  if (!postId) {
-    throw new ValidationError('Post ID is required for update');
-  }
-
-  // Validate scheduled status if status is being updated
-  if (updateData.status) {
-    validators.validateScheduledStatus(updateData, 'Post');
-  }
-
-  return updateWithOCC('posts', postId, updateData, options, 'Post');
-}
-
-export async function deletePost(postId) {
-  return deleteResource('posts', postId, 'Post');
-}
-
-export async function getPost(postId, options = {}) {
-  return readResource('posts', postId, 'Post', options);
-}
-
-export async function getPosts(options = {}) {
-  const defaultOptions = {
-    limit: 15,
-    include: 'tags,authors',
-    ...options,
-  };
-
-  try {
-    return await handleApiRequest('posts', 'browse', {}, defaultOptions);
-  } catch (error) {
-    console.error('Failed to get posts:', error);
-    throw error;
-  }
-}
-
-export async function searchPosts(query, options = {}) {
-  // Validate query
-  if (!query || query.trim().length === 0) {
-    throw new ValidationError('Search query is required');
-  }
-
-  // Sanitize query - escape special NQL characters to prevent injection
-  const sanitizedQuery = sanitizeNqlValue(query);
-
-  // Build filter with fuzzy title match using Ghost NQL
-  const filterParts = [`title:~'${sanitizedQuery}'`];
-
-  // Add status filter if provided and not 'all'
-  if (options.status && options.status !== 'all') {
-    filterParts.push(`status:${options.status}`);
-  }
-
-  const searchOptions = {
-    limit: options.limit || 15,
-    include: 'tags,authors',
-    filter: filterParts.join('+'),
-  };
-
-  try {
-    return await handleApiRequest('posts', 'browse', {}, searchOptions);
-  } catch (error) {
-    console.error('Failed to search posts:', error);
-    throw error;
-  }
-}
-
-/**
- * Page CRUD Operations
- * Pages are similar to posts but do NOT support tags
- */
-
-export async function createPage(pageData, options = { source: 'html' }) {
-  // Validate input
-  validators.validatePageData(pageData);
-
-  // Add defaults
-  const dataWithDefaults = {
-    status: 'draft',
-    ...pageData,
-  };
-
-  // SECURITY: HTML must be sanitized before reaching this function. See htmlContentSchema in schemas/common.js
-
-  try {
-    return await handleApiRequest('pages', 'add', dataWithDefaults, options);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      throw new ValidationError('Page creation failed due to validation errors', [
-        { field: 'page', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-export async function updatePage(pageId, updateData, options = {}) {
-  if (!pageId) {
-    throw new ValidationError('Page ID is required for update');
-  }
-
-  // SECURITY: HTML must be sanitized before reaching this function. See htmlContentSchema in schemas/common.js
-
-  // Validate scheduled status if status is being updated
-  if (updateData.status) {
-    validators.validateScheduledStatus(updateData, 'Page');
-  }
-
-  return updateWithOCC('pages', pageId, updateData, options, 'Page');
-}
-
-export async function deletePage(pageId) {
-  return deleteResource('pages', pageId, 'Page');
-}
-
-export async function getPage(pageId, options = {}) {
-  return readResource('pages', pageId, 'Page', options);
-}
-
-export async function getPages(options = {}) {
-  const defaultOptions = {
-    limit: 15,
-    include: 'authors',
-    ...options,
-  };
-
-  try {
-    return await handleApiRequest('pages', 'browse', {}, defaultOptions);
-  } catch (error) {
-    console.error('Failed to get pages:', error);
-    throw error;
-  }
-}
-
-export async function searchPages(query, options = {}) {
-  // Validate query
-  if (!query || query.trim().length === 0) {
-    throw new ValidationError('Search query is required');
-  }
-
-  // Sanitize query - escape special NQL characters to prevent injection
-  const sanitizedQuery = sanitizeNqlValue(query);
-
-  // Build filter with fuzzy title match using Ghost NQL
-  const filterParts = [`title:~'${sanitizedQuery}'`];
-
-  // Add status filter if provided and not 'all'
-  if (options.status && options.status !== 'all') {
-    filterParts.push(`status:${options.status}`);
-  }
-
-  const searchOptions = {
-    limit: options.limit || 15,
-    include: 'authors',
-    filter: filterParts.join('+'),
-  };
-
-  try {
-    return await handleApiRequest('pages', 'browse', {}, searchOptions);
-  } catch (error) {
-    console.error('Failed to search pages:', error);
-    throw error;
-  }
-}
-
-export async function uploadImage(imagePath) {
-  // Validate input
-  await validators.validateImagePath(imagePath);
-
-  const imageData = { file: imagePath };
-
-  try {
-    return await handleApiRequest('images', 'upload', imageData);
-  } catch (error) {
-    if (error instanceof GhostAPIError) {
-      throw new ValidationError(`Image upload failed: ${error.originalError}`);
-    }
-    throw error;
-  }
-}
-
-export async function createTag(tagData) {
-  // Validate input
-  validators.validateTagData(tagData);
-
-  // Auto-generate slug if not provided
-  if (!tagData.slug) {
-    tagData.slug = tagData.name
-      .toLowerCase()
-      .replace(/[^a-z0-9]+/g, '-')
-      .replace(/^-+|-+$/g, '');
-  }
-
-  try {
-    return await handleApiRequest('tags', 'add', tagData);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      // Check if it's a duplicate tag error
-      if (error.originalError.includes('already exists')) {
-        // Try to fetch the existing tag by name filter
-        const existingTags = await getTags({ filter: `name:'${tagData.name}'` });
-        if (existingTags.length > 0) {
-          return existingTags[0]; // Return existing tag instead of failing
-        }
-      }
-      throw new ValidationError('Tag creation failed', [
-        { field: 'tag', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-export async function getTags(options = {}) {
-  try {
-    const tags = await handleApiRequest(
-      'tags',
-      'browse',
-      {},
-      {
-        limit: 15,
-        ...options,
-      }
-    );
-    return tags || [];
-  } catch (error) {
-    logger.error('Failed to get tags', { error: error.message });
-    throw error;
-  }
-}
-
-export async function getTag(tagId, options = {}) {
-  return readResource('tags', tagId, 'Tag', options);
-}
-
-export async function updateTag(tagId, updateData) {
-  if (!tagId) {
-    throw new ValidationError('Tag ID is required for update');
-  }
-
-  validators.validateTagUpdateData(updateData);
-
-  try {
-    await readResource('tags', tagId, 'Tag');
-    return await handleApiRequest('tags', 'edit', { id: tagId, ...updateData });
-  } catch (error) {
-    if (error instanceof NotFoundError) {
-      throw error;
-    }
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      throw new ValidationError('Tag update failed', [
-        { field: 'tag', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-export async function deleteTag(tagId) {
-  return deleteResource('tags', tagId, 'Tag');
-}
-
-/**
- * Member CRUD Operations
- * Members represent subscribers/users in Ghost CMS
- */
-
-/**
- * Creates a new member (subscriber) in Ghost CMS
- * @param {Object} memberData - The member data
- * @param {string} memberData.email - Member email (required)
- * @param {string} [memberData.name] - Member name
- * @param {string} [memberData.note] - Notes about the member (HTML will be sanitized)
- * @param {string[]} [memberData.labels] - Array of label names
- * @param {Object[]} [memberData.newsletters] - Array of newsletter objects with id
- * @param {boolean} [memberData.subscribed] - Email subscription status
- * @param {Object} [options] - Additional options for the API request
- * @returns {Promise<Object>} The created member object
- * @throws {ValidationError} If validation fails
- * @throws {GhostAPIError} If the API request fails
- */
-export async function createMember(memberData, options = {}) {
-  // Input validation is performed at the MCP tool layer using Zod schemas
-  try {
-    return await handleApiRequest('members', 'add', memberData, options);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      throw new ValidationError('Member creation failed due to validation errors', [
-        { field: 'member', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-/**
- * Updates an existing member in Ghost CMS
- * @param {string} memberId - The member ID to update
- * @param {Object} updateData - The member update data
- * @param {string} [updateData.email] - Member email
- * @param {string} [updateData.name] - Member name
- * @param {string} [updateData.note] - Notes about the member (HTML will be sanitized)
- * @param {string[]} [updateData.labels] - Array of label names
- * @param {Object[]} [updateData.newsletters] - Array of newsletter objects with id
- * @param {boolean} [updateData.subscribed] - Email subscription status
- * @param {Object} [options] - Additional options for the API request
- * @returns {Promise<Object>} The updated member object
- * @throws {ValidationError} If validation fails
- * @throws {NotFoundError} If the member is not found
- * @throws {GhostAPIError} If the API request fails
- */
-export async function updateMember(memberId, updateData, options = {}) {
-  // Input validation is performed at the MCP tool layer using Zod schemas
-  if (!memberId) {
-    throw new ValidationError('Member ID is required for update');
-  }
-
-  return updateWithOCC('members', memberId, updateData, options, 'Member');
-}
-
-/**
- * Deletes a member from Ghost CMS
- * @param {string} memberId - The member ID to delete
- * @returns {Promise<Object>} Deletion confirmation object
- * @throws {ValidationError} If member ID is not provided
- * @throws {NotFoundError} If the member is not found
- * @throws {GhostAPIError} If the API request fails
- */
-export async function deleteMember(memberId) {
-  return deleteResource('members', memberId, 'Member');
-}
-
-/**
- * List members from Ghost CMS with optional filtering and pagination
- * @param {Object} [options] - Query options
- * @param {number} [options.limit] - Number of members to return (1-100)
- * @param {number} [options.page] - Page number (1+)
- * @param {string} [options.filter] - NQL filter string (e.g., 'status:paid')
- * @param {string} [options.order] - Order string (e.g., 'created_at desc')
- * @param {string} [options.include] - Include string (e.g., 'labels,newsletters')
- * @returns {Promise<Array>} Array of member objects
- * @throws {ValidationError} If validation fails
- * @throws {GhostAPIError} If the API request fails
- */
-export async function getMembers(options = {}) {
-  // Input validation is performed at the MCP tool layer using Zod schemas
-  const defaultOptions = {
-    limit: 15,
-    ...options,
-  };
-
-  try {
-    const members = await handleApiRequest('members', 'browse', {}, defaultOptions);
-    return members || [];
-  } catch (error) {
-    console.error('Failed to get members:', error);
-    throw error;
-  }
-}
-
-/**
- * Get a single member from Ghost CMS by ID or email
- * @param {Object} params - Lookup parameters (id OR email required)
- * @param {string} [params.id] - Member ID
- * @param {string} [params.email] - Member email
- * @returns {Promise<Object>} The member object
- * @throws {ValidationError} If validation fails
- * @throws {NotFoundError} If the member is not found
- * @throws {GhostAPIError} If the API request fails
- */
-export async function getMember(params) {
-  // Input validation is performed at the MCP tool layer using Zod schemas
-  const { id, email } = params;
-
-  try {
-    if (id) {
-      // Lookup by ID using read endpoint
-      return await handleApiRequest('members', 'read', { id }, { id });
-    } else {
-      // Lookup by email using browse with filter
-      const sanitizedEmail = sanitizeNqlValue(email);
-      const members = await handleApiRequest(
-        'members',
-        'browse',
-        {},
-        { filter: `email:'${sanitizedEmail}'`, limit: 1 }
-      );
-
-      if (!members || members.length === 0) {
-        throw new NotFoundError('Member', email);
-      }
-
-      return members[0];
-    }
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 404) {
-      throw new NotFoundError('Member', id || email);
-    }
-    throw error;
-  }
-}
-
-/**
- * Search members by name or email
- * @param {string} query - Search query (searches name and email fields)
- * @param {Object} [options] - Additional options
- * @param {number} [options.limit] - Maximum number of results (default: 15)
- * @returns {Promise<Array>} Array of matching member objects
- * @throws {ValidationError} If validation fails
- * @throws {GhostAPIError} If the API request fails
- */
-export async function searchMembers(query, options = {}) {
-  // Input validation is performed at the MCP tool layer using Zod schemas
-  const sanitizedQuery = sanitizeNqlValue(query.trim());
-
-  const limit = options.limit || 15;
-
-  // Build NQL filter for name or email containing the query
-  // Ghost uses ~ for contains/like matching
-  const filter = `name:~'${sanitizedQuery}',email:~'${sanitizedQuery}'`;
-
-  try {
-    const members = await handleApiRequest('members', 'browse', {}, { filter, limit });
-    return members || [];
-  } catch (error) {
-    console.error('Failed to search members:', error);
-    throw error;
-  }
-}
-
-/**
- * Newsletter CRUD Operations
- */
-
-export async function getNewsletters(options = {}) {
-  const defaultOptions = {
-    limit: 'all',
-    ...options,
-  };
-
-  try {
-    const newsletters = await handleApiRequest('newsletters', 'browse', {}, defaultOptions);
-    return newsletters || [];
-  } catch (error) {
-    console.error('Failed to get newsletters:', error);
-    throw error;
-  }
-}
-
-export async function getNewsletter(newsletterId) {
-  return readResource('newsletters', newsletterId, 'Newsletter');
-}
-
-export async function createNewsletter(newsletterData) {
-  // Validate input
-  validators.validateNewsletterData(newsletterData);
-
-  try {
-    return await handleApiRequest('newsletters', 'add', newsletterData);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      throw new ValidationError('Newsletter creation failed', [
-        { field: 'newsletter', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-export async function updateNewsletter(newsletterId, updateData) {
-  if (!newsletterId) {
-    throw new ValidationError('Newsletter ID is required for update');
-  }
-
-  try {
-    return await updateWithOCC('newsletters', newsletterId, updateData, {}, 'Newsletter');
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      throw new ValidationError('Newsletter update failed', [
-        { field: 'newsletter', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-export async function deleteNewsletter(newsletterId) {
-  return deleteResource('newsletters', newsletterId, 'Newsletter');
-}
-
-/**
- * Create a new tier (membership level)
- * @param {Object} tierData - Tier data
- * @param {Object} [options={}] - Options for the API request
- * @returns {Promise<Object>} Created tier
- */
-export async function createTier(tierData, options = {}) {
-  const { validateTierData } = await import('./tierService.js');
-  validateTierData(tierData);
-
-  try {
-    return await handleApiRequest('tiers', 'add', tierData, options);
-  } catch (error) {
-    if (error instanceof GhostAPIError && error.ghostStatusCode === 422) {
-      throw new ValidationError('Tier creation failed due to validation errors', [
-        { field: 'tier', message: error.originalError },
-      ]);
-    }
-    throw error;
-  }
-}
-
-/**
- * Update an existing tier
- * @param {string} id - Tier ID
- * @param {Object} updateData - Tier update data
- * @param {Object} [options={}] - Options for the API request
- * @returns {Promise<Object>} Updated tier
- */
-export async function updateTier(id, updateData, options = {}) {
-  if (!id || typeof id !== 'string' || id.trim().length === 0) {
-    throw new ValidationError('Tier ID is required for update');
-  }
-
-  const { validateTierUpdateData } = await import('./tierService.js');
-  validateTierUpdateData(updateData);
-
-  return updateWithOCC('tiers', id, updateData, options, 'Tier');
-}
-
-/**
- * Delete a tier
- * @param {string} id - Tier ID
- * @returns {Promise<Object>} Deletion result
- */
-export async function deleteTier(id) {
-  if (!id || typeof id !== 'string' || id.trim().length === 0) {
-    throw new ValidationError('Tier ID is required for deletion');
-  }
+ * Barrel re-export for backward compatibility.
+ *
+ * The implementation has been split into focused modules:
+ *   - ghostApiClient.js  — API client, circuit breaker, retry logic, CRUD helpers
+ *   - validators.js      — Input validation helpers
+ *   - posts.js           — Post CRUD operations
+ *   - pages.js           — Page CRUD operations
+ *   - tags.js            — Tag CRUD operations
+ *   - members.js         — Member CRUD operations
+ *   - newsletters.js     — Newsletter CRUD operations
+ *   - tiers.js           — Tier CRUD operations
+ *   - images.js          — Image upload
+ */
+
+// Infrastructure
+export {
+  api,
+  ghostCircuitBreaker,
+  handleApiRequest,
+  readResource,
+  updateWithOCC,
+  deleteResource,
+  getSiteInfo,
+  checkHealth,
+} from './ghostApiClient.js';
 
-  return deleteResource('tiers', id, 'Tier');
-}
+// Validators
+export { validators } from './validators.js';
 
-/**
- * Get all tiers with optional filtering
- * @param {Object} [options={}] - Query options
- * @param {number} [options.limit] - Number of tiers to return (1-100, default 15)
- * @param {number} [options.page] - Page number
- * @param {string} [options.filter] - NQL filter string (e.g., "type:paid", "type:free")
- * @param {string} [options.order] - Order string
- * @param {string} [options.include] - Include string
- * @returns {Promise<Array>} Array of tiers
- */
-export async function getTiers(options = {}) {
-  const { validateTierQueryOptions } = await import('./tierService.js');
-  validateTierQueryOptions(options);
+// Posts
+export { createPost, updatePost, deletePost, getPost, getPosts, searchPosts } from './posts.js';
 
-  const defaultOptions = {
-    limit: 15,
-    ...options,
-  };
+// Pages
+export { createPage, updatePage, deletePage, getPage, getPages, searchPages } from './pages.js';
 
-  try {
-    const tiers = await handleApiRequest('tiers', 'browse', {}, defaultOptions);
-    return tiers || [];
-  } catch (error) {
-    console.error('Failed to get tiers:', error);
-    throw error;
-  }
-}
+// Tags
+export { createTag, getTags, getTag, updateTag, deleteTag } from './tags.js';
 
-/**
- * Get a single tier by ID
- * @param {string} id - Tier ID
- * @returns {Promise<Object>} Tier object
- */
-export async function getTier(id) {
-  if (!id || typeof id !== 'string' || id.trim().length === 0) {
-    throw new ValidationError('Tier ID is required and must be a non-empty string');
-  }
+// Members
+export {
+  createMember,
+  updateMember,
+  deleteMember,
+  getMembers,
+  getMember,
+  searchMembers,
+} from './members.js';
 
-  return readResource('tiers', id, 'Tier');
-}
+// Newsletters
+export {
+  getNewsletters,
+  getNewsletter,
+  createNewsletter,
+  updateNewsletter,
+  deleteNewsletter,
+} from './newsletters.js';
 
-/**
- * Health check for Ghost API connection
- */
-export async function checkHealth() {
-  try {
-    const site = await getSiteInfo();
-    const circuitState = ghostCircuitBreaker.getState();
+// Tiers
+export { createTier, updateTier, deleteTier, getTiers, getTier } from './tiers.js';
 
-    return {
-      status: 'healthy',
-      site: {
-        title: site.title,
-        version: site.version,
-        url: site.url,
-      },
-      circuitBreaker: circuitState,
-      timestamp: new Date().toISOString(),
-    };
-  } catch (error) {
-    return {
-      status: 'unhealthy',
-      error: error.message,
-      circuitBreaker: ghostCircuitBreaker.getState(),
-      timestamp: new Date().toISOString(),
-    };
-  }
-}
+// Images
+export { uploadImage } from './images.js';
 
-// Export everything including the API client for backward compatibility
-export { api, handleApiRequest, ghostCircuitBreaker, validators };
+// Re-import for default export object
+import { getSiteInfo, checkHealth } from './ghostApiClient.js';
+import { createPost, updatePost, deletePost, getPost, getPosts, searchPosts } from './posts.js';
+import { createPage, updatePage, deletePage, getPage, getPages, searchPages } from './pages.js';
+import { createTag, getTags, getTag, updateTag, deleteTag } from './tags.js';
+import {
+  createMember,
+  updateMember,
+  deleteMember,
+  getMembers,
+  getMember,
+  searchMembers,
+} from './members.js';
+import {
+  getNewsletters,
+  getNewsletter,
+  createNewsletter,
+  updateNewsletter,
+  deleteNewsletter,
+} from './newsletters.js';
+import { createTier, updateTier, deleteTier, getTiers, getTier } from './tiers.js';
+import { uploadImage } from './images.js';
 
 export default {
   getSiteInfo,