adapty 0.8.0 → 0.8.1

package/oclif.manifest.json

@@ -425,59 +425,36 @@
         "update.js"
       ]
     },
-    "asa:connect": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
+      "description": "Authenticate with Adapty via browser",
       "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
+        "<%= config.bin %> auth login"
       ],
-      "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"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:connect",
+      "id": "auth:login",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "connect.js"
+        "auth",
+        "login.js"
       ]
     },
-    "asa:whoami": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Show which company the token unlocks and whether Apple Ads is connected",
+      "description": "Remove stored authentication token",
       "examples": [
-        "<%= config.bin %> asa whoami"
+        "<%= config.bin %> auth logout"
       ],
       "flags": {
         "json": {
@@ -490,7 +467,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:whoami",
+      "id": "auth:logout",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -500,40 +477,48 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "whoami.js"
+        "auth",
+        "logout.js"
       ]
     },
-    "auth:login": {
+    "auth:revoke": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Adapty via browser",
+      "description": "Revoke the current authentication token",
       "examples": [
-        "<%= config.bin %> auth login"
+        "<%= config.bin %> auth revoke"
       ],
-      "flags": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "auth:revoke",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "auth",
-        "login.js"
+        "revoke.js"
       ]
     },
-    "auth:logout": {
+    "auth:status": {
       "aliases": [],
       "args": {},
-      "description": "Remove stored authentication token",
+      "description": "Show current authentication state (local only)",
       "examples": [
-        "<%= config.bin %> auth logout"
+        "<%= config.bin %> auth status"
       ],
       "flags": {
         "json": {
@@ -546,7 +531,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "auth:status",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -557,15 +542,15 @@
         "dist",
         "commands",
         "auth",
-        "logout.js"
+        "status.js"
       ]
     },
-    "auth:revoke": {
+    "auth:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Revoke the current authentication token",
+      "description": "Show current user info from server (verifies token)",
       "examples": [
-        "<%= config.bin %> auth revoke"
+        "<%= config.bin %> auth whoami"
       ],
       "flags": {
         "json": {
@@ -578,7 +563,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:revoke",
+      "id": "auth:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -589,15 +574,16 @@
         "dist",
         "commands",
         "auth",
-        "revoke.js"
+        "whoami.js"
       ]
     },
-    "auth:status": {
+    "asa:connect": {
       "aliases": [],
       "args": {},
-      "description": "Show current authentication state (local only)",
+      "description": "Connect an Apple Search Ads account to this company",
       "examples": [
-        "<%= config.bin %> auth status"
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
       ],
       "flags": {
         "json": {
@@ -606,11 +592,25 @@
           "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:status",
+      "id": "asa:connect",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -620,16 +620,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "status.js"
+        "asa",
+        "connect.js"
       ]
     },
-    "auth:whoami": {
+    "asa:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Show current user info from server (verifies token)",
+      "description": "Show which company the token unlocks and whether Apple Ads is connected",
       "examples": [
-        "<%= config.bin %> auth whoami"
+        "<%= config.bin %> asa whoami"
       ],
       "flags": {
         "json": {
@@ -642,7 +642,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "asa:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -652,7 +652,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
+        "asa",
         "whoami.js"
       ]
     },
@@ -806,12 +806,13 @@
         "list.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 '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -829,16 +830,30 @@
           "multiple": false,
           "type": "option"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "product-id",
+        "audiences": {
+          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
+          "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,
@@ -848,7 +863,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:create",
+      "id": "placements:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -858,22 +873,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": {
@@ -894,7 +909,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:get",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -904,16 +919,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": {
@@ -950,7 +965,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:list",
+      "id": "placements:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -960,22 +975,23 @@
       "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 '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -992,11 +1008,41 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "audiences": {
+          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
+          "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": "paywalls:placements",
+      "id": "placements:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1006,22 +1052,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "placements.js"
+        "placements",
+        "update.js"
       ]
     },
-    "paywalls:update": {
+    "paywalls:create": {
       "aliases": [],
-      "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
-          "required": true
-        }
-      },
-      "description": "Update a paywall",
+      "args": {},
+      "description": "Create a paywall with products",
       "examples": [
-        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -1058,7 +1098,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:update",
+      "id": "paywalls:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1069,16 +1109,21 @@
         "dist",
         "commands",
         "paywalls",
-        "update.js"
+        "create.js"
       ]
     },
-    "placements:create": {
+    "paywalls:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create a placement with a paywall",
+      "args": {
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
+          "required": true
+        }
+      },
+      "description": "Get paywall details",
       "examples": [
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1095,33 +1140,59 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "paywalls:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "paywalls",
+        "get.js"
+      ]
+    },
+    "paywalls:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List paywalls for an app",
+      "examples": [
+        "<%= config.bin %> paywalls list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "audiences": {
-          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
-          "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",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
-          "required": true,
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1129,7 +1200,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:create",
+      "id": "paywalls:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1139,22 +1210,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "create.js"
+        "paywalls",
+        "list.js"
       ]
     },
-    "placements:get": {
+    "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": "Get placement details",
+      "description": "List placements that currently use this paywall",
       "examples": [
-        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
       ],
       "flags": {
         "json": {
@@ -1175,7 +1246,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:get",
+      "id": "paywalls:placements",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1185,16 +1256,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "get.js"
+        "paywalls",
+        "placements.js"
       ]
     },
-    "placements:list": {
+    "paywalls:update": {
       "aliases": [],
-      "args": {},
-      "description": "List placements for an app",
+      "args": {
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
+          "required": true
+        }
+      },
+      "description": "Update a paywall",
       "examples": [
-        "<%= config.bin %> placements list --app 550e8400-..."
+        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -1212,18 +1289,18 @@
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "product-id": {
+          "description": "Product ID (UUID). Repeat for multiple.",
+          "name": "product-id",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "title": {
+          "description": "Paywall title",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1231,7 +1308,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:list",
+      "id": "paywalls:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1241,23 +1318,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "list.js"
+        "paywalls",
+        "update.js"
       ]
     },
-    "placements:update": {
+    "segments:get": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
           "required": true
         }
       },
-      "description": "Update a placement",
+      "description": "Get segment details",
       "examples": [
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1274,33 +1350,59 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "get.js"
+      ]
+    },
+    "segments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List segments for an app",
+      "examples": [
+        "<%= config.bin %> segments list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "audiences": {
-          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
-          "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",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
-          "required": true,
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1308,7 +1410,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "segments:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1318,8 +1420,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "update.js"
+        "segments",
+        "list.js"
       ]
     },
     "products:create": {
@@ -1606,115 +1708,12 @@
         "update.js"
       ]
     },
-    "segments:get": {
-      "aliases": [],
-      "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
-          "required": true
-        }
-      },
-      "description": "Get segment details",
-      "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "segments:get",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "segments",
-        "get.js"
-      ]
-    },
-    "segments:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List segments for an app",
-      "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "segments:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "segments",
-        "list.js"
-      ]
-    },
-    "asa:ad-groups:create": {
+    "asa:ads:create": {
       "aliases": [],
       "args": {},
-      "description": "Create an ad group inside a campaign",
+      "description": "Create an ad from a creative in an ad group",
       "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 ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
       ],
       "flags": {
         "json": {
@@ -1724,40 +1723,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "Schedule end (YYYY-MM-DD)",
-          "name": "end-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Schedule start (YYYY-MM-DD), defaults to today",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pricing-model": {
-          "description": "Pricing model; Apple requires one on every ad group",
-          "name": "pricing-model",
-          "default": "CPC",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "CPC",
-            "CPM"
-          ],
-          "type": "option"
-        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -1772,37 +1737,24 @@
           "multiple": false,
           "type": "option"
         },
-        "automated-keywords": {
-          "description": "Let Apple add keywords automatically",
-          "name": "automated-keywords",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "campaign": {
-          "description": "Campaign ID (UUID)",
-          "name": "campaign",
+        "ad-group": {
+          "description": "Ad group ID (UUID) — the campaign is resolved from it",
+          "name": "ad-group",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "cpa-goal": {
-          "description": "CPA goal (amount, e.g. 50 or 12.50)",
-          "name": "cpa-goal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "default-bid": {
-          "description": "Default bid (amount, e.g. 50 or 12.50)",
-          "name": "default-bid",
+        "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 group name",
+          "description": "Ad name",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
@@ -1823,7 +1775,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:create",
+      "id": "asa:ads:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1834,22 +1786,22 @@
         "dist",
         "commands",
         "asa",
-        "ad-groups",
+        "ads",
         "create.js"
       ]
     },
-    "asa:ad-groups:get": {
+    "asa:ads:get": {
       "aliases": [],
       "args": {
-        "ad_group_id": {
-          "description": "Ad group ID (UUID)",
-          "name": "ad_group_id",
+        "ad_id": {
+          "description": "Ad ID (UUID)",
+          "name": "ad_id",
           "required": true
         }
       },
-      "description": "Show one ad group; read numbers with asa metrics",
+      "description": "Show one ad and its serving state",
       "examples": [
-        "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1862,7 +1814,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:get",
+      "id": "asa:ads:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1873,17 +1825,17 @@
         "dist",
         "commands",
         "asa",
-        "ad-groups",
+        "ads",
         "get.js"
       ]
     },
-    "asa:ad-groups:list": {
+    "asa:ads:list": {
       "aliases": [],
       "args": {},
-      "description": "List ad groups; read numbers with asa metrics",
+      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
       "examples": [
-        "<%= config.bin %> asa ad-groups list",
-        "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
+        "<%= config.bin %> asa ads list",
+        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
       ],
       "flags": {
         "json": {
@@ -1909,9 +1861,16 @@
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
+        "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"
@@ -1930,13 +1889,6 @@
           "multiple": false,
           "type": "option"
         },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "status": {
           "description": "Keep only rows in this state",
           "name": "status",
@@ -1951,7 +1903,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:list",
+      "id": "asa:ads:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1962,23 +1914,22 @@
         "dist",
         "commands",
         "asa",
-        "ad-groups",
+        "ads",
         "list.js"
       ]
     },
-    "asa:ad-groups:update": {
+    "asa:ads:update": {
       "aliases": [],
       "args": {
-        "ad_group_id": {
-          "description": "Ad group ID (UUID)",
-          "name": "ad_group_id",
+        "ad_id": {
+          "description": "Ad ID (UUID)",
+          "name": "ad_id",
           "required": true
         }
       },
-      "description": "Change an ad group: bid, CPA goal, status or schedule",
+      "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
       "examples": [
-        "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
-        "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
+        "<%= config.bin %> asa ads update UUID --status PAUSED"
       ],
       "flags": {
         "json": {
@@ -1988,28 +1939,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "Schedule end (YYYY-MM-DD)",
-          "name": "end-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Schedule start (YYYY-MM-DD), defaults to today",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2024,35 +1953,15 @@
           "multiple": false,
           "type": "option"
         },
-        "automated-keywords": {
-          "description": "Let Apple add keywords automatically",
-          "name": "automated-keywords",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "cpa-goal": {
-          "description": "CPA goal (amount, e.g. 50 or 12.50)",
-          "name": "cpa-goal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "default-bid": {
-          "description": "Default bid (amount, e.g. 50 or 12.50)",
-          "name": "default-bid",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "name": {
-          "description": "Ad group name",
+          "description": "Ad name",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "status": {
-          "description": "Ad group status",
+          "description": "Ad status",
           "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2065,7 +1974,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:update",
+      "id": "asa:ads:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2076,16 +1985,17 @@
         "dist",
         "commands",
         "asa",
-        "ad-groups",
+        "ads",
         "update.js"
       ]
     },
-    "asa:ads:create": {
+    "asa:ad-groups:create": {
       "aliases": [],
       "args": {},
-      "description": "Create an ad from a creative in an ad group",
+      "description": "Create an ad group inside a campaign",
       "examples": [
-        "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
+        "<%= 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"
       ],
       "flags": {
         "json": {
@@ -2095,6 +2005,40 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-time": {
+          "description": "Schedule end (YYYY-MM-DD)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-time": {
+          "description": "Schedule start (YYYY-MM-DD), defaults to today",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pricing-model": {
+          "description": "Pricing model; Apple requires one on every ad group",
+          "name": "pricing-model",
+          "default": "CPC",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "CPC",
+            "CPM"
+          ],
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2109,24 +2053,37 @@
           "multiple": false,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "name": "ad-group",
+        "automated-keywords": {
+          "description": "Let Apple add keywords automatically",
+          "name": "automated-keywords",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "campaign": {
+          "description": "Campaign ID (UUID)",
+          "name": "campaign",
           "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",
+        "cpa-goal": {
+          "description": "CPA goal (amount, e.g. 50 or 12.50)",
+          "name": "cpa-goal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-bid": {
+          "description": "Default bid (amount, e.g. 50 or 12.50)",
+          "name": "default-bid",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "name": {
-          "description": "Ad name",
+          "description": "Ad group name",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
@@ -2147,7 +2104,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:create",
+      "id": "asa:ad-groups:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2158,22 +2115,22 @@
         "dist",
         "commands",
         "asa",
-        "ads",
+        "ad-groups",
         "create.js"
       ]
     },
-    "asa:ads:get": {
+    "asa:ad-groups:get": {
       "aliases": [],
       "args": {
-        "ad_id": {
-          "description": "Ad ID (UUID)",
-          "name": "ad_id",
+        "ad_group_id": {
+          "description": "Ad group ID (UUID)",
+          "name": "ad_group_id",
           "required": true
         }
       },
-      "description": "Show one ad and its serving state",
+      "description": "Show one ad group; read numbers with asa metrics",
       "examples": [
-        "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2186,7 +2143,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:get",
+      "id": "asa:ad-groups:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2197,17 +2154,17 @@
         "dist",
         "commands",
         "asa",
-        "ads",
+        "ad-groups",
         "get.js"
       ]
     },
-    "asa:ads:list": {
+    "asa:ad-groups:list": {
       "aliases": [],
       "args": {},
-      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
+      "description": "List ad groups; read numbers with asa metrics",
       "examples": [
-        "<%= config.bin %> asa ads list",
-        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
+        "<%= config.bin %> asa ad-groups list",
+        "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
       ],
       "flags": {
         "json": {
@@ -2233,16 +2190,9 @@
           "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",
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -2261,6 +2211,13 @@
           "multiple": false,
           "type": "option"
         },
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "status": {
           "description": "Keep only rows in this state",
           "name": "status",
@@ -2275,7 +2232,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:list",
+      "id": "asa:ad-groups:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2286,22 +2243,23 @@
         "dist",
         "commands",
         "asa",
-        "ads",
+        "ad-groups",
         "list.js"
       ]
     },
-    "asa:ads:update": {
+    "asa:ad-groups:update": {
       "aliases": [],
       "args": {
-        "ad_id": {
-          "description": "Ad ID (UUID)",
-          "name": "ad_id",
+        "ad_group_id": {
+          "description": "Ad group ID (UUID)",
+          "name": "ad_group_id",
           "required": true
         }
       },
-      "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
+      "description": "Change an ad group: bid, CPA goal, status or schedule",
       "examples": [
-        "<%= config.bin %> asa ads update UUID --status PAUSED"
+        "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
+        "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
       ],
       "flags": {
         "json": {
@@ -2311,6 +2269,28 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-time": {
+          "description": "Schedule end (YYYY-MM-DD)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-time": {
+          "description": "Schedule start (YYYY-MM-DD), defaults to today",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2325,15 +2305,35 @@
           "multiple": false,
           "type": "option"
         },
+        "automated-keywords": {
+          "description": "Let Apple add keywords automatically",
+          "name": "automated-keywords",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "cpa-goal": {
+          "description": "CPA goal (amount, e.g. 50 or 12.50)",
+          "name": "cpa-goal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-bid": {
+          "description": "Default bid (amount, e.g. 50 or 12.50)",
+          "name": "default-bid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "name": {
-          "description": "Ad name",
+          "description": "Ad group name",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "status": {
-          "description": "Ad status",
+          "description": "Ad group status",
           "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2346,7 +2346,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:update",
+      "id": "asa:ad-groups:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2357,7 +2357,7 @@
         "dist",
         "commands",
         "asa",
-        "ads",
+        "ad-groups",
         "update.js"
       ]
     },
@@ -2762,47 +2762,6 @@
         "update.js"
       ]
     },
-    "asa:competitors:summary": {
-      "aliases": [],
-      "args": {},
-      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
-      "examples": [
-        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-ids": {
-          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
-          "name": "app-ids",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:competitors:summary",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "competitors",
-        "summary.js"
-      ]
-    },
     "asa:campaigns:bulk-create": {
       "aliases": [],
       "args": {},
@@ -3448,6 +3407,47 @@
         "update.js"
       ]
     },
+    "asa:competitors:summary": {
+      "aliases": [],
+      "args": {},
+      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
+      "examples": [
+        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app-ids": {
+          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
+          "name": "app-ids",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:competitors:summary",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "competitors",
+        "summary.js"
+      ]
+    },
     "asa:creatives:list": {
       "aliases": [],
       "args": {},
@@ -3818,7 +3818,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 coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
+      "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 20000 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.",
       "examples": [
         "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
         "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
@@ -4818,5 +4818,5 @@
       ]
     }
   },
-  "version": "0.8.0"
+  "version": "0.8.1"
 }