{
  "docs": [
    {
      "id": "post_id",
      "title": "Post Title",
      "slug": "post-title",
      "createdAt": "2026-01-07T10:00:00Z",
      "updatedAt": "2026-01-07T10:00:00Z"
    }
  ],
  "totalDocs": 100,
  "limit": 10,
  "page": 1,
  "totalPages": 10,
  "pagingCounter": 1,
  "hasPrevPage": false,
  "hasNextPage": true,
  "prevPage": null,
  "nextPage": 2
}

{
  "id": "post_id",
  "title": "Post Title",
  "slug": "post-title",
  "createdAt": "2026-01-07T10:00:00Z",
  "updatedAt": "2026-01-07T10:00:00Z"
}

{
  "message": "Post created successfully",
  "doc": {
    "id": "post_id",
    "title": "Post Title",
    "slug": "post-title",
    "createdAt": "2026-01-07T10:00:00Z",
    "updatedAt": "2026-01-07T10:00:00Z"
  }
}

{
  "id": "post_id",
  "message": "Post deleted successfully"
}

interface PayloadFindResponse<T> {
  docs: T[]
  totalDocs: number
  limit: number
  totalPages: number
  page: number
  pagingCounter: number
  hasPrevPage: boolean
  hasNextPage: boolean
  prevPage: number | null
  nextPage: number | null
}

const response = await client.from('posts').find({ limit: 10 })
// response: PayloadFindResponse<Post>

console.log(response.docs)        // Post[]
console.log(response.totalDocs)   // 100
console.log(response.hasNextPage) // true

interface PayloadMutationResponse<T> {
  message: string
  doc: T
  errors?: unknown[]
}

const response = await client.from('posts').create({ title: 'New Post', slug: 'new-post' })
// response: PayloadMutationResponse<Post>

console.log(response.doc)     // Post
console.log(response.message) // "Post created successfully"

const post = await client.from('posts').findById('id')
// post: Post

const deleted = await client.from('posts').remove('id')
// deleted: Post

const result = await client.from('posts').count({
  where: { status: { equals: 'active' } }
})
// result: { totalDocs: number }

{
  "errors": [
    {
      "message": "Validation failed",
      "name": "ValidationError",
      "data": {
        "field": "email",
        "message": "Email is required"
      }
    }
  ]
}