adapty 0.8.3 → 0.8.4

package/oclif.manifest.json

@@ -806,6 +806,113 @@
         "list.js"
       ]
     },
+    "flows:publish": {
+      "aliases": [],
+      "args": {
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
+          "required": true
+        }
+      },
+      "description": "Publish a flow (async — publication completes in the background). Publishing is async: returns status `publishing`. Poll `adapty flows get <flow_id>` for `published`/`publication_failed`; on failure, `adapty flows config get <flow_id>` shows why.",
+      "examples": [
+        "<%= config.bin %> flows publish --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"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flows:publish",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flows",
+        "publish.js"
+      ]
+    },
+    "flows:update": {
+      "aliases": [],
+      "args": {
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
+          "required": true
+        }
+      },
+      "description": "Rename a flow",
+      "examples": [
+        "<%= config.bin %> flows update --app UUID 550e8400-e29b-41d4-a716-446655440000 --name \"Onboarding v2\""
+      ],
+      "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"
+        },
+        "name": {
+          "description": "New flow name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flows:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flows",
+        "update.js"
+      ]
+    },
     "paywalls:create": {
       "aliases": [],
       "args": {},
@@ -1077,7 +1184,8 @@
       "args": {},
       "description": "Create a placement with a paywall",
       "examples": [
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= 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": {
@@ -1097,7 +1205,7 @@
           "type": "option"
         },
         "audiences": {
-          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
+          "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,
@@ -1256,7 +1364,8 @@
       },
       "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= 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": {
@@ -1276,7 +1385,7 @@
           "type": "option"
         },
         "audiences": {
-          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
+          "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,
@@ -3743,17 +3852,13 @@
         "list.js"
       ]
     },
