Tree API ServerSide DataProvider

// --- Client Side (Vue) ---
import { CAPITreeServerDataProvider } from '@katlux/providers/data'

const provider = new CAPITreeServerDataProvider({
    cacheStrategy: 'Memory',
    cacheLifetime: 30000
})

await provider.setAPIUrl('/api/v1/taxonomy')

// --- Server Side (Nuxt Nitro) ---
// server/api/v1/taxonomy.get.ts
export default defineEventHandler(async (event) => {
    const query = getQuery(event)

    // The provider automatically sends these parameters as URL query strings:
    //   pageNumber       — number string — current page (e.g. "1"), parse with parseInt
    //   pageSize         — number string — items per page (e.g. "10"), parse with parseInt
    //   sortList         — IDataSort[] serialized as JSON string — deserialize with JSON.parse
    //   filter           — IDataFilter serialized as JSON string — deserialize with JSON.parse
    //   expandedNodes    — (string | number)[] serialized as JSON string — deserialize with JSON.parse
    //   parentKey        — string — field name for parent reference (e.g. "parentId")
    //   idKey            — string — field name for unique node ID (e.g. "id")
    //   paginateBy       — TreePaginationMode string — "all" or "root"
    //   expandedByDefault — boolean string — "true" or "false", compare with === 'true'
    const pageNumber        = parseInt(query.pageNumber as string) || 1
    const pageSize          = parseInt(query.pageSize   as string) || 10
    const sortList          = query.sortList       ? JSON.parse(query.sortList       as string) : []
    const filter            = query.filter         ? JSON.parse(query.filter         as string) : null
    const expandedNodes     = query.expandedNodes  ? JSON.parse(query.expandedNodes  as string) : []
    const parentKey         = (query.parentKey     as string) ?? 'parentId'
    const idKey             = (query.idKey         as string) ?? 'id'
    const paginateBy        = (query.paginateBy    as string) ?? 'all'
    const expandedByDefault = query.expandedByDefault === 'true'

    // Apply the parameters to your database / ORM layer
    const { rows, count } = await fetchNestedTaxonomy(expandedNodes, pageNumber, pageSize)

    // Return shape must be: { rows: Array<any>, rowCount: number }
    // rows: flat array of root nodes + children of expanded nodes only
    return {
        rows: rows,
        rowCount: count
    }
})