Migration: @kubb/adapter-oas

Part of the v4 → v5 migration guide. See the full option reference in @kubb/adapter-oas.

v4 made you repeat the same schema-level options on every plugin. In v5 they live on adapterOas and apply globally. Remove them from each plugin and set them once on the adapter.

Option	Removed from	v5 location
dateType	plugin-ts, plugin-faker, plugin-zod	adapterOas({ dateType })
integerType	plugin-ts, plugin-zod, plugin-faker	adapterOas({ integerType })
unknownType	plugin-ts, plugin-zod, plugin-faker	adapterOas({ unknownType })
emptySchemaType	plugin-ts, plugin-zod, plugin-faker	adapterOas({ emptySchemaType })
enumSuffix	plugin-ts	adapterOas({ enumSuffix })
contentType	plugin-ts, plugin-msw	adapterOas({ contentType })

IMPORTANT

The default value of integerType changed from 'number' to 'bigint'. OpenAPI int64 fields now map to bigint by default. To keep the previous behavior, set integerType: 'number' explicitly on adapterOas.

v4 kubb.config.ts

import { defineConfig } from '@kubb/core'
import { pluginTs } from '@kubb/plugin-ts'
import { pluginZod } from '@kubb/plugin-zod'
import { pluginFaker } from '@kubb/plugin-faker'

export default defineConfig({
  input: { path: './petstore.yaml' },
  output: { path: './src/gen' },
  plugins: [
    pluginTs({
      dateType: 'date',
      integerType: 'number',
      unknownType: 'unknown',
      emptySchemaType: 'unknown',
      enumSuffix: 'enum',
    }),
    pluginZod({
      dateType: 'date',
      integerType: 'number',
      unknownType: 'unknown',
    }),
    pluginFaker({
      dateType: 'date',
      integerType: 'number',
      unknownType: 'unknown',
    }),
  ],
})

v5 kubb.config.ts

import {  } from 'kubb'
import {  } from '@kubb/adapter-oas'
import {  } from '@kubb/plugin-ts'
import {  } from '@kubb/plugin-zod'
import {  } from '@kubb/plugin-faker'

export default ({
  : { : './petstore.yaml' },
  : { : './src/gen' },
  : ({
    : 'date',
    : 'number',
    : 'unknown',
    : 'unknown',
    : 'enum',
  }),
  : [(), (), ()],
})

pluginOas() no longer belongs in plugins. Its validate, serverIndex, serverVariables, discriminator, and contentType options move to the same top-level adapter key. See @kubb/plugin-oas removed on the main guide.