@verbatims/sdk 1.6.14 → 1.6.16

package/src/resources/search.ts

@@ -4,7 +4,7 @@ import { apiResponseSchema } from '../types'
 import { paginate } from '../pagination'
 import type { SearchParams } from '../types'
 
-const searchAuthorSchema = z.object({
+const searchAuthorRefSchema = z.object({
   id: z.number(),
   name: z.string(),
   fictional: z.boolean().optional(),
@@ -12,24 +12,42 @@ const searchAuthorSchema = z.object({
   job: z.string().nullable().optional(),
 })
 
-const searchReferenceSchema = z.object({
+const searchQuoteRefSchema = z.object({
   id: z.number(),
   name: z.string(),
   type: z.string().optional(),
 })
 
-const searchQuoteSchema = z.object({
+const searchQuoteItemSchema = z.object({
   id: z.number(),
   content: z.string(),
   language: z.string(),
-  author: searchAuthorSchema.nullable().optional(),
-  reference: searchReferenceSchema.nullable().optional(),
+  author: searchAuthorRefSchema.nullable().optional(),
+  reference: searchQuoteRefSchema.nullable().optional(),
   created_at: z.string().nullable(),
 })
 
-type SearchResultItem = z.infer<typeof searchQuoteSchema>
+const searchAuthorItemSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  image_url: z.string().nullable().optional(),
+  job: z.string().nullable().optional(),
+  type: z.literal('author').optional(),
+})
+
+const searchReferenceItemSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  type: z.string().optional(),
+  image_url: z.string().nullable().optional(),
+  entity_type: z.literal('reference').optional(),
+})
+
+const searchResultSchema = z.union([searchQuoteItemSchema, searchAuthorItemSchema, searchReferenceItemSchema])
+
+type SearchResultItem = z.infer<typeof searchResultSchema>
 
-const searchResponseSchema = apiResponseSchema(z.array(searchQuoteSchema))
+const searchResponseSchema = apiResponseSchema(z.array(searchResultSchema))
 
 export class SearchResource {
   constructor(private client: VerbatimsClient) {}

package/src/resources/social.ts

@@ -0,0 +1,190 @@
+import { z } from 'zod/v4'
+import type { VerbatimsClient } from '../client'
+import { apiResponseSchema } from '../types'
+import { paginate } from '../pagination'
+import type {
+  SocialQueueItem,
+  ListSocialQueueParams,
+  ListSocialPostsParams,
+  AddToSocialQueueData,
+  AddRandomToSocialQueueData,
+  ClearSocialQueueData,
+  ReorderSocialQueueData,
+  RunSocialAutopostData,
+} from '../types'
+
+const socialQueueStatsSchema = z.object({
+  queued: z.number(),
+  processing: z.number(),
+  posted: z.number(),
+  failed: z.number(),
+})
+
+const socialResolvedContentSchema = z.object({
+  source_type: z.string(),
+  source_id: z.number(),
+  primary_text: z.string().nullable(),
+  secondary_text: z.string().nullable(),
+  canonical_path: z.string().nullable(),
+  title: z.string().nullable(),
+  subtitle: z.string().nullable(),
+  language: z.string().nullable(),
+})
+
+const socialQueueItemSchema = z.object({
+  id: z.number(),
+  quote_id: z.number(),
+  source_type: z.string(),
+  source_id: z.number(),
+  platform: z.enum(['x', 'bluesky', 'instagram', 'threads', 'facebook', 'pinterest']),
+  status: z.enum(['queued', 'processing', 'posted', 'failed']),
+  position: z.number(),
+  scheduled_for: z.string().nullable(),
+  created_at: z.string().nullable(),
+  updated_at: z.string().nullable(),
+  published_post_url: z.string().nullable(),
+  published_external_post_id: z.string().nullable(),
+  published_posted_at: z.string().nullable(),
+  error_message: z.string().nullable(),
+  quote_posts_count: z.number(),
+  quote_text: z.string().nullable(),
+  quote_language: z.string().nullable(),
+  author_name: z.string().nullable(),
+  reference_name: z.string().nullable(),
+  resolved_content: socialResolvedContentSchema.nullable(),
+})
+
+const socialPostSchema = z.object({
+  id: z.number(),
+  quote_id: z.number(),
+  source_type: z.string(),
+  source_id: z.number(),
+  queue_id: z.number().nullable(),
+  platform: z.enum(['x', 'bluesky', 'instagram', 'threads', 'facebook', 'pinterest']),
+  status: z.enum(['success', 'failed']),
+  post_text: z.string().nullable(),
+  post_url: z.string().nullable(),
+  external_post_id: z.string().nullable(),
+  error_message: z.string().nullable(),
+  posted_at: z.string().nullable(),
+  created_at: z.string().nullable(),
+})
+
+const socialPlatformSchema = z.object({
+  platform: z.enum(['x', 'bluesky', 'instagram', 'threads', 'facebook', 'pinterest']),
+  label: z.string(),
+  enabled: z.boolean(),
+  queue: socialQueueStatsSchema,
+})
+
+const queuedItemSchema = z.object({
+  id: z.number(),
+  quote_id: z.number(),
+  source_type: z.string(),
+  source_id: z.number(),
+  position: z.number(),
+  status: z.enum(['queued', 'processing', 'posted', 'failed']).optional(),
+})
+
+const socialQueueListResponseSchema = apiResponseSchema(z.object({
+  queue: z.array(socialQueueItemSchema),
+  stats: socialQueueStatsSchema,
+}))
+
+const socialPostsListResponseSchema = apiResponseSchema(z.object({
+  posts: z.array(socialPostSchema),
+}))
+
+const socialPlatformsResponseSchema = apiResponseSchema(z.array(socialPlatformSchema))
+
+const enqueueResponseSchema = apiResponseSchema(z.array(queuedItemSchema)).extend({
+  count: z.number().optional(),
+})
+
+const deleteQueueItemResponseSchema = apiResponseSchema(z.object({
+  deleted: z.literal(true),
+  id: z.number(),
+  sourceType: z.string(),
+  sourceId: z.number(),
+}))
+
+const clearQueueResponseSchema = apiResponseSchema(z.object({
+  deleted: z.literal(true),
+  platform: z.string(),
+  deletedCount: z.number(),
+  sourceTypes: z.array(z.object({
+    sourceType: z.string(),
+    count: z.number(),
+  })),
+}))
+
+const reorderQueueResponseSchema = apiResponseSchema(z.object({
+  moved: z.boolean(),
+  id: z.number().optional(),
+  sourceType: z.string().optional(),
+  sourceId: z.number().optional(),
+  position: z.number().optional(),
+}))
+
+const requeueQueueItemResponseSchema = apiResponseSchema(z.object({
+  requeued: z.literal(true),
+  id: z.number(),
+}))
+
+export class SocialResource {
+  constructor(private client: VerbatimsClient) {}
+
+  async listPlatforms() {
+    return this.client.get('/social/platforms', {}, socialPlatformsResponseSchema)
+  }
+
+  async listQueue(params?: ListSocialQueueParams) {
+    return this.client.get('/social/queue', { params: params as Record<string, unknown> }, socialQueueListResponseSchema)
+  }
+
+  paginateQueue(params?: ListSocialQueueParams): AsyncGenerator<SocialQueueItem> {
+    return paginate<SocialQueueItem>((page) =>
+      this.listQueue({ ...params, page }).then(r => ({
+        data: r.data?.queue,
+        pagination: r.pagination,
+      }))
+    )
+  }
+
+  async getQueueItem(id: number) {
+    return this.client.get(`/social/queue/${id}`, {}, apiResponseSchema(socialQueueItemSchema))
+  }
+
+  async addToQueue(data: AddToSocialQueueData) {
+    return this.client.post('/social/queue', data, {}, enqueueResponseSchema)
+  }
+
+  async addRandomToQueue(data: AddRandomToSocialQueueData) {
+    return this.client.post('/social/queue/bulk-random', data, {}, enqueueResponseSchema)
+  }
+
+  async removeQueueItem(id: number) {
+    return this.client.delete(`/social/queue/${id}`, {}, deleteQueueItemResponseSchema)
+  }
+
+  async clearQueue(data: ClearSocialQueueData) {
+    return this.client.post('/social/queue/clear', data, {}, clearQueueResponseSchema)
+  }
+
+  async reorderQueueItem(data: ReorderSocialQueueData) {
+    return this.client.post('/social/queue/reorder', data, {}, reorderQueueResponseSchema)
+  }
+
+  async runNow(data?: RunSocialAutopostData) {
+    return this.client.post('/social/queue/run-now', data ?? {}, {}, apiResponseSchema(z.record(z.string(), z.unknown())))
+  }
+
+  async requeueQueueItem(id: number) {
+    return this.client.post(`/social/queue/${id}/requeue`, {}, {}, requeueQueueItemResponseSchema)
+  }
+
+  async listPosts(params?: ListSocialPostsParams) {
+    return this.client.get('/social/posts', { params: params as Record<string, unknown> }, socialPostsListResponseSchema)
+  }
+}
+

package/src/types.ts

@@ -451,3 +451,130 @@ export interface ThemeSuggestionsQuery {
   tags?: string
   language?: string
 }
+
+// --- Social queue / auto-post types ---
+
+export type SocialPlatform = 'x' | 'bluesky' | 'instagram' | 'threads' | 'facebook' | 'pinterest'
+export type SocialQueueStatus = 'queued' | 'processing' | 'posted' | 'failed'
+export type SocialPostStatus = 'success' | 'failed'
+
+export interface SocialQueueStats {
+  queued: number
+  processing: number
+  posted: number
+  failed: number
+}
+
+export interface SocialPlatformInfo {
+  platform: SocialPlatform
+  label: string
+  enabled: boolean
+  queue: SocialQueueStats
+}
+
+export interface SocialResolvedContent {
+  source_type: string
+  source_id: number
+  primary_text: string | null
+  secondary_text: string | null
+  canonical_path: string | null
+  title: string | null
+  subtitle: string | null
+  language: string | null
+}
+
+export interface SocialQueueItem {
+  id: number
+  quote_id: number
+  source_type: string
+  source_id: number
+  platform: SocialPlatform
+  status: SocialQueueStatus
+  position: number
+  scheduled_for: string | null
+  created_at: string | null
+  updated_at: string | null
+  published_post_url: string | null
+  published_external_post_id: string | null
+  published_posted_at: string | null
+  error_message: string | null
+  quote_posts_count: number
+  quote_text: string | null
+  quote_language: string | null
+  author_name: string | null
+  reference_name: string | null
+  resolved_content: SocialResolvedContent | null
+}
+
+export interface SocialPost {
+  id: number
+  quote_id: number
+  source_type: string
+  source_id: number
+  queue_id: number | null
+  platform: SocialPlatform
+  status: SocialPostStatus
+  post_text: string | null
+  post_url: string | null
+  external_post_id: string | null
+  error_message: string | null
+  posted_at: string | null
+  created_at: string | null
+}
+
+export interface QueuedSocialItem {
+  id: number
+  quote_id: number
+  source_type: string
+  source_id: number
+  position: number
+  status?: SocialQueueStatus
+}
+
+export interface ListSocialQueueParams {
+  page?: number
+  limit?: number
+  platform?: SocialPlatform
+  status?: SocialQueueStatus | 'active'
+  search?: string
+}
+
+export interface ListSocialPostsParams {
+  page?: number
+  limit?: number
+  platform?: SocialPlatform
+  status?: SocialPostStatus
+}
+
+export interface AddToSocialQueueData {
+  quote_ids: number[]
+  platform?: SocialPlatform
+  scheduled_for?: string | null
+}
+
+export interface AddRandomToSocialQueueData {
+  platform?: SocialPlatform
+  count?: number
+  language?: string
+}
+
+export interface ClearSocialQueueData {
+  platform: SocialPlatform
+  confirm: boolean
+  scope?: 'all' | 'finished'
+}
+
+export interface ReorderSocialQueueData {
+  id: number
+  direction?: 'up' | 'down'
+  before_id?: number | null
+}
+
+export interface RunSocialAutopostData {
+  platform?: SocialPlatform
+}
+
+export interface SocialQueueListResult {
+  queue: SocialQueueItem[]
+  stats: SocialQueueStats
+}