@forge/cli 0.0.0-experimental-034f51a → 0.0.0-experimental-c8e9749

package/out/environment-variables/set-environment-variable.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetEnvironmentVariableCommand = void 0;
+class SetEnvironmentVariableCommand {
+    constructor(client, getAppConfig) {
+        this.client = client;
+        this.getAppConfig = getAppConfig;
+    }
+    async execute(details) {
+        const { id: appId } = await this.getAppConfig();
+        await this.client.setEnvironmentVariable(Object.assign(Object.assign({}, details), { appId }));
+    }
+}
+exports.SetEnvironmentVariableCommand = SetEnvironmentVariableCommand;

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

@@ -0,0 +1,75 @@
+import { AppEnvironment, AppUninstallationInput, GraphQLClient, GraphQlMutationError, Pause, BaseError, UserError } from '@forge/cli-shared';
+import { AppInstallSiteDetails, InstallAppClient } from './install-app-site';
+import { Installation, ListAppInstallationsClient, UpgradeAppInstallationsClient } from '../service/installation-service';
+import { UninstallAppClient, UninstallAppOutput } from './uninstall-app';
+import { SiteTranslator } from './site-translation';
+export declare const UNINSTALLATION_EVENT_POLL_INTERVAL = 500;
+export declare const ALREADY_UPGRADED_CODE = "INSTALLATION_ALREADY_UPGRADED";
+export declare class PermissionDeniedError extends GraphQlMutationError {
+    constructor(requestId: string | undefined, appId: string | undefined, statusCode: number | undefined);
+}
+export declare class AlreadyInstalledError extends GraphQlMutationError {
+    constructor(requestId: string | undefined, statusCode: number | undefined);
+}
+export declare class InstallationError extends GraphQlMutationError {
+    constructor(message: string, { requestId, code, statusCode }: {
+        requestId: string | undefined;
+        code: string | undefined;
+        statusCode: number | undefined;
+    });
+}
+export declare class UpgradeError extends GraphQlMutationError {
+    constructor(message: string, { requestId, code, statusCode }: {
+        requestId: string | undefined;
+        code: string | undefined;
+        statusCode: number | undefined;
+    });
+}
+export declare class EnvironmentNotFoundError extends Error {
+}
+export declare class MissingTaskIdError extends Error {
+}
+export declare class InstallationRequestFailedError extends BaseError {
+    private readonly userError;
+    readonly code?: string | undefined;
+    constructor(userError: boolean, code?: string | undefined, message?: string);
+    isUserError(): boolean;
+}
+export declare class MissingAppError extends UserError {
+}
+export declare class MissingAppEnvironmentError extends Error {
+}
+export declare class MissingAppUninstallTask extends Error {
+}
+export declare class InstallationNotFoundError extends UserError {
+}
+export declare class UnknownSiteWithoutResourceIdError extends Error {
+    constructor();
+}
+export declare class InstallationsGraphqlClient implements InstallAppClient, ListAppInstallationsClient, UninstallAppClient, UpgradeAppInstallationsClient {
+    private readonly graphqlClient;
+    private readonly cloudIdTranslator;
+    private readonly bitbucketTranslator;
+    private readonly pause;
+    SITE_RESOURCE_TYPE: string;
+    WORKSPACE_RESOURCE_TYPE: string;
+    static buildInstallationContext(product: string, resourceId: string, resourceType: string): string;
+    constructor(graphqlClient: GraphQLClient, cloudIdTranslator: SiteTranslator, bitbucketTranslator: SiteTranslator, pause: Pause);
+    private buildInstallationContext;
+    private getProductTranslation;
+    installAppIntoSite({ environmentKey, site, product, appId }: AppInstallSiteDetails): Promise<void>;
+    upgradeInstallation({ site, product, environmentKey, appId }: AppInstallSiteDetails): Promise<void>;
+    private monitorAppInstallOrUpgrade;
+    uninstallApp(input: AppUninstallationInput): Promise<boolean>;
+    uninstallMultipleApps(apps: AppUninstallationInput[]): Promise<Partial<UninstallAppOutput>[]>;
+    listInstallations(appId: string): Promise<Installation[]>;
+    getInstallation(appId: string, installationId: string): Promise<Installation>;
+    private getAppInstallationTask;
+    private monitorUninstallApp;
+    private getResourceArisForProduct;
+    private getCombinedHostnameMap;
+    private resolveInstallationsHostnames;
+    private getAllInstallations;
+    getVersions(appId: string, environmentKey: string, firstN?: number): Promise<AppEnvironment['versions']>;
+}
+//# sourceMappingURL=graphql-client.d.ts.map

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

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

