@forge/cli 10.13.3-next.10 → 10.13.4-next.1-experimental-19bd64d

package/out/command-line/register-version-commands.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommands = exports.parseMajorVersion = void 0;
+const cli_shared_1 = require("@forge/cli-shared");
+function parseMajorVersion(majorVersionStr, property) {
+    if (!/^\d+$/.test(majorVersionStr)) {
+        throw new cli_shared_1.ValidationError(cli_shared_1.Text.version.check.error.invalidMajorVersion(property));
+    }
+    return parseInt(majorVersionStr, 10);
+}
+exports.parseMajorVersion = parseMajorVersion;
+const registerDetailsCommands = (parent, { controllers: { versionController } }) => {
+    parent
+        .command(cli_shared_1.Text.version.check.cmdName)
+        .description(cli_shared_1.Text.version.check.desc)
+        .requireAppId()
+        .environmentOption()
+        .nonInteractiveOption()
+        .option('-v, --major-version [version]', cli_shared_1.Text.version.check.option.majorVersion)
+        .option('--json', cli_shared_1.Text.version.check.option.json)
+        .option('-f, --out-file [outFile]', cli_shared_1.Text.version.check.option.outFile)
+        .action(async ({ environment, majorVersion, json, outFile, nonInteractive }) => {
+        const majorVersionInt = majorVersion ? parseMajorVersion(majorVersion) : undefined;
+        await versionController.getAppVersionDetails({
+            environment,
+            majorVersion: majorVersionInt,
+            json,
+            outFile,
+            nonInteractive
+        });
+    });
+};
+const registerListCommands = (parent, { controllers: { versionController } }) => {
+    parent
+        .command(cli_shared_1.Text.version.list.cmdName)
+        .description(cli_shared_1.Text.version.list.desc)
+        .requireAppId()
+        .environmentOption()
+        .nonInteractiveOption()
+        .option('--json', cli_shared_1.Text.version.list.option.json)
+        .option('-f, --out-file [outFile]', cli_shared_1.Text.version.list.option.outFile)
+        .action(async ({ environment, json, outFile, nonInteractive }) => {
+        await versionController.getVersionList({ environment, json, outFile, nonInteractive });
+    });
+};
+const registerDiffCommands = (parent, { controllers: { versionController } }) => {
+    parent
+        .command(cli_shared_1.Text.version.diff.cmdName)
+        .description(cli_shared_1.Text.version.diff.desc)
+        .requireAppId()
+        .environmentOption()
+        .nonInteractiveOption()
+        .option('-v1, --version1 [version]', cli_shared_1.Text.version.diff.option.version1)
+        .option('-v2, --version2 [version]', cli_shared_1.Text.version.diff.option.version2)
+        .option('-f, --out-file [outFile]', cli_shared_1.Text.version.diff.option.outFile)
+        .action(async ({ environment, version1, version2, outFile }) => {
+        if (!version1 || !version2) {
+            throw new cli_shared_1.ValidationError(cli_shared_1.Text.version.diff.error.noVersionProvided);
+        }
+        const version1Int = parseMajorVersion(version1, '--version1');
+        const version2Int = parseMajorVersion(version2, '--version2');
+        await versionController.getAppVersionDiff({ environment, version1: version1Int, version2: version2Int, outFile });
+    });
+};
+const registerCommands = (deps) => {
+    const { cmd } = deps;
+    const version = cmd.command(cli_shared_1.Text.version.cmd.cmdName).description(cli_shared_1.Text.version.cmd.desc);
+    registerDetailsCommands(version, deps);
+    registerDiffCommands(version, deps);
+    registerListCommands(version, deps);
+};
+exports.registerCommands = registerCommands;

package/out/command-line/view/version-view.d.ts

