[GH-ISSUE #207] Add Build Bundles CLI support #68

New issue

Closed

opened 2026-02-26 21:33:08 +03:00 by kerem · 1 comment

kerem commented

2026-02-26 21:33:08 +03:00

Owner

Originally created by @rudrankriyam on GitHub (Jan 26, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/207

Originally assigned to: @rudrankriyam on GitHub.

Overview

Add CLI support to read Build Bundle metadata and related App Clip signals: file sizes, domain cache/debug status, and beta App Clip invocations.

Docs (API)

Build Bundles: https://sosumi.ai/documentation/appstoreconnectapi/build-bundles
BuildBundle object: https://sosumi.ai/documentation/appstoreconnectapi/buildbundle
BuildBundleFileSize: https://sosumi.ai/documentation/appstoreconnectapi/buildbundlefilesize

Scope (Endpoints)

From Build Bundles docs:

GET /v1/buildBundles/{id}/appClipDomainCacheStatus
GET /v1/buildBundles/{id}/appClipDomainDebugStatus
GET /v1/buildBundles/{id}/betaAppClipInvocations
GET /v1/buildBundles/{id}/buildBundleFileSizes
Relationship endpoints for the above resources

(Discovery) Confirm how to list build bundles for a build (likely GET /v1/builds/{id}/buildBundles or include=buildBundles). Add list support accordingly.

Proposed CLI

asc build-bundles list --build-id BUILD_ID
asc build-bundles file-sizes list --build-bundle-id BUNDLE_ID
asc build-bundles app-clip cache-status get --build-bundle-id BUNDLE_ID
asc build-bundles app-clip debug-status get --build-bundle-id BUNDLE_ID
asc build-bundles app-clip invocations list --build-bundle-id BUNDLE_ID

Flags

Common:

--output json|table|markdown
--pretty
--limit, --next, --paginate (for list endpoints)

Output

JSON (minified) by default
Table/markdown for list endpoints
File sizes should surface device type, size, and bundle type

Acceptance Criteria

asc build-bundles --help available
Can list build bundles for a build (discovery step resolved)
Can list build bundle file sizes
Can read App Clip domain cache/debug status
Can list beta App Clip invocations
JSON/table/markdown output

Tests

CLI validation tests (missing --build-id / --build-bundle-id)
Client tests for the list/get endpoints
Output tests for table/markdown

Manual Test Plan (using real apps)

Find a build:
- asc builds list --app APP_ID --limit 1 --output json
List build bundles:
- asc build-bundles list --build-id BUILD_ID
Use BUNDLE_ID from step 2:
- asc build-bundles file-sizes list --build-bundle-id BUNDLE_ID
- asc build-bundles app-clip cache-status get --build-bundle-id BUNDLE_ID
- asc build-bundles app-clip debug-status get --build-bundle-id BUNDLE_ID
- asc build-bundles app-clip invocations list --build-bundle-id BUNDLE_ID

Notes:

App Clip endpoints may return empty/404 if the build has no App Clip; handle gracefully.

Implementation Notes

Add internal/asc/build_bundles.go with response types and client methods.
Add output helpers in internal/asc/build_bundles_output.go.
Add commands in cmd/build_bundles.go and register in cmd/root.go.
Add resource type constants in internal/asc/client_types.go if needed.

Originally created by @rudrankriyam on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/207 Originally assigned to: @rudrankriyam on GitHub. # Overview Add CLI support to read **Build Bundle** metadata and related App Clip signals: file sizes, domain cache/debug status, and beta App Clip invocations. # Docs (API) - Build Bundles: https://sosumi.ai/documentation/appstoreconnectapi/build-bundles - BuildBundle object: https://sosumi.ai/documentation/appstoreconnectapi/buildbundle - BuildBundleFileSize: https://sosumi.ai/documentation/appstoreconnectapi/buildbundlefilesize # Scope (Endpoints) From Build Bundles docs: - `GET /v1/buildBundles/{id}/appClipDomainCacheStatus` - `GET /v1/buildBundles/{id}/appClipDomainDebugStatus` - `GET /v1/buildBundles/{id}/betaAppClipInvocations` - `GET /v1/buildBundles/{id}/buildBundleFileSizes` - Relationship endpoints for the above resources (Discovery) Confirm how to **list build bundles** for a build (likely `GET /v1/builds/{id}/buildBundles` or `include=buildBundles`). Add list support accordingly. # Proposed CLI ``` asc build-bundles list --build-id BUILD_ID asc build-bundles file-sizes list --build-bundle-id BUNDLE_ID asc build-bundles app-clip cache-status get --build-bundle-id BUNDLE_ID asc build-bundles app-clip debug-status get --build-bundle-id BUNDLE_ID asc build-bundles app-clip invocations list --build-bundle-id BUNDLE_ID ``` # Flags Common: - `--output json|table|markdown` - `--pretty` - `--limit`, `--next`, `--paginate` (for list endpoints) # Output - JSON (minified) by default - Table/markdown for list endpoints - File sizes should surface device type, size, and bundle type # Acceptance Criteria - [ ] `asc build-bundles --help` available - [ ] Can list build bundles for a build (discovery step resolved) - [ ] Can list build bundle file sizes - [ ] Can read App Clip domain cache/debug status - [ ] Can list beta App Clip invocations - [ ] JSON/table/markdown output # Tests - CLI validation tests (missing --build-id / --build-bundle-id) - Client tests for the list/get endpoints - Output tests for table/markdown # Manual Test Plan (using real apps) 1) Find a build: - `asc builds list --app APP_ID --limit 1 --output json` 2) List build bundles: - `asc build-bundles list --build-id BUILD_ID` 3) Use BUNDLE_ID from step 2: - `asc build-bundles file-sizes list --build-bundle-id BUNDLE_ID` - `asc build-bundles app-clip cache-status get --build-bundle-id BUNDLE_ID` - `asc build-bundles app-clip debug-status get --build-bundle-id BUNDLE_ID` - `asc build-bundles app-clip invocations list --build-bundle-id BUNDLE_ID` Notes: - App Clip endpoints may return empty/404 if the build has no App Clip; handle gracefully. # Implementation Notes - Add `internal/asc/build_bundles.go` with response types and client methods. - Add output helpers in `internal/asc/build_bundles_output.go`. - Add commands in `cmd/build_bundles.go` and register in `cmd/root.go`. - Add resource type constants in `internal/asc/client_types.go` if needed.

kerem closed this issue

2026-02-26 21:33:09 +03:00

kerem commented

2026-02-26 21:33:09 +03:00

Author

Owner

@rudrankriyam commented on GitHub (Jan 27, 2026):

Closed as fixed by #227. PRs: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/227

@rudrankriyam commented on GitHub (Jan 27, 2026): Closed as fixed by #227. PRs: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/227