adapty 0.6.0 → 0.7.0

package/README.md

@@ -256,6 +256,33 @@ and the outcome shows up in `adapty asa automations runs`.
 | `--page`      | Page number (default: 1)               |
 | `--page-size` | Items per page (default: 20, max: 100; `asa` commands: default 100, max 1000) |
 
+## Paywall Preview
+
+`adapty flows config preview <config_file>` turns a local flow config into a render URL. On a TTY it opens the
+browser; piped or with `--json` it prints the URL alone. Screenshotting is the caller's job — the CLI only
+builds the URL.
+
+> **Small configs only.** This is a quick-look escape hatch. The config travels in the URL fragment, and past
+> roughly **32KB of pretty-printed JSON** the render page becomes slow and unreliable. Trim to the screen you
+> care about, or preview the saved flow in the dashboard builder instead.
+
+> **That URL is huge.** Even a config the page renders happily produces thousands of characters, and a 668KB
+> flow yields ~113,000. Nobody should read it — **agents especially should never let it into their context.**
+> Pipe it into whatever captures the screenshot:
+>
+> ```sh
+> adapty flows config preview flow.json --screen scr_abc | node capture.mjs --out shot.png
+>
+> # or, for a tool that wants a flag instead of stdin:
+> node capture.mjs --url "$(adapty flows config preview flow.json --screen scr_abc)" --out shot.png
+> ```
+>
+> Prefer the pipe: it has no size limit, while an argument is capped by the shell (~1MB, so a config around
+> 6MB).
+
+See [skills/adapty-cli/references/cli-commands.md](skills/adapty-cli/references/cli-commands.md#preview) for
+the flags and the size ceiling.
+
 ## Environment Variables
 
 | Variable             | Description                                                                             |
@@ -263,6 +290,7 @@ and the outcome shows up in `adapty asa automations runs`.
 | `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_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 |
 
 The two API URLs are independent: pointing `ADAPTY_API_URL` at a staging host leaves `adapty asa` on the ASA
 default, and the other way round.

package/dist/commands/asa/campaigns/bulk-list.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+import type { AsaBulkOperationListDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCampaignsBulkList extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'created-from': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'created-to': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AsaBulkOperationListDTO>;
+}

package/dist/commands/asa/campaigns/bulk-list.js

@@ -0,0 +1,54 @@
+import { Command, Flags } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags, parseDate } from '../../../lib/asa-flags.js';
+import { isValidUuid, paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+async function parseAppId(input) {
+    if (!isValidUuid(input))
+        throw new Error('Invalid app ID format. Run `adapty asa apps list` to find your app ID.');
+    return input;
+}
+export default class AsaCampaignsBulkList extends Command {
+    static description = "This company's bulk operations, newest first; inspect one with bulk-status";
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa campaigns bulk-list',
+        '<%= config.bin %> asa campaigns bulk-list --status partial --status failed',
+        '<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20',
+    ];
+    static flags = {
+        ...asaPaginationFlags,
+        app: Flags.string({ description: 'Keep only operations of this app (UUID)', parse: parseAppId }),
+        'created-from': Flags.string({
+            description: 'Keep only operations created on or after this date (YYYY-MM-DD)',
+            parse: parseDate,
+        }),
+        'created-to': Flags.string({
+            description: 'Keep only operations created on or before this date (YYYY-MM-DD)',
+            parse: parseDate,
+        }),
+        status: Flags.string({
+            description: 'Keep only operations in this state; repeatable',
+            multiple: true,
+            options: ['failed', 'partial', 'pending', 'running', 'success'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaCampaignsBulkList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/bulk-operations', {
+            ...paginationParams(flags),
+            app_id: flags.app,
+            created_from: flags['created-from'],
+            created_to: flags['created-to'],
+            status: flags.status,
+        });
+        const pages = Math.max(1, Math.ceil(result.total / result.limit));
+        printList(result.items, this.log.bind(this), {
+            count: result.total,
+            page: flags.page,
+            pages,
+        });
+        return result;
+    }
+}

package/dist/commands/auth/login.d.ts

@@ -3,4 +3,6 @@ export default class AuthLogin extends Command {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
+    /** Keeps the browser on the configured dashboard host, when ADAPTY_APP_URL asks for one. */
+    private verificationUrl;
 }

package/dist/commands/auth/login.js

@@ -1,6 +1,7 @@
 import { Command } from '@oclif/core';
 import open from 'open';
 import { ApiClient } from '../../lib/api-client.js';
+import { onAppHost } from '../../lib/app-url.js';
 import { buildUserAgent } from '../../lib/client-from-config.js';
 import { readConfig, writeConfig } from '../../lib/config.js';
 import { ApiError } from '../../lib/errors.js';
@@ -27,11 +28,12 @@ export default class AuthLogin extends Command {
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Failed to initiate auth flow', { exit: 1 });
         }
+        const verificationUrl = this.verificationUrl(device.verification_uri_complete);
         this.log(`\nYour code: ${device.user_code}\n`);
-        this.log(`If browser doesn't open, visit: ${device.verification_uri_complete}\n`);
+        this.log(`If browser doesn't open, visit: ${verificationUrl}\n`);
         if (process.stdin.isTTY === true) {
             try {
-                await open(device.verification_uri_complete);
+                await open(verificationUrl);
             }
             catch {
                 // browser open failed silently — URL already printed
@@ -106,4 +108,13 @@ export default class AuthLogin extends Command {
             process.removeListener('SIGINT', onSignal);
         }
     }
+    /** Keeps the browser on the configured dashboard host, when ADAPTY_APP_URL asks for one. */
+    verificationUrl(issuedUrl) {
+        try {
+            return onAppHost(issuedUrl);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+    }
 }

package/dist/commands/flows/config/preview.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export interface PreviewResult {
+    render_url: string;
+}
+export default class FlowsConfigPreview extends Command {
+    static args: {
+        config_file: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        device: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        orientation: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        screen: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<PreviewResult>;
+}

package/dist/commands/flows/config/preview.js

@@ -0,0 +1,74 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import open from 'open';
+import { APP_URL_ENV_VAR } from '../../../lib/app-url.js';
+import { buildRenderUrl, DEFAULT_DEVICE_ID, DEFAULT_ORIENTATION, normalizePreviewConfig, ORIENTATIONS, } from '../../../lib/preview.js';
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export default class FlowsConfigPreview extends Command {
+    static args = {
+        config_file: Args.string({ description: 'Path to a local flow config JSON file', required: true }),
+    };
+    static description = `Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot ("| node capture.mjs") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $${APP_URL_ENV_VAR}.`;
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> flows config preview ./config.json',
+        '<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape',
+        '# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png',
+        '# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url "$(<%= config.bin %> flows config preview ./config.json)" --out shot.png',
+    ];
+    static flags = {
+        device: Flags.string({ default: DEFAULT_DEVICE_ID, description: 'Device frame to render in' }),
+        orientation: Flags.string({
+            default: DEFAULT_ORIENTATION,
+            description: 'Device orientation to render in',
+            options: [...ORIENTATIONS],
+        }),
+        screen: Flags.string({ description: "Screen ID to render (default: the flow's first screen)" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsConfigPreview);
+        const configPath = resolve(args.config_file);
+        let raw;
+        try {
+            raw = JSON.parse(await readFile(configPath, 'utf8'));
+        }
+        catch (error) {
+            this.error(`Could not read config file ${configPath}: ${describeError(error)}`, { exit: 2 });
+        }
+        let payload;
+        try {
+            payload = normalizePreviewConfig(raw);
+        }
+        catch (error) {
+            this.error(describeError(error), { exit: 2 });
+        }
+        let renderUrl;
+        try {
+            renderUrl = buildRenderUrl({ device: flags.device, orientation: flags.orientation, screen: flags.screen }, payload);
+        }
+        catch (error) {
+            this.error(describeError(error), { exit: 2 });
+        }
+        const result = { render_url: renderUrl };
+        if (this.jsonEnabled())
+            return result;
+        // Piped output stays a bare URL so it composes — the whole config rides in the fragment, which
+        // is why a TTY gets the browser opened instead of a screenful of base64.
+        if (process.stdout.isTTY !== true) {
+            this.log(renderUrl);
+            return result;
+        }
+        const target = [flags.screen ?? 'first screen', flags.device, flags.orientation].join(', ');
+        try {
+            await open(renderUrl);
+            this.log(`Opened the preview in your browser (${target}).`);
+        }
+        catch {
+            this.log(renderUrl);
+        }
+        return result;
+    }
+}

package/dist/lib/app-url.d.ts

@@ -0,0 +1,10 @@
+export declare const APP_URL_ENV_VAR = "ADAPTY_APP_URL";
+export declare const DEFAULT_APP_URL = "https://app.adapty.io";
+/** Builds a dashboard URL for a fixed route, e.g. the flow preview page. */
+export declare function appUrl(path: string): URL;
+/**
+ * Moves a link the API issued (the device-flow verification URI) onto the configured dashboard
+ * host, so pointing the CLI at a local or staging dashboard keeps the browser there too. Without
+ * ADAPTY_APP_URL the link is left exactly as issued — the API is free to serve it from any host.
+ */
+export declare function onAppHost(issuedUrl: string): string;

package/dist/lib/app-url.js

@@ -0,0 +1,33 @@
+export const APP_URL_ENV_VAR = 'ADAPTY_APP_URL';
+export const DEFAULT_APP_URL = 'https://app.adapty.io';
+/** Dashboard origin: ADAPTY_APP_URL when set, production otherwise. Only its origin is used. */
+function appBaseUrl() {
+    const base = process.env[APP_URL_ENV_VAR] ?? DEFAULT_APP_URL;
+    try {
+        return new URL(base);
+    }
+    catch {
+        throw new Error(`Invalid ${APP_URL_ENV_VAR}: ${base}`);
+    }
+}
+/** Builds a dashboard URL for a fixed route, e.g. the flow preview page. */
+export function appUrl(path) {
+    return new URL(path, appBaseUrl());
+}
+/**
+ * Moves a link the API issued (the device-flow verification URI) onto the configured dashboard
+ * host, so pointing the CLI at a local or staging dashboard keeps the browser there too. Without
+ * ADAPTY_APP_URL the link is left exactly as issued — the API is free to serve it from any host.
+ */
+export function onAppHost(issuedUrl) {
+    if (!process.env[APP_URL_ENV_VAR])
+        return issuedUrl;
+    let issued;
+    try {
+        issued = new URL(issuedUrl);
+    }
+    catch {
+        return issuedUrl;
+    }
+    return appUrl(`${issued.pathname}${issued.search}${issued.hash}`).toString();
+}

package/dist/lib/asa-flags.d.ts

@@ -11,6 +11,7 @@ export declare const asaPaginationFlags: {
 export declare const byDaysFlag: {
     'by-days': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
 };
+export declare function parseDate(input: string): Promise<string>;
 export declare const periodFlags: {
     'date-from': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     'date-to': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/lib/asa-flags.js

@@ -26,7 +26,7 @@ export const byDaysFlag = {
         multiple: true,
     }),
 };
-async function parseDate(input) {
+export async function parseDate(input) {
     if (!DATE_REGEX.test(input))
         throw new Error('Dates must be written as YYYY-MM-DD.');
     return input;

package/dist/lib/asa-schemas.d.ts

@@ -314,6 +314,21 @@ export interface AsaBulkOperationStateDTO {
     started_at: null | string;
     status: AsaBulkOperationStatus;
 }
+export interface AsaBulkOperationListItemDTO {
+    app_id: string;
+    created_at: string;
+    error: null | string;
+    finished_at: null | string;
+    operation_id: string;
+    started_at: null | string;
+    status: AsaBulkOperationStatus;
+}
+export interface AsaBulkOperationListDTO {
+    items: AsaBulkOperationListItemDTO[];
+    limit: number;
+    offset: number;
+    total: number;
+}
 export interface AsaTemplateIssueDTO {
     column: null | string;
     message: string;

package/dist/lib/preview.d.ts

@@ -0,0 +1,27 @@
+/** The render route is fixed; only its host is configurable, via ADAPTY_APP_URL. */
+export declare const PREVIEW_PATH = "/flow-preview";
+export declare const DEFAULT_DEVICE_ID = "iphone-14";
+/** Orientations the render page accepts; anything else falls back to its own default. */
+export declare const ORIENTATIONS: readonly ["landscape", "portrait"];
+export declare const DEFAULT_ORIENTATION = "portrait";
+/** Payload the render page expects. Wire format shared with the UI, hence camelCase. */
+export interface PreviewPayload {
+    flow: Record<string, unknown>;
+    remoteConfigs: unknown[];
+}
+/**
+ * Accepts either a dashboard-api envelope (`{config, remote_configs, ...}`) or a bare
+ * builder config, and returns the shape the render page injects.
+ *
+ * `screens` must be an array: that is exactly what the page's own payload guard checks
+ * before it treats the payload as a builder draft, so a config without it would be
+ * rejected there instead — better to say so here, against the file the user named.
+ */
+export declare function normalizePreviewConfig(raw: unknown): PreviewPayload;
+export interface RenderTarget {
+    device: string;
+    orientation: string;
+    /** Omitted lets the render page fall back to the flow's first screen. */
+    screen?: string;
+}
+export declare function buildRenderUrl(target: RenderTarget, payload: PreviewPayload): string;

package/dist/lib/preview.js

@@ -0,0 +1,48 @@
+import { gzipSync } from 'node:zlib';
+import { appUrl } from './app-url.js';
+/** The render route is fixed; only its host is configurable, via ADAPTY_APP_URL. */
+export const PREVIEW_PATH = '/flow-preview';
+export const DEFAULT_DEVICE_ID = 'iphone-14';
+/** Orientations the render page accepts; anything else falls back to its own default. */
+export const ORIENTATIONS = ['landscape', 'portrait'];
+export const DEFAULT_ORIENTATION = 'portrait';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Accepts either a dashboard-api envelope (`{config, remote_configs, ...}`) or a bare
+ * builder config, and returns the shape the render page injects.
+ *
+ * `screens` must be an array: that is exactly what the page's own payload guard checks
+ * before it treats the payload as a builder draft, so a config without it would be
+ * rejected there instead — better to say so here, against the file the user named.
+ */
+export function normalizePreviewConfig(raw) {
+    if (!isRecord(raw)) {
+        throw new Error('Config file must contain a JSON object.');
+    }
+    const envelopeConfig = isRecord(raw.config) ? raw.config : null;
+    const flow = envelopeConfig ?? raw;
+    if (!Array.isArray(flow.screens)) {
+        throw new TypeError('Unrecognized config file. Expected a dashboard-api envelope with a `config` object, or a bare builder config — either way `screens` must be an array.');
+    }
+    const remoteConfigs = envelopeConfig && Array.isArray(raw.remote_configs) ? raw.remote_configs : [];
+    return { flow, remoteConfigs };
+}
+/**
+ * Fragment wire format shared with the render page: bare `base64url(gzip(utf8(JSON)))`, no
+ * prefix — the page compresses unconditionally too, so there is no plain shape to mark it
+ * apart from. Node's base64url already omits the `=` padding the page strips.
+ */
+function encodeConfigFragment(payload) {
+    return gzipSync(Buffer.from(JSON.stringify(payload), 'utf8')).toString('base64url');
+}
+export function buildRenderUrl(target, payload) {
+    const url = appUrl(PREVIEW_PATH);
+    if (target.screen)
+        url.searchParams.set('screen', target.screen);
+    url.searchParams.set('device', target.device);
+    url.searchParams.set('orientation', target.orientation);
+    url.hash = `config=${encodeConfigFragment(payload)}`;
+    return url.toString();
+}

package/oclif.manifest.json

@@ -1322,6 +1322,108 @@
         "update.js"
       ]
     },
+    "segments:get": {
+      "aliases": [],
+      "args": {
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
+          "required": true
+        }
+      },
+      "description": "Get segment details",
+      "examples": [
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "get.js"
+      ]
+    },
+    "segments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List segments for an app",
+      "examples": [
+        "<%= config.bin %> segments list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "list.js"
+      ]
+    },
     "products:create": {
       "aliases": [],
       "args": {},
@@ -1606,108 +1708,6 @@
         "update.js"
       ]
     },
-    "segments:get": {
-      "aliases": [],
-      "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
-          "required": true
-        }
-      },
-      "description": "Get segment details",
-      "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "segments:get",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "segments",
-        "get.js"
-      ]
-    },
-    "segments:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List segments for an app",
-      "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "segments:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "segments",
-        "list.js"
-      ]
-    },
     "asa:ad-groups:create": {
       "aliases": [],
       "args": {},
@@ -2361,6 +2361,56 @@
         "update.js"
       ]
     },
