adapty 0.10.0 → 0.12.0

package/oclif.manifest.json

@@ -66,13 +66,12 @@
         "feedback.js"
       ]
     },
-    "apps:create": {
+    "access-levels:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new Adapty app",
+      "description": "Create a custom access level",
       "examples": [
-        "<%= config.bin %> apps create --title \"My App\" --platform ios --apple-bundle-id com.example.app",
-        "<%= config.bin %> apps create --title \"My App\" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app"
+        "<%= config.bin %> access-levels create --app 550e8400-... --sdk-id vip --title \"VIP Access\""
       ],
       "flags": {
         "json": {
@@ -82,36 +81,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "title": {
-          "description": "App title",
-          "name": "title",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "platform": {
-          "description": "Platform (ios, android). Repeat for multiple.",
-          "name": "platform",
+        "sdk-id": {
+          "description": "Access level SDK identifier",
+          "name": "sdk-id",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "ios",
-            "android"
-          ],
-          "type": "option"
-        },
-        "apple-bundle-id": {
-          "description": "Apple bundle ID (required with --platform ios)",
-          "name": "apple-bundle-id",
-          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "google-bundle-id": {
-          "description": "Google bundle ID (required with --platform android)",
-          "name": "google-bundle-id",
+        "title": {
+          "description": "Access level title",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -119,31 +108,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:create",
+      "id": "access-levels:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "apps",
+        "access-levels",
         "create.js"
       ]
     },
-    "apps:get": {
+    "access-levels:get": {
       "aliases": [],
       "args": {
-        "app_id": {
-          "description": "App ID (UUID)",
-          "name": "app_id",
+        "access_level_id": {
+          "description": "Access Level ID (UUID)",
+          "name": "access_level_id",
           "required": true
         }
       },
-      "description": "Get app details",
+      "description": "Get access level details",
       "examples": [
-        "<%= config.bin %> apps get 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> access-levels get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -152,30 +142,38 @@
           "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": "apps:get",
+      "id": "access-levels:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "apps",
+        "access-levels",
         "get.js"
       ]
     },
-    "apps:list": {
+    "access-levels:list": {
       "aliases": [],
       "args": {},
-      "description": "List Adapty apps",
+      "description": "List access levels for an app",
       "examples": [
-        "<%= config.bin %> apps list",
-        "<%= config.bin %> apps list --page 2 --page-size 10"
+        "<%= config.bin %> access-levels list --app 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -185,6 +183,14 @@
           "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",
@@ -204,31 +210,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:list",
+      "id": "access-levels:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "apps",
+        "access-levels",
         "list.js"
       ]
     },
-    "apps:update": {
+    "access-levels:update": {
       "aliases": [],
       "args": {
-        "app_id": {
-          "description": "App ID (UUID)",
-          "name": "app_id",
+        "access_level_id": {
+          "description": "Access Level ID (UUID)",
+          "name": "access_level_id",
           "required": true
         }
       },
-      "description": "Update an app",
+      "description": "Update an access level",
       "examples": [
-        "<%= config.bin %> apps update 550e8400-... --title \"My App\""
+        "<%= config.bin %> access-levels update --app UUID 550e8400-... --title \"VIP Access\""
       ],
       "flags": {
         "json": {
@@ -238,23 +245,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "title": {
-          "description": "App title",
-          "name": "title",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "apple-bundle-id": {
-          "description": "Apple bundle ID",
-          "name": "apple-bundle-id",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "google-bundle-id": {
-          "description": "Google bundle ID",
-          "name": "google-bundle-id",
+        "title": {
+          "description": "Access level title",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -262,25 +264,27 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:update",
+      "id": "access-levels:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "apps",
+        "access-levels",
         "update.js"
       ]
     },
-    "access-levels:create": {
+    "analytics:catalog": {
       "aliases": [],
       "args": {},
-      "description": "Create a custom access level",
+      "description": "List what the analytics of an app can answer: the six operations with their options, groupings and filters, every chart and conversion, and every filter dimension",
       "examples": [
-        "<%= config.bin %> access-levels create --app 550e8400-... --sdk-id vip --title \"VIP Access\""
+        "<%= config.bin %> analytics catalog --app APP_UUID",
+        "<%= config.bin %> analytics catalog --app APP_UUID --json"
       ],
       "flags": {
         "json": {
@@ -297,52 +301,31 @@
           "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",
+      "id": "analytics:catalog",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "access-levels",
-        "create.js"
+        "analytics",
+        "catalog.js"
       ]
     },
-    "access-levels:get": {
+    "analytics:chart": {
       "aliases": [],
-      "args": {
-        "access_level_id": {
-          "description": "Access Level ID (UUID)",
-          "name": "access_level_id",
-          "required": true
-        }
-      },
-      "description": "Get access level details",
+      "args": {},
+      "description": "Read one chart of the analytics of an app (revenue, MRR, installs, ...): the number of the period, its points and its groups, the total first",
       "examples": [
-        "<%= config.bin %> access-levels get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> analytics chart --app APP_UUID --chart revenue --date-from 2026-07-01 --date-to 2026-09-30",
+        "<%= config.bin %> analytics chart --app APP_UUID --chart revenue --date-from 2026-07-01 --date-to 2026-09-30 --group-by country --csv",
+        "<%= config.bin %> analytics chart --app APP_UUID --chart mrr --date-from 2026-07-01 --date-to 2026-09-30 --compare-from 2026-04-01 --compare-to 2026-06-30 --json"
       ],
       "flags": {
         "json": {
@@ -359,30 +342,124 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "chart": {
+          "description": "The chart, as `adapty analytics catalog` lists it",
+          "name": "chart",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "compare-from": {
+          "description": "First day of a period to compare with, inclusive (YYYY-MM-DD); needs --compare-to",
+          "name": "compare-from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "compare-to": {
+          "description": "Last day of a period to compare with, inclusive (YYYY-MM-DD); needs --compare-from",
+          "name": "compare-to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "One grouping of this operation, as `adapty analytics catalog` lists it (e.g. country)",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep the data whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value; values exactly as written, an empty one too, e.g. country= for no country). Dimensions: `adapty analytics catalog`; values: `adapty analytics values`",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timezone": {
+          "description": "IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted",
+          "name": "timezone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "granularity": {
+          "description": "The period of one point (default month)",
+          "name": "granularity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ],
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the money values use: gross (default), proceeds (after store commission) or net (also after taxes)",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        },
+        "csv": {
+          "description": "Print a CSV table made from the API answer: one row per group, the total first (is_total true; a null key is an empty cell, an empty key is written \"\"); a compared period in compare.* columns of the same row; the numbers of the whole answer in data.* and meta.* columns. No groups: the header line, and \"No data for this period.\" with those numbers on stderr",
+          "exclusive": [
+            "json"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "access-levels:get",
+      "id": "analytics:chart",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "access-levels",
-        "get.js"
+        "analytics",
+        "chart.js"
       ]
     },
-    "access-levels:list": {
+    "analytics:cohort": {
       "aliases": [],
       "args": {},
-      "description": "List access levels for an app",
+      "description": "Read the install cohorts of an app: revenue, subscribers and averages of each cohort per renewal (or day), with predictions, the total first (no grouping, no compared period)",
       "examples": [
-        "<%= config.bin %> access-levels list --app 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> analytics cohort --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30",
+        "<%= config.bin %> analytics cohort --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30 --granularity week --revenue-basis proceeds --csv"
       ],
       "flags": {
         "json": {
@@ -400,51 +477,530 @@
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-from",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-to",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "access-levels:list",
+        },
+        "filter": {
+          "description": "Keep the data whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value; values exactly as written, an empty one too, e.g. country= for no country). Dimensions: `adapty analytics catalog`; values: `adapty analytics values`",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timezone": {
+          "description": "IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted",
+          "name": "timezone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "granularity": {
+          "description": "The length of one cohort (default month)",
+          "name": "granularity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ],
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the money values use: gross (default), proceeds (after store commission) or net (also after taxes)",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        },
+        "period-type": {
+          "description": "Count per renewal (renewals, default) or per day since the install (days)",
+          "name": "period-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "renewals",
+            "days"
+          ],
+          "type": "option"
+        },
+        "renewal-days": {
+          "description": "The days to count with --period-type days (comma-separated or repeatable); the backend list when omitted",
+          "name": "renewal-days",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "csv": {
+          "description": "Print a CSV table made from the API answer: one row per group, the total first (is_total true; a null key is an empty cell, an empty key is written \"\"); a compared period in compare.* columns of the same row; the numbers of the whole answer in data.* and meta.* columns. No groups: the header line, and \"No data for this period.\" with those numbers on stderr",
+          "exclusive": [
+            "json"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:cohort",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "cohort.js"
+      ]
+    },
+    "analytics:conversion": {
+      "aliases": [],
+      "args": {},
+      "description": "Read one conversion of the analytics of an app (install → trial, trial → paid, ...): the rate in percent with its two counts, per point and per group, the total first",
+      "examples": [
+        "<%= config.bin %> analytics conversion --app APP_UUID --conversion trial-paid --date-from 2026-07-01 --date-to 2026-09-30",
+        "<%= config.bin %> analytics conversion --app APP_UUID --conversion install-paid --date-from 2026-07-01 --date-to 2026-09-30 --granularity month --group-by country --csv"
+      ],
+      "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"
+        },
+        "conversion": {
+          "description": "The conversion, as `adapty analytics catalog` lists it",
+          "name": "conversion",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "compare-from": {
+          "description": "First day of a period to compare with, inclusive (YYYY-MM-DD); needs --compare-to",
+          "name": "compare-from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "compare-to": {
+          "description": "Last day of a period to compare with, inclusive (YYYY-MM-DD); needs --compare-from",
+          "name": "compare-to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "One grouping of this operation, as `adapty analytics catalog` lists it (e.g. country)",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep the data whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value; values exactly as written, an empty one too, e.g. country= for no country). Dimensions: `adapty analytics catalog`; values: `adapty analytics values`",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timezone": {
+          "description": "IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted",
+          "name": "timezone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "granularity": {
+          "description": "The period of one point (default day)",
+          "name": "granularity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ],
+          "type": "option"
+        },
+        "csv": {
+          "description": "Print a CSV table made from the API answer: one row per group, the total first (is_total true; a null key is an empty cell, an empty key is written \"\"); a compared period in compare.* columns of the same row; the numbers of the whole answer in data.* and meta.* columns. No groups: the header line, and \"No data for this period.\" with those numbers on stderr",
+          "exclusive": [
+            "json"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:conversion",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "conversion.js"
+      ]
+    },
+    "analytics:funnel": {
+      "aliases": [],
+      "args": {},
+      "description": "Read the funnel of an app, from install to renewals: the count at each step, per group, the total first (no compared period: the funnel query cannot keep two periods apart)",
+      "examples": [
+        "<%= config.bin %> analytics funnel --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30",
+        "<%= config.bin %> analytics funnel --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30 --group-by country --csv"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "One grouping of this operation, as `adapty analytics catalog` lists it (e.g. country)",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep the data whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value; values exactly as written, an empty one too, e.g. country= for no country). Dimensions: `adapty analytics catalog`; values: `adapty analytics values`",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timezone": {
+          "description": "IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted",
+          "name": "timezone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "csv": {
+          "description": "Print a CSV table made from the API answer: one row per group, the total first (is_total true; a null key is an empty cell, an empty key is written \"\"); a compared period in compare.* columns of the same row; the numbers of the whole answer in data.* and meta.* columns. No groups: the header line, and \"No data for this period.\" with those numbers on stderr",
+          "exclusive": [
+            "json"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:funnel",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "funnel.js"
+      ]
+    },
+    "analytics:ltv": {
+      "aliases": [],
+      "args": {},
+      "description": "Read the LTV of an app: the revenue per paying user after each renewal (or day), per group, the total first (no compared period)",
+      "examples": [
+        "<%= config.bin %> analytics ltv --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30",
+        "<%= config.bin %> analytics ltv --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30 --revenue-basis net --period-type days --renewal-days 7,30,90 --csv"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "One grouping of this operation, as `adapty analytics catalog` lists it (e.g. country)",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep the data whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value; values exactly as written, an empty one too, e.g. country= for no country). Dimensions: `adapty analytics catalog`; values: `adapty analytics values`",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timezone": {
+          "description": "IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted",
+          "name": "timezone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the money values use: gross (default), proceeds (after store commission) or net (also after taxes)",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        },
+        "period-type": {
+          "description": "Count per renewal (renewals, default) or per day since the install (days)",
+          "name": "period-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "renewals",
+            "days"
+          ],
+          "type": "option"
+        },
+        "renewal-days": {
+          "description": "The days to count with --period-type days (comma-separated or repeatable); the backend list when omitted",
+          "name": "renewal-days",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "csv": {
+          "description": "Print a CSV table made from the API answer: one row per group, the total first (is_total true; a null key is an empty cell, an empty key is written \"\"); a compared period in compare.* columns of the same row; the numbers of the whole answer in data.* and meta.* columns. No groups: the header line, and \"No data for this period.\" with those numbers on stderr",
+          "exclusive": [
+            "json"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:ltv",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "ltv.js"
+      ]
+    },
+    "analytics:retention": {
+      "aliases": [],
+      "args": {},
+      "description": "Read the retention of an app: the subscribers left in each period, per group, the total first (no compared period)",
+      "examples": [
+        "<%= config.bin %> analytics retention --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30",
+        "<%= config.bin %> analytics retention --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30 --group-by country --use-trial --csv"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the --timezone zone, else the app time zone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "One grouping of this operation, as `adapty analytics catalog` lists it (e.g. country)",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep the data whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value; values exactly as written, an empty one too, e.g. country= for no country). Dimensions: `adapty analytics catalog`; values: `adapty analytics values`",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "timezone": {
+          "description": "IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted",
+          "name": "timezone",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "use-trial": {
+          "description": "Count from the trial, not from the first paid period",
+          "name": "use-trial",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "csv": {
+          "description": "Print a CSV table made from the API answer: one row per group, the total first (is_total true; a null key is an empty cell, an empty key is written \"\"); a compared period in compare.* columns of the same row; the numbers of the whole answer in data.* and meta.* columns. No groups: the header line, and \"No data for this period.\" with those numbers on stderr",
+          "exclusive": [
+            "json"
+          ],
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:retention",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "access-levels",
-        "list.js"
+        "analytics",
+        "retention.js"
       ]
     },
-    "access-levels:update": {
+    "analytics:values": {
       "aliases": [],
-      "args": {
-        "access_level_id": {
-          "description": "Access Level ID (UUID)",
-          "name": "access_level_id",
-          "required": true
-        }
-      },
-      "description": "Update an access level",
+      "args": {},
+      "description": "List the values one analytics filter takes for an app: what --filter accepts",
       "examples": [
-        "<%= config.bin %> access-levels update --app UUID 550e8400-... --title \"VIP Access\""
+        "<%= config.bin %> analytics values --app APP_UUID --dimension country",
+        "<%= config.bin %> analytics values --app APP_UUID --dimension store_product_id --json"
       ],
       "flags": {
         "json": {
@@ -462,28 +1018,236 @@
           "multiple": false,
           "type": "option"
         },
+        "dimension": {
+          "description": "A filter dimension, as `adapty analytics catalog` lists it under Dimensions",
+          "name": "dimension",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:values",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "values.js"
+      ]
+    },
+    "apps:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a new Adapty app",
+      "examples": [
+        "<%= config.bin %> apps create --title \"My App\" --platform ios --apple-bundle-id com.example.app",
+        "<%= config.bin %> apps create --title \"My App\" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "title": {
-          "description": "Access level title",
+          "description": "App title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "platform": {
+          "description": "Platform (ios, android). Repeat for multiple.",
+          "name": "platform",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "ios",
+            "android"
+          ],
+          "type": "option"
+        },
+        "apple-bundle-id": {
+          "description": "Apple bundle ID (required with --platform ios)",
+          "name": "apple-bundle-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "google-bundle-id": {
+          "description": "Google bundle ID (required with --platform android)",
+          "name": "google-bundle-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "access-levels:update",
+      "id": "apps:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "access-levels",
+        "apps",
+        "create.js"
+      ]
+    },
+    "apps:get": {
+      "aliases": [],
+      "args": {
+        "app_id": {
+          "description": "App ID (UUID)",
+          "name": "app_id",
+          "required": true
+        }
+      },
+      "description": "Get app details",
+      "examples": [
+        "<%= config.bin %> apps get 550e8400-e29b-41d4-a716-446655440000"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apps",
+        "get.js"
+      ]
+    },
+    "apps:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Adapty apps",
+      "examples": [
+        "<%= config.bin %> apps list",
+        "<%= config.bin %> apps list --page 2 --page-size 10"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apps",
+        "list.js"
+      ]
+    },
+    "apps:update": {
+      "aliases": [],
+      "args": {
+        "app_id": {
+          "description": "App ID (UUID)",
+          "name": "app_id",
+          "required": true
+        }
+      },
+      "description": "Update an app",
+      "examples": [
+        "<%= config.bin %> apps update 550e8400-... --title \"My App\""
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "title": {
+          "description": "App title",
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apple-bundle-id": {
+          "description": "Apple bundle ID",
+          "name": "apple-bundle-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "google-bundle-id": {
+          "description": "Google bundle ID",
+          "name": "google-bundle-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apps",
         "update.js"
       ]
     },
@@ -2145,7 +2909,7 @@
           "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.",
+          "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/B test (as `placements get` shows it): {content_type:\"ab_test\" | \"flow_ab_test\", ab_test_id, segment_ids, priority}; crossplacement entries (\"cross_ab_test\", \"flow_cross_ab_test\") are read-only, the API keeps the stored ones. Write the entries of `placements get` back unchanged to keep a running test: a write that removes or replaces an A/B test entry stops that test with no winner. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
           "name": "audiences",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2325,7 +3089,7 @@
           "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.",
+          "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/B test (as `placements get` shows it): {content_type:\"ab_test\" | \"flow_ab_test\", ab_test_id, segment_ids, priority}; crossplacement entries (\"cross_ab_test\", \"flow_cross_ab_test\") are read-only, the API keeps the stored ones. Write the entries of `placements get` back unchanged to keep a running test: a write that removes or replaces an A/B test entry stops that test with no winner. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
           "name": "audiences",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6790,5 +7554,5 @@
       ]
     }
   },
-  "version": "0.10.0"
+  "version": "0.12.0"
 }