api 6.1.1 → 7.0.0-alpha.1

package/package.json

@@ -1,9 +1,7 @@
 {
   "name": "api",
-  "version": "6.1.1",
+  "version": "7.0.0-alpha.1",
   "description": "Magical SDK generation from an OpenAPI definition 🪄",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "bin": {
     "api": "./bin/api"
   },
@@ -13,7 +11,7 @@
     "lint:types": "tsc --noEmit",
     "prebuild": "rm -rf dist/; npm run version",
     "prepack": "npm run build",
-    "test": "vitest --coverage",
+    "test": "vitest run --coverage",
     "test:smoke": "vitest --config=vitest-smoketest.config.ts ",
     "version": "node -p \"'// This file is automatically updated by the build script.\\nexport const PACKAGE_NAME = \\'' + require('./package.json').name + '\\';\\nexport const PACKAGE_VERSION = \\'' + require('./package.json').version + '\\';'\" > src/packageInfo.ts; git add src/packageInfo.ts"
   },
@@ -29,7 +27,7 @@
   "author": "Jon Ursenbach <jon@readme.io>",
   "license": "MIT",
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   },
   "keywords": [
     "api",
@@ -38,62 +36,46 @@
     "swagger"
   ],
   "dependencies": {
-    "@readme/oas-to-har": "^20.0.2",
     "@readme/openapi-parser": "^2.4.0",
-    "caseless": "^0.12.0",
     "chalk": "^4.1.2",
-    "commander": "^10.0.0",
-    "datauri": "^4.1.0",
+    "commander": "^11.0.0",
     "execa": "^5.1.1",
-    "fetch-har": "^8.1.5",
     "figures": "^3.2.0",
-    "find-cache-dir": "^3.3.1",
-    "form-data-encoder": "^1.7.2",
-    "formdata-node": "^4.3.2",
-    "get-stream": "^6.0.1",
-    "isomorphic-fetch": "^3.0.0",
     "js-yaml": "^4.1.0",
-    "json-schema-to-ts": "^2.6.2-beta.0",
-    "json-schema-traverse": "^1.0.0",
+    "json-schema-to-ts": "^2.9.2",
     "lodash.camelcase": "^4.3.0",
     "lodash.deburr": "^4.1.0",
-    "lodash.merge": "^4.6.2",
     "lodash.setwith": "^4.3.2",
     "lodash.startcase": "^4.4.0",
     "make-dir": "^3.1.0",
-    "node-abort-controller": "^3.1.1",
     "oas": "^20.4.0",
     "ora": "^5.4.1",
     "prompts": "^2.4.2",
-    "remove-undefined-objects": "^2.0.2",
     "semver": "^7.3.8",
     "ssri": "^10.0.1",
     "ts-morph": "^17.0.1",
     "validate-npm-package-name": "^5.0.0"
   },
   "devDependencies": {
-    "@readme/oas-examples": "^5.9.0",
-    "@types/caseless": "^0.12.2",
-    "@types/find-cache-dir": "^3.2.1",
+    "@api/test-utils": "file:../test-utils",
+    "@readme/api-core": "file:../core",
+    "@readme/oas-examples": "^5.12.0",
     "@types/js-yaml": "^4.0.5",
     "@types/lodash.camelcase": "^4.3.7",
     "@types/lodash.deburr": "^4.1.7",
-    "@types/lodash.merge": "^4.6.7",
     "@types/lodash.setwith": "^4.3.7",
     "@types/lodash.startcase": "^4.4.7",
-    "@types/prettier": "^2.7.2",
-    "@types/prompts": "^2.4.2",
-    "@types/semver": "^7.3.13",
+    "@types/prompts": "^2.4.4",
+    "@types/semver": "^7.5.1",
     "@types/ssri": "^7.1.1",
     "@types/validate-npm-package-name": "^4.0.0",
-    "@vitest/coverage-v8": "^0.34.1",
+    "@vitest/coverage-v8": "^0.34.4",
     "fetch-mock": "^9.11.0",
     "oas-normalize": "^8.3.2",
-    "type-fest": "^4.2.0",
-    "typescript": "^4.9.5",
+    "type-fest": "^4.3.1",
+    "typescript": "^5.2.2",
     "unique-temp-dir": "^1.0.0",
     "vitest": "^0.34.1"
   },
