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

package/lib/types/api/transform.d.ts

@@ -1,14 +1,3 @@
-import { TransformationController } from "@apimatic/sdk";
-export type TransformationIdParams = {
-    file: string;
-    url: string;
-    format: string;
-};
-export type DownloadTransformationParams = {
-    id: string;
-    destinationFilePath: string;
-    transformationController: TransformationController;
-};
 export type TransformationData = {
     result: NodeJS.ReadableStream | Blob;
 };
@@ -28,18 +17,18 @@ export declare const DestinationFormats: {
     GraphQlSchema: string;
 };
 export declare enum TransformationFormats {
-    APIMATIC = "Apimatic",
-    WADL2009 = "Wadl2009",
-    WSDL = "Wsdl",
-    SWAGGER10 = "Swagger10",
-    SWAGGER20 = "Swagger20",
-    SWAGGERYAML = "Swaggeryaml",
-    OAS3 = "Oas3",
-    OPENAPI3YAML = "Openapi3Yaml",
-    APIBLUEPRINT = "Apiblueprint",
-    RAML = "Raml",
-    RAML10 = "Raml10",
-    POSTMAN10 = "Postman10",
-    POSTMAN20 = "Postman20",
-    GRAPHQLSCHEMA = "Graphqlschema"
+    apimatic = "Apimatic",
+    wadl2009 = "Wadl2009",
+    wsdl = "Wsdl",
+    swagger10 = "Swagger10",
+    swagger20 = "Swagger20",
+    swaggeryaml = "Swaggeryaml",
+    oas3 = "Oas3",
+    openapi3yaml = "Openapi3Yaml",
+    apiblueprint = "Apiblueprint",
+    raml = "Raml",
+    raml10 = "Raml10",
+    postman10 = "Postman10",
+    postman20 = "Postman20",
+    graphqlschema = "Graphqlschema"
 }

