adapty 0.8.8 → 0.9.0

package/dist/cli/commands/migrations/run/command.js

@@ -0,0 +1,141 @@
+import { Args, Flags } from '@oclif/core';
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import { CliError, exitCode } from '../../../errors.js';
+import { migrationFlags } from '../../../input/migration.js';
+import { renderEnvelope } from '../../../views/migrations/envelope/envelope.js';
+import { actionView } from './lib/action-view.js';
+import { findAction, unknownActionMessage, unsupportedActionMessage } from './lib/actions.js';
+import { readActionInput } from './lib/input.js';
+import { openLink } from './lib/open-link.js';
+export default class Run extends MigrationCommand {
+    static summary = 'Run an input action or open an external action link';
+    static description = [
+        'Choose an action ID from next_actions or available_actions in `adapty migrations status -m ID --json`.',
+        'Replace ACTION_ID in the examples with an offered action ID.',
+        'For input actions, read the resources in reads and prepare a JSON object matching input_schema.',
+        'Omitting input sends {}. Review confirm before passing --yes.',
+        'Without --yes, actions requiring confirmation exit with code 6. No confirmation prompt is shown.',
+        '',
+        'External actions print a link and open it in an interactive terminal. Complete the browser step, then check status.',
+        'External actions reject --input and --input-file, including stdin.',
+        'Pipes and --json require --open to launch a browser; BROWSER=none disables it.',
+        'File uploads are not supported; use the dashboard or an offered Cloud Export action.',
+        '',
+        'With --json, returns the full migration response (before the browser step for external actions).',
+        'After a revision_conflict error, read status and review the action before retrying.',
+    ].join('\n');
+    static examples = [
+        {
+            description: 'Run an offered action on the saved migration after reviewing confirm:',
+            command: '<%= config.bin %> migrations run ACTION_ID --yes',
+        },
+        {
+            description: 'Read current action IDs and input schemas first:',
+            command: '<%= config.bin %> migrations status -m mig_7x2 --json',
+        },
+        {
+            description: 'Submit an empty JSON object, if the action input_schema allows it:',
+            command: '<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input \'{}\'',
+        },
+        {
+            description: 'Submit a file matching input_schema, after reviewing confirm:',
+            command: '<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file ./decisions.json --yes --json',
+        },
+        {
+            description: 'Read the same prepared input from stdin:',
+            command: '<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file - --yes --json < ./decisions.json',
+        },
+        {
+            description: 'Get an external action link without opening a browser:',
+            command: '<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --no-browser',
+        },
+    ];
+    static args = {
+        action_id: Args.string({
+            description: 'Offered action ID from `adapty migrations status`',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...migrationFlags,
+        'input': Flags.string({
+            description: 'Input action data as a JSON object matching input_schema',
+            exclusive: ['input-file'],
+            helpValue: 'JSON',
+        }),
+        'input-file': Flags.string({
+            description: 'Read an input action\'s JSON object from a file; use - for stdin',
+            exclusive: ['input'],
+            helpValue: 'PATH',
+        }),
+        'yes': Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Confirm the input action after reviewing its confirmation text',
+        }),
+        'open': Flags.boolean({
+            default: false,
+            description: 'Open an external action\'s HTTPS link, including with pipes or --json',
+            exclusive: ['no-browser'],
+        }),
+        'no-browser': Flags.boolean({
+            default: false,
+            description: 'Show the external action without opening a browser',
+            exclusive: ['open'],
+        }),
+    };
+    async run() {
+        const context = await this.prepare();
+        if (context.href !== undefined) {
+            return this.runExternalAction(context, context.href);
+        }
+        return this.runInputAction(context);
+    }
+    async prepare() {
+        const { args, flags } = await this.parse(Run);
+        // Inline input and files are read before the request; stdin waits for the action kind.
+        const fromStdin = flags['input-file'] === '-';
+        const input = fromStdin ? undefined : await readActionInput(flags);
+        const selection = await this.currentMigration.require(flags.migration);
+        const envelope = await this.adapty.migrations.get(selection.currentMigrationId);
+        const action = findAction(envelope, args.action_id);
+        if (action === undefined) {
+            throw new CliError(unknownActionMessage(envelope, args.action_id), exitCode.usage, 'action_not_found');
+        }
+        const href = 'href' in action ? action.href : undefined;
+        if (href !== undefined && (flags.input !== undefined || flags['input-file'] !== undefined)) {
+            throw new CliError(`Action \`${action.action_id}\` hands over a link and does not accept --input or --input-file. Remove the input option and complete the step in the browser.`, exitCode.usage, 'action_input_unsupported');
+        }
+        return {
+            action, envelope, flags, href, selection,
+            input: fromStdin && action.kind === 'input' ? await readActionInput(flags) : input,
+        };
+    }
+    async runExternalAction(context, href) {
+        this.render({ action: context.action, migrationId: context.envelope.migration.id }, actionView);
+        await openLink(href, context.flags, this.interactive);
+        return context.envelope;
+    }
+    async runInputAction({ action, envelope, flags, input, selection }) {
+        if (action.kind !== 'input' && action.kind !== 'upload' && action.kind !== 'external') {
+            this.render({ action, migrationId: envelope.migration.id }, actionView);
+            return envelope;
+        }
+        if (action.kind !== 'input') {
+            throw new CliError(unsupportedActionMessage(action), exitCode.usage, 'action_unsupported');
+        }
+        if (action.confirm !== null && !flags.yes) {
+            const message = `${action.confirm}\n\nRe-run with --yes to do it.`;
+            throw new CliError(message, exitCode.confirmRequired, 'confirm_required');
+        }
+        if (selection.source === 'context') {
+            process.stderr.write(`Using saved migration: ${selection.currentMigrationId}\n`);
+        }
+        const result = await this.adapty.migrations.runAction(selection.currentMigrationId, action.action_id, {
+            expectedRevision: envelope.migration.revision,
+            input,
+        });
+        this.render(result, renderEnvelope);
+        return result;
+    }
+}

