@apimatic/cli 1.1.0-alpha.9 → 1.1.0-beta.10

package/lib/actions/portal/generate.js

@@ -1,58 +1,63 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PortalGenerateAction = void 0;
-const path = require("path");
-const fs = require("fs-extra");
-const portal_service_1 = require("../../infrastructure/services/portal-service");
-const result_1 = require("../../types/common/result");
-const utils_1 = require("../../utils/utils");
-const generate_1 = require("../../prompts/portal/generate");
-class PortalGenerateAction {
-    constructor() {
-        this.prompts = new generate_1.PortalGeneratePrompts();
-    }
-    async generatePortal(paths, flags, configDir) {
-        var _a;
-        this.prompts.displayPortalGenerationMessage();
-        const pathsToIgnore = (0, utils_1.getGeneratedFilesPaths)(paths.sourceFolderPath, paths.generatedPortalArtifactsFolderPath);
-        //TODO: Refactor this method, carries dual responsibility.
-        const sourceBuildInputZipFilePath = await (0, utils_1.validateAndZipPortalSource)(paths.sourceFolderPath, path.join(paths.sourceFolderPath, ".portal_source.zip"), pathsToIgnore);
-        const generatePortalParams = {
-            sourceBuildInputZipFilePath: sourceBuildInputZipFilePath,
-            generatedPortalArtifactsFolderPath: paths.generatedPortalArtifactsFolderPath,
-            generatedPortalArtifactsZipFilePath: paths.generatedPortalArtifactsZipFilePath,
-            overrideAuthKey: (_a = flags["auth-key"]) !== null && _a !== void 0 ? _a : null,
-            generateZipFile: flags.zip
-        };
-        const docsPortalService = new portal_service_1.PortalService();
-        const portalGenerationResult = await docsPortalService.generateOnPremPortal(generatePortalParams, configDir);
-        await (0, utils_1.deleteFile)(sourceBuildInputZipFilePath);
-        if (portalGenerationResult.isSuccess()) {
-            await this.saveGeneratedPortalStreamToZipFile(portalGenerationResult.value, paths.generatedPortalArtifactsZipFilePath);
-            if (flags.zip) {
-                this.prompts.displayPortalGenerationSuccessMessage();
-                this.prompts.displayOutroMessage(paths.generatedPortalArtifactsZipFilePath);
-                return;
+import { PortalGeneratePrompts } from "../../prompts/portal/generate.js";
+import { PortalService } from "../../infrastructure/services/portal-service.js";
+import { ActionResult } from "../action-result.js";
+import { BuildContext } from "../../types/build-context.js";
+import { PortalContext } from "../../types/portal-context.js";
+import { withDirPath } from "../../infrastructure/tmp-extensions.js";
+import { LauncherService } from "../../infrastructure/launcher-service.js";
+import { TempContext } from "../../types/temp-context.js";
+import { ServiceError } from "../../infrastructure/service-error.js";
+export class GenerateAction {
+    constructor(configDir, commandMetadata, authKey = null) {
+        this.prompts = new PortalGeneratePrompts();
+        this.launcherService = new LauncherService();
+        this.portalService = new PortalService();
+        this.execute = async (buildDirectory, portalDirectory, force, zipPortal, displayMessages = true) => {
+            if (buildDirectory.isEqual(portalDirectory)) {
+                this.prompts.directoryCannotBeSame(portalDirectory);
+                return ActionResult.failed();
             }
-            await (0, utils_1.extractZipFile)(paths.generatedPortalArtifactsZipFilePath, paths.generatedPortalArtifactsFolderPath);
-            await (0, utils_1.deleteFile)(paths.generatedPortalArtifactsZipFilePath);
-            this.prompts.displayPortalGenerationSuccessMessage();
-            this.prompts.displayOutroMessage(paths.generatedPortalArtifactsFolderPath);
-        }
-        else {
-            this.prompts.displayPortalGenerationErrorMessage();
-            this.prompts.logError((0, utils_1.getMessageInRedColor)(`${portalGenerationResult.error}`));
-        }
-    }
-    async saveGeneratedPortalStreamToZipFile(data, generatedPortalArtifactsZipFilePath) {
-        const writeStream = fs.createWriteStream(generatedPortalArtifactsZipFilePath);
-        await new Promise((resolve, reject) => {
-            data
-                .pipe(writeStream)
-                .on("finish", () => resolve())
-                .on("error", (error) => reject(result_1.Result.failure(`Failed to save downloaded portal to file: ${error.message}`)));
-        });
+            const buildContext = new BuildContext(buildDirectory);
+            if (!(await buildContext.validate())) {
+                this.prompts.srcDirectoryEmpty(buildDirectory);
+                return ActionResult.failed();
+            }
+            const portalContext = new PortalContext(portalDirectory);
+            if (!force && (await portalContext.exists()) && !(await this.prompts.overwritePortal(portalDirectory))) {
+                this.prompts.portalDirectoryNotEmpty();
+                return ActionResult.cancelled();
+            }
+            return await withDirPath(async (tempDirectory) => {
+                const tempContext = new TempContext(tempDirectory);
+                const buildZipPath = await tempContext.zip(buildDirectory);
+                const response = await this.prompts.generatePortal(this.portalService.generatePortal(buildZipPath, this.configDir, this.commandMetadata, this.authKey));
+                if (response.isErr()) {
+                    const error = response.error;
+                    if (error instanceof ServiceError) {
+                        this.prompts.portalGenerationServiceError(error);
+                    }
+                    else if (typeof error === "string") {
+                        this.prompts.portalGenerationError(error);
+                    }
+                    else {
+                        const errorZipPath = await tempContext.save(error);
+                        const reportPath = await portalContext.saveError(errorZipPath);
+                        await this.launcherService.openFile(reportPath);
+                        this.prompts.portalGenerationErrorWithReport(reportPath);
+                    }
+                    return ActionResult.failed();
+                }
+                const tempPortalZipPath = await tempContext.save(response.value);
+                await portalContext.save(tempPortalZipPath, zipPortal);
+                if (displayMessages) {
+                    this.prompts.portalGenerated(portalDirectory);
+                }
+                return ActionResult.success();
+            });
+        };
+        this.configDir = configDir;
+        this.commandMetadata = commandMetadata;
+        this.authKey = authKey;
     }
 }
-exports.PortalGenerateAction = PortalGenerateAction;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2VuZXJhdGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYWN0aW9ucy9wb3J0YWwvZ2VuZXJhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsNkJBQTZCO0FBQzdCLCtCQUErQjtBQUMvQixpRkFBNkU7QUFFN0Usc0RBQW1EO0FBQ25ELDZDQU0yQjtBQUMzQiw0REFBc0U7QUFFdEUsTUFBYSxvQkFBb0I7SUFHL0I7UUFDRSxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksZ0NBQXFCLEVBQUUsQ0FBQztJQUM3QyxDQUFDO0lBRUQsS0FBSyxDQUFDLGNBQWMsQ0FBQyxLQUFrQixFQUFFLEtBQW9CLEVBQUUsU0FBaUI7O1FBQzlFLElBQUksQ0FBQyxPQUFPLENBQUMsOEJBQThCLEVBQUUsQ0FBQztRQUM5QyxNQUFNLGFBQWEsR0FBRyxJQUFBLDhCQUFzQixFQUFDLEtBQUssQ0FBQyxnQkFBZ0IsRUFBRSxLQUFLLENBQUMsa0NBQWtDLENBQUMsQ0FBQztRQUUvRywwREFBMEQ7UUFDMUQsTUFBTSwyQkFBMkIsR0FBRyxNQUFNLElBQUEsa0NBQTBCLEVBQ2xFLEtBQUssQ0FBQyxnQkFBZ0IsRUFDdEIsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsZ0JBQWdCLEVBQUUsb0JBQW9CLENBQUMsRUFDdkQsYUFBYSxDQUNkLENBQUM7UUFFRixNQUFNLG9CQUFvQixHQUF5QjtZQUNqRCwyQkFBMkIsRUFBRSwyQkFBMkI7WUFDeEQsa0NBQWtDLEVBQUUsS0FBSyxDQUFDLGtDQUFrQztZQUM1RSxtQ0FBbUMsRUFBRSxLQUFLLENBQUMsbUNBQW1DO1lBQzlFLGVBQWUsRUFBRSxNQUFBLEtBQUssQ0FBQyxVQUFVLENBQUMsbUNBQUksSUFBSTtZQUMxQyxlQUFlLEVBQUUsS0FBSyxDQUFDLEdBQUc7U0FDM0IsQ0FBQztRQUVGLE1BQU0saUJBQWlCLEdBQUcsSUFBSSw4QkFBYSxFQUFFLENBQUM7UUFDOUMsTUFBTSxzQkFBc0IsR0FBRyxNQUFNLGlCQUFpQixDQUFDLG9CQUFvQixDQUFDLG9CQUFvQixFQUFFLFNBQVMsQ0FBQyxDQUFDO1FBQzdHLE1BQU0sSUFBQSxrQkFBVSxFQUFDLDJCQUEyQixDQUFDLENBQUM7UUFFOUMsSUFBSSxzQkFBc0IsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDO1lBQ3ZDLE1BQU0sSUFBSSxDQUFDLGtDQUFrQyxDQUMzQyxzQkFBc0IsQ0FBQyxLQUFNLEVBQzdCLEtBQUssQ0FBQyxtQ0FBbUMsQ0FDMUMsQ0FBQztZQUVGLElBQUksS0FBSyxDQUFDLEdBQUcsRUFBRSxDQUFDO2dCQUNkLElBQUksQ0FBQyxPQUFPLENBQUMscUNBQXFDLEVBQUUsQ0FBQztnQkFDckQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsQ0FBQyxLQUFLLENBQUMsbUNBQW1DLENBQUMsQ0FBQztnQkFDNUUsT0FBTztZQUNULENBQUM7WUFFRCxNQUFNLElBQUEsc0JBQWMsRUFBQyxLQUFLLENBQUMsbUNBQW1DLEVBQUUsS0FBSyxDQUFDLGtDQUFrQyxDQUFDLENBQUM7WUFDMUcsTUFBTSxJQUFBLGtCQUFVLEVBQUMsS0FBSyxDQUFDLG1DQUFtQyxDQUFDLENBQUM7WUFFNUQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxxQ0FBcUMsRUFBRSxDQUFDO1lBQ3JELElBQUksQ0FBQyxPQUFPLENBQUMsbUJBQW1CLENBQUMsS0FBSyxDQUFDLGtDQUFrQyxDQUFDLENBQUM7UUFDN0UsQ0FBQzthQUFNLENBQUM7WUFDTixJQUFJLENBQUMsT0FBTyxDQUFDLG1DQUFtQyxFQUFFLENBQUM7WUFDbkQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQ25CLElBQUEsNEJBQW9CLEVBQUMsR0FBRyxzQkFBc0IsQ0FBQyxLQUFNLEVBQUUsQ0FBQyxDQUN6RCxDQUFDO1FBQ0osQ0FBQztJQUNILENBQUM7SUFFTyxLQUFLLENBQUMsa0NBQWtDLENBQzlDLElBQTJCLEVBQzNCLG1DQUEyQztRQUUzQyxNQUFNLFdBQVcsR0FBRyxFQUFFLENBQUMsaUJBQWlCLENBQUMsbUNBQW1DLENBQUMsQ0FBQztRQUM5RSxNQUFNLElBQUksT0FBTyxDQUFPLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQzFDLElBQUk7aUJBQ0QsSUFBSSxDQUFDLFdBQVcsQ0FBQztpQkFDakIsRUFBRSxDQUFDLFFBQVEsRUFBRSxHQUFHLEVBQUUsQ0FBQyxPQUFPLEVBQUUsQ0FBQztpQkFDN0IsRUFBRSxDQUFDLE9BQU8sRUFBRSxDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLGVBQU0sQ0FBQyxPQUFPLENBQUMsNkNBQTZDLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUNsSCxDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7Q0FDRjtBQW5FRCxvREFtRUMifQ==
+//# sourceMappingURL=generate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/actions/portal/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,MAAM,OAAO,cAAc;IAQzB,YAAY,SAAwB,EAAE,eAAgC,EAAE,UAAyB,IAAI;QAPpF,YAAO,GAA0B,IAAI,qBAAqB,EAAE,CAAC;QAC7D,oBAAe,GAAoB,IAAI,eAAe,EAAE,CAAC;QACzD,kBAAa,GAAkB,IAAI,aAAa,EAAE,CAAC;QAWpD,YAAO,GAAG,KAAK,EAC7B,cAA6B,EAC7B,eAA8B,EAC9B,KAAc,EACd,SAAkB,EAClB,kBAA2B,IAAI,EACR,EAAE;YACzB,IAAI,cAAc,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;gBACpD,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;YAC/B,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;gBAC/C,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;YAC/B,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;gBACvG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;gBACvC,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;YAClC,CAAC;YAED,OAAO,MAAM,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE;gBAC/C,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;gBACnD,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAE3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAChD,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,CACpG,CAAC;gBAEF,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;oBACrB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;oBAC7B,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;wBAClC,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;oBACnD,CAAC;yBACI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBACnC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;oBAC5C,CAAC;yBAAM,CAAC;wBACN,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACnD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;wBAC/D,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;wBAChD,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC;oBAC3D,CAAC;oBACD,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC/B,CAAC;gBAED,MAAM,iBAAiB,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACjE,MAAM,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;gBAEvD,IAAI,eAAe,EAAE,CAAC;oBACpB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;gBAChD,CAAC;gBAED,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QA9DA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CA4DF"}

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

@@ -0,0 +1,17 @@
+import { DirectoryPath } from '../../types/file/directoryPath.js';
+import { ActionResult } from '../action-result.js';
+import { CommandMetadata } from '../../types/common/command-metadata.js';
+export declare class PortalQuickstartAction {
+    private readonly prompts;
+    private readonly zipService;
+    private readonly fileService;
+    private readonly configDir;
+    private readonly commandMetadata;
+    private readonly fileDownloadService;
+    private readonly buildFileUrl;
+    private readonly defaultSpecUrl;
+    private readonly repositoryFolderName;
+    private readonly validationService;
+    constructor(configDir: DirectoryPath, commandMetadata: CommandMetadata);
+    readonly execute: () => Promise<ActionResult>;
+}

package/lib/actions/portal/quickstart.js

@@ -0,0 +1,169 @@
+import { getAuthInfo } from '../../client-utils/auth-manager.js';
+import { FileService } from '../../infrastructure/file-service.js';
+import { withDirPath } from '../../infrastructure/tmp-extensions.js';
+import { ZipService } from '../../infrastructure/zip-service.js';
+import { PortalQuickstartPrompts } from '../../prompts/portal/quickstart.js';
+import { UrlPath } from '../../types/file/urlPath.js';
+import { LoginAction } from '../auth/login.js';
+import { ActionResult } from '../action-result.js';
+import { PortalServeAction } from './serve.js';
+import { ValidateAction } from '../api/validate.js';
+import { BuildContext } from '../../types/build-context.js';
+import { TempContext } from '../../types/temp-context.js';
+import { FileDownloadService } from '../../infrastructure/services/file-download-service.js';
+import { getLanguagesConfig } from '../../types/build/build.js';
+import { SpecContext } from '../../types/spec-context.js';
+import { ValidationService } from '../../infrastructure/services/validation-service.js';
+import { FileName } from '../../types/file/fileName.js';
+const defaultPort = 3000;
+export class PortalQuickstartAction {
+    constructor(configDir, commandMetadata) {
+        this.prompts = new PortalQuickstartPrompts();
+        this.zipService = new ZipService();
+        this.fileService = new FileService();
+        this.fileDownloadService = new FileDownloadService();
+        this.buildFileUrl = new UrlPath(`https://github.com/apimatic/sample-docs-as-code-portal/archive/refs/heads/master.zip`);
+        this.defaultSpecUrl = new UrlPath(`https://raw.githubusercontent.com/apimatic/sample-docs-as-code-portal/refs/heads/master/src/spec/openapi.json`);
+        this.repositoryFolderName = 'sample-docs-as-code-portal-master/src';
+        this.execute = async () => {
+            const storedAuth = await getAuthInfo(this.configDir.toString());
+            if (!(storedAuth === null || storedAuth === void 0 ? void 0 : storedAuth.authKey)) {
+                const loginResult = await new LoginAction(this.configDir, this.commandMetadata).execute();
+                if (loginResult.isFailed()) {
+                    return ActionResult.failed();
+                }
+            }
+            return await withDirPath(async (tempDirectory) => {
+                var _a;
+                // Step 1/4
+                this.prompts.importSpecStep();
+                let specPath;
+                while (!specPath) {
+                    const inputPath = await this.prompts.specPathPrompt(this.defaultSpecUrl);
+                    if (!inputPath) {
+                        this.prompts.noSpecSpecified();
+                        return ActionResult.cancelled();
+                    }
+                    if (inputPath instanceof UrlPath) {
+                        const downloadFileResult = await this.prompts.downloadSpecFile(this.fileDownloadService.downloadFile(inputPath));
+                        if (downloadFileResult.isErr()) {
+                            this.prompts.serviceError(downloadFileResult.error);
+                        }
+                        else {
+                            const specContext = new SpecContext(tempDirectory);
+                            specPath = await specContext.save(downloadFileResult.value.stream, downloadFileResult.value.filename);
+                        }
+                    }
+                    else {
+                        const fileExists = await this.fileService.fileExists(inputPath);
+                        if (!fileExists) {
+                            this.prompts.specFileDoesNotExist();
+                        }
+                        else {
+                            specPath = inputPath;
+                        }
+                    }
+                }
+                // Step 2/4
+                this.prompts.validateSpecStep();
+                const validateAction = new ValidateAction(this.configDir, this.commandMetadata);
+                const validationResult = await validateAction.execute(specPath, false);
+                if (validationResult.isFailed()) {
+                    this.prompts.specValidationFailed();
+                    if (!(await this.prompts.useDefaultSpecPrompt())) {
+                        this.prompts.fixYourSpec();
+                        return ActionResult.cancelled();
+                    }
+                    const downloadFileResult = await this.prompts.downloadSpecFile(this.fileDownloadService.downloadFile(this.defaultSpecUrl));
+                    if (downloadFileResult.isErr()) {
+                        this.prompts.serviceError(downloadFileResult.error);
+                    }
+                    else {
+                        const specContext = new SpecContext(tempDirectory);
+                        specPath = await specContext.save(downloadFileResult.value.stream, downloadFileResult.value.filename);
+                    }
+                }
+                if (validationResult.isSuccess()) {
+                    const unallowed = validationResult.getValue();
+                    if (unallowed && (((_a = unallowed.Features) === null || _a === void 0 ? void 0 : _a.length) > 0 || unallowed.EndpointCount > unallowed.EndpointLimit)) {
+                        const config = {
+                            features: unallowed.Features.filter((name) => !!name),
+                            endpointsToKeep: unallowed.EndpointLimit
+                        };
+                        const stripUnallowedFeaturesResult = await this.validationService.stripUnallowedFeatures(specPath, config);
+                        if (stripUnallowedFeaturesResult.isErr()) {
+                            this.prompts.splitSpecDetected(unallowed);
+                            return ActionResult.failed();
+                        }
+                        else {
+                            this.prompts.stripUnallowedFeaturesStep(unallowed);
+                            const specContext = new SpecContext(tempDirectory);
+                            specPath = await specContext.save(stripUnallowedFeaturesResult.value, new FileName('pruned-spec.zip'));
+                        }
+                    }
+                }
+                // Step 3/4
+                this.prompts.selectLanguagesStep();
+                const languages = await this.prompts.selectLanguagesPrompt();
+                if (!languages) {
+                    this.prompts.noLanguagesSelected();
+                    return ActionResult.cancelled();
+                }
+                // Step 4/4
+                this.prompts.selectInputDirectoryStep();
+                let inputDirectory;
+                while (true) {
+                    inputDirectory = await this.prompts.inputDirectoryPathPrompt();
+                    if (!inputDirectory) {
+                        this.prompts.noInputDirectoryProvided();
+                        return ActionResult.cancelled();
+                    }
+                    if (!(await this.fileService.directoryExists(inputDirectory))) {
+                        this.prompts.inputDirectoryPathDoesNotExist(inputDirectory);
+                        // TODO: Prompt user if he wants to create the directory
+                        continue;
+                    }
+                    if (!(await this.fileService.directoryEmpty(inputDirectory))) {
+                        this.prompts.inputDirectoryNotEmpty(inputDirectory);
+                        continue;
+                    }
+                    break;
+                }
+                const masterBuildFile = await this.prompts.downloadBuildDirectory(this.fileDownloadService.downloadFile(this.buildFileUrl));
+                if (masterBuildFile.isErr()) {
+                    this.prompts.serviceError(masterBuildFile.error);
+                    return ActionResult.failed();
+                }
+                const tempContext = new TempContext(tempDirectory);
+                const masterBuildFilePath = await tempContext.save(masterBuildFile.value.stream);
+                await this.zipService.unArchive(masterBuildFilePath, tempDirectory);
+                const extractedFolder = tempDirectory.join(this.repositoryFolderName);
+                const tempBuildContext = new BuildContext(extractedFolder);
+                await tempBuildContext.deleteWorkflowDir();
+                const buildFile = await tempBuildContext.getBuildFileContents();
+                buildFile.generatePortal.languageConfig = getLanguagesConfig(languages);
+                await tempBuildContext.updateBuildFileContents(buildFile);
+                const sourceDirectory = inputDirectory.join('src');
+                await this.fileService.copyDirectoryContents(extractedFolder, sourceDirectory);
+                const specDirectory = sourceDirectory.join('spec');
+                const specContext = new SpecContext(specDirectory);
+                await specContext.replaceDefaultSpec(specPath);
+                const buildDirectoryStructure = await this.fileService.getDirectory(sourceDirectory);
+                this.prompts.printDirectoryStructure(inputDirectory, buildDirectoryStructure);
+                const portalDirectory = inputDirectory.join('portal');
+                const portalServeAction = new PortalServeAction(this.configDir, this.commandMetadata, null);
+                const result = await portalServeAction.execute(sourceDirectory, portalDirectory, defaultPort, true, false, () => {
+                    this.prompts.nextSteps();
+                });
+                if (result.isFailed()) {
+                    return ActionResult.failed();
+                }
+                return ActionResult.success();
+            });
+        };
+        this.configDir = configDir;
+        this.commandMetadata = commandMetadata;
+        this.validationService = new ValidationService(this.configDir);
+    }
+}
+//# sourceMappingURL=quickstart.js.map

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

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

package/lib/actions/portal/recipe/new-recipe.d.ts

@@ -0,0 +1,15 @@
+import { DirectoryPath } from "../../../types/file/directoryPath.js";
+import { CommandMetadata } from "../../../types/common/command-metadata.js";
+import { ActionResult } from "../../action-result.js";
+export declare class PortalRecipeAction {
+    private readonly configDirectory;
+    private readonly commandMetadata;
+    private readonly prompts;
+    private readonly launcherService;
+    private readonly fileService;
+    private readonly portalService;
+    constructor(configDirectory: DirectoryPath, commandMetadata: CommandMetadata);
+    execute(buildDirectory: DirectoryPath, name?: string): Promise<ActionResult>;
+    private promptForContent;
+    private getTocStructure;
+}

package/lib/actions/portal/recipe/new-recipe.js

@@ -0,0 +1,177 @@
+import { PortalRecipePrompts } from "../../../prompts/portal/recipe/new-recipe.js";
+import { StepType } from "../../../types/recipe/recipe.js";
+import { PortalService } from "../../../infrastructure/services/portal-service.js";
+import { getEndpointDescription, getEndpointGroupsFromSdl } from "../../../types/sdl/sdl.js";
+import { ActionResult } from "../../action-result.js";
+import { TocContext } from "../../../types/toc-context.js";
+import { FileName } from "../../../types/file/fileName.js";
+import { PortalRecipe } from "../../../application/portal/recipe/portal-recipe.js";
+import { PortalRecipeGenerator } from "../../../application/portal/recipe/recipe-generator.js";
+import { BuildContext } from "../../../types/build-context.js";
+import { ContentContext } from "../toc/new-toc.js";
+import { SpecContext } from "../../../types/spec-context.js";
+import { LauncherService } from "../../../infrastructure/launcher-service.js";
+import { FileService } from "../../../infrastructure/file-service.js";
+import { FilePath } from "../../../types/file/filePath.js";
+import { withDirPath } from "../../../infrastructure/tmp-extensions.js";
+import { TempContext } from "../../../types/temp-context.js";
+import { RecipeContext } from "../../../types/recipe-context.js";
+export class PortalRecipeAction {
+    constructor(configDirectory, commandMetadata) {
+        this.configDirectory = configDirectory;
+        this.commandMetadata = commandMetadata;
+        this.prompts = new PortalRecipePrompts();
+        this.launcherService = new LauncherService();
+        this.fileService = new FileService();
+        this.portalService = new PortalService();
+    }
+    async execute(buildDirectory, name) {
+        this.prompts.displayWelcomeMessage();
+        const buildContext = new BuildContext(buildDirectory);
+        if (!(await buildContext.validate())) {
+            this.prompts.invalidBuildDirectory(buildDirectory);
+            return ActionResult.failed();
+        }
+        const recipeName = name !== null && name !== void 0 ? name : (await this.prompts.recipeNamePrompt());
+        if (!recipeName) {
+            this.prompts.recipeNameEmpty();
+            return ActionResult.cancelled();
+        }
+        const contentDirectory = buildDirectory.join("content");
+        const contentContext = new ContentContext(contentDirectory);
+        if (!(await contentContext.exists())) {
+            this.prompts.contentFolderNotFound();
+            return ActionResult.failed();
+        }
+        const specDirectory = buildDirectory.join("spec");
+        const specContext = new SpecContext(specDirectory);
+        if (!(await specContext.validate())) {
+            this.prompts.specFileEmptyInvalid();
+            return ActionResult.failed();
+        }
+        // Setup TOC context
+        const tocContext = new TocContext(contentDirectory);
+        const tocData = await tocContext.parseTocData();
+        // Setup recipe context
+        const recipeContext = new RecipeContext(recipeName);
+        const recipeScriptFileName = recipeContext.getRecipeScriptFileName();
+        const recipeMarkdownFileName = recipeContext.getRecipeMarkdownFileName();
+        // Check if the recipe already exists
+        const recipeAlreadyExists = recipeContext.exists(tocData, recipeName, recipeMarkdownFileName);
+        if (recipeAlreadyExists && !(await this.prompts.overwriteApiRecipeInTocPrompt(recipeName))) {
+            return ActionResult.cancelled();
+        }
+        // Build the recipe
+        const recipe = new PortalRecipe(recipeName);
+        let stepIndex = 0;
+        this.prompts.displayStepsInformation();
+        let endpointGroups;
+        do {
+            const stepType = await this.prompts.stepTypeSelectionPrompt();
+            if (!stepType)
+                return ActionResult.cancelled();
+            const stepName = await this.prompts.stepNamePrompt(`Step ${++stepIndex}`);
+            if (!stepName)
+                return ActionResult.cancelled();
+            switch (stepType) {
+                case StepType.Content: {
+                    const contentResult = await this.promptForContent();
+                    recipe.addContentStep(stepName, contentResult);
+                    this.prompts.displayStepAddedSuccessfullyMessage();
+                    break;
+                }
+                case StepType.Endpoint: {
+                    if (!endpointGroups) {
+                        const sdlResult = await withDirPath(async (tempDirectory) => {
+                            const tempContext = new TempContext(tempDirectory);
+                            const specZipPath = await tempContext.zip(specDirectory);
+                            const specFileStream = await this.fileService.getStream(specZipPath);
+                            try {
+                                return await this.prompts.generateSdl(this.portalService.generateSdl(specFileStream, this.configDirectory, this.commandMetadata));
+                            }
+                            finally {
+                                specFileStream.close();
+                            }
+                        });
+                        if (sdlResult.isErr()) {
+                            this.prompts.serviceError(sdlResult.error);
+                            return ActionResult.failed();
+                        }
+                        endpointGroups = getEndpointGroupsFromSdl(sdlResult.value);
+                    }
+                    const endpointGroupName = await this.prompts.endpointGroupNamePrompt(endpointGroups);
+                    if (!endpointGroupName)
+                        return ActionResult.cancelled();
+                    const endpointName = await this.prompts.endpointNamePrompt(endpointGroups, endpointGroupName);
+                    if (!endpointName)
+                        return ActionResult.cancelled();
+                    const defaultDescription = getEndpointDescription(endpointGroups, endpointGroupName, endpointName);
+                    const description = await this.prompts.endpointDescriptionPrompt(defaultDescription);
+                    if (!description)
+                        return ActionResult.cancelled();
+                    recipe.addEndpointStep(stepName, description, endpointGroupName, endpointName);
+                    this.prompts.displayStepAddedSuccessfullyMessage();
+                    break;
+                }
+            }
+        } while (await this.prompts.addAnotherStepSelectionPrompt());
+        const serializableRecipe = recipe.toSerializableRecipe();
+        // Generate the recipe
+        const recipeGenerator = new PortalRecipeGenerator();
+        await recipeGenerator.createRecipe(serializableRecipe, tocData, tocContext.tocPath, recipeName, recipeScriptFileName, recipeMarkdownFileName, buildContext, buildDirectory);
+        const tocStructure = this.getTocStructure(recipeScriptFileName);
+        this.prompts.recipeCreated();
+        this.prompts.displayRecipeStructure(tocStructure);
+        this.prompts.nextSteps();
+        return ActionResult.success();
+    }
+    async promptForContent() {
+        return await withDirPath(async (tempDir) => {
+            const tempFile = new FilePath(tempDir, new FileName(`recipe-markdown-content.md`));
+            const defaultContent = "# The Heading Goes Here\n\n" +
+                "This is placeholder text for your API Recipe content step. " +
+                "Feel free to edit this. Save your changes and then close the file once you're done.";
+            await this.fileService.writeContents(tempFile, defaultContent);
+            this.prompts.openRecipeMarkdownEditor();
+            await this.launcherService.openInEditor(tempFile);
+            const fileContent = await this.fileService.getContents(tempFile);
+            return fileContent.replace(/\r\n|\r/g, "\n");
+        });
+    }
+    getTocStructure(recipeFileName) {
+        return {
+            name: "src",
+            items: [
+                {
+                    name: "content",
+                    items: [
+                        {
+                            name: "toc.yml",
+                            description: "# Contains the API Recipes group with a new page for your API recipe"
+                        }
+                    ]
+                },
+                {
+                    name: "static",
+                    items: [
+                        {
+                            name: "scripts",
+                            items: [
+                                {
+                                    name: "recipes",
+                                    items: [
+                                        {
+                                            name: `${recipeFileName}`,
+                                            description: "# Generated recipe script file containing all of the steps"
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=new-recipe.js.map

package/lib/actions/portal/recipe/new-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-recipe.js","sourceRoot":"","sources":["../../../../src/actions/portal/recipe/new-recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAe,MAAM,2BAA2B,CAAC;AAG1G,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE,MAAM,OAAO,kBAAkB;IAM7B,YAA6B,eAA8B,EAAmB,eAAgC;QAAjF,oBAAe,GAAf,eAAe,CAAe;QAAmB,oBAAe,GAAf,eAAe,CAAiB;QAL7F,YAAO,GAAwB,IAAI,mBAAmB,EAAE,CAAC;QACzD,oBAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,gBAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,kBAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAE4D,CAAC;IAE3G,KAAK,CAAC,OAAO,CAAC,cAA6B,EAAE,IAAa;QAC/D,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAErC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;YACnD,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAE5D,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;YACrC,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;QAEnD,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;YACpC,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QAED,oBAAoB;QACpB,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC;QAEhD,uBAAuB;QACvB,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,oBAAoB,GAAG,aAAa,CAAC,uBAAuB,EAAE,CAAC;QACrE,MAAM,sBAAsB,GAAG,aAAa,CAAC,yBAAyB,EAAE,CAAC;QAEzE,qCAAqC;QACrC,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,sBAAsB,CAAC,CAAC;QAC9F,IAAI,mBAAmB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC3F,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;QAClC,CAAC;QAED,mBAAmB;QACnB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,SAAS,GAAW,CAAC,CAAC;QAE1B,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;QAEvC,IAAI,cAAsD,CAAC;QAE3D,GAAG,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;YAC9D,IAAI,CAAC,QAAQ;gBAAE,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;YAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAC1E,IAAI,CAAC,QAAQ;gBAAE,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;YAE/C,QAAQ,QAAQ,EAAE,CAAC;gBACjB,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;oBACtB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACpD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;oBAC/C,IAAI,CAAC,OAAO,CAAC,mCAAmC,EAAE,CAAC;oBACnD,MAAM;gBACR,CAAC;gBAED,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACvB,IAAI,CAAC,cAAc,EAAE,CAAC;wBACpB,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE;4BAC1D,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;4BACnD,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;4BAEzD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;4BAErE,IAAI,CAAC;gCACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CACnC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAC3F,CAAC;4BACJ,CAAC;oCAAS,CAAC;gCACT,cAAc,CAAC,KAAK,EAAE,CAAC;4BACzB,CAAC;wBACH,CAAC,CAAC,CAAC;wBAEH,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;4BACtB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;4BAC3C,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;wBAC/B,CAAC;wBACD,cAAc,GAAG,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBAC7D,CAAC;oBAED,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;oBACrF,IAAI,CAAC,iBAAiB;wBAAE,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;oBACxD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;oBAC9F,IAAI,CAAC,YAAY;wBAAE,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;oBAEnD,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,cAAc,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC;oBACnG,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;oBACrF,IAAI,CAAC,WAAW;wBAAE,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;oBAElD,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC;oBAC/E,IAAI,CAAC,OAAO,CAAC,mCAAmC,EAAE,CAAC;oBACnD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC,QAAQ,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE;QAE7D,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAEzD,sBAAsB;QACtB,MAAM,eAAe,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACpD,MAAM,eAAe,CAAC,YAAY,CAChC,kBAAkB,EAClB,OAAO,EACP,UAAU,CAAC,OAAO,EAClB,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,cAAc,CACf,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC5B,OAAO,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACzC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACnF,MAAM,cAAc,GAClB,6BAA6B;gBAC7B,6DAA6D;gBAC7D,qFAAqF,CAAC;YAExF,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC/D,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,cAAwB;QAC9C,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,WAAW,EAAE,sEAAsE;yBACpF;qBACF;iBACF;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE;gCACL;oCACE,IAAI,EAAE,SAAS;oCACf,KAAK,EAAE;wCACL;4CACE,IAAI,EAAE,GAAG,cAAc,EAAE;4CACzB,WAAW,EAAE,4DAA4D;yCAC1E;qCACF;iCACF;6BACF;yBACF;qBACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { ActionResult } from "../action-result.js";
+import { CommandMetadata } from "../../types/common/command-metadata.js";
+export declare class PortalServeAction {
+    private readonly prompts;
+    private readonly networkService;
+    private readonly launcherService;
+    private readonly application;
+    private readonly configDir;
+    private readonly commandMetadata;
+    private readonly authKey;
+    constructor(configDir: DirectoryPath, commandMetadata: CommandMetadata, authKey?: string | null);
+    execute(buildDirectory: DirectoryPath, portalDirectory: DirectoryPath, port: number, openInBrowser: boolean, hotReload: boolean, onAfterServe?: () => void): Promise<ActionResult>;
+    private clearStandardInput;
+}