package/lib/types/api/transform.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformationFormats = exports.DestinationFormats = void 0;
-exports.DestinationFormats = {
+export const DestinationFormats = {
     OpenApi3Json: "json",
     OpenApi3Yaml: "yaml",
     APIMATIC: "json",
@@ -10,27 +7,27 @@ exports.DestinationFormats = {
     Swagger10: "json",
     Swagger20: "json",
     SwaggerYaml: "yaml",
-    RAML: "yaml",
-    RAML10: "yaml",
+    RAML: "raml",
+    RAML10: "raml",
     Postman10: "json",
     Postman20: "json",
     GraphQlSchema: "json"
 };
-var TransformationFormats;
+export var TransformationFormats;
 (function (TransformationFormats) {
-    TransformationFormats["APIMATIC"] = "Apimatic";
-    TransformationFormats["WADL2009"] = "Wadl2009";
-    TransformationFormats["WSDL"] = "Wsdl";
-    TransformationFormats["SWAGGER10"] = "Swagger10";
-    TransformationFormats["SWAGGER20"] = "Swagger20";
-    TransformationFormats["SWAGGERYAML"] = "Swaggeryaml";
-    TransformationFormats["OAS3"] = "Oas3";
-    TransformationFormats["OPENAPI3YAML"] = "Openapi3Yaml";
-    TransformationFormats["APIBLUEPRINT"] = "Apiblueprint";
-    TransformationFormats["RAML"] = "Raml";
-    TransformationFormats["RAML10"] = "Raml10";
-    TransformationFormats["POSTMAN10"] = "Postman10";
-    TransformationFormats["POSTMAN20"] = "Postman20";
-    TransformationFormats["GRAPHQLSCHEMA"] = "Graphqlschema";
-})(TransformationFormats || (exports.TransformationFormats = TransformationFormats = {}));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhbnNmb3JtLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3R5cGVzL2FwaS90cmFuc2Zvcm0udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBa0JhLFFBQUEsa0JBQWtCLEdBQUc7SUFDaEMsWUFBWSxFQUFFLE1BQU07SUFDcEIsWUFBWSxFQUFFLE1BQU07SUFDcEIsUUFBUSxFQUFFLE1BQU07SUFDaEIsUUFBUSxFQUFFLEtBQUs7SUFDZixJQUFJLEVBQUUsS0FBSztJQUNYLFNBQVMsRUFBRSxNQUFNO0lBQ2pCLFNBQVMsRUFBRSxNQUFNO0lBQ2pCLFdBQVcsRUFBRSxNQUFNO0lBQ25CLElBQUksRUFBRSxNQUFNO0lBQ1osTUFBTSxFQUFFLE1BQU07SUFDZCxTQUFTLEVBQUUsTUFBTTtJQUNqQixTQUFTLEVBQUUsTUFBTTtJQUNqQixhQUFhLEVBQUUsTUFBTTtDQUN0QixDQUFDO0FBRUYsSUFBWSxxQkFlWDtBQWZELFdBQVkscUJBQXFCO0lBQy9CLDhDQUFxQixDQUFBO0lBQ3JCLDhDQUFxQixDQUFBO0lBQ3JCLHNDQUFhLENBQUE7SUFDYixnREFBdUIsQ0FBQTtJQUN2QixnREFBdUIsQ0FBQTtJQUN2QixvREFBMkIsQ0FBQTtJQUMzQixzQ0FBYSxDQUFBO0lBQ2Isc0RBQTZCLENBQUE7SUFDN0Isc0RBQTZCLENBQUE7SUFDN0Isc0NBQWEsQ0FBQTtJQUNiLDBDQUFpQixDQUFBO0lBQ2pCLGdEQUF1QixDQUFBO0lBQ3ZCLGdEQUF1QixDQUFBO0lBQ3ZCLHdEQUErQixDQUFBO0FBQ2pDLENBQUMsRUFmVyxxQkFBcUIscUNBQXJCLHFCQUFxQixRQWVoQyJ9
+    TransformationFormats["apimatic"] = "Apimatic";
+    TransformationFormats["wadl2009"] = "Wadl2009";
+    TransformationFormats["wsdl"] = "Wsdl";
+    TransformationFormats["swagger10"] = "Swagger10";
+    TransformationFormats["swagger20"] = "Swagger20";
+    TransformationFormats["swaggeryaml"] = "Swaggeryaml";
+    TransformationFormats["oas3"] = "Oas3";
+    TransformationFormats["openapi3yaml"] = "Openapi3Yaml";
+    TransformationFormats["apiblueprint"] = "Apiblueprint";
+    TransformationFormats["raml"] = "Raml";
+    TransformationFormats["raml10"] = "Raml10";
+    TransformationFormats["postman10"] = "Postman10";
+    TransformationFormats["postman20"] = "Postman20";
+    TransformationFormats["graphqlschema"] = "Graphqlschema";
+})(TransformationFormats || (TransformationFormats = {}));
+//# sourceMappingURL=transform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/types/api/transform.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,KAAK;IACX,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,MAAM;IACnB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;IACjB,aAAa,EAAE,MAAM;CACtB,CAAC;AAEF,MAAM,CAAN,IAAY,qBAeX;AAfD,WAAY,qBAAqB;IAC/B,8CAAqB,CAAA;IACrB,8CAAqB,CAAA;IACrB,sCAAa,CAAA;IACb,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,oDAA2B,CAAA;IAC3B,sCAAa,CAAA;IACb,sDAA6B,CAAA;IAC7B,sDAA6B,CAAA;IAC7B,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,wDAA+B,CAAA;AACjC,CAAC,EAfW,qBAAqB,KAArB,qBAAqB,QAehC"}

package/lib/types/build/build.d.ts

@@ -0,0 +1,22 @@
+import { DirectoryPath } from "../file/directoryPath.js";
+export interface BuildConfig {
+    generatePortal?: PortalConfig;
+    apiCopilotConfig?: CopilotConfig;
+    [key: string]: unknown;
+}
+export interface PortalConfig {
+    contentFolder?: string;
+    languageConfig: {
+        [key: string]: object;
+    };
+    [key: string]: unknown;
+    apiSpecPath?: DirectoryPath;
+}
+export interface CopilotConfig {
+    isEnabled: boolean;
+    key: string;
+    welcomeMessage: string;
+}
+export declare function getLanguagesConfig(selectedLanguages: string[]): {
+    [key: string]: object;
+};

