@kubb/adapter-oas 5.0.0-alpha.1 → 5.0.0-alpha.11

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import * as _kubb_core0 from "@kubb/core";
 import { AdapterFactoryOptions } from "@kubb/core";
-import { DiscriminatorObject, OASDocument, SchemaObject } from "oas/types";
+import { DiscriminatorObject, OASDocument, ParameterObject, SchemaObject } from "oas/types";
 import BaseOas from "oas";
 import * as oas_normalize_lib_types0 from "oas-normalize/lib/types";
 import { Operation } from "oas/operation";
+import { OpenAPIV3 } from "openapi-types";
 
 //#region src/oas/types.d.ts
 type contentType = 'application/json' | (string & {});
@@ -24,10 +25,30 @@ type SchemaObject$1 = SchemaObject & {
    */
   contentMediaType?: string;
   $ref?: string;
+  /**
+   * OAS 3.1 / JSON Schema: positional items in a tuple schema.
+   * Replaces the OAS 3.0 multi-item `items` array syntax.
+   */
+  prefixItems?: Array<SchemaObject$1 | ReferenceObject>;
+  /**
+   * JSON Schema: maps regex patterns to sub-schemas for additional property validation.
+   */
+  patternProperties?: Record<string, SchemaObject$1 | boolean>;
+  /**
+   * OAS 3.0 / JSON Schema: single-schema form.
+   * The OAS base type already includes this, but we re-declare it here to ensure
+   * the single-schema overload takes precedence over the multi-schema tuple form.
+   */
+  items?: SchemaObject$1 | ReferenceObject;
+  /**
+   * Enum values for this schema (narrowed from `unknown[]` in the base type).
+   */
+  enum?: Array<string | number | boolean | null>;
 };
 type Document = OASDocument;
 type Operation$1 = Operation;
 type DiscriminatorObject$1 = DiscriminatorObject;
+type ReferenceObject = OpenAPIV3.ReferenceObject;
 //#endregion
 //#region src/oas/Oas.d.ts
 type OasOptions = {
@@ -52,6 +73,15 @@ declare class Oas extends BaseOas {
   dereferenceWithRef<T = unknown>(schema?: T): T;
   getResponseSchema(operation: Operation$1, statusCode: string | number): SchemaObject$1;
   getRequestSchema(operation: Operation$1): SchemaObject$1 | undefined;
+  /**
+   * Returns all resolved parameters for an operation, merging path-level and operation-level
+   * parameters and deduplicating by `in:name` (operation-level takes precedence).
+   *
+   * oas v31+ filters out `$ref` parameters in `getParameters()`, so this method accesses the
+   * raw `operation.schema.parameters` and path-item parameters directly and resolves `$ref`
+   * pointers via `dereferenceWithRef` to preserve backward compatibility.
+   */
+  getParameters(operation: Operation$1): Array<ParameterObject>;
   getParametersSchema(operation: Operation$1, inKey: 'path' | 'query' | 'header'): SchemaObject$1 | null;
   validate(): Promise<oas_normalize_lib_types0.ValidationResult>;
   flattenSchema(schema: SchemaObject$1 | null): SchemaObject$1 | null;
@@ -70,6 +100,31 @@ declare class Oas extends BaseOas {
 }
 //#endregion
 //#region src/types.d.ts
+/**
+ * Controls how various OAS constructs are mapped to Kubb AST nodes.
+ */
+type ParserOptions = {
+  /**
+   * How `format: 'date-time'` schemas are represented. `false` falls through to a plain string.
+   */
+  dateType: false | 'string' | 'stringOffset' | 'stringLocal' | 'date';
+  /**
+   * Whether `type: 'integer'` and `format: 'int64'` produce `number` or `bigint` nodes.
+   */
+  integerType?: 'number' | 'bigint';
+  /**
+   * AST type used when no schema type can be inferred.
+   */
+  unknownType: 'any' | 'unknown' | 'void';
+  /**
+   * AST type used for completely empty schemas (`{}`).
+   */
+  emptySchemaType: 'any' | 'unknown' | 'void';
+  /**
+   * Suffix appended to derived enum names when building property schema names.
+   */
+  enumSuffix: 'enum' | (string & {});
+};
 type OasAdapterOptions = {
   /**
    * Validate the OpenAPI spec before parsing.
@@ -109,34 +164,16 @@ type OasAdapterOptions = {
    */
   discriminator?: 'strict' | 'inherit';
   /**
-   * Automatically resolve name collisions across schema components.
-   * @default false
+   * Enable collision detection for inline enum and schema type names.
+   * When `true` (default), full-path names are used and name collisions
+   * across schema components are automatically resolved (e.g. `OrderParamsStatusEnum`).
+   * When `false`, enum names use only the immediate property context
+   * (e.g. `ParamsStatusEnum`) matching the v4 naming conventions, with numeric
+   * suffixes for deduplication (e.g. `ParamsStatusEnum2`).
+   * @default true
    */
   collisionDetection?: boolean;
-  /**
-   * How `format: 'date-time'` schemas are represented in the AST.
-   * - `'string'` maps to a `datetime` string node.
-   * - `'date'` maps to a JavaScript `Date` node.
-   * - `false` falls through to a plain `string` node.
-   * @default 'string'
-   */
-  dateType?: false | 'string' | 'stringOffset' | 'stringLocal' | 'date';
-  /**
-   * Whether `type: 'integer'` / `format: 'int64'` produces `number` or `bigint` nodes.
-   * @default 'number'
-   */
-  integerType?: 'number' | 'bigint';
-  /**
-   * AST type used when no schema type can be inferred.
-   * @default 'any'
-   */
-  unknownType?: 'any' | 'unknown' | 'void';
-  /**
-   * AST type used for completely empty schemas (`{}`).
-   * @default `unknownType`
-   */
-  emptySchemaType?: 'any' | 'unknown' | 'void';
-};
+} & Partial<ParserOptions>;
 type OasAdapterResolvedOptions = {
   validate: boolean;
   oasClass: OasAdapterOptions['oasClass'];
@@ -149,6 +186,13 @@ type OasAdapterResolvedOptions = {
   integerType: NonNullable<OasAdapterOptions['integerType']>;
   unknownType: NonNullable<OasAdapterOptions['unknownType']>;
   emptySchemaType: NonNullable<OasAdapterOptions['emptySchemaType']>;
+  enumSuffix: OasAdapterOptions['enumSuffix'];
+  /**
+   * Map from original `$ref` paths to their collision-resolved schema names.
+   * Populated by the adapter after each `parse()` call.
+   * e.g. `'#/components/schemas/Order'` → `'OrderSchema'`
+   */
+  nameMapping: Map<string, string>;
 };
 type OasAdapter = AdapterFactoryOptions<'oas', OasAdapterOptions, OasAdapterResolvedOptions>;
 //#endregion