adapty 0.8.9 → 0.9.1

package/oclif.manifest.json

@@ -270,7 +270,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -308,7 +307,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -357,7 +355,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -416,7 +413,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -425,6 +421,85 @@
         "update.js"
       ]
     },
+    "asa:connect": {
+      "aliases": [],
+      "args": {},
+      "description": "Connect an Apple Search Ads account to this company",
+      "examples": [
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the browser step",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait until Apple Ads reports as connected",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:connect",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "connect.js"
+      ]
+    },
+    "asa:whoami": {
+      "aliases": [],
+      "args": {},
+      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
+      "examples": [
+        "<%= config.bin %> asa whoami"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:whoami",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "whoami.js"
+      ]
+    },
     "attribution:dimensions": {
       "aliases": [],
       "args": {},
@@ -721,7 +796,7 @@
     "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Remove the stored session",
+      "description": "Remove stored credentials and the saved migration selection",
       "examples": [
         "<%= config.bin %> auth logout"
       ],
@@ -753,7 +828,7 @@
     "auth:revoke": {
       "aliases": [],
       "args": {},
-      "description": "Revoke the current token on the server and remove any matching stored session",
+      "description": "Revoke the current token and remove matching stored credentials and migration selection",
       "examples": [
         "<%= config.bin %> auth revoke"
       ],
@@ -837,7 +912,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -846,85 +920,6 @@
         "whoami.js"
       ]
     },
-    "asa:connect": {
-      "aliases": [],
-      "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
-      "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the browser step",
-          "name": "timeout",
-          "default": 300,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "Wait until Apple Ads reports as connected",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:connect",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "connect.js"
-      ]
-    },
-    "asa:whoami": {
-      "aliases": [],
-      "args": {},
-      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
-      "examples": [
-        "<%= config.bin %> asa whoami"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:whoami",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "whoami.js"
-      ]
-    },
     "flows:create": {
       "aliases": [],
       "args": {},
@@ -1182,14 +1177,27 @@
         "update.js"
       ]
     },