package/lib/types/build/build.js

@@ -0,0 +1,7 @@
+export function getLanguagesConfig(selectedLanguages) {
+    return selectedLanguages.reduce((config, lang) => {
+        config[lang] = {};
+        return config;
+    }, {});
+}
+//# sourceMappingURL=build.js.map

package/lib/types/build/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/types/build/build.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,kBAAkB,CAAC,iBAA2B;IAC5D,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAA+B,CAAC,CAAC;AACtC,CAAC"}

package/lib/types/build-context.d.ts

@@ -0,0 +1,13 @@
+import { DirectoryPath } from "./file/directoryPath.js";
+import { BuildConfig } from "./build/build.js";
+export declare class BuildContext {
+    private readonly fileService;
+    private readonly buildDirectory;
+    constructor(buildDirectory: DirectoryPath);
+    private get buildFile();
+    validate(): Promise<boolean>;
+    exists(): Promise<boolean>;
+    getBuildFileContents(): Promise<BuildConfig>;
+    updateBuildFileContents(buildJson: BuildConfig): Promise<void>;
+    deleteWorkflowDir(): Promise<void>;
+}

package/lib/types/build-context.js

@@ -0,0 +1,33 @@
+import { FileService } from "../infrastructure/file-service.js";
+import { FilePath } from "./file/filePath.js";
+import { FileName } from "./file/fileName.js";
+export class BuildContext {
+    constructor(buildDirectory) {
+        this.fileService = new FileService();
+        this.buildDirectory = buildDirectory;
+    }
+    get buildFile() {
+        // TODO: add checks for build file path
+        return new FilePath(this.buildDirectory, new FileName("APIMATIC-BUILD.json"));
+    }
+    async validate() {
+        // TODO: add more checks here
+        if (!(await this.fileService.directoryExists(this.buildDirectory)))
+            return false;
+        return await this.fileService.fileExists(this.buildFile);
+    }
+    async exists() {
+        return !(await this.fileService.directoryEmpty(this.buildDirectory));
+    }
+    async getBuildFileContents() {
+        const buildFileContent = await this.fileService.getContents(this.buildFile);
+        return JSON.parse(buildFileContent);
+    }
+    async updateBuildFileContents(buildJson) {
+        await this.fileService.writeContents(this.buildFile, JSON.stringify(buildJson, null, 2));
+    }
+    async deleteWorkflowDir() {
+        await this.fileService.deleteDirectory(this.buildDirectory.join(".github"));
+    }
+}
+//# sourceMappingURL=build-context.js.map

package/lib/types/build-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context.js","sourceRoot":"","sources":["../../src/types/build-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,OAAO,YAAY;IAIvB,YAAY,cAA6B;QAHxB,gBAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAI/C,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,IAAY,SAAS;QACnB,uCAAuC;QACvC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAChF,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,6BAA6B;QAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAEjF,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACvE,CAAC;IAEM,KAAK,CAAC,oBAAoB;QAC/B,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAgB,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,uBAAuB,CAAC,SAAsB;QACzD,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IAEM,KAAK,CAAC,iBAAiB;QAC5B,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/lib/types/common/command-metadata.d.ts

@@ -0,0 +1,4 @@
+export interface CommandMetadata {
+    readonly commandName: string;
+    readonly shell: string;
+}

package/lib/types/common/command-metadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-metadata.js.map

package/lib/types/common/command-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-metadata.js","sourceRoot":"","sources":["../../../src/types/common/command-metadata.ts"],"names":[],"mappings":""}

package/lib/types/events/domain-event.d.ts

@@ -0,0 +1,8 @@
+export declare abstract class DomainEvent {
+    protected abstract readonly eventName: string;
+    private readonly message;
+    private readonly commandName;
+    private readonly flags;
+    protected constructor(message: string, commandName: string, flags: Record<string, unknown>);
+    private extractFlagKeys;
+}

package/lib/types/events/domain-event.js