package/out/installations/graphql-client.js

@@ -0,0 +1,423 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationsGraphqlClient = exports.UnknownSiteWithoutResourceIdError = exports.InstallationNotFoundError = exports.MissingAppUninstallTask = exports.MissingAppEnvironmentError = exports.MissingAppError = exports.InstallationRequestFailedError = exports.MissingTaskIdError = exports.EnvironmentNotFoundError = exports.UpgradeError = exports.InstallationError = exports.AlreadyInstalledError = exports.PermissionDeniedError = exports.ALREADY_UPGRADED_CODE = exports.UNINSTALLATION_EVENT_POLL_INTERVAL = void 0;
+const cs_ari_1 = require("@forge/util/packages/cs-ari");
+const cli_shared_1 = require("@forge/cli-shared");
+exports.UNINSTALLATION_EVENT_POLL_INTERVAL = 500;
+exports.ALREADY_UPGRADED_CODE = 'INSTALLATION_ALREADY_UPGRADED';
+const ALREADY_INSTALLED_CODE = 'APP_ALREADY_INSTALLED';
+const PERMISSION_DENIED = 'PERMISSION_DENIED';
+class PermissionDeniedError extends cli_shared_1.GraphQlMutationError {
+    constructor(requestId = 'unknown', appId = 'unknown', statusCode) {
+        super(cli_shared_1.Text.install.error.permissionsDeniedInstructions(requestId, appId), {
+            requestId,
+            code: PERMISSION_DENIED,
+            statusCode
+        });
+    }
+}
+exports.PermissionDeniedError = PermissionDeniedError;
+class AlreadyInstalledError extends cli_shared_1.GraphQlMutationError {
+    constructor(requestId, statusCode) {
+        super(cli_shared_1.Text.install.error.alreadyInstalledError, { requestId, code: ALREADY_INSTALLED_CODE, statusCode });
+    }
+}
+exports.AlreadyInstalledError = AlreadyInstalledError;
+class InstallationError extends cli_shared_1.GraphQlMutationError {
+    constructor(message, { requestId, code, statusCode }) {
+        super(cli_shared_1.Text.install.error.serverSideInstallationError(message), { requestId, code, statusCode });
+    }
+}
+exports.InstallationError = InstallationError;
+class UpgradeError extends cli_shared_1.GraphQlMutationError {
+    constructor(message, { requestId, code, statusCode }) {
+        super(cli_shared_1.Text.upgrade.error.serverSideInstallationError(message), { requestId, code, statusCode });
+    }
+}
+exports.UpgradeError = UpgradeError;
+class EnvironmentNotFoundError extends Error {
+}
+exports.EnvironmentNotFoundError = EnvironmentNotFoundError;
+class MissingTaskIdError extends Error {
+}
+exports.MissingTaskIdError = MissingTaskIdError;
+class InstallationRequestFailedError extends cli_shared_1.BaseError {
+    constructor(userError, code, message) {
+        super(message);
+        this.userError = userError;
+        this.code = code;
+    }
+    isUserError() {
+        return this.userError;
+    }
+}
+exports.InstallationRequestFailedError = InstallationRequestFailedError;
+class MissingAppError extends cli_shared_1.UserError {
+}
+exports.MissingAppError = MissingAppError;
+class MissingAppEnvironmentError extends Error {
+}
+exports.MissingAppEnvironmentError = MissingAppEnvironmentError;
+class MissingAppUninstallTask extends Error {
+}
+exports.MissingAppUninstallTask = MissingAppUninstallTask;
+class InstallationNotFoundError extends cli_shared_1.UserError {
+}
+exports.InstallationNotFoundError = InstallationNotFoundError;
+class UnknownSiteWithoutResourceIdError extends Error {
+    constructor() {
+        super(cli_shared_1.Text.installList.noResourceId);
+    }
+}
+exports.UnknownSiteWithoutResourceIdError = UnknownSiteWithoutResourceIdError;
+class InstallationsGraphqlClient {
+    constructor(graphqlClient, cloudIdTranslator, bitbucketTranslator, pause) {
+        this.graphqlClient = graphqlClient;
+        this.cloudIdTranslator = cloudIdTranslator;
+        this.bitbucketTranslator = bitbucketTranslator;
+        this.pause = pause;
+        this.SITE_RESOURCE_TYPE = 'site';
+        this.WORKSPACE_RESOURCE_TYPE = 'workspace';
+    }
+    static buildInstallationContext(product, resourceId, resourceType) {
+        const ari = new cs_ari_1.ResourceIdentifier({
+            resourceOwner: product.toLowerCase(),
+            resourceType: resourceType,
+            resourceId: resourceId
+        });
+        return ari.toString();
+    }
+    async buildInstallationContext(product, site) {
+        const ari = await this.getProductTranslation(product).buildInstallationContext(product, site);
+        return ari.toString();
+    }
+    getProductTranslation(product) {
+        if (product && (0, cli_shared_1.isBitbucketProduct)(product)) {
+            return this.bitbucketTranslator;
+        }
+        return this.cloudIdTranslator;
+    }
+    async installAppIntoSite({ environmentKey, site, product, appId }) {
+        const installationContext = await this.buildInstallationContext(product, site);
+        const query = `
+      mutation forge_cli_installApplication($input: AppInstallationInput!) {
+        installApp(input: $input) {
+          success
+          taskId
+          errors {
+            message
+            extensions {
+              errorType
+            }
+          }
+        }
+      }
+    `;
+        const variables = {
+            input: {
+                installationContext,
+                appId,
+                environmentKey,
+                async: true
+            }
+        };
+        const { response: { installApp: { success, taskId, errors } }, requestId } = await this.graphqlClient.mutate(query, variables);
+        const error = (0, cli_shared_1.getError)(errors);
+        if (!success) {
+            if (error.code === ALREADY_INSTALLED_CODE) {
+                throw new AlreadyInstalledError(requestId, error.statusCode);
+            }
+            if (error.code === PERMISSION_DENIED) {
+                throw new PermissionDeniedError(requestId, (0, cs_ari_1.parse)(appId).resourceId, error.statusCode);
+            }
+            throw new InstallationError(`${error.message} (requestId: ${requestId || 'unknown'})`, {
+                requestId,
+                code: error.code,
+                statusCode: error.statusCode
+            });
+        }
+        if (!taskId) {
+            throw new MissingTaskIdError(error.message);
+        }
+        await this.monitorAppInstallOrUpgrade(taskId);
+    }
+    async upgradeInstallation({ site, product, environmentKey, appId }) {
+        const installationContext = await this.buildInstallationContext(product, site);
+        const query = `
+      mutation forge_cli_upgradeApplication($input: AppInstallationUpgradeInput!) {
+        upgradeApp(input: $input) {
+          success
+          taskId
+          errors {
+            message
+            extensions {
+              errorType
+            }
+          }
+        }
+      }
+    `;
+        const variables = {
+            input: {
+                installationContext,
+                appId,
+                environmentKey,
+                async: true
+            }
+        };
+        const { response: { upgradeApp: { success, errors, taskId } }, requestId } = await this.graphqlClient.mutate(query, variables);
+        const error = (0, cli_shared_1.getError)(errors);
+        if (!success) {
+            throw new UpgradeError(`${error.message} (requestId: ${requestId || 'unknown'})`, {
+                requestId,
+                code: error.code,
+                statusCode: error.statusCode
+            });
+        }
+        if (!taskId) {
+            throw new MissingTaskIdError(error.message);
+        }
+        await this.monitorAppInstallOrUpgrade(taskId);
+    }
+    async monitorAppInstallOrUpgrade(taskId) {
+        var _a, _b, _c, _d;
+        let status = cli_shared_1.AppTaskState.Pending;
+        while (status !== cli_shared_1.AppTaskState.Complete) {
+            const { state, errors } = await this.getAppInstallationTask(taskId);
+            status = state;
+            if (status === cli_shared_1.AppTaskState.Failed) {
+                const error = errors === null || errors === void 0 ? void 0 : errors[0];
+                const statusCode = (_a = error === null || error === void 0 ? void 0 : error.extensions) === null || _a === void 0 ? void 0 : _a.statusCode;
+                const isUserError = statusCode && statusCode >= 400 && statusCode < 500 ? true : false;
+                const code = (_c = (_b = error === null || error === void 0 ? void 0 : error.extensions) === null || _b === void 0 ? void 0 : _b.errorType) !== null && _c !== void 0 ? _c : undefined;
+                throw new InstallationRequestFailedError(isUserError, code, (_d = error === null || error === void 0 ? void 0 : error.message) !== null && _d !== void 0 ? _d : undefined);
+            }
+            if (status !== cli_shared_1.AppTaskState.Complete)
+                await this.pause(exports.UNINSTALLATION_EVENT_POLL_INTERVAL);
+        }
+    }
+    async uninstallApp(input) {
+        const query = `
+      mutation forge_cli_uninstallApplication($input: AppUninstallationInput!) {
+        uninstallApp(input: $input) {
+          success
+          taskId
+          errors {
+            message
+            extensions {
+              errorType
+            }
+          }
+        }
+      }
+    `;
+        const { response: { uninstallApp: { success, errors, taskId } }, requestId } = await this.graphqlClient.mutate(query, { input });
+        const error = (0, cli_shared_1.getError)(errors);
+        if (!success) {
+            throw new cli_shared_1.GraphQlMutationError(`${error.message} (requestId: ${requestId || 'unknown'})`, {
+                requestId,
+                code: error.code,
+                statusCode: error.statusCode
+            });
+        }
+        return this.monitorUninstallApp(taskId);
+    }
+    async uninstallMultipleApps(apps) {
+        const uninstallsResult = [];
+        for (const app of apps) {
+            try {
+                const [success] = await Promise.all([
+                    this.uninstallApp(app),
+                    new Promise((resolve) => setTimeout(resolve, 1000))
+                ]);
+                uninstallsResult.push(Object.assign(Object.assign({}, app), { successful: success }));
+            }
+            catch (err) {
+                uninstallsResult.push(Object.assign(Object.assign({}, app), { successful: false }));
+            }
+        }
+        return uninstallsResult;
+    }
+    async listInstallations(appId) {
+        const installations = await this.getAllInstallations(appId);
+        return await this.resolveInstallationsHostnames(installations);
+    }
+    async getInstallation(appId, installationId) {
+        const installations = await this.listInstallations(appId);
+        const matchedInstallation = installations.find(({ id }) => id === installationId);
+        if (matchedInstallation) {
+            return matchedInstallation;
+        }
+        throw new InstallationNotFoundError(cli_shared_1.Text.installationId.errors.notFound(installationId));
+    }
+    async getAppInstallationTask(taskId) {
+        const query = `
+      query forge_cli_getInstallationTask($id: ID!) {
+        appInstallationTask(id: $id) {
+          state
+          errors {
+            message
+            extensions {
+              errorType
+            }
+          }
+        }
+      }
+    `;
+        const { appInstallationTask } = await this.graphqlClient.query(query, {
+            id: taskId
+        });
+        if (!appInstallationTask) {
+            throw new MissingAppUninstallTask(cli_shared_1.Text.uninstall.missingUninstallTask);
+        }
+        const { state, errors } = appInstallationTask;
+        return {
+            errors,
+            state
+        };
+    }
+    async monitorUninstallApp(taskId) {
+        let status = cli_shared_1.AppTaskState.Pending;
+        while (status !== cli_shared_1.AppTaskState.Complete) {
+            const { state } = await this.getAppInstallationTask(taskId);
+            status = state;
+            if (status === cli_shared_1.AppTaskState.Failed) {
+                return false;
+            }
+            if (status !== cli_shared_1.AppTaskState.Complete)
+                await this.pause(exports.UNINSTALLATION_EVENT_POLL_INTERVAL);
+        }
+        return true;
+    }
+    getResourceArisForProduct(installationContexts, condition) {
+        return [...new Set(installationContexts.filter((context) => condition(context)))];
+    }
+    async getCombinedHostnameMap(installationContexts) {
+        const bitbucketAris = this.getResourceArisForProduct(installationContexts, this.bitbucketTranslator.ariBelongsToProduct);
+        const workspaceAriToHostname = await this.bitbucketTranslator.getSitesForResourceAris(bitbucketAris);
+        const cloudIdAris = this.getResourceArisForProduct(installationContexts, this.cloudIdTranslator.ariBelongsToProduct);
+        const siteAriToHostname = await this.cloudIdTranslator.getSitesForResourceAris(cloudIdAris);
+        const combinedAriToHostname = Object.assign(Object.assign({}, siteAriToHostname), workspaceAriToHostname);
+        return combinedAriToHostname;
+    }
+    async resolveInstallationsHostnames(installations) {
+        if (!installations.length) {
+            return [];
+        }
+        const installationContexts = installations.map(({ installation }) => {
+            const context = (0, cs_ari_1.parse)(installation.installationContext);
+            const resourceId = context.resourceId;
+            if (!resourceId) {
+                throw new UnknownSiteWithoutResourceIdError();
+            }
+            return context;
+        });
+        const combinedAriToHostname = await this.getCombinedHostnameMap(installationContexts);
+        return installationContexts.map((context, i) => {
+            const { environment, installation } = installations[i];
+            const site = combinedAriToHostname[context.toString()];
+            return {
+                id: installation.id,
+                product: context.resourceOwner,
+                environmentKey: environment,
+                context: installation.installationContext,
+                site,
+                version: installation.version || {
+                    isLatest: false
+                }
+            };
+        });
+    }
+    async getAllInstallations(appId) {
+        var _a, _b;
+        const query = `
+      query forge_cli_getEcosystemInstallationsByApp($filter: AppInstallationsByAppFilter!, $first: Int, $after: String) {
+        ecosystem {
+          appInstallationsByApp(filter: $filter, first: $first, after: $after) {
+            nodes {
+              id
+              installationContext
+              version {
+                isLatest
+              }
+              appEnvironment {
+                key
+              }
+            }
+            pageInfo {
+              hasNextPage
+              endCursor
+            }
+          }
+        }
+      }
+    `;
+        const output = [];
+        let cursor = undefined;
+        let hasNext = undefined;
+        do {
+            const result = (await this.graphqlClient.query(query, {
+                filter: {
+                    apps: {
+                        ids: [appId]
+                    }
+                },
+                first: 100,
+                after: cursor
+            }));
+            if (!((_b = (_a = result === null || result === void 0 ? void 0 : result.ecosystem) === null || _a === void 0 ? void 0 : _a.appInstallationsByApp) === null || _b === void 0 ? void 0 : _b.nodes)) {
+                throw new MissingAppError();
+            }
+            const { nodes, pageInfo } = result.ecosystem.appInstallationsByApp;
+            for (const node of nodes) {
+                if (node) {
+                    if (!node.appEnvironment) {
+                        throw new MissingAppEnvironmentError();
+                    }
+                    output.push({
+                        environment: node.appEnvironment.key,
+                        installation: node
+                    });
+                }
+            }
+            cursor = pageInfo.endCursor;
+            hasNext = pageInfo.hasNextPage;
+        } while (hasNext && cursor);
+        return output;
+    }
+    async getVersions(appId, environmentKey, firstN = 1) {
+        const query = `
+      query forge_cli_getApplicationEnvironmentLatestVersions($appId: ID!, $environmentKey: String!, $firstN: Int!) {
+        app(id: $appId) {
+          environmentByKey(key: $environmentKey) {
+            versions(first: $firstN) {
+              nodes {
+                permissions {
+                  egress {
+                    addresses
+                  }
+                  scopes {
+                    key
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    `;
+        const result = await this.graphqlClient.query(query, {
+            appId,
+            environmentKey,
+            firstN
+        });
+        if (!result.app) {
+            throw new MissingAppError();
+        }
+        if (!result.app.environmentByKey) {
+            throw new EnvironmentNotFoundError();
+        }
+        return result.app.environmentByKey.versions;
+    }
+}
+exports.InstallationsGraphqlClient = InstallationsGraphqlClient;

