@apimatic/cli 1.1.0-alpha.8 → 1.1.0-beta.1

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

@@ -0,0 +1,97 @@
+import { ok } from "neverthrow";
+import { PortalNewTocPrompts } from "../../../prompts/portal/toc/new-toc.js";
+import { TocStructureGenerator } from "../../../application/portal/toc/toc-structure-generator.js";
+import { ActionResult } from "../../action-result.js";
+import { TocContext } from "../../../types/toc-context.js";
+import { FileService } from "../../../infrastructure/file-service.js";
+import { BuildContext } from "../../../types/build-context.js";
+import { getEndpointGroupsAndModels } from "../../../types/sdl/sdl.js";
+import { withDirPath } from "../../../infrastructure/tmp-extensions.js";
+import { TempContext } from "../../../types/temp-context.js";
+import { PortalService } from "../../../infrastructure/services/portal-service.js";
+export class ContentContext {
+    constructor(contentDirectory) {
+        this.contentDirectory = contentDirectory;
+        this.fileService = new FileService();
+    }
+    async exists() {
+        return this.fileService.directoryExists(this.contentDirectory);
+    }
+    async extractContentGroups() {
+        const directory = await this.fileService.getDirectory(this.contentDirectory);
+        return await directory.parseContentFolder(this.contentDirectory);
+    }
+}
+export class PortalNewTocAction {
+    constructor(configDirectory, commandMetadata) {
+        this.configDirectory = configDirectory;
+        this.commandMetadata = commandMetadata;
+        this.prompts = new PortalNewTocPrompts();
+        this.tocGenerator = new TocStructureGenerator();
+        this.fileService = new FileService();
+        this.portalService = new PortalService();
+    }
+    async execute(buildDirectory, tocDirectory, force = false, expandEndpoints = false, expandModels = false) {
+        var _a, _b;
+        // Validate build directory
+        const buildContext = new BuildContext(buildDirectory);
+        if (!(await buildContext.validate())) {
+            this.prompts.invalidBuildDirectory(buildDirectory);
+            return ActionResult.failed();
+        }
+        const buildConfig = await buildContext.getBuildFileContents();
+        const contentDirectory = buildDirectory.join((_b = (_a = buildConfig.generatePortal) === null || _a === void 0 ? void 0 : _a.contentFolder) !== null && _b !== void 0 ? _b : "content");
+        const tocDir = tocDirectory !== null && tocDirectory !== void 0 ? tocDirectory : contentDirectory;
+        const tocContext = new TocContext(tocDir);
+        if (!force && (await tocContext.exists()) && !(await this.prompts.overwriteToc(tocContext.tocPath))) {
+            this.prompts.tocFileAlreadyExists();
+            return ActionResult.cancelled();
+        }
+        let sdlComponents = { endpointGroups: new Map(), models: [] };
+        if (expandEndpoints || expandModels) {
+            const specDirectory = buildDirectory.join("spec");
+            if (!(await this.fileService.directoryExists(specDirectory))) {
+                this.prompts.fallingBackToDefault();
+            }
+            else {
+                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 {
+                        const result = await this.prompts.extractEndpointGroupsAndModels(this.portalService.generateSdl(specFileStream, this.configDirectory, this.commandMetadata));
+                        if (result.isErr()) {
+                            this.prompts.fallingBackToDefault();
+                            return ok({ endpointGroups: new Map(), models: [] });
+                        }
+                        return ok(getEndpointGroupsAndModels(result.value));
+                    }
+                    finally {
+                        specFileStream.close();
+                    }
+                });
+                if (sdlResult.isErr()) {
+                    this.prompts.logError(sdlResult.error);
+                    return ActionResult.failed();
+                }
+                sdlComponents = sdlResult.value;
+            }
+        }
+        const contentContext = new ContentContext(contentDirectory);
+        const contentExists = await contentContext.exists();
+        let contentGroups;
+        if (!contentExists) {
+            this.prompts.contentDirectoryNotFound(contentDirectory);
+            contentGroups = [];
+        }
+        else {
+            contentGroups = await contentContext.extractContentGroups();
+        }
+        const toc = this.tocGenerator.createTocStructure(sdlComponents.endpointGroups, sdlComponents.models, expandEndpoints, expandModels, contentGroups);
+        const yamlString = this.tocGenerator.transformToYaml(toc);
+        const tocFilePath = await tocContext.save(yamlString);
+        this.prompts.tocCreated(tocFilePath);
+        return ActionResult.success();
+    }
+}
+//# sourceMappingURL=new-toc.js.map

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

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

