@apimatic/cli 1.0.2-alpha.2 → 1.1.0-alpha.10

package/lib/controllers/api/transform.js

@@ -1,49 +1,50 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getValidFormat = exports.downloadTransformationFile = exports.getTransformationId = void 0;
-const cli_ux_1 = require("cli-ux");
-const fs = require("fs-extra");
-const utils_1 = require("../../utils/utils");
-const sdk_1 = require("@apimatic/sdk");
-exports.getTransformationId = async ({ file, url, format }, transformationController) => {
-    cli_ux_1.default.action.start("Transforming API specification");
+import { ux } from "@oclif/core";
+import fsExtra from "fs-extra";
+import { writeFileUsingReadableStream } from "../../utils/utils.js";
+import { TransformationFormats } from "../../types/api/transform.js";
+import { ContentType, ExportFormats, FileWrapper } from "@apimatic/sdk";
+export const getTransformationId = async ({ file, url, format }, transformationController) => {
+    ux.action.start("Transforming API specification");
     let generation;
     if (file) {
-        const fileDescriptor = new sdk_1.FileWrapper(fs.createReadStream(file));
-        generation = await transformationController.transformViaFile(fileDescriptor, format);
+        const fileDescriptor = new FileWrapper(fsExtra.createReadStream(file));
+        generation = await transformationController.transformViaFile(ContentType.EnumMultipartformdata, fileDescriptor, format);
     }
     else if (url) {
         const body = {
             url: url,
             exportFormat: format
         };
-        generation = await transformationController.transformViaURL(body);
+        generation = await transformationController.transformViaUrl(body);
     }
     else {
         throw new Error("Please provide a specification file");
     }
-    cli_ux_1.default.action.stop();
+    ux.action.stop();
     return generation.result;
 };
-exports.downloadTransformationFile = async ({ id, destinationFilePath, transformationController }) => {
-    cli_ux_1.default.action.start("Downloading Transformed file");
+export const downloadTransformationFile = async ({ id, destinationFilePath, transformationController }) => {
+    ux.action.start("Downloading Transformed file");
     const { result } = await transformationController.downloadTransformedFile(id);
     if (result.readable) {
-        await utils_1.writeFileUsingReadableStream(result, destinationFilePath);
+        await writeFileUsingReadableStream(result, destinationFilePath);
     }
     else {
         throw new Error("Couldn't save transformation file");
     }
-    cli_ux_1.default.action.stop();
+    ux.action.stop();
     return destinationFilePath;
 };
 // Get valid platform from user's input, convert simple platform to valid Platforms enum value
-exports.getValidFormat = (format) => {
-    if (Object.keys(sdk_1.ExportFormats).find((exportFormat) => exportFormat === format)) {
-        return sdk_1.ExportFormats[format];
+export const getValidFormat = (format) => {
+    const key = Object.keys(TransformationFormats).find((value) => value === format);
+    if (key) {
+        const transformationFormat = TransformationFormats[key];
+        return ExportFormats[transformationFormat];
     }
     else {
-        const formats = Object.keys(sdk_1.ExportFormats).join("|");
-        throw new Error(`Please provide a valid platform i.e. ${formats}`);
+        const formats = Object.keys(TransformationFormats).join("|");
+        throw new Error(`Please provide a valid platform, e.g. ${formats}`);
     }
 };
+//# sourceMappingURL=transform.js.map

package/lib/controllers/api/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/controllers/api/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,OAAO,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAGL,qBAAqB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,WAAW,EACX,aAAa,EACb,WAAW,EAIZ,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAA0B,EAC7C,wBAAkD,EACzB,EAAE;IAC3B,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAElD,IAAI,UAAuC,CAAC;IAC5C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,cAAc,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,UAAU,GAAG,MAAM,wBAAwB,CAAC,gBAAgB,CAC1D,WAAW,CAAC,qBAAqB,EACjC,cAAc,EACd,MAAuB,CACxB,CAAC;IACJ,CAAC;SAAM,IAAI,GAAG,EAAE,CAAC;QACf,MAAM,IAAI,GAA2B;YACnC,GAAG,EAAE,GAAG;YACR,YAAY,EAAE,MAAuB;SACtC,CAAC;QACF,UAAU,GAAG,MAAM,wBAAwB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,EAAE,EAC/C,EAAE,EACF,mBAAmB,EACnB,wBAAwB,EACK,EAAmB,EAAE;IAClD,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAEhD,MAAM,EAAE,MAAM,EAAE,GAAuB,MAAM,wBAAwB,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAElG,IAAK,MAAgC,CAAC,QAAQ,EAAE,CAAC;QAC/C,MAAM,4BAA4B,CAAC,MAA+B,EAAE,mBAAmB,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,mBAAmB,CAAC;AAC7B,CAAC,CAAC;AACF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,EAAE;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAElE,CAAC;IACd,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,GAAG,CAA+B,CAAC;QACtF,OAAO,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC,CAAC"}

package/lib/controllers/api/validate.d.ts

@@ -1,3 +1,3 @@
-import { GetValidationParams } from "../../types/api/validate";
-import { APIValidationExternalApisController, ApiValidationSummary } from "@apimatic/sdk";
-export declare const getValidation: ({ file, url }: GetValidationParams, apiValidationController: APIValidationExternalApisController) => Promise<ApiValidationSummary>;
+import { ApiValidationExternalApIsController, ApiValidationSummary } from "@apimatic/sdk";
+import { GetValidationParams } from "../../types/api/validate.js";
+export declare const getValidationSummary: ({ file, url }: GetValidationParams, apiValidationController: ApiValidationExternalApIsController) => Promise<ApiValidationSummary>;

package/lib/controllers/api/validate.js

@@ -1,22 +1,29 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getValidation = void 0;
-const cli_ux_1 = require("cli-ux");
-const fs = require("fs-extra");
-const core_1 = require("@apimatic/core");
-exports.getValidation = async ({ file, url }, apiValidationController) => {
+import fsExtra from "fs-extra";
+import { ContentType, FileWrapper } from "@apimatic/sdk";
+import { createTempDirectory, deleteFile, zipDirectory } from "../../utils/utils.js";
+export const getValidationSummary = async ({ file, url }, apiValidationController) => {
     let validation;
-    cli_ux_1.default.action.start("Validating specification file");
     if (file) {
-        const fileDescriptor = new core_1.FileWrapper(fs.createReadStream(file));
-        validation = await apiValidationController.validateAPIViaFile(fileDescriptor);
+        const fileStatus = fsExtra.statSync(file);
+        if (fileStatus.isDirectory()) {
+            const tempDir = await createTempDirectory();
+            const zipPath = await zipDirectory(file, tempDir);
+            const zipFile = new FileWrapper(fsExtra.createReadStream(zipPath));
+            validation = await apiValidationController.validateApiViaFile(ContentType.EnumMultipartformdata, zipFile);
+            await deleteFile(zipPath);
+            await fsExtra.remove(tempDir);
+        }
+        else {
+            const fileDescriptor = new FileWrapper(fsExtra.createReadStream(file));
+            validation = await apiValidationController.validateApiViaFile(ContentType.EnumMultipartformdata, fileDescriptor);
+        }
     }
     else if (url) {
-        validation = await apiValidationController.validateAPIViaURL(url);
+        validation = await apiValidationController.validateApiViaUrl(url);
     }
     else {
         throw new Error("Please provide a specification file");
     }
-    cli_ux_1.default.action.stop();
     return validation.result;
 };
+//# sourceMappingURL=validate.js.map

package/lib/controllers/api/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/controllers/api/validate.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAC;AAC/B,OAAO,EAA0E,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjI,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,EAAE,IAAI,EAAE,GAAG,EAAuB,EAClC,uBAA4D,EAC7B,EAAE;IACjC,IAAI,UAA6C,CAAC;IAElD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,UAAU,GAAG,MAAM,uBAAuB,CAAC,kBAAkB,CAAC,WAAW,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;YAE1G,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YAE1B,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YACvE,UAAU,GAAG,MAAM,uBAAuB,CAAC,kBAAkB,CAAC,WAAW,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;QACnH,CAAC;IACH,CAAC;SAAM,IAAI,GAAG,EAAE,CAAC;QACf,UAAU,GAAG,MAAM,uBAAuB,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC,CAAC"}

package/lib/controllers/portal/generate.d.ts

@@ -1,2 +1,3 @@
-import { GeneratePortalParams } from "../../types/portal/generate";
-export declare const downloadDocsPortal: ({ zippedBuildFilePath, portalFolderPath, zippedPortalPath, overrideAuthKey, zip }: GeneratePortalParams, configDir: string) => Promise<string>;
+import { GeneratePortalParams } from "../../types/portal/generate.js";
+import { Result } from "../../types/common/result.js";
+export declare const downloadDocsPortal: (params: GeneratePortalParams, configDir: string) => Promise<Result<string, string>>;

package/lib/controllers/portal/generate.js

@@ -1,49 +1,106 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadDocsPortal = void 0;
-const cli_ux_1 = require("cli-ux");
-const fs = require("fs-extra");
-const FormData = require("form-data");
-const env_1 = require("../../config/env");
-const utils_1 = require("../../utils/utils");
-const auth_manager_1 = require("../../client-utils/auth-manager");
-const axios_1 = require("axios");
-// TODO: Remove after SDK is patched
-const downloadPortalAxios = async (zippedBuildFilePath, overrideAuthKey, configDir) => {
-    const formData = new FormData();
-    const authInfo = await auth_manager_1.getAuthInfo(configDir);
-    formData.append("file", fs.createReadStream(zippedBuildFilePath));
-    const config = {
-        headers: Object.assign({ Authorization: authInfo || overrideAuthKey ? `X-Auth-Key ${(authInfo === null || authInfo === void 0 ? void 0 : authInfo.authKey.trim()) || overrideAuthKey}` : "" }, formData.getHeaders()),
-        responseType: "arraybuffer"
-    };
-    const { data } = await axios_1.default.post(`${env_1.baseURL}/portal`, formData, config);
-    return data;
-};
-// Download Docs Portal
-exports.downloadDocsPortal = async ({ zippedBuildFilePath, portalFolderPath, zippedPortalPath, overrideAuthKey, zip }, configDir) => {
-    cli_ux_1.default.action.start("Downloading portal");
-    // Check if the build file exists for the user or not
-    if (!(await fs.pathExists(zippedBuildFilePath))) {
-        throw new Error("Build file doesn't exist");
-    }
-    // TODO: ***CRITICAL*** Remove this call once the SDK is patched
-    const data = await downloadPortalAxios(zippedBuildFilePath, overrideAuthKey, configDir);
-    await utils_1.deleteFile(zippedBuildFilePath);
-    await fs.writeFile(zippedPortalPath, data);
-    // TODO: Uncomment this code block when the SDK is patched
-    // const file: FileWrapper = new FileWrapper(fs.createReadStream(zippedBuildFilePath));
-    // const { result }: ApiResponse<NodeJS.ReadableStream | Blob> =
-    //   await docsPortalController.generateOnPremPortalViaBuildInput(file);
-    // if ((data as NodeJS.ReadableStream).readable) {
-    //   await writeFileUsingReadableStream(data as NodeJS.ReadableStream, zippedPortalPath);
-    if (!zip) {
-        await utils_1.unzipFile(fs.createReadStream(zippedPortalPath), portalFolderPath);
-        await utils_1.deleteFile(zippedPortalPath);
-    }
-    cli_ux_1.default.action.stop();
-    return zip ? zippedPortalPath : portalFolderPath;
-    // } else {
-    //   throw new Error("Couldn't download the portal");
-    // }
+import fsExtra from "fs-extra";
+import { deleteFile, extractZipFile, getMessageInRedColor, parseStreamBodyToJson } from "../../utils/utils.js";
+import { getAuthInfo } from "../../client-utils/auth-manager.js";
+import { ApiError, Client, ContentType, DocsPortalManagementController, FileWrapper, ProblemDetailsError, UnauthorizedResponseError } from "@apimatic/sdk";
+import { Result } from "../../types/common/result.js";
+const CONTENT_TYPE = ContentType.EnumMultipartformdata;
+const TIMEOUT = 0;
+export const downloadDocsPortal = async (params, configDir) => {
+    if (!(await fsExtra.pathExists(params.sourceBuildInputZipFilePath))) {
+        return Result.failure("Build file doesn't exist");
+    }
+    const authInfo = await getAuthInfo(configDir);
+    const authorizationHeader = createAuthorizationHeader(authInfo, params.overrideAuthKey);
+    const client = createApiClient(authorizationHeader);
+    const docsPortalManagementController = new DocsPortalManagementController(client);
+    try {
+        const stream = await generatePortalFromSyncEndpoint(docsPortalManagementController, params.sourceBuildInputZipFilePath);
+        await saveGeneratedPortalStreamToZipFile(stream, params.generatedPortalArtifactsZipFilePath);
+        await deleteFile(params.sourceBuildInputZipFilePath);
+        if (params.generateZipFile) {
+            return Result.success(params.generatedPortalArtifactsZipFilePath);
+        }
+        await extractZipFile(params.generatedPortalArtifactsZipFilePath, params.generatedPortalArtifactsFolderPath);
+        await deleteFile(params.generatedPortalArtifactsZipFilePath);
+        return Result.success(params.generatedPortalArtifactsFolderPath);
+    }
+    catch (error) {
+        return handlePortalGenerationErrors(error, params);
+    }
+};
+const createAuthorizationHeader = (authInfo, overrideAuthKey) => {
+    if (overrideAuthKey) {
+        return `X-Auth-Key ${overrideAuthKey}`;
+    }
+    if (!authInfo) {
+        return "";
+    }
+    return `X-Auth-Key ${authInfo.authKey}`;
+};
+const createApiClient = (authorizationHeader) => {
+    return new Client({
+        customHeaderAuthenticationCredentials: {
+            Authorization: authorizationHeader
+        },
+        timeout: TIMEOUT
+    });
+};
+const generatePortalFromSyncEndpoint = async (docsPortalManagementController, zippedBuildFilePath) => {
+    const file = new FileWrapper(fsExtra.createReadStream(zippedBuildFilePath));
+    const response = await docsPortalManagementController.generateOnPremPortalViaBuildInput(CONTENT_TYPE, file);
+    return response.result;
+};
+const saveGeneratedPortalStreamToZipFile = async (data, generatedPortalArtifactsZipFilePath) => {
+    const writeStream = fsExtra.createWriteStream(generatedPortalArtifactsZipFilePath);
+    await new Promise((resolve, reject) => {
+        data
+            .pipe(writeStream)
+            .on("finish", () => resolve())
+            .on("error", (error) => reject(Result.failure(`Failed to save downloaded portal to file: ${error.message}`)));
+    });
+};
+const handlePortalGenerationErrors = async (error, params) => {
+    var _a, _b;
+    if (error instanceof UnauthorizedResponseError) {
+        //401
+        const body = await parseErrorResponse(error);
+        return Result.failure(getMessageInRedColor((_a = body.message) !== null && _a !== void 0 ? _a : "Unauthorized access"));
+    }
+    else if (error instanceof ProblemDetailsError) {
+        //400 & 403
+        const body = await parseErrorResponse(error);
+        const message = body.errors[Object.keys(body.errors)[0]][0];
+        return Result.failure(getMessageInRedColor(body.title + " " + ((_b = body.detail) !== null && _b !== void 0 ? _b : "") + ":\n" + message));
+    }
+    else if (error instanceof ApiError && error.statusCode === 422) {
+        //422
+        await extractErrorZipFile(error, params);
+        return Result.failure(getMessageInRedColor("An error occurred during portal generation due to an issue with the input. An error report has been written at the destination path: " +
+            params.generatedPortalArtifactsFolderPath));
+    }
+    else {
+        return Result.failure(getMessageInRedColor(error instanceof Error ? error.message : String(error)));
+    }
+};
+const parseErrorResponse = async (error) => {
+    if (error instanceof Error && "body" in error) {
+        const stream = error.body;
+        return await parseStreamBodyToJson(stream);
+    }
+    throw error;
+};
+const extractErrorZipFile = async (error, params) => {
+    const data = error.body;
+    const writeStream = fsExtra.createWriteStream(params.generatedPortalArtifactsZipFilePath);
+    await new Promise((resolve, reject) => {
+        data
+            .pipe(writeStream)
+            .on("finish", () => resolve())
+            .on("error", reject);
+    });
+    if (!params.generateZipFile) {
+        await extractZipFile(params.generatedPortalArtifactsZipFilePath, params.generatedPortalArtifactsFolderPath);
+        await deleteFile(params.generatedPortalArtifactsZipFilePath);
+    }
 };
+//# sourceMappingURL=generate.js.map

package/lib/controllers/portal/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/controllers/portal/generate.ts"],"names":[],"mappings":"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"}

package/lib/controllers/portal/quickstart.d.ts

@@ -0,0 +1,14 @@
+import { ApiValidationExternalApIsController, ApiValidationSummary } from "@apimatic/sdk";
+import { LoginCredentials, SpecFile } from "../../types/portal/quickstart.js";
+import { SDKClient } from "../../client-utils/sdk-client.js";
+import { PortalQuickstartPrompts } from "../../prompts/portal/quickstart.js";
+export declare class PortalQuickstartController {
+    private readonly specUrl;
+    isUserAuthenticated(configDir: string): Promise<boolean>;
+    userLogin(credentials: LoginCredentials, client: SDKClient, configDir: string): Promise<void>;
+    getSpecFile(spec: string): Promise<SpecFile>;
+    getSpecValidationSummary(prompts: PortalQuickstartPrompts, specFile: SpecFile, apiValidationController: ApiValidationExternalApIsController): Promise<ApiValidationSummary>;
+    setupBuildDirectory(prompts: PortalQuickstartPrompts, targetFolder: string, specFile: SpecFile, validationSummary: ApiValidationSummary, languages: string[]): Promise<void>;
+    generatePortalArtifacts(targetFolder: string, configDir: string): Promise<string>;
+    servePortal(generatedPortalPath: string, targetFolder: string, configDir: string): Promise<boolean>;
+}

package/lib/controllers/portal/quickstart.js

@@ -0,0 +1,253 @@
+import { simpleGit } from "simple-git";
+import axios from "axios";
+import * as path from "path";
+import * as filetype from "file-type";
+import fs from "fs";
+import fsExtra from "fs-extra";
+import { getAuthInfo } from "../../client-utils/auth-manager.js";
+import { createTempDirectory, isValidUrl, unzipFile, getMessageInRedColor, clearDirectory, deleteFile, cleanUpGeneratedPortalFiles } from "../../utils/utils.js";
+import { getValidationSummary } from "../api/validate.js";
+import { generatePortal } from "./serve.js";
+import { metadataFileContent, staticPortalRepoUrl } from "../../config/env.js";
+import { PortalServerService } from "../../services/portal/server.js";
+export class PortalQuickstartController {
+    constructor() {
+        this.specUrl = "https://github.com/apimatic/static-portal-workflow/blob/master/spec/Apimatic-Calculator.json";
+    }
+    async isUserAuthenticated(configDir) {
+        const storedAuth = await getAuthInfo(configDir);
+        if (!(storedAuth === null || storedAuth === void 0 ? void 0 : storedAuth.authKey)) {
+            return false;
+        }
+        return true;
+    }
+    async userLogin(credentials, client, configDir) {
+        await client.login(credentials.email, credentials.password, configDir);
+    }
+    async getSpecFile(spec) {
+        let filePath = "";
+        const tempSpecDir = await createTempDirectory();
+        if (spec) {
+            let specPath = String(spec);
+            if (isValidUrl(specPath)) {
+                try {
+                    const response = await axios.head(specPath);
+                    if (response.headers["content-type"].includes("text/html")) {
+                        throw new Error(getMessageInRedColor(`Invalid URL. Please check the URL and ensure it points to a valid OpenAPI definition.`));
+                    }
+                    const specFile = await axios.get(specPath, { responseType: "arraybuffer" });
+                    const fileName = path.basename(specPath);
+                    filePath = path.join(tempSpecDir, fileName);
+                    await fsExtra.writeFile(filePath, specFile.data);
+                }
+                catch (error) {
+                    if (axios.isAxiosError(error)) {
+                        if (error.response) {
+                            if (error.response.status === 404) {
+                                throw new Error(getMessageInRedColor(`Unable to download the API Definition. The server returned a 404 Not Found error. Please verify that the provided URL is correct and publicly accessible.`));
+                            }
+                            else {
+                                throw new Error(getMessageInRedColor(`Unable to download the API Definition. The server returned ${error.response.status} ${error.response.statusText}`));
+                            }
+                        }
+                        else if (error.request) {
+                            if (error.code === "ECONNABORTED") {
+                                throw new Error(getMessageInRedColor(`Unable to download the API Definition, your request timed out. Please check your internet connection and try again, or contact APIMatic support for help if your problem persists.`));
+                            }
+                            else if (error.code === "ENOTFOUND" || error.code === "ERR_NETWORK") {
+                                throw new Error(getMessageInRedColor(`Failed to download the API Definition file due to network issues. Please check your internet connection and try again.`));
+                            }
+                            else {
+                                throw new Error(getMessageInRedColor(`Failed to download the API Definition file, no response was received from the server. Please try again later.`));
+                            }
+                        }
+                        else {
+                            throw new Error(getMessageInRedColor(`Failed to download API Definition: ${error.message}`));
+                        }
+                    }
+                    else {
+                        throw new Error(getMessageInRedColor(`Unable to save API Definition : ${error instanceof Error ? error.message : "Unknown error"}`));
+                    }
+                }
+            }
+            else {
+                specPath = path.normalize(specPath);
+                const fileType = await filetype.fromFile(specPath);
+                if ((fileType === null || fileType === void 0 ? void 0 : fileType.ext) === "zip") {
+                    filePath = tempSpecDir;
+                    await unzipFile(fs.createReadStream(specPath), tempSpecDir);
+                }
+                else {
+                    const destinationPath = path.join(tempSpecDir, path.basename(specPath));
+                    filePath = destinationPath;
+                    await fsExtra.copy(specPath, destinationPath);
+                }
+            }
+        }
+        return { filePath, url: this.specUrl };
+    }
+    async getSpecValidationSummary(prompts, specFile, apiValidationController) {
+        const validationFlags = {
+            file: specFile.filePath,
+            url: specFile.url
+        };
+        try {
+            const validationSummary = await getValidationSummary(validationFlags, apiValidationController);
+            return validationSummary;
+        }
+        catch (error) {
+            prompts.displaySpecValidationErrorMessage();
+            if (axios.isAxiosError(error)) {
+                if (error.response) {
+                    if (error.response.status === 400) {
+                        throw new Error(getMessageInRedColor(`The provided spec file is not valid. Please ensure that the spec you have provided is a valid API definition file.`));
+                    }
+                    else if (error.response.status === 500) {
+                        throw new Error(getMessageInRedColor(`The server encountered an error while validating your spec file, please try again later. If the issue persists, contact our team at support@apimatic.io`));
+                    }
+                    else {
+                        throw new Error(getMessageInRedColor(`Something went wrong while validating your spec file. The server returned the following error ${error.response.status} ${error.response.statusText}. Please try again later. If the issue persists, contact our team at support@apimatic.io`));
+                    }
+                }
+                else if (error.request) {
+                    if (error.code === "ECONNABORTED") {
+                        throw new Error(getMessageInRedColor(`The spec validation request timed out. Please try again.`));
+                    }
+                    else if (error.code === "ENOTFOUND" || error.code === "ERR_NETWORK") {
+                        throw new Error(getMessageInRedColor(`Network error encountered while validating the spec file. Please check your connection and try again.`));
+                    }
+                    else {
+                        throw new Error(getMessageInRedColor(`Something went wrong while validating the spec file, please try again. If the issue persists, reach out to our support team at support@apimatic.io`));
+                    }
+                }
+                else {
+                    throw new Error(getMessageInRedColor(`Failed to validate spec file: ${error.message}`));
+                }
+            }
+            else if (error.result) {
+                const apiError = error;
+                if (error.body && apiError.statusCode === 401) {
+                    throw new Error("You are not authorized to perform this action.");
+                }
+                else {
+                    throw new Error(error.message);
+                }
+            }
+            else if (error.statusCode === 401) {
+                throw new Error("You are not authorized to perform this action.");
+            }
+            else if (error.statusCode === 402 &&
+                error.body &&
+                typeof error.body === "string") {
+                throw new Error(error.body);
+            }
+            else {
+                throw new Error(getMessageInRedColor(`Something went wrong while validating the spec file, please try again later. If the issue persists, contact our team at support@apimatic.io`));
+            }
+        }
+    }
+    async setupBuildDirectory(prompts, targetFolder, specFile, validationSummary, languages) {
+        const git = simpleGit({
+            timeout: {
+                block: 60 * 1000 // 1 minute timeout.
+            }
+        });
+        try {
+            await git.clone(staticPortalRepoUrl, targetFolder);
+        }
+        catch (error) {
+            prompts.displayBuildDirectoryGenerationErrorMessage();
+            if (error instanceof Error) {
+                if (error.message.includes("timed out")) {
+                    throw new Error(getMessageInRedColor("The operation timed out while setting up the build directory. Please check your internet connection and try again."));
+                }
+                else if (error.message.includes("Could not resolve host")) {
+                    throw new Error(getMessageInRedColor("Unable to resolve the host. Please check your network settings and try again."));
+                }
+                else {
+                    throw new Error(getMessageInRedColor(`Failed to set up the build directory. ${error.message}`));
+                }
+            }
+            else {
+                throw new Error(getMessageInRedColor(`Failed to set up the build directory. ${error}`));
+            }
+        }
+        await clearDirectory(path.join(targetFolder, ".git"));
+        await clearDirectory(path.join(targetFolder, ".github"));
+        if (specFile.filePath && validationSummary.success) {
+            await deleteFile(path.join(targetFolder, "spec", "Apimatic-Calculator.json"));
+            fsExtra.copy(specFile.filePath, path.join(targetFolder, "spec", path.basename(specFile.filePath)));
+        }
+        const buildFilePath = path.join(targetFolder, "APIMATIC-BUILD.json");
+        const buildFileContent = JSON.parse(fs.readFileSync(buildFilePath, "utf8"));
+        const languageConfig = languages.reduce((config, lang) => {
+            config[lang] = {};
+            return config;
+        }, {});
+        buildFileContent.generatePortal.languageConfig = languageConfig;
+        fs.writeFileSync(buildFilePath, JSON.stringify(buildFileContent, null, 2));
+        const specFolder = path.join(targetFolder, "spec");
+        const metadataFile = fs.readdirSync(specFolder).find((file) => file.startsWith("APIMATIC-META"));
+        if (!metadataFile) {
+            const newMetadataFilePath = path.join(specFolder, "APIMATIC-META.json");
+            fs.writeFileSync(newMetadataFilePath, JSON.stringify(metadataFileContent, null, 2));
+        }
+    }
+    async generatePortalArtifacts(targetFolder, configDir) {
+        const generatedPortalPath = path.join(targetFolder, "generated_portal");
+        try {
+            await generatePortal(targetFolder, generatedPortalPath, configDir);
+            return generatedPortalPath;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.response) {
+                    if (error.response.status === 400) {
+                        throw new Error(getMessageInRedColor(`The provided input is not valid. Please ensure the zip file contains a valid build file at the root level.`));
+                    }
+                    else if (error.response.status === 403) {
+                        throw new Error(getMessageInRedColor(`Access denied. It looks like you don't have access to APIMatic's Docs as Code offering. Check your subscription details and contact our team at support@apimatic.io if you believe this is a mistake.`));
+                    }
+                    else if (error.response.status === 422) {
+                        throw new Error(getMessageInRedColor(`Unable to process the build input. Please verify that your zip file is correctly structured and your build file is a valid JSON file.`));
+                    }
+                    else if (error.response.status === 500) {
+                        throw new Error(getMessageInRedColor(`The server encountered an error while generating your portal, please try again. If the issue persists, contact our team at support@apimatic.io`));
+                    }
+                    else {
+                        throw new Error(getMessageInRedColor(`Something went wrong while generating the portal. The server returned the following error ${error.response.status} ${error.response.statusText}. Please try again later. If the issue persists, contact our team at support@apimatic.io`));
+                    }
+                }
+                else if (error.request) {
+                    if (error.code === "ECONNABORTED") {
+                        throw new Error(getMessageInRedColor(`The portal generation request timed out. Please try again. If the issue persists, try out our Async API for Docs as Code: https://docs.apimatic.io/platform-api/#/http/api-endpoints/docs-portal-management/generate-on-prem-portal-via-build-input`));
+                    }
+                    else if (error.code === "ENOTFOUND" || error.code === "ERR_NETWORK") {
+                        throw new Error(getMessageInRedColor(`Network error encountered while generating the portal. Please check your connection and try again.`));
+                    }
+                    else {
+                        throw new Error(getMessageInRedColor(`Something went wrong while generating the portal, please try again. If the issue persists, reach out to our support team at support@apimatic.io`));
+                    }
+                }
+                else {
+                    throw new Error(getMessageInRedColor(`Failed to generate portal: ${error.message}`));
+                }
+            }
+            else {
+                throw new Error(getMessageInRedColor(`Something went wrong while generating the portal, please try again later. If the issue persists, contact our team at support@apimatic.io`));
+            }
+        }
+    }
+    async servePortal(generatedPortalPath, targetFolder, configDir) {
+        const server = new PortalServerService();
+        server.setupServer(generatedPortalPath);
+        await cleanUpGeneratedPortalFiles(targetFolder);
+        return await server.startServer({
+            generatedPortalPath,
+            targetFolder,
+            configDir,
+            authKey: null
+        }, false, false);
+    }
+}
+//# sourceMappingURL=quickstart.js.map

package/lib/controllers/portal/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../../src/controllers/portal/quickstart.ts"],"names":[],"mappings":"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"}

package/lib/controllers/portal/serve.d.ts

@@ -0,0 +1,3 @@
+import chokidar from "chokidar";
+export declare const watchAndRegeneratePortal: (sourceDir: string, portalDir: string, configDir: string, overrideAuthKey: string | null, ignoredPaths?: string[]) => Promise<chokidar.FSWatcher>;
+export declare const generatePortal: (sourceDir: string, portalDir: string, configDir: string, ignoredPaths?: string[], overrideAuthKey?: string | null) => Promise<void>;