feat(blobs): add a --region flag to the blobs commands

[paulo]

The blobs:* commands opened every store without a region, so they could only ever read the default one. There was no way to target a store whose data is held in another region, which meant the CLI could not be used to confirm where data actually is.

The API path already honours the region, so this adds a --region flag to the four commands and passes it through to getStore. An unsupported value is rejected by the client with the list of supported regions.

Omitting the flag is unchanged behaviour: no region is sent, and the API picks its default.

Requires @netlify/blobs 11.1.0 (bumped here from 11.0.3) — that release is where region became an option on site-wide stores, so the flag does not type-check without it.

[coderabbitai]

Understand this PR’s impact

Explore downstream dependencies and potential security impact with Blast Radius.

View blast radius →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: c5ee10fd-902e-4590-ba87-b929d11c69e6

📥 Commits

Reviewing files that changed from the base of the PR and between 1e2da46 and 0308339.

📒 Files selected for processing (7)

• docs/commands/blobs.md
• src/commands/blobs/blobs-delete.ts
• src/commands/blobs/blobs-get.ts
• src/commands/blobs/blobs-list.ts
• src/commands/blobs/blobs-set.ts
• src/commands/blobs/blobs.ts
• tests/integration/commands/blobs/blobs.test.ts

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

• netlify/blueprints (manual)

Included review availability: 9 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.

---

📝 Summary

Summary by CodeRabbit

• New Features

  • Added an optional --region flag to the blobs:delete, blobs:get, blobs:list, and blobs:set commands.
  • Commands use the default region when no region is specified and validate supported region values.
  • Added region-specific usage guidance and examples for blob commands.

• Tests

  • Added coverage verifying regional requests, default behavior, and rejection of unsupported regions.

Walkthrough

Added an optional --region option to the blobs:delete, blobs:get, blobs:list, and blobs:set commands. Each command forwards the region to getStore. Documentation and integration tests cover regional requests, omitted regions, and unsupported regions.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~15 minutes

Change: Feature

Suggested reviewers: serhalp

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely identifies the main change: adding a --region flag to the blobs commands.
Description check	✅ Passed	The description directly explains the existing limitation, the new --region flag, default behavior, validation, and required dependency update.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 6…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

📊 Benchmark results

Comparing with 1e2da46

• Dependency count: 1,073 (no change)
• Package size: 422 MB (no change)
• Number of ts-expect-error directives: 346 (no change)

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/netlify-cli@8521

commit: 0308339