@@ -0,0 +1,26 @@
+import { AppEnvironmentType, UI } from '@forge/cli-shared';
+import { VersionDetails, VersionOverview } from '../../service/version-service';
+import { Change } from 'diff';
+export declare class VersionView {
+    private readonly ui;
+    constructor(ui: UI);
+    displayDetailsProgress(progress: () => Promise<VersionDetails>): Promise<VersionDetails>;
+    displayDiffProgress(progress: () => Promise<VersionDetails[]>): Promise<VersionDetails[]>;
+    displayListProgress(progress: () => Promise<VersionOverview[]>): Promise<VersionOverview[]>;
+    promptVersionDetailsProperties(): Promise<(keyof VersionDetails)[]>;
+    displayVersionDetailsBanner(appVersion: number, envKey: string, envType: AppEnvironmentType): void;
+    displayDetailsAsTable(details: VersionDetails): void;
+    displayDataInJson(data: VersionDetails): void;
+    displayDiffBanner(version1: number, version2: number, envKey: string, envType: AppEnvironmentType): void;
+    displayDiffAsTable(versions: {
+        v1: number;
+        v2: number;
+    }, input: {
+        key: string;
+        diff: Change[];
+    }[]): void;
+    displayListBanner(versions: number, envKey: string, envType: AppEnvironmentType): void;
+    displayWriteToFile(outFile: string): void;
+    displayVersionList(data: VersionOverview[]): void;
+}
+//# sourceMappingURL=version-view.d.ts.map

package/out/command-line/view/version-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-view.d.ts","sourceRoot":"","sources":["../../../src/command-line/view/version-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAQ,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAG9B,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,EAAE;IAEtB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxF,mBAAmB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzF,mBAAmB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI3F,8BAA8B,IAAI,OAAO,CAAC,CAAC,MAAM,cAAc,CAAC,EAAE,CAAC;IAsDzE,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMlG,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA0DpD,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAI7C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMxG,kBAAkB,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GAAG,IAAI;IAkCxG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMtF,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzC,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,IAAI;CAwBzD"}

