adapty 0.9.5 → 0.10.0

package/oclif.manifest.json

@@ -1,73 +1,12 @@
 {
   "commands": {
-    "access-levels:create": {
+    "feedback": {
       "aliases": [],
       "args": {},
-      "description": "Create a custom access level",
-      "examples": [
-        "<%= config.bin %> access-levels create --app 550e8400-... --sdk-id vip --title \"VIP Access\""
-      ],
-      "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"
-        },
-        "sdk-id": {
-          "description": "Access level SDK identifier",
-          "name": "sdk-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "description": "Access level title",
-          "name": "title",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "access-levels:create",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "access-levels",
-        "create.js"
-      ]
-    },
-    "access-levels:get": {
-      "aliases": [],
-      "args": {
-        "access_level_id": {
-          "description": "Access Level ID (UUID)",
-          "name": "access_level_id",
-          "required": true
-        }
-      },
-      "description": "Get access level details",
+      "description": "Send a short report on how a task with the Adapty CLI or an Adapty skill went.\nMeant for AI agents: say what worked, what failed or confused you. Put app, flow and other ids into the message if they matter.\nLeave out secrets and personal data.",
       "examples": [
-        "<%= config.bin %> access-levels get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> feedback --sentiment negative --feature flow-generator --message \"flows config update rejected a valid button component twice\"",
+        "<%= config.bin %> feedback --sentiment positive --message \"Imported the paywall from Canva in one pass\" --context \"Building an onboarding flow from a Canva file\""
       ],
       "flags": {
         "json": {
@@ -77,120 +16,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
+        "sentiment": {
+          "description": "How the task went",
+          "name": "sentiment",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "positive",
+            "neutral",
+            "negative"
+          ],
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "access-levels:get",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "access-levels",
-        "get.js"
-      ]
-    },
-    "access-levels:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List access levels for an app",
-      "examples": [
-        "<%= config.bin %> access-levels list --app 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",
+        "message": {
+          "description": "The report: a few sentences on what happened",
+          "name": "message",
           "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": "access-levels:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "access-levels",
-        "list.js"
-      ]
-    },
-    "access-levels:update": {
-      "aliases": [],
-      "args": {
-        "access_level_id": {
-          "description": "Access Level ID (UUID)",
-          "name": "access_level_id",
-          "required": true
-        }
-      },
-      "description": "Update an access level",
-      "examples": [
-        "<%= config.bin %> access-levels update --app UUID 550e8400-... --title \"VIP Access\""
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "feature": {
+          "description": "Feature or skill the report comes from; Adapty records \"unknown\" when omitted",
+          "name": "feature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "description": "Access level title",
-          "name": "title",
-          "required": true,
+        "context": {
+          "description": "What you were doing at that moment",
+          "name": "context",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -198,18 +54,16 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "access-levels:update",
+      "id": "feedback",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "access-levels",
-        "update.js"
+        "feedback.js"
       ]
     },
     "apps:create": {
@@ -421,13 +275,12 @@
         "update.js"
       ]
     },
-    "asa:connect": {
+    "access-levels:create": {
       "aliases": [],
       "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
+      "description": "Create a custom access level",
       "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
+        "<%= config.bin %> access-levels create --app 550e8400-... --sdk-id vip --title \"VIP Access\""
       ],
       "flags": {
         "json": {
@@ -437,24 +290,34 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "timeout": {
-          "description": "Seconds to wait for the browser step",
-          "name": "timeout",
-          "default": 300,
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "description": "Wait until Apple Ads reports as connected",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
+        "sdk-id": {
+          "description": "Access level SDK identifier",
+          "name": "sdk-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Access level title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:connect",
+      "id": "access-levels:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -464,16 +327,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "connect.js"
+        "access-levels",
+        "create.js"
       ]
     },
-    "asa:whoami": {
+    "access-levels:get": {
       "aliases": [],
-      "args": {},
-      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
+      "args": {
+        "access_level_id": {
+          "description": "Access Level ID (UUID)",
+          "name": "access_level_id",
+          "required": true
+        }
+      },
+      "description": "Get access level details",
       "examples": [
-        "<%= config.bin %> asa whoami"
+        "<%= config.bin %> access-levels get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -482,11 +351,19 @@
           "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": "asa:whoami",
+      "id": "access-levels:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -496,17 +373,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "whoami.js"
+        "access-levels",
+        "get.js"
       ]
     },
-    "attribution:dimensions": {
+    "access-levels:list": {
       "aliases": [],
       "args": {},
-      "description": "List the dimensions an attribution report can group or filter by (not scoped to an app)",
+      "description": "List access levels for an app",
       "examples": [
-        "<%= config.bin %> attribution dimensions",
-        "<%= config.bin %> attribution dimensions --json"
+        "<%= config.bin %> access-levels list --app 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -515,15 +391,205 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "attribution:dimensions",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
+        },
+        "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": "access-levels:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "access-levels",
+        "list.js"
+      ]
+    },
+    "access-levels:update": {
+      "aliases": [],
+      "args": {
+        "access_level_id": {
+          "description": "Access Level ID (UUID)",
+          "name": "access_level_id",
+          "required": true
+        }
+      },
+      "description": "Update an access level",
+      "examples": [
+        "<%= config.bin %> access-levels update --app UUID 550e8400-... --title \"VIP Access\""
+      ],
+      "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"
+        },
+        "title": {
+          "description": "Access level title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "access-levels:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "access-levels",
+        "update.js"
+      ]
+    },
+    "asa:connect": {
+      "aliases": [],
+      "args": {},
+      "description": "Connect an Apple Search Ads account to this company",
+      "examples": [
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the browser step",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait until Apple Ads reports as connected",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:connect",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "connect.js"
+      ]
+    },
+    "asa:whoami": {
+      "aliases": [],
+      "args": {},
+      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
+      "examples": [
+        "<%= config.bin %> asa whoami"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:whoami",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "whoami.js"
+      ]
+    },
+    "attribution:dimensions": {
+      "aliases": [],
+      "args": {},
+      "description": "List the dimensions an attribution report can group or filter by (not scoped to an app)",
+      "examples": [
+        "<%= config.bin %> attribution dimensions",
+        "<%= config.bin %> attribution dimensions --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:dimensions",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2053,13 +2119,14 @@
         "update.js"
       ]
     },
-    "segments:create": {
+    "placements:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a segment from filters over profile fields\n\nFilters are written as field:OPERATOR:value[,value...] and validated by the server. Apple Search Ads\nattribution uses campaign, ad_group and creative (a keyword) with Apple ids as values; build those from\nASA entities with `asa segments create` instead of copying ids by hand.",
+      "description": "Create a placement with a paywall",
       "examples": [
-        "<%= config.bin %> segments create --app UUID --title \"[ASA] Campaign: Brand\" --filter campaign:IN:2144520245",
-        "<%= config.bin %> segments create --app UUID --title \"US installs\" --filter ip_country:IN:US --filter install_date:>=:2026-01-01"
+        "<%= 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": {
@@ -2077,23 +2144,30 @@
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Segment description",
-          "name": "description",
+        "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"
         },
-        "filter": {
-          "description": "Filter as field:OPERATOR:value[,value...] (e.g. campaign:IN:2144520245), field:IS NULL, or a JSON object {\"field_name\",\"operator\",\"value_list\"}; repeatable",
-          "name": "filter",
+        "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": "Segment title",
+          "description": "Placement title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -2103,7 +2177,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:create",
+      "id": "placements:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2113,22 +2187,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "placements",
         "create.js"
       ]
     },
-    "segments:get": {
+    "placements:get": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Get segment details",
+      "description": "Get placement details",
       "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2149,7 +2223,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:get",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2159,16 +2233,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "placements",
         "get.js"
       ]
     },
-    "segments:list": {
+    "placements:list": {
       "aliases": [],
       "args": {},
-      "description": "List segments for an app",
+      "description": "List placements for an app",
       "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
+        "<%= config.bin %> placements list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -2205,7 +2279,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:list",
+      "id": "placements:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2215,22 +2289,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "placements",
         "list.js"
       ]
     },
-    "segments:update": {
+    "placements:update": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Replace a segment's title, description and filters\n\nThe server takes the whole segment, as the dashboard sends it: pass every filter you want to keep, not only\nthe changed one. Read the current ones with `segments get`.",
+      "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> segments update --app UUID 550e8400-e29b-41d4-a716-446655440000 --title \"[ASA] Campaign: Brand\" --filter campaign:IN:2144520245"
+        "<%= 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": {
@@ -2248,23 +2324,30 @@
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Segment description",
-          "name": "description",
+        "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"
         },
-        "filter": {
-          "description": "Filter as field:OPERATOR:value[,value...] (e.g. campaign:IN:2144520245), field:IS NULL, or a JSON object {\"field_name\",\"operator\",\"value_list\"}; repeatable",
-          "name": "filter",
+        "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": "Segment title",
+          "description": "Placement title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -2274,7 +2357,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:update",
+      "id": "placements:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2284,18 +2367,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "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": {
@@ -2313,30 +2394,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,
@@ -2346,7 +2477,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:create",
+      "id": "products:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2356,22 +2487,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": {
@@ -2392,7 +2523,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:get",
+      "id": "products:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2402,16 +2533,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": {
@@ -2448,7 +2579,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:list",
+      "id": "products:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2458,24 +2589,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",
+      "description": "Update a product (title and access level only)",
       "examples": [
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
       ],
       "flags": {
         "json": {
@@ -2493,30 +2622,16 @@
           "multiple": false,
           "type": "option"
         },
-        "audiences": {
-          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
-          "name": "audiences",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
+        "access-level-id": {
+          "description": "Access level ID (UUID)",
+          "name": "access-level-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",
+          "description": "Product title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -2526,7 +2641,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "products:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2536,69 +2651,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "products",
         "update.js"
       ]
     },
-    "skills:install": {
-      "aliases": [],
-      "args": {},
-      "description": "Install the Adapty skills into the coding agents on this machine",
-      "examples": [
-        "<%= config.bin %> skills install",
-        "<%= config.bin %> skills install --agent claude-code",
-        "<%= config.bin %> skills install --yes"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "agent": {
-          "description": "Install into this agent only. Repeat for several.",
-          "name": "agent",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "claude-code",
-            "codex",
-            "gemini-cli"
-          ],
-          "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Install into every agent found without asking; required when several are found and no one can answer. Never runs the npx fallback, which is always asked for",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:install",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "install.js"
-      ]
-    },
-    "products:create": {
+    "segments:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a product with vendor products per platform",
+      "description": "Create a segment from filters over profile fields\n\nFilters are written as field:OPERATOR:value[,value...] and validated by the server. Apple Search Ads\nattribution uses campaign, ad_group and creative (a keyword) with Apple ids as values; build those from\nASA entities with `asa segments create` instead of copying ids by hand.",
       "examples": [
-        "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
+        "<%= config.bin %> segments create --app UUID --title \"[ASA] Campaign: Brand\" --filter campaign:IN:2144520245",
+        "<%= config.bin %> segments create --app UUID --title \"US installs\" --filter ip_country:IN:US --filter install_date:>=:2026-01-01"
       ],
       "flags": {
         "json": {
@@ -2616,80 +2679,23 @@
           "multiple": false,
           "type": "option"
         },
-        "access-level-id": {
-          "description": "Access level ID (UUID)",
-          "name": "access-level-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "android-base-plan-id": {
-          "description": "Android base plan ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "android-base-plan-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "android-product-id": {
-          "description": "Android product ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "android-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "ios-product-id": {
-          "description": "iOS product ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "ios-product-id",
-          "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",
+        "description": {
+          "description": "Segment description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "period": {
-          "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
-          "name": "period",
+        "filter": {
+          "description": "Filter as field:OPERATOR:value[,value...] (e.g. campaign:IN:2144520245), field:IS NULL, or a JSON object {\"field_name\",\"operator\",\"value_list\"}; repeatable",
+          "name": "filter",
           "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,
+          "multiple": true,
           "type": "option"
         },
         "title": {
-          "description": "Product title",
+          "description": "Segment title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -2699,7 +2705,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:create",
+      "id": "segments:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2709,22 +2715,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "segments",
         "create.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": {
@@ -2745,7 +2751,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:get",
+      "id": "segments:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2755,16 +2761,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": {
@@ -2801,7 +2807,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:list",
+      "id": "segments:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2811,22 +2817,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "segments",
         "list.js"
       ]
     },
-    "products:update": {
+    "segments:update": {
       "aliases": [],
       "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
           "required": true
         }
       },
-      "description": "Update a product (title and access level only)",
+      "description": "Replace a segment's title, description and filters\n\nThe server takes the whole segment, as the dashboard sends it: pass every filter you want to keep, not only\nthe changed one. Read the current ones with `segments get`.",
       "examples": [
-        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
+        "<%= config.bin %> segments update --app UUID 550e8400-e29b-41d4-a716-446655440000 --title \"[ASA] Campaign: Brand\" --filter campaign:IN:2144520245"
       ],
       "flags": {
         "json": {
@@ -2844,16 +2850,23 @@
           "multiple": false,
           "type": "option"
         },
-        "access-level-id": {
-          "description": "Access level ID (UUID)",
-          "name": "access-level-id",
-          "required": true,
+        "description": {
+          "description": "Segment description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "filter": {
+          "description": "Filter as field:OPERATOR:value[,value...] (e.g. campaign:IN:2144520245), field:IS NULL, or a JSON object {\"field_name\",\"operator\",\"value_list\"}; repeatable",
+          "name": "filter",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "title": {
-          "description": "Product title",
+          "description": "Segment title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -2863,7 +2876,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:update",
+      "id": "segments:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2873,10 +2886,63 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "segments",
         "update.js"
       ]
     },
+    "skills:install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install the Adapty skills into the coding agents on this machine",
+      "examples": [
+        "<%= config.bin %> skills install",
+        "<%= config.bin %> skills install --agent claude-code",
+        "<%= config.bin %> skills install --yes"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "agent": {
+          "description": "Install into this agent only. Repeat for several.",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "claude-code",
+            "codex",
+            "gemini-cli"
+          ],
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Install into every agent found without asking; required when several are found and no one can answer. Never runs the npx fallback, which is always asked for",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:install",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "install.js"
+      ]
+    },
     "asa:ad-groups:create": {
       "aliases": [],
       "args": {},
@@ -6724,5 +6790,5 @@
       ]
     }
   },
-  "version": "0.9.5"
+  "version": "0.10.0"
 }