adapty 0.8.3 → 0.8.4-beta.1

package/README.md

@@ -199,142 +199,12 @@ adapty asa product-pages sync [--adam-id 123456]
 
 adapty asa automations list
 adapty asa automations get AUTOMATION_ID
-adapty asa automations create --file rule.json [--run-now] [--target-ad-group UUID ...]
-adapty asa automations update AUTOMATION_ID [--stop] [--start] [--name "..."] [--file rule.json] [--target-ad-group UUID ...]
+adapty asa automations create --file rule.json [--run-now]
+adapty asa automations update AUTOMATION_ID [--stop] [--start] [--name "..."] [--file rule.json]
 adapty asa automations run AUTOMATION_ID [--dry-run]
 adapty asa automations runs AUTOMATION_ID
 ```
 
-A rule file carries the whole rule: `name`, `status` (1 active, 0 stopped), `operate_with` (what the
-rule iterates over), `apply_to` (where it looks), exactly one condition, exactly one action and a
-`run_frequency`. The API stores one action and one condition per rule and rejects anything else.
-
-| Field           | Shape                                                                                       |
-| --------------- | ------------------------------------------------------------------------------------------- |
-| `operate_with`  | `search-term`, `targeting-keyword`, `campaign`, `ad-group`                                   |
-| `apply_to[]`    | `{"internal_id": UUID, "type": "campaign-group" \| "app" \| "campaign" \| "ad-group" \| "targeting-keywords"}` |
-| `conditions[0]` | `{"operator": ..., "args": number, "operand": {...}}`, or `{"operator": "and" \| "or", "args": [condition, ...]}` |
-| `operator`      | `eq`, `neq`, `gt`, `gte`, `lt`, `lte` for a leaf; `and`, `or` to nest                        |
-| `operand.field` | a metric name in dashboard nomenclature — the same vocabulary `asa metrics --metric` takes    |
-| `date_range_type` | `today`, `yesterday`, `last_1_d`, `last_3_d`, `last_7_d`, `last_14_d`, `last_28_d`, `last_30_d`, `last_60_d`, `last_90_d`, `custom` |
-| `run_frequency` | `{"type": "daily", "hour": 8}`, `{"type": "hour", "value": 24, "start_time": 8}`, `{"type": "weekly", "weekdays": ["monday"], "hour": 8}`, `{"type": "monthly", "days": [1], "hour": 8}`, `{"type": "once", "date_time": "2026-10-01T09:00:00Z"}` — `hour` and `start_time` are UTC |
-
-The `add-as-keyword-to` action promotes what the rule found into a keyword in one or more target ad
-groups. Its `params` differ by `operate_with`, and the API picks the variant by shape without a
-discriminator: a key that belongs to another variant makes it silently choose that variant and drop
-the rest, which is how a rule ends up as "Add as keyword to 0 ad groups". `negate` and
-`skip_enable_duplicate_keywords` exist only on a `search-term` rule, `pause_in_original_ad_group`
-only on a `targeting-keyword` one, and `targets` holds `internal_ids` — never `ids`.
-
-A full `search-term` rule — every term with 10+ taps over the last week becomes an exact keyword in
-the target ad group at the term's own CPT, and is negated in the ad group it came from:
-
-```json
-{
-  "name": "Search term harvester",
-  "status": 1,
-  "operate_with": "search-term",
-  "apply_to": [{"internal_id": "CAMPAIGN_UUID", "type": "campaign"}],
-  "conditions": [
-    {
-      "operator": "gte",
-      "args": 10,
-      "operand": {
-        "field": "taps",
-        "field_type": "base_field",
-        "date_range_type": "last_7_d",
-        "date_range_size": 0,
-        "date_range_offset": 0,
-        "by_days": null
-      }
-    }
-  ],
-  "actions": [
-    {
-      "type": "add-as-keyword-to",
-      "params": {
-        "targets": {"type": "ad-group", "internal_ids": ["AD_GROUP_UUID"]},
-        "cpt_bid": {"type": "search_term_current_cpt", "value": null},
-        "match_type": "EXACT",
-        "negate": {"enabled": true, "type": "ad-group"},
-        "skip_enable_duplicate_keywords": false
-      }
-    }
-  ],
-  "run_frequency": {"type": "daily", "hour": 8}
-}
-```
-
-The same action on a `targeting-keyword` rule — a broad keyword that has earned installs graduates
-into the exact ad group at its current bid and is paused where it was:
-
-```json
-{
-  "name": "Graduate broad keywords to exact",
-  "status": 1,
-  "operate_with": "targeting-keyword",
-  "apply_to": [{"internal_id": "SOURCE_AD_GROUP_UUID", "type": "ad-group"}],
-  "conditions": [
-    {
-      "operator": "gte",
-      "args": 3,
-      "operand": {
-        "field": "total_installs",
-        "field_type": "base_field",
-        "date_range_type": "last_14_d",
-        "date_range_size": 0,
-        "date_range_offset": 0,
-        "by_days": null
-      }
-    }
-  ],
-  "actions": [
-    {
-      "type": "add-as-keyword-to",
-      "params": {
-        "targets": {"type": "ad-group", "internal_ids": ["EXACT_AD_GROUP_UUID"]},
-        "cpt_bid": {"type": "keyword_current_bid", "value": null},
-        "match_type": "EXACT",
-        "pause_in_original_ad_group": true
-      }
-    }
-  ],
-  "run_frequency": {"type": "daily", "hour": 8}
-}
-```
-
-Rather than hand-writing that `params` block, pass the action flags — they fill in or override
-`actions[0].params` in the file, and the CLI refuses a rule the API would have quietly accepted and
-broken:
-
-```sh
-adapty asa automations create --file rule.json --target-ad-group AD_GROUP_UUID \
-  --match-type EXACT --cpt-bid-type search_term_current_cpt --negate ad-group
-adapty asa automations create --file rule.json --target-ad-group AD_GROUP_UUID \
-  --match-type BROAD --cpt-bid-type set_to --cpt-bid 1.50 --no-negate --skip-enable-duplicates
-adapty asa automations update AUTOMATION_ID --target-ad-group AD_GROUP_UUID \
-  --match-type EXACT --cpt-bid-type search_term_current_cpt
-```
-
-| Flag                       | Where it lands                                                        |
-| -------------------------- | --------------------------------------------------------------------- |
-| `--target-ad-group`        | `targets.internal_ids`, repeatable; a rule without one does nothing    |
-| `--match-type`             | `match_type`: `BROAD` or `EXACT`                                      |
-| `--cpt-bid-type`           | `cpt_bid.type`: `ad_group_default_bid`, `set_to`, `search_term_current_cpt`, `keyword_current_bid` |
-| `--cpt-bid`                | `cpt_bid.value`: the bid itself with `set_to` (required), a percent markup on the entity's own bid with `search_term_current_cpt` / `keyword_current_bid`, rejected with `ad_group_default_bid` |
-| `--negate` / `--no-negate` | `negate` (search-term rules): `ad-group` or `campaign`, or off        |
-| `--skip-enable-duplicates` | `skip_enable_duplicate_keywords` (search-term rules)                  |
-| `--pause-original`         | `pause_in_original_ad_group` (targeting-keyword rules)                |
-
-`--cpt-bid-type` and `--match-type` have no defaults, here or in the API: a bid and a match type are
-a spend decision and a reach decision, so when `params` are built from scratch the CLI asks for them
-instead of guessing. On `update`, an action flag turns the call into a read-modify-write — the rule
-is read, `actions[0].params` is rebuilt and the whole `actions` list is written back, since the API
-replaces it wholesale. That also repairs a rule whose stored `params` carry the wrong shape: only
-the keys that fit are kept, the strays are dropped, and anything missing has to come from a flag. A
-dashboard edit made between the read and the write is overwritten.
-
-
 Metrics take an entity level, a period and an optional metric selection. Rows come back one per entity,
 aggregated and sorted server-side, so a top-N or a breakdown is a single call — use `--order-by` with a small
 `--page-size` for rankings, `metrics overview` for account totals and time series, and one big page (up to

package/dist/commands/asa/ad-groups/create.js

@@ -1,7 +1,7 @@
 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, pricingModelFlag, scheduleFlags, startOfDayUtc, todayUtc, } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdGroupsCreate extends Command {

package/dist/commands/asa/ad-groups/update.js

@@ -1,7 +1,7 @@
 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, scheduleFlags, startOfDayUtc } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdGroupsUpdate extends Command {

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

@@ -1,7 +1,7 @@
 import { 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 { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdsCreate extends Command {

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

@@ -1,7 +1,7 @@
 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 { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdsUpdate extends Command {

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

@@ -9,17 +9,8 @@ export default class AsaAutomationsCreate extends Command {
         '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>;
-        'cpt-bid': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'cpt-bid-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'match-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        negate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'no-negate': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'pause-original': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'skip-enable-duplicates': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'target-ad-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<AsaAutomationMutationDTO>;
-    private applyActionFlags;
     private readRule;
     private readStdin;
 }

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

@@ -1,21 +1,17 @@
 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 { addKeywordActionFlags, idempotencyFlags } from '../../../lib/asa-flags.js';
-import { hasAddKeywordActionFlags, rebuildAddKeywordAction, requireSingleAction, } from '../../../lib/asa-keyword-action.js';
+import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAutomationsCreate extends Command {
-    static description = 'Create an automation rule from a JSON rule file. The add-as-keyword action flags fill in or override actions[0].params, so the bid, the match type and the target ad groups need no hand-written JSON.';
+    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',
-        '<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt',
-        '<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type set_to --cpt-bid 1.50 --negate ad-group',
     ];
     static flags = {
-        ...addKeywordActionFlags,
         ...confirmFlags,
         ...idempotencyFlags,
         file: Flags.string({ description: 'JSON file with the rule body, or - to read stdin', required: true }),
@@ -26,7 +22,6 @@ export default class AsaAutomationsCreate extends Command {
         const body = await this.readRule(flags.file);
         if (flags['run-now'])
             body.run_immediately = true;
-        this.applyActionFlags(body, flags);
         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);
@@ -41,17 +36,6 @@ export default class AsaAutomationsCreate extends Command {
         printResponse(result, this.log.bind(this));
         return result;
     }
-    applyActionFlags(body, flags) {
-        try {
-            requireSingleAction(body.actions);
-            if (!hasAddKeywordActionFlags(flags))
-                return;
-            body.actions = rebuildAddKeywordAction(body.actions, body.operate_with, flags);
-        }
-        catch (error) {
-            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
-        }
-    }
     async readRule(path) {
         let raw;
         try {

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

@@ -1,7 +1,7 @@
 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 { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaAutomationsRun extends Command {
     static args = {

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

@@ -14,17 +14,8 @@ export default class AsaAutomationsUpdate extends Command {
         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>;
-        'cpt-bid': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'cpt-bid-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'match-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        negate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'no-negate': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'pause-original': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'skip-enable-duplicates': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'target-ad-group': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<AsaAutomationMutationDTO>;
     private readRule;
     private readStdin;
-    private rebuildAction;
 }

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

@@ -1,24 +1,21 @@
 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 { addKeywordActionFlags, idempotencyFlags } from '../../../lib/asa-flags.js';
-import { hasAddKeywordActionFlags, rebuildAddKeywordAction, } from '../../../lib/asa-keyword-action.js';
+import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.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. An add-as-keyword action flag turns the call into a read-modify-write: the rule is read, actions[0].params is rebuilt from the flags and the whole actions list is written back — an edit someone makes in the dashboard in between is overwritten. This is also the way to repair a rule whose stored params carry the wrong shape.';
+    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',
-        '<%= config.bin %> asa automations update UUID --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt',
     ];
     static flags = {
-        ...addKeywordActionFlags,
         ...confirmFlags,
         ...idempotencyFlags,
         file: Flags.string({ description: 'JSON file with the parts to change, or - to read stdin' }),
@@ -37,17 +34,14 @@ export default class AsaAutomationsUpdate extends Command {
             body.status = 1;
         if (flags.stop)
             body.status = 0;
-        const actionFlags = hasAddKeywordActionFlags(flags);
-        if (Object.keys(body).length === 0 && !actionFlags) {
-            this.error('Nothing to change. Pass --stop, --start, --name, --file or an action flag.', { exit: 2 });
+        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 });
         }
-        const client = await createAsaClient(this.config);
-        if (actionFlags)
-            await this.rebuildAction(client, args.automation_id, body, flags);
         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)
@@ -76,14 +70,4 @@ export default class AsaAutomationsUpdate extends Command {
             chunks.push(chunk);
         return Buffer.concat(chunks).toString('utf8');
     }
-    // Read-modify-write: the API replaces `actions` wholesale, so the whole list has to be sent back.
-    async rebuildAction(client, automationId, body, flags) {
-        const rule = await client.get(`/automations/${automationId}`);
-        try {
-            body.actions = rebuildAddKeywordAction(body.actions ?? rule.actions, body.operate_with ?? rule.operate_with, flags);
-        }
-        catch (error) {
-            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
-        }
-    }
 }

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

@@ -2,8 +2,8 @@ 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 { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { printResponse } from '../../../lib/output.js';
 const TERMINAL_STATUSES = new Set(['failed', 'partial', 'success']);
 export default class AsaCampaignsBulkCreate extends Command {

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

@@ -1,7 +1,7 @@
 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, invoiceFlags, locInvoiceDetails, money, moneyFlag, reportServingState, } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaCampaignsCreate extends Command {

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

@@ -1,7 +1,7 @@
 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, invoiceFlags, locInvoiceDetails, money, moneyFlag, reportServingState, } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaCampaignsUpdate extends Command {

package/dist/commands/asa/keywords/add.js

@@ -1,8 +1,8 @@
 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 { currencyFlag, idempotencyFlags, MAX_BULK_ITEMS, money, moneyFlag, reportBulkOutcome } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaKeywordsAdd extends Command {
     static description = 'Add targeting keywords to an ad group';

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

@@ -1,7 +1,7 @@
 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, reportBulkOutcome } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaKeywordsUpdate extends Command {
     static args = {

package/dist/commands/asa/metrics/index.d.ts

@@ -9,13 +9,10 @@ export default class AsaMetrics extends Command {
         'date-to': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         entity: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'group-by': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        metric: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        metric: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         order: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'order-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'order-by-day': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'ad-group': 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: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'by-days': import("@oclif/core/interfaces").OptionFlag<number[] | 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>;

package/dist/commands/asa/metrics/index.js

@@ -1,6 +1,6 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient } from '../../../lib/asa-client.js';
-import { ASA_GROUP_BY_DIMENSIONS, ASA_METRIC_ENTITIES, asaPaginationFlags, byDaysFlag, MAX_BY_DAYS, metricsScopeBody, metricsScopeFlags, } from '../../../lib/asa-flags.js';
+import { ASA_GROUP_BY_DIMENSIONS, ASA_METRIC_ENTITIES, asaPaginationFlags, byDaysFlag, MAX_BY_DAYS } from '../../../lib/asa-flags.js';
 import { paginationParams } from '../../../lib/flags.js';
 import { printList } from '../../../lib/output.js';
 export default class AsaMetrics extends Command {
@@ -10,29 +10,21 @@ One row per entity, already aggregated server-side and sorted by --order-by, so
 call with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to
 asa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when
 day is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by
-coarsening the grouping, not by splitting into more calls. Each page is also capped at 5000 breakdown
+coarsening the grouping, not by splitting into more calls. Each page is also capped at 20000 breakdown
 rows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen
 the grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most
-2 per 10 seconds, one at a time.
-
---metric is required and every metric named is computed over the whole entity set, so ask for the
-columns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)
-count unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they
-are refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way
-to make any call fast, since cost follows the number of entities aggregated, not the page size.`;
+2 per 10 seconds, one at a time.`;
     static enableJsonFlag = true;
     static examples = [
-        '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs',
-        '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5',
-        '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --group-by country --page-size 1000',
+        '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31',
+        '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5',
+        '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000',
         '<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas',
         '<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90',
-        '<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric arpas --campaign 0f0e...',
     ];
     static flags = {
         ...asaPaginationFlags,
         ...byDaysFlag,
-        ...metricsScopeFlags,
         'date-from': Flags.string({ description: 'Start of the period (YYYY-MM-DD)', required: true }),
         'date-to': Flags.string({ description: 'End of the period (YYYY-MM-DD)', required: true }),
         entity: Flags.string({ description: 'What to report on', options: ASA_METRIC_ENTITIES, required: true }),
@@ -42,9 +34,8 @@ to make any call fast, since cost follows the number of entities aggregated, not
             options: ASA_GROUP_BY_DIMENSIONS,
         }),
         metric: Flags.string({
-            description: 'Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable and required; every metric asked for is computed over the whole entity set, so list only what you read; a wrong name fails listing all valid ones',
+            description: 'Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones',
             multiple: true,
-            required: true,
         }),
         order: Flags.string({ default: 'desc', description: 'Sort direction', options: ['asc', 'desc'] }),
         'order-by': Flags.string({
@@ -65,9 +56,8 @@ to make any call fast, since cost follows the number of entities aggregated, not
                 date_from: flags['date-from'],
                 date_to: flags['date-to'],
                 entity: flags.entity,
-                metrics: flags.metric,
                 order: flags.order,
-                ...metricsScopeBody(flags),
+                ...(flags.metric === undefined ? {} : { metrics: flags.metric }),
                 ...(flags['by-days'] === undefined ? {} : { by_days: flags['by-days'] }),
                 ...(flags['group-by'] === undefined ? {} : { group_by: flags['group-by'] }),
                 ...(flags['order-by'] === undefined ? {} : { order_by: flags['order-by'] }),

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

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags, MAX_BULK_ITEMS, reportBulkOutcome } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaNegativeKeywordsAdd extends Command {
     static description = 'Add negative keywords to an ad group or across a campaign';

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

@@ -1,7 +1,7 @@
 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 { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaProductPagesSync extends Command {
     static description = 'Refresh custom product pages from Apple';

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

@@ -6,7 +6,8 @@ export default class FlowsConfigGet extends Command {
     static args = {
         flow_id: Args.string({ description: 'Flow ID (UUID)', required: true }),
     };
-    static description = 'Read the flow builder config (404 until the config has been written at least once)';
+    static description = 'Read the flow builder config (404 until the config has been written at least once). ' +
+        'On a failed publish, `publication_status`, `transform_error` and `publication_error` show why.';
     static enableJsonFlag = true;
     static examples = ['<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000'];
     static flags = {

package/dist/commands/flows/publish.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import type { FlowDTO } from '../../lib/api-schemas.js';
+export default class FlowsPublish extends Command {
+    static args: {
+        flow_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<FlowDTO>;
+}

package/dist/commands/flows/publish.js

@@ -0,0 +1,52 @@
+import { Args, Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { confirmFlags, confirmMutation } from '../../lib/confirm.js';
+import { ApiError } from '../../lib/errors.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+import { flowFixLinks } from '../../lib/flow-help.js';
+import { printResponse } from '../../lib/output.js';
+export default class FlowsPublish extends Command {
+    static args = {
+        flow_id: Args.string({ description: 'Flow ID (UUID)', required: true }),
+    };
+    static description = 'Publish a flow (async — publication completes in the background). ' +
+        'Publishing is async: returns status `publishing`. Poll `adapty flows get <flow_id>` for `published`/`publication_failed`; on failure, `adapty flows config get <flow_id>` shows why.';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = {
+        ...appFlag,
+        ...confirmFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsPublish);
+        if (!isValidUuid(args.flow_id)) {
+            this.error('Invalid flow ID format.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const flow = await client.get(`/apps/${flags.app}/flows/${args.flow_id}/`);
+        await confirmMutation(this, {
+            method: 'POST',
+            path: `/apps/${flags.app}/flows/${args.flow_id}/publish/`,
+            summary: `Publish flow "${flow.name}" live to end users`,
+        }, flags.yes);
+        let result;
+        try {
+            result = await client.post(`/apps/${flags.app}/flows/${args.flow_id}/publish/`);
+        }
+        catch (error) {
+            if (error instanceof ApiError && (error.statusCode === 400 || error.errorCode === 'validation_error')) {
+                this.error(`Flow publish failed: ${error.message}\n` +
+                    'Publishing needs a flow with a valid config. Fix it, then run `adapty flows publish` again:\n' +
+                    flowFixLinks(args.flow_id), { exit: 1 });
+            }
+            throw error;
+        }
+        if (!this.jsonEnabled()) {
+            this.log('Publishing started — status: publishing. This is asynchronous; the flow is NOT published yet.');
+            this.log(`Check progress:  adapty flows get --app ${flags.app} ${args.flow_id}   (wait for status 'published' or 'publication_failed')`);
+            this.log(`If it fails:     adapty flows config get --app ${flags.app} ${args.flow_id}   (shows why)`);
+        }
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

package/dist/commands/flows/update.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import type { FlowDTO } from '../../lib/api-schemas.js';
+export default class FlowsUpdate extends Command {
+    static args: {
+        flow_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<FlowDTO>;
+}