@kubb/plugin-oas 4.31.2 → 4.31.4

package/LICENSE

@@ -1,21 +1,14 @@
-MIT License
+Copyright (c) 2026 Stijn Van Hulle
 
-Copyright (c) 2025 Stijn Van Hulle
+This repository contains software under two licenses:
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+1. Most of the code in this repository is licensed under the
+   MIT License — see licenses/LICENSE-MIT for the full license text.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+2. The following components are licensed under the
+   GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)
+   — see licenses/LICENSE-AGPL-3.0 for the full license text:
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+   - packages/agent (published as @kubb/agent)
+
+Each package's own LICENSE file or package.json specifies its applicable license.

package/dist/utils.cjs

@@ -77,11 +77,18 @@ function getPathParams(operationSchema, options = {}) {
 */
 function getParamsMapping(operationSchema, options = {}) {
 	if (!operationSchema || !operationSchema.schema.properties) return;
-	const mapping = {};
+	const allEntries = [];
+	let hasTransformation = false;
 	Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {
 		let transformedName = originalName;
 		if (options.casing === "camelcase") transformedName = (0, _kubb_core_transformers.camelCase)(originalName);
 		else if (!(0, _kubb_core_transformers.isValidVarName)(originalName)) transformedName = (0, _kubb_core_transformers.camelCase)(originalName);
+		allEntries.push([originalName, transformedName]);
+		if (transformedName !== originalName) hasTransformation = true;
+	});
+	if (options.casing === "camelcase" && hasTransformation) return Object.fromEntries(allEntries);
+	const mapping = {};
+	allEntries.forEach(([originalName, transformedName]) => {
 		if (transformedName !== originalName) mapping[originalName] = transformedName;
 	});
 	return Object.keys(mapping).length > 0 ? mapping : void 0;

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["URLPath","SchemaGenerator","schemaKeywords","transformers"],"sources":["../src/utils/getComments.ts","../src/utils/getImports.ts","../src/utils/getParams.ts","../src/utils/getSchemas.ts","../src/utils/paramsCasing.ts"],"sourcesContent":["import { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .flatMap((text) => {\n      // Split by newlines to preserve line breaks in JSDoc\n      // Trim each line individually to remove leading/trailing whitespace\n      return text.split(/\\r?\\n/).map((line) => line.trim())\n    })\n    .filter(Boolean)\n}\n","import type { KubbFile } from '@kubb/fabric-core/types'\nimport { SchemaGenerator } from '../SchemaGenerator.ts'\nimport type { Schema } from '../SchemaMapper'\nimport { schemaKeywords } from '../SchemaMapper'\n\n/**\n * Get imports from a schema tree by extracting all ref schemas that are importable\n */\nexport function getImports(tree: Array<Schema>): Array<KubbFile.Import> {\n  const refs = SchemaGenerator.deepSearch(tree, schemaKeywords.ref)\n\n  return refs\n    ?.map((item) => {\n      if (!item.args.path || !item.args.isImportable) {\n        return undefined\n      }\n\n      return {\n        name: [item.args.name],\n        path: item.args.path,\n      }\n    })\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    casing,\n    override,\n  }: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    // Use camelCase name for indexed access if casing is enabled\n    const accessName = casing === 'camelcase' ? camelCase(name) : name\n\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${accessName}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = curr.name\n\n      // Only transform to camelCase if explicitly requested\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      } else if (!isValidVarName(name)) {\n        // If not valid variable name and casing not set, still need to make it valid\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n\n/**\n * Get a mapping of camelCase parameter names to their original names\n * Used for mapping function parameters to backend parameter names\n */\nexport function getParamsMapping(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    casing?: 'camelcase'\n  } = {},\n): Record<string, string> | undefined {\n  if (!operationSchema || !operationSchema.schema.properties) {\n    return undefined\n  }\n\n  const mapping: Record<string, string> = {}\n\n  Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {\n    let transformedName = originalName\n\n    // Only transform to camelCase if explicitly requested\n    if (options.casing === 'camelcase') {\n      transformedName = camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name and casing not set, still need to make it valid\n      transformedName = camelCase(originalName)\n    }\n\n    // Only add mapping if the names differ\n    if (transformedName !== originalName) {\n      mapping[originalName] = transformedName\n    }\n  })\n\n  return Object.keys(mapping).length > 0 ? mapping : undefined\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\nexport type GetSchemasResult = {\n  schemas: Record<string, OasTypes.SchemaObject>\n  /**\n   * Mapping from original component name to resolved name after collision handling\n   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }\n   */\n  nameMapping: Map<string, string>\n}\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n  /**\n   * Whether to resolve name collisions with suffixes.\n   * If not provided, uses oas.options.collisionDetection\n   * @default false (from oas.options or fallback)\n   */\n  collisionDetection?: boolean\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order along with name mapping for collision resolution.\n *\n * This function is a wrapper around the oas.getSchemas() method for backward compatibility.\n * New code should use oas.getSchemas() directly.\n *\n * @deprecated Use oas.getSchemas() instead\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'], collisionDetection }: GetSchemasProps): GetSchemasResult {\n  return oas.getSchemas({\n    contentType,\n    includes,\n    collisionDetection,\n  })\n}\n","import transformers, { isValidVarName } from '@kubb/core/transformers'\nimport type { SchemaObject } from '@kubb/oas'\n\n/**\n * Apply casing transformation to schema properties\n * Only transforms property names, not nested schemas\n */\nexport function applyParamsCasing(schema: SchemaObject, casing: 'camelcase' | undefined): SchemaObject {\n  if (!casing || !schema.properties) {\n    return schema\n  }\n\n  const transformedProperties: Record<string, any> = {}\n  const transformedRequired: string[] = []\n\n  // Transform property names\n  Object.entries(schema.properties).forEach(([originalName, propertySchema]) => {\n    let transformedName = originalName\n\n    if (casing === 'camelcase') {\n      transformedName = transformers.camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name, make it valid\n      transformedName = transformers.camelCase(originalName)\n    }\n\n    transformedProperties[transformedName] = propertySchema\n  })\n\n  // Transform required field names\n  if (Array.isArray(schema.required)) {\n    schema.required.forEach((originalName) => {\n      let transformedName = originalName\n\n      if (casing === 'camelcase') {\n        transformedName = transformers.camelCase(originalName)\n      } else if (!isValidVarName(originalName)) {\n        transformedName = transformers.camelCase(originalName)\n      }\n\n      transformedRequired.push(transformedName)\n    })\n  }\n\n  // Return a new schema with transformed properties and required fields\n  return {\n    ...schema,\n    properties: transformedProperties,\n    ...(transformedRequired.length > 0 && { required: transformedRequired }),\n  } as SchemaObject\n}\n\n/**\n * Check if this schema is a parameter schema (pathParams, queryParams, or headerParams)\n * Only these should be transformed, not response/data/body\n */\nexport function isParameterSchema(schemaName: string): boolean {\n  const lowerName = schemaName.toLowerCase()\n  return lowerName.includes('pathparams') || lowerName.includes('queryparams') || lowerName.includes('headerparams')\n}\n"],"mappings":";;;;;;;;;;;AAIA,SAAgB,YAAY,WAAgC;AAC1D,QAAO;EACL,UAAU,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACxE,UAAU,YAAY,IAAI,YAAY,UAAU,YAAY;EAC5D,UAAU,QAAQ,UAAU,IAAIA,yBAAQ,UAAU,KAAK,CAAC,IAAI;EAC5D,UAAU,cAAc,IAAI;EAC7B,CACE,OAAO,QAAQ,CACf,SAAS,SAAS;AAGjB,SAAO,KAAK,MAAM,QAAQ,CAAC,KAAK,SAAS,KAAK,MAAM,CAAC;GACrD,CACD,OAAO,QAAQ;;;;;;;;ACTpB,SAAgB,WAAW,MAA6C;AAGtE,QAFaC,oCAAgB,WAAW,MAAMC,oCAAe,IAAI,EAG7D,KAAK,SAAS;AACd,MAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,KAAK,aAChC;AAGF,SAAO;GACL,MAAM,CAAC,KAAK,KAAK,KAAK;GACtB,MAAM,KAAK,KAAK;GACjB;GACD,CACD,OAAO,QAAQ;;;;;;;;;;ACZpB,SAAgB,aACd,iBACA,EACE,QAAQ,OACR,QACA,aAKE,EAAE,EACe;AACrB,KAAI,CAAC,mBAAmB,CAAC,gBAAgB,OAAO,cAAc,CAAC,gBAAgB,KAC7E,QAAO,EAAE;CAGX,MAAM,iBAAiB,MAAM,QAAQ,gBAAgB,OAAO,SAAS,GAAG,gBAAgB,OAAO,WAAW,EAAE;AAE5G,QAAO,OAAO,QAAQ,gBAAgB,OAAO,WAAW,CAAC,KAAK,CAAC,UAA2C;EAExG,MAAM,aAAa,WAAW,qDAAwB,KAAK,GAAG;EAE9D,MAAM,OAA0B;GAC9B;GACA,SAAS,CAAC,CAAC;GACX,UAAU,eAAe,SAAS,KAAK;GACvC,MAAM,QAAQ,GAAG,gBAAgB,KAAK,IAAI,WAAW,MAAM;GAC5D;AAED,SAAO,WAAW,SAAS,KAAK,GAAG;GACnC;;AAGJ,SAAgB,cACd,iBACA,UAII,EAAE,EACN;AACA,QAAO,aAAa,iBAAiB,QAAQ,CAAC,QAAQ,KAAK,SAAS;AAClE,MAAI,KAAK,QAAQ,KAAK,SAAS;GAC7B,IAAI,OAAO,KAAK;AAGhB,OAAI,QAAQ,WAAW,YACrB,+CAAiB,KAAK;YACb,6CAAgB,KAAK,CAE9B,+CAAiB,KAAK;AAGxB,OAAI,QAAQ;IACV,SAAS,KAAK;IACd,MAAM,KAAK;IACX,UAAU,CAAC,KAAK;IACjB;;AAGH,SAAO;IACN,EAAE,CAAW;;;;;;AAOlB,SAAgB,iBACd,iBACA,UAEI,EAAE,EAC8B;AACpC,KAAI,CAAC,mBAAmB,CAAC,gBAAgB,OAAO,WAC9C;CAGF,MAAM,UAAkC,EAAE;AAE1C,QAAO,QAAQ,gBAAgB,OAAO,WAAW,CAAC,SAAS,CAAC,kBAAkB;EAC5E,IAAI,kBAAkB;AAGtB,MAAI,QAAQ,WAAW,YACrB,0DAA4B,aAAa;WAChC,6CAAgB,aAAa,CAEtC,0DAA4B,aAAa;AAI3C,MAAI,oBAAoB,aACtB,SAAQ,gBAAgB;GAE1B;AAEF,QAAO,OAAO,KAAK,QAAQ,CAAC,SAAS,IAAI,UAAU;;;;;;;;;;;;;;ACzErD,SAAgB,WAAW,EAAE,KAAK,aAAa,WAAW;CAAC;CAAW;CAAiB;CAAY,EAAE,sBAAyD;AAC5J,QAAO,IAAI,WAAW;EACpB;EACA;EACA;EACD,CAAC;;;;;;;;;AChCJ,SAAgB,kBAAkB,QAAsB,QAA+C;AACrG,KAAI,CAAC,UAAU,CAAC,OAAO,WACrB,QAAO;CAGT,MAAM,wBAA6C,EAAE;CACrD,MAAM,sBAAgC,EAAE;AAGxC,QAAO,QAAQ,OAAO,WAAW,CAAC,SAAS,CAAC,cAAc,oBAAoB;EAC5E,IAAI,kBAAkB;AAEtB,MAAI,WAAW,YACb,mBAAkBC,gCAAa,UAAU,aAAa;WAC7C,6CAAgB,aAAa,CAEtC,mBAAkBA,gCAAa,UAAU,aAAa;AAGxD,wBAAsB,mBAAmB;GACzC;AAGF,KAAI,MAAM,QAAQ,OAAO,SAAS,CAChC,QAAO,SAAS,SAAS,iBAAiB;EACxC,IAAI,kBAAkB;AAEtB,MAAI,WAAW,YACb,mBAAkBA,gCAAa,UAAU,aAAa;WAC7C,6CAAgB,aAAa,CACtC,mBAAkBA,gCAAa,UAAU,aAAa;AAGxD,sBAAoB,KAAK,gBAAgB;GACzC;AAIJ,QAAO;EACL,GAAG;EACH,YAAY;EACZ,GAAI,oBAAoB,SAAS,KAAK,EAAE,UAAU,qBAAqB;EACxE;;;;;;AAOH,SAAgB,kBAAkB,YAA6B;CAC7D,MAAM,YAAY,WAAW,aAAa;AAC1C,QAAO,UAAU,SAAS,aAAa,IAAI,UAAU,SAAS,cAAc,IAAI,UAAU,SAAS,eAAe"}
+{"version":3,"file":"utils.cjs","names":["URLPath","SchemaGenerator","schemaKeywords","transformers"],"sources":["../src/utils/getComments.ts","../src/utils/getImports.ts","../src/utils/getParams.ts","../src/utils/getSchemas.ts","../src/utils/paramsCasing.ts"],"sourcesContent":["import { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .flatMap((text) => {\n      // Split by newlines to preserve line breaks in JSDoc\n      // Trim each line individually to remove leading/trailing whitespace\n      return text.split(/\\r?\\n/).map((line) => line.trim())\n    })\n    .filter(Boolean)\n}\n","import type { KubbFile } from '@kubb/fabric-core/types'\nimport { SchemaGenerator } from '../SchemaGenerator.ts'\nimport type { Schema } from '../SchemaMapper'\nimport { schemaKeywords } from '../SchemaMapper'\n\n/**\n * Get imports from a schema tree by extracting all ref schemas that are importable\n */\nexport function getImports(tree: Array<Schema>): Array<KubbFile.Import> {\n  const refs = SchemaGenerator.deepSearch(tree, schemaKeywords.ref)\n\n  return refs\n    ?.map((item) => {\n      if (!item.args.path || !item.args.isImportable) {\n        return undefined\n      }\n\n      return {\n        name: [item.args.name],\n        path: item.args.path,\n      }\n    })\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    casing,\n    override,\n  }: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    // Use camelCase name for indexed access if casing is enabled\n    const accessName = casing === 'camelcase' ? camelCase(name) : name\n\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${accessName}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = curr.name\n\n      // Only transform to camelCase if explicitly requested\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      } else if (!isValidVarName(name)) {\n        // If not valid variable name and casing not set, still need to make it valid\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n\n/**\n * Get a mapping of camelCase parameter names to their original names\n * Used for mapping function parameters to backend parameter names\n */\nexport function getParamsMapping(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    casing?: 'camelcase'\n  } = {},\n): Record<string, string> | undefined {\n  if (!operationSchema || !operationSchema.schema.properties) {\n    return undefined\n  }\n\n  const allEntries: Array<[string, string]> = []\n  let hasTransformation = false\n\n  Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {\n    let transformedName = originalName\n\n    // Only transform to camelCase if explicitly requested\n    if (options.casing === 'camelcase') {\n      transformedName = camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name and casing not set, still need to make it valid\n      transformedName = camelCase(originalName)\n    }\n\n    allEntries.push([originalName, transformedName])\n\n    if (transformedName !== originalName) {\n      hasTransformation = true\n    }\n  })\n\n  // When using explicit casing and there are transformations, include ALL params so that\n  // mappedParams contains every parameter (not just the ones whose names changed).\n  // This prevents params with already-camelCase names (e.g. 'page', 'search') from being\n  // silently dropped when other params in the same schema do need transformation.\n  if (options.casing === 'camelcase' && hasTransformation) {\n    return Object.fromEntries(allEntries)\n  }\n\n  // When casing is not specified or no transformations are needed, only return changed entries\n  const mapping: Record<string, string> = {}\n  allEntries.forEach(([originalName, transformedName]) => {\n    if (transformedName !== originalName) {\n      mapping[originalName] = transformedName\n    }\n  })\n\n  return Object.keys(mapping).length > 0 ? mapping : undefined\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\nexport type GetSchemasResult = {\n  schemas: Record<string, OasTypes.SchemaObject>\n  /**\n   * Mapping from original component name to resolved name after collision handling\n   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }\n   */\n  nameMapping: Map<string, string>\n}\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n  /**\n   * Whether to resolve name collisions with suffixes.\n   * If not provided, uses oas.options.collisionDetection\n   * @default false (from oas.options or fallback)\n   */\n  collisionDetection?: boolean\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order along with name mapping for collision resolution.\n *\n * This function is a wrapper around the oas.getSchemas() method for backward compatibility.\n * New code should use oas.getSchemas() directly.\n *\n * @deprecated Use oas.getSchemas() instead\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'], collisionDetection }: GetSchemasProps): GetSchemasResult {\n  return oas.getSchemas({\n    contentType,\n    includes,\n    collisionDetection,\n  })\n}\n","import transformers, { isValidVarName } from '@kubb/core/transformers'\nimport type { SchemaObject } from '@kubb/oas'\n\n/**\n * Apply casing transformation to schema properties\n * Only transforms property names, not nested schemas\n */\nexport function applyParamsCasing(schema: SchemaObject, casing: 'camelcase' | undefined): SchemaObject {\n  if (!casing || !schema.properties) {\n    return schema\n  }\n\n  const transformedProperties: Record<string, any> = {}\n  const transformedRequired: string[] = []\n\n  // Transform property names\n  Object.entries(schema.properties).forEach(([originalName, propertySchema]) => {\n    let transformedName = originalName\n\n    if (casing === 'camelcase') {\n      transformedName = transformers.camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name, make it valid\n      transformedName = transformers.camelCase(originalName)\n    }\n\n    transformedProperties[transformedName] = propertySchema\n  })\n\n  // Transform required field names\n  if (Array.isArray(schema.required)) {\n    schema.required.forEach((originalName) => {\n      let transformedName = originalName\n\n      if (casing === 'camelcase') {\n        transformedName = transformers.camelCase(originalName)\n      } else if (!isValidVarName(originalName)) {\n        transformedName = transformers.camelCase(originalName)\n      }\n\n      transformedRequired.push(transformedName)\n    })\n  }\n\n  // Return a new schema with transformed properties and required fields\n  return {\n    ...schema,\n    properties: transformedProperties,\n    ...(transformedRequired.length > 0 && { required: transformedRequired }),\n  } as SchemaObject\n}\n\n/**\n * Check if this schema is a parameter schema (pathParams, queryParams, or headerParams)\n * Only these should be transformed, not response/data/body\n */\nexport function isParameterSchema(schemaName: string): boolean {\n  const lowerName = schemaName.toLowerCase()\n  return lowerName.includes('pathparams') || lowerName.includes('queryparams') || lowerName.includes('headerparams')\n}\n"],"mappings":"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"}