package/dist/cli/commands/migrations/run/index.d.ts

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/run/index.js

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/run/lib/action-view.d.ts

@@ -0,0 +1,7 @@
+import type { Action } from '../../../../../sdk/adapty/index.js';
+type ActionView = {
+    action: Action;
+    migrationId: string;
+};
+export declare const actionView: ({ action, migrationId }: ActionView) => string;
+export {};

package/dist/cli/commands/migrations/run/lib/action-view.js

@@ -0,0 +1,2 @@
+import { actionBlock } from '../../../../views/migrations/envelope/action-block.js';
+export const actionView = ({ action, migrationId }) => actionBlock(action, migrationId).join('\n');

package/dist/cli/commands/migrations/run/lib/actions.d.ts

@@ -0,0 +1,4 @@
+import type { Action, Envelope } from '../../../../../sdk/adapty/index.js';
+export declare const findAction: (envelope: Envelope, actionId: string) => Action | undefined;
+export declare const unknownActionMessage: (envelope: Envelope, actionId: string) => string;
+export declare const unsupportedActionMessage: (action: Action) => string;

package/dist/cli/commands/migrations/run/lib/actions.js

@@ -0,0 +1,20 @@
+const offered = (envelope) => [...envelope.next_actions, ...envelope.available_actions];
+export const findAction = (envelope, actionId) => {
+    return offered(envelope).find(action => action.action_id === actionId);
+};
+const line = (action) => `  ${action.action_id}  (${action.kind})  ${action.title}`;
+export const unknownActionMessage = (envelope, actionId) => {
+    const actions = offered(envelope);
+    if (actions.length === 0) {
+        const { state, summary } = envelope.migration;
+        return `No action \`${actionId}\` here: this migration offers none right now (state: ${state}).\n${summary}`;
+    }
+    return [`No action \`${actionId}\` here. Available now:`, ...actions.map(line)].join('\n');
+};
+export const unsupportedActionMessage = (action) => {
+    const detail = action.detail === null ? '' : `\n${action.detail}`;
+    if (action.kind === 'upload') {
+        return `\`${action.action_id}\` (${action.title}) uploads a file, which this adapty-cli cannot do yet.${detail}\nUse the dashboard or an offered Cloud Export action.`;
+    }
+    return `\`${action.action_id}\` (${action.title}) is a "${action.kind}" action: it needs a newer adapty-cli.${detail}`;
+};