package/lib/actions/quickstart.d.ts

@@ -0,0 +1,10 @@
+import { CommandMetadata } from "../types/common/command-metadata.js";
+import { DirectoryPath } from "../types/file/directoryPath.js";
+import { ActionResult } from "./action-result.js";
+export declare class QuickstartAction {
+    private readonly configDir;
+    private readonly commandMetadata;
+    private readonly prompts;
+    constructor(configDir: DirectoryPath, commandMetadata: CommandMetadata);
+    readonly execute: () => Promise<ActionResult>;
+}

package/lib/actions/quickstart.js

@@ -0,0 +1,30 @@
+import { QuickstartPrompts } from "../prompts/quickstart.js";
+import { ActionResult } from "./action-result.js";
+import { PortalQuickstartAction } from "./portal/quickstart.js";
+import { SdkQuickstartAction } from "./sdk/quickstart.js";
+export class QuickstartAction {
+    constructor(configDir, commandMetadata) {
+        this.configDir = configDir;
+        this.commandMetadata = commandMetadata;
+        this.prompts = new QuickstartPrompts();
+        this.execute = async () => {
+            this.prompts.welcomeMessage();
+            const selectedFlow = await this.prompts.selectQuickstartFlow();
+            switch (selectedFlow) {
+                case "portal": {
+                    const action = new PortalQuickstartAction(this.configDir, this.commandMetadata);
+                    return await action.execute();
+                }
+                case "sdk": {
+                    const action = new SdkQuickstartAction(this.configDir, this.commandMetadata);
+                    return await action.execute();
+                }
+                case undefined: {
+                    this.prompts.noQuickstartFlowSelected();
+                    return ActionResult.cancelled();
+                }
+            }
+        };
+    }
+}
+//# sourceMappingURL=quickstart.js.map

package/lib/actions/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../../src/actions/quickstart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,OAAO,gBAAgB;IAG3B,YAAoC,SAAwB,EAAmB,eAAgC;QAA3E,cAAS,GAAT,SAAS,CAAe;QAAmB,oBAAe,GAAf,eAAe,CAAiB;QAF9F,YAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAInC,YAAO,GAAG,KAAK,IAA2B,EAAE;YAC1D,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAC/D,QAAQ,YAAY,EAAE,CAAC;gBACrB,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,MAAM,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;oBAChF,OAAO,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBAChC,CAAC;gBACD,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;oBAC7E,OAAO,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBAChC,CAAC;gBACD,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC;oBACxC,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IAnBgH,CAAC;CAoBpH"}

package/lib/actions/sdk/generate.d.ts

@@ -0,0 +1,13 @@
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { ActionResult } from "../action-result.js";
+import { CommandMetadata } from "../../types/common/command-metadata.js";
+import { Language } from "../../types/sdk/generate.js";
+export declare class GenerateAction {
+    private readonly prompts;
+    private readonly portalService;
+    private readonly configDir;
+    private readonly commandMetadata;
+    private readonly authKey;
+    constructor(configDir: DirectoryPath, commandMetadata: CommandMetadata, authKey?: string | null);
+    readonly execute: (specDirectory: DirectoryPath, sdkDirectory: DirectoryPath, language: Language, force: boolean, zipSdk: boolean) => Promise<ActionResult>;
+}

package/lib/actions/sdk/generate.js

