Compare commits
16 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 719bfafb93 | |||
| d493d9fd01 | |||
| 63e514c1da | |||
| b3f08fb64c | |||
| 7251e90395 | |||
| 62839e2f54 | |||
| 2d9844eb61 | |||
| 76c2b714b5 | |||
| cf10f51089 | |||
| 2f05d0edc4 | |||
| 1cde47da68 | |||
| a687b639d2 | |||
| a0ffc7c4d7 | |||
| d82c58e608 | |||
| 5d3cfe2f93 | |||
| 8de7fc795e |
70
changelog.md
70
changelog.md
@@ -1,5 +1,75 @@
|
|||||||
# Changelog
|
# 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
|
||||||
|
|
||||||
|
- Implemented core TypeScript classes: Ghost, Post, Tag, Author and Page with CRUD methods and helpers
|
||||||
|
- Added TypeScript interfaces for posts, tags, authors and pages to provide typings
|
||||||
|
- Included comprehensive README with installation, usage examples and API method documentation
|
||||||
|
- Added unit test scaffold under test/test.ts
|
||||||
|
- Updated package metadata and commitinfo (version 1.2.0)
|
||||||
|
|
||||||
|
## 2025-10-07 - 1.2.0 - feat(ghost)
|
||||||
|
Implement Tag, Author and Page models; add advanced filtering, search, bulk operations, image upload, related-posts, update tests and bump dependencies
|
||||||
|
|
||||||
|
- Add fully implemented Author, Tag and Page classes with CRUD methods
|
||||||
|
- Enhance Ghost class with: improved getPosts filtering (tag/author/featured/custom filters), getTags/getAuthors/getPages with minimatch filtering, getTag/getAuthor/getPage by id/slug, createTag/createPage, searchPosts, uploadImage, bulkUpdatePosts, bulkDeletePosts and getRelatedPosts
|
||||||
|
- Refactor Post types (IPost) and update Post class to use the new type and consistent constructors/serialization
|
||||||
|
- Export new modules (author, tag, page) from index.ts
|
||||||
|
- Integrate @push.rocks/smartmatch for pattern filtering and expose it via ghost.plugins
|
||||||
|
- Update tests to exercise tags, authors, pages, filtering, search and related posts; change test baseUrl to localhost and adjust imports
|
||||||
|
- Bump devDependencies and dependencies versions, adjust test script, add packageManager metadata and add pnpm-workspace.yaml
|
||||||
|
|
||||||
|
## 2024-07-06 - 1.1.0 - feat(core)
|
||||||
|
Enhanced post fetching and creation with additional metadata and support for HTML source
|
||||||
|
|
||||||
|
- Added support for fetching posts with included tags and authors.
|
||||||
|
- Implemented helper method to create posts directly from HTML content.
|
||||||
|
- Enhanced Post class to include additional metadata such as visibility, created_at, updated_at, published_at, etc.
|
||||||
|
- Modified getPosts method in Ghost class to include tags and authors in the response.
|
||||||
|
|
||||||
|
## 2024-07-01 - 1.0.3 - fix(docs)
|
||||||
|
Updated the project keywords and readme content for better clarity and SEO
|
||||||
|
|
||||||
|
- Improved the project description in `package.json` and `npmextra.json`.
|
||||||
|
- Added comprehensive usage instructions and examples in `readme.md`.
|
||||||
|
|
||||||
## 2024-07-01 - 1.0.2 - fix(core)
|
## 2024-07-01 - 1.0.2 - fix(core)
|
||||||
No changes in the project files
|
No changes in the project files
|
||||||
|
|
||||||
|
|||||||
@@ -5,10 +5,20 @@
|
|||||||
"githost": "code.foss.global",
|
"githost": "code.foss.global",
|
||||||
"gitscope": "apiclient.xyz",
|
"gitscope": "apiclient.xyz",
|
||||||
"gitrepo": "ghost",
|
"gitrepo": "ghost",
|
||||||
"description": "an unofficial ghost api package",
|
"description": "An unofficial Ghost CMS API package enabling content and admin functionality for managing posts.",
|
||||||
"npmPackagename": "@apiclient.xyz/ghost",
|
"npmPackagename": "@apiclient.xyz/ghost",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"projectDomain": "apiclient.xyz"
|
"projectDomain": "apiclient.xyz",
|
||||||
|
"keywords": [
|
||||||
|
"Ghost CMS",
|
||||||
|
"API client",
|
||||||
|
"content management",
|
||||||
|
"admin API",
|
||||||
|
"content API",
|
||||||
|
"TypeScript",
|
||||||
|
"post management",
|
||||||
|
"blog management"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"npmci": {
|
"npmci": {
|
||||||
|
|||||||
38
package.json
38
package.json
@@ -1,30 +1,31 @@
|
|||||||
{
|
{
|
||||||
"name": "@apiclient.xyz/ghost",
|
"name": "@apiclient.xyz/ghost",
|
||||||
"version": "1.0.2",
|
"version": "2.1.0",
|
||||||
"private": false,
|
"private": false,
|
||||||
"description": "an unofficial ghost api package",
|
"description": "An unofficial Ghost CMS API package enabling content and admin functionality for managing posts.",
|
||||||
"main": "dist_ts/index.js",
|
"main": "dist_ts/index.js",
|
||||||
"typings": "dist_ts/index.d.ts",
|
"typings": "dist_ts/index.d.ts",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"author": "Task Venture Capital GmbH",
|
"author": "Task Venture Capital GmbH",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"test": "(tstest test/ --web)",
|
"test": "(tstest test/ --verbose)",
|
||||||
"build": "(tsbuild --web --allowimplicitany)",
|
"build": "(tsbuild --web --allowimplicitany)",
|
||||||
"buildDocs": "(tsdoc)"
|
"buildDocs": "(tsdoc)"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@git.zone/tsbuild": "^2.1.82",
|
"@git.zone/tsbuild": "^2.6.8",
|
||||||
"@git.zone/tsbundle": "^2.0.5",
|
"@git.zone/tsbundle": "^2.5.1",
|
||||||
"@git.zone/tsrun": "^1.2.49",
|
"@git.zone/tsrun": "^1.3.3",
|
||||||
"@git.zone/tstest": "^1.0.44",
|
"@git.zone/tstest": "^2.3.8",
|
||||||
"@push.rocks/qenv": "^6.0.5",
|
"@push.rocks/qenv": "^6.1.3",
|
||||||
"@push.rocks/tapbundle": "^5.0.15",
|
"@push.rocks/tapbundle": "^6.0.3",
|
||||||
"@types/node": "^20.14.9"
|
"@types/node": "^22.12.0"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@tryghost/admin-api": "^1.13.12",
|
"@push.rocks/smartmatch": "^2.0.0",
|
||||||
"@tryghost/content-api": "^1.11.21"
|
"@tryghost/admin-api": "^1.14.0",
|
||||||
|
"@tryghost/content-api": "^1.12.0"
|
||||||
},
|
},
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
@@ -48,5 +49,16 @@
|
|||||||
"cli.js",
|
"cli.js",
|
||||||
"npmextra.json",
|
"npmextra.json",
|
||||||
"readme.md"
|
"readme.md"
|
||||||
]
|
],
|
||||||
|
"keywords": [
|
||||||
|
"Ghost CMS",
|
||||||
|
"API client",
|
||||||
|
"content management",
|
||||||
|
"admin API",
|
||||||
|
"content API",
|
||||||
|
"TypeScript",
|
||||||
|
"post management",
|
||||||
|
"blog management"
|
||||||
|
],
|
||||||
|
"packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34"
|
||||||
}
|
}
|
||||||
|
|||||||
8631
pnpm-lock.yaml
generated
8631
pnpm-lock.yaml
generated
File diff suppressed because it is too large
Load Diff
4
pnpm-workspace.yaml
Normal file
4
pnpm-workspace.yaml
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
onlyBuiltDependencies:
|
||||||
|
- esbuild
|
||||||
|
- mongodb-memory-server
|
||||||
|
- puppeteer
|
||||||
683
readme.md
683
readme.md
@@ -1,31 +1,662 @@
|
|||||||
# @apiclient.xyz/ghost
|
# @apiclient.xyz/ghost 👻
|
||||||
an unofficial ghost api package
|
|
||||||
|
|
||||||
## Availabililty and Links
|
> The **unofficial** TypeScript-first Ghost CMS API client that actually makes sense
|
||||||
* [npmjs.org (npm package)](https://www.npmjs.com/package/@apiclient.xyz/ghost)
|
|
||||||
* [gitlab.com (source)](https://code.foss.global/apiclient.xyz/ghost)
|
|
||||||
* [github.com (source mirror)](https://github.com/apiclient.xyz/ghost)
|
|
||||||
* [docs (typedoc)](https://apiclient.xyz.gitlab.io/ghost/)
|
|
||||||
|
|
||||||
## Status for master
|
A modern, fully-typed API client for Ghost CMS that wraps both the Content and Admin APIs into an elegant, developer-friendly interface. Built with TypeScript, designed for humans.
|
||||||
|
|
||||||
Status Category | Status Badge
|
## 🚀 Why This Library?
|
||||||
-- | --
|
|
||||||
GitLab Pipelines | [](https://lossless.cloud)
|
|
||||||
GitLab Pipline Test Coverage | [](https://lossless.cloud)
|
|
||||||
npm | [](https://lossless.cloud)
|
|
||||||
Snyk | [](https://lossless.cloud)
|
|
||||||
TypeScript Support | [](https://lossless.cloud)
|
|
||||||
node Support | [](https://nodejs.org/dist/latest-v10.x/docs/api/)
|
|
||||||
Code Style | [](https://lossless.cloud)
|
|
||||||
PackagePhobia (total standalone install weight) | [](https://lossless.cloud)
|
|
||||||
PackagePhobia (package size on registry) | [](https://lossless.cloud)
|
|
||||||
BundlePhobia (total size when bundled) | [](https://lossless.cloud)
|
|
||||||
|
|
||||||
## Usage
|
- **🎯 TypeScript Native** - Full type safety for all Ghost API operations
|
||||||
Use TypeScript for best in class intellisense
|
- **🔥 Dual API Support** - Unified interface for both Content and Admin APIs
|
||||||
For further information read the linked docs at the top of this readme.
|
- **⚡ Modern Async/Await** - No callback hell, just clean promises
|
||||||
|
- **🎨 Elegant API** - Intuitive methods that match your mental model
|
||||||
|
- **🔍 Smart Filtering** - Built-in minimatch support for flexible queries
|
||||||
|
- **🔄 Multi-Instance Sync** - Synchronize content across multiple Ghost sites
|
||||||
|
- **💪 Production Ready** - Battle-tested with comprehensive error handling
|
||||||
|
|
||||||
## Legal
|
## 📦 Installation
|
||||||
> MIT licensed | **©** [Task Venture Capital GmbH](https://task.vc)
|
|
||||||
| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy)
|
```bash
|
||||||
|
npm install @apiclient.xyz/ghost
|
||||||
|
```
|
||||||
|
|
||||||
|
Or with pnpm:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install @apiclient.xyz/ghost
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎯 Quick Start
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { Ghost } from '@apiclient.xyz/ghost';
|
||||||
|
|
||||||
|
const ghost = new Ghost({
|
||||||
|
baseUrl: 'https://your-ghost-site.com',
|
||||||
|
contentApiKey: 'your_content_api_key',
|
||||||
|
adminApiKey: 'your_admin_api_key'
|
||||||
|
});
|
||||||
|
|
||||||
|
const posts = await ghost.getPosts();
|
||||||
|
posts.forEach(post => console.log(post.getTitle()));
|
||||||
|
```
|
||||||
|
|
||||||
|
That's it. No complicated setup, no boilerplate. Just pure Ghost API goodness.
|
||||||
|
|
||||||
|
## 📚 Core API
|
||||||
|
|
||||||
|
### 🔑 Authentication & Setup
|
||||||
|
|
||||||
|
Initialize the Ghost client with your API credentials:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const ghost = new Ghost({
|
||||||
|
baseUrl: 'https://your-ghost-site.com',
|
||||||
|
contentApiKey: 'your_content_api_key', // For reading public content
|
||||||
|
adminApiKey: 'your_admin_api_key' // For write operations
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📝 Posts
|
||||||
|
|
||||||
|
### Get All Posts
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const posts = await ghost.getPosts();
|
||||||
|
|
||||||
|
posts.forEach(post => {
|
||||||
|
console.log(post.getTitle());
|
||||||
|
console.log(post.getExcerpt());
|
||||||
|
console.log(post.getFeatureImage());
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Filter Posts
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const techPosts = await ghost.getPosts({
|
||||||
|
tag: 'technology',
|
||||||
|
limit: 10
|
||||||
|
});
|
||||||
|
|
||||||
|
const featuredPosts = await ghost.getPosts({
|
||||||
|
featured: true,
|
||||||
|
limit: 5
|
||||||
|
});
|
||||||
|
|
||||||
|
const authorPosts = await ghost.getPosts({
|
||||||
|
author: 'john-doe'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Get Single Post
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const post = await ghost.getPostById('post-id');
|
||||||
|
console.log(post.getTitle());
|
||||||
|
console.log(post.getHtml());
|
||||||
|
console.log(post.getAuthor());
|
||||||
|
```
|
||||||
|
|
||||||
|
### Create Post
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const newPost = await ghost.createPost({
|
||||||
|
title: 'My Awesome Post',
|
||||||
|
html: '<p>This is the content of my post.</p>',
|
||||||
|
feature_image: 'https://example.com/image.jpg',
|
||||||
|
tags: [{ id: 'tag-id' }],
|
||||||
|
excerpt: 'A brief summary of the post'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
Or create from HTML specifically:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const post = await ghost.createPostFromHtml({
|
||||||
|
title: 'My HTML Post',
|
||||||
|
html: '<p>Content here</p>'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Update Post
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const post = await ghost.getPostById('post-id');
|
||||||
|
await post.update({
|
||||||
|
...post.toJson(),
|
||||||
|
title: 'Updated Title',
|
||||||
|
html: '<p>Updated content</p>'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Delete Post
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const post = await ghost.getPostById('post-id');
|
||||||
|
await post.delete();
|
||||||
|
```
|
||||||
|
|
||||||
|
### Search Posts
|
||||||
|
|
||||||
|
Full-text search across post titles:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const results = await ghost.searchPosts('typescript tutorial', { limit: 10 });
|
||||||
|
results.forEach(post => console.log(post.getTitle()));
|
||||||
|
```
|
||||||
|
|
||||||
|
### Related Posts
|
||||||
|
|
||||||
|
Get posts with similar tags:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const post = await ghost.getPostById('post-id');
|
||||||
|
const related = await ghost.getRelatedPosts(post.getId(), 5);
|
||||||
|
related.forEach(p => console.log(`Related: ${p.getTitle()}`));
|
||||||
|
```
|
||||||
|
|
||||||
|
### Bulk Operations
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
await ghost.bulkUpdatePosts(['id1', 'id2', 'id3'], {
|
||||||
|
featured: true
|
||||||
|
});
|
||||||
|
|
||||||
|
await ghost.bulkDeletePosts(['id4', 'id5', 'id6']);
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📄 Pages
|
||||||
|
|
||||||
|
Pages work similarly to posts but are for static content:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const pages = await ghost.getPages();
|
||||||
|
|
||||||
|
const aboutPage = await ghost.getPageBySlug('about');
|
||||||
|
console.log(aboutPage.getHtml());
|
||||||
|
|
||||||
|
const newPage = await ghost.createPage({
|
||||||
|
title: 'Contact',
|
||||||
|
html: '<p>Contact information...</p>'
|
||||||
|
});
|
||||||
|
|
||||||
|
await newPage.update({
|
||||||
|
html: '<p>Updated content</p>'
|
||||||
|
});
|
||||||
|
|
||||||
|
await newPage.delete();
|
||||||
|
```
|
||||||
|
|
||||||
|
Filter pages with minimatch patterns:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const filteredPages = await ghost.getPages({
|
||||||
|
filter: 'about*',
|
||||||
|
limit: 10
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🏷️ Tags
|
||||||
|
|
||||||
|
### Get Tags
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const tags = await ghost.getTags();
|
||||||
|
tags.forEach(tag => console.log(`${tag.name} (${tag.slug})`));
|
||||||
|
```
|
||||||
|
|
||||||
|
### Filter Tags with Minimatch
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const techTags = await ghost.getTags({ filter: 'tech-*' });
|
||||||
|
const blogTags = await ghost.getTags({ filter: '*blog*' });
|
||||||
|
```
|
||||||
|
|
||||||
|
### Get Single Tag
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const tag = await ghost.getTagBySlug('javascript');
|
||||||
|
console.log(tag.getName());
|
||||||
|
console.log(tag.getDescription());
|
||||||
|
```
|
||||||
|
|
||||||
|
### Create, Update, Delete Tags
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const newTag = await ghost.createTag({
|
||||||
|
name: 'TypeScript',
|
||||||
|
slug: 'typescript',
|
||||||
|
description: 'All about TypeScript'
|
||||||
|
});
|
||||||
|
|
||||||
|
await newTag.update({
|
||||||
|
description: 'Everything TypeScript related'
|
||||||
|
});
|
||||||
|
|
||||||
|
await newTag.delete();
|
||||||
|
```
|
||||||
|
|
||||||
|
## 👤 Authors
|
||||||
|
|
||||||
|
### Get Authors
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const authors = await ghost.getAuthors();
|
||||||
|
authors.forEach(author => {
|
||||||
|
console.log(`${author.getName()} (${author.getSlug()})`);
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Filter Authors
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const filteredAuthors = await ghost.getAuthors({
|
||||||
|
filter: 'j*',
|
||||||
|
limit: 10
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Get Single Author
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const author = await ghost.getAuthorBySlug('john-doe');
|
||||||
|
console.log(author.getBio());
|
||||||
|
console.log(author.getProfileImage());
|
||||||
|
```
|
||||||
|
|
||||||
|
### Update Author
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
await author.update({
|
||||||
|
bio: 'Updated bio information',
|
||||||
|
website: 'https://johndoe.com'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## 👥 Members
|
||||||
|
|
||||||
|
Manage your Ghost site members (requires Ghost membership features):
|
||||||
|
|
||||||
|
### Get Members
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const members = await ghost.getMembers({ limit: 100 });
|
||||||
|
members.forEach(member => {
|
||||||
|
console.log(`${member.getName()} - ${member.getEmail()}`);
|
||||||
|
console.log(`Status: ${member.getStatus()}`);
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Filter Members
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const gmailMembers = await ghost.getMembers({
|
||||||
|
filter: '*@gmail.com'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Get Single Member
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const member = await ghost.getMemberByEmail('user@example.com');
|
||||||
|
console.log(member.getStatus());
|
||||||
|
console.log(member.getLabels());
|
||||||
|
```
|
||||||
|
|
||||||
|
### Create Member
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const newMember = await ghost.createMember({
|
||||||
|
email: 'newuser@example.com',
|
||||||
|
name: 'New User',
|
||||||
|
note: 'VIP member'
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Update and Delete Members
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
await member.update({
|
||||||
|
name: 'Updated Name',
|
||||||
|
note: 'Premium member'
|
||||||
|
});
|
||||||
|
|
||||||
|
await member.delete();
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🪝 Webhooks
|
||||||
|
|
||||||
|
Manage webhooks for Ghost events:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const webhook = await ghost.createWebhook({
|
||||||
|
event: 'post.published',
|
||||||
|
target_url: 'https://example.com/webhook',
|
||||||
|
name: 'Post Published Webhook'
|
||||||
|
});
|
||||||
|
|
||||||
|
await ghost.updateWebhook(webhook.id, {
|
||||||
|
target_url: 'https://example.com/new-webhook'
|
||||||
|
});
|
||||||
|
|
||||||
|
await ghost.deleteWebhook(webhook.id);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:** The Ghost Admin API only supports creating, updating, and deleting webhooks. Browsing and reading individual webhooks are not supported by the underlying SDK.
|
||||||
|
|
||||||
|
## 🖼️ Image Upload
|
||||||
|
|
||||||
|
Upload images to your Ghost site:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const imageUrl = await ghost.uploadImage('/path/to/image.jpg');
|
||||||
|
|
||||||
|
await ghost.createPost({
|
||||||
|
title: 'Post with Image',
|
||||||
|
html: '<p>Content here</p>',
|
||||||
|
feature_image: imageUrl
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔄 Multi-Instance Synchronization
|
||||||
|
|
||||||
|
The `SyncedInstance` class enables you to synchronize content across multiple Ghost instances - perfect for staging environments, multi-region deployments, or content distribution.
|
||||||
|
|
||||||
|
### Setup
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { Ghost, SyncedInstance } from '@apiclient.xyz/ghost';
|
||||||
|
|
||||||
|
const sourceGhost = new Ghost({
|
||||||
|
baseUrl: 'https://source.ghost.com',
|
||||||
|
contentApiKey: 'source_content_key',
|
||||||
|
adminApiKey: 'source_admin_key'
|
||||||
|
});
|
||||||
|
|
||||||
|
const targetGhost1 = new Ghost({
|
||||||
|
baseUrl: 'https://target1.ghost.com',
|
||||||
|
contentApiKey: 'target1_content_key',
|
||||||
|
adminApiKey: 'target1_admin_key'
|
||||||
|
});
|
||||||
|
|
||||||
|
const targetGhost2 = new Ghost({
|
||||||
|
baseUrl: 'https://target2.ghost.com',
|
||||||
|
contentApiKey: 'target2_content_key',
|
||||||
|
adminApiKey: 'target2_admin_key'
|
||||||
|
});
|
||||||
|
|
||||||
|
const synced = new SyncedInstance(sourceGhost, [targetGhost1, targetGhost2]);
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sync Content
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const tagReport = await synced.syncTags();
|
||||||
|
console.log(`Synced ${tagReport.totalItems} tags`);
|
||||||
|
console.log(`Duration: ${tagReport.duration}ms`);
|
||||||
|
|
||||||
|
const postReport = await synced.syncPosts();
|
||||||
|
console.log(`Success: ${postReport.targetReports[0].successCount}`);
|
||||||
|
console.log(`Failed: ${postReport.targetReports[0].failureCount}`);
|
||||||
|
|
||||||
|
const pageReport = await synced.syncPages();
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sync Options
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const report = await synced.syncPosts({
|
||||||
|
filter: 'featured-*',
|
||||||
|
dryRun: true,
|
||||||
|
incremental: true
|
||||||
|
});
|
||||||
|
|
||||||
|
report.targetReports.forEach(targetReport => {
|
||||||
|
console.log(`Target: ${targetReport.targetUrl}`);
|
||||||
|
targetReport.results.forEach(result => {
|
||||||
|
console.log(` ${result.sourceSlug}: ${result.status}`);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sync Everything
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const reports = await synced.syncAll({
|
||||||
|
types: ['tags', 'posts', 'pages'],
|
||||||
|
syncOptions: {
|
||||||
|
dryRun: false
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
reports.forEach(report => {
|
||||||
|
console.log(`${report.contentType}: ${report.totalItems} items`);
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sync Status & History
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const status = synced.getSyncStatus();
|
||||||
|
console.log(`Total mappings: ${status.totalMappings}`);
|
||||||
|
console.log(`Recent syncs: ${status.recentSyncs.length}`);
|
||||||
|
|
||||||
|
status.mappings.forEach(mapping => {
|
||||||
|
console.log(`Source: ${mapping.sourceSlug}`);
|
||||||
|
mapping.targetMappings.forEach(tm => {
|
||||||
|
console.log(` -> ${tm.targetUrl} (${tm.targetId})`);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
synced.clearSyncHistory();
|
||||||
|
synced.clearMappings();
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎨 Complete Example
|
||||||
|
|
||||||
|
Here's a comprehensive example showing various operations:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { Ghost } from '@apiclient.xyz/ghost';
|
||||||
|
|
||||||
|
const ghost = new Ghost({
|
||||||
|
baseUrl: 'https://your-ghost-site.com',
|
||||||
|
contentApiKey: 'your_content_key',
|
||||||
|
adminApiKey: 'your_admin_key'
|
||||||
|
});
|
||||||
|
|
||||||
|
async function main() {
|
||||||
|
const imageUrl = await ghost.uploadImage('./banner.jpg');
|
||||||
|
|
||||||
|
const tag = await ghost.createTag({
|
||||||
|
name: 'Tutorial',
|
||||||
|
slug: 'tutorial',
|
||||||
|
description: 'Step-by-step guides'
|
||||||
|
});
|
||||||
|
|
||||||
|
const post = await ghost.createPost({
|
||||||
|
title: 'Getting Started with Ghost',
|
||||||
|
html: '<h1>Welcome</h1><p>This is an introduction...</p>',
|
||||||
|
feature_image: imageUrl,
|
||||||
|
tags: [{ id: tag.getId() }],
|
||||||
|
featured: true
|
||||||
|
});
|
||||||
|
|
||||||
|
console.log(`Created post: ${post.getTitle()}`);
|
||||||
|
|
||||||
|
const related = await ghost.getRelatedPosts(post.getId(), 5);
|
||||||
|
console.log(`Found ${related.length} related posts`);
|
||||||
|
|
||||||
|
const searchResults = await ghost.searchPosts('getting started', { limit: 10 });
|
||||||
|
console.log(`Search found ${searchResults.length} posts`);
|
||||||
|
}
|
||||||
|
|
||||||
|
main().catch(console.error);
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔒 Error Handling
|
||||||
|
|
||||||
|
All methods throw errors that you can catch and handle:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
try {
|
||||||
|
const post = await ghost.getPostById('invalid-id');
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Failed to fetch post:', error);
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
await post.update({ title: 'New Title' });
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Failed to update post:', error);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📖 API Reference
|
||||||
|
|
||||||
|
### Ghost Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `getPosts(options?)` | Get all posts with optional filtering | `Promise<Post[]>` |
|
||||||
|
| `getPostById(id)` | Get a single post by ID | `Promise<Post>` |
|
||||||
|
| `createPost(data)` | Create a new post | `Promise<Post>` |
|
||||||
|
| `createPostFromHtml(data)` | Create post from HTML | `Promise<Post>` |
|
||||||
|
| `searchPosts(query, options?)` | Search posts by title | `Promise<Post[]>` |
|
||||||
|
| `getRelatedPosts(postId, limit)` | Get related posts | `Promise<Post[]>` |
|
||||||
|
| `bulkUpdatePosts(ids, updates)` | Update multiple posts | `Promise<Post[]>` |
|
||||||
|
| `bulkDeletePosts(ids)` | Delete multiple posts | `Promise<void>` |
|
||||||
|
| `getPages(options?)` | Get all pages | `Promise<Page[]>` |
|
||||||
|
| `getPageById(id)` | Get page by ID | `Promise<Page>` |
|
||||||
|
| `getPageBySlug(slug)` | Get page by slug | `Promise<Page>` |
|
||||||
|
| `createPage(data)` | Create a new page | `Promise<Page>` |
|
||||||
|
| `getTags(options?)` | Get all tags | `Promise<ITag[]>` |
|
||||||
|
| `getTagById(id)` | Get tag by ID | `Promise<Tag>` |
|
||||||
|
| `getTagBySlug(slug)` | Get tag by slug | `Promise<Tag>` |
|
||||||
|
| `createTag(data)` | Create a new tag | `Promise<Tag>` |
|
||||||
|
| `getAuthors(options?)` | Get all authors | `Promise<Author[]>` |
|
||||||
|
| `getAuthorById(id)` | Get author by ID | `Promise<Author>` |
|
||||||
|
| `getAuthorBySlug(slug)` | Get author by slug | `Promise<Author>` |
|
||||||
|
| `getMembers(options?)` | Get all members | `Promise<Member[]>` |
|
||||||
|
| `getMemberById(id)` | Get member by ID | `Promise<Member>` |
|
||||||
|
| `getMemberByEmail(email)` | Get member by email | `Promise<Member>` |
|
||||||
|
| `createMember(data)` | Create a new member | `Promise<Member>` |
|
||||||
|
| `createWebhook(data)` | Create a webhook | `Promise<any>` |
|
||||||
|
| `updateWebhook(id, data)` | Update a webhook | `Promise<any>` |
|
||||||
|
| `deleteWebhook(id)` | Delete a webhook | `Promise<void>` |
|
||||||
|
| `uploadImage(filePath)` | Upload an image | `Promise<string>` |
|
||||||
|
|
||||||
|
### Post Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `getId()` | Get post ID | `string` |
|
||||||
|
| `getTitle()` | Get post title | `string` |
|
||||||
|
| `getHtml()` | Get post HTML content | `string` |
|
||||||
|
| `getExcerpt()` | Get post excerpt | `string` |
|
||||||
|
| `getFeatureImage()` | Get feature image URL | `string \| undefined` |
|
||||||
|
| `getAuthor()` | Get primary author | `IAuthor` |
|
||||||
|
| `toJson()` | Get raw post data | `IPost` |
|
||||||
|
| `update(data)` | Update the post | `Promise<Post>` |
|
||||||
|
| `delete()` | Delete the post | `Promise<void>` |
|
||||||
|
|
||||||
|
### Page Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `getId()` | Get page ID | `string` |
|
||||||
|
| `getTitle()` | Get page title | `string` |
|
||||||
|
| `getHtml()` | Get page HTML content | `string` |
|
||||||
|
| `getSlug()` | Get page slug | `string` |
|
||||||
|
| `getFeatureImage()` | Get feature image URL | `string \| undefined` |
|
||||||
|
| `getAuthor()` | Get primary author | `IAuthor` |
|
||||||
|
| `toJson()` | Get raw page data | `IPage` |
|
||||||
|
| `update(data)` | Update the page | `Promise<Page>` |
|
||||||
|
| `delete()` | Delete the page | `Promise<void>` |
|
||||||
|
|
||||||
|
### Tag Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `getId()` | Get tag ID | `string` |
|
||||||
|
| `getName()` | Get tag name | `string` |
|
||||||
|
| `getSlug()` | Get tag slug | `string` |
|
||||||
|
| `getDescription()` | Get tag description | `string \| undefined` |
|
||||||
|
| `toJson()` | Get raw tag data | `ITag` |
|
||||||
|
| `update(data)` | Update the tag | `Promise<Tag>` |
|
||||||
|
| `delete()` | Delete the tag | `Promise<void>` |
|
||||||
|
|
||||||
|
### Author Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `getId()` | Get author ID | `string` |
|
||||||
|
| `getName()` | Get author name | `string` |
|
||||||
|
| `getSlug()` | Get author slug | `string` |
|
||||||
|
| `getProfileImage()` | Get profile image URL | `string \| undefined` |
|
||||||
|
| `getBio()` | Get author bio | `string \| undefined` |
|
||||||
|
| `toJson()` | Get raw author data | `IAuthor` |
|
||||||
|
| `update(data)` | Update the author | `Promise<Author>` |
|
||||||
|
|
||||||
|
### Member Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `getId()` | Get member ID | `string` |
|
||||||
|
| `getEmail()` | Get member email | `string` |
|
||||||
|
| `getName()` | Get member name | `string \| undefined` |
|
||||||
|
| `getStatus()` | Get member status | `string \| undefined` |
|
||||||
|
| `getLabels()` | Get member labels | `Array \| undefined` |
|
||||||
|
| `toJson()` | Get raw member data | `IMember` |
|
||||||
|
| `update(data)` | Update the member | `Promise<Member>` |
|
||||||
|
| `delete()` | Delete the member | `Promise<void>` |
|
||||||
|
|
||||||
|
### SyncedInstance Class
|
||||||
|
|
||||||
|
| Method | Description | Returns |
|
||||||
|
|--------|-------------|---------|
|
||||||
|
| `syncPosts(options?)` | Sync posts to targets | `Promise<ISyncReport>` |
|
||||||
|
| `syncPages(options?)` | Sync pages to targets | `Promise<ISyncReport>` |
|
||||||
|
| `syncTags(options?)` | Sync tags to targets | `Promise<ISyncReport>` |
|
||||||
|
| `syncAll(options?)` | Sync all content types | `Promise<ISyncReport[]>` |
|
||||||
|
| `getSyncStatus()` | Get sync status & mappings | `Object` |
|
||||||
|
| `clearSyncHistory()` | Clear sync history | `void` |
|
||||||
|
| `clearMappings()` | Clear ID mappings | `void` |
|
||||||
|
|
||||||
|
## 🧪 Testing
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm test
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📝 TypeScript Support
|
||||||
|
|
||||||
|
This library is written in TypeScript and provides full type definitions out of the box. No `@types/*` package needed.
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import type { IPost, ITag, IAuthor, IMember } from '@apiclient.xyz/ghost';
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🤝 Contributing
|
||||||
|
|
||||||
|
This is an open-source project. Issues and pull requests are welcome!
|
||||||
|
|
||||||
|
Repository: [https://code.foss.global/apiclient.xyz/ghost](https://code.foss.global/apiclient.xyz/ghost)
|
||||||
|
|
||||||
|
## License and Legal Information
|
||||||
|
|
||||||
|
This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
|
||||||
|
|
||||||
|
### Trademarks
|
||||||
|
|
||||||
|
This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
|
||||||
|
|
||||||
|
### Company Information
|
||||||
|
|
||||||
|
Task Venture Capital GmbH
|
||||||
|
Registered at District court Bremen HRB 35230 HB, Germany
|
||||||
|
|
||||||
|
For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
|
||||||
|
|
||||||
|
By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
|
||||||
|
|||||||
107
test/test.author.node.ts
Normal file
107
test/test.author.node.ts
Normal file
@@ -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();
|
||||||
28
test/test.ghost.node.ts
Normal file
28
test/test.ghost.node.ts
Normal file
@@ -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 };
|
||||||
151
test/test.member.node.ts
Normal file
151
test/test.member.node.ts
Normal file
@@ -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();
|
||||||
106
test/test.page.node.ts
Normal file
106
test/test.page.node.ts
Normal file
@@ -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();
|
||||||
144
test/test.post.node.ts
Normal file
144
test/test.post.node.ts
Normal file
@@ -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();
|
||||||
185
test/test.syncedinstance.node.ts
Normal file
185
test/test.syncedinstance.node.ts
Normal file
@@ -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();
|
||||||
110
test/test.tag.node.ts
Normal file
110
test/test.tag.node.ts
Normal file
@@ -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();
|
||||||
25
test/test.ts
25
test/test.ts
@@ -1,25 +0,0 @@
|
|||||||
import { expect, expectAsync, 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: 'https://coffee.link',
|
|
||||||
adminApiKey: await testQenv.getEnvVarOnDemand('ADMIN_APIKEY'),
|
|
||||||
contentApiKey: await testQenv.getEnvVarOnDemand('CONTENT_APIKEY'),
|
|
||||||
});
|
|
||||||
expect(testGhostInstance).toBeInstanceOf(ghost.Ghost);
|
|
||||||
});
|
|
||||||
|
|
||||||
tap.test('should get posts', async () => {
|
|
||||||
const posts = await testGhostInstance.getPosts();
|
|
||||||
expect(posts).toBeArray();
|
|
||||||
expect(posts[0]).toBeInstanceOf(ghost.Post);
|
|
||||||
console.log(posts.map((post) => post.getTitle()));
|
|
||||||
})
|
|
||||||
|
|
||||||
tap.start()
|
|
||||||
186
test/test.ts.old
Normal file
186
test/test.ts.old
Normal file
@@ -0,0 +1,186 @@
|
|||||||
|
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';
|
||||||
|
|
||||||
|
// make sure we can import the IPost type
|
||||||
|
import {type IPost} 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);
|
||||||
|
});
|
||||||
|
|
||||||
|
tap.test('should get posts', async () => {
|
||||||
|
const posts = await testGhostInstance.getPosts();
|
||||||
|
expect(posts).toBeArray();
|
||||||
|
expect(posts[0]).toBeInstanceOf(ghost.Post);
|
||||||
|
console.log(JSON.stringify(posts[0].postData, null, 2));
|
||||||
|
posts.map((post) => {
|
||||||
|
// console.log(JSON.stringify(post.postData, null, 2));
|
||||||
|
console.log(`-> ${post.getTitle()}`);
|
||||||
|
console.log(`by ${post.getAuthor().name}`)
|
||||||
|
console.log(post.getExcerpt());
|
||||||
|
console.log(`===============`)
|
||||||
|
})
|
||||||
|
|
||||||
|
})
|
||||||
|
|
||||||
|
tap.test('should get all tags', async () => {
|
||||||
|
const tags = await testGhostInstance.getTags();
|
||||||
|
expect(tags).toBeArray();
|
||||||
|
console.log(`Found ${tags.length} tags:`);
|
||||||
|
tags.forEach((tag) => {
|
||||||
|
console.log(`-> ${tag.name} (${tag.slug})`);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
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}':`);
|
||||||
|
filteredTags.forEach((tag) => {
|
||||||
|
console.log(`-> ${tag.name} (${tag.slug})`);
|
||||||
|
expect(tag.slug).toMatch(new RegExp(`^${firstTagSlug.charAt(0)}`));
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
console.log('No tags available to test filtering');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
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);
|
||||||
|
console.log(`Got tag: ${tag.getName()} (${tag.getSlug()})`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
tap.test('should get all authors', async () => {
|
||||||
|
const authors = await testGhostInstance.getAuthors();
|
||||||
|
expect(authors).toBeArray();
|
||||||
|
console.log(`Found ${authors.length} authors:`);
|
||||||
|
authors.forEach((author) => {
|
||||||
|
console.log(`-> ${author.getName()} (${author.getSlug()})`);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
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}':`);
|
||||||
|
filteredAuthors.forEach((author) => {
|
||||||
|
console.log(`-> ${author.getName()} (${author.getSlug()})`);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
tap.test('should get all pages', async () => {
|
||||||
|
const pages = await testGhostInstance.getPages();
|
||||||
|
expect(pages).toBeArray();
|
||||||
|
console.log(`Found ${pages.length} pages:`);
|
||||||
|
pages.forEach((page) => {
|
||||||
|
console.log(`-> ${page.getTitle()} (${page.getSlug()})`);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
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 featured status', async () => {
|
||||||
|
const featuredPosts = await testGhostInstance.getPosts({ featured: true, limit: 5 });
|
||||||
|
expect(featuredPosts).toBeArray();
|
||||||
|
console.log(`Found ${featuredPosts.length} featured posts`);
|
||||||
|
});
|
||||||
|
|
||||||
|
tap.test('should search posts', async () => {
|
||||||
|
const searchResults = await testGhostInstance.searchPosts('the', { limit: 5 });
|
||||||
|
expect(searchResults).toBeArray();
|
||||||
|
console.log(`Found ${searchResults.length} posts matching 'the':`);
|
||||||
|
searchResults.forEach((post) => {
|
||||||
|
console.log(`-> ${post.getTitle()}`);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
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()}'`);
|
||||||
|
relatedPosts.forEach((post) => {
|
||||||
|
console.log(`-> ${post.getTitle()}`);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
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()
|
||||||
41
test/test.webhook.node.ts
Normal file
41
test/test.webhook.node.ts
Normal file
@@ -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();
|
||||||
@@ -3,6 +3,6 @@
|
|||||||
*/
|
*/
|
||||||
export const commitinfo = {
|
export const commitinfo = {
|
||||||
name: '@apiclient.xyz/ghost',
|
name: '@apiclient.xyz/ghost',
|
||||||
version: '1.0.2',
|
version: '2.1.0',
|
||||||
description: 'an unofficial ghost api package'
|
description: 'An unofficial Ghost CMS API package enabling content and admin functionality for managing posts.'
|
||||||
}
|
}
|
||||||
|
|||||||
49
ts/classes.author.ts
Normal file
49
ts/classes.author.ts
Normal file
@@ -0,0 +1,49 @@
|
|||||||
|
import type { Ghost } from './classes.ghost.js';
|
||||||
|
import type { IAuthor } from './classes.post.js';
|
||||||
|
|
||||||
|
export class Author {
|
||||||
|
public ghostInstanceRef: Ghost;
|
||||||
|
public authorData: IAuthor;
|
||||||
|
|
||||||
|
constructor(ghostInstanceRefArg: Ghost, authorData: IAuthor) {
|
||||||
|
this.ghostInstanceRef = ghostInstanceRefArg;
|
||||||
|
this.authorData = authorData;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getId(): string {
|
||||||
|
return this.authorData.id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getName(): string {
|
||||||
|
return this.authorData.name;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getSlug(): string {
|
||||||
|
return this.authorData.slug;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getProfileImage(): string | undefined {
|
||||||
|
return this.authorData.profile_image;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getBio(): string | undefined {
|
||||||
|
return this.authorData.bio;
|
||||||
|
}
|
||||||
|
|
||||||
|
public toJson(): IAuthor {
|
||||||
|
return this.authorData;
|
||||||
|
}
|
||||||
|
|
||||||
|
public async update(authorData: Partial<IAuthor>): Promise<Author> {
|
||||||
|
try {
|
||||||
|
const updatedAuthorData = await this.ghostInstanceRef.adminApi.users.edit({
|
||||||
|
...authorData,
|
||||||
|
id: this.getId()
|
||||||
|
});
|
||||||
|
this.authorData = updatedAuthorData;
|
||||||
|
return this;
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,5 +1,9 @@
|
|||||||
import * as plugins from './ghost.plugins.js';
|
import * as plugins from './ghost.plugins.js';
|
||||||
import { Post, type IPostOptions } from './classes.post.js';
|
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 {
|
export interface IGhostConstructorOptions {
|
||||||
baseUrl: string;
|
baseUrl: string;
|
||||||
@@ -18,22 +22,49 @@ export class Ghost {
|
|||||||
this.adminApi = new plugins.GhostAdminAPI({
|
this.adminApi = new plugins.GhostAdminAPI({
|
||||||
url: this.options.baseUrl,
|
url: this.options.baseUrl,
|
||||||
key: this.options.adminApiKey,
|
key: this.options.adminApiKey,
|
||||||
version: "v3"
|
version: 'v3',
|
||||||
});
|
});
|
||||||
|
|
||||||
this.contentApi = new plugins.GhostContentAPI({
|
this.contentApi = new plugins.GhostContentAPI({
|
||||||
url: this.options.baseUrl,
|
url: this.options.baseUrl,
|
||||||
key: this.options.contentApiKey,
|
key: this.options.contentApiKey,
|
||||||
version: "v3"
|
version: 'v3',
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
public async getPosts(limit: number = 1000): Promise<Post[]> {
|
public async getPosts(optionsArg?: {
|
||||||
|
limit?: number;
|
||||||
|
tag?: string;
|
||||||
|
author?: string;
|
||||||
|
featured?: boolean;
|
||||||
|
filter?: string;
|
||||||
|
}): Promise<Post[]> {
|
||||||
try {
|
try {
|
||||||
const postsData = await this.contentApi.posts.browse({ limit });
|
const limit = optionsArg?.limit || 1000;
|
||||||
return postsData.map((postData: IPostOptions) => new Post(this, postData));
|
const filters: string[] = [];
|
||||||
|
|
||||||
|
if (optionsArg?.tag) {
|
||||||
|
filters.push(`tag:${optionsArg.tag}`);
|
||||||
|
}
|
||||||
|
if (optionsArg?.author) {
|
||||||
|
filters.push(`author:${optionsArg.author}`);
|
||||||
|
}
|
||||||
|
if (optionsArg?.featured !== undefined) {
|
||||||
|
filters.push(`featured:${optionsArg.featured}`);
|
||||||
|
}
|
||||||
|
if (optionsArg?.filter) {
|
||||||
|
filters.push(optionsArg.filter);
|
||||||
|
}
|
||||||
|
|
||||||
|
const filterString = filters.length > 0 ? filters.join('+') : undefined;
|
||||||
|
|
||||||
|
const postsData = await this.contentApi.posts.browse({
|
||||||
|
limit,
|
||||||
|
include: 'tags,authors',
|
||||||
|
...(filterString && { filter: filterString })
|
||||||
|
});
|
||||||
|
return postsData.map((postData: IPost) => new Post(this, postData));
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('Error fetching posts:', error);
|
|
||||||
throw error;
|
throw error;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -41,19 +72,294 @@ export class Ghost {
|
|||||||
public async getPostById(id: string): Promise<Post> {
|
public async getPostById(id: string): Promise<Post> {
|
||||||
try {
|
try {
|
||||||
const postData = await this.contentApi.posts.read({ id });
|
const postData = await this.contentApi.posts.read({ id });
|
||||||
return new Post(postData, this.adminApi);
|
return new Post(this, postData);
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error(`Error fetching post with id ${id}:`, error);
|
|
||||||
throw error;
|
throw error;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public async createPost(postData: IPostOptions): Promise<Post> {
|
public async createPost(postData: IPost): Promise<Post> {
|
||||||
try {
|
try {
|
||||||
const createdPostData = await this.adminApi.posts.add(postData);
|
const createdPostData = await this.adminApi.posts.add(postData);
|
||||||
return new Post(createdPostData, this.adminApi);
|
return new Post(this, createdPostData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async createPostFromHtml(optionsArg: { title: string; html: string }) {
|
||||||
|
const postData = await this.adminApi.posts.add(
|
||||||
|
{ title: optionsArg.title, html: optionsArg.html },
|
||||||
|
{ source: 'html' } // Tell the API to use HTML as the content source, instead of Lexical
|
||||||
|
);
|
||||||
|
return new Post(this, postData);
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getTags(optionsArg?: { filter?: string; limit?: number }): Promise<ITag[]> {
|
||||||
|
try {
|
||||||
|
const limit = optionsArg?.limit || 1000;
|
||||||
|
const tagsData = await this.contentApi.tags.browse({ limit });
|
||||||
|
|
||||||
|
if (optionsArg?.filter) {
|
||||||
|
const matcher = new plugins.smartmatch.SmartMatch(optionsArg.filter);
|
||||||
|
return tagsData.filter((tag: ITag) => matcher.match(tag.slug));
|
||||||
|
}
|
||||||
|
|
||||||
|
return tagsData;
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getTagById(id: string): Promise<Tag> {
|
||||||
|
try {
|
||||||
|
const tagData = await this.contentApi.tags.read({ id });
|
||||||
|
return new Tag(this, tagData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getTagBySlug(slug: string): Promise<Tag> {
|
||||||
|
try {
|
||||||
|
const tagData = await this.contentApi.tags.read({ slug });
|
||||||
|
return new Tag(this, tagData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async createTag(tagData: Partial<ITag>): Promise<Tag> {
|
||||||
|
try {
|
||||||
|
const createdTagData = await this.adminApi.tags.add(tagData);
|
||||||
|
return new Tag(this, createdTagData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getAuthors(optionsArg?: { filter?: string; limit?: number }): Promise<Author[]> {
|
||||||
|
try {
|
||||||
|
const limit = optionsArg?.limit || 1000;
|
||||||
|
const authorsData = await this.contentApi.authors.browse({ limit });
|
||||||
|
|
||||||
|
if (optionsArg?.filter) {
|
||||||
|
const matcher = new plugins.smartmatch.SmartMatch(optionsArg.filter);
|
||||||
|
return authorsData
|
||||||
|
.filter((author: IAuthor) => matcher.match(author.slug))
|
||||||
|
.map((author: IAuthor) => new Author(this, author));
|
||||||
|
}
|
||||||
|
|
||||||
|
return authorsData.map((author: IAuthor) => new Author(this, author));
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getAuthorById(id: string): Promise<Author> {
|
||||||
|
try {
|
||||||
|
const authorData = await this.contentApi.authors.read({ id });
|
||||||
|
return new Author(this, authorData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getAuthorBySlug(slug: string): Promise<Author> {
|
||||||
|
try {
|
||||||
|
const authorData = await this.contentApi.authors.read({ slug });
|
||||||
|
return new Author(this, authorData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getPages(optionsArg?: { limit?: number; filter?: string }): Promise<Page[]> {
|
||||||
|
try {
|
||||||
|
const limit = optionsArg?.limit || 1000;
|
||||||
|
const pagesData = await this.contentApi.pages.browse({ limit, include: 'tags,authors' });
|
||||||
|
|
||||||
|
if (optionsArg?.filter) {
|
||||||
|
const matcher = new plugins.smartmatch.SmartMatch(optionsArg.filter);
|
||||||
|
return pagesData
|
||||||
|
.filter((page: IPage) => matcher.match(page.slug))
|
||||||
|
.map((page: IPage) => new Page(this, page));
|
||||||
|
}
|
||||||
|
|
||||||
|
return pagesData.map((pageData: IPage) => new Page(this, pageData));
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getPageById(id: string): Promise<Page> {
|
||||||
|
try {
|
||||||
|
const pageData = await this.contentApi.pages.read({ id });
|
||||||
|
return new Page(this, pageData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getPageBySlug(slug: string): Promise<Page> {
|
||||||
|
try {
|
||||||
|
const pageData = await this.contentApi.pages.read({ slug });
|
||||||
|
return new Page(this, pageData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async createPage(pageData: Partial<IPage>): Promise<Page> {
|
||||||
|
try {
|
||||||
|
const createdPageData = await this.adminApi.pages.add(pageData);
|
||||||
|
return new Page(this, createdPageData);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async searchPosts(query: string, optionsArg?: { limit?: number }): Promise<Post[]> {
|
||||||
|
try {
|
||||||
|
const limit = optionsArg?.limit || 100;
|
||||||
|
const postsData = await this.contentApi.posts.browse({
|
||||||
|
limit,
|
||||||
|
filter: `title:~'${query}'`,
|
||||||
|
include: 'tags,authors'
|
||||||
|
});
|
||||||
|
return postsData.map((postData: IPost) => new Post(this, postData));
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async uploadImage(filePath: string): Promise<string> {
|
||||||
|
try {
|
||||||
|
const result = await this.adminApi.images.upload({ file: filePath });
|
||||||
|
return result.url;
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async bulkUpdatePosts(postIds: string[], updates: Partial<IPost>): Promise<Post[]> {
|
||||||
|
try {
|
||||||
|
const updatePromises = postIds.map(async (id) => {
|
||||||
|
const post = await this.getPostById(id);
|
||||||
|
return post.update({ ...post.postData, ...updates, id });
|
||||||
|
});
|
||||||
|
return await Promise.all(updatePromises);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async bulkDeletePosts(postIds: string[]): Promise<void> {
|
||||||
|
try {
|
||||||
|
const deletePromises = postIds.map(async (id) => {
|
||||||
|
const post = await this.getPostById(id);
|
||||||
|
return post.delete();
|
||||||
|
});
|
||||||
|
await Promise.all(deletePromises);
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async getRelatedPosts(postId: string, limit: number = 5): Promise<Post[]> {
|
||||||
|
try {
|
||||||
|
const post = await this.getPostById(postId);
|
||||||
|
const tags = post.postData.tags;
|
||||||
|
|
||||||
|
if (!tags || !Array.isArray(tags) || tags.length === 0) {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
|
||||||
|
const tagSlugs = tags.map(tag => tag.slug).join(',');
|
||||||
|
const postsData = await this.contentApi.posts.browse({
|
||||||
|
limit,
|
||||||
|
filter: `tag:[${tagSlugs}]+id:-${postId}`,
|
||||||
|
include: 'tags,authors'
|
||||||
|
});
|
||||||
|
|
||||||
|
return postsData.map((postData: IPost) => new Post(this, postData));
|
||||||
|
} catch (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) {
|
} catch (error) {
|
||||||
console.error('Error creating post:', error);
|
|
||||||
throw error;
|
throw error;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
85
ts/classes.member.ts
Normal file
85
ts/classes.member.ts
Normal file
@@ -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;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
63
ts/classes.page.ts
Normal file
63
ts/classes.page.ts
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
import type { Ghost } from './classes.ghost.js';
|
||||||
|
import type { IPost, IAuthor } from './classes.post.js';
|
||||||
|
|
||||||
|
export interface IPage extends IPost {}
|
||||||
|
|
||||||
|
export class Page {
|
||||||
|
public ghostInstanceRef: Ghost;
|
||||||
|
public pageData: IPage;
|
||||||
|
|
||||||
|
constructor(ghostInstanceRefArg: Ghost, pageData: IPage) {
|
||||||
|
this.ghostInstanceRef = ghostInstanceRefArg;
|
||||||
|
this.pageData = pageData;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getId(): string {
|
||||||
|
return this.pageData.id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getTitle(): string {
|
||||||
|
return this.pageData.title;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getHtml(): string {
|
||||||
|
return this.pageData.html;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getSlug(): string {
|
||||||
|
return this.pageData.slug;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getFeatureImage(): string | undefined {
|
||||||
|
return this.pageData.feature_image;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getAuthor(): IAuthor {
|
||||||
|
return this.pageData.primary_author;
|
||||||
|
}
|
||||||
|
|
||||||
|
public toJson(): IPage {
|
||||||
|
return this.pageData;
|
||||||
|
}
|
||||||
|
|
||||||
|
public async update(pageData: Partial<IPage>): Promise<Page> {
|
||||||
|
try {
|
||||||
|
const updatedPageData = await this.ghostInstanceRef.adminApi.pages.edit({
|
||||||
|
...pageData,
|
||||||
|
id: this.getId()
|
||||||
|
});
|
||||||
|
this.pageData = updatedPageData;
|
||||||
|
return this;
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async delete(): Promise<void> {
|
||||||
|
try {
|
||||||
|
await this.ghostInstanceRef.adminApi.pages.delete({ id: this.getId() });
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,20 +1,91 @@
|
|||||||
import type { Ghost } from './classes.ghost.js';
|
import type { Ghost } from './classes.ghost.js';
|
||||||
import * as plugins from './ghost.plugins.js';
|
import * as plugins from './ghost.plugins.js';
|
||||||
|
|
||||||
export interface IPostOptions {
|
export interface IAuthor {
|
||||||
id: string;
|
id: string;
|
||||||
title: string;
|
name: string;
|
||||||
html: string;
|
slug: string;
|
||||||
excerpt?: string;
|
profile_image?: string;
|
||||||
|
cover_image?: string;
|
||||||
|
bio?: string;
|
||||||
|
website?: string;
|
||||||
|
location?: string;
|
||||||
|
facebook?: string;
|
||||||
|
twitter?: string;
|
||||||
|
meta_title?: string;
|
||||||
|
meta_description?: string;
|
||||||
|
url: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ITag {
|
||||||
|
id: string;
|
||||||
|
name: string;
|
||||||
|
slug: string;
|
||||||
|
description?: string;
|
||||||
feature_image?: string;
|
feature_image?: string;
|
||||||
|
visibility: string;
|
||||||
|
og_image?: string;
|
||||||
|
og_title?: string;
|
||||||
|
og_description?: string;
|
||||||
|
twitter_image?: string;
|
||||||
|
twitter_title?: string;
|
||||||
|
twitter_description?: string;
|
||||||
|
meta_title?: string;
|
||||||
|
meta_description?: string;
|
||||||
|
codeinjection_head?: string;
|
||||||
|
codeinjection_foot?: string;
|
||||||
|
canonical_url?: string;
|
||||||
|
accent_color?: string;
|
||||||
|
url: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IPost {
|
||||||
|
id: string;
|
||||||
|
uuid: string;
|
||||||
|
title: string;
|
||||||
|
slug: string;
|
||||||
|
html: string;
|
||||||
|
comment_id: string;
|
||||||
|
feature_image?: string;
|
||||||
|
featured: boolean;
|
||||||
|
visibility: string;
|
||||||
|
created_at: string;
|
||||||
|
updated_at: string;
|
||||||
|
published_at: string;
|
||||||
|
custom_excerpt?: string;
|
||||||
|
codeinjection_head?: string | null;
|
||||||
|
codeinjection_foot?: string | null;
|
||||||
|
custom_template?: string | null;
|
||||||
|
canonical_url?: string | null;
|
||||||
|
url: string;
|
||||||
|
excerpt?: string;
|
||||||
|
reading_time: number;
|
||||||
|
access: boolean;
|
||||||
|
comments: boolean;
|
||||||
|
og_image?: string | null;
|
||||||
|
og_title?: string | null;
|
||||||
|
og_description?: string | null;
|
||||||
|
twitter_image?: string | null;
|
||||||
|
twitter_title?: string | null;
|
||||||
|
twitter_description?: string | null;
|
||||||
|
meta_title?: string | null;
|
||||||
|
meta_description?: string | null;
|
||||||
|
email_subject?: string | null;
|
||||||
|
frontmatter?: string | null;
|
||||||
|
feature_image_alt?: string | null;
|
||||||
|
feature_image_caption?: string | null;
|
||||||
|
authors: IAuthor[];
|
||||||
|
tags: ITag[];
|
||||||
|
primary_author: IAuthor;
|
||||||
|
primary_tag: ITag;
|
||||||
[key: string]: any; // To allow for additional properties
|
[key: string]: any; // To allow for additional properties
|
||||||
}
|
}
|
||||||
|
|
||||||
export class Post {
|
export class Post {
|
||||||
public ghostInstanceRef: Ghost;
|
public ghostInstanceRef: Ghost;
|
||||||
private postData: IPostOptions;
|
public postData: IPost;
|
||||||
|
|
||||||
constructor(ghostInstanceRefArg: Ghost, postData: IPostOptions) {
|
constructor(ghostInstanceRefArg: Ghost, postData: IPost) {
|
||||||
this.ghostInstanceRef = ghostInstanceRefArg;
|
this.ghostInstanceRef = ghostInstanceRefArg;
|
||||||
this.postData = postData;
|
this.postData = postData;
|
||||||
}
|
}
|
||||||
@@ -39,17 +110,20 @@ export class Post {
|
|||||||
return this.postData.feature_image;
|
return this.postData.feature_image;
|
||||||
}
|
}
|
||||||
|
|
||||||
public toJson(): IPostOptions {
|
public getAuthor(): IAuthor {
|
||||||
|
return this.postData.primary_author;
|
||||||
|
}
|
||||||
|
|
||||||
|
public toJson(): IPost {
|
||||||
return this.postData;
|
return this.postData;
|
||||||
}
|
}
|
||||||
|
|
||||||
public async update(postData: IPostOptions): Promise<Post> {
|
public async update(postData: IPost): Promise<Post> {
|
||||||
try {
|
try {
|
||||||
const updatedPostData = await this.ghostInstanceRef.adminApi.posts.edit(postData);
|
const updatedPostData = await this.ghostInstanceRef.adminApi.posts.edit(postData);
|
||||||
this.postData = updatedPostData;
|
this.postData = updatedPostData;
|
||||||
return this;
|
return this;
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('Error updating post:', error);
|
|
||||||
throw error;
|
throw error;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -58,7 +132,6 @@ export class Post {
|
|||||||
try {
|
try {
|
||||||
await this.ghostInstanceRef.adminApi.posts.delete({ id: this.getId() });
|
await this.ghostInstanceRef.adminApi.posts.delete({ id: this.getId() });
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error(`Error deleting post with id ${this.getId()}:`, error);
|
|
||||||
throw error;
|
throw error;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
406
ts/classes.syncedinstance.ts
Normal file
406
ts/classes.syncedinstance.ts
Normal file
@@ -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();
|
||||||
|
}
|
||||||
|
}
|
||||||
53
ts/classes.tag.ts
Normal file
53
ts/classes.tag.ts
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
import type { Ghost } from './classes.ghost.js';
|
||||||
|
import type { ITag } from './classes.post.js';
|
||||||
|
|
||||||
|
export class Tag {
|
||||||
|
public ghostInstanceRef: Ghost;
|
||||||
|
public tagData: ITag;
|
||||||
|
|
||||||
|
constructor(ghostInstanceRefArg: Ghost, tagData: ITag) {
|
||||||
|
this.ghostInstanceRef = ghostInstanceRefArg;
|
||||||
|
this.tagData = tagData;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getId(): string {
|
||||||
|
return this.tagData.id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getName(): string {
|
||||||
|
return this.tagData.name;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getSlug(): string {
|
||||||
|
return this.tagData.slug;
|
||||||
|
}
|
||||||
|
|
||||||
|
public getDescription(): string | undefined {
|
||||||
|
return this.tagData.description;
|
||||||
|
}
|
||||||
|
|
||||||
|
public toJson(): ITag {
|
||||||
|
return this.tagData;
|
||||||
|
}
|
||||||
|
|
||||||
|
public async update(tagData: Partial<ITag>): Promise<Tag> {
|
||||||
|
try {
|
||||||
|
const updatedTagData = await this.ghostInstanceRef.adminApi.tags.edit({
|
||||||
|
...tagData,
|
||||||
|
id: this.getId()
|
||||||
|
});
|
||||||
|
this.tagData = updatedTagData;
|
||||||
|
return this;
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public async delete(): Promise<void> {
|
||||||
|
try {
|
||||||
|
await this.ghostInstanceRef.adminApi.tags.delete({ id: this.getId() });
|
||||||
|
} catch (error) {
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,7 +1,9 @@
|
|||||||
import GhostContentAPI from '@tryghost/content-api';
|
import GhostContentAPI from '@tryghost/content-api';
|
||||||
import GhostAdminAPI from '@tryghost/admin-api';
|
import GhostAdminAPI from '@tryghost/admin-api';
|
||||||
|
import * as smartmatch from '@push.rocks/smartmatch';
|
||||||
|
|
||||||
export {
|
export {
|
||||||
GhostContentAPI,
|
GhostContentAPI,
|
||||||
GhostAdminAPI
|
GhostAdminAPI,
|
||||||
|
smartmatch
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,2 +1,7 @@
|
|||||||
export * from './classes.ghost.js';
|
export * from './classes.ghost.js';
|
||||||
export * from './classes.post.js';
|
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';
|
||||||
Reference in New Issue
Block a user