package/dist/cli/commands/migrations/run/lib/https.d.ts

@@ -0,0 +1 @@
+export declare const isHttps: (href: string) => boolean;

package/dist/cli/commands/migrations/run/lib/https.js

@@ -0,0 +1,8 @@
+export const isHttps = (href) => {
+    try {
+        return new URL(href).protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+};

package/dist/cli/commands/migrations/run/lib/input.d.ts

@@ -0,0 +1,10 @@
+type InputFlags = {
+    'input'?: string | undefined;
+    'input-file'?: string | undefined;
+};
+/**
+ * Read inline JSON, a file, or stdin, and answer with an input the action request accepts.
+ * The caller checks the action kind before waiting on stdin.
+ */
+export declare const readActionInput: (flags: InputFlags) => Promise<unknown>;
+export {};

package/dist/cli/commands/migrations/run/lib/input.js

@@ -0,0 +1,51 @@
+import { readFileSync } from 'node:fs';
+import { validateActionInput } from '../../../../../sdk/adapty/migrations/index.js';
+import { ValidationError } from '../../../../../sdk/core/errors.js';
+import { assertValid } from '../../../../../sdk/core/validation.js';
+/** CLI error formatting maps inputFile to --input-file. */
+const invalid = (path, message) => {
+    throw new ValidationError([{ message, path }]);
+};
+const reason = (error) => (error instanceof Error ? error.message : String(error));
+const parseJson = (raw, path) => {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        return invalid(path, `is not valid JSON: ${reason(error)}`);
+    }
+};
+const readFile = (path) => {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        return invalid('inputFile', `cannot be read: ${reason(error)}`);
+    }
+};
+const readStdin = async () => {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+};
+const parseActionInput = async (flags) => {
+    if (flags.input !== undefined) {
+        return parseJson(flags.input, 'input');
+    }
+    const path = flags['input-file'];
+    if (path === undefined) {
+        return undefined;
+    }
+    return parseJson(path === '-' ? await readStdin() : readFile(path), 'inputFile');
+};
+/**
+ * Read inline JSON, a file, or stdin, and answer with an input the action request accepts.
+ * The caller checks the action kind before waiting on stdin.
+ */
+export const readActionInput = async (flags) => {
+    const input = await parseActionInput(flags);
+    assertValid(validateActionInput(input));
+    return input;
+};

package/dist/cli/commands/migrations/run/lib/open-link.d.ts

@@ -0,0 +1,7 @@
+type BrowserFlags = {
+    'no-browser': boolean;
+    'open': boolean;
+};
+/** Piped and JSON output require --open to launch a browser. */
+export declare const openLink: (href: string, flags: BrowserFlags, interactive: boolean) => Promise<void>;
+export {};

package/dist/cli/commands/migrations/run/lib/open-link.js

@@ -0,0 +1,11 @@
+import open from 'open';
+import { isHttps } from './https.js';
+/** Piped and JSON output require --open to launch a browser. */
+export const openLink = async (href, flags, interactive) => {
+    const wanted = flags.open || interactive;
+    const allowed = !flags['no-browser'] && process.env.BROWSER !== 'none' && isHttps(href);
+    if (!wanted || !allowed) {
+        return;
+    }
+    await open(href).catch(() => undefined);
+};

package/dist/cli/commands/migrations/show/command.d.ts

@@ -0,0 +1,17 @@
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import type { Envelope } from '../../../../sdk/adapty/index.js';
+export default class Show extends MigrationCommand {
+    static summary: string;
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        resource: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        migration: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<Envelope>;
+}

package/dist/cli/commands/migrations/show/command.js

