@simplysf/simply-gitlab 0.1.0

package/lib/commands/gitlab/commit/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/commit/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAW7E,4EAA4E;AAC5E,MAAM,OAAO,GAAG,WAAW,CAAC;AAE5B,qGAAqG;AACrG,SAAS,OAAO,CAAC,KAAgB;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC;IACvC,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC;IACrC,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,WAAW,IAAI,EAAE,CAAC;IAC1D,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,EAAE,EAAE,CAAC;IAClD,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,WAAW,IAAI,OAAO,EAAE,EAAE,CAAC;IACnE,OAAO,YAAY,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,aAAsC;IAC3E,MAAM,CAAmB,OAAO,GAAG,iCAAiC,CAAC;IACrE,MAAM,CAAmB,WAAW,GACzC,8FAA8F;QAC9F,iGAAiG;QACjG,uCAAuC,CAAC;IAEnC,MAAM,CAAmB,QAAQ,GAAG;QACzC,2EAA2E;QAC3E,kFAAkF;KACnF,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC7F,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oDAAoD,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACvG,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAgB,CAAC;QAEvG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC1C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/lib/commands/gitlab/commit/list.d.ts

@@ -0,0 +1,17 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabCommitList extends GitLabCommand<typeof GitlabCommitList> {
+    static readonly summary = "List repository commits.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        ref: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        until: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        author: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stats: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/commit/list.js

@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { commitColumns, formatTable } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabCommitList extends GitLabCommand {
+    static summary = 'List repository commits.';
+    static description = 'Walks the history of a ref, newest first. --path narrows to commits that touched one file ' +
+        'or directory, which is the fastest way to answer "when did this change and who changed it".\n\n' +
+        '--since and --until take ISO 8601 timestamps (2026-01-31T00:00:00Z); a bare date works too.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --ref main --limit 10',
+        '<%= config.bin %> <%= command.id %> --project group/project --path src/index.ts',
+        '<%= config.bin %> <%= command.id %> --project group/project --since 2026-01-01 --until 2026-02-01',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'commits'),
+        ref: Flags.string({ summary: 'Branch, tag, or SHA to list from. Defaults to the default branch.' }),
+        path: Flags.string({ summary: 'Only commits that touched this file or directory.' }),
+        since: Flags.string({ summary: 'Only commits on or after this ISO 8601 timestamp.' }),
+        until: Flags.string({ summary: 'Only commits on or before this ISO 8601 timestamp.' }),
+        author: Flags.string({ summary: 'Only commits by this author name or email.' }),
+        stats: Flags.boolean({ summary: 'Include per-commit line counts in the JSON payload.', default: false }),
+    };
+    async run() {
+        const result = await this.gitlab().listCommits(this.flags.project, {
+            ref: this.flags.ref,
+            path: this.flags.path,
+            since: this.flags.since,
+            until: this.flags.until,
+            author: this.flags.author,
+            withStats: this.flags.stats || undefined,
+        }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No commits matched.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, commitColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'commit(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/gitlab/commit/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/commit/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAY,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAExF,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,aAAsC;IAC3E,MAAM,CAAmB,OAAO,GAAG,0BAA0B,CAAC;IAC9D,MAAM,CAAmB,WAAW,GACzC,4FAA4F;QAC5F,iGAAiG;QACjG,6FAA6F,CAAC;IAEzF,MAAM,CAAmB,QAAQ,GAAG;QACzC,mFAAmF;QACnF,iFAAiF;QACjF,mGAAmG;KACpG,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC;QACtC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mEAAmE,EAAE,CAAC;QACnG,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;QACpF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;QACrF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;QACtF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;QAC/E,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,qDAAqD,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACzG,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB;YACE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;YACnB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS;SACzC,EACD,IAAI,CAAC,KAAK,CAAC,KAAK,CACjB,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YAChC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,aAAa,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACnG,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/commit/view.d.ts

@@ -0,0 +1,11 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabCommitView extends GitLabCommand<typeof GitlabCommitView> {
+    static readonly summary = "Show one commit.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        sha: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/commit/view.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag } from '../../../shared/base-command.js';
+export default class GitlabCommitView extends GitLabCommand {
+    static summary = 'Show one commit.';
+    static description = 'Accepts a full or short SHA, or the name of a branch or tag — in which case the commit at ' +
+        'its tip is shown, so the answer changes as the branch moves. Use commit diff for the changes ' +
+        'themselves.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --sha 9a1b2c3',
+        '<%= config.bin %> <%= command.id %> --project group/project --sha main --json',
+    ];
+    static flags = {
+        ...projectFlag,
+        sha: Flags.string({ summary: 'Commit SHA, or the name of a branch or tag.', required: true }),
+    };
+    async run() {
+        const commit = (await this.gitlab().getCommit(this.flags.project, this.flags.sha));
+        this.logSafe(formatKeyValue([
+            ['Commit', commit.id],
+            ['Author', commit.author_name],
+            ['Date', commit.created_at],
+            ['Parents', commit.parent_ids?.join(', ')],
+            [
+                'Changes',
+                commit.stats === undefined ? undefined : `+${commit.stats.additions ?? 0} -${commit.stats.deletions ?? 0}`,
+            ],
+            ['URL', commit.web_url],
+        ]));
+        if (typeof commit.message === 'string') {
+            this.log('');
+            this.logSafe(commit.message.trimEnd());
+        }
+        return commit;
+    }
+}
+//# sourceMappingURL=view.js.map

package/lib/commands/gitlab/commit/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/commit/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAe7E,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,aAAsC;IAC3E,MAAM,CAAmB,OAAO,GAAG,kBAAkB,CAAC;IACtD,MAAM,CAAmB,WAAW,GACzC,4FAA4F;QAC5F,+FAA+F;QAC/F,aAAa,CAAC;IAET,MAAM,CAAmB,QAAQ,GAAG;QACzC,2EAA2E;QAC3E,+EAA+E;KAChF,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC9F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAW,CAAC;QAE7F,IAAI,CAAC,OAAO,CACV,cAAc,CAAC;YACb,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;YACrB,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;YAC9B,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;YAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C;gBACE,SAAS;gBACT,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE;aAC3G;YACD,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;SACxB,CAAC,CACH,CAAC;QACF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/file/create.d.ts

@@ -0,0 +1,20 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabFileCreate extends GitLabCommand<typeof GitlabFileCreate> {
+    static isWrite: boolean;
+    static readonly summary = "Create a file in a repository.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        path: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        content: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'content-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'start-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-email': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/file/create.js

@@ -0,0 +1,65 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { buildFileWrite, formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabFileCreate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Create a file in a repository.';
+    static description = 'Commits one new file to a branch. GitLab refuses the request if the file already exists — ' +
+        'use file update for that — and refuses it if the branch is protected and the token lacks ' +
+        'the role to push to it. Use --dry-run to see exactly what would be sent.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --path docs/new.md --branch main --content-file ./new.md --message "docs: add page"',
+        '<%= config.bin %> <%= command.id %> --project group/project --path src/config.json --branch feature --content-file ./config.json --message "feat: add config" --dry-run',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...writeFlags,
+        path: Flags.string({ summary: 'Path the file will have in the repository.', required: true }),
+        branch: Flags.string({ summary: 'Branch to commit to.', required: true }),
+        content: Flags.string({ summary: 'File contents.', exclusive: ['content-file'] }),
+        'content-file': Flags.string({ summary: 'Path to a local file holding the contents.' }),
+        message: Flags.string({ summary: 'Commit message.', required: true }),
+        'start-branch': Flags.string({ summary: 'Branch to create --branch from, if it does not exist.' }),
+        'author-email': Flags.string({ summary: 'Commit author email.' }),
+        'author-name': Flags.string({ summary: 'Commit author name.' }),
+    };
+    async run() {
+        const input = buildFileWrite({
+            branch: this.flags.branch,
+            content: this.flags.content,
+            contentFile: this.flags['content-file'],
+            message: this.flags.message,
+            startBranch: this.flags['start-branch'],
+            authorEmail: this.flags['author-email'],
+            authorName: this.flags['author-name'],
+        });
+        const request = { file_path: this.flags.path, ...input };
+        if (this.flags['dry-run']) {
+            this.log('Dry run — not sent. Request body:');
+            this.logSafe(JSON.stringify(request, null, 2));
+            return request;
+        }
+        const created = (await this.gitlab().createFile(this.flags.project, this.flags.path, input));
+        this.logSafe(formatKeyValue([
+            ['Created', created.file_path ?? this.flags.path],
+            ['Branch', created.branch ?? this.flags.branch],
+        ]));
+        return created;
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/gitlab/file/create.js.map

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

package/lib/commands/gitlab/file/update.d.ts

@@ -0,0 +1,21 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabFileUpdate extends GitLabCommand<typeof GitlabFileUpdate> {
+    static isWrite: boolean;
+    static readonly summary = "Replace a file in a repository.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        path: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        content: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'content-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'start-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'last-commit-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-email': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/file/update.js

@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { buildFileWrite, formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabFileUpdate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Replace a file in a repository.';
+    static description = 'Commits new contents over an existing file. The whole file is replaced; there is no partial ' +
+        'edit. Pass --last-commit-id with the value file view reported to have GitLab reject the ' +
+        'write if someone else changed the file meanwhile, instead of silently overwriting them.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --path README.md --branch main --content-file ./README.md --message "docs: refresh readme"',
+        '<%= config.bin %> <%= command.id %> --project group/project --path README.md --branch main --content-file ./README.md --message "docs: refresh" --last-commit-id 9a1b2c3',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...writeFlags,
+        path: Flags.string({ summary: 'Path to the file within the repository.', required: true }),
+        branch: Flags.string({ summary: 'Branch to commit to.', required: true }),
+        content: Flags.string({ summary: 'New file contents.', exclusive: ['content-file'] }),
+        'content-file': Flags.string({ summary: 'Path to a local file holding the new contents.' }),
+        message: Flags.string({ summary: 'Commit message.', required: true }),
+        'start-branch': Flags.string({ summary: 'Branch to create --branch from, if it does not exist.' }),
+        'last-commit-id': Flags.string({ summary: 'Reject the write if the file changed since this commit.' }),
+        'author-email': Flags.string({ summary: 'Commit author email.' }),
+        'author-name': Flags.string({ summary: 'Commit author name.' }),
+    };
+    async run() {
+        const input = buildFileWrite({
+            branch: this.flags.branch,
+            content: this.flags.content,
+            contentFile: this.flags['content-file'],
+            message: this.flags.message,
+            startBranch: this.flags['start-branch'],
+            lastCommitId: this.flags['last-commit-id'],
+            authorEmail: this.flags['author-email'],
+            authorName: this.flags['author-name'],
+        });
+        const request = { file_path: this.flags.path, ...input };
+        if (this.flags['dry-run']) {
+            this.log('Dry run — not sent. Request body:');
+            this.logSafe(JSON.stringify(request, null, 2));
+            return request;
+        }
+        const updated = (await this.gitlab().updateFile(this.flags.project, this.flags.path, input));
+        this.logSafe(formatKeyValue([
+            ['Updated', updated.file_path ?? this.flags.path],
+            ['Branch', updated.branch ?? this.flags.branch],
+        ]));
+        return updated;
+    }
+}
+//# sourceMappingURL=update.js.map

package/lib/commands/gitlab/file/update.js.map

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

package/lib/commands/gitlab/file/view.d.ts

@@ -0,0 +1,13 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabFileView extends GitLabCommand<typeof GitlabFileView> {
+    static readonly summary = "Print a file from a repository.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        path: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        ref: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raw: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/file/view.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { decodeFileContent, formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag } from '../../../shared/base-command.js';
+export default class GitlabFileView extends GitLabCommand {
+    static summary = 'Print a file from a repository.';
+    static description = 'Reads one file at a ref and writes its decoded contents to stdout, under a short metadata ' +
+        'header. Use --raw for the contents alone, or --json for the API payload, whose "content" is ' +
+        'base64 exactly as GitLab sends it.\n\n' +
+        'A binary file is not printed: its bytes would emit escape sequences to a terminal and noise ' +
+        'to whatever reads this stream. The metadata still is, so you can see what was found.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --path src/index.ts --ref main',
+        '<%= config.bin %> <%= command.id %> --project group/project --path README.md --ref v1.2.0 --raw',
+    ];
+    static flags = {
+        ...projectFlag,
+        path: Flags.string({ summary: 'Path to the file within the repository.', required: true }),
+        ref: Flags.string({ summary: 'Branch, tag, or commit SHA to read from.', required: true }),
+        raw: Flags.boolean({ summary: 'Print only the file contents, with no metadata header.', default: false }),
+    };
+    async run() {
+        const payload = (await this.gitlab().getFile(this.flags.project, this.flags.path, {
+            ref: this.flags.ref,
+        }));
+        const decoded = decodeFileContent(payload);
+        if (!this.flags.raw) {
+            this.logSafe(formatKeyValue([
+                ['File', payload.file_path],
+                ['Ref', payload.ref],
+                ['Size', decoded.bytes],
+                ['Last commit', payload.last_commit_id],
+            ]));
+            this.log('');
+        }
+        if (decoded.printable) {
+            this.logSafe(decoded.text);
+        }
+        else {
+            this.log(`(${decoded.bytes} bytes of binary content, not printed)`);
+        }
+        return payload;
+    }
+}
+//# sourceMappingURL=view.js.map

package/lib/commands/gitlab/file/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/file/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAoB,MAAM,8BAA8B,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAoC;IACvE,MAAM,CAAmB,OAAO,GAAG,iCAAiC,CAAC;IACrE,MAAM,CAAmB,WAAW,GACzC,4FAA4F;QAC5F,8FAA8F;QAC9F,wCAAwC;QACxC,8FAA8F;QAC9F,sFAAsF,CAAC;IAElF,MAAM,CAAmB,QAAQ,GAAG;QACzC,4FAA4F;QAC5F,iGAAiG;KAClG,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1F,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1F,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,wDAAwD,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KAC1G,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAChF,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;SACpB,CAAC,CAAgB,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CACV,cAAc,CAAC;gBACb,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;gBAC3B,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;gBACpB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;gBACvB,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC;aACxC,CAAC,CACH,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,wCAAwC,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/lib/commands/gitlab/mr/create.d.ts

@@ -0,0 +1,25 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabMrCreate extends GitLabCommand<typeof GitlabMrCreate> {
+    static isWrite: boolean;
+    static readonly summary = "Open a merge request.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'source-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        draft: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        squash: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'remove-source-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'assignee-id': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'reviewer-id': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        labels: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'milestone-id': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        body: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'body-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/mr/create.js

@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { buildMergeRequestCreateBody, formatKeyValue, parseBodyInput } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, parseList, projectFlag, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabMrCreate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Open a merge request.';
+    static description = 'Both branches must already exist on the project. --draft prefixes the title with "Draft: ", ' +
+        'which is how GitLab itself marks a draft; there is no separate field for it.\n\n' +
+        'Assignees and reviewers are numeric user ids, not usernames — GitLab accepts only ids here. ' +
+        '--body or --body-file supplies raw JSON for anything the flags do not cover, such as ' +
+        'approval rules. Use --dry-run to see exactly what would be sent.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --source-branch feature --target-branch main --title "feat: the thing"',
+        '<%= config.bin %> <%= command.id %> --project group/project --source-branch feature --target-branch main --title wip --draft --squash',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...writeFlags,
+        'source-branch': Flags.string({ summary: 'Branch holding the changes.' }),
+        'target-branch': Flags.string({ summary: 'Branch the changes are proposed for.' }),
+        title: Flags.string({ summary: 'Merge request title.' }),
+        description: Flags.string({ summary: 'Merge request description, as Markdown.' }),
+        draft: Flags.boolean({ summary: 'Open it as a draft.', default: false }),
+        squash: Flags.boolean({ summary: 'Squash the commits when it merges.', default: false }),
+        'remove-source-branch': Flags.boolean({ summary: 'Delete the source branch on merge.', default: false }),
+        'assignee-id': Flags.integer({ summary: 'User id to assign. Repeatable.', multiple: true }),
+        'reviewer-id': Flags.integer({ summary: 'User id to request review from. Repeatable.', multiple: true }),
+        labels: Flags.string({ summary: 'Comma-separated labels to apply.' }),
+        'milestone-id': Flags.integer({ summary: 'Milestone id to attach.' }),
+        body: Flags.string({ summary: 'Raw JSON request body.', exclusive: ['body-file'] }),
+        'body-file': Flags.string({ summary: 'Path to a file holding the raw JSON request body.' }),
+    };
+    async run() {
+        const request = buildMergeRequestCreateBody({
+            sourceBranch: this.flags['source-branch'],
+            targetBranch: this.flags['target-branch'],
+            title: this.flags.title,
+            description: this.flags.description,
+            draft: this.flags.draft || undefined,
+            squash: this.flags.squash || undefined,
+            removeSourceBranch: this.flags['remove-source-branch'] || undefined,
+            assigneeIds: this.flags['assignee-id'],
+            reviewerIds: this.flags['reviewer-id'],
+            labels: parseList(this.flags.labels),
+            milestoneId: this.flags['milestone-id'],
+            body: parseBodyInput(this.flags.body, this.flags['body-file']),
+        });
+        if (this.flags['dry-run']) {
+            this.log('Dry run — not sent. Request body:');
+            this.logSafe(JSON.stringify(request, null, 2));
+            return request;
+        }
+        const created = (await this.gitlab().createMergeRequest(this.flags.project, request));
+        this.logSafe(formatKeyValue([
+            ['Created', created.iid === undefined ? undefined : `!${created.iid}`],
+            ['Title', created.title],
+            ['URL', created.web_url],
+        ]));
+        return created;
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/gitlab/mr/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/mr/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAQpG,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAoC;IACvE,MAAM,CAAU,OAAO,GAAG,IAAI,CAAC;IAE/B,MAAM,CAAmB,OAAO,GAAG,uBAAuB,CAAC;IAC3D,MAAM,CAAmB,WAAW,GACzC,8FAA8F;QAC9F,kFAAkF;QAClF,8FAA8F;QAC9F,uFAAuF;QACvF,kEAAkE,CAAC;IAE9D,MAAM,CAAmB,QAAQ,GAAG;QACzC,oIAAoI;QACpI,uIAAuI;KACxI,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,UAAU;QACb,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;QACzE,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;QAClF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QACxD,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QACjF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACxE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACxF,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACxG,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC3F,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;QACrE,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;QACrE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QACnF,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;KAC5F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,OAAO,GAAG,2BAA2B,CAAC;YAC1C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;YACzC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;YACzC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS;YACpC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS;YACtC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,SAAS;YACnE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACtC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACtC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACpC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;YACvC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;SAC/D,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAwB,CAAC;QAC7G,IAAI,CAAC,OAAO,CACV,cAAc,CAAC;YACb,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACtE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;YACxB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;SACzB,CAAC,CACH,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/lib/commands/gitlab/mr/list.d.ts

@@ -0,0 +1,18 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabMrList extends GitLabCommand<typeof GitlabMrList> {
+    static readonly summary = "List merge requests for a project.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        state: import("@oclif/core/interfaces").OptionFlag<"opened" | "closed" | "locked" | "merged" | "all", import("@oclif/core/interfaces").CustomOptions>;
+        'source-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-username': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'reviewer-username': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        labels: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}