@verbatims/sdk 1.4.0 → 1.5.0

package/src/resources/__tests__/resources.test.ts

@@ -38,7 +38,7 @@ describe('QuotesResource', () => {
     it('calls GET /quotes with params', async () => {
       fetchFn.mockResolvedValue(mockResponse({
         success: true,
-        data: [{ id: 1, name: 'Test', language: 'fr', status: 'published', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' }],
+        data: [{ id: 1, content: 'Test', language: 'fr', stats: { views: 0, likes: 0, shares: 0 }, created_at: '2024-01-01', updated_at: '2024-01-01' }],
         pagination: { page: 1, limit: 10, total: 1, totalPages: 1, hasMore: false },
       }))
 
@@ -52,7 +52,7 @@ describe('QuotesResource', () => {
       expect(parsed.searchParams.get('limit')).toBe('10')
       expect(result.success).toBe(true)
       expect(result.data).toHaveLength(1)
-      expect(result.data![0].name).toBe('Test')
+      expect(result.data![0].content).toBe('Test')
     })
   })
 
@@ -60,7 +60,7 @@ describe('QuotesResource', () => {
     it('calls GET /quotes/:id', async () => {
       fetchFn.mockResolvedValue(mockResponse({
         success: true,
-        data: { id: 42, name: 'Quote 42', language: 'en', status: 'published', views_count: 10, likes_count: 5, shares_count: 2, created_at: '2024-01-01', updated_at: '2024-01-01' },
+        data: { id: 42, content: 'Quote 42', language: 'en', stats: { views: 10, likes: 5, shares: 2 }, created_at: '2024-01-01', updated_at: '2024-01-01' },
       }))
 
       const result = await quotes.get(42)
@@ -74,7 +74,7 @@ describe('QuotesResource', () => {
     it('calls POST /quotes with body', async () => {
       fetchFn.mockResolvedValue(mockResponse({
         success: true,
-        data: { id: 1, name: 'New quote', language: 'en', status: 'published', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+        data: { id: 1, content: 'New quote', language: 'en', stats: { views: 0, likes: 0, shares: 0 }, created_at: '2024-01-01', updated_at: '2024-01-01' },
       }))
 
       await quotes.create({ name: 'New quote', language: 'en' })
@@ -88,7 +88,7 @@ describe('QuotesResource', () => {
     it('calls PUT /quotes/:id with body', async () => {
       fetchFn.mockResolvedValue(mockResponse({
         success: true,
-        data: { id: 1, name: 'Updated', language: 'en', status: 'published', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+        data: { id: 1, content: 'Updated', language: 'en', stats: { views: 0, likes: 0, shares: 0 }, created_at: '2024-01-01', updated_at: '2024-01-01' },
       }))
 
       await quotes.update(1, { name: 'Updated' })
@@ -113,12 +113,12 @@ describe('QuotesResource', () => {
       fetchFn
         .mockResolvedValueOnce(mockResponse({
           success: true,
-          data: [{ id: 1, name: 'A', language: 'fr', status: 'published', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' }],
+          data: [{ id: 1, content: 'A', language: 'fr', stats: { views: 0, likes: 0, shares: 0 }, created_at: '2024-01-01', updated_at: '2024-01-01' }],
           pagination: { page: 1, limit: 1, total: 2, totalPages: 2, hasMore: true },
         }))
         .mockResolvedValueOnce(mockResponse({
           success: true,
-          data: [{ id: 2, name: 'B', language: 'fr', status: 'published', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' }],
+          data: [{ id: 2, content: 'B', language: 'fr', stats: { views: 0, likes: 0, shares: 0 }, created_at: '2024-01-01', updated_at: '2024-01-01' }],
           pagination: { page: 2, limit: 1, total: 2, totalPages: 2, hasMore: false },
         }))
 
@@ -148,7 +148,7 @@ describe('AuthorsResource', () => {
   it('list calls GET /authors', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: [{ id: 1, name: 'Author', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' }],
+      data: [{ id: 1, name: 'Author', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' }],
       pagination: { page: 1, limit: 10, total: 1, totalPages: 1, hasMore: false },
     }))
 
@@ -163,7 +163,7 @@ describe('AuthorsResource', () => {
   it('get calls GET /authors/:id', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: { id: 5, name: 'Author 5', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+      data: { id: 5, name: 'Author 5', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' },
     }))
 
     await authors.get(5)
@@ -174,7 +174,7 @@ describe('AuthorsResource', () => {
   it('create calls POST /authors', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: { id: 1, name: 'New Author', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+      data: { id: 1, name: 'New Author', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' },
     }))
 
     await authors.create({ name: 'New Author', is_fictional: true })
@@ -186,7 +186,7 @@ describe('AuthorsResource', () => {
   it('update calls PUT /authors/:id', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: { id: 1, name: 'Updated', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+      data: { id: 1, name: 'Updated', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' },
     }))
 
     await authors.update(1, { name: 'Updated' })
@@ -208,7 +208,7 @@ describe('ReferencesResource', () => {
   it('list calls GET /references', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: [{ id: 1, name: 'Ref', primary_type: 'book', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' }],
+      data: [{ id: 1, name: 'Ref', type: 'book', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' }],
       pagination: { page: 1, limit: 10, total: 1, totalPages: 1, hasMore: false },
     }))
 
@@ -222,7 +222,7 @@ describe('ReferencesResource', () => {
   it('get calls GET /references/:id', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: { id: 3, name: 'Ref 3', primary_type: 'book', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+      data: { id: 3, name: 'Ref 3', type: 'book', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' },
     }))
 
     await references.get(3)
@@ -233,7 +233,7 @@ describe('ReferencesResource', () => {
   it('create calls POST /references', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: { id: 1, name: 'New Ref', primary_type: 'movie', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+      data: { id: 1, name: 'New Ref', type: 'movie', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' },
     }))
 
     await references.create({ name: 'New Ref', primary_type: 'movie' })
@@ -244,7 +244,7 @@ describe('ReferencesResource', () => {
   it('update calls PUT /references/:id', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: { id: 1, name: 'Updated', primary_type: 'book', views_count: 0, likes_count: 0, shares_count: 0, created_at: '2024-01-01', updated_at: '2024-01-01' },
+      data: { id: 1, name: 'Updated', type: 'book', stats: { views: 0, likes: 0 }, created_at: '2024-01-01' },
     }))
 
     await references.update(1, { name: 'Updated' })
@@ -266,7 +266,7 @@ describe('TagsResource', () => {
   it('list calls GET /tags', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: [{ id: 1, name: 'wisdom' }],
+      data: [{ id: 1, name: 'wisdom', color: '#6C757D' }],
       pagination: { page: 1, limit: 10, total: 1, totalPages: 1, hasMore: false },
     }))
 
@@ -280,12 +280,12 @@ describe('TagsResource', () => {
     fetchFn
       .mockResolvedValueOnce(mockResponse({
         success: true,
-        data: [{ id: 1, name: 'tag1' }],
+        data: [{ id: 1, name: 'tag1', color: '#6C757D' }],
         pagination: { page: 1, limit: 1, total: 2, totalPages: 2, hasMore: true },
       }))
       .mockResolvedValueOnce(mockResponse({
         success: true,
-        data: [{ id: 2, name: 'tag2' }],
+        data: [{ id: 2, name: 'tag2', color: '#6C757D' }],
         pagination: { page: 2, limit: 1, total: 2, totalPages: 2, hasMore: false },
       }))
 
@@ -351,7 +351,7 @@ describe('SearchResource', () => {
   it('query calls GET /search with q param', async () => {
     fetchFn.mockResolvedValue(mockResponse({
       success: true,
-      data: [{ id: 1, type: 'quote', name: 'Life is...' }],
+      data: [{ id: 1, content: 'Life is...', language: 'en', created_at: null }],
       pagination: { page: 1, limit: 10, total: 1, totalPages: 1, hasMore: false },
     }))
 
@@ -361,19 +361,19 @@ describe('SearchResource', () => {
     const parsed = new URL(url, 'http://localhost')
     expect(parsed.searchParams.get('q')).toBe('life')
     expect(parsed.searchParams.get('type')).toBe('quotes')
-    expect(result.data![0].name).toBe('Life is...')
+    expect(result.data![0].content).toBe('Life is...')
   })
 
   it('paginate searches across pages', async () => {
     fetchFn
       .mockResolvedValueOnce(mockResponse({
         success: true,
-        data: [{ id: 1, type: 'quote', name: 'A' }],
+        data: [{ id: 1, content: 'A', language: 'en', created_at: null }],
         pagination: { page: 1, limit: 1, total: 2, totalPages: 2, hasMore: true },
       }))
       .mockResolvedValueOnce(mockResponse({
         success: true,
-        data: [{ id: 2, type: 'quote', name: 'B' }],
+        data: [{ id: 2, content: 'B', language: 'en', created_at: null }],
         pagination: { page: 2, limit: 1, total: 2, totalPages: 2, hasMore: false },
       }))
 

package/src/resources/authors.ts

@@ -4,23 +4,28 @@ import { apiResponseSchema } from '../types'
 import { paginate } from '../pagination'
 import type { Author, ListAuthorsParams, CreateAuthorData, UpdateAuthorData } from '../types'
 
+const authorStatsSchema = z.object({
+  views: z.number(),
+  likes: z.number(),
+})
+
+const authorDatesSchema = z.object({
+  birth: z.string().nullable().optional(),
+  death: z.string().nullable().optional(),
+  birth_location: z.string().nullable().optional(),
+  death_location: z.string().nullable().optional(),
+})
+
 const authorSchema = z.object({
   id: z.number(),
   name: z.string(),
-  is_fictional: z.boolean().optional(),
+  fictional: z.boolean().optional(),
   image_url: z.string().nullable().optional(),
   job: z.string().nullable().optional(),
   description: z.string().nullable().optional(),
-  birth_date: z.string().nullable().optional(),
-  birth_location: z.string().nullable().optional(),
-  death_date: z.string().nullable().optional(),
-  death_location: z.string().nullable().optional(),
-  views_count: z.number(),
-  likes_count: z.number(),
-  shares_count: z.number(),
-  quotes_count: z.number().optional(),
-  created_at: z.string(),
-  updated_at: z.string(),
+  dates: authorDatesSchema.optional(),
+  stats: authorStatsSchema.optional(),
+  created_at: z.string().nullable(),
 })
 
 const authorListResponseSchema = apiResponseSchema(z.array(authorSchema))

package/src/resources/quotes.ts

@@ -4,36 +4,44 @@ import { apiResponseSchema } from '../types'
 import { paginate } from '../pagination'
 import type { QuoteWithRelations, ListQuotesParams, CreateQuoteData, UpdateQuoteData } from '../types'
 
-const quoteSchema = z.object({
+const quoteStatsSchema = z.object({
+  views: z.number(),
+  likes: z.number(),
+  shares: z.number().optional(),
+})
+
+const quoteAuthorSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  fictional: z.boolean().optional(),
+  image_url: z.string().nullable().optional(),
+  description: z.string().nullable().optional(),
+  job: z.string().nullable().optional(),
+})
+
+const quoteReferenceSchema = z.object({
   id: z.number(),
   name: z.string(),
+  type: z.string().optional(),
+})
+
+const quoteTagSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  color: z.string().nullable().optional(),
+})
+
+const quoteSchema = z.object({
+  id: z.number(),
+  content: z.string(),
   language: z.string(),
-  author_id: z.number().optional(),
-  reference_id: z.number().optional(),
-  status: z.string(),
-  views_count: z.number(),
-  likes_count: z.number(),
-  shares_count: z.number(),
-  is_featured: z.boolean().optional(),
-  created_at: z.string(),
-  updated_at: z.string(),
-  author: z.object({
-    id: z.number(),
-    name: z.string(),
-    is_fictional: z.boolean().optional(),
-    image_url: z.string().nullable().optional(),
-    description: z.string().nullable().optional(),
-  }).optional(),
-  reference: z.object({
-    id: z.number(),
-    name: z.string(),
-    primary_type: z.string().optional(),
-  }).optional(),
-  tags: z.array(z.object({
-    id: z.number().optional(),
-    name: z.string(),
-    color: z.string().nullable().optional(),
-  })).optional(),
+  stats: quoteStatsSchema.optional(),
+  featured: z.boolean().optional(),
+  author: quoteAuthorSchema.nullable().optional(),
+  reference: quoteReferenceSchema.nullable().optional(),
+  tags: z.array(quoteTagSchema).optional(),
+  created_at: z.string().nullable(),
+  updated_at: z.string().nullable(),
 })
 
 const quoteListResponseSchema = apiResponseSchema(z.array(quoteSchema))

package/src/resources/references.ts

@@ -4,21 +4,22 @@ import { apiResponseSchema } from '../types'
 import { paginate } from '../pagination'
 import type { ListReferencesParams, CreateReferenceData, UpdateReferenceData } from '../types'
 
+const referenceStatsSchema = z.object({
+  views: z.number(),
+  likes: z.number(),
+})
+
 const referenceSchema = z.object({
   id: z.number(),
   name: z.string(),
-  primary_type: z.string(),
+  type: z.string(),
   secondary_type: z.string().nullable().optional(),
-  original_language: z.string().optional(),
+  language: z.string().optional(),
   release_date: z.string().nullable().optional(),
   description: z.string().nullable().optional(),
   image_url: z.string().nullable().optional(),
-  views_count: z.number(),
-  likes_count: z.number(),
-  shares_count: z.number(),
-  quotes_count: z.number().optional(),
-  created_at: z.string(),
-  updated_at: z.string(),
+  stats: referenceStatsSchema.optional(),
+  created_at: z.string().nullable(),
 })
 
 const referenceListResponseSchema = apiResponseSchema(z.array(referenceSchema))

package/src/resources/search.ts

@@ -4,17 +4,32 @@ import { apiResponseSchema } from '../types'
 import { paginate } from '../pagination'
 import type { SearchParams } from '../types'
 
-const searchResultSchema = z.object({
+const searchAuthorSchema = z.object({
   id: z.number(),
-  type: z.string(),
   name: z.string(),
-  description: z.string().optional(),
-  match: z.string().optional(),
+  fictional: z.boolean().optional(),
+  image_url: z.string().nullable().optional(),
+  job: z.string().nullable().optional(),
 })
 
-type SearchResultItem = z.infer<typeof searchResultSchema>
+const searchReferenceSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  type: z.string().optional(),
+})
+
+const searchQuoteSchema = z.object({
+  id: z.number(),
+  content: z.string(),
+  language: z.string(),
+  author: searchAuthorSchema.nullable().optional(),
+  reference: searchReferenceSchema.nullable().optional(),
+  created_at: z.string().nullable(),
+})
+
+type SearchResultItem = z.infer<typeof searchQuoteSchema>
 
-const searchResponseSchema = apiResponseSchema(z.array(searchResultSchema))
+const searchResponseSchema = apiResponseSchema(z.array(searchQuoteSchema))
 
 export class SearchResource {
   constructor(private client: VerbatimsClient) {}

package/src/resources/tags.ts

@@ -6,8 +6,10 @@ import { paginate } from '../pagination'
 const tagSchema = z.object({
   id: z.number(),
   name: z.string(),
-  color: z.string().nullable().optional(),
-  usage_count: z.number().optional(),
+  description: z.string().nullable().optional(),
+  category: z.string().nullable().optional(),
+  color: z.string().nullable(),
+  quote_count: z.number().optional(),
 })
 
 type TagItem = z.infer<typeof tagSchema>

package/src/types.ts

@@ -34,74 +34,82 @@ export interface ApiResponse<T = unknown> {
   pagination?: PaginationMeta
 }
 
-// --- API entity types (subset of shared types, inlined for portability) ---
+// --- API entity types ---
 
 export interface QuoteAuthor {
   id: number
   name: string
-  is_fictional?: boolean
+  fictional?: boolean
   image_url?: string | null
   description?: string | null
+  job?: string | null
 }
 
 export interface QuoteReferenceInfo {
   id: number
   name: string
-  primary_type?: string
+  type?: string
+}
+
+export interface QuoteStats {
+  views: number
+  likes: number
+  shares?: number
 }
 
 export interface QuoteWithRelations {
   id: number
-  name: string
+  content: string
   language: string
-  author_id?: number
-  reference_id?: number
-  status: string
-  views_count: number
-  likes_count: number
-  shares_count: number
-  is_featured?: boolean
-  created_at: string
-  updated_at: string
-  author?: QuoteAuthor
-  reference?: QuoteReferenceInfo
-  tags?: Array<{ id?: number; name: string; color?: string | null }>
+  stats?: QuoteStats
+  featured?: boolean
+  author?: QuoteAuthor | null
+  reference?: QuoteReferenceInfo | null
+  tags?: Array<{ id: number; name: string; color?: string | null }>
+  created_at: string | null
+  updated_at: string | null
+}
+
+export interface AuthorDates {
+  birth?: string | null
+  death?: string | null
+  birth_location?: string | null
+  death_location?: string | null
+}
+
+export interface AuthorStats {
+  views: number
+  likes: number
 }
 
 export interface Author {
   id: number
   name: string
-  is_fictional?: boolean
+  fictional?: boolean
   image_url?: string | null
   job?: string | null
   description?: string | null
-  birth_date?: string | null
-  birth_location?: string | null
-  death_date?: string | null
-  death_location?: string | null
-  views_count: number
-  likes_count: number
-  shares_count: number
-  quotes_count?: number
-  created_at: string
-  updated_at: string
+  dates?: AuthorDates
+  stats?: AuthorStats
+  created_at: string | null
+}
+
+export interface ReferenceStats {
+  views: number
+  likes: number
 }
 
 export interface QuoteReference {
   id: number
   name: string
-  primary_type: string
+  type: string
   secondary_type?: string | null
-  original_language?: string
+  language?: string
   release_date?: string | null
   description?: string | null
   image_url?: string | null
-  views_count: number
-  likes_count: number
-  shares_count: number
-  quotes_count?: number
-  created_at: string
-  updated_at: string
+  stats?: ReferenceStats
+  created_at: string | null
 }
 
 // --- Parameter types for SDK methods ---
@@ -139,7 +147,8 @@ export interface SearchParams {
 }
 
 export interface CreateQuoteData {
-  name: string
+  content?: string
+  name?: string
   language?: string
   author_id?: number
   reference_id?: number
@@ -160,6 +169,7 @@ export interface CreateQuoteData {
 }
 
 export interface UpdateQuoteData {
+  content?: string
   name?: string
   language?: string
   author_id?: number | null
@@ -168,6 +178,7 @@ export interface UpdateQuoteData {
 
 export interface CreateAuthorData {
   name: string
+  fictional?: boolean
   is_fictional?: boolean
   job?: string | null
   description?: string | null
@@ -181,9 +192,10 @@ export interface CreateAuthorData {
 
 export interface UpdateAuthorData {
   name?: string
+  fictional?: boolean
   is_fictional?: boolean
-  job?: string | null
   description?: string | null
+  job?: string | null
   birth_date?: string | null
   birth_location?: string | null
   death_date?: string | null
@@ -194,10 +206,12 @@ export interface UpdateAuthorData {
 
 export interface CreateReferenceData {
   name: string
-  primary_type: string
+  type?: string
+  primary_type?: string
   secondary_type?: string | null
   description?: string | null
   release_date?: string | null
+  language?: string
   original_language?: string
   image_url?: string | null
   urls?: Record<string, string> | null
@@ -205,10 +219,12 @@ export interface CreateReferenceData {
 
 export interface UpdateReferenceData {
   name?: string
+  type?: string
   primary_type?: string
   secondary_type?: string | null
   description?: string | null
   release_date?: string | null
+  language?: string
   original_language?: string
   image_url?: string | null
   urls?: Record<string, string> | null