appstore-tools 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alejandro Sanabria
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,192 @@
+# appstore-tools
+
+TypeScript CLI and library for App Store Connect. Authenticate with JWT, list apps, generate IPAs, and upload builds — all from your terminal.
+
+## Installation
+
+### From npm
+
+```bash
+npx appstore-tools --help
+```
+
+Or install globally:
+
+```bash
+npm install -g appstore-tools
+appstore-tools --help
+```
+
+### From source
+
+```bash
+git clone https://github.com/alesanabriav7/appstore-tools.git
+cd appstore-tools
+pnpm install
+npm link
+appstore-tools --help
+```
+
+## Setup
+
+Requires Node.js 20+ and an [App Store Connect API key](https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api).
+
+Set these environment variables (via `.env`, shell, or CI secrets):
+
+```env
+ASC_ISSUER_ID=your-issuer-id
+ASC_KEY_ID=your-key-id
+```
+
+For the private key, point to your `.p8` file (recommended):
+
+```env
+ASC_PRIVATE_KEY_PATH=./AuthKey_XXXXXX.p8
+```
+
+Or pass the key inline:
+
+```env
+ASC_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
+```
+
+`ASC_PRIVATE_KEY_PATH` takes priority when both are set. `ASC_BASE_URL` is optional and defaults to `https://api.appstoreconnect.apple.com/`.
+
+## Usage
+
+### List apps
+
+```bash
+npx appstore-tools apps list
+```
+
+JSON output:
+
+```bash
+npx appstore-tools apps list --json
+```
+
+### Generate IPA
+
+No credentials required.
+
+From xcodebuild:
+
+```bash
+npx appstore-tools ipa generate \
+  --output-ipa ./dist/MyApp.ipa \
+  --scheme MyApp \
+  --workspace-path ./MyApp.xcworkspace \
+  --export-options-plist ./ExportOptions.plist
+```
+
+From a custom command:
+
+```bash
+npx appstore-tools ipa generate \
+  --output-ipa ./dist/MyApp.ipa \
+  --build-command "make build-ipa" \
+  --generated-ipa-path ./build/MyApp.ipa
+```
+
+### Upload build
+
+Dry-run by default — verifies the IPA locally without uploading:
+
+```bash
+npx appstore-tools builds upload \
+  --app com.example.myapp \
+  --version 1.2.3 \
+  --build-number 45 \
+  --ipa ./dist/MyApp.ipa
+```
+
+Add `--apply` to upload, `--wait-processing` to poll until done:
+
+```bash
+npx appstore-tools builds upload \
+  --app com.example.myapp \
+  --version 1.2.3 \
+  --build-number 45 \
+  --ipa ./dist/MyApp.ipa \
+  --apply --wait-processing
+```
+
+Build and upload in one step (xcodebuild mode):
+
+```bash
+npx appstore-tools builds upload \
+  --app com.example.myapp \
+  --version 1.2.3 \
+  --build-number 45 \
+  --scheme MyApp \
+  --workspace-path ./MyApp.xcworkspace \
+  --export-options-plist ./ExportOptions.plist \
+  --apply
+```
+
+#### Preflight checks
+
+Every upload runs these checks before touching App Store Connect:
+
+- File exists, is readable, has `.ipa` extension
+- Archive contains `Payload/*.app/Info.plist`
+- Bundle ID, version, and build number match expectations
+- Code signing is valid (`codesign --verify --strict --deep`)
+- SHA-256 and MD5 checksums computed
+
+### Help
+
+```bash
+npx appstore-tools --help
+```
+
+## Library usage
+
+```typescript
+import { AppStoreConnectClient, listApps } from "appstore-tools";
+
+const client = new AppStoreConnectClient({
+  issuerId: process.env.ASC_ISSUER_ID!,
+  keyId: process.env.ASC_KEY_ID!,
+  privateKey: process.env.ASC_PRIVATE_KEY!
+});
+
+const apps = await listApps(client);
+console.log(apps);
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm verify          # typecheck + test + build + help
+```
+
+Individual commands:
+
+```bash
+pnpm typecheck       # type check
+pnpm test            # run tests
+pnpm build           # compile to dist/
+pnpm cli -- --help   # run built CLI
+pnpm cli:dev -- --help  # run from source (no build needed)
+```
+
+## Project structure
+
+```
+src/
+  api/
+    client.ts        # HTTP client with JWT auth
+    types.ts         # Shared upload operation types
+  commands/
+    apps-list.ts     # apps list command
+    builds-upload.ts # builds upload command
+    ipa-generate.ts  # ipa generate command
+  ipa/
+    artifact.ts      # IPA resolution (prebuilt/xcodebuild/custom)
+    preflight.ts     # IPA verification
+  cli.ts             # CLI entry point
+  index.ts           # Public API exports
+```

