adapty 0.8.4-beta.1 → 0.8.5

package/README.md

@@ -12,7 +12,7 @@
 npm install -g adapty
 ```
 
-Requires Node.js >= 18.
+Requires Node.js 22 or 24. Node 18 and 20 are past end-of-life and are not supported.
 
 ## Authentication
 
@@ -199,12 +199,142 @@ 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]
-adapty asa automations update AUTOMATION_ID [--stop] [--start] [--name "..."] [--file rule.json]
+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 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/bin/dev.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
 
-import {execute} from '@oclif/core'
+import { execute } from '@oclif/core';
 
-await execute({development: true, dir: import.meta.url})
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-import {execute} from '@oclif/core'
+import { execute } from '@oclif/core';
 
-await execute({dir: import.meta.url})
+await execute({ dir: import.meta.url });

package/dist/commands/access-levels/create.js

@@ -11,7 +11,7 @@ export default class AccessLevelsCreate extends Command {
     static flags = {
         ...appFlag,
         'sdk-id': Flags.string({ description: 'Access level SDK identifier', required: true }),
-        title: Flags.string({ description: 'Access level title', required: true }),
+        'title': Flags.string({ description: 'Access level title', required: true }),
     };
     async run() {
         const { flags } = await this.parse(AccessLevelsCreate);

package/dist/commands/access-levels/list.d.ts

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AccessLevelDTO } from '../../lib/api-schemas.js';
-import { type PaginatedResponse } from '../../lib/flags.js';
+import type { PaginatedResponse } from '../../lib/flags.js';
 export default class AccessLevelsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;

package/dist/commands/apps/create.js

@@ -11,13 +11,13 @@ export default class AppsCreate extends Command {
     static flags = {
         'apple-bundle-id': Flags.string({ description: 'Apple bundle ID (required with --platform ios)' }),
         'google-bundle-id': Flags.string({ description: 'Google bundle ID (required with --platform android)' }),
-        platform: Flags.string({
+        'platform': Flags.string({
             description: 'Platform (ios, android). Repeat for multiple.',
             multiple: true,
             options: ['ios', 'android'],
             required: true,
         }),
-        title: Flags.string({ description: 'App title', required: true }),
+        'title': Flags.string({ description: 'App title', required: true }),
     };
     async run() {
         const { flags } = await this.parse(AppsCreate);
@@ -32,18 +32,21 @@ export default class AppsCreate extends Command {
             platforms: flags.platform,
             title: flags.title,
         };
-        if (flags['apple-bundle-id'])
+        if (flags['apple-bundle-id']) {
             body.apple_bundle_id = flags['apple-bundle-id'];
-        if (flags['google-bundle-id'])
+        }
+        if (flags['google-bundle-id']) {
             body.google_bundle_id = flags['google-bundle-id'];
+        }
         const result = await client.post('/apps', body);
         this.log('App created!');
         printResponse(result, this.log.bind(this));
         try {
             const accessLevels = await client.get(`/apps/${result.id}/access-levels`);
-            if (accessLevels.items?.length) {
+            const [defaultAccessLevel] = accessLevels.items ?? [];
+            if (defaultAccessLevel) {
                 this.log('\nDefault access level:');
-                printResponse(accessLevels.items[0], this.log.bind(this));
+                printResponse(defaultAccessLevel, this.log.bind(this));
             }
         }
         catch {

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

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AppSummaryDTO } from '../../lib/api-schemas.js';
-import { type PaginatedResponse } from '../../lib/flags.js';
+import type { PaginatedResponse } from '../../lib/flags.js';
 export default class AppsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;

package/dist/commands/apps/update.js

@@ -12,7 +12,7 @@ export default class AppsUpdate extends Command {
     static flags = {
         'apple-bundle-id': Flags.string({ description: 'Apple bundle ID' }),
         'google-bundle-id': Flags.string({ description: 'Google bundle ID' }),
-        title: Flags.string({ description: 'App title' }),
+        'title': Flags.string({ description: 'App title' }),
     };
     async run() {
         const { args, flags } = await this.parse(AppsUpdate);
@@ -24,12 +24,15 @@ export default class AppsUpdate extends Command {
         }
         const client = await createAuthenticatedClient(this.config);
         const body = {};
-        if (flags.title)
+        if (flags.title) {
             body.title = flags.title;
-        if (flags['apple-bundle-id'])
+        }
+        if (flags['apple-bundle-id']) {
             body.apple_bundle_id = flags['apple-bundle-id'];
-        if (flags['google-bundle-id'])
+        }
+        if (flags['google-bundle-id']) {
             body.google_bundle_id = flags['google-bundle-id'];
+        }
         const result = await client.put(`/apps/${args.app_id}`, body);
         this.log('App updated!');
         printResponse(result, this.log.bind(this));

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

@@ -18,21 +18,22 @@ export default class AsaAdGroupsCreate extends Command {
         ...pricingModelFlag,
         ...confirmFlags,
         ...idempotencyFlags,
-        automated: Flags.boolean({
+        'automated': Flags.boolean({
             description: 'Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)',
             exclusive: ['automated-keywords'],
         }),
         'automated-keywords': Flags.boolean({ allowNo: true, description: 'Let Apple add keywords automatically' }),
-        campaign: Flags.string({ description: 'Campaign ID (UUID)', required: true }),
+        'campaign': Flags.string({ description: 'Campaign ID (UUID)', required: true }),
         'cpa-goal': moneyFlag('CPA goal'),
         'default-bid': moneyFlag('Default bid; required unless --automated is set'),
-        name: Flags.string({ description: 'Ad group name', required: true }),
-        status: Flags.string({ description: 'Initial status', options: ['ENABLED', 'PAUSED'] }),
+        'name': Flags.string({ description: 'Ad group name', required: true }),
+        'status': Flags.string({ description: 'Initial status', options: ['ENABLED', 'PAUSED'] }),
     };
     async run() {
         const { flags } = await this.parse(AsaAdGroupsCreate);
-        if (!isValidUuid(flags.campaign))
+        if (!isValidUuid(flags.campaign)) {
             this.error('Invalid campaign ID format.', { exit: 2 });
+        }
         if (!flags.automated && flags['default-bid'] === undefined) {
             this.error('--default-bid is required unless --automated is set.', { exit: 2 });
         }
@@ -55,14 +56,15 @@ export default class AsaAdGroupsCreate extends Command {
             status: flags.status,
         };
         await confirmMutation(this, { body, method: 'POST', path: '/ad-groups/', summary: `Create ad group ${flags.name}` }, flags.yes);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         const { replayed, result } = await asaWrite(client, 'post', '/ad-groups', {
             body,
             idempotencyKey: flags['idempotency-key'],
         });
         noteReplay(replayed, this.log.bind(this));
-        if (result.ad_group && !replayed)
+        if (result.ad_group && !replayed) {
             this.log('Ad group created!');
+        }
         printResponse(result, this.log.bind(this));
         return result;
     }

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

@@ -11,9 +11,10 @@ export default class AsaAdGroupsGet extends Command {
     static examples = ['<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000'];
     async run() {
         const { args } = await this.parse(AsaAdGroupsGet);
-        if (!isValidUuid(args.ad_group_id))
+        if (!isValidUuid(args.ad_group_id)) {
             this.error('Invalid ad group ID format.', { exit: 2 });
-        const client = await createAsaClient(this.config);
+        }
+        const client = await createAsaClient(this);
         const result = await client.get(`/ad-groups/${args.ad_group_id}`);
         printResponse(result, this.log.bind(this));
         return result;

package/dist/commands/asa/ad-groups/list.d.ts

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AsaAdGroupDTO } from '../../../lib/asa-schemas.js';
-import { type PaginatedResponse } from '../../../lib/flags.js';
+import type { PaginatedResponse } from '../../../lib/flags.js';
 export default class AsaAdGroupsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;

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

@@ -13,7 +13,7 @@ export default class AsaAdGroupsList extends Command {
     static flags = { ...asaPaginationFlags, ...campaignScopeFlags, ...statusFilter(['ENABLED', 'PAUSED']) };
     async run() {
         const { flags } = await this.parse(AsaAdGroupsList);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         const result = await client.get('/ad-groups', {
             ...paginationParams(flags),
             ...scopeParams(flags),

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

@@ -22,40 +22,50 @@ export default class AsaAdGroupsUpdate extends Command {
         'automated-keywords': Flags.boolean({ allowNo: true, description: 'Let Apple add keywords automatically' }),
         'cpa-goal': moneyFlag('CPA goal'),
         'default-bid': moneyFlag('Default bid'),
-        name: Flags.string({ description: 'Ad group name' }),
-        status: Flags.string({ description: 'Ad group status', options: ['ENABLED', 'PAUSED'] }),
+        'name': Flags.string({ description: 'Ad group name' }),
+        'status': Flags.string({ description: 'Ad group status', options: ['ENABLED', 'PAUSED'] }),
     };
     async run() {
         const { args, flags } = await this.parse(AsaAdGroupsUpdate);
-        if (!isValidUuid(args.ad_group_id))
+        if (!isValidUuid(args.ad_group_id)) {
             this.error('Invalid ad group ID format.', { exit: 2 });
+        }
         const body = {};
-        if (flags.name !== undefined)
+        if (flags.name !== undefined) {
             body.name = flags.name;
-        if (flags.status !== undefined)
+        }
+        if (flags.status !== undefined) {
             body.status = flags.status;
-        if (flags['default-bid'] !== undefined)
+        }
+        if (flags['default-bid'] !== undefined) {
             body.default_bid_amount = money(flags['default-bid'], flags.currency);
-        if (flags['cpa-goal'] !== undefined)
+        }
+        if (flags['cpa-goal'] !== undefined) {
             body.cpa_goal = money(flags['cpa-goal'], flags.currency);
-        if (flags['automated-keywords'] !== undefined)
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- FIXME if you see this
+        if (flags['automated-keywords'] !== undefined) {
             body.automated_keywords_opt_in = flags['automated-keywords'];
-        if (flags['start-time'] !== undefined)
+        }
+        if (flags['start-time'] !== undefined) {
             body.start_time = startOfDayUtc(flags['start-time']);
-        if (flags['end-time'] !== undefined)
+        }
+        if (flags['end-time'] !== undefined) {
             body.end_time = startOfDayUtc(flags['end-time']);
+        }
         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: `/ad-groups/${args.ad_group_id}/`, summary: 'Update ad group' }, flags.yes);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         const { replayed, result } = await asaWrite(client, 'put', `/ad-groups/${args.ad_group_id}`, {
             body,
             idempotencyKey: flags['idempotency-key'],
         });
         noteReplay(replayed, this.log.bind(this));
-        if (result.ad_group && !replayed)
+        if (result.ad_group && !replayed) {
             this.log('Ad group updated!');
+        }
         printResponse(result, this.log.bind(this));
         return result;
     }

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

@@ -13,13 +13,14 @@ export default class AsaAdsCreate extends Command {
         ...idempotencyFlags,
         'ad-group': Flags.string({ description: 'Ad group ID (UUID) — the campaign is resolved from it', required: true }),
         'creative-id': Flags.integer({ description: 'Apple creative ID from a product page or the default set', required: true }),
-        name: Flags.string({ description: 'Ad name', required: true }),
-        status: Flags.string({ description: 'Initial status', options: ['ENABLED', 'PAUSED'] }),
+        'name': Flags.string({ description: 'Ad name', required: true }),
+        'status': Flags.string({ description: 'Initial status', options: ['ENABLED', 'PAUSED'] }),
     };
     async run() {
         const { flags } = await this.parse(AsaAdsCreate);
-        if (!isValidUuid(flags['ad-group']))
+        if (!isValidUuid(flags['ad-group'])) {
             this.error('Invalid ad group ID format.', { exit: 2 });
+        }
         const body = {
             ad_group_id: flags['ad-group'],
             creative_id: flags['creative-id'],
@@ -27,14 +28,15 @@ export default class AsaAdsCreate extends Command {
             ...(flags.status === undefined ? {} : { status: flags.status }),
         };
         await confirmMutation(this, { body, method: 'POST', path: '/ads/', summary: `Create ad ${flags.name}` }, flags.yes);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         const { replayed, result } = await asaWrite(client, 'post', '/ads', {
             body,
             idempotencyKey: flags['idempotency-key'],
         });
         noteReplay(replayed, this.log.bind(this));
-        if (result.ad && !replayed)
+        if (result.ad && !replayed) {
             this.log('Ad created!');
+        }
         printResponse(result, this.log.bind(this));
         return result;
     }

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

@@ -11,9 +11,10 @@ export default class AsaAdsGet extends Command {
     static examples = ['<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000'];
     async run() {
         const { args } = await this.parse(AsaAdsGet);
-        if (!isValidUuid(args.ad_id))
+        if (!isValidUuid(args.ad_id)) {
             this.error('Invalid ad ID format.', { exit: 2 });
-        const client = await createAsaClient(this.config);
+        }
+        const client = await createAsaClient(this);
         const result = await client.get(`/ads/${args.ad_id}`);
         printResponse(result, this.log.bind(this));
         return result;

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

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AsaAdDTO } from '../../../lib/asa-schemas.js';
-import { type PaginatedResponse } from '../../../lib/flags.js';
+import type { PaginatedResponse } from '../../../lib/flags.js';
 export default class AsaAdsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;

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

@@ -13,7 +13,7 @@ export default class AsaAdsList extends Command {
     static flags = { ...asaPaginationFlags, ...adScopeFlags, ...statusFilter(['ENABLED', 'PAUSED']) };
     async run() {
         const { flags } = await this.parse(AsaAdsList);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         const result = await client.get('/ads', {
             ...paginationParams(flags),
             ...scopeParams(flags),

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

@@ -19,25 +19,29 @@ export default class AsaAdsUpdate extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(AsaAdsUpdate);
-        if (!isValidUuid(args.ad_id))
+        if (!isValidUuid(args.ad_id)) {
             this.error('Invalid ad ID format.', { exit: 2 });
+        }
         const body = {};
-        if (flags.name !== undefined)
+        if (flags.name !== undefined) {
             body.name = flags.name;
-        if (flags.status !== undefined)
+        }
+        if (flags.status !== undefined) {
             body.status = flags.status;
+        }
         if (Object.keys(body).length === 0) {
             this.error('Nothing to change. Pass --name or --status.', { exit: 2 });
         }
         await confirmMutation(this, { body, method: 'PUT', path: `/ads/${args.ad_id}/`, summary: 'Update ad' }, flags.yes);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         const { replayed, result } = await asaWrite(client, 'put', `/ads/${args.ad_id}`, {
             body,
             idempotencyKey: flags['idempotency-key'],
         });
         noteReplay(replayed, this.log.bind(this));
-        if (result.ad && !replayed)
+        if (result.ad && !replayed) {
             this.log('Ad updated!');
+        }
         printResponse(result, this.log.bind(this));
         return result;
     }

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

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AsaAppDTO } from '../../../lib/asa-schemas.js';
-import { type PaginatedResponse } from '../../../lib/flags.js';
+import type { PaginatedResponse } from '../../../lib/flags.js';
 export default class AsaAppsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;

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

@@ -10,7 +10,7 @@ export default class AsaAppsList extends Command {
     static flags = { ...asaPaginationFlags };
     async run() {
         const { flags } = await this.parse(AsaAppsList);
-        const client = await createAsaClient(this.config);
+        const client = await createAsaClient(this);
         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

@@ -9,8 +9,17 @@ 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,30 +1,36 @@
-import { Command, Flags } from '@oclif/core';
 import { readFile } from 'node:fs/promises';
+import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { addKeywordActionFlags, idempotencyFlags } from '../../../lib/asa-flags.js';
+import { hasAddKeywordActionFlags, rebuildAddKeywordAction, requireSingleAction, } from '../../../lib/asa-keyword-action.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';
+    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 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 }),
+        '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'])
+        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);
+        const client = await createAsaClient(this);
         const { replayed, result } = await asaWrite(client, 'post', '/automations', {
             body,
             idempotencyKey: flags['idempotency-key'],
@@ -36,6 +42,18 @@ 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 {
@@ -53,8 +71,9 @@ export default class AsaAutomationsCreate extends Command {
     }
     async readStdin() {
         const chunks = [];
-        for await (const chunk of process.stdin)
+        for await (const chunk of process.stdin) {
             chunks.push(chunk);
+        }
         return Buffer.concat(chunks).toString('utf8');
     }
 }