adapty 0.6.0 → 0.6.1-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/README.md +28 -0
  2. package/dist/commands/auth/login.d.ts +2 -0
  3. package/dist/commands/auth/login.js +13 -2
  4. package/dist/commands/flows/config/preview.d.ts +18 -0
  5. package/dist/commands/flows/config/preview.js +74 -0
  6. package/dist/commands/flows/config/validate.d.ts +20 -0
  7. package/dist/commands/flows/config/validate.js +81 -0
  8. package/dist/lib/api-schemas.d.ts +15 -0
  9. package/dist/lib/app-url.d.ts +10 -0
  10. package/dist/lib/app-url.js +33 -0
  11. package/dist/lib/preview.d.ts +27 -0
  12. package/dist/lib/preview.js +48 -0
  13. package/oclif.manifest.json +1193 -1053
  14. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -1072,256 +1072,6 @@
1072
1072
  "update.js"
1073
1073
  ]
1074
1074
  },
1075
- "placements:create": {
1076
- "aliases": [],
1077
- "args": {},
1078
- "description": "Create a placement with a paywall",
1079
- "examples": [
1080
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1081
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1082
- ],
1083
- "flags": {
1084
- "json": {
1085
- "description": "Format output as json.",
1086
- "helpGroup": "GLOBAL",
1087
- "name": "json",
1088
- "allowNo": false,
1089
- "type": "boolean"
1090
- },
1091
- "app": {
1092
- "description": "App ID (UUID)",
1093
- "name": "app",
1094
- "required": true,
1095
- "hasDynamicHelp": false,
1096
- "multiple": false,
1097
- "type": "option"
1098
- },
1099
- "audiences": {
1100
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1101
- "name": "audiences",
1102
- "hasDynamicHelp": false,
1103
- "multiple": false,
1104
- "type": "option"
1105
- },
1106
- "developer-id": {
1107
- "description": "Developer ID for the placement",
1108
- "name": "developer-id",
1109
- "required": true,
1110
- "hasDynamicHelp": false,
1111
- "multiple": false,
1112
- "type": "option"
1113
- },
1114
- "paywall-id": {
1115
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1116
- "name": "paywall-id",
1117
- "hasDynamicHelp": false,
1118
- "multiple": false,
1119
- "type": "option"
1120
- },
1121
- "title": {
1122
- "description": "Placement title",
1123
- "name": "title",
1124
- "required": true,
1125
- "hasDynamicHelp": false,
1126
- "multiple": false,
1127
- "type": "option"
1128
- }
1129
- },
1130
- "hasDynamicHelp": false,
1131
- "hiddenAliases": [],
1132
- "id": "placements:create",
1133
- "pluginAlias": "adapty",
1134
- "pluginName": "adapty",
1135
- "pluginType": "core",
1136
- "strict": true,
1137
- "enableJsonFlag": true,
1138
- "isESM": true,
1139
- "relativePath": [
1140
- "dist",
1141
- "commands",
1142
- "placements",
1143
- "create.js"
1144
- ]
1145
- },
1146
- "placements:get": {
1147
- "aliases": [],
1148
- "args": {
1149
- "placement_id": {
1150
- "description": "Placement ID (UUID)",
1151
- "name": "placement_id",
1152
- "required": true
1153
- }
1154
- },
1155
- "description": "Get placement details",
1156
- "examples": [
1157
- "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1158
- ],
1159
- "flags": {
1160
- "json": {
1161
- "description": "Format output as json.",
1162
- "helpGroup": "GLOBAL",
1163
- "name": "json",
1164
- "allowNo": false,
1165
- "type": "boolean"
1166
- },
1167
- "app": {
1168
- "description": "App ID (UUID)",
1169
- "name": "app",
1170
- "required": true,
1171
- "hasDynamicHelp": false,
1172
- "multiple": false,
1173
- "type": "option"
1174
- }
1175
- },
1176
- "hasDynamicHelp": false,
1177
- "hiddenAliases": [],
1178
- "id": "placements:get",
1179
- "pluginAlias": "adapty",
1180
- "pluginName": "adapty",
1181
- "pluginType": "core",
1182
- "strict": true,
1183
- "enableJsonFlag": true,
1184
- "isESM": true,
1185
- "relativePath": [
1186
- "dist",
1187
- "commands",
1188
- "placements",
1189
- "get.js"
1190
- ]
1191
- },
1192
- "placements:list": {
1193
- "aliases": [],
1194
- "args": {},
1195
- "description": "List placements for an app",
1196
- "examples": [
1197
- "<%= config.bin %> placements list --app 550e8400-..."
1198
- ],
1199
- "flags": {
1200
- "json": {
1201
- "description": "Format output as json.",
1202
- "helpGroup": "GLOBAL",
1203
- "name": "json",
1204
- "allowNo": false,
1205
- "type": "boolean"
1206
- },
1207
- "app": {
1208
- "description": "App ID (UUID)",
1209
- "name": "app",
1210
- "required": true,
1211
- "hasDynamicHelp": false,
1212
- "multiple": false,
1213
- "type": "option"
1214
- },
1215
- "page": {
1216
- "description": "Page number",
1217
- "name": "page",
1218
- "default": 1,
1219
- "hasDynamicHelp": false,
1220
- "multiple": false,
1221
- "type": "option"
1222
- },
1223
- "page-size": {
1224
- "description": "Items per page (max 100)",
1225
- "name": "page-size",
1226
- "default": 20,
1227
- "hasDynamicHelp": false,
1228
- "multiple": false,
1229
- "type": "option"
1230
- }
1231
- },
1232
- "hasDynamicHelp": false,
1233
- "hiddenAliases": [],
1234
- "id": "placements:list",
1235
- "pluginAlias": "adapty",
1236
- "pluginName": "adapty",
1237
- "pluginType": "core",
1238
- "strict": true,
1239
- "enableJsonFlag": true,
1240
- "isESM": true,
1241
- "relativePath": [
1242
- "dist",
1243
- "commands",
1244
- "placements",
1245
- "list.js"
1246
- ]
1247
- },
1248
- "placements:update": {
1249
- "aliases": [],
1250
- "args": {
1251
- "placement_id": {
1252
- "description": "Placement ID (UUID)",
1253
- "name": "placement_id",
1254
- "required": true
1255
- }
1256
- },
1257
- "description": "Update a placement",
1258
- "examples": [
1259
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1260
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1261
- ],
1262
- "flags": {
1263
- "json": {
1264
- "description": "Format output as json.",
1265
- "helpGroup": "GLOBAL",
1266
- "name": "json",
1267
- "allowNo": false,
1268
- "type": "boolean"
1269
- },
1270
- "app": {
1271
- "description": "App ID (UUID)",
1272
- "name": "app",
1273
- "required": true,
1274
- "hasDynamicHelp": false,
1275
- "multiple": false,
1276
- "type": "option"
1277
- },
1278
- "audiences": {
1279
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1280
- "name": "audiences",
1281
- "hasDynamicHelp": false,
1282
- "multiple": false,
1283
- "type": "option"
1284
- },
1285
- "developer-id": {
1286
- "description": "Developer ID for the placement",
1287
- "name": "developer-id",
1288
- "required": true,
1289
- "hasDynamicHelp": false,
1290
- "multiple": false,
1291
- "type": "option"
1292
- },
1293
- "paywall-id": {
1294
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1295
- "name": "paywall-id",
1296
- "hasDynamicHelp": false,
1297
- "multiple": false,
1298
- "type": "option"
1299
- },
1300
- "title": {
1301
- "description": "Placement title",
1302
- "name": "title",
1303
- "required": true,
1304
- "hasDynamicHelp": false,
1305
- "multiple": false,
1306
- "type": "option"
1307
- }
1308
- },
1309
- "hasDynamicHelp": false,
1310
- "hiddenAliases": [],
1311
- "id": "placements:update",
1312
- "pluginAlias": "adapty",
1313
- "pluginName": "adapty",
1314
- "pluginType": "core",
1315
- "strict": true,
1316
- "enableJsonFlag": true,
1317
- "isESM": true,
1318
- "relativePath": [
1319
- "dist",
1320
- "commands",
1321
- "placements",
1322
- "update.js"
1323
- ]
1324
- },
1325
1075
  "products:create": {
1326
1076
  "aliases": [],
1327
1077
  "args": {},
@@ -1708,13 +1458,263 @@
1708
1458
  "list.js"
1709
1459
  ]
1710
1460
  },
