@sitepong/fastnode 0.2.2 → 0.3.1

package/README.md

@@ -53,7 +53,8 @@ Each module can be imported separately:
 | `@sitepong/fastnode/match` | Sync certs + profiles across machines via git/S3/local storage |
 | `@sitepong/fastnode/produce` | Create App Store Connect apps and bundle IDs, manage capabilities |
 | `@sitepong/fastnode/pilot` | Upload builds to TestFlight, manage beta groups, set changelog |
-| `@sitepong/fastnode/deliver` | Upload metadata, screenshots, submit to App Review |
+| `@sitepong/fastnode/deliver` | Upload metadata, screenshots, previews, product page headers and search results assets (App Asset Library), submit to App Review |
+| `@sitepong/fastnode/review` | Read App Review's Resolution Center: rejection reasons and messages |
 | `@sitepong/fastnode/pem` | Create APNS push notification certificates |
 | `@sitepong/fastnode/gym` | Build and archive iOS apps via xcodebuild |
 | `@sitepong/fastnode/scan` | Run tests via xcodebuild, parse xcresult |
@@ -62,6 +63,68 @@ Each module can be imported separately:
 | `@sitepong/fastnode/precheck` | Static-analyze App Store metadata against review rules |
 | `@sitepong/fastnode/frameit` | Composite screenshots into device frames |
 
+## App Store assets (App Asset Library)
+
+App Store Connect API 4.5.1 replaced screenshot and preview sets with one
+asset library per app. Images and videos are uploaded once, then *placed* on
+App Store version localizations. The same library carries the iOS 27 creative
+assets: the product page header and the search results asset.
+
+```
+assets/
+  en-US/
+    screenshots/01-home.png              APP_SCREENSHOT, group picked from the image size
+    screenshots/IPHONE_DUO/01-home.png   APP_SCREENSHOT in an explicit placement group
+    previews/<PLACEMENT_GROUP>/demo.mp4  APP_PREVIEW (videos go in a group folder)
+    header/hero.png                      PRODUCT_PAGE_HEADER_ASSET (21:9 3840×1646, or 16:9 5244×2950)
+    search_results/card.png              APP_STORE_SEARCH_RESULTS_ASSET (3:2 or 16:9)
+```
+
+```bash
+npx @sitepong/fastnode assets specs                       # placement groups + accepted sizes, from Apple
+npx @sitepong/fastnode deliver -a com.example.app --assets-path ./assets --skip-binary-upload
+npx @sitepong/fastnode deliver -a com.example.app --screenshots-path ./screenshots --asset-library --overwrite-assets
+npx @sitepong/fastnode assets list -a com.example.app
+```
+
+- Placement groups and sizes come from `/v1/appAssetLibraryRefData`, never a
+  hard-coded table, so new devices (e.g. `IPHONE_DUO`) work without a release.
+- A file is uploaded once per content hash and reused across locales and
+  later runs. `--overwrite-assets` makes the folder the source of truth for
+  each slot it fills; without it, new placements are added beside existing ones.
+- Apple's per-group limits are enforced before upload (10 screenshots,
+  3 previews, 1 header per group for versions).
+- `--screenshots-path` without `--asset-library` still uses the deprecated
+  screenshot sets.
+- Assets can be submitted for review on their own:
+  `client.reviewSubmissionItems.create({ reviewSubmissionId, appAssetLibraryImageId })`.
+
+As a library: `uploadAssetLibrary({ client, appId, versionId, assetsPath })`
+from `@sitepong/fastnode/deliver`, or the raw resources
+`client.appAssetLibraries`, `appAssetLibraryImages`, `appAssetLibraryVideos`
+and `appAssetLibraryPlacements`.
+
+## App Review feedback
+
+The public API has no Resolution Center, so `fastnode rejections` reads it
+through an Apple ID session, the way Spaceship does:
+
+```bash
+FASTNODE_USER=you@example.com npx @sitepong/fastnode rejections --app-id 1234567890
+npx @sitepong/fastnode rejections --app-id 1234567890 --all --json
+```
+
+You sign in once: the Apple ID session (never the password) is saved to
+`~/.fastnode/sessions` (0600; override with `FASTNODE_SESSION_DIR`), and later
+`rejections` and `privacy` runs on the same Apple ID reuse it until Apple
+expires it, with no password or 2FA prompt. `--fresh-login` forces a new
+sign-in.
+
+It prints each submission waiting on you (`UNRESOLVED_ISSUES`), the guideline
+reasons App Review attached, and the message text. `--all` includes resolved
+submissions too. From code: `getReviewFeedback(session, appId)` in
+`@sitepong/fastnode/review`.
+
 ## Apple sign-in & one-click setup
 
 `fastnode` ships a complete "sign in with your Apple Developer Apple ID