[GH-ISSUE #195] Add App Store Server API diagnostic CLI (status/history/test notifications) #55

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

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

Overview

Diagnostics CLI for App Store Server Notifications (V2). This issue is focused only on notification test/status/history endpoints. No webhook receiver or background daemon. "Live" behavior should use polling via --watch on history.

Docs

Scope (notifications)

  • Request test notification
  • Get test notification status
  • Get notification history (--watch, --interval)

Non-goals (out of scope)

  • Listener / webhook server
  • Local HTTP server or tunneling
  • Background daemon mode

Proposed CLI

Top-level group: asc server [flags]

  • asc server notifications request-test
  • asc server notifications status --token TEST_TOKEN
  • asc server notifications history --start "2025-01-01T00:00:00Z" --end "2025-01-31T00:00:00Z" [--watch --interval 10]

Auth & Config

Requires In-App Purchase key (different from ASC API key):

  • ASC_IAP_KEY_ID
  • ASC_IAP_ISSUER_ID
  • ASC_IAP_PRIVATE_KEY_PATH (or _B64/raw variants)
  • ASC_IAP_BUNDLE_ID
  • ASC_IAP_ENV (SANDBOX|PRODUCTION)

Output

  • JSON (minified) by default
  • --pretty for JSON
  • Table/markdown for summary lists when useful

Acceptance Criteria

  • asc server notifications --help available
  • All commands above work
  • --watch polls history (no webhook server)
  • Clear errors for missing IAP credentials
  • Environment selection (SANDBOX/PRODUCTION) affects base URL

Tests

  • CLI validation tests
  • HTTP client tests (mocked) per endpoint
  • Paging tests for history endpoint

Manual Test Plan

  1. Set ASC_IAP_* env vars and ASC_IAP_ENV=SANDBOX
  2. asc server notifications request-test -> TEST_TOKEN
  3. asc server notifications status --token TEST_TOKEN
  4. asc server notifications history --watch --interval 10
Originally created by @rudrankriyam on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/195 # Overview Diagnostics CLI for App Store Server Notifications (V2). This issue is focused only on notification test/status/history endpoints. No webhook receiver or background daemon. "Live" behavior should use polling via --watch on history. # Docs - App Store Server Notifications: https://developer.apple.com/documentation/appstoreservernotifications - Apple server library (endpoint map): https://apple.github.io/app-store-server-library-node/classes/AppStoreServerAPIClient.html # Scope (notifications) - Request test notification - Get test notification status - Get notification history (--watch, --interval) # Non-goals (out of scope) - Listener / webhook server - Local HTTP server or tunneling - Background daemon mode # Proposed CLI Top-level group: asc server <subcommand> [flags] - asc server notifications request-test - asc server notifications status --token TEST_TOKEN - asc server notifications history --start "2025-01-01T00:00:00Z" --end "2025-01-31T00:00:00Z" [--watch --interval 10] # Auth & Config Requires In-App Purchase key (different from ASC API key): - ASC_IAP_KEY_ID - ASC_IAP_ISSUER_ID - ASC_IAP_PRIVATE_KEY_PATH (or _B64/raw variants) - ASC_IAP_BUNDLE_ID - ASC_IAP_ENV (SANDBOX|PRODUCTION) # Output - JSON (minified) by default - --pretty for JSON - Table/markdown for summary lists when useful # Acceptance Criteria - asc server notifications --help available - All commands above work - --watch polls history (no webhook server) - Clear errors for missing IAP credentials - Environment selection (SANDBOX/PRODUCTION) affects base URL # Tests - CLI validation tests - HTTP client tests (mocked) per endpoint - Paging tests for history endpoint # Manual Test Plan 1) Set ASC_IAP_* env vars and ASC_IAP_ENV=SANDBOX 2) asc server notifications request-test -> TEST_TOKEN 3) asc server notifications status --token TEST_TOKEN 4) asc server notifications history --watch --interval 10
kerem closed this issue 2026-02-26 21:33:03 +03:00
Author
Owner

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

Closing as not planned (won't fix) per request.

<!-- gh-comment-id:3820799855 --> @rudrankriyam commented on GitHub (Jan 29, 2026): Closing as not planned (won't fix) per request.
Sign in to join this conversation.
No milestone
No project
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#55
No description provided.