@@ -0,0 +1,47 @@
+import { PortalService } from "../../infrastructure/services/portal-service.js";
+import { ActionResult } from "../action-result.js";
+import { withDirPath } from "../../infrastructure/tmp-extensions.js";
+import { SdkContext } from "../../types/sdk-context.js";
+import { SpecContext } from "../../types/spec-context.js";
+import { SdkGeneratePrompts } from "../../prompts/sdk/generate.js";
+import { TempContext } from "../../types/temp-context.js";
+export class GenerateAction {
+    constructor(configDir, commandMetadata, authKey = null) {
+        this.prompts = new SdkGeneratePrompts();
+        this.portalService = new PortalService();
+        this.execute = async (specDirectory, sdkDirectory, language, force, zipSdk) => {
+            if (specDirectory.isEqual(sdkDirectory)) {
+                this.prompts.sameSpecAndSdkDir(specDirectory);
+                return ActionResult.failed();
+            }
+            const specContext = new SpecContext(specDirectory);
+            if (!(await specContext.validate())) {
+                this.prompts.invalidSpecDirectory(specDirectory);
+                return ActionResult.failed();
+            }
+            const sdkContext = new SdkContext(sdkDirectory, language);
+            if (!force && (await sdkContext.exists()) && !(await this.prompts.overwriteSdk(sdkContext.sdkLanguageDirectory))) {
+                this.prompts.destinationDirNotEmpty();
+                return ActionResult.cancelled();
+            }
+            return await withDirPath(async (tempDirectory) => {
+                const tempContext = new TempContext(tempDirectory);
+                const specZipPath = await tempContext.zip(specDirectory);
+                const response = await this.prompts.generateSDK(this.portalService.generateSdk(specZipPath, language, this.configDir, this.commandMetadata, this.authKey));
+                // TODO: this should be service error
+                if (response.isErr()) {
+                    this.prompts.logGenerationError(response.error);
+                    return ActionResult.failed();
+                }
+                const tempSdkFilePath = await tempContext.save(response.value);
+                const sdkLanguageDirectory = await sdkContext.save(tempSdkFilePath, zipSdk);
+                this.prompts.sdkGenerated(sdkLanguageDirectory);
+                return ActionResult.success();
+            });
+        };
+        this.configDir = configDir;
+        this.commandMetadata = commandMetadata;
+        this.authKey = authKey;
+    }
+}
+//# sourceMappingURL=generate.js.map

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

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

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

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

package/lib/actions/sdk/quickstart.js

@@ -0,0 +1,149 @@
+import { SdkQuickstartPrompts } from "../../prompts/sdk/quickstart.js";
+import { ActionResult } from "../action-result.js";
+import { UrlPath } from "../../types/file/urlPath.js";
+import { LoginAction } from "../auth/login.js";
+import { getAuthInfo } from "../../client-utils/auth-manager.js";
+import { withDirPath } from "../../infrastructure/tmp-extensions.js";
+import { FilePath } from "../../types/file/filePath.js";
+import { SpecContext } from "../../types/spec-context.js";
+import { ValidateAction } from "../api/validate.js";
+import { FileDownloadService } from "../../infrastructure/services/file-download-service.js";
+import { FileService } from "../../infrastructure/file-service.js";
+import { GenerateAction } from "./generate.js";
+import { LauncherService } from "../../infrastructure/launcher-service.js";
+import { ZipService } from "../../infrastructure/zip-service.js";
+import { FileName } from "../../types/file/fileName.js";
+const defaultSpecUrl = new UrlPath(`https://raw.githubusercontent.com/apimatic/sample-docs-as-code-portal/refs/heads/master/src/spec/openapi.json`);
+const metadataFileUrl = new UrlPath(`https://raw.githubusercontent.com/apimatic/sample-docs-as-code-portal/refs/heads/master/src/spec/APIMATIC-META.json`);
+export class SdkQuickstartAction {
+    constructor(configDir, commandMetadata) {
+        this.configDir = configDir;
+        this.commandMetadata = commandMetadata;
+        this.prompts = new SdkQuickstartPrompts();
+        this.fileDownloadService = new FileDownloadService();
+        this.fileService = new FileService();
+        this.launcherService = new LauncherService();
+        this.zipService = new ZipService();
+        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) => {
+                // Step 1/4
+                this.prompts.importSpecStep();
+                let specPath;
+                while (!specPath) {
+                    const inputPath = await this.prompts.specPathPrompt(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(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);
+                    }
+                }
+                // Step 3/4
+                this.prompts.selectLanguageStep();
+                const language = await this.prompts.selectLanguagePrompt();
+                if (!language) {
+                    this.prompts.noLanguageSelected();
+                    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;
+                }
+                // Setup source directory with the spec folder
+                const apimaticMetaFile = await this.prompts.downloadMetadataFile(this.fileDownloadService.downloadFile(metadataFileUrl));
+                if (apimaticMetaFile.isErr()) {
+                    this.prompts.serviceError(apimaticMetaFile.error);
+                    return ActionResult.failed();
+                }
+                const tempSpecDirectory = tempDirectory.join("spec");
+                await this.fileService.createDirectoryIfNotExists(tempSpecDirectory);
+                const metadataFilePath = new FilePath(tempSpecDirectory, apimaticMetaFile.value.filename);
+                await this.fileService.writeFile(metadataFilePath, apimaticMetaFile.value.stream);
+                if (await this.fileService.isZipFile(specPath)) {
+                    await this.zipService.unArchive(specPath, tempSpecDirectory);
+                }
+                else {
+                    await this.fileService.copyToDir(specPath, tempSpecDirectory);
+                }
+                const sourceDirectory = inputDirectory.join("src");
+                const specDirectory = sourceDirectory.join("spec");
+                await this.fileService.copyDirectoryContents(tempSpecDirectory, specDirectory);
+                const srcDirectoryStructure = await this.fileService.getDirectory(sourceDirectory);
+                this.prompts.printDirectoryStructure(inputDirectory, srcDirectoryStructure);
+                const sdkDirectory = inputDirectory.join("sdk");
+                const sdkGenerateAction = new GenerateAction(this.configDir, this.commandMetadata);
+                const result = await sdkGenerateAction.execute(specDirectory, sdkDirectory, language, true, false);
+                if (result.isFailed()) {
+                    return ActionResult.failed();
+                }
+                const languageDirectory = sdkDirectory.join(language);
+                const readmeFilePath = new FilePath(languageDirectory, new FileName("README.md"));
+                if (await this.launcherService.openFolderInIde(languageDirectory, readmeFilePath)) {
+                    this.prompts.sdkOpenedInEditor();
+                }
+                this.prompts.nextSteps(language, inputDirectory);
+                return ActionResult.success();
+            });
+        };
+    }
+}
+//# sourceMappingURL=quickstart.js.map

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

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

