@apimatic/cli 1.1.0-beta.10 → 1.1.0-beta.13

package/lib/prompts/sdk/publish/interactive.js

@@ -0,0 +1,139 @@
+import { confirm, isCancel, log, select, text } from '@clack/prompts';
+import { format as f } from '../../../prompts/format.js';
+import { noteWrapped, withSpinner } from '../../prompt.js';
+import { DirectoryPath } from '../../../types/file/directoryPath.js';
+import { PublishType } from '../../../types/publish-api/publishing-profile-item.js';
+import { SemVersion } from '../../../types/publish/version.js';
+import { removeQuotes } from '../../../utils/string-utils.js';
+export class SdkPublishInteractivePrompts {
+    async inputWorkingDirectory(defaultDirectory, validator) {
+        const value = await text({
+            message: `Enter the path to the directory containing the ${f.var('src')} folder:`,
+            placeholder: defaultDirectory.toString(),
+            defaultValue: defaultDirectory.toString(),
+            validate: validator
+        });
+        if (isCancel(value)) {
+            return undefined;
+        }
+        return new DirectoryPath(removeQuotes(value.trim()));
+    }
+    async noInputDirectoryProvided() {
+        log.error('No input directory was provided.');
+    }
+    srcDirectoryInvalid(directory) {
+        log.error(`${f.path(directory)} does not contain a valid ${f.var('APIMATIC-BUILD.json')}. Please check the path and try again.`);
+    }
+    async inputSdkDirectory(defaultDirectory, validator) {
+        const value = await text({
+            message: 'Enter the destination path for the generated SDK:',
+            placeholder: defaultDirectory.toString(),
+            defaultValue: defaultDirectory.toString(),
+            validate: validator
+        });
+        if (isCancel(value)) {
+            return undefined;
+        }
+        return new DirectoryPath(removeQuotes(value.trim()));
+    }
+    sdkDirectoryCannotBeSameAsBuildDirectory() {
+        log.error(`SDK directory must be different from the ${f.var('src')} directory.`);
+    }
+    async noSdkDirectoryProvided() {
+        log.error('No SDK directory was provided.');
+    }
+    async getPublishingProfiles(fn) {
+        return withSpinner('Searching for publishing profiles', 'Profile search complete.', 'Failed to fetch publishing profiles.', fn);
+    }
+    getPublishingProfilesServiceError(serviceError) {
+        log.error(serviceError.errorMessage);
+    }
+    noPublishingProfilesFound(errorMessage) {
+        log.error(errorMessage);
+    }
+    noProfileWithEnabledLanguagesFound() {
+        log.error('No publishing profiles found with languages enabled for Source Code Publishing or Package Publishing. Please enable at least one language in a publishing profile before publishing an SDK.');
+    }
+    async selectPublishingProfile(groups) {
+        const publishingProfile = await select({
+            message: 'Select a publishing profile:',
+            options: groups.flatMap((group) => group.profiles.map(({ profile, enabledLanguages }) => ({
+                value: profile,
+                hint: group.apiGroupName,
+                label: `${profile.name} | ${enabledLanguages.join(', ')} | ID: ${profile.id}`
+            })))
+        });
+        if (isCancel(publishingProfile)) {
+            return undefined;
+        }
+        return publishingProfile;
+    }
+    noPublishingProfileSelected() {
+        log.error('No publishing profile was selected.');
+    }
+    async selectLanguage(publishingProfile) {
+        const options = publishingProfile.getEnabledLanguages().map((language) => ({
+            value: language,
+            label: `${language} (${publishingProfile
+                .getPublishTypesForLanguage(language)
+                .map((t) => (t === PublishType.PackagePublishing ? 'Package' : 'Source Code'))
+                .join(' + ')})`
+        }));
+        const language = await select({
+            message: 'Select a language to publish:',
+            options
+        });
+        if (isCancel(language)) {
+            return undefined;
+        }
+        return language;
+    }
+    noLanguageSelected() {
+        log.error('No language was selected for publishing.');
+    }
+    async inputVersion() {
+        const version = await text({
+            message: 'Enter version to publish (e.g. 1.0.0):',
+            validate: (value) => {
+                if (!value)
+                    return 'Version is required.';
+                if (SemVersion.tryCreate(value).isErr())
+                    return 'Please enter a valid version in the format major.minor.patch (e.g., 1.0.0).';
+            }
+        });
+        if (isCancel(version)) {
+            return undefined;
+        }
+        const versionResult = SemVersion.tryCreate(version);
+        if (versionResult.isErr())
+            return undefined;
+        return versionResult.value;
+    }
+    noVersionSpecified() {
+        log.error('No version was specified for publishing the SDK.');
+    }
+    publishingSummary(profile, language, version, publishType) {
+        const targets = publishType
+            .map((t) => (t === PublishType.PackagePublishing ? 'Package' : 'Source Code'))
+            .join(' + ');
+        log.info(`Ready to publish:\n\n  Profile:   ${profile}\n  Language:  ${language}\n  Version:   ${version}\n  Targets:   ${targets}`);
+    }
+    async confirmPublishing() {
+        const result = await confirm({ message: 'Do you want to proceed?' });
+        if (isCancel(result))
+            return false;
+        return result;
+    }
+    publishingCancelled() {
+        log.error('Publishing cancelled.');
+    }
+    sourceCodeOnlyPublishingNotice() {
+        log.info('Version tags will not be created in your Git repository because you have opted to publish Source Code only.');
+    }
+    sdkPublishingInProgress(publishingLogUrl) {
+        const message = `To view the status of publishing, please visit: 
+${f.link(publishingLogUrl)}`;
+        noteWrapped(message, 'Next Steps');
+    }
+}
+//# sourceMappingURL=interactive.js.map

