adapty 0.8.6 → 0.8.8

package/oclif.manifest.json

@@ -504,6 +504,275 @@
         "whoami.js"
       ]
     },
+    "attribution:dimensions": {
+      "aliases": [],
+      "args": {},
+      "description": "List the dimensions an attribution report can group or filter by (not scoped to an app)",
+      "examples": [
+        "<%= config.bin %> attribution dimensions",
+        "<%= config.bin %> attribution dimensions --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:dimensions",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "dimensions.js"
+      ]
+    },
+    "attribution:metrics": {
+      "aliases": [],
+      "args": {},
+      "description": "List the metrics an attribution report can ask for (not scoped to an app)",
+      "examples": [
+        "<%= config.bin %> attribution metrics",
+        "<%= config.bin %> attribution metrics --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:metrics",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "metrics.js"
+      ]
+    },
+    "attribution:report": {
+      "aliases": [],
+      "args": {},
+      "description": "Run an Attribution report for an app: metrics over a period, grouped by dimensions",
+      "examples": [
+        "<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign",
+        "<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend --group-by date --granularity week --filter country=US,GB --sort spend:desc",
+        "<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign --json"
+      ],
+      "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"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metrics": {
+          "description": "Metric names, as `adapty attribution metrics` lists them (repeatable or comma-separated)",
+          "name": "metrics",
+          "required": true,
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "Dimensions to group rows by (repeatable or comma-separated)",
+          "name": "group-by",
+          "required": true,
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "date",
+            "campaign",
+            "adset",
+            "ad",
+            "keyword",
+            "channel",
+            "country",
+            "store"
+          ],
+          "type": "option"
+        },
+        "granularity": {
+          "description": "Date bucket; required with --group-by date, and allowed only with it",
+          "name": "granularity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ],
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep rows whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the revenue metrics use; the backend default applies when omitted",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort rows by a requested metric or dimension: field[:asc|desc] (ascending by default)",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:report",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "report.js"
+      ]
+    },
+    "attribution:values": {
+      "aliases": [],
+      "args": {},
+      "description": "List the values a dimension takes for an app over a period: what a report --filter can use",
+      "examples": [
+        "<%= config.bin %> attribution values --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --dimension campaign",
+        "<%= config.bin %> attribution values --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --dimension country --json"
+      ],
+      "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"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dimension": {
+          "description": "A filterable dimension, as `adapty attribution dimensions` lists it",
+          "name": "dimension",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the revenue metrics use; the backend default applies when omitted",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:values",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "values.js"
+      ]
+    },
     "auth:login": {
       "aliases": [],
       "args": {},
@@ -656,12 +925,12 @@
         "whoami.js"
       ]
     },