@@ -0,0 +1,11 @@
+export class DomainEvent {
+    constructor(message, commandName, flags) {
+        this.message = message;
+        this.commandName = commandName;
+        this.flags = this.extractFlagKeys(flags);
+    }
+    extractFlagKeys(flags) {
+        return Object.keys(flags);
+    }
+}
+//# sourceMappingURL=domain-event.js.map

package/lib/types/events/domain-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../../../src/types/events/domain-event.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,WAAW;IAM/B,YAAsB,OAAe,EAAE,WAAmB,EAAE,KAA8B;QACxF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAEO,eAAe,CAAC,KAA8B;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/lib/types/events/quickstart-completed.d.ts

@@ -0,0 +1,7 @@
+import { DomainEvent } from "./domain-event.js";
+export declare class QuickstartCompletedEvent extends DomainEvent {
+    protected readonly eventName: string;
+    private static readonly message;
+    private static readonly commandName;
+    constructor();
+}

package/lib/types/events/quickstart-completed.js

@@ -0,0 +1,10 @@
+import { DomainEvent } from "./domain-event.js";
+export class QuickstartCompletedEvent extends DomainEvent {
+    constructor() {
+        super(QuickstartCompletedEvent.message, QuickstartCompletedEvent.commandName, {});
+        this.eventName = QuickstartCompletedEvent.name;
+    }
+}
+QuickstartCompletedEvent.message = "Quickstart completed.";
+QuickstartCompletedEvent.commandName = "quickstart";
+//# sourceMappingURL=quickstart-completed.js.map

package/lib/types/events/quickstart-completed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart-completed.js","sourceRoot":"","sources":["../../../src/types/events/quickstart-completed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IAKvD;QACE,KAAK,CAAC,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QALjE,cAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC;IAM7D,CAAC;;AALuB,gCAAO,GAAG,uBAAgC,AAAnC,CAAoC;AAC3C,oCAAW,GAAG,YAAqB,AAAxB,CAAyB"}

package/lib/types/events/quickstart-initiated.d.ts

@@ -0,0 +1,7 @@
+import { DomainEvent } from "./domain-event.js";
+export declare class QuickstartInitiatedEvent extends DomainEvent {
+    protected readonly eventName: string;
+    private static readonly message;
+    private static readonly commandName;
+    constructor();
+}

package/lib/types/events/quickstart-initiated.js

@@ -0,0 +1,10 @@
+import { DomainEvent } from "./domain-event.js";
+export class QuickstartInitiatedEvent extends DomainEvent {
+    constructor() {
+        super(QuickstartInitiatedEvent.message, QuickstartInitiatedEvent.commandName, {});
+        this.eventName = QuickstartInitiatedEvent.name;
+    }
+}
+QuickstartInitiatedEvent.message = "Quickstart initiated.";
+QuickstartInitiatedEvent.commandName = "quickstart";
+//# sourceMappingURL=quickstart-initiated.js.map

package/lib/types/events/quickstart-initiated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart-initiated.js","sourceRoot":"","sources":["../../../src/types/events/quickstart-initiated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IAKvD;QACE,KAAK,CAAC,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QALjE,cAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC;IAM7D,CAAC;;AALuB,gCAAO,GAAG,uBAAgC,AAAnC,CAAoC;AAC3C,oCAAW,GAAG,YAAqB,AAAxB,CAAyB"}

package/lib/types/events/recipe-creation-failed.d.ts

@@ -0,0 +1,5 @@
+import { DomainEvent } from "./domain-event.js";
+export declare class RecipeCreationFailedEvent extends DomainEvent {
+    protected readonly eventName: string;
+    constructor(message: string, commandName: string, flags: Record<string, unknown>);
+}

package/lib/types/events/recipe-creation-failed.js

@@ -0,0 +1,8 @@
+import { DomainEvent } from "./domain-event.js";
+export class RecipeCreationFailedEvent extends DomainEvent {
+    constructor(message, commandName, flags) {
+        super(message, commandName, flags);
+        this.eventName = RecipeCreationFailedEvent.name;
+    }
+}
+//# sourceMappingURL=recipe-creation-failed.js.map

package/lib/types/events/recipe-creation-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-creation-failed.js","sourceRoot":"","sources":["../../../src/types/events/recipe-creation-failed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IAGxD,YAAY,OAAe,EAAE,WAAmB,EAAE,KAA8B;QAC9E,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAHlB,cAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC;IAI9D,CAAC;CACF"}

