@apimatic/cli 1.1.0-beta.8 → 1.1.0

package/lib/prompts/sdk/save-changes.js

@@ -0,0 +1,84 @@
+import { log, isCancel, select, confirm } from "@clack/prompts";
+import { format as f, getTree } from "../format.js";
+import { noteWrapped } from "../prompt.js";
+export class SaveChangesPrompts {
+    srcDirectoryEmpty(directory) {
+        const message = `The ${f.var("src")} directory is either empty or invalid: ${f.path(directory)}`;
+        log.error(message);
+    }
+    invalidSdkDirectory(directory) {
+        const message = `SDK directory does not exist: ${f.path(directory)}`;
+        log.error(message);
+    }
+    invalidVersionedDocsDirectory(directory) {
+        const message = `The ${f.var("versioned_docs")} directory is either empty or invalid: ${f.path(directory)}`;
+        log.error(message);
+    }
+    apiVersionOnlyApplicableWithVersionedBuild() {
+        log.warn(`The ${f.flag("api-version")} is only applicable with a versioned build.`);
+    }
+    versionNotFound() {
+        log.error(`The selected API version is invalid.`);
+    }
+    async selectVersion(versions) {
+        const version = await select({
+            message: "Select an API version to save SDK changes into:",
+            options: versions.map((v) => ({ label: v, value: v }))
+        });
+        if (isCancel(version)) {
+            return undefined;
+        }
+        return version;
+    }
+    sdkSourceTreeNotFound(language) {
+        log.error(`No 'sdk-source-tree' found for ${f.var(language)}. You need to generate the SDK with change tracking enabled before you can save changes.`);
+        const message = `Generate the SDK with change tracking by running:
+'${f.cmdAlt("apimatic", "sdk", "generate")} ${f.flag("language", language)} ${f.flag("track-changes")}'
+Then customize your SDK and run ${f.cmdAlt("apimatic", "sdk", "save-changes")} again.`;
+        noteWrapped(message, "Next Steps");
+    }
+    operationCancelled() {
+        log.warn("Exiting without saving any changes.");
+    }
+    async directoryStillOpen(directory) {
+        log.info(`Please close all applications using the directory ${f.path(directory)} to allow cleanup of temporary files.`);
+    }
+    modifiedFilesDetected(directory) {
+        log.info(`Detected changes in the following file(s):
+  ${getTree(directory.toTreeNode())}`);
+    }
+    async confirmReviewChanges() {
+        const confirmed = await confirm({
+            message: `Do you want to review these changes?`,
+            initialValue: false
+        });
+        if (isCancel(confirmed)) {
+            return false;
+        }
+        return confirmed;
+    }
+    noChangesDetected() {
+        log.info("No changes detected in the SDK.");
+    }
+    openingDirectoryToReviewChanges() {
+        log.info(`Opening the changed files in VS Code for review. Close the editor to proceed.`);
+    }
+    async reviewChangesManually(tempDirectory) {
+        log.info(`Review the changes at ${f.path(tempDirectory)} to proceed.`);
+    }
+    async confirmSaveChanges() {
+        const confirmed = await confirm({
+            message: `Do you want to save these changes?`,
+            initialValue: true
+        });
+        if (isCancel(confirmed)) {
+            return false;
+        }
+        return confirmed;
+    }
+    changesSaved(sourceTreePath) {
+        log.success(`Changes saved successfully at ${f.path(sourceTreePath)}.`);
+        log.info(`Your saved changes will reapply automatically the next time you generate this SDK.`);
+    }
+}
+//# sourceMappingURL=save-changes.js.map

package/lib/prompts/sdk/save-changes.js.map

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

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

@@ -1,7 +1,11 @@
 import { DirectoryPath } from "../file/directoryPath.js";