+    "asa:apps:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the apps promoted by this company in Apple Search Ads",
+      "examples": [
+        "<%= config.bin %> asa apps list",
+        "<%= config.bin %> asa apps list --page 2 --page-size 50"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:apps:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "apps",
+        "list.js"
+      ]
+    },
     "asa:automations:create": {
       "aliases": [],
       "args": {},
@@ -2712,15 +2762,113 @@
         "update.js"
       ]
     },
-    "asa:campaigns:bulk-create": {
+    "asa:campaigns:bulk-create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
+      "examples": [
+        "<%= config.bin %> asa campaigns bulk-create --file structure.json",
+        "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
+        "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
+        "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "idempotency-key": {
+          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
+          "name": "idempotency-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from-file": {
+          "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
+          "name": "from-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "org-id": {
+          "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
+          "name": "org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "poll-interval": {
+          "description": "Seconds between progress polls",
+          "name": "poll-interval",
+          "default": 5,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "preview": {
+          "description": "With --from-file: print the converted request and stop, nothing is created",
+          "name": "preview",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Max seconds to wait for the operation to finish",
+          "name": "timeout",
+          "default": 900,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:campaigns:bulk-create",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "campaigns",
+        "bulk-create.js"
+      ]
+    },
+    "asa:campaigns:bulk-list": {
       "aliases": [],
       "args": {},
-      "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
+      "description": "This company's bulk operations, newest first; inspect one with bulk-status",
       "examples": [
-        "<%= config.bin %> asa campaigns bulk-create --file structure.json",
-        "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
-        "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
-        "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
+        "<%= config.bin %> asa campaigns bulk-list",
+        "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
+        "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
       ],
       "flags": {
         "json": {
@@ -2730,73 +2878,61 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
-          "name": "file",
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "from-file": {
-          "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
-          "name": "from-file",
+        "app": {
+          "description": "Keep only operations of this app (UUID)",
+          "name": "app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "org-id": {
-          "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
-          "name": "org-id",
+        "created-from": {
+          "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
+          "name": "created-from",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "poll-interval": {
-          "description": "Seconds between progress polls",
-          "name": "poll-interval",
-          "default": 5,
+        "created-to": {
+          "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
+          "name": "created-to",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "preview": {
-          "description": "With --from-file: print the converted request and stop, nothing is created",
-          "name": "preview",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Max seconds to wait for the operation to finish",
-          "name": "timeout",
-          "default": 900,
+        "status": {
+          "description": "Keep only operations in this state; repeatable",
+          "name": "status",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
+          "options": [
+            "failed",
+            "partial",
+            "pending",
+            "running",
+            "success"
+          ],
           "type": "option"
-        },
-        "wait": {
-          "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:campaigns:bulk-create",
+      "id": "asa:campaigns:bulk-list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2808,7 +2944,7 @@
         "commands",
         "asa",
         "campaigns",
-        "bulk-create.js"
+        "bulk-list.js"
       ]
     },
     "asa:campaigns:bulk-status": {
@@ -4111,55 +4247,6 @@
         "list.js"
       ]
     },
-    "asa:orgs:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List the Apple Search Ads organizations this company can spend from",
-      "examples": [
-        "<%= config.bin %> asa orgs list"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:orgs:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "orgs",
-        "list.js"
-      ]
-    },
     "asa:product-pages:list": {
       "aliases": [],
       "args": {},
@@ -4378,6 +4465,55 @@
         "list.js"
       ]
     },
+    "asa:orgs:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the Apple Search Ads organizations this company can spend from",
+      "examples": [
+        "<%= config.bin %> asa orgs list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:orgs:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "orgs",
+        "list.js"
+      ]
+    },
     "flows:config:get": {
       "aliases": [],
       "args": {
@@ -4425,6 +4561,75 @@
         "get.js"
       ]
     },
+    "flows:config:preview": {
+      "aliases": [],
+      "args": {
+        "config_file": {
+          "description": "Path to a local flow config JSON file",
+          "name": "config_file",
+          "required": true
+        }
+      },
+      "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
+      "examples": [
+        "<%= config.bin %> flows config preview ./config.json",
+        "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
+        "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
+        "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device frame to render in",
+          "name": "device",
+          "default": "iphone-14",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "orientation": {
+          "description": "Device orientation to render in",
+          "name": "orientation",
+          "default": "portrait",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "landscape",
+            "portrait"
+          ],
+          "type": "option"
+        },
+        "screen": {
+          "description": "Screen ID to render (default: the flow's first screen)",
+          "name": "screen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flows:config:preview",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flows",
+        "config",
+        "preview.js"
+      ]
+    },
     "flows:config:update": {
       "aliases": [],
       "args": {
@@ -4501,57 +4706,7 @@
         "config",
         "update.js"
       ]
-    },
-    "asa:apps:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List the apps promoted by this company in Apple Search Ads",
-      "examples": [
-        "<%= config.bin %> asa apps list",
-        "<%= config.bin %> asa apps list --page 2 --page-size 50"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:apps:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "apps",
-        "list.js"
-      ]
     }
   },
-  "version": "0.6.0"
+  "version": "0.7.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adapty",
   "description": "Adapty command line interface",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "author": "Adapty team <support@adapty.io>",
   "bin": {
     "adapty": "./bin/run.js"