@verbatims/sdk 1.0.0

package/src/resources/quotes.ts

@@ -0,0 +1,80 @@
+import { z } from 'zod/v4'
+import type { VerbatimsClient } from '../client'
+import { apiResponseSchema } from '../types'
+import { paginate } from '../pagination'
+import type { QuoteWithRelations, ListQuotesParams, CreateQuoteData, UpdateQuoteData } from '../types'
+
+const quoteSchema = z.object({
+  id: z.number(),
+  name: 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(),
+})
+
+const quoteListResponseSchema = apiResponseSchema(z.array(quoteSchema))
+const quoteSingleResponseSchema = apiResponseSchema(quoteSchema)
+const quoteDeleteResponseSchema = apiResponseSchema(z.undefined()).or(z.object({
+  success: z.literal(true),
+  message: z.string().optional(),
+  data: z.unknown().optional(),
+}))
+
+type QuoteItem = z.infer<typeof quoteSchema>
+
+export class QuotesResource {
+  constructor(private client: VerbatimsClient) {}
+
+  async list(params?: ListQuotesParams) {
+    return this.client.get('/quotes', { params: params as Record<string, unknown> }, quoteListResponseSchema)
+  }
+
+  paginate(params?: ListQuotesParams): AsyncGenerator<QuoteItem> {
+    return paginate<QuoteItem>((page) =>
+      this.list({ ...params, page }).then(r => ({
+        data: r.data,
+        pagination: r.pagination,
+      }))
+    )
+  }
+
+  async get(id: number) {
+    return this.client.get(`/quotes/${id}`, {}, quoteSingleResponseSchema)
+  }
+
+  async create(data: CreateQuoteData) {
+    return this.client.post('/quotes', data, {}, quoteSingleResponseSchema)
+  }
+
+  async update(id: number, data: UpdateQuoteData) {
+    return this.client.put(`/quotes/${id}`, data, {}, quoteSingleResponseSchema)
+  }
+
+  async delete(id: number) {
+    return this.client.delete(`/quotes/${id}`, {}, quoteDeleteResponseSchema)
+  }
+}

package/src/resources/references.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod/v4'
+import type { VerbatimsClient } from '../client'
+import { apiResponseSchema } from '../types'
+import { paginate } from '../pagination'
+import type { ListReferencesParams, CreateReferenceData, UpdateReferenceData } from '../types'
+
+const referenceSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  primary_type: z.string(),
+  secondary_type: z.string().nullable().optional(),
+  original_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(),
+})
+
+const referenceListResponseSchema = apiResponseSchema(z.array(referenceSchema))
+const referenceSingleResponseSchema = apiResponseSchema(referenceSchema)
+
+type ReferenceItem = z.infer<typeof referenceSchema>
+
+export class ReferencesResource {
+  constructor(private client: VerbatimsClient) {}
+
+  async list(params?: ListReferencesParams) {
+    return this.client.get('/references', { params: params as Record<string, unknown> }, referenceListResponseSchema)
+  }
+
+  paginate(params?: ListReferencesParams): AsyncGenerator<ReferenceItem> {
+    return paginate<ReferenceItem>((page) =>
+      this.list({ ...params, page }).then(r => ({
+        data: r.data,
+        pagination: r.pagination,
+      }))
+    )
+  }
+
+  async get(id: number) {
+    return this.client.get(`/references/${id}`, {}, referenceSingleResponseSchema)
+  }
+
+  async create(data: CreateReferenceData) {
+    return this.client.post('/references', data, {}, referenceSingleResponseSchema)
+  }
+
+  async update(id: number, data: UpdateReferenceData) {
+    return this.client.put(`/references/${id}`, data, {}, referenceSingleResponseSchema)
+  }
+}

package/src/resources/search.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod/v4'
+import type { VerbatimsClient } from '../client'
+import { apiResponseSchema } from '../types'
+import { paginate } from '../pagination'
+import type { SearchParams } from '../types'
+
+const searchResultSchema = z.object({
+  id: z.number(),
+  type: z.string(),
+  name: z.string(),
+  description: z.string().optional(),
+  match: z.string().optional(),
+})
+
+type SearchResultItem = z.infer<typeof searchResultSchema>
+
+const searchResponseSchema = apiResponseSchema(z.array(searchResultSchema))
+
+export class SearchResource {
+  constructor(private client: VerbatimsClient) {}
+
+  async query(params: SearchParams) {
+    return this.client.get('/search', { params: params as unknown as Record<string, unknown> }, searchResponseSchema)
+  }
+
+  paginate(params: SearchParams): AsyncGenerator<SearchResultItem> {
+    return paginate<SearchResultItem>((page) =>
+      this.query({ ...params, page }).then(r => ({
+        data: r.data,
+        pagination: r.pagination,
+      }))
+    )
+  }
+}

