adapty 0.3.0 → 0.4.0

package/dist/commands/asa/automations/create.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+import type { AsaAutomationMutationDTO } from '../../../lib/asa-schemas.js';
+export default class AsaAutomationsCreate extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'run-now': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'idempotency-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<AsaAutomationMutationDTO>;
+    private readRule;
+    private readStdin;
+}

package/dist/commands/asa/automations/create.js

@@ -0,0 +1,60 @@
+import { Command, Flags } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { asaWrite, createAsaClient, noteReplay } 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 AsaAutomationsCreate extends Command {
+    static description = 'Create an automation rule from a JSON rule file';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa automations create --file rule.json',
+        '<%= config.bin %> asa automations create --file rule.json --run-now',
+    ];
+    static flags = {
+        ...confirmFlags,
+        ...idempotencyFlags,
+        file: Flags.string({ description: 'JSON file with the rule body, or - to read stdin', required: true }),
+        'run-now': Flags.boolean({ description: 'Queue the first run right after the rule is stored' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaAutomationsCreate);
+        const body = await this.readRule(flags.file);
+        if (flags['run-now'])
+            body.run_immediately = true;
+        const summary = flags['run-now'] ? 'Create automation rule and run it immediately' : 'Create automation rule';
+        await confirmMutation(this, { body, method: 'POST', path: '/automations/', summary }, flags.yes);
+        const client = await createAsaClient(this.config);
+        const { replayed, result } = await asaWrite(client, 'post', '/automations', {
+            body,
+            idempotencyKey: flags['idempotency-key'],
+        });
+        noteReplay(replayed, this.log.bind(this));
+        if (result.automation && !replayed) {
+            this.log(flags['run-now'] ? 'Automation created and the first run queued!' : 'Automation created!');
+        }
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+    async readRule(path) {
+        let raw;
+        try {
+            raw = path === '-' ? await this.readStdin() : await readFile(path, 'utf8');
+        }
+        catch {
+            this.error(`Could not read ${path}.`, { exit: 2 });
+        }
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            this.error(`${path} is not valid JSON.`, { exit: 2 });
+        }
+    }
+    async readStdin() {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        return Buffer.concat(chunks).toString('utf8');
+    }
+}

