adapty 0.3.0 → 0.5.0

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

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

package/dist/commands/asa/apps/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 AsaAppsList extends Command {
+    static description = 'List the apps promoted by this company in Apple Search Ads';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa apps list', '<%= config.bin %> asa apps list --page 2 --page-size 50'];
+    static flags = { ...asaPaginationFlags };
+    async run() {
+        const { flags } = await this.parse(AsaAppsList);
+        const client = await createAsaClient(this.config);
+        const result = await client.get('/apps', paginationParams(flags));
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

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/bulk-create.d.ts

@@ -0,0 +1,25 @@
+import { Command } from '@oclif/core';
+import type { AsaBulkOperationStateDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCampaignsBulkCreate extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'from-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'org-id': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'poll-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        preview: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        wait: 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<AsaBulkOperationStateDTO | Record<string, unknown>>;
+    private convertTemplate;
+    private countStructure;
+    private formatIssue;
+    private readStructure;
+    private report;
+    private waitForCompletion;
+}

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

@@ -0,0 +1,177 @@
+import { Command, Flags } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+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';
+const TERMINAL_STATUSES = new Set(['failed', 'partial', 'success']);
+export default class AsaCampaignsBulkCreate extends Command {
+    static description = 'Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation';
+    static enableJsonFlag = true;
+    static 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',
+    ];
+    static flags = {
+        ...confirmFlags,
+        ...idempotencyFlags,
+        file: Flags.string({
+            description: 'JSON file with the campaign structure (the POST /bulk-operations/ body); use "-" for stdin',
+            exactlyOne: ['file', 'from-file'],
+        }),
+        'from-file': Flags.string({
+            description: 'Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit',
+        }),
+        'org-id': Flags.integer({
+            description: 'Apple org id (campaign_group_id) the converted template will target; required with --from-file',
+        }),
+        'poll-interval': Flags.integer({ default: 5, description: 'Seconds between progress polls' }),
+        preview: Flags.boolean({
+            description: 'With --from-file: print the converted request and stop, nothing is created',
+        }),
+        timeout: Flags.integer({ default: 900, description: 'Max seconds to wait for the operation to finish' }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Poll the operation until it finishes; --no-wait returns the operation id immediately',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaCampaignsBulkCreate);
+        const client = await createAsaClient(this.config);
+        const body = flags['from-file'] ? await this.convertTemplate(client, flags) : await this.readStructure(flags.file);
+        if (flags.preview) {
+            this.log(JSON.stringify(body, null, 2));
+            return body;
+        }
+        const counts = this.countStructure(body);
+        const summary = `Bulk-create: ${counts.campaigns} campaign node(s), ${counts.adGroups} ad group(s), ` +
+            `${counts.keywords} keyword(s), ${counts.negativeKeywords} negative keyword(s), ${counts.ads} ad(s)`;
+        await confirmMutation(this, { body, method: 'POST', path: '/bulk-operations/', summary }, flags.yes);
+        const { replayed, result } = await asaWrite(client, 'post', '/bulk-operations', {
+            body,
+            idempotencyKey: flags['idempotency-key'],
+        });
+        noteReplay(replayed, this.log.bind(this));
+        this.log(`Operation accepted: ${result.operation_id}`);
+        if (!flags.wait) {
+            this.log(`Check progress with: adapty asa campaigns bulk-status ${result.operation_id}`);
+            return { operation_id: result.operation_id };
+        }
+        const state = await this.waitForCompletion(client, result.operation_id, flags['poll-interval'], flags.timeout);
+        this.report(state);
+        return state;
+    }
+    async convertTemplate(client, flags) {
+        if (flags['org-id'] === undefined)
+            this.error('--org-id is required with --from-file.', { exit: 2 });
+        const path = flags['from-file'];
+        let content;
+        try {
+            content = await readFile(path);
+        }
+        catch {
+            this.error(`Cannot read file: ${path}`, { exit: 2 });
+        }
+        const form = new FormData();
+        form.append('file', new Blob([new Uint8Array(content)]), basename(path));
+        form.append('campaign_group_id', String(flags['org-id']));
+        const result = await client.postForm('/bulk-operations/convert', form);
+        for (const warning of result.warnings)
+            this.warn(this.formatIssue(warning));
+        if (result.errors.length > 0 || result.request === null) {
+            for (const issue of result.errors)
+                this.log(this.formatIssue(issue));
+            this.error(`Template conversion failed with ${result.errors.length} error(s); nothing was created.`, { exit: 2 });
+        }
+        return result.request;
+    }
+    countStructure(body) {
+        const counts = { adGroups: 0, ads: 0, campaigns: 0, keywords: 0, negativeKeywords: 0 };
+        const campaigns = Array.isArray(body.campaigns) ? body.campaigns : [];
+        counts.campaigns = campaigns.length;
+        for (const campaign of campaigns) {
+            if (typeof campaign !== 'object' || campaign === null)
+                continue;
+            const campaignNode = campaign;
+            counts.negativeKeywords += Array.isArray(campaignNode.negative_keywords) ? campaignNode.negative_keywords.length : 0;
+            const adGroups = Array.isArray(campaignNode.ad_groups) ? campaignNode.ad_groups : [];
+            counts.adGroups += adGroups.length;
+            for (const adGroup of adGroups) {
+                if (typeof adGroup !== 'object' || adGroup === null)
+                    continue;
+                const adGroupNode = adGroup;
+                counts.keywords += Array.isArray(adGroupNode.keywords) ? adGroupNode.keywords.length : 0;
+                counts.negativeKeywords += Array.isArray(adGroupNode.negative_keywords) ? adGroupNode.negative_keywords.length : 0;
+                counts.ads += Array.isArray(adGroupNode.ads) ? adGroupNode.ads.length : 0;
+            }
+        }
+        return counts;
+    }
+    formatIssue(issue) {
+        const place = [issue.sheet, issue.row === null ? undefined : `row ${issue.row}`, issue.column ?? undefined]
+            .filter(Boolean)
+            .join(', ');
+        return place ? `${place}: ${issue.message}` : issue.message;
+    }
+    async readStructure(source) {
+        let raw;
+        if (source === '-') {
+            const chunks = [];
+            for await (const chunk of process.stdin)
+                chunks.push(chunk);
+            raw = Buffer.concat(chunks).toString('utf8');
+        }
+        else {
+            try {
+                raw = await readFile(source, 'utf8');
+            }
+            catch {
+                this.error(`Cannot read file: ${source}`, { exit: 2 });
+            }
+        }
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            this.error('The structure is not valid JSON.', { exit: 2 });
+        }
+    }
+    report(state) {
+        const { counts } = state;
+        this.log(`Finished: ${state.status} — ${counts.applied}/${counts.total} applied, ${counts.failed} failed`);
+        const failedObjects = state.objects.filter((object) => object.status === 'failed');
+        for (const object of failedObjects) {
+            printResponse(object, this.log.bind(this));
+            this.log('---');
+        }
+        if (state.status === 'failed')
+            this.error('Bulk operation failed.', { exit: 1 });
+        if (state.status === 'partial')
+            this.warn('Some objects were not created — see the failures above.');
+    }
+    async waitForCompletion(client, operationId, pollIntervalSeconds, timeoutSeconds) {
+        const startedAt = Date.now();
+        let lastProgress = '';
+        for (;;) {
+            const state = await client.get(`/bulk-operations/${operationId}`);
+            const progress = `${state.status}: ${state.counts.applied}/${state.counts.total} applied, ${state.counts.failed} failed`;
+            if (progress !== lastProgress) {
+                this.log(progress);
+                lastProgress = progress;
+            }
+            if (TERMINAL_STATUSES.has(state.status))
+                return state;
+            if ((Date.now() - startedAt) / 1000 >= timeoutSeconds) {
+                this.warn(`Still ${state.status} after ${timeoutSeconds}s — check later with: adapty asa campaigns bulk-status ${operationId}`);
+                return state;
+            }
+            await new Promise((resolve) => {
+                setTimeout(resolve, pollIntervalSeconds * 1000);
+            });
+        }
+    }
+}

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

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import type { AsaBulkOperationStateDTO } from '../../../lib/asa-schemas.js';
+export default class AsaCampaignsBulkStatus extends Command {
+    static args: {
+        'operation-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<AsaBulkOperationStateDTO>;
+}

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

@@ -0,0 +1,26 @@
+import { Args, Command } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags } from '../../../lib/asa-flags.js';
+import { isValidUuid, paginationParams } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class AsaCampaignsBulkStatus extends Command {
+    static args = {
+        'operation-id': Args.string({ description: 'Bulk operation ID returned by bulk-create', required: true }),
+    };
+    static description = 'Progress board of one bulk operation: counts, pipelines and the per-object log';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001'];
+    static flags = {
+        ...asaPaginationFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(AsaCampaignsBulkStatus);
+        const operationId = args['operation-id'];
+        if (!isValidUuid(operationId))
+            this.error('Invalid operation ID format.', { exit: 2 });
+        const client = await createAsaClient(this.config);
+        const state = await client.get(`/bulk-operations/${operationId}`, paginationParams(flags));
+        printResponse(state, this.log.bind(this));
+        return state;
+    }
+}