adapty 0.11.0 → 0.13.0

package/README.md

@@ -72,6 +72,19 @@ adapty products create --app UUID [flags]
 adapty products update --app UUID PRODUCT_ID [flags]
 ```
 
+### Product offers
+
+```sh
+adapty product-offers list --app UUID --product UUID
+adapty product-offers get OFFER_ID --app UUID
+adapty product-offers create --app UUID --product UUID --title "Spring" --type promotional|win_back [--ios-offer-id ID] [--android-offer-id ID]
+adapty product-offers update OFFER_ID --app UUID [--title ...] [--type ...] [--ios-offer-id ID | --clear-ios-offer-id] [--android-offer-id ID | --clear-android-offer-id]
+```
+
+`list` returns every offer on one page. `create` needs at least one store offer id; `win_back` is App Store only.
+`update` reads the offer and writes it back whole: it keeps every field you leave out, overwrites a dashboard edit made
+in between, and refuses to clear the last store side. Introductory offers are read-only. Offers are deleted in the dashboard.
+
 ### Paywalls
 
 ```sh
@@ -618,6 +631,38 @@ too. A burst of 429s puts the token into an escalating cool-down (`cli_cooldown_
 not waiting out the pause in a loop. An automation run is queued rather than awaited: `run` prints a run ID
 and the outcome shows up in `adapty asa automations runs`.
 
+### Analytics
+
+The analytics of an app, as the dashboard shows them, live under `adapty analytics`: the charts, conversions, the
+funnel, retention, LTV and cohorts, all on the Developer API with the same token.
+
+```sh
+adapty analytics catalog --app APP_UUID                          # operations, charts, conversions, filters
+adapty analytics values --app APP_UUID --dimension country       # what --filter country=... takes
+adapty analytics chart --app APP_UUID --chart revenue --date-from 2026-07-01 --date-to 2026-09-30 \
+  --group-by country --compare-from 2026-04-01 --compare-to 2026-06-30
+adapty analytics funnel --app APP_UUID --date-from 2026-07-01 --date-to 2026-09-30 --csv
+```
+
+Every data command (`chart`, `conversion`, `funnel`, `retention`, `ltv`, `cohort`) answers in one shape: the
+number of the period, then segments with the total first (`is_total`), each group keyed by the raw backend value.
+`--json` prints the API answer unchanged; `--csv` prints a table made from it (one row per group, total first; a
+compared period in `compare.*` columns);
+the human view prints a short table (one row per group, total first, money with 2 decimals, `—` for a missing
+value) and `No data for this period.` for an empty window. The analytics numbers never add to the `attribution`
+numbers. Dates are
+inclusive days of `--timezone`, else the app time zone. Only `chart` and `conversion` take a compared period. Bad
+input exits 2 before anything is sent; a refusal exits 4 with the API's error code; a missing token or an app the
+token cannot access (403) exits 3; an Adapty that cannot be reached (no connection) exits 5 with
+`Could not reach <url>`, or `code: network_error` and `status: 0` under `--json`. Each analytics route has its own
+rate limits, as the Export API: 2 requests per second per app and 360 per minute for all callers together. Over a limit, the command exits 4 with the wait
+(`retry_after_seconds` in `--json`).
+
+The analytics queries are stricter than the Export API and the dashboard: a filter or grouping that the report does
+not take is a 400 that names the field, never ignored; the funnel refuses the `cancellation_reason` filter; retention
+and conversion group by the dashboard's retention list; retention, LTV, cohort and funnel take no compared period.
+The full list is in `docs/agent/analytics.md`.
+
 ### Attribution
 
 Attribution analytics across ad networks live under `adapty attribution` and talk to the attribution service

package/dist/cli/base/adapty/flags.d.ts

@@ -0,0 +1,65 @@
+import type { AnalyticsFilter, PeriodUnit } from '../../../sdk/adapty/index.js';
+/** The flags the analytics commands share. A flag left out leaves its field out: the backend default applies. */
+/** Days of the query time zone: `--timezone`, else the app zone. */
+export declare const periodFlags: {
+    'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};
+/** Only the chart and the conversion take them: the other queries mix two periods into one. */
+export declare const compareFlags: {
+    'compare-from': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'compare-to': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const filterFlags: {
+    filter: import("@oclif/core/interfaces").OptionFlag<AnalyticsFilter[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    timezone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const groupByFlag: {
+    'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+/** The text differs per command: the period of one point, or the length of one cohort. */
+export declare const granularityFlag: (description: string) => {
+    granularity: import("@oclif/core/interfaces").OptionFlag<"day" | "week" | "month" | "quarter" | "year" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const revenueBasisFlag: {
+    'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const renewalPeriodFlags: {
+    'period-type': import("@oclif/core/interfaces").OptionFlag<"renewals" | "days" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'renewal-days': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const csvFlag: {
+    csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+};
+type QueryFlags = {
+    'app': string;
+    'date-from': string;
+    'date-to': string;
+    'filter'?: AnalyticsFilter[] | undefined;
+    'timezone'?: string | undefined;
+};
+/** Where the shared flags meet the sdk's field names. */
+export declare const queryParams: (flags: QueryFlags) => {
+    appId: string;
+    dateFrom: string;
+    dateTo: string;
+    filters: AnalyticsFilter[] | undefined;
+    timezone: string | undefined;
+};
+/** The compare flags as the sdk names them; a chart and a conversion take them. */
+export declare const compareParams: (flags: {
+    "compare-from"?: string | undefined;
+    "compare-to"?: string | undefined;
+}) => {
+    compareFrom: string | undefined;
+    compareTo: string | undefined;
+};
+/** The grouping and the period of one point as the sdk names them; a command without one of the flags leaves it out. */
+export declare const groupingParams: (flags: {
+    "granularity"?: PeriodUnit | undefined;
+    "group-by"?: string | undefined;
+}) => {
+    granularity: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    groupBy: string | undefined;
+};
+export {};

package/dist/cli/base/adapty/flags.js

@@ -0,0 +1,95 @@
+import { Flags } from '@oclif/core';
+import { periodTypes, periodUnits, revenueBases } from '../../../sdk/adapty/index.js';
+import { usageError } from '../../errors.js';
+import { splitFilter } from '../../input/filter.js';
+import { dateParser, dayRangeFlags } from '../../input/period.js';
+/** The flags the analytics commands share. A flag left out leaves its field out: the backend default applies. */
+/** Days of the query time zone: `--timezone`, else the app zone. */
+export const periodFlags = dayRangeFlags('in the --timezone zone, else the app time zone');
+/** Only the chart and the conversion take them: the other queries mix two periods into one. */
+export const compareFlags = {
+    'compare-from': Flags.string({
+        description: 'First day of a period to compare with, inclusive (YYYY-MM-DD); needs --compare-to',
+        parse: dateParser,
+    }),
+    'compare-to': Flags.string({
+        description: 'Last day of a period to compare with, inclusive (YYYY-MM-DD); needs --compare-from',
+        parse: dateParser,
+    }),
+};
+/**
+ * `dimension=value[,value]` with every value exactly as written. An empty value is a value: `country=` keeps the
+ * data without a country, as the dashboard filter does.
+ */
+const parseExactFilter = (input) => {
+    const filter = splitFilter(input);
+    return filter === undefined
+        ? Promise.reject(usageError(`Expected dimension=value[,value] (an empty value is a value), got "${input}".`))
+        : Promise.resolve(filter);
+};
+export const filterFlags = {
+    filter: Flags.custom({
+        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`',
+        multiple: true,
+        parse: parseExactFilter,
+    })(),
+    timezone: Flags.string({
+        description: 'IANA time zone of the days, e.g. Europe/Berlin; the app time zone when omitted',
+    }),
+};
+export const groupByFlag = {
+    'group-by': Flags.string({
+        description: 'One grouping of this operation, as `adapty analytics catalog` lists it (e.g. country)',
+    }),
+};
+/** The text differs per command: the period of one point, or the length of one cohort. */
+export const granularityFlag = (description) => ({
+    granularity: Flags.option({ description, options: periodUnits })(),
+});
+export const revenueBasisFlag = {
+    'revenue-basis': Flags.option({
+        description: 'Which revenue the money values use: gross (default), proceeds (after store commission) or net (also after taxes)',
+        options: revenueBases,
+    })(),
+};
+export const renewalPeriodFlags = {
+    'period-type': Flags.option({
+        description: 'Count per renewal (renewals, default) or per day since the install (days)',
+        options: periodTypes,
+    })(),
+    'renewal-days': Flags.integer({
+        delimiter: ',',
+        description: 'The days to count with --period-type days (comma-separated or repeatable); the backend list when omitted',
+        min: 0,
+        multiple: true,
+    }),
+};
+export const csvFlag = {
+    csv: Flags.boolean({
+        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'],
+    }),
+};
+/** Where the shared flags meet the sdk's field names. */
+export const queryParams = (flags) => ({
+    appId: flags.app,
+    dateFrom: flags['date-from'],
+    dateTo: flags['date-to'],
+    filters: flags.filter,
+    timezone: flags.timezone,
+});
+/** The compare flags as the sdk names them; a chart and a conversion take them. */
+export const compareParams = (flags) => ({
+    compareFrom: flags['compare-from'],
+    compareTo: flags['compare-to'],
+});
+/** The grouping and the period of one point as the sdk names them; a command without one of the flags leaves it out. */
+export const groupingParams = (flags) => ({
+    granularity: flags.granularity,
+    groupBy: flags['group-by'],
+});