package/dist/api/client.d.ts

@@ -0,0 +1,54 @@
+export declare class DomainError extends Error {
+    constructor(message: string);
+}
+export declare class InfrastructureError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+export type HttpMethod = "GET" | "POST" | "PATCH" | "DELETE";
+export type HttpQueryValue = string | number | boolean | undefined;
+export interface HttpRequest {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly query?: Readonly<Record<string, HttpQueryValue>>;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+}
+export interface HttpResponse<T> {
+    readonly status: number;
+    readonly headers: Headers;
+    readonly data: T;
+}
+export interface AppStoreConnectAuthConfig {
+    readonly issuerId: string;
+    readonly keyId: string;
+    readonly privateKey: string;
+    readonly audience?: string;
+    readonly scope?: readonly string[];
+    readonly tokenTtlSeconds?: number;
+}
+export interface Clock {
+    now(): Date;
+}
+export type FetchLike = (input: URL | string, init?: RequestInit) => Promise<Response>;
+export declare class AppStoreConnectClient {
+    private cachedToken;
+    private readonly baseUrl;
+    private readonly clock;
+    private readonly fetchLike;
+    private readonly config;
+    constructor(config: AppStoreConnectAuthConfig, options?: {
+        readonly baseUrl?: string;
+        readonly clock?: Clock;
+        readonly fetchLike?: FetchLike;
+    });
+    request<T>(request: HttpRequest): Promise<HttpResponse<T>>;
+    getToken(): Promise<string>;
+    private buildPayload;
+    private sign;
+    private currentEpochSeconds;
+    private buildUrl;
+    private assertValidConfig;
+}
+export declare function safeReadText(response: Response): Promise<string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAMA,qBAAa,WAAY,SAAQ,KAAK;gBACjB,OAAO,EAAE,MAAM;CAInC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAyB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKpD;AAMD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB;AAMD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAuCD,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,IAAI,CAAC;CACb;AAYD,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,GAAG,GAAG,MAAM,EACnB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,qBAAa,qBAAqB;IAChC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAGjD,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;KAChC;IASU,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA8D1D,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BxC,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,iBAAiB;CAqB1B;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAMtE"}

package/dist/api/client.js