-export interface BuildConfig {
+import { UrlPath } from "../file/urlPath.js";
+export interface BuildConfigData {
     generatePortal?: PortalConfig;
+    generateVersionedPortal?: object;
+    versionsPath?: string;
     apiCopilotConfig?: CopilotConfig;
+    recipes?: RecipesConfig;
     [key: string]: unknown;
 }
 export interface PortalConfig {
@@ -9,14 +13,89 @@ export interface PortalConfig {
     languageConfig: {
         [key: string]: object;
     };
-    [key: string]: unknown;
+    /** URL where the portal will be hosted. Mirrors `generatePortal.baseUrl` in codegen. */
+    baseUrl?: string;
+    /** Portal UI settings. Mirrors `generatePortal.portalSettings` in codegen. */
+    portalSettings?: PortalSettingsData;
     apiSpecPath?: DirectoryPath;
+    [key: string]: unknown;
+}
+export interface PortalSettingsData {
+    /** Base URL for the API calls made by the portal. Preferred over `generatePortal.baseUrl` for portal artifacts. */
+    baseUrl?: string;
+    /** Language/template id the portal opens on first load. */
+    initialPlatform?: string;
+    /** Per-language portal settings, keyed by language/template id. */
+    languageSettings?: {
+        [language: string]: LanguageSettingData;
+    };
+    [key: string]: unknown;
+}
+export interface LanguageSettingData {
+    aiIntegration?: AiIntegration;
+    [key: string]: unknown;
+}
+export interface AiIntegration {
+    cursor?: AiIntegrationSetting;
+    claudeCode?: AiIntegrationSetting;
+    vscode?: AiIntegrationSetting;
+}
+export interface AiIntegrationSetting {
+    isEnabled: boolean;
+    stabilityLevelTag?: string;
 }
 export interface CopilotConfig {
     isEnabled: boolean;
     key: string;
     welcomeMessage: string;
 }
+export interface RecipesConfig {
+    workflows?: RecipeWorkflow[];
+}
+export interface RecipeWorkflow {
+    name: string;
+    permalink: string;
+    functionName: string;
+    scriptPath: string;
+}
 export declare function getLanguagesConfig(selectedLanguages: string[]): {
     [key: string]: object;
 };
+export declare class LanguageSetting {
+    private readonly data;
+    private constructor();
+    static from(data?: LanguageSettingData): LanguageSetting;
+    /** Returns a copy with all AI editor integrations (Cursor/Claude Code/VS Code) enabled. */
+    withAiIntegrationsEnabled(): LanguageSetting;
+    toLanguageSettingData(): LanguageSettingData;
+}
+export declare class PortalSettings {
+    private readonly data;
+    private constructor();
+    static from(data?: PortalSettingsData): PortalSettings;
+    /** Returns a copy with the API-call base URL set. */
+    withBaseUrl(baseUrl: UrlPath): PortalSettings;
+    withAiIntegrations(languages: string[]): PortalSettings;
+    toPortalSettingsData(): PortalSettingsData;
+}
+export declare class BuildConfig {
+    private readonly data;
+    private constructor();
+    static parse(json: string): BuildConfig;
+    toJSON(): BuildConfigData;
+    /** Content directory for the portal, relative to the build directory. Defaults to "content". */
+    contentFolder(): string;
+    /** True when this build produces a multi-versioned portal. */
+    isVersioned(): boolean;
+    /** Directory holding the versioned portals, relative to the build directory. Defaults to "versioned_docs". */
+    versionsPath(): string;
+    /** True when API Copilot is already configured for this build. */
+    hasApiCopilot(): boolean;
+    /** Returns a copy with the portal's languageConfig set from the selected friendly language ids. */
+    withPortalLanguages(languages: string[]): BuildConfig;
+    /** Returns a copy with the API Copilot configuration set (or overwritten). */
+    withApiCopilotConfig(config: CopilotConfig): BuildConfig;
+    withApiCopilotForPortal(key: string, welcomeMessage: string, baseUrl: UrlPath): BuildConfig;
+    updateBuildConfigBaseUrl(serveUrl: UrlPath): BuildConfig;
+    withRecipeWorkflow(name: string, functionName: string, scriptPath: string): BuildConfig;
+}

package/lib/types/build/build.js

@@ -1,7 +1,165 @@
+import { UrlPath } from "../file/urlPath.js";
 export function getLanguagesConfig(selectedLanguages) {
     return selectedLanguages.reduce((config, lang) => {
         config[lang] = {};
         return config;
     }, {});
 }
+// Maps the CLI's friendly language identifiers (used as languageConfig keys) to
+// codegen's SupportedTemplates ids, which is what portalSettings.languageSettings
+// must be keyed by (codegen resolves these via SdkLanguage.FromSupportedTemplate).
+// These ids are version-specific in codegen (e.g. php_generic_lib_v2) — keep in sync
+// with APIMatic.CodeGen.Common.SdkLanguage.
+const CODEGEN_TEMPLATE_ID_BY_LANGUAGE = {
+    typescript: "ts_generic_lib",
+    csharp: "cs_net_standard_lib",
+    java: "java_eclipse_jre_lib",
+    php: "php_generic_lib_v2",
+    python: "python_generic_lib",
+    ruby: "ruby_generic_lib",
+    go: "go_generic_lib"
+};
+// codegen derives initialPlatform from languageConfig (http is always first), so a
+// languageSettings entry for http must exist or the portal widget fails to render.
+const HTTP_TEMPLATE_ID = "http_curl_v1";
+// Immutable per-language portal setting. Build new values via the static factory and
+// the with* transforms; the wrapped data is never mutated after construction.
+export class LanguageSetting {
+    constructor(data) {
+        this.data = data;
+    }
+    static from(data = {}) {
+        return new LanguageSetting(data);
+    }
+    /** Returns a copy with all AI editor integrations (Cursor/Claude Code/VS Code) enabled. */
+    withAiIntegrationsEnabled() {
+        return new LanguageSetting(Object.assign(Object.assign({}, this.data), { aiIntegration: {
+                cursor: { isEnabled: true },
+                claudeCode: { isEnabled: true },
+                vscode: { isEnabled: true }
+            } }));
+    }
+    toLanguageSettingData() {
+        return this.data;
+    }
+}
+// Immutable portal UI settings. Build new values via the static factory and the with*
+// transforms; the wrapped data is never mutated after construction.
+export class PortalSettings {
+    constructor(data) {
+        this.data = data;
+    }
+    static from(data = {}) {
+        return new PortalSettings(data);
+    }
+    /** Returns a copy with the API-call base URL set. */
+    withBaseUrl(baseUrl) {
+        return new PortalSettings(Object.assign(Object.assign({}, this.data), { baseUrl: baseUrl.toString() }));
+    }
+    // Returns a copy with AI editor integrations enabled for the given SDK languages
+    // (friendly ids). Always adds the http entry the portal needs to render and opens the
+    // portal on the first SDK language. Languages without a codegen template id are skipped.
+    withAiIntegrations(languages) {
+        var _a;
+        const languageSettings = Object.assign({}, this.data.languageSettings);
+        languageSettings[HTTP_TEMPLATE_ID] = (_a = languageSettings[HTTP_TEMPLATE_ID]) !== null && _a !== void 0 ? _a : {};
+        let firstSdkTemplateId;
+        for (const language of languages) {
+            const templateId = CODEGEN_TEMPLATE_ID_BY_LANGUAGE[language];
+            if (!templateId) {
+                continue;
+            }
+            firstSdkTemplateId !== null && firstSdkTemplateId !== void 0 ? firstSdkTemplateId : (firstSdkTemplateId = templateId);
+            languageSettings[templateId] = LanguageSetting.from(languageSettings[templateId]).withAiIntegrationsEnabled().toLanguageSettingData();
+        }
+        return new PortalSettings(Object.assign(Object.assign(Object.assign({}, this.data), { languageSettings }), (firstSdkTemplateId ? { initialPlatform: firstSdkTemplateId } : {})));
+    }
+    toPortalSettingsData() {
+        return this.data;
+    }
+}
+// Immutable wrapper around the parsed APIMATIC-BUILD.json. All build-config reads go
+// through accessor methods and all changes go through with*/update methods that
+// return a NEW BuildConfig — the wrapped data is never mutated after construction.
+// Construct via `BuildConfig.parse`; persist via `BuildContext`.
+export class BuildConfig {
+    constructor(data) {
+        this.data = data;
+    }
+    static parse(json) {
+        return new BuildConfig(JSON.parse(json));
+    }
+    // Called implicitly by JSON.stringify when the config is written back to disk.
+    toJSON() {
+        return this.data;
+    }
+    /** Content directory for the portal, relative to the build directory. Defaults to "content". */
+    contentFolder() {
+        var _a, _b;
+        return (_b = (_a = this.data.generatePortal) === null || _a === void 0 ? void 0 : _a.contentFolder) !== null && _b !== void 0 ? _b : "content";
+    }
+    /** True when this build produces a multi-versioned portal. */
+    isVersioned() {
+        return this.data.generateVersionedPortal != null;
+    }
+    /** Directory holding the versioned portals, relative to the build directory. Defaults to "versioned_docs". */
+    versionsPath() {
+        var _a;
+        return (_a = this.data.versionsPath) !== null && _a !== void 0 ? _a : "versioned_docs";
+    }
+    /** True when API Copilot is already configured for this build. */
+    hasApiCopilot() {
+        return this.data.apiCopilotConfig != null;
+    }
+    /** Returns a copy with the portal's languageConfig set from the selected friendly language ids. */
+    withPortalLanguages(languages) {
+        const portal = this.data.generatePortal;
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { generatePortal: Object.assign(Object.assign({}, portal), { languageConfig: getLanguagesConfig(languages) }) }));
+    }
+    /** Returns a copy with the API Copilot configuration set (or overwritten). */
+    withApiCopilotConfig(config) {
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { apiCopilotConfig: Object.assign({}, config) }));
+    }
+    // Returns a copy with API Copilot enabled for a locally-served portal: stores the
+    // Copilot config, points the portal base URL at the local serve URL, and turns on AI
+    // editor integrations for the configured SDK languages.
+    withApiCopilotForPortal(key, welcomeMessage, baseUrl) {
+        const portal = this.data.generatePortal;
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { apiCopilotConfig: { isEnabled: true, key, welcomeMessage }, generatePortal: Object.assign(Object.assign({}, portal), { baseUrl: baseUrl.toString(), portalSettings: PortalSettings.from(portal.portalSettings)
+                    .withAiIntegrations(Object.keys(portal.languageConfig))
+                    .toPortalSettingsData() }) }));
+    }
+    // Returns a copy with the portal base URL repointed at the serve URL, or `this`
+    // unchanged when there's no localhost base URL to rewrite (or it already matches the
+    // serve URL). Callers detect a change via reference identity: `result !== original`.
+    updateBuildConfigBaseUrl(serveUrl) {
+        var _a, _b, _c, _d;
+        // `portalSettings.baseUrl` is preferred for portal artifacts; otherwise fall back
+        // to `generatePortal.baseUrl`. Mirrors how codegen resolves the base URL.
+        const portalSettings = (_a = this.data.generatePortal) === null || _a === void 0 ? void 0 : _a.portalSettings;
+        const baseUrl = (_b = portalSettings === null || portalSettings === void 0 ? void 0 : portalSettings.baseUrl) !== null && _b !== void 0 ? _b : (_c = this.data.generatePortal) === null || _c === void 0 ? void 0 : _c.baseUrl;
+        if (!baseUrl) {
+            return this;
+        }
+        const parsedUrl = UrlPath.create(baseUrl);
+        if (!(parsedUrl === null || parsedUrl === void 0 ? void 0 : parsedUrl.isLocalhost()) || parsedUrl.isEqual(serveUrl)) {
+            return this;
+        }
+        const portal = this.data.generatePortal;
+        const updatedPortal = ((_d = portal.portalSettings) === null || _d === void 0 ? void 0 : _d.baseUrl)
+            ? Object.assign(Object.assign({}, portal), { portalSettings: PortalSettings.from(portal.portalSettings).withBaseUrl(serveUrl).toPortalSettingsData() }) : Object.assign(Object.assign({}, portal), { baseUrl: serveUrl.toString() });
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { generatePortal: updatedPortal }));
+    }
+    // Returns a copy with a recipe workflow added (or replaced, matched by permalink).
+    withRecipeWorkflow(name, functionName, scriptPath) {
+        var _a, _b;
+        const recipes = (_a = this.data.recipes) !== null && _a !== void 0 ? _a : {};
+        const workflows = (_b = recipes.workflows) !== null && _b !== void 0 ? _b : [];
+        const permalink = `page:recipes/${functionName}`;
+        const workflow = { name, permalink, functionName, scriptPath };
+        const existingIndex = workflows.findIndex((w) => w.permalink === permalink);
+        const updatedWorkflows = existingIndex === -1 ? [...workflows, workflow] : workflows.map((w, index) => (index === existingIndex ? workflow : w));
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { recipes: Object.assign(Object.assign({}, recipes), { workflows: updatedWorkflows }) }));
+    }
+}
 //# sourceMappingURL=build.js.map

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

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

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