package/out/command-line/view/version-view.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionView = void 0;
+const tslib_1 = require("tslib");
+const cli_shared_1 = require("@forge/cli-shared");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+class VersionView {
+    ui;
+    constructor(ui) {
+        this.ui = ui;
+    }
+    async displayDetailsProgress(progress) {
+        return this.ui.displayProgress(progress, cli_shared_1.Text.version.check.start, cli_shared_1.Text.version.check.end);
+    }
+    async displayDiffProgress(progress) {
+        return this.ui.displayProgress(progress, cli_shared_1.Text.version.diff.start, cli_shared_1.Text.version.diff.end);
+    }
+    async displayListProgress(progress) {
+        return this.ui.displayProgress(progress, cli_shared_1.Text.version.list.start, cli_shared_1.Text.version.list.end);
+    }
+    async promptVersionDetailsProperties() {
+        const propsOptions = [
+            {
+                names: ['License', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.license],
+                property: 'requiresLicense'
+            },
+            {
+                names: ['Scopes', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.scopes],
+                property: 'scopes'
+            },
+            {
+                names: ['Egress', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.egress],
+                property: 'egresses'
+            },
+            {
+                names: ['Policies', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.policies],
+                property: 'policies'
+            },
+            {
+                names: ['Connect Key', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.connectKeys],
+                property: 'connectKeys'
+            },
+            {
+                names: ['Functions', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.functions],
+                property: 'functions'
+            },
+            {
+                names: ['Modules', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.modules],
+                property: 'modules'
+            },
+            {
+                names: ['Remotes', cli_shared_1.Text.version.check.details.prompt.properties.descriptions.remotes],
+                property: 'remotes'
+            }
+        ];
+        const allOrNot = await this.ui.promptForList(cli_shared_1.Text.version.check.details.prompt.options.banner, [
+            cli_shared_1.Text.version.check.details.prompt.options.choices.all,
+            cli_shared_1.Text.version.check.details.prompt.options.choices.manual
+        ]);
+        if (allOrNot === cli_shared_1.Text.version.check.details.prompt.options.choices.manual) {
+            const choices = await this.ui.promptForTable(cli_shared_1.Text.version.check.details.prompt.properties.banner, cli_shared_1.Text.version.check.details.prompt.properties.info, cli_shared_1.Text.version.check.details.prompt.properties.headers, propsOptions);
+            return choices.map((index) => propsOptions[index].property);
+        }
+        return [];
+    }
+    displayVersionDetailsBanner(appVersion, envKey, envType) {
+        this.ui.emptyLine();
+        this.ui.info(cli_shared_1.Text.version.check.details.banner(envKey, envType, appVersion));
+        this.ui.emptyLine();
+    }
+    displayDetailsAsTable(details) {
+        this.ui.table([
+            ['entry', 'Property'],
+            ['details', 'Details']
+        ], [
+            {
+                entry: 'deployment date',
+                details: cli_shared_1.Text.version.check.details.deploymentDate(details.deploymentDateTime),
+                property: 'deploymentDateTime'
+            },
+            {
+                entry: 'functions',
+                details: cli_shared_1.Text.version.check.details.functions(details.functions || []),
+                property: 'functions'
+            },
+            {
+                entry: 'modules',
+                details: cli_shared_1.Text.version.check.details.modules(details.modules || []),
+                property: 'modules'
+            },
+            {
+                entry: 'license',
+                details: cli_shared_1.Text.version.check.details.license(details.requiresLicense),
+                property: 'requiresLicense'
+            },
+            {
+                entry: 'scopes',
+                details: cli_shared_1.Text.version.check.details.scopes(details.scopes || []),
+                property: 'scopes'
+            },
+            {
+                entry: 'egress',
+                details: cli_shared_1.Text.version.check.details.egress(details.egresses || []),
+                property: 'egresses'
+            },
+            {
+                entry: 'policies',
+                details: cli_shared_1.Text.version.check.details.securityPolicies(details.policies || []),
+                property: 'policies'
+            },
+            {
+                entry: 'connect keys',
+                details: cli_shared_1.Text.version.check.details.connectKeys(details.connectKeys || []),
+                property: 'connectKeys'
+            },
+            {
+                entry: 'remotes',
+                details: cli_shared_1.Text.version.check.details.remotes(details.remotes || []),
+                property: 'remotes'
+            }
+        ]
+            .sort((a, b) => a.entry.localeCompare(b.entry))
+            .filter(({ property }) => Object.keys(details).includes(property)));
+    }
+    displayDataInJson(data) {
+        this.ui.info(JSON.stringify(data, null, 2));
+    }
+    displayDiffBanner(version1, version2, envKey, envType) {
+        this.ui.emptyLine();
+        this.ui.info(cli_shared_1.Text.version.diff.details.banner(envKey, envType, version1, version2));
+        this.ui.emptyLine();
+    }
+    displayDiffAsTable(versions, input) {
+        this.ui.table([
+            ['entry', 'Property'],
+            ['v1', `Version 1 [${versions.v1}]`],
+            ['v2', `Version 2 [${versions.v2}]`]
+        ], input
+            .filter(({ diff }) => diff.filter((change) => change.added || change.removed).length > 0)
+            .map(({ key, diff }) => ({
+            entry: key,
+            v1: diff
+                .filter((change) => !change.added)
+                .map((change) => {
+                if (!change.removed) {
+                    return chalk_1.default.gray(change.value);
+                }
+                return change.value;
+            })
+                .join(''),
+            v2: diff
+                .filter((change) => !change.removed)
+                .map((change) => {
+                if (!change.added) {
+                    return chalk_1.default.gray(change.value);
+                }
+                return change.value;
+            })
+                .join('')
+        }))
+            .sort((a, b) => a.entry.localeCompare(b.entry)));
+    }
+    displayListBanner(versions, envKey, envType) {
+        this.ui.emptyLine();
+        this.ui.info(cli_shared_1.Text.version.list.details.banner(envKey, envType, versions));
+        this.ui.emptyLine();
+    }
+    displayWriteToFile(outFile) {
+        this.ui.info(cli_shared_1.Text.version.check.details.writeToFile(outFile));
+    }
+    displayVersionList(data) {
+        this.ui.table([
+            ['version', 'Major Versions'],
+            ['deploymentDate', 'Deployment Date'],
+            ['egresses', 'Egress'],
+            ['policies', 'Policies'],
+            ['scopes', 'Scopes'],
+            ['connectKeys', 'Connect keys'],
+            ['functions', 'Functions'],
+            ['remotes', 'Remotes'],
+            ['modules', 'Modules'],
+            ['requiresLicense', 'License']
+        ], data.map(({ version, egresses, modules, policies, deploymentDateTime, ...rest }) => ({
+            ...rest,
+            version: version.toString(),
+            deploymentDate: cli_shared_1.Text.version.list.details.deploymentDate(deploymentDateTime),
+            egresses: cli_shared_1.Text.version.list.details.egresses(egresses),
+            policies: cli_shared_1.Text.version.list.details.policies(policies),
+            modules: cli_shared_1.Text.version.list.details.modules(modules)
+        })));
+    }
+}
+exports.VersionView = VersionView;