package/dist/commands/asa/automations/get.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+import type { AsaAutomationDTO } from '../../../lib/asa-schemas.js';
+export default class AsaAutomationsGet extends Command {
+    static args: {
+        automation_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<AsaAutomationDTO>;
+}

package/dist/commands/asa/automations/get.js

@@ -0,0 +1,21 @@
+import { Args, Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { isValidUuid } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaAutomationsGet extends Command {
+    static args = {
+        automation_id: Args.string({ description: 'Automation rule ID (UUID)', required: true }),
+    };
+    static description = 'Show one automation rule with its conditions and actions';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000'];
+    async run() {
+        const { args } = await this.parse(AsaAutomationsGet);
+        if (!isValidUuid(args.automation_id))
+            this.error('Invalid automation ID format.', { exit: 2 });
+        const client = await createAsaClient(this.config);
+        const result = await client.get(`/automations/${args.automation_id}`);
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

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

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+import type { AsaAutomationDTO } from '../../../lib/asa-schemas.js';
+import { type PaginatedResponse } from '../../../lib/flags.js';
+export default class AsaAutomationsList 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<AsaAutomationDTO>>;
+}

package/dist/commands/asa/automations/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 AsaAutomationsList extends Command {
+    static description = 'List automation rules; status 1 is active, 0 is stopped';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa automations list'];
+    static flags = { ...asaPaginationFlags };
+    async run() {
+        const { flags } = await this.parse(AsaAutomationsList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/automations', paginationParams(flags));
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/automations/run.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+import type { AsaAutomationRunEnqueuedDTO } from '../../../lib/asa-schemas.js';
+export default class AsaAutomationsRun extends Command {
+    static args: {
+        automation_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'idempotency-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<AsaAutomationRunEnqueuedDTO>;
+}

package/dist/commands/asa/automations/run.js

@@ -0,0 +1,41 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
+import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
+import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { isValidUuid } from '../../../lib/flags.js';
+export default class AsaAutomationsRun extends Command {
+    static args = {
+        automation_id: Args.string({ description: 'Automation rule ID (UUID)', required: true }),
+    };
+    static description = 'Run an automation rule now; the run is queued, not awaited';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa automations run UUID',
+        '<%= config.bin %> asa automations run UUID --dry-run',
+    ];
+    static flags = {
+        ...confirmFlags,
+        ...idempotencyFlags,
+        'dry-run': Flags.boolean({ description: 'Evaluate and log the rule without touching Apple' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AsaAutomationsRun);
+        if (!isValidUuid(args.automation_id))
+            this.error('Invalid automation ID format.', { exit: 2 });
+        if (!flags['dry-run']) {
+            await confirmMutation(this, {
+                method: 'POST',
+                path: `/automations/${args.automation_id}/run/`,
+                summary: 'Run the rule for real — it applies its actions to Apple',
+            }, flags.yes);
+        }
+        const client = await createAsaClient(this.config);
+        const { replayed, result } = await asaWrite(client, 'post', `/automations/${args.automation_id}/run`, { idempotencyKey: flags['idempotency-key'], params: flags['dry-run'] ? { dry_run: 'true' } : undefined });
+        noteReplay(replayed, this.log.bind(this));
+        if (!replayed)
+            this.log(flags['dry-run'] ? 'Dry run queued.' : 'Run queued.');
+        this.log(`Run ID: ${result.run_id ?? 'unknown'}`);
+        this.log(`Follow it with: ${this.config.bin} asa automations runs ${args.automation_id}`);
+        return result;
+    }
+}

package/dist/commands/asa/automations/runs.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+import type { AsaAutomationRunDTO } from '../../../lib/asa-schemas.js';
+import { type PaginatedResponse } from '../../../lib/flags.js';
+export default class AsaAutomationsRuns extends Command {
+    static args: {
+        automation_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    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<AsaAutomationRunDTO>>;
+}

package/dist/commands/asa/automations/runs.js

@@ -0,0 +1,24 @@
+import { Args, Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags } from '../../../lib/asa-flags.js';
+import { isValidUuid } from '../../../lib/flags.js';
+import { paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+export default class AsaAutomationsRuns extends Command {
+    static args = {
+        automation_id: Args.string({ description: 'Automation rule ID (UUID)', required: true }),
+    };
+    static description = 'List past runs of an automation rule, including dry runs';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = { ...asaPaginationFlags };
+    async run() {
+        const { args, flags } = await this.parse(AsaAutomationsRuns);
+        if (!isValidUuid(args.automation_id))
+            this.error('Invalid automation ID format.', { exit: 2 });
+        const client = await createAsaClient(this.config);
+        const result = await client.get(`/automations/${args.automation_id}/runs`, paginationParams(flags));
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/automations/update.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+import type { AsaAutomationMutationDTO } from '../../../lib/asa-schemas.js';
+export default class AsaAutomationsUpdate extends Command {
+    static args: {
+        automation_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        start: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        stop: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'idempotency-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<AsaAutomationMutationDTO>;
+    private readRule;
+    private readStdin;
+}

package/dist/commands/asa/automations/update.js

@@ -0,0 +1,73 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
+import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
+import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { isValidUuid } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaAutomationsUpdate extends Command {
+    static args = {
+        automation_id: Args.string({ description: 'Automation rule ID (UUID)', required: true }),
+    };
+    static description = 'Change an automation rule: stop it, rename it, or replace parts of the rule';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa automations update UUID --stop',
+        '<%= config.bin %> asa automations update UUID --file rule.json',
+    ];
+    static flags = {
+        ...confirmFlags,
+        ...idempotencyFlags,
+        file: Flags.string({ description: 'JSON file with the parts to change, or - to read stdin' }),
+        name: Flags.string({ description: 'Rule name' }),
+        start: Flags.boolean({ description: 'Activate the rule', exclusive: ['stop'] }),
+        stop: Flags.boolean({ description: 'Stop the rule and clear its next run', exclusive: ['start'] }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AsaAutomationsUpdate);
+        if (!isValidUuid(args.automation_id))
+            this.error('Invalid automation ID format.', { exit: 2 });
+        const body = flags.file ? await this.readRule(flags.file) : {};
+        if (flags.name !== undefined)
+            body.name = flags.name;
+        if (flags.start)
+            body.status = 1;
+        if (flags.stop)
+            body.status = 0;
+        if (Object.keys(body).length === 0) {
+            this.error('Nothing to change. Pass --stop, --start, --name or --file.', { exit: 2 });
+        }
+        if ('internal_id' in body) {
+            this.error('Remove internal_id from the file: the rule ID comes from the command line.', { exit: 2 });
+        }
+        await confirmMutation(this, { body, method: 'PUT', path: `/automations/${args.automation_id}/`, summary: 'Update automation rule' }, flags.yes);
+        const client = await createAsaClient(this.config);
+        const { replayed, result } = await asaWrite(client, 'put', `/automations/${args.automation_id}`, { body, idempotencyKey: flags['idempotency-key'] });
+        noteReplay(replayed, this.log.bind(this));
+        if (result.automation && !replayed)
+            this.log('Automation updated!');
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+    async readRule(path) {
+        let raw;
+        try {
+            raw = path === '-' ? await this.readStdin() : await readFile(path, 'utf8');
+        }
+        catch {
+            this.error(`Could not read ${path}.`, { exit: 2 });
+        }
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            this.error(`${path} is not valid JSON.`, { exit: 2 });
+        }
+    }
+    async readStdin() {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        return Buffer.concat(chunks).toString('utf8');
+    }
+}

package/dist/commands/asa/campaigns/create.d.ts

@@ -0,0 +1,25 @@
+import { Command } from '@oclif/core';
+import type { AsaCampaignMutationDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCampaignsCreate extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'ad-channel-type': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'adam-id': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'bidding-strategy': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'billing-event': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        budget: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        country: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        'daily-budget': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        org: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'supply-source': import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        'target-cpa': import("@oclif/core/interfaces").OptionFlag<string | 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>;
+        currency: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AsaCampaignMutationDTO>;
+}

package/dist/commands/asa/campaigns/create.js

@@ -0,0 +1,67 @@
+import { Command, Flags } from '@oclif/core';
+import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
+import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
+import { currencyFlag, idempotencyFlags, money, moneyFlag } from '../../../lib/asa-flags.js';
+import { isValidUuid } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaCampaignsCreate extends Command {
+    static description = 'Create a campaign in Apple Search Ads';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa campaigns create --org UUID --name "Winter push" --adam-id 123456 --country US --daily-budget 50',
+    ];
+    static flags = {
+        ...currencyFlag,
+        ...confirmFlags,
+        ...idempotencyFlags,
+        'ad-channel-type': Flags.string({ default: 'SEARCH', description: 'Ad channel type', options: ['DISPLAY', 'SEARCH'] }),
+        'adam-id': Flags.integer({ description: 'App Store app ID (adam_id)', required: true }),
+        'bidding-strategy': Flags.string({
+            description: 'Bidding strategy; Apple defaults to MANUAL_CPT when omitted',
+            options: ['MANUAL_CPT', 'MAX_CONVERSIONS'],
+        }),
+        'billing-event': Flags.string({ default: 'TAPS', description: 'Billing event', options: ['IMPRESSIONS', 'TAPS'] }),
+        budget: moneyFlag('Lifetime budget'),
+        country: Flags.string({ description: 'Country or region code, repeatable', multiple: true, required: true }),
+        'daily-budget': moneyFlag('Daily budget', { required: true }),
+        name: Flags.string({ description: 'Campaign name', required: true }),
+        org: Flags.string({ description: 'Campaign group ID (UUID) — see `adapty asa orgs list`', required: true }),
+        status: Flags.string({ description: 'Initial status', options: ['ENABLED', 'PAUSED'] }),
+        'supply-source': Flags.string({
+            default: ['APPSTORE_SEARCH_RESULTS'],
+            description: 'Supply source, repeatable',
+            multiple: true,
+        }),
+        'target-cpa': moneyFlag('Target CPA'),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaCampaignsCreate);
+        if (!isValidUuid(flags.org))
+            this.error('Invalid org ID format.', { exit: 2 });
+        const body = {
+            ad_channel_type: flags['ad-channel-type'],
+            adam_id: flags['adam-id'],
+            bidding_strategy: flags['bidding-strategy'],
+            billing_event: flags['billing-event'],
+            budget_amount: money(flags.budget, flags.currency),
+            campaign_group_id: flags.org,
+            countries_or_regions: flags.country,
+            daily_budget_amount: money(flags['daily-budget'], flags.currency),
+            name: flags.name,
+            status: flags.status,
+            supply_sources: flags['supply-source'],
+            target_cpa: money(flags['target-cpa'], flags.currency),
+        };
+        await confirmMutation(this, { body, method: 'POST', path: '/campaigns/', summary: `Create campaign ${flags.name}` }, flags.yes);
+        const client = await createAsaClient(this.config);
+        const { replayed, result } = await asaWrite(client, 'post', '/campaigns', {
+            body,
+            idempotencyKey: flags['idempotency-key'],
+        });
+        noteReplay(replayed, this.log.bind(this));
+        if (result.campaign && !replayed)
+            this.log('Campaign created!');
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

package/dist/commands/asa/campaigns/get.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+import type { AsaCampaignDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCampaignsGet extends Command {
+    static args: {
+        campaign_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<AsaCampaignDTO>;
+}

package/dist/commands/asa/campaigns/get.js

@@ -0,0 +1,21 @@
+import { Args, Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { isValidUuid } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaCampaignsGet extends Command {
+    static args = {
+        campaign_id: Args.string({ description: 'Campaign ID (UUID)', required: true }),
+    };
+    static description = 'Show one campaign; read numbers with asa metrics';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000'];
+    async run() {
+        const { args } = await this.parse(AsaCampaignsGet);
+        if (!isValidUuid(args.campaign_id))
+            this.error('Invalid campaign ID format.', { exit: 2 });
+        const client = await createAsaClient(this.config);
+        const result = await client.get(`/campaigns/${args.campaign_id}`);
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

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

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

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

@@ -0,0 +1,24 @@
+import { Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags, orgScopeFlags, scopeParams, statusFilter } from '../../../lib/asa-flags.js';
+import { paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+export default class AsaCampaignsList extends Command {
+    static description = 'List Apple Search Ads campaigns; read numbers with asa metrics';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa campaigns list',
+        '<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED',
+    ];
+    static flags = { ...asaPaginationFlags, ...orgScopeFlags, ...statusFilter(['ENABLED', 'PAUSED']) };
+    async run() {
+        const { flags } = await this.parse(AsaCampaignsList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/campaigns', {
+            ...paginationParams(flags),
+            ...scopeParams(flags),
+        });
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/asa/campaigns/update.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@oclif/core';
+import type { AsaCampaignMutationDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCampaignsUpdate extends Command {
+    static args: {
+        campaign_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'bidding-strategy': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        budget: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        country: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'daily-budget': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: 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>;
+        'target-cpa': import("@oclif/core/interfaces").OptionFlag<string | 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>;
+        currency: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AsaCampaignMutationDTO>;
+}

package/dist/commands/asa/campaigns/update.js

@@ -0,0 +1,66 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
+import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
+import { currencyFlag, idempotencyFlags, money, moneyFlag } from '../../../lib/asa-flags.js';
+import { isValidUuid } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaCampaignsUpdate extends Command {
+    static args = {
+        campaign_id: Args.string({ description: 'Campaign ID (UUID)', required: true }),
+    };
+    static description = 'Change a campaign: budgets, countries, status or schedule';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa campaigns update UUID --status PAUSED',
+        '<%= config.bin %> asa campaigns update UUID --daily-budget 80',
+    ];
+    static flags = {
+        ...currencyFlag,
+        ...confirmFlags,
+        ...idempotencyFlags,
+        'bidding-strategy': Flags.string({
+            description: 'Bidding strategy',
+            options: ['MANUAL_CPT', 'MAX_CONVERSIONS'],
+        }),
+        budget: moneyFlag('Lifetime budget'),
+        country: Flags.string({ description: 'Replace the country list, repeatable', multiple: true }),
+        'daily-budget': moneyFlag('Daily budget'),
+        name: Flags.string({ description: 'Campaign name' }),
+        status: Flags.string({ description: 'Campaign status', options: ['ENABLED', 'PAUSED'] }),
+        'target-cpa': moneyFlag('Target CPA'),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AsaCampaignsUpdate);
+        if (!isValidUuid(args.campaign_id))
+            this.error('Invalid campaign ID format.', { exit: 2 });
+        const body = {};
+        if (flags.name !== undefined)
+            body.name = flags.name;
+        if (flags.status !== undefined)
+            body.status = flags.status;
+        if (flags.country !== undefined)
+            body.countries_or_regions = flags.country;
+        if (flags['daily-budget'] !== undefined)
+            body.daily_budget_amount = money(flags['daily-budget'], flags.currency);
+        if (flags.budget !== undefined)
+            body.budget_amount = money(flags.budget, flags.currency);
+        if (flags['target-cpa'] !== undefined)
+            body.target_cpa = money(flags['target-cpa'], flags.currency);
+        if (flags['bidding-strategy'] !== undefined)
+            body.bidding_strategy = flags['bidding-strategy'];
+        if (Object.keys(body).length === 0) {
+            this.error('Nothing to change. Pass at least one field, e.g. --status PAUSED.', { exit: 2 });
+        }
+        await confirmMutation(this, { body, method: 'PUT', path: `/campaigns/${args.campaign_id}/`, summary: 'Update campaign' }, flags.yes);
+        const client = await createAsaClient(this.config);
+        const { replayed, result } = await asaWrite(client, 'put', `/campaigns/${args.campaign_id}`, {
+            body,
+            idempotencyKey: flags['idempotency-key'],
+        });
+        noteReplay(replayed, this.log.bind(this));
+        if (result.campaign && !replayed)
+            this.log('Campaign updated!');
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

package/dist/commands/asa/competitors/summary.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+import type { AsaCompetitorsSummaryDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCompetitorsSummary extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'app-ids': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AsaCompetitorsSummaryDTO>;
+}