adapty 0.11.0 → 0.13.0

package/oclif.manifest.json

@@ -278,6 +278,770 @@
         "update.js"
       ]
     },
+    "analytics:catalog": {
+      "aliases": [],
+      "args": {},
+      "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 %> analytics catalog --app APP_UUID",
+        "<%= config.bin %> analytics catalog --app APP_UUID --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analytics:catalog",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "catalog.js"
+      ]
+    },
+    "analytics:chart": {
+      "aliases": [],
+      "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 %> 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": {
+          "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"
+        },
+        "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": "analytics:chart",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "chart.js"
+      ]
+    },
+    "analytics:cohort": {
+      "aliases": [],
+      "args": {},
+      "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 %> 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": {
+          "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"
+        },
+        "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,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analytics",
+        "retention.js"
+      ]
+    },
+    "analytics:values": {
+      "aliases": [],
+      "args": {},
+      "description": "List the values one analytics filter takes for an app: what --filter accepts",
+      "examples": [
+        "<%= config.bin %> analytics values --app APP_UUID --dimension country",
+        "<%= config.bin %> analytics values --app APP_UUID --dimension store_product_id --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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": {},
@@ -2357,17 +3121,288 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "placements:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "placements",
+        "update.js"
+      ]
+    },
+    "product-offers:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create an offer for a product",
+      "examples": [
+        "<%= config.bin %> product-offers create --app 550e8400-... --product 660e8400-... --title \"Spring\" --type promotional --ios-offer-id spring_ios --android-offer-id spring-android",
+        "<%= config.bin %> product-offers create --app 550e8400-... --product 660e8400-... --title \"Come back\" --type win_back --ios-offer-id winback_ios"
+      ],
+      "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"
+        },
+        "product": {
+          "description": "Product ID (UUID)",
+          "name": "product",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Offer title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Offer type (win_back is App Store only)",
+          "name": "type",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "promotional",
+            "win_back"
+          ],
+          "type": "option"
+        },
+        "ios-offer-id": {
+          "description": "App Store offer ID",
+          "name": "ios-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "android-offer-id": {
+          "description": "Google Play offer ID",
+          "name": "android-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:create",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "create.js"
+      ]
+    },
+    "product-offers:get": {
+      "aliases": [],
+      "args": {
+        "offer_id": {
+          "description": "Offer ID (UUID)",
+          "name": "offer_id",
+          "required": true
+        }
+      },
+      "description": "Get a product offer",
+      "examples": [
+        "<%= config.bin %> product-offers get 770e8400-... --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "get.js"
+      ]
+    },
+    "product-offers:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the offers of a product (all on one page)",
+      "examples": [
+        "<%= config.bin %> product-offers list --app 550e8400-... --product 660e8400-..."
+      ],
+      "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"
+        },
+        "product": {
+          "description": "Product ID (UUID)",
+          "name": "product",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "list.js"
+      ]
+    },
+    "product-offers:update": {
+      "aliases": [],
+      "args": {
+        "offer_id": {
+          "description": "Offer ID (UUID)",
+          "name": "offer_id",
+          "required": true
+        }
+      },
+      "description": "Reads the offer and writes it back whole: fields you leave out keep their stored value, a change made in the dashboard in between is overwritten, and at least one store offer id must remain.",
+      "examples": [
+        "<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --title \"Spring 2\"",
+        "<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --clear-android-offer-id"
+      ],
+      "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": "Offer title",
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Offer type (win_back is App Store only: clear the Google Play side too)",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "promotional",
+            "win_back"
+          ],
+          "type": "option"
+        },
+        "ios-offer-id": {
+          "description": "App Store offer ID",
+          "exclusive": [
+            "clear-ios-offer-id"
+          ],
+          "name": "ios-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "android-offer-id": {
+          "description": "Google Play offer ID",
+          "exclusive": [
+            "clear-android-offer-id"
+          ],
+          "name": "android-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "clear-ios-offer-id": {
+          "description": "Remove the App Store side of the offer",
+          "name": "clear-ios-offer-id",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "clear-android-offer-id": {
+          "description": "Remove the Google Play side of the offer",
+          "name": "clear-android-offer-id",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Update a product offer",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
+        "product-offers",
         "update.js"
       ]
     },
@@ -5988,12 +7023,13 @@
         "list.js"
       ]
     },
-    "asa:orgs:list": {
+    "asa:product-pages:list": {
       "aliases": [],
       "args": {},
-      "description": "List the Apple Search Ads organizations this company can spend from",
+      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
       "examples": [
-        "<%= config.bin %> asa orgs list"
+        "<%= config.bin %> asa product-pages list",
+        "<%= config.bin %> asa product-pages list --app APP_UUID"
       ],
       "flags": {
         "json": {
@@ -6018,11 +7054,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:orgs:list",
+      "id": "asa:product-pages:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -6033,10 +7083,65 @@
         "dist",
         "commands",
         "asa",
-        "orgs",
+        "product-pages",
         "list.js"
       ]
     },
+    "asa:product-pages:sync": {
+      "aliases": [],
+      "args": {},
+      "description": "Refresh custom product pages from Apple",
+      "examples": [
+        "<%= config.bin %> asa product-pages sync",
+        "<%= config.bin %> asa product-pages sync --adam-id 123456"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "idempotency-key": {
+          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
+          "name": "idempotency-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "adam-id": {
+          "description": "Limit the refresh to one app; omit to cover every app",
+          "name": "adam-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:product-pages:sync",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "product-pages",
+        "sync.js"
+      ]
+    },
     "asa:search-terms:list": {
       "aliases": [],
       "args": {},
@@ -6136,6 +7241,55 @@
         "list.js"
       ]
     },
+    "asa:orgs:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the Apple Search Ads organizations this company can spend from",
+      "examples": [
+        "<%= config.bin %> asa orgs list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:orgs:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "orgs",
+        "list.js"
+      ]
+    },
     "asa:segments:create": {
       "aliases": [],
       "args": {},
@@ -6367,125 +7521,6 @@
         "update.js"
       ]
     },
-    "asa:product-pages:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
-      "examples": [
-        "<%= config.bin %> asa product-pages list",
-        "<%= config.bin %> asa product-pages list --app APP_UUID"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:product-pages:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "product-pages",
-        "list.js"
-      ]
-    },
-    "asa:product-pages:sync": {
-      "aliases": [],
-      "args": {},
-      "description": "Refresh custom product pages from Apple",
-      "examples": [
-        "<%= config.bin %> asa product-pages sync",
-        "<%= config.bin %> asa product-pages sync --adam-id 123456"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "adam-id": {
-          "description": "Limit the refresh to one app; omit to cover every app",
-          "name": "adam-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:product-pages:sync",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "product-pages",
-        "sync.js"
-      ]
-    },
     "flows:config:get": {
       "aliases": [],
       "args": {
@@ -6790,5 +7825,5 @@
       ]
     }
   },
-  "version": "0.11.0"
+  "version": "0.13.0"
 }