adapty 0.8.9 → 0.9.1

package/README.md

@@ -33,8 +33,8 @@ Other auth commands:
 ```sh
 adapty auth whoami     # verify token, show user info
 adapty auth status     # show local auth state
-adapty auth logout     # clear stored token (local only)
-adapty auth revoke     # revoke active token and clear any matching stored session
+adapty auth logout     # clear stored credentials and migration selection (local only)
+adapty auth revoke     # revoke active token and clear matching credentials and selection
 ```
 
 `auth revoke` uses `ADAPTY_TOKEN` when set, otherwise the stored token. A different token in the
@@ -42,6 +42,14 @@ session file is preserved. After revoking an environment token, unset `ADAPTY_TO
 stored session will then become active again. With no token, revoke succeeds without a request
 and returns `{"status":"not_authenticated"}` under `--json`.
 
+`auth logout` removes the saved migration selection even without stored credentials or with a
+malformed context. `auth revoke` removes selection only after server success and only when it
+belongs to the revoked token. Failed revocation preserves both files. Both cleanup operations
+are attempted independently; incomplete cleanup returns exit 1 (`auth_cleanup_failed`). If the
+server already revoked the token, the error says so: fix local files without repeating revocation.
+Environment variables remain in the parent shell; unset `ADAPTY_TOKEN` and `ADAPTY_MIGRATION`
+there when needed.
+
 ## Commands
 
 All resource commands require `--app APP_ID` (UUID). Use `adapty apps list` to find your app ID.
@@ -105,6 +113,142 @@ adapty access-levels create --app UUID [flags]
 adapty access-levels update --app UUID ACCESS_LEVEL_ID [flags]
 ```
 