package/lib/types/events/toc-creation-failed.d.ts

@@ -0,0 +1,5 @@
+import { DomainEvent } from "./domain-event.js";
+export declare class TocCreationFailedEvent extends DomainEvent {
+    protected readonly eventName: string;
+    constructor(message: string, commandName: string, flags: Record<string, unknown>);
+}

package/lib/types/events/toc-creation-failed.js

@@ -0,0 +1,8 @@
+import { DomainEvent } from "./domain-event.js";
+export class TocCreationFailedEvent extends DomainEvent {
+    constructor(message, commandName, flags) {
+        super(message, commandName, flags);
+        this.eventName = TocCreationFailedEvent.name;
+    }
+}
+//# sourceMappingURL=toc-creation-failed.js.map

package/lib/types/events/toc-creation-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc-creation-failed.js","sourceRoot":"","sources":["../../../src/types/events/toc-creation-failed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IAGrD,YAAY,OAAe,EAAE,WAAmB,EAAE,KAA8B;QAC9E,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAHlB,cAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAI3D,CAAC;CACF"}

package/lib/types/file/directory.d.ts

@@ -0,0 +1,17 @@
+import { DirectoryPath } from "./directoryPath.js";
+import { FileName } from "./fileName.js";
+import { TocGroup } from "../toc/toc.js";
+import { TreeNode } from "../../prompts/format.js";
+export type DirectoryItem = FileName | Directory;
+export declare class Directory {
+    readonly directoryPath: DirectoryPath;
+    readonly items: DirectoryItem[];
+    private readonly fileService;
+    constructor(directoryPath: DirectoryPath, filePaths: DirectoryItem[]);
+    private static readonly folderDescriptions;
+    private static readonly fileDescriptions;
+    toTreeNode(): TreeNode;
+    parseContentFolder(baseContentPath: DirectoryPath): Promise<TocGroup[]>;
+    private getPageName;
+    private isRootContentDirectory;
+}

package/lib/types/file/directory.js

@@ -0,0 +1,87 @@
+import { FilePath } from "./filePath.js";
+import { FileService } from "../../infrastructure/file-service.js";
+export class Directory {
+    constructor(directoryPath, filePaths) {
+        this.fileService = new FileService();
+        this.directoryPath = directoryPath;
+        this.items = filePaths;
+    }
+    toTreeNode() {
+        const folderName = this.directoryPath.leafName();
+        const folderDescription = Directory.folderDescriptions[folderName];
+        return {
+            name: folderName,
+            description: folderDescription,
+            items: this.items.map((item) => {
+                if (item instanceof Directory) {
+                    return item.toTreeNode();
+                }
+                // file case
+                const fileName = item.toString();
+                const fileDescription = Directory.fileDescriptions[fileName];
+                return {
+                    name: fileName,
+                    description: fileDescription
+                };
+            })
+        };
+    }
+    async parseContentFolder(baseContentPath) {
+        const groups = [];
+        const pages = [];
+        for (const item of this.items) {
+            if (item instanceof Directory) {
+                const subGroups = await item.parseContentFolder(baseContentPath);
+                if (subGroups.length > 0) {
+                    const directoryName = item.directoryPath.leafName();
+                    groups.push({
+                        group: directoryName,
+                        items: subGroups
+                    });
+                }
+            }
+            else {
+                if (item.isMarkDown()) {
+                    const currentFilePath = new FilePath(this.directoryPath, item);
+                    const relativeFilePath = this.fileService.getRelativePath(currentFilePath, baseContentPath);
+                    pages.push({
+                        page: this.getPageName(item),
+                        file: relativeFilePath
+                    });
+                }
+            }
+        }
+        const allItems = [...pages, ...groups];
+        if (allItems.length === 0) {
+            return [];
+        }
+        if (this.isRootContentDirectory(baseContentPath)) {
+            return [
+                {
+                    group: "Custom Content",
+                    items: allItems
+                }
+            ];
+        }
+        // For subdirectories, return the items directly
+        return allItems;
+    }
+    getPageName(fileName) {
+        const fileNameStr = fileName.toString();
+        return fileNameStr.replace(/\.md$/, "");
+    }
+    isRootContentDirectory(baseContentPath) {
+        return this.directoryPath.toString() === baseContentPath.toString();
+    }
+}
+Directory.folderDescriptions = {
+    spec: "# Contains all API definition files",
+    content: "# Includes custom documentation pages in Markdown",
+    static: "# Includes all static files, such as images, GIFs, and PDFs"
+};
+Directory.fileDescriptions = {
+    "toc.yml": "# Controls the structure of the side navigation bar in the API portal",
+    "APIMATIC-BUILD.json": "# Defines all configurations for the API portal, including programming languages and themes",
+    "APIMATIC-META.json": "# Defines customization for SDK generation",
+};
+//# sourceMappingURL=directory.js.map