@@ -0,0 +1,183 @@
+import { createSign } from "node:crypto";
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export class DomainError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DomainError";
+    }
+}
+export class InfrastructureError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "InfrastructureError";
+        this.cause = cause;
+    }
+}
+function encodeJsonAsBase64Url(value) {
+    return Buffer.from(JSON.stringify(value), "utf8").toString("base64url");
+}
+const MAX_TOKEN_TTL_SECONDS = 1200;
+const DEFAULT_TOKEN_TTL_SECONDS = 1200;
+const REFRESH_WINDOW_SECONDS = 30;
+const DEFAULT_AUDIENCE = "appstoreconnect-v1";
+const DEFAULT_BASE_URL = "https://api.appstoreconnect.apple.com/";
+class SystemClock {
+    now() {
+        return new Date();
+    }
+}
+export class AppStoreConnectClient {
+    cachedToken = null;
+    baseUrl;
+    clock;
+    fetchLike;
+    config;
+    constructor(config, options) {
+        this.assertValidConfig(config);
+        this.config = config;
+        this.baseUrl = new URL(options?.baseUrl ?? DEFAULT_BASE_URL);
+        this.clock = options?.clock ?? new SystemClock();
+        this.fetchLike = options?.fetchLike ?? fetch;
+    }
+    async request(request) {
+        const token = await this.getToken();
+        const url = this.buildUrl(request.path, request.query);
+        const headers = new Headers(request.headers);
+        headers.set("Authorization", `Bearer ${token}`);
+        const hasBody = request.body !== undefined;
+        if (hasBody && !headers.has("Content-Type")) {
+            headers.set("Content-Type", "application/json");
+        }
+        const requestInit = {
+            method: request.method,
+            headers
+        };
+        if (hasBody) {
+            requestInit.body = JSON.stringify(request.body);
+        }
+        const response = await this.fetchLike(url, requestInit);
+        if (!response.ok) {
+            const errorBody = await safeReadText(response);
+            throw new InfrastructureError(`App Store Connect request failed (${response.status}): ${errorBody || response.statusText}`);
+        }
+        if (response.status === 204) {
+            return {
+                status: response.status,
+                headers: response.headers,
+                data: undefined
+            };
+        }
+        const textBody = await response.text();
+        if (!textBody) {
+            return {
+                status: response.status,
+                headers: response.headers,
+                data: undefined
+            };
+        }
+        try {
+            return {
+                status: response.status,
+                headers: response.headers,
+                data: JSON.parse(textBody)
+            };
+        }
+        catch (error) {
+            throw new InfrastructureError("Received invalid JSON from App Store Connect.", error);
+        }
+    }
+    async getToken() {
+        const nowEpochSeconds = this.currentEpochSeconds();
+        if (this.cachedToken &&
+            nowEpochSeconds < this.cachedToken.expiresAtEpochSeconds - REFRESH_WINDOW_SECONDS) {
+            return this.cachedToken.token;
+        }
+        const payload = this.buildPayload(nowEpochSeconds);
+        const header = {
+            alg: "ES256",
+            kid: this.config.keyId,
+            typ: "JWT"
+        };
+        const encodedHeader = encodeJsonAsBase64Url(header);
+        const encodedPayload = encodeJsonAsBase64Url(payload);
+        const signaturePayload = `${encodedHeader}.${encodedPayload}`;
+        const signature = this.sign(signaturePayload);
+        const token = `${signaturePayload}.${signature}`;
+        this.cachedToken = {
+            token,
+            expiresAtEpochSeconds: payload.exp
+        };
+        return token;
+    }
+    buildPayload(nowEpochSeconds) {
+        const ttlSeconds = this.config.tokenTtlSeconds ?? DEFAULT_TOKEN_TTL_SECONDS;
+        const payload = {
+            iss: this.config.issuerId,
+            iat: nowEpochSeconds,
+            exp: nowEpochSeconds + ttlSeconds,
+            aud: this.config.audience ?? DEFAULT_AUDIENCE
+        };
+        if (this.config.scope && this.config.scope.length > 0) {
+            return {
+                ...payload,
+                scope: this.config.scope
+            };
+        }
+        return payload;
+    }
+    sign(payload) {
+        try {
+            const signer = createSign("SHA256");
+            signer.update(payload);
+            signer.end();
+            return signer
+                .sign({ key: this.config.privateKey, dsaEncoding: "ieee-p1363" })
+                .toString("base64url");
+        }
+        catch (error) {
+            throw new InfrastructureError("Failed to sign App Store Connect JWT token.", error);
+        }
+    }
+    currentEpochSeconds() {
+        return Math.floor(this.clock.now().getTime() / 1000);
+    }
+    buildUrl(path, query) {
+        const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
+        const url = new URL(normalizedPath, this.baseUrl);
+        if (!query) {
+            return url;
+        }
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url;
+    }
+    assertValidConfig(config) {
+        if (!config.issuerId.trim()) {
+            throw new InfrastructureError("issuerId is required.");
+        }
+        if (!config.keyId.trim()) {
+            throw new InfrastructureError("keyId is required.");
+        }
+        if (!config.privateKey.trim()) {
+            throw new InfrastructureError("privateKey is required.");
+        }
+        const ttl = config.tokenTtlSeconds ?? DEFAULT_TOKEN_TTL_SECONDS;
+        if (ttl <= 0 || ttl > MAX_TOKEN_TTL_SECONDS) {
+            throw new InfrastructureError(`tokenTtlSeconds must be between 1 and ${MAX_TOKEN_TTL_SECONDS}.`);
+        }
+    }
+}
+export async function safeReadText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return "";
+    }
+}

package/dist/api/types.d.ts

@@ -0,0 +1,24 @@
+export interface UploadHttpHeader {
+    readonly name: string;
+    readonly value: string;
+}
+export interface UploadOperation {
+    readonly method: string;
+    readonly url: string;
+    readonly length: number;
+    readonly offset: number;
+    readonly requestHeaders: readonly UploadHttpHeader[];
+}
+export declare function parseUploadOperations(operationsPayload: readonly {
+    readonly method?: string;
+    readonly url?: string;
+    readonly offset?: number;
+    readonly length?: number;
+    readonly requestHeaders?: readonly {
+        readonly name?: string;
+        readonly value?: string;
+    }[];
+}[], context: string): UploadOperation[];
+export type UploadFetchLike = (input: URL | string, init?: RequestInit) => Promise<Response>;
+export declare function executeUploadOperations(filePath: string, operations: readonly UploadOperation[], fetchLike?: UploadFetchLike): Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACtD;AAED,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,SAAS;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS;QACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;CACL,EAAE,EACH,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAkCnB;AAMD,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,GAAG,GAAG,MAAM,EACnB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,SAAS,GAAE,eAAuB,GACjC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/api/types.js