package/lib/prompts/sdk/publish/interactive.js.map

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

package/lib/prompts/sdk/publish/non-interactive.d.ts

@@ -0,0 +1,27 @@
+import { Result } from 'neverthrow';
+import { PublishType } from '../../../types/publish-api/publishing-profile-item.js';
+import { SemVersion } from '../../../types/publish/version.js';
+import { DirectoryPath } from '../../../types/file/directoryPath.js';
+import { ServiceError } from '../../../infrastructure/service-error.js';
+import { PublishingProfileItem } from '../../../types/publish-api/publishing-profile-item.js';
+import { PublishLogItem } from '../../../types/publish-api/publish-log.js';
+import { ProfileId } from '../../../types/publish/profile-id.js';
+import { PublishingProfile } from '../../../types/publish/publishing-profile.js';
+import { Language } from '../../../types/sdk/generate.js';
+export declare class SdkPublishNonInteractivePrompts {
+    directoryCannotBeSame(directory: DirectoryPath): void;
+    srcDirectoryDoesNotExist(directory: DirectoryPath): void;
+    missingRequiredFlags(options: string[]): void;
+    interactiveModeNotice(): void;
+    invalidVersion(version: string): void;
+    invalidProfileId(profileId: string): void;
+    getPublishingProfiles(fn: Promise<Result<PublishingProfileItem[], ServiceError>>): Promise<Result<PublishingProfileItem[], ServiceError>>;
+    getPublishingProfilesServiceError(serviceError: ServiceError): void;
+    publishingProfileNotFound(profileId: ProfileId): void;
+    languageNotConfiguredForProfile(language: Language): void;
+    publishTypesNotAvailableForLanguage(publishTypes: PublishType[], language: Language): void;
+    sourceCodeOnlyPublishingNotice(): void;
+    publishingRunningNotice(profile: PublishingProfile, language: Language, version: SemVersion, publishType: PublishType[]): void;
+    postPublishingMessage(publishingLogUrl: string): void;
+    pollPublishingStatus(getSdkPublishingLogFn: () => Promise<Result<PublishLogItem, ServiceError>>): Promise<boolean>;
+}