package/dist/cli/base/adapty/index.d.ts

@@ -3,3 +3,4 @@ export { build } from './build.js';
 export { MigrationCommand } from './migration-command.js';
 export { openSession, resolveSession } from './openSession.js';
 export type { AuthenticatedSession, ResolvedSession } from '../session.js';
+export { compareFlags, compareParams, csvFlag, filterFlags, granularityFlag, groupByFlag, groupingParams, periodFlags, queryParams, renewalPeriodFlags, revenueBasisFlag, } from './flags.js';

package/dist/cli/base/adapty/index.js

@@ -2,3 +2,4 @@ export { AdaptyCommand } from './adapty-command.js';
 export { build } from './build.js';
 export { MigrationCommand } from './migration-command.js';
 export { openSession, resolveSession } from './openSession.js';
+export { compareFlags, compareParams, csvFlag, filterFlags, granularityFlag, groupByFlag, groupingParams, periodFlags, queryParams, renewalPeriodFlags, revenueBasisFlag, } from './flags.js';

package/dist/cli/base/attribution/flags.d.ts

@@ -3,9 +3,6 @@ export declare const periodFlags: {
     'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
 };
-export declare const revenueBasisFlag: {
-    'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-};
 /** Where the period flags meet the sdk's field names. */
 export declare const periodParams: (flags: {
     "date-from": string;
@@ -14,3 +11,6 @@ export declare const periodParams: (flags: {
     dateFrom: string;
     dateTo: string;
 };
+export declare const revenueBasisFlag: {
+    'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};

package/dist/cli/base/attribution/flags.js

@@ -1,28 +1,13 @@
 import { Flags } from '@oclif/core';
-import { ISO_DATE, revenueBases } from '../../../sdk/attribution/index.js';
-import { usageError } from '../../errors.js';
-/** The shape only: whether the day exists and the order of the two are sdk rules. */
-const dateParser = (input) => (ISO_DATE.test(input)
-    ? Promise.resolve(input)
-    : Promise.reject(usageError('Dates must be written as YYYY-MM-DD.')));
+import { revenueBases } from '../../../sdk/attribution/index.js';
+import { dayRangeFlags } from '../../input/period.js';
 /** An inclusive day range, both ends required. */
-export const periodFlags = {
-    'date-from': Flags.string({
-        description: 'First day of the period, inclusive (YYYY-MM-DD, in the app timezone)',
-        parse: dateParser,
-        required: true,
-    }),
-    'date-to': Flags.string({
-        description: 'Last day of the period, inclusive (YYYY-MM-DD, in the app timezone)',
-        parse: dateParser,
-        required: true,
-    }),
-};
+export const periodFlags = dayRangeFlags('in the app timezone');
+/** Where the period flags meet the sdk's field names. */
+export const periodParams = (flags) => ({ dateFrom: flags['date-from'], dateTo: flags['date-to'] });
 export const revenueBasisFlag = {
     'revenue-basis': Flags.option({
         description: 'Which revenue the revenue metrics use; the backend default applies when omitted',
         options: revenueBases,
     })(),
 };
-/** Where the period flags meet the sdk's field names. */
-export const periodParams = (flags) => ({ dateFrom: flags['date-from'], dateTo: flags['date-to'] });

package/dist/cli/commands/analytics/catalog.d.ts

@@ -0,0 +1,10 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { CatalogResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsCatalog extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CatalogResponse>;
+}

package/dist/cli/commands/analytics/catalog.js

@@ -0,0 +1,52 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+const list = (items) => (items.length === 0 ? 'none' : items.join(', '));
+const groupings = (segmentations) => list(segmentations.map(segmentation => segmentation.key));
+/** Under the catalog's own names, so a reader knows what to look for in --json and what a flag takes. */
+const describeOption = (option) => {
+    const values = option.values === null ? '' : ` ${option.values.join('|')}`;
+    const fallback = option.default === null ? '' : ` (default ${String(option.default)})`;
+    return `${option.name}${values}${fallback}`;
+};
+const describeOperation = (operation) => {
+    const perChart = operation.id === 'metrics' ? 'per chart, see Charts' : undefined;
+    return [
+        `${operation.id} (${operation.method} ${operation.path}; ${operation.can_compare ? 'can compare two periods' : 'one period only'})`,
+        `  options: ${operation.options.map(option => describeOption(option)).join('; ')}`,
+        `  groupings: ${perChart ?? groupings(operation.segmentations)}`,
+        `  filters: ${perChart ?? list(operation.filters)}`,
+    ].join('\n');
+};
+const describeChart = (chart) => [
+    `${chart.id}: ${chart.title} (${chart.unit}${chart.takes_revenue_basis ? ', takes revenue_basis' : ''})`,
+    `  groupings: ${groupings(chart.segmentations)}`,
+    `  filters: ${list(chart.filters)}`,
+].join('\n');
+const renderCatalog = ({ data }) => [
+    'Operations',
+    ...data.operations.map(operation => describeOperation(operation)),
+    '',
+    'Charts',
+    ...data.charts.map(chart => describeChart(chart)),
+    '',
+    'Conversions',
+    ...data.conversions.map(conversion => `${conversion.id}: ${conversion.title}`),
+    '',
+    'Dimensions',
+    ...data.dimensions.map(dimension => `${dimension.key}: ${dimension.label}`),
+].join('\n');
+export default class AnalyticsCatalog extends AdaptyCommand {
+    static 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';
+    static examples = [
+        '<%= config.bin %> analytics catalog --app APP_UUID',
+        '<%= config.bin %> analytics catalog --app APP_UUID --json',
+    ];
+    static flags = { ...appIdFlag };
+    async run() {
+        const { flags } = await this.parse(AnalyticsCatalog);
+        const catalog = await this.adapty.analytics.catalog(flags.app);
+        this.render(catalog, renderCatalog);
+        return catalog;
+    }
+}

package/dist/cli/commands/analytics/chart.d.ts

@@ -0,0 +1,21 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ChartResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsChart extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        granularity: import("@oclif/core/interfaces").OptionFlag<"day" | "week" | "month" | "quarter" | "year" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<import("../../../sdk/adapty/index.js").AnalyticsFilter[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timezone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'compare-from': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'compare-to': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        chart: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ChartResponse>;
+}

package/dist/cli/commands/analytics/chart.js

@@ -0,0 +1,47 @@
+import { Flags } from '@oclif/core';
+import { validateChart } from '../../../sdk/adapty/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand, compareFlags, compareParams, csvFlag, filterFlags, granularityFlag, groupByFlag, groupingParams, periodFlags, queryParams, revenueBasisFlag, } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { analyticsView, chartTable } from '../../views/analytics/human.js';
+import { csvNotice } from '../../views/analytics/segments.js';
+export default class AnalyticsChart extends AdaptyCommand {
+    static 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';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        chart: Flags.string({
+            description: 'The chart, as `adapty analytics catalog` lists it',
+            required: true,
+        }),
+        ...periodFlags,
+        ...compareFlags,
+        ...groupByFlag,
+        ...filterFlags,
+        ...granularityFlag('The period of one point (default month)'),
+        ...revenueBasisFlag,
+        ...csvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsChart);
+        const input = {
+            ...queryParams(flags),
+            chartId: flags.chart,
+            ...compareParams(flags),
+            ...groupingParams(flags),
+            revenueBasis: flags['revenue-basis'],
+        };
+        // Before this.adapty: bad input is exit 2 even without a token
+        assertValid(validateChart(input));
+        const answer = await this.adapty.analytics.chart(input);
+        this.render(answer, analyticsView(flags.csv, chartTable));
+        // Beside a CSV of a period without data, its summary; an empty text otherwise
+        process.stderr.write(csvNotice(answer, flags.csv));
+        return answer;
+    }
+}

package/dist/cli/commands/analytics/cohort.d.ts

@@ -0,0 +1,19 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { CohortResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsCohort extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'period-type': import("@oclif/core/interfaces").OptionFlag<"renewals" | "days" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'renewal-days': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        granularity: import("@oclif/core/interfaces").OptionFlag<"day" | "week" | "month" | "quarter" | "year" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<import("../../../sdk/adapty/index.js").AnalyticsFilter[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timezone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CohortResponse>;
+}

package/dist/cli/commands/analytics/cohort.js

@@ -0,0 +1,40 @@
+import { validateCohort } from '../../../sdk/adapty/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand, csvFlag, filterFlags, granularityFlag, groupingParams, periodFlags, queryParams, renewalPeriodFlags, revenueBasisFlag, } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { analyticsView, cohortTable } from '../../views/analytics/human.js';
+import { csvNotice } from '../../views/analytics/segments.js';
+export default class AnalyticsCohort extends AdaptyCommand {
+    static 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)';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        ...periodFlags,
+        ...filterFlags,
+        ...granularityFlag('The length of one cohort (default month)'),
+        ...revenueBasisFlag,
+        ...renewalPeriodFlags,
+        ...csvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsCohort);
+        const input = {
+            ...queryParams(flags),
+            ...groupingParams(flags),
+            periodType: flags['period-type'],
+            renewalDays: flags['renewal-days'],
+            revenueBasis: flags['revenue-basis'],
+        };
+        // Before this.adapty: bad input is exit 2 even without a token
+        assertValid(validateCohort(input));
+        const answer = await this.adapty.analytics.cohort(input);
+        this.render(answer, analyticsView(flags.csv, cohortTable));
+        // Beside a CSV of a period without data, its summary; an empty text otherwise
+        process.stderr.write(csvNotice(answer, flags.csv));
+        return answer;
+    }
+}

