@kevinoid/openapi-transformers 0.1.0

package/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright 2016 Kevin Locke <kevin@kevinlocke.name>. All rights reserved.
+
+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:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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.

package/README.md

@@ -0,0 +1,134 @@
+OpenAPI Transformers
+====================
+
+[![Build Status](https://img.shields.io/github/actions/workflow/status/kevinoid/openapi-transformers/node.js.yml?branch=main&style=flat&label=build)](https://github.com/kevinoid/openapi-transformers/actions/workflows/node.js.yml?query=branch%3Amain)
+[![Coverage](https://img.shields.io/codecov/c/github/kevinoid/openapi-transformers/main.svg?style=flat)](https://app.codecov.io/gh/kevinoid/openapi-transformers/branch/main)
+[![Dependency Status](https://img.shields.io/librariesio/release/npm/@kevinoid/openapi-transformers.svg?style=flat)](https://libraries.io/npm/@kevinoid%2Fopenapi-transformers)
+[![Supported Node Version](https://img.shields.io/node/v/@kevinoid/openapi-transformers.svg?style=flat)](https://www.npmjs.com/package/@kevinoid/openapi-transformers)
+[![Version on NPM](https://img.shields.io/npm/v/@kevinoid/openapi-transformers.svg?style=flat)](https://www.npmjs.com/package/@kevinoid/openapi-transformers)
+
+A collection of classes for transforming
+[OpenAPI](https://github.com/OAI/OpenAPI-Specification/) documents,
+particularly for compatibility with code generators like
+[Autorest](https://github.com/Azure/autorest) and [OpenAPI
+Generator](https://openapi-generator.tech/).
+
+
+## Introductory Example
+
+To rename all Schema Objects defined in `components` of an OpenAPI document:
+
+```js
+import RenameComponentsTransformer from '@kevinoid/openapi-transformers';
+import openapi from './openapi.json' with { type: 'json' };
+
+function renameSchema(schemaName) {
+    return `New${schemaName}`;
+}
+
+const transformer = new RenameComponentsTransformer({ schemas: renameSchema });
+console.log(transformer.transformOpenApi(openapi));
+```
+
+
+## Example with [`@kevinoid/openapi-transformer-cli`](https://github.com/kevinoid/openapi-transformer-cli)
+
+To remove `headers` from responses in an OpenAPI document:
+
+```sh
+openapi-transformer -t @kevinoid/openapi-transformers/remove-response-headers.js <openapi-old.json >openapi-new.json
+```
+
+
+## Transformers
+
+| **Transformer**                                                                                      | **Description** |
+| ---------------------------------------------------------------------------------------------------- | --------------- |
+| [AddTagToOperationIdsTransformer](add-tag-to-operation-ids.js)                                       | Prefix `operationId` with the first tag name and an underscore. |
+| [AddXMsEnumNameTransformer](add-x-ms-enum-name.js)                                                   | Add `x-ms-enum.name` from schema name, if not present. |
+| [AddXMsEnumValueNamesTransformer](add-x-ms-enum-value-names.js)                                      | Add `x-ms-enum.values.name` to enums where the name generated by Autorest differs from the Microsoft C# Capitalization Rules for Identifiers. |
+| [AdditionalPropertiesToObjectTransformer](additional-properties-to-object.js)                        | Replace boolean `additionalProperties` with a Schema. |
+| [AdditionalPropertiesToUnconstrainedTransformer](additional-properties-to-unconstrained.js)          | Replace `additionalProperties` (and `patternProperties`) with an unconstrained schema alongside other properties. |
+| [AnyOfNullToNullableTransformer](any-of-null-to-nullable.js)                                         | Replace `type: 'null'` in `anyOf` with `nullable: true` (for OAS 3.0). |
+| [BinaryStringToFileTransformer](binary-string-to-file.js)                                            | Replace `type: string` with `format: binary` (or `format: file`) with `type: file`. |
+| [BoolEnumToBoolTransformer](bool-enum-to-bool.js)                                                    | Replace `enum: [true, false]` with `type: boolean`. |
+| [ClearHtmlResponseSchemaTransformer](clear-html-response-schema.js)                                  | Remove response content for the `text/html` media type. |
+| [ClientParamsToGlobalTransformer](client-params-to-global.js)                                        | Move parameters with `x-ms-parameter-location: client` defined on Path Item Objects and Operation Objects to the Components or Definitions Object. |
+| [ConstToEnumTransformer](const-to-enum.js)                                                           | Convert Schema Objects with `const` to `enum`. |
+| [AssertPropertiesTransformer](assert-properties.js)                                                  | Throw an `Error` when given properties are present. |
+| [EscapeEnumValuesTransformer](escape-enum-values.js)                                                 | Escape string enum values appropriately for C# string literals. |
+| [ExclusiveMinMaxToBoolTransformer](exclusive-min-max-to-bool.js)                                     | Convert Schema Objects with numeric values for `exclusiveMaximum` and/or `exclusiveMinimum` to boolean values with corresponding `maximum` and/or `minimum`. |
+| [FormatToTypeTransformer](format-to-type.js)                                                         | Convert known formats in an OAS3 doc to types. |
+| [InlineNonObjectSchemaTransformer](inline-non-object-schemas.js)                                     | Inline schemas with non-object type. |
+| [MergeAllOfTransformer](merge-all-of.js)                                                             | Merge `allOf` schemas into the parent schema. |
+| [MergeAnyOfTransformer](merge-any-of.js)                                                             | Merge `anyOf` schemas into the parent schema. |
+| [MergeOneOfTransformer](merge-one-of.js)                                                             | Merge `oneOf` schemas into the parent schema. |
+| [NullableNotRequiredTransformer](nullable-not-required.js)                                           | Make properties which are `nullable` non-`required`. |
+| [NullableToTypeNullTransformer](nullable-to-type-null.js)                                            | Add `'null'` to `type` of Schema Objects with `nullable: true` or `x-nullable: true`. |
+| [OpenApi31To30Transformer](openapi31to30.js)                                                         | Convert an OpenAPI 3.1.* document to OpenAPI 3.0.3. |
+| [PathParametersToOperationTransformer](path-parameters-to-operations.js)                             | Move parameters defined on Path Item Objects to the beginning of the parameters array of the Operation Objects. |
+| [PatternPropertiesToAdditionalPropertiesTransformer](pattern-properties-to-additional-properties.js) | Combine any `patternProperties` into `additionalProperties`. |
+| [QueriesToXMsPathsTransformer](queries-to-x-ms-paths.js)                                             | Move paths with query parameters from `paths` to `x-ms-paths`. |
+| [ReadOnlyNotRequiredTransformer](read-only-not-required.js)                                          | Ensure `readOnly` schema properties are not `required`. |
+| [RefPathParametersTransformer](ref-path-parameters.js)                                               | Move Parameters defined on Path Item Objects to global parameters which are referenced in the Path Item. |
+| [RemoveDefaultOnlyResponseProducesTransformer](remove-default-only-response-produces.js)             | Remove `produces` from Operations with only a default response. |
+| [RemovePathsWithServersTransformer](remove-paths-with-servers.js)                                    | Remove Path Item Objects which have `servers`. |
+| [RemoveQueryFromPathsTransformer](remove-query-from-paths.js)                                        | Remove query component of path in Paths Object. |
+| [RemoveRefSiblingsTransformer](remove-ref-siblings.js)                                               | Remove properties from Reference Objects. |
+| [RemoveRequestBodyTransformer](remove-request-body.js)                                               | Remove `requestBody` from operations on a given set of HTTP methods. |
+| [RemoveResponseHeadersTransformer](remove-response-headers.js)                                       | Remove `headers` from Response objects.
+| [RemoveSecuritySchemeIfTransformer](remove-security-scheme-if.js)                                    | Remove `security` schemes matching a given predicate. |
+| [RemoveTypeIfTransformer](remove-type-if.js)                                                         | Remove `type` from Schema Objects where `type` matches a given predicate. |
+| [RenameComponentsTransformer](rename-components.js)                                                  | Rename `components`. |
+| [ReplacedByToDescriptionTransformer](replaced-by-to-description.js)                                  | Convert `x-deprecated.replaced-by` to `x-deprecated.description`, if not present. |
+| [ServerVarsToPathParamsTransformer](server-vars-to-path-params.js)                                   | Convert Server Variables in path portion to Parameters on Path Item Objects. |
+| [ServerVarsToParamHostTransformer](server-vars-to-x-ms-parameterized-host.js)                        | Convert Server Variables in host portion to `x-ms-parameterized-host`. |
+| [TypeNullToEnumTransformer](type-null-to-enum.js)                                                    | Convert Schema Objects with `type: 'null'` to `enum: [null]`. |
+| [TypeNullToNullableTransformer](type-null-to-nullable.js)                                            | Convert Schema Objects with `'null'` in `type` to `nullable: true`. |
+| [UrlencodedToStringTransformer](urlencoded-to-string.js)                                             | Change request parameter types to string for operations which only consume `application/x-www-form-urlencoded`. |
+| [XEnumToXMsEnumTransformer](x-enum-to-ms.js)                                                         | Convert `x-enum-descriptions` and `x-enum-varnames` to `x-ms-enum`. |
+
+
+## Installation
+
+[This package](https://www.npmjs.com/package/@kevinoid/openapi-transformers) can be
+installed using [npm](https://www.npmjs.com/), either globally or locally, by
+running:
+
+```sh
+npm install @kevinoid/openapi-transformers
+```
+
+
+## Recipes
+
+More examples can be found in the [test
+specifications](https://kevinoid.github.io/openapi-transformers/spec).
+
+
+## API Docs
+
+To use this module as a library, see the [API
+Documentation](https://kevinoid.github.io/openapi-transformers/api).
+
+
+## Contributing
+
+Contributions are appreciated.  Contributors agree to abide by the [Contributor
+Covenant Code of
+Conduct](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html).
+If this is your first time contributing to a Free and Open Source Software
+project, consider reading [How to Contribute to Open
+Source](https://opensource.guide/how-to-contribute/)
+in the Open Source Guides.
+
+If the desired change is large, complex, backwards-incompatible, can have
+significantly differing implementations, or may not be in scope for this
+project, opening an issue before writing the code can avoid frustration and
+save a lot of time and effort.
+
+
+## License
+
+This project is available under the terms of the [MIT License](LICENSE.txt).
+See the [summary at TLDRLegal](https://tldrlegal.com/license/mit-license).

package/add-tag-to-operation-ids.js

@@ -0,0 +1,60 @@
+/**
+ * @copyright Copyright 2019 Kevin Locke <kevin@kevinlocke.name>
+ * @license MIT
+ * @module "openapi-transformers/add-tag-to-operation-ids.js"
+ */
+
+import { debuglog } from 'node:util';
+
+import OpenApiTransformerBase from 'openapi-transformer-base';
+
+const debug = debuglog('add-tag-to-operation-ids');
+
+/**
+ * Transformer to prefix operationId with the first tag name and an underscore,
+ * which Autorest recognizes as an "operation group" represented by a separate
+ * API class when generating the client.
+ *
+ * See https://github.com/Azure/autorest/issues/1497#issuecomment-252082163
+ */
+export default class AddTagToOperationIdsTransformer
+  extends OpenApiTransformerBase {
+  constructor({ tagSuffix = '' } = {}) {
+    super();
+    this.tagSuffix = String(tagSuffix);
+  }
+
+  transformOperation(op) {
+    if (op === null || typeof op !== 'object') {
+      debug('Not adding tag to non-object operation %O', op);
+      return op;
+    }
+
+    const { tags } = op;
+    if (!Array.isArray(tags) || tags.length === 0) {
+      debug('No tag to add for operation %O', op);
+      return op;
+    }
+
+    const { operationId } = op;
+    if (operationId === undefined
+      || operationId === null
+      || operationId === '') {
+      debug('No operationId to add for operation %O', op);
+      return op;
+    }
+
+    return {
+      ...op,
+      operationId: `${tags[0]}${this.tagSuffix}_${operationId}`,
+    };
+  }
+
+  // Override as performance optimization, since only transforming paths
+  transformOpenApi(spec) {
+    return {
+      ...spec,
+      paths: this.transformPaths(spec.paths),
+    };
+  }
+}

package/add-x-ms-enum-name.js

@@ -0,0 +1,96 @@
+/**
+ * @copyright Copyright 2019 Kevin Locke <kevin@kevinlocke.name>
+ * @license MIT
+ * @module "openapi-transformers/add-x-ms-enum-name.js"
+ */
+
+import OpenApiTransformerBase from 'openapi-transformer-base';
+
+/**
+ * Transformer to add x-ms-enum.name from schema name, if not present
+ * (so Autorest will generate enum types).
+ *
+ * https://github.com/Azure/autorest/tree/master/docs/extensions#x-ms-enum
+ */
+export default class AddXMsEnumNameTransformer extends OpenApiTransformerBase {
+  // eslint-disable-next-line class-methods-use-this
+  transformSchema(schema, schemaName) {
+    if (!schema.enum || (schema['x-ms-enum'] && schema['x-ms-enum'].name)) {
+      return schema;
+    }
+
+    return {
+      ...schema,
+      'x-ms-enum': {
+        ...schema['x-ms-enum'],
+        name: schemaName,
+      },
+    };
+  }
+
+  /** Transforms Map[string,Schema] with named schemas by passing the
+   * name as the second argument to transformSchema.
+   *
+   * @param {!Object<string,object>|*} schemas Schmea map to transform.
+   * @returns {!Object<string,object>|*} If obj is a Map, a plain object with
+   * the same own enumerable string-keyed properties as obj with values
+   * returned by transformSchema.  Otherwise, obj is returned unchanged.
+   */
+  transformSchemas(schemas) {
+    if (typeof schemas !== 'object'
+      || schemas === null
+      || Array.isArray(schemas)) {
+      return schemas;
+    }
+
+    const newSchemas = { ...schemas };
+    for (const [schemaName, schema] of Object.entries(schemas)) {
+      if (schema !== undefined) {
+        newSchemas[schemaName] = this.transformSchema(schema, schemaName);
+      }
+    }
+
+    return newSchemas;
+  }
+
+  // Optimization: Only transform schemas
+  transformComponents(components) {
+    if (!components) {
+      return components;
+    }
+
+    const { schemas } = components;
+    if (!schemas) {
+      return components;
+    }
+
+    return {
+      ...components,
+      schemas: this.transformSchemas(schemas),
+    };
+  }
+
+  // Optimization: Only transform components/definitions
+  transformOpenApi(openApi) {
+    if (!openApi) {
+      return openApi;
+    }
+
+    const { components, definitions } = openApi;
+    if (!components && !definitions) {
+      return openApi;
+    }
+
+    const newOpenApi = { ...openApi };
+
+    if (components) {
+      newOpenApi.components = this.transformComponents(components);
+    }
+
+    if (definitions) {
+      newOpenApi.definitions = this.transformSchemas(definitions);
+    }
+
+    return newOpenApi;
+  }
+}

package/add-x-ms-enum-value-names.js

@@ -0,0 +1,142 @@
+/**
+ * @copyright Copyright 2019 Kevin Locke <kevin@kevinlocke.name>
+ * @license MIT
+ * @module "openapi-transformers/add-x-ms-enum-value-names.js"
+ */
+
+import assert from 'node:assert';
+
+import dotnetCase from '@kevinoid/dotnet-identifier-case';
+import OpenApiTransformerBase from 'openapi-transformer-base';
+
+assert.ok(/\p{L}/u.test('X'), 'Unicode property escapes are supported.');
+
+function firstToLower(word) {
+  if (!word) {
+    return word;
+  }
+
+  // Lower-case 2-letter acronym together (as Autorest does)
+  if (word.length === 2 && word === word.toUpperCase()) {
+    return word.toLowerCase();
+  }
+
+  return word.charAt(0).toLowerCase() + word.slice(1);
+}
+
+function firstToUpper(word) {
+  if (!word) {
+    return word;
+  }
+
+  return word.charAt(0).toUpperCase() + word.slice(1);
+}
+
+/** Returns the enum member name which would be used by Autorest.
+ * https://github.com/Azure/autorest.common/blob/54c21af/src/CodeNamer.cs#L178
+ *
+ * @private
+ */
+function autorestEnumMemberName(value) {
+  const clean = value.replaceAll(/[^\p{L}\p{N}_-]/gu, '');
+  const words = clean.split(/[_-]/);
+
+  if (clean.charAt(0) === '_') {
+    // eslint-disable-next-line prefer-template
+    return '_' + words
+      .map((word, i) => (i > 0 ? firstToUpper(word) : firstToLower(word)))
+      .join('');
+  }
+
+  return words
+    .map(firstToUpper)
+    .join('');
+}
+
+function addXMsEnumValueNamesToSchema(schema) {
+  if (!schema.enum || !schema['x-ms-enum']) {
+    // Schema won't generate an enum
+    return schema;
+  }
+
+  const xMsEnum = schema['x-ms-enum'];
+  const xMsEnumValues = xMsEnum.values;
+  if (xMsEnumValues
+    && xMsEnumValues.every((v) => v.name !== null && v.name !== undefined)) {
+    // Names already specified for all values
+    return schema;
+  }
+
+  const values =
+    Array.isArray(xMsEnumValues) ? xMsEnumValues.map((v) => v.value)
+      : schema.enum;
+  const stringValues = values.map(String);
+  const autorestNames = stringValues.map(autorestEnumMemberName);
+  const microsoftNames = stringValues.map(dotnetCase);
+
+  let anyNameChanged = false;
+  let newXMsEnumValues;
+  if (Array.isArray(xMsEnumValues)) {
+    newXMsEnumValues = xMsEnumValues.map((xMsEnumValue, i) => {
+      if (xMsEnumValue.name !== null && xMsEnumValue.name !== undefined) {
+        return xMsEnumValue;
+      }
+
+      const autorestName = autorestNames[i];
+      const microsoftName = microsoftNames[i];
+      if (autorestName === microsoftName) {
+        return xMsEnumValue;
+      }
+
+      anyNameChanged = true;
+      return {
+        ...xMsEnumValue,
+        name: microsoftName,
+      };
+    });
+  } else {
+    newXMsEnumValues = schema.enum.map((value, i) => {
+      const autorestName = autorestNames[i];
+      const microsoftName = microsoftNames[i];
+      const newXMsEnumValue = { value };
+      if (autorestName !== microsoftName) {
+        anyNameChanged = true;
+        newXMsEnumValue.name = microsoftName;
+      }
+      return newXMsEnumValue;
+    });
+  }
+
+  if (!anyNameChanged) {
+    return schema;
+  }
+
+  return {
+    ...schema,
+    'x-ms-enum': {
+      ...xMsEnum,
+      values: newXMsEnumValues,
+    },
+  };
+}
+
+/**
+ * Transformer to add x-ms-enum.values.name to enums where the name generated by
+ * Autorest differs from the Microsoft C# Capitalization Rules for Identifiers.
+ *
+ * https://github.com/Azure/autorest/issues/3328
+ */
+export default class AddXMsEnumValueNamesTransformer
+  extends OpenApiTransformerBase {
+  transformSchema(schema) {
+    return addXMsEnumValueNamesToSchema(
+      super.transformSchema(schema),
+    );
+  }
+
+  transformParameter(parameter) {
+    return addXMsEnumValueNamesToSchema(
+      super.transformParameter(parameter),
+    );
+  }
+}

package/additional-properties-to-object.js

@@ -0,0 +1,35 @@
+/**
+ * @copyright Copyright 2019 Kevin Locke <kevin@kevinlocke.name>
+ * @license MIT
+ * @module "openapi-transformers/additional-properties-to-object.js"
+ */
+
+import OpenApiTransformerBase from 'openapi-transformer-base';
+
+/**
+ * Transformer to replace boolean additionalProperties with an object schema to
+ * work around https://github.com/Azure/autorest/issues/3439.
+ */
+export default class AdditionalPropertiesToObjectTransformer
+  extends OpenApiTransformerBase {
+  transformSchema(schema) {
+    if (typeof schema !== 'object' || schema === null) {
+      return schema;
+    }
+
+    const newSchema = super.transformSchema(schema);
+    const { additionalProperties } = newSchema;
+
+    if (typeof additionalProperties !== 'boolean') {
+      return newSchema;
+    }
+
+    return {
+      ...newSchema,
+
+      // Use schema equivalents described by current spec author Henry Andrews
+      // https://groups.google.com/d/msg/json-schema/Es0fEf3hj2Y/MxWmgercBAAJ
+      additionalProperties: additionalProperties ? {} : { not: {} },
+    };
+  }
+}

package/additional-properties-to-unconstrained.js

@@ -0,0 +1,115 @@
+/**
+ * @copyright Copyright 2019-2020 Kevin Locke <kevin@kevinlocke.name>
+ * @license MIT
+ * @module "openapi-transformers/additional-properties-to-unconstrained.js"
+ */
+
+import OpenApiTransformerBase from 'openapi-transformer-base';
+
+/** Applies a predicate to each schema which contributes to the generated
+ * type of a given schema.
+ *
+ * @private
+ */
+function someCombinedSchema(schema, predicate) {
+  if (predicate(schema)) {
+    return true;
+  }
+
+  if (typeof schema !== 'object' || schema === null) {
+    return false;
+  }
+
+  if (['then', 'else'].some(
+    (key) => someCombinedSchema(schema[key], predicate),
+  )) {
+    return true;
+  }
+
+  return ['allOf', 'anyOf', 'oneOf'].some(
+    (key) => Array.isArray(schema[key])
+      && schema[key].some((s) => someCombinedSchema(s, predicate)),
+  );
+}
+
+/** Replaces additionalProperties (and patternProperties) in each schema which
+ * contributes to the generated type of a given schema.
+ *
+ * @private
+ */
+function replaceAdditionalProperties(schema) {
+  if (typeof schema !== 'object' || schema === null) {
+    return schema;
+  }
+
+  const newSchema = { ...schema };
+
+  for (const key of ['additionalProperties', 'patternProperties']) {
+    const propSchema = newSchema[key];
+    if (typeof propSchema === 'object' && propSchema !== null) {
+      // Note: Use {} instead of true to work around
+      // https://github.com/Azure/autorest/issues/3439 and
+      // https://github.com/Azure/autorest/issues/2564 (marked fixed, but fix
+      // only covers additionalProperties on top-level schemas)
+      newSchema[key] = {};
+    }
+  }
+
+  for (const key of ['then', 'else']) {
+    if (newSchema[key] !== undefined) {
+      newSchema[key] = replaceAdditionalProperties(newSchema[key]);
+    }
+  }
+
+  for (const key of ['allOf', 'anyOf', 'oneOf']) {
+    if (Array.isArray(newSchema[key])) {
+      newSchema[key] = newSchema[key].map(replaceAdditionalProperties);
+    }
+  }
+
+  return newSchema;
+}
+
+/** Does a schema describe an object with at least one property?
+ *
+ * @private
+ */
+function hasProperties(schema) {
+  return schema
+    && schema.properties
+    && Object.keys(schema.properties).length > 0;
+}
+
+/** Does a schema describe an object with constrained additionalProperties
+ * (or patternProperties)?
+ *
+ * @private
+ */
+function hasConstrainedAdditionalProps(schema) {
+  return schema
+    && ((schema.additionalProperties
+      && Object.keys(schema.additionalProperties).length > 0)
+    || (schema.patternProperties
+      && Object.keys(schema.patternProperties).length > 0));
+}
+
+/**
+ * Transformer to replace additionalProperties (and patternProperties) with an
+ * unconstrained schema alongside other properties to work around
+ * https://github.com/Azure/autorest/issues/2469
+ */
+export default class AdditionalPropertiesToUnconstrainedTransformer
+  extends OpenApiTransformerBase {
+  transformSchema(schema) {
+    let newSchema;
+    if (someCombinedSchema(schema, hasConstrainedAdditionalProps)
+      && someCombinedSchema(schema, hasProperties)) {
+      newSchema = replaceAdditionalProperties(schema);
+    } else {
+      newSchema = schema;
+    }
+
+    // Search for additionalProperties in child schemas
+    return super.transformSchema(newSchema);
+  }
+}

package/any-of-null-to-nullable.js

@@ -0,0 +1,50 @@
+/**
+ * @copyright Copyright 2025 Kevin Locke <kevin@kevinlocke.name>
+ * @license MIT
+ * @module "openapi-transformers/any-of-null-to-nullable.js"
+ */
+
+import { isDeepStrictEqual } from 'node:util';
+
+import OpenApiTransformerBase from 'openapi-transformer-base';
+
+/**
+ * Transformer to convert Schema Objects with `type: 'null'` in `anyOf` (as in
+ * OAS 3.1 and JSON Schema) to `nullable: true` (as in OAS 3.0).
+ */
+export default class AnyOfNullToNullableTransformer
+  extends OpenApiTransformerBase {
+  transformSchema(schema) {
+    const newSchema = super.transformSchema(schema);
+    if (newSchema === null
+      || typeof newSchema !== 'object'
+      || Array.isArray(newSchema)) {
+      return newSchema;
+    }
+
+    const { anyOf, nullable } = newSchema;
+    if (nullable !== undefined && nullable !== true) {
+      return newSchema;
+    }
+
+    if (!Array.isArray(anyOf) || anyOf.length < 2) {
+      return newSchema;
+    }
+
+    const anyOfNoNull =
+      anyOf.filter((s) => !isDeepStrictEqual(s, { type: 'null' }));
+    if (anyOfNoNull.length === anyOf.length) {
+      return newSchema;
+    }
+
+    if (anyOfNoNull.length === 0) {
+      return newSchema;
+    }
+
+    return {
+      ...newSchema,
+      nullable: true,
+      anyOf: anyOfNoNull,
+    };
+  }
+}