2.1.0

changelog.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 2025-10-08 - 2.1.0 - feat(syncedinstance)
+Add SyncedInstance for multi-instance content synchronization, export it, add tests, and expand README
+
+- Introduce SyncedInstance class (ts/classes.syncedinstance.ts) to synchronize tags, posts and pages across Ghost instances with mapping and history support. New APIs: syncTags, syncPosts, syncPages, syncAll, getSyncStatus, clearSyncHistory, clearMappings.
+- Export SyncedInstance from the package entry point (ts/index.ts).
+- Add integration tests for SyncedInstance (test/test.syncedinstance.node.ts).
+- Expand README (readme.md) with Quick Start, detailed Multi-Instance Synchronization docs, examples and updated API reference.
+
+## 2025-10-08 - 2.0.0 - BREAKING CHANGE(classes.ghost)
+Remove Settings and Webhooks browse/read APIs, remove noisy console.error logs, and update tests/docs
+
+- Removed Settings API methods from Ghost: getSettings and updateSettings (breaking change).
+- Removed Webhooks browsing/reading methods from Ghost: getWebhooks and getWebhookById. createWebhook, updateWebhook and deleteWebhook remain.
+- Removed test/test.settings.node.ts and simplified test/test.webhook.node.ts to only exercise create/update/delete webhook flows without feature-availability guarding.
+- Stripped console.error debug logging across multiple classes (Author, Ghost, Member, Page, Post, Tag) to reduce noisy runtime output.
+- Updated README: removed 'Site Settings' section and clarified webhook API limitations supported by the underlying Ghost Admin SDK.
+
+## 2025-10-07 - 1.4.1 - fix(tests)
+Remove updated_at from post and page update test payloads
+
+- Stop setting updated_at in test update payloads to avoid mutating server-managed timestamps
+- Changed test/test.post.node.ts: removed updated_at assignment when updating a post
+- Changed test/test.page.node.ts: removed updated_at assignment when updating a page
+
+## 2025-10-07 - 1.4.0 - feat(classes.ghost)
+Add members, settings and webhooks support; implement Member class and add tests
+
+- Introduce IMember and Member class (ts/classes.member.ts) with CRUD (update, delete) and JSON helpers
+- Add member management API to Ghost: getMembers (with minimatch filtering), getMemberById, getMemberByEmail, createMember
+- Add site settings API to Ghost: getSettings and updateSettings (admin API wrappers)
+- Add webhooks management to Ghost: getWebhooks, getWebhookById, createWebhook, updateWebhook, deleteWebhook
+- Wire smartmatch filtering for members using @push.rocks/smartmatch
+- Export Member from ts/index.ts so it's part of the public API
+- Add comprehensive node tests for Ghost, Author, Member, Page, Post, Tag, Settings and Webhooks (test/*.node.ts)
+- Fix Post construction usages in classes.ghost to pass the Ghost instance when creating Post objects
+
 ## 2025-10-07 - 1.3.0 - feat(core)
 Add Ghost CMS API client classes and README documentation
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apiclient.xyz/ghost",
-  "version": "1.3.0",
+  "version": "2.1.0",
   "private": false,
   "description": "An unofficial Ghost CMS API package enabling content and admin functionality for managing posts.",
   "main": "dist_ts/index.js",

test/test.author.node.ts

@@ -0,0 +1,107 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+
+tap.test('initialize Ghost instance', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('should get all authors', async () => {
+  const authors = await testGhostInstance.getAuthors();
+  expect(authors).toBeArray();
+  console.log(`Found ${authors.length} authors`);
+  if (authors.length > 0) {
+    expect(authors[0]).toBeInstanceOf(ghost.Author);
+    console.log(`First author: ${authors[0].getName()} (${authors[0].getSlug()})`);
+  }
+});
+
+tap.test('should get authors with limit', async () => {
+  const authors = await testGhostInstance.getAuthors({ limit: 2 });
+  expect(authors).toBeArray();
+  expect(authors.length).toBeLessThanOrEqual(2);
+});
+
+tap.test('should filter authors with minimatch pattern', async () => {
+  const authors = await testGhostInstance.getAuthors();
+  if (authors.length > 0) {
+    const firstAuthorSlug = authors[0].getSlug();
+    const pattern = `${firstAuthorSlug.charAt(0)}*`;
+    const filteredAuthors = await testGhostInstance.getAuthors({ filter: pattern });
+    expect(filteredAuthors).toBeArray();
+    console.log(`Filtered authors with pattern '${pattern}': found ${filteredAuthors.length}`);
+    filteredAuthors.forEach((author) => {
+      expect(author.getSlug()).toMatch(new RegExp(`^${firstAuthorSlug.charAt(0)}`));
+    });
+  }
+});
+
+tap.test('should get author by slug', async () => {
+  const authors = await testGhostInstance.getAuthors({ limit: 1 });
+  if (authors.length > 0) {
+    const author = await testGhostInstance.getAuthorBySlug(authors[0].getSlug());
+    expect(author).toBeInstanceOf(ghost.Author);
+    expect(author.getSlug()).toEqual(authors[0].getSlug());
+    console.log(`Got author by slug: ${author.getName()}`);
+  }
+});
+
+tap.test('should get author by ID', async () => {
+  const authors = await testGhostInstance.getAuthors({ limit: 1 });
+  if (authors.length > 0) {
+    const author = await testGhostInstance.getAuthorById(authors[0].getId());
+    expect(author).toBeInstanceOf(ghost.Author);
+    expect(author.getId()).toEqual(authors[0].getId());
+  }
+});
+
+tap.test('should access author methods', async () => {
+  const authors = await testGhostInstance.getAuthors({ limit: 1 });
+  if (authors.length > 0) {
+    const author = authors[0];
+    expect(author.getId()).toBeTruthy();
+    expect(author.getName()).toBeTruthy();
+    expect(author.getSlug()).toBeTruthy();
+    const json = author.toJson();
+    expect(json).toBeTruthy();
+    expect(json.id).toEqual(author.getId());
+  }
+});
+
+tap.test('should update author bio', async () => {
+  try {
+    const authors = await testGhostInstance.getAuthors({ limit: 1 });
+    if (authors.length > 0) {
+      const author = authors[0];
+      const originalBio = author.getBio();
+      
+      const updatedAuthor = await author.update({
+        bio: 'Updated bio for testing'
+      });
+      expect(updatedAuthor).toBeInstanceOf(ghost.Author);
+      expect(updatedAuthor.getBio()).toEqual('Updated bio for testing');
+      console.log(`Updated author bio: ${updatedAuthor.getName()}`);
+      
+      await updatedAuthor.update({
+        bio: originalBio
+      });
+    }
+  } catch (error: any) {
+    if (error.type === 'NotImplementedError') {
+      console.log('Author updates not supported in this Ghost version - skipping test');
+    } else {
+      throw error;
+    }
+  }
+});
+
+export default tap.start();

test/test.ghost.node.ts

@@ -0,0 +1,28 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+
+tap.test('should create a valid instance of Ghost', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+  expect(testGhostInstance.options.baseUrl).toEqual('http://localhost:2368');
+});
+
+tap.test('should have adminApi configured', async () => {
+  expect(testGhostInstance.adminApi).toBeTruthy();
+});
+
+tap.test('should have contentApi configured', async () => {
+  expect(testGhostInstance.contentApi).toBeTruthy();
+});
+
+export default tap.start();
+export { testGhostInstance };

test/test.member.node.ts

@@ -0,0 +1,151 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+let createdMember: ghost.Member;
+
+tap.test('initialize Ghost instance', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('should get all members', async () => {
+  try {
+    const members = await testGhostInstance.getMembers({ limit: 10 });
+    expect(members).toBeArray();
+    console.log(`Found ${members.length} members`);
+    if (members.length > 0) {
+      expect(members[0]).toBeInstanceOf(ghost.Member);
+      console.log(`First member: ${members[0].getEmail()}`);
+    }
+  } catch (error: any) {
+    if (error.message?.includes('members') || error.statusCode === 403) {
+      console.log('Members feature not available or requires permissions - skipping test');
+    } else {
+      throw error;
+    }
+  }
+});
+
+tap.test('should get members with limit', async () => {
+  try {
+    const members = await testGhostInstance.getMembers({ limit: 2 });
+    expect(members).toBeArray();
+    expect(members.length).toBeLessThanOrEqual(2);
+  } catch (error: any) {
+    if (error.message?.includes('members') || error.statusCode === 403) {
+      console.log('Members feature not available - skipping test');
+    } else {
+      throw error;
+    }
+  }
+});
+
+tap.test('should filter members with minimatch pattern', async () => {
+  try {
+    const members = await testGhostInstance.getMembers({ filter: '*@gmail.com' });
+    expect(members).toBeArray();
+    console.log(`Found ${members.length} Gmail members`);
+    if (members.length > 0) {
+      members.forEach((member) => {
+        expect(member.getEmail()).toContain('@gmail.com');
+      });
+    }
+  } catch (error: any) {
+    if (error.message?.includes('members') || error.statusCode === 403) {
+      console.log('Members feature not available - skipping test');
+    } else {
+      throw error;
+    }
+  }
+});
+
+tap.test('should create member', async () => {
+  try {
+    const timestamp = Date.now();
+    createdMember = await testGhostInstance.createMember({
+      email: `test${timestamp}@example.com`,
+      name: `Test Member ${timestamp}`
+    });
+    expect(createdMember).toBeInstanceOf(ghost.Member);
+    expect(createdMember.getEmail()).toEqual(`test${timestamp}@example.com`);
+    console.log(`Created member: ${createdMember.getId()}`);
+  } catch (error: any) {
+    if (error.message?.includes('members') || error.statusCode === 403) {
+      console.log('Members feature not available - skipping test');
+    } else {
+      throw error;
+    }
+  }
+});
+
+tap.test('should access member methods', async () => {
+  if (createdMember) {
+    expect(createdMember.getId()).toBeTruthy();
+    expect(createdMember.getEmail()).toBeTruthy();
+    expect(createdMember.getName()).toBeTruthy();
+    const json = createdMember.toJson();
+    expect(json).toBeTruthy();
+    expect(json.id).toEqual(createdMember.getId());
+  }
+});
+
+tap.test('should get member by email', async () => {
+  if (createdMember) {
+    try {
+      const member = await testGhostInstance.getMemberByEmail(createdMember.getEmail());
+      expect(member).toBeInstanceOf(ghost.Member);
+      expect(member.getEmail()).toEqual(createdMember.getEmail());
+    } catch (error: any) {
+      if (error.message?.includes('members') || error.statusCode === 403 || error.type === 'RequestNotAcceptableError') {
+        console.log('Member by email not supported in this Ghost version - using ID instead');
+        const member = await testGhostInstance.getMemberById(createdMember.getId());
+        expect(member).toBeInstanceOf(ghost.Member);
+      } else {
+        throw error;
+      }
+    }
+  }
+});
+
+tap.test('should update member', async () => {
+  if (createdMember) {
+    try {
+      const updatedMember = await createdMember.update({
+        note: 'Updated by automated tests'
+      });
+      expect(updatedMember).toBeInstanceOf(ghost.Member);
+      console.log(`Updated member: ${updatedMember.getId()}`);
+    } catch (error: any) {
+      if (error.message?.includes('members') || error.statusCode === 403) {
+        console.log('Members feature not available - skipping test');
+      } else {
+        throw error;
+      }
+    }
+  }
+});
+
+tap.test('should delete member', async () => {
+  if (createdMember) {
+    try {
+      await createdMember.delete();
+      console.log(`Deleted member: ${createdMember.getId()}`);
+    } catch (error: any) {
+      if (error.message?.includes('members') || error.statusCode === 403) {
+        console.log('Members feature not available - skipping test');
+      } else {
+        throw error;
+      }
+    }
+  }
+});
+
+export default tap.start();

test/test.page.node.ts

@@ -0,0 +1,106 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+let createdPage: ghost.Page;
+
+tap.test('initialize Ghost instance', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('should get all pages', async () => {
+  const pages = await testGhostInstance.getPages();
+  expect(pages).toBeArray();
+  console.log(`Found ${pages.length} pages`);
+  if (pages.length > 0) {
+    expect(pages[0]).toBeInstanceOf(ghost.Page);
+    console.log(`First page: ${pages[0].getTitle()} (${pages[0].getSlug()})`);
+  }
+});
+
+tap.test('should get pages with limit', async () => {
+  const pages = await testGhostInstance.getPages({ limit: 3 });
+  expect(pages).toBeArray();
+  expect(pages.length).toBeLessThanOrEqual(3);
+});
+
+tap.test('should filter pages with minimatch pattern', async () => {
+  const pages = await testGhostInstance.getPages();
+  if (pages.length > 0) {
+    const firstPageSlug = pages[0].getSlug();
+    const pattern = `${firstPageSlug.charAt(0)}*`;
+    const filteredPages = await testGhostInstance.getPages({ filter: pattern });
+    expect(filteredPages).toBeArray();
+    console.log(`Filtered pages with pattern '${pattern}': found ${filteredPages.length}`);
+  }
+});
+
+tap.test('should get page by slug', async () => {
+  const pages = await testGhostInstance.getPages({ limit: 1 });
+  if (pages.length > 0) {
+    const page = await testGhostInstance.getPageBySlug(pages[0].getSlug());
+    expect(page).toBeInstanceOf(ghost.Page);
+    expect(page.getSlug()).toEqual(pages[0].getSlug());
+    console.log(`Got page by slug: ${page.getTitle()}`);
+  }
+});
+
+tap.test('should get page by ID', async () => {
+  const pages = await testGhostInstance.getPages({ limit: 1 });
+  if (pages.length > 0) {
+    const page = await testGhostInstance.getPageById(pages[0].getId());
+    expect(page).toBeInstanceOf(ghost.Page);
+    expect(page.getId()).toEqual(pages[0].getId());
+  }
+});
+
+tap.test('should create page', async () => {
+  const timestamp = Date.now();
+  createdPage = await testGhostInstance.createPage({
+    title: `Test Page ${timestamp}`,
+    html: '<p>This is a test page created by automated tests.</p>',
+    status: 'published'
+  } as any);
+  expect(createdPage).toBeInstanceOf(ghost.Page);
+  expect(createdPage.getTitle()).toEqual(`Test Page ${timestamp}`);
+  console.log(`Created page: ${createdPage.getId()}`);
+});
+
+tap.test('should access page methods', async () => {
+  if (createdPage) {
+    expect(createdPage.getId()).toBeTruthy();
+    expect(createdPage.getTitle()).toBeTruthy();
+    expect(createdPage.getSlug()).toBeTruthy();
+    const json = createdPage.toJson();
+    expect(json).toBeTruthy();
+    expect(json.id).toEqual(createdPage.getId());
+  }
+});
+
+tap.test('should update page', async () => {
+  if (createdPage) {
+    const updatedPage = await createdPage.update({
+      ...createdPage.pageData,
+      html: '<p>This page has been updated.</p>'
+    });
+    expect(updatedPage).toBeInstanceOf(ghost.Page);
+    console.log(`Updated page: ${updatedPage.getId()}`);
+  }
+});
+
+tap.test('should delete page', async () => {
+  if (createdPage) {
+    await createdPage.delete();
+    console.log(`Deleted page: ${createdPage.getId()}`);
+  }
+});
+
+export default tap.start();

test/test.post.node.ts

@@ -0,0 +1,144 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+let createdPost: ghost.Post;
+
+tap.test('initialize Ghost instance', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('should get all posts', async () => {
+  const posts = await testGhostInstance.getPosts();
+  expect(posts).toBeArray();
+  if (posts.length > 0) {
+    expect(posts[0]).toBeInstanceOf(ghost.Post);
+    console.log(`Found ${posts.length} posts`);
+  }
+});
+
+tap.test('should get posts with limit', async () => {
+  const posts = await testGhostInstance.getPosts({ limit: 5 });
+  expect(posts).toBeArray();
+  expect(posts.length).toBeLessThanOrEqual(5);
+});
+
+tap.test('should filter posts by tag', async () => {
+  const tags = await testGhostInstance.getTags({ limit: 1 });
+  if (tags.length > 0) {
+    const posts = await testGhostInstance.getPosts({ tag: tags[0].slug, limit: 5 });
+    expect(posts).toBeArray();
+    console.log(`Found ${posts.length} posts with tag '${tags[0].name}'`);
+  }
+});
+
+tap.test('should filter posts by author', async () => {
+  const authors = await testGhostInstance.getAuthors({ limit: 1 });
+  if (authors.length > 0) {
+    const posts = await testGhostInstance.getPosts({ author: authors[0].getSlug(), limit: 5 });
+    expect(posts).toBeArray();
+    console.log(`Found ${posts.length} posts by author '${authors[0].getName()}'`);
+  }
+});
+
+tap.test('should filter posts by featured status', async () => {
+  const featuredPosts = await testGhostInstance.getPosts({ featured: true, limit: 5 });
+  expect(featuredPosts).toBeArray();
+  console.log(`Found ${featuredPosts.length} featured posts`);
+  if (featuredPosts.length > 0) {
+    expect(featuredPosts[0].postData.featured).toEqual(true);
+  }
+});
+
+tap.test('should search posts by title', async () => {
+  const searchResults = await testGhostInstance.searchPosts('the', { limit: 5 });
+  expect(searchResults).toBeArray();
+  console.log(`Found ${searchResults.length} posts matching 'the'`);
+});
+
+tap.test('should get post by ID', async () => {
+  const posts = await testGhostInstance.getPosts({ limit: 1 });
+  if (posts.length > 0) {
+    const post = await testGhostInstance.getPostById(posts[0].getId());
+    expect(post).toBeInstanceOf(ghost.Post);
+    expect(post.getId()).toEqual(posts[0].getId());
+  }
+});
+
+tap.test('should get related posts', async () => {
+  const posts = await testGhostInstance.getPosts({ limit: 1 });
+  if (posts.length > 0) {
+    const relatedPosts = await testGhostInstance.getRelatedPosts(posts[0].getId(), 3);
+    expect(relatedPosts).toBeArray();
+    console.log(`Found ${relatedPosts.length} related posts for '${posts[0].getTitle()}'`);
+  }
+});
+
+tap.test('should create post from HTML', async () => {
+  const timestamp = Date.now();
+  createdPost = await testGhostInstance.createPostFromHtml({
+    title: `Test Post ${timestamp}`,
+    html: '<p>This is a test post created by automated tests.</p>',
+    status: 'published'
+  } as any);
+  expect(createdPost).toBeInstanceOf(ghost.Post);
+  expect(createdPost.getTitle()).toEqual(`Test Post ${timestamp}`);
+  console.log(`Created post: ${createdPost.getId()}`);
+});
+
+tap.test('should access post methods', async () => {
+  if (createdPost) {
+    expect(createdPost.getId()).toBeTruthy();
+    expect(createdPost.getTitle()).toBeTruthy();
+    const json = createdPost.toJson();
+    expect(json).toBeTruthy();
+    expect(json.id).toEqual(createdPost.getId());
+  }
+});
+
+tap.test('should update post', async () => {
+  if (createdPost) {
+    const updatedPost = await createdPost.update({
+      ...createdPost.postData,
+      html: '<p>This post has been updated.</p>'
+    });
+    expect(updatedPost).toBeInstanceOf(ghost.Post);
+    console.log(`Updated post: ${updatedPost.getId()}`);
+  }
+});
+
+tap.test('should delete post', async () => {
+  if (createdPost) {
+    await createdPost.delete();
+    console.log(`Deleted post: ${createdPost.getId()}`);
+  }
+});
+
+tap.test('should bulk update posts', async () => {
+  const posts = await testGhostInstance.getPosts({ limit: 2 });
+  if (posts.length >= 2) {
+    const postIds = posts.map(p => p.getId());
+    const originalFeatured = posts[0].postData.featured;
+    
+    const updatedPosts = await testGhostInstance.bulkUpdatePosts(postIds, {
+      featured: !originalFeatured
+    });
+    expect(updatedPosts).toBeArray();
+    expect(updatedPosts.length).toEqual(postIds.length);
+    
+    await testGhostInstance.bulkUpdatePosts(postIds, {
+      featured: originalFeatured
+    });
+    console.log(`Bulk updated ${updatedPosts.length} posts`);
+  }
+});
+
+export default tap.start();

test/test.syncedinstance.node.ts

@@ -0,0 +1,185 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let sourceGhost: ghost.Ghost;
+let targetGhost: ghost.Ghost;
+let syncedInstance: ghost.SyncedInstance;
+let testTag: ghost.Tag;
+let testPost: ghost.Post;
+let testPage: ghost.Page;
+
+tap.test('initialize source and target Ghost instances', async () => {
+  sourceGhost = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  
+  targetGhost = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  
+  expect(sourceGhost).toBeInstanceOf(ghost.Ghost);
+  expect(targetGhost).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('create SyncedInstance', async () => {
+  syncedInstance = new ghost.SyncedInstance(sourceGhost, [targetGhost]);
+  expect(syncedInstance).toBeInstanceOf(ghost.SyncedInstance);
+  expect(syncedInstance.sourceGhost).toEqual(sourceGhost);
+  expect(syncedInstance.targetGhosts).toBeArray();
+  expect(syncedInstance.targetGhosts.length).toEqual(1);
+});
+
+tap.test('create test tag on source', async () => {
+  const timestamp = Date.now();
+  testTag = await sourceGhost.createTag({
+    name: `Sync Test Tag ${timestamp}`,
+    slug: `sync-test-tag-${timestamp}`,
+    description: 'This is a test tag for syncing'
+  });
+  expect(testTag).toBeInstanceOf(ghost.Tag);
+});
+
+tap.test('sync tags from source to target', async () => {
+  const report = await syncedInstance.syncTags();
+  
+  expect(report).toBeTruthy();
+  expect(report.contentType).toEqual('tags');
+  expect(report.totalItems).toBeGreaterThan(0);
+  expect(report.targetReports).toBeArray();
+  expect(report.targetReports.length).toEqual(1);
+  
+  const targetReport = report.targetReports[0];
+  expect(targetReport.results).toBeArray();
+});
+
+tap.test('verify sync status was tracked', async () => {
+  const status = syncedInstance.getSyncStatus();
+  expect(status.totalMappings).toBeGreaterThan(0);
+  expect(status.recentSyncs).toBeArray();
+  expect(status.recentSyncs.length).toBeGreaterThan(0);
+});
+
+tap.test('create test post on source', async () => {
+  const timestamp = Date.now();
+  testPost = await sourceGhost.createPost({
+    title: `Sync Test Post ${timestamp}`,
+    slug: `sync-test-post-${timestamp}`,
+    html: '<p>This is a test post for syncing</p>',
+    status: 'published',
+    tags: [{ id: testTag.tagData.id }]
+  });
+  expect(testPost).toBeInstanceOf(ghost.Post);
+});
+
+tap.test('sync posts from source to target', async () => {
+  const report = await syncedInstance.syncPosts();
+  
+  expect(report).toBeTruthy();
+  expect(report.contentType).toEqual('posts');
+  expect(report.totalItems).toBeGreaterThan(0);
+  expect(report.targetReports).toBeArray();
+  expect(report.targetReports.length).toEqual(1);
+});
+
+tap.test('verify post sync in status', async () => {
+  const status = syncedInstance.getSyncStatus();
+  expect(status.recentSyncs).toBeArray();
+  const postSync = status.recentSyncs.find(s => s.contentType === 'posts');
+  expect(postSync).toBeTruthy();
+});
+
+tap.test('create test page on source', async () => {
+  const timestamp = Date.now();
+  testPage = await sourceGhost.createPage({
+    title: `Sync Test Page ${timestamp}`,
+    slug: `sync-test-page-${timestamp}`,
+    html: '<p>This is a test page for syncing</p>',
+    status: 'published'
+  });
+  expect(testPage).toBeInstanceOf(ghost.Page);
+});
+
+tap.test('sync pages from source to target', async () => {
+  const report = await syncedInstance.syncPages();
+  
+  expect(report).toBeTruthy();
+  expect(report.contentType).toEqual('pages');
+  expect(report.totalItems).toBeGreaterThan(0);
+  expect(report.targetReports).toBeArray();
+  expect(report.targetReports.length).toEqual(1);
+});
+
+tap.test('verify page sync in status', async () => {
+  const status = syncedInstance.getSyncStatus();
+  const pageSync = status.recentSyncs.find(s => s.contentType === 'pages');
+  expect(pageSync).toBeTruthy();
+});
+
+tap.test('test syncAll method', async () => {
+  const reports = await syncedInstance.syncAll({ 
+    types: ['tags', 'posts', 'pages'],
+    syncOptions: { dryRun: true }
+  });
+  
+  expect(reports).toBeArray();
+  expect(reports.length).toEqual(3);
+  expect(reports[0].contentType).toEqual('tags');
+  expect(reports[1].contentType).toEqual('posts');
+  expect(reports[2].contentType).toEqual('pages');
+});
+
+tap.test('test clear methods', async () => {
+  syncedInstance.clearMappings();
+  syncedInstance.clearSyncHistory();
+  
+  const status = syncedInstance.getSyncStatus();
+  expect(status.totalMappings).toEqual(0);
+  expect(status.recentSyncs.length).toEqual(0);
+});
+
+tap.test('update tag and re-sync', async () => {
+  await testTag.update({
+    description: 'Updated description for sync test'
+  });
+  
+  const report = await syncedInstance.syncTags();
+  expect(report).toBeTruthy();
+  expect(report.totalItems).toBeGreaterThan(0);
+});
+
+tap.test('cleanup - delete synced content', async () => {
+  if (testPost) {
+    await testPost.delete();
+    const targetPosts = await targetGhost.getPosts({ filter: `slug:${testPost.postData.slug}` });
+    if (targetPosts.length > 0) {
+      await targetPosts[0].delete();
+    }
+  }
+  
+  if (testPage) {
+    await testPage.delete();
+    try {
+      const targetPage = await targetGhost.getPageBySlug(testPage.pageData.slug);
+      await targetPage.delete();
+    } catch (error) {
+    }
+  }
+  
+  if (testTag) {
+    await testTag.delete();
+    try {
+      const targetTag = await targetGhost.getTagBySlug(testTag.tagData.slug);
+      await targetTag.delete();
+    } catch (error) {
+    }
+  }
+});
+
+export default tap.start();

test/test.tag.node.ts

@@ -0,0 +1,110 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+let createdTag: ghost.Tag;
+
+tap.test('initialize Ghost instance', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('should get all tags', async () => {
+  const tags = await testGhostInstance.getTags();
+  expect(tags).toBeArray();
+  console.log(`Found ${tags.length} tags`);
+  if (tags.length > 0) {
+    console.log(`First tag: ${tags[0].name} (${tags[0].slug})`);
+  }
+});
+
+tap.test('should get tags with limit', async () => {
+  const tags = await testGhostInstance.getTags({ limit: 3 });
+  expect(tags).toBeArray();
+  expect(tags.length).toBeLessThanOrEqual(3);
+});
+
+tap.test('should filter tags with minimatch pattern', async () => {
+  const allTags = await testGhostInstance.getTags();
+  if (allTags.length > 0) {
+    const firstTagSlug = allTags[0].slug;
+    const pattern = `${firstTagSlug.charAt(0)}*`;
+    
+    const filteredTags = await testGhostInstance.getTags({ filter: pattern });
+    expect(filteredTags).toBeArray();
+    console.log(`Filtered tags with pattern '${pattern}': found ${filteredTags.length}`);
+    filteredTags.forEach((tag) => {
+      expect(tag.slug).toMatch(new RegExp(`^${firstTagSlug.charAt(0)}`));
+    });
+  }
+});
+
+tap.test('should get tag by slug', async () => {
+  const tags = await testGhostInstance.getTags({ limit: 1 });
+  if (tags.length > 0) {
+    const tag = await testGhostInstance.getTagBySlug(tags[0].slug);
+    expect(tag).toBeInstanceOf(ghost.Tag);
+    expect(tag.getSlug()).toEqual(tags[0].slug);
+    console.log(`Got tag by slug: ${tag.getName()}`);
+  }
+});
+
+tap.test('should get tag by ID', async () => {
+  const tags = await testGhostInstance.getTags({ limit: 1 });
+  if (tags.length > 0) {
+    const tag = await testGhostInstance.getTagById(tags[0].id);
+    expect(tag).toBeInstanceOf(ghost.Tag);
+    expect(tag.getId()).toEqual(tags[0].id);
+  }
+});
+
+tap.test('should create tag', async () => {
+  const timestamp = Date.now();
+  createdTag = await testGhostInstance.createTag({
+    name: `Test Tag ${timestamp}`,
+    slug: `test-tag-${timestamp}`,
+    description: 'A test tag created by automated tests'
+  });
+  expect(createdTag).toBeInstanceOf(ghost.Tag);
+  expect(createdTag.getName()).toEqual(`Test Tag ${timestamp}`);
+  console.log(`Created tag: ${createdTag.getId()}`);
+});
+
+tap.test('should access tag methods', async () => {
+  if (createdTag) {
+    expect(createdTag.getId()).toBeTruthy();
+    expect(createdTag.getName()).toBeTruthy();
+    expect(createdTag.getSlug()).toBeTruthy();
+    expect(createdTag.getDescription()).toBeTruthy();
+    const json = createdTag.toJson();
+    expect(json).toBeTruthy();
+    expect(json.id).toEqual(createdTag.getId());
+  }
+});
+
+tap.test('should update tag', async () => {
+  if (createdTag) {
+    const updatedTag = await createdTag.update({
+      description: 'Updated description for test tag'
+    });
+    expect(updatedTag).toBeInstanceOf(ghost.Tag);
+    expect(updatedTag.getDescription()).toEqual('Updated description for test tag');
+    console.log(`Updated tag: ${updatedTag.getId()}`);
+  }
+});
+
+tap.test('should delete tag', async () => {
+  if (createdTag) {
+    await createdTag.delete();
+    console.log(`Deleted tag: ${createdTag.getId()}`);
+  }
+});
+
+export default tap.start();

test/test.ts.old

@@ -138,4 +138,49 @@ tap.test('should get related posts', async () => {
   }
 });
 
+tap.test('should get members', async () => {
+  try {
+    const members = await testGhostInstance.getMembers({ limit: 10 });
+    expect(members).toBeArray();
+    console.log(`Found ${members.length} members`);
+    if (members.length > 0) {
+      console.log(`First member: ${members[0].getEmail()}`);
+    }
+  } catch (error: any) {
+    if (error.message?.includes('members') || error.statusCode === 403) {
+      console.log('Members feature not available or requires permissions');
+    } else {
+      throw error;
+    }
+  }
+});
+
+tap.test('should get settings', async () => {
+  try {
+    const settings = await testGhostInstance.getSettings();
+    expect(settings).toBeTruthy();
+    console.log(`Retrieved ${settings.settings?.length || 0} settings`);
+  } catch (error: any) {
+    if (error.message?.includes('undefined') || error.statusCode === 403) {
+      console.log('Settings API not available or requires different permissions');
+    } else {
+      throw error;
+    }
+  }
+});
+
+tap.test('should get webhooks', async () => {
+  try {
+    const webhooks = await testGhostInstance.getWebhooks();
+    expect(webhooks).toBeArray();
+    console.log(`Found ${webhooks.length} webhooks`);
+  } catch (error: any) {
+    if (error.message?.includes('not a function') || error.statusCode === 403) {
+      console.log('Webhooks API not available in this Ghost version');
+    } else {
+      throw error;
+    }
+  }
+});
+
 tap.start()

test/test.webhook.node.ts

@@ -0,0 +1,41 @@
+import { expect, tap } from '@push.rocks/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as ghost from '../ts/index.js';
+
+let testGhostInstance: ghost.Ghost;
+let createdWebhook: any;
+
+tap.test('initialize Ghost instance', async () => {
+  testGhostInstance = new ghost.Ghost({
+    baseUrl: 'http://localhost:2368',
+    adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
+    contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
+  });
+  expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
+});
+
+tap.test('should create webhook', async () => {
+  const timestamp = Date.now();
+  createdWebhook = await testGhostInstance.createWebhook({
+    event: 'post.published',
+    target_url: `https://example.com/webhook/${timestamp}`,
+    name: `Test Webhook ${timestamp}`
+  });
+  expect(createdWebhook).toBeTruthy();
+  expect(createdWebhook.id).toBeTruthy();
+});
+
+tap.test('should update webhook', async () => {
+  const updatedWebhook = await testGhostInstance.updateWebhook(createdWebhook.id, {
+    target_url: 'https://example.com/webhook/updated'
+  });
+  expect(updatedWebhook).toBeTruthy();
+});
+
+tap.test('should delete webhook', async () => {
+  await testGhostInstance.deleteWebhook(createdWebhook.id);
+});
+
+export default tap.start();

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@apiclient.xyz/ghost',
-  version: '1.3.0',
+  version: '2.1.0',
   description: 'An unofficial Ghost CMS API package enabling content and admin functionality for managing posts.'
 }

ts/classes.author.ts

@@ -43,7 +43,6 @@ export class Author {
       this.authorData = updatedAuthorData;
       return this;
     } catch (error) {
-      console.error('Error updating author:', error);
       throw error;
     }
   }

ts/classes.ghost.ts

@@ -3,6 +3,7 @@ import { Post, type IPost, type ITag, type IAuthor } from './classes.post.js';
 import { Author } from './classes.author.js';
 import { Tag } from './classes.tag.js';
 import { Page, type IPage } from './classes.page.js';
+import { Member, type IMember } from './classes.member.js';
 
 export interface IGhostConstructorOptions {
   baseUrl: string;
@@ -64,7 +65,6 @@ export class Ghost {
       });
       return postsData.map((postData: IPost) => new Post(this, postData));
     } catch (error) {
-      console.error('Error fetching posts:', error);
       throw error;
     }
   }
@@ -72,9 +72,8 @@ export class Ghost {
   public async getPostById(id: string): Promise<Post> {
     try {
       const postData = await this.contentApi.posts.read({ id });
-      return new Post(postData, this.adminApi);
+      return new Post(this, postData);
     } catch (error) {
-      console.error(`Error fetching post with id ${id}:`, error);
       throw error;
     }
   }
@@ -82,9 +81,8 @@ export class Ghost {
   public async createPost(postData: IPost): Promise<Post> {
     try {
       const createdPostData = await this.adminApi.posts.add(postData);
-      return new Post(createdPostData, this.adminApi);
+      return new Post(this, createdPostData);
     } catch (error) {
-      console.error('Error creating post:', error);
       throw error;
     }
   }
@@ -109,7 +107,6 @@ export class Ghost {
       
       return tagsData;
     } catch (error) {
-      console.error('Error fetching tags:', error);
       throw error;
     }
   }
@@ -119,7 +116,6 @@ export class Ghost {
       const tagData = await this.contentApi.tags.read({ id });
       return new Tag(this, tagData);
     } catch (error) {
-      console.error(`Error fetching tag with id ${id}:`, error);
       throw error;
     }
   }
@@ -129,7 +125,6 @@ export class Ghost {
       const tagData = await this.contentApi.tags.read({ slug });
       return new Tag(this, tagData);
     } catch (error) {
-      console.error(`Error fetching tag with slug ${slug}:`, error);
       throw error;
     }
   }
@@ -139,7 +134,6 @@ export class Ghost {
       const createdTagData = await this.adminApi.tags.add(tagData);
       return new Tag(this, createdTagData);
     } catch (error) {
-      console.error('Error creating tag:', error);
       throw error;
     }
   }
@@ -158,7 +152,6 @@ export class Ghost {
       
       return authorsData.map((author: IAuthor) => new Author(this, author));
     } catch (error) {
-      console.error('Error fetching authors:', error);
       throw error;
     }
   }
@@ -168,7 +161,6 @@ export class Ghost {
       const authorData = await this.contentApi.authors.read({ id });
       return new Author(this, authorData);
     } catch (error) {
-      console.error(`Error fetching author with id ${id}:`, error);
       throw error;
     }
   }
@@ -178,7 +170,6 @@ export class Ghost {
       const authorData = await this.contentApi.authors.read({ slug });
       return new Author(this, authorData);
     } catch (error) {
-      console.error(`Error fetching author with slug ${slug}:`, error);
       throw error;
     }
   }
@@ -197,7 +188,6 @@ export class Ghost {
       
       return pagesData.map((pageData: IPage) => new Page(this, pageData));
     } catch (error) {
-      console.error('Error fetching pages:', error);
       throw error;
     }
   }
@@ -207,7 +197,6 @@ export class Ghost {
       const pageData = await this.contentApi.pages.read({ id });
       return new Page(this, pageData);
     } catch (error) {
-      console.error(`Error fetching page with id ${id}:`, error);
       throw error;
     }
   }
@@ -217,7 +206,6 @@ export class Ghost {
       const pageData = await this.contentApi.pages.read({ slug });
       return new Page(this, pageData);
     } catch (error) {
-      console.error(`Error fetching page with slug ${slug}:`, error);
       throw error;
     }
   }
@@ -227,7 +215,6 @@ export class Ghost {
       const createdPageData = await this.adminApi.pages.add(pageData);
       return new Page(this, createdPageData);
     } catch (error) {
-      console.error('Error creating page:', error);
       throw error;
     }
   }
@@ -242,7 +229,6 @@ export class Ghost {
       });
       return postsData.map((postData: IPost) => new Post(this, postData));
     } catch (error) {
-      console.error('Error searching posts:', error);
       throw error;
     }
   }
@@ -252,7 +238,6 @@ export class Ghost {
       const result = await this.adminApi.images.upload({ file: filePath });
       return result.url;
     } catch (error) {
-      console.error('Error uploading image:', error);
       throw error;
     }
   }
@@ -265,7 +250,6 @@ export class Ghost {
       });
       return await Promise.all(updatePromises);
     } catch (error) {
-      console.error('Error bulk updating posts:', error);
       throw error;
     }
   }
@@ -278,7 +262,6 @@ export class Ghost {
       });
       await Promise.all(deletePromises);
     } catch (error) {
-      console.error('Error bulk deleting posts:', error);
       throw error;
     }
   }
@@ -301,7 +284,82 @@ export class Ghost {
       
       return postsData.map((postData: IPost) => new Post(this, postData));
     } catch (error) {
-      console.error('Error fetching related posts:', error);
+      throw error;
+    }
+  }
+
+  public async getMembers(optionsArg?: { filter?: string; limit?: number }): Promise<Member[]> {
+    try {
+      const limit = optionsArg?.limit || 1000;
+      const membersData = await this.adminApi.members.browse({ limit });
+      
+      if (optionsArg?.filter) {
+        const matcher = new plugins.smartmatch.SmartMatch(optionsArg.filter);
+        return membersData
+          .filter((member: IMember) => matcher.match(member.email))
+          .map((member: IMember) => new Member(this, member));
+      }
+      
+      return membersData.map((member: IMember) => new Member(this, member));
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async getMemberById(id: string): Promise<Member> {
+    try {
+      const memberData = await this.adminApi.members.read({ id });
+      return new Member(this, memberData);
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async getMemberByEmail(email: string): Promise<Member> {
+    try {
+      const memberData = await this.adminApi.members.read({ email });
+      return new Member(this, memberData);
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async createMember(memberData: Partial<IMember>): Promise<Member> {
+    try {
+      const createdMemberData = await this.adminApi.members.add(memberData);
+      return new Member(this, createdMemberData);
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async createWebhook(webhookData: {
+    event: string;
+    target_url: string;
+    name?: string;
+    secret?: string;
+    api_version?: string;
+    integration_id?: string;
+  }): Promise<any> {
+    try {
+      return await this.adminApi.webhooks.add(webhookData);
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async updateWebhook(id: string, webhookData: any): Promise<any> {
+    try {
+      return await this.adminApi.webhooks.edit({ ...webhookData, id });
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async deleteWebhook(id: string): Promise<void> {
+    try {
+      await this.adminApi.webhooks.delete({ id });
+    } catch (error) {
       throw error;
     }
   }

ts/classes.member.ts

@@ -0,0 +1,85 @@
+import type { Ghost } from './classes.ghost.js';
+
+export interface IMember {
+  id: string;
+  uuid: string;
+  email: string;
+  name?: string;
+  note?: string;
+  geolocation?: string;
+  enable_comment_notifications?: boolean;
+  subscribed?: boolean;
+  email_count?: number;
+  email_opened_count?: number;
+  email_open_rate?: number;
+  status?: string;
+  created_at: string;
+  updated_at: string;
+  labels?: Array<{
+    id: string;
+    name: string;
+    slug: string;
+  }>;
+  subscriptions?: any[];
+  avatar_image?: string;
+  comped?: boolean;
+  email_suppression?: {
+    suppressed: boolean;
+    info?: string;
+  };
+}
+
+export class Member {
+  public ghostInstanceRef: Ghost;
+  public memberData: IMember;
+
+  constructor(ghostInstanceRefArg: Ghost, memberData: IMember) {
+    this.ghostInstanceRef = ghostInstanceRefArg;
+    this.memberData = memberData;
+  }
+
+  public getId(): string {
+    return this.memberData.id;
+  }
+
+  public getEmail(): string {
+    return this.memberData.email;
+  }
+
+  public getName(): string | undefined {
+    return this.memberData.name;
+  }
+
+  public getStatus(): string | undefined {
+    return this.memberData.status;
+  }
+
+  public getLabels(): Array<{ id: string; name: string; slug: string }> | undefined {
+    return this.memberData.labels;
+  }
+
+  public toJson(): IMember {
+    return this.memberData;
+  }
+
+  public async update(memberData: Partial<IMember>): Promise<Member> {
+    try {
+      const updatedMemberData = await this.ghostInstanceRef.adminApi.members.edit({
+        ...memberData,
+        id: this.getId()
+      });
+      this.memberData = updatedMemberData;
+      return this;
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  public async delete(): Promise<void> {
+    try {
+      await this.ghostInstanceRef.adminApi.members.delete({ id: this.getId() });
+    } catch (error) {
+      throw error;
+    }
+  }
+}

ts/classes.page.ts

@@ -49,7 +49,6 @@ export class Page {
       this.pageData = updatedPageData;
       return this;
     } catch (error) {
-      console.error('Error updating page:', error);
       throw error;
     }
   }
@@ -58,7 +57,6 @@ export class Page {
     try {
       await this.ghostInstanceRef.adminApi.pages.delete({ id: this.getId() });
     } catch (error) {
-      console.error(`Error deleting page with id ${this.getId()}:`, error);
       throw error;
     }
   }

ts/classes.post.ts

@@ -124,7 +124,6 @@ export class Post {
       this.postData = updatedPostData;
       return this;
     } catch (error) {
-      console.error('Error updating post:', error);
       throw error;
     }
   }
@@ -133,7 +132,6 @@ export class Post {
     try {
       await this.ghostInstanceRef.adminApi.posts.delete({ id: this.getId() });
     } catch (error) {
-      console.error(`Error deleting post with id ${this.getId()}:`, error);
       throw error;
     }
   }

ts/classes.syncedinstance.ts

@@ -0,0 +1,406 @@
+import * as plugins from './ghost.plugins.js';
+import { Ghost } from './classes.ghost.js';
+import { type IPost } from './classes.post.js';
+import { type IPage } from './classes.page.js';
+import { type ITag } from './classes.post.js';
+
+export interface ISyncOptions {
+  incremental?: boolean;
+  filter?: string;
+  dryRun?: boolean;
+}
+
+export interface ISyncItemResult {
+  sourceId: string;
+  sourceSlug: string;
+  targetId?: string;
+  status: 'created' | 'updated' | 'skipped' | 'failed';
+  error?: string;
+}
+
+export interface ISyncTargetReport {
+  targetUrl: string;
+  results: ISyncItemResult[];
+  successCount: number;
+  failureCount: number;
+}
+
+export interface ISyncReport {
+  contentType: 'posts' | 'pages' | 'tags';
+  totalItems: number;
+  targetReports: ISyncTargetReport[];
+  duration: number;
+  timestamp: Date;
+}
+
+export interface ISyncMapping {
+  sourceId: string;
+  sourceSlug: string;
+  targetMappings: Array<{
+    targetUrl: string;
+    targetId: string;
+    lastSynced: Date;
+  }>;
+}
+
+export class SyncedInstance {
+  public sourceGhost: Ghost;
+  public targetGhosts: Ghost[];
+  private syncMappings: Map<string, ISyncMapping>;
+  private syncHistory: ISyncReport[];
+
+  constructor(sourceGhost: Ghost, targetGhosts: Ghost[]) {
+    this.sourceGhost = sourceGhost;
+    this.targetGhosts = targetGhosts;
+    this.syncMappings = new Map();
+    this.syncHistory = [];
+  }
+
+  private addMapping(contentType: string, sourceId: string, sourceSlug: string, targetUrl: string, targetId: string) {
+    const key = `${contentType}:${sourceId}`;
+    const existing = this.syncMappings.get(key);
+    
+    if (existing) {
+      const targetMapping = existing.targetMappings.find(tm => tm.targetUrl === targetUrl);
+      if (targetMapping) {
+        targetMapping.targetId = targetId;
+        targetMapping.lastSynced = new Date();
+      } else {
+        existing.targetMappings.push({
+          targetUrl,
+          targetId,
+          lastSynced: new Date()
+        });
+      }
+    } else {
+      this.syncMappings.set(key, {
+        sourceId,
+        sourceSlug,
+        targetMappings: [{
+          targetUrl,
+          targetId,
+          lastSynced: new Date()
+        }]
+      });
+    }
+  }
+
+  private getMapping(contentType: string, sourceId: string, targetUrl: string): string | undefined {
+    const key = `${contentType}:${sourceId}`;
+    const mapping = this.syncMappings.get(key);
+    if (!mapping) return undefined;
+    
+    const targetMapping = mapping.targetMappings.find(tm => tm.targetUrl === targetUrl);
+    return targetMapping?.targetId;
+  }
+
+  public async syncTags(optionsArg?: ISyncOptions): Promise<ISyncReport> {
+    const startTime = Date.now();
+    const report: ISyncReport = {
+      contentType: 'tags',
+      totalItems: 0,
+      targetReports: [],
+      duration: 0,
+      timestamp: new Date()
+    };
+
+    const sourceTags = await this.sourceGhost.getTags(optionsArg?.filter ? { filter: optionsArg.filter } : {});
+    report.totalItems = sourceTags.length;
+
+    for (const targetGhost of this.targetGhosts) {
+      const targetReport: ISyncTargetReport = {
+        targetUrl: targetGhost.options.baseUrl,
+        results: [],
+        successCount: 0,
+        failureCount: 0
+      };
+
+      for (const sourceTag of sourceTags) {
+        try {
+          let targetTag: any;
+          let status: 'created' | 'updated' | 'skipped' = 'created';
+
+          try {
+            targetTag = await targetGhost.getTagBySlug(sourceTag.slug);
+            if (!optionsArg?.dryRun) {
+              await targetTag.update({
+                name: sourceTag.name,
+                description: sourceTag.description,
+                feature_image: sourceTag.feature_image,
+                visibility: sourceTag.visibility,
+                meta_title: sourceTag.meta_title,
+                meta_description: sourceTag.meta_description
+              });
+            }
+            status = 'updated';
+          } catch (error) {
+            if (!optionsArg?.dryRun) {
+              targetTag = await targetGhost.createTag({
+                name: sourceTag.name,
+                slug: sourceTag.slug,
+                description: sourceTag.description,
+                feature_image: sourceTag.feature_image,
+                visibility: sourceTag.visibility,
+                meta_title: sourceTag.meta_title,
+                meta_description: sourceTag.meta_description
+              });
+            }
+          }
+
+          if (!optionsArg?.dryRun && targetTag) {
+            this.addMapping('tags', sourceTag.id, sourceTag.slug, targetGhost.options.baseUrl, targetTag.tagData.id);
+          }
+
+          targetReport.results.push({
+            sourceId: sourceTag.id,
+            sourceSlug: sourceTag.slug,
+            targetId: targetTag?.tagData?.id,
+            status
+          });
+          targetReport.successCount++;
+        } catch (error) {
+          targetReport.results.push({
+            sourceId: sourceTag.id,
+            sourceSlug: sourceTag.slug,
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error)
+          });
+          targetReport.failureCount++;
+        }
+      }
+
+      report.targetReports.push(targetReport);
+    }
+
+    report.duration = Date.now() - startTime;
+    this.syncHistory.push(report);
+    return report;
+  }
+
+  public async syncPosts(optionsArg?: ISyncOptions): Promise<ISyncReport> {
+    const startTime = Date.now();
+    const report: ISyncReport = {
+      contentType: 'posts',
+      totalItems: 0,
+      targetReports: [],
+      duration: 0,
+      timestamp: new Date()
+    };
+
+    const sourcePosts = await this.sourceGhost.getPosts(optionsArg?.filter ? { filter: optionsArg.filter } : {});
+    report.totalItems = sourcePosts.length;
+
+    for (const targetGhost of this.targetGhosts) {
+      const targetReport: ISyncTargetReport = {
+        targetUrl: targetGhost.options.baseUrl,
+        results: [],
+        successCount: 0,
+        failureCount: 0
+      };
+
+      for (const sourcePost of sourcePosts) {
+        try {
+          const postData = sourcePost.postData;
+          
+          const tagSlugs = postData.tags?.map(t => t.slug) || [];
+          const targetTagIds: string[] = [];
+          
+          for (const tagSlug of tagSlugs) {
+            try {
+              const targetTag = await targetGhost.getTagBySlug(tagSlug);
+              targetTagIds.push(targetTag.tagData.id);
+            } catch (error) {
+            }
+          }
+
+          const syncData: any = {
+            title: postData.title,
+            slug: postData.slug,
+            html: postData.html,
+            feature_image: postData.feature_image,
+            featured: postData.featured,
+            status: postData.status,
+            visibility: postData.visibility,
+            meta_title: postData.meta_title,
+            meta_description: postData.meta_description,
+            published_at: postData.published_at,
+            custom_excerpt: postData.custom_excerpt,
+            tags: targetTagIds.length > 0 ? targetTagIds.map(id => ({ id })) : undefined
+          };
+
+          let targetPost: any;
+          let status: 'created' | 'updated' = 'created';
+
+          try {
+            targetPost = await targetGhost.contentApi.posts.read({ slug: postData.slug }, { formats: ['html'] });
+            if (!optionsArg?.dryRun) {
+              const updated = await targetGhost.adminApi.posts.edit({
+                ...syncData,
+                id: targetPost.id,
+                updated_at: targetPost.updated_at
+              });
+              targetPost = updated;
+            }
+            status = 'updated';
+          } catch (error) {
+            if (!optionsArg?.dryRun) {
+              targetPost = await targetGhost.adminApi.posts.add(syncData);
+            }
+          }
+
+          if (!optionsArg?.dryRun && targetPost) {
+            this.addMapping('posts', postData.id, postData.slug, targetGhost.options.baseUrl, targetPost.id);
+          }
+
+          targetReport.results.push({
+            sourceId: postData.id,
+            sourceSlug: postData.slug,
+            targetId: targetPost?.id,
+            status
+          });
+          targetReport.successCount++;
+        } catch (error) {
+          targetReport.results.push({
+            sourceId: sourcePost.postData.id,
+            sourceSlug: sourcePost.postData.slug,
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error)
+          });
+          targetReport.failureCount++;
+        }
+      }
+
+      report.targetReports.push(targetReport);
+    }
+
+    report.duration = Date.now() - startTime;
+    this.syncHistory.push(report);
+    return report;
+  }
+
+  public async syncPages(optionsArg?: ISyncOptions): Promise<ISyncReport> {
+    const startTime = Date.now();
+    const report: ISyncReport = {
+      contentType: 'pages',
+      totalItems: 0,
+      targetReports: [],
+      duration: 0,
+      timestamp: new Date()
+    };
+
+    const sourcePages = await this.sourceGhost.getPages(optionsArg?.filter ? { filter: optionsArg.filter } : {});
+    report.totalItems = sourcePages.length;
+
+    for (const targetGhost of this.targetGhosts) {
+      const targetReport: ISyncTargetReport = {
+        targetUrl: targetGhost.options.baseUrl,
+        results: [],
+        successCount: 0,
+        failureCount: 0
+      };
+
+      for (const sourcePage of sourcePages) {
+        try {
+          const pageData = sourcePage.pageData;
+
+          const syncData: Partial<IPage> = {
+            title: pageData.title,
+            slug: pageData.slug,
+            html: pageData.html,
+            feature_image: pageData.feature_image,
+            featured: pageData.featured,
+            status: pageData.status,
+            visibility: pageData.visibility,
+            meta_title: pageData.meta_title,
+            meta_description: pageData.meta_description,
+            published_at: pageData.published_at,
+            custom_excerpt: pageData.custom_excerpt
+          };
+
+          let targetPage: any;
+          let status: 'created' | 'updated' = 'created';
+
+          try {
+            targetPage = await targetGhost.contentApi.pages.read({ slug: pageData.slug }, { formats: ['html'] });
+            if (!optionsArg?.dryRun) {
+              const updated = await targetGhost.adminApi.pages.edit({
+                ...syncData,
+                id: targetPage.id,
+                updated_at: targetPage.updated_at
+              });
+              targetPage = updated;
+            }
+            status = 'updated';
+          } catch (error) {
+            if (!optionsArg?.dryRun) {
+              targetPage = await targetGhost.adminApi.pages.add(syncData);
+            }
+          }
+
+          if (!optionsArg?.dryRun && targetPage) {
+            this.addMapping('pages', pageData.id, pageData.slug, targetGhost.options.baseUrl, targetPage.id);
+          }
+
+          targetReport.results.push({
+            sourceId: pageData.id,
+            sourceSlug: pageData.slug,
+            targetId: targetPage?.id,
+            status
+          });
+          targetReport.successCount++;
+        } catch (error) {
+          targetReport.results.push({
+            sourceId: sourcePage.pageData.id,
+            sourceSlug: sourcePage.pageData.slug,
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error)
+          });
+          targetReport.failureCount++;
+        }
+      }
+
+      report.targetReports.push(targetReport);
+    }
+
+    report.duration = Date.now() - startTime;
+    this.syncHistory.push(report);
+    return report;
+  }
+
+  public async syncAll(optionsArg?: { types?: Array<'posts' | 'pages' | 'tags'>; syncOptions?: ISyncOptions }): Promise<ISyncReport[]> {
+    const types = optionsArg?.types || ['tags', 'posts', 'pages'];
+    const reports: ISyncReport[] = [];
+
+    for (const type of types) {
+      if (type === 'tags') {
+        reports.push(await this.syncTags(optionsArg?.syncOptions));
+      } else if (type === 'posts') {
+        reports.push(await this.syncPosts(optionsArg?.syncOptions));
+      } else if (type === 'pages') {
+        reports.push(await this.syncPages(optionsArg?.syncOptions));
+      }
+    }
+
+    return reports;
+  }
+
+  public getSyncStatus(): {
+    totalMappings: number;
+    mappings: ISyncMapping[];
+    recentSyncs: ISyncReport[];
+  } {
+    return {
+      totalMappings: this.syncMappings.size,
+      mappings: Array.from(this.syncMappings.values()),
+      recentSyncs: this.syncHistory.slice(-10)
+    };
+  }
+
+  public clearSyncHistory(): void {
+    this.syncHistory = [];
+  }
+
+  public clearMappings(): void {
+    this.syncMappings.clear();
+  }
+}

ts/classes.tag.ts

@@ -39,7 +39,6 @@ export class Tag {
       this.tagData = updatedTagData;
       return this;
     } catch (error) {
-      console.error('Error updating tag:', error);
       throw error;
     }
   }
@@ -48,7 +47,6 @@ export class Tag {
     try {
       await this.ghostInstanceRef.adminApi.tags.delete({ id: this.getId() });
     } catch (error) {
-      console.error(`Error deleting tag with id ${this.getId()}:`, error);
       throw error;
     }
   }

ts/index.ts

@@ -3,3 +3,5 @@ export * from './classes.post.js';
 export * from './classes.author.js';
 export * from './classes.tag.js';
 export * from './classes.page.js';
+export * from './classes.member.js';
+export * from './classes.syncedinstance.js';