adapty 0.11.0 → 0.13.0

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

@@ -0,0 +1,40 @@
+import { validateLtv } from '../../../sdk/adapty/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand, csvFlag, filterFlags, groupByFlag, groupingParams, periodFlags, queryParams, renewalPeriodFlags, revenueBasisFlag, } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { analyticsView, ltvTable } from '../../views/analytics/human.js';
+import { csvNotice } from '../../views/analytics/segments.js';
+export default class AnalyticsLtv extends AdaptyCommand {
+    static 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)';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        ...periodFlags,
+        ...groupByFlag,
+        ...filterFlags,
+        ...revenueBasisFlag,
+        ...renewalPeriodFlags,
+        ...csvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsLtv);
+        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(validateLtv(input));
+        const answer = await this.adapty.analytics.ltv(input);
+        this.render(answer, analyticsView(flags.csv, ltvTable));
+        // 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/retention.d.ts

@@ -0,0 +1,17 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { RetentionResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsRetention extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'use-trial': 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<RetentionResponse>;
+}

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

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { validateRetention } 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, retentionTable } from '../../views/analytics/human.js';
+import { csvNotice } from '../../views/analytics/segments.js';
+export default class AnalyticsRetention extends AdaptyCommand {
+    static description = 'Read the retention of an app: the subscribers left in each period, per group, '
+        + 'the total first (no compared period)';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        ...periodFlags,
+        ...groupByFlag,
+        ...filterFlags,
+        'use-trial': Flags.boolean({
+            description: 'Count from the trial, not from the first paid period',
+        }),
+        ...csvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsRetention);
+        const input = {
+            ...queryParams(flags),
+            ...groupingParams(flags),
+            // Sent only when given: the backend default (false) applies otherwise, and meta.query says so
+            useTrial: flags['use-trial'] ? true : undefined,
+        };
+        // Before this.adapty: bad input is exit 2 even without a token
+        assertValid(validateRetention(input));
+        const answer = await this.adapty.analytics.retention(input);
+        this.render(answer, analyticsView(flags.csv, retentionTable));
+        // 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/values.d.ts

@@ -0,0 +1,11 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { FilterValuesResponse } from '../../../sdk/adapty/index.js';
+export default class AnalyticsValues extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dimension: 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<FilterValuesResponse>;
+}

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

@@ -0,0 +1,33 @@
+import { Flags } from '@oclif/core';
+import { validateFilterValues } from '../../../sdk/adapty/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+/** The value first, as `--filter <dimension>=<value>` takes it; an empty value is shown as `""`. */
+const describeValue = (item) => `${item.value === '' ? '""' : item.value}: ${item.label}${item.group === null ? '' : ` (${item.group})`}`;
+const renderValues = ({ data, meta }) => (data.length === 0
+    ? `No ${meta.dimension} values for this app.`
+    : data.map(item => describeValue(item)).join('\n'));
+export default class AnalyticsValues extends AdaptyCommand {
+    static description = 'List the values one analytics filter takes for an app: what --filter accepts';
+    static examples = [
+        '<%= config.bin %> analytics values --app APP_UUID --dimension country',
+        '<%= config.bin %> analytics values --app APP_UUID --dimension store_product_id --json',
+    ];
+    static flags = {
+        ...appIdFlag,
+        dimension: Flags.string({
+            description: 'A filter dimension, as `adapty analytics catalog` lists it under Dimensions',
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AnalyticsValues);
+        const input = { appId: flags.app, dimension: flags.dimension };
+        // Before this.adapty: bad input is exit 2 even without a token
+        assertValid(validateFilterValues(input));
+        const values = await this.adapty.analytics.values(input);
+        this.render(values, renderValues);
+        return values;
+    }
+}

package/dist/cli/commands/attribution/report/command.js

@@ -4,20 +4,15 @@ import { assertValid } from '../../../../sdk/core/validation.js';
 import { AttributionCommand, periodFlags, periodParams, revenueBasisFlag } from '../../../base/attribution/index.js';
 import { usageError } from '../../../errors.js';
 import { appIdFlag } from '../../../input/app.js';
+import { splitFilter } from '../../../input/filter.js';
 import { renderReport } from './lib/render.js';
-/** A comma not preceded by a backslash: `\,` keeps a comma inside a value, as oclif's own delimiter does. */
-const VALUE_SEPARATOR = /(?<!\\),/;
-/** `dimension=value[,value]`: one value filters by equality, several by any of them. */
+/** `dimension=value[,value]`: one value filters by equality, several by any; values trimmed, empties dropped. */
 const parseFilter = (input) => {
-    const separator = input.indexOf('=');
-    const dimension = separator === -1 ? '' : input.slice(0, separator).trim();
-    const values = separator === -1
-        ? []
-        : input.slice(separator + 1).split(VALUE_SEPARATOR).map(value => value.replaceAll('\\,', ',').trim())
-            .filter(value => value !== '');
-    return dimension === '' || values.length === 0
+    const filter = splitFilter(input);
+    const values = filter?.values.map(value => value.trim()).filter(value => value !== '') ?? [];
+    return filter === undefined || values.length === 0
         ? Promise.reject(usageError(`Expected dimension=value[,value], got "${input}".`))
-        : Promise.resolve({ dimension, values });
+        : Promise.resolve({ dimension: filter.dimension, values });
 };
 const isDirection = (value) => sortDirections.includes(value);
 /** `field[:asc|desc]`, ascending when the direction is left out. */

package/dist/cli/commands/product-offers/create.d.ts

@@ -0,0 +1,15 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersCreate extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<"promotional" | "win_back", import("@oclif/core/interfaces").CustomOptions>;
+        'ios-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'android-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        product: 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<ProductOffer>;
+}

