autoblogger 0.2.8 → 0.2.9

package/README.md

@@ -29,10 +29,13 @@ Visit `/writer` to start writing.
 
 - **AI Writing** — Generate essays with Claude or GPT. Stream responses in real-time.
 - **Chat Modes** — Ask questions, let AI edit directly (Agent mode), or generate outlines (Plan mode).
+- **Web Search** — Ground AI responses with real-time web search (works with all models).
+- **Thinking Mode** — Extended thinking for more thoughtful Claude responses.
 - **WYSIWYG Editor** — Tiptap-based editor with formatting toolbar. Syncs to markdown.
 - **Revision History** — Every save creates a revision. Browse and restore any version.
 - **Inline Comments** — Highlight text and leave threaded comments.
 - **RSS Auto-Draft** — Subscribe to feeds, filter by keywords, auto-generate drafts.
+- **CMS Integrations** — Sync posts to Prismic, Contentful, Sanity, or custom destinations.
 - **User Roles** — Admin, writer, and drafter with different permissions.
 - **SEO Fields** — Custom title, description, keywords, and OG image per post.
 
@@ -132,16 +135,16 @@ npx autoblogger import ./posts    # Import markdown files
 | ⌘K | Toggle chat panel |
 | ⌘⇧A | Toggle Ask/Agent mode |
 | ⌘. | Toggle theme |
-| ⌘/ | Toggle view |
-| N | New article |
-| Esc | Go back |
+| ⌘S | Save draft |
+| Esc | Go back / Stop generation |
 
 ## Package Exports
 
 ```typescript
 // Server
-import { createAutoblogger } from 'autoblogger'
-import { runAutoDraft } from 'autoblogger'
+import { createAutoblogger, runAutoDraft } from 'autoblogger'
+import { createDestinationDispatcher } from 'autoblogger'
+import type { Destination, DestinationResult } from 'autoblogger'
 
 // UI
 import { AutobloggerDashboard } from 'autoblogger/ui'
@@ -151,6 +154,75 @@ import { ChatProvider, ChatPanel, ChatButton } from 'autoblogger/ui'
 import { renderMarkdown, htmlToMarkdown } from 'autoblogger/markdown'
 import { getSeoValues } from 'autoblogger/seo'
 import { ARTICLE_CLASSES } from 'autoblogger/styles/article'
+
+// Rich text converters (for custom destination adapters)
+import { 
+  markdownToPrismicRichText,
+  markdownToContentfulRichText,
+  markdownToPortableText,
+} from 'autoblogger/rich-text'
+```
+
+## CMS Integrations
+
+Autoblogger can sync published posts to external CMSs like Prismic, Contentful, or Sanity.
+
+### Prismic (Built-in)
+
+Configure Prismic integration via the Settings UI or in code:
+
+```typescript
+export const cms = createAutoblogger({
+  // ... other config
+  prismic: {
+    repository: 'your-repo',
+    writeToken: process.env.PRISMIC_WRITE_TOKEN,
+  },
+})
+```
+
+Then enable it in Settings → CMS Integrations → Prismic.
+
+**Sync Modes:**
+- **Stub** (default): Only syncs the post slug as UID. Content lives in autoblogger, Prismic stores references for collection slices.
+- **Full**: Syncs complete content as Prismic rich text.
+
+### Custom Destinations
+
+Create custom adapters for any CMS:
+
+```typescript
+import { createAutoblogger, type Destination } from 'autoblogger'
+
+const myDestination: Destination = {
+  name: 'my-cms',
+  async onPublish(post) {
+    // Sync post to your CMS
+    return { success: true, externalId: 'doc-123' }
+  },
+  async onUnpublish(post) {
+    return { success: true }
+  },
+  async onDelete(post) {
+    return { success: true }
+  },
+}
+
+export const cms = createAutoblogger({
+  // ... other config
+  destinations: [myDestination],
+})
+```
+
+### Webhooks
+
+Send POST requests to URLs when posts are published/unpublished/deleted:
+
+```typescript
+export const cms = createAutoblogger({
+  // ... other config
+  webhooks: ['https://api.example.com/cms-webhook'],
+})
 ```
 
 ## Styling

package/dist/index.d.mts