package/dist/cli/commands/analytics/conversion.d.ts

@@ -0,0 +1,20 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ConversionResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsConversion extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        granularity: import("@oclif/core/interfaces").OptionFlag<"day" | "week" | "month" | "quarter" | "year" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<import("../../../sdk/adapty/index.js").AnalyticsFilter[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timezone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'compare-from': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'compare-to': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        conversion: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ConversionResponse>;
+}

package/dist/cli/commands/analytics/conversion.js

@@ -0,0 +1,44 @@
+import { Flags } from '@oclif/core';
+import { validateConversion } from '../../../sdk/adapty/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand, compareFlags, compareParams, csvFlag, filterFlags, granularityFlag, groupByFlag, groupingParams, periodFlags, queryParams, } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { analyticsView, conversionTable } from '../../views/analytics/human.js';
+import { csvNotice } from '../../views/analytics/segments.js';
+export default class AnalyticsConversion extends AdaptyCommand {
+    static 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';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        conversion: Flags.string({
+            description: 'The conversion, as `adapty analytics catalog` lists it',
+            required: true,
+        }),
+        ...periodFlags,
+        ...compareFlags,
+        ...groupByFlag,
+        ...filterFlags,
+        ...granularityFlag('The period of one point (default day)'),
+        ...csvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsConversion);
+        const input = {
+            ...queryParams(flags),
+            ...compareParams(flags),
+            conversionId: flags.conversion,
+            ...groupingParams(flags),
+        };
+        // Before this.adapty: bad input is exit 2 even without a token
+        assertValid(validateConversion(input));
+        const answer = await this.adapty.analytics.conversion(input);
+        this.render(answer, analyticsView(flags.csv, conversionTable));
+        // Beside a CSV of a period without data, its summary; an empty text otherwise
+        process.stderr.write(csvNotice(answer, flags.csv));
+        return answer;
+    }
+}