package/dist/cli/commands/product-offers/create.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { offerTypes } from '../../../sdk/adapty/index.js';
+import { validateCreateProductOffer } from '../../../sdk/adapty/product-offers/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { productFlag } from '../../input/product.js';
+import { renderRecord } from '../../views/record.js';
+export default class ProductOffersCreate extends AdaptyCommand {
+    static description = 'Create an offer for a product';
+    static 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',
+    ];
+    static flags = {
+        ...appIdFlag,
+        ...productFlag,
+        'title': Flags.string({ description: 'Offer title', required: true }),
+        'type': Flags.option({
+            description: 'Offer type (win_back is App Store only)',
+            options: offerTypes,
+            required: true,
+        })(),
+        'ios-offer-id': Flags.string({ description: 'App Store offer ID' }),
+        'android-offer-id': Flags.string({ description: 'Google Play offer ID' }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProductOffersCreate);
+        const input = {
+            androidOfferId: flags['android-offer-id'],
+            iosOfferId: flags['ios-offer-id'],
+            offerType: flags.type,
+            title: flags.title,
+        };
+        assertValid(validateCreateProductOffer(input));
+        const offer = await this.adapty.productOffers.create(flags.app, flags.product, input);
+        this.log('Offer created!');
+        this.render(offer, renderRecord);
+        return offer;
+    }
+}

package/dist/cli/commands/product-offers/get.d.ts

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

package/dist/cli/commands/product-offers/get.js

@@ -0,0 +1,16 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { offerIdArg } from '../../input/offer.js';
+import { renderRecord } from '../../views/record.js';
+export default class ProductOffersGet extends AdaptyCommand {
+    static description = 'Get a product offer';
+    static examples = ['<%= config.bin %> product-offers get 770e8400-... --app 550e8400-...'];
+    static args = { ...offerIdArg };
+    static flags = { ...appIdFlag };
+    async run() {
+        const { args, flags } = await this.parse(ProductOffersGet);
+        const offer = await this.adapty.productOffers.get(flags.app, args.offer_id);
+        this.render(offer, renderRecord);
+        return offer;
+    }
+}

package/dist/cli/commands/product-offers/list.d.ts

@@ -0,0 +1,11 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { Paginated, ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersList extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        product: 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<Paginated<ProductOffer>>;
+}

package/dist/cli/commands/product-offers/list.js

