starred/App-Store-Connect-CLI

Fork 0

mirror of https://github.com/rudrankriyam/App-Store-Connect-CLI.git synced 2026-04-25 15:45:48 +03:00

[GH-ISSUE #244] Add Actors CLI support (list/get) #72

New issue

Closed

opened 2026-02-26 21:33:09 +03:00 by kerem · 3 comments

kerem commented

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

Owner

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

Overview

Add CLI support for Actors: listing and retrieving actor information using the App Store Connect API. This enables querying actor data from the CLI with JSON-first output and explicit flags.

Scope

Primary resources from the OpenAPI spec:

actors (list/get only - read-only resource)

Proposed CLI

Top-level group:

asc actors <subcommand> [flags]

Subcommands:

actors list|get (for actors)

Examples:

asc actors list
asc actors get --actor-id ACTOR_ID
asc actors list --limit 50 --paginate

Flag patterns

Common:

--output, --pretty, --limit, --next, --paginate

Resource-specific examples:

--actor-id

Output

JSON minified by default
--pretty for JSON
--output table/markdown for list commands

Acceptance criteria

Commands appear in asc --help and asc actors --help
List command works for actors
Get command works for individual actors
Pagination flags work (--paginate, --next, --limit)
JSON-first output matches existing conventions
Table and markdown output for list commands

Tests

Unit tests for command flag validation and error cases
HTTP client tests for list/get
Output tests for table/markdown

Implementation notes

Add cmd/actors*.go and internal/asc/client_actors*.go
Add output helpers in internal/asc/output_actors.go
Register command in cmd/root.go
Add resource type constants in internal/asc/client_types.go
Follow patterns in cmd/users.go, cmd/apps.go, and output helpers in internal/asc/output_*

Originally created by @rudrankriyam on GitHub (Jan 28, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/244 # Overview Add CLI support for Actors: listing and retrieving actor information using the App Store Connect API. This enables querying actor data from the CLI with JSON-first output and explicit flags. # Scope Primary resources from the OpenAPI spec: - `actors` (list/get only - read-only resource) # Proposed CLI Top-level group: - `asc actors <subcommand> [flags]` Subcommands: - `actors list|get` (for `actors`) Examples: - `asc actors list` - `asc actors get --actor-id ACTOR_ID` - `asc actors list --limit 50 --paginate` # Flag patterns Common: - `--output`, `--pretty`, `--limit`, `--next`, `--paginate` Resource-specific examples: - `--actor-id` # Output - JSON minified by default - `--pretty` for JSON - `--output table/markdown` for list commands # Acceptance criteria - [ ] Commands appear in `asc --help` and `asc actors --help` - [ ] List command works for actors - [ ] Get command works for individual actors - [ ] Pagination flags work (`--paginate`, `--next`, `--limit`) - [ ] JSON-first output matches existing conventions - [ ] Table and markdown output for list commands # Tests - Unit tests for command flag validation and error cases - HTTP client tests for list/get - Output tests for table/markdown # Implementation notes - Add `cmd/actors*.go` and `internal/asc/client_actors*.go` - Add output helpers in `internal/asc/output_actors.go` - Register command in `cmd/root.go` - Add resource type constants in `internal/asc/client_types.go` - Follow patterns in `cmd/users.go`, `cmd/apps.go`, and output helpers in `internal/asc/output_*`

kerem closed this issue

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

kerem commented

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

Author

Owner

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

Tracking in PR #257 (Fixes #244).

@rudrankriyam commented on GitHub (Jan 28, 2026): Tracking in PR #257 (Fixes #244).

kerem commented

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

Author

Owner

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

Additional debug (ASC_BYPASS_KEYCHAIN=1):

asc nominations list --status SUBMITTED --limit 1 --include createdByActor --output json returned actor id b09c4dde-7d80-497f-bf54-40359437da9b in included.
asc actors get --id "b09c4dde-7d80-497f-bf54-40359437da9b" -> 404 resource does not exist.
asc actors list --id "b09c4dde-7d80-497f-bf54-40359437da9b" --fields actorType,userEmail --limit 1 -> empty list.

This suggests the /v1/actors endpoint is returning empty/404 for actor IDs present in included relationships (API behavior mismatch vs OpenAPI).

@rudrankriyam commented on GitHub (Jan 28, 2026): Additional debug (ASC_BYPASS_KEYCHAIN=1): - `asc nominations list --status SUBMITTED --limit 1 --include createdByActor --output json` returned actor id `b09c4dde-7d80-497f-bf54-40359437da9b` in `included`. - `asc actors get --id "b09c4dde-7d80-497f-bf54-40359437da9b"` -> 404 resource does not exist. - `asc actors list --id "b09c4dde-7d80-497f-bf54-40359437da9b" --fields actorType,userEmail --limit 1` -> empty list. This suggests the `/v1/actors` endpoint is returning empty/404 for actor IDs present in included relationships (API behavior mismatch vs OpenAPI).

kerem commented

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

Author

Owner

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

Update: actor IDs from nominations are bare UUIDs, but the /v1/actors endpoint expects prefixed IDs (e.g., USER:). Added fallback in actors client to retry with USER:, API_KEY:, XCODE_CLOUD: prefixes. Verified with:

ASC_BYPASS_KEYCHAIN=1 go run . actors get --id "b09c4dde-7d80-497f-bf54-40359437da9b" --output json

Actor lookup now succeeds.

@rudrankriyam commented on GitHub (Jan 28, 2026): Update: actor IDs from nominations are bare UUIDs, but the /v1/actors endpoint expects prefixed IDs (e.g., USER:<uuid>). Added fallback in actors client to retry with USER:, API_KEY:, XCODE_CLOUD: prefixes. Verified with: - ASC_BYPASS_KEYCHAIN=1 go run . actors get --id "b09c4dde-7d80-497f-bf54-40359437da9b" --output json Actor lookup now succeeds.

kerem referenced this issue

2026-02-26 21:34:26 +03:00

[PR #103] [MERGED] App Store assets management #285