nx 21.0.0-canary.20250429-cf4a1f3 → 21.0.0-canary.20250501-8f50358

package/src/command-line/release/utils/remote-release-clients/github.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubRemoteReleaseClient = exports.defaultCreateReleaseProvider = void 0;
+const chalk = require("chalk");
+const enquirer_1 = require("enquirer");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const output_1 = require("../../../../utils/output");
+const path_1 = require("../../../../utils/path");
+const remote_release_client_1 = require("./remote-release-client");
+// axios types and values don't seem to match
+const _axios = require("axios");
+const axios = _axios;
+exports.defaultCreateReleaseProvider = {
+    provider: 'github',
+    hostname: 'github.com',
+    apiBaseUrl: 'https://api.github.com',
+};
+class GithubRemoteReleaseClient extends remote_release_client_1.RemoteReleaseClient {
+    constructor() {
+        super(...arguments);
+        this.remoteReleaseProviderName = 'GitHub';
+    }
+    /**
+     * Get GitHub repository data from git remote
+     */
+    static resolveRepoData(createReleaseConfig, remoteName = 'origin') {
+        try {
+            const remoteUrl = (0, node_child_process_1.execSync)(`git remote get-url ${remoteName}`, {
+                encoding: 'utf8',
+                stdio: 'pipe',
+            }).trim();
+            // Use the default provider if custom one is not specified or releases are disabled
+            let hostname = exports.defaultCreateReleaseProvider.hostname;
+            let apiBaseUrl = exports.defaultCreateReleaseProvider.apiBaseUrl;
+            if (createReleaseConfig !== false &&
+                typeof createReleaseConfig !== 'string') {
+                hostname = createReleaseConfig.hostname;
+                apiBaseUrl = createReleaseConfig.apiBaseUrl;
+            }
+            // Extract the 'user/repo' part from the URL
+            const escapedHostname = hostname.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regexString = `${escapedHostname}[/:]([\\w.-]+/[\\w.-]+)(\\.git)?`;
+            const regex = new RegExp(regexString);
+            const match = remoteUrl.match(regex);
+            if (match && match[1]) {
+                return {
+                    hostname,
+                    apiBaseUrl,
+                    // Ensure any trailing .git is stripped
+                    slug: match[1].replace(/\.git$/, ''),
+                };
+            }
+            else {
+                throw new Error(`Could not extract "user/repo" data from the resolved remote URL: ${remoteUrl}`);
+            }
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Resolve a GitHub token from environment variables or gh CLI
+     */
+    static async resolveTokenData(hostname) {
+        // Try and resolve from the environment
+        const tokenFromEnv = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+        if (tokenFromEnv) {
+            return { token: tokenFromEnv, headerName: 'Authorization' };
+        }
+        // Try and resolve from gh CLI installation
+        const ghCLIPath = (0, path_1.joinPathFragments)(process.env.XDG_CONFIG_HOME || (0, path_1.joinPathFragments)((0, node_os_1.homedir)(), '.config'), 'gh', 'hosts.yml');
+        if ((0, node_fs_1.existsSync)(ghCLIPath)) {
+            const yamlContents = await node_fs_1.promises.readFile(ghCLIPath, 'utf8');
+            const { load } = require('@zkochan/js-yaml');
+            const ghCLIConfig = load(yamlContents);
+            if (ghCLIConfig[hostname]) {
+                // Web based session (the token is already embedded in the config)
+                if (ghCLIConfig[hostname].oauth_token) {
+                    return ghCLIConfig[hostname].oauth_token;
+                }
+                // SSH based session (we need to dynamically resolve a token using the CLI)
+                if (ghCLIConfig[hostname].user &&
+                    ghCLIConfig[hostname].git_protocol === 'ssh') {
+                    const token = (0, node_child_process_1.execSync)(`gh auth token`, {
+                        encoding: 'utf8',
+                        stdio: 'pipe',
+                        windowsHide: false,
+                    }).trim();
+                    return { token, headerName: 'Authorization' };
+                }
+            }
+        }
+        if (hostname !== 'github.com') {
+            console.log(`Warning: It was not possible to automatically resolve a GitHub token from your environment for hostname ${hostname}. If you set the GITHUB_TOKEN or GH_TOKEN environment variable, that will be used for GitHub API requests.`);
+        }
+        return null;
+    }
+    createPostGitTask(releaseVersion, changelogContents, dryRun) {
+        return async (latestCommit) => {
+            output_1.output.logSingleLine(`Creating GitHub Release`);
+            await this.createOrUpdateRelease(releaseVersion, changelogContents, latestCommit, { dryRun });
+        };
+    }
+    async applyUsernameToAuthors(authors) {
+        await Promise.all([...authors.keys()].map(async (authorName) => {
+            const meta = authors.get(authorName);
+            for (const email of meta.email) {
+                if (email.endsWith('@users.noreply.github.com')) {
+                    const match = email.match(/^(\d+\+)?([^@]+)@users\.noreply\.github\.com$/);
+                    if (match && match[2]) {
+                        meta.username = match[2];
+                        break;
+                    }
+                }
+                const { data } = await axios
+                    .get(`https://ungh.cc/users/find/${email}`)
+                    .catch(() => ({ data: { user: null } }));
+                if (data?.user) {
+                    meta.username = data.user.username;
+                    break;
+                }
+            }
+        }));
+    }
+    /**
+     * Get a release by tag
+     */
+    async getReleaseByTag(tag) {
+        const githubRepoData = this.getRequiredRemoteRepoData();
+        return await this.makeRequest(`/repos/${githubRepoData.slug}/releases/tags/${tag}`);
+    }
+    /**
+     * Create a new release
+     */
+    async createRelease(remoteRelease) {
+        const githubRepoData = this.getRequiredRemoteRepoData();
+        return await this.makeRequest(`/repos/${githubRepoData.slug}/releases`, {
+            method: 'POST',
+            data: remoteRelease,
+        });
+    }
+    async updateRelease(id, remoteRelease) {
+        const githubRepoData = this.getRequiredRemoteRepoData();
+        return await this.makeRequest(`/repos/${githubRepoData.slug}/releases/${id}`, {
+            method: 'PATCH',
+            data: remoteRelease,
+        });
+    }
+    getManualRemoteReleaseURL(remoteReleaseOptions) {
+        const githubRepoData = this.getRequiredRemoteRepoData();
+        // Parameters taken from https://github.com/isaacs/github/issues/1410#issuecomment-442240267
+        let url = `https://${githubRepoData.hostname}/${githubRepoData.slug}/releases/new?tag=${remoteReleaseOptions.version}&title=${remoteReleaseOptions.version}&body=${encodeURIComponent(remoteReleaseOptions.body)}&target=${remoteReleaseOptions.commit}`;
+        if (remoteReleaseOptions.prerelease) {
+            url += '&prerelease=true';
+        }
+        return url;
+    }
+    handleAuthError() {
+        output_1.output.error({
+            title: `Unable to resolve data via the GitHub API. You can use any of the following options to resolve this:`,
+            bodyLines: [
+                '- Set the `GITHUB_TOKEN` or `GH_TOKEN` environment variable to a valid GitHub token with `repo` scope',
+                '- Have an active session via the official gh CLI tool (https://cli.github.com) in your current terminal',
+            ],
+        });
+    }
+    logReleaseAction(existingRelease, gitTag, dryRun) {
+        const githubRepoData = this.getRequiredRemoteRepoData();
+        const logTitle = `https://${githubRepoData.hostname}/${githubRepoData.slug}/releases/tag/${gitTag}`;
+        if (existingRelease) {
+            console.error(`${chalk.white('UPDATE')} ${logTitle}${dryRun ? chalk.keyword('orange')(' [dry-run]') : ''}`);
+        }
+        else {
+            console.error(`${chalk.green('CREATE')} ${logTitle}${dryRun ? chalk.keyword('orange')(' [dry-run]') : ''}`);
+        }
+    }
+    async handleError(error, result) {
+        if (error) {
+            process.exitCode = 1;
+            if (error.response?.data) {
+                // There's a nicely formatted error from GitHub we can display to the user
+                output_1.output.error({
+                    title: `A GitHub API Error occurred when creating/updating the release`,
+                    bodyLines: [
+                        `GitHub Error: ${JSON.stringify(error.response.data)}`,
+                        `---`,
+                        `Request Data:`,
+                        `Repo: ${this.getRemoteRepoData()?.slug}`,
+                        `Token Header Data: ${this.tokenHeader}`,
+                        `Body: ${JSON.stringify(result.requestData)}`,
+                    ],
+                });
+            }
+            else {
+                console.log(error);
+                console.error(`An unknown error occurred while trying to create a release on GitHub, please report this on https://github.com/nrwl/nx (NOTE: make sure to redact your GitHub token from the error message!)`);
+            }
+        }
+        const shouldContinueInGitHub = await this.promptForContinueInGitHub();
+        if (!shouldContinueInGitHub) {
+            return;
+        }
+        const open = require('open');
+        await open(result.url)
+            .then(() => {
+            console.info(`\nFollow up in the browser to manually create the release:\n\n` +
+                chalk.underline(chalk.cyan(result.url)) +
+                `\n`);
+        })
+            .catch(() => {
+            console.info(`Open this link to manually create a release: \n` +
+                chalk.underline(chalk.cyan(result.url)) +
+                '\n');
+        });
+    }
+    async promptForContinueInGitHub() {
+        try {
+            const reply = await (0, enquirer_1.prompt)([
+                {
+                    name: 'open',
+                    message: 'Do you want to finish creating the release manually in your browser?',
+                    type: 'autocomplete',
+                    choices: [
+                        {
+                            name: 'Yes',
+                            hint: 'It will pre-populate the form for you',
+                        },
+                        {
+                            name: 'No',
+                        },
+                    ],
+                    initial: 0,
+                },
+            ]);
+            return reply.open === 'Yes';
+        }
+        catch {
+            // Ensure the cursor is always restored before exiting
+            process.stdout.write('\u001b[?25h');
+            // Handle the case where the user exits the prompt with ctrl+c
+            process.exit(1);
+        }
+    }
+    /**
+     * Format references for the release (e.g., PRs, issues)
+     */
+    formatReferences(references) {
+        const githubRepoData = this.getRequiredRemoteRepoData();
+        const providerToRefSpec = {
+            github: { 'pull-request': 'pull', hash: 'commit', issue: 'issues' },
+        };
+        const refSpec = providerToRefSpec.github;
+        const formatSingleReference = (ref) => {
+            return `[${ref.value}](https://${githubRepoData.hostname}/${githubRepoData.slug}/${refSpec[ref.type]}/${ref.value.replace(/^#/, '')})`;
+        };
+        const pr = references.filter((ref) => ref.type === 'pull-request');
+        const issue = references.filter((ref) => ref.type === 'issue');
+        if (pr.length > 0 || issue.length > 0) {
+            return (' (' +
+                [...pr, ...issue].map((ref) => formatSingleReference(ref)).join(', ') +
+                ')');
+        }
+        if (references.length > 0) {
+            return ' (' + formatSingleReference(references[0]) + ')';
+        }
+        return '';
+    }
+    async syncRelease(remoteReleaseOptions, existingRelease) {
+        const githubReleaseData = {
+            tag_name: remoteReleaseOptions.version,
+            name: remoteReleaseOptions.version,
+            body: remoteReleaseOptions.body,
+            prerelease: remoteReleaseOptions.prerelease,
+            // legacy specifies that the latest release should be determined based on the release creation date and higher semantic version.
+            make_latest: 'legacy',
+        };
+        try {
+            const newGhRelease = await (existingRelease
+                ? this.updateRelease(existingRelease.id, githubReleaseData)
+                : this.createRelease({
+                    ...githubReleaseData,
+                    target_commitish: remoteReleaseOptions.commit,
+                }));
+            return {
+                status: existingRelease ? 'updated' : 'created',
+                id: newGhRelease.id,
+                url: newGhRelease.html_url,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'manual',
+                error,
+                url: this.getManualRemoteReleaseURL(remoteReleaseOptions),
+                requestData: githubReleaseData,
+            };
+        }
+    }
+    getRequiredRemoteRepoData() {
+        const githubRepoData = this.getRemoteRepoData();
+        if (!githubRepoData) {
+            throw new Error(`No remote repo data could be resolved for the current workspace`);
+        }
+        return githubRepoData;
+    }
+}
+exports.GithubRemoteReleaseClient = GithubRemoteReleaseClient;

package/src/command-line/release/utils/remote-release-clients/gitlab.d.ts

@@ -0,0 +1,62 @@
+import type { PostGitTask } from '../../changelog';
+import type { ResolvedCreateRemoteReleaseProvider } from '../../config/config';
+import type { Reference } from '../git';
+import { ReleaseVersion } from '../shared';
+import { RemoteReleaseClient, RemoteReleaseOptions, RemoteReleaseResult, RemoteRepoData } from './remote-release-client';
+export interface GitLabRepoData extends RemoteRepoData {
+    projectId: string;
+}
+export interface GitLabRelease {
+    id?: string;
+    name?: string;
+    tag_name: string;
+    ref: string;
+    assets?: {
+        links?: {
+            name: string;
+            url: string;
+            direct_asset_path?: string;
+            link_type?: string;
+        }[];
+    };
+    released_at?: string;
+    description?: string;
+    milestones?: string[];
+    prerelease?: boolean;
+}
+export declare const defaultCreateReleaseProvider: ResolvedCreateRemoteReleaseProvider;
+export declare class GitLabRemoteReleaseClient extends RemoteReleaseClient<GitLabRelease> {
+    remoteReleaseProviderName: string;
+    /**
+     * Get GitLab repository data from git remote
+     */
+    static resolveRepoData(createReleaseConfig: false | ResolvedCreateRemoteReleaseProvider, remoteName?: string): GitLabRepoData | null;
+    /**
+     * Resolve a GitLab token from various environment variables
+     */
+    static resolveTokenData(hostname: string): Promise<{
+        token: string;
+        headerName: string;
+    } | null>;
+    createPostGitTask(releaseVersion: ReleaseVersion, changelogContents: string, dryRun: boolean): PostGitTask;
+    applyUsernameToAuthors(): Promise<void>;
+    protected getReleaseByTag(tag: string): Promise<GitLabRelease>;
+    protected createRelease(remoteRelease: GitLabRelease): Promise<any>;
+    protected updateRelease(_id: string, remoteRelease: GitLabRelease): Promise<any>;
+    /**
+     * Generate a URL for manual release creation on GitLab. Sadly, unlike GitHub, GitLab does not
+     * seem to respect query string parameters for setting the UI form fields, so the user has to
+     * start from scratch.
+     */
+    protected getManualRemoteReleaseURL(_remoteReleaseOptions: RemoteReleaseOptions): string;
+    protected handleAuthError(): void;
+    protected logReleaseAction(existingRelease: GitLabRelease | undefined, gitTag: string, dryRun: boolean): void;
+    protected handleError(error: any, result: RemoteReleaseResult): Promise<void>;
+    private promptForContinueInGitLab;
+    /**
+     * Format references for the release (e.g., MRs, issues)
+     */
+    formatReferences(references: Reference[]): string;
+    protected syncRelease(remoteReleaseOptions: RemoteReleaseOptions, existingRelease?: GitLabRelease): Promise<RemoteReleaseResult>;
+    private getRequiredRemoteRepoData;
+}

package/src/command-line/release/utils/remote-release-clients/gitlab.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitLabRemoteReleaseClient = exports.defaultCreateReleaseProvider = void 0;
+const chalk = require("chalk");
+const enquirer_1 = require("enquirer");
+const node_child_process_1 = require("node:child_process");
+const output_1 = require("../../../../utils/output");
+const remote_release_client_1 = require("./remote-release-client");
+exports.defaultCreateReleaseProvider = {
+    provider: 'gitlab',
+    hostname: 'gitlab.com',
+    apiBaseUrl: 'https://gitlab.com/api/v4',
+};
+class GitLabRemoteReleaseClient extends remote_release_client_1.RemoteReleaseClient {
+    constructor() {
+        super(...arguments);
+        this.remoteReleaseProviderName = 'GitLab';
+    }
+    /**
+     * Get GitLab repository data from git remote
+     */
+    static resolveRepoData(createReleaseConfig, remoteName = 'origin') {
+        try {
+            const remoteUrl = (0, node_child_process_1.execSync)(`git remote get-url ${remoteName}`, {
+                encoding: 'utf8',
+                stdio: 'pipe',
+            }).trim();
+            // Use the default provider if custom one is not specified or releases are disabled
+            let hostname = exports.defaultCreateReleaseProvider.hostname;
+            let apiBaseUrl = exports.defaultCreateReleaseProvider.apiBaseUrl;
+            if (createReleaseConfig !== false &&
+                typeof createReleaseConfig !== 'string') {
+                hostname = createReleaseConfig.hostname || hostname;
+                apiBaseUrl = createReleaseConfig.apiBaseUrl || apiBaseUrl;
+            }
+            // Extract the project path from the URL
+            const escapedHostname = hostname.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regexString = `${escapedHostname}[/:]([\\w.-]+/[\\w.-]+(?:/[\\w.-]+)*)(\\.git)?`;
+            const regex = new RegExp(regexString);
+            const match = remoteUrl.match(regex);
+            if (match && match[1]) {
+                // Remove trailing .git if present
+                const slug = match[1].replace(/\.git$/, '');
+                // Encode the project path for use in API URLs
+                const projectId = encodeURIComponent(slug);
+                return {
+                    hostname,
+                    apiBaseUrl,
+                    slug,
+                    projectId,
+                };
+            }
+            else {
+                throw new Error(`Could not extract project path data from the resolved remote URL: ${remoteUrl}`);
+            }
+        }
+        catch (err) {
+            if (process.env.NX_VERBOSE_LOGGING === 'true') {
+                console.error(err);
+            }
+            return null;
+        }
+    }
+    /**
+     * Resolve a GitLab token from various environment variables
+     */
+    static async resolveTokenData(hostname) {
+        // Try and resolve from the environment
+        const tokenFromEnv = process.env.GITLAB_TOKEN || process.env.GL_TOKEN;
+        if (tokenFromEnv) {
+            return { token: tokenFromEnv, headerName: 'PRIVATE-TOKEN' };
+        }
+        // Try and resolve from a CI environment
+        if (process.env.CI_JOB_TOKEN) {
+            return { token: process.env.CI_JOB_TOKEN, headerName: 'JOB-TOKEN' };
+        }
+        if (hostname !== 'gitlab.com') {
+            console.log(`Warning: It was not possible to automatically resolve a GitLab token from your environment for hostname ${hostname}. If you set the GITLAB_TOKEN or GL_TOKEN environment variable (or you are in GitLab CI where CI_JOB_TOKEN is set automatically), that will be used for GitLab API requests.`);
+        }
+        return null;
+    }
+    createPostGitTask(releaseVersion, changelogContents, dryRun) {
+        return async (latestCommit) => {
+            output_1.output.logSingleLine(`Creating GitLab Release`);
+            await this.createOrUpdateRelease(releaseVersion, changelogContents, latestCommit, { dryRun });
+        };
+    }
+    // Not implemented for GitLab yet, the changelog renderer should not call this method
+    async applyUsernameToAuthors() {
+        throw new Error('applyUsernameToAuthors is not implemented for GitLab yet');
+    }
+    async getReleaseByTag(tag) {
+        const gitlabRepoData = this.getRequiredRemoteRepoData();
+        return await this.makeRequest(`/projects/${gitlabRepoData.projectId}/releases/${encodeURIComponent(tag)}`);
+    }
+    async createRelease(remoteRelease) {
+        const gitlabRepoData = this.getRequiredRemoteRepoData();
+        return await this.makeRequest(`/projects/${gitlabRepoData.projectId}/releases`, {
+            method: 'POST',
+            data: remoteRelease,
+        });
+    }
+    async updateRelease(_id, remoteRelease) {
+        const gitlabRepoData = this.getRequiredRemoteRepoData();
+        return await this.makeRequest(`/projects/${gitlabRepoData.projectId}/releases/${encodeURIComponent(remoteRelease.tag_name)}`, {
+            method: 'PUT',
+            data: remoteRelease,
+        });
+    }
+    /**
+     * Generate a URL for manual release creation on GitLab. Sadly, unlike GitHub, GitLab does not
+     * seem to respect query string parameters for setting the UI form fields, so the user has to
+     * start from scratch.
+     */
+    getManualRemoteReleaseURL(_remoteReleaseOptions) {
+        const gitlabRepoData = this.getRequiredRemoteRepoData();
+        return `https://${gitlabRepoData.hostname}/${gitlabRepoData.slug}/-/releases/new`;
+    }
+    handleAuthError() {
+        output_1.output.error({
+            title: `Unable to resolve data via the GitLab API.`,
+            bodyLines: [
+                '- Set the `GITLAB_TOKEN` or `GL_TOKEN` environment variable to a valid GitLab token with `api` scope',
+                '- If running in GitLab CI, the automatically provisioned CI_JOB_TOKEN can also be used',
+            ],
+        });
+    }
+    logReleaseAction(existingRelease, gitTag, dryRun) {
+        const gitlabRepoData = this.getRequiredRemoteRepoData();
+        const logTitle = `https://${gitlabRepoData.hostname}/${gitlabRepoData.slug}/-/releases/${encodeURIComponent(gitTag)}`;
+        if (existingRelease) {
+            console.error(`${chalk.white('UPDATE')} ${logTitle}${dryRun ? chalk.keyword('orange')(' [dry-run]') : ''}`);
+        }
+        else {
+            console.error(`${chalk.green('CREATE')} ${logTitle}${dryRun ? chalk.keyword('orange')(' [dry-run]') : ''}`);
+        }
+    }
+    async handleError(error, result) {
+        if (error) {
+            process.exitCode = 1;
+            if (error.response?.data) {
+                output_1.output.error({
+                    title: `A GitLab API Error occurred when creating/updating the release`,
+                    bodyLines: [
+                        `GitLab Error: ${JSON.stringify(error.response.data)}`,
+                        `---`,
+                        `Request Data:`,
+                        `Repo: ${this.getRemoteRepoData()?.slug}`,
+                        `Token Header Data: ${this.tokenHeader}`,
+                        `Body: ${JSON.stringify(result.requestData)}`,
+                    ],
+                });
+            }
+            else {
+                console.log(error);
+                console.error(`An unknown error occurred while trying to create a release on GitLab, please report this on https://github.com/nrwl/nx (NOTE: make sure to redact your GitLab token from the error message!)`);
+            }
+        }
+        const shouldContinueInGitLab = await this.promptForContinueInGitLab();
+        if (!shouldContinueInGitLab) {
+            return;
+        }
+        const open = require('open');
+        await open(result.url)
+            .then(() => {
+            console.info(`\nFollow up in the browser to manually create the release:\n\n` +
+                chalk.underline(chalk.cyan(result.url)) +
+                `\n`);
+        })
+            .catch(() => {
+            console.info(`Open this link to manually create a release: \n` +
+                chalk.underline(chalk.cyan(result.url)) +
+                '\n');
+        });
+    }
+    async promptForContinueInGitLab() {
+        try {
+            const reply = await (0, enquirer_1.prompt)([
+                {
+                    name: 'open',
+                    message: 'Do you want to create the release manually in your browser?',
+                    type: 'autocomplete',
+                    choices: [
+                        {
+                            name: 'Yes',
+                            hint: 'It will open the GitLab release page for you',
+                        },
+                        {
+                            name: 'No',
+                        },
+                    ],
+                    initial: 0,
+                },
+            ]);
+            return reply.open === 'Yes';
+        }
+        catch {
+            // Ensure the cursor is always restored before exiting
+            process.stdout.write('\u001b[?25h');
+            // Handle the case where the user exits the prompt with ctrl+c
+            process.exit(1);
+        }
+    }
+    /**
+     * Format references for the release (e.g., MRs, issues)
+     */
+    formatReferences(references) {
+        const gitlabRepoData = this.getRequiredRemoteRepoData();
+        const providerToRefSpec = {
+            gitlab: {
+                'pull-request': 'merge_requests',
+                hash: 'commit',
+                issue: 'issues',
+            },
+        };
+        const refSpec = providerToRefSpec.gitlab;
+        const formatSingleReference = (ref) => {
+            return `https://${gitlabRepoData.hostname}/${gitlabRepoData.slug}/-/${refSpec[ref.type]}/${ref.value.replace(/^[#!]/, '')}`;
+        };
+        const mr = references.filter((ref) => ref.type === 'pull-request');
+        const issue = references.filter((ref) => ref.type === 'issue');
+        if (mr.length > 0 || issue.length > 0) {
+            return (' (' +
+                [...mr, ...issue].map((ref) => formatSingleReference(ref)).join(', ') +
+                ')');
+        }
+        if (references.length > 0) {
+            return ' (' + formatSingleReference(references[0]) + ')';
+        }
+        return '';
+    }
+    async syncRelease(remoteReleaseOptions, existingRelease) {
+        const gitlabReleaseData = {
+            tag_name: remoteReleaseOptions.version,
+            name: remoteReleaseOptions.version,
+            description: remoteReleaseOptions.body,
+            prerelease: remoteReleaseOptions.prerelease,
+            ref: remoteReleaseOptions.commit,
+            released_at: new Date().toISOString(),
+            assets: { links: [] },
+            milestones: [],
+        };
+        try {
+            const newGlRelease = await (existingRelease
+                ? this.updateRelease(existingRelease.id, gitlabReleaseData)
+                : this.createRelease(gitlabReleaseData));
+            const gitlabRepoData = this.getRequiredRemoteRepoData();
+            return {
+                status: existingRelease ? 'updated' : 'created',
+                id: newGlRelease.tag_name,
+                url: `https://${gitlabRepoData.hostname}/${gitlabRepoData.slug}/-/tags/${encodeURIComponent(remoteReleaseOptions.version)}`,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'manual',
+                error,
+                url: this.getManualRemoteReleaseURL(remoteReleaseOptions),
+                requestData: gitlabReleaseData,
+            };
+        }
+    }
+    getRequiredRemoteRepoData() {
+        const gitlabRepoData = this.getRemoteRepoData();
+        if (!gitlabRepoData) {
+            throw new Error(`No remote repo data could be resolved for the current workspace`);
+        }
+        return gitlabRepoData;
+    }
+}
+exports.GitLabRemoteReleaseClient = GitLabRemoteReleaseClient;