1711
- "asa:ad-groups:create": {
1461
+ "placements:create": {
1712
1462
  "aliases": [],
1713
1463
  "args": {},
1714
- "description": "Create an ad group inside a campaign",
1464
+ "description": "Create a placement with a paywall",
1715
1465
  "examples": [
1716
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1717
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM"
1466
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1467
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1468
+ ],
1469
+ "flags": {
1470
+ "json": {
1471
+ "description": "Format output as json.",
1472
+ "helpGroup": "GLOBAL",
1473
+ "name": "json",
1474
+ "allowNo": false,
1475
+ "type": "boolean"
1476
+ },
1477
+ "app": {
1478
+ "description": "App ID (UUID)",
1479
+ "name": "app",
1480
+ "required": true,
1481
+ "hasDynamicHelp": false,
1482
+ "multiple": false,
1483
+ "type": "option"
1484
+ },
1485
+ "audiences": {
1486
+ "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1487
+ "name": "audiences",
1488
+ "hasDynamicHelp": false,
1489
+ "multiple": false,
1490
+ "type": "option"
1491
+ },
1492
+ "developer-id": {
1493
+ "description": "Developer ID for the placement",
1494
+ "name": "developer-id",
1495
+ "required": true,
1496
+ "hasDynamicHelp": false,
1497
+ "multiple": false,
1498
+ "type": "option"
1499
+ },
1500
+ "paywall-id": {
1501
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1502
+ "name": "paywall-id",
1503
+ "hasDynamicHelp": false,
1504
+ "multiple": false,
1505
+ "type": "option"
1506
+ },
1507
+ "title": {
1508
+ "description": "Placement title",
1509
+ "name": "title",
1510
+ "required": true,
1511
+ "hasDynamicHelp": false,
1512
+ "multiple": false,
1513
+ "type": "option"
1514
+ }
1515
+ },
1516
+ "hasDynamicHelp": false,
1517
+ "hiddenAliases": [],
1518
+ "id": "placements:create",
1519
+ "pluginAlias": "adapty",
1520
+ "pluginName": "adapty",
1521
+ "pluginType": "core",
1522
+ "strict": true,
1523
+ "enableJsonFlag": true,
1524
+ "isESM": true,
1525
+ "relativePath": [
1526
+ "dist",
1527
+ "commands",
1528
+ "placements",
1529
+ "create.js"
1530
+ ]
1531
+ },
1532
+ "placements:get": {
1533
+ "aliases": [],
1534
+ "args": {
1535
+ "placement_id": {
1536
+ "description": "Placement ID (UUID)",
1537
+ "name": "placement_id",
1538
+ "required": true
1539
+ }
1540
+ },
1541
+ "description": "Get placement details",
1542
+ "examples": [
1543
+ "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1544
+ ],
1545
+ "flags": {
1546
+ "json": {
1547
+ "description": "Format output as json.",
1548
+ "helpGroup": "GLOBAL",
1549
+ "name": "json",
1550
+ "allowNo": false,
1551
+ "type": "boolean"
1552
+ },
1553
+ "app": {
1554
+ "description": "App ID (UUID)",
1555
+ "name": "app",
1556
+ "required": true,
1557
+ "hasDynamicHelp": false,
1558
+ "multiple": false,
1559
+ "type": "option"
1560
+ }
1561
+ },
1562
+ "hasDynamicHelp": false,
1563
+ "hiddenAliases": [],
1564
+ "id": "placements:get",
1565
+ "pluginAlias": "adapty",
1566
+ "pluginName": "adapty",
1567
+ "pluginType": "core",
1568
+ "strict": true,
1569
+ "enableJsonFlag": true,
1570
+ "isESM": true,
1571
+ "relativePath": [
1572
+ "dist",
1573
+ "commands",
1574
+ "placements",
1575
+ "get.js"
1576
+ ]
1577
+ },
1578
+ "placements:list": {
1579
+ "aliases": [],
1580
+ "args": {},
1581
+ "description": "List placements for an app",
1582
+ "examples": [
1583
+ "<%= config.bin %> placements list --app 550e8400-..."
1584
+ ],
1585
+ "flags": {
1586
+ "json": {
1587
+ "description": "Format output as json.",
1588
+ "helpGroup": "GLOBAL",
1589
+ "name": "json",
1590
+ "allowNo": false,
1591
+ "type": "boolean"
1592
+ },
1593
+ "app": {
1594
+ "description": "App ID (UUID)",
1595
+ "name": "app",
1596
+ "required": true,
1597
+ "hasDynamicHelp": false,
1598
+ "multiple": false,
1599
+ "type": "option"
1600
+ },
1601
+ "page": {
1602
+ "description": "Page number",
1603
+ "name": "page",
1604
+ "default": 1,
1605
+ "hasDynamicHelp": false,
1606
+ "multiple": false,
1607
+ "type": "option"
1608
+ },
1609
+ "page-size": {
1610
+ "description": "Items per page (max 100)",
1611
+ "name": "page-size",
1612
+ "default": 20,
1613
+ "hasDynamicHelp": false,
1614
+ "multiple": false,
1615
+ "type": "option"
1616
+ }
1617
+ },
1618
+ "hasDynamicHelp": false,
1619
+ "hiddenAliases": [],
1620
+ "id": "placements:list",
1621
+ "pluginAlias": "adapty",
1622
+ "pluginName": "adapty",
1623
+ "pluginType": "core",
1624
+ "strict": true,
1625
+ "enableJsonFlag": true,
1626
+ "isESM": true,
1627
+ "relativePath": [
1628
+ "dist",
1629
+ "commands",
1630
+ "placements",
1631
+ "list.js"
1632
+ ]
1633
+ },
1634
+ "placements:update": {
1635
+ "aliases": [],
1636
+ "args": {
1637
+ "placement_id": {
1638
+ "description": "Placement ID (UUID)",
1639
+ "name": "placement_id",
1640
+ "required": true
1641
+ }
1642
+ },
1643
+ "description": "Update a placement",
1644
+ "examples": [
1645
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1646
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1647
+ ],
1648
+ "flags": {
1649
+ "json": {
1650
+ "description": "Format output as json.",
1651
+ "helpGroup": "GLOBAL",
1652
+ "name": "json",
1653
+ "allowNo": false,
1654
+ "type": "boolean"
1655
+ },
1656
+ "app": {
1657
+ "description": "App ID (UUID)",
1658
+ "name": "app",
1659
+ "required": true,
1660
+ "hasDynamicHelp": false,
1661
+ "multiple": false,
1662
+ "type": "option"
1663
+ },
1664
+ "audiences": {
1665
+ "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1666
+ "name": "audiences",
1667
+ "hasDynamicHelp": false,
1668
+ "multiple": false,
1669
+ "type": "option"
1670
+ },
1671
+ "developer-id": {
1672
+ "description": "Developer ID for the placement",
1673
+ "name": "developer-id",
1674
+ "required": true,
1675
+ "hasDynamicHelp": false,
1676
+ "multiple": false,
1677
+ "type": "option"
1678
+ },
1679
+ "paywall-id": {
1680
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1681
+ "name": "paywall-id",
1682
+ "hasDynamicHelp": false,
1683
+ "multiple": false,
1684
+ "type": "option"
1685
+ },
1686
+ "title": {
1687
+ "description": "Placement title",
1688
+ "name": "title",
1689
+ "required": true,
1690
+ "hasDynamicHelp": false,
1691
+ "multiple": false,
1692
+ "type": "option"
1693
+ }
1694
+ },
1695
+ "hasDynamicHelp": false,
1696
+ "hiddenAliases": [],
1697
+ "id": "placements:update",
1698
+ "pluginAlias": "adapty",
1699
+ "pluginName": "adapty",
1700
+ "pluginType": "core",
1701
+ "strict": true,
1702
+ "enableJsonFlag": true,
1703
+ "isESM": true,
1704
+ "relativePath": [
1705
+ "dist",
1706
+ "commands",
1707
+ "placements",
1708
+ "update.js"
1709
+ ]
1710
+ },
1711
+ "asa:ad-groups:create": {
1712
+ "aliases": [],
1713
+ "args": {},
1714
+ "description": "Create an ad group inside a campaign",
1715
+ "examples": [
1716
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1717
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM"
1718
1718
  ],
1719
1719
  "flags": {
1720
1720
  "json": {
@@ -2361,13 +2361,13 @@
2361
2361
  "update.js"
2362
2362
  ]
2363
2363
  },
2364
- "asa:automations:create": {
2364
+ "asa:apps:list": {
2365
2365
  "aliases": [],
2366
2366
  "args": {},
2367
- "description": "Create an automation rule from a JSON rule file",
2367
+ "description": "List the apps promoted by this company in Apple Search Ads",
2368
2368
  "examples": [
2369
- "<%= config.bin %> asa automations create --file rule.json",
2370
- "<%= config.bin %> asa automations create --file rule.json --run-now"
2369
+ "<%= config.bin %> asa apps list",
2370
+ "<%= config.bin %> asa apps list --page 2 --page-size 50"
2371
2371
  ],
2372
2372
  "flags": {
2373
2373
  "json": {
@@ -2377,38 +2377,26 @@
2377
2377
  "allowNo": false,
2378
2378
  "type": "boolean"
2379
2379
  },
2380
- "yes": {
2381
- "char": "y",
2382
- "description": "Apply without asking; required when the output is piped or --json is used",
2383
- "name": "yes",
2384
- "allowNo": false,
2385
- "type": "boolean"
2386
- },
2387
- "idempotency-key": {
2388
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2389
- "name": "idempotency-key",
2380
+ "page": {
2381
+ "description": "Page number",
2382
+ "name": "page",
2383
+ "default": 1,
2390
2384
  "hasDynamicHelp": false,
2391
2385
  "multiple": false,
2392
2386
  "type": "option"
2393
2387
  },
2394
- "file": {
2395
- "description": "JSON file with the rule body, or - to read stdin",
2396
- "name": "file",
2397
- "required": true,
2388
+ "page-size": {
2389
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2390
+ "name": "page-size",
2391
+ "default": 100,
2398
2392
  "hasDynamicHelp": false,
2399
2393
  "multiple": false,
2400
2394
  "type": "option"
2401
- },
2402
- "run-now": {
2403
- "description": "Queue the first run right after the rule is stored",
2404
- "name": "run-now",
2405
- "allowNo": false,
2406
- "type": "boolean"
2407
2395
  }
2408
2396
  },
2409
2397
  "hasDynamicHelp": false,
2410
2398
  "hiddenAliases": [],
2411
- "id": "asa:automations:create",
2399
+ "id": "asa:apps:list",
2412
2400
  "pluginAlias": "adapty",
2413
2401
  "pluginName": "adapty",
2414
2402
  "pluginType": "core",
@@ -2419,22 +2407,16 @@
2419
2407
  "dist",
2420
2408
  "commands",
2421
2409
  "asa",
2422
- "automations",
2423
- "create.js"
2410
+ "apps",
2411
+ "list.js"
2424
2412
  ]
2425
2413
  },
2426
- "asa:automations:get": {
2414
+ "asa:competitors:summary": {
2427
2415
  "aliases": [],
2428
- "args": {
2429
- "automation_id": {
2430
- "description": "Automation rule ID (UUID)",
2431
- "name": "automation_id",
2432
- "required": true
2433
- }
2434
- },
2435
- "description": "Show one automation rule with its conditions and actions",
2416
+ "args": {},
2417
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2436
2418
  "examples": [
2437
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2419
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2438
2420
  ],
2439
2421
  "flags": {
2440
2422
  "json": {
@@ -2443,11 +2425,19 @@
2443
2425
  "name": "json",
2444
2426
  "allowNo": false,
2445
2427
  "type": "boolean"
2428
+ },
2429
+ "app-ids": {
2430
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2431
+ "name": "app-ids",
2432
+ "required": true,
2433
+ "hasDynamicHelp": false,
2434
+ "multiple": false,
2435
+ "type": "option"
2446
2436
  }
2447
2437
  },
2448
2438
  "hasDynamicHelp": false,
2449
2439
  "hiddenAliases": [],
2450
- "id": "asa:automations:get",
2440
+ "id": "asa:competitors:summary",
2451
2441
  "pluginAlias": "adapty",
2452
2442
  "pluginName": "adapty",
2453
2443
  "pluginType": "core",
@@ -2458,16 +2448,17 @@
2458
2448
  "dist",
2459
2449
  "commands",
2460
2450
  "asa",
2461
- "automations",
2462
- "get.js"
2451
+ "competitors",
2452
+ "summary.js"
2463
2453
  ]
2464
2454
  },
2465
- "asa:automations:list": {
2455
+ "asa:creatives:list": {
2466
2456
  "aliases": [],
2467
2457
  "args": {},
2468
- "description": "List automation rules; status 1 is active, 0 is stopped",
2458
+ "description": "List creatives; creative_id is what `asa ads create` needs",
2469
2459
  "examples": [
2470
- "<%= config.bin %> asa automations list"
2460
+ "<%= config.bin %> asa creatives list",
2461
+ "<%= config.bin %> asa creatives list --app APP_UUID"
2471
2462
  ],
2472
2463
  "flags": {
2473
2464
  "json": {
@@ -2492,11 +2483,25 @@
2492
2483
  "hasDynamicHelp": false,
2493
2484
  "multiple": false,
2494
2485
  "type": "option"
2486
+ },
2487
+ "app": {
2488
+ "description": "Keep only rows in this app; repeatable",
2489
+ "name": "app",
2490
+ "hasDynamicHelp": false,
2491
+ "multiple": true,
2492
+ "type": "option"
2493
+ },
2494
+ "campaign-group": {
2495
+ "description": "Keep only rows in this campaign group; repeatable",
2496
+ "name": "campaign-group",
2497
+ "hasDynamicHelp": false,
2498
+ "multiple": true,
2499
+ "type": "option"
2495
2500
  }
2496
2501
  },
2497
2502
  "hasDynamicHelp": false,
2498
2503
  "hiddenAliases": [],
2499
- "id": "asa:automations:list",
2504
+ "id": "asa:creatives:list",
2500
2505
  "pluginAlias": "adapty",
2501
2506
  "pluginName": "adapty",
2502
2507
  "pluginType": "core",
@@ -2507,23 +2512,19 @@
2507
2512
  "dist",
2508
2513
  "commands",
2509
2514
  "asa",
2510
- "automations",
2515
+ "creatives",
2511
2516
  "list.js"
2512
2517
  ]
2513
2518
  },
2514
- "asa:automations:run": {
2519
+ "asa:campaigns:bulk-create": {
2515
2520
  "aliases": [],
2516
- "args": {
2517
- "automation_id": {
2518
- "description": "Automation rule ID (UUID)",
2519
- "name": "automation_id",
2520
- "required": true
2521
- }
2522
- },
2523
- "description": "Run an automation rule now; the run is queued, not awaited",
2521
+ "args": {},
2522
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2524
2523
  "examples": [
2525
- "<%= config.bin %> asa automations run UUID",
2526
- "<%= config.bin %> asa automations run UUID --dry-run"
2524
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2525
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2526
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2527
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2527
2528
  ],
2528
2529
  "flags": {
2529
2530
  "json": {
@@ -2547,16 +2548,59 @@
2547
2548
  "multiple": false,
2548
2549
  "type": "option"
2549
2550
  },
2550
- "dry-run": {
2551
- "description": "Evaluate and log the rule without touching Apple",
2552
- "name": "dry-run",
2551
+ "file": {
2552
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2553
+ "name": "file",
2554
+ "hasDynamicHelp": false,
2555
+ "multiple": false,
2556
+ "type": "option"
2557
+ },
2558
+ "from-file": {
2559
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2560
+ "name": "from-file",
2561
+ "hasDynamicHelp": false,
2562
+ "multiple": false,
2563
+ "type": "option"
2564
+ },
2565
+ "org-id": {
2566
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2567
+ "name": "org-id",
2568
+ "hasDynamicHelp": false,
2569
+ "multiple": false,
2570
+ "type": "option"
2571
+ },
2572
+ "poll-interval": {
2573
+ "description": "Seconds between progress polls",
2574
+ "name": "poll-interval",
2575
+ "default": 5,
2576
+ "hasDynamicHelp": false,
2577
+ "multiple": false,
2578
+ "type": "option"
2579
+ },
2580
+ "preview": {
2581
+ "description": "With --from-file: print the converted request and stop, nothing is created",
2582
+ "name": "preview",
2553
2583
  "allowNo": false,
2554
2584
  "type": "boolean"
2585
+ },
2586
+ "timeout": {
2587
+ "description": "Max seconds to wait for the operation to finish",
2588
+ "name": "timeout",
2589
+ "default": 900,
2590
+ "hasDynamicHelp": false,
2591
+ "multiple": false,
2592
+ "type": "option"
2593
+ },
2594
+ "wait": {
2595
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2596
+ "name": "wait",
2597
+ "allowNo": true,
2598
+ "type": "boolean"
2555
2599
  }
2556
2600
  },
2557
2601
  "hasDynamicHelp": false,
2558
2602
  "hiddenAliases": [],
2559
- "id": "asa:automations:run",
2603
+ "id": "asa:campaigns:bulk-create",
2560
2604
  "pluginAlias": "adapty",
2561
2605
  "pluginName": "adapty",
2562
2606
  "pluginType": "core",
@@ -2567,22 +2611,22 @@
2567
2611
  "dist",
2568
2612
  "commands",
2569
2613
  "asa",
2570
- "automations",
2571
- "run.js"
2614
+ "campaigns",
2615
+ "bulk-create.js"
2572
2616
  ]
2573
2617
  },
2574
- "asa:automations:runs": {
2618
+ "asa:campaigns:bulk-status": {
2575
2619
  "aliases": [],
2576
2620
  "args": {
2577
- "automation_id": {
2578
- "description": "Automation rule ID (UUID)",
2579
- "name": "automation_id",
2621
+ "operation-id": {
2622
+ "description": "Bulk operation ID returned by bulk-create",
2623
+ "name": "operation-id",
2580
2624
  "required": true
2581
2625
  }
2582
2626
  },
2583
- "description": "List past runs of an automation rule, including dry runs",
2627
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2584
2628
  "examples": [
2585
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2629
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2586
2630
  ],
2587
2631
  "flags": {
2588
2632
  "json": {
@@ -2611,7 +2655,7 @@
2611
2655
  },
2612
2656
  "hasDynamicHelp": false,
2613
2657
  "hiddenAliases": [],
2614
- "id": "asa:automations:runs",
2658
+ "id": "asa:campaigns:bulk-status",
2615
2659
  "pluginAlias": "adapty",
2616
2660
  "pluginName": "adapty",
2617
2661
  "pluginType": "core",
@@ -2622,23 +2666,16 @@
2622
2666
  "dist",
2623
2667
  "commands",
2624
2668
  "asa",
2625
- "automations",
2626
- "runs.js"
2669
+ "campaigns",
2670
+ "bulk-status.js"
2627
2671
  ]
2628
2672
  },
2629
- "asa:automations:update": {
2673
+ "asa:campaigns:create": {
2630
2674
  "aliases": [],
2631
- "args": {
2632
- "automation_id": {
2633
- "description": "Automation rule ID (UUID)",
2634
- "name": "automation_id",
2635
- "required": true
2636
- }
2637
- },
2638
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2675
+ "args": {},
2676
+ "description": "Create a campaign in Apple Search Ads",
2639
2677
  "examples": [
2640
- "<%= config.bin %> asa automations update UUID --stop",
2641
- "<%= config.bin %> asa automations update UUID --file rule.json"
2678
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2642
2679
  ],
2643
2680
  "flags": {
2644
2681
  "json": {
@@ -2648,6 +2685,14 @@
2648
2685
  "allowNo": false,
2649
2686
  "type": "boolean"
2650
2687
  },
2688
+ "currency": {
2689
+ "description": "Currency code for the amounts in this call",
2690
+ "name": "currency",
2691
+ "default": "USD",
2692
+ "hasDynamicHelp": false,
2693
+ "multiple": false,
2694
+ "type": "option"
2695
+ },
2651
2696
  "yes": {
2652
2697
  "char": "y",
2653
2698
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2662,287 +2707,46 @@
2662
2707
  "multiple": false,
2663
2708
  "type": "option"
2664
2709
  },
2665
- "file": {
2666
- "description": "JSON file with the parts to change, or - to read stdin",
2667
- "name": "file",
2710
+ "ad-channel-type": {
2711
+ "description": "Ad channel type",
2712
+ "name": "ad-channel-type",
2713
+ "default": "SEARCH",
2668
2714
  "hasDynamicHelp": false,
2669
2715
  "multiple": false,
2716
+ "options": [
2717
+ "DISPLAY",
2718
+ "SEARCH"
2719
+ ],
2670
2720
  "type": "option"
2671
2721
  },
2672
- "name": {
2673
- "description": "Rule name",
2674
- "name": "name",
2722
+ "adam-id": {
2723
+ "description": "App Store app ID (adam_id)",
2724
+ "name": "adam-id",
2725
+ "required": true,
2675
2726
  "hasDynamicHelp": false,
2676
2727
  "multiple": false,
2677
2728
  "type": "option"
2678
2729
  },
2679
- "start": {
2680
- "description": "Activate the rule",
2681
- "exclusive": [
2682
- "stop"
2730
+ "bidding-strategy": {
2731
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2732
+ "name": "bidding-strategy",
2733
+ "hasDynamicHelp": false,
2734
+ "multiple": false,
2735
+ "options": [
2736
+ "MANUAL_CPT",
2737
+ "MAX_CONVERSIONS"
2683
2738
  ],
2684
- "name": "start",
2685
- "allowNo": false,
2686
- "type": "boolean"
2739
+ "type": "option"
2687
2740
  },
2688
- "stop": {
2689
- "description": "Stop the rule and clear its next run",
2690
- "exclusive": [
2691
- "start"
2692
- ],
2693
- "name": "stop",
2694
- "allowNo": false,
2695
- "type": "boolean"
2696
- }
2697
- },
2698
- "hasDynamicHelp": false,
2699
- "hiddenAliases": [],
2700
- "id": "asa:automations:update",
2701
- "pluginAlias": "adapty",
2702
- "pluginName": "adapty",
2703
- "pluginType": "core",
2704
- "strict": true,
2705
- "enableJsonFlag": true,
2706
- "isESM": true,
2707
- "relativePath": [
2708
- "dist",
2709
- "commands",
2710
- "asa",
2711
- "automations",
2712
- "update.js"
2713
- ]
2714
- },
2715
- "asa:campaigns:bulk-create": {
2716
- "aliases": [],
2717
- "args": {},
2718
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2719
- "examples": [
2720
- "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2721
- "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2722
- "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2723
- "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2724
- ],
2725
- "flags": {
2726
- "json": {
2727
- "description": "Format output as json.",
2728
- "helpGroup": "GLOBAL",
2729
- "name": "json",
2730
- "allowNo": false,
2731
- "type": "boolean"
2732
- },
2733
- "yes": {
2734
- "char": "y",
2735
- "description": "Apply without asking; required when the output is piped or --json is used",
2736
- "name": "yes",
2737
- "allowNo": false,
2738
- "type": "boolean"
2739
- },
2740
- "idempotency-key": {
2741
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2742
- "name": "idempotency-key",
2743
- "hasDynamicHelp": false,
2744
- "multiple": false,
2745
- "type": "option"
2746
- },
2747
- "file": {
2748
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2749
- "name": "file",
2750
- "hasDynamicHelp": false,
2751
- "multiple": false,
2752
- "type": "option"
2753
- },
2754
- "from-file": {
2755
- "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2756
- "name": "from-file",
2757
- "hasDynamicHelp": false,
2758
- "multiple": false,
2759
- "type": "option"
2760
- },
2761
- "org-id": {
2762
- "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2763
- "name": "org-id",
2764
- "hasDynamicHelp": false,
2765
- "multiple": false,
2766
- "type": "option"
2767
- },
2768
- "poll-interval": {
2769
- "description": "Seconds between progress polls",
2770
- "name": "poll-interval",
2771
- "default": 5,
2772
- "hasDynamicHelp": false,
2773
- "multiple": false,
2774
- "type": "option"
2775
- },
2776
- "preview": {
2777
- "description": "With --from-file: print the converted request and stop, nothing is created",
2778
- "name": "preview",
2779
- "allowNo": false,
2780
- "type": "boolean"
2781
- },
2782
- "timeout": {
2783
- "description": "Max seconds to wait for the operation to finish",
2784
- "name": "timeout",
2785
- "default": 900,
2786
- "hasDynamicHelp": false,
2787
- "multiple": false,
2788
- "type": "option"
2789
- },
2790
- "wait": {
2791
- "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2792
- "name": "wait",
2793
- "allowNo": true,
2794
- "type": "boolean"
2795
- }
2796
- },
2797
- "hasDynamicHelp": false,
2798
- "hiddenAliases": [],
2799
- "id": "asa:campaigns:bulk-create",
2800
- "pluginAlias": "adapty",
2801
- "pluginName": "adapty",
2802
- "pluginType": "core",
2803
- "strict": true,
2804
- "enableJsonFlag": true,
2805
- "isESM": true,
2806
- "relativePath": [
2807
- "dist",
2808
- "commands",
2809
- "asa",
2810
- "campaigns",
2811
- "bulk-create.js"
2812
- ]
2813
- },
2814
- "asa:campaigns:bulk-status": {
2815
- "aliases": [],
2816
- "args": {
2817
- "operation-id": {
2818
- "description": "Bulk operation ID returned by bulk-create",
2819
- "name": "operation-id",
2820
- "required": true
2821
- }
2822
- },
2823
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2824
- "examples": [
2825
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2826
- ],
2827
- "flags": {
2828
- "json": {
2829
- "description": "Format output as json.",
2830
- "helpGroup": "GLOBAL",
2831
- "name": "json",
2832
- "allowNo": false,
2833
- "type": "boolean"
2834
- },
2835
- "page": {
2836
- "description": "Page number",
2837
- "name": "page",
2838
- "default": 1,
2839
- "hasDynamicHelp": false,
2840
- "multiple": false,
2841
- "type": "option"
2842
- },
2843
- "page-size": {
2844
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2845
- "name": "page-size",
2846
- "default": 100,
2847
- "hasDynamicHelp": false,
2848
- "multiple": false,
2849
- "type": "option"
2850
- }
2851
- },
2852
- "hasDynamicHelp": false,
2853
- "hiddenAliases": [],
2854
- "id": "asa:campaigns:bulk-status",
2855
- "pluginAlias": "adapty",
2856
- "pluginName": "adapty",
2857
- "pluginType": "core",
2858
- "strict": true,
2859
- "enableJsonFlag": true,
2860
- "isESM": true,
2861
- "relativePath": [
2862
- "dist",
2863
- "commands",
2864
- "asa",
2865
- "campaigns",
2866
- "bulk-status.js"
2867
- ]
2868
- },
2869
- "asa:campaigns:create": {
2870
- "aliases": [],
2871
- "args": {},
2872
- "description": "Create a campaign in Apple Search Ads",
2873
- "examples": [
2874
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2875
- ],
2876
- "flags": {
2877
- "json": {
2878
- "description": "Format output as json.",
2879
- "helpGroup": "GLOBAL",
2880
- "name": "json",
2881
- "allowNo": false,
2882
- "type": "boolean"
2883
- },
2884
- "currency": {
2885
- "description": "Currency code for the amounts in this call",
2886
- "name": "currency",
2887
- "default": "USD",
2888
- "hasDynamicHelp": false,
2889
- "multiple": false,
2890
- "type": "option"
2891
- },
2892
- "yes": {
2893
- "char": "y",
2894
- "description": "Apply without asking; required when the output is piped or --json is used",
2895
- "name": "yes",
2896
- "allowNo": false,
2897
- "type": "boolean"
2898
- },
2899
- "idempotency-key": {
2900
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2901
- "name": "idempotency-key",
2902
- "hasDynamicHelp": false,
2903
- "multiple": false,
2904
- "type": "option"
2905
- },
2906
- "ad-channel-type": {
2907
- "description": "Ad channel type",
2908
- "name": "ad-channel-type",
2909
- "default": "SEARCH",
2910
- "hasDynamicHelp": false,
2911
- "multiple": false,
2912
- "options": [
2913
- "DISPLAY",
2914
- "SEARCH"
2915
- ],
2916
- "type": "option"
2917
- },
2918
- "adam-id": {
2919
- "description": "App Store app ID (adam_id)",
2920
- "name": "adam-id",
2921
- "required": true,
2922
- "hasDynamicHelp": false,
2923
- "multiple": false,
2924
- "type": "option"
2925
- },
2926
- "bidding-strategy": {
2927
- "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2928
- "name": "bidding-strategy",
2929
- "hasDynamicHelp": false,
2930
- "multiple": false,
2931
- "options": [
2932
- "MANUAL_CPT",
2933
- "MAX_CONVERSIONS"
2934
- ],
2935
- "type": "option"
2936
- },
2937
- "billing-event": {
2938
- "description": "Billing event",
2939
- "name": "billing-event",
2940
- "default": "TAPS",
2941
- "hasDynamicHelp": false,
2942
- "multiple": false,
2943
- "options": [
2944
- "IMPRESSIONS",
2945
- "TAPS"
2741
+ "billing-event": {
2742
+ "description": "Billing event",
2743
+ "name": "billing-event",
2744
+ "default": "TAPS",
2745
+ "hasDynamicHelp": false,
2746
+ "multiple": false,
2747
+ "options": [
2748
+ "IMPRESSIONS",
2749
+ "TAPS"
2946
2750
  ],
2947
2751
  "type": "option"
2948
2752
  },
@@ -3271,13 +3075,17 @@
3271
3075
  "update.js"
3272
3076
  ]
3273
3077
  },
3274
- "asa:competitors:summary": {
3078
+ "asa:metrics": {
3275
3079
  "aliases": [],
3276
3080
  "args": {},
3277
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3081
+ "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3278
3082
  "examples": [
3279
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3280
- ],
3083
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3084
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3085
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3086
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3087
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3088
+ ],
3281
3089
  "flags": {
3282
3090
  "json": {
3283
3091
  "description": "Format output as json.",
@@ -3286,18 +3094,111 @@
3286
3094
  "allowNo": false,
3287
3095
  "type": "boolean"
3288
3096
  },
3289
- "app-ids": {
3290
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3291
- "name": "app-ids",
3097
+ "page": {
3098
+ "description": "Page number",
3099
+ "name": "page",
3100
+ "default": 1,
3101
+ "hasDynamicHelp": false,
3102
+ "multiple": false,
3103
+ "type": "option"
3104
+ },
3105
+ "page-size": {
3106
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3107
+ "name": "page-size",
3108
+ "default": 100,
3109
+ "hasDynamicHelp": false,
3110
+ "multiple": false,
3111
+ "type": "option"
3112
+ },
3113
+ "by-days": {
3114
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3115
+ "name": "by-days",
3116
+ "hasDynamicHelp": false,
3117
+ "multiple": true,
3118
+ "type": "option"
3119
+ },
3120
+ "date-from": {
3121
+ "description": "Start of the period (YYYY-MM-DD)",
3122
+ "name": "date-from",
3123
+ "required": true,
3124
+ "hasDynamicHelp": false,
3125
+ "multiple": false,
3126
+ "type": "option"
3127
+ },
3128
+ "date-to": {
3129
+ "description": "End of the period (YYYY-MM-DD)",
3130
+ "name": "date-to",
3292
3131
  "required": true,
3293
3132
  "hasDynamicHelp": false,
3294
3133
  "multiple": false,
3295
3134
  "type": "option"
3135
+ },
3136
+ "entity": {
3137
+ "description": "What to report on",
3138
+ "name": "entity",
3139
+ "required": true,
3140
+ "hasDynamicHelp": false,
3141
+ "multiple": false,
3142
+ "options": [
3143
+ "ad",
3144
+ "ad-group",
3145
+ "campaign",
3146
+ "keyword"
3147
+ ],
3148
+ "type": "option"
3149
+ },
3150
+ "group-by": {
3151
+ "description": "Break the rows down by a dimension, repeatable",
3152
+ "name": "group-by",
3153
+ "hasDynamicHelp": false,
3154
+ "multiple": true,
3155
+ "options": [
3156
+ "country",
3157
+ "day",
3158
+ "month",
3159
+ "quarter",
3160
+ "week",
3161
+ "year"
3162
+ ],
3163
+ "type": "option"
3164
+ },
3165
+ "metric": {
3166
+ "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3167
+ "name": "metric",
3168
+ "hasDynamicHelp": false,
3169
+ "multiple": true,
3170
+ "type": "option"
3171
+ },
3172
+ "order": {
3173
+ "description": "Sort direction",
3174
+ "name": "order",
3175
+ "default": "desc",
3176
+ "hasDynamicHelp": false,
3177
+ "multiple": false,
3178
+ "options": [
3179
+ "asc",
3180
+ "desc"
3181
+ ],
3182
+ "type": "option"
3183
+ },
3184
+ "order-by": {
3185
+ "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3186
+ "name": "order-by",
3187
+ "hasDynamicHelp": false,
3188
+ "multiple": false,
3189
+ "type": "option"
3190
+ },
3191
+ "order-by-day": {
3192
+ "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3193
+ "name": "order-by-day",
3194
+ "hasDynamicHelp": false,
3195
+ "multiple": false,
3196
+ "type": "option"
3296
3197
  }
3297
3198
  },
3298
3199
  "hasDynamicHelp": false,
3299
3200
  "hiddenAliases": [],
3300
- "id": "asa:competitors:summary",
3201
+ "id": "asa:metrics",
3301
3202
  "pluginAlias": "adapty",
3302
3203
  "pluginName": "adapty",
3303
3204
  "pluginType": "core",
@@ -3308,17 +3209,17 @@
3308
3209
  "dist",
3309
3210
  "commands",
3310
3211
  "asa",
3311
- "competitors",
3312
- "summary.js"
3212
+ "metrics",
3213
+ "index.js"
3313
3214
  ]
3314
3215
  },
3315
- "asa:creatives:list": {
3216
+ "asa:metrics:overview": {
3316
3217
  "aliases": [],
3317
3218
  "args": {},
3318
- "description": "List creatives; creative_id is what `asa ads create` needs",
3219
+ "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
3319
3220
  "examples": [
3320
- "<%= config.bin %> asa creatives list",
3321
- "<%= config.bin %> asa creatives list --app APP_UUID"
3221
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3222
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3322
3223
  ],
3323
3224
  "flags": {
3324
3225
  "json": {
@@ -3328,40 +3229,69 @@
3328
3229
  "allowNo": false,
3329
3230
  "type": "boolean"
3330
3231
  },
3331
- "page": {
3332
- "description": "Page number",
3333
- "name": "page",
3334
- "default": 1,
3232
+ "by-days": {
3233
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3234
+ "name": "by-days",
3235
+ "hasDynamicHelp": false,
3236
+ "multiple": true,
3237
+ "type": "option"
3238
+ },
3239
+ "date-from": {
3240
+ "description": "Start of the period (YYYY-MM-DD)",
3241
+ "name": "date-from",
3242
+ "required": true,
3335
3243
  "hasDynamicHelp": false,
3336
3244
  "multiple": false,
3337
3245
  "type": "option"
3338
3246
  },
3339
- "page-size": {
3340
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3341
- "name": "page-size",
3342
- "default": 100,
3247
+ "date-to": {
3248
+ "description": "End of the period (YYYY-MM-DD)",
3249
+ "name": "date-to",
3250
+ "required": true,
3343
3251
  "hasDynamicHelp": false,
3344
3252
  "multiple": false,
3345
3253
  "type": "option"
3346
3254
  },
3347
- "app": {
3348
- "description": "Keep only rows in this app; repeatable",
3349
- "name": "app",
3255
+ "entity": {
3256
+ "description": "What to report on",
3257
+ "name": "entity",
3258
+ "required": true,
3350
3259
  "hasDynamicHelp": false,
3351
- "multiple": true,
3260
+ "multiple": false,
3261
+ "options": [
3262
+ "ad",
3263
+ "ad-group",
3264
+ "campaign",
3265
+ "keyword"
3266
+ ],
3352
3267
  "type": "option"
3353
3268
  },
3354
- "campaign-group": {
3355
- "description": "Keep only rows in this campaign group; repeatable",
3356
- "name": "campaign-group",
3269
+ "metric": {
3270
+ "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3271
+ "name": "metric",
3357
3272
  "hasDynamicHelp": false,
3358
3273
  "multiple": true,
3359
3274
  "type": "option"
3275
+ },
3276
+ "period-unit": {
3277
+ "description": "Bucket size",
3278
+ "name": "period-unit",
3279
+ "default": "day",
3280
+ "hasDynamicHelp": false,
3281
+ "multiple": false,
3282
+ "options": [
3283
+ "day",
3284
+ "month",
3285
+ "quarter",
3286
+ "week",
3287
+ "year"
3288
+ ],
3289
+ "type": "option"
3360
3290
  }
3361
3291
  },
3362
3292
  "hasDynamicHelp": false,
3363
3293
  "hiddenAliases": [],
3364
- "id": "asa:creatives:list",
3294
+ "id": "asa:metrics:overview",
3365
3295
  "pluginAlias": "adapty",
3366
3296
  "pluginName": "adapty",
3367
3297
  "pluginType": "core",
@@ -3372,17 +3302,17 @@
3372
3302
  "dist",
3373
3303
  "commands",
3374
3304
  "asa",
3375
- "creatives",
3376
- "list.js"
3305
+ "metrics",
3306
+ "overview.js"
3377
3307
  ]
3378
3308
  },
3379
- "asa:keywords:add": {
3309
+ "asa:automations:create": {
3380
3310
  "aliases": [],
3381
3311
  "args": {},
3382
- "description": "Add targeting keywords to an ad group",
3312
+ "description": "Create an automation rule from a JSON rule file",
3383
3313
  "examples": [
3384
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3385
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3314
+ "<%= config.bin %> asa automations create --file rule.json",
3315
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
3386
3316
  ],
3387
3317
  "flags": {
3388
3318
  "json": {
@@ -3392,14 +3322,6 @@
3392
3322
  "allowNo": false,
3393
3323
  "type": "boolean"
3394
3324
  },
3395
- "currency": {
3396
- "description": "Currency code for the amounts in this call",
3397
- "name": "currency",
3398
- "default": "USD",
3399
- "hasDynamicHelp": false,
3400
- "multiple": false,
3401
- "type": "option"
3402
- },
3403
3325
  "yes": {
3404
3326
  "char": "y",
3405
3327
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3414,63 +3336,24 @@
3414
3336
  "multiple": false,
3415
3337
  "type": "option"
3416
3338
  },
3417
- "ad-group": {
3418
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3419
- "name": "ad-group",
3339
+ "file": {
3340
+ "description": "JSON file with the rule body, or - to read stdin",
3341
+ "name": "file",
3420
3342
  "required": true,
3421
3343
  "hasDynamicHelp": false,
3422
3344
  "multiple": false,
3423
3345
  "type": "option"
3424
3346
  },
3425
- "bid": {
3426
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3427
- "name": "bid",
3428
- "hasDynamicHelp": false,
3429
- "multiple": false,
3430
- "type": "option"
3431
- },
3432
- "from-file": {
3433
- "description": "File with one keyword per line, combined with any --text values",
3434
- "name": "from-file",
3435
- "hasDynamicHelp": false,
3436
- "multiple": false,
3437
- "type": "option"
3438
- },
3439
- "match-type": {
3440
- "description": "Match type",
3441
- "name": "match-type",
3442
- "default": "BROAD",
3443
- "hasDynamicHelp": false,
3444
- "multiple": false,
3445
- "options": [
3446
- "BROAD",
3447
- "EXACT"
3448
- ],
3449
- "type": "option"
3450
- },
3451
- "status": {
3452
- "description": "Keyword status",
3453
- "name": "status",
3454
- "default": "ACTIVE",
3455
- "hasDynamicHelp": false,
3456
- "multiple": false,
3457
- "options": [
3458
- "ACTIVE",
3459
- "PAUSED"
3460
- ],
3461
- "type": "option"
3462
- },
3463
- "text": {
3464
- "description": "Keyword text, repeatable",
3465
- "name": "text",
3466
- "hasDynamicHelp": false,
3467
- "multiple": true,
3468
- "type": "option"
3347
+ "run-now": {
3348
+ "description": "Queue the first run right after the rule is stored",
3349
+ "name": "run-now",
3350
+ "allowNo": false,
3351
+ "type": "boolean"
3469
3352
  }
3470
3353
  },
3471
3354
  "hasDynamicHelp": false,
3472
3355
  "hiddenAliases": [],
3473
- "id": "asa:keywords:add",
3356
+ "id": "asa:automations:create",
3474
3357
  "pluginAlias": "adapty",
3475
3358
  "pluginName": "adapty",
3476
3359
  "pluginType": "core",
@@ -3481,17 +3364,55 @@
3481
3364
  "dist",
3482
3365
  "commands",
3483
3366
  "asa",
3484
- "keywords",
3485
- "add.js"
3367
+ "automations",
3368
+ "create.js"
3486
3369
  ]
3487
3370
  },
3488
- "asa:keywords:list": {
3371
+ "asa:automations:get": {
3372
+ "aliases": [],
3373
+ "args": {
3374
+ "automation_id": {
3375
+ "description": "Automation rule ID (UUID)",
3376
+ "name": "automation_id",
3377
+ "required": true
3378
+ }
3379
+ },
3380
+ "description": "Show one automation rule with its conditions and actions",
3381
+ "examples": [
3382
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
3383
+ ],
3384
+ "flags": {
3385
+ "json": {
3386
+ "description": "Format output as json.",
3387
+ "helpGroup": "GLOBAL",
3388
+ "name": "json",
3389
+ "allowNo": false,
3390
+ "type": "boolean"
3391
+ }
3392
+ },
3393
+ "hasDynamicHelp": false,
3394
+ "hiddenAliases": [],
3395
+ "id": "asa:automations:get",
3396
+ "pluginAlias": "adapty",
3397
+ "pluginName": "adapty",
3398
+ "pluginType": "core",
3399
+ "strict": true,
3400
+ "enableJsonFlag": true,
3401
+ "isESM": true,
3402
+ "relativePath": [
3403
+ "dist",
3404
+ "commands",
3405
+ "asa",
3406
+ "automations",
3407
+ "get.js"
3408
+ ]
3409
+ },
3410
+ "asa:automations:list": {
3489
3411
  "aliases": [],
3490
3412
  "args": {},
3491
- "description": "List targeting keywords; read numbers with asa metrics",
3413
+ "description": "List automation rules; status 1 is active, 0 is stopped",
3492
3414
  "examples": [
3493
- "<%= config.bin %> asa keywords list",
3494
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3415
+ "<%= config.bin %> asa automations list"
3495
3416
  ],
3496
3417
  "flags": {
3497
3418
  "json": {
@@ -3516,57 +3437,126 @@
3516
3437
  "hasDynamicHelp": false,
3517
3438
  "multiple": false,
3518
3439
  "type": "option"
3440
+ }
3441
+ },
3442
+ "hasDynamicHelp": false,
3443
+ "hiddenAliases": [],
3444
+ "id": "asa:automations:list",
3445
+ "pluginAlias": "adapty",
3446
+ "pluginName": "adapty",
3447
+ "pluginType": "core",
3448
+ "strict": true,
3449
+ "enableJsonFlag": true,
3450
+ "isESM": true,
3451
+ "relativePath": [
3452
+ "dist",
3453
+ "commands",
3454
+ "asa",
3455
+ "automations",
3456
+ "list.js"
3457
+ ]
3458
+ },
3459
+ "asa:automations:run": {
3460
+ "aliases": [],
3461
+ "args": {
3462
+ "automation_id": {
3463
+ "description": "Automation rule ID (UUID)",
3464
+ "name": "automation_id",
3465
+ "required": true
3466
+ }
3467
+ },
3468
+ "description": "Run an automation rule now; the run is queued, not awaited",
3469
+ "examples": [
3470
+ "<%= config.bin %> asa automations run UUID",
3471
+ "<%= config.bin %> asa automations run UUID --dry-run"
3472
+ ],
3473
+ "flags": {
3474
+ "json": {
3475
+ "description": "Format output as json.",
3476
+ "helpGroup": "GLOBAL",
3477
+ "name": "json",
3478
+ "allowNo": false,
3479
+ "type": "boolean"
3519
3480
  },
3520
- "app": {
3521
- "description": "Keep only rows in this app; repeatable",
3522
- "name": "app",
3523
- "hasDynamicHelp": false,
3524
- "multiple": true,
3525
- "type": "option"
3526
- },
3527
- "campaign-group": {
3528
- "description": "Keep only rows in this campaign group; repeatable",
3529
- "name": "campaign-group",
3530
- "hasDynamicHelp": false,
3531
- "multiple": true,
3532
- "type": "option"
3481
+ "yes": {
3482
+ "char": "y",
3483
+ "description": "Apply without asking; required when the output is piped or --json is used",
3484
+ "name": "yes",
3485
+ "allowNo": false,
3486
+ "type": "boolean"
3533
3487
  },
3534
- "search": {
3535
- "description": "Case-insensitive substring match on the name",
3536
- "name": "search",
3488
+ "idempotency-key": {
3489
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3490
+ "name": "idempotency-key",
3537
3491
  "hasDynamicHelp": false,
3538
3492
  "multiple": false,
3539
3493
  "type": "option"
3540
3494
  },
3541
- "campaign": {
3542
- "description": "Keep only rows in this campaign; repeatable",
3543
- "name": "campaign",
3544
- "hasDynamicHelp": false,
3545
- "multiple": true,
3546
- "type": "option"
3495
+ "dry-run": {
3496
+ "description": "Evaluate and log the rule without touching Apple",
3497
+ "name": "dry-run",
3498
+ "allowNo": false,
3499
+ "type": "boolean"
3500
+ }
3501
+ },
3502
+ "hasDynamicHelp": false,
3503
+ "hiddenAliases": [],
3504
+ "id": "asa:automations:run",
3505
+ "pluginAlias": "adapty",
3506
+ "pluginName": "adapty",
3507
+ "pluginType": "core",
3508
+ "strict": true,
3509
+ "enableJsonFlag": true,
3510
+ "isESM": true,
3511
+ "relativePath": [
3512
+ "dist",
3513
+ "commands",
3514
+ "asa",
3515
+ "automations",
3516
+ "run.js"
3517
+ ]
3518
+ },
3519
+ "asa:automations:runs": {
3520
+ "aliases": [],
3521
+ "args": {
3522
+ "automation_id": {
3523
+ "description": "Automation rule ID (UUID)",
3524
+ "name": "automation_id",
3525
+ "required": true
3526
+ }
3527
+ },
3528
+ "description": "List past runs of an automation rule, including dry runs",
3529
+ "examples": [
3530
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
3531
+ ],
3532
+ "flags": {
3533
+ "json": {
3534
+ "description": "Format output as json.",
3535
+ "helpGroup": "GLOBAL",
3536
+ "name": "json",
3537
+ "allowNo": false,
3538
+ "type": "boolean"
3547
3539
  },
3548
- "ad-group": {
3549
- "description": "Keep only rows in this ad group; repeatable",
3550
- "name": "ad-group",
3540
+ "page": {
3541
+ "description": "Page number",
3542
+ "name": "page",
3543
+ "default": 1,
3551
3544
  "hasDynamicHelp": false,
3552
- "multiple": true,
3545
+ "multiple": false,
3553
3546
  "type": "option"
3554
3547
  },
3555
- "status": {
3556
- "description": "Keep only rows in this state",
3557
- "name": "status",
3548
+ "page-size": {
3549
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3550
+ "name": "page-size",
3551
+ "default": 100,
3558
3552
  "hasDynamicHelp": false,
3559
3553
  "multiple": false,
3560
- "options": [
3561
- "ACTIVE",
3562
- "PAUSED"
3563
- ],
3564
3554
  "type": "option"
3565
3555
  }
3566
3556
  },
3567
3557
  "hasDynamicHelp": false,
3568
3558
  "hiddenAliases": [],
3569
- "id": "asa:keywords:list",
3559
+ "id": "asa:automations:runs",
3570
3560
  "pluginAlias": "adapty",
3571
3561
  "pluginName": "adapty",
3572
3562
  "pluginType": "core",
@@ -3577,23 +3567,23 @@
3577
3567
  "dist",
3578
3568
  "commands",
3579
3569
  "asa",
3580
- "keywords",
3581
- "list.js"
3570
+ "automations",
3571
+ "runs.js"
3582
3572
  ]
3583
3573
  },
3584
- "asa:keywords:update": {
3574
+ "asa:automations:update": {
3585
3575
  "aliases": [],
3586
3576
  "args": {
3587
- "keyword_id": {
3588
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3589
- "name": "keyword_id",
3577
+ "automation_id": {
3578
+ "description": "Automation rule ID (UUID)",
3579
+ "name": "automation_id",
3590
3580
  "required": true
3591
3581
  }
3592
3582
  },
3593
- "description": "Change bid, status, text or match type of keywords",
3583
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
3594
3584
  "examples": [
3595
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3596
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3585
+ "<%= config.bin %> asa automations update UUID --stop",
3586
+ "<%= config.bin %> asa automations update UUID --file rule.json"
3597
3587
  ],
3598
3588
  "flags": {
3599
3589
  "json": {
@@ -3603,14 +3593,6 @@
3603
3593
  "allowNo": false,
3604
3594
  "type": "boolean"
3605
3595
  },
3606
- "currency": {
3607
- "description": "Currency code for the amounts in this call",
3608
- "name": "currency",
3609
- "default": "USD",
3610
- "hasDynamicHelp": false,
3611
- "multiple": false,
3612
- "type": "option"
3613
- },
3614
3596
  "yes": {
3615
3597
  "char": "y",
3616
3598
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3625,70 +3607,63 @@
3625
3607
  "multiple": false,
3626
3608
  "type": "option"
3627
3609
  },
3628
- "bid": {
3629
- "description": "Bid (amount, e.g. 50 or 12.50)",
3630
- "name": "bid",
3610
+ "file": {
3611
+ "description": "JSON file with the parts to change, or - to read stdin",
3612
+ "name": "file",
3631
3613
  "hasDynamicHelp": false,
3632
3614
  "multiple": false,
3633
3615
  "type": "option"
3634
3616
  },
3635
- "match-type": {
3636
- "description": "Match type",
3637
- "name": "match-type",
3617
+ "name": {
3618
+ "description": "Rule name",
3619
+ "name": "name",
3638
3620
  "hasDynamicHelp": false,
3639
3621
  "multiple": false,
3640
- "options": [
3641
- "BROAD",
3642
- "EXACT"
3643
- ],
3644
3622
  "type": "option"
3645
3623
  },
3646
- "status": {
3647
- "description": "Keyword status",
3648
- "name": "status",
3649
- "hasDynamicHelp": false,
3650
- "multiple": false,
3651
- "options": [
3652
- "ACTIVE",
3653
- "PAUSED"
3624
+ "start": {
3625
+ "description": "Activate the rule",
3626
+ "exclusive": [
3627
+ "stop"
3654
3628
  ],
3655
- "type": "option"
3629
+ "name": "start",
3630
+ "allowNo": false,
3631
+ "type": "boolean"
3656
3632
  },
3657
- "text": {
3658
- "description": "Keyword text (only meaningful for a single keyword)",
3659
- "name": "text",
3660
- "hasDynamicHelp": false,
3661
- "multiple": false,
3662
- "type": "option"
3633
+ "stop": {
3634
+ "description": "Stop the rule and clear its next run",
3635
+ "exclusive": [
3636
+ "start"
3637
+ ],
3638
+ "name": "stop",
3639
+ "allowNo": false,
3640
+ "type": "boolean"
3663
3641
  }
3664
3642
  },
3665
3643
  "hasDynamicHelp": false,
3666
3644
  "hiddenAliases": [],
3667
- "id": "asa:keywords:update",
3645
+ "id": "asa:automations:update",
3668
3646
  "pluginAlias": "adapty",
3669
3647
  "pluginName": "adapty",
3670
3648
  "pluginType": "core",
3671
- "strict": false,
3649
+ "strict": true,
3672
3650
  "enableJsonFlag": true,
3673
3651
  "isESM": true,
3674
3652
  "relativePath": [
3675
3653
  "dist",
3676
3654
  "commands",
3677
3655
  "asa",
3678
- "keywords",
3656
+ "automations",
3679
3657
  "update.js"
3680
3658
  ]
3681
3659
  },
3682
- "asa:metrics": {
3660
+ "asa:keywords:add": {
3683
3661
  "aliases": [],
3684
3662
  "args": {},
3685
- "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3663
+ "description": "Add targeting keywords to an ad group",
3686
3664
  "examples": [
3687
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3688
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3689
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3690
- "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3691
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3665
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3666
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3692
3667
  ],
3693
3668
  "flags": {
3694
3669
  "json": {
@@ -3698,111 +3673,85 @@
3698
3673
  "allowNo": false,
3699
3674
  "type": "boolean"
3700
3675
  },
3701
- "page": {
3702
- "description": "Page number",
3703
- "name": "page",
3704
- "default": 1,
3676
+ "currency": {
3677
+ "description": "Currency code for the amounts in this call",
3678
+ "name": "currency",
3679
+ "default": "USD",
3705
3680
  "hasDynamicHelp": false,
3706
3681
  "multiple": false,
3707
3682
  "type": "option"
3708
3683
  },
3709
- "page-size": {
3710
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3711
- "name": "page-size",
3712
- "default": 100,
3713
- "hasDynamicHelp": false,
3714
- "multiple": false,
3715
- "type": "option"
3684
+ "yes": {
3685
+ "char": "y",
3686
+ "description": "Apply without asking; required when the output is piped or --json is used",
3687
+ "name": "yes",
3688
+ "allowNo": false,
3689
+ "type": "boolean"
3716
3690
  },
3717
- "by-days": {
3718
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3719
- "name": "by-days",
3691
+ "idempotency-key": {
3692
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3693
+ "name": "idempotency-key",
3720
3694
  "hasDynamicHelp": false,
3721
- "multiple": true,
3695
+ "multiple": false,
3722
3696
  "type": "option"
3723
3697
  },
3724
- "date-from": {
3725
- "description": "Start of the period (YYYY-MM-DD)",
3726
- "name": "date-from",
3698
+ "ad-group": {
3699
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3700
+ "name": "ad-group",
3727
3701
  "required": true,
3728
3702
  "hasDynamicHelp": false,
3729
3703
  "multiple": false,
3730
3704
  "type": "option"
3731
3705
  },
3732
- "date-to": {
3733
- "description": "End of the period (YYYY-MM-DD)",
3734
- "name": "date-to",
3735
- "required": true,
3706
+ "bid": {
3707
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3708
+ "name": "bid",
3736
3709
  "hasDynamicHelp": false,
3737
3710
  "multiple": false,
3738
3711
  "type": "option"
3739
3712
  },
3740
- "entity": {
3741
- "description": "What to report on",
3742
- "name": "entity",
3743
- "required": true,
3713
+ "from-file": {
3714
+ "description": "File with one keyword per line, combined with any --text values",
3715
+ "name": "from-file",
3744
3716
  "hasDynamicHelp": false,
3745
3717
  "multiple": false,
3746
- "options": [
3747
- "ad",
3748
- "ad-group",
3749
- "campaign",
3750
- "keyword"
3751
- ],
3752
3718
  "type": "option"
3753
3719
  },
3754
- "group-by": {
3755
- "description": "Break the rows down by a dimension, repeatable",
3756
- "name": "group-by",
3720
+ "match-type": {
3721
+ "description": "Match type",
3722
+ "name": "match-type",
3723
+ "default": "BROAD",
3757
3724
  "hasDynamicHelp": false,
3758
- "multiple": true,
3725
+ "multiple": false,
3759
3726
  "options": [
3760
- "country",
3761
- "day",
3762
- "month",
3763
- "quarter",
3764
- "week",
3765
- "year"
3727
+ "BROAD",
3728
+ "EXACT"
3766
3729
  ],
3767
3730
  "type": "option"
3768
3731
  },
3769
- "metric": {
3770
- "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3771
- "name": "metric",
3772
- "hasDynamicHelp": false,
3773
- "multiple": true,
3774
- "type": "option"
3775
- },
3776
- "order": {
3777
- "description": "Sort direction",
3778
- "name": "order",
3779
- "default": "desc",
3732
+ "status": {
3733
+ "description": "Keyword status",
3734
+ "name": "status",
3735
+ "default": "ACTIVE",
3780
3736
  "hasDynamicHelp": false,
3781
3737
  "multiple": false,
3782
3738
  "options": [
3783
- "asc",
3784
- "desc"
3739
+ "ACTIVE",
3740
+ "PAUSED"
3785
3741
  ],
3786
3742
  "type": "option"
3787
3743
  },
3788
- "order-by": {
3789
- "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3790
- "name": "order-by",
3791
- "hasDynamicHelp": false,
3792
- "multiple": false,
3793
- "type": "option"
3794
- },
3795
- "order-by-day": {
3796
- "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3797
- "name": "order-by-day",
3744
+ "text": {
3745
+ "description": "Keyword text, repeatable",
3746
+ "name": "text",
3798
3747
  "hasDynamicHelp": false,
3799
- "multiple": false,
3748
+ "multiple": true,
3800
3749
  "type": "option"
3801
3750
  }
3802
3751
  },
3803
3752
  "hasDynamicHelp": false,
3804
3753
  "hiddenAliases": [],
3805
- "id": "asa:metrics",
3754
+ "id": "asa:keywords:add",
3806
3755
  "pluginAlias": "adapty",
3807
3756
  "pluginName": "adapty",
3808
3757
  "pluginType": "core",
@@ -3813,17 +3762,17 @@
3813
3762
  "dist",
3814
3763
  "commands",
3815
3764
  "asa",
3816
- "metrics",
3817
- "index.js"
3765
+ "keywords",
3766
+ "add.js"
3818
3767
  ]
3819
3768
  },
3820
- "asa:metrics:overview": {
3769
+ "asa:keywords:list": {
3821
3770
  "aliases": [],
3822
3771
  "args": {},
3823
- "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
3772
+ "description": "List targeting keywords; read numbers with asa metrics",
3824
3773
  "examples": [
3825
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3826
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3774
+ "<%= config.bin %> asa keywords list",
3775
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3827
3776
  ],
3828
3777
  "flags": {
3829
3778
  "json": {
@@ -3833,69 +3782,72 @@
3833
3782
  "allowNo": false,
3834
3783
  "type": "boolean"
3835
3784
  },
3836
- "by-days": {
3837
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3838
- "name": "by-days",
3785
+ "page": {
3786
+ "description": "Page number",
3787
+ "name": "page",
3788
+ "default": 1,
3789
+ "hasDynamicHelp": false,
3790
+ "multiple": false,
3791
+ "type": "option"
3792
+ },
3793
+ "page-size": {
3794
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3795
+ "name": "page-size",
3796
+ "default": 100,
3797
+ "hasDynamicHelp": false,
3798
+ "multiple": false,
3799
+ "type": "option"
3800
+ },
3801
+ "app": {
3802
+ "description": "Keep only rows in this app; repeatable",
3803
+ "name": "app",
3839
3804
  "hasDynamicHelp": false,
3840
3805
  "multiple": true,
3841
3806
  "type": "option"
3842
3807
  },
3843
- "date-from": {
3844
- "description": "Start of the period (YYYY-MM-DD)",
3845
- "name": "date-from",
3846
- "required": true,
3808
+ "campaign-group": {
3809
+ "description": "Keep only rows in this campaign group; repeatable",
3810
+ "name": "campaign-group",
3847
3811
  "hasDynamicHelp": false,
3848
- "multiple": false,
3812
+ "multiple": true,
3849
3813
  "type": "option"
3850
3814
  },
3851
- "date-to": {
3852
- "description": "End of the period (YYYY-MM-DD)",
3853
- "name": "date-to",
3854
- "required": true,
3815
+ "search": {
3816
+ "description": "Case-insensitive substring match on the name",
3817
+ "name": "search",
3855
3818
  "hasDynamicHelp": false,
3856
3819
  "multiple": false,
3857
3820
  "type": "option"
3858
3821
  },
3859
- "entity": {
3860
- "description": "What to report on",
3861
- "name": "entity",
3862
- "required": true,
3822
+ "campaign": {
3823
+ "description": "Keep only rows in this campaign; repeatable",
3824
+ "name": "campaign",
3863
3825
  "hasDynamicHelp": false,
3864
- "multiple": false,
3865
- "options": [
3866
- "ad",
3867
- "ad-group",
3868
- "campaign",
3869
- "keyword"
3870
- ],
3826
+ "multiple": true,
3871
3827
  "type": "option"
3872
3828
  },
3873
- "metric": {
3874
- "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3875
- "name": "metric",
3829
+ "ad-group": {
3830
+ "description": "Keep only rows in this ad group; repeatable",
3831
+ "name": "ad-group",
3876
3832
  "hasDynamicHelp": false,
3877
3833
  "multiple": true,
3878
3834
  "type": "option"
3879
3835
  },
3880
- "period-unit": {
3881
- "description": "Bucket size",
3882
- "name": "period-unit",
3883
- "default": "day",
3836
+ "status": {
3837
+ "description": "Keep only rows in this state",
3838
+ "name": "status",
3884
3839
  "hasDynamicHelp": false,
3885
3840
  "multiple": false,
3886
3841
  "options": [
3887
- "day",
3888
- "month",
3889
- "quarter",
3890
- "week",
3891
- "year"
3842
+ "ACTIVE",
3843
+ "PAUSED"
3892
3844
  ],
3893
3845
  "type": "option"
3894
3846
  }
3895
3847
  },
3896
3848
  "hasDynamicHelp": false,
3897
3849
  "hiddenAliases": [],
3898
- "id": "asa:metrics:overview",
3850
+ "id": "asa:keywords:list",
3899
3851
  "pluginAlias": "adapty",
3900
3852
  "pluginName": "adapty",
3901
3853
  "pluginType": "core",
@@ -3906,18 +3858,23 @@
3906
3858
  "dist",
3907
3859
  "commands",
3908
3860
  "asa",
3909
- "metrics",
3910
- "overview.js"
3861
+ "keywords",
3862
+ "list.js"
3911
3863
  ]
3912
3864
  },
3913
- "asa:negative-keywords:add": {
3865
+ "asa:keywords:update": {
3914
3866
  "aliases": [],
3915
- "args": {},
3916
- "description": "Add negative keywords to an ad group or across a campaign",
3867
+ "args": {
3868
+ "keyword_id": {
3869
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3870
+ "name": "keyword_id",
3871
+ "required": true
3872
+ }
3873
+ },
3874
+ "description": "Change bid, status, text or match type of keywords",
3917
3875
  "examples": [
3918
- "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3919
- "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3920
- "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3876
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3877
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3921
3878
  ],
3922
3879
  "flags": {
3923
3880
  "json": {
@@ -3927,6 +3884,14 @@
3927
3884
  "allowNo": false,
3928
3885
  "type": "boolean"
3929
3886
  },
3887
+ "currency": {
3888
+ "description": "Currency code for the amounts in this call",
3889
+ "name": "currency",
3890
+ "default": "USD",
3891
+ "hasDynamicHelp": false,
3892
+ "multiple": false,
3893
+ "type": "option"
3894
+ },
3930
3895
  "yes": {
3931
3896
  "char": "y",
3932
3897
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3941,31 +3906,9 @@
3941
3906
  "multiple": false,
3942
3907
  "type": "option"
3943
3908
  },
3944
- "ad-group": {
3945
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3946
- "exclusive": [
3947
- "campaign"
3948
- ],
3949
- "name": "ad-group",
3950
- "hasDynamicHelp": false,
3951
- "multiple": false,
3952
- "type": "option"
3953
- },
3954
- "all-ad-groups": {
3955
- "dependsOn": [
3956
- "campaign"
3957
- ],
3958
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
3959
- "name": "all-ad-groups",
3960
- "allowNo": false,
3961
- "type": "boolean"
3962
- },
3963
- "campaign": {
3964
- "description": "Campaign ID (UUID)",
3965
- "exclusive": [
3966
- "ad-group"
3967
- ],
3968
- "name": "campaign",
3909
+ "bid": {
3910
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3911
+ "name": "bid",
3969
3912
  "hasDynamicHelp": false,
3970
3913
  "multiple": false,
3971
3914
  "type": "option"
@@ -3973,7 +3916,6 @@
3973
3916
  "match-type": {
3974
3917
  "description": "Match type",
3975
3918
  "name": "match-type",
3976
- "default": "EXACT",
3977
3919
  "hasDynamicHelp": false,
3978
3920
  "multiple": false,
3979
3921
  "options": [
@@ -3985,7 +3927,6 @@
3985
3927
  "status": {
3986
3928
  "description": "Keyword status",
3987
3929
  "name": "status",
3988
- "default": "ACTIVE",
3989
3930
  "hasDynamicHelp": false,
3990
3931
  "multiple": false,
3991
3932
  "options": [
@@ -3995,38 +3936,37 @@
3995
3936
  "type": "option"
3996
3937
  },
3997
3938
  "text": {
3998
- "description": "Keyword text, repeatable",
3939
+ "description": "Keyword text (only meaningful for a single keyword)",
3999
3940
  "name": "text",
4000
- "required": true,
4001
3941
  "hasDynamicHelp": false,
4002
- "multiple": true,
3942
+ "multiple": false,
4003
3943
  "type": "option"
4004
3944
  }
4005
3945
  },
4006
3946
  "hasDynamicHelp": false,
4007
3947
  "hiddenAliases": [],
4008
- "id": "asa:negative-keywords:add",
3948
+ "id": "asa:keywords:update",
4009
3949
  "pluginAlias": "adapty",
4010
3950
  "pluginName": "adapty",
4011
3951
  "pluginType": "core",
4012
- "strict": true,
3952
+ "strict": false,
4013
3953
  "enableJsonFlag": true,
4014
3954
  "isESM": true,
4015
3955
  "relativePath": [
4016
3956
  "dist",
4017
3957
  "commands",
4018
3958
  "asa",
4019
- "negative-keywords",
4020
- "add.js"
3959
+ "keywords",
3960
+ "update.js"
4021
3961
  ]
4022
3962
  },
4023
- "asa:negative-keywords:list": {
3963
+ "asa:product-pages:list": {
4024
3964
  "aliases": [],
4025
3965
  "args": {},
4026
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3966
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4027
3967
  "examples": [
4028
- "<%= config.bin %> asa negative-keywords list",
4029
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3968
+ "<%= config.bin %> asa product-pages list",
3969
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
4030
3970
  ],
4031
3971
  "flags": {
4032
3972
  "json": {
@@ -4065,38 +4005,11 @@
4065
4005
  "hasDynamicHelp": false,
4066
4006
  "multiple": true,
4067
4007
  "type": "option"
4068
- },
4069
- "search": {
4070
- "description": "Case-insensitive substring match on the name",
4071
- "name": "search",
4072
- "hasDynamicHelp": false,
4073
- "multiple": false,
4074
- "type": "option"
4075
- },
4076
- "campaign": {
4077
- "description": "Keep only rows in this campaign; repeatable",
4078
- "name": "campaign",
4079
- "hasDynamicHelp": false,
4080
- "multiple": true,
4081
- "type": "option"
4082
- },
4083
- "ad-group": {
4084
- "description": "Keep only rows in this ad group; repeatable",
4085
- "name": "ad-group",
4086
- "hasDynamicHelp": false,
4087
- "multiple": true,
4088
- "type": "option"
4089
- },
4090
- "campaign-level-only": {
4091
- "description": "Keep only campaign-level rows (ad_group_id is null)",
4092
- "name": "campaign-level-only",
4093
- "allowNo": false,
4094
- "type": "boolean"
4095
4008
  }
4096
4009
  },
4097
4010
  "hasDynamicHelp": false,
4098
4011
  "hiddenAliases": [],
4099
- "id": "asa:negative-keywords:list",
4012
+ "id": "asa:product-pages:list",
4100
4013
  "pluginAlias": "adapty",
4101
4014
  "pluginName": "adapty",
4102
4015
  "pluginType": "core",
@@ -4107,16 +4020,17 @@
4107
4020
  "dist",
4108
4021
  "commands",
4109
4022
  "asa",
4110
- "negative-keywords",
4023
+ "product-pages",
4111
4024
  "list.js"
4112
4025
  ]
4113
4026
  },
4114
- "asa:orgs:list": {
4027
+ "asa:product-pages:sync": {
4115
4028
  "aliases": [],
4116
4029
  "args": {},
4117
- "description": "List the Apple Search Ads organizations this company can spend from",
4030
+ "description": "Refresh custom product pages from Apple",
4118
4031
  "examples": [
4119
- "<%= config.bin %> asa orgs list"
4032
+ "<%= config.bin %> asa product-pages sync",
4033
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
4120
4034
  ],
4121
4035
  "flags": {
4122
4036
  "json": {
@@ -4126,18 +4040,23 @@
4126
4040
  "allowNo": false,
4127
4041
  "type": "boolean"
4128
4042
  },
4129
- "page": {
4130
- "description": "Page number",
4131
- "name": "page",
4132
- "default": 1,
4043
+ "yes": {
4044
+ "char": "y",
4045
+ "description": "Apply without asking; required when the output is piped or --json is used",
4046
+ "name": "yes",
4047
+ "allowNo": false,
4048
+ "type": "boolean"
4049
+ },
4050
+ "idempotency-key": {
4051
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4052
+ "name": "idempotency-key",
4133
4053
  "hasDynamicHelp": false,
4134
4054
  "multiple": false,
4135
4055
  "type": "option"
4136
4056
  },
4137
- "page-size": {
4138
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4139
- "name": "page-size",
4140
- "default": 100,
4057
+ "adam-id": {
4058
+ "description": "Limit the refresh to one app; omit to cover every app",
4059
+ "name": "adam-id",
4141
4060
  "hasDynamicHelp": false,
4142
4061
  "multiple": false,
4143
4062
  "type": "option"
@@ -4145,7 +4064,7 @@
4145
4064
  },
4146
4065
  "hasDynamicHelp": false,
4147
4066
  "hiddenAliases": [],
4148
- "id": "asa:orgs:list",
4067
+ "id": "asa:product-pages:sync",
4149
4068
  "pluginAlias": "adapty",
4150
4069
  "pluginName": "adapty",
4151
4070
  "pluginType": "core",
@@ -4156,17 +4075,16 @@
4156
4075
  "dist",
4157
4076
  "commands",
4158
4077
  "asa",
4159
- "orgs",
4160
- "list.js"
4078
+ "product-pages",
4079
+ "sync.js"
4161
4080
  ]
4162
4081
  },
4163
- "asa:product-pages:list": {
4082
+ "asa:orgs:list": {
4164
4083
  "aliases": [],
4165
4084
  "args": {},
4166
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4085
+ "description": "List the Apple Search Ads organizations this company can spend from",
4167
4086
  "examples": [
4168
- "<%= config.bin %> asa product-pages list",
4169
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4087
+ "<%= config.bin %> asa orgs list"
4170
4088
  ],
4171
4089
  "flags": {
4172
4090
  "json": {
@@ -4191,25 +4109,11 @@
4191
4109
  "hasDynamicHelp": false,
4192
4110
  "multiple": false,
4193
4111
  "type": "option"
4194
- },
4195
- "app": {
4196
- "description": "Keep only rows in this app; repeatable",
4197
- "name": "app",
4198
- "hasDynamicHelp": false,
4199
- "multiple": true,
4200
- "type": "option"
4201
- },
4202
- "campaign-group": {
4203
- "description": "Keep only rows in this campaign group; repeatable",
4204
- "name": "campaign-group",
4205
- "hasDynamicHelp": false,
4206
- "multiple": true,
4207
- "type": "option"
4208
4112
  }
4209
4113
  },
4210
4114
  "hasDynamicHelp": false,
4211
4115
  "hiddenAliases": [],
4212
- "id": "asa:product-pages:list",
4116
+ "id": "asa:orgs:list",
4213
4117
  "pluginAlias": "adapty",
4214
4118
  "pluginName": "adapty",
4215
4119
  "pluginType": "core",
@@ -4220,17 +4124,18 @@
4220
4124
  "dist",
4221
4125
  "commands",
4222
4126
  "asa",
4223
- "product-pages",
4127
+ "orgs",
4224
4128
  "list.js"
4225
4129
  ]
4226
4130
  },
4227
- "asa:product-pages:sync": {
4131
+ "asa:negative-keywords:add": {
4228
4132
  "aliases": [],
4229
4133
  "args": {},
4230
- "description": "Refresh custom product pages from Apple",
4134
+ "description": "Add negative keywords to an ad group or across a campaign",
4231
4135
  "examples": [
4232
- "<%= config.bin %> asa product-pages sync",
4233
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
4136
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
4137
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
4138
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
4234
4139
  ],
4235
4140
  "flags": {
4236
4141
  "json": {
@@ -4240,31 +4145,85 @@
4240
4145
  "allowNo": false,
4241
4146
  "type": "boolean"
4242
4147
  },
4243
- "yes": {
4244
- "char": "y",
4245
- "description": "Apply without asking; required when the output is piped or --json is used",
4246
- "name": "yes",
4148
+ "yes": {
4149
+ "char": "y",
4150
+ "description": "Apply without asking; required when the output is piped or --json is used",
4151
+ "name": "yes",
4152
+ "allowNo": false,
4153
+ "type": "boolean"
4154
+ },
4155
+ "idempotency-key": {
4156
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4157
+ "name": "idempotency-key",
4158
+ "hasDynamicHelp": false,
4159
+ "multiple": false,
4160
+ "type": "option"
4161
+ },
4162
+ "ad-group": {
4163
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
4164
+ "exclusive": [
4165
+ "campaign"
4166
+ ],
4167
+ "name": "ad-group",
4168
+ "hasDynamicHelp": false,
4169
+ "multiple": false,
4170
+ "type": "option"
4171
+ },
4172
+ "all-ad-groups": {
4173
+ "dependsOn": [
4174
+ "campaign"
4175
+ ],
4176
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
4177
+ "name": "all-ad-groups",
4247
4178
  "allowNo": false,
4248
4179
  "type": "boolean"
4249
4180
  },
4250
- "idempotency-key": {
4251
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4252
- "name": "idempotency-key",
4181
+ "campaign": {
4182
+ "description": "Campaign ID (UUID)",
4183
+ "exclusive": [
4184
+ "ad-group"
4185
+ ],
4186
+ "name": "campaign",
4253
4187
  "hasDynamicHelp": false,
4254
4188
  "multiple": false,
4255
4189
  "type": "option"
4256
4190
  },
4257
- "adam-id": {
4258
- "description": "Limit the refresh to one app; omit to cover every app",
4259
- "name": "adam-id",
4191
+ "match-type": {
4192
+ "description": "Match type",
4193
+ "name": "match-type",
4194
+ "default": "EXACT",
4195
+ "hasDynamicHelp": false,
4196
+ "multiple": false,
4197
+ "options": [
4198
+ "BROAD",
4199
+ "EXACT"
4200
+ ],
4201
+ "type": "option"
4202
+ },
4203
+ "status": {
4204
+ "description": "Keyword status",
4205
+ "name": "status",
4206
+ "default": "ACTIVE",
4260
4207
  "hasDynamicHelp": false,
4261
4208
  "multiple": false,
4209
+ "options": [
4210
+ "ACTIVE",
4211
+ "PAUSED"
4212
+ ],
4213
+ "type": "option"
4214
+ },
4215
+ "text": {
4216
+ "description": "Keyword text, repeatable",
4217
+ "name": "text",
4218
+ "required": true,
4219
+ "hasDynamicHelp": false,
4220
+ "multiple": true,
4262
4221
  "type": "option"
4263
4222
  }
4264
4223
  },
4265
4224
  "hasDynamicHelp": false,
4266
4225
  "hiddenAliases": [],
4267
- "id": "asa:product-pages:sync",
4226
+ "id": "asa:negative-keywords:add",
4268
4227
  "pluginAlias": "adapty",
4269
4228
  "pluginName": "adapty",
4270
4229
  "pluginType": "core",
@@ -4275,17 +4234,17 @@
4275
4234
  "dist",
4276
4235
  "commands",
4277
4236
  "asa",
4278
- "product-pages",
4279
- "sync.js"
4237
+ "negative-keywords",
4238
+ "add.js"
4280
4239
  ]
4281
4240
  },
4282
- "asa:search-terms:list": {
4241
+ "asa:negative-keywords:list": {
4283
4242
  "aliases": [],
4284
4243
  "args": {},
4285
- "description": "List the search terms your ads matched, with their metrics",
4244
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
4286
4245
  "examples": [
4287
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4288
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4246
+ "<%= config.bin %> asa negative-keywords list",
4247
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
4289
4248
  ],
4290
4249
  "flags": {
4291
4250
  "json": {
@@ -4311,20 +4270,6 @@
4311
4270
  "multiple": false,
4312
4271
  "type": "option"
4313
4272
  },
4314
- "date-from": {
4315
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4316
- "name": "date-from",
4317
- "hasDynamicHelp": false,
4318
- "multiple": false,
4319
- "type": "option"
4320
- },
4321
- "date-to": {
4322
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4323
- "name": "date-to",
4324
- "hasDynamicHelp": false,
4325
- "multiple": false,
4326
- "type": "option"
4327
- },
4328
4273
  "app": {
4329
4274
  "description": "Keep only rows in this app; repeatable",
4330
4275
  "name": "app",
@@ -4359,11 +4304,17 @@
4359
4304
  "hasDynamicHelp": false,
4360
4305
  "multiple": true,
4361
4306
  "type": "option"
4307
+ },
4308
+ "campaign-level-only": {
4309
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
4310
+ "name": "campaign-level-only",
4311
+ "allowNo": false,
4312
+ "type": "boolean"
4362
4313
  }
4363
4314
  },
4364
4315
  "hasDynamicHelp": false,
4365
4316
  "hiddenAliases": [],
4366
- "id": "asa:search-terms:list",
4317
+ "id": "asa:negative-keywords:list",
4367
4318
  "pluginAlias": "adapty",
4368
4319
  "pluginName": "adapty",
4369
4320
  "pluginType": "core",
@@ -4374,7 +4325,7 @@
4374
4325
  "dist",
4375
4326
  "commands",
4376
4327
  "asa",
4377
- "search-terms",
4328
+ "negative-keywords",
4378
4329
  "list.js"
4379
4330
  ]
4380
4331
  },
@@ -4425,6 +4376,75 @@
4425
4376
  "get.js"
4426
4377
  ]
4427
4378
  },
4379
+ "flows:config:preview": {
4380
+ "aliases": [],
4381
+ "args": {
4382
+ "config_file": {
4383
+ "description": "Path to a local flow config JSON file",
4384
+ "name": "config_file",
4385
+ "required": true
4386
+ }
4387
+ },
4388
+ "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
4389
+ "examples": [
4390
+ "<%= config.bin %> flows config preview ./config.json",
4391
+ "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4392
+ "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
4393
+ "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
4394
+ ],
4395
+ "flags": {
4396
+ "json": {
4397
+ "description": "Format output as json.",
4398
+ "helpGroup": "GLOBAL",
4399
+ "name": "json",
4400
+ "allowNo": false,
4401
+ "type": "boolean"
4402
+ },
4403
+ "device": {
4404
+ "description": "Device frame to render in",
4405
+ "name": "device",
4406
+ "default": "iphone-14",
4407
+ "hasDynamicHelp": false,
4408
+ "multiple": false,
4409
+ "type": "option"
4410
+ },
4411
+ "orientation": {
4412
+ "description": "Device orientation to render in",
4413
+ "name": "orientation",
4414
+ "default": "portrait",
4415
+ "hasDynamicHelp": false,
4416
+ "multiple": false,
4417
+ "options": [
4418
+ "landscape",
4419
+ "portrait"
4420
+ ],
4421
+ "type": "option"
4422
+ },
4423
+ "screen": {
4424
+ "description": "Screen ID to render (default: the flow's first screen)",
4425
+ "name": "screen",
4426
+ "hasDynamicHelp": false,
4427
+ "multiple": false,
4428
+ "type": "option"
4429
+ }
4430
+ },
4431
+ "hasDynamicHelp": false,
4432
+ "hiddenAliases": [],
4433
+ "id": "flows:config:preview",
4434
+ "pluginAlias": "adapty",
4435
+ "pluginName": "adapty",
4436
+ "pluginType": "core",
4437
+ "strict": true,
4438
+ "enableJsonFlag": true,
4439
+ "isESM": true,
4440
+ "relativePath": [
4441
+ "dist",
4442
+ "commands",
4443
+ "flows",
4444
+ "config",
4445
+ "preview.js"
4446
+ ]
4447
+ },
4428
4448
  "flows:config:update": {
4429
4449
  "aliases": [],
4430
4450
  "args": {
@@ -4502,13 +4522,84 @@
4502
4522
  "update.js"
4503
4523
  ]
4504
4524
  },
4505
- "asa:apps:list": {
4525
+ "flows:config:validate": {
4526
+ "aliases": [],
4527
+ "args": {
4528
+ "flow_id": {
4529
+ "description": "Flow ID (UUID)",
4530
+ "name": "flow_id",
4531
+ "required": true
4532
+ }
4533
+ },
4534
+ "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4535
+ "examples": [
4536
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4537
+ "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4538
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4539
+ ],
4540
+ "flags": {
4541
+ "json": {
4542
+ "description": "Format output as json.",
4543
+ "helpGroup": "GLOBAL",
4544
+ "name": "json",
4545
+ "allowNo": false,
4546
+ "type": "boolean"
4547
+ },
4548
+ "app": {
4549
+ "description": "App ID (UUID)",
4550
+ "name": "app",
4551
+ "required": true,
4552
+ "hasDynamicHelp": false,
4553
+ "multiple": false,
4554
+ "type": "option"
4555
+ },
4556
+ "config": {
4557
+ "description": "Builder config as a JSON string",
4558
+ "name": "config",
4559
+ "hasDynamicHelp": false,
4560
+ "multiple": false,
4561
+ "type": "option"
4562
+ },
4563
+ "config-file": {
4564
+ "description": "JSON file with the builder config, or - to read stdin",
4565
+ "name": "config-file",
4566
+ "hasDynamicHelp": false,
4567
+ "multiple": false,
4568
+ "type": "option"
4569
+ },
4570
+ "source": {
4571
+ "description": "Caller attribution, sent as X-Adapty-Source (e.g. byo-cli)",
4572
+ "name": "source",
4573
+ "default": "adapty-cli",
4574
+ "hasDynamicHelp": false,
4575
+ "multiple": false,
4576
+ "type": "option"
4577
+ }
4578
+ },
4579
+ "hasDynamicHelp": false,
4580
+ "hiddenAliases": [],
4581
+ "id": "flows:config:validate",
4582
+ "pluginAlias": "adapty",
4583
+ "pluginName": "adapty",
4584
+ "pluginType": "core",
4585
+ "strict": true,
4586
+ "enableJsonFlag": true,
4587
+ "isESM": true,
4588
+ "relativePath": [
4589
+ "dist",
4590
+ "commands",
4591
+ "flows",
4592
+ "config",
4593
+ "validate.js"
4594
+ ]
4595
+ },
4596
+ "asa:search-terms:list": {
4506
4597
  "aliases": [],
4507
4598
  "args": {},
4508
- "description": "List the apps promoted by this company in Apple Search Ads",
4599
+ "description": "List the search terms your ads matched, with their metrics",
4509
4600
  "examples": [
4510
- "<%= config.bin %> asa apps list",
4511
- "<%= config.bin %> asa apps list --page 2 --page-size 50"
4601
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4602
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4512
4603
  ],
4513
4604
  "flags": {
4514
4605
  "json": {
@@ -4533,11 +4624,60 @@
4533
4624
  "hasDynamicHelp": false,
4534
4625
  "multiple": false,
4535
4626
  "type": "option"
4627
+ },
4628
+ "date-from": {
4629
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4630
+ "name": "date-from",
4631
+ "hasDynamicHelp": false,
4632
+ "multiple": false,
4633
+ "type": "option"
4634
+ },
4635
+ "date-to": {
4636
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4637
+ "name": "date-to",
4638
+ "hasDynamicHelp": false,
4639
+ "multiple": false,
4640
+ "type": "option"
4641
+ },
4642
+ "app": {
4643
+ "description": "Keep only rows in this app; repeatable",
4644
+ "name": "app",
4645
+ "hasDynamicHelp": false,
4646
+ "multiple": true,
4647
+ "type": "option"
4648
+ },
4649
+ "campaign-group": {
4650
+ "description": "Keep only rows in this campaign group; repeatable",
4651
+ "name": "campaign-group",
4652
+ "hasDynamicHelp": false,
4653
+ "multiple": true,
4654
+ "type": "option"
4655
+ },
4656
+ "search": {
4657
+ "description": "Case-insensitive substring match on the name",
4658
+ "name": "search",
4659
+ "hasDynamicHelp": false,
4660
+ "multiple": false,
4661
+ "type": "option"
4662
+ },
4663
+ "campaign": {
4664
+ "description": "Keep only rows in this campaign; repeatable",
4665
+ "name": "campaign",
4666
+ "hasDynamicHelp": false,
4667
+ "multiple": true,
4668
+ "type": "option"
4669
+ },
4670
+ "ad-group": {
4671
+ "description": "Keep only rows in this ad group; repeatable",
4672
+ "name": "ad-group",
4673
+ "hasDynamicHelp": false,
4674
+ "multiple": true,
4675
+ "type": "option"
4536
4676
  }
4537
4677
  },
4538
4678
  "hasDynamicHelp": false,
4539
4679
  "hiddenAliases": [],
4540
- "id": "asa:apps:list",
4680
+ "id": "asa:search-terms:list",
4541
4681
  "pluginAlias": "adapty",
4542
4682
  "pluginName": "adapty",
4543
4683
  "pluginType": "core",
@@ -4548,10 +4688,10 @@
4548
4688
  "dist",
4549
4689
  "commands",
4550
4690
  "asa",
4551
- "apps",
4691
+ "search-terms",
4552
4692
  "list.js"
4553
4693
  ]
4554
4694
  }
4555
4695
  },
4556
- "version": "0.6.0"
4696
+ "version": "0.6.1-beta.0"
4557
4697
  }