adapty 0.3.0 → 0.4.0

package/dist/commands/asa/negative-keywords/list.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+import type { AsaNegativeKeywordDTO } from '../../../lib/asa-schemas.js';
+import { type PaginatedResponse } from '../../../lib/flags.js';
+export default class AsaNegativeKeywordsList extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'campaign-level-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'ad-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        campaign: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'campaign-group': 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<PaginatedResponse<AsaNegativeKeywordDTO>>;
+}

package/dist/commands/asa/negative-keywords/list.js

@@ -0,0 +1,29 @@
+import { Command, Flags } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { adGroupScopeFlags, asaPaginationFlags, scopeParams } from '../../../lib/asa-flags.js';
+import { paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+export default class AsaNegativeKeywordsList extends Command {
+    static description = 'List negative keywords; ad_group_id is empty for campaign-level ones';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa negative-keywords list',
+        '<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID',
+    ];
+    static flags = {
+        ...asaPaginationFlags,
+        ...adGroupScopeFlags,
+        'campaign-level-only': Flags.boolean({ description: 'Keep only campaign-level rows (ad_group_id is null)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaNegativeKeywordsList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/negative-keywords', {
+            ...paginationParams(flags),
+            ...scopeParams(flags),
+            ...(flags['campaign-level-only'] ? { campaign_level_only: 'true' } : {}),
+        });
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/orgs/list.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+import type { AsaCampaignGroupDTO } from '../../../lib/asa-schemas.js';
+import { type PaginatedResponse } from '../../../lib/flags.js';
+export default class AsaOrgsList extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        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<PaginatedResponse<AsaCampaignGroupDTO>>;
+}

package/dist/commands/asa/orgs/list.js

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags } from '../../../lib/asa-flags.js';
+import { paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+export default class AsaOrgsList extends Command {
+    static description = 'List the Apple Search Ads organizations this company can spend from';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa orgs list'];
+    static flags = { ...asaPaginationFlags };
+    async run() {
+        const { flags } = await this.parse(AsaOrgsList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/campaign-groups', paginationParams(flags));
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/product-pages/list.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import type { AsaProductPageDTO } from '../../../lib/asa-schemas.js';
+import { type PaginatedResponse } from '../../../lib/flags.js';
+export default class AsaProductPagesList 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>;
+        'campaign-group': 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<PaginatedResponse<AsaProductPageDTO>>;
+}

package/dist/commands/asa/product-pages/list.js

@@ -0,0 +1,24 @@
+import { Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags, assetScopeFlags, scopeParams } from '../../../lib/asa-flags.js';
+import { paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+export default class AsaProductPagesList extends Command {
+    static description = 'List custom product pages (read-only; authoring stays in App Store Connect)';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa product-pages list',
+        '<%= config.bin %> asa product-pages list --app APP_UUID',
+    ];
+    static flags = { ...asaPaginationFlags, ...assetScopeFlags };
+    async run() {
+        const { flags } = await this.parse(AsaProductPagesList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/product-pages', {
+            ...paginationParams(flags),
+            ...scopeParams(flags),
+        });
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/product-pages/sync.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+import type { AsaProductPageSyncDTO } from '../../../lib/asa-schemas.js';
+export default class AsaProductPagesSync extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'adam-id': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'idempotency-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<AsaProductPageSyncDTO>;
+}

package/dist/commands/asa/product-pages/sync.js

@@ -0,0 +1,28 @@
+import { Command, Flags } from '@oclif/core';
+import { asaWrite, createAsaClient } from '../../../lib/asa-client.js';
+import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
+import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaProductPagesSync extends Command {
+    static description = 'Refresh custom product pages from Apple';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa product-pages sync', '<%= config.bin %> asa product-pages sync --adam-id 123456'];
+    static flags = {
+        ...confirmFlags,
+        ...idempotencyFlags,
+        'adam-id': Flags.integer({ description: 'Limit the refresh to one app; omit to cover every app' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaProductPagesSync);
+        const body = { ...(flags['adam-id'] === undefined ? {} : { adam_id: flags['adam-id'] }) };
+        await confirmMutation(this, { body, method: 'POST', path: '/product-pages/sync/', summary: 'Queue a product page refresh from Apple' }, flags.yes);
+        const client = await createAsaClient(this.config);
+        const { result } = await asaWrite(client, 'post', '/product-pages/sync', {
+            body,
+            idempotencyKey: flags['idempotency-key'],
+        });
+        this.log(result.replayed ? 'Already running; nothing new was queued.' : 'Sync queued.');
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

package/dist/commands/asa/search-terms/list.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+import type { AsaSearchTermDTO } from '../../../lib/asa-schemas.js';
+import { type PaginatedResponse } from '../../../lib/flags.js';
+export default class AsaSearchTermsList extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'ad-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        campaign: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'campaign-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        '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>;
+        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<PaginatedResponse<AsaSearchTermDTO>>;
+}

package/dist/commands/asa/search-terms/list.js

@@ -0,0 +1,25 @@
+import { Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { adGroupScopeFlags, asaPaginationFlags, periodFlags, periodParams, scopeParams } from '../../../lib/asa-flags.js';
+import { paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+export default class AsaSearchTermsList extends Command {
+    static description = 'List the search terms your ads matched, with their metrics';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31',
+        '<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID',
+    ];
+    static flags = { ...asaPaginationFlags, ...periodFlags, ...adGroupScopeFlags };
+    async run() {
+        const { flags } = await this.parse(AsaSearchTermsList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/search-terms', {
+            ...paginationParams(flags),
+            ...periodParams(flags),
+            ...scopeParams(flags),
+        });
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/whoami.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+import type { AsaMeDTO } from '../../lib/asa-schemas.js';
+export default class AsaWhoami extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<AsaMeDTO>;
+}

package/dist/commands/asa/whoami.js

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+import { createAsaClient } from '../../lib/asa-client.js';
+import { printResponse } from '../../lib/output.js';
+export default class AsaWhoami extends Command {
+    static description = 'Show which company the token unlocks and whether Apple Ads is connected';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa whoami'];
+    async run() {
+        await this.parse(AsaWhoami);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/me');
+        printResponse(result, this.log.bind(this));
+        if (result.apple_credentials_status !== 'active') {
+            this.log('\nApple Ads is not connected. Run `adapty asa connect` to link an account.');
+        }
+        if (result.access_source === 'none') {
+            this.log('\nNo active Ads Manager subscription for this company: connecting an account works, but every');
+            this.log('data command answers 402 until the subscription is in place.');
+        }
+        return result;
+    }
+}

package/dist/lib/api-client.d.ts

@@ -1,15 +1,27 @@
+import { type ApiErrorFormat } from './errors.js';
+export type QueryParams = Record<string, string | string[] | undefined>;
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    onResponse?: (headers: Headers) => void;
+}
 export interface ApiClientOptions {
     baseUrl?: string;
+    defaultBaseUrl?: string;
+    errorFormat?: ApiErrorFormat;
     token?: null | string;
+    urlEnvVar?: string;
     userAgent?: string;
 }
 export declare class ApiClient {
     private baseUrl;
+    private errorFormat;
     private token;
     private userAgent;
     constructor(opts?: ApiClientOptions);
-    get<T = unknown>(path: string, params?: Record<string, string>): Promise<T>;
-    post<T = unknown>(path: string, body?: unknown): Promise<T>;
-    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    get<T = unknown>(path: string, params?: QueryParams): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, params?: QueryParams, opts?: RequestOptions): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown, params?: QueryParams, opts?: RequestOptions): Promise<T>;
+    private buildUrl;
+    private isRetryableRateLimit;
     private request;
 }

package/dist/lib/api-client.js

@@ -1,42 +1,62 @@
 import { ApiError, NetworkError, parseApiError } from './errors.js';
 const DEFAULT_API_URL = 'https://api-admin.adapty.io/api/v1/developer';
+const MAX_RETRY_AFTER_SECONDS = 60;
 function ensureTrailingSlash(path) {
     return path.endsWith('/') ? path : `${path}/`;
 }
 export class ApiClient {
     baseUrl;
+    errorFormat;
     token;
     userAgent;
     constructor(opts = {}) {
-        this.baseUrl = (opts.baseUrl ?? process.env.ADAPTY_API_URL ?? DEFAULT_API_URL).replace(/\/$/, '');
-        if (this.baseUrl !== DEFAULT_API_URL) {
+        const defaultBaseUrl = opts.defaultBaseUrl ?? DEFAULT_API_URL;
+        const envBaseUrl = process.env[opts.urlEnvVar ?? 'ADAPTY_API_URL'];
+        this.baseUrl = (opts.baseUrl ?? envBaseUrl ?? defaultBaseUrl).replace(/\/$/, '');
+        if (this.baseUrl !== defaultBaseUrl) {
             process.stderr.write(`Warning: using non-default API URL: ${this.baseUrl}\n`);
         }
+        this.errorFormat = opts.errorFormat ?? 'developer';
         this.token = opts.token ?? null;
         this.userAgent = opts.userAgent ?? 'adapty-cli';
     }
     async get(path, params) {
-        let url = `${this.baseUrl}${ensureTrailingSlash(path)}`;
-        if (params) {
-            const qs = new URLSearchParams(params);
-            url += `?${qs.toString()}`;
-        }
-        return this.request(url, { method: 'GET' });
+        return this.request(this.buildUrl(path, params), { method: 'GET' });
     }
-    async post(path, body) {
-        return this.request(`${this.baseUrl}${ensureTrailingSlash(path)}`, {
+    async post(path, body, params, opts) {
+        return this.request(this.buildUrl(path, params), {
             body: body ? JSON.stringify(body) : undefined,
             method: 'POST',
-        });
+        }, opts);
     }
-    async put(path, body) {
-        return this.request(`${this.baseUrl}${ensureTrailingSlash(path)}`, {
+    async put(path, body, params, opts) {
+        return this.request(this.buildUrl(path, params), {
             body: body ? JSON.stringify(body) : undefined,
             method: 'PUT',
-        });
+        }, opts);
+    }
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${ensureTrailingSlash(path)}`;
+        if (!params)
+            return url;
+        const search = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            for (const item of Array.isArray(value) ? value : [value])
+                search.append(key, item);
+        }
+        return search.size === 0 ? url : `${url}?${search.toString()}`;
+    }
+    isRetryableRateLimit(error) {
+        return (this.errorFormat === 'asa' &&
+            error.statusCode === 429 &&
+            error.errorCode !== 'cli_cooldown_active' &&
+            error.retryAfterSeconds !== undefined &&
+            error.retryAfterSeconds <= MAX_RETRY_AFTER_SECONDS);
     }
     // eslint-disable-next-line no-undef
-    async request(url, init) {
+    async request(url, init, opts = {}, retried = false) {
         const headers = {
             'User-Agent': this.userAgent,
         };
@@ -46,6 +66,7 @@ export class ApiClient {
         if (this.token) {
             headers.Authorization = `Bearer ${this.token}`;
         }
+        Object.assign(headers, opts.headers);
         let response;
         try {
             response = await fetch(url, { ...init, headers });
@@ -53,24 +74,35 @@ export class ApiClient {
         catch (error) {
             throw new NetworkError(error instanceof Error ? error.message : 'Connection failed');
         }
+        opts.onResponse?.(response.headers);
         if (response.status === 204) {
             return undefined;
         }
+        const retryAfter = Number.parseInt(response.headers.get('Retry-After') ?? '', 10);
+        const errorOptions = this.errorFormat === 'asa' && !Number.isNaN(retryAfter) ? { retryAfterSeconds: retryAfter } : {};
         let body;
         try {
             body = await response.json();
         }
         catch {
             if (!response.ok) {
-                throw new ApiError(response.status, `http_${response.status}`, {});
+                throw new ApiError(response.status, `http_${response.status}`, {}, errorOptions);
             }
             return undefined;
         }
         if (!response.ok) {
-            const error = parseApiError(response.status, body);
+            const error = parseApiError(response.status, body, errorOptions, this.errorFormat);
             if (response.status === 401) {
                 error.message = 'Token expired or invalid. Run `adapty auth login`.';
             }
+            if (!retried && this.isRetryableRateLimit(error)) {
+                const seconds = error.retryAfterSeconds ?? 0;
+                process.stderr.write(`Rate limited (${error.errorCode}); waiting ${seconds}s per Retry-After, then retrying once.\n`);
+                await new Promise((resolve) => {
+                    setTimeout(resolve, seconds * 1000);
+                });
+                return this.request(url, init, opts, true);
+            }
             throw error;
         }
         return body;

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

@@ -0,0 +1,16 @@
+import type { Config } from '@oclif/core';
+import { ApiClient, type QueryParams } from './api-client.js';
+export declare const ASA_API_URL = "https://api-asa-admin.adapty.io/api/v1/cli";
+export declare const ASA_API_URL_ENV_VAR = "ADAPTY_ASA_API_URL";
+export declare function createAsaClient(config: Config): Promise<ApiClient>;
+export interface AsaWriteOptions {
+    body?: unknown;
+    idempotencyKey?: string;
+    params?: QueryParams;
+}
+export interface AsaWriteOutcome<T> {
+    replayed: boolean;
+    result: T;
+}
+export declare function asaWrite<T>(client: ApiClient, method: 'post' | 'put', path: string, opts?: AsaWriteOptions): Promise<AsaWriteOutcome<T>>;
+export declare function noteReplay(replayed: boolean, log: (msg: string) => void): void;

package/dist/lib/asa-client.js

@@ -0,0 +1,46 @@
+import { randomUUID } from 'node:crypto';
+import { ApiClient } from './api-client.js';
+import { resolveToken } from './auth.js';
+import { buildUserAgent } from './client-from-config.js';
+import { AuthRequiredError, NetworkError } from './errors.js';
+export const ASA_API_URL = 'https://api-asa-admin.adapty.io/api/v1/cli';
+export const ASA_API_URL_ENV_VAR = 'ADAPTY_ASA_API_URL';
+export async function createAsaClient(config) {
+    const token = await resolveToken(config.configDir);
+    if (!token)
+        throw new AuthRequiredError();
+    return new ApiClient({
+        defaultBaseUrl: ASA_API_URL,
+        errorFormat: 'asa',
+        token,
+        urlEnvVar: ASA_API_URL_ENV_VAR,
+        userAgent: buildUserAgent(config),
+    });
+}
+export async function asaWrite(client, method, path, opts = {}) {
+    const key = opts.idempotencyKey ?? randomUUID();
+    let replayed = false;
+    const requestOpts = {
+        headers: { 'Idempotency-Key': key },
+        onResponse(headers) {
+            replayed = headers.get('Idempotency-Replayed') === 'true';
+        },
+    };
+    const send = () => method === 'post'
+        ? client.post(path, opts.body, opts.params, requestOpts)
+        : client.put(path, opts.body, opts.params, requestOpts);
+    try {
+        const result = await send();
+        return { replayed, result };
+    }
+    catch (error) {
+        if (!(error instanceof NetworkError))
+            throw error;
+        const result = await send();
+        return { replayed, result };
+    }
+}
+export function noteReplay(replayed, log) {
+    if (replayed)
+        log('Already applied earlier — showing the stored result.');
+}

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

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export declare const confirmFlags: {
+    yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+};
+export type ConfirmDecision = 'ask' | 'proceed' | 'refuse';
+export declare function decideConfirmation(opts: {
+    isTty: boolean;
+    json: boolean;
+    yes: boolean;
+}): ConfirmDecision;
+export interface MutationPreview {
+    body?: unknown;
+    method: string;
+    path: string;
+    summary: string;
+}
+export declare function renderPreview(preview: MutationPreview): string;
+export declare function confirmMutation(command: Command, preview: MutationPreview, yes: boolean): Promise<void>;

package/dist/lib/asa-confirm.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { createInterface } from 'node:readline/promises';
+export const confirmFlags = {
+    yes: Flags.boolean({
+        char: 'y',
+        description: 'Apply without asking; required when the output is piped or --json is used',
+    }),
+};
+export function decideConfirmation(opts) {
+    if (opts.yes)
+        return 'proceed';
+    if (opts.json || !opts.isTty)
+        return 'refuse';
+    return 'ask';
+}
+export function renderPreview(preview) {
+    const lines = [preview.summary, `${preview.method} ${preview.path}`];
+    if (preview.body !== undefined)
+        lines.push(JSON.stringify(preview.body, null, 2));
+    return lines.join('\n');
+}
+export async function confirmMutation(command, preview, yes) {
+    const decision = decideConfirmation({ isTty: process.stdin.isTTY === true, json: command.jsonEnabled(), yes });
+    if (decision === 'proceed')
+        return;
+    if (decision === 'refuse') {
+        const reason = `${preview.summary} changes your account. Re-run with --yes to apply it without a prompt.`;
+        process.stderr.write(`${reason}\n${renderPreview(preview)}\n`);
+        command.error(reason, { exit: 2 });
+    }
+    process.stderr.write(`${renderPreview(preview)}\n`);
+    const reader = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        const answer = await reader.question('Apply? [y/N] ');
+        if (!/^y(es)?$/i.test(answer.trim()))
+            command.error('Cancelled, nothing was sent.', { exit: 1 });
+    }
+    finally {
+        reader.close();
+    }
+}

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

@@ -0,0 +1,88 @@
+import type { QueryParams } from './api-client.js';
+import type { AsaMoney, AsaMutationError } from './asa-schemas.js';
+export declare const MAX_BULK_ITEMS = 100;
+export declare const MAX_BY_DAYS = 16;
+export declare const ASA_METRIC_ENTITIES: string[];
+export declare const ASA_GROUP_BY_DIMENSIONS: string[];
+export declare const asaPaginationFlags: {
+    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>;
+};
+export declare const byDaysFlag: {
+    'by-days': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+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>;
+};
+export declare const assetScopeFlags: {
+    app: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'campaign-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const orgScopeFlags: {
+    search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    app: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'campaign-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const campaignScopeFlags: {
+    campaign: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    app: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'campaign-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const adGroupScopeFlags: {
+    'ad-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    campaign: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    app: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'campaign-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const adScopeFlags: {
+    search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'ad-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    campaign: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'campaign-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const statusFilter: (options: string[]) => {
+    status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+interface ScopeFlags {
+    'ad-group'?: string[];
+    app?: string[];
+    campaign?: string[];
+    'campaign-group'?: string[];
+    search?: string;
+    status?: string;
+}
+export declare function scopeParams(flags: ScopeFlags): QueryParams;
+export declare const scheduleFlags: {
+    'end-time': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    'start-time': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const pricingModelFlag: {
+    'pricing-model': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare function startOfDayUtc(date: string | undefined): string | undefined;
+export declare function todayUtc(): string;
+export declare function periodParams(flags: {
+    'date-from'?: string;
+    'date-to'?: string;
+}): Record<string, string>;
+export declare function moneyFlag(description: string, opts?: {
+    required?: boolean;
+}): import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+export declare const currencyFlag: {
+    currency: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare const idempotencyFlags: {
+    'idempotency-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+export declare function money(amount: string | undefined, currency: string): AsaMoney | undefined;
+interface BulkOutcome {
+    applied: unknown[];
+    errors: AsaMutationError[];
+    isValidationFailure: boolean;
+    kind: string;
+}
+export declare function reportBulkOutcome({ applied, errors, isValidationFailure, kind }: BulkOutcome, log: (msg: string) => void): void;
+export {};