[GH-ISSUE #204] Add Featuring Nominations CLI support #64

New issue

Closed

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

kerem commented

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

Owner

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

Originally assigned to: @rudrankriyam on GitHub.

Overview

Add CLI support for Featuring Nominations so users can submit and manage nominations for editorial featuring consideration.

Docs (API)

Featuring nominations: https://sosumi.ai/documentation/appstoreconnectapi/featuring-nominations
Nomination object: https://sosumi.ai/documentation/appstoreconnectapi/nomination
Create request: https://sosumi.ai/documentation/appstoreconnectapi/nominationcreaterequest
Update request: https://sosumi.ai/documentation/appstoreconnectapi/nominationupdaterequest

Scope (Endpoints)

From docs:

POST /v1/nominations
GET /v1/nominations
GET /v1/nominations/{id}
PATCH /v1/nominations/{id}
DELETE /v1/nominations/{id}

Proposed CLI

Top‑level group: asc nominations <subcommand> [flags]

Subcommands:

nominations list [--app APP_ID] [--status STATUS] [--type TYPE]
nominations get --id NOMINATION_ID
nominations create --app APP_ID --type TYPE --description "..." [--version VERSION_ID] [--countries "US,GB"] [--publish-date YYYY-MM-DD] [--platforms "IOS"]
nominations update --id NOMINATION_ID [flags]
nominations delete --id NOMINATION_ID --confirm

Flags

Common:

--output json|table|markdown
--pretty
--limit, --next, --paginate
--sort (if supported by API)

Create/update:

--type (enum)
--description
Optional: --version, --countries, --publish-date, --platforms

Delete:

--confirm required

Output

JSON (minified) by default
Table/markdown for list/get

Acceptance Criteria

asc nominations --help available
CRUD works against live App Store Connect
Filtering and pagination supported for list
Validations for enums/required flags
JSON/table/markdown output

Tests

CLI validation tests (missing required flags, invalid enums, missing --confirm)
Client tests for list/get/create/update/delete
Output tests for table/markdown

Manual Test Plan (using real apps)

asc apps --paginate → APP_ID
Create nomination:
- asc nominations create --app APP_ID --type APP_UPDATE --description "Major update" --version VERSION_ID
List nominations:
- asc nominations list --app APP_ID --output table
Get nomination:
- asc nominations get --id NOMINATION_ID
Update nomination:
- asc nominations update --id NOMINATION_ID --description "Updated description"
Delete nomination:
- asc nominations delete --id NOMINATION_ID --confirm

Implementation Notes

Add cmd/nominations.go, internal/asc/client_nominations.go, and output helpers.
Register in cmd/root.go.
Validate ISO date format for --publish-date.

Originally created by @rudrankriyam on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/204 Originally assigned to: @rudrankriyam on GitHub. # Overview Add CLI support for **Featuring Nominations** so users can submit and manage nominations for editorial featuring consideration. # Docs (API) - Featuring nominations: https://sosumi.ai/documentation/appstoreconnectapi/featuring-nominations - Nomination object: https://sosumi.ai/documentation/appstoreconnectapi/nomination - Create request: https://sosumi.ai/documentation/appstoreconnectapi/nominationcreaterequest - Update request: https://sosumi.ai/documentation/appstoreconnectapi/nominationupdaterequest # Scope (Endpoints) From docs: - `POST /v1/nominations` - `GET /v1/nominations` - `GET /v1/nominations/{id}` - `PATCH /v1/nominations/{id}` - `DELETE /v1/nominations/{id}` # Proposed CLI Top‑level group: `asc nominations <subcommand> [flags]` Subcommands: - `nominations list [--app APP_ID] [--status STATUS] [--type TYPE]` - `nominations get --id NOMINATION_ID` - `nominations create --app APP_ID --type TYPE --description "..." [--version VERSION_ID] [--countries "US,GB"] [--publish-date YYYY-MM-DD] [--platforms "IOS"]` - `nominations update --id NOMINATION_ID [flags]` - `nominations delete --id NOMINATION_ID --confirm` # Flags Common: - `--output json|table|markdown` - `--pretty` - `--limit`, `--next`, `--paginate` - `--sort` (if supported by API) Create/update: - `--type` (enum) - `--description` - Optional: `--version`, `--countries`, `--publish-date`, `--platforms` Delete: - `--confirm` required # Output - JSON (minified) by default - Table/markdown for list/get # Acceptance Criteria - [ ] `asc nominations --help` available - [ ] CRUD works against live App Store Connect - [ ] Filtering and pagination supported for list - [ ] Validations for enums/required flags - [ ] JSON/table/markdown output # Tests - CLI validation tests (missing required flags, invalid enums, missing --confirm) - Client tests for list/get/create/update/delete - Output tests for table/markdown # Manual Test Plan (using real apps) 1) `asc apps --paginate` → `APP_ID` 2) Create nomination: - `asc nominations create --app APP_ID --type APP_UPDATE --description "Major update" --version VERSION_ID` 3) List nominations: - `asc nominations list --app APP_ID --output table` 4) Get nomination: - `asc nominations get --id NOMINATION_ID` 5) Update nomination: - `asc nominations update --id NOMINATION_ID --description "Updated description"` 6) Delete nomination: - `asc nominations delete --id NOMINATION_ID --confirm` # Implementation Notes - Add `cmd/nominations.go`, `internal/asc/client_nominations.go`, and output helpers. - Register in `cmd/root.go`. - Validate ISO date format for `--publish-date`.

kerem closed this issue

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

kerem commented

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

Author

Owner

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

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

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

kerem referenced this issue

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

[PR #64] [MERGED] Build localizations command #263