package/lib/application/portal/recipe/portal-recipe.d.ts

@@ -0,0 +1,8 @@
+import { SerializableRecipe } from "../../../types/recipe/recipe.js";
+export declare class PortalRecipe {
+    private readonly recipe;
+    constructor(name: string);
+    addContentStep(key: string, content: string): void;
+    addEndpointStep(key: string, description: string, endpointGroupName: string, endpointName: string): void;
+    toSerializableRecipe(): SerializableRecipe;
+}

package/lib/application/portal/recipe/portal-recipe.js

@@ -0,0 +1,33 @@
+import { StepType } from "../../../types/recipe/recipe.js";
+export class PortalRecipe {
+    constructor(name) {
+        this.recipe = {
+            name,
+            steps: []
+        };
+    }
+    addContentStep(key, content) {
+        this.recipe.steps.push({
+            key,
+            name: key, //TODO: Check if key is required
+            type: StepType.Content,
+            config: { content }
+        });
+    }
+    addEndpointStep(key, description, endpointGroupName, endpointName) {
+        const endpointPermalink = `$e/${[endpointGroupName, endpointName].map(encodeURIComponent).join("/")}`;
+        this.recipe.steps.push({
+            key,
+            name: key, //TODO: Check if key is required
+            type: StepType.Endpoint,
+            config: {
+                description,
+                endpointPermalink
+            }
+        });
+    }
+    toSerializableRecipe() {
+        return this.recipe;
+    }
+}
+//# sourceMappingURL=portal-recipe.js.map

package/lib/application/portal/recipe/portal-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-recipe.js","sourceRoot":"","sources":["../../../../src/application/portal/recipe/portal-recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE/E,MAAM,OAAO,YAAY;IAGvB,YAAY,IAAY;QACtB,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI;YACJ,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,GAAW,EAAE,OAAe;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACrB,GAAG;YACH,IAAI,EAAE,GAAG,EAAE,gCAAgC;YAC3C,IAAI,EAAE,QAAQ,CAAC,OAAO;YACtB,MAAM,EAAE,EAAE,OAAO,EAAE;SACpB,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,GAAW,EAAE,WAAmB,EAAE,iBAAyB,EAAE,YAAoB;QAC/F,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACrB,GAAG;YACH,IAAI,EAAE,GAAG,EAAE,gCAAgC;YAC3C,IAAI,EAAE,QAAQ,CAAC,QAAQ;YACvB,MAAM,EAAE;gBACN,WAAW;gBACX,iBAAiB;aAClB;SACF,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/lib/application/portal/recipe/recipe-generator.d.ts