package/out/service/version-service.d.ts

@@ -0,0 +1,74 @@
+import { AppConfigProvider, AppEnvironmentType } from '@forge/cli-shared';
+import { AppVersionDetailsClient } from '../version/graphql-client';
+export interface VersionDetails {
+    appVersion: number;
+    deploymentDateTime: Date;
+    environmentType: AppEnvironmentType;
+    functions: {
+        key: string;
+        runtimeName: string;
+        regions: string[];
+        handler: string;
+    }[] | undefined;
+    modules: {
+        type: string;
+        items: {
+            key: string;
+            properties: any;
+        }[];
+    }[];
+    requiresLicense: boolean;
+    egresses: {
+        type: string;
+        addresses: string[];
+    }[];
+    scopes: string[];
+    policies: {
+        type: string;
+        policies: string[];
+    }[];
+    connectKeys: {
+        product: string;
+        key: string;
+    }[] | undefined;
+    remotes: {
+        key: string;
+        baseUrl: string;
+        operations: string[];
+    }[] | undefined;
+}
+export interface VersionOverview {
+    version: number;
+    deploymentDateTime: Date;
+    environmentType: AppEnvironmentType;
+    egresses: {
+        type: string;
+        count: number;
+    }[];
+    policies: {
+        type: string;
+        count: number;
+    }[];
+    scopes: string;
+    connectKeys: string;
+    functions: string;
+    remotes: string;
+    modules: {
+        type: string;
+        count: number;
+    }[];
+    requiresLicense: boolean;
+}
+export declare class VersionService {
+    private readonly getAppConfig;
+    private readonly versionDetailsClient;
+    constructor(getAppConfig: AppConfigProvider, versionDetailsClient: AppVersionDetailsClient);
+    private getMajorVersion;
+    getAppVersionDetails(environmentKey: string, majorVersion?: number): Promise<VersionDetails>;
+    private getTypeFromPermissionType;
+    private getModulesGroupedByTypes;
+    private removeInternalPropertiesFromObject;
+    private getAppVersions;
+    getAppVersionOverviewList(environmentKey: string): Promise<VersionOverview[]>;
+}
+//# sourceMappingURL=version-service.d.ts.map

package/out/service/version-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-service.d.ts","sourceRoot":"","sources":["../../src/service/version-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAInB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,IAAI,CAAC;IACzB,eAAe,EAAE,kBAAkB,CAAC;IACpC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;IAClG,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,GAAG,CAAA;SAAE,EAAE,CAAA;KAAE,EAAE,CAAC;IACvE,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjD,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;IAC5D,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;CAC/E;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,IAAI,CAAC;IACzB,eAAe,EAAE,kBAAkB,CAAC;IACpC,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBADpB,YAAY,EAAE,iBAAiB,EAC/B,oBAAoB,EAAE,uBAAuB;IAGhE,OAAO,CAAC,eAAe;IAIV,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA+EzG,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,kCAAkC;YAM5B,cAAc;IAKf,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAsB3F"}