package/src/resources/tags.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod/v4'
+import type { VerbatimsClient } from '../client'
+import { apiResponseSchema } from '../types'
+import { paginate } from '../pagination'
+
+const tagSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  color: z.string().nullable().optional(),
+  usage_count: z.number().optional(),
+})
+
+type TagItem = z.infer<typeof tagSchema>
+
+const tagListResponseSchema = apiResponseSchema(z.array(tagSchema))
+
+export class TagsResource {
+  constructor(private client: VerbatimsClient) {}
+
+  async list(params?: { page?: number; limit?: number }) {
+    return this.client.get('/tags', { params: params as Record<string, unknown> }, tagListResponseSchema)
+  }
+
+  paginate(params?: { page?: number; limit?: number }): AsyncGenerator<TagItem> {
+    return paginate<TagItem>((page) =>
+      this.list({ ...params, page }).then(r => ({
+        data: r.data,
+        pagination: r.pagination,
+      }))
+    )
+  }
+}

package/src/types.ts

@@ -0,0 +1,221 @@
+import { z } from 'zod/v4'
+
+// --- Zod schemas for response validation ---
+
+export const paginationMetaSchema = z.object({
+  page: z.number(),
+  limit: z.number(),
+  total: z.number(),
+  totalPages: z.number(),
+  hasMore: z.boolean(),
+})
+
+export function apiResponseSchema<T extends z.ZodTypeAny>(dataSchema: T) {
+  return z.object({
+    success: z.literal(true),
+    data: dataSchema.optional(),
+    message: z.string().optional(),
+    pagination: paginationMetaSchema.optional(),
+  })
+}
+
+export const errorResponseSchema = z.object({
+  success: z.literal(false),
+  message: z.string().optional(),
+  errors: z.array(z.string()).optional(),
+})
+
+export type PaginationMeta = z.infer<typeof paginationMetaSchema>
+
+export interface ApiResponse<T = unknown> {
+  success: boolean
+  data?: T
+  message?: string
+  pagination?: PaginationMeta
+}
+
+// --- API entity types (subset of shared types, inlined for portability) ---
+
+export interface QuoteAuthor {
+  id: number
+  name: string
+  is_fictional?: boolean
+  image_url?: string | null
+  description?: string | null
+}
+
+export interface QuoteReferenceInfo {
+  id: number
+  name: string
+  primary_type?: string
+}
+
+export interface QuoteWithRelations {
+  id: number
+  name: 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 }>
+}
+
+export interface Author {
+  id: number
+  name: string
+  is_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
+}
+
+export interface QuoteReference {
+  id: number
+  name: string
+  primary_type: string
+  secondary_type?: string | null
+  original_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
+}
+
+// --- Parameter types for SDK methods ---
+
+export interface ListQuotesParams {
+  page?: number
+  limit?: number
+  language?: string
+  author_id?: number
+  reference_id?: number
+  search?: string
+  tag?: string
+  sort_by?: string
+  sort_order?: 'asc' | 'desc'
+}
+
+export interface ListAuthorsParams {
+  page?: number
+  limit?: number
+  search?: string
+}
+
+export interface ListReferencesParams {
+  page?: number
+  limit?: number
+  search?: string
+  type?: string
+}
+
+export interface SearchParams {
+  q: string
+  type?: 'quotes' | 'authors' | 'references'
+  page?: number
+  limit?: number
+}
+
+export interface CreateQuoteData {
+  name: string
+  language?: string
+  author_id?: number
+  reference_id?: number
+  new_author?: {
+    name: string
+    is_fictional?: boolean
+    job?: string | null
+    description?: string | null
+  }
+  new_reference?: {
+    name: string
+    primary_type: string
+    original_language?: string
+    description?: string | null
+    release_date?: string | null
+  }
+  tags?: number[]
+}
+
+export interface UpdateQuoteData {
+  name?: string
+  language?: string
+  author_id?: number | null
+  reference_id?: number | null
+}
+
+export interface CreateAuthorData {
+  name: string
+  is_fictional?: boolean
+  job?: string | null
+  description?: string | null
+  birth_date?: string | null
+  birth_location?: string | null
+  death_date?: string | null
+  death_location?: string | null
+  image_url?: string | null
+  socials?: Record<string, string> | null
+}
+
+export interface UpdateAuthorData {
+  name?: string
+  is_fictional?: boolean
+  job?: string | null
+  description?: string | null
+  birth_date?: string | null
+  birth_location?: string | null
+  death_date?: string | null
+  death_location?: string | null
+  image_url?: string | null
+  socials?: Record<string, string> | null
+}
+
+export interface CreateReferenceData {
+  name: string
+  primary_type: string
+  secondary_type?: string | null
+  description?: string | null
+  release_date?: string | null
+  original_language?: string
+  image_url?: string | null
+  urls?: Record<string, string> | null
+}
+
+export interface UpdateReferenceData {
+  name?: string
+  primary_type?: string
+  secondary_type?: string | null
+  description?: string | null
+  release_date?: string | null
+  original_language?: string
+  image_url?: string | null
+  urls?: Record<string, string> | null
+}
+
+export interface CreateCollectionData {
+  name: string
+  description?: string | null
+  is_public?: boolean
+}