Function cloneSpecObject

packages/cli/generators/openapi/utils.js:196–217

* Clone an OpenAPI spec. When a `$ref` is encountered, we store it as `x-$ref` * and keep the stringified original value as `x-$original-value`. These * metadata allows us to access the original object after `$ref` is resolved * and dereferenced by the parser. * * @param {*} spec An OpenAPI spe

(spec)

 * @param {*} spec An OpenAPI spec object
 */
function cloneSpecObject(spec) {
  return _.cloneDeepWith(spec, item => {
    /**
     * A yaml object below produces `null` for `servers.url`
     * ```yaml
     * servers:
     * - url:
     *   description: null url for testing
     * ```
     */
    if (item != null && item.$ref) {
      const copy = _.cloneDeep(item);
      return {
        ...copy,
        // Store the original item in `x-$original`
        'x-$original-value': json5.stringify(item, null, 2),
        // Keep `$ref` as `x-$ref` as `$ref` will be removed during dereferencing
        'x-$ref': item.$ref,
      };
    }
  });
}

/**
 * Print an OpenAPI spec object as JavaScript object literal. The original value