package/lib/types/file/directory.js.map

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

package/lib/types/file/directoryPath.d.ts

@@ -0,0 +1,10 @@
+export declare class DirectoryPath {
+    private readonly directoryPath;
+    constructor(directoryPath: string, ...subPaths: string[]);
+    static default: DirectoryPath;
+    static createInput(input: string | undefined): DirectoryPath;
+    toString(): string;
+    join(...subPath: string[]): DirectoryPath;
+    isEqual(other: DirectoryPath): boolean;
+    leafName(): string;
+}

package/lib/types/file/directoryPath.js

@@ -0,0 +1,26 @@
+import * as path from "path";
+export class DirectoryPath {
+    constructor(directoryPath, ...subPaths) {
+        this.directoryPath = path.resolve(directoryPath, ...subPaths);
+    }
+    static createInput(input) {
+        if (!input) {
+            return DirectoryPath.default;
+        }
+        return new DirectoryPath(input);
+    }
+    toString() {
+        return this.directoryPath;
+    }
+    join(...subPath) {
+        return new DirectoryPath(path.join(this.directoryPath, ...subPath));
+    }
+    isEqual(other) {
+        return this.directoryPath === other.directoryPath;
+    }
+    leafName() {
+        return path.basename(this.directoryPath);
+    }
+}
+DirectoryPath.default = new DirectoryPath("./");
+//# sourceMappingURL=directoryPath.js.map

package/lib/types/file/directoryPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryPath.js","sourceRoot":"","sources":["../../../src/types/file/directoryPath.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,OAAO,aAAa;IAGxB,YAAY,aAAqB,EAAE,GAAG,QAAkB;QACtD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,QAAQ,CAAC,CAAC;IAChE,CAAC;IAIM,MAAM,CAAC,WAAW,CAAC,KAAyB;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,aAAa,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAEM,IAAI,CAAC,GAAG,OAAiB;QAC9B,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAEM,OAAO,CAAC,KAAoB;QACjC,OAAO,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAAC;IACpD,CAAC;IACM,QAAQ;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;;AAtBa,qBAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC"}

package/lib/types/file/fileName.d.ts

@@ -0,0 +1,7 @@
+export declare class FileName {
+    private readonly name;
+    constructor(name: string);
+    isMarkDown(): boolean;
+    normalize(): FileName;
+    toString(): string;
+}

package/lib/types/file/fileName.js

@@ -0,0 +1,21 @@
+export class FileName {
+    constructor(name) {
+        this.name = name;
+    }
+    isMarkDown() {
+        return this.name.endsWith(".md");
+    }
+    normalize() {
+        const nameWithoutExt = this.name.replace(/\.[^/.]+$/, "");
+        const normalized = nameWithoutExt
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "-")
+            .replace(/-+/g, "-")
+            .replace(/(^-|-$)/g, "");
+        return new FileName(normalized);
+    }
+    toString() {
+        return this.name;
+    }
+}
+//# sourceMappingURL=fileName.js.map

package/lib/types/file/fileName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileName.js","sourceRoot":"","sources":["../../../src/types/file/fileName.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IAGnB,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,UAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAEM,SAAS;QACd,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,cAAc;aAC9B,WAAW,EAAE;aACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;aAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3B,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/lib/types/file/filePath.d.ts