package/lib/prompts/sdk/publish/non-interactive.js

@@ -0,0 +1,97 @@
+import { log, spinner } from '@clack/prompts';
+import { PublishType } from '../../../types/publish-api/publishing-profile-item.js';
+import { format as f } from '../../../prompts/format.js';
+import { noteWrapped, withSpinner } from '../../prompt.js';
+export class SdkPublishNonInteractivePrompts {
+    directoryCannotBeSame(directory) {
+        const message = `The ${f.var('src')} and ${f.var('sdk')} directories must be different. Current value: ${f.path(directory)}`;
+        log.error(message);
+    }
+    srcDirectoryDoesNotExist(directory) {
+        log.error(`The ${f.var('src')} does not exist at the provided location: ${f.path(directory)}`);
+    }
+    missingRequiredFlags(options) {
+        const message = `Missing required flag(s): ${options.join(', ')}`;
+        log.error(message);
+    }
+    interactiveModeNotice() {
+        log.info('You can run the command in interactive mode by not passing any flags.');
+    }
+    invalidVersion(version) {
+        log.error(`Invalid version '${version}'. Please provide a valid version in the format major.minor.patch (e.g., 1.0.0).`);
+    }
+    invalidProfileId(profileId) {
+        log.error(`Invalid profile id '${profileId}' provided. Please provide a valid profile id.`);
+    }
+    async getPublishingProfiles(fn) {
+        return withSpinner('Searching for publishing profile', 'Profile search complete.', 'Failed to search for publishing profile.', fn);
+    }
+    getPublishingProfilesServiceError(serviceError) {
+        log.error(serviceError.errorMessage);
+    }
+    publishingProfileNotFound(profileId) {
+        log.error(`Publishing profile with id '${profileId}' not found. Please check if the provided profile id is correct or create a new publishing profile on the APIMatic App.`);
+    }
+    languageNotConfiguredForProfile(language) {
+        log.error(`No configuration found for '${language}' in the selected publishing profile. Please check the provided profile's configuration on the APIMatic App and try again.`);
+    }
+    publishTypesNotAvailableForLanguage(publishTypes, language) {
+        const types = [...publishTypes]
+            .sort((a, b) => (a === PublishType.SourceCodePublishing ? -1 : b === PublishType.SourceCodePublishing ? 1 : 0))
+            .join(' + ');
+        const noun = publishTypes.length === 1 ? 'type' : 'types';
+        log.error(`Publish ${noun} '${types}' not found or not enabled for '${language}' in the selected publishing profile. Please check your profile configuration on the APIMatic App and try again.`);
+    }
+    sourceCodeOnlyPublishingNotice() {
+        log.info('Version tags will not be created in your Git repository because you have opted to publish Source Code only.');
+    }
+    publishingRunningNotice(profile, language, version, publishType) {
+        const targets = [...publishType]
+            .sort((a, b) => (a === PublishType.SourceCodePublishing ? -1 : b === PublishType.SourceCodePublishing ? 1 : 0))
+            .map((t) => (t === PublishType.PackagePublishing ? 'Package' : 'Source Code'))
+            .join(' + ');
+        log.info(`Publishing is running for the following:\n\n  Profile:   ${profile}\n  Language:  ${language}\n  Version:   ${version}\n  Targets:   ${targets}`);
+    }
+    postPublishingMessage(publishingLogUrl) {
+        const message = `To view publishing logs, please visit:
+${f.link(publishingLogUrl)}`;
+        noteWrapped(message, 'Next Steps');
+    }
+    async pollPublishingStatus(getSdkPublishingLogFn) {
+        const TERMINAL_STATES = new Set(['Succeeded', 'Failed', 'Exception', 'InternalError']);
+        const POLL_INTERVAL_MS = 10000; // poll after every 10 seconds.
+        const spin = spinner();
+        spin.start('Waiting for publishing status...');
+        while (true) {
+            const publishingLogResult = await getSdkPublishingLogFn();
+            if (publishingLogResult.isErr()) {
+                spin.stop('Failed to fetch publishing status.', 1);
+                return false;
+            }
+            const { events } = publishingLogResult.value;
+            const executionCompleted = events.every((event) => TERMINAL_STATES.has(event.eventType));
+            const statusMessage = [...events]
+                .sort((a, b) => (a.publishType === 'SourceCode' ? -1 : b.publishType === 'SourceCode' ? 1 : 0))
+                .map((event) => {
+                var _a;
+                const target = event.publishType === 'SourceCode' ? 'Source Code' : 'Package';
+                const eventLabels = {
+                    Queued: 'Queued',
+                    InProgress: 'In Progress',
+                    Succeeded: 'Published'
+                };
+                const label = (_a = eventLabels[event.eventType]) !== null && _a !== void 0 ? _a : 'Failed';
+                return `${target}: [${label}]`;
+            })
+                .join(' | ');
+            if (executionCompleted) {
+                const isExecutionSuccessful = events.every((event) => event.eventType === 'Succeeded');
+                spin.stop(statusMessage, isExecutionSuccessful ? 0 : 1);
+                return isExecutionSuccessful;
+            }
+            spin.message(statusMessage);
+            await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+        }
+    }
+}
+//# sourceMappingURL=non-interactive.js.map