@@ -0,0 +1,21 @@
+import { SerializableRecipe } from "../../../types/recipe/recipe.js";
+import { DirectoryPath } from "../../../types/file/directoryPath.js";
+import { Toc } from "../../../types/toc/toc.js";
+import { FilePath } from "../../../types/file/filePath.js";
+import { FileName } from "../../../types/file/fileName.js";
+import { BuildContext } from "../../../types/build-context.js";
+export declare class PortalRecipeGenerator {
+    private readonly fileService;
+    createRecipe(recipe: SerializableRecipe, tocFileContent: Toc, tocFilePath: FilePath, recipeName: string, recipeScriptFileName: FileName, recipeMarkdownFileName: FileName, buildContext: BuildContext, buildDirectory: DirectoryPath): Promise<void>;
+    private addRecipeToToc;
+    private registerRecipeInBuildConfigFile;
+    private createMarkdownFile;
+    private createScriptFromRecipe;
+    private saveGeneratedRecipeScriptToBuildDirectory;
+    private generateVerifyFunction;
+    private addContentStepToScript;
+    private addEndpointStepToScript;
+    private getMarkdownFileContent;
+    private formatScript;
+    private toPascalCase;
+}

package/lib/application/portal/recipe/recipe-generator.js

@@ -0,0 +1,145 @@
+import prettier from "prettier";
+import { stringify } from "yaml";
+import { FileService } from "../../../infrastructure/file-service.js";
+import { FilePath } from "../../../types/file/filePath.js";
+export class PortalRecipeGenerator {
+    constructor() {
+        //TODO: Replace tocFileContent any type with concrete type.
+        this.fileService = new FileService();
+    }
+    async createRecipe(recipe, tocFileContent, tocFilePath, recipeName, recipeScriptFileName, recipeMarkdownFileName, buildContext, buildDirectory) {
+        await this.addRecipeToToc(tocFileContent, tocFilePath, recipeName, recipeMarkdownFileName);
+        await this.registerRecipeInBuildConfigFile(buildContext, recipeName, recipeScriptFileName);
+        await this.createMarkdownFile(recipeMarkdownFileName, buildDirectory.join("content"));
+        const generatedRecipeScript = await this.createScriptFromRecipe(recipe);
+        const generatedRecipeScriptsDirectoryPath = buildDirectory.join("static", "scripts", "recipes");
+        await this.saveGeneratedRecipeScriptToBuildDirectory(generatedRecipeScript, generatedRecipeScriptsDirectoryPath, recipeScriptFileName);
+    }
+    async addRecipeToToc(tocData, tocFilePath, recipeName, recipeMarkdownFileName) {
+        let toc = tocData.toc;
+        let apiRecipesGroup = toc.find((item) => item.group === "API Recipes");
+        if (!apiRecipesGroup) {
+            // If the group doesn't exist, create and insert it after the last group
+            apiRecipesGroup = {
+                group: "API Recipes",
+                items: []
+            };
+            // Insert after the last group section, before generate sections
+            let lastGroupIdx = -1;
+            for (let i = 0; i < toc.length; i++) {
+                if (toc[i].group)
+                    lastGroupIdx = i;
+            }
+            toc.splice(lastGroupIdx + 1, 0, apiRecipesGroup);
+        }
+        // Only add the recipe if it doesn't already exist
+        const existingRecipe = apiRecipesGroup.items.find((item) => item.page === recipeName || item.file === `recipes/${recipeMarkdownFileName}`);
+        if (!existingRecipe) {
+            apiRecipesGroup.items.push({
+                page: recipeName,
+                file: `recipes/${recipeMarkdownFileName}`
+            });
+            await this.fileService.writeContents(tocFilePath, stringify(tocData));
+        }
+    }
+    async registerRecipeInBuildConfigFile(buildContext, recipeName, recipeScriptFileName) {
+        const buildConfig = await buildContext.getBuildFileContents();
+        if (!buildConfig.recipes) {
+            buildConfig.recipes = {};
+        }
+        const recipesConfig = buildConfig.recipes;
+        if (!recipesConfig.workflows) {
+            recipesConfig.workflows = [];
+        }
+        const existingIndex = recipesConfig.workflows.findIndex((workflow) => workflow.permalink === `page:recipes/${this.toPascalCase(recipeName)}`);
+        const newWorkflow = {
+            name: recipeName,
+            permalink: `page:recipes/${this.toPascalCase(recipeName)}`,
+            functionName: this.toPascalCase(recipeName),
+            scriptPath: `./static/scripts/recipes/${recipeScriptFileName}`
+        };
+        if (existingIndex !== -1) {
+            // Replace the existing workflow
+            recipesConfig.workflows[existingIndex] = newWorkflow;
+        }
+        else {
+            // Add as new workflow
+            recipesConfig.workflows.push(newWorkflow);
+        }
+        await buildContext.updateBuildFileContents(buildConfig);
+    }
+    async createMarkdownFile(recipeMarkdownFileName, contentFolder) {
+        const directory = contentFolder.join("recipes");
+        const markdownFileContent = this.getMarkdownFileContent();
+        await this.fileService.createDirectoryIfNotExists(directory);
+        await this.fileService.writeContents(new FilePath(directory, recipeMarkdownFileName), markdownFileContent);
+    }
+    async createScriptFromRecipe(recipe) {
+        let script = `export default function ${this.toPascalCase(recipe.name)}(workflowCtx, portal) {`;
+        script += "return {";
+        recipe.steps.forEach((step, index) => {
+            script += `"${step.key}": {`;
+            script += `name: "${step.name}",`;
+            script += "stepCallback: async () => {";
+            if (step.type === "content") {
+                script += this.addContentStepToScript(step.config);
+            }
+            else if (step.type === "endpoint") {
+                script += this.addEndpointStepToScript(step.config);
+            }
+            script += "},";
+            script += "}";
+            if (index < recipe.steps.length - 1) {
+                script += ",";
+            }
+        });
+        script += "};";
+        script += "}";
+        return script;
+    }
+    async saveGeneratedRecipeScriptToBuildDirectory(generatedRecipeScript, generatedRecipeScriptsDirectoryPath, recipeScriptFileName, format = false) {
+        if (format) {
+            generatedRecipeScript = await this.formatScript(generatedRecipeScript);
+        }
+        await this.fileService.createDirectoryIfNotExists(generatedRecipeScriptsDirectoryPath);
+        await this.fileService.writeContents(new FilePath(generatedRecipeScriptsDirectoryPath, recipeScriptFileName), generatedRecipeScript);
+    }
+    generateVerifyFunction() {
+        return `if (response.StatusCode == 200) { return true; } else { setError("API Call wasn't able to get a valid response. Please try again."); return false; }`;
+    }
+    addContentStepToScript(contentConfig) {
+        return `return workflowCtx.showContent(${JSON.stringify(contentConfig.content)});`;
+    }
+    addEndpointStepToScript(endpointConfig) {
+        let script = "return workflowCtx.showEndpoint({";
+        if (endpointConfig.description !== "") {
+            script += `description: ${JSON.stringify(endpointConfig.description)},`;
+        }
+        script += `endpointPermalink: "${endpointConfig.endpointPermalink}",`;
+        script += "verify: (response, setError) => {";
+        script += this.generateVerifyFunction();
+        script += "},";
+        script += "});";
+        return script;
+    }
+    getMarkdownFileContent() {
+        return `# This is a Guided Walkthrough File
+This is the starter content`;
+    }
+    async formatScript(code) {
+        return prettier.format(code, {
+            parser: "babel",
+            semi: true,
+            singleQuote: false,
+            tabWidth: 2,
+            trailingComma: "es5"
+        });
+    }
+    toPascalCase(str) {
+        return str
+            .split(" ")
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join("");
+    }
+}
+//# sourceMappingURL=recipe-generator.js.map

package/lib/application/portal/recipe/recipe-generator.js.map

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

package/lib/application/portal/{new/toc → toc}/toc-content-parser.d.ts

@@ -1,4 +1,4 @@
-import { TocGroup } from "../../../../types/toc/toc";
+import { TocGroup } from "../../../types/toc/toc.js";
 export declare class TocContentParser {
     parseContentFolder(contentFolderPath: string, workingDirectory: string): Promise<TocGroup[]>;
     private normalizePath;