-    "asa:metrics": {
+    "asa:keywords:add": {
       "aliases": [],
       "args": {},
-      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at 5000 breakdown\nrows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen\nthe grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most\n2 per 10 seconds, one at a time.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
+      "description": "Add targeting keywords to an ad group",
       "examples": [
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --group-by country --page-size 1000",
-        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90",
-        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric arpas --campaign 0f0e..."
+        "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
+        "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
       ],
       "flags": {
         "json": {
@@ -3763,133 +3868,85 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
           "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"
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "by-days": {
-          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
-          "name": "by-days",
+        "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": true,
+          "multiple": false,
           "type": "option"
         },
         "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
+          "description": "Ad group ID (UUID) — the campaign is resolved from it",
           "name": "ad-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "date-from": {
-          "description": "Start of the period (YYYY-MM-DD)",
-          "name": "date-from",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "date-to": {
-          "description": "End of the period (YYYY-MM-DD)",
-          "name": "date-to",
-          "required": true,
+        "bid": {
+          "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
+          "name": "bid",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "entity": {
-          "description": "What to report on",
-          "name": "entity",
-          "required": true,
+        "from-file": {
+          "description": "File with one keyword per line, combined with any --text values",
+          "name": "from-file",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ad",
-            "ad-group",
-            "campaign",
-            "keyword"
-          ],
           "type": "option"
         },
-        "group-by": {
-          "description": "Break the rows down by a dimension, repeatable",
-          "name": "group-by",
+        "match-type": {
+          "description": "Match type",
+          "name": "match-type",
+          "default": "BROAD",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "options": [
-            "country",
-            "day",
-            "month",
-            "quarter",
-            "week",
-            "year"
+            "BROAD",
+            "EXACT"
           ],
           "type": "option"
         },
-        "metric": {
-          "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable and required; every metric asked for is computed over the whole entity set, so list only what you read; a wrong name fails listing all valid ones",
-          "name": "metric",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "order": {
-          "description": "Sort direction",
-          "name": "order",
-          "default": "desc",
+        "status": {
+          "description": "Keyword status",
+          "name": "status",
+          "default": "ACTIVE",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "asc",
-            "desc"
+            "ACTIVE",
+            "PAUSED"
           ],
           "type": "option"
         },
-        "order-by": {
-          "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
-          "name": "order-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "order-by-day": {
-          "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
-          "name": "order-by-day",
+        "text": {
+          "description": "Keyword text, repeatable",
+          "name": "text",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:metrics",
+      "id": "asa:keywords:add",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3900,17 +3957,17 @@
         "dist",
         "commands",
         "asa",
-        "metrics",
-        "index.js"
+        "keywords",
+        "add.js"
       ]
     },
-    "asa:metrics:overview": {
+    "asa:keywords:list": {
       "aliases": [],
       "args": {},
-      "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
+      "description": "List targeting keywords; read numbers with asa metrics",
       "examples": [
-        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
-        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
+        "<%= config.bin %> asa keywords list",
+        "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
       ],
       "flags": {
         "json": {
@@ -3920,69 +3977,72 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "by-days": {
-          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
-          "name": "by-days",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "date-from": {
-          "description": "Start of the period (YYYY-MM-DD)",
-          "name": "date-from",
-          "required": true,
+        "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"
         },
-        "date-to": {
-          "description": "End of the period (YYYY-MM-DD)",
-          "name": "date-to",
-          "required": true,
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "entity": {
-          "description": "What to report on",
-          "name": "entity",
-          "required": true,
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "search": {
+          "description": "Case-insensitive substring match on the name",
+          "name": "search",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ad",
-            "ad-group",
-            "campaign",
-            "keyword"
-          ],
           "type": "option"
         },
-        "metric": {
-          "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
-          "name": "metric",
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "period-unit": {
-          "description": "Bucket size",
-          "name": "period-unit",
-          "default": "day",
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "status": {
+          "description": "Keep only rows in this state",
+          "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "day",
-            "month",
-            "quarter",
-            "week",
-            "year"
+            "ACTIVE",
+            "PAUSED"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:metrics:overview",
+      "id": "asa:keywords:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3993,16 +4053,23 @@
         "dist",
         "commands",
         "asa",
-        "metrics",
-        "overview.js"
+        "keywords",
+        "list.js"
       ]
     },
-    "asa:orgs:list": {
+    "asa:keywords:update": {
       "aliases": [],
-      "args": {},
-      "description": "List the Apple Search Ads organizations this company can spend from",
+      "args": {
+        "keyword_id": {
+          "description": "Keyword ID (UUID), repeatable as extra arguments",
+          "name": "keyword_id",
+          "required": true
+        }
+      },
+      "description": "Change bid, status, text or match type of keywords",
       "examples": [
-        "<%= config.bin %> asa orgs list"
+        "<%= config.bin %> asa keywords update UUID --bid 2.00",
+        "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
       ],
       "flags": {
         "json": {
@@ -4012,56 +4079,13 @@
           "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,
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:orgs:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "orgs",
-        "list.js"
-      ]
-    },
-    "asa:negative-keywords:add": {
-      "aliases": [],
-      "args": {},
-      "description": "Add negative keywords to an ad group or across a campaign",
-      "examples": [
-        "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
-        "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
-        "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
         "yes": {
           "char": "y",
@@ -4077,31 +4101,9 @@
           "multiple": false,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "exclusive": [
-            "campaign"
-          ],
-          "name": "ad-group",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all-ad-groups": {
-          "dependsOn": [
-            "campaign"
-          ],
-          "description": "Apply to every ad group of the campaign instead of the campaign itself",
-          "name": "all-ad-groups",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "campaign": {
-          "description": "Campaign ID (UUID)",
-          "exclusive": [
-            "ad-group"
-          ],
-          "name": "campaign",
+        "bid": {
+          "description": "Bid (amount, e.g. 50 or 12.50)",
+          "name": "bid",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4109,7 +4111,6 @@
         "match-type": {
           "description": "Match type",
           "name": "match-type",
-          "default": "EXACT",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -4121,7 +4122,6 @@
         "status": {
           "description": "Keyword status",
           "name": "status",
-          "default": "ACTIVE",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -4131,38 +4131,41 @@
           "type": "option"
         },
         "text": {
-          "description": "Keyword text, repeatable",
+          "description": "Keyword text (only meaningful for a single keyword)",
           "name": "text",
-          "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:negative-keywords:add",
+      "id": "asa:keywords:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "asa",
-        "negative-keywords",
-        "add.js"
+        "keywords",
+        "update.js"
       ]
     },
-    "asa:negative-keywords:list": {
+    "asa:metrics": {
       "aliases": [],
       "args": {},
-      "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
+      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at 5000 breakdown\nrows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen\nthe grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most\n2 per 10 seconds, one at a time.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
       "examples": [
-        "<%= config.bin %> asa negative-keywords list",
-        "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --group-by country --page-size 1000",
+        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90",
+        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric arpas --campaign 0f0e..."
       ],
       "flags": {
         "json": {
@@ -4188,25 +4191,25 @@
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
+        "by-days": {
+          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
+          "name": "by-days",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "search": {
-          "description": "Case-insensitive substring match on the name",
-          "name": "search",
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "campaign": {
@@ -4216,23 +4219,89 @@
           "multiple": true,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
+        "date-from": {
+          "description": "Start of the period (YYYY-MM-DD)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "End of the period (YYYY-MM-DD)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "entity": {
+          "description": "What to report on",
+          "name": "entity",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad",
+            "ad-group",
+            "campaign",
+            "keyword"
+          ],
+          "type": "option"
+        },
+        "group-by": {
+          "description": "Break the rows down by a dimension, repeatable",
+          "name": "group-by",
           "hasDynamicHelp": false,
           "multiple": true,
+          "options": [
+            "country",
+            "day",
+            "month",
+            "quarter",
+            "week",
+            "year"
+          ],
           "type": "option"
         },
-        "campaign-level-only": {
-          "description": "Keep only campaign-level rows (ad_group_id is null)",
-          "name": "campaign-level-only",
-          "allowNo": false,
-          "type": "boolean"
+        "metric": {
+          "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable and required; every metric asked for is computed over the whole entity set, so list only what you read; a wrong name fails listing all valid ones",
+          "name": "metric",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "order": {
+          "description": "Sort direction",
+          "name": "order",
+          "default": "desc",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "asc",
+            "desc"
+          ],
+          "type": "option"
+        },
+        "order-by": {
+          "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
+          "name": "order-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "order-by-day": {
+          "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
+          "name": "order-by-day",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:negative-keywords:list",
+      "id": "asa:metrics",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4243,17 +4312,17 @@
         "dist",
         "commands",
         "asa",
-        "negative-keywords",
-        "list.js"
+        "metrics",
+        "index.js"
       ]
     },
-    "asa:search-terms:list": {
+    "asa:metrics:overview": {
       "aliases": [],
       "args": {},
-      "description": "List the search terms your ads matched, with their metrics",
+      "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
       "examples": [
-        "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
-        "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
+        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
+        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
       ],
       "flags": {
         "json": {
@@ -4263,75 +4332,69 @@
           "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,
+        "by-days": {
+          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
+          "name": "by-days",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "date-from": {
-          "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
+          "description": "Start of the period (YYYY-MM-DD)",
           "name": "date-from",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "date-to": {
-          "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
+          "description": "End of the period (YYYY-MM-DD)",
           "name": "date-to",
+          "required": true,
           "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"
-        },
-        "search": {
-          "description": "Case-insensitive substring match on the name",
-          "name": "search",
+        "entity": {
+          "description": "What to report on",
+          "name": "entity",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "ad",
+            "ad-group",
+            "campaign",
+            "keyword"
+          ],
           "type": "option"
         },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
+        "metric": {
+          "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
+          "name": "metric",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
+        "period-unit": {
+          "description": "Bucket size",
+          "name": "period-unit",
+          "default": "day",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "options": [
+            "day",
+            "month",
+            "quarter",
+            "week",
+            "year"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:search-terms:list",
+      "id": "asa:metrics:overview",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4342,17 +4405,18 @@
         "dist",
         "commands",
         "asa",
-        "search-terms",
-        "list.js"
+        "metrics",
+        "overview.js"
       ]
     },
-    "asa:product-pages:list": {
+    "asa:negative-keywords:add": {
       "aliases": [],
       "args": {},
-      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
+      "description": "Add negative keywords to an ad group or across a campaign",
       "examples": [
-        "<%= config.bin %> asa product-pages list",
-        "<%= config.bin %> asa product-pages list --app APP_UUID"
+        "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
+        "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
+        "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
       ],
       "flags": {
         "json": {
@@ -4362,32 +4426,77 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "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"
         },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
+        "ad-group": {
+          "description": "Ad group ID (UUID) — the campaign is resolved from it",
+          "exclusive": [
+            "campaign"
+          ],
+          "name": "ad-group",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
+        "all-ad-groups": {
+          "dependsOn": [
+            "campaign"
+          ],
+          "description": "Apply to every ad group of the campaign instead of the campaign itself",
+          "name": "all-ad-groups",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "campaign": {
+          "description": "Campaign ID (UUID)",
+          "exclusive": [
+            "ad-group"
+          ],
+          "name": "campaign",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
+        "match-type": {
+          "description": "Match type",
+          "name": "match-type",
+          "default": "EXACT",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BROAD",
+            "EXACT"
+          ],
+          "type": "option"
+        },
+        "status": {
+          "description": "Keyword status",
+          "name": "status",
+          "default": "ACTIVE",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ACTIVE",
+            "PAUSED"
+          ],
+          "type": "option"
+        },
+        "text": {
+          "description": "Keyword text, repeatable",
+          "name": "text",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -4395,7 +4504,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:product-pages:list",
+      "id": "asa:negative-keywords:add",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4406,17 +4515,17 @@
         "dist",
         "commands",
         "asa",
-        "product-pages",
-        "list.js"
+        "negative-keywords",
+        "add.js"
       ]
     },
-    "asa:product-pages:sync": {
+    "asa:negative-keywords:list": {
       "aliases": [],
       "args": {},
-      "description": "Refresh custom product pages from Apple",
+      "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
       "examples": [
-        "<%= config.bin %> asa product-pages sync",
-        "<%= config.bin %> asa product-pages sync --adam-id 123456"
+        "<%= config.bin %> asa negative-keywords list",
+        "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
       ],
       "flags": {
         "json": {
@@ -4426,78 +4535,67 @@
           "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",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "adam-id": {
-          "description": "Limit the refresh to one app; omit to cover every app",
-          "name": "adam-id",
+        "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:product-pages:sync",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "product-pages",
-        "sync.js"
-      ]
-    },
-    "flows:media:upload": {
-      "aliases": [],
-      "args": {
-        "file": {
-          "description": "Path to the image file to upload",
-          "name": "file",
-          "required": true
-        }
-      },
-      "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
-      "examples": [
-        "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
         "app": {
-          "description": "App ID (UUID)",
+          "description": "Keep only rows in this app; repeatable",
           "name": "app",
-          "required": true,
+          "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"
+        },
+        "search": {
+          "description": "Case-insensitive substring match on the name",
+          "name": "search",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-level-only": {
+          "description": "Keep only campaign-level rows (ad_group_id is null)",
+          "name": "campaign-level-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:media:upload",
+      "id": "asa:negative-keywords:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4507,23 +4605,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "media",
-        "upload.js"
+        "asa",
+        "negative-keywords",
+        "list.js"
       ]
     },
-    "flows:config:get": {
+    "asa:orgs:list": {
       "aliases": [],
-      "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
-          "required": true
-        }
-      },
-      "description": "Read the flow builder config (404 until the config has been written at least once)",
+      "args": {},
+      "description": "List the Apple Search Ads organizations this company can spend from",
       "examples": [
-        "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> asa orgs list"
       ],
       "flags": {
         "json": {
@@ -4533,10 +4625,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "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"
@@ -4544,7 +4644,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:get",
+      "id": "asa:orgs:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4554,26 +4654,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "get.js"
+        "asa",
+        "orgs",
+        "list.js"
       ]
     },
-    "flows:config:preview": {
+    "asa:product-pages:list": {
       "aliases": [],
-      "args": {
-        "config_file": {
-          "description": "Path to a local flow config JSON file",
-          "name": "config_file",
-          "required": true
-        }
-      },
-      "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
+      "args": {},
+      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
       "examples": [
-        "<%= config.bin %> flows config preview ./config.json",
-        "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
-        "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
-        "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
+        "<%= config.bin %> asa product-pages list",
+        "<%= config.bin %> asa product-pages list --app APP_UUID"
       ],
       "flags": {
         "json": {
@@ -4583,37 +4675,40 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "device": {
-          "description": "Device frame to render in",
-          "name": "device",
-          "default": "iphone-14",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "orientation": {
-          "description": "Device orientation to render in",
-          "name": "orientation",
-          "default": "portrait",
+        "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": [
-            "landscape",
-            "portrait"
-          ],
           "type": "option"
         },
-        "screen": {
-          "description": "Screen ID to render (default: the flow's first screen)",
-          "name": "screen",
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
           "hasDynamicHelp": false,
-          "multiple": 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": "flows:config:preview",
+      "id": "asa:product-pages:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4623,25 +4718,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "preview.js"
+        "asa",
+        "product-pages",
+        "list.js"
       ]
     },
-    "flows:config:update": {
+    "asa:product-pages:sync": {
       "aliases": [],
-      "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
-          "required": true
-        }
-      },
-      "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
+      "args": {},
+      "description": "Refresh custom product pages from Apple",
       "examples": [
-        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
-        "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
-        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
+        "<%= config.bin %> asa product-pages sync",
+        "<%= config.bin %> asa product-pages sync --adam-id 123456"
       ],
       "flags": {
         "json": {
@@ -4651,38 +4739,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "config": {
-          "description": "Builder config as a JSON string",
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "config-file": {
-          "description": "JSON file with the builder config, or - to read stdin",
-          "name": "config-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "expected-updated-at": {
-          "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
-          "name": "expected-updated-at",
+        "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"
         },
-        "remote-configs": {
-          "description": "JSON array of remote config entries: [{locale, data}]",
-          "name": "remote-configs",
+        "adam-id": {
+          "description": "Limit the refresh to one app; omit to cover every app",
+          "name": "adam-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4690,7 +4763,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:update",
+      "id": "asa:product-pages:sync",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4700,25 +4773,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "update.js"
+        "asa",
+        "product-pages",
+        "sync.js"
       ]
     },
-    "flows:config:validate": {
+    "asa:search-terms:list": {
       "aliases": [],
-      "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
-          "required": true
-        }
-      },
-      "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
+      "args": {},
+      "description": "List the search terms your ads matched, with their metrics",
       "examples": [
-        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
-        "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
-        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
+        "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
+        "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
       ],
       "flags": {
         "json": {
@@ -4728,32 +4794,75 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config": {
-          "description": "Builder config as a JSON string",
-          "name": "config",
+        "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"
         },
-        "config-file": {
-          "description": "JSON file with the builder config, or - to read stdin",
-          "name": "config-file",
+        "date-from": {
+          "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
+          "name": "date-from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
+          "name": "date-to",
+          "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"
+        },
+        "search": {
+          "description": "Case-insensitive substring match on the name",
+          "name": "search",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:validate",
+      "id": "asa:search-terms:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4763,18 +4872,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "validate.js"
+        "asa",
+        "search-terms",
+        "list.js"
       ]
     },
-    "asa:keywords:add": {
+    "flows:config:get": {
       "aliases": [],
-      "args": {},
-      "description": "Add targeting keywords to an ad group",
+      "args": {
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
+          "required": true
+        }
+      },
+      "description": "Read the flow builder config (404 until the config has been written at least once). On a failed publish, `publication_status`, `transform_error` and `publication_error` show why.",
       "examples": [
-        "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
-        "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
+        "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -4784,85 +4898,87 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flows:config:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flows",
+        "config",
+        "get.js"
+      ]
+    },
+    "flows:config:preview": {
+      "aliases": [],
+      "args": {
+        "config_file": {
+          "description": "Path to a local flow config JSON file",
+          "name": "config_file",
+          "required": true
+        }
+      },
+      "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
+      "examples": [
+        "<%= config.bin %> flows config preview ./config.json",
+        "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
+        "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
+        "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "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"
-        },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "name": "ad-group",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "bid": {
-          "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
-          "name": "bid",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "from-file": {
-          "description": "File with one keyword per line, combined with any --text values",
-          "name": "from-file",
+        "device": {
+          "description": "Device frame to render in",
+          "name": "device",
+          "default": "iphone-14",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "match-type": {
-          "description": "Match type",
-          "name": "match-type",
-          "default": "BROAD",
+        "orientation": {
+          "description": "Device orientation to render in",
+          "name": "orientation",
+          "default": "portrait",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "BROAD",
-            "EXACT"
+            "landscape",
+            "portrait"
           ],
           "type": "option"
         },
-        "status": {
-          "description": "Keyword status",
-          "name": "status",
-          "default": "ACTIVE",
+        "screen": {
+          "description": "Screen ID to render (default: the flow's first screen)",
+          "name": "screen",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ACTIVE",
-            "PAUSED"
-          ],
-          "type": "option"
-        },
-        "text": {
-          "description": "Keyword text, repeatable",
-          "name": "text",
-          "hasDynamicHelp": false,
-          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:add",
+      "id": "flows:config:preview",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4872,18 +4988,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "keywords",
-        "add.js"
+        "flows",
+        "config",
+        "preview.js"
       ]
     },
-    "asa:keywords:list": {
+    "flows:config:update": {
       "aliases": [],
-      "args": {},
-      "description": "List targeting keywords; read numbers with asa metrics",
+      "args": {
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
+          "required": true
+        }
+      },
+      "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
       "examples": [
-        "<%= config.bin %> asa keywords list",
-        "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
+        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
+        "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
+        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
       ],
       "flags": {
         "json": {
@@ -4893,72 +5016,46 @@
           "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",
+          "description": "App ID (UUID)",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "search": {
-          "description": "Case-insensitive substring match on the name",
-          "name": "search",
+        "config": {
+          "description": "Builder config as a JSON string",
+          "name": "config",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
+        "config-file": {
+          "description": "JSON file with the builder config, or - to read stdin",
+          "name": "config-file",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
+        "expected-updated-at": {
+          "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
+          "name": "expected-updated-at",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "status": {
-          "description": "Keep only rows in this state",
-          "name": "status",
+        "remote-configs": {
+          "description": "JSON array of remote config entries: [{locale, data}]",
+          "name": "remote-configs",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ACTIVE",
-            "PAUSED"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:list",
+      "id": "flows:config:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4968,24 +5065,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "keywords",
-        "list.js"
+        "flows",
+        "config",
+        "update.js"
       ]
     },
-    "asa:keywords:update": {
+    "flows:config:validate": {
       "aliases": [],
       "args": {
-        "keyword_id": {
-          "description": "Keyword ID (UUID), repeatable as extra arguments",
-          "name": "keyword_id",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "Change bid, status, text or match type of keywords",
+      "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
       "examples": [
-        "<%= config.bin %> asa keywords update UUID --bid 2.00",
-        "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
+        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
+        "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
+        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
       ],
       "flags": {
         "json": {
@@ -4995,60 +5093,71 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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"
-        },
-        "bid": {
-          "description": "Bid (amount, e.g. 50 or 12.50)",
-          "name": "bid",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "match-type": {
-          "description": "Match type",
-          "name": "match-type",
+        "config": {
+          "description": "Builder config as a JSON string",
+          "name": "config",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "BROAD",
-            "EXACT"
-          ],
           "type": "option"
         },
-        "status": {
-          "description": "Keyword status",
-          "name": "status",
+        "config-file": {
+          "description": "JSON file with the builder config, or - to read stdin",
+          "name": "config-file",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ACTIVE",
-            "PAUSED"
-          ],
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flows:config:validate",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flows",
+        "config",
+        "validate.js"
+      ]
+    },
+    "flows:media:upload": {
+      "aliases": [],
+      "args": {
+        "file": {
+          "description": "Path to the image file to upload",
+          "name": "file",
+          "required": true
+        }
+      },
+      "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
+      "examples": [
+        "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "text": {
-          "description": "Keyword text (only meaningful for a single keyword)",
-          "name": "text",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5056,21 +5165,21 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:update",
+      "id": "flows:media:upload",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "keywords",
-        "update.js"
+        "flows",
+        "media",
+        "upload.js"
       ]
     }
   },
-  "version": "0.8.3"
+  "version": "0.8.4"
 }