package/lib/prompts/sdk/publish/non-interactive.js.map

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

package/lib/prompts/sdk/publish.d.ts

@@ -0,0 +1,12 @@
+import { Result } from 'neverthrow';
+import { ServiceError } from '../../infrastructure/service-error.js';
+import { PublishingInfo } from '../../types/publish-api/publishing-info.js';
+import { PublishType } from '../../types/publish-api/publishing-profile-item.js';
+import { SemVersion } from '../../types/publish/version.js';
+import { Language } from '../../types/sdk/generate.js';
+import { PublishingProfile } from '../../types/publish/publishing-profile.js';
+export declare class SdkPublishPrompts {
+    publishSdk(fn: Promise<Result<PublishingInfo, ServiceError>>): Promise<Result<PublishingInfo, ServiceError>>;
+    sdkPublishingServiceError(serviceError: ServiceError): void;
+    dryRunNotice(publishingProfile: PublishingProfile, language: Language, version: SemVersion, publishType: PublishType[]): void;
+}

package/lib/prompts/sdk/publish.js

@@ -0,0 +1,16 @@
+import { log } from '@clack/prompts';
+import { PublishType } from '../../types/publish-api/publishing-profile-item.js';
+import { withSpinner } from '../prompt.js';
+export class SdkPublishPrompts {
+    publishSdk(fn) {
+        return withSpinner('Publishing SDK', 'Publishing initiated.', 'SDK Publishing failed.', fn);
+    }
+    sdkPublishingServiceError(serviceError) {
+        log.error(serviceError.errorMessage);
+    }
+    dryRunNotice(publishingProfile, language, version, publishType) {
+        const targets = publishType.map((t) => (t === PublishType.PackagePublishing ? 'Package' : 'Source Code')).join(' + ');
+        log.info(`You can publish this SDK by removing the --dry-run flag. It will be published for the following:\n\n  Profile:   ${publishingProfile}\n  Language:  ${language}\n  Version:   ${version}\n  Targets:   ${targets}`);
+    }
+}
+//# sourceMappingURL=publish.js.map

package/lib/prompts/sdk/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/prompts/sdk/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAIrC,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,OAAO,iBAAiB;IACrB,UAAU,CAAC,EAAiD;QACjE,OAAO,WAAW,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAEM,yBAAyB,CAAC,YAA0B;QACzD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAEM,YAAY,CAAC,iBAAoC,EAAE,QAAkB,EAAE,OAAmB,EAAE,WAA0B;QAC3H,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtH,GAAG,CAAC,IAAI,CACN,oHAAoH,iBAAiB,kBAAkB,QAAQ,kBAAkB,OAAO,kBAAkB,OAAO,EAAE,CACpN,CAAC;IACJ,CAAC;CACF"}