package/out/service/version-service.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionService = void 0;
+const cli_shared_1 = require("@forge/cli-shared");
+const manifest_1 = require("@forge/manifest");
+const arn_1 = require("@sandfox/arn");
+class VersionService {
+    getAppConfig;
+    versionDetailsClient;
+    constructor(getAppConfig, versionDetailsClient) {
+        this.getAppConfig = getAppConfig;
+        this.versionDetailsClient = versionDetailsClient;
+    }
+    getMajorVersion(version) {
+        return parseInt(version.split('.')[0]);
+    }
+    async getAppVersionDetails(environmentKey, majorVersion) {
+        const { id: appId } = await this.getAppConfig();
+        const data = await this.versionDetailsClient.getVersionDetails(appId, environmentKey, majorVersion);
+        const functionModules = data.modules?.filter((mod) => mod?.extensionData.type === manifest_1.AllModuleTypes.CoreFunction);
+        const remoteModules = data.modules?.filter((mod) => mod?.extensionData.type === manifest_1.AllModuleTypes.CoreRemote);
+        const allModules = this.getModulesGroupedByTypes(data.modules);
+        return {
+            requiresLicense: data.requiresLicense,
+            egresses: data.permissions?.[0].egress
+                ?.filter((entry) => entry !== undefined && entry !== null)
+                .filter((entry) => {
+                if (entry.type === 'FETCH_BACKEND_SIDE') {
+                    entry.addresses = entry.addresses?.filter((address) => !remoteModules?.map((remote) => remote?.extensionData.baseUrl).includes(address));
+                }
+                return entry;
+            })
+                .filter((entry) => entry?.addresses?.length !== 0)
+                .map((entry) => ({
+                type: this.getTypeFromPermissionType(entry?.type),
+                addresses: entry.addresses
+            })) || [],
+            scopes: data.permissions?.[0].scopes.map((scope) => scope.key).sort() || [],
+            policies: data.permissions?.[0].securityPolicies
+                ?.filter((entry) => entry.type !== undefined && entry.type !== null)
+                .map((entry) => ({
+                type: this.getTypeFromPermissionType(entry?.type),
+                policies: entry.policies
+            })) || [],
+            connectKeys: data.migrationKeys
+                ? Object.keys(data.migrationKeys).map((key) => ({
+                    product: key,
+                    key: data.migrationKeys[key]
+                }))
+                : undefined,
+            appVersion: this.getMajorVersion(data.appVersion),
+            deploymentDateTime: data.deploymentDateTime,
+            environmentType: data.environmentType,
+            functions: functionModules?.map((entry) => ({
+                key: entry?.key || 'N/A',
+                runtimeName: (entry?.extensionData.functions?.[Object.keys(entry?.extensionData.functions || {})[0]]?.runtime
+                    ?.identifier ||
+                    entry?.extensionData.runtime?.identifier ||
+                    'sandbox')
+                    .replace('provided.al2', 'sandbox')
+                    .replace('provided', 'sandbox'),
+                regions: entry?.extensionData.functions
+                    ? Object.keys(entry?.extensionData.functions)
+                    : [(0, arn_1.parse)(entry?.extensionData.functionName).region],
+                handler: entry?.extensionData.handler
+            })) || [],
+            modules: Object.keys(allModules)
+                .filter((type) => !['function', 'remote'].includes(type))
+                .map((type) => ({ type, items: allModules[type] })) || [],
+            remotes: remoteModules?.map((entry) => ({
+                key: entry?.key || 'N/A',
+                baseUrl: entry?.extensionData.baseUrl,
+                operations: entry?.extensionData.operations || []
+            })) || []
+        };
+    }
+    getTypeFromPermissionType(permissionType) {
+        switch (permissionType) {
+            case cli_shared_1.AppNetworkPermissionType.FetchBackendSide:
+                return 'fetch.backend';
+            case cli_shared_1.AppNetworkPermissionType.FetchClientSide:
+                return 'fetch.client';
+            default:
+                return permissionType?.toLowerCase().replaceAll('_', '.');
+        }
+    }
+    getModulesGroupedByTypes(modules) {
+        const rawModules = modules
+            ?.filter((mod) => manifest_1.SUPPORTED_MODULES.includes(mod?.extensionData.type))
+            ?.filter((mod) => ![manifest_1.AllModuleTypes.CoreFunction, manifest_1.AllModuleTypes.CoreRemote].includes(mod?.extensionData.type))
+            .map((entry) => ({
+            key: entry?.key || 'N/A',
+            type: entry?.extensionData.type,
+            properties: {
+                ...this.removeInternalPropertiesFromObject(entry?.extensionData)
+            }
+        })) || [];
+        return rawModules.reduce((acc, entry) => {
+            const type = (0, manifest_1.cleanKey)(entry.type);
+            if (acc[type] === undefined) {
+                acc[type] = [];
+            }
+            acc[type].push(entry);
+            return acc;
+        }, {});
+    }
+    removeInternalPropertiesFromObject(obj) {
+        const { type, functions, outboundAuthContainerId, resourceUploadId, key, ...rest } = obj || {};
+        return rest;
+    }
+    async getAppVersions(environmentKey) {
+        const { id: appId } = await this.getAppConfig();
+        return await this.versionDetailsClient.getVersionList(appId, environmentKey);
+    }
+    async getAppVersionOverviewList(environmentKey) {
+        const versions = await this.getAppVersions(environmentKey);
+        const majorVersions = versions.map((version) => this.getMajorVersion(version));
+        const versionDetails = await Promise.all(majorVersions.map(async (version) => await this.getAppVersionDetails(environmentKey, version)));
+        return versionDetails.map((entry) => ({
+            version: entry.appVersion,
+            deploymentDateTime: entry.deploymentDateTime,
+            environmentType: entry.environmentType,
+            egresses: entry.egresses.map((egress) => ({ type: egress.type, count: egress.addresses.length })),
+            policies: entry.policies.map((policy) => ({ type: policy.type, count: policy.policies.length })),
+            scopes: (entry.scopes.length || 0).toString(),
+            connectKeys: (entry.connectKeys?.length || 0).toString(),
+            functions: (entry.functions?.length || 0).toString(),
+            remotes: (entry.remotes?.length || 0).toString(),
+            modules: entry.modules.map((module) => ({ type: module.type, count: module.items.length })),
+            requiresLicense: entry.requiresLicense
+        }));
+    }
+}
+exports.VersionService = VersionService;