@@ -0,0 +1,10 @@
+import { FileName } from "./fileName.js";
+import { DirectoryPath } from "./directoryPath.js";
+export declare class FilePath {
+    private readonly fileName;
+    private readonly directoryPath;
+    constructor(path: DirectoryPath, name: FileName);
+    replaceDirectory(newDirectory: DirectoryPath): FilePath;
+    toString(): string;
+    static create(filePath: string): FilePath | undefined;
+}

package/lib/types/file/filePath.js

@@ -0,0 +1,32 @@
+import path from "path";
+import { FileName } from "./fileName.js";
+import { DirectoryPath } from "./directoryPath.js";
+export class FilePath {
+    constructor(path, name) {
+        this.fileName = name;
+        this.directoryPath = path;
+    }
+    replaceDirectory(newDirectory) {
+        return new FilePath(newDirectory, this.fileName);
+    }
+    toString() {
+        return path.join(this.directoryPath.toString(), this.fileName.toString());
+    }
+    static create(filePath) {
+        if (!filePath) {
+            return undefined;
+        }
+        try {
+            const normalizedPath = path.normalize(filePath);
+            const directory = path.dirname(normalizedPath);
+            const filename = path.basename(normalizedPath);
+            const directoryPath = new DirectoryPath(directory);
+            const fileName = new FileName(filename);
+            return new FilePath(directoryPath, fileName);
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=filePath.js.map

package/lib/types/file/filePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePath.js","sourceRoot":"","sources":["../../../src/types/file/filePath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAO,QAAQ;IAInB,YAAY,IAAmB,EAAE,IAAc;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAEM,gBAAgB,CAAC,YAA2B;QACjD,OAAO,IAAI,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,QAAgB;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAC/C,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxC,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/lib/types/file/resource-input.d.ts

@@ -0,0 +1,5 @@
+import { FilePath } from "./filePath.js";
+import { UrlPath } from "./urlPath.js";
+export type ResourceInput = FilePath | UrlPath;
+export declare const createResourceInput: (file?: string, url?: string) => ResourceInput;
+export declare function createResourceInputFromInput(path: string): ResourceInput | undefined;

package/lib/types/file/resource-input.js

@@ -0,0 +1,42 @@
+import path from "path";
+import { DirectoryPath } from "./directoryPath.js";
+import { FileName } from "./fileName.js";
+import { FilePath } from "./filePath.js";
+import { UrlPath } from "./urlPath.js";
+import { removeQuotes } from "../../utils/string-utils.js";
+// Factory function to create the discriminated union
+export const createResourceInput = (file, url) => {
+    if (file && url) {
+        throw new Error("Cannot specify both file and url. Please provide only one.");
+    }
+    if (!file && !url) {
+        throw new Error("Must specify either file or url.");
+    }
+    if (file) {
+        if (!file.trim()) {
+            throw new Error("Invalid file path provided.");
+        }
+        return new FilePath(new DirectoryPath(path.dirname(file)), new FileName(path.basename(file)));
+    }
+    if (url) {
+        if (!url.trim()) {
+            throw new Error("Invalid URL provided.");
+        }
+        return new UrlPath(url);
+    }
+    throw new Error("Must specify either file or url.");
+};
+export function createResourceInputFromInput(path) {
+    var _a;
+    const sanitizedPath = removeQuotes((_a = path.trim()) !== null && _a !== void 0 ? _a : "");
+    const urlPath = UrlPath.create(sanitizedPath);
+    if (urlPath) {
+        return urlPath;
+    }
+    const filePath = FilePath.create(sanitizedPath);
+    if (filePath) {
+        return filePath;
+    }
+    return undefined;
+}
+//# sourceMappingURL=resource-input.js.map

package/lib/types/file/resource-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-input.js","sourceRoot":"","sources":["../../../src/types/file/resource-input.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI3D,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAa,EAAE,GAAY,EAAiB,EAAE;IAChF,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,IAAY;;IACvD,MAAM,aAAa,GAAG,YAAY,CAAC,MAAA,IAAI,CAAC,IAAI,EAAE,mCAAI,EAAE,CAAC,CAAA;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}