package/dist/utils.js

@@ -75,11 +75,18 @@ function getPathParams(operationSchema, options = {}) {
 */
 function getParamsMapping(operationSchema, options = {}) {
 	if (!operationSchema || !operationSchema.schema.properties) return;
-	const mapping = {};
+	const allEntries = [];
+	let hasTransformation = false;
 	Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {
 		let transformedName = originalName;
 		if (options.casing === "camelcase") transformedName = camelCase(originalName);
 		else if (!isValidVarName(originalName)) transformedName = camelCase(originalName);
+		allEntries.push([originalName, transformedName]);
+		if (transformedName !== originalName) hasTransformation = true;
+	});
+	if (options.casing === "camelcase" && hasTransformation) return Object.fromEntries(allEntries);
+	const mapping = {};
+	allEntries.forEach(([originalName, transformedName]) => {
 		if (transformedName !== originalName) mapping[originalName] = transformedName;
 	});
 	return Object.keys(mapping).length > 0 ? mapping : void 0;

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../src/utils/getComments.ts","../src/utils/getImports.ts","../src/utils/getParams.ts","../src/utils/getSchemas.ts","../src/utils/paramsCasing.ts"],"sourcesContent":["import { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .flatMap((text) => {\n      // Split by newlines to preserve line breaks in JSDoc\n      // Trim each line individually to remove leading/trailing whitespace\n      return text.split(/\\r?\\n/).map((line) => line.trim())\n    })\n    .filter(Boolean)\n}\n","import type { KubbFile } from '@kubb/fabric-core/types'\nimport { SchemaGenerator } from '../SchemaGenerator.ts'\nimport type { Schema } from '../SchemaMapper'\nimport { schemaKeywords } from '../SchemaMapper'\n\n/**\n * Get imports from a schema tree by extracting all ref schemas that are importable\n */\nexport function getImports(tree: Array<Schema>): Array<KubbFile.Import> {\n  const refs = SchemaGenerator.deepSearch(tree, schemaKeywords.ref)\n\n  return refs\n    ?.map((item) => {\n      if (!item.args.path || !item.args.isImportable) {\n        return undefined\n      }\n\n      return {\n        name: [item.args.name],\n        path: item.args.path,\n      }\n    })\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    casing,\n    override,\n  }: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    // Use camelCase name for indexed access if casing is enabled\n    const accessName = casing === 'camelcase' ? camelCase(name) : name\n\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${accessName}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = curr.name\n\n      // Only transform to camelCase if explicitly requested\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      } else if (!isValidVarName(name)) {\n        // If not valid variable name and casing not set, still need to make it valid\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n\n/**\n * Get a mapping of camelCase parameter names to their original names\n * Used for mapping function parameters to backend parameter names\n */\nexport function getParamsMapping(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    casing?: 'camelcase'\n  } = {},\n): Record<string, string> | undefined {\n  if (!operationSchema || !operationSchema.schema.properties) {\n    return undefined\n  }\n\n  const mapping: Record<string, string> = {}\n\n  Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {\n    let transformedName = originalName\n\n    // Only transform to camelCase if explicitly requested\n    if (options.casing === 'camelcase') {\n      transformedName = camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name and casing not set, still need to make it valid\n      transformedName = camelCase(originalName)\n    }\n\n    // Only add mapping if the names differ\n    if (transformedName !== originalName) {\n      mapping[originalName] = transformedName\n    }\n  })\n\n  return Object.keys(mapping).length > 0 ? mapping : undefined\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\nexport type GetSchemasResult = {\n  schemas: Record<string, OasTypes.SchemaObject>\n  /**\n   * Mapping from original component name to resolved name after collision handling\n   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }\n   */\n  nameMapping: Map<string, string>\n}\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n  /**\n   * Whether to resolve name collisions with suffixes.\n   * If not provided, uses oas.options.collisionDetection\n   * @default false (from oas.options or fallback)\n   */\n  collisionDetection?: boolean\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order along with name mapping for collision resolution.\n *\n * This function is a wrapper around the oas.getSchemas() method for backward compatibility.\n * New code should use oas.getSchemas() directly.\n *\n * @deprecated Use oas.getSchemas() instead\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'], collisionDetection }: GetSchemasProps): GetSchemasResult {\n  return oas.getSchemas({\n    contentType,\n    includes,\n    collisionDetection,\n  })\n}\n","import transformers, { isValidVarName } from '@kubb/core/transformers'\nimport type { SchemaObject } from '@kubb/oas'\n\n/**\n * Apply casing transformation to schema properties\n * Only transforms property names, not nested schemas\n */\nexport function applyParamsCasing(schema: SchemaObject, casing: 'camelcase' | undefined): SchemaObject {\n  if (!casing || !schema.properties) {\n    return schema\n  }\n\n  const transformedProperties: Record<string, any> = {}\n  const transformedRequired: string[] = []\n\n  // Transform property names\n  Object.entries(schema.properties).forEach(([originalName, propertySchema]) => {\n    let transformedName = originalName\n\n    if (casing === 'camelcase') {\n      transformedName = transformers.camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name, make it valid\n      transformedName = transformers.camelCase(originalName)\n    }\n\n    transformedProperties[transformedName] = propertySchema\n  })\n\n  // Transform required field names\n  if (Array.isArray(schema.required)) {\n    schema.required.forEach((originalName) => {\n      let transformedName = originalName\n\n      if (casing === 'camelcase') {\n        transformedName = transformers.camelCase(originalName)\n      } else if (!isValidVarName(originalName)) {\n        transformedName = transformers.camelCase(originalName)\n      }\n\n      transformedRequired.push(transformedName)\n    })\n  }\n\n  // Return a new schema with transformed properties and required fields\n  return {\n    ...schema,\n    properties: transformedProperties,\n    ...(transformedRequired.length > 0 && { required: transformedRequired }),\n  } as SchemaObject\n}\n\n/**\n * Check if this schema is a parameter schema (pathParams, queryParams, or headerParams)\n * Only these should be transformed, not response/data/body\n */\nexport function isParameterSchema(schemaName: string): boolean {\n  const lowerName = schemaName.toLowerCase()\n  return lowerName.includes('pathparams') || lowerName.includes('queryparams') || lowerName.includes('headerparams')\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils/getComments.ts","../src/utils/getImports.ts","../src/utils/getParams.ts","../src/utils/getSchemas.ts","../src/utils/paramsCasing.ts"],"sourcesContent":["import { URLPath } from '@kubb/core/utils'\n\nimport type { Operation } from '@kubb/oas'\n\nexport function getComments(operation: Operation): string[] {\n  return [\n    operation.getDescription() && `@description ${operation.getDescription()}`,\n    operation.getSummary() && `@summary ${operation.getSummary()}`,\n    operation.path && `{@link ${new URLPath(operation.path).URL}}`,\n    operation.isDeprecated() && '@deprecated',\n  ]\n    .filter(Boolean)\n    .flatMap((text) => {\n      // Split by newlines to preserve line breaks in JSDoc\n      // Trim each line individually to remove leading/trailing whitespace\n      return text.split(/\\r?\\n/).map((line) => line.trim())\n    })\n    .filter(Boolean)\n}\n","import type { KubbFile } from '@kubb/fabric-core/types'\nimport { SchemaGenerator } from '../SchemaGenerator.ts'\nimport type { Schema } from '../SchemaMapper'\nimport { schemaKeywords } from '../SchemaMapper'\n\n/**\n * Get imports from a schema tree by extracting all ref schemas that are importable\n */\nexport function getImports(tree: Array<Schema>): Array<KubbFile.Import> {\n  const refs = SchemaGenerator.deepSearch(tree, schemaKeywords.ref)\n\n  return refs\n    ?.map((item) => {\n      if (!item.args.path || !item.args.isImportable) {\n        return undefined\n      }\n\n      return {\n        name: [item.args.name],\n        path: item.args.path,\n      }\n    })\n    .filter(Boolean)\n}\n","import { camelCase, isValidVarName } from '@kubb/core/transformers'\nimport type { FunctionParamsAST } from '@kubb/core/utils'\nimport type { OasTypes } from '@kubb/oas'\nimport type { Params } from '@kubb/react-fabric/types'\nimport type { OperationSchema } from '../types.ts'\n/**\n *\n * @deprecated\n * TODO move to operationManager hook\n */\nexport function getASTParams(\n  operationSchema: OperationSchema | undefined,\n  {\n    typed = false,\n    casing,\n    override,\n  }: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n): FunctionParamsAST[] {\n  if (!operationSchema || !operationSchema.schema.properties || !operationSchema.name) {\n    return []\n  }\n\n  const requiredFields = Array.isArray(operationSchema.schema.required) ? operationSchema.schema.required : []\n\n  return Object.entries(operationSchema.schema.properties).map(([name]: [string, OasTypes.SchemaObject]) => {\n    // Use camelCase name for indexed access if casing is enabled\n    const accessName = casing === 'camelcase' ? camelCase(name) : name\n\n    const data: FunctionParamsAST = {\n      name,\n      enabled: !!name,\n      required: requiredFields.includes(name),\n      type: typed ? `${operationSchema.name}[\"${accessName}\"]` : undefined,\n    }\n\n    return override ? override(data) : data\n  })\n}\n\nexport function getPathParams(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    typed?: boolean\n    casing?: 'camelcase'\n    override?: (data: FunctionParamsAST) => FunctionParamsAST\n  } = {},\n) {\n  return getASTParams(operationSchema, options).reduce((acc, curr) => {\n    if (curr.name && curr.enabled) {\n      let name = curr.name\n\n      // Only transform to camelCase if explicitly requested\n      if (options.casing === 'camelcase') {\n        name = camelCase(name)\n      } else if (!isValidVarName(name)) {\n        // If not valid variable name and casing not set, still need to make it valid\n        name = camelCase(name)\n      }\n\n      acc[name] = {\n        default: curr.default,\n        type: curr.type,\n        optional: !curr.required,\n      }\n    }\n\n    return acc\n  }, {} as Params)\n}\n\n/**\n * Get a mapping of camelCase parameter names to their original names\n * Used for mapping function parameters to backend parameter names\n */\nexport function getParamsMapping(\n  operationSchema: OperationSchema | undefined,\n  options: {\n    casing?: 'camelcase'\n  } = {},\n): Record<string, string> | undefined {\n  if (!operationSchema || !operationSchema.schema.properties) {\n    return undefined\n  }\n\n  const allEntries: Array<[string, string]> = []\n  let hasTransformation = false\n\n  Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {\n    let transformedName = originalName\n\n    // Only transform to camelCase if explicitly requested\n    if (options.casing === 'camelcase') {\n      transformedName = camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name and casing not set, still need to make it valid\n      transformedName = camelCase(originalName)\n    }\n\n    allEntries.push([originalName, transformedName])\n\n    if (transformedName !== originalName) {\n      hasTransformation = true\n    }\n  })\n\n  // When using explicit casing and there are transformations, include ALL params so that\n  // mappedParams contains every parameter (not just the ones whose names changed).\n  // This prevents params with already-camelCase names (e.g. 'page', 'search') from being\n  // silently dropped when other params in the same schema do need transformation.\n  if (options.casing === 'camelcase' && hasTransformation) {\n    return Object.fromEntries(allEntries)\n  }\n\n  // When casing is not specified or no transformations are needed, only return changed entries\n  const mapping: Record<string, string> = {}\n  allEntries.forEach(([originalName, transformedName]) => {\n    if (transformedName !== originalName) {\n      mapping[originalName] = transformedName\n    }\n  })\n\n  return Object.keys(mapping).length > 0 ? mapping : undefined\n}\n","import type { contentType, Oas, OasTypes } from '@kubb/oas'\n\nexport type GetSchemasResult = {\n  schemas: Record<string, OasTypes.SchemaObject>\n  /**\n   * Mapping from original component name to resolved name after collision handling\n   * e.g., { 'Order': 'OrderSchema', 'variant': 'variant2' }\n   */\n  nameMapping: Map<string, string>\n}\n\ntype Mode = 'schemas' | 'responses' | 'requestBodies'\n\ntype GetSchemasProps = {\n  oas: Oas\n  contentType?: contentType\n  includes?: Mode[]\n  /**\n   * Whether to resolve name collisions with suffixes.\n   * If not provided, uses oas.options.collisionDetection\n   * @default false (from oas.options or fallback)\n   */\n  collisionDetection?: boolean\n}\n\n/**\n * Collect schemas from OpenAPI components (schemas, responses, requestBodies)\n * and return them in dependency order along with name mapping for collision resolution.\n *\n * This function is a wrapper around the oas.getSchemas() method for backward compatibility.\n * New code should use oas.getSchemas() directly.\n *\n * @deprecated Use oas.getSchemas() instead\n */\nexport function getSchemas({ oas, contentType, includes = ['schemas', 'requestBodies', 'responses'], collisionDetection }: GetSchemasProps): GetSchemasResult {\n  return oas.getSchemas({\n    contentType,\n    includes,\n    collisionDetection,\n  })\n}\n","import transformers, { isValidVarName } from '@kubb/core/transformers'\nimport type { SchemaObject } from '@kubb/oas'\n\n/**\n * Apply casing transformation to schema properties\n * Only transforms property names, not nested schemas\n */\nexport function applyParamsCasing(schema: SchemaObject, casing: 'camelcase' | undefined): SchemaObject {\n  if (!casing || !schema.properties) {\n    return schema\n  }\n\n  const transformedProperties: Record<string, any> = {}\n  const transformedRequired: string[] = []\n\n  // Transform property names\n  Object.entries(schema.properties).forEach(([originalName, propertySchema]) => {\n    let transformedName = originalName\n\n    if (casing === 'camelcase') {\n      transformedName = transformers.camelCase(originalName)\n    } else if (!isValidVarName(originalName)) {\n      // If not valid variable name, make it valid\n      transformedName = transformers.camelCase(originalName)\n    }\n\n    transformedProperties[transformedName] = propertySchema\n  })\n\n  // Transform required field names\n  if (Array.isArray(schema.required)) {\n    schema.required.forEach((originalName) => {\n      let transformedName = originalName\n\n      if (casing === 'camelcase') {\n        transformedName = transformers.camelCase(originalName)\n      } else if (!isValidVarName(originalName)) {\n        transformedName = transformers.camelCase(originalName)\n      }\n\n      transformedRequired.push(transformedName)\n    })\n  }\n\n  // Return a new schema with transformed properties and required fields\n  return {\n    ...schema,\n    properties: transformedProperties,\n    ...(transformedRequired.length > 0 && { required: transformedRequired }),\n  } as SchemaObject\n}\n\n/**\n * Check if this schema is a parameter schema (pathParams, queryParams, or headerParams)\n * Only these should be transformed, not response/data/body\n */\nexport function isParameterSchema(schemaName: string): boolean {\n  const lowerName = schemaName.toLowerCase()\n  return lowerName.includes('pathparams') || lowerName.includes('queryparams') || lowerName.includes('headerparams')\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-oas",
-  "version": "4.31.2",
+  "version": "4.31.4",
   "description": "OpenAPI Specification (OAS) plugin for Kubb, providing core functionality for parsing and processing OpenAPI/Swagger schemas for code generation.",
   "keywords": [
     "openapi",
@@ -83,8 +83,8 @@
   "dependencies": {
     "@kubb/react-fabric": "0.13.3",
     "remeda": "^2.33.6",
-    "@kubb/core": "4.31.2",
-    "@kubb/oas": "4.31.2"
+    "@kubb/core": "4.31.4",
+    "@kubb/oas": "4.31.4"
   },
   "peerDependencies": {
     "@kubb/react-fabric": "0.13.3"

package/src/utils/getParams.ts

@@ -86,7 +86,8 @@ export function getParamsMapping(
     return undefined
   }
 
-  const mapping: Record<string, string> = {}
+  const allEntries: Array<[string, string]> = []
+  let hasTransformation = false
 
   Object.entries(operationSchema.schema.properties).forEach(([originalName]) => {
     let transformedName = originalName
@@ -99,7 +100,24 @@ export function getParamsMapping(
       transformedName = camelCase(originalName)
     }
 
-    // Only add mapping if the names differ
+    allEntries.push([originalName, transformedName])
+
+    if (transformedName !== originalName) {
+      hasTransformation = true
+    }
+  })
+
+  // When using explicit casing and there are transformations, include ALL params so that
+  // mappedParams contains every parameter (not just the ones whose names changed).
+  // This prevents params with already-camelCase names (e.g. 'page', 'search') from being
+  // silently dropped when other params in the same schema do need transformation.
+  if (options.casing === 'camelcase' && hasTransformation) {
+    return Object.fromEntries(allEntries)
+  }
+
+  // When casing is not specified or no transformations are needed, only return changed entries
+  const mapping: Record<string, string> = {}
+  allEntries.forEach(([originalName, transformedName]) => {
     if (transformedName !== originalName) {
       mapping[originalName] = transformedName
     }