package/out/version/graphql-client.d.ts

@@ -0,0 +1,27 @@
+import { AppEnvironmentType, AppPermission, AppVersionExtension, GraphQLClient, Maybe, MigrationKeys, Storage, UserError } from '@forge/cli-shared';
+export interface AppVersionDetailsData {
+    migrationKeys?: Maybe<MigrationKeys> | null;
+    permissions?: Array<AppPermission> | null;
+    modules: Array<AppVersionExtension | null> | null | undefined;
+    environmentType: AppEnvironmentType;
+    appVersion: string;
+    deploymentDateTime: Date;
+    requiresLicense: boolean;
+    storage: Storage;
+}
+export declare class MissingAppError extends UserError {
+}
+export declare class EnvironmentNotFoundError extends UserError {
+    constructor(environmentKey: string);
+}
+export declare class MissingAppVersionError extends Error {
+}
+export declare class MissingAppEnvironmentError extends Error {
+}
+export declare class AppVersionDetailsClient {
+    private readonly graphqlClient;
+    constructor(graphqlClient: GraphQLClient);
+    getVersionDetails(appId: string, environmentKey: string, majorVersion?: number): Promise<AppVersionDetailsData>;
+    getVersionList(appId: string, environmentKey: string): Promise<string[]>;
+}
+//# sourceMappingURL=graphql-client.d.ts.map

package/out/version/graphql-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-client.d.ts","sourceRoot":"","sources":["../../src/version/graphql-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,KAAK,EACL,aAAa,EAEb,OAAO,EAEP,SAAS,EACV,MAAM,mBAAmB,CAAC;AAS3B,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC5C,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9D,eAAe,EAAE,kBAAkB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,IAAI,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,eAAgB,SAAQ,SAAS;CAAG;AAEjD,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,cAAc,EAAE,MAAM;CAGnC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AAEpD,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAExD,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAE5C,iBAAiB,CAC5B,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAyFpB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAuDtF"}