package/out/installations/install-app-site.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+import { URL } from 'url';
+import { AppConfigProvider } from '@forge/cli-shared';
+export interface TriggerAppSiteInstallDetails {
+    site: URL;
+    product: string;
+    environmentKey: string;
+}
+export interface AppInstallSiteDetails extends TriggerAppSiteInstallDetails {
+    appId: string;
+}
+export interface InstallAppClient {
+    installAppIntoSite(appInstallDetails: AppInstallSiteDetails): Promise<void>;
+}
+export declare class InstallAppSiteCommand {
+    private readonly getAppConfig;
+    private readonly installAppClient;
+    constructor(getAppConfig: AppConfigProvider, installAppClient: InstallAppClient);
+    execute({ environmentKey, site, product }: TriggerAppSiteInstallDetails): Promise<void>;
+}
+//# sourceMappingURL=install-app-site.d.ts.map

package/out/installations/install-app-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-app-site.d.ts","sourceRoot":"","sources":["../../src/installations/install-app-site.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAAC,iBAAiB,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAqB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAlE,YAAY,EAAE,iBAAiB,EAAmB,gBAAgB,EAAE,gBAAgB;IAEpG,OAAO,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,4BAA4B;CASrF"}

package/out/installations/install-app-site.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallAppSiteCommand = void 0;
+class InstallAppSiteCommand {
+    constructor(getAppConfig, installAppClient) {
+        this.getAppConfig = getAppConfig;
+        this.installAppClient = installAppClient;
+    }
+    async execute({ environmentKey, site, product }) {
+        const { id: appId } = await this.getAppConfig();
+        return await this.installAppClient.installAppIntoSite({
+            appId,
+            environmentKey,
+            site,
+            product
+        });
+    }
+}
+exports.InstallAppSiteCommand = InstallAppSiteCommand;

