@redocly/cli 1.0.0-beta.99 → 1.0.0-rc.2

package/README.md

@@ -1,39 +1,100 @@
-# Redocly CLI toolset
+# Redocly CLI
 
-Redocly CLI toolbox with rich validation and bundling features.
+Command-line utility from [@Redocly](https://redocly.com) with OpenAPI superpowers. Build, manage and quality-check OpenAPI descriptions, configure and execute API governance, and publish beautiful API documentation. Supports OpenAPI 3.1, 3.0 and OpenAPI 2.0 (legacy Swagger format).
 
+![build and test](https://github.com/redocly/redocly-cli/actions/workflows/tests.yaml/badge.svg)
 ![npm (scoped)](https://img.shields.io/npm/v/@redocly/cli)
 ![NPM](https://img.shields.io/npm/l/@redocly/cli)
 
 ![OpenAPI 3 CLI toolset](./media/redocly-cli.gif)
 
-## Features
+## Usage
 
-Currently, @redocly/cli supports these features:
+### Node
 
-- [x] Multifile validation. No need to bundle your file before validation.
-- [x] Lightning-fast validation. Lint a 1 Mb file in less than one second.
-- [x] Built-in rules for common validations.
-- [x] Configurable severity levels for each rule.
-- [x] Human-readable error messages with codeframes and stylish format options.
-- [x] Intuitive suggestions for misspelled types or references.
-- [x] Easy to implement custom rules.
-- [x] Bundle a multifile definition into a single file.
-- [x] Decorators to modify a validated definition during bundling.
-- [x] Preview reference docs for local development.
-- [x] Support for OpenAPI 2 (fka Swagger) and OpenAPI 3.0.
-- [ ] Support for OpenAPI 3.1 ([coming soon](https://github.com/Redocly/redocly-cli/issues/160)).
+```
+npx @redocly/cli lint path-to-root-file.yaml
+```
 
-## What makes this tool different
+Alternatively, install it globally with `npm`:
 
-Unlike other OpenAPI linters, `@redocly/cli` defines the possible type tree of a valid OpenAPI definition and then traverses it. This approach is very similar to how linters for programming languages work and results in major performance benefits over other approaches. Extend functionality at different points in the lifecycle with preprocessors, rules, and decorators.
+```
+npm install @redocly/cli -g
+```
 
-## TLDR
+Then you can use it as `redocly [command] [options]`, for example:
 
-`npx @redocly/cli lint path-to-root-file.yaml`
+```
+redocly lint path-to-root-file.yaml
+```
 
-## [Read the docs](https://redoc.ly/docs/cli/)
+### Docker
+
+To give the Docker container access to the OpenAPI definition files, you need to
+mount the containing directory as a volume. Assuming the OAS definition is rooted
+in the current working directory, you need the following command:
+
+```
+docker run --rm -v $PWD:/spec redocly/cli lint path-to-root-file.yaml
+```
+
+To build and run with a local image, run the following from the project root:
+
+```
+docker build -t redocly/cli .
+docker run --rm -v $PWD:/spec redocly/cli lint path-to-root-file.yaml
+```
+
+## Common tasks
+
+### Generate API reference documentation
+
+Redocly CLI is a great way to render API reference documentation. It uses open source [Redoc](https://github.com/redocly/redoc) to build your documentation. Use a command like this:
+
+```
+redocly build-docs openapi.yaml
+```
+
+Your API reference docs are in `redoc-static.html` by default. You can customize this in many ways. [Read the main docs](https://redocly.com/docs/cli/commands/build-docs) for more information.
+
+> :bulb: Redocly also has [hosted API reference docs](https://redocly.com/docs/api-registry/guides/api-registry-quickstart/), a (commercial) alternative to Redoc. Both Redoc and Redocly API reference docs can be worked on locally using the `preview-docs` command.
+
+### Lint an API description against a standard
+
+Check your API meets the expected standards using `lint` to ensure quality in every version of your API. Our API linter is designed for speed on even large documents, so it's easy to run locally, in CI, or anywhere you need it. It's also designed for humans, with meaningful error messages to help you get your API right every time. Try it like this:
+
+```
+redocly lint openapi.yaml
+```
+
+**Configure the rules** as you wish. No JSONPath here, just type-aware expressions that understand the OpenAPI structure. You can either use the [built-in rules](https://redocly.com/docs/cli/rules) to mix-and-match your ideal API standard, or break out the tools to build your own.
+
+**Format the output** in whatever way you need, the `stylish` output is as good as it sounds, but if you need JSON or Checkstyle outputs to integrate with other tools, we've got those too.
+
+**Multiple files supported** so you don't need to bundle your API description to lint it, just give the entry point and Redocly CLI does the rest.
+
+[Learn more about API standards and configuring Redocly rules](https://redocly.com/docs/cli/api-standards).
+
+### Transform an OpenAPI description
+
+If your OpenAPI description isn't everything you hoped it would be, enhance it with the Redocly [decorators](https://redocly.com/docs/cli/decorators) feature. This allows you to:
+
+- Publish reference docs with a subset of endpoints for public use
+- Improve the docs by adding examples and descriptions
+- Adapt an existing OpenAPI description, and replace details like URLs for use on staging platforms
+
+## Data collection
+
+This tool [collects data](./docs/usage-data.md) to help Redocly improve our products and services. You can opt out by setting the `REDOCLY_TELEMETRY` environment variable to `off`.
+
+## More resources
+
+[Read the detailed docs](https://redocly.com/docs/cli/).
 
 ## Credits
 
-Thanks to [graphql-js](https://github.com/graphql/graphql-js) and [eslint](https://github.com/eslint/eslint) for inspiration of the definition traversal approach and to [Swagger](https://github.com/swagger-api/swagger-editor), [Spectral](https://github.com/stoplightio/spectral), and [OAS-Kit](https://github.com/Mermade/oas-kit) for inspiring the ruleset.
+Thanks to [graphql-js](https://github.com/graphql/graphql-js) and [eslint](https://github.com/eslint/eslint) for inspiration of the definition traversal approach and to [Swagger](https://github.com/swagger-api/swagger-editor), [Spectral](https://github.com/stoplightio/spectral), and [OAS-Kit](https://github.com/Mermade/oas-kit) for inspiring the recommended ruleset.
+
+## Development
+
+Contributions are welcome! All the information you need is in [CONTRIBUTING.md](.github/CONTRIBUTING.md).

package/bin/cli.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-require("../lib/index");
+require('../lib/index');

package/lib/__mocks__/@redocly/openapi-core.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="jest" />
+import { Document } from '@redocly/openapi-core';
 export declare const __redoclyClient: {
     isAuthorizedWithRedocly: jest.Mock<any, any>;
     isAuthorizedWithRedoclyByRegion: jest.Mock<any, any>;
@@ -23,10 +24,23 @@ export declare const RedoclyClient: jest.Mock<{
 }, []>;
 export declare const loadConfig: jest.Mock<{
     configFile: null;
-    lint: {
+    styleguide: {
+        addIgnore: jest.Mock<any, any>;
         skipRules: jest.Mock<any, any>;
         skipPreprocessors: jest.Mock<any, any>;
+        saveIgnore: jest.Mock<any, any>;
         skipDecorators: jest.Mock<any, any>;
+        ignore: null;
+        decorators: {
+            oas2: {};
+            oas3_0: {};
+            oas3_1: {};
+        };
+        preprocessors: {
+            oas2: {};
+            oas3_0: {};
+            oas3_1: {};
+        };
     };
 }, []>;
 export declare const getMergedConfig: jest.Mock<any, any>;
@@ -42,3 +56,41 @@ export declare const getTotals: jest.Mock<{
 }, []>;
 export declare const formatProblems: jest.Mock<any, any>;
 export declare const slash: jest.Mock<any, any>;
+export declare const findConfig: jest.Mock<any, any>;
+export declare const doesYamlFileExist: jest.Mock<any, any>;
+export declare const bundleDocument: jest.Mock<Promise<{
+    problems: {};
+}>, []>;
+export declare const detectOpenAPI: jest.Mock<any, any>;
+export declare const isAbsoluteUrl: jest.Mock<any, any>;
+export declare class BaseResolver {
+    cache: Map<string, Promise<Document | ResolveError>>;
+    getFiles: jest.Mock<any, any>;
+    resolveExternalRef: jest.Mock<any, any>;
+    loadExternalRef: typeof jest.fn;
+    parseDocument: jest.Mock<any, any>;
+    resolveDocument: jest.Mock<any, any>;
+}
+export declare class ResolveError extends Error {
+    originalError: Error;
+    constructor(originalError: Error);
+}
+export declare class YamlParseError extends Error {
+    originalError: Error;
+    constructor(originalError: Error);
+}
+export declare enum OasVersion {
+    Version2 = "oas2",
+    Version3_0 = "oas3_0",
+    Version3_1 = "oas3_1"
+}
+export declare enum Oas3Operations {
+    get = "get",
+    put = "put",
+    post = "post",
+    delete = "delete",
+    options = "options",
+    head = "head",
+    patch = "patch",
+    trace = "trace"
+}

package/lib/__mocks__/@redocly/openapi-core.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.slash = exports.formatProblems = exports.getTotals = exports.bundle = exports.lint = exports.getMergedConfig = exports.loadConfig = exports.RedoclyClient = exports.__redoclyClient = void 0;
+exports.Oas3Operations = exports.OasVersion = exports.YamlParseError = exports.ResolveError = exports.BaseResolver = exports.isAbsoluteUrl = exports.detectOpenAPI = exports.bundleDocument = exports.doesYamlFileExist = exports.findConfig = exports.slash = exports.formatProblems = exports.getTotals = exports.bundle = exports.lint = exports.getMergedConfig = exports.loadConfig = exports.RedoclyClient = exports.__redoclyClient = void 0;
+const config_1 = require("./../../__tests__/fixtures/config");
+const documents_1 = require("../documents");
 exports.__redoclyClient = {
     isAuthorizedWithRedocly: jest.fn().mockResolvedValue(true),
     isAuthorizedWithRedoclyByRegion: jest.fn().mockResolvedValue(true),
@@ -16,13 +18,62 @@ exports.__redoclyClient = {
     },
 };
 exports.RedoclyClient = jest.fn(() => exports.__redoclyClient);
-exports.loadConfig = jest.fn(() => ({
-    configFile: null,
-    lint: { skipRules: jest.fn(), skipPreprocessors: jest.fn(), skipDecorators: jest.fn() },
-}));
+exports.loadConfig = jest.fn(() => config_1.ConfigFixture);
 exports.getMergedConfig = jest.fn();
 exports.lint = jest.fn();
 exports.bundle = jest.fn(() => ({ bundle: { parsed: null }, problems: null }));
 exports.getTotals = jest.fn(() => ({ errors: 0 }));
 exports.formatProblems = jest.fn();
 exports.slash = jest.fn();
+exports.findConfig = jest.fn();
+exports.doesYamlFileExist = jest.fn();
+exports.bundleDocument = jest.fn(() => Promise.resolve({ problems: {} }));
+exports.detectOpenAPI = jest.fn();
+exports.isAbsoluteUrl = jest.fn();
+class BaseResolver {
+    constructor() {
+        this.cache = new Map();
+        this.getFiles = jest.fn();
+        this.resolveExternalRef = jest.fn();
+        this.loadExternalRef = jest.fn;
+        this.parseDocument = jest.fn();
+        this.resolveDocument = jest
+            .fn()
+            .mockImplementationOnce(() => Promise.resolve({ source: { absoluteRef: 'ref' }, parsed: documents_1.firstDocument }))
+            .mockImplementationOnce(() => Promise.resolve({ source: { absoluteRef: 'ref' }, parsed: documents_1.secondDocument }));
+    }
+}
+exports.BaseResolver = BaseResolver;
+class ResolveError extends Error {
+    constructor(originalError) {
+        super(originalError.message);
+        this.originalError = originalError;
+        Object.setPrototypeOf(this, ResolveError.prototype);
+    }
+}
+exports.ResolveError = ResolveError;
+class YamlParseError extends Error {
+    constructor(originalError) {
+        super(originalError.message);
+        this.originalError = originalError;
+        Object.setPrototypeOf(this, YamlParseError.prototype);
+    }
+}
+exports.YamlParseError = YamlParseError;
+var OasVersion;
+(function (OasVersion) {
+    OasVersion["Version2"] = "oas2";
+    OasVersion["Version3_0"] = "oas3_0";
+    OasVersion["Version3_1"] = "oas3_1";
+})(OasVersion = exports.OasVersion || (exports.OasVersion = {}));
+var Oas3Operations;
+(function (Oas3Operations) {
+    Oas3Operations["get"] = "get";
+    Oas3Operations["put"] = "put";
+    Oas3Operations["post"] = "post";
+    Oas3Operations["delete"] = "delete";
+    Oas3Operations["options"] = "options";
+    Oas3Operations["head"] = "head";
+    Oas3Operations["patch"] = "patch";
+    Oas3Operations["trace"] = "trace";
+})(Oas3Operations = exports.Oas3Operations || (exports.Oas3Operations = {}));

package/lib/__mocks__/documents.d.ts

@@ -0,0 +1,92 @@
+export declare const firstDocument: {
+    openapi: string;
+    servers: {
+        url: string;
+    }[];
+    info: {
+        description: string;
+        version: string;
+        title: string;
+        termsOfService: string;
+        license: {
+            name: string;
+            url: string;
+        };
+    };
+    paths: {
+        '/GETUser/{userId}': {
+            summary: string;
+            description: string;
+            servers: ({
+                url: string;
+                description?: undefined;
+            } | {
+                url: string;
+                description: string;
+            })[];
+            get: {
+                tags: string[];
+                summary: string;
+                description: string;
+                operationId: string;
+                servers: {
+                    url: string;
+                }[];
+            };
+            parameters: {
+                name: string;
+                in: string;
+                schema: {
+                    description: string;
+                };
+            }[];
+        };
+    };
+    components: {};
+};
+export declare const secondDocument: {
+    openapi: string;
+    servers: {
+        url: string;
+    }[];
+    info: {
+        description: string;
+        version: string;
+        title: string;
+        termsOfService: string;
+        license: {
+            name: string;
+            url: string;
+        };
+    };
+    post: {
+        '/GETUser/{userId}': {
+            summary: string;
+            description: string;
+            servers: ({
+                url: string;
+                description?: undefined;
+            } | {
+                url: string;
+                description: string;
+            })[];
+            get: {
+                tags: string[];
+                summary: string;
+                description: string;
+                operationId: string;
+                servers: {
+                    url: string;
+                }[];
+            };
+            parameters: {
+                name: string;
+                in: string;
+                schema: {
+                    description: string;
+                };
+            }[];
+        };
+    };
+    components: {};
+};

package/lib/__mocks__/documents.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secondDocument = exports.firstDocument = void 0;
+exports.firstDocument = {
+    openapi: '3.0.0',
+    servers: [{ url: 'http://localhost:8080' }],
+    info: {
+        description: 'example test',
+        version: '1.0.0',
+        title: 'Swagger Petstore',
+        termsOfService: 'http://swagger.io/terms/',
+        license: {
+            name: 'Apache 2.0',
+            url: 'http://www.apache.org/licenses/LICENSE-2.0.html',
+        },
+    },
+    paths: {
+        '/GETUser/{userId}': {
+            summary: 'get user by id',
+            description: 'user info',
+            servers: [{ url: '/user' }, { url: '/pet', description: 'pet server' }],
+            get: {
+                tags: ['pet'],
+                summary: 'Find pet by ID',
+                description: 'Returns a single pet',
+                operationId: 'getPetById',
+                servers: [{ url: '/pet' }],
+            },
+            parameters: [{ name: 'param1', in: 'header', schema: { description: 'string' } }],
+        },
+    },
+    components: {},
+};
+exports.secondDocument = {
+    openapi: '3.0.0',
+    servers: [{ url: 'http://localhost:8080' }],
+    info: {
+        description: 'example test',
+        version: '1.0.0',
+        title: 'Swagger Petstore',
+        termsOfService: 'http://swagger.io/terms/',
+        license: {
+            name: 'Apache 2.0',
+            url: 'http://www.apache.org/licenses/LICENSE-2.0.html',
+        },
+    },
+    post: {
+        '/GETUser/{userId}': {
+            summary: 'get user',
+            description: 'user information',
+            servers: [{ url: '/user' }, { url: '/pet', description: '' }],
+            get: {
+                tags: ['pet'],
+                summary: 'Find pet by ID',
+                description: 'Returns a single pet',
+                operationId: 'getPetById',
+                servers: [{ url: '/pet' }],
+            },
+            parameters: [{ name: 'param1', in: 'header', schema: { description: 'string' } }],
+        },
+    },
+    components: {},
+};

package/lib/__mocks__/fs.d.ts

@@ -5,3 +5,5 @@ export declare const statSync: jest.Mock<{
     size: number;
 }, []>;
 export declare const createReadStream: jest.Mock<any, any>;
+export declare const writeFileSync: jest.Mock<any, any>;
+export declare const mkdirSync: jest.Mock<any, any>;

package/lib/__mocks__/fs.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReadStream = exports.statSync = exports.readFileSync = exports.existsSync = void 0;
+exports.mkdirSync = exports.writeFileSync = exports.createReadStream = exports.statSync = exports.readFileSync = exports.existsSync = void 0;
 exports.existsSync = jest.fn();
 exports.readFileSync = jest.fn(() => '');
 exports.statSync = jest.fn(() => ({ size: 0 }));
 exports.createReadStream = jest.fn();
+exports.writeFileSync = jest.fn();
+exports.mkdirSync = jest.fn();

package/lib/__mocks__/perf_hooks.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="jest" />
+export declare const performance: {
+    now: jest.Mock<any, any>;
+};

package/lib/__mocks__/perf_hooks.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performance = void 0;
+exports.performance = {
+    now: jest.fn(),
+};

package/lib/__mocks__/redoc.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="jest" />
+export declare const loadAndBundleSpec: jest.Mock<Promise<{
+    openapi: string;
+}>, []>;
+export declare const createStore: jest.Mock<Promise<{
+    toJS: jest.Mock<string, []>;
+}>, []>;

package/lib/__mocks__/redoc.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStore = exports.loadAndBundleSpec = void 0;
+exports.loadAndBundleSpec = jest.fn(() => Promise.resolve({ openapi: '3.0.0' }));
+exports.createStore = jest.fn(() => Promise.resolve({ toJS: jest.fn(() => '{}') }));

package/lib/__mocks__/utils.d.ts

@@ -1,8 +1,5 @@
 /// <reference types="jest" />
-export declare const getFallbackEntryPointsOrExit: jest.Mock<any, [entrypoints: any]>;
-export declare const getTotals: jest.Mock<{
-    errors: number;
-}, []>;
+export declare const getFallbackApisOrExit: jest.Mock<any, [entrypoints: any]>;
 export declare const dumpBundle: jest.Mock<string, []>;
 export declare const slash: jest.Mock<any, any>;
 export declare const pluralize: jest.Mock<any, any>;
@@ -15,3 +12,28 @@ export declare const getOutputFileName: jest.Mock<{
     ext: string;
 }, []>;
 export declare const handleError: jest.Mock<any, any>;
+export declare const exitWithError: jest.Mock<any, any>;
+export declare const writeYaml: jest.Mock<any, any>;
+export declare const loadConfigAndHandleErrors: jest.Mock<{
+    configFile: null;
+    styleguide: {
+        addIgnore: jest.Mock<any, any>;
+        skipRules: jest.Mock<any, any>;
+        skipPreprocessors: jest.Mock<any, any>;
+        saveIgnore: jest.Mock<any, any>;
+        skipDecorators: jest.Mock<any, any>;
+        ignore: null;
+        decorators: {
+            oas2: {};
+            oas3_0: {};
+            oas3_1: {};
+        };
+        preprocessors: {
+            oas2: {};
+            oas3_0: {};
+            oas3_1: {};
+        };
+    };
+}, []>;
+export declare const checkIfRulesetExist: jest.Mock<any, any>;
+export declare const sortTopLevelKeysForOas: jest.Mock<any, [document: any]>;

package/lib/__mocks__/utils.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleError = exports.getOutputFileName = exports.printLintTotals = exports.printUnusedWarnings = exports.printExecutionTime = exports.getExecutionTime = exports.pluralize = exports.slash = exports.dumpBundle = exports.getTotals = exports.getFallbackEntryPointsOrExit = void 0;
-exports.getFallbackEntryPointsOrExit = jest.fn((entrypoints) => entrypoints.map(() => ({ path: '' })));
-exports.getTotals = jest.fn(() => ({ errors: 0 }));
+exports.sortTopLevelKeysForOas = exports.checkIfRulesetExist = exports.loadConfigAndHandleErrors = exports.writeYaml = exports.exitWithError = exports.handleError = exports.getOutputFileName = exports.printLintTotals = exports.printUnusedWarnings = exports.printExecutionTime = exports.getExecutionTime = exports.pluralize = exports.slash = exports.dumpBundle = exports.getFallbackApisOrExit = void 0;
+const config_1 = require("../__tests__/fixtures/config");
+exports.getFallbackApisOrExit = jest.fn((entrypoints) => entrypoints.map((path) => ({ path })));
 exports.dumpBundle = jest.fn(() => '');
 exports.slash = jest.fn();
 exports.pluralize = jest.fn();
@@ -12,3 +12,8 @@ exports.printUnusedWarnings = jest.fn();
 exports.printLintTotals = jest.fn();
 exports.getOutputFileName = jest.fn(() => ({ outputFile: 'test.yaml', ext: 'yaml' }));
 exports.handleError = jest.fn();
+exports.exitWithError = jest.fn();
+exports.writeYaml = jest.fn();
+exports.loadConfigAndHandleErrors = jest.fn(() => config_1.ConfigFixture);
+exports.checkIfRulesetExist = jest.fn();
+exports.sortTopLevelKeysForOas = jest.fn((document) => document);

package/lib/__tests__/commands/build-docs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/__tests__/commands/build-docs.test.js

@@ -0,0 +1,59 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const redoc_1 = require("redoc");
+const server_1 = require("react-dom/server");
+const build_docs_1 = require("../../commands/build-docs");
+const utils_1 = require("../../commands/build-docs/utils");
+const utils_2 = require("../../utils");
+jest.mock('redoc');
+jest.mock('fs');
+jest.mock('../../utils');
+const config = {
+    output: '',
+    title: 'Test',
+    disableGoogleFont: false,
+    templateFileName: '',
+    templateOptions: {},
+    redocOptions: {},
+};
+jest.mock('react-dom/server', () => ({
+    renderToString: jest.fn(),
+}));
+jest.mock('handlebars', () => ({
+    compile: jest.fn(() => jest.fn(() => '<html></html>')),
+}));
+jest.mock('mkdirp', () => ({
+    sync: jest.fn(),
+}));
+describe('build-docs', () => {
+    it('should return correct html and call function for ssr', () => __awaiter(void 0, void 0, void 0, function* () {
+        const result = yield utils_1.getPageHTML({}, '../some-path/openapi.yaml', Object.assign(Object.assign({}, config), { redocCurrentVersion: '2.0.0' }));
+        expect(server_1.renderToString).toBeCalledTimes(1);
+        expect(redoc_1.createStore).toBeCalledTimes(1);
+        expect(result).toBe('<html></html>');
+    }));
+    it('should work correctly when calling handlerBuildCommand', () => __awaiter(void 0, void 0, void 0, function* () {
+        const processExitMock = jest.spyOn(process, 'exit').mockImplementation();
+        yield build_docs_1.handlerBuildCommand({
+            o: '',
+            title: 'test',
+            disableGoogleFont: false,
+            template: '',
+            templateOptions: {},
+            theme: { openapi: {} },
+            api: '../some-path/openapi.yaml',
+        }, {});
+        expect(redoc_1.loadAndBundleSpec).toBeCalledTimes(1);
+        expect(utils_2.getFallbackApisOrExit).toBeCalledTimes(1);
+        expect(processExitMock).toBeCalledTimes(0);
+    }));
+});