@@ -0,0 +1,15 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { productFlag } from '../../input/product.js';
+import { renderPage } from '../../views/list.js';
+export default class ProductOffersList extends AdaptyCommand {
+    static description = 'List the offers of a product (all on one page)';
+    static examples = ['<%= config.bin %> product-offers list --app 550e8400-... --product 660e8400-...'];
+    static flags = { ...appIdFlag, ...productFlag };
+    async run() {
+        const { flags } = await this.parse(ProductOffersList);
+        const page = await this.adapty.productOffers.list(flags.app, flags.product);
+        this.render(page, renderPage);
+        return page;
+    }
+}

package/dist/cli/commands/product-offers/update.d.ts

@@ -0,0 +1,20 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersUpdate extends AdaptyCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        offer_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<"promotional" | "win_back" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ios-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'android-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'clear-ios-offer-id': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'clear-android-offer-id': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ProductOffer>;
+}

package/dist/cli/commands/product-offers/update.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { offerTypes } from '../../../sdk/adapty/index.js';
+import { validateUpdateProductOffer } from '../../../sdk/adapty/product-offers/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { offerIdArg } from '../../input/offer.js';
+import { renderRecord } from '../../views/record.js';
+export default class ProductOffersUpdate extends AdaptyCommand {
+    static summary = 'Update a product offer';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --title "Spring 2"',
+        '<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --clear-android-offer-id',
+    ];
+    static args = { ...offerIdArg };
+    static flags = {
+        ...appIdFlag,
+        'title': Flags.string({ description: 'Offer title' }),
+        'type': Flags.option({ description: 'Offer type (win_back is App Store only: clear the Google Play side too)', options: offerTypes })(),
+        'ios-offer-id': Flags.string({ description: 'App Store offer ID', exclusive: ['clear-ios-offer-id'] }),
+        'android-offer-id': Flags.string({ description: 'Google Play offer ID', exclusive: ['clear-android-offer-id'] }),
+        'clear-ios-offer-id': Flags.boolean({ description: 'Remove the App Store side of the offer' }),
+        'clear-android-offer-id': Flags.boolean({ description: 'Remove the Google Play side of the offer' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProductOffersUpdate);
+        const input = {
+            androidOfferId: flags['clear-android-offer-id'] ? null : flags['android-offer-id'],
+            iosOfferId: flags['clear-ios-offer-id'] ? null : flags['ios-offer-id'],
+            offerType: flags.type,
+            title: flags.title,
+        };
+        assertValid(validateUpdateProductOffer(input));
+        const offer = await this.adapty.productOffers.update(flags.app, args.offer_id, input);
+        this.log('Offer updated!');
+        this.render(offer, renderRecord);
+        return offer;
+    }
+}

package/dist/cli/errors.js

@@ -88,7 +88,14 @@ export const describeCleanupFailures = (files, results) => {
 };
 /** Issue.path is a camelCase sdk field; the user typed a kebab-case flag. */
 const flagName = (path) => `--${path.replace(/[A-Z]/g, char => `-${char.toLowerCase()}`)}`;
-const describeIssue = (issue) => (issue.path === undefined ? issue.message : `${flagName(issue.path)}: ${issue.message}`);
+/**
+ * A rule names another input field as `{fieldName}` and lists it in `fields`: the user reads the flag they would
+ * type. Only the listed names are written, so other braces in a message stay as they are.
+ */
+const describeIssue = (issue) => {
+    const message = (issue.fields ?? []).reduce((text, field) => text.replaceAll(`{${field}}`, flagName(field)), issue.message);
+    return issue.path === undefined ? message : `${flagName(issue.path)}: ${message}`;
+};
 /**
  * The one place where an sdk error gets a human text and an exit code. No default in the switch:
  * a new kind fails to compile until it is mapped here.

package/dist/cli/input/app.js

@@ -1,17 +1,7 @@
 import { Args, Flags } from '@oclif/core';
-import { usageError } from '../errors.js';
-const UUID_PATTERN = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+import { uuidParser } from './uuid.js';
 /** The published wording of both the `app_id` arg and the `--app` flag. */
 const APP_ID_HINT = 'Invalid app ID format. Run `adapty apps list` to find your app ID.';