+### Migrations
+
+Manage migrations into Adapty: catalog, transactions and store events. The server provides the
+steps, available actions and input schemas; use the current response to choose what to do next.
+
+#### Start or find a migration
+
+```sh
+adapty migrations list
+adapty migrations create --name "Acme Fitness" --json
+```
+
+`--name` starts a catalog migration into a new Adapty app. For an existing app, choose a flow and
+its app from `list` and pass both flags (replace `FLOW` and `APP_ID` with those values):
+
+```sh
+adapty migrations create --flow FLOW --app APP_ID --json
+```
+
+These are alternative creation modes: `--name` cannot be combined with `--flow` or `--app`.
+Creation starts the flow and saves it as current; the returned JSON contains its ID in `migration.id`.
+Use `--no-select` to create without changing the saved selection. If creation succeeds but saving
+fails, the command still succeeds and prints a warning with the explicit continuation command.
+
+Commands choose a migration in this order: `-m, --migration`, non-empty `ADAPTY_MIGRATION`,
+then the saved selection for the current token. Explicit IDs do not change the saved selection.
+Replace `mig_7x2` below with an ID from `create` or `list`; agents should pass `-m` explicitly.
+
+#### Manage a saved selection
+
+```sh
+adapty migrations use mig_7x2
+adapty migrations current --json
+adapty migrations unuse
+```
+
+`use` verifies access through the API, then saves the returned ID for the current token.
+`current` reads the effective selection locally: `ADAPTY_MIGRATION` takes precedence over the
+saved context. `unuse` removes the saved selection without authentication; an environment override
+must be unset in your shell. Changing tokens makes the previous token's selection inapplicable.
+
+The selection is shared across terminals and survives restarting the CLI. After `use` or `create`,
+you can run `adapty migrations status`, `steps`, `show`, `run` or `close` without `-m`.
+An operation keeps its initially selected ID even if another terminal changes the selection.
+`run` and `close` print the target on stderr before a mutation that uses saved selection.
+Scripts should pass explicit IDs and use `create --no-select` to preserve the shared default.
+
+#### Inspect and run an action
+
+```sh
+adapty migrations status -m mig_7x2 --json
+adapty migrations steps -m mig_7x2
+adapty migrations show -m mig_7x2
+```
+
+`steps` shows the checklist. `show` lists readable resource names; pass one as `RESOURCE` to read
+its data. Choose `ACTION_ID` from `next_actions` or `available_actions` in the status response.
+For an input action, read its `reads` resources and prepare a JSON object matching `input_schema`:
+
+```sh
+adapty migrations show RESOURCE -m mig_7x2
+adapty migrations run ACTION_ID -m mig_7x2 --input-file ./decisions.json --json
+```
+
+Alternatively, use `--input-file -` with stdin (`< ./decisions.json`), or `--input '{}'` if the
+schema allows an empty object. Omitting input also sends `{}`. Use only one input option.
+
+Read the action's full `confirm` text in `status` or `status --json` before adding `--yes`. Input actions
+requiring confirmation exit **6** without it; there is no interactive prompt. The CLI reads
+status before refusing, but does not send the action request. After an action, check status again.
+After `revision_conflict`, read status and review the current action, input and confirmation before retrying.
+
+For an `external` action, complete the step in the browser, then check status:
+
+```sh
+adapty migrations run ACTION_ID -m mig_7x2 --no-browser
+```
+
+`--no-browser` prints the action details and link. By default, the browser opens in an interactive
+terminal; pipes and `--json` require `--open`. `BROWSER=none` disables opening, and only HTTPS
+links are supported. External actions do not send an action request; their JSON response reflects
+the migration before the browser step. Passing `--input` or `--input-file` to an external action
+returns a usage error (exit 2). File uploads are marked unsupported in `status`: use the dashboard or an
+offered Cloud Export action. `list --all` is also unsupported.
+
+#### Wait for a change or close a migration
+
+```sh
+adapty migrations status -m mig_7x2 --wait --timeout 5m --json
+```
+
+`--wait` returns when the revision changes, the state is no longer `running`, or the polling budget
+cannot accommodate another pause. `--timeout` requires `--wait`: default 120s, range 1–600s,
+with formats such as `300`, `300s` or `5m`. In-flight requests and retries may take longer.
+Exit **0** means the request succeeded, even when the migration is still running or has failed;
+inspect `migration.state`. Progress goes to stderr; Ctrl+C exits **130**.
+
+To permanently mark a migration as completed:
+
+```sh
+adapty migrations close -m mig_7x2 --outcome finish --yes
+```
+
+To abandon it instead:
+
+```sh
+adapty migrations close -m mig_7x2 --outcome cancel --yes
+```
+
+Both outcomes require `--yes`; there is no confirmation prompt.
+
+#### JSON output
+
+With `--json`, `list` returns `{items, available}`. All other migration commands return the full
+migration response (the envelope):
+
+| Data | JSON field |
+| --- | --- |
+| Migration ID, state and revision | `migration` |
+| Next and optional actions | `next_actions`, `available_actions` |
+| Checklist | `steps` |
+| Readable resource names | `resources` |
+| Data from `show RESOURCE` | `result` (may be `null`) |
+
+Without `--json`, `show RESOURCE` prints just the resource data as JSON, or a message if empty.
+Wizard Service errors preserve `detail`, `fields`, `next_step`, `request_id`, `retryable` and
+`retry_after_seconds` under `error` in JSON when supplied. Human output includes details, field
+errors, the next step and request ID. Retry metadata in the response does not change automatic retry behavior.
+
+To extract specific fields from the full response, these examples require the separate `jq` utility:
+
+```sh
+adapty migrations steps -m mig_7x2 --json | jq '.steps'
+adapty migrations show RESOURCE -m mig_7x2 --json | jq '.result'
+```
+
 ### Apple Search Ads
 
 Apple Search Ads commands live under `adapty asa` and talk to the ASA service rather than the Developer