@@ -47,9 +47,126 @@ interface AutoDraftConfig {
  */
 declare function runAutoDraft(config: AutoDraftConfig, topicId?: string, skipFrequencyCheck?: boolean): Promise<GenerationResult[]>;
 
+/**
+ * Result returned by a destination after handling an event
+ */
+interface DestinationResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** External ID assigned by the destination (e.g., Prismic document ID) */
+    externalId?: string;
+    /** Error message if the operation failed */
+    error?: string;
+}
+/**
+ * A destination adapter that syncs posts to an external CMS or service.
+ *
+ * Implement this interface to create custom adapters for Prismic, Contentful,
+ * Sanity, or any other service.
+ */
+interface Destination {
+    /** Unique name for this destination (for logging/debugging) */
+    name: string;
+    /**
+     * Called when a post is published.
+     * Should create or update the post in the external service.
+     */
+    onPublish(post: Post): Promise<DestinationResult>;
+    /**
+     * Called when a post is unpublished (status changed from 'published' to 'draft').
+     * Should archive or unpublish the post in the external service.
+     */
+    onUnpublish(post: Post): Promise<DestinationResult>;
+    /**
+     * Called when a post is deleted.
+     * Should remove the post from the external service.
+     */
+    onDelete(post: Post): Promise<DestinationResult>;
+}
+/**
+ * Event payload sent to webhooks
+ */
+interface DestinationEvent {
+    /** The type of event that occurred */
+    type: 'publish' | 'unpublish' | 'delete';
+    /** The post that triggered the event */
+    post: Post;
+    /** When the event occurred */
+    timestamp: string;
+}
+/**
+ * Configuration for the destination system
+ */
+interface DestinationsConfig {
+    /** Array of destination adapters to sync posts to */
+    destinations?: Destination[];
+    /** Webhook URLs to POST event payloads to */
+    webhooks?: string[];
+    /** Callback fired when a post is published */
+    onPublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is unpublished */
+    onUnpublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is deleted */
+    onDelete?: (post: Post) => Promise<void>;
+}
+/**
+ * Aggregated results from all destinations
+ */
+interface DispatchResult {
+    /** Results from each destination adapter */
+    destinations: Array<{
+        name: string;
+        result: DestinationResult;
+    }>;
+    /** Results from webhook calls */
+    webhooks: Array<{
+        url: string;
+        success: boolean;
+        error?: string;
+    }>;
+    /** Whether all operations succeeded */
+    allSucceeded: boolean;
+}
+
+interface DispatcherConfig {
+    destinations?: Destination[];
+    webhooks?: string[];
+    onPublish?: (post: Post) => Promise<void>;
+    onUnpublish?: (post: Post) => Promise<void>;
+    onDelete?: (post: Post) => Promise<void>;
+}
+/**
+ * Creates a destination dispatcher that fires events to adapters, webhooks, and callbacks.
+ */
+declare function createDestinationDispatcher(config: DispatcherConfig): {
+    /**
+     * Dispatch a publish event to all destinations
+     */
+    publish(post: Post): Promise<DispatchResult>;
+    /**
+     * Dispatch an unpublish event to all destinations
+     */
+    unpublish(post: Post): Promise<DispatchResult>;
+    /**
+     * Dispatch a delete event to all destinations
+     */
+    delete(post: Post): Promise<DispatchResult>;
+    /**
+     * Check if any destinations or webhooks are configured
+     */
+    readonly hasDestinations: boolean;
+};
+type DestinationDispatcher = ReturnType<typeof createDestinationDispatcher>;
+
 interface PostHooks {
     beforePublish?: (post: Post) => Promise<void>;
     afterSave?: (post: Post) => Promise<void>;
+    /** Called when a slug changes on a post that was previously published. Used to create redirects. */
+    onSlugChange?: (data: {
+        postId: string;
+        oldSlug: string;
+        newSlug: string;
+    }) => Promise<void>;
 }
 interface CreatePostInput {
     title: string;
@@ -68,7 +185,7 @@ interface UpdatePostInput {
     publishedAt?: Date;
     [key: string]: unknown;
 }
-declare function createPostsData(prisma: any, hooks?: PostHooks): {
+declare function createPostsData(prisma: any, hooks?: PostHooks, dispatcher?: DestinationDispatcher, prismicEnvToken?: string): {
     count(where?: {
         status?: string;
     }): Promise<any>;
@@ -353,6 +470,13 @@ interface AutobloggerServerConfig {
         anthropicKey?: string;
         openaiKey?: string;
     };
+    /** Prismic integration config (passed from host app) */
+    prismic?: {
+        /** Repository name (e.g., 'my-repo') - auto-fills the settings UI */
+        repository?: string;
+        /** Write API token from env */
+        writeToken?: string;
+    };
     storage?: {
         upload: (file: File) => Promise<{
             url: string;
@@ -365,6 +489,12 @@ interface AutobloggerServerConfig {
     hooks?: {
         beforePublish?: (post: Post) => Promise<void>;
         afterSave?: (post: Post) => Promise<void>;
+        /** Called when a slug changes on a post that was previously published. Used to create redirects. */
+        onSlugChange?: (data: {
+            postId: string;
+            oldSlug: string;
+            newSlug: string;
+        }) => Promise<void>;
         /** Called during auto-draft after generating essay, return extra fields for post creation */
         onAutoDraftPostCreate?: (article: RssArticle, essay: {
             title: string;
@@ -372,6 +502,16 @@ interface AutobloggerServerConfig {
             markdown: string;
         }) => Record<string, unknown> | Promise<Record<string, unknown>>;
     };
+    /** Array of destination adapters to sync posts to (Prismic, Contentful, etc.) */
+    destinations?: Destination[];
+    /** Webhook URLs to POST event payloads to when posts are published/unpublished/deleted */
+    webhooks?: string[];
+    /** Callback fired when a post is published */
+    onPublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is unpublished */
+    onUnpublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is deleted */
+    onDelete?: (post: Post) => Promise<void>;
 }
 
 interface AutobloggerServer {
@@ -679,4 +819,4 @@ declare function applyCommentMarks(editor: Editor, comments: CommentWithUser[]):
  */
 declare function scrollToComment(editor: Editor, commentId: string): void;
 
-export { type AIModel, AI_MODELS, type AutoDraftConfig, type AutobloggerServer as Autoblogger, type AutobloggerServerConfig as AutobloggerConfig, type BaseCrud, CommentMark, type CommentWithUser, type CreateCommentData, type CrudOptions, type CustomFieldConfig, type CustomFieldProps, DEFAULT_AUTO_DRAFT_TEMPLATE, DEFAULT_CHAT_TEMPLATE, DEFAULT_EXPAND_PLAN_TEMPLATE, DEFAULT_GENERATE_TEMPLATE, DEFAULT_PLAN_RULES, DEFAULT_PLAN_TEMPLATE, DEFAULT_REWRITE_TEMPLATE, type GenerationResult, Post, type RssArticle, type SelectionState, type Session, type StylesConfig, addCommentMark, applyCommentMarks, buildAutoDraftPrompt, buildChatPrompt, buildExpandPlanPrompt, buildGeneratePrompt, buildPlanPrompt, buildRewritePrompt, canDeleteComment, canEditComment, createAPIHandler, createAutoblogger, createCommentsClient, createCrudData, fetchRssFeeds, filterByKeywords, formatDate, generate, getDefaultModel, getModel, parseGeneratedContent, removeCommentMark, resolveModel, runAutoDraft, scrollToComment, truncate, validateSchema };
+export { type AIModel, AI_MODELS, type AutoDraftConfig, type AutobloggerServer as Autoblogger, type AutobloggerServerConfig as AutobloggerConfig, type BaseCrud, CommentMark, type CommentWithUser, type CreateCommentData, type CrudOptions, type CustomFieldConfig, type CustomFieldProps, DEFAULT_AUTO_DRAFT_TEMPLATE, DEFAULT_CHAT_TEMPLATE, DEFAULT_EXPAND_PLAN_TEMPLATE, DEFAULT_GENERATE_TEMPLATE, DEFAULT_PLAN_RULES, DEFAULT_PLAN_TEMPLATE, DEFAULT_REWRITE_TEMPLATE, type Destination, type DestinationDispatcher, type DestinationEvent, type DestinationResult, type DestinationsConfig, type DispatchResult, type DispatcherConfig, type GenerationResult, Post, type RssArticle, type SelectionState, type Session, type StylesConfig, addCommentMark, applyCommentMarks, buildAutoDraftPrompt, buildChatPrompt, buildExpandPlanPrompt, buildGeneratePrompt, buildPlanPrompt, buildRewritePrompt, canDeleteComment, canEditComment, createAPIHandler, createAutoblogger, createCommentsClient, createCrudData, createDestinationDispatcher, fetchRssFeeds, filterByKeywords, formatDate, generate, getDefaultModel, getModel, parseGeneratedContent, removeCommentMark, resolveModel, runAutoDraft, scrollToComment, truncate, validateSchema };

package/dist/index.d.ts

@@ -47,9 +47,126 @@ interface AutoDraftConfig {
  */
 declare function runAutoDraft(config: AutoDraftConfig, topicId?: string, skipFrequencyCheck?: boolean): Promise<GenerationResult[]>;
 
+/**
+ * Result returned by a destination after handling an event
+ */
+interface DestinationResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** External ID assigned by the destination (e.g., Prismic document ID) */
+    externalId?: string;
+    /** Error message if the operation failed */
+    error?: string;
+}
+/**
+ * A destination adapter that syncs posts to an external CMS or service.
+ *
+ * Implement this interface to create custom adapters for Prismic, Contentful,
+ * Sanity, or any other service.
+ */
+interface Destination {
+    /** Unique name for this destination (for logging/debugging) */
+    name: string;
+    /**
+     * Called when a post is published.
+     * Should create or update the post in the external service.
+     */
+    onPublish(post: Post): Promise<DestinationResult>;
+    /**
+     * Called when a post is unpublished (status changed from 'published' to 'draft').
+     * Should archive or unpublish the post in the external service.
+     */
+    onUnpublish(post: Post): Promise<DestinationResult>;
+    /**
+     * Called when a post is deleted.
+     * Should remove the post from the external service.
+     */
+    onDelete(post: Post): Promise<DestinationResult>;
+}
+/**
+ * Event payload sent to webhooks
+ */
+interface DestinationEvent {
+    /** The type of event that occurred */
+    type: 'publish' | 'unpublish' | 'delete';
+    /** The post that triggered the event */
+    post: Post;
+    /** When the event occurred */
+    timestamp: string;
+}
+/**
+ * Configuration for the destination system
+ */
+interface DestinationsConfig {
+    /** Array of destination adapters to sync posts to */
+    destinations?: Destination[];
+    /** Webhook URLs to POST event payloads to */
+    webhooks?: string[];
+    /** Callback fired when a post is published */
+    onPublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is unpublished */
+    onUnpublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is deleted */
+    onDelete?: (post: Post) => Promise<void>;
+}
+/**
+ * Aggregated results from all destinations
+ */
+interface DispatchResult {
+    /** Results from each destination adapter */
+    destinations: Array<{
+        name: string;
+        result: DestinationResult;
+    }>;
+    /** Results from webhook calls */
+    webhooks: Array<{
+        url: string;
+        success: boolean;
+        error?: string;
+    }>;
+    /** Whether all operations succeeded */
+    allSucceeded: boolean;
+}
+
+interface DispatcherConfig {
+    destinations?: Destination[];
+    webhooks?: string[];
+    onPublish?: (post: Post) => Promise<void>;
+    onUnpublish?: (post: Post) => Promise<void>;
+    onDelete?: (post: Post) => Promise<void>;
+}
+/**
+ * Creates a destination dispatcher that fires events to adapters, webhooks, and callbacks.
+ */
+declare function createDestinationDispatcher(config: DispatcherConfig): {
+    /**
+     * Dispatch a publish event to all destinations
+     */
+    publish(post: Post): Promise<DispatchResult>;
+    /**
+     * Dispatch an unpublish event to all destinations
+     */
+    unpublish(post: Post): Promise<DispatchResult>;
+    /**
+     * Dispatch a delete event to all destinations
+     */
+    delete(post: Post): Promise<DispatchResult>;
+    /**
+     * Check if any destinations or webhooks are configured
+     */
+    readonly hasDestinations: boolean;
+};
+type DestinationDispatcher = ReturnType<typeof createDestinationDispatcher>;
+
 interface PostHooks {
     beforePublish?: (post: Post) => Promise<void>;
     afterSave?: (post: Post) => Promise<void>;
+    /** Called when a slug changes on a post that was previously published. Used to create redirects. */
+    onSlugChange?: (data: {
+        postId: string;
+        oldSlug: string;
+        newSlug: string;
+    }) => Promise<void>;
 }
 interface CreatePostInput {
     title: string;
@@ -68,7 +185,7 @@ interface UpdatePostInput {
     publishedAt?: Date;
     [key: string]: unknown;
 }
-declare function createPostsData(prisma: any, hooks?: PostHooks): {
+declare function createPostsData(prisma: any, hooks?: PostHooks, dispatcher?: DestinationDispatcher, prismicEnvToken?: string): {
     count(where?: {
         status?: string;
     }): Promise<any>;
@@ -353,6 +470,13 @@ interface AutobloggerServerConfig {
         anthropicKey?: string;
         openaiKey?: string;
     };
+    /** Prismic integration config (passed from host app) */
+    prismic?: {
+        /** Repository name (e.g., 'my-repo') - auto-fills the settings UI */
+        repository?: string;
+        /** Write API token from env */
+        writeToken?: string;
+    };
     storage?: {
         upload: (file: File) => Promise<{
             url: string;
@@ -365,6 +489,12 @@ interface AutobloggerServerConfig {
     hooks?: {
         beforePublish?: (post: Post) => Promise<void>;
         afterSave?: (post: Post) => Promise<void>;
+        /** Called when a slug changes on a post that was previously published. Used to create redirects. */
+        onSlugChange?: (data: {
+            postId: string;
+            oldSlug: string;
+            newSlug: string;
+        }) => Promise<void>;
         /** Called during auto-draft after generating essay, return extra fields for post creation */
         onAutoDraftPostCreate?: (article: RssArticle, essay: {
             title: string;
@@ -372,6 +502,16 @@ interface AutobloggerServerConfig {
             markdown: string;
         }) => Record<string, unknown> | Promise<Record<string, unknown>>;
     };
+    /** Array of destination adapters to sync posts to (Prismic, Contentful, etc.) */
+    destinations?: Destination[];
+    /** Webhook URLs to POST event payloads to when posts are published/unpublished/deleted */
+    webhooks?: string[];
+    /** Callback fired when a post is published */
+    onPublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is unpublished */
+    onUnpublish?: (post: Post) => Promise<void>;
+    /** Callback fired when a post is deleted */
+    onDelete?: (post: Post) => Promise<void>;
 }
 
 interface AutobloggerServer {
@@ -679,4 +819,4 @@ declare function applyCommentMarks(editor: Editor, comments: CommentWithUser[]):
  */
 declare function scrollToComment(editor: Editor, commentId: string): void;
 
-export { type AIModel, AI_MODELS, type AutoDraftConfig, type AutobloggerServer as Autoblogger, type AutobloggerServerConfig as AutobloggerConfig, type BaseCrud, CommentMark, type CommentWithUser, type CreateCommentData, type CrudOptions, type CustomFieldConfig, type CustomFieldProps, DEFAULT_AUTO_DRAFT_TEMPLATE, DEFAULT_CHAT_TEMPLATE, DEFAULT_EXPAND_PLAN_TEMPLATE, DEFAULT_GENERATE_TEMPLATE, DEFAULT_PLAN_RULES, DEFAULT_PLAN_TEMPLATE, DEFAULT_REWRITE_TEMPLATE, type GenerationResult, Post, type RssArticle, type SelectionState, type Session, type StylesConfig, addCommentMark, applyCommentMarks, buildAutoDraftPrompt, buildChatPrompt, buildExpandPlanPrompt, buildGeneratePrompt, buildPlanPrompt, buildRewritePrompt, canDeleteComment, canEditComment, createAPIHandler, createAutoblogger, createCommentsClient, createCrudData, fetchRssFeeds, filterByKeywords, formatDate, generate, getDefaultModel, getModel, parseGeneratedContent, removeCommentMark, resolveModel, runAutoDraft, scrollToComment, truncate, validateSchema };
+export { type AIModel, AI_MODELS, type AutoDraftConfig, type AutobloggerServer as Autoblogger, type AutobloggerServerConfig as AutobloggerConfig, type BaseCrud, CommentMark, type CommentWithUser, type CreateCommentData, type CrudOptions, type CustomFieldConfig, type CustomFieldProps, DEFAULT_AUTO_DRAFT_TEMPLATE, DEFAULT_CHAT_TEMPLATE, DEFAULT_EXPAND_PLAN_TEMPLATE, DEFAULT_GENERATE_TEMPLATE, DEFAULT_PLAN_RULES, DEFAULT_PLAN_TEMPLATE, DEFAULT_REWRITE_TEMPLATE, type Destination, type DestinationDispatcher, type DestinationEvent, type DestinationResult, type DestinationsConfig, type DispatchResult, type DispatcherConfig, type GenerationResult, Post, type RssArticle, type SelectionState, type Session, type StylesConfig, addCommentMark, applyCommentMarks, buildAutoDraftPrompt, buildChatPrompt, buildExpandPlanPrompt, buildGeneratePrompt, buildPlanPrompt, buildRewritePrompt, canDeleteComment, canEditComment, createAPIHandler, createAutoblogger, createCommentsClient, createCrudData, createDestinationDispatcher, fetchRssFeeds, filterByKeywords, formatDate, generate, getDefaultModel, getModel, parseGeneratedContent, removeCommentMark, resolveModel, runAutoDraft, scrollToComment, truncate, validateSchema };