json-rest-api 1.0.29 → 2.0.0

package/tests/fixtures/api-configs.js

@@ -1,2566 +0,0 @@
-import { Api } from 'hooked-api'
-import {
-  AutoFilterPlugin,
-  FileHandlingPlugin,
-  QueryProjectionsPlugin,
-  RestApiAnyapiKnexPlugin,
-  RestApiKnexPlugin,
-  RestApiPlugin,
-  RowPolicyPlugin,
-  SocketIOPlugin
-} from '../../index.js'
-import { ExpressPlugin } from '../../plugins/core/connectors/express-plugin.js'
-import express from 'express'
-import { createServer } from 'http'
-import { ensureAnyApiSchema } from '../../plugins/core/lib/anyapi/schema-utils.js'
-import { storageMode } from '../helpers/storage-mode.js'
-
-async function resetAnyApiTables (knex) {
-  if (!storageMode.isAnyApi()) return
-  await knex('any_links').delete().catch(() => {})
-  await knex('any_records').delete().catch(() => {})
-  await knex('any_relationship_configs').delete().catch(() => {})
-  await knex('any_field_configs').delete().catch(() => {})
-  await knex('any_resource_configs').delete().catch(() => {})
-}
-
-async function useStoragePlugin (api, knex, { tenantId } = {}) {
-  if (storageMode.isAnyApi()) {
-    await ensureAnyApiSchema(knex)
-    const sanitizedName = api?.name ? api.name.replace(/[^A-Za-z0-9]+/g, '_').toLowerCase() : 'tenant'
-    const effectiveTenantId = tenantId || api?.anyapi?.tenantId || `${sanitizedName}_tenant`
-    api.anyapi = api.anyapi || {}
-    api.anyapi.tenantId = effectiveTenantId
-    await api.use(RestApiAnyapiKnexPlugin, { knex, tenantId: effectiveTenantId })
-    storageMode.setCurrentTenant(effectiveTenantId)
-  } else {
-    await api.use(RestApiKnexPlugin, { knex })
-  }
-}
-
-function mapTable (tableName, resourceName) {
-  if (storageMode.isAnyApi()) {
-    storageMode.registerTable(tableName, resourceName)
-  }
-}
-
-async function withTenantContext (tenantId, fn) {
-  if (!storageMode.isAnyApi()) {
-    return await fn()
-  }
-
-  const previousTenant = storageMode.currentTenant
-  storageMode.setCurrentTenant(tenantId || storageMode.defaultTenant)
-  try {
-    return await fn()
-  } finally {
-    storageMode.setCurrentTenant(previousTenant)
-  }
-}
-
-export async function createTemporalBoundaryApi (knex) {
-  const api = new Api({ name: 'temporal-boundaries', log: { level: 'error' } })
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: { post: 'full', put: 'full', patch: 'full' },
-    queryDefaultLimit: 2,
-    queryMaxLimit: 3
-  })
-  await api.use(QueryProjectionsPlugin)
-  await useStoragePlugin(api, knex)
-  const producedAt = {
-    type: 'dateTime', temporalPrecision: 0, computed: true,
-    compute: () => new Date('2026-09-08T01:02:03.456Z')
-  }
-  await api.addResource('people', {
-    schema: { id: { type: 'id' }, name: { type: 'string' }, producedAt },
-    relationships: { events: { type: 'hasMany', target: 'events', foreignKey: 'personId' } },
-    tableName: 'temporal_people'
-  })
-  await api.resources.people.createKnexTable()
-  mapTable('temporal_people', 'people')
-  await api.addResource('events', {
-    sortableFields: ['id', 'name', 'occurredAt', 'day', 'atTime', 'observedAtMs'],
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true },
-      occurredAt: { type: 'dateTime', temporalPrecision: 6, nullable: true, search: true },
-      day: { type: 'date', nullable: true, search: true },
-      atTime: { type: 'time', temporalPrecision: 3, nullable: true, search: true },
-      observedAtMs: { type: 'epochMilliseconds', nullable: true, search: true },
-      observedAtSeconds: { type: 'epochSeconds', nullable: true, search: true },
-      serializedAt: {
-        type: 'dateTime', temporalPrecision: 6, nullable: true, search: true,
-        storage: { serialize: value => value == null ? null : value.replace('T', ' ').replace(/Z$/, '') }
-      },
-      personId: { type: 'id', belongsTo: 'people', as: 'person', nullable: true },
-      subjectId: { type: 'number', nullable: true },
-      subjectType: { type: 'string', nullable: true },
-      producedAt
-    },
-    queryFields: {
-      projectedAt: {
-        type: 'dateTime', temporalPrecision: 3, sortable: true,
-        select: ({ knex, column }) => knex.raw('??', [column('occurredAt')])
-      }
-    },
-    relationships: {
-      subject: { belongsToPolymorphic: { types: ['people'], typeField: 'subjectType', idField: 'subjectId' } }
-    },
-    tableName: 'temporal_events'
-  })
-  await api.resources.events.createKnexTable()
-  mapTable('temporal_events', 'events')
-  return api
-}
-
-/**
- * Creates a basic API configuration with Countries, Publishers, Authors, Books
- */
-export async function createBasicApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'basic-test-api'
-  const tablePrefix = pluginOptions.tablePrefix || 'basic'
-  if (storageMode.isAnyApi()) {
-    storageMode.clearRegistry()
-  }
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const previousTenant = storageMode.currentTenant
-  const tenantId = storageMode.isAnyApi()
-    ? (pluginOptions.tenantId || `${tablePrefix}_tenant`)
-    : storageMode.defaultTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  const restApiOptions = {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,  // Need to return record to get ID for tests
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',  // Tests expect full JSON:API response
-      put: 'no',
-      patch: 'minimal'  // Tests expect minimal response with ID
-    },
-    sortableFields: ['id', 'title', 'country_id', 'publisher_id', 'name', 'code'],
-    ...pluginOptions['rest-api']  // Merge any custom options for rest-api plugin
-  }
-
-  await api.use(RestApiPlugin, restApiOptions)
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  // Add Express plugin if requested
-  if (pluginOptions.includeExpress) {
-    await api.use(ExpressPlugin, {
-      mountPath: '/api',  // Default mount path for tests
-      ...(pluginOptions.express || {})
-    })
-  }
-
-  try {
-  // Countries table
-    await api.addResource('countries', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 100, search: true },
-        code: { type: 'string', max: 2, unique: true }
-      },
-      relationships: {
-        publishers: { type: 'hasMany', target: 'publishers', foreignKey: 'country_id' },
-        books: { type: 'hasMany', target: 'books', foreignKey: 'country_id' }
-      },
-      tableName: `${tablePrefix}_countries`
-    })
-    await api.resources.countries.createKnexTable()
-    mapTable(`${tablePrefix}_countries`, 'countries')
-
-    // Publishers table
-    await api.addResource('publishers', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        country_id: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' }
-      },
-      relationships: {
-        books: { type: 'hasMany', target: 'books', foreignKey: 'publisher_id' },
-        authors: { type: 'hasMany', target: 'authors', foreignKey: 'publisher_id' }
-      },
-      tableName: `${tablePrefix}_publishers`
-    })
-    await api.resources.publishers.createKnexTable()
-    mapTable(`${tablePrefix}_publishers`, 'publishers')
-
-    // Authors table
-    await api.addResource('authors', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        publisher_id: { type: 'number', nullable: true, belongsTo: 'publishers', as: 'publisher' }
-      },
-      relationships: {
-        books: { type: 'manyToMany', through: 'book_authors', foreignKey: 'author_id', otherKey: 'book_id' }
-      },
-      tableName: `${tablePrefix}_authors`
-    })
-    await api.resources.authors.createKnexTable()
-    mapTable(`${tablePrefix}_authors`, 'authors')
-
-    // Books table
-    await api.addResource('books', {
-      schema: {
-        id: { type: 'id' },
-        title: { type: 'string', required: true, max: 300, search: true },
-        country_id: { type: 'number', required: true, belongsTo: 'countries', as: 'country', search: true },
-        publisher_id: { type: 'number', belongsTo: 'publishers', as: 'publisher', search: true }
-      },
-      relationships: {
-        authors: { type: 'manyToMany', through: 'book_authors', foreignKey: 'book_id', otherKey: 'author_id' }
-      },
-      tableName: `${tablePrefix}_books`
-    })
-    await api.resources.books.createKnexTable()
-    mapTable(`${tablePrefix}_books`, 'books')
-
-    // Book-Authors pivot table
-    await api.addResource('book_authors', {
-      schema: {
-        id: { type: 'id' },
-        book_id: { type: 'number', required: true, belongsTo: 'books', as: 'book' },
-        author_id: { type: 'number', required: true, belongsTo: 'authors', as: 'author' }
-      },
-      tableName: `${tablePrefix}_book_authors`
-    })
-    await api.resources.book_authors.createKnexTable()
-    mapTable(`${tablePrefix}_book_authors`, 'book_authors')
-    if (storageMode.isAnyApi()) {
-      const descriptorTenant = api.anyapi?.tenantId || tenantId
-      const booksDescriptor = await api.anyapi.registry.getDescriptor(descriptorTenant, 'books')
-      const authorsDescriptor = await api.anyapi.registry.getDescriptor(descriptorTenant, 'authors')
-      const relationshipKey = booksDescriptor?.manyToMany?.authors?.relationship
-      const inverseRelationshipKey = authorsDescriptor?.manyToMany?.books?.relationship
-      storageMode.registerLink(
-      `${tablePrefix}_book_authors`,
-      'books',
-      'authors',
-      relationshipKey,
-      inverseRelationshipKey
-      )
-    }
-
-    return api
-  } finally {
-    if (storageMode.isAnyApi()) {
-      storageMode.setCurrentTenant(previousTenant)
-    }
-  }
-}
-
-export async function createReturnRecordApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'return-record-test-api'
-  const tablePrefix = pluginOptions.tablePrefix || 'return'
-  if (storageMode.isAnyApi()) {
-    storageMode.clearRegistry()
-  }
-
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const previousTenant = storageMode.currentTenant
-  const tenantId = storageMode.isAnyApi()
-    ? (pluginOptions.tenantId || `${tablePrefix}_tenant`)
-    : storageMode.defaultTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: false,
-      put: true,
-      patch: 'minimal'
-    },
-    sortableFields: ['id', 'name'],
-    ...pluginOptions['rest-api']
-  })
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  try {
-    await api.addResource('global_items', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 100 }
-      },
-      tableName: `${tablePrefix}_global_items`
-    })
-    await api.resources.global_items.createKnexTable()
-    mapTable(`${tablePrefix}_global_items`, 'global_items')
-
-    await api.addResource('scope_items', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 100 }
-      },
-      tableName: `${tablePrefix}_scope_items`,
-      returnRecordApi: {
-        post: false,
-        put: true,
-        patch: 'minimal'
-      },
-      returnRecordTransport: true
-    })
-    await api.resources.scope_items.createKnexTable()
-    mapTable(`${tablePrefix}_scope_items`, 'scope_items')
-  } finally {
-    if (storageMode.isAnyApi()) {
-      storageMode.setCurrentTenant(previousTenant)
-    }
-  }
-
-  return api
-}
-
-/**
- * Creates a small API that uses logical camelCase belongsTo fields with default snake_case storage mapping.
- * This reproduces the full JSON:API linkage path where storage column names differ from logical field names.
- */
-export async function createCamelCaseBelongsToApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'camelcase-belongsto-test-api'
-  const tablePrefix = pluginOptions.tablePrefix || 'camel_fk'
-
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'full'
-    },
-    ...(pluginOptions['rest-api'] || {})
-  })
-
-  await api.use(RestApiKnexPlugin, { knex })
-
-  await api.addResource('countries', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 100 }
-    },
-    tableName: `${tablePrefix}_countries`
-  })
-  await api.resources.countries.createKnexTable()
-
-  await api.addResource('publishers', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 200 },
-      countryId: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' }
-    },
-    tableName: `${tablePrefix}_publishers`
-  })
-  await api.resources.publishers.createKnexTable()
-
-  return api
-}
-
-export async function createRelationshipIncludeStorageAdapterApi (knex) {
-  const api = new Api({
-    name: 'relationship-include-storage-adapter-test',
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false
-  })
-  await api.use(RestApiKnexPlugin, { knex })
-
-  await knex.schema.createTable('uninitialized_pets', table => {
-    table.increments('id').primary()
-    table.string('first_name').notNullable()
-    table.string('last_name').notNullable()
-  })
-  await knex.schema.createTable('uninitialized_bookings', table => {
-    table.increments('id').primary()
-    table.string('reference').notNullable()
-    table.integer('pet_id').notNullable()
-  })
-
-  await api.addResource('pets', {
-    schema: {
-      id: { type: 'id' },
-      firstName: { type: 'string', required: true },
-      lastName: { type: 'string', required: true }
-    },
-    tableName: 'uninitialized_pets'
-  })
-
-  await api.addResource('bookings', {
-    schema: {
-      id: { type: 'id' },
-      reference: { type: 'string', required: true },
-      petId: {
-        type: 'id',
-        required: true,
-        belongsTo: 'pets',
-        as: 'pet'
-      }
-    },
-    tableName: 'uninitialized_bookings'
-  })
-
-  return api
-}
-
-export async function seedRelationshipIncludeStorageAdapterApi (knex) {
-  await knex('uninitialized_pets').insert({
-    id: 7,
-    first_name: 'Coco',
-    last_name: 'Spaniel'
-  })
-  await knex('uninitialized_bookings').insert({
-    id: 41,
-    reference: 'BOOK-41',
-    pet_id: 7
-  })
-}
-
-/**
- * Creates a small API focused on resource ID normalization behavior.
- */
-export async function createIdNormalizationApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'id-normalization-test-api'
-  const tablePrefix = pluginOptions.tablePrefix || 'id_norm'
-  if (storageMode.isAnyApi()) {
-    storageMode.clearRegistry()
-  }
-
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const previousTenant = storageMode.currentTenant
-  const tenantId = storageMode.isAnyApi()
-    ? (pluginOptions.tenantId || `${tablePrefix}_tenant`)
-    : storageMode.defaultTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'minimal'
-    },
-    ...(pluginOptions['rest-api'] || {})
-  })
-
-  try {
-    await withTenantContext(tenantId, async () => {
-      await useStoragePlugin(api, knex, { tenantId })
-      await resetAnyApiTables(knex)
-
-      await api.addResource('countries', {
-        schema: {
-          id: { type: 'string', required: true },
-          name: { type: 'string', required: true, max: 100 }
-        },
-        tableName: `${tablePrefix}_countries`,
-        ...(pluginOptions.countryResourceOptions || {})
-      })
-      await knex.schema.dropTableIfExists(`${tablePrefix}_countries`)
-      await knex.schema.createTable(`${tablePrefix}_countries`, (table) => {
-        table.string('id').primary()
-        table.string('name').notNullable()
-      })
-      mapTable(`${tablePrefix}_countries`, 'countries')
-
-      await api.addResource('publishers', {
-        schema: {
-          id: { type: 'string', required: true },
-          name: { type: 'string', required: true, max: 100 },
-          country_id: { type: 'string', nullable: true, belongsTo: 'countries', as: 'country' }
-        },
-        relationships: {
-          tags: { type: 'manyToMany', through: 'publisher_tags', foreignKey: 'publisher_id', otherKey: 'tag_id' }
-        },
-        tableName: `${tablePrefix}_publishers`,
-        ...(pluginOptions.publisherResourceOptions || {})
-      })
-      await knex.schema.dropTableIfExists(`${tablePrefix}_publishers`)
-      await knex.schema.createTable(`${tablePrefix}_publishers`, (table) => {
-        table.string('id').primary()
-        table.string('name').notNullable()
-        table.string('country_id').nullable()
-      })
-      mapTable(`${tablePrefix}_publishers`, 'publishers')
-
-      await api.addResource('tags', {
-        schema: {
-          id: { type: 'string', required: true },
-          name: { type: 'string', required: true, max: 100 }
-        },
-        tableName: `${tablePrefix}_tags`,
-        ...(pluginOptions.tagResourceOptions || {})
-      })
-      await knex.schema.dropTableIfExists(`${tablePrefix}_tags`)
-      await knex.schema.createTable(`${tablePrefix}_tags`, (table) => {
-        table.string('id').primary()
-        table.string('name').notNullable()
-      })
-      mapTable(`${tablePrefix}_tags`, 'tags')
-
-      await api.addResource('publisher_tags', {
-        schema: {
-          id: { type: 'id' },
-          publisher_id: { type: 'string', required: true, belongsTo: 'publishers', as: 'publisher' },
-          tag_id: { type: 'string', required: true, belongsTo: 'tags', as: 'tag' }
-        },
-        tableName: `${tablePrefix}_publisher_tags`
-      })
-      await knex.schema.dropTableIfExists(`${tablePrefix}_publisher_tags`)
-      await knex.schema.createTable(`${tablePrefix}_publisher_tags`, (table) => {
-        table.increments('id').primary()
-        table.string('publisher_id').notNullable()
-        table.string('tag_id').notNullable()
-      })
-      mapTable(`${tablePrefix}_publisher_tags`, 'publisher_tags')
-      if (storageMode.isAnyApi()) {
-        const descriptorTenant = api.anyapi?.tenantId || tenantId
-        const publishersDescriptor = await api.anyapi.registry.getDescriptor(descriptorTenant, 'publishers')
-        const tagsDescriptor = await api.anyapi.registry.getDescriptor(descriptorTenant, 'tags')
-        const relationshipKey = publishersDescriptor?.manyToMany?.tags?.relationship
-        const inverseRelationshipKey = tagsDescriptor?.manyToMany?.publishers?.relationship
-        storageMode.registerLink(
-          `${tablePrefix}_publisher_tags`,
-          'publishers',
-          'tags',
-          relationshipKey,
-          inverseRelationshipKey
-        )
-      }
-    })
-
-    return api
-  } finally {
-    if (storageMode.isAnyApi()) {
-      storageMode.setCurrentTenant(previousTenant)
-    }
-  }
-}
-
-/**
- * Creates a basic API with bulk operations enabled
- */
-export async function createBulkOperationsApi (knex, pluginOptions = {}) {
-  const { BulkOperationsPlugin } = await import('../../plugins/core/bulk-operations-plugin.js')
-
-  const api = await createBasicApi(knex, {
-    ...pluginOptions,
-    tenantId: pluginOptions.tenantId || 'bulk_ops_tenant'
-  })
-
-  // Add bulk operations plugin
-  await api.use(BulkOperationsPlugin, {
-    'bulk-operations': {
-      maxBulkOperations: 100,
-      defaultAtomic: true,
-      batchSize: 10,
-      enableOptimizations: true,
-      ...pluginOptions['bulk-operations']
-    }
-  })
-
-  return api
-}
-
-/**
- * Creates an extended API with additional fields for more complex testing
- */
-export async function createExtendedApi (knex) {
-  const api = new Api({
-    name: 'extended-test-api',
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'extended_tenant' : storageMode.defaultTenant
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,  // Need to return record to get ID for tests
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',  // Tests expect full JSON:API response
-      put: 'no',
-      patch: 'minimal'  // Tests expect minimal response with ID
-    },
-    sortableFields: ['id', 'title', 'country_id', 'publisher_id', 'price', 'language', 'population', 'name', 'code']
-  })
-  await withTenantContext(tenantId, async () => {
-    await useStoragePlugin(api, knex, { tenantId })
-    await resetAnyApiTables(knex)
-
-    // Countries with extended fields
-    await api.addResource('countries', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 100 },
-        code: { type: 'string', max: 2, unique: true },
-        capital: { type: 'string', max: 100 },
-        population: { type: 'number' },
-        currency: { type: 'string', max: 3 }
-      },
-      relationships: {
-        publishers: { type: 'hasMany', target: 'publishers', foreignKey: 'country_id' },
-        books: { type: 'hasMany', target: 'books', foreignKey: 'country_id' },
-        authors: { type: 'hasMany', target: 'authors', foreignKey: 'nationality_id' }
-      },
-      tableName: 'ext_countries'
-    })
-    await api.resources.countries.createKnexTable()
-    mapTable('ext_countries', 'countries')
-
-    // Publishers with extended fields
-    await api.addResource('publishers', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        country_id: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' },
-        founded_year: { type: 'number' },
-        website: { type: 'string', max: 255 },
-        active: { type: 'boolean', default: true }
-      },
-      relationships: {
-        books: { type: 'hasMany', target: 'books', foreignKey: 'publisher_id' },
-        reviews: {
-          type: 'hasMany',
-          target: 'reviews',
-          via: 'reviewable'
-        }
-      },
-      tableName: 'ext_publishers'
-    })
-    await api.resources.publishers.createKnexTable()
-    mapTable('ext_publishers', 'publishers')
-
-    // Authors with extended fields
-    await api.addResource('authors', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        birth_date: { type: 'date' },
-        biography: { type: 'string', max: 5000 },
-        nationality_id: { type: 'number', belongsTo: 'countries', as: 'nationality' }
-      },
-      relationships: {
-        books: { type: 'manyToMany', through: 'book_authors', foreignKey: 'author_id', otherKey: 'book_id' },
-        reviews: {
-          type: 'hasMany',
-          target: 'reviews',
-          via: 'reviewable'
-        }
-      },
-      tableName: 'ext_authors'
-    })
-    await api.resources.authors.createKnexTable()
-    mapTable('ext_authors', 'authors')
-
-    // Books with extended fields
-    await api.addResource('books', {
-      schema: {
-        id: { type: 'id' },
-        title: { type: 'string', required: true, max: 300, search: true },
-        isbn: { type: 'string', max: 13 },
-        pages: { type: 'number' },
-        price: { type: 'number', search: true }, // Store price as string for decimal precision
-        published_date: { type: 'date' },
-        language: { type: 'string', max: 2, default: 'en', search: true },
-        country_id: { type: 'number', required: true, belongsTo: 'countries', as: 'country', search: true },
-        publisher_id: { type: 'number', belongsTo: 'publishers', as: 'publisher', search: true }
-      },
-      relationships: {
-        authors: { type: 'manyToMany', through: 'book_authors', foreignKey: 'book_id', otherKey: 'author_id' },
-        reviews: {
-          type: 'hasMany',
-          target: 'reviews',
-          via: 'reviewable'
-        }
-      },
-      tableName: 'ext_books'
-    })
-    await api.resources.books.createKnexTable()
-    mapTable('ext_books', 'books')
-
-    // Book-Authors pivot with extended fields
-    await api.addResource('book_authors', {
-      schema: {
-        id: { type: 'id' },
-        book_id: { type: 'number', required: true, belongsTo: 'books', as: 'book' },
-        author_id: { type: 'number', required: true, belongsTo: 'authors', as: 'author' },
-        contribution_type: { type: 'string', max: 50 },
-        order: { type: 'number' }
-      },
-      tableName: 'ext_book_authors'
-    })
-    await api.resources.book_authors.createKnexTable()
-    mapTable('ext_book_authors', 'book_authors')
-    if (storageMode.isAnyApi()) {
-      const booksDescriptor = await api.anyapi.registry.getDescriptor(tenantId, 'books')
-      const authorsDescriptor = await api.anyapi.registry.getDescriptor(tenantId, 'authors')
-      const relationshipKey = booksDescriptor?.manyToMany?.authors?.relationship
-      const inverseRelationshipKey = authorsDescriptor?.manyToMany?.books?.relationship
-      storageMode.registerLink('ext_book_authors', 'books', 'authors', relationshipKey, inverseRelationshipKey)
-    }
-
-    // Polymorphic reviews (can go on authors, books and publishers)
-    await api.addResource('reviews', {
-      schema: {
-        id: { type: 'id' },
-        rating: { type: 'number', required: true, min: 1, max: 5 },
-        title: { type: 'string', max: 200 },
-        content: { type: 'string', required: true, max: 5000 },
-        reviewer_name: { type: 'string', required: true, max: 100 },
-        review_date: { type: 'dateTime', temporalPrecision: 3, defaultTo: () => new Date().toISOString() },
-        helpful_count: { type: 'number', default: 0 },
-        reviewable_type: { type: 'string', required: true },
-        reviewable_id: { type: 'number', required: true }
-      },
-      relationships: {
-        reviewable: {
-          belongsToPolymorphic: {
-            types: ['books', 'authors', 'publishers'],
-            typeField: 'reviewable_type',
-            idField: 'reviewable_id'
-          }
-        }
-      },
-      tableName: 'ext_reviews'
-    })
-    await api.resources.reviews.createKnexTable()
-    mapTable('ext_reviews', 'reviews')
-  })
-
-  return api
-}
-
-/**
- * Creates an API with limited include depth for testing depth validation
- * Uses 'limited_' prefix for all tables to avoid conflicts
- */
-export async function createLimitedDepthApi (knex) {
-  const api = new Api({
-    name: 'limited-depth-api',
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'limited_depth_tenant' : storageMode.defaultTenant
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'minimal'
-    },
-    sortableFields: ['id', 'title', 'country_id', 'publisher_id', 'name', 'code'],
-    includeDepthLimit: 2  // Key difference: limit is 2 instead of default 3
-  })
-  await withTenantContext(tenantId, async () => {
-    await useStoragePlugin(api, knex, { tenantId })
-
-    // Use different table names with 'limited_' prefix to avoid conflicts
-    await api.addResource('countries', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 100 },
-        code: { type: 'string', max: 2, unique: true }
-      },
-      relationships: {
-        publishers: { type: 'hasMany', target: 'publishers', foreignKey: 'country_id' },
-        books: { type: 'hasMany', target: 'books', foreignKey: 'country_id' }
-      },
-      tableName: 'limited_countries',
-    })
-    await api.resources.countries.createKnexTable()
-    mapTable('limited_countries', 'countries')
-
-    await api.addResource('publishers', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        country_id: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' }
-      },
-      relationships: {
-        books: { type: 'hasMany', target: 'books', foreignKey: 'publisher_id' },
-        authors: { type: 'hasMany', target: 'authors', foreignKey: 'publisher_id' }
-      },
-      tableName: 'limited_publishers'
-    })
-    await api.resources.publishers.createKnexTable()
-    mapTable('limited_publishers', 'publishers')
-
-    await api.addResource('authors', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        publisher_id: { type: 'number', nullable: true, belongsTo: 'publishers', as: 'publisher' }
-      },
-      relationships: {
-        books: { type: 'manyToMany', through: 'book_authors', foreignKey: 'author_id', otherKey: 'book_id' }
-      },
-      tableName: 'limited_authors'
-    })
-    await api.resources.authors.createKnexTable()
-
-    await api.addResource('books', {
-      schema: {
-        id: { type: 'id' },
-        title: { type: 'string', required: true, max: 300, search: true },
-        country_id: { type: 'number', required: true, belongsTo: 'countries', as: 'country', search: true },
-        publisher_id: { type: 'number', belongsTo: 'publishers', as: 'publisher', search: true }
-      },
-      relationships: {
-        authors: { type: 'manyToMany', through: 'book_authors', foreignKey: 'book_id', otherKey: 'author_id' }
-      },
-      tableName: 'limited_books'
-    })
-    await api.resources.books.createKnexTable()
-
-    await api.addResource('book_authors', {
-      schema: {
-        id: { type: 'id' },
-        book_id: { type: 'number', required: true, belongsTo: 'books', as: 'book' },
-        author_id: { type: 'number', required: true, belongsTo: 'authors', as: 'author' }
-      },
-      tableName: 'limited_book_authors'
-    })
-    await api.resources.book_authors.createKnexTable()
-    mapTable('limited_book_authors', 'book_authors')
-    if (storageMode.isAnyApi()) {
-      const booksDescriptor = await api.anyapi.registry.getDescriptor(tenantId, 'books')
-      const authorsDescriptor = await api.anyapi.registry.getDescriptor(tenantId, 'authors')
-      const relationshipKey = booksDescriptor?.manyToMany?.authors?.relationship
-      const inverseRelationshipKey = authorsDescriptor?.manyToMany?.books?.relationship
-      storageMode.registerLink('limited_book_authors', 'books', 'authors', relationshipKey, inverseRelationshipKey)
-    }
-  })
-
-  return api
-}
-
-/**
- * Creates an API configuration for pagination testing
- */
-export async function createPaginationApi (knex, options = {}) {
-  const api = new Api({
-    name: 'pagination-test-api',
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'pagination_tenant' : storageMode.defaultTenant
-
-  const restApiOptions = {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'minimal'
-    },
-    sortableFields: ['id', 'title', 'country_id', 'publisher_id', 'name', 'code'],
-    ...options  // Allow overriding options likereturnBasePath, enablePaginationCounts
-  }
-
-  await api.use(RestApiPlugin, restApiOptions)
-  await withTenantContext(tenantId, async () => {
-    await useStoragePlugin(api, knex, { tenantId })
-
-    // Countries table
-    await api.addResource('countries', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 100 },
-        code: { type: 'string', max: 2, unique: true }
-      },
-      relationships: {
-        publishers: { type: 'hasMany', target: 'publishers', foreignKey: 'country_id' },
-        books: { type: 'hasMany', target: 'books', foreignKey: 'country_id' }
-      },
-      tableName: 'pagination_countries'
-    })
-    await api.resources.countries.createKnexTable()
-    mapTable('pagination_countries', 'countries')
-
-    // Publishers table
-    await api.addResource('publishers', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 200 },
-        country_id: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' }
-      },
-      relationships: {
-        books: { type: 'hasMany', target: 'books', foreignKey: 'publisher_id' }
-      },
-      tableName: 'pagination_publishers'
-    })
-    await api.resources.publishers.createKnexTable()
-    mapTable('pagination_publishers', 'publishers')
-
-    // Books table
-    await api.addResource('books', {
-      schema: {
-        id: { type: 'id' },
-        title: { type: 'string', required: true, max: 300, search: true },
-        country_id: { type: 'number', required: true, belongsTo: 'countries', as: 'country', search: true },
-        publisher_id: { type: 'number', belongsTo: 'publishers', as: 'publisher', search: true }
-      },
-      tableName: 'pagination_books'
-    })
-    await api.resources.books.createKnexTable()
-    mapTable('pagination_books', 'books')
-  })
-
-  return api
-}
-
-/**
- * Creates an API with WebSocket/Socket.IO support for testing
- */
-export async function createWebSocketApi (knex, pluginOptions = {}) {
-  const { jwtVerify } = await import('jose')
-
-  const api = await createBasicApi(knex, {
-    ...pluginOptions,
-    tenantId: pluginOptions.tenantId || 'socketio_tenant',
-    includeExpress: true,
-    express: {
-      port: 0 // Let OS assign a port
-    }
-  })
-
-  const socketioOptions = { ...(pluginOptions['socketio'] || {}) }
-  const authOptions = { ...(socketioOptions.auth || {}) }
-  const sharedSecret = authOptions.sharedSecret || socketioOptions.sharedSecret || 'test-secret-key'
-
-  if (!authOptions.authenticate) {
-    authOptions.authenticate = async ({ socket }) => {
-      const token = socket.handshake.auth?.token
-      if (!token) {
-        throw new Error('Authentication required')
-      }
-
-      const encoder = new TextEncoder()
-      const key = encoder.encode(sharedSecret)
-      const { payload } = await jwtVerify(token, key)
-
-      const roles = Array.isArray(payload.roles)
-        ? payload.roles
-        : payload.role ? [payload.role] : []
-
-      const authContext = {
-        userId: payload.userId || payload.sub,
-        roles,
-        token: payload
-      }
-
-      if (!authContext.userId) {
-        throw new Error('Token is missing required user identifier')
-      }
-
-      return authContext
-    }
-  }
-
-  if (authOptions.requireAuth === undefined) {
-    authOptions.requireAuth = true
-  }
-
-  socketioOptions.auth = authOptions
-
-  await api.use(SocketIOPlugin, socketioOptions)
-
-  // Create and start Express server
-  const app = express()
-  api.http.express.app = app
-
-  // Mount the API routes
-  app.use('/api', api.http.express.router)
-
-  // Create HTTP server
-  const server = createServer(app)
-
-  // Start Socket.IO server
-  await api.startSocketServer(server)
-
-  // Start listening
-  await new Promise((resolve) => {
-    server.listen(0, () => {
-      resolve()
-    })
-  })
-
-  return { api, server }
-}
-
-/**
- * Creates an API with computed fields for testing
- */
-export async function createComputedFieldsApi (knex, pluginOptions = {}) {
-  const api = new Api({
-    name: 'computed-fields-test-api',
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'computed_fields_tenant' : storageMode.defaultTenant
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: true,
-    simplifiedTransport: true
-  })
-
-  await withTenantContext(tenantId, async () => {
-    await useStoragePlugin(api, knex, { tenantId })
-    await resetAnyApiTables(knex)
-
-    // Products resource with computed fields
-    await api.addResource('products', {
-      schema: {
-        id: { type: 'id' },
-        name: { type: 'string', required: true, max: 255 },
-        price: { type: 'number', required: true, min: 0 },
-        cost: { type: 'number', required: true, min: 0, normallyHidden: true },
-        internal_notes: { type: 'string', normallyHidden: true },
-        profit_margin: {
-          type: 'number',
-          computed: true,
-          dependencies: ['price', 'cost'],
-          compute: ({ attributes }) => {
-            if (!attributes.price || attributes.price === 0) return 0
-            return Number(((attributes.price - attributes.cost) / attributes.price * 100).toFixed(2))
-          }
-        },
-        profit_amount: {
-          type: 'number',
-          computed: true,
-          dependencies: ['price', 'cost'],
-          compute: ({ attributes }) => {
-            return Number((attributes.price - attributes.cost).toFixed(2))
-          }
-        },
-        calculated_at: {
-          type: 'dateTime',
-          temporalPrecision: 0,
-          computed: true,
-          compute: () => new Date('2026-08-25T23:45:01.987Z')
-        },
-        calculated_time: {
-          type: 'time',
-          temporalPrecision: 3,
-          computed: true,
-          compute: () => new Date('2026-08-25T23:45:01.987Z')
-        }
-      },
-      relationships: {
-        reviews: { type: 'hasMany', target: 'reviews', foreignKey: 'product_id' }
-      },
-      tableName: 'test_products'
-    })
-    await api.resources.products.createKnexTable()
-    mapTable('searchmerge_products', 'products')
-    mapTable('test_products', 'products')
-
-    // Reviews resource with computed fields
-    await api.addResource('reviews', {
-      schema: {
-        id: { type: 'id' },
-        product_id: { type: 'number', required: true, belongsTo: 'products', as: 'product' },
-        reviewer_name: { type: 'string', required: true },
-        rating: { type: 'number', required: true, min: 1, max: 5 },
-        comment: { type: 'string', max: 1000 },
-        helpful_votes: { type: 'number', default: 0 },
-        total_votes: { type: 'number', default: 0 },
-        spam_score: { type: 'number', default: 0, normallyHidden: true },
-        helpfulness_score: {
-          type: 'number',
-          computed: true,
-          dependencies: ['helpful_votes', 'total_votes'],
-          compute: ({ attributes }) => {
-            if (attributes.total_votes === 0) return null
-            return Number(((attributes.helpful_votes / attributes.total_votes) * 100).toFixed(0))
-          }
-        },
-        is_helpful: {
-          type: 'boolean',
-          computed: true,
-          dependencies: ['helpful_votes', 'total_votes', 'spam_score'],
-          compute: ({ attributes }) => {
-            if (attributes.total_votes < 10) return null
-            const helpfulnessScore = (attributes.helpful_votes / attributes.total_votes) * 100
-            return helpfulnessScore > 70 && attributes.spam_score < 0.5
-          }
-        },
-        calculated_at: {
-          type: 'dateTime',
-          temporalPrecision: 0,
-          computed: true,
-          compute: () => new Date('2026-08-25T23:46:02.654Z')
-        }
-      },
-      tableName: 'test_reviews'
-    })
-    await api.resources.reviews.createKnexTable()
-    mapTable('test_reviews', 'reviews')
-  })
-
-  return api
-}
-
-/**
- * Creates an API with field getters for testing
- */
-export async function createFieldGettersApi (knex, pluginOptions = {}) {
-  const api = new Api({
-    name: 'field-getters-test-api',
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'field_getters_tenant' : storageMode.defaultTenant
-  const previousTenant = storageMode.currentTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: true,
-    simplifiedTransport: true
-  })
-
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  // Users resource with basic getters
-  await api.addResource('users', {
-    schema: {
-      id: { type: 'id' },
-      email: {
-        type: 'string',
-        nullable: true,
-        getter: (value) => value?.toLowerCase().trim()
-      },
-      name: {
-        type: 'string',
-        nullable: true,
-        getter: (value) => value?.trim()
-      },
-      phone: {
-        type: 'string',
-        nullable: true,
-        getter: (value) => {
-          if (!value) return null
-          // Remove all non-digits and format
-          const digits = value.replace(/\D/g, '')
-          if (digits.length === 10) {
-            return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`
-          }
-          return value
-        }
-      },
-      metadata_json: {
-        type: 'string',
-        nullable: true,
-        getter: (value) => {
-          if (!value) return {}
-          try {
-            return JSON.parse(value)
-          } catch {
-            return {}
-          }
-        }
-      },
-      tags_csv: {
-        type: 'string',
-        nullable: true,
-        getter: (value) => {
-          if (!value) return []
-          return value.split(',').map(t => t.trim()).filter(t => t)
-        }
-      }
-    },
-    tableName: 'getter_users'
-  })
-  await api.resources.users.createKnexTable()
-  mapTable('searchmerge_users', 'users')
-  mapTable('getter_users', 'users')
-
-  // Products resource with getters and computed fields
-  await api.addResource('products', {
-    schema: {
-      id: { type: 'id' },
-      name: {
-        type: 'string',
-        getter: (value) => value?.toUpperCase()
-      },
-      description: {
-        type: 'string',
-        getter: (value) => {
-          // Truncate long descriptions
-          if (!value) return ''
-          return value.length > 50 ? value.substring(0, 47) + '...' : value
-        }
-      },
-      price_str: {
-        type: 'string',
-        getter: (value) => parseFloat(value) || 0
-      },
-      tax_rate_str: {
-        type: 'string',
-        getter: (value) => parseFloat(value) || 0
-      },
-      total_price: {
-        type: 'number',
-        computed: true,
-        dependencies: ['price_str', 'tax_rate_str'],
-        compute: ({ attributes }) => {
-          // Should see numbers from getters, not strings
-          return attributes.price_str * (1 + attributes.tax_rate_str)
-        }
-      }
-    },
-    relationships: {
-      reviews: { type: 'hasMany', target: 'reviews', foreignKey: 'product_id' }
-    },
-    tableName: 'getter_products'
-  })
-  await api.resources.products.createKnexTable()
-  mapTable('getter_products', 'products')
-
-  // Reviews resource with getters
-  await api.addResource('reviews', {
-    schema: {
-      id: { type: 'id' },
-      product_id: { type: 'id', belongsTo: 'products', as: 'product' },
-      content: {
-        type: 'string',
-        getter: (value) => `[REVIEW] ${value}`
-      },
-      rating: { type: 'number' }
-    },
-    tableName: 'getter_reviews'
-  })
-  await api.resources.reviews.createKnexTable()
-  mapTable('getter_reviews', 'reviews')
-
-  // Resource with getter dependencies
-  await api.addResource('formatted_data', {
-    schema: {
-      id: { type: 'id' },
-      step1: {
-        type: 'string',
-        nullable: true,
-        getter: (value) => value?.trim()
-      },
-      step2: {
-        type: 'string',
-        nullable: true,
-        getter: (value, { attributes }) => {
-          if (!value) return value // Return null/undefined as-is
-          // Depends on step1 being trimmed first
-          return `${value} [step1: ${attributes.step1}]`
-        },
-        runGetterAfter: ['step1']
-      },
-      step3: {
-        type: 'string',
-        getter: (value, { attributes }) => {
-          if (!value) return value // Return null/undefined as-is
-          // Depends on step2
-          return `${value} [step2: ${attributes.step2}]`
-        },
-        runGetterAfter: ['step2']
-      }
-    },
-    tableName: 'getter_formatted'
-  })
-  await api.resources.formatted_data.createKnexTable()
-  mapTable('getter_formatted', 'formatted_data')
-
-  // Async getters example
-  await api.addResource('encrypted_data', {
-    schema: {
-      id: { type: 'id' },
-      secret: {
-        type: 'string',
-        nullable: true,
-        getter: async (value) => {
-          if (!value) return null
-          // Simulate async decryption
-          await new Promise(resolve => setTimeout(resolve, 5))
-          return Buffer.from(value, 'base64').toString()
-        }
-      },
-      data: {
-        type: 'string',
-        nullable: true,
-        getter: async (value, context) => {
-          if (!value) return null
-          await new Promise(resolve => setTimeout(resolve, 5))
-          const decrypted = Buffer.from(value, 'base64').toString()
-          return `[${context.scopeName}] ${decrypted}`
-        }
-      }
-    },
-    tableName: 'getter_encrypted'
-  })
-  await api.resources.encrypted_data.createKnexTable()
-  mapTable('getter_encrypted', 'encrypted_data')
-
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(previousTenant)
-  }
-
-  return api
-}
-
-export async function createProjectedFieldsApi (knex, pluginOptions = {}) {
-  const api = new Api({
-    name: 'projected-fields-test-api',
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'projected_fields_tenant' : storageMode.defaultTenant
-  const previousTenant = storageMode.currentTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'minimal'
-    },
-    sortableFields: ['id', 'first_name', 'last_name'],
-    ...pluginOptions['rest-api']
-  })
-  await api.use(QueryProjectionsPlugin)
-
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  await api.addResource('authors', {
-    schema: {
-      id: { type: 'id' },
-      first_name: { type: 'string', required: true, max: 100 },
-      last_name: { type: 'string', required: true, max: 100 }
-    },
-    queryFields: {
-      full_name: {
-        type: 'string',
-        sortable: true,
-        select: ({ knex, column }) => knex.raw(
-          "trim(coalesce(??, '') || ' ' || coalesce(??, ''))",
-          [column('first_name'), column('last_name')]
-        )
-      },
-      sort_name: {
-        type: 'string',
-        sortable: true,
-        normallyHidden: true,
-        select: ({ knex, column }) => knex.raw(
-          "trim(coalesce(??, '') || ' ' || coalesce(??, ''))",
-          [column('first_name'), column('last_name')]
-        )
-      }
-    },
-    relationships: {
-      books: { type: 'hasMany', target: 'books', foreignKey: 'author_id' }
-    },
-    sortableFields: ['id', 'first_name', 'last_name'],
-    defaultSort: ['full_name'],
-    tableName: 'projected_authors'
-  })
-  await api.resources.authors.createKnexTable()
-  mapTable('projected_authors', 'authors')
-
-  await api.addResource('books', {
-    schema: {
-      id: { type: 'id' },
-      title: { type: 'string', required: true, max: 200 },
-      author_id: { type: 'id', required: true, belongsTo: 'authors', as: 'author' }
-    },
-    tableName: 'projected_books'
-  })
-  await api.resources.books.createKnexTable()
-  mapTable('projected_books', 'books')
-
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(previousTenant)
-  }
-
-  return api
-}
-
-/**
- * Creates an API with field setters for testing
- */
-export async function createFieldSettersApi (knex, pluginOptions = {}) {
-  const api = new Api({
-    name: 'field-setters-test-api',
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'field_setters_tenant' : storageMode.defaultTenant
-  const previousTenant = storageMode.currentTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: true,
-    simplifiedTransport: true,
-    returnRecordApi: {
-      post: true,
-      put: true,
-      patch: true
-    }
-  })
-
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  // Users resource with basic setters
-  await api.addResource('users', {
-    schema: {
-      id: { type: 'id' },
-      email: {
-        type: 'string',
-        required: true,
-        setter: (value) => value?.toLowerCase().trim()
-      },
-      username: {
-        type: 'string',
-        required: true,
-        setter: (value) => value?.toLowerCase().replace(/\s+/g, '')
-      },
-      tags: {
-        type: 'string',  // Accepts string, stored as string
-        setter: (value) => value  // Pass through
-      },
-      preferences: {
-        type: 'string',  // Accepts string, stored as string
-        setter: (value) => value  // Pass through
-      }
-    },
-    tableName: 'setter_users'
-  })
-  await api.resources.users.createKnexTable()
-
-  // Products with type conversion setters
-  await api.addResource('products', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true },
-      price: {
-        type: 'number',
-        required: true,
-        min: 0,
-        setter: (value) => {
-          // Convert to cents and round
-          return Math.round(value * 100)
-        }
-      },
-      discount_percent: {
-        type: 'number',
-        min: 0,
-        max: 100,
-        setter: (value) => Math.round(value)
-      },
-      metadata: {
-        type: 'object',
-        setter: (value) => JSON.stringify(value || {})
-      }
-    },
-    tableName: 'setter_products'
-  })
-  await api.resources.products.createKnexTable()
-
-  // Secure data with async setters
-  await api.addResource('secure_data', {
-    schema: {
-      id: { type: 'id' },
-      password: {
-        type: 'string',
-        required: true,
-        min: 8,
-        setter: async (value) => {
-          // Simulate async password hashing
-          await new Promise(resolve => setTimeout(resolve, 5))
-          return `hashed:${value}`
-        }
-      },
-      api_key: {
-        type: 'string',
-        setter: async (value) => {
-          if (!value) return null
-          // Simulate encryption
-          await new Promise(resolve => setTimeout(resolve, 5))
-          return Buffer.from(value).toString('base64')
-        }
-      },
-      data: {
-        type: 'string',
-        setter: async (value) => {
-          if (!value) return null
-          return Buffer.from(value).toString('base64')
-        }
-      }
-    },
-    tableName: 'setter_secure'
-  })
-  await api.resources.secure_data.createKnexTable()
-
-  // Resource with setter dependencies
-  await api.addResource('computed_data', {
-    schema: {
-      id: { type: 'id' },
-      base_value: {
-        type: 'number',
-        setter: (value) => value || 0
-      },
-      multiplier: {
-        type: 'number',
-        setter: (value) => value || 1
-      },
-      adjustment: {
-        type: 'number',
-        setter: (value) => value || 0
-      },
-      calculated_value: {
-        type: 'number',
-        setter: (value, { attributes }) => {
-          // Calculate based on other fields
-          return (attributes.base_value || 0) * (attributes.multiplier || 1)
-        },
-        runSetterAfter: ['base_value', 'multiplier']
-      },
-      final_value: {
-        type: 'number',
-        setter: (value, { attributes }) => {
-          // Depends on calculated_value
-          return (attributes.calculated_value || 0) + (attributes.adjustment || 0)
-        },
-        runSetterAfter: ['calculated_value', 'adjustment']
-      }
-    },
-    tableName: 'setter_computed'
-  })
-  await api.resources.computed_data.createKnexTable()
-
-  // Nullable fields handling
-  await api.addResource('nullable_data', {
-    schema: {
-      id: { type: 'id' },
-      field1: {
-        type: 'string',
-        nullable: true,
-        setter: (value) => value === undefined ? null : value
-      },
-      field2: {
-        type: 'string',
-        nullable: true,
-        setter: (value) => value === undefined ? null : value
-      },
-      field3: {
-        type: 'string',
-        setter: (value) => value === '' ? 'empty' : value
-      },
-      field4: {
-        type: 'number',
-        setter: (value) => value === 0 ? -1 : value
-      }
-    },
-    tableName: 'setter_nullable'
-  })
-  await api.resources.nullable_data.createKnexTable()
-
-  // Validated data
-  await api.addResource('validated_data', {
-    schema: {
-      id: { type: 'id' },
-      email: {
-        type: 'string',
-        required: true,
-        format: 'email',
-        setter: (value) => value.toLowerCase().trim()
-      },
-      age: {
-        type: 'number',
-        min: 0,
-        max: 120,
-        setter: (value) => value // No transformation, just to verify it's a number
-      },
-      score: {
-        type: 'number',
-        min: 0,
-        max: 100,
-        setter: (value) => Math.ceil(value) // Round up
-      }
-    },
-    tableName: 'setter_validated'
-  })
-  await api.resources.validated_data.createKnexTable()
-
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(previousTenant)
-  }
-
-  return api
-}
-
-export async function createAutoFilterApi (knex, pluginOptions = {}) {
-  const { AutoFilterPlugin } = await import('../../plugins/core/rest-api-autofilter-plugin.js')
-
-  const api = new Api({
-    name: 'autofilter-test-api',
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'autofilter_tenant' : storageMode.defaultTenant
-  const previousTenant = storageMode.currentTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'minimal'
-    },
-    sortableFields: ['id', 'title', 'name', 'workspace_id', 'user_id']
-  })
-
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  // Add Express plugin if requested for transport testing
-  if (pluginOptions.includeExpress) {
-    await api.use(ExpressPlugin, pluginOptions.express || {})
-  }
-
-  const autofilterOptions = pluginOptions.autofilter || {}
-  const workspaceField = pluginOptions.workspaceField || 'workspace_id'
-  const userField = pluginOptions.userField || 'user_id'
-
-  await api.use(AutoFilterPlugin, {
-    ...autofilterOptions,
-    resolvers: {
-      workspace: ({ context }) => context.scopeValues?.workspaceId,
-      user: ({ context }) => context.scopeValues?.userId,
-      currentProject: ({ context }) => context.scopeValues?.projectId ?? null,
-      ...(autofilterOptions.resolvers || {})
-    },
-    presets: {
-      public: { filters: [] },
-      workspace: {
-        filters: [{ field: workspaceField, resolver: 'workspace' }]
-      },
-      user: {
-        filters: [{ field: userField, resolver: 'user' }]
-      },
-      workspace_user: {
-        filters: [
-          { field: workspaceField, resolver: 'workspace' },
-          { field: userField, resolver: 'user' }
-        ]
-      },
-      ...(autofilterOptions.presets || {})
-    }
-  })
-
-  await api.addResource('workspace_reports', {
-    schema: {
-      id: { type: 'id' },
-      title: { type: 'string', required: true, max: 200 },
-      workspace_id: { type: 'string', required: true }
-    },
-    autofilter: 'workspace',
-    tableName: 'autofilter_workspace_reports'
-  })
-  await api.resources.workspace_reports.createKnexTable()
-  mapTable('autofilter_workspace_reports', 'workspace_reports')
-
-  await api.addResource('user_notes', {
-    schema: {
-      id: { type: 'id' },
-      body: { type: 'string', required: true, max: 500 },
-      user_id: { type: 'number', required: true }
-    },
-    autofilter: 'user',
-    tableName: 'autofilter_user_notes'
-  })
-  await api.resources.user_notes.createKnexTable()
-  mapTable('autofilter_user_notes', 'user_notes')
-
-  await api.addResource('projects', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 200 },
-      description: { type: 'string', max: 1000 },
-      status: { type: 'string', defaultTo: 'active' },
-      workspace_id: { type: 'string', required: true },
-      user_id: { type: 'number', required: true }
-    },
-    relationships: {
-      tasks: { type: 'hasMany', target: 'tasks', foreignKey: 'project_id' }
-    },
-    autofilter: 'workspace_user',
-    tableName: 'autofilter_projects'
-  })
-  await api.resources.projects.createKnexTable()
-  mapTable('autofilter_projects', 'projects')
-
-  await api.addResource('tasks', {
-    schema: {
-      id: { type: 'id' },
-      title: { type: 'string', required: true, max: 200 },
-      completed: { type: 'boolean', defaultTo: false },
-      project_id: { type: 'number', belongsTo: 'projects', as: 'project' },
-      workspace_id: { type: 'string', required: true },
-      user_id: { type: 'number', required: true }
-    },
-    autofilter: 'workspace_user',
-    tableName: 'autofilter_tasks'
-  })
-  await api.resources.tasks.createKnexTable()
-  mapTable('autofilter_tasks', 'tasks')
-
-  await api.addResource('optional_tasks', {
-    schema: {
-      id: { type: 'id' },
-      title: { type: 'string', required: true, max: 200 },
-      project_id: { type: 'number', belongsTo: 'projects', as: 'project', nullable: true }
-    },
-    autofilter: {
-      filters: [{ field: 'project_id', resolver: 'currentProject' }]
-    },
-    tableName: 'autofilter_optional_tasks'
-  })
-  await api.resources.optional_tasks.createKnexTable()
-  mapTable('autofilter_optional_tasks', 'optional_tasks')
-
-  await api.addResource('system_settings', {
-    schema: {
-      id: { type: 'id' },
-      key: { type: 'string', required: true, unique: true },
-      value: { type: 'string', required: true }
-    },
-    autofilter: 'public',
-    tableName: 'autofilter_system_settings'
-  })
-  await api.resources.system_settings.createKnexTable()
-  mapTable('autofilter_system_settings', 'system_settings')
-
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(previousTenant)
-  }
-
-  return api
-}
-
-export async function createRowPolicyApi (knex, pluginOptions = {}) {
-  const api = new Api({
-    name: 'row-policy-test-api',
-  })
-
-  const tenantId = storageMode.isAnyApi() ? 'row_policy_tenant' : storageMode.defaultTenant
-  const previousTenant = storageMode.currentTenant
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    sortableFields: ['id', 'name', 'title', 'access_group', 'project_id']
-  })
-
-  await useStoragePlugin(api, knex, { tenantId })
-  await resetAnyApiTables(knex)
-
-  const rowPolicyOptions = pluginOptions.rowPolicy || {}
-  await api.use(RowPolicyPlugin, {
-    ...rowPolicyOptions,
-    policies: {
-      groupVisibility: ({ query, context, column, value, scopeName, queryPurpose }) => {
-        pluginOptions.onPolicy?.({ scopeName, queryPurpose })
-
-        if (context.visibility?.all === true) {
-          return true
-        }
-
-        const groups = context.visibility?.groups
-        if (!Array.isArray(groups) || groups.length === 0) {
-          return false
-        }
-
-        query.where(function visibilityGrants () {
-          this.whereRaw('1 = 0')
-          this.orWhere(function groupVisibilityGrant () {
-            this.whereIn(
-              column('access_group'),
-              groups.map((group) => value('access_group', group))
-            )
-          })
-        })
-        return true
-      },
-      ...(rowPolicyOptions.policies || {})
-    }
-  })
-
-  await api.use(AutoFilterPlugin, {
-    resolvers: {
-      workspace: ({ context }) => context.scopeValues?.workspaceId
-    },
-    presets: {
-      workspace: {
-        filters: [{ field: 'workspace_id', resolver: 'workspace' }]
-      }
-    }
-  })
-
-  await api.addResource('policy_projects', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 200 },
-      access_group: { type: 'string', required: true },
-      workspace_id: { type: 'string', required: true }
-    },
-    relationships: {
-      tasks: { type: 'hasMany', target: 'policy_tasks', foreignKey: 'project_id' },
-      shared_tasks: {
-        type: 'manyToMany',
-        target: 'policy_tasks',
-        through: 'policy_project_tasks',
-        foreignKey: 'project_id',
-        otherKey: 'task_id'
-      }
-    },
-    autofilter: 'workspace',
-    rowPolicy: 'groupVisibility',
-    tableName: 'row_policy_projects'
-  })
-  await api.resources.policy_projects.createKnexTable()
-  mapTable('row_policy_projects', 'policy_projects')
-
-  await api.addResource('policy_tasks', {
-    schema: {
-      id: { type: 'id' },
-      title: { type: 'string', required: true, max: 200, search: true },
-      access_group: { type: 'string', required: true },
-      workspace_id: { type: 'string', required: true },
-      project_id: {
-        type: 'number',
-        nullable: true,
-        belongsTo: 'policy_projects',
-        as: 'project',
-        search: true
-      }
-    },
-    relationships: {
-      shared_projects: {
-        type: 'manyToMany',
-        target: 'policy_projects',
-        through: 'policy_project_tasks',
-        foreignKey: 'task_id',
-        otherKey: 'project_id'
-      }
-    },
-    autofilter: 'workspace',
-    rowPolicy: 'groupVisibility',
-    tableName: 'row_policy_tasks'
-  })
-  await api.resources.policy_tasks.createKnexTable()
-  mapTable('row_policy_tasks', 'policy_tasks')
-
-  await api.addResource('policy_project_tasks', {
-    schema: {
-      id: { type: 'id' },
-      project_id: { type: 'number', required: true, belongsTo: 'policy_projects', as: 'project' },
-      task_id: { type: 'number', required: true, belongsTo: 'policy_tasks', as: 'task' }
-    },
-    tableName: 'row_policy_project_tasks'
-  })
-  await api.resources.policy_project_tasks.createKnexTable()
-  mapTable('row_policy_project_tasks', 'policy_project_tasks')
-
-  if (storageMode.isAnyApi()) {
-    const projectsDescriptor = await api.anyapi.registry.getDescriptor(tenantId, 'policy_projects')
-    const tasksDescriptor = await api.anyapi.registry.getDescriptor(tenantId, 'policy_tasks')
-    storageMode.registerLink(
-      'row_policy_project_tasks',
-      'policy_projects',
-      'shared_tasks',
-      projectsDescriptor?.manyToMany?.shared_tasks?.relationship,
-      tasksDescriptor?.manyToMany?.shared_projects?.relationship
-    )
-  }
-
-  await api.addResource('policy_broken', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true }
-    },
-    rowPolicy: () => undefined,
-    tableName: 'row_policy_broken'
-  })
-  await api.resources.policy_broken.createKnexTable()
-  mapTable('row_policy_broken', 'policy_broken')
-
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(previousTenant)
-  }
-
-  return api
-}
-
-/**
- * Creates an API with positioning support for testing
- */
-export async function createPositioningApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'positioning-test-api'
-  const tablePrefix = pluginOptions.tablePrefix || 'positioning'
-  const api = new Api({
-    name: apiName,
-  })
-
-  const restApiOptions = {
-    simplifiedApi: true,  // Changed to true to allow simplified API calls in tests
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: true,
-      patch: true
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'full',
-      patch: 'full'
-    },
-    sortableFields: ['id', 'title', 'name', 'position', 'sort_order', 'category_id', 'project_id', 'status'],
-    ...pluginOptions['rest-api']
-  }
-
-  await api.use(RestApiPlugin, restApiOptions)
-  await useStoragePlugin(api, knex)
-  await resetAnyApiTables(knex)
-
-  // Categories (for grouping tasks)
-  await api.addResource('categories', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 100 }
-    },
-    tableName: `${tablePrefix}_categories`
-  })
-  await api.resources.categories.createKnexTable()
-  mapTable(`${tablePrefix}_categories`, 'categories')
-
-  // Tasks (main positioning test resource)
-  await api.addResource('tasks', {
-    schema: {
-      id: { type: 'id' },
-      title: { type: 'string', required: true, max: 200 },
-      category_id: { type: 'number', nullable: true, belongsTo: 'categories', as: 'category', search: true },
-      position: { type: 'string', max: 255, nullable: true },
-      beforeId: { type: 'string', virtual: true }, // Virtual field for positioning
-      deleted_at: { type: 'dateTime', nullable: true, search: true }, // For soft delete tests
-      version: { type: 'number', defaultTo: 1, search: true } // For versioning tests
-    },
-    relationships: {
-      category: { belongsTo: 'categories' }
-    },
-    tableName: `${tablePrefix}_tasks`
-  })
-  await api.resources.tasks.createKnexTable()
-  mapTable(`${tablePrefix}_tasks`, 'tasks')
-
-  // Projects (for multi-filter testing)
-  await api.addResource('projects', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 100 }
-    },
-    tableName: `${tablePrefix}_projects`
-  })
-  await api.resources.projects.createKnexTable()
-  mapTable(`${tablePrefix}_projects`, 'projects')
-
-  // Items (flexible resource for various positioning tests)
-  await api.addResource('items', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 200 },
-      project_id: { type: 'number', nullable: true, belongsTo: 'projects', as: 'project', search: true },
-      status: { type: 'string', defaultTo: 'active', nullable: true, search: true },
-      position: { type: 'string', max: 255, nullable: true },
-      sort_order: { type: 'string', max: 255, nullable: true }, // Alternative position field
-      beforeId: { type: 'string', virtual: true },
-      priority: { type: 'string', defaultTo: 'medium', search: true } // For multi-filter tests
-    },
-    relationships: {
-      project: { belongsTo: 'projects' }
-    },
-    tableName: `${tablePrefix}_items`
-  })
-  await api.resources.items.createKnexTable()
-  mapTable(`${tablePrefix}_items`, 'items')
-
-  return api
-}
-
-/**
- * Creates an API with custom idProperty for all resources to test idProperty functionality
- * Uses 'custom_id_' prefix for all tables to avoid conflicts
- */
-export async function createCustomIdPropertyApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'custom-id-test-api'
-  const tablePrefix = pluginOptions.tablePrefix || 'custom_id'
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  if (storageMode.isAnyApi()) {
-    storageMode.clearRegistry()
-  }
-
-  const restApiOptions = {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: 'full',
-      put: 'full',
-      patch: 'full'
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'full',
-      patch: 'full'
-    },
-    sortableFields: ['country_id', 'publisher_id', 'author_id', 'book_id', 'title', 'name', 'code'],
-    ...pluginOptions['rest-api']  // Merge any custom options for rest-api plugin
-  }
-
-  await api.use(RestApiPlugin, restApiOptions)
-  await useStoragePlugin(api, knex)
-  await resetAnyApiTables(knex)
-
-  // Countries table with custom idProperty
-  await api.addResource('countries', {
-    schema: {
-      // NO id: { type: 'id' } - this is key!
-      name: { type: 'string', required: true, max: 100, search: true },
-      code: { type: 'string', max: 2, unique: true }
-    },
-    relationships: {
-      publishers: { type: 'hasMany', target: 'publishers', foreignKey: 'country_id' },
-      books: { type: 'hasMany', target: 'books', foreignKey: 'country_id' }
-    },
-    tableName: `${tablePrefix}_countries`,
-    idProperty: 'country_id'  // Custom ID property
-  })
-  await api.resources.countries.createKnexTable()
-  mapTable(`${tablePrefix}_countries`, 'countries')
-
-  // Publishers table with custom idProperty
-  await api.addResource('publishers', {
-    schema: {
-      name: { type: 'string', required: true, max: 200 },
-      country_id: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' }
-    },
-    relationships: {
-      books: { type: 'hasMany', target: 'books', foreignKey: 'publisher_id' },
-      reviews: {
-        type: 'hasMany',
-        target: 'reviews',
-        via: 'reviewable'
-      }
-    },
-    tableName: `${tablePrefix}_publishers`,
-    idProperty: 'publisher_id'
-  })
-  await api.resources.publishers.createKnexTable()
-  mapTable(`${tablePrefix}_publishers`, 'publishers')
-
-  // Authors table with custom idProperty
-  await api.addResource('authors', {
-    schema: {
-      name: { type: 'string', required: true, max: 200 },
-      biography: { type: 'string', max: 5000 },
-      country_id: { type: 'number', nullable: true, belongsTo: 'countries', as: 'country' }
-    },
-    relationships: {
-      books: { type: 'manyToMany', through: 'book_authors', foreignKey: 'author_id', otherKey: 'book_id' },
-      reviews: {
-        type: 'hasMany',
-        target: 'reviews',
-        via: 'reviewable'
-      }
-    },
-    tableName: `${tablePrefix}_authors`,
-    idProperty: 'author_id'
-  })
-  await api.resources.authors.createKnexTable()
-  mapTable(`${tablePrefix}_authors`, 'authors')
-
-  // Books table with custom idProperty
-  await api.addResource('books', {
-    schema: {
-      title: { type: 'string', required: true, max: 300, search: true },
-      isbn: { type: 'string', max: 13 },
-      pages: { type: 'number' },
-      published_date: { type: 'date' },
-      country_id: { type: 'number', required: true, belongsTo: 'countries', as: 'country', search: true },
-      publisher_id: { type: 'number', nullable: true, belongsTo: 'publishers', as: 'publisher', search: true }
-    },
-    relationships: {
-      authors: { type: 'manyToMany', through: 'book_authors', foreignKey: 'book_id', otherKey: 'author_id' },
-      reviews: {
-        type: 'hasMany',
-        target: 'reviews',
-        via: 'reviewable'
-      }
-    },
-    tableName: `${tablePrefix}_books`,
-    idProperty: 'book_id'
-  })
-  await api.resources.books.createKnexTable()
-  mapTable(`${tablePrefix}_books`, 'books')
-
-  // Book-Authors pivot table with custom idProperty
-  await api.addResource('book_authors', {
-    schema: {
-      book_id: { type: 'number', required: true, belongsTo: 'books', as: 'book' },
-      author_id: { type: 'number', required: true, belongsTo: 'authors', as: 'author' },
-      contribution_type: { type: 'string', max: 50 },
-      order: { type: 'number' }
-    },
-    tableName: `${tablePrefix}_book_authors`,
-    idProperty: 'book_author_id'
-  })
-  await api.resources.book_authors.createKnexTable()
-  mapTable(`${tablePrefix}_book_authors`, 'book_authors')
-
-  // Polymorphic reviews with custom idProperty
-  await api.addResource('reviews', {
-    schema: {
-      rating: { type: 'number', required: true, min: 1, max: 5 },
-      title: { type: 'string', max: 200 },
-      content: { type: 'string', required: true, max: 5000 },
-      reviewer_name: { type: 'string', required: true, max: 100 },
-      review_date: { type: 'dateTime', temporalPrecision: 3, defaultTo: () => new Date().toISOString() },
-      reviewable_type: { type: 'string', required: true, search: true },
-      reviewable_id: { type: 'number', required: true },
-      // Define the polymorphic field in schema
-      reviewable: {
-        belongsToPolymorphic: {
-          types: ['books', 'authors', 'publishers'],
-          typeField: 'reviewable_type',
-          idField: 'reviewable_id'
-        },
-        as: 'reviewable'
-      }
-    },
-    relationships: {},
-    tableName: `${tablePrefix}_reviews`,
-    idProperty: 'review_id'
-  })
-  await api.resources.reviews.createKnexTable()
-  mapTable(`${tablePrefix}_reviews`, 'reviews')
-
-  if (storageMode.isAnyApi()) {
-    const tenant = storageMode.defaultTenant || 'default'
-    const booksDescriptor = await api.anyapi.registry.getDescriptor(tenant, 'books')
-    const authorsDescriptor = await api.anyapi.registry.getDescriptor(tenant, 'authors')
-    const relationshipKey = booksDescriptor?.manyToMany?.authors?.relationship
-    const inverseRelationshipKey = authorsDescriptor?.manyToMany?.books?.relationship
-    storageMode.registerLink(
-      `${tablePrefix}_book_authors`,
-      'books',
-      'authors',
-      relationshipKey,
-      inverseRelationshipKey
-    )
-  }
-
-  return api
-}
-
-/**
- * Creates an API configuration for multi-field cursor pagination testing
- * Uses 'cursor_' prefix for all tables to avoid conflicts
- */
-export async function createCursorPaginationApi (knex) {
-  const api = new Api({
-    name: 'cursor-pagination-test-api',
-  })
-
-  const restApiOptions = {
-    simplified: false,
-    responseFormat: {
-      post: 'full',
-      put: 'full',
-      patch: 'minimal'
-    },
-    sortableFields: ['id', 'name', 'category', 'brand', 'price', 'sku', 'createdAt', 'code', 'status', 'type'],
-    queryDefaultLimit: 20,
-    queryMaxLimit: 100,
-    returnBasePath: 'https://api.example.com'
-  }
-
-  await api.use(RestApiPlugin, restApiOptions)
-  await useStoragePlugin(api, knex)
-  await resetAnyApiTables(knex)
-
-  // Create products table with fields suitable for multi-field sorting
-  await api.addResource('products', {
-    schema: {
-      id: { type: 'id' },
-      name: { type: 'string', required: true, max: 200, search: true },
-      category: { type: 'string', required: true, max: 100, search: true, indexed: true },
-      brand: { type: 'string', required: true, max: 100, search: true, indexed: true },
-      price: { type: 'number', required: true },
-      sku: { type: 'string', required: true, max: 50, unique: true },
-      status: { type: 'string', max: 50, default: 'active' },
-      createdAt: { type: 'dateTime', temporalPrecision: 3, defaultTo: () => new Date().toISOString() }
-    },
-    tableName: 'cursor_products'
-  })
-  await api.resources.products.createKnexTable()
-  mapTable('cursor_products', 'products')
-
-  // Create items table with custom ID property
-  await api.addResource('items', {
-    schema: {
-      item_id: { type: 'id' },
-      code: { type: 'string', required: true, max: 10, unique: true },
-      name: { type: 'string', required: true, max: 200 },
-      category: { type: 'string', required: true, max: 100 },
-      type: { type: 'string', required: true, max: 50 }
-    },
-    idProperty: 'item_id',
-    tableName: 'cursor_items'
-  })
-  await api.resources.items.createKnexTable()
-  mapTable('cursor_items', 'items')
-
-  return api
-}
-
-/**
- * Creates an API configuration for testing virtual fields validation
- */
-export async function createVirtualFieldsApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'virtual-fields-test-api'
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const restApiOptions = {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    returnRecordTransport: {
-      post: 'full',
-      put: 'no',
-      patch: 'minimal'
-    },
-    ...pluginOptions['rest-api']
-  }
-
-  await api.use(RestApiPlugin, restApiOptions)
-  await useStoragePlugin(api, knex)
-  await resetAnyApiTables(knex)
-
-  // Add a test resource with virtual fields
-  await api.addResource('users', {
-    schema: {
-      // Regular fields
-      username: { type: 'string', required: true },
-      email: { type: 'string', required: true },
-      age: { type: 'number' },
-
-      // Virtual fields with validation rules
-      password: { type: 'string', virtual: true, minLength: 8 },
-      passwordConfirmation: { type: 'string', virtual: true, minLength: 8 },
-      termsAccepted: { type: 'boolean', virtual: true, required: true },
-      captchaScore: { type: 'number', virtual: true, min: 0, max: 1 },
-      tags: { type: 'array', virtual: true },
-      metadata: { type: 'object', virtual: true }
-    },
-    tableName: 'virtual_users'
-  })
-
-  await api.resources.users.createKnexTable()
-
-  return api
-}
-
-/**
- * Creates an API configuration for testing searchSchema merge behavior.
- * Shared suites assert merge/validation behavior across storage backends;
- * backend-specific execution cases live in storage-specific tests.
- */
-export async function createSearchSchemaMergeApi (knex, pluginOptions = {}) {
-  const api = new Api({
-    name: 'searchschema-merge-test-api',
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  await api.use(RestApiPlugin, {
-    simplifiedApi: false,
-    simplifiedTransport: false,
-    returnRecordApi: {
-      post: true,
-      put: false,
-      patch: false
-    },
-    ...pluginOptions['rest-api']
-  })
-
-  await useStoragePlugin(api, knex)
-  await resetAnyApiTables(knex)
-
-  // Test resource with both search:true and searchSchema
-  await api.addResource('products', {
-    schema: {
-      name: { type: 'string', search: true },        // Should be added to searchSchema
-      description: { type: 'string', search: true }, // Should be added to searchSchema
-      price: { type: 'number', search: true },       // Should be overridden by searchSchema
-      category: { type: 'number' },               // Not searchable
-      sku: { type: 'string', search: true },         // Should be added to searchSchema
-      status: { type: 'string' }                     // Not searchable but added via searchSchema
-    },
-    searchSchema: {
-      // This should override the price field from search:true
-      // 'between' operator requires array type for validation [min, max]
-      price: {
-        type: 'array',
-        filterOperator: 'between'
-      },
-      // Arbitrary public filter name that searches across multiple fields.
-      // The key `term` is part of the API contract even though there is no `term` column.
-      term: {
-        type: 'string',
-        oneOf: ['name', 'description'],
-        filterOperator: 'like'
-      },
-      // This is a virtual field
-      category_name: {
-        type: 'string',
-        actualField: 'category.name',
-        filterOperator: 'like'
-      },
-      // Arbitrary public filter name with fully custom server-side meaning.
-      // The Knex query layer decides what `availability` means.
-      availability: {
-        type: 'boolean',
-        applyFilter: (query, value) => {
-          query.where('status', value ? 'active' : 'inactive')
-        }
-      },
-      // This is an explicit field not marked with search:true
-      // 'in' operator requires array type for validation
-      status: {
-        type: 'array',
-        filterOperator: 'in'
-      }
-    },
-    tableName: 'searchmerge_products'
-  })
-  await api.resources.products.createKnexTable()
-
-  // Test resource with only search:true fields
-  await api.addResource('users', {
-    schema: {
-      username: { type: 'string', search: true },
-      email: { type: 'string', search: true },
-      age: { type: 'number' },
-      bio: { type: 'string', search: { filterOperator: 'like' } }
-    },
-    tableName: 'searchmerge_users'
-  })
-  await api.resources.users.createKnexTable()
-
-  // Test resource with only explicit searchSchema
-  await api.addResource('orders', {
-    schema: {
-      order_number: { type: 'string' },
-      total: { type: 'number' },
-      status: { type: 'string' }
-    },
-    searchSchema: {
-      order_number: { type: 'string', filterOperator: '=' },
-      status: { type: 'array', filterOperator: 'in' }  // 'in' operator requires array type
-    },
-    tableName: 'searchmerge_orders'
-  })
-  await api.resources.orders.createKnexTable()
-  mapTable('searchmerge_orders', 'orders')
-
-  return api
-}
-
-export async function createFileUploadApi (knex, pluginOptions = {}) {
-  const apiName = pluginOptions.apiName || 'file-upload-test-api'
-  const tableName = pluginOptions.tableName || 'file_documents'
-  const tablePrefix = pluginOptions.tablePrefix || 'file'
-  const storage = pluginOptions.storage
-  const detectorState = pluginOptions.detectorState || { payload: null }
-
-  if (!storage) {
-    throw new Error('createFileUploadApi requires a storage adapter')
-  }
-
-  if (storageMode.isAnyApi()) {
-    storageMode.clearRegistry()
-  }
-
-  const api = new Api({
-    name: apiName,
-    log: { level: process.env.LOG_LEVEL || 'info' }
-  })
-
-  const previousTenant = storageMode.currentTenant
-  const tenantId = storageMode.isAnyApi()
-    ? (pluginOptions.tenantId || `${tablePrefix}_tenant`)
-    : storageMode.defaultTenant
-
-  if (storageMode.isAnyApi()) {
-    storageMode.setCurrentTenant(tenantId)
-  }
-
-  try {
-    await api.use(RestApiPlugin, {
-      simplifiedApi: false,
-      simplifiedTransport: false,
-      returnRecordApi: {
-        post: true,
-        put: false,
-        patch: false
-      },
-      returnRecordTransport: {
-        post: 'full',
-        put: 'no',
-        patch: 'minimal'
-      },
-      sortableFields: ['id', 'title'],
-      ...pluginOptions['rest-api']
-    })
-    await useStoragePlugin(api, knex, { tenantId })
-    await resetAnyApiTables(knex)
-    await api.use(FileHandlingPlugin)
-
-    api.rest.registerFileDetector({
-      name: 'test-file-detector',
-      detect: () => Boolean(detectorState.payload),
-      parse: async () => detectorState.payload
-    })
-
-    await api.addResource('documents', {
-      schema: {
-        id: { type: 'id' },
-        title: { type: 'string', required: true },
-        attachment: {
-          type: 'file',
-          storage,
-          accepts: ['image/png'],
-          maxSize: '1mb'
-        }
-      },
-      tableName
-    })
-    await api.resources.documents.createKnexTable()
-    mapTable(tableName, 'documents')
-
-    return api
-  } finally {
-    if (storageMode.isAnyApi()) {
-      storageMode.setCurrentTenant(previousTenant)
-    }
-  }
-}