-  "prettier": "@readme/eslint-config/prettier",
-  "gitHead": "e440a28841e753895bfb5315b4d31f679824fa39"
+  "prettier": "@readme/eslint-config/prettier"
 }

package/src/bin.ts

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 
-import commands from './cli/commands';
+import commands from './commands';
 import * as pkg from './packageInfo';
 
 (async () => {

package/src/{cli/codegen → codegen}/language.ts

@@ -1,7 +1,7 @@
 import type Storage from '../storage';
 import type Oas from 'oas';
 
-import { PACKAGE_NAME, PACKAGE_VERSION } from '../../packageInfo';
+import { PACKAGE_NAME, PACKAGE_VERSION } from '../packageInfo';
 
 export interface InstallerOptions {
   /**
@@ -25,11 +25,12 @@ export default abstract class CodeGeneratorLanguage {
 
   userAgent: string;
 
-  requiredPackages: Record<string, { reason: string; url: string }>;
+  requiredPackages!: Record<string, { reason: string; url: string }>;
 
   constructor(spec: Oas, specPath: string, identifier: string) {
     this.spec = spec;
     this.specPath = specPath;
+    this.identifier = identifier;
 
     // User agents should be contextual to the spec in question and the version of `api` that was
     // used to generate the SDK. For example, this'll look like `petstore/1.0.0 (api/4.2.0)` for

package/src/{cli/codegen → codegen}/languages/typescript/util.ts

@@ -123,7 +123,7 @@ export function docblockEscape(str: string) {
  * @license MIT
  * @see {@link https://github.com/bcherny/json-schema-to-typescript}
  */
-export function toSafeString(str: string) {
+function toSafeString(str: string) {
   // identifiers in javaScript/ts:
   // First character: a-zA-Z | _ | $
   // Rest: a-zA-Z | _ | $ | 0-9

package/src/{cli/codegen → codegen}/languages/typescript.ts

@@ -3,6 +3,7 @@ import type { InstallerOptions } from '../language';
 import type Oas from 'oas';
 import type { Operation } from 'oas';
 import type { HttpMethods, SchemaObject } from 'oas/dist/rmoas.types';
+import type { SemVer } from 'semver';
 import type {
   ClassDeclaration,
   JSDocStructure,
@@ -12,8 +13,8 @@ import type {
 } from 'ts-morph';
 import type { PackageJson } from 'type-fest';
 
-import fs from 'fs';
-import path from 'path';
+import fs from 'node:fs';
+import path from 'node:path';
 
 import execa from 'execa';
 import setWith from 'lodash.setwith';
@@ -53,20 +54,18 @@ export default class TSGenerator extends CodeGeneratorLanguage {
 
   types: Map<string, string>;
 
-  files: Record<string, string>;
-
-  sdk: ClassDeclaration;
+  sdk!: ClassDeclaration;
 
   schemas: Record<
     string,
     // Operation-level type
     | {
-        body?: any;
-        metadata?: any;
-        response?: Record<string, any>;
+        body?: unknown;
+        metadata?: unknown;
+        response?: Record<string, unknown>;
       }
     // Wholesale collection of `$ref` pointer types
-    | Record<string, any>
+    | Record<string, unknown>
   >;
 
   usesHTTPMethodRangeInterface = false;
@@ -87,15 +86,15 @@ export default class TSGenerator extends CodeGeneratorLanguage {
 
     this.requiredPackages = {
       api: {
-        reason: "Required for the `api/dist/core` library that the codegen'd SDK uses for making requests.",
+        reason: "Required for the `@readme/api-core` library that the codegen'd SDK uses for making requests.",
         url: 'https://npm.im/api',
       },
-      'json-schema-to-ts@beta': {
+      'json-schema-to-ts': {
         reason: 'Required for TypeScript type handling.',
         url: 'https://npm.im/json-schema-to-ts',
       },
       oas: {
-        reason: 'Used within `api/dist/core` and is also loaded for TypeScript types.',
+        reason: 'Used within `@readme/api-core` and is also loaded for TypeScript types.',
         url: 'https://npm.im/oas',
       },
     };
@@ -138,7 +137,7 @@ export default class TSGenerator extends CodeGeneratorLanguage {
     if (!pkgVersion) {
       // If the version that's in `info.version` isn't compatible with semver NPM won't be able to
       // handle it properly so we need to fallback to something it can.
-      pkgVersion = semver.coerce('0.0.0');
+      pkgVersion = semver.coerce('0.0.0') as SemVer;
     }
 
     const pkg: PackageJson = {
@@ -221,7 +220,7 @@ export default class TSGenerator extends CodeGeneratorLanguage {
       sdkSource
         .getImportDeclarations()
         .find(id => id.getText() === "import type * as types from './types';")
-        .remove();
+        ?.remove();
     }
 
     // If this SDK doesn't use the `HTTPMethodRange` interface for handling `2XX` response status
@@ -230,7 +229,7 @@ export default class TSGenerator extends CodeGeneratorLanguage {
       sdkSource
         .getImportDeclarations()
         .find(id => id.getText().includes('HTTPMethodRange'))
-        .replaceWithText("import type { ConfigOptions, FetchResponse } from 'api/dist/core'");
+        ?.replaceWithText("import type { ConfigOptions, FetchResponse } from '@readme/api-core';");
     }
 
     if (this.outputJS) {
@@ -301,10 +300,10 @@ export default class TSGenerator extends CodeGeneratorLanguage {
       {
         // `HTTPMethodRange` will be conditionally removed later if it ends up not being used.
         defaultImport: 'type { ConfigOptions, FetchResponse, HTTPMethodRange }',
-        moduleSpecifier: 'api/dist/core',
+        moduleSpecifier: '@readme/api-core',
       },
       { defaultImport: 'Oas', moduleSpecifier: 'oas' },
-      { defaultImport: 'APICore', moduleSpecifier: 'api/dist/core' },
+      { defaultImport: 'APICore', moduleSpecifier: '@readme/api-core' },
       { defaultImport: 'definition', moduleSpecifier: this.specPath },
     ]);
 
@@ -566,10 +565,10 @@ sdk.server('https://eu.api.example.com/v14');`),
 
     let hasOptionalBody = false;
     let hasOptionalMetadata = false;
-    const parameters: {
-      body?: OptionalKind<ParameterDeclarationStructure>;
-      metadata?: OptionalKind<ParameterDeclarationStructure>;
-    } = {};
+    const parameters = {} as {
+      body: OptionalKind<ParameterDeclarationStructure>;
+      metadata: OptionalKind<ParameterDeclarationStructure>;
+    };
 
     if (paramTypes) {
       // If an operation has a request body payload it will only ever have `body` or `formData`,
@@ -656,7 +655,7 @@ sdk.server('https://eu.api.example.com/v14');`),
       // we should only add a docblock to the first overload we create because IDE Intellisense will
       // always use that and adding a docblock to all three will bloat the SDK with unused and
       // unsurfaced method documentation.
-      docs: shouldAddAltTypedOverloads ? null : Object.keys(docblock).length ? [docblock] : null,
+      docs: shouldAddAltTypedOverloads ? undefined : Object.keys(docblock).length ? [docblock] : undefined,
       statements: writer => {
         /**
          * @example return this.core.fetch('/pet/findByStatus', 'get', body, metadata);
@@ -698,7 +697,7 @@ sdk.server('https://eu.api.example.com/v14');`),
           { ...parameters.metadata, hasQuestionToken: false },
         ],
         returnType,
-        docs: Object.keys(docblock).length ? [docblock] : null,
+        docs: Object.keys(docblock).length ? [docblock] : undefined,
       });
 
       // Create an overload that just has a single `metadata` parameter.
@@ -711,7 +710,7 @@ sdk.server('https://eu.api.example.com/v14');`),
       // our `metadata` parameter is actually required for this operation this is the only way we're
       // able to have an optional `body` parameter be present before `metadata`.
       //
-      // Thankfully our core fetch work in `api/dist/core` is able to do the proper determination to
+      // Thankfully our core fetch work in `@readme/api-core` is able to do the proper determination to
       // see if what the user is supplying is `metadata` or `body` content when they supply one or
       // both.
       operationIdAccessor.addParameters([
@@ -739,13 +738,13 @@ sdk.server('https://eu.api.example.com/v14');`),
    */
   loadOperationsAndMethods() {
     const operations: Record</* operationId */ string, OperationTypeHousing> = {};
-    const methods = new Set();
+    const methods = new Set<HttpMethods>();
 
     // Prepare all of the schemas that we need to process for every operation within this API
     // definition.
     Object.entries(this.spec.getPaths()).forEach(([, ops]) => {
-      Object.entries(ops).forEach(([method, operation]: [HttpMethods, Operation]) => {
-        methods.add(method);
+      Object.entries(ops).forEach(([method, operation]: [string, Operation]) => {
+        methods.add(method as HttpMethods);
 
         const operationId = operation.getOperationId({
           // This `camelCase` option will clean up any weird characters that might be present in
@@ -786,7 +785,7 @@ sdk.server('https://eu.api.example.com/v14');`),
       transformer: (s: SchemaObject) => {
         // As our schemas are dereferenced in the `oas` library we don't want to pollute our
         // codegen'd schemas file with duplicate schemas.
-        if ('x-readme-ref-name' in s) {
+        if ('x-readme-ref-name' in s && typeof s['x-readme-ref-name'] !== 'undefined') {
           const typeName = generateTypeName(s['x-readme-ref-name']);
           this.addSchemaToExport(s, typeName, typeName);
 
@@ -806,7 +805,7 @@ sdk.server('https://eu.api.example.com/v14');`),
       .reduce((prev, next) => Object.assign(prev, next));
 
     return Object.entries(res)
-      .map(([paramType, schema]: [string, string | unknown]) => {
+      .map(([paramType, schema]: [string, string | SchemaObject]) => {
         let typeName;
 
         if (typeof schema === 'string' && schema.startsWith('::convert::')) {
@@ -815,7 +814,7 @@ sdk.server('https://eu.api.example.com/v14');`),
           typeName = schema.replace('::convert::', '');
         } else {
           typeName = generateTypeName(operationId, paramType, 'param');
-          this.addSchemaToExport(schema, typeName, `${generateTypeName(operationId)}.${paramType}`);
+          this.addSchemaToExport(schema as SchemaObject, typeName, `${generateTypeName(operationId)}.${paramType}`);
         }
 
         return {
@@ -844,7 +843,7 @@ sdk.server('https://eu.api.example.com/v14');`),
           transformer: (s: SchemaObject) => {
             // As our schemas are dereferenced in the `oas` library we don't want to pollute our
             // codegen'd schemas file with duplicate schemas.
-            if ('x-readme-ref-name' in s) {
+            if ('x-readme-ref-name' in s && typeof s['x-readme-ref-name'] !== 'undefined') {
               const typeName = generateTypeName(s['x-readme-ref-name']);
               this.addSchemaToExport(s, typeName, `${typeName}`);
 
@@ -900,7 +899,7 @@ sdk.server('https://eu.api.example.com/v14');`),
    * Add a given schema into our schema dataset that we'll be be exporting as types.
    *
    */
-  addSchemaToExport(schema: any, typeName: string, pointer: string) {
+  addSchemaToExport(schema: SchemaObject, typeName: string, pointer: string) {
     if (this.types.has(typeName)) {
       return;
     }

package/src/{cli/commands → commands}/install.ts

@@ -5,8 +5,8 @@ import figures from 'figures';
 import Oas from 'oas';
 import ora from 'ora';
 
-import Fetcher from '../../fetcher';
 import codegen from '../codegen';
+import Fetcher from '../fetcher';
 import promptTerminal from '../lib/prompt';
 import logger from '../logger';
 import Storage from '../storage';

package/src/fetcher.ts

@@ -1,10 +1,9 @@
 import type { OASDocument } from 'oas/dist/rmoas.types';
 
-import fs from 'fs';
-import path from 'path';
+import fs from 'node:fs';
+import path from 'node:path';
 
 import OpenAPIParser from '@readme/openapi-parser';
-import 'isomorphic-fetch';
 import yaml from 'js-yaml';
 
 export default class Fetcher {
@@ -52,7 +51,7 @@ export default class Fetcher {
       return undefined;
     }
 
-    return matches.groups.project;
+    return matches.groups?.project;
   }
 
   async load() {
@@ -115,7 +114,7 @@ export default class Fetcher {
     });
   }
 
-  static validate(json: any) {
+  static validate(json: OASDocument) {
     if (json.swagger) {
       throw new Error('Sorry, this module only supports OpenAPI definitions.');
     }

package/src/packageInfo.ts

@@ -1,3 +1,3 @@
 // This file is automatically updated by the build script.
 export const PACKAGE_NAME = 'api';
-export const PACKAGE_VERSION = '6.1.1';
+export const PACKAGE_VERSION = '7.0.0-alpha.1';

package/src/{cli/storage.ts → storage.ts}

@@ -1,14 +1,14 @@
 import type { OASDocument } from 'oas/dist/rmoas.types';
 
-import fs from 'fs';
-import path from 'path';
+import fs from 'node:fs';
+import path from 'node:path';
 
 import makeDir from 'make-dir';
 import ssri from 'ssri';
 import validateNPMPackageName from 'validate-npm-package-name';
 
-import Fetcher from '../fetcher';
-import { PACKAGE_VERSION } from '../packageInfo';
+import Fetcher from './fetcher';
+import { PACKAGE_VERSION } from './packageInfo';
 
 export default class Storage {
   static dir: string;
@@ -21,7 +21,7 @@ export default class Storage {
    */
   source: string;
 
-  identifier: string;
+  identifier!: string;
 
   fetcher: Fetcher;
 
@@ -31,7 +31,9 @@ export default class Storage {
     this.fetcher = new Fetcher(source);
 
     this.source = source;
-    this.identifier = identifier;
+    if (identifier) {
+      this.identifier = identifier;
+    }
 
     // This should default to false so we have awareness if we've looked at the lockfile yet.
     Storage.lockfile = false;
@@ -116,7 +118,9 @@ export default class Storage {
     if (!isValidForNPM.validForNewPackages) {
       // `prompts` doesn't support surfacing multiple errors in a `validate` call so we can only
       // surface the first to the user.
-      throw new Error(`Identifier cannot be used for an NPM package: ${isValidForNPM.errors[0]}`);
+      throw new Error(
+        `Identifier cannot be used for an NPM package: ${isValidForNPM?.errors?.[0] || '[error unavailable]'}`,
+      );
     }
 
     return true;
@@ -269,7 +273,7 @@ export default class Storage {
   }
 }
 
-export interface Lockfile {
+interface Lockfile {
   apis: LockfileAPI[];
 
   /**
@@ -279,7 +283,7 @@ export interface Lockfile {
   version: '1.0';
 }
 
-export interface LockfileAPI {
+interface LockfileAPI {
   /**
    * A unique identifier of the API. This'll be used to do requires on `@api/<identifier>` and also
    * where the SDK code will be located in `.api/apis/<identifier>`.

package/tsconfig.json

@@ -4,21 +4,11 @@
     "baseUrl": "./src",
     "declaration": true,
     "esModuleInterop": true,
-    "lib": ["dom", "dom.iterable", "es2020"],
+    "lib": ["DOM", "DOM.Iterable", "ES2020"],
     "noImplicitAny": true,
     "outDir": "dist/",
-    "paths": {
-      // Because this library uses ES2015+ `#private` syntax that would require us to make this
-      // library ESM-only we're overloading its types with a `paths` config with this empty file.
-      // This isn't a great solution as we're losing type checks where this library is used, but
-      // it's far too early in the ESM lifecycle for us to make API an ESM-only library.
-      //
-      // And though TS offers an unstable `node12` module resolution that lets us manage this in
-      // another way that module resolution requires TS nightlies to be installed, which no thanks!
-      //
-      // https://github.com/microsoft/TypeScript/issues/17042
-      "form-data-encoder": [".sink.d.ts"]
-    }
+    "strict": true,
+    "useUnknownInCatchVariables": false
   },
   "include": ["./src/**/*"]
 }

package/dist/cache.d.ts

@@ -1,68 +0,0 @@
-import type { OASDocument } from 'oas/dist/rmoas.types';
-import 'isomorphic-fetch';
-import Fetcher from './fetcher';
-type CacheStore = Record<string, {
-    hash: string;
-    original: string | OASDocument;
-    /**
-     * @deprecated Deprecated in v4.5.0 in favor of `hash`.
-     */
-    path?: string;
-    title?: string;
-    version?: string;
-}>;
-export default class Cache {
-    static dir: string;
-    static cacheStore: string;
-    static specsCache: string;
-    uri: string | OASDocument;
-    uriHash: string;
-    cached: false | CacheStore;
-    fetcher: Fetcher;
-    constructor(uri: string | OASDocument, cacheDir?: string | false);
-    static getCacheHash(file: string | OASDocument): string;
-    static setCacheDir(dir?: string | false): void;
-    static reset(): Promise<void>;
-    isCached(): boolean;
-    getCache(): CacheStore;
-    get(): any;
-    load(): Promise<import("openapi-types").OpenAPIV3.Document<{}> | (Omit<Omit<import("openapi-types").OpenAPIV3.Document<{}>, "paths" | "components">, "paths" | "components" | "info" | "servers" | "webhooks" | "jsonSchemaDialect"> & {
-        info: import("openapi-types").OpenAPIV3_1.InfoObject;
-        jsonSchemaDialect?: string;
-        servers?: import("openapi-types").OpenAPIV3_1.ServerObject[];
-    } & Pick<{
-        paths: import("openapi-types").OpenAPIV3_1.PathsObject<{}, {}>;
-        webhooks: Record<string, import("openapi-types").OpenAPIV3_1.ReferenceObject | import("openapi-types").OpenAPIV3_1.PathItemObject<{}>>;
-        components: import("openapi-types").OpenAPIV3_1.ComponentsObject;
-    }, "paths"> & Omit<Partial<{
-        paths: import("openapi-types").OpenAPIV3_1.PathsObject<{}, {}>;
-        webhooks: Record<string, import("openapi-types").OpenAPIV3_1.ReferenceObject | import("openapi-types").OpenAPIV3_1.PathItemObject<{}>>;
-        components: import("openapi-types").OpenAPIV3_1.ComponentsObject;
-    }>, "paths">) | (Omit<Omit<import("openapi-types").OpenAPIV3.Document<{}>, "paths" | "components">, "paths" | "components" | "info" | "servers" | "webhooks" | "jsonSchemaDialect"> & {
-        info: import("openapi-types").OpenAPIV3_1.InfoObject;
-        jsonSchemaDialect?: string;
-        servers?: import("openapi-types").OpenAPIV3_1.ServerObject[];
-    } & Pick<{
-        paths: import("openapi-types").OpenAPIV3_1.PathsObject<{}, {}>;
-        webhooks: Record<string, import("openapi-types").OpenAPIV3_1.ReferenceObject | import("openapi-types").OpenAPIV3_1.PathItemObject<{}>>;
-        components: import("openapi-types").OpenAPIV3_1.ComponentsObject;
-    }, "webhooks"> & Omit<Partial<{
-        paths: import("openapi-types").OpenAPIV3_1.PathsObject<{}, {}>;
-        webhooks: Record<string, import("openapi-types").OpenAPIV3_1.ReferenceObject | import("openapi-types").OpenAPIV3_1.PathItemObject<{}>>;
-        components: import("openapi-types").OpenAPIV3_1.ComponentsObject;
-    }>, "webhooks">) | (Omit<Omit<import("openapi-types").OpenAPIV3.Document<{}>, "paths" | "components">, "paths" | "components" | "info" | "servers" | "webhooks" | "jsonSchemaDialect"> & {
-        info: import("openapi-types").OpenAPIV3_1.InfoObject;
-        jsonSchemaDialect?: string;
-        servers?: import("openapi-types").OpenAPIV3_1.ServerObject[];
-    } & Pick<{
-        paths: import("openapi-types").OpenAPIV3_1.PathsObject<{}, {}>;
-        webhooks: Record<string, import("openapi-types").OpenAPIV3_1.ReferenceObject | import("openapi-types").OpenAPIV3_1.PathItemObject<{}>>;
-        components: import("openapi-types").OpenAPIV3_1.ComponentsObject;
-    }, "components"> & Omit<Partial<{
-        paths: import("openapi-types").OpenAPIV3_1.PathsObject<{}, {}>;
-        webhooks: Record<string, import("openapi-types").OpenAPIV3_1.ReferenceObject | import("openapi-types").OpenAPIV3_1.PathItemObject<{}>>;
-        components: import("openapi-types").OpenAPIV3_1.ComponentsObject;
-    }>, "components">) | import("openapi-types").OpenAPIV2.Document<{}>>;
-    save(spec: OASDocument): OASDocument;
-}
-export {};