@pilatos/bitbucket-cli 1.15.0 → 1.16.0

package/README.md

@@ -88,6 +88,8 @@ bb pr list
 bb repo list
 bb pr create --title "Add feature"
 bb pr approve 42
+bb browse 42                  # open PR #42 in your browser
+bb browse src/cli.ts:20       # open a file at a specific line
 bb config set defaultWorkspace myworkspace
 ```
 

package/dist/index.js

@@ -17440,6 +17440,8 @@ var ServiceTokens = {
   AddDefaultReviewerCommand: "AddDefaultReviewerCommand",
   RemoveDefaultReviewerCommand: "RemoveDefaultReviewerCommand",
   DefaultReviewerService: "DefaultReviewerService",
+  UrlBuilderService: "UrlBuilderService",
+  BrowseCommand: "BrowseCommand",
   CreatePRCommand: "CreatePRCommand",
   ListPRsCommand: "ListPRsCommand",
   ViewPRCommand: "ViewPRCommand",
@@ -17823,6 +17825,9 @@ class GitService {
   async getCurrentBranch() {
     return this.execOrError(["rev-parse", "--abbrev-ref", "HEAD"]);
   }
+  async getCurrentCommit() {
+    return this.execOrError(["rev-parse", "HEAD"]);
+  }
   async getRemoteUrl(remote = "origin") {
     const result = await this.exec(["remote", "get-url", remote]);
     if (result.exitCode !== 0) {
@@ -23376,6 +23381,67 @@ function accountToEntry(account) {
     nickname: asUser.nickname
   };
 }
+// src/services/url-builder.service.ts
+var BITBUCKET_WEB_BASE = "https://bitbucket.org";
+function encodePathSegments(path3) {
+  return path3.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+}
+
+class UrlBuilderService {
+  base;
+  constructor(base = BITBUCKET_WEB_BASE) {
+    this.base = base.replace(/\/+$/, "");
+  }
+  repo(ctx) {
+    return this.repoBase(ctx);
+  }
+  src(ctx, branch, path3, line) {
+    const encodedBranch = encodeURIComponent(branch);
+    const trimmedPath = path3?.replace(/^\/+/, "").replace(/\/+$/, "") ?? "";
+    const pathPart = trimmedPath ? `/${encodePathSegments(trimmedPath)}` : "/";
+    const lineFragment = typeof line === "number" && Number.isFinite(line) && line > 0 ? `#lines-${line}` : "";
+    return `${this.repoBase(ctx)}/src/${encodedBranch}${pathPart}${lineFragment}`;
+  }
+  branchList(ctx) {
+    return `${this.repoBase(ctx)}/branches/`;
+  }
+  commit(ctx, sha) {
+    return `${this.repoBase(ctx)}/commits/${encodeURIComponent(sha)}`;
+  }
+  commitList(ctx) {
+    return `${this.repoBase(ctx)}/commits/`;
+  }
+  pullRequest(ctx, id) {
+    return `${this.repoBase(ctx)}/pull-requests/${id}`;
+  }
+  pullRequestList(ctx) {
+    return `${this.repoBase(ctx)}/pull-requests/`;
+  }
+  pipelinesHome(ctx) {
+    return `${this.repoBase(ctx)}/pipelines`;
+  }
+  pipelineRun(ctx, idOrUuid) {
+    return `${this.repoBase(ctx)}/pipelines/results/${encodeURIComponent(idOrUuid)}`;
+  }
+  downloads(ctx) {
+    return `${this.repoBase(ctx)}/downloads/`;
+  }
+  issue(ctx, id) {
+    return `${this.repoBase(ctx)}/issues/${id}`;
+  }
+  issueList(ctx) {
+    return `${this.repoBase(ctx)}/issues`;
+  }
+  wiki(ctx) {
+    return `${this.repoBase(ctx)}/wiki`;
+  }
+  settings(ctx) {
+    return `${this.repoBase(ctx)}/admin`;
+  }
+  repoBase(ctx) {
+    return `${this.base}/${encodeURIComponent(ctx.workspace)}/${encodeURIComponent(ctx.repoSlug)}`;
+  }
+}
 // src/bootstrap.ts
 import { createRequire } from "module";
 