@@ -1,5 +1,7 @@
 import { DirectoryPath } from "./file/directoryPath.js";
+import { FilePath } from "./file/filePath.js";
 import { BuildConfig } from "./build/build.js";
+import { SpecContext } from "./spec-context.js";
 export declare class BuildContext {
     private readonly fileService;
     private readonly buildDirectory;
@@ -7,7 +9,16 @@ export declare class BuildContext {
     private get buildFile();
     validate(): Promise<boolean>;
     exists(): Promise<boolean>;
+    existsSync(): boolean;
     getBuildFileContents(): Promise<BuildConfig>;
-    updateBuildFileContents(buildJson: BuildConfig): Promise<void>;
+    updateBuildFileContents(buildConfig: BuildConfig): Promise<void>;
     deleteWorkflowDir(): Promise<void>;
+    getBuildZipPath(tempDir: DirectoryPath, packageSettingsDirectory?: DirectoryPath): Promise<FilePath>;
+    getSpecContext(): SpecContext;
+    hasSdkSourceTree(language: string): Promise<boolean>;
+    getSdkSourceTree(language: string): FilePath;
+    isVersionedBuild(): Promise<boolean>;
+    getVersionedBuildDirectory(): Promise<DirectoryPath | undefined>;
+    getSingleVersionedBuildDirectory(): Promise<DirectoryPath | undefined>;
+    getSelectedVersionedBuildDirectory(versionSelector: (versions: string[]) => Promise<string | undefined>): Promise<DirectoryPath | undefined>;
 }

package/lib/types/build-context.js

@@ -1,6 +1,9 @@
 import { FileService } from "../infrastructure/file-service.js";
 import { FilePath } from "./file/filePath.js";
 import { FileName } from "./file/fileName.js";
+import { BuildConfig } from "./build/build.js";
+import { SpecContext } from "./spec-context.js";
+import { TempContext } from "./temp-context.js";
 export class BuildContext {
     constructor(buildDirectory) {
         this.fileService = new FileService();
@@ -17,17 +20,88 @@ export class BuildContext {
         return await this.fileService.fileExists(this.buildFile);
     }
     async exists() {
-        return !(await this.fileService.directoryEmpty(this.buildDirectory));
+        return await this.fileService.directoryExists(this.buildDirectory);
+    }
+    existsSync() {
+        return this.fileService.directoryExistsSync(this.buildDirectory);
     }
     async getBuildFileContents() {
         const buildFileContent = await this.fileService.getContents(this.buildFile);
-        return JSON.parse(buildFileContent);
+        return BuildConfig.parse(buildFileContent);
     }
-    async updateBuildFileContents(buildJson) {
-        await this.fileService.writeContents(this.buildFile, JSON.stringify(buildJson, null, 2));
+    async updateBuildFileContents(buildConfig) {
+        await this.fileService.writeContents(this.buildFile, JSON.stringify(buildConfig, null, 2));
     }
     async deleteWorkflowDir() {
         await this.fileService.deleteDirectory(this.buildDirectory.join(".github"));
     }
+    async getBuildZipPath(tempDir, packageSettingsDirectory) {
+        const tempContext = new TempContext(tempDir);
+        const tempBuildDir = tempDir.join("build");
+        await this.fileService.copyDirectoryContents(this.buildDirectory, tempBuildDir);
+        if (packageSettingsDirectory) {
+            await this.fileService.copyDirectoryContents(packageSettingsDirectory, tempBuildDir.join('package-settings'));
+        }
+        return await tempContext.zip(tempBuildDir);
+    }
+    getSpecContext() {
+        return new SpecContext(this.buildDirectory.join("spec"));
+    }
+    async hasSdkSourceTree(language) {
+        const sourceTreePath = FilePath.create(this.buildDirectory.join("sdk-source-tree").join(`.${language}`).toString());
+        if (!sourceTreePath) {
+            return false;
+        }
+        return await this.fileService.fileExists(sourceTreePath);
+    }
+    getSdkSourceTree(language) {
+        return FilePath.create(this.buildDirectory.join("sdk-source-tree").join(`.${language}`).toString());
+    }
+    async isVersionedBuild() {
+        if (!await this.validate()) {
+            return false;
+        }
+        return (await this.getBuildFileContents()).isVersioned();
+    }
+    async getVersionedBuildDirectory() {
+        const buildConfig = await this.getBuildFileContents();
+        if (!buildConfig.isVersioned()) {
+            return undefined;
+        }
+        const versionsDirectory = this.buildDirectory.join(buildConfig.versionsPath());
+        if (!await this.fileService.directoryExists(versionsDirectory)) {
+            return undefined;
+        }
+        const versionsDirs = await this.fileService.getSubDirectoriesPaths(versionsDirectory);
+        return versionsDirs.length > 0 ? versionsDirectory : undefined;
+    }
+    async getSingleVersionedBuildDirectory() {
+        const buildConfig = await this.getBuildFileContents();
+        if (!buildConfig.isVersioned()) {
+            return undefined;
+        }
+        const versionsDirectory = this.buildDirectory.join(buildConfig.versionsPath());
+        if (!await this.fileService.directoryExists(versionsDirectory)) {
+            return undefined;
+        }
+        const versionsDirs = await this.fileService.getSubDirectoriesPaths(versionsDirectory);
+        return versionsDirs.length === 1 ? versionsDirs[0] : undefined;
+    }
+    async getSelectedVersionedBuildDirectory(versionSelector) {
+        const buildConfig = await this.getBuildFileContents();
+        if (!buildConfig.isVersioned()) {
+            return undefined;
+        }
+        const versionsDirectory = this.buildDirectory.join(buildConfig.versionsPath());
+        if (!await this.fileService.directoryExists(versionsDirectory)) {
+            return undefined;
+        }
+        const versionsDirs = await this.fileService.getSubDirectoriesPaths(versionsDirectory);
+        const selectedVersion = await versionSelector(versionsDirs.map(dir => dir.leafName()));
+        if (!selectedVersion) {
+            return undefined;
+        }
+        return versionsDirs.find(dir => dir.leafName() === selectedVersion);
+    }
 }
 //# sourceMappingURL=build-context.js.map

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

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

package/lib/types/events/sdk-changes-saved.d.ts

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

package/lib/types/events/sdk-changes-saved.js

@@ -0,0 +1,11 @@
+import { DomainEvent } from "./domain-event.js";
+export class SdkChangesSavedEvent extends DomainEvent {
+    constructor(language) {
+        super(SdkChangesSavedEvent.message, SdkChangesSavedEvent.commandName, {});
+        this.eventName = SdkChangesSavedEvent.name;
+        this.language = language;
+    }
+}
+SdkChangesSavedEvent.message = "Save changes completed.";
+SdkChangesSavedEvent.commandName = "sdk:save-changes";
+//# sourceMappingURL=sdk-changes-saved.js.map

package/lib/types/events/sdk-changes-saved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-changes-saved.js","sourceRoot":"","sources":["../../../src/types/events/sdk-changes-saved.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAMnD,YAAY,QAAgB;QAC1B,KAAK,CAAC,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QANzD,cAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC;QAOvD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;;AAPuB,4BAAO,GAAG,yBAAkC,AAArC,CAAsC;AAC7C,gCAAW,GAAG,kBAA2B,AAA9B,CAA+B"}

package/lib/types/events/sdk-changes-tracked.d.ts

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

package/lib/types/events/sdk-changes-tracked.js

@@ -0,0 +1,11 @@
+import { DomainEvent } from "./domain-event.js";
+export class SdkChangesTrackedEvent extends DomainEvent {
+    constructor(language) {
+        super(SdkChangesTrackedEvent.message, SdkChangesTrackedEvent.commandName, {});
+        this.eventName = SdkChangesTrackedEvent.name;
+        this.language = language;
+    }
+}
+SdkChangesTrackedEvent.message = "SDK generated with track changes enabled.";
+SdkChangesTrackedEvent.commandName = "sdk:generate";
+//# sourceMappingURL=sdk-changes-tracked.js.map

package/lib/types/events/sdk-changes-tracked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-changes-tracked.js","sourceRoot":"","sources":["../../../src/types/events/sdk-changes-tracked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IAMrD,YAAY,QAAgB;QAC1B,KAAK,CAAC,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAN7D,cAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC;QAOzD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;;AAPuB,8BAAO,GAAG,2CAAoD,AAAvD,CAAwD;AAC/D,kCAAW,GAAG,cAAuB,AAA1B,CAA2B"}

package/lib/types/events/sdk-conflicts-resolved.d.ts

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

package/lib/types/events/sdk-conflicts-resolved.js

@@ -0,0 +1,11 @@
+import { DomainEvent } from "./domain-event.js";
+export class SdkConflictsResolvedEvent extends DomainEvent {
+    constructor(language) {
+        super(SdkConflictsResolvedEvent.message, SdkConflictsResolvedEvent.commandName, {});
+        this.eventName = SdkConflictsResolvedEvent.name;
+        this.language = language;
+    }
+}
+SdkConflictsResolvedEvent.message = "SDK merge conflicts resolved.";
+SdkConflictsResolvedEvent.commandName = "sdk:generate";
+//# sourceMappingURL=sdk-conflicts-resolved.js.map

package/lib/types/events/sdk-conflicts-resolved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-conflicts-resolved.js","sourceRoot":"","sources":["../../../src/types/events/sdk-conflicts-resolved.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IAMxD,YAAY,QAAgB;QAC1B,KAAK,CAAC,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QANnE,cAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC;QAO5D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;;AAPuB,iCAAO,GAAG,+BAAwC,AAA3C,CAA4C;AACnD,qCAAW,GAAG,cAAuB,AAA1B,CAA2B"}

package/lib/types/events/sdk-publish-validation-failed.d.ts

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

package/lib/types/events/sdk-publish-validation-failed.js

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

package/lib/types/events/sdk-publish-validation-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-publish-validation-failed.js","sourceRoot":"","sources":["../../../src/types/events/sdk-publish-validation-failed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,+BAAgC,SAAQ,WAAW;IAG9D,YAAY,OAAe,EAAE,WAAmB,EAAE,KAA8B;QAC9E,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAHlB,cAAS,GAAG,+BAA+B,CAAC,IAAI,CAAC;IAIpE,CAAC;CACF"}

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

@@ -1,8 +1,13 @@
 import { DirectoryPath } from "./directoryPath.js";
 import { FileName } from "./fileName.js";
 import { TocGroup } from "../toc/toc.js";
+import { FilePath } from "./filePath.js";
 import { TreeNode } from "../../prompts/format.js";
-export type DirectoryItem = FileName | Directory;
+export type FileItem = {
+    fileName: FileName;
+    description?: string;
+};
+export type DirectoryItem = FileItem | Directory;
 export declare class Directory {
     readonly directoryPath: DirectoryPath;
     readonly items: DirectoryItem[];
@@ -11,7 +16,11 @@ export declare class Directory {
     private static readonly folderDescriptions;
     private static readonly fileDescriptions;
     toTreeNode(): TreeNode;
+    mapFilesInDirectory(map: (rootDir: DirectoryPath, fileItem: FileItem) => Promise<FileItem | undefined>): Promise<Directory>;
+    isEmpty(): boolean;
+    getAllFiles(): FilePath[];
     parseContentFolder(baseContentPath: DirectoryPath): Promise<TocGroup[]>;
     private getPageName;
     private isRootContentDirectory;
+    static createFromRelativePaths(rootDir: DirectoryPath, fileItems: FileItem[]): Directory;
 }