package/out/installations/shared.d.ts

@@ -0,0 +1,5 @@
+import { Installation } from '../service/installation-service';
+export declare class UninstallAppError extends Error {
+}
+export declare const getHangingIdentityInstallationsFromSite: (allInstallations: Installation[], remainingApps: Installation[], sites: Set<string>) => Installation[];
+//# sourceMappingURL=shared.d.ts.map

package/out/installations/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/installations/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,eAAO,MAAM,uCAAuC,qBAChC,YAAY,EAAE,iBACjB,YAAY,EAAE,SACtB,IAAI,MAAM,CAAC,KACjB,YAAY,EAkBd,CAAC"}

package/out/installations/shared.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHangingIdentityInstallationsFromSite = exports.UninstallAppError = void 0;
+class UninstallAppError extends Error {
+}
+exports.UninstallAppError = UninstallAppError;
+const getHangingIdentityInstallationsFromSite = (allInstallations, remainingApps, sites) => {
+    const hangingIdentityInstalls = [];
+    sites.forEach((site) => {
+        const shouldUninstallIdentity = remainingApps.filter((app) => app.site === site).length === 0;
+        if (shouldUninstallIdentity) {
+            const identityInstall = allInstallations.find((install) => install.site === site && install.product === 'identity');
+            if (identityInstall) {
+                hangingIdentityInstalls.push(identityInstall);
+            }
+        }
+    });
+    return hangingIdentityInstalls;
+};
+exports.getHangingIdentityInstallationsFromSite = getHangingIdentityInstallationsFromSite;