-const isUuid = (value) => UUID_PATTERN.test(value);
-/**
- * Checking the shape of a value is the parser's job, so a run() never starts with one. oclif turns
- * a *flag* parser's failure into exit 2 itself but passes an *arg* parser's error through, hence
- * the explicit code. The hint is per resource: `adapty apps list` only helps for an app id.
- */
-const uuidParser = (hint) => (input) => (isUuid(input)
-    ? Promise.resolve(input)
-    : Promise.reject(usageError(hint)));
 /** Spread into a command: `static args = { ...appIdArg }`. Texts kept as published. */
 export const appIdArg = {
     app_id: Args.string({

package/dist/cli/input/filter.d.ts

@@ -0,0 +1,11 @@
+/** One `--filter`: a dimension and the values it may take (one value is equality, several any of them). */
+export type DimensionFilter = {
+    dimension: string;
+    values: string[];
+};
+/**
+ * `dimension=value[,value]` split as written: the dimension before the first `=`, trimmed; every value after it
+ * as typed, `\,` turned into a comma. Undefined without `=` or without a dimension. What a product does with
+ * spaces and empty values is its own rule, so its flag parser decides that.
+ */
+export declare const splitFilter: (input: string) => DimensionFilter | undefined;

package/dist/cli/input/filter.js

@@ -0,0 +1,16 @@
+/** A comma not preceded by a backslash: `\,` keeps a comma inside a value, as oclif's own delimiter does. */
+const VALUE_SEPARATOR = /(?<!\\),/;
+/**
+ * `dimension=value[,value]` split as written: the dimension before the first `=`, trimmed; every value after it
+ * as typed, `\,` turned into a comma. Undefined without `=` or without a dimension. What a product does with
+ * spaces and empty values is its own rule, so its flag parser decides that.
+ */
+export const splitFilter = (input) => {
+    const separator = input.indexOf('=');
+    const dimension = separator === -1 ? '' : input.slice(0, separator).trim();
+    if (dimension === '') {
+        return undefined;
+    }
+    const values = input.slice(separator + 1).split(VALUE_SEPARATOR).map(value => value.replaceAll('\\,', ','));
+    return { dimension, values };
+};

package/dist/cli/input/offer.d.ts

@@ -0,0 +1,3 @@
+export declare const offerIdArg: {
+    offer_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+};

package/dist/cli/input/offer.js

@@ -0,0 +1,9 @@
+import { Args } from '@oclif/core';
+import { uuidParser } from './uuid.js';
+export const offerIdArg = {
+    offer_id: Args.string({
+        description: 'Offer ID (UUID)',
+        parse: uuidParser('Invalid offer ID format.'),
+        required: true,
+    }),
+};

package/dist/cli/input/period.d.ts

@@ -0,0 +1,10 @@
+/** The shape only: whether the day exists and the order of the two are sdk rules. */
+export declare const dateParser: (input: string) => Promise<string>;
+/**
+ * An inclusive day range, both ends required. `zone` completes the help text: which time zone the days are in,
+ * the one thing the products say differently.
+ */
+export declare const dayRangeFlags: (zone: string) => {
+    '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>;
+};

package/dist/cli/input/period.js

@@ -0,0 +1,23 @@
+import { Flags } from '@oclif/core';
+import { ISO_DATE } from '../../sdk/core/dates.js';
+import { usageError } from '../errors.js';
+/** The shape only: whether the day exists and the order of the two are sdk rules. */
+export const dateParser = (input) => (ISO_DATE.test(input)
+    ? Promise.resolve(input)
+    : Promise.reject(usageError('Dates must be written as YYYY-MM-DD.')));
+/**
+ * An inclusive day range, both ends required. `zone` completes the help text: which time zone the days are in,
+ * the one thing the products say differently.
+ */
+export const dayRangeFlags = (zone) => ({
+    'date-from': Flags.string({
+        description: `First day of the period, inclusive (YYYY-MM-DD, ${zone})`,
+        parse: dateParser,
+        required: true,
+    }),
+    'date-to': Flags.string({
+        description: `Last day of the period, inclusive (YYYY-MM-DD, ${zone})`,
+        parse: dateParser,
+        required: true,
+    }),
+});

package/dist/cli/input/product.d.ts

@@ -0,0 +1,3 @@
+export declare const productFlag: {
+    product: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};

package/dist/cli/input/product.js

@@ -0,0 +1,9 @@
+import { Flags } from '@oclif/core';
+import { uuidParser } from './uuid.js';
+export const productFlag = {
+    product: Flags.string({
+        description: 'Product ID (UUID)',
+        parse: uuidParser('Invalid product ID format.'),
+        required: true,
+    }),
+};

package/dist/cli/input/uuid.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Checking the shape of a value is the parser's job, so a run() never starts with one. oclif turns
+ * a *flag* parser's failure into exit 2 itself but passes an *arg* parser's error through, hence
+ * the explicit code. The hint is per resource: `adapty apps list` only helps for an app id.
+ */
+export declare const uuidParser: (hint: string) => (input: string) => Promise<string>;

package/dist/cli/input/uuid.js

@@ -0,0 +1,11 @@
+import { usageError } from '../errors.js';
+const UUID_PATTERN = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+const isUuid = (value) => UUID_PATTERN.test(value);
+/**
+ * Checking the shape of a value is the parser's job, so a run() never starts with one. oclif turns
+ * a *flag* parser's failure into exit 2 itself but passes an *arg* parser's error through, hence
+ * the explicit code. The hint is per resource: `adapty apps list` only helps for an app id.
+ */
+export const uuidParser = (hint) => (input) => (isUuid(input)
+    ? Promise.resolve(input)
+    : Promise.reject(usageError(hint)));

package/dist/cli/views/analytics/csv.d.ts

@@ -0,0 +1,3 @@
+/** What a CSV cell can hold: the scalar values of an API answer. */
+export type Cell = boolean | null | number | string | undefined;
+export declare const csvLine: (cells: readonly Cell[]) => string;

package/dist/cli/views/analytics/csv.js

@@ -0,0 +1,16 @@
+/**
+ * RFC 4180: a field with a comma, a double quote or a line break goes in double quotes, and a quote inside is
+ * doubled. A missing value (null) is an empty cell, so it never reads as 0; an empty text (a group key, for
+ * example) is `""`, so it never reads as a missing one.
+ */
+const csvCell = (value) => {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (value === '') {
+        return '""';
+    }
+    const text = String(value);
+    return /[",\n\r]/.test(text) ? `"${text.replaceAll('"', '""')}"` : text;
+};
+export const csvLine = (cells) => cells.map(cell => csvCell(cell)).join(',');

package/dist/cli/views/analytics/human.d.ts

@@ -0,0 +1,41 @@
+import type { AnalyticsAnswer } from './segments.js';
+/**
+ * The human view of the six analytics operations: a short table, one row per group (the total first), the main
+ * numbers of the group and one column per point (a date, a funnel step, a period). The resolved query gives the
+ * heading. Where an operation has more fields than one table holds, a line under it says that `--json` and
+ * `--csv` give every field.
+ */
+type Query = Record<string, unknown>;
+/** How a number reads: money with 2 decimals, any other number as the API gives it, null as `—`. */
+type Format = (value: unknown) => string;
+/** One number of a group: its header and the segment field it shows. */
+type Column = {
+    field: string;
+    format: Format;
+    header: string;
+};
+export type HumanTable = {
+    /** The numbers of a group after its title, the main value first. */
+    columns: (query: Query) => Column[];
+    /** The fields the table leaves out; none when it shows every number of the answer. */
+    omitted?: string;
+    /** How the value of a point reads. */
+    points: (query: Query) => Format;
+    /** What the answer is, from the resolved query: the operation, then its options. */
+    title: (query: Query) => (string | undefined)[];
+};
+export declare const chartTable: HumanTable;
+export declare const conversionTable: HumanTable;
+export declare const funnelTable: HumanTable;
+export declare const retentionTable: HumanTable;
+export declare const ltvTable: HumanTable;
+export declare const cohortTable: HumanTable;
+/**
+ * The heading (what, by which grouping; the period, its time zone and filters), then the table of the asked
+ * period and, when there is one, of the compared period. A period without groups: `No data for this period.` and
+ * the summary of that period, every field, null as `—`.
+ */
+export declare const humanView: (spec: HumanTable) => (answer: AnalyticsAnswer) => string;
+/** The view of a data command: the CSV with `--csv`, else the human table (`--json` prints no view at all). */
+export declare const analyticsView: (csv: boolean, spec: HumanTable) => (answer: AnalyticsAnswer) => string;
+export {};