oas 20.8.9 → 20.9.0

package/dist/lib/helpers.d.ts

@@ -1,3 +1,4 @@
 import type { SchemaObject } from 'rmoas.types';
 export declare function hasSchemaType(schema: SchemaObject, discriminator: 'array' | 'object'): boolean;
+export declare function isObject(val: unknown): boolean;
 export declare function isPrimitive(val: unknown): boolean;

package/dist/lib/helpers.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPrimitive = exports.hasSchemaType = void 0;
+exports.isPrimitive = exports.isObject = exports.hasSchemaType = void 0;
 function hasSchemaType(schema, discriminator) {
     if (Array.isArray(schema.type)) {
         return schema.type.includes(discriminator);
@@ -8,6 +8,10 @@ function hasSchemaType(schema, discriminator) {
     return schema.type === discriminator;
 }
 exports.hasSchemaType = hasSchemaType;
+function isObject(val) {
+    return typeof val === 'object' && val !== null && !Array.isArray(val);
+}
+exports.isObject = isObject;
 function isPrimitive(val) {
     return typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean';
 }

package/dist/lib/openapi-to-json-schema.d.ts

@@ -1,5 +1,4 @@
 import * as RMOAS from '../rmoas.types';
-type PrevSchemasType = RMOAS.SchemaObject[];
 export interface toJSONSchemaOptions {
     /**
      * Whether or not to extend descriptions with a list of any present enums.
@@ -26,9 +25,13 @@ export interface toJSONSchemaOptions {
      */
     isPolymorphicAllOfChild?: boolean;
     /**
-     * Array of parent schemas to utilize when attempting to path together examples.
+     * Array of parent `default` schemas to utilzie when attempting to path together schema defaults.
      */
-    prevSchemas?: PrevSchemasType;
+    prevDefaultSchemas?: RMOAS.SchemaObject[];
+    /**
+     * Array of parent `example` schemas to utilize when attempting to path together schema examples.
+     */
+    prevExampleSchemas?: RMOAS.SchemaObject[];
     /**
      * A function that's called anytime a (circular) `$ref` is found.
      */
@@ -78,4 +81,3 @@ export declare function getSchemaVersionString(schema: RMOAS.SchemaObject, api:
  * @param data OpenAPI Schema Object to convert to pure JSON Schema.
  */
 export default function toJSONSchema(data: RMOAS.SchemaObject | boolean, opts?: toJSONSchemaOptions): RMOAS.SchemaObject;
-export {};

package/dist/lib/openapi-to-json-schema.js

@@ -141,8 +141,8 @@ function isRequestBodySchema(schema) {
     return 'content' in schema;
 }
 /**
- * Given a JSON pointer and an array of examples do a reverse search through them until we find the
- * JSON pointer, or part of it, within the array.
+ * Given a JSON pointer, a type of property to look for, and an array of schemas do a reverse
+ * search through them until we find the JSON pointer, or part of it, within the array.
  *
  * This function will allow you to take a pointer like `/tags/name` and return back `buster` from
  * the following array:
@@ -170,12 +170,13 @@ function isRequestBodySchema(schema) {
  * it shouldn't raise immediate cause for alarm.
  *
  * @see {@link https://tools.ietf.org/html/rfc6901}
+ * @param property Specific type of schema property to look for a value for.
  * @param pointer JSON pointer to search for an example for.
- * @param examples Array of previous schemas we've found relating to this pointer.
+ * @param schemas Array of previous schemas we've found relating to this pointer.
  */
-function searchForExampleByPointer(pointer, examples) {
-    if (examples === void 0) { examples = []; }
-    if (!examples.length || !pointer.length) {
+function searchForValueByPropAndPointer(property, pointer, schemas) {
+    if (schemas === void 0) { schemas = []; }
+    if (!schemas.length || !pointer.length) {
         return undefined;
     }
     var locSplit = pointer.split('/').filter(Boolean).reverse();
@@ -185,38 +186,43 @@ function searchForExampleByPointer(pointer, examples) {
         point = "/".concat(locSplit[i]).concat(point);
         pointers.push(point);
     }
-    var example;
-    var rev = __spreadArray([], examples, true).reverse();
+    var foundValue;
+    var rev = __spreadArray([], schemas, true).reverse();
     for (var i = 0; i < pointers.length; i += 1) {
         for (var ii = 0; ii < rev.length; ii += 1) {
             var schema = rev[ii];
-            if ('example' in schema) {
-                schema = schema.example;
+            if (property === 'example') {
+                if ('example' in schema) {
+                    schema = schema.example;
+                }
+                else {
+                    if (!Array.isArray(schema.examples) || !schema.examples.length) {
+                        continue;
+                    }
+                    // Prevent us from crashing if `examples` is a completely empty object.
+                    schema = __spreadArray([], schema.examples, true).shift();
+                }
             }
             else {
-                if (!Array.isArray(schema.examples) || !schema.examples.length) {
-                    continue;
-                }
-                // Prevent us from crashing if `examples` is a completely empty object.
-                schema = __spreadArray([], schema.examples, true).shift();
+                schema = schema.default;
             }
             try {
-                example = jsonpointer_1.default.get(schema, pointers[i]);
+                foundValue = jsonpointer_1.default.get(schema, pointers[i]);
             }
             catch (err) {
                 // If the schema we're looking at is `{obj: null}` and our pointer is `/obj/propertyName`
                 // `jsonpointer` will throw an error. If that happens, we should silently catch and toss it
                 // and return no example.
             }
-            if (example !== undefined) {
+            if (foundValue !== undefined) {
                 break;
             }
         }
-        if (example !== undefined) {
+        if (foundValue !== undefined) {
             break;
         }
     }
-    return example;
+    return foundValue;
 }
 /**
  * Given an OpenAPI-flavored JSON Schema, make an effort to modify it so it's shaped more towards
@@ -258,7 +264,7 @@ function toJSONSchema(data, opts) {
     if (opts === void 0) { opts = {}; }
     var schema = data === true ? {} : __assign({}, data);
     var schemaAdditionalProperties = RMOAS.isSchema(schema) ? schema.additionalProperties : null;
-    var _a = __assign({ addEnumsToDescriptions: false, currentLocation: '', globalDefaults: {}, hideReadOnlyProperties: false, hideWriteOnlyProperties: false, isPolymorphicAllOfChild: false, prevSchemas: [], refLogger: function () { return true; }, transformer: function (s) { return s; } }, opts), addEnumsToDescriptions = _a.addEnumsToDescriptions, currentLocation = _a.currentLocation, globalDefaults = _a.globalDefaults, hideReadOnlyProperties = _a.hideReadOnlyProperties, hideWriteOnlyProperties = _a.hideWriteOnlyProperties, isPolymorphicAllOfChild = _a.isPolymorphicAllOfChild, prevSchemas = _a.prevSchemas, refLogger = _a.refLogger, transformer = _a.transformer;
+    var _a = __assign({ addEnumsToDescriptions: false, currentLocation: '', globalDefaults: {}, hideReadOnlyProperties: false, hideWriteOnlyProperties: false, isPolymorphicAllOfChild: false, prevDefaultSchemas: [], prevExampleSchemas: [], refLogger: function () { return true; }, transformer: function (s) { return s; } }, opts), addEnumsToDescriptions = _a.addEnumsToDescriptions, currentLocation = _a.currentLocation, globalDefaults = _a.globalDefaults, hideReadOnlyProperties = _a.hideReadOnlyProperties, hideWriteOnlyProperties = _a.hideWriteOnlyProperties, isPolymorphicAllOfChild = _a.isPolymorphicAllOfChild, prevDefaultSchemas = _a.prevDefaultSchemas, prevExampleSchemas = _a.prevExampleSchemas, refLogger = _a.refLogger, transformer = _a.transformer;
     // If this schema contains a `$ref`, it's circular and we shouldn't try to resolve it. Just
     // return and move along.
     if (RMOAS.isRef(schema)) {
@@ -337,7 +343,8 @@ function toJSONSchema(data, opts) {
                         hideReadOnlyProperties: hideReadOnlyProperties,
                         hideWriteOnlyProperties: hideWriteOnlyProperties,
                         isPolymorphicAllOfChild: false,
-                        prevSchemas: prevSchemas,
+                        prevDefaultSchemas: prevDefaultSchemas,
+                        prevExampleSchemas: prevExampleSchemas,
                         refLogger: refLogger,
                         transformer: transformer,
                     };
@@ -496,6 +503,9 @@ function toJSONSchema(data, opts) {
         }
     }
     if (RMOAS.isSchema(schema, isPolymorphicAllOfChild)) {
+        if ('default' in schema && (0, helpers_1.isObject)(schema.default)) {
+            prevDefaultSchemas.push({ default: schema.default });
+        }
         // JSON Schema doesn't support OpenAPI-style examples so we need to reshape them a bit.
         if ('example' in schema) {
             // Only bother adding primitive examples.
@@ -509,7 +519,7 @@ function toJSONSchema(data, opts) {
                 }
             }
             else {
-                prevSchemas.push({ example: schema.example });
+                prevExampleSchemas.push({ example: schema.example });
             }
             delete schema.example;
         }
@@ -535,9 +545,9 @@ function toJSONSchema(data, opts) {
                         }
                         else {
                             // If this example is neither a primitive or an array we should dump it into the
-                            // `prevSchemas` array because we might be able to extract an example from it further
-                            // downstream.
-                            prevSchemas.push({
+                            // `prevExampleSchemas` array because we might be able to extract an example from it
+                            // further downstream.
+                            prevExampleSchemas.push({
                                 example: example.value,
                             });
                         }
@@ -561,7 +571,7 @@ function toJSONSchema(data, opts) {
         // find one. But as we're only looking for primitive example, only try to search for one if
         // we're dealing with a primitive schema.
         if (!(0, helpers_1.hasSchemaType)(schema, 'array') && !(0, helpers_1.hasSchemaType)(schema, 'object') && !schema.examples) {
-            var foundExample = searchForExampleByPointer(currentLocation, prevSchemas);
+            var foundExample = searchForValueByPropAndPointer('example', currentLocation, prevExampleSchemas);
             if (foundExample) {
                 // We can only really deal with primitives, so only promote those as the found example if
                 // it is.
@@ -585,7 +595,7 @@ function toJSONSchema(data, opts) {
                         globalDefaults: globalDefaults,
                         hideReadOnlyProperties: hideReadOnlyProperties,
                         hideWriteOnlyProperties: hideWriteOnlyProperties,
-                        prevSchemas: prevSchemas,
+                        prevExampleSchemas: prevExampleSchemas,
                         refLogger: refLogger,
                         transformer: transformer,
                     });
@@ -615,7 +625,8 @@ function toJSONSchema(data, opts) {
                             globalDefaults: globalDefaults,
                             hideReadOnlyProperties: hideReadOnlyProperties,
                             hideWriteOnlyProperties: hideWriteOnlyProperties,
-                            prevSchemas: prevSchemas,
+                            prevDefaultSchemas: prevDefaultSchemas,
+                            prevExampleSchemas: prevExampleSchemas,
                             refLogger: refLogger,
                             transformer: transformer,
                         });
@@ -661,7 +672,8 @@ function toJSONSchema(data, opts) {
                         globalDefaults: globalDefaults,
                         hideReadOnlyProperties: hideReadOnlyProperties,
                         hideWriteOnlyProperties: hideWriteOnlyProperties,
-                        prevSchemas: prevSchemas,
+                        prevDefaultSchemas: prevDefaultSchemas,
+                        prevExampleSchemas: prevExampleSchemas,
                         refLogger: refLogger,
                         transformer: transformer,
                     });
@@ -713,21 +725,40 @@ function toJSONSchema(data, opts) {
     }
     // Only add a default value if we actually have one.
     if ('default' in schema && typeof schema.default !== 'undefined') {
-        // If it's an enum and not the response schema, add the default to the description.
-        // If there's an existing description, trim trailing new lines so it doesn't look ugly.
-        if ('enum' in schema && !addEnumsToDescriptions) {
-            schema.description = schema.description
-                ? "".concat(schema.description.replace(/\n$/, ''), "\n\nDefault: `").concat(schema.default, "`")
-                : "Default: ".concat(schema.default);
-        }
-        if (('allowEmptyValue' in schema && schema.allowEmptyValue && schema.default === '') || schema.default !== '') {
-            // If we have `allowEmptyValue` present, and the default is actually an empty string, let it
-            // through as it's allowed.
+        if ((0, helpers_1.hasSchemaType)(schema, 'object')) {
+            // Defaults for `object` and types have been dereferenced into their children schemas already
+            // above so we don't need to preserve this default anymore.
+            delete schema.default;
         }
         else {
-            // If the default is empty and we don't want to allowEmptyValue, we need to remove the
-            // default.
-            delete schema.default;
+            // If it's an enum and not the response schema, add the default to the description.
+            // If there's an existing description, trim trailing new lines so it doesn't look ugly.
+            if ('enum' in schema && !addEnumsToDescriptions) {
+                schema.description = schema.description
+                    ? "".concat(schema.description.replace(/\n$/, ''), "\n\nDefault: `").concat(schema.default, "`")
+                    : "Default: ".concat(schema.default);
+            }
+            if (('allowEmptyValue' in schema && schema.allowEmptyValue && schema.default === '') || schema.default !== '') {
+                // If we have `allowEmptyValue` present, and the default is actually an empty string, let it
+                // through as it's allowed.
+            }
+            else {
+                // If the default is empty and we don't want to allowEmptyValue, we need to remove the
+                // default.
+                delete schema.default;
+            }
+        }
+    }
+    else if (prevDefaultSchemas.length) {
+        var foundDefault = searchForValueByPropAndPointer('default', currentLocation, prevDefaultSchemas);
+        // We shouldn't ever set an object default out of the parent lineage tree defaults because
+        // the contents of that object will be set on the schema that they're a part of. Setting
+        // that object as well would result us in duplicating the defaults for that schema in two
+        // places.
+        if ((0, helpers_1.isPrimitive)(foundDefault) ||
+            foundDefault === null ||
+            (Array.isArray(foundDefault) && (0, helpers_1.hasSchemaType)(schema, 'array'))) {
+            schema.default = foundDefault;
         }
     }
     if (RMOAS.isSchema(schema, isPolymorphicAllOfChild) && 'enum' in schema && Array.isArray(schema.enum)) {

package/dist/operation/get-parameters-as-json-schema.js

@@ -99,7 +99,7 @@ function getParametersAsJSONSchema(operation, api, opts) {
             globalDefaults: opts.globalDefaults,
             hideReadOnlyProperties: opts.hideReadOnlyProperties,
             hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
-            prevSchemas: [],
+            prevExampleSchemas: [],
             refLogger: refLogger,
             transformer: opts.transformer,
         });
@@ -135,12 +135,12 @@ function getParametersAsJSONSchema(operation, api, opts) {
         if (!mediaTypeObject.schema || !Object.keys(mediaTypeObject.schema).length) {
             return null;
         }
-        var prevSchemas = [];
+        var prevExampleSchemas = [];
         if ('example' in mediaTypeObject) {
-            prevSchemas.push({ example: mediaTypeObject.example });
+            prevExampleSchemas.push({ example: mediaTypeObject.example });
         }
         else if ('examples' in mediaTypeObject) {
-            prevSchemas.push({
+            prevExampleSchemas.push({
                 examples: Object.values(mediaTypeObject.examples)
                     .map(function (example) { return example.value; })
                     .filter(function (val) { return val !== undefined; }),
@@ -153,7 +153,7 @@ function getParametersAsJSONSchema(operation, api, opts) {
             globalDefaults: opts.globalDefaults,
             hideReadOnlyProperties: opts.hideReadOnlyProperties,
             hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
-            prevSchemas: prevSchemas,
+            prevExampleSchemas: prevExampleSchemas,
             refLogger: refLogger,
             transformer: opts.transformer,
         });

package/dist/samples/utils.js

@@ -12,9 +12,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deeplyStripKey = exports.isFunc = exports.normalizeArray = exports.objectify = exports.usesPolymorphism = void 0;
-function isObject(obj) {
-    return !!obj && typeof obj === 'object';
-}
+var helpers_1 = require("../lib/helpers");
 function usesPolymorphism(schema) {
     if (schema.oneOf) {
         return 'oneOf';
@@ -29,7 +27,7 @@ function usesPolymorphism(schema) {
 }
 exports.usesPolymorphism = usesPolymorphism;
 function objectify(thing) {
-    if (!isObject(thing)) {
+    if (!(0, helpers_1.isObject)(thing)) {
         return {};
     }
     return thing;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oas",
-  "version": "20.8.9",
+  "version": "20.9.0",
   "description": "Comprehensive tooling for working with OpenAPI definitions",
   "license": "MIT",
   "author": "ReadMe <support@readme.io> (https://readme.com)",
@@ -59,16 +59,16 @@
   "devDependencies": {
     "@commitlint/cli": "^17.6.6",
     "@commitlint/config-conventional": "^17.6.6",
-    "@readme/eslint-config": "^10.6.1",
+    "@readme/eslint-config": "^10.6.2",
     "@readme/oas-examples": "^5.11.1",
     "@readme/openapi-parser": "^2.5.0",
-    "@types/jest": "^29.5.1",
+    "@types/jest": "^29.5.3",
     "@types/json-schema-merge-allof": "^0.6.1",
     "@types/memoizee": "^0.4.6",
-    "@types/node": "^20.3.3",
+    "@types/node": "^20.4.1",
     "eslint": "^8.44.0",
     "husky": "^8.0.3",
-    "jest": "^29.5.0",
+    "jest": "^29.6.1",
     "prettier": "^2.8.8",
     "ts-jest": "^29.1.1",
     "typescript": "^5.1.6"

package/src/lib/helpers.ts

@@ -8,6 +8,10 @@ export function hasSchemaType(schema: SchemaObject, discriminator: 'array' | 'ob
   return schema.type === discriminator;
 }
 
+export function isObject(val: unknown) {
+  return typeof val === 'object' && val !== null && !Array.isArray(val);
+}
+
 export function isPrimitive(val: unknown): boolean {
   return typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean';
 }

package/src/lib/openapi-to-json-schema.ts

@@ -9,7 +9,7 @@ import removeUndefinedObjects from 'remove-undefined-objects';
 
 import * as RMOAS from '../rmoas.types';
 
-import { hasSchemaType, isPrimitive } from './helpers';
+import { hasSchemaType, isObject, isPrimitive } from './helpers';
 
 /**
  * This list has been pulled from `openapi-schema-to-json-schema` but been slightly modified to fit
@@ -25,8 +25,6 @@ const UNSUPPORTED_SCHEMA_PROPS = [
   'xml',
 ] as const;
 
-type PrevSchemasType = RMOAS.SchemaObject[];
-
 export interface toJSONSchemaOptions {
   /**
    * Whether or not to extend descriptions with a list of any present enums.
@@ -59,9 +57,14 @@ export interface toJSONSchemaOptions {
   isPolymorphicAllOfChild?: boolean;
 
   /**
-   * Array of parent schemas to utilize when attempting to path together examples.
+   * Array of parent `default` schemas to utilzie when attempting to path together schema defaults.
+   */
+  prevDefaultSchemas?: RMOAS.SchemaObject[];
+
+  /**
+   * Array of parent `example` schemas to utilize when attempting to path together schema examples.
    */
-  prevSchemas?: PrevSchemasType;
+  prevExampleSchemas?: RMOAS.SchemaObject[];
 
   /**
    * A function that's called anytime a (circular) `$ref` is found.
@@ -154,8 +157,8 @@ function isRequestBodySchema(schema: unknown): schema is RMOAS.RequestBodyObject
 }
 
 /**
- * Given a JSON pointer and an array of examples do a reverse search through them until we find the
- * JSON pointer, or part of it, within the array.
+ * Given a JSON pointer, a type of property to look for, and an array of schemas do a reverse
+ * search through them until we find the JSON pointer, or part of it, within the array.
  *
  * This function will allow you to take a pointer like `/tags/name` and return back `buster` from
  * the following array:
@@ -183,11 +186,16 @@ function isRequestBodySchema(schema: unknown): schema is RMOAS.RequestBodyObject
  * it shouldn't raise immediate cause for alarm.
  *
  * @see {@link https://tools.ietf.org/html/rfc6901}
+ * @param property Specific type of schema property to look for a value for.
  * @param pointer JSON pointer to search for an example for.
- * @param examples Array of previous schemas we've found relating to this pointer.
+ * @param schemas Array of previous schemas we've found relating to this pointer.
  */
-function searchForExampleByPointer(pointer: string, examples: PrevSchemasType = []) {
-  if (!examples.length || !pointer.length) {
+function searchForValueByPropAndPointer(
+  property: 'example' | 'default',
+  pointer: string,
+  schemas: toJSONSchemaOptions['prevExampleSchemas'] | toJSONSchemaOptions['prevDefaultSchemas'] = []
+) {
+  if (!schemas.length || !pointer.length) {
     return undefined;
   }
 
@@ -200,42 +208,47 @@ function searchForExampleByPointer(pointer: string, examples: PrevSchemasType =
     pointers.push(point);
   }
 
-  let example;
-  const rev = [...examples].reverse();
+  let foundValue;
+  const rev = [...schemas].reverse();
 
   for (let i = 0; i < pointers.length; i += 1) {
     for (let ii = 0; ii < rev.length; ii += 1) {
       let schema = rev[ii];
-      if ('example' in schema) {
-        schema = schema.example;
-      } else {
-        if (!Array.isArray(schema.examples) || !schema.examples.length) {
-          continue;
-        }
 
-        // Prevent us from crashing if `examples` is a completely empty object.
-        schema = [...schema.examples].shift();
+      if (property === 'example') {
+        if ('example' in schema) {
+          schema = schema.example;
+        } else {
+          if (!Array.isArray(schema.examples) || !schema.examples.length) {
+            continue;
+          }
+
+          // Prevent us from crashing if `examples` is a completely empty object.
+          schema = [...schema.examples].shift();
+        }
+      } else {
+        schema = schema.default;
       }
 
       try {
-        example = jsonpointer.get(schema, pointers[i]);
+        foundValue = jsonpointer.get(schema, pointers[i]);
       } catch (err) {
         // If the schema we're looking at is `{obj: null}` and our pointer is `/obj/propertyName`
         // `jsonpointer` will throw an error. If that happens, we should silently catch and toss it
         // and return no example.
       }
 
-      if (example !== undefined) {
+      if (foundValue !== undefined) {
         break;
       }
     }
 
-    if (example !== undefined) {
+    if (foundValue !== undefined) {
       break;
     }
   }
 
-  return example;
+  return foundValue;
 }
 
 /**
@@ -288,7 +301,8 @@ export default function toJSONSchema(
     hideReadOnlyProperties,
     hideWriteOnlyProperties,
     isPolymorphicAllOfChild,
-    prevSchemas,
+    prevDefaultSchemas,
+    prevExampleSchemas,
     refLogger,
     transformer,
   } = {
@@ -298,7 +312,8 @@ export default function toJSONSchema(
     hideReadOnlyProperties: false,
     hideWriteOnlyProperties: false,
     isPolymorphicAllOfChild: false,
-    prevSchemas: [] as PrevSchemasType,
+    prevDefaultSchemas: [] as toJSONSchemaOptions['prevDefaultSchemas'],
+    prevExampleSchemas: [] as toJSONSchemaOptions['prevExampleSchemas'],
     refLogger: () => true,
     transformer: (s: RMOAS.SchemaObject) => s,
     ...opts,
@@ -391,7 +406,8 @@ export default function toJSONSchema(
             hideReadOnlyProperties,
             hideWriteOnlyProperties,
             isPolymorphicAllOfChild: false,
-            prevSchemas,
+            prevDefaultSchemas,
+            prevExampleSchemas,
             refLogger,
             transformer,
           };
@@ -564,6 +580,10 @@ export default function toJSONSchema(
   }
 
   if (RMOAS.isSchema(schema, isPolymorphicAllOfChild)) {
+    if ('default' in schema && isObject(schema.default)) {
+      prevDefaultSchemas.push({ default: schema.default });
+    }
+
     // JSON Schema doesn't support OpenAPI-style examples so we need to reshape them a bit.
     if ('example' in schema) {
       // Only bother adding primitive examples.
@@ -575,7 +595,7 @@ export default function toJSONSchema(
           delete schema.examples;
         }
       } else {
-        prevSchemas.push({ example: schema.example });
+        prevExampleSchemas.push({ example: schema.example });
       }
 
       delete schema.example;
@@ -598,9 +618,9 @@ export default function toJSONSchema(
               reshapedExamples = true;
             } else {
               // If this example is neither a primitive or an array we should dump it into the
-              // `prevSchemas` array because we might be able to extract an example from it further
-              // downstream.
-              prevSchemas.push({
+              // `prevExampleSchemas` array because we might be able to extract an example from it
+              // further downstream.
+              prevExampleSchemas.push({
                 example: example.value,
               });
             }
@@ -626,7 +646,7 @@ export default function toJSONSchema(
     // find one. But as we're only looking for primitive example, only try to search for one if
     // we're dealing with a primitive schema.
     if (!hasSchemaType(schema, 'array') && !hasSchemaType(schema, 'object') && !schema.examples) {
-      const foundExample = searchForExampleByPointer(currentLocation, prevSchemas);
+      const foundExample = searchForValueByPropAndPointer('example', currentLocation, prevExampleSchemas);
       if (foundExample) {
         // We can only really deal with primitives, so only promote those as the found example if
         // it is.
@@ -650,7 +670,7 @@ export default function toJSONSchema(
             globalDefaults,
             hideReadOnlyProperties,
             hideWriteOnlyProperties,
-            prevSchemas,
+            prevExampleSchemas,
             refLogger,
             transformer,
           });
@@ -679,7 +699,8 @@ export default function toJSONSchema(
               globalDefaults,
               hideReadOnlyProperties,
               hideWriteOnlyProperties,
-              prevSchemas,
+              prevDefaultSchemas,
+              prevExampleSchemas,
               refLogger,
               transformer,
             });
@@ -727,7 +748,8 @@ export default function toJSONSchema(
             globalDefaults,
             hideReadOnlyProperties,
             hideWriteOnlyProperties,
-            prevSchemas,
+            prevDefaultSchemas,
+            prevExampleSchemas,
             refLogger,
             transformer,
           });
@@ -786,21 +808,41 @@ export default function toJSONSchema(
 
   // Only add a default value if we actually have one.
   if ('default' in schema && typeof schema.default !== 'undefined') {
-    // If it's an enum and not the response schema, add the default to the description.
-    // If there's an existing description, trim trailing new lines so it doesn't look ugly.
-    if ('enum' in schema && !addEnumsToDescriptions) {
-      schema.description = schema.description
-        ? `${schema.description.replace(/\n$/, '')}\n\nDefault: \`${schema.default}\``
-        : `Default: ${schema.default}`;
-    }
-
-    if (('allowEmptyValue' in schema && schema.allowEmptyValue && schema.default === '') || schema.default !== '') {
-      // If we have `allowEmptyValue` present, and the default is actually an empty string, let it
-      // through as it's allowed.
-    } else {
-      // If the default is empty and we don't want to allowEmptyValue, we need to remove the
-      // default.
+    if (hasSchemaType(schema, 'object')) {
+      // Defaults for `object` and types have been dereferenced into their children schemas already
+      // above so we don't need to preserve this default anymore.
       delete schema.default;
+    } else {
+      // If it's an enum and not the response schema, add the default to the description.
+      // If there's an existing description, trim trailing new lines so it doesn't look ugly.
+      if ('enum' in schema && !addEnumsToDescriptions) {
+        schema.description = schema.description
+          ? `${schema.description.replace(/\n$/, '')}\n\nDefault: \`${schema.default}\``
+          : `Default: ${schema.default}`;
+      }
+
+      if (('allowEmptyValue' in schema && schema.allowEmptyValue && schema.default === '') || schema.default !== '') {
+        // If we have `allowEmptyValue` present, and the default is actually an empty string, let it
+        // through as it's allowed.
+      } else {
+        // If the default is empty and we don't want to allowEmptyValue, we need to remove the
+        // default.
+        delete schema.default;
+      }
+    }
+  } else if (prevDefaultSchemas.length) {
+    const foundDefault = searchForValueByPropAndPointer('default', currentLocation, prevDefaultSchemas);
+
+    // We shouldn't ever set an object default out of the parent lineage tree defaults because
+    // the contents of that object will be set on the schema that they're a part of. Setting
+    // that object as well would result us in duplicating the defaults for that schema in two
+    // places.
+    if (
+      isPrimitive(foundDefault) ||
+      foundDefault === null ||
+      (Array.isArray(foundDefault) && hasSchemaType(schema, 'array'))
+    ) {
+      schema.default = foundDefault;
     }
   }
 

package/src/operation/get-parameters-as-json-schema.ts

@@ -1,3 +1,4 @@
+import type { toJSONSchemaOptions } from '../lib/openapi-to-json-schema';
 import type Operation from '../operation';
 import type { ComponentsObject, ExampleObject, OASDocument, ParameterObject, SchemaObject } from '../rmoas.types';
 import type { OpenAPIV3_1 } from 'openapi-types';
@@ -125,7 +126,7 @@ export default function getParametersAsJSONSchema(
       globalDefaults: opts.globalDefaults,
       hideReadOnlyProperties: opts.hideReadOnlyProperties,
       hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
-      prevSchemas: [],
+      prevExampleSchemas: [],
       refLogger,
       transformer: opts.transformer,
     });
@@ -170,11 +171,11 @@ export default function getParametersAsJSONSchema(
       return null;
     }
 
-    const prevSchemas: SchemaObject[] = [];
+    const prevExampleSchemas: toJSONSchemaOptions['prevExampleSchemas'] = [];
     if ('example' in mediaTypeObject) {
-      prevSchemas.push({ example: mediaTypeObject.example });
+      prevExampleSchemas.push({ example: mediaTypeObject.example });
     } else if ('examples' in mediaTypeObject) {
-      prevSchemas.push({
+      prevExampleSchemas.push({
         examples: Object.values(mediaTypeObject.examples)
           .map((example: ExampleObject) => example.value)
           .filter(val => val !== undefined),
@@ -189,7 +190,7 @@ export default function getParametersAsJSONSchema(
       globalDefaults: opts.globalDefaults,
       hideReadOnlyProperties: opts.hideReadOnlyProperties,
       hideWriteOnlyProperties: opts.hideWriteOnlyProperties,
-      prevSchemas,
+      prevExampleSchemas,
       refLogger,
       transformer: opts.transformer,
     });

package/src/samples/utils.ts

@@ -6,9 +6,7 @@
  */
 import type * as RMOAS from '../rmoas.types';
 
-function isObject(obj: unknown) {
-  return !!obj && typeof obj === 'object';
-}
+import { isObject } from '../lib/helpers';
 
 export function usesPolymorphism(schema: RMOAS.SchemaObject) {
   if (schema.oneOf) {

package/tsconfig.json

@@ -7,7 +7,7 @@
     "lib": ["dom", "es2020"],
     "noImplicitAny": true,
     "outDir": "./dist",
-    "resolveJsonModule": true,
+    "resolveJsonModule": true
   },
   "include": ["./src/**/*"]
 }