package/lib/prompts/sdk/save-changes.d.ts

@@ -0,0 +1,21 @@
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { FilePath } from "../../types/file/filePath.js";
+import { Directory } from "../../types/file/directory.js";
+export declare class SaveChangesPrompts {
+    srcDirectoryEmpty(directory: DirectoryPath): void;
+    invalidSdkDirectory(directory: DirectoryPath): void;
+    invalidVersionedDocsDirectory(directory: DirectoryPath): void;
+    apiVersionOnlyApplicableWithVersionedBuild(): void;
+    versionNotFound(): void;
+    selectVersion(versions: string[]): Promise<string | undefined>;
+    sdkSourceTreeNotFound(language: string): void;
+    operationCancelled(): void;
+    directoryStillOpen(directory: DirectoryPath): Promise<void>;
+    modifiedFilesDetected(directory: Directory): void;
+    confirmReviewChanges(): Promise<boolean>;
+    noChangesDetected(): void;
+    openingDirectoryToReviewChanges(): void;
+    reviewChangesManually(tempDirectory: DirectoryPath): Promise<void>;
+    confirmSaveChanges(): Promise<boolean>;
+    changesSaved(sourceTreePath: FilePath): void;
+}

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,6 +1,8 @@
 import { DirectoryPath } from "../file/directoryPath.js";
 export interface BuildConfig {
     generatePortal?: PortalConfig;
+    generateVersionedPortal?: object;
+    versionsPath?: string;
     apiCopilotConfig?: CopilotConfig;
     [key: string]: unknown;
 }

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":"AAuBA,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

@@ -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>;
     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,8 @@
 import { FileService } from "../infrastructure/file-service.js";
 import { FilePath } from "./file/filePath.js";
 import { FileName } from "./file/fileName.js";
+import { SpecContext } from "./spec-context.js";
+import { TempContext } from "./temp-context.js";
 export class BuildContext {
     constructor(buildDirectory) {
         this.fileService = new FileService();
@@ -17,7 +19,10 @@ 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);
@@ -29,5 +34,80 @@ export class BuildContext {
     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.join('package-settings'), 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;
+        }
+        const buildConfig = await this.getBuildFileContents();
+        if (buildConfig.generateVersionedPortal) {
+            return true;
+        }
+        return false;
+    }
+    async getVersionedBuildDirectory() {
+        var _a;
+        const buildConfig = await this.getBuildFileContents();
+        if (!buildConfig.generateVersionedPortal) {
+            return undefined;
+        }
+        const versionsDirectory = this.buildDirectory.join((_a = buildConfig.versionsPath) !== null && _a !== void 0 ? _a : 'versioned_docs');
+        if (!await this.fileService.directoryExists(versionsDirectory)) {
+            return undefined;
+        }
+        const versionsDirs = await this.fileService.getSubDirectoriesPaths(versionsDirectory);
+        return versionsDirs.length > 0 ? versionsDirectory : undefined;
+    }
+    async getSingleVersionedBuildDirectory() {
+        var _a;
+        const buildConfig = await this.getBuildFileContents();
+        if (!buildConfig.generateVersionedPortal) {
+            return undefined;
+        }
+        const versionsDirectory = this.buildDirectory.join((_a = buildConfig.versionsPath) !== null && _a !== void 0 ? _a : 'versioned_docs');
+        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) {
+        var _a;
+        const buildConfig = await this.getBuildFileContents();
+        if (!buildConfig.generateVersionedPortal) {
+            return undefined;
+        }
+        const versionsDirectory = this.buildDirectory.join((_a = buildConfig.versionsPath) !== null && _a !== void 0 ? _a : 'versioned_docs');
+        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);
+}