@@ -0,0 +1,47 @@
+import { Args } from '@oclif/core';
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import { migrationFlags } from '../../../input/migration.js';
+import { renderResources, renderResult } from './lib/render.js';
+export default class Show extends MigrationCommand {
+    static summary = 'List migration resources or read one resource';
+    static description = [
+        'Omit RESOURCE to list what can be read now. Use a name from that list, such as apps or mapping.',
+        '',
+        'Reading a resource prints its data as JSON. With --json, returns the full migration response.',
+        'Resource data is in result (null if no data is available yet).',
+    ].join('\n');
+    static examples = [
+        {
+            description: 'Read the RevenueCat apps of the selected migration:',
+            command: '<%= config.bin %> migrations show apps',
+        },
+        {
+            description: 'List resource names available now:',
+            command: '<%= config.bin %> migrations show -m mig_7x2',
+        },
+        {
+            description: 'Read mapping data, if listed as available:',
+            command: '<%= config.bin %> migrations show mapping -m mig_7x2',
+        },
+        {
+            description: 'Extract only the resource data (requires jq):',
+            command: '<%= config.bin %> migrations show mapping -m mig_7x2 --json | jq \'.result\'',
+        },
+    ];
+    static args = {
+        resource: Args.string({
+            description: 'Resource name; omit to list what can be read now',
+        }),
+    };
+    static flags = { ...migrationFlags };
+    async run() {
+        const { args, flags } = await this.parse(Show);
+        const selection = await this.currentMigration.require(flags.migration);
+        const { resource } = args;
+        const envelope = resource === undefined
+            ? await this.adapty.migrations.get(selection.currentMigrationId)
+            : await this.adapty.migrations.resource(selection.currentMigrationId, resource);
+        this.render(envelope, resource === undefined ? renderResources : renderResult);
+        return envelope;
+    }
+}

package/dist/cli/commands/migrations/show/index.d.ts

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/show/index.js

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/show/lib/render.d.ts

@@ -0,0 +1,4 @@
+import type { Envelope } from '../../../../../sdk/adapty/index.js';
+export declare const renderResources: (envelope: Envelope) => string;
+/** Use JSON because resource shapes vary by flow. */
+export declare const renderResult: (envelope: Envelope) => string;

package/dist/cli/commands/migrations/show/lib/render.js

@@ -0,0 +1,27 @@
+const maxWidth = (values) => {
+    return values.reduce((max, value) => Math.max(max, value.length), 0);
+};
+const resourceLine = (resource, width) => {
+    return `  ${resource.name.padEnd(width)}  ${resource.title}`;
+};
+export const renderResources = (envelope) => {
+    const { resources } = envelope;
+    const [first] = resources;
+    if (first === undefined) {
+        return `Nothing to read yet: ${envelope.migration.summary}`;
+    }
+    const width = maxWidth(resources.map(resource => resource.name));
+    return [
+        'Readable now:',
+        ...resources.map(resource => resourceLine(resource, width)),
+        '',
+        `Read one: \`adapty migrations show ${first.name} -m ${envelope.migration.id}\``,
+    ].join('\n');
+};
+/** Use JSON because resource shapes vary by flow. */
+export const renderResult = (envelope) => {
+    if (envelope.result === null) {
+        return `No data in this resource yet: ${envelope.migration.summary}`;
+    }
+    return JSON.stringify(envelope.result, null, 2);
+};

package/dist/cli/commands/migrations/status/command.d.ts

@@ -0,0 +1,18 @@
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import type { Envelope } from '../../../../sdk/adapty/index.js';
+export default class Status extends MigrationCommand {
+    static summary: string;
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        migration: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<Envelope>;
+    /** Timeout returns the last response with exit 0; Ctrl+C cancels with exit 130. */
+    private waitForMigration;
+}

package/dist/cli/commands/migrations/status/command.js