@@ -457,6 +601,7 @@ the flags and the size ceiling.
 | `ADAPTY_TOKEN`       | Override stored auth token                                                              |
 | `ADAPTY_API_URL`     | Override Developer API base URL (default: `https://api-admin.adapty.io/api/v1/developer`) |
 | `ADAPTY_ASA_API_URL` | Override Apple Search Ads base URL (default: `https://api-asa-admin.adapty.io/api/v1/cli`) |
+| `ADAPTY_MIGRATION`   | Migration id used by `adapty migrations` when `-m` is not given                          |
 | `ADAPTY_ATTRIBUTION_API_URL` | Override attribution base URL (default: `https://api-ua.adapty.io/api/v1/cli`) |
 | `ADAPTY_APP_URL`     | Override dashboard base URL (default: `https://app.adapty.io`). Used by `flows config preview` for the fixed `/flow-preview` route, and by `auth login` to keep the verification link on that host |
 

package/dist/cli/base/adapty/adapty-command.d.ts

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../base-command.js';
 import type { Adapty } from '../../../sdk/adapty/index.js';
-import type { AuthenticatedSession } from '../session.js';
+import type { AuthenticatedSession, ResolvedSession } from '../session.js';
 /**
  * Commands that require a token; auth commands other than `whoami` also work without one.
  *
@@ -10,8 +10,9 @@ import type { AuthenticatedSession } from '../session.js';
  */
 export declare abstract class AdaptyCommand extends BaseCommand {
     #private;
-    static enableJsonFlag: boolean;
     protected get adapty(): Adapty;
+    /** Effective session without enforcing auth, for local input resolution before SDK access. */
+    protected get resolvedSession(): ResolvedSession;
     /** Narrowed once here, so nothing downstream re-checks the token. */
     protected get session(): AuthenticatedSession;
     protected init(): Promise<void>;

package/dist/cli/base/adapty/adapty-command.js

@@ -10,27 +10,30 @@ import { openSession } from './openSession.js';
  * branch into all 75 commands, and one of them would forget it.
  */
 export class AdaptyCommand extends BaseCommand {
-    // Keep one own static so oclif's manifest cache walks through this intermediate class and
-    // includes statics inherited from BaseCommand.
-    static enableJsonFlag = true;
     #adapty;
     #resolved;
     get adapty() {
         this.#adapty ??= build(this.session, {
             config: this.config,
+            interactive: this.interactive,
             signal: this.signal,
             warn: message => this.warn(message),
         });
         return this.#adapty;
     }
