From 9905d41065d7a1b7c77a08f7507814715367e9a2 Mon Sep 17 00:00:00 2001
From: koraytt <kkoraytt00@gmail.com>
Date: Tue, 21 Oct 2025 14:42:43 +0300
Subject: [PATCH 1/2] Add batch metadata support to get-version-metadata

---
 README.md                   |  3 +-
 cmd/get_version_metadata.go | 64 +++++++++++++++++++++++++++++++++++--
 2 files changed, 63 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 2768dcd6..a5787b0c 100644
--- a/README.md
+++ b/README.md
@@ -152,7 +152,8 @@ Usage:
 Flags:
   -i, --app-id int                   ID of the target iOS app (required)
   -b, --bundle-identifier string     The bundle identifier of the target iOS app (overrides the app ID)
-      --external-version-id string   External version identifier of the target iOS app (required)
+      --all-versions                 Retrieve metadata for all available versions
+      --external-version-id string   External version identifier of the target iOS app
   -h, --help                         help for get-version-metadata
 
 Global Flags:
diff --git a/cmd/get_version_metadata.go b/cmd/get_version_metadata.go
index d67e60d8..c052d394 100644
--- a/cmd/get_version_metadata.go
+++ b/cmd/get_version_metadata.go
@@ -2,6 +2,7 @@ package cmd
 
 import (
 	"errors"
+	"fmt"
 	"time"
 
 	"github.com/avast/retry-go"
@@ -15,6 +16,7 @@ func getVersionMetadataCmd() *cobra.Command {
 		appID             int64
 		bundleID          string
 		externalVersionID string
+		allVersions       bool
 	)
 
 	cmd := &cobra.Command{
@@ -25,6 +27,14 @@ func getVersionMetadataCmd() *cobra.Command {
 				return errors.New("either the app ID or the bundle identifier must be specified")
 			}
 
+			if !allVersions && externalVersionID == "" {
+				return errors.New("either the external version identifier must be specified or the --all-versions flag must be used")
+			}
+
+			if allVersions && externalVersionID != "" {
+				return errors.New("the --all-versions flag cannot be used together with the --external-version-id flag")
+			}
+
 			var lastErr error
 			var acc appstore.Account
 
@@ -55,6 +65,55 @@ func getVersionMetadataCmd() *cobra.Command {
 					app = lookupResult.App
 				}
 
+				if allVersions {
+					versions, err := dependencies.AppStore.ListVersions(appstore.ListVersionsInput{Account: acc, App: app})
+					if err != nil {
+						return err
+					}
+
+					versionDetails := make([]map[string]interface{}, 0, len(versions.ExternalVersionIdentifiers))
+					hasFailure := false
+					failureCount := 0
+					verboseMode := cmd.Flag("verbose").Value.String() == "true"
+
+					for _, versionID := range versions.ExternalVersionIdentifiers {
+						entry := map[string]interface{}{
+							"externalVersionID": versionID,
+						}
+
+						meta, err := dependencies.AppStore.GetVersionMetadata(appstore.GetVersionMetadataInput{
+							Account:   acc,
+							App:       app,
+							VersionID: versionID,
+						})
+						if err != nil {
+							hasFailure = true
+							failureCount++
+							entry["success"] = false
+							if verboseMode {
+								entry["error"] = err.Error()
+							}
+						} else {
+							entry["displayVersion"] = meta.DisplayVersion
+							entry["success"] = true
+						}
+
+						versionDetails = append(versionDetails, entry)
+					}
+
+					dependencies.Logger.Log().
+						Str("bundleID", app.BundleID).
+						Interface("versions", versionDetails).
+						Bool("success", !hasFailure).
+						Send()
+
+					if hasFailure {
+						return fmt.Errorf("failed to resolve metadata for %d version(s)", failureCount)
+					}
+
+					return nil
+				}
+
 				out, err := dependencies.AppStore.GetVersionMetadata(appstore.GetVersionMetadataInput{
 					Account:   acc,
 					App:       app,
@@ -88,9 +147,8 @@ func getVersionMetadataCmd() *cobra.Command {
 
 	cmd.Flags().Int64VarP(&appID, "app-id", "i", 0, "ID of the target iOS app (required)")
 	cmd.Flags().StringVarP(&bundleID, "bundle-identifier", "b", "", "The bundle identifier of the target iOS app (overrides the app ID)")
-	cmd.Flags().StringVar(&externalVersionID, "external-version-id", "", "External version identifier of the target iOS app (required)")
-
-	_ = cmd.MarkFlagRequired("external-version-id")
+	cmd.Flags().StringVar(&externalVersionID, "external-version-id", "", "External version identifier of the target iOS app")
+	cmd.Flags().BoolVar(&allVersions, "all-versions", false, "Retrieve metadata for all available versions")
 
 	return cmd
 }

From ea83bd3a641cb3ba17cedeb888bad1e4bba7517f Mon Sep 17 00:00:00 2001
From: koraytt <kkoraytt00@gmail.com>
Date: Tue, 21 Oct 2025 15:14:05 +0300
Subject: [PATCH 2/2] mention README warning to use a secondary Apple Account
 with --all-versions

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index a5787b0c..3bded1ed 100644
--- a/README.md
+++ b/README.md
@@ -163,6 +163,8 @@ Global Flags:
       --verbose                      enables verbose logs
 ```
 
+When using `--all-versions`, the command fires one request per version identifier against Apple’s private APIs. To avoid risking your main Apple Account, run this mode with a secondary account.
+
 **Note:** the tool runs in interactive mode by default. Use the `--non-interactive` flag
 if running in an automated environment.