@@ -0,0 +1,54 @@
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import { migrationFlags } from '../../../input/migration.js';
+import { renderEnvelope } from '../../../views/migrations/envelope/envelope.js';
+import { waitFlags } from './lib/flags.js';
+import { pollNotice } from './lib/notice.js';
+export default class Status extends MigrationCommand {
+    static summary = 'Show migration state, issues, and available actions';
+    static description = [
+        'Read next_actions for the next steps and available_actions for optional actions.',
+        'Use --json to read each action\'s input_schema, reads, and confirmation text.',
+        '',
+        '--wait returns when the revision changes, the state leaves running, or the polling budget runs out.',
+        'Exit 0 means the request succeeded, even if the migration is still running or has failed.',
+        'Check migration.state in JSON output. Progress goes to stderr. Ctrl+C exits with code 130.',
+    ].join('\n');
+    static examples = [
+        {
+            description: 'Inspect the saved migration:',
+            command: '<%= config.bin %> migrations status',
+        },
+        {
+            description: 'See the current state and what to do next:',
+            command: '<%= config.bin %> migrations status -m mig_7x2',
+        },
+        {
+            description: 'Read action IDs, input schemas, and confirmation text as JSON:',
+            command: '<%= config.bin %> migrations status -m mig_7x2 --json',
+        },
+        {
+            description: 'Wait for a change with a five-minute polling budget:',
+            command: '<%= config.bin %> migrations status -m mig_7x2 --wait --timeout 5m --json',
+        },
+    ];
+    static flags = { ...migrationFlags, ...waitFlags };
+    async run() {
+        const { flags } = await this.parse(Status);
+        const selection = await this.currentMigration.require(flags.migration);
+        const envelope = flags.wait
+            ? await this.waitForMigration(selection.currentMigrationId, flags.timeout)
+            : await this.adapty.migrations.get(selection.currentMigrationId);
+        this.render(envelope, renderEnvelope);
+        return envelope;
+    }
+    /** Timeout returns the last response with exit 0; Ctrl+C cancels with exit 130. */
+    async waitForMigration(id, timeoutMs) {
+        return this.adapty.migrations.waitFor(id, {
+            onPoll: (envelope, delayMs) => {
+                process.stderr.write(`${pollNotice(envelope, delayMs)}\n`);
+            },
+            signal: this.signal,
+            timeoutMs,
+        });
+    }
+}

package/dist/cli/commands/migrations/status/index.d.ts

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/status/index.js

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/status/lib/flags.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Keep defaults out of these flags so dependsOn can detect a missing --wait.
+ * The SDK supplies the default timeout.
+ */
+export declare const waitFlags: {
+    timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+};

package/dist/cli/commands/migrations/status/lib/flags.js

@@ -0,0 +1,29 @@
+import { Errors, Flags } from '@oclif/core';
+import { exitCode } from '../../../../errors.js';
+const DURATION_PATTERN = /^(\d+)(m|s)?$/;
+const MAX_WAIT_SECONDS = 600;
+const durationHint = `Use seconds or minutes, e.g. 300s or 5m, up to ${MAX_WAIT_SECONDS}s.`;
+const parseDuration = (input) => {
+    const match = DURATION_PATTERN.exec(input);
+    const amount = Number(match?.[1]);
+    const seconds = match?.[2] === 'm' ? amount * 60 : amount;
+    return Number.isFinite(seconds) && seconds >= 1 && seconds <= MAX_WAIT_SECONDS
+        ? Promise.resolve(seconds * 1000)
+        : Promise.reject(new Errors.CLIError(`Invalid duration \`${input}\`. ${durationHint}`, { exit: exitCode.usage }));
+};
+/** Parse seconds or minutes into milliseconds for the SDK. */
+const duration = Flags.custom({ parse: async (input) => parseDuration(input) });
+/**
+ * Keep defaults out of these flags so dependsOn can detect a missing --wait.
+ * The SDK supplies the default timeout.
+ */
+export const waitFlags = {
+    timeout: duration({
+        dependsOn: ['wait'],
+        description: 'Polling budget with --wait: 1-600s, default 120s (e.g. 300, 300s, 5m); in-flight requests may take longer',
+        helpValue: 'DURATION',
+    }),
+    wait: Flags.boolean({
+        description: 'Poll for a revision or state change, then return the latest response',
+    }),
+};

package/dist/cli/commands/migrations/status/lib/notice.d.ts

@@ -0,0 +1,3 @@
+import type { Envelope } from '../../../../../sdk/adapty/index.js';
+/** Format a progress line for stderr, including when progress or its total is unknown. */
+export declare const pollNotice: (envelope: Envelope, delayMs: number) => string;

package/dist/cli/commands/migrations/status/lib/notice.js