-    /** Narrowed once here, so nothing downstream re-checks the token. */
-    get session() {
+    /** Effective session without enforcing auth, for local input resolution before SDK access. */
+    get resolvedSession() {
         const resolved = this.#resolved;
         if (resolved === undefined) {
             // A bug, not a user error, and deliberately not an SdkError: it lands as exit 1 with a
             // stack instead of passing for a normal scenario.
             throw new Error('session is available only after init()');
         }
+        return resolved;
+    }
+    /** Narrowed once here, so nothing downstream re-checks the token. */
+    get session() {
+        const resolved = this.resolvedSession;
         if (resolved.token === undefined) {
             throw new AuthRequiredError('missing');
         }

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

@@ -1,5 +1,10 @@
 import type { Adapty } from '../../../sdk/adapty/index.js';
 import type { CommandContext } from '../base-command.js';
 import type { ResolvedSession } from '../session.js';
+/** The Adapty sdk also tells the server whether a person is watching (`X-Adapty-Interactive`). */
+type AdaptyCommandContext = CommandContext & {
+    interactive: boolean;
+};
 /** Shared by authenticated commands and login/revoke, which can run without a token. */
-export declare const build: (session: ResolvedSession, context: CommandContext) => Adapty;
+export declare const build: (session: ResolvedSession, context: AdaptyCommandContext) => Adapty;
+export {};

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

@@ -3,6 +3,7 @@ import { createAdapty } from '../../../sdk/adapty/index.js';
 /** Shared by authenticated commands and login/revoke, which can run without a token. */
 export const build = (session, context) => createAdapty({
     baseUrl: session.apiUrl,
+    interactive: context.interactive,
     onRetry: ({ attempt, delayMs }) => {
         context.warn(`Request failed, retrying in ${delayMs / 1000}s (attempt ${attempt + 1})`);
     },

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

@@ -1,4 +1,5 @@
 export { AdaptyCommand } from './adapty-command.js';
 export { build } from './build.js';
+export { MigrationCommand } from './migration-command.js';
 export { openSession, resolveSession } from './openSession.js';
 export type { AuthenticatedSession, ResolvedSession } from '../session.js';

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

@@ -1,3 +1,4 @@
 export { AdaptyCommand } from './adapty-command.js';
 export { build } from './build.js';
+export { MigrationCommand } from './migration-command.js';
 export { openSession, resolveSession } from './openSession.js';

package/dist/cli/base/adapty/migration-command.d.ts

@@ -0,0 +1,11 @@
+import { AdaptyCommand } from './adapty-command.js';
+import type { CurrentMigration } from '../../context/migration/index.js';
+/**
+ * `AdaptyCommand` plus the saved migration selection. One topic out of ten stays a base of its own
+ * rather than a getter on `AdaptyCommand`, where all 75 commands would pay for it.
+ */
+export declare abstract class MigrationCommand extends AdaptyCommand {
+    #private;
+    /** A getter, not a field: field initializers run in the constructor, before init() has a session. */
+    protected get currentMigration(): CurrentMigration;
+}

package/dist/cli/base/adapty/migration-command.js

@@ -0,0 +1,17 @@
+import { openCurrentMigration } from '../../context/migration/index.js';
+import { AdaptyCommand } from './adapty-command.js';
+/**
+ * `AdaptyCommand` plus the saved migration selection. One topic out of ten stays a base of its own
+ * rather than a getter on `AdaptyCommand`, where all 75 commands would pay for it.
+ */
+export class MigrationCommand extends AdaptyCommand {
+    #current;
+    /** A getter, not a field: field initializers run in the constructor, before init() has a session. */
+    get currentMigration() {
+        this.#current ??= openCurrentMigration({
+            configDir: this.config.configDir,
+            session: this.resolvedSession,
+        });
+        return this.#current;
+    }
+}

package/dist/cli/base/base-command.d.ts

@@ -18,6 +18,12 @@ export declare abstract class BaseCommand extends Command {
     #private;
     /** --json is a property of the CLI, not a per-command opt-in; `auth login` opts back out. */
     static enableJsonFlag: boolean;
+    /**
+     * Whether a person is watching this run. --json means a program is reading, even from a
+     * terminal, and a pipe means one is reading whatever the flags say. The sdk sends the answer
+     * as `X-Adapty-Interactive`; `migrations run` asks it before opening a browser.
+     */
+    protected get interactive(): boolean;
     protected get signal(): AbortSignal;
     protected catch(error: Error): Promise<unknown>;
     protected toErrorJson(error: unknown): {

package/dist/cli/base/base-command.js

@@ -1,5 +1,11 @@
 import { Command } from '@oclif/core';
 import { CliError, toCliError } from '../errors.js';
+/**
+ * On a pipe Node leaves `isTTY` absent, not false, while @types/node promises a boolean. Taken at
+ * its word, a piped run answers `undefined` — a third answer to a two-answer question. The
+ * parameter type is the one place to say so.
+ */
+const attachedToTerminal = (stream) => stream.isTTY === true;
 /**
  * What every command gets and nothing more: the output channel, cancellation, the single place
  * where sdk errors become CLI errors. Product SDKs and sessions belong to their adapters.
@@ -16,6 +22,14 @@ export class BaseCommand extends Command {
     #onSigint = () => {
         this.#abort.abort();
     };
+    /**
+     * Whether a person is watching this run. --json means a program is reading, even from a
+     * terminal, and a pipe means one is reading whatever the flags say. The sdk sends the answer
+     * as `X-Adapty-Interactive`; `migrations run` asks it before opening a browser.
+     */
+    get interactive() {
+        return attachedToTerminal(process.stdout) && !this.jsonEnabled();
+    }
     get signal() {
         return this.#abort.signal;
     }

package/dist/cli/commands/apps/create.d.ts

@@ -5,7 +5,7 @@ export default class AppsCreate extends AdaptyCommand {
     static examples: string[];
     static flags: {
         title: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        platform: import("@oclif/core/interfaces").OptionFlag<("ios" | "android")[], import("@oclif/core/interfaces").CustomOptions>;
+        platform: import("@oclif/core/interfaces").OptionFlag<("android" | "ios")[], import("@oclif/core/interfaces").CustomOptions>;
         'apple-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'google-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/cli/commands/apps/get.js

@@ -1,5 +1,5 @@
 import { AdaptyCommand } from '../../base/adapty/index.js';
-import { appIdArg } from '../../flags.js';
+import { appIdArg } from '../../input/app.js';
 import { renderRecord } from '../../views/record.js';
 export default class AppsGet extends AdaptyCommand {
     static args = { ...appIdArg };

package/dist/cli/commands/apps/list.js

@@ -1,5 +1,5 @@
 import { AdaptyCommand } from '../../base/adapty/index.js';
-import { pageParams, paginationFlags } from '../../flags.js';
+import { pageParams, paginationFlags } from '../../input/pagination.js';
 import { renderPage } from '../../views/list.js';
 export default class AppsList extends AdaptyCommand {
     static description = 'List Adapty apps';

package/dist/cli/commands/apps/update.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { validateUpdateApp } from '../../../sdk/adapty/apps/index.js';
 import { assertValid } from '../../../sdk/core/validation.js';
 import { AdaptyCommand } from '../../base/adapty/index.js';
-import { appIdArg } from '../../flags.js';
+import { appIdArg } from '../../input/app.js';
 import { renderRecord } from '../../views/record.js';
 export default class AppsUpdate extends AdaptyCommand {
     static args = { ...appIdArg };

package/dist/cli/commands/attribution/report/command.d.ts

@@ -0,0 +1,18 @@
+import { AttributionCommand } from '../../../base/attribution/index.js';
+import type { ReportFilter, ReportResponse, ReportSort } from '../../../../sdk/attribution/index.js';
+export default class AttributionReport extends AttributionCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        sort: import("@oclif/core/interfaces").OptionFlag<ReportSort | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        metrics: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<("store" | "date" | "campaign" | "adset" | "ad" | "keyword" | "channel" | "country")[], 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<ReportFilter[] | 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<ReportResponse>;
+}

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

@@ -0,0 +1,93 @@
+import { Flags } from '@oclif/core';
+import { granularities, reportGroupBy, sortDirections, validateReport } from '../../../../sdk/attribution/index.js';
+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 { 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. */
+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
+        ? Promise.reject(usageError(`Expected dimension=value[,value], got "${input}".`))
+        : Promise.resolve({ dimension, values });
+};
+const isDirection = (value) => sortDirections.includes(value);
+/** `field[:asc|desc]`, ascending when the direction is left out. */
+const parseSort = (input) => {
+    const separator = input.lastIndexOf(':');
+    const field = (separator === -1 ? input : input.slice(0, separator)).trim();
+    const direction = separator === -1 ? 'asc' : input.slice(separator + 1).trim();
+    if (field === '') {
+        return Promise.reject(usageError(`Expected field[:asc|desc], got "${input}".`));
+    }
+    return isDirection(direction)
+        ? Promise.resolve({ direction, field })
+        : Promise.reject(usageError(`The sort direction must be asc or desc, got "${direction}".`));
+};
+export default class AttributionReport extends AttributionCommand {
+    static description = 'Run an Attribution report for an app: metrics over a period, grouped by dimensions';
+    static examples = [
+        '<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign',
+        '<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend --group-by date --granularity week --filter country=US,GB --sort spend:desc',
+        '<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign --json',
+    ];
+    // Input shape here; the rules (dates in order, a granularity exactly when grouping by date) live
+    // in sdk/attribution/report.ts, and which names exist is the backend catalog's knowledge.
+    static flags = {
+        ...appIdFlag,
+        ...periodFlags,
+        'metrics': Flags.string({
+            delimiter: ',',
+            description: 'Metric names, as `adapty attribution metrics` lists them (repeatable or comma-separated)',
+            multiple: true,
+            required: true,
+        }),
+        'group-by': Flags.option({
+            delimiter: ',',
+            description: 'Dimensions to group rows by (repeatable or comma-separated)',
+            multiple: true,
+            options: reportGroupBy,
+            required: true,
+        })(),
+        'granularity': Flags.option({
+            description: 'Date bucket; required with --group-by date, and allowed only with it',
+            options: granularities,
+        })(),
+        'filter': Flags.custom({
+            description: 'Keep rows whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value)',
+            multiple: true,
+            parse: parseFilter,
+        })(),
+        ...revenueBasisFlag,
+        'sort': Flags.custom({
+            description: 'Sort rows by a requested metric or dimension: field[:asc|desc] (ascending by default)',
+            parse: parseSort,
+        })(),
+    };
+    async run() {
+        const { flags } = await this.parse(AttributionReport);
+        const input = {
+            appId: flags.app,
+            ...periodParams(flags),
+            filters: flags.filter,
+            granularity: flags.granularity,
+            groupBy: flags['group-by'],
+            metrics: flags.metrics.filter(metric => metric !== ''),
+            revenueBasis: flags['revenue-basis'],
+            sort: flags.sort,
+        };
+        // Before this.attribution: bad input is exit 2 even without a token
+        assertValid(validateReport(input));
+        const report = await this.attribution.report(input);
+        this.render(report, renderReport);
+        return report;
+    }
+}

package/dist/cli/commands/attribution/report/index.d.ts

@@ -1,18 +1 @@
-import { AttributionCommand } from '../../../base/attribution/index.js';
-import type { ReportFilter, ReportResponse, ReportSort } from '../../../../sdk/attribution/index.js';
-export default class AttributionReport extends AttributionCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        sort: import("@oclif/core/interfaces").OptionFlag<ReportSort | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'revenue-basis': import("@oclif/core/interfaces").OptionFlag<"gross" | "proceeds" | "net" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        metrics: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
-        'group-by': import("@oclif/core/interfaces").OptionFlag<("store" | "date" | "campaign" | "adset" | "ad" | "keyword" | "channel" | "country")[], 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<ReportFilter[] | 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<ReportResponse>;
-}
+export { default } from './command.js';

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

@@ -1,93 +1 @@
-import { Flags } from '@oclif/core';
-import { granularities, reportGroupBy, sortDirections, validateReport } from '../../../../sdk/attribution/index.js';
-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 '../../../flags.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. */
-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
-        ? Promise.reject(usageError(`Expected dimension=value[,value], got "${input}".`))
-        : Promise.resolve({ dimension, values });
-};
-const isDirection = (value) => sortDirections.includes(value);
-/** `field[:asc|desc]`, ascending when the direction is left out. */
-const parseSort = (input) => {
-    const separator = input.lastIndexOf(':');
-    const field = (separator === -1 ? input : input.slice(0, separator)).trim();
-    const direction = separator === -1 ? 'asc' : input.slice(separator + 1).trim();
-    if (field === '') {
-        return Promise.reject(usageError(`Expected field[:asc|desc], got "${input}".`));
-    }
-    return isDirection(direction)
-        ? Promise.resolve({ direction, field })
-        : Promise.reject(usageError(`The sort direction must be asc or desc, got "${direction}".`));
-};
-export default class AttributionReport extends AttributionCommand {
-    static description = 'Run an Attribution report for an app: metrics over a period, grouped by dimensions';
-    static examples = [
-        '<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign',
-        '<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend --group-by date --granularity week --filter country=US,GB --sort spend:desc',
-        '<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign --json',
-    ];
-    // Input shape here; the rules (dates in order, a granularity exactly when grouping by date) live
-    // in sdk/attribution/report.ts, and which names exist is the backend catalog's knowledge.
-    static flags = {
-        ...appIdFlag,
-        ...periodFlags,
-        'metrics': Flags.string({
-            delimiter: ',',
-            description: 'Metric names, as `adapty attribution metrics` lists them (repeatable or comma-separated)',
-            multiple: true,
-            required: true,
-        }),
-        'group-by': Flags.option({
-            delimiter: ',',
-            description: 'Dimensions to group rows by (repeatable or comma-separated)',
-            multiple: true,
-            options: reportGroupBy,
-            required: true,
-        })(),
-        'granularity': Flags.option({
-            description: 'Date bucket; required with --group-by date, and allowed only with it',
-            options: granularities,
-        })(),
-        'filter': Flags.custom({
-            description: 'Keep rows whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value)',
-            multiple: true,
-            parse: parseFilter,
-        })(),
-        ...revenueBasisFlag,
-        'sort': Flags.custom({
-            description: 'Sort rows by a requested metric or dimension: field[:asc|desc] (ascending by default)',
-            parse: parseSort,
-        })(),
-    };
-    async run() {
-        const { flags } = await this.parse(AttributionReport);
-        const input = {
-            appId: flags.app,
-            ...periodParams(flags),
-            filters: flags.filter,
-            granularity: flags.granularity,
-            groupBy: flags['group-by'],
-            metrics: flags.metrics.filter(metric => metric !== ''),
-            revenueBasis: flags['revenue-basis'],
-            sort: flags.sort,
-        };
-        // Before this.attribution: bad input is exit 2 even without a token
-        assertValid(validateReport(input));
-        const report = await this.attribution.report(input);
-        this.render(report, renderReport);
-        return report;
-    }
-}
+export { default } from './command.js';

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

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { validateValues } from '../../../sdk/attribution/index.js';
 import { assertValid } from '../../../sdk/core/validation.js';
 import { AttributionCommand, periodFlags, periodParams, revenueBasisFlag } from '../../base/attribution/index.js';
-import { appIdFlag } from '../../flags.js';
+import { appIdFlag } from '../../input/app.js';
 const describeItem = (item) => {
     if ('value' in item) {
         return item.value ?? '—';

package/dist/cli/commands/auth/login.js

@@ -14,11 +14,12 @@ export default class AuthLogin extends BaseCommand {
         await this.parse(AuthLogin);
         const session = await openSession(this.config);
         if (session.user !== undefined) {
-            this.log(`Already authenticated as ${session.user.email}. Re-authenticating...`);
+            this.log(`Already authenticated as ${session.user.name}. Re-authenticating...`);
         }
         // No token yet: the same factory without one, which leaves only auth reachable
         const adapty = build({ ...session, token: undefined }, {
             config: this.config,
+            interactive: this.interactive,
             signal: this.signal,
             warn: message => this.warn(message),
         });
@@ -44,7 +45,7 @@ export default class AuthLogin extends BaseCommand {
             signal: this.signal,
         });
         await session.store.save({ token: issued.accessToken, user: issued.user });
-        this.log(`\nAuthenticated as ${issued.user.email}`);
+        this.log(`\nAuthenticated as ${issued.user.name}`);
         this.log(`Session saved to ${session.store.path}`);
     }
     /** ADAPTY_APP_URL is the CLI's business: the sdk knows nothing about browsers or dashboards. */