@onmyway133/asc-cli 1.0.1

package/docs/API_COVERAGE.md

@@ -0,0 +1,355 @@
+# API Coverage Checklist
+
+Tracks which App Store Connect API endpoint groups are exposed via CLI commands.
+Generated from `docs/openapi/latest.json` (1208 endpoints across 174 resource groups).
+
+**Regenerate snapshot:** `bun run generate`  
+**Browse raw paths:** `grep <term> docs/openapi/paths.txt`  
+**SDK functions:** `src/api/generated/sdk.gen.ts`
+
+Legend: ✅ CLI command exists · 🔲 Not yet exposed · ➖ Internal/relationship-only (no direct CLI value)
+
+---
+
+## Apps
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `apps` | 86 | `asc apps list / get` |
+| ✅ | `appInfos` | 20 | `asc app-info get / update` |
+| ✅ | `appInfoLocalizations` | 4 | via `asc metadata list` |
+| ✅ | `appCategories` | 6 | `asc app-info categories list` |
+| ✅ | `ageRatingDeclarations` | 1 | `asc app-info age-rating` (update only) |
+| ✅ | `appAvailabilities` | 4 | `asc availability get / set` |
+| 🔲 | `appTags` | 3 | — |
+| ➖ | `actors` | 2 | internal |
+| 🔲 | `endAppAvailabilityPreOrders` | 1 | — |
+| 🔲 | `preReleaseVersions` | 6 | — |
+| 🔲 | `nominations` | 5 | — |
+
+## Builds
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `builds` | 30 | `asc builds list / get / update-beta-notes` |
+| ✅ | `buildBetaDetails` | 5 | `asc beta-review notify` |
+| ✅ | `betaBuildLocalizations` | 7 | `asc beta-review localizations list` |
+| 🔲 | `buildBetaNotifications` | 1 | — |
+| 🔲 | `buildBundles` | 8 | — |
+| 🔲 | `buildUploadFiles` | 3 | — |
+| 🔲 | `buildUploads` | 5 | — |
+| ➖ | `preReleaseVersions` | 6 | — |
+
+## App Store Versions
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `appStoreVersions` | 30 | `asc versions list / create / submit` |
+| ✅ | `appStoreVersionLocalizations` | 12 | `asc metadata list / update` |
+| 🔲 | `appStoreVersionPhasedReleases` | 3 | — |
+| 🔲 | `appStoreVersionReleaseRequests` | 1 | — |
+| 🔲 | `appStoreVersionSubmissions` | 1 | — |
+| 🔲 | `appStoreVersionPromotions` | 1 | — |
+| 🔲 | `appStoreVersionExperiments` | 12 | — |
+| 🔲 | `appStoreVersionExperimentTreatments` | 6 | — |
+| 🔲 | `appStoreVersionExperimentTreatmentLocalizations` | 7 | — |
+| 🔲 | `appStoreReviewDetails` | 5 | — |
+| 🔲 | `appStoreReviewAttachments` | 4 | — |
+| 🔲 | `routingAppCoverages` | 4 | — |
+| 🔲 | `reviewSubmissions` | 6 | — |
+| 🔲 | `reviewSubmissionItems` | 3 | — |
+
+## Screenshots & Previews
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `appScreenshotSets` | 6 | `asc screenshots sets list` |
+| ✅ | `appScreenshots` | 4 | `asc screenshots list / upload / delete` |
+| ✅ | `appPreviewSets` | 6 | `asc screenshots previews list` |
+| 🔲 | `appPreviews` | 4 | — |
+
+## TestFlight
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `betaGroups` | 21 | `asc testflight groups list` |
+| ✅ | `betaTesters` | 16 | `asc testflight testers list / add / remove` |
+| ✅ | `betaAppReviewSubmissions` | 5 | `asc beta-review submit / status` |
+| ✅ | `betaAppReviewDetails` | 5 | `asc beta-review detail-get / detail-update` |
+| ✅ | `betaAppLocalizations` | 7 | via builds |
+| 🔲 | `betaLicenseAgreements` | 5 | — |
+| 🔲 | `betaTesterInvitations` | 1 | — |
+| 🔲 | `betaRecruitmentCriteria` | 3 | — |
+| 🔲 | `betaCrashLogs` | 1 | — |
+| 🔲 | `betaFeedbackCrashSubmissions` | 4 | — |
+| 🔲 | `betaFeedbackScreenshotSubmissions` | 2 | — |
+| 🔲 | `betaAppClipInvocations` | 4 | — |
+| 🔲 | `betaAppClipInvocationLocalizations` | 3 | — |
+
+## Pricing & Territories
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `appPriceSchedules` | 8 | `asc pricing get / set` |
+| ✅ | `appPricePoints` | 3 | `asc pricing points list` |
+| ✅ | `territories` | 1 | `asc pricing territories list` |
+| 🔲 | `territoryAvailabilities` | 1 | — |
+
+## In-App Purchases
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `inAppPurchases` | 23 | `asc iap list / get / create / delete` |
+| ✅ | `inAppPurchaseLocalizations` | 4 | — |
+| 🔲 | `inAppPurchasePriceSchedules` | 8 | — |
+| 🔲 | `inAppPurchasePricePoints` | 2 | — |
+| 🔲 | `inAppPurchaseAvailabilities` | 4 | — |
+| 🔲 | `inAppPurchaseOfferCodes` | 9 | — |
+| 🔲 | `inAppPurchaseOfferCodeCustomCodes` | 3 | — |
+| 🔲 | `inAppPurchaseOfferCodeOneTimeUseCodes` | 4 | — |
+| 🔲 | `inAppPurchaseContents` | 1 | — |
+| 🔲 | `inAppPurchaseImages` | 4 | — |
+| 🔲 | `inAppPurchaseAppStoreReviewScreenshots` | 4 | — |
+| 🔲 | `inAppPurchaseSubmissions` | 1 | — |
+| 🔲 | `promotedPurchases` | 4 | — |
+
+## Subscriptions
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `subscriptionGroups` | 8 | `asc subscriptions groups list / create` |
+| ✅ | `subscriptions` | 28 | `asc subscriptions list / get / create / prices` |
+| ✅ | `subscriptionPrices` | 2 | `asc subscriptions prices` |
+| 🔲 | `subscriptionPricePoints` | 3 | — |
+| 🔲 | `subscriptionAvailabilities` | 4 | — |
+| 🔲 | `subscriptionLocalizations` | 4 | — |
+| 🔲 | `subscriptionGroupLocalizations` | 4 | — |
+| 🔲 | `subscriptionGroupSubmissions` | 1 | — |
+| 🔲 | `subscriptionIntroductoryOffers` | 3 | — |
+| 🔲 | `subscriptionPromotionalOffers` | 6 | — |
+| 🔲 | `subscriptionOfferCodes` | 9 | — |
+| 🔲 | `subscriptionOfferCodeCustomCodes` | 3 | — |
+| 🔲 | `subscriptionOfferCodeOneTimeUseCodes` | 4 | — |
+| 🔲 | `subscriptionImages` | 4 | — |
+| 🔲 | `subscriptionAppStoreReviewScreenshots` | 4 | — |
+| 🔲 | `subscriptionSubmissions` | 1 | — |
+| 🔲 | `subscriptionGracePeriods` | 2 | — |
+| 🔲 | `winBackOffers` | 6 | — |
+
+## Customer Reviews
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `customerReviews` | 3 | `asc reviews list / get` |
+| ✅ | `customerReviewResponses` | 3 | `asc reviews respond` |
+
+## Code Signing
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `certificates` | 7 | `asc signing certs list / get / revoke` |
+| ✅ | `devices` | 4 | `asc signing devices list / register` |
+| ✅ | `bundleIds` | 11 | `asc signing bundle-ids list / register` |
+| ✅ | `profiles` | 10 | `asc signing profiles list / delete` |
+| 🔲 | `bundleIdCapabilities` | 3 | — |
+| 🔲 | `merchantIds` | 7 | — |
+| 🔲 | `passTypeIds` | 7 | — |
+
+## Reports & Analytics
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `salesReports` | 1 | `asc reports sales` |
+| ✅ | `financeReports` | 1 | `asc reports finance` |
+| ✅ | `analyticsReportRequests` | 5 | `asc reports analytics request / list` |
+| 🔲 | `analyticsReports` | 3 | — |
+| 🔲 | `analyticsReportInstances` | 3 | — |
+| 🔲 | `analyticsReportSegments` | 1 | — |
+| 🔲 | `diagnosticSignatures` | 1 | — |
+
+## Xcode Cloud
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `ciProducts` | 13 | `asc xcode-cloud products list` |
+| ✅ | `ciWorkflows` | 8 | `asc xcode-cloud workflows list / get` |
+| ✅ | `ciBuildRuns` | 6 | `asc xcode-cloud builds list / run` |
+| ✅ | `ciArtifacts` | 1 | `asc xcode-cloud artifacts list` |
+| ✅ | `ciTestResults` | 1 | `asc xcode-cloud test-results list` |
+| 🔲 | `ciBuildActions` | 9 | — |
+| 🔲 | `ciIssues` | 1 | — |
+| 🔲 | `ciMacOsVersions` | 4 | — |
+| 🔲 | `ciXcodeVersions` | 4 | — |
+| 🔲 | `scmProviders` | 4 | — |
+| 🔲 | `scmRepositories` | 6 | — |
+| 🔲 | `scmGitReferences` | 1 | — |
+| 🔲 | `scmPullRequests` | 1 | — |
+
+## Game Center
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| ✅ | `gameCenterAchievements` | 19 | `asc game-center achievements list / get` |
+| ✅ | `gameCenterLeaderboards` | 21 | `asc game-center leaderboards list` |
+| ✅ | `gameCenterLeaderboardSets` | 27 | `asc game-center leaderboard-sets list` |
+| ✅ | `gameCenterEnabledVersions` | 5 | `asc game-center check` |
+| ✅ | `gameCenterDetails` | 42 | — |
+| 🔲 | `gameCenterGroups` | 29 | — |
+| 🔲 | `gameCenterAchievementLocalizations` | 14 | — |
+| 🔲 | `gameCenterAchievementImages` | 8 | — |
+| 🔲 | `gameCenterAchievementReleases` | 3 | — |
+| 🔲 | `gameCenterLeaderboardLocalizations` | 12 | — |
+| 🔲 | `gameCenterLeaderboardImages` | 8 | — |
+| 🔲 | `gameCenterLeaderboardReleases` | 3 | — |
+| 🔲 | `gameCenterLeaderboardSetLocalizations` | 12 | — |
+| 🔲 | `gameCenterMatchmakingQueues` | 10 | — |
+| 🔲 | `gameCenterMatchmakingRuleSets` | 11 | — |
+| 🔲 | `gameCenterMatchmakingRules` | 6 | — |
+| 🔲 | `gameCenterActivities` | 14 | — |
+| 🔲 | `gameCenterChallenges` | 8 | — |
+| ➖ | `gameCenterAppVersions` | 9 | internal |
+
+## App Events
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `appEvents` | 6 | — |
+| 🔲 | `appEventLocalizations` | 8 | — |
+| 🔲 | `appEventScreenshots` | 4 | — |
+| 🔲 | `appEventVideoClips` | 4 | — |
+
+## App Clips
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `appClips` | 5 | — |
+| 🔲 | `appClipDefaultExperiences` | 11 | — |
+| 🔲 | `appClipDefaultExperienceLocalizations` | 6 | — |
+| 🔲 | `appClipAdvancedExperiences` | 3 | — |
+| 🔲 | `appClipAdvancedExperienceImages` | 3 | — |
+| 🔲 | `appClipAppStoreReviewDetails` | 3 | — |
+| 🔲 | `appClipHeaderImages` | 4 | — |
+
+## Custom Product Pages
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `appCustomProductPages` | 6 | — |
+| 🔲 | `appCustomProductPageVersions` | 5 | — |
+| 🔲 | `appCustomProductPageLocalizations` | 12 | — |
+
+## Alternative Distribution (AltStore / Marketplace)
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `alternativeDistributionDomains` | 4 | — |
+| 🔲 | `alternativeDistributionKeys` | 4 | — |
+| 🔲 | `alternativeDistributionPackages` | 4 | — |
+| 🔲 | `alternativeDistributionPackageVersions` | 5 | — |
+| 🔲 | `alternativeDistributionPackageDeltas` | 1 | — |
+| 🔲 | `alternativeDistributionPackageVariants` | 1 | — |
+| 🔲 | `marketplaceSearchDetails` | 3 | — |
+| 🔲 | `marketplaceWebhooks` | 4 | — |
+
+## Encryption & Compliance
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `appEncryptionDeclarations` | 8 | — |
+| 🔲 | `appEncryptionDeclarationDocuments` | 3 | — |
+| 🔲 | `accessibilityDeclarations` | 4 | — |
+
+## Users & Roles
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `users` | 9 | — |
+| 🔲 | `userInvitations` | 6 | — |
+
+## EULAs & Legal
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `endUserLicenseAgreements` | 6 | — |
+
+## Background Assets
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `backgroundAssets` | 5 | — |
+| 🔲 | `backgroundAssetVersions` | 4 | — |
+| 🔲 | `backgroundAssetUploadFiles` | 3 | — |
+
+## Android → iOS Mapping
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `androidToIosAppMappingDetails` | 4 | — |
+
+## Sandbox Testing
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `sandboxTesters` | 2 | — |
+| 🔲 | `sandboxTestersClearPurchaseHistoryRequest` | 1 | — |
+
+## Webhooks
+
+| Status | Resource | Endpoints | CLI Command |
+|--------|----------|-----------|-------------|
+| 🔲 | `webhooks` | 6 | — |
+| 🔲 | `webhookDeliveries` | 1 | — |
+| 🔲 | `webhookPings` | 1 | — |
+
+---
+
+## Summary
+
+| Category | Total Resources | ✅ Covered | 🔲 Not Yet |
+|----------|----------------|-----------|-----------|
+| Apps | 11 | 6 | 5 |
+| Builds | 8 | 4 | 4 |
+| App Store Versions | 14 | 4 | 10 |
+| Screenshots & Previews | 4 | 3 | 1 |
+| TestFlight | 13 | 6 | 7 |
+| Pricing & Territories | 4 | 3 | 1 |
+| In-App Purchases | 13 | 2 | 11 |
+| Subscriptions | 18 | 4 | 14 |
+| Customer Reviews | 2 | 2 | 0 |
+| Code Signing | 7 | 4 | 3 |
+| Reports & Analytics | 7 | 3 | 4 |
+| Xcode Cloud | 13 | 5 | 8 |
+| Game Center | 19 | 5 | 14 |
+| App Events | 4 | 0 | 4 |
+| App Clips | 7 | 0 | 7 |
+| Custom Product Pages | 3 | 0 | 3 |
+| Alt. Distribution | 8 | 0 | 8 |
+| Encryption & Compliance | 3 | 0 | 3 |
+| Users & Roles | 2 | 0 | 2 |
+| Other (EULAs, Webhooks, etc.) | 9 | 0 | 9 |
+| **Total** | **169** | **51** | **118** |
+
+## How to Add Coverage for a Missing Endpoint
+
+1. Find the SDK function in `src/api/generated/sdk.gen.ts`
+   ```bash
+   grep -i "subscriptionLocalizations" src/api/generated/sdk.gen.ts | head -5
+   ```
+2. Check the request/response types in `src/api/generated/types.gen.ts`
+3. Add implementation to the relevant `src/commands/*.ts` file
+4. Wire the new command into `src/index.ts`
+5. Update the `docs/openapi/paths.txt` index if needed:
+   ```bash
+   bun run generate
+   ```
+6. Check the box above ✅
+
+## Regenerating the Spec
+
+When Apple updates their API:
+```bash
+bun run generate
+```
+
+This re-downloads `docs/openapi/latest.json`, refreshes `docs/openapi/paths.txt`,
+and regenerates `src/api/generated/` from the latest spec.