@@ -30451,6 +30517,193 @@ class UninstallCompletionCommand extends BaseCommand {
   }
 }
 
+// src/commands/browse.command.ts
+var SHA_PATTERN = /^[0-9a-f]{7,40}$/i;
+var PR_NUMBER_PATTERN = /^\d+$/;
+var PATH_LINE_PATTERN = /^(.+):(\d+)$/;
+
+class BrowseCommand extends BaseCommand {
+  contextService;
+  gitService;
+  urlBuilder;
+  name = "browse";
+  description = "Open a Bitbucket page (repo, file, PR, commit, etc.) in your browser";
+  constructor(contextService, gitService, urlBuilder, output) {
+    super(output);
+    this.contextService = contextService;
+    this.gitService = gitService;
+    this.urlBuilder = urlBuilder;
+  }
+  async execute(options, context) {
+    const repoContext = await this.contextService.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+    this.validateFlagCombination(options);
+    const url2 = await this.resolveUrl(options, repoContext);
+    const useJson = Boolean(context.globalOptions.json);
+    const printOnly = options.browser === false;
+    if (useJson) {
+      await this.output.json({ url: url2 });
+      return { url: url2, opened: false };
+    }
+    if (printOnly) {
+      this.output.text(url2);
+      return { url: url2, opened: false };
+    }
+    await this.openInBrowser(url2);
+    return { url: url2, opened: true };
+  }
+  async resolveUrl(options, ctx) {
+    if (options.pr !== undefined) {
+      return this.urlBuilder.pullRequest(ctx, this.parsePositiveInt(options.pr, "pr"));
+    }
+    if (options.prs || options.pullRequests) {
+      return this.urlBuilder.pullRequestList(ctx);
+    }
+    if (options.branches) {
+      return this.urlBuilder.branchList(ctx);
+    }
+    if (options.commits) {
+      return this.urlBuilder.commitList(ctx);
+    }
+    if (options.commit !== undefined) {
+      const sha = typeof options.commit === "string" && options.commit.length > 0 ? options.commit : await this.gitService.getCurrentCommit();
+      return this.urlBuilder.commit(ctx, sha);
+    }
+    if (options.pipelines) {
+      return this.urlBuilder.pipelinesHome(ctx);
+    }
+    if (options.pipeline !== undefined) {
+      const value = options.pipeline.trim();
+      if (value.length === 0) {
+        throw new BBError({
+          code: 5002 /* VALIDATION_INVALID */,
+          message: this.appendHelpHint("--pipeline requires a run id or uuid.")
+        });
+      }
+      return this.urlBuilder.pipelineRun(ctx, value);
+    }
+    if (options.downloads) {
+      return this.urlBuilder.downloads(ctx);
+    }
+    if (options.issue !== undefined) {
+      return this.urlBuilder.issue(ctx, this.parsePositiveInt(options.issue, "issue"));
+    }
+    if (options.issues) {
+      return this.urlBuilder.issueList(ctx);
+    }
+    if (options.wiki) {
+      return this.urlBuilder.wiki(ctx);
+    }
+    if (options.settings) {
+      return this.urlBuilder.settings(ctx);
+    }
+    const target = options.target?.trim();
+    if (target && target.length > 0) {
+      if (PR_NUMBER_PATTERN.test(target)) {
+        return this.urlBuilder.pullRequest(ctx, Number.parseInt(target, 10));
+      }
+      if (SHA_PATTERN.test(target)) {
+        return this.urlBuilder.commit(ctx, target);
+      }
+      const { path: path3, line } = this.parsePathWithLine(target);
+      const branch = await this.resolveBranch(options.branch);
+      return this.urlBuilder.src(ctx, branch, path3, line);
+    }
+    if (options.branch) {
+      return this.urlBuilder.src(ctx, options.branch);
+    }
+    return this.urlBuilder.repo(ctx);
+  }
+  validateFlagCombination(options) {
+    const setFlags = [];
+    if (options.pr !== undefined)
+      setFlags.push("--pr");
+    if (options.prs) {
+      setFlags.push("--prs");
+    } else if (options.pullRequests) {
+      setFlags.push("--pull-requests");
+    }
+    if (options.branches)
+      setFlags.push("--branches");
+    if (options.commit !== undefined)
+      setFlags.push("--commit");
+    if (options.commits)
+      setFlags.push("--commits");
+    if (options.pipelines)
+      setFlags.push("--pipelines");
+    if (options.pipeline !== undefined)
+      setFlags.push("--pipeline");
+    if (options.downloads)
+      setFlags.push("--downloads");
+    if (options.issue !== undefined)
+      setFlags.push("--issue");
+    if (options.issues)
+      setFlags.push("--issues");
+    if (options.wiki)
+      setFlags.push("--wiki");
+    if (options.settings)
+      setFlags.push("--settings");
+    if (setFlags.length > 1) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`Cannot combine ${setFlags.join(" and ")}; pick one resource.`)
+      });
+    }
+    const hasResourceFlag = setFlags.length === 1;
+    const hasTarget = !!options.target?.trim();
+    if (hasResourceFlag && hasTarget) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`Cannot use a positional target with ${setFlags[0]}.`)
+      });
+    }
+    if (hasResourceFlag && options.branch) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`Cannot combine --branch with ${setFlags[0]}.`)
+      });
+    }
+  }
+  parsePathWithLine(target) {
+    const match = PATH_LINE_PATTERN.exec(target);
+    if (match) {
+      const line = Number.parseInt(match[2], 10);
+      if (Number.isFinite(line) && line > 0) {
+        return { path: match[1], line };
+      }
+    }
+    return { path: target };
+  }
+  async resolveBranch(explicit) {
+    if (explicit && explicit.length > 0) {
+      return explicit;
+    }
+    try {
+      return await this.gitService.getCurrentBranch();
+    } catch {
+      return "HEAD";
+    }
+  }
+  parsePositiveInt(value, name) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0 || String(parsed) !== value.trim()) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`--${name} must be a positive integer.`),
+        context: { [name]: value }
+      });
+    }
+    return parsed;
+  }
+  async openInBrowser(url2) {
+    this.output.info(`Opening ${url2} in your browser...`);
+    const open2 = (await Promise.resolve().then(() => (init_open(), exports_open))).default;
+    await open2(url2);
+  }
+}
+
 // src/bootstrap.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -30497,6 +30750,7 @@ function bootstrap(options = {}) {
   });
   registerCommand(container, ServiceTokens.SnippetFilesService, SnippetFilesService, [ServiceTokens.SnippetsAxios]);
   registerCommand(container, ServiceTokens.DefaultReviewerService, DefaultReviewerService, [ServiceTokens.PullrequestsApi]);
