adapty 0.8.4 → 0.8.6

package/oclif.manifest.json

@@ -228,16 +228,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "apple-bundle-id": {
-          "description": "Apple bundle ID (required with --platform ios)",
-          "name": "apple-bundle-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "google-bundle-id": {
-          "description": "Google bundle ID (required with --platform android)",
-          "name": "google-bundle-id",
+        "title": {
+          "description": "App title",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -254,10 +248,16 @@
           ],
           "type": "option"
         },
-        "title": {
-          "description": "App title",
-          "name": "title",
-          "required": true,
+        "apple-bundle-id": {
+          "description": "Apple bundle ID (required with --platform ios)",
+          "name": "apple-bundle-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "google-bundle-id": {
+          "description": "Google bundle ID (required with --platform android)",
+          "name": "google-bundle-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -387,6 +387,13 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "title": {
+          "description": "App title",
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "apple-bundle-id": {
           "description": "Apple bundle ID",
           "name": "apple-bundle-id",
@@ -400,13 +407,6 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "title": {
-          "description": "App title",
-          "name": "title",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -425,36 +425,59 @@
         "update.js"
       ]
     },
-    "auth:login": {
+    "asa:connect": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Adapty via browser",
+      "description": "Connect an Apple Search Ads account to this company",
       "examples": [
-        "<%= config.bin %> auth login"
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
       ],
-      "flags": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the browser step",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait until Apple Ads reports as connected",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "asa:connect",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "asa",
+        "connect.js"
       ]
     },
-    "auth:logout": {
+    "asa:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Remove stored authentication token",
+      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
       "examples": [
-        "<%= config.bin %> auth logout"
+        "<%= config.bin %> asa whoami"
       ],
       "flags": {
         "json": {
@@ -467,7 +490,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "asa:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -477,48 +500,40 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "asa",
+        "whoami.js"
       ]
     },
-    "auth:revoke": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Revoke the current authentication token",
+      "description": "Authenticate with Adapty via browser",
       "examples": [
-        "<%= config.bin %> auth revoke"
+        "<%= config.bin %> auth login"
       ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:revoke",
+      "id": "auth:login",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "auth",
-        "revoke.js"
+        "login.js"
       ]
     },
-    "auth:status": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Show current authentication state (local only)",
+      "description": "Remove the stored session",
       "examples": [
-        "<%= config.bin %> auth status"
+        "<%= config.bin %> auth logout"
       ],
       "flags": {
         "json": {
@@ -531,7 +546,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:status",
+      "id": "auth:logout",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -542,15 +557,15 @@
         "dist",
         "commands",
         "auth",
-        "status.js"
+        "logout.js"
       ]
     },
-    "auth:whoami": {
+    "auth:revoke": {
       "aliases": [],
       "args": {},
-      "description": "Show current user info from server (verifies token)",
+      "description": "Revoke the current token on the server and remove any matching stored session",
       "examples": [
-        "<%= config.bin %> auth whoami"
+        "<%= config.bin %> auth revoke"
       ],
       "flags": {
         "json": {
@@ -563,7 +578,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:revoke",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -574,16 +589,15 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "revoke.js"
       ]
     },
-    "asa:connect": {
+    "auth:status": {
       "aliases": [],
       "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
+      "description": "Show the local authentication state (no network)",
       "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
+        "<%= config.bin %> auth status"
       ],
       "flags": {
         "json": {
@@ -592,25 +606,11 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the browser step",
-          "name": "timeout",
-          "default": 300,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "Wait until Apple Ads reports as connected",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:connect",
+      "id": "auth:status",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -620,16 +620,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "connect.js"
+        "auth",
+        "status.js"
       ]
     },
-    "asa:whoami": {
+    "auth:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Show which company the token unlocks and whether Apple Ads is connected",
+      "description": "Show the current user from the server (verifies the token)",
       "examples": [
-        "<%= config.bin %> asa whoami"
+        "<%= config.bin %> auth whoami"
       ],
       "flags": {
         "json": {
@@ -642,7 +642,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:whoami",
+      "id": "auth:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -652,16 +652,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
+        "auth",
         "whoami.js"
       ]
     },
-    "flows:create": {
+    "paywalls:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a flow (row only — write its config with `flows config update`)",
+      "description": "Create a paywall with products",
       "examples": [
-        "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
+        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -679,9 +679,17 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Flow name",
-          "name": "name",
+        "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",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -690,7 +698,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:create",
+      "id": "paywalls:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -700,22 +708,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
+        "paywalls",
         "create.js"
       ]
     },
-    "flows:get": {
+    "paywalls:get": {
       "aliases": [],
       "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Get flow details",
+      "description": "Get paywall details",
       "examples": [
-        "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -736,7 +744,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:get",
+      "id": "paywalls:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -746,16 +754,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
+        "paywalls",
         "get.js"
       ]
     },
-    "flows:list": {
+    "paywalls:list": {
       "aliases": [],
       "args": {},
-      "description": "List flows for an app",
+      "description": "List paywalls for an app",
       "examples": [
-        "<%= config.bin %> flows list --app 550e8400-..."
+        "<%= config.bin %> paywalls list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -792,7 +800,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:list",
+      "id": "paywalls:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -802,22 +810,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
+        "paywalls",
         "list.js"
       ]
     },
-    "flows:publish": {
+    "paywalls:placements": {
       "aliases": [],
       "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_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.",
+      "description": "List placements that currently use this paywall",
       "examples": [
-        "<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
       ],
       "flags": {
         "json": {
@@ -834,18 +842,11 @@
           "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",
+      "id": "paywalls:placements",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -855,22 +856,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "publish.js"
+        "paywalls",
+        "placements.js"
       ]
     },
-    "flows:update": {
+    "paywalls:update": {
       "aliases": [],
       "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Rename a flow",
+      "description": "Update a paywall",
       "examples": [
-        "<%= config.bin %> flows update --app UUID 550e8400-e29b-41d4-a716-446655440000 --name \"Onboarding v2\""
+        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -888,18 +889,26 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "New flow name",
-          "name": "name",
+        "product-id": {
+          "description": "Product ID (UUID). Repeat for multiple.",
+          "name": "product-id",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "title": {
+          "description": "Paywall title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:update",
+      "id": "paywalls:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -909,16 +918,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
+        "paywalls",
         "update.js"
       ]
     },
-    "paywalls:create": {
+    "placements:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a paywall with products",
+      "description": "Create a placement with a paywall",
       "examples": [
-        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+        "<%= 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": {
@@ -936,16 +947,30 @@
           "multiple": false,
           "type": "option"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "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"
+        },
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
         "title": {
-          "description": "Paywall title",
+          "description": "Placement title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -955,7 +980,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:create",
+      "id": "placements:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -965,22 +990,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "placements",
         "create.js"
       ]
     },
-    "paywalls:get": {
+    "placements:get": {
       "aliases": [],
       "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Get paywall details",
+      "description": "Get placement details",
       "examples": [
-        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1001,7 +1026,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:get",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1011,16 +1036,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "placements",
         "get.js"
       ]
     },
-    "paywalls:list": {
+    "placements:list": {
       "aliases": [],
       "args": {},
-      "description": "List paywalls for an app",
+      "description": "List placements for an app",
       "examples": [
-        "<%= config.bin %> paywalls list --app 550e8400-..."
+        "<%= config.bin %> placements list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1057,7 +1082,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:list",
+      "id": "placements:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1067,22 +1092,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "placements",
         "list.js"
       ]
     },
-    "paywalls:placements": {
+    "placements:update": {
       "aliases": [],
       "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "List placements that currently use this paywall",
+      "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
+        "<%= 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": {
@@ -1099,63 +1126,31 @@
           "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"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "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"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "product-id",
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
         "title": {
-          "description": "Paywall title",
+          "description": "Placement title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -1165,7 +1160,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:update",
+      "id": "placements:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1175,18 +1170,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
+        "placements",
         "update.js"
       ]
     },
-    "placements:create": {
+    "products:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a placement with a paywall",
+      "description": "Create a product with vendor products per platform",
       "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 %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
       ],
       "flags": {
         "json": {
@@ -1204,30 +1197,80 @@
           "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",
+        "access-level-id": {
+          "description": "Access level ID (UUID)",
+          "name": "access-level-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
+        "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"
         },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
+        "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": "Placement title",
+          "description": "Product title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -1237,7 +1280,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:create",
+      "id": "products:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1247,22 +1290,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "products",
         "create.js"
       ]
     },
-    "placements:get": {
+    "products:get": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
+        "product_id": {
+          "description": "Product ID (UUID)",
+          "name": "product_id",
           "required": true
         }
       },
-      "description": "Get placement details",
+      "description": "Get product details",
       "examples": [
-        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1283,7 +1326,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:get",
+      "id": "products:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1293,16 +1336,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "products",
         "get.js"
       ]
     },
-    "placements:list": {
+    "products:list": {
       "aliases": [],
       "args": {},
-      "description": "List placements for an app",
+      "description": "List products for an app",
       "examples": [
-        "<%= config.bin %> placements list --app 550e8400-..."
+        "<%= config.bin %> products list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1339,7 +1382,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:list",
+      "id": "products:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1349,94 +1392,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "products",
         "list.js"
       ]
     },
-    "placements:update": {
+    "products:update": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
+        "product_id": {
+          "description": "Product ID (UUID)",
+          "name": "product_id",
           "required": true
         }
       },
-      "description": "Update a placement",
-      "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"
-      ],
-      "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",
+      "description": "Update a product (title and access level only)",
       "examples": [
-        "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
+        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
       ],
       "flags": {
         "json": {
@@ -1462,70 +1433,6 @@
           "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",
@@ -1537,7 +1444,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:create",
+      "id": "products:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1548,21 +1455,21 @@
         "dist",
         "commands",
         "products",
-        "create.js"
+        "update.js"
       ]
     },
-    "products:get": {
+    "segments:get": {
       "aliases": [],
       "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
           "required": true
         }
       },
-      "description": "Get product details",
+      "description": "Get segment details",
       "examples": [
-        "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1583,7 +1490,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:get",
+      "id": "segments:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1593,16 +1500,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "segments",
         "get.js"
       ]
     },
-    "products:list": {
+    "segments:list": {
       "aliases": [],
       "args": {},
-      "description": "List products for an app",
+      "description": "List segments for an app",
       "examples": [
-        "<%= config.bin %> products list --app 550e8400-..."
+        "<%= config.bin %> segments list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1639,7 +1546,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:list",
+      "id": "segments:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1649,22 +1556,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "segments",
         "list.js"
       ]
     },
-    "products:update": {
+    "flows:create": {
       "aliases": [],
-      "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
-          "required": true
-        }
-      },
-      "description": "Update a product (title and access level only)",
+      "args": {},
+      "description": "Create a flow (row only — write its config with `flows config update`)",
       "examples": [
-        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
+        "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
       ],
       "flags": {
         "json": {
@@ -1682,17 +1583,9 @@
           "multiple": false,
           "type": "option"
         },
-        "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",
+        "name": {
+          "description": "Flow name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1701,7 +1594,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:update",
+      "id": "flows:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1711,22 +1604,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
-        "update.js"
+        "flows",
+        "create.js"
       ]
     },
-    "segments:get": {
+    "flows:get": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "Get segment details",
+      "description": "Get flow details",
       "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1747,7 +1640,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:get",
+      "id": "flows:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1757,16 +1650,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "flows",
         "get.js"
       ]
     },
-    "segments:list": {
+    "flows:list": {
       "aliases": [],
       "args": {},
-      "description": "List segments for an app",
+      "description": "List flows for an app",
       "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
+        "<%= config.bin %> flows list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1803,7 +1696,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:list",
+      "id": "flows:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1813,21 +1706,128 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "flows",
         "list.js"
       ]
     },
-    "asa:ad-groups:create": {
+    "flows:publish": {
       "aliases": [],
-      "args": {},
-      "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
-      "examples": [
-        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
-        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
-        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
-      ],
-      "flags": {
-        "json": {
+      "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": {},
+      "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
+      "examples": [
+        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
+        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
+        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
+      ],
+      "flags": {
+        "json": {
           "description": "Format output as json.",
           "helpGroup": "GLOBAL",
           "name": "json",
@@ -2198,12 +2198,13 @@
         "update.js"
       ]
     },
-    "asa:ads:create": {
+    "asa:apps:list": {
       "aliases": [],
       "args": {},
-      "description": "Create an ad from a creative in an ad group",
+      "description": "List the apps promoted by this company in Apple Search Ads",
       "examples": [
-        "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
+        "<%= config.bin %> asa apps list",
+        "<%= config.bin %> asa apps list --page 2 --page-size 50"
       ],
       "flags": {
         "json": {
@@ -2213,98 +2214,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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,
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "status": {
-          "description": "Initial status",
-          "name": "status",
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads: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",
+      "id": "asa:apps:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2315,17 +2244,19 @@
         "dist",
         "commands",
         "asa",
-        "ads",
-        "get.js"
+        "apps",
+        "list.js"
       ]
     },
-    "asa:ads:list": {
+    "asa:automations:create": {
       "aliases": [],
       "args": {},
-      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
+      "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 ads list",
-        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
+        "<%= 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": {
@@ -2335,241 +2266,29 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "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-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
+        "cpt-bid-type": {
+          "description": "Where the bid of the created keyword comes from; the API has no default",
+          "name": "cpt-bid-type",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "ad_group_default_bid",
+            "keyword_current_bid",
+            "search_term_current_cpt",
+            "set_to"
+          ],
           "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",
-          "name": "cpt-bid-type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ad_group_default_bid",
-            "keyword_current_bid",
-            "search_term_current_cpt",
-            "set_to"
-          ],
-          "type": "option"
-        },
-        "match-type": {
-          "description": "Match type of the created keyword; the API has no default",
-          "name": "match-type",
+        "match-type": {
+          "description": "Match type of the created keyword; the API has no default",
+          "name": "match-type",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -4158,7 +3877,7 @@
     "asa:metrics": {
       "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": "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 a breakdown-row\ncount (entities × countries × periods); over it the call fails with 422 cli_response_too_large naming the\npage[size] that fits — coarsen the grouping, narrow the window, or reduce page[size].\n\nMoney columns are in the campaign group currency, not USD, and spend and local_spend carry the same\nfigure; the currency itself comes from asa orgs list. Rate budgets and the breakdown-row cap are set per\ncompany: read the current ones with asa whoami rather than assuming a default. meta.pagination.count is\nthe full entity count behind the filters, so take inventory from there instead of counting the rows on a\npage. meta.max_valid_day says how many days the youngest cohort in the window has lived — any --by-days\nwindow above it repeats the last real figure because that time has not passed yet, so treat those as\nunreached rather than as a plateau.\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 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",
@@ -4877,6 +4596,287 @@
         "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 +5181,5 @@
       ]
     }
   },
-  "version": "0.8.4"
+  "version": "0.8.6"
 }