@@ -0,0 +1,77 @@
+import { open } from "node:fs/promises";
+import { InfrastructureError, safeReadText } from "./client.js";
+export function parseUploadOperations(operationsPayload, context) {
+    return operationsPayload.map((item) => {
+        const method = item.method;
+        const url = item.url;
+        const length = item.length;
+        const offset = item.offset;
+        if (!method || !url || length === undefined || offset === undefined) {
+            throw new InfrastructureError(`Malformed ${context} payload: invalid upload operation.`);
+        }
+        const requestHeaders = (item.requestHeaders ?? []).map((header) => {
+            if (!header.name || header.value === undefined) {
+                throw new InfrastructureError(`Malformed ${context} payload: invalid upload operation header.`);
+            }
+            return {
+                name: header.name,
+                value: header.value
+            };
+        });
+        return {
+            method,
+            url,
+            length,
+            offset,
+            requestHeaders
+        };
+    });
+}
+export async function executeUploadOperations(filePath, operations, fetchLike = fetch) {
+    const fileHandle = await open(filePath, "r");
+    try {
+        for (const operation of operations) {
+            await executeOperation(fileHandle, operation, fetchLike);
+        }
+    }
+    finally {
+        await fileHandle.close();
+    }
+}
+async function executeOperation(fileHandle, operation, fetchLike) {
+    if (operation.length < 0 || operation.offset < 0) {
+        throw new InfrastructureError("Upload operation has invalid offset/length.");
+    }
+    const headers = new Headers();
+    for (const header of operation.requestHeaders) {
+        headers.set(header.name, header.value);
+    }
+    const body = operation.length === 0
+        ? undefined
+        : await readFileChunk(fileHandle, operation.offset, operation.length);
+    const requestInit = {
+        method: operation.method,
+        headers
+    };
+    if (body !== undefined) {
+        requestInit.body = body;
+    }
+    const response = await fetchLike(operation.url, requestInit);
+    if (!response.ok) {
+        const errorBody = await safeReadText(response);
+        throw new InfrastructureError(`Upload operation failed (${response.status}): ${errorBody || response.statusText}`);
+    }
+}
+async function readFileChunk(fileHandle, offset, length) {
+    const buffer = Buffer.alloc(length);
+    const { bytesRead } = await fileHandle.read({
+        buffer,
+        offset: 0,
+        length,
+        position: offset
+    });
+    if (bytesRead !== length) {
+        throw new InfrastructureError(`Upload operation expected ${length} bytes but read ${bytesRead} bytes.`);
+    }
+    return buffer;
+}

package/dist/cli.d.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import type { IpaSource } from "./ipa/artifact.js";
+interface CliEnvironment {
+    readonly issuerId: string;
+    readonly keyId: string;
+    readonly privateKey: string;
+    readonly baseUrl: string;
+}
+export declare function resolveCliEnvironment(env: NodeJS.ProcessEnv): Promise<CliEnvironment>;
+export interface AppsListCliCommand {
+    readonly kind: "apps-list";
+    readonly json: boolean;
+}
+export interface IpaGenerateCliCommand {
+    readonly kind: "ipa-generate";
+    readonly json: boolean;
+    readonly outputIpaPath: string;
+    readonly ipaSource: Exclude<IpaSource, {
+        kind: "prebuilt";
+    }>;
+}
+export interface BuildsUploadCliCommand {
+    readonly kind: "builds-upload";
+    readonly json: boolean;
+    readonly apply: boolean;
+    readonly waitProcessing: boolean;
+    readonly appReference: string;
+    readonly version: string;
+    readonly buildNumber: string;
+    readonly ipaSource: IpaSource;
+}
+export interface HelpCliCommand {
+    readonly kind: "help";
+}
+export type CliCommand = AppsListCliCommand | IpaGenerateCliCommand | BuildsUploadCliCommand | HelpCliCommand;
+export declare function parseCliCommand(argv: readonly string[]): CliCommand;
+export declare function runCli(argv: readonly string[], env: NodeJS.ProcessEnv): Promise<number>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AASnD,UAAU,cAAc;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAqC3F;AA2BD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,cAAc,CAAC;AAEnB,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA2BnE;AAyND,wBAAsB,MAAM,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CASjB"}