+  container.register(ServiceTokens.UrlBuilderService, () => new UrlBuilderService);
   registerCommand(container, ServiceTokens.LoginCommand, LoginCommand, [
     ServiceTokens.CredentialStore,
     ServiceTokens.UsersApi,
@@ -30731,6 +30985,12 @@ function bootstrap(options = {}) {
     ServiceTokens.OutputService
   ]);
   registerCommand(container, ServiceTokens.ListConfigCommand, ListConfigCommand, [ServiceTokens.ConfigService, ServiceTokens.OutputService]);
+  registerCommand(container, ServiceTokens.BrowseCommand, BrowseCommand, [
+    ServiceTokens.ContextService,
+    ServiceTokens.GitService,
+    ServiceTokens.UrlBuilderService,
+    ServiceTokens.OutputService
+  ]);
   registerCommand(container, ServiceTokens.InstallCompletionCommand, InstallCompletionCommand, [ServiceTokens.OutputService]);
   registerCommand(container, ServiceTokens.UninstallCompletionCommand, UninstallCompletionCommand, [ServiceTokens.OutputService]);
   container.register(ServiceTokens.VersionService, () => {
@@ -30820,6 +31080,7 @@ var ROOT_COMPLETIONS = [
   "repo",
   "pr",
   "snippet",
+  "browse",
   "config",
   "completion",
   "--help",
@@ -31021,7 +31282,7 @@ cli.name("bb").description("A command-line interface for Bitbucket Cloud").versi
   } catch {}
 });
 var authCmd = new Command("auth").description("Authenticate with Bitbucket");
-authCmd.command("login").description("Authenticate with Bitbucket (OAuth or API token)").option("-u, --username <username>", "Bitbucket username (implies API token auth)").option("-p, --password <password>", "Bitbucket API token (implies API token auth)").option("--app-password", "Use API token authentication instead of OAuth").option("--client-id <clientId>", "Custom OAuth consumer client ID").option("--client-secret <clientSecret>", "Custom OAuth consumer client secret").addHelpText("before", `
+authCmd.command("login").description("Authenticate with Bitbucket (OAuth or API token)").option("-u, --username <username>", "Bitbucket username (implies API token auth)").option("-p, --password <password>", "Bitbucket API token (implies API token auth)").option("--app-password", "Use API token authentication (instead of OAuth). App passwords are deprecated; use API tokens.").option("--client-id <clientId>", "Custom OAuth consumer client ID").option("--client-secret <clientSecret>", "Custom OAuth consumer client secret").addHelpText("before", `
 Default: OAuth (browser-based, recommended).
 ` + `For CI/CD: API token via --app-password or BB_API_TOKEN env var.
 ` + `Note: Bitbucket app passwords are deprecated; use OAuth or an API token.
@@ -31164,7 +31425,7 @@ prCmd.command("create").description("Create a pull request").option("-t, --title
   const context = createContext(cli);
   await runCommand(ServiceTokens.CreatePRCommand, withGlobalOptions(options, context), cli, context);
 });
-prCmd.command("list").description("List pull requests").option("-s, --state <state>", `Filter by state (${PR_STATES.join(", ")})`, "OPEN").option("--limit <number>", "Maximum number of PRs to list", "25").option("--mine", "Show only PRs where you are a reviewer").addHelpText("after", buildHelpText({
+prCmd.command("list").description("List pull requests").option("-s, --state <state>", `Filter by state (${PR_STATES.join(", ")})`, "OPEN").option("--limit <number>", "Maximum number of PRs to list", "25").option("--mine", "Show only PRs where you are a reviewer (not authored by you)").addHelpText("after", buildHelpText({
   examples: [
     "bb pr list",
     "bb pr list -s MERGED --limit 10",
@@ -31358,23 +31619,23 @@ prReviewersCmd.command("list <id>").description("List reviewers on a pull reques
   const context = createContext(cli);
   await runCommand(ServiceTokens.ListReviewersPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prReviewersCmd.command("add <id> <username>").description("Add a reviewer to a pull request").addHelpText("after", buildHelpText({
+prReviewersCmd.command("add <id> <user>").description("Add a reviewer to a pull request (user is an account ID or {uuid})").addHelpText("after", buildHelpText({
   examples: [
     'bb pr reviewers add 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"',
     'bb pr reviewers add 42 "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"'
   ]
-})).action(async (id, username, options) => {
+})).action(async (id, user, options) => {
   const context = createContext(cli);
-  await runCommand(ServiceTokens.AddReviewerPRCommand, withGlobalOptions({ id, username, ...options }, context), cli, context);
+  await runCommand(ServiceTokens.AddReviewerPRCommand, withGlobalOptions({ id, username: user, ...options }, context), cli, context);
 });
-prReviewersCmd.command("remove <id> <username>").description("Remove a reviewer from a pull request").addHelpText("after", buildHelpText({
+prReviewersCmd.command("remove <id> <user>").description("Remove a reviewer from a pull request (user is an account ID or {uuid})").addHelpText("after", buildHelpText({
   examples: [
     'bb pr reviewers remove 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"',
     'bb pr reviewers remove 42 "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"'
   ]
-})).action(async (id, username, options) => {
+})).action(async (id, user, options) => {
   const context = createContext(cli);
-  await runCommand(ServiceTokens.RemoveReviewerPRCommand, withGlobalOptions({ id, username, ...options }, context), cli, context);
+  await runCommand(ServiceTokens.RemoveReviewerPRCommand, withGlobalOptions({ id, username: user, ...options }, context), cli, context);
 });
 cli.addCommand(prCmd);
 prCmd.addCommand(prCommentsCmd);
@@ -31405,7 +31666,7 @@ snippetCmd.command("view <id>").description("View snippet details").option("-f,
   const context = createContext(cli);
   await runCommand(ServiceTokens.ViewSnippetCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-snippetCmd.command("create").description("Create a new snippet").option("-t, --title <title>", "Snippet title").option("-f, --file <path...>", "File(s) to include").option("--private", "Create a private snippet (default)").option("--public", "Create a public snippet").addHelpText("after", buildHelpText({
+snippetCmd.command("create").description("Create a new snippet").option("-t, --title <title>", "Snippet title").option("-f, --file <path...>", "File(s) to include (variadic; pass multiple paths or repeat the flag)").option("--private", "Create a private snippet (default)").option("--public", "Create a public snippet").addHelpText("after", buildHelpText({
   examples: [
     'bb snippet create -t "My snippet" -f file.txt',
     'bb snippet create -t "Config files" -f config.yml -f setup.sh --public'
@@ -31415,7 +31676,7 @@ snippetCmd.command("create").description("Create a new snippet").option("-t, --t
   const context = createContext(cli);
   await runCommand(ServiceTokens.CreateSnippetCommand, withGlobalOptions(options, context), cli, context);
 });
-snippetCmd.command("edit <id>").description("Edit a snippet").option("-t, --title <title>", "New snippet title").option("--private", "Make snippet private").option("--public", "Make snippet public").option("-f, --file <path...>", "Replace/add file(s) (sends multipart update)").addHelpText("after", buildHelpText({
+snippetCmd.command("edit <id>").description("Edit a snippet").option("-t, --title <title>", "New snippet title").option("--private", "Make snippet private").option("--public", "Make snippet public").option("-f, --file <path...>", "Replace/add file(s) (variadic; pass multiple paths or repeat the flag; sends multipart update)").addHelpText("after", buildHelpText({
   examples: [
     'bb snippet edit kypj -t "New title"',
     "bb snippet edit kypj --public",
@@ -31488,6 +31749,26 @@ snippetCommentsCmd.command("delete <snippet-id> <comment-id>").description("Dele
 });
 snippetCmd.addCommand(snippetCommentsCmd);
 cli.addCommand(snippetCmd);
+cli.command("browse [target]").description("Open a Bitbucket page (repo home, file, PR, commit, etc.) in your browser").option("--pr <id>", "Open a specific pull request").option("--prs", "Open the pull-requests list").option("--pull-requests", "Alias for --prs").option("--branch <name>", "Open the branch source tree (or, with <target>, that path on the branch)").option("--branches", "Open the branches list").option("--commit [sha]", "Open a specific commit (defaults to HEAD when no SHA is given)").option("--commits", "Open the commits list").option("--pipelines", "Open the pipelines page").option("--pipeline <id>", "Open a specific pipeline run").option("--downloads", "Open the downloads page").option("--issue <id>", "Open a specific issue").option("--issues", "Open the issue tracker").option("--wiki", "Open the wiki").option("--settings", "Open repository settings").option("-n, --no-browser", "Print the URL to stdout instead of opening it").addHelpText("after", buildHelpText({
+  examples: [
+    "bb browse",
+    "bb browse src/cli.ts",
+    "bb browse src/cli.ts:42",
+    "bb browse --branch release/2.0 src/cli.ts",
+    "bb browse 217",
+    "bb browse --pr 217",
+    "bb browse --prs",
+    "bb browse abc1234",
+    "bb browse --commit",
+    "bb browse --pipelines",
+    "bb browse --settings",
+    "bb browse --pr 217 --no-browser",
+    "bb browse --pr 217 --json url"
+  ]
+})).action(async (target, options) => {
+  const context = createContext(cli);
+  await runCommand(ServiceTokens.BrowseCommand, withGlobalOptions({ target, ...options }, context), cli, context);
+});
 var configCmd = new Command("config").description("Manage configuration");
 configCmd.command("get <key>").description("Get a configuration value").addHelpText("after", buildHelpText({
   examples: ["bb config get defaultWorkspace"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilatos/bitbucket-cli",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "A command-line interface for Bitbucket Cloud",
   "author": "",
   "license": "MIT",