init

2026-03-13 10:46:13 +01:00
commit 837c414c34
4 changed files with 718 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,106 @@
+# Pricing
+
+A Swift command-line tool to download subscription pricing from App Store Connect.
+
+## Prerequisites
+
+- Swift 5.9+
+- An App Store Connect API key (`.p8` file) with access to your app's subscription data
+
+## Setup
+
+Export your App Store Connect API credentials as environment variables:
+
+```bash
+export AS_ISSUER_ID="your-issuer-id"
+export AS_KEY_ID="your-key-id"
+export AS_PRIVATE_KEY_PATH="/path/to/AuthKey_XXXX.p8"
+```
+
+You can add these to your shell profile (`~/.zshrc`, `~/.bashrc`) to persist them.
+
+## Usage
+
+```
+swift run pricing <app-id> [product-id] [options]
+swift run pricing <app-id> --group <group-name> [--csv <directory>]
+```
+
+### Arguments
+
+| Argument | Description |
+|---|---|
+| `app-id` | Numeric Apple ID from App Store Connect (e.g. `6737844884`) |
+| `product-id` | Subscription product ID string (e.g. `com.example.app.monthly`) |
+
+### Options
+
+| Option | Description |
+|---|---|
+| `--group <name>` | Fetch all subscriptions in a named subscription group |
+| `--csv <directory>` | Export results to CSV files (one per subscription) in the given directory |
+
+## Examples
+
+### Default: fetch all subscriptions in a group and export to CSV
+
+```bash
+swift run pricing 6737844884 --group subscriptions --csv ./export
+```
+
+This fetches every subscription in the "subscriptions" group, prints a price table for each one, and writes individual CSV files to `./export/` (e.g. `Core_Monthly.csv`, `Pro_Annual.csv`).
+
+### Fetch a single subscription
+
+```bash
+swift run pricing 6737844884 com.pixycad.core.monthly
+```
+
+### Fetch a single subscription and export to CSV
+
+```bash
+swift run pricing 6737844884 com.pixycad.core.monthly --csv ./export
+```
+
+### Fetch all subscriptions in a group (console only)
+
+```bash
+swift run pricing 6737844884 --group subscriptions
+```
+
+## Output
+
+### Console
+
+```
+[Core Monthly] (state: APPROVED)
+
+Subscription Prices for: com.pixycad.core.monthly
+────────────────────────────────────────────────────────────────────────
+Territory                       Curr        Price    Proceeds
+────────────────────────────────────────────────────────────────────────
+USA                             USD          4.99        4.24
+GBR                             GBP          4.99        4.24
+...
+────────────────────────────────────────────────────────────────────────
+Total territories: 175
+```
+
+### CSV
+
+Each CSV file contains:
+
+```
+Product ID,Territory,Currency,Customer Price,Proceeds
+com.pixycad.core.monthly,USA,USD,4.99,4.24
+com.pixycad.core.monthly,GBR,GBP,4.99,4.24
+...
+```
+
+Opens directly in Excel, Numbers, or Google Sheets.
+
+## Notes
+
+- Only the **current active price** per territory is returned (future scheduled prices and historical prices are filtered out)
+- The tool automatically retries on timeouts and rate limits (up to 3 attempts with backoff)
+- Group name matching is case-insensitive; if no match is found, available group names are printed