package/dist/cli/commands/analytics/funnel.d.ts

@@ -0,0 +1,16 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { FunnelResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsFunnel extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        filter: import("@oclif/core/interfaces").OptionFlag<import("../../../sdk/adapty/index.js").AnalyticsFilter[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timezone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<FunnelResponse>;
+}

package/dist/cli/commands/analytics/funnel.js

@@ -0,0 +1,32 @@
+import { validateFunnel } from '../../../sdk/adapty/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand, csvFlag, filterFlags, groupByFlag, groupingParams, periodFlags, queryParams, } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { analyticsView, funnelTable } from '../../views/analytics/human.js';
+import { csvNotice } from '../../views/analytics/segments.js';
+export default class AnalyticsFunnel extends AdaptyCommand {
+    static 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)';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        ...periodFlags,
+        ...groupByFlag,
+        ...filterFlags,
+        ...csvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsFunnel);
+        const input = { ...queryParams(flags), ...groupingParams(flags) };
+        // Before this.adapty: bad input is exit 2 even without a token
+        assertValid(validateFunnel(input));
+        const answer = await this.adapty.analytics.funnel(input);
+        this.render(answer, analyticsView(flags.csv, funnelTable));
+        // Beside a CSV of a period without data, its summary; an empty text otherwise
+        process.stderr.write(csvNotice(answer, flags.csv));
+        return answer;
+    }
+}

package/dist/cli/commands/analytics/ltv.d.ts

@@ -0,0 +1,19 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { LtvResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsLtv extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'period-type': import("@oclif/core/interfaces").OptionFlag<"renewals" | "days" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'renewal-days': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<import("../../../sdk/adapty/index.js").AnalyticsFilter[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timezone: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-from': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<LtvResponse>;
+}