@pilatos/bitbucket-cli 1.17.0 → 1.19.0

package/README.md

@@ -93,7 +93,7 @@ bb browse src/cli.ts:20       # open a file at a specific line
 bb config set defaultWorkspace myworkspace
 ```
 
-**Global options:** `--json [fields]`, `--jq <expression>`, `--no-color`, `-w, --workspace`, `-r, --repo`
+**Global options** (work on every command): `--json [fields]`, `--jq`, `--no-color`, `--no-unicode`, `--no-truncate`, `--limit`, `--all`, `--locale`, `-w, --workspace`, `-r, --repo`. Full reference: [Global Flags](https://bitbucket-cli.paulvanderlei.com/reference/global-flags/).
 
 ### Scripting with `--json` and `--jq`
 
@@ -135,13 +135,16 @@ Full documentation: **[bitbucket-cli.paulvanderlei.com](https://bitbucket-cli.pa
 
 ## Environment Variables
 
-| Variable       | Description                                                |
-| -------------- | ---------------------------------------------------------- |
-| `BB_USERNAME`  | Bitbucket username (fallback for `bb auth login`)          |
-| `BB_API_TOKEN` | Bitbucket API token (fallback for `bb auth login`; for CI) |
-| `DEBUG`        | Enable HTTP debug logging when set to `true`               |
-| `NO_COLOR`     | Disable color output when set                              |
-| `FORCE_COLOR`  | Force color output when set (and not `0`)                  |
+| Variable        | Description                                                            |
+| --------------- | ---------------------------------------------------------------------- |
+| `BB_USERNAME`   | Bitbucket username (fallback for `bb auth login`)                      |
+| `BB_API_TOKEN`  | Bitbucket API token (fallback for `bb auth login`; for CI)             |
+| `BB_WORKSPACE`  | Default workspace; overrides `defaultWorkspace` config                 |
+| `BB_LOCALE`     | BCP-47 locale for date/time formatting (e.g. `de-DE`); `--locale` wins |
+| `BB_NO_UNICODE` | Use ASCII fallbacks for symbols when set (any non-empty value)         |
+| `DEBUG`         | Enable HTTP debug logging — must equal exactly `true`                  |
+| `NO_COLOR`      | Disable color output when set                                          |
+| `FORCE_COLOR`   | Force color output when set (and not `0`)                              |
 
 Full reference: [Environment variables](https://bitbucket-cli.paulvanderlei.com/reference/environment-variables/).
 

package/dist/index.js

@@ -17941,8 +17941,7 @@ class ContextService {
       };
     }
     if (options.repo) {
-      const config = await this.configService.getConfig();
-      const workspace = gitContext?.workspace || config.defaultWorkspace;
+      const workspace = gitContext?.workspace ?? await this.resolveDefaultWorkspace();
       if (workspace) {
         return {
           context: { workspace, repoSlug: options.repo },
@@ -17953,6 +17952,21 @@ class ContextService {
     }
     return gitResult;
   }
+  async resolveDefaultWorkspace() {
+    const fromEnv = process.env.BB_WORKSPACE;
+    if (typeof fromEnv === "string") {
+      const trimmed = fromEnv.trim();
+      if (trimmed.length > 0) {
+        return trimmed;
+      }
+    }
+    const config = await this.configService.getConfig();
+    const fromConfig = config.defaultWorkspace;
+    if (typeof fromConfig === "string" && fromConfig.length > 0) {
+      return fromConfig;
+    }
+    return;
+  }
   async requireRepoContext(options) {
     const result = await this.resolveRepoContext(options);
     if (!result.context) {
@@ -17990,9 +18004,9 @@ class ContextService {
     if (explicit && explicit.length > 0) {
       return explicit;
     }
-    const config = await this.configService.getConfig();
-    if (config.defaultWorkspace && config.defaultWorkspace.length > 0) {
-      return config.defaultWorkspace;
+    const fallback = await this.resolveDefaultWorkspace();
+    if (fallback) {
+      return fallback;
     }
     throw new BBError({
       code: 6002 /* CONTEXT_WORKSPACE_NOT_FOUND */,
@@ -18785,8 +18799,9 @@ class OutputService {
     if (rows.length === 0) {
       return;
     }
-    const sanitizedHeaders = headers.map(stripControl);
-    const sanitizedRows = rows.map((row) => row.map((cell) => stripControl(cell || "")));
+    const sanitizeCell = (cell) => stripControl(cell).replace(/[\t\n\r]+/g, " ");
+    const sanitizedHeaders = headers.map(sanitizeCell);
+    const sanitizedRows = rows.map((row) => row.map((cell) => sanitizeCell(cell || "")));
     const widths = sanitizedHeaders.map((header, index) => {
       const maxRowWidth = Math.max(...sanitizedRows.map((row) => (row[index] || "").length));
       return Math.max(header.length, maxRowWidth);
@@ -23570,11 +23585,14 @@ function parseLimit(limit, fallback = DEFAULT_LIMIT) {
   }
   return parsed;
 }
-async function collectPages(options) {
+function resolveLimit(options) {
+  return options.all ? Number.POSITIVE_INFINITY : parseLimit(options.limit);
+}
+async function collectPagesWithMeta(options) {
   const { fetchPage, shouldInclude } = options;
   const limit = Math.max(0, options.limit);
   if (limit === 0) {
-    return [];
+    return { items: [], hasMore: false };
   }
   const requestedPageSize = options.pageSize ?? limit;
   const pagelen = Math.max(1, Math.min(requestedPageSize, MAX_PAGE_LENGTH));
@@ -23586,13 +23604,15 @@ async function collectPages(options) {
     if (pageValues.length === 0) {
       break;
     }
-    for (const value of pageValues) {
+    for (let i = 0;i < pageValues.length; i += 1) {
+      const value = pageValues[i];
       if (shouldInclude && !shouldInclude(value)) {
         continue;
       }
       items.push(value);
       if (items.length >= limit) {
-        return items;
+        const moreOnThisPage = pageValues.slice(i + 1).some((rest) => !shouldInclude || shouldInclude(rest));
+        return { items, hasMore: moreOnThisPage || Boolean(data.next) };
       }
     }
     if (!data.next) {
@@ -23600,7 +23620,10 @@ async function collectPages(options) {
     }
     page += 1;
   }
-  return items;
+  return { items, hasMore: false };
+}
+async function collectPages(options) {
+  return (await collectPagesWithMeta(options)).items;
 }
 
 // src/services/default-reviewer.service.ts
@@ -27584,6 +27607,11 @@ class BaseCommand {
     }
     return this.output.truncate(text, maxLength);
   }
+  printMoreHint(shown, hasMore, noun = "results") {
+    if (!hasMore)
+      return;
+    this.output.text(this.output.dim(`Showing ${shown} ${noun}. Use --limit <n> or --all to see more.`));
+  }
   requireConfirmation(confirmed, warning) {
     if (confirmed)
       return;
@@ -28278,8 +28306,8 @@ class ListReposCommand extends BaseCommand {
   }
   async execute(options, context) {
     const workspace = await this.contextService.requireWorkspace(options.workspace ?? context.globalOptions.workspace);
-    const limit = parseLimit(options.limit);
-    const repos = await collectPages({
+    const limit = resolveLimit(options);
+    const { items: repos, hasMore } = await collectPagesWithMeta({
       limit,
       fetchPage: async (page, pagelen) => {
         const response = await this.repositoriesApi.repositoriesWorkspaceGet({
@@ -28308,6 +28336,7 @@ class ListReposCommand extends BaseCommand {
       this.truncateText(repo.description ?? "", 50, context.globalOptions)
     ]);
     this.output.table(["REPOSITORY", "VISIBILITY", "DESCRIPTION"], rows);
+    this.printMoreHint(repos.length, hasMore, "repositories");
   }
 }
 
@@ -28675,9 +28704,9 @@ class ListPRsCommand extends BaseCommand {
   async execute(options, context) {
     const repoContext = await this.contextService.requireRepoContextFor(options, context);
     const state = options.state ? this.parseEnumOption(options.state, "state", PR_STATES) : "OPEN";
-    const limit = parseLimit(options.limit);
+    const limit = resolveLimit(options);
     const reviewerQuery = options.mine ? await this.buildMineFilter() : undefined;
-    const values = await collectPages({
+    const { items: values, hasMore } = await collectPagesWithMeta({
       limit,
       fetchPage: async (page, pagelen) => {
         const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsGet({
@@ -28724,6 +28753,7 @@ class ListPRsCommand extends BaseCommand {
       ];
     });
     this.output.table(["ID", "TITLE", "AUTHOR", "BRANCHES"], rows);
+    this.printMoreHint(values.length, hasMore, "pull requests");
   }
   async buildMineFilter() {
     const response = await this.usersApi.userGet();
@@ -29421,8 +29451,8 @@ class ActivityPRCommand extends BaseCommand {
     const repoContext = await this.contextService.requireRepoContextFor(options, context);
     const prId = this.parsePositiveInt(options.id, "id");
     const filterTypes = this.parseTypeFilter(options.type);
-    const limit = parseLimit(options.limit);
-    const activities = await collectPages({
+    const limit = resolveLimit(options);
+    const { items: activities, hasMore } = await collectPagesWithMeta({
       limit,
       fetchPage: async (page, pagelen) => {
         const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdActivityGet({
@@ -29472,6 +29502,7 @@ class ActivityPRCommand extends BaseCommand {
       ];
     });
     this.output.table(["TYPE", "ACTOR", "DATE", "DETAILS"], rows);
+    this.printMoreHint(activities.length, hasMore, "activity entries");
   }
   parseTypeFilter(typeOption) {
     if (!typeOption) {
@@ -29658,8 +29689,8 @@ class ListCommentsPRCommand extends BaseCommand {
   async execute(options, context) {
     const repoContext = await this.contextService.requireRepoContextFor(options, context);
     const prId = this.parsePositiveInt(options.id, "id");
-    const limit = parseLimit(options.limit);
-    const values = await collectPages({
+    const limit = resolveLimit(options);
+    const { items: values, hasMore } = await collectPagesWithMeta({
       limit,
       fetchPage: async (page, pagelen) => {
         const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdCommentsGet({
@@ -29696,6 +29727,7 @@ class ListCommentsPRCommand extends BaseCommand {
       ];
     });
     this.output.table(["ID", "Author", "Content", "Date"], rows);
+    this.printMoreHint(values.length, hasMore, "comments");
   }
 }
 
@@ -30025,9 +30057,9 @@ class ListSnippetsCommand extends BaseCommand {
   }
   async execute(options, context) {
     const workspace = await this.contextService.requireWorkspace(options.workspace ?? context.globalOptions.workspace);
-    const limit = parseLimit(options.limit);
+    const limit = resolveLimit(options);
     const role = options.role ? this.parseEnumOption(options.role, "role", VALID_ROLES) : undefined;
-    const snippets = await collectPages({
+    const { items: snippets, hasMore } = await collectPagesWithMeta({
       limit,
       fetchPage: async (page, pagelen) => {
         const response = await this.snippetsApi.snippetsWorkspaceGet({
@@ -30059,6 +30091,7 @@ class ListSnippetsCommand extends BaseCommand {
       this.output.formatDate(snippet.updated_on ?? "")
     ]);
     this.output.table(["ID", "TITLE", "VISIBILITY", "CREATOR", "UPDATED"], rows);
+    this.printMoreHint(snippets.length, hasMore, "snippets");
   }
 }
 
@@ -30383,8 +30416,8 @@ class ListSnippetCommentsCommand extends BaseCommand {
   }
   async execute(options, context) {
     const workspace = await this.contextService.requireWorkspace(options.workspace ?? context.globalOptions.workspace);
-    const limit = parseLimit(options.limit);
-    const comments = await collectPages({
+    const limit = resolveLimit(options);
+    const { items: comments, hasMore } = await collectPagesWithMeta({
       limit,
       fetchPage: async (page, pagelen) => {
         const response = await this.snippetsApi.snippetsWorkspaceEncodedIdCommentsGet({
@@ -30419,6 +30452,7 @@ class ListSnippetCommentsCommand extends BaseCommand {
       ];
     });
     this.output.table(["ID", "AUTHOR", "DATE", "CONTENT"], rows);
+    this.printMoreHint(comments.length, hasMore, "comments");
   }
 }
 
@@ -31481,14 +31515,15 @@ function withGlobalOptions(options, context) {
   };
 }
 var cli = new Command;
-cli.name("bb").description("A command-line interface for Bitbucket Cloud").version(pkg2.version).option("--json [fields]", "Output as JSON; optionally project to a comma-separated field list (e.g. number,title,author.display_name)").option("--jq <expression>", `Filter the JSON output through a jq expression \u2014 runs in-process via embedded jq, requires --json (e.g. '.pullRequests[] | select(.state == "OPEN") | .title')`).option("--no-color", "Disable color output").option("--no-unicode", "Use ASCII fallbacks for symbols (separators, arrows, status icons) \u2014 also enabled by BB_NO_UNICODE").option("--no-truncate", "Show full values in table output without truncation").option("--locale <locale>", "BCP-47 locale tag for date/time formatting (e.g. de-DE, ja-JP). Falls back to BB_LOCALE, then LC_TIME/LC_ALL/LANG, then en-US.").option("-w, --workspace <workspace>", "Specify workspace").option("-r, --repo <repo>", "Specify repository").addHelpText("after", buildHelpText({
+cli.name("bb").description("A command-line interface for Bitbucket Cloud").version(pkg2.version).option("--json [fields]", "Output as JSON; optionally project to a comma-separated field list (e.g. number,title,author.display_name)").option("--jq <expression>", `Filter the JSON output through a jq expression \u2014 runs in-process via embedded jq, requires --json (e.g. '.pullRequests[] | select(.state == "OPEN") | .title')`).option("--no-color", "Disable color output").option("--no-unicode", "Use ASCII fallbacks for symbols (separators, arrows, status icons) \u2014 also enabled by BB_NO_UNICODE").option("--no-truncate", "Show full values in table output without truncation").option("--locale <locale>", "BCP-47 locale tag for date/time formatting (e.g. de-DE, ja-JP). Falls back to BB_LOCALE, then LC_TIME/LC_ALL/LANG, then en-US.").option("-w, --workspace <workspace>", "Specify workspace (falls back to BB_WORKSPACE, then config defaultWorkspace)").option("-r, --repo <repo>", "Specify repository").addHelpText("after", buildHelpText({
   envVars: {
     BB_USERNAME: "Bitbucket username (fallback for auth login)",
     BB_API_TOKEN: "Bitbucket API token (fallback for auth login)",
+    BB_WORKSPACE: "Default workspace (overrides config.defaultWorkspace; --workspace still wins)",
     NO_COLOR: "Disable color output when set",
     FORCE_COLOR: "Force color output when set (and not '0')",
     BB_NO_UNICODE: "Use ASCII fallbacks for symbols when set (any non-empty value)",
-    DEBUG: "Enable HTTP debug logging when 'true'",
+    DEBUG: "Enable HTTP debug logging when exactly 'true'",
     BB_LOCALE: "BCP-47 locale tag for date/time formatting; --locale takes precedence"
   },
   seeAlso: [
@@ -31586,10 +31621,11 @@ repoCmd.command("create <name>").description("Create a new repository").option("
   const context = createContext(cli);
   await runCommand(ServiceTokens.CreateRepoCommand, withGlobalOptions({ name, ...options }, context), cli, context);
 });
-repoCmd.command("list").description("List repositories").option("--limit <number>", "Maximum number of repositories to list", "25").addHelpText("after", buildHelpText({
+repoCmd.command("list").description("List repositories").option("--limit <number>", "Maximum number of repositories to list", "25").option("--all", "List all repositories (overrides --limit)").addHelpText("after", buildHelpText({
   examples: [
     "bb repo list",
     "bb repo list --limit 50",
+    "bb repo list --all",
     "bb repo list --json"
   ],
   defaults: { limit: "25" }
@@ -31675,10 +31711,11 @@ 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 (not authored by you)").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("--all", "List all pull requests (overrides --limit)").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",
+    "bb pr list --all",
     "bb pr list --mine",
     "bb pr list --json"
   ],
@@ -31706,10 +31743,11 @@ prCmd.command("view <id>").description("View pull request details").addHelpText(
   const context = createContext(cli);
   await runCommand(ServiceTokens.ViewPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("activity <id>").description("Show pull request activity log").option("--limit <number>", "Maximum number of activity entries", "25").option("--type <types>", "Filter activity by type (comma-separated)").addHelpText("after", buildHelpText({
+prCmd.command("activity <id>").description("Show pull request activity log").option("--limit <number>", "Maximum number of activity entries", "25").option("--all", "Show all activity entries (overrides --limit)").option("--type <types>", "Filter activity by type (comma-separated)").addHelpText("after", buildHelpText({
   examples: [
     "bb pr activity 42",
     "bb pr activity 42 --type comment,approval",
+    "bb pr activity 42 --all",
     "bb pr activity 42 --limit 10 --json"
   ],
   validValues: {
@@ -31824,10 +31862,11 @@ prCmd.command("diff [id]").description("View pull request diff").option("--color
   await runCommand(ServiceTokens.DiffPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
 var prCommentsCmd = new Command("comments").description("Manage pull request comments");
-prCommentsCmd.command("list <id>").description("List comments on a pull request").option("--limit <number>", "Maximum number of comments (default: 25)").addHelpText("after", buildHelpText({
+prCommentsCmd.command("list <id>").description("List comments on a pull request").option("--limit <number>", "Maximum number of comments (default: 25)").option("--all", "List all comments (overrides --limit)").addHelpText("after", buildHelpText({
   examples: [
     "bb pr comments list 42",
     "bb pr comments list 42 --no-truncate",
+    "bb pr comments list 42 --all",
     "bb pr comments list 42 --limit 50 --json"
   ],
   defaults: { limit: "25" }
@@ -31891,10 +31930,11 @@ cli.addCommand(prCmd);
 prCmd.addCommand(prCommentsCmd);
 prCmd.addCommand(prReviewersCmd);
 var snippetCmd = new Command("snippet").description("Manage snippets");
-snippetCmd.command("list").description("List snippets in a workspace").option("--role <role>", "Filter by role (owner, contributor, member)").option("--limit <number>", "Maximum number of snippets to list", "25").addHelpText("after", buildHelpText({
+snippetCmd.command("list").description("List snippets in a workspace").option("--role <role>", "Filter by role (owner, contributor, member)").option("--limit <number>", "Maximum number of snippets to list", "25").option("--all", "List all snippets (overrides --limit)").addHelpText("after", buildHelpText({
   examples: [
     "bb snippet list",
     "bb snippet list --role owner",
+    "bb snippet list --all",
     "bb snippet list --limit 50 --json"
   ],
   validValues: {
@@ -31958,9 +31998,10 @@ snippetCmd.command("unwatch <id>").description("Stop watching a snippet").addHel
   await runCommand(ServiceTokens.UnwatchSnippetCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
 var snippetCommentsCmd = new Command("comments").description("Manage snippet comments");
-snippetCommentsCmd.command("list <id>").description("List comments on a snippet").option("--limit <number>", "Maximum number of comments", "25").addHelpText("after", buildHelpText({
+snippetCommentsCmd.command("list <id>").description("List comments on a snippet").option("--limit <number>", "Maximum number of comments", "25").option("--all", "List all comments (overrides --limit)").addHelpText("after", buildHelpText({
   examples: [
     "bb snippet comments list kypj",
+    "bb snippet comments list kypj --all",
     "bb snippet comments list kypj --limit 50 --json"
   ],
   defaults: { limit: "25" }
@@ -32092,5 +32133,5 @@ if (typeof Bun === "undefined") {
 }
 cli.parse(process.argv);
 
-//# debugId=1F677A9695E119AD64756E2164756E21
+//# debugId=C24B0C4332F9755664756E2164756E21
 //# sourceMappingURL=index.js.map