starred/App-Store-Connect-CLI
1
0
Fork 0
mirror of https://github.com/rudrankriyam/App-Store-Connect-CLI.git synced 2026-04-25 15:45:48 +03:00
Code Issues 2 Projects Releases 10 Packages Wiki Activity

[GH-ISSUE #199] Add App Pre-Orders CLI support #63

New issue
Closed
opened 2026-02-26 21:33:06 +03:00 by kerem · 1 comment
kerem commented 2026-02-26 21:33:06 +03:00
Owner
Copy link

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

Originally assigned to: @rudrankriyam on GitHub.

Overview

Add CLI support for App Pre‑Orders so users can configure pre‑order availability, release dates, and end pre‑orders using the public App Store Connect API.

Docs (API)

Scope (Endpoints)

The pre‑order flow is built on app availability and territory availability resources:

  • POST /v2/appAvailabilities (create/replace territory availabilities with pre‑order fields)
  • PATCH /v1/territoryAvailabilities/{id} (update release date / pre‑order enabled per territory)
  • POST /v1/endAppAvailabilityPreorders (end pre‑order and release immediately)
  • GET /v1/apps/{id}/appAvailabilityV2
  • GET /v1/appAvailabilityV2/{id}/territoryAvailabilities

Proposed CLI

Top‑level group: asc pre-orders <subcommand> [flags]

Subcommands:

  • pre-orders get --app APP_ID
  • pre-orders list --app APP_ID (alias of get, but returns territory rows)
  • pre-orders enable --app APP_ID --territory "USA,GBR" --release-date YYYY-MM-DD
  • pre-orders update --territory-availability AVAILABILITY_ID --release-date YYYY-MM-DD
  • pre-orders disable --territory-availability AVAILABILITY_ID (set preOrderEnabled=false)
  • pre-orders end --availability APP_AVAILABILITY_ID --confirm (end pre‑order globally)

Flags

Common:

  • --output json|table|markdown
  • --pretty

Enable/update:

  • --release-date required, validate YYYY-MM-DD
  • --territory required for enable (comma‑separated)

End:

  • --confirm required

Output

  • JSON (minified) by default
  • Table/markdown for list/get
  • Show available, releaseDate, preOrderEnabled per territory

Acceptance Criteria

  • asc pre-orders --help available
  • Can list territory pre‑order status for an app
  • Can enable pre‑order for territories with a release date
  • Can update release date for a territory availability
  • Can disable pre‑order for a territory availability
  • Can end pre‑order globally (endAppAvailabilityPreorders)
  • JSON/table/markdown output

Tests

  • CLI validation tests (missing --app, missing --territory, invalid date, missing --confirm)
  • Client tests for POST /v2/appAvailabilities, PATCH /v1/territoryAvailabilities, POST /v1/endAppAvailabilityPreorders
  • Output tests for table/markdown

Manual Test Plan (using real apps)

  1. Find IDs:
    • asc apps --paginate → APP_ID
  2. Get app availability ID:
    • asc pricing availability get --app APP_ID → APP_AVAILABILITY_ID
  3. List territory availability:
    • asc pricing availability territory-availabilities --availability APP_AVAILABILITY_ID
  4. Enable pre‑order:
    • asc pre-orders enable --app APP_ID --territory "USA" --release-date "2026-02-15"
  5. Update a territory availability (use ID from step 3):
    • asc pre-orders update --territory-availability TERR_AVAIL_ID --release-date "2026-02-20"
  6. Disable pre‑order:
    • asc pre-orders disable --territory-availability TERR_AVAIL_ID
  7. End pre‑order globally:
    • asc pre-orders end --availability APP_AVAILABILITY_ID --confirm

Implementation Notes

  • Reuse existing pricing availability client types (TerritoryAvailabilityCreate supports releaseDate + preOrderEnabled).
  • Add new command file cmd/pre_orders.go or extend cmd/pricing.go with a dedicated pre-orders group.
  • Add output helpers if needed to show pre‑order fields clearly.
Originally created by @rudrankriyam on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/199 Originally assigned to: @rudrankriyam on GitHub. # Overview Add CLI support for **App Pre‑Orders** so users can configure pre‑order availability, release dates, and end pre‑orders using the public App Store Connect API. # Docs (API) - App Pre‑Orders: https://sosumi.ai/documentation/appstoreconnectapi/app-pre-orders - App availability (existing): https://sosumi.ai/documentation/appstoreconnectapi/app-availability - Modify territory availability: https://sosumi.ai/documentation/appstoreconnectapi/patch-v1-territoryavailabilities-_id_ - End pre‑order: https://sosumi.ai/documentation/appstoreconnectapi/post-v1-endappavailabilitypreorders # Scope (Endpoints) The pre‑order flow is built on **app availability** and **territory availability** resources: - `POST /v2/appAvailabilities` (create/replace territory availabilities with pre‑order fields) - `PATCH /v1/territoryAvailabilities/{id}` (update release date / pre‑order enabled per territory) - `POST /v1/endAppAvailabilityPreorders` (end pre‑order and release immediately) - `GET /v1/apps/{id}/appAvailabilityV2` - `GET /v1/appAvailabilityV2/{id}/territoryAvailabilities` # Proposed CLI Top‑level group: `asc pre-orders <subcommand> [flags]` Subcommands: - `pre-orders get --app APP_ID` - `pre-orders list --app APP_ID` (alias of get, but returns territory rows) - `pre-orders enable --app APP_ID --territory "USA,GBR" --release-date YYYY-MM-DD` - `pre-orders update --territory-availability AVAILABILITY_ID --release-date YYYY-MM-DD` - `pre-orders disable --territory-availability AVAILABILITY_ID` (set `preOrderEnabled=false`) - `pre-orders end --availability APP_AVAILABILITY_ID --confirm` (end pre‑order globally) # Flags Common: - `--output json|table|markdown` - `--pretty` Enable/update: - `--release-date` required, validate `YYYY-MM-DD` - `--territory` required for `enable` (comma‑separated) End: - `--confirm` required # Output - JSON (minified) by default - Table/markdown for list/get - Show `available`, `releaseDate`, `preOrderEnabled` per territory # Acceptance Criteria - [ ] `asc pre-orders --help` available - [ ] Can list territory pre‑order status for an app - [ ] Can enable pre‑order for territories with a release date - [ ] Can update release date for a territory availability - [ ] Can disable pre‑order for a territory availability - [ ] Can end pre‑order globally (`endAppAvailabilityPreorders`) - [ ] JSON/table/markdown output # Tests - CLI validation tests (missing --app, missing --territory, invalid date, missing --confirm) - Client tests for POST /v2/appAvailabilities, PATCH /v1/territoryAvailabilities, POST /v1/endAppAvailabilityPreorders - Output tests for table/markdown # Manual Test Plan (using real apps) 1) Find IDs: - `asc apps --paginate` → `APP_ID` 2) Get app availability ID: - `asc pricing availability get --app APP_ID` → `APP_AVAILABILITY_ID` 3) List territory availability: - `asc pricing availability territory-availabilities --availability APP_AVAILABILITY_ID` 4) Enable pre‑order: - `asc pre-orders enable --app APP_ID --territory "USA" --release-date "2026-02-15"` 5) Update a territory availability (use ID from step 3): - `asc pre-orders update --territory-availability TERR_AVAIL_ID --release-date "2026-02-20"` 6) Disable pre‑order: - `asc pre-orders disable --territory-availability TERR_AVAIL_ID` 7) End pre‑order globally: - `asc pre-orders end --availability APP_AVAILABILITY_ID --confirm` # Implementation Notes - Reuse existing `pricing availability` client types (`TerritoryAvailabilityCreate` supports `releaseDate` + `preOrderEnabled`). - Add new command file `cmd/pre_orders.go` or extend `cmd/pricing.go` with a dedicated `pre-orders` group. - Add output helpers if needed to show pre‑order fields clearly.
kerem closed this issue 2026-02-26 21:33:06 +03:00
kerem commented 2026-02-26 21:33:07 +03:00
Author
Owner
Copy link

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

Closed as fixed by #225, #229, #236. PRs: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/225, https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/229, https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/236

<!-- gh-comment-id:3808155842 --> @rudrankriyam commented on GitHub (Jan 27, 2026): Closed as fixed by #225, #229, #236. PRs: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/225, https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/229, https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/236
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
1.2.6
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.1
1.1.0
1.0.1
1.0.0
0.49.1
0.49.0
0.48.1
0.48.0
0.47.1
0.47.0
0.46.2
0.46.1
0.46.0
0.45.4
0.45.3
0.45.2
0.45.1
0.45.0
0.44.2
0.44.1
0.44.0
0.43.0
0.42.0
0.41.4
0.41.3
0.41.2
0.41.1
0.41.0
0.40.1
0.40.0
0.39.1
0.39.0
0.38.3
0.38.2
0.38.1
0.38.0
0.37.3
0.37.2
0.37.1
0.37.0
0.36.3
0.36.2
0.36.1
0.36.0
0.35.3
0.35.2
0.35.1
0.35.0
0.34.1
0.34.0
0.33.2
0.33.1
0.33.0
0.32.0
0.31.3
0.31.2
0.31.1
0.31.0
0.30.0
0.29.3
0.29.2
0.29.1
0.29.0
0.28.14
0.28.13
0.28.12
0.28.11
0.28.10
0.28.9
0.28.8
0.28.7
0.28.6
0.28.5
0.28.4
0.28.3
0.28.2
0.28.1
0.28.0
0.27.0
0.26.4
0.26.3
0.26.2
0.26.1
0.26.0
0.25.4
0.25.3
0.25.1
0.25.0
0.24.3
0.24.2
0.24.1
0.24.0
0.23.5
0.23.4
0.23.3
0.23.2
0.23.1
0.23.0
0.22.1
0.22.0
0.21.0
0.20.2
0.20.1
0.20.0
0.19.3
0.19.2
0.19.1
0.19.0
0.18.2
0.18.1
0.18.0
0.17.0
0.16.0
0.15.0
0.14.0
0.13.0
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.0
0.10.2
0.10.1
0.10.0
0.9.0
0.8.1
0.8.0
0.7.0
0.6.0
0.5.0
0.3.1
0.3.0
0.2.0
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0
Labels
Clear labels   
bug

   
bug

   
documentation

   
enhancement

   
pull-request

Mirrored from GitHub Pull Request

No labels
bug
bug
documentation
enhancement
pull-request
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/App-Store-Connect-CLI#63
No description provided.