@verbatims/sdk 1.6.15 → 1.6.17

package/src/types.ts

@@ -51,6 +51,36 @@ export interface QuoteReferenceInfo {
   type?: string
 }
 
+export type ProvenanceStatus = 'unverified' | 'manually_verified' | 'externally_verified' | 'disputed'
+
+export interface QuoteAttribution {
+  id: number
+  quote_id: number
+  author_id: number | null
+  reference_id: number | null
+  is_primary: boolean
+  status: ProvenanceStatus
+  verified_by?: number | null
+  verified_at?: string | null
+  notes?: string | null
+  author?: { id: number; name: string }
+  reference?: { id: number; name: string }
+}
+
+export interface QuoteSource {
+  id: number
+  quote_id: number
+  attribution_id: number | null
+  source_type: string
+  source_url?: string | null
+  label?: string | null
+  verification_status: ProvenanceStatus
+  verified_by?: number | null
+  verified_at?: string | null
+  notes?: string | null
+  is_primary: boolean
+}
+
 export type QuoteStatus = 'draft' | 'pending' | 'approved' | 'rejected'
 
 export interface QuoteStats {
@@ -68,6 +98,9 @@ export interface QuoteWithRelations {
   featured?: boolean
   author?: QuoteAuthor | null
   reference?: QuoteReferenceInfo | null
+  source?: { type: string; url?: string | null } | null
+  attributions?: QuoteAttribution[]
+  sources?: QuoteSource[]
   tags?: Array<{ id: number; name: string; color?: string | null }>
   user_id?: number
   moderator_id?: number | null
@@ -163,6 +196,8 @@ export interface CreateQuoteData {
   language?: string
   author_id?: number
   reference_id?: number
+  source_type?: string | null
+  source_url?: string | null
   new_author?: {
     name: string
     is_fictional?: boolean
@@ -185,6 +220,8 @@ export interface UpdateQuoteData {
   language?: string
   author_id?: number | null
   reference_id?: number | null
+  source_type?: string | null
+  source_url?: string | null
 }
 
 export interface ModerateQuoteData {
@@ -451,3 +488,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
+}