@onmyway133/asc-cli 1.0.2 → 1.0.3

package/docs/DEVELOPMENT.md

@@ -0,0 +1,112 @@
+# Development
+
+## Setup
+
+```bash
+git clone https://github.com/onmyway133/asc-cli
+cd asc-cli
+bun install
+```
+
+## Run during development
+
+```bash
+bun run src/index.ts <command>
+bun run src/index.ts auth list
+bun run src/index.ts apps list --output json
+```
+
+## Type check
+
+```bash
+bun run typecheck
+```
+
+## Tests
+
+```bash
+bun test
+```
+
+Tests use a temp `tests/tmp_home` directory — they never touch `~/.asc/credentials.json`. Always clean up test artifacts; don't run the CLI manually against real profiles to test behavior.
+
+## Build
+
+```bash
+bun run build        # outputs dist/index.js
+./dist/asc --help
+```
+
+## Regenerate API client
+
+When Apple updates their OpenAPI spec:
+
+```bash
+bun run generate
+```
+
+This fetches the latest spec to `docs/openapi/latest.json`, regenerates `docs/openapi/paths.txt`, and re-runs `openapi-ts` to update `src/api/generated/`.
+
+The snapshot is committed to the repo so the client can be built offline.
+
+## Browse API endpoints
+
+```bash
+grep "apps" docs/openapi/paths.txt
+grep "GET.*builds" docs/openapi/paths.txt
+```
+
+## Adding a new command
+
+1. Check `docs/API_COVERAGE.md` for uncovered endpoints
+2. Find the relevant function in `src/api/generated/sdk.gen.ts`
+3. Add a handler in `src/commands/<area>.ts` using the generated SDK function
+4. Wire up the command in `src/index.ts`
+5. Mark it covered in `docs/API_COVERAGE.md`
+
+## Project structure
+
+```
+src/
+  index.ts              # CLI entry point — all command definitions
+  auth/
+    credentials.ts      # Load/save ~/.asc/credentials.json
+    jwt.ts              # JWT generation + macOS Keychain (security CLI)
+  api/
+    client.ts           # throwOnError / ASCError / ascFetch (fallback only)
+    hey-api-client.ts   # hey-api client with auth interceptor
+    generated/          # Auto-generated SDK (do not edit)
+  commands/             # Business logic for each command group
+  utils/
+    output.ts           # Table / JSON / plain formatters
+    help-spec.ts        # Structured JSON help for AI agents
+docs/
+  API_COVERAGE.md       # Checklist of covered vs uncovered endpoints
+  openapi/
+    latest.json         # Offline OpenAPI snapshot (committed)
+    paths.txt           # Quick-grep index of all endpoints
+```
+
+## Known SDK gaps
+
+Three endpoints have no generated SDK function and fall back to `ascFetch`/`ascFetchAll`. If Apple updates the OpenAPI spec to include them, run `bun run generate` and migrate:
+
+| Endpoint | File | Reason |
+|----------|------|--------|
+| `POST /v1/appStoreVersionSubmissions` | `versions.ts` | Deprecated submission API — SDK only includes the `DELETE` variant |
+| `PATCH /v1/customerReviewResponses/{id}` | `reviews.ts` | SDK has create/delete for review responses but no update function |
+| `GET /v1/ciBuildRuns` | `xcode-cloud.ts` | Unfiltered collection; SDK only exposes filtered variants (`ciWorkflowsBuildRunsGetToManyRelated`) |
+| `GET /v1/ciBuildRuns/{id}/artifacts` | `xcode-cloud.ts` | Sub-resource not present in generated SDK |
+| `GET /v1/ciBuildRuns/{id}/testResults` | `xcode-cloud.ts` | Sub-resource not present in generated SDK |
+
+## Publish
+
+```bash
+# Bump version in package.json, then:
+bun run build
+git add package.json
+git commit -m "Release X.X.X"
+git tag X.X.X
+git push && git push --tags
+npm publish --access public --otp=<your-otp>
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onmyway133/asc-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "App Store Connect CLI — manage apps, builds, TestFlight, metadata and more from your terminal",
   "type": "module",
   "bin": {

package/src/commands/app-info.ts

@@ -1,34 +1,32 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
+import {
+  appsAppInfosGetToManyRelated,
+  appInfosUpdateInstance,
+  appCategoriesGetCollection,
+  ageRatingDeclarationsUpdateInstance,
+} from "../api/generated/sdk.gen.ts"
+import { throwOnError } from "../api/client.ts"
 import { detectFormat, printJSON, printTable } from "../utils/output.ts"
 
 // ---- App Info (content ratings, age ratings, primary/secondary categories) ----
 
 export async function appInfoGet(appId: string, opts: { output?: string } = {}): Promise<void> {
-  const result = await ascFetch<{
-    data: Array<{
-      id: string
-      attributes: {
-        appStoreState?: string
-        appStoreAgeRating?: string
-        brazilAgeRating?: string
-        kidsAgeBand?: string
-      }
-    }>
-  }>(`/v1/apps/${appId}/appInfos`, {
-    params: {
-      include: "primaryCategory,secondaryCategory",
-      "fields[appInfos]": "appStoreState,appStoreAgeRating,brazilAgeRating,kidsAgeBand",
+  const result = await appsAppInfosGetToManyRelated({
+    path: { id: appId },
+    query: {
+      include: ["primaryCategory", "secondaryCategory"],
+      "fields[appInfos]": ["appStoreState", "appStoreAgeRating", "brazilAgeRating", "kidsAgeBand"],
     },
   })
+  const data = throwOnError(result)
   const fmt = detectFormat(opts.output)
-  if (fmt === "json") { printJSON(result.data); return }
-  for (const info of result.data.data) {
+  if (fmt === "json") { printJSON(data); return }
+  for (const info of data.data) {
     const a = info.attributes
     console.log(`Info ID:       ${info.id}`)
-    console.log(`State:         ${a.appStoreState ?? "-"}`)
-    console.log(`Age Rating:    ${a.appStoreAgeRating ?? "-"}`)
-    console.log(`Brazil Rating: ${a.brazilAgeRating ?? "-"}`)
-    console.log(`Kids Band:     ${a.kidsAgeBand ?? "-"}`)
+    console.log(`State:         ${a?.appStoreState ?? "-"}`)
+    console.log(`Age Rating:    ${a?.appStoreAgeRating ?? "-"}`)
+    console.log(`Brazil Rating: ${a?.brazilAgeRating ?? "-"}`)
+    console.log(`Kids Band:     ${a?.kidsAgeBand ?? "-"}`)
     console.log("")
   }
 }
@@ -45,13 +43,13 @@ export async function appInfoUpdate(opts: {
   if (opts.secondaryCategoryId) {
     relationships["secondaryCategory"] = { data: { type: "appCategories", id: opts.secondaryCategoryId } }
   }
-  await ascFetch(`/v1/appInfos/${opts.infoId}`, {
-    method: "PATCH",
+  await appInfosUpdateInstance({
+    path: { id: opts.infoId },
     body: {
       data: {
         type: "appInfos",
         id: opts.infoId,
-        relationships,
+        relationships: relationships as never,
       },
     },
   })
@@ -62,17 +60,17 @@ export async function appCategoriesList(opts: {
   platform?: string
   output?: string
 } = {}): Promise<void> {
-  const params: Record<string, string> = {}
-  if (opts.platform) params["filter[platforms]"] = opts.platform
-  const items = await ascFetchAll<{
-    id: string
-    attributes: { platforms?: string[] }
-  }>("/v1/appCategories", { params })
+  const query: Record<string, unknown> = {}
+  if (opts.platform) query["filter[platforms]"] = [opts.platform]
+
+  const result = await appCategoriesGetCollection({ query: query as never })
+  const data = throwOnError(result)
+  const items = data.data
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(items); return }
   printTable(
     ["Category ID", "Platforms"],
-    items.map(c => [c.id, (c.attributes.platforms ?? []).join(", ")]),
+    items.map(c => [c.id, (c.attributes?.platforms ?? []).join(", ")]),
     `App Categories (${items.length})`,
   )
 }
@@ -96,13 +94,13 @@ export async function ageRatingDeclarationUpdate(opts: {
   violenceRealistic?: string
 }): Promise<void> {
   const { declarationId, ...attributes } = opts
-  await ascFetch(`/v1/ageRatingDeclarations/${declarationId}`, {
-    method: "PATCH",
+  await ageRatingDeclarationsUpdateInstance({
+    path: { id: declarationId },
     body: {
       data: {
         type: "ageRatingDeclarations",
         id: declarationId,
-        attributes,
+        attributes: attributes as never,
       },
     },
   })

package/src/commands/apps.ts

@@ -1,11 +1,13 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
-import type { App } from "../api/types.ts"
+import { appsGetCollection, appsGetInstance } from "../api/generated/sdk.gen.ts"
+import { throwOnError } from "../api/client.ts"
 import { detectFormat, formatDate, printJSON, printTable, truncate } from "../utils/output.ts"
 
 export async function appsList(opts: { limit?: number; output?: string } = {}): Promise<void> {
-  const apps = await ascFetchAll<App>("/v1/apps", {
-    params: { "fields[apps]": "name,bundleId,sku,primaryLocale" },
+  const result = await appsGetCollection({
+    query: { "fields[apps]": ["name", "bundleId", "sku", "primaryLocale"], limit: 200 },
   })
+  const data = throwOnError(result)
+  const apps = data.data
 
   const fmt = detectFormat(opts.output)
   if (fmt === "json") {
@@ -17,18 +19,19 @@ export async function appsList(opts: { limit?: number; output?: string } = {}):
     ["ID", "Name", "Bundle ID", "SKU", "Locale"],
     apps.map((a) => [
       a.id,
-      truncate(a.attributes.name, 40),
-      a.attributes.bundleId,
-      a.attributes.sku ?? "-",
-      a.attributes.primaryLocale,
+      truncate(a.attributes?.name ?? "-", 40),
+      a.attributes?.bundleId ?? "-",
+      a.attributes?.sku ?? "-",
+      a.attributes?.primaryLocale ?? "-",
     ]),
     `Apps (${apps.length})`,
   )
 }
 
 export async function appsGet(appId: string, opts: { output?: string } = {}): Promise<void> {
-  const res = await ascFetch<App>(`/v1/apps/${appId}`)
-  const app = res.data
+  const result = await appsGetInstance({ path: { id: appId } })
+  const data = throwOnError(result)
+  const app = data.data
 
   const fmt = detectFormat(opts.output)
   if (fmt === "json") {
@@ -37,8 +40,8 @@ export async function appsGet(appId: string, opts: { output?: string } = {}): Pr
   }
 
   console.log(`ID:             ${app.id}`)
-  console.log(`Name:           ${app.attributes.name}`)
-  console.log(`Bundle ID:      ${app.attributes.bundleId}`)
-  console.log(`SKU:            ${app.attributes.sku ?? "-"}`)
-  console.log(`Primary Locale: ${app.attributes.primaryLocale}`)
+  console.log(`Name:           ${app.attributes?.name ?? "-"}`)
+  console.log(`Bundle ID:      ${app.attributes?.bundleId ?? "-"}`)
+  console.log(`SKU:            ${app.attributes?.sku ?? "-"}`)
+  console.log(`Primary Locale: ${app.attributes?.primaryLocale ?? "-"}`)
 }

package/src/commands/availability.ts

@@ -1,27 +1,29 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
+import {
+  appsAppAvailabilityV2GetToOneRelated,
+  appAvailabilitiesV2CreateInstance,
+} from "../api/generated/sdk.gen.ts"
+import { throwOnError } from "../api/client.ts"
 import { detectFormat, printJSON, printTable } from "../utils/output.ts"
 
 export async function availabilityGet(appId: string, opts: { output?: string } = {}): Promise<void> {
-  const result = await ascFetch<{
-    data: { id: string; attributes: { availableInNewTerritories?: boolean } }
-    included?: Array<{ type: string; id: string; attributes?: { currency?: string; name?: string } }>
-  }>(`/v1/apps/${appId}/appAvailabilityV2`, {
-    params: {
-      include: "availableTerritories",
-      "fields[territories]": "currency,name",
+  const result = await appsAppAvailabilityV2GetToOneRelated({
+    path: { id: appId },
+    query: {
+      include: ["territoryAvailabilities"],
     },
   })
-  const body = result.data
+  const body = throwOnError(result)
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(body); return }
   console.log(`App ID:                       ${appId}`)
   console.log(`Available in new territories: ${body.data.attributes?.availableInNewTerritories ?? "-"}`)
-  const territories = (body.included ?? []).filter(r => r.type === "territories")
+  const included = (body as { data: unknown; included?: Array<{ type: string; id: string; attributes?: { territory?: string | null } }> }).included ?? []
+  const territories = included.filter(r => r.type === "territoryAvailabilities")
   if (territories.length) {
     console.log(`\nEnabled Territories (${territories.length}):`)
     printTable(
-      ["Territory Code", "Name", "Currency"],
-      territories.map(t => [t.id, t.attributes?.name ?? "-", t.attributes?.currency ?? "-"]),
+      ["Territory Availability ID", "Territory"],
+      territories.map(t => [t.id, t.attributes?.territory ?? "-"]),
     )
   }
 }
@@ -31,8 +33,7 @@ export async function availabilityTerritoriesSet(opts: {
   territories: string[]
   availableInNewTerritories?: boolean
 }): Promise<void> {
-  await ascFetch(`/v1/appAvailabilities`, {
-    method: "POST",
+  await appAvailabilitiesV2CreateInstance({
     body: {
       data: {
         type: "appAvailabilities",
@@ -41,8 +42,8 @@ export async function availabilityTerritoriesSet(opts: {
         },
         relationships: {
           app: { data: { type: "apps", id: opts.appId } },
-          availableTerritories: {
-            data: opts.territories.map(t => ({ type: "territories", id: t })),
+          territoryAvailabilities: {
+            data: opts.territories.map(t => ({ type: "territoryAvailabilities" as const, id: t })),
           },
         },
       },

package/src/commands/beta-review.ts

@@ -1,35 +1,39 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
+import {
+  betaAppReviewSubmissionsCreateInstance,
+  betaAppReviewSubmissionsGetCollection,
+  appsBetaAppReviewDetailGetToOneRelated,
+  betaAppReviewDetailsUpdateInstance,
+  buildsBuildBetaDetailGetToOneRelated,
+  buildBetaDetailsUpdateInstance,
+  buildsBetaBuildLocalizationsGetToManyRelated,
+} from "../api/generated/sdk.gen.ts"
+import { throwOnError } from "../api/client.ts"
 import { detectFormat, formatDate, printJSON, printSuccess, printTable, truncate } from "../utils/output.ts"
 
 // ---- Beta App Review Submissions ----
 
 export async function betaReviewSubmissionCreate(buildId: string): Promise<void> {
-  const result = await ascFetch<{ data: { id: string; attributes: { betaReviewState?: string } } }>(
-    "/v1/betaAppReviewSubmissions",
-    {
-      method: "POST",
-      body: {
-        data: {
-          type: "betaAppReviewSubmissions",
-          relationships: {
-            build: { data: { type: "builds", id: buildId } },
-          },
+  const result = await betaAppReviewSubmissionsCreateInstance({
+    body: {
+      data: {
+        type: "betaAppReviewSubmissions",
+        relationships: {
+          build: { data: { type: "builds", id: buildId } },
         },
       },
     },
-  )
-  const state = result.data.data.attributes.betaReviewState
+  })
+  const data = throwOnError(result)
+  const state = data.data.attributes?.betaReviewState
   printSuccess(`Beta review submitted for build ${buildId} (state: ${state ?? "WAITING_FOR_REVIEW"})`)
 }
 
 export async function betaReviewSubmissionGet(buildId: string, opts: { output?: string } = {}): Promise<void> {
-  const items = await ascFetchAll<{
-    id: string
-    attributes: { betaReviewState?: string }
-    relationships?: { build?: { data?: { id: string } } }
-  }>("/v1/betaAppReviewSubmissions", {
-    params: { "filter[build]": buildId },
+  const result = await betaAppReviewSubmissionsGetCollection({
+    query: { "filter[build]": [buildId] },
   })
+  const data = throwOnError(result)
+  const items = data.data
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(items); return }
   if (items.length === 0) {
@@ -38,40 +42,27 @@ export async function betaReviewSubmissionGet(buildId: string, opts: { output?:
   }
   for (const s of items) {
     console.log(`Submission ID: ${s.id}`)
-    console.log(`State:         ${s.attributes.betaReviewState ?? "-"}`)
+    console.log(`State:         ${s.attributes?.betaReviewState ?? "-"}`)
   }
 }
 
 // ---- Beta App Review Details ----
 
 export async function betaReviewDetailGet(appId: string, opts: { output?: string } = {}): Promise<void> {
-  const result = await ascFetch<{
-    data: {
-      id: string
-      attributes: {
-        contactFirstName?: string
-        contactLastName?: string
-        contactPhone?: string
-        contactEmail?: string
-        demoAccountName?: string
-        demoAccountPassword?: string
-        demoAccountRequired?: boolean
-        notes?: string
-      }
-    }
-  }>(`/v1/apps/${appId}/betaAppReviewDetail`)
+  const result = await appsBetaAppReviewDetailGetToOneRelated({ path: { id: appId } })
+  const data = throwOnError(result)
   const fmt = detectFormat(opts.output)
-  if (fmt === "json") { printJSON(result.data.data); return }
-  const a = result.data.data.attributes
-  console.log(`Review Detail ID:   ${result.data.data.id}`)
-  console.log(`Contact:            ${a.contactFirstName ?? ""} ${a.contactLastName ?? ""}`)
-  console.log(`Contact Email:      ${a.contactEmail ?? "-"}`)
-  console.log(`Contact Phone:      ${a.contactPhone ?? "-"}`)
-  console.log(`Demo Account:       ${a.demoAccountRequired ? "Required" : "Not required"}`)
-  if (a.demoAccountRequired) {
-    console.log(`Demo Username:      ${a.demoAccountName ?? "-"}`)
+  if (fmt === "json") { printJSON(data.data); return }
+  const a = data.data.attributes
+  console.log(`Review Detail ID:   ${data.data.id}`)
+  console.log(`Contact:            ${a?.contactFirstName ?? ""} ${a?.contactLastName ?? ""}`)
+  console.log(`Contact Email:      ${a?.contactEmail ?? "-"}`)
+  console.log(`Contact Phone:      ${a?.contactPhone ?? "-"}`)
+  console.log(`Demo Account:       ${a?.demoAccountRequired ? "Required" : "Not required"}`)
+  if (a?.demoAccountRequired) {
+    console.log(`Demo Username:      ${a?.demoAccountName ?? "-"}`)
   }
-  if (a.notes) console.log(`Notes:              ${a.notes}`)
+  if (a?.notes) console.log(`Notes:              ${a.notes}`)
 }
 
 export async function betaReviewDetailUpdate(opts: {
@@ -86,16 +77,17 @@ export async function betaReviewDetailUpdate(opts: {
   notes?: string
 }): Promise<void> {
   // First get the detail ID
-  const current = await ascFetch<{ data: { id: string } }>(`/v1/apps/${opts.appId}/betaAppReviewDetail`)
-  const detailId = current.data.data.id
+  const current = await appsBetaAppReviewDetailGetToOneRelated({ path: { id: opts.appId } })
+  const currentData = throwOnError(current)
+  const detailId = currentData.data.id
   const { appId, ...attributes } = opts
-  await ascFetch(`/v1/betaAppReviewDetails/${detailId}`, {
-    method: "PATCH",
+  await betaAppReviewDetailsUpdateInstance({
+    path: { id: detailId },
     body: {
       data: {
         type: "betaAppReviewDetails",
         id: detailId,
-        attributes,
+        attributes: attributes as never,
       },
     },
   })
@@ -108,12 +100,11 @@ export async function buildBetaDetailUpdate(opts: {
   buildId: string
   autoNotifyEnabled?: boolean
 }): Promise<void> {
-  const current = await ascFetch<{
-    data: { id: string }
-  }>(`/v1/builds/${opts.buildId}/buildBetaDetail`)
-  const detailId = current.data.data.id
-  await ascFetch(`/v1/buildBetaDetails/${detailId}`, {
-    method: "PATCH",
+  const current = await buildsBuildBetaDetailGetToOneRelated({ path: { id: opts.buildId } })
+  const currentData = throwOnError(current)
+  const detailId = currentData.data.id
+  await buildBetaDetailsUpdateInstance({
+    path: { id: detailId },
     body: {
       data: {
         type: "buildBetaDetails",
@@ -131,15 +122,14 @@ export async function betaBuildLocalizationsList(opts: {
   buildId: string
   output?: string
 }): Promise<void> {
-  const items = await ascFetchAll<{
-    id: string
-    attributes: { locale?: string; whatsNew?: string }
-  }>(`/v1/builds/${opts.buildId}/betaBuildLocalizations`)
+  const result = await buildsBetaBuildLocalizationsGetToManyRelated({ path: { id: opts.buildId } })
+  const data = throwOnError(result)
+  const items = data.data
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(items); return }
   printTable(
     ["ID", "Locale", "What's New"],
-    items.map(l => [l.id, l.attributes.locale ?? "-", truncate(l.attributes.whatsNew ?? "-", 60)]),
+    items.map(l => [l.id, l.attributes?.locale ?? "-", truncate(l.attributes?.whatsNew ?? "-", 60)]),
     `Beta Build Localizations (${items.length})`,
   )
 }

package/src/commands/builds.ts

@@ -1,6 +1,12 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
-import type { Build } from "../api/types.ts"
-import { detectFormat, formatDate, printJSON, printSuccess, printTable, truncate } from "../utils/output.ts"
+import {
+  buildsGetCollection,
+  buildsGetInstance,
+  buildsBetaBuildLocalizationsGetToManyRelated,
+  betaBuildLocalizationsUpdateInstance,
+  betaBuildLocalizationsCreateInstance,
+} from "../api/generated/sdk.gen.ts"
+import { throwOnError } from "../api/client.ts"
+import { detectFormat, formatDate, printJSON, printSuccess, printTable } from "../utils/output.ts"
 
 export async function buildsList(opts: {
   appId?: string
@@ -8,15 +14,17 @@ export async function buildsList(opts: {
   platform?: string
   output?: string
 } = {}): Promise<void> {
-  const params: Record<string, string> = {
-    "fields[builds]": "version,uploadedDate,processingState,expired",
-    "limit": "200",
+  const query: Record<string, unknown> = {
+    "fields[builds]": ["version", "uploadedDate", "processingState", "expired"],
+    limit: 200,
   }
-  if (opts.appId) params["filter[app]"] = opts.appId
-  if (opts.version) params["filter[version]"] = opts.version
-  if (opts.platform) params["filter[platform]"] = opts.platform.toUpperCase()
+  if (opts.appId) query["filter[app]"] = [opts.appId]
+  if (opts.version) query["filter[version]"] = [opts.version]
+  if (opts.platform) query["filter[preReleaseVersion.platform]"] = [opts.platform.toUpperCase()]
 
-  const builds = await ascFetchAll<Build>("/v1/builds", { params })
+  const result = await buildsGetCollection({ query } as Parameters<typeof buildsGetCollection>[0])
+  const data = throwOnError(result)
+  const builds = data.data
 
   const fmt = detectFormat(opts.output)
   if (fmt === "json") {
@@ -28,18 +36,19 @@ export async function buildsList(opts: {
     ["ID", "Version", "Uploaded", "State", "Expired"],
     builds.map((b) => [
       b.id,
-      b.attributes.version,
-      formatDate(b.attributes.uploadedDate),
-      b.attributes.processingState ?? "-",
-      b.attributes.expired ? "yes" : "no",
+      b.attributes?.version ?? "-",
+      formatDate(b.attributes?.uploadedDate ?? ""),
+      b.attributes?.processingState ?? "-",
+      b.attributes?.expired ? "yes" : "no",
     ]),
     `Builds (${builds.length})`,
   )
 }
 
 export async function buildsGet(buildId: string, opts: { output?: string } = {}): Promise<void> {
-  const res = await ascFetch<Build>(`/v1/builds/${buildId}`)
-  const b = res.data
+  const result = await buildsGetInstance({ path: { id: buildId } })
+  const data = throwOnError(result)
+  const b = data.data
 
   const fmt = detectFormat(opts.output)
   if (fmt === "json") {
@@ -48,11 +57,11 @@ export async function buildsGet(buildId: string, opts: { output?: string } = {})
   }
 
   console.log(`ID:               ${b.id}`)
-  console.log(`Version:          ${b.attributes.version}`)
-  console.log(`Uploaded:         ${formatDate(b.attributes.uploadedDate)}`)
-  console.log(`Processing State: ${b.attributes.processingState ?? "-"}`)
-  console.log(`Expired:          ${b.attributes.expired ? "yes" : "no"}`)
-  console.log(`Min OS:           ${b.attributes.minOsVersion ?? "-"}`)
+  console.log(`Version:          ${b.attributes?.version ?? "-"}`)
+  console.log(`Uploaded:         ${formatDate(b.attributes?.uploadedDate ?? "")}`)
+  console.log(`Processing State: ${b.attributes?.processingState ?? "-"}`)
+  console.log(`Expired:          ${b.attributes?.expired ? "yes" : "no"}`)
+  console.log(`Min OS:           ${b.attributes?.minOsVersion ?? "-"}`)
 }
 
 export async function buildsUpdateBetaNotes(opts: {
@@ -61,15 +70,15 @@ export async function buildsUpdateBetaNotes(opts: {
   notes: string
 }): Promise<void> {
   // First get existing localizations
-  const res = await ascFetchAll<{ type: string; id: string; attributes: { locale: string; whatsNew?: string } }>(
-    `/v1/builds/${opts.buildId}/betaBuildLocalizations`,
-  )
+  const listResult = await buildsBetaBuildLocalizationsGetToManyRelated({ path: { id: opts.buildId } })
+  const listData = throwOnError(listResult)
+  const locs = listData.data
 
-  const existing = res.find((l) => l.attributes.locale === opts.locale)
+  const existing = locs.find((l) => l.attributes?.locale === opts.locale)
 
   if (existing) {
-    await ascFetch(`/v1/betaBuildLocalizations/${existing.id}`, {
-      method: "PATCH",
+    await betaBuildLocalizationsUpdateInstance({
+      path: { id: existing.id },
       body: {
         data: {
           type: "betaBuildLocalizations",
@@ -80,8 +89,7 @@ export async function buildsUpdateBetaNotes(opts: {
     })
     printSuccess(`Beta notes updated for locale "${opts.locale}"`)
   } else {
-    await ascFetch("/v1/betaBuildLocalizations", {
-      method: "POST",
+    await betaBuildLocalizationsCreateInstance({
       body: {
         data: {
           type: "betaBuildLocalizations",