-    "paywalls:create": {
+    "flows:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a paywall with products",
+      "description": "Create a flow (row only — write its config with `flows config update`)",
       "examples": [
-        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+        "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
       ],
       "flags": {
         "json": {
@@ -679,17 +948,9 @@
           "multiple": false,
           "type": "option"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "product-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "title": {
-          "description": "Paywall title",
-          "name": "title",
+        "name": {
+          "description": "Flow name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -698,7 +959,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:create",
+      "id": "flows:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -708,22 +969,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "flows",
         "create.js"
       ]
     },
-    "paywalls:get": {
+    "flows:get": {
       "aliases": [],
       "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "Get paywall details",
+      "description": "Get flow details",
       "examples": [
-        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -744,7 +1005,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:get",
+      "id": "flows:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -754,16 +1015,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "flows",
         "get.js"
       ]
     },
-    "paywalls:list": {
+    "flows:list": {
       "aliases": [],
       "args": {},
-      "description": "List paywalls for an app",
+      "description": "List flows for an app",
       "examples": [
-        "<%= config.bin %> paywalls list --app 550e8400-..."
+        "<%= config.bin %> flows list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -800,7 +1061,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:list",
+      "id": "flows:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -810,22 +1071,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "flows",
         "list.js"
       ]
     },
-    "paywalls:placements": {
+    "flows:publish": {
       "aliases": [],
       "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "List placements that currently use this paywall",
+      "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 %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
+        "<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -842,11 +1103,18 @@
           "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": "paywalls:placements",
+      "id": "flows:publish",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -856,22 +1124,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "placements.js"
+        "flows",
+        "publish.js"
       ]
     },
-    "paywalls:update": {
+    "flows:update": {
       "aliases": [],
       "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "Update a paywall",
+      "description": "Rename a flow",
       "examples": [
-        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+        "<%= config.bin %> flows update --app UUID 550e8400-e29b-41d4-a716-446655440000 --name \"Onboarding v2\""
       ],
       "flags": {
         "json": {
@@ -889,17 +1157,9 @@
           "multiple": false,
           "type": "option"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "product-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "title": {
-          "description": "Paywall title",
-          "name": "title",
+        "name": {
+          "description": "New flow name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -908,7 +1168,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:update",
+      "id": "flows:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -918,18 +1178,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "flows",
         "update.js"
       ]
     },
-    "placements:create": {
+    "paywalls:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a placement with a paywall",
+      "description": "Create a paywall with products",
       "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"
+        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -947,30 +1205,16 @@
           "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",
+        "product-id": {
+          "description": "Product ID (UUID). Repeat for multiple.",
+          "name": "product-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,
+          "multiple": true,
           "type": "option"
         },
         "title": {
-          "description": "Placement title",
+          "description": "Paywall title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -980,7 +1224,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:create",
+      "id": "paywalls:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -990,22 +1234,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "paywalls",
         "create.js"
       ]
     },
-    "placements:get": {
+    "paywalls:get": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Get placement details",
+      "description": "Get paywall details",
       "examples": [
-        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1026,7 +1270,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:get",
+      "id": "paywalls:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1036,16 +1280,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "paywalls",
         "get.js"
       ]
     },
-    "placements:list": {
+    "paywalls:list": {
       "aliases": [],
       "args": {},
-      "description": "List placements for an app",
+      "description": "List paywalls for an app",
       "examples": [
-        "<%= config.bin %> placements list --app 550e8400-..."
+        "<%= config.bin %> paywalls list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1082,7 +1326,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:list",
+      "id": "paywalls:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1092,24 +1336,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "paywalls",
         "list.js"
       ]
     },
-    "placements:update": {
+    "paywalls:placements": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Update a placement",
+      "description": "List placements that currently use this paywall",
       "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"
+        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
       ],
       "flags": {
         "json": {
@@ -1126,31 +1368,63 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "paywalls:placements",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "paywalls",
+        "placements.js"
+      ]
+    },
+    "paywalls:update": {
+      "aliases": [],
+      "args": {
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
+          "required": true
+        }
+      },
+      "description": "Update a paywall",
+      "examples": [
+        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "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",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
+        "product-id": {
+          "description": "Product ID (UUID). Repeat for multiple.",
+          "name": "product-id",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "title": {
-          "description": "Placement title",
+          "description": "Paywall title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -1160,7 +1434,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "paywalls:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1170,16 +1444,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "paywalls",
         "update.js"
       ]
     },
-    "products:create": {
+    "placements:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a product with vendor products per platform",
+      "description": "Create a placement with a paywall",
       "examples": [
-        "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
+        "<%= 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": {
@@ -1197,81 +1473,31 @@
           "multiple": false,
           "type": "option"
         },
-        "access-level-id": {
-          "description": "Access level ID (UUID)",
-          "name": "access-level-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "android-base-plan-id": {
-          "description": "Android base plan ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "android-base-plan-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "android-product-id": {
-          "description": "Android product ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "android-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "ios-product-id": {
-          "description": "iOS product ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "ios-product-id",
+        "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"
         },
-        "paddle-price-id": {
-          "description": "Paddle price ID (requires --paddle-product-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "paddle-price-id",
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "paddle-product-id": {
-          "description": "Paddle product ID (requires --paddle-price-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "paddle-product-id",
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "period": {
-          "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
-          "name": "period",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stripe-price-id": {
-          "description": "Stripe price ID (requires --stripe-product-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "stripe-price-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stripe-product-id": {
-          "description": "Stripe product ID (requires --stripe-price-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "stripe-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "description": "Product title",
-          "name": "title",
+        "title": {
+          "description": "Placement title",
+          "name": "title",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1280,7 +1506,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:create",
+      "id": "placements:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1290,22 +1516,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "placements",
         "create.js"
       ]
     },
-    "products:get": {
+    "placements:get": {
       "aliases": [],
       "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Get product details",
+      "description": "Get placement details",
       "examples": [
-        "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1326,7 +1552,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:get",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1336,16 +1562,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "placements",
         "get.js"
       ]
     },
-    "products:list": {
+    "placements:list": {
       "aliases": [],
       "args": {},
-      "description": "List products for an app",
+      "description": "List placements for an app",
       "examples": [
-        "<%= config.bin %> products list --app 550e8400-..."
+        "<%= config.bin %> placements list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1382,7 +1608,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:list",
+      "id": "placements:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1392,22 +1618,94 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "placements",
         "list.js"
       ]
     },
-    "products:update": {
+    "placements:update": {
       "aliases": [],
       "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Update a product (title and access level only)",
+      "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
+        "<%= 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": {
+          "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:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "placements",
+        "update.js"
+      ]
+    },
+    "products:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a product with vendor products per platform",
+      "examples": [
+        "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
       ],
       "flags": {
         "json": {
@@ -1433,6 +1731,70 @@
           "multiple": false,
           "type": "option"
         },
+        "android-base-plan-id": {
+          "description": "Android base plan ID",
+          "helpGroup": "STORE BINDINGS",
+          "name": "android-base-plan-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "android-product-id": {
+          "description": "Android product ID",
+          "helpGroup": "STORE BINDINGS",
+          "name": "android-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ios-product-id": {
+          "description": "iOS product ID",
+          "helpGroup": "STORE BINDINGS",
+          "name": "ios-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paddle-price-id": {
+          "description": "Paddle price ID (requires --paddle-product-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "paddle-price-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paddle-product-id": {
+          "description": "Paddle product ID (requires --paddle-price-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "paddle-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "period": {
+          "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
+          "name": "period",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stripe-price-id": {
+          "description": "Stripe price ID (requires --stripe-product-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "stripe-price-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stripe-product-id": {
+          "description": "Stripe product ID (requires --stripe-price-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "stripe-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "title": {
           "description": "Product title",
           "name": "title",
@@ -1444,7 +1806,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:update",
+      "id": "products:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1455,21 +1817,21 @@
         "dist",
         "commands",
         "products",
-        "update.js"
+        "create.js"
       ]
     },
-    "segments:get": {
+    "products:get": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "product_id": {
+          "description": "Product ID (UUID)",
+          "name": "product_id",
           "required": true
         }
       },
-      "description": "Get segment details",
+      "description": "Get product details",
       "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1490,7 +1852,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:get",
+      "id": "products:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1500,16 +1862,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "products",
         "get.js"
       ]
     },
-    "segments:list": {
+    "products:list": {
       "aliases": [],
       "args": {},
-      "description": "List segments for an app",
+      "description": "List products for an app",
       "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
+        "<%= config.bin %> products list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1546,7 +1908,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:list",
+      "id": "products:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1556,16 +1918,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "products",
         "list.js"
       ]
     },
-    "flows:create": {
+    "products:update": {
       "aliases": [],
-      "args": {},
-      "description": "Create a flow (row only — write its config with `flows config update`)",
+      "args": {
+        "product_id": {
+          "description": "Product ID (UUID)",
+          "name": "product_id",
+          "required": true
+        }
+      },
+      "description": "Update a product (title and access level only)",
       "examples": [
-        "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
+        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
       ],
       "flags": {
         "json": {
@@ -1583,9 +1951,17 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Flow name",
-          "name": "name",
+        "access-level-id": {
+          "description": "Access level ID (UUID)",
+          "name": "access-level-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Product title",
+          "name": "title",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1594,7 +1970,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:create",
+      "id": "products:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1604,22 +1980,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "create.js"
+        "products",
+        "update.js"
       ]
     },
-    "flows:get": {
+    "segments:get": {
       "aliases": [],
       "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
           "required": true
         }
       },
-      "description": "Get flow details",
+      "description": "Get segment details",
       "examples": [
-        "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1640,7 +2016,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:get",
+      "id": "segments:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1650,16 +2026,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
+        "segments",
         "get.js"
       ]
     },
-    "flows:list": {
+    "segments:list": {
       "aliases": [],
       "args": {},
-      "description": "List flows for an app",
+      "description": "List segments for an app",
       "examples": [
-        "<%= config.bin %> flows list --app 550e8400-..."
+        "<%= config.bin %> segments list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1696,7 +2072,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:list",
+      "id": "segments:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1706,117 +2082,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
+        "segments",
         "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"
-      ]
-    },
     "asa:ad-groups:create": {
       "aliases": [],
       "args": {},
@@ -2198,13 +2467,12 @@
         "update.js"
       ]
     },
-    "asa:apps:list": {
+    "asa:ads:create": {
       "aliases": [],
       "args": {},
-      "description": "List the apps promoted by this company in Apple Search Ads",
+      "description": "Create an ad from a creative in an ad group",
       "examples": [
-        "<%= config.bin %> asa apps list",
-        "<%= config.bin %> asa apps list --page 2 --page-size 50"
+        "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
       ],
       "flags": {
         "json": {
@@ -2214,26 +2482,59 @@
           "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",
+          "name": "ad-group",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "creative-id": {
+          "description": "Apple creative ID from a product page or the default set",
+          "name": "creative-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Ad name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Initial status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:apps:list",
+      "id": "asa:ads:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2244,19 +2545,56 @@
         "dist",
         "commands",
         "asa",
-        "apps",
-        "list.js"
+        "ads",
+        "create.js"
       ]
     },
-    "asa:automations:create": {
+    "asa:ads:get": {
+      "aliases": [],
+      "args": {
+        "ad_id": {
+          "description": "Ad ID (UUID)",
+          "name": "ad_id",
+          "required": true
+        }
+      },
+      "description": "Show one ad and its serving state",
+      "examples": [
+        "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:ads:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "ads",
+        "get.js"
+      ]
+    },
+    "asa:ads:list": {
       "aliases": [],
       "args": {},
-      "description": "Create an automation rule from a JSON rule file. The add-as-keyword action flags fill in or override actions[0].params, so the bid, the match type and the target ad groups need no hand-written JSON.",
+      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
       "examples": [
-        "<%= config.bin %> asa automations create --file rule.json",
-        "<%= config.bin %> asa automations create --file rule.json --run-now",
-        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt",
-        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type set_to --cpt-bid 1.50 --negate ad-group"
+        "<%= config.bin %> asa ads list",
+        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
       ],
       "flags": {
         "json": {
@@ -2266,12 +2604,224 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "cpt-bid": {
-          "description": "cpt_bid.value: the bid itself with --cpt-bid-type set_to, or a percent markup on the entity bid with search_term_current_cpt / keyword_current_bid; not accepted with ad_group_default_bid",
-          "name": "cpt-bid",
-          "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 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
+          "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"
+        },
+        "status": {
+          "description": "Keep only rows in this state",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:ads:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "ads",
+        "list.js"
+      ]
+    },
+    "asa:ads:update": {
+      "aliases": [],
+      "args": {
+        "ad_id": {
+          "description": "Ad ID (UUID)",
+          "name": "ad_id",
+          "required": true
+        }
+      },
+      "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"
+      ],
+      "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": {
+          "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:automations:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create an automation rule from a JSON rule file. The add-as-keyword action flags fill in or override actions[0].params, so the bid, the match type and the target ad groups need no hand-written JSON.",
+      "examples": [
+        "<%= config.bin %> asa automations create --file rule.json",
+        "<%= config.bin %> asa automations create --file rule.json --run-now",
+        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt",
+        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type set_to --cpt-bid 1.50 --negate ad-group"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cpt-bid": {
+          "description": "cpt_bid.value: the bid itself with --cpt-bid-type set_to, or a percent markup on the entity bid with search_term_current_cpt / keyword_current_bid; not accepted with ad_group_default_bid",
+          "name": "cpt-bid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "cpt-bid-type": {
           "description": "Where the bid of the created keyword comes from; the API has no default",
@@ -3776,19 +4326,14 @@
         "list.js"
       ]
     },
-    "asa:keywords:update": {
+    "asa:keywords:recommend": {
       "aliases": [],
-      "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",
+      "args": {},
+      "description": "Keyword recommendations for one of your apps: its brand terms, generic terms, or the brand terms of its selected competitors",
       "examples": [
-        "<%= config.bin %> asa keywords update UUID --bid 2.00",
-        "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
+        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type brand",
+        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type generic --country US",
+        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type competitor"
       ],
       "flags": {
         "json": {
@@ -3798,34 +4343,102 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
+        "adam-id": {
+          "description": "Apple App Store ID (adam_id) of your app, from `asa apps list`",
+          "name": "adam-id",
+          "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"
-        },
-        "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",
+        "country": {
+          "description": "ISO country code (e.g. US); repeatable, default every country in the pool",
+          "name": "country",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "bid": {
-          "description": "Bid (amount, e.g. 50 or 12.50)",
-          "name": "bid",
+        "type": {
+          "description": "Which pool to read",
+          "name": "type",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
+          "options": [
+            "brand",
+            "generic",
+            "competitor"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:keywords:recommend",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "keywords",
+        "recommend.js"
+      ]
+    },
+    "asa:keywords:update": {
+      "aliases": [],
+      "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 keywords update UUID --bid 2.00",
+        "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "match-type": {
           "description": "Match type",
@@ -4596,287 +5209,6 @@
         "list.js"
       ]
     },
-    "asa:ads:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create an ad from a creative in an ad group",
-      "examples": [
-        "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
-      ],
-      "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"
-        },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "name": "ad-group",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "creative-id": {
-          "description": "Apple creative ID from a product page or the default set",
-          "name": "creative-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Ad name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Initial status",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:ads:create",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "ads",
-        "create.js"
-      ]
-    },
-    "asa:ads:get": {
-      "aliases": [],
-      "args": {
-        "ad_id": {
-          "description": "Ad ID (UUID)",
-          "name": "ad_id",
-          "required": true
-        }
-      },
-      "description": "Show one ad and its serving state",
-      "examples": [
-        "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:ads:get",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "ads",
-        "get.js"
-      ]
-    },
-    "asa:ads:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
-      "examples": [
-        "<%= config.bin %> asa ads list",
-        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
-      ],
-      "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"
-        },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
-          "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"
-        },
-        "status": {
-          "description": "Keep only rows in this state",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:ads:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "ads",
-        "list.js"
-      ]
-    },
-    "asa:ads:update": {
-      "aliases": [],
-      "args": {
-        "ad_id": {
-          "description": "Ad ID (UUID)",
-          "name": "ad_id",
-          "required": true
-        }
-      },
-      "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"
-      ],
-      "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"
-      ]
-    },
     "flows:config:get": {
       "aliases": [],
       "args": {
@@ -5181,5 +5513,5 @@
       ]
     }
   },
-  "version": "0.8.6"
+  "version": "0.8.8"
 }