@@ -0,0 +1,10 @@
+const workDone = (progress) => {
+    const done = progress.total === null ? String(progress.done) : `${progress.done} of ${progress.total}`;
+    return `${done} ${progress.unit}`;
+};
+/** Format a progress line for stderr, including when progress or its total is unknown. */
+export const pollNotice = (envelope, delayMs) => {
+    const { progress, state } = envelope.migration;
+    const work = progress === null ? state : `${state}  ${workDone(progress)}`;
+    return `${work} — checking again in ${Math.round(delayMs / 1000)}s`;
+};

package/dist/cli/commands/migrations/steps/command.d.ts

@@ -0,0 +1,14 @@
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import type { Envelope } from '../../../../sdk/adapty/index.js';
+export default class Steps extends MigrationCommand {
+    static summary: string;
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        migration: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<Envelope>;
+}

package/dist/cli/commands/migrations/steps/command.js

@@ -0,0 +1,34 @@
+import { MigrationCommand } from '../../../base/adapty/index.js';
+import { migrationFlags } from '../../../input/migration.js';
+import { renderSteps } from './lib/render.js';
+export default class Steps extends MigrationCommand {
+    static summary = 'Show the migration checklist and step statuses';
+    static description = [
+        'Shows done, active, and locked steps in migration order.',
+        'To find actions you can run, use `adapty migrations status -m ID`.',
+        '',
+        'With --json, the full migration response is returned; the checklist is in steps.',
+    ].join('\n');
+    static examples = [
+        {
+            description: 'View the saved migration checklist:',
+            command: '<%= config.bin %> migrations steps',
+        },
+        {
+            description: 'View the checklist:',
+            command: '<%= config.bin %> migrations steps -m mig_7x2',
+        },
+        {
+            description: 'Extract the checklist as JSON (requires jq):',
+            command: '<%= config.bin %> migrations steps -m mig_7x2 --json | jq \'.steps\'',
+        },
+    ];
+    static flags = { ...migrationFlags };
+    async run() {
+        const { flags } = await this.parse(Steps);
+        const selection = await this.currentMigration.require(flags.migration);
+        const envelope = await this.adapty.migrations.get(selection.currentMigrationId);
+        this.render(envelope, renderSteps);
+        return envelope;
+    }
+}

package/dist/cli/commands/migrations/steps/index.d.ts

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/steps/index.js

@@ -0,0 +1 @@
+export { default } from './command.js';

package/dist/cli/commands/migrations/steps/lib/render.d.ts

@@ -0,0 +1,3 @@
+import type { Envelope } from '../../../../../sdk/adapty/index.js';
+/** Keep server order and step IDs so users can match steps to issues and actions. */
+export declare const renderSteps: (envelope: Envelope) => string;

package/dist/cli/commands/migrations/steps/lib/render.js

@@ -0,0 +1,28 @@
+/** Unknown statuses are displayed as text; satisfies checks that all known statuses have a mark. */
+const marks = {
+    active: '[>]',
+    done: '[x]',
+    locked: '[ ]',
+};
+const markOf = (status) => marks[status] ?? `[${status}]`;
+const maxWidth = (values) => {
+    return values.reduce((max, value) => Math.max(max, value.length), 0);
+};
+const stepLine = (step, widths) => {
+    const mark = markOf(step.status).padEnd(widths.mark);
+    const stepId = step.step_id.padEnd(widths.stepId);
+    const summary = step.summary === null ? '' : `  ${step.summary}`;
+    return `${mark} ${stepId}  ${step.title}${summary}`;
+};
+/** Keep server order and step IDs so users can match steps to issues and actions. */
+export const renderSteps = (envelope) => {
+    const { steps } = envelope;
+    if (steps.length === 0) {
+        return `No steps yet: ${envelope.migration.summary}`;
+    }
+    const widths = {
+        mark: maxWidth(steps.map(step => markOf(step.status))),
+        stepId: maxWidth(steps.map(step => step.step_id)),
+    };
+    return steps.map(step => stepLine(step, widths)).join('\n');
+};

package/dist/cli/commands/migrations/unuse/command.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base/base-command.js';
+type Result = {
+    currentMigrationId: null;
+};
+export default class Unuse extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<Result>;
+}
+export {};