-    "placements:create": {
+    "migrations:close": {
       "aliases": [],
       "args": {},
-      "description": "Create a placement with a paywall",
+      "description": "Choose finish to mark the migration as completed, or cancel to abandon it.\nBoth outcomes permanently close the migration and require --yes. No confirmation prompt is shown.\n\nWith --json, returns the full migration response after closing.",
       "examples": [
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        {
+          "description": "Finish the saved migration:",
+          "command": "<%= config.bin %> migrations close --outcome finish --yes"
+        },
+        {
+          "description": "Mark the migration as finished:",
+          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome finish --yes"
+        },
+        {
+          "description": "Abandon the migration:",
+          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome cancel --yes"
+        },
+        {
+          "description": "Finish and return the final state as JSON:",
+          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome finish --yes --json"
+        }
       ],
       "flags": {
         "json": {
@@ -1199,73 +1207,69 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "audiences": {
-          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
-          "name": "audiences",
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
+        "outcome": {
+          "description": "finish: mark completed; cancel: abandon the migration",
+          "name": "outcome",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "finish",
+            "cancel"
+          ],
           "type": "option"
         },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
+        "yes": {
+          "char": "y",
+          "description": "Confirm permanent closure of this migration",
+          "name": "yes",
           "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:create",
+      "id": "migrations:close",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Permanently finish or cancel a migration",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "create.js"
+        "migrations",
+        "close.js"
       ]
     },
-    "placements:get": {
+    "migrations:create": {
       "aliases": [],
-      "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
-          "required": true
-        }
-      },
-      "description": "Get placement details",
+      "args": {},
+      "description": "Use --name to migrate a catalog into a new Adapty app.\nFor an existing app, use --flow and --app together. Choose a flow and its app from `adapty migrations list`.\n\nCreation starts the flow and saves it as current; use `adapty migrations status` to continue.\nUse --no-select to keep the previous selection. ADAPTY_MIGRATION overrides saved selection.\nWith --json, the migration ID is in migration.id.",
       "examples": [
-        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        {
+          "description": "Start a catalog migration into a new app:",
+          "command": "<%= config.bin %> migrations create --name \"Acme Fitness\""
+        },
+        {
+          "description": "Start transactions for an existing app, if listed as available:",
+          "command": "<%= config.bin %> migrations create --flow transactions --app 3f2ab1c4-0000-4000-8000-000000000000"
+        },
+        {
+          "description": "Return the new migration as JSON for an agent or script:",
+          "command": "<%= config.bin %> migrations create --name \"Acme Fitness\" --json"
+        }
       ],
       "flags": {
         "json": {
@@ -1275,37 +1279,74 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "no-select": {
+          "description": "Create without changing the saved migration selection",
+          "name": "no-select",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "description": "New Adapty app name; cannot be combined with --flow or --app",
+          "exclusive": [
+            "app",
+            "flow"
+          ],
+          "name": "name",
+          "hasDynamicHelp": false,
+          "helpValue": "APP_NAME",
+          "multiple": false,
+          "type": "option"
+        },
+        "flow": {
+          "dependsOn": [
+            "app"
+          ],
+          "description": "Available flow from `adapty migrations list`; requires --app",
+          "name": "flow",
+          "hasDynamicHelp": false,
+          "helpValue": "FLOW",
+          "multiple": false,
+          "type": "option"
+        },
         "app": {
-          "description": "App ID (UUID)",
+          "dependsOn": [
+            "flow"
+          ],
+          "description": "Existing Adapty app ID (UUID); requires --flow",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
+          "helpValue": "APP_ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:get",
+      "id": "migrations:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Start a migration into Adapty",
+      "usage": [
+        "migrations create --name APP_NAME [--no-select] [--json]",
+        "migrations create --flow FLOW --app APP_ID [--no-select] [--json]"
+      ],
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "get.js"
+        "migrations",
+        "create.js"
       ]
     },
-    "placements:list": {
+    "migrations:current": {
       "aliases": [],
       "args": {},
-      "description": "List placements for an app",
+      "description": "ADAPTY_MIGRATION takes precedence over the saved selection for the current token.\nWith no applicable selection, returns null and exits successfully.",
       "examples": [
-        "<%= config.bin %> placements list --app 550e8400-..."
+        "<%= config.bin %> migrations current",
+        "<%= config.bin %> migrations current --json"
       ],
       "flags": {
         "json": {
@@ -1314,62 +1355,207 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:current",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show the effective migration selection and its source (no network)",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "current.js"
+      ]
+    },
+    "migrations:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Use a migration ID with `adapty migrations status -m ID` to continue an existing flow.\nStart an available flow with `adapty migrations create --flow FLOW --app APP_ID`.\n\nWith --json, items contains migrations and available contains flows with their target apps.",
+      "examples": [
+        {
+          "description": "Find migrations and available flows, grouped by app:",
+          "command": "<%= config.bin %> migrations list"
+        },
+        {
+          "description": "Read migration IDs and available flows as JSON:",
+          "command": "<%= config.bin %> migrations list --json"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List migrations and the flows you can start",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "list.js"
+      ]
+    },
+    "migrations:run": {
+      "aliases": [],
+      "args": {
+        "action_id": {
+          "description": "Offered action ID from `adapty migrations status`",
+          "name": "action_id",
+          "required": true
+        }
+      },
+      "description": "Choose an action ID from next_actions or available_actions in `adapty migrations status -m ID --json`.\nReplace ACTION_ID in the examples with an offered action ID.\nFor input actions, read the resources in reads and prepare a JSON object matching input_schema.\nOmitting input sends {}. Review confirm before passing --yes.\nWithout --yes, actions requiring confirmation exit with code 6. No confirmation prompt is shown.\n\nExternal actions print a link and open it in an interactive terminal. Complete the browser step, then check status.\nExternal actions reject --input and --input-file, including stdin.\nPipes and --json require --open to launch a browser; BROWSER=none disables it.\nFile uploads are not supported; use the dashboard or an offered Cloud Export action.\n\nWith --json, returns the full migration response (before the browser step for external actions).\nAfter a revision_conflict error, read status and review the action before retrying.",
+      "examples": [
+        {
+          "description": "Run an offered action on the saved migration after reviewing confirm:",
+          "command": "<%= config.bin %> migrations run ACTION_ID --yes"
+        },
+        {
+          "description": "Read current action IDs and input schemas first:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2 --json"
+        },
+        {
+          "description": "Submit an empty JSON object, if the action input_schema allows it:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input '{}'"
+        },
+        {
+          "description": "Submit a file matching input_schema, after reviewing confirm:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file ./decisions.json --yes --json"
+        },
+        {
+          "description": "Read the same prepared input from stdin:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file - --yes --json < ./decisions.json"
+        },
+        {
+          "description": "Get an external action link without opening a browser:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --no-browser"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "input": {
+          "description": "Input action data as a JSON object matching input_schema",
+          "exclusive": [
+            "input-file"
+          ],
+          "name": "input",
           "hasDynamicHelp": false,
+          "helpValue": "JSON",
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "input-file": {
+          "description": "Read an input action's JSON object from a file; use - for stdin",
+          "exclusive": [
+            "input"
+          ],
+          "name": "input-file",
           "hasDynamicHelp": false,
+          "helpValue": "PATH",
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm the input action after reviewing its confirmation text",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "open": {
+          "description": "Open an external action's HTTPS link, including with pipes or --json",
+          "exclusive": [
+            "no-browser"
+          ],
+          "name": "open",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-browser": {
+          "description": "Show the external action without opening a browser",
+          "exclusive": [
+            "open"
+          ],
+          "name": "no-browser",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:list",
+      "id": "migrations:run",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Run an input action or open an external action link",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "list.js"
+        "migrations",
+        "run.js"
       ]
     },
-    "placements:update": {
+    "migrations:show": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
-          "required": true
+        "resource": {
+          "description": "Resource name; omit to list what can be read now",
+          "name": "resource"
         }
       },
-      "description": "Update a placement",
+      "description": "Omit RESOURCE to list what can be read now. Use a name from that list, such as apps or mapping.\n\nReading a resource prints its data as JSON. With --json, returns the full migration response.\nResource data is in result (null if no data is available yet).",
       "examples": [
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        {
+          "description": "Read the RevenueCat apps of the selected migration:",
+          "command": "<%= config.bin %> migrations show apps"
+        },
+        {
+          "description": "List resource names available now:",
+          "command": "<%= config.bin %> migrations show -m mig_7x2"
+        },
+        {
+          "description": "Read mapping data, if listed as available:",
+          "command": "<%= config.bin %> migrations show mapping -m mig_7x2"
+        },
+        {
+          "description": "Extract only the resource data (requires jq):",
+          "command": "<%= config.bin %> migrations show mapping -m mig_7x2 --json | jq '.result'"
+        }
       ],
       "flags": {
         "json": {
@@ -1379,59 +1565,226 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:show",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List migration resources or read one resource",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "show.js"
+      ]
+    },
+    "migrations:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Read next_actions for the next steps and available_actions for optional actions.\nUse --json to read each action's input_schema, reads, and confirmation text.\n\n--wait returns when the revision changes, the state leaves running, or the polling budget runs out.\nExit 0 means the request succeeded, even if the migration is still running or has failed.\nCheck migration.state in JSON output. Progress goes to stderr. Ctrl+C exits with code 130.",
+      "examples": [
+        {
+          "description": "Inspect the saved migration:",
+          "command": "<%= config.bin %> migrations status"
         },
-        "audiences": {
-          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
-          "name": "audiences",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        {
+          "description": "See the current state and what to do next:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2"
         },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
-          "required": true,
+        {
+          "description": "Read action IDs, input schemas, and confirmation text as JSON:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2 --json"
+        },
+        {
+          "description": "Wait for a change with a five-minute polling budget:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2 --wait --timeout 5m --json"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
+        "timeout": {
+          "dependsOn": [
+            "wait"
+          ],
+          "description": "Polling budget with --wait: 1-600s, default 120s (e.g. 300, 300s, 5m); in-flight requests may take longer",
+          "name": "timeout",
           "hasDynamicHelp": false,
+          "helpValue": "DURATION",
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
-          "required": true,
+        "wait": {
+          "description": "Poll for a revision or state change, then return the latest response",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:status",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show migration state, issues, and available actions",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "status.js"
+      ]
+    },
+    "migrations:steps": {
+      "aliases": [],
+      "args": {},
+      "description": "Shows done, active, and locked steps in migration order.\nTo find actions you can run, use `adapty migrations status -m ID`.\n\nWith --json, the full migration response is returned; the checklist is in steps.",
+      "examples": [
+        {
+          "description": "View the saved migration checklist:",
+          "command": "<%= config.bin %> migrations steps"
+        },
+        {
+          "description": "View the checklist:",
+          "command": "<%= config.bin %> migrations steps -m mig_7x2"
+        },
+        {
+          "description": "Extract the checklist as JSON (requires jq):",
+          "command": "<%= config.bin %> migrations steps -m mig_7x2 --json | jq '.steps'"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "migrations:steps",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show the migration checklist and step statuses",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "steps.js"
+      ]
+    },
+    "migrations:unuse": {
+      "aliases": [],
+      "args": {},
+      "description": "Works without authentication, including when the saved context is malformed.\nADAPTY_MIGRATION remains active until you unset it in your shell.",
+      "examples": [
+        "<%= config.bin %> migrations unuse"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:unuse",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "summary": "Clear the saved migration selection (no network)",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "update.js"
+        "migrations",
+        "unuse.js"
+      ]
+    },
+    "migrations:use": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Migration ID from `adapty migrations list`",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Select a migration for the current token. This does not start or modify the migration.\nCompleted, canceled and failed migrations can also be selected for inspection.\nADAPTY_MIGRATION overrides the saved selection until you unset it in your shell.",
+      "examples": [
+        "<%= config.bin %> migrations use mig_7x2"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:use",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Save the current migration after verifying access",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "use.js"
       ]
     },
     "paywalls:create": {
@@ -1700,18 +2053,90 @@
         "update.js"
       ]
     },
-    "segments:get": {
+    "placements:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a placement with a paywall",
+      "examples": [
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "audiences": {
+          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
+          "name": "audiences",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Placement title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "placements:create",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "placements",
+        "create.js"
+      ]
+    },
+    "placements:get": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Get segment details",
+      "description": "Get placement details",
       "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1732,7 +2157,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:get",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1742,16 +2167,80 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "placements",
         "get.js"
       ]
     },
-    "segments:list": {
+    "placements:list": {
       "aliases": [],
       "args": {},
-      "description": "List segments for an app",
+      "description": "List placements for an app",
+      "examples": [
+        "<%= config.bin %> placements list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "placements:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "placements",
+        "list.js"
+      ]
+    },
+    "placements:update": {
+      "aliases": [],
+      "args": {
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
+          "required": true
+        }
+      },
+      "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -1769,18 +2258,32 @@
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "audiences": {
+          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
+          "name": "audiences",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Placement title",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1788,7 +2291,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:list",
+      "id": "placements:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1798,8 +2301,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
-        "list.js"
+        "placements",
+        "update.js"
       ]
     },
     "products:create": {
@@ -2086,6 +2589,108 @@
         "update.js"
       ]
     },
+    "segments:get": {
+      "aliases": [],
+      "args": {
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
+          "required": true
+        }
+      },
+      "description": "Get segment details",
+      "examples": [
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "get.js"
+      ]
+    },
+    "segments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List segments for an app",
+      "examples": [
+        "<%= config.bin %> segments list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "list.js"
+      ]
+    },
     "asa:ad-groups:create": {
       "aliases": [],
       "args": {},
@@ -2467,56 +3072,6 @@
         "update.js"
       ]
     },
-    "asa:apps:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List the apps promoted by this company in Apple Search Ads",
-      "examples": [
-        "<%= config.bin %> asa apps list",
-        "<%= config.bin %> asa apps list --page 2 --page-size 50"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:apps:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "apps",
-        "list.js"
-      ]
-    },
     "asa:ads:create": {
       "aliases": [],
       "args": {},
@@ -2738,7 +3293,73 @@
       },
       "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
       "examples": [
-        "<%= config.bin %> asa ads update UUID --status PAUSED"
+        "<%= config.bin %> asa ads update UUID --status PAUSED"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "idempotency-key": {
+          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
+          "name": "idempotency-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Ad name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Ad status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:ads:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "ads",
+        "update.js"
+      ]
+    },
+    "asa:apps:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the apps promoted by this company in Apple Search Ads",
+      "examples": [
+        "<%= config.bin %> asa apps list",
+        "<%= config.bin %> asa apps list --page 2 --page-size 50"
       ],
       "flags": {
         "json": {
@@ -2748,42 +3369,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Ad name",
-          "name": "name",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "status": {
-          "description": "Ad status",
-          "name": "status",
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:update",
+      "id": "asa:apps:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2794,8 +3399,8 @@
         "dist",
         "commands",
         "asa",
-        "ads",
-        "update.js"
+        "apps",
+        "list.js"
       ]
     },
     "asa:automations:create": {
@@ -3298,111 +3903,6 @@
         "update.js"
       ]
     },
-    "asa:competitors:summary": {
-      "aliases": [],
-      "args": {},
-      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
-      "examples": [
-        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-ids": {
-          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
-          "name": "app-ids",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:competitors:summary",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "competitors",
-        "summary.js"
-      ]
-    },
-    "asa:creatives:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List creatives; creative_id is what `asa ads create` needs",
-      "examples": [
-        "<%= config.bin %> asa creatives list",
-        "<%= config.bin %> asa creatives list --app APP_UUID"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:creatives:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "creatives",
-        "list.js"
-      ]
-    },
     "asa:campaigns:bulk-create": {
       "aliases": [],
       "args": {},
@@ -4107,6 +4607,111 @@
         "update.js"
       ]
     },
+    "asa:competitors:summary": {
+      "aliases": [],
+      "args": {},
+      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
+      "examples": [
+        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app-ids": {
+          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
+          "name": "app-ids",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:competitors:summary",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "competitors",
+        "summary.js"
+      ]
+    },
+    "asa:creatives:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "examples": [
+        "<%= config.bin %> asa creatives list",
+        "<%= config.bin %> asa creatives list --app APP_UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:creatives:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "creatives",
+        "list.js"
+      ]
+    },
     "asa:keywords:add": {
       "aliases": [],
       "args": {},
@@ -5499,5 +6104,5 @@
       ]
     }
   },
-  "version": "0.8.9"
+  "version": "0.9.1"
 }