package/out/installations/site-translation/bitbucket.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import { SiteTranslator, ResourcefulAri } from './site-translation';
+import { URL } from 'url';
+import { Ari } from '@forge/util/packages/cs-ari';
+export declare class InvalidWorkspaceError extends Error {
+    constructor(url: URL);
+}
+export declare class InvalidResponseError extends Error {
+    constructor(url: URL);
+}
+export declare const getBitbucketEndpoint: () => string;
+export declare class BitbucketTranslator implements SiteTranslator {
+    ariBelongsToProduct(ari: ResourcefulAri): boolean;
+    buildInstallationContext(product: string, site: URL): Promise<Ari>;
+    getSitesForResourceAris(aris: ResourcefulAri[]): Promise<Record<string, string>>;
+    private getWorkspaceId;
+    getWorkspaceUrl(workspaceId: string): Promise<URL | null>;
+    private decorateWorkspaceId;
+    private extractWorkspaceId;
+    private buildFetchUrl;
+    private extractWorkspaceName;
+    private buildWorkspaceUrl;
+}
+//# sourceMappingURL=bitbucket.d.ts.map

package/out/installations/site-translation/bitbucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket.d.ts","sourceRoot":"","sources":["../../../src/installations/site-translation/bitbucket.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAsB,MAAM,6BAA6B,CAAC;AAGtE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,GAAG,EAAE,GAAG;CAGrB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,GAAG,EAAE,GAAG;CAGrB;AAOD,eAAO,MAAM,oBAAoB,QAAO,MAEvC,CAAC;AAEF,qBAAa,mBAAoB,YAAW,cAAc;IACjD,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO;IAI3C,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAUlE,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAc/E,cAAc;IAwBf,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAsBtE,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,iBAAiB;CAG1B"}