adapty 0.7.0 → 0.8.0-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 (7) hide show
  1. package/dist/commands/flows/config/validate.d.ts +19 -0
  2. package/dist/commands/flows/config/validate.js +77 -0
  3. package/dist/commands/flows/media/upload.d.ts +14 -0
  4. package/dist/commands/flows/media/upload.js +46 -0
  5. package/dist/lib/api-schemas.d.ts +23 -0
  6. package/oclif.manifest.json +1860 -1750
  7. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -656,156 +656,6 @@
656
656
  "whoami.js"
657
657
  ]
658
658
  },
659
- "flows:create": {
660
- "aliases": [],
661
- "args": {},
662
- "description": "Create a flow (row only — write its config with `flows config update`)",
663
- "examples": [
664
- "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
665
- ],
666
- "flags": {
667
- "json": {
668
- "description": "Format output as json.",
669
- "helpGroup": "GLOBAL",
670
- "name": "json",
671
- "allowNo": false,
672
- "type": "boolean"
673
- },
674
- "app": {
675
- "description": "App ID (UUID)",
676
- "name": "app",
677
- "required": true,
678
- "hasDynamicHelp": false,
679
- "multiple": false,
680
- "type": "option"
681
- },
682
- "name": {
683
- "description": "Flow name",
684
- "name": "name",
685
- "required": true,
686
- "hasDynamicHelp": false,
687
- "multiple": false,
688
- "type": "option"
689
- }
690
- },
691
- "hasDynamicHelp": false,
692
- "hiddenAliases": [],
693
- "id": "flows:create",
694
- "pluginAlias": "adapty",
695
- "pluginName": "adapty",
696
- "pluginType": "core",
697
- "strict": true,
698
- "enableJsonFlag": true,
699
- "isESM": true,
700
- "relativePath": [
701
- "dist",
702
- "commands",
703
- "flows",
704
- "create.js"
705
- ]
706
- },
707
- "flows:get": {
708
- "aliases": [],
709
- "args": {
710
- "flow_id": {
711
- "description": "Flow ID (UUID)",
712
- "name": "flow_id",
713
- "required": true
714
- }
715
- },
716
- "description": "Get flow details",
717
- "examples": [
718
- "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
719
- ],
720
- "flags": {
721
- "json": {
722
- "description": "Format output as json.",
723
- "helpGroup": "GLOBAL",
724
- "name": "json",
725
- "allowNo": false,
726
- "type": "boolean"
727
- },
728
- "app": {
729
- "description": "App ID (UUID)",
730
- "name": "app",
731
- "required": true,
732
- "hasDynamicHelp": false,
733
- "multiple": false,
734
- "type": "option"
735
- }
736
- },
737
- "hasDynamicHelp": false,
738
- "hiddenAliases": [],
739
- "id": "flows:get",
740
- "pluginAlias": "adapty",
741
- "pluginName": "adapty",
742
- "pluginType": "core",
743
- "strict": true,
744
- "enableJsonFlag": true,
745
- "isESM": true,
746
- "relativePath": [
747
- "dist",
748
- "commands",
749
- "flows",
750
- "get.js"
751
- ]
752
- },
753
- "flows:list": {
754
- "aliases": [],
755
- "args": {},
756
- "description": "List flows for an app",
757
- "examples": [
758
- "<%= config.bin %> flows list --app 550e8400-..."
759
- ],
760
- "flags": {
761
- "json": {
762
- "description": "Format output as json.",
763
- "helpGroup": "GLOBAL",
764
- "name": "json",
765
- "allowNo": false,
766
- "type": "boolean"
767
- },
768
- "app": {
769
- "description": "App ID (UUID)",
770
- "name": "app",
771
- "required": true,
772
- "hasDynamicHelp": false,
773
- "multiple": false,
774
- "type": "option"
775
- },
776
- "page": {
777
- "description": "Page number",
778
- "name": "page",
779
- "default": 1,
780
- "hasDynamicHelp": false,
781
- "multiple": false,
782
- "type": "option"
783
- },
784
- "page-size": {
785
- "description": "Items per page (max 100)",
786
- "name": "page-size",
787
- "default": 20,
788
- "hasDynamicHelp": false,
789
- "multiple": false,
790
- "type": "option"
791
- }
792
- },
793
- "hasDynamicHelp": false,
794
- "hiddenAliases": [],
795
- "id": "flows:list",
796
- "pluginAlias": "adapty",
797
- "pluginName": "adapty",
798
- "pluginType": "core",
799
- "strict": true,
800
- "enableJsonFlag": true,
801
- "isESM": true,
802
- "relativePath": [
803
- "dist",
804
- "commands",
805
- "flows",
806
- "list.js"
807
- ]
808
- },
809
659
  "paywalls:create": {
810
660
  "aliases": [],
811
661
  "args": {},
@@ -1072,89 +922,18 @@
1072
922
  "update.js"
1073
923
  ]
1074
924
  },
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": {
925
+ "segments:get": {
1147
926
  "aliases": [],
1148
927
  "args": {
1149
- "placement_id": {
1150
- "description": "Placement ID (UUID)",
1151
- "name": "placement_id",
928
+ "segment_id": {
929
+ "description": "Segment ID (UUID)",
930
+ "name": "segment_id",
1152
931
  "required": true
1153
932
  }
1154
933
  },
1155
- "description": "Get placement details",
934
+ "description": "Get segment details",
1156
935
  "examples": [
1157
- "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
936
+ "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1158
937
  ],
1159
938
  "flags": {
1160
939
  "json": {
@@ -1175,7 +954,7 @@
1175
954
  },
1176
955
  "hasDynamicHelp": false,
1177
956
  "hiddenAliases": [],
1178
- "id": "placements:get",
957
+ "id": "segments:get",
1179
958
  "pluginAlias": "adapty",
1180
959
  "pluginName": "adapty",
1181
960
  "pluginType": "core",
@@ -1185,16 +964,16 @@
1185
964
  "relativePath": [
1186
965
  "dist",
1187
966
  "commands",
1188
- "placements",
967
+ "segments",
1189
968
  "get.js"
1190
969
  ]
1191
970
  },
1192
- "placements:list": {
971
+ "segments:list": {
1193
972
  "aliases": [],
1194
973
  "args": {},
1195
- "description": "List placements for an app",
974
+ "description": "List segments for an app",
1196
975
  "examples": [
1197
- "<%= config.bin %> placements list --app 550e8400-..."
976
+ "<%= config.bin %> segments list --app 550e8400-..."
1198
977
  ],
1199
978
  "flags": {
1200
979
  "json": {
@@ -1231,7 +1010,7 @@
1231
1010
  },
1232
1011
  "hasDynamicHelp": false,
1233
1012
  "hiddenAliases": [],
1234
- "id": "placements:list",
1013
+ "id": "segments:list",
1235
1014
  "pluginAlias": "adapty",
1236
1015
  "pluginName": "adapty",
1237
1016
  "pluginType": "core",
@@ -1241,190 +1020,11 @@
1241
1020
  "relativePath": [
1242
1021
  "dist",
1243
1022
  "commands",
1244
- "placements",
1023
+ "segments",
1245
1024
  "list.js"
1246
1025
  ]
1247
1026
  },
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
- "segments:get": {
1326
- "aliases": [],
1327
- "args": {
1328
- "segment_id": {
1329
- "description": "Segment ID (UUID)",
1330
- "name": "segment_id",
1331
- "required": true
1332
- }
1333
- },
1334
- "description": "Get segment details",
1335
- "examples": [
1336
- "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1337
- ],
1338
- "flags": {
1339
- "json": {
1340
- "description": "Format output as json.",
1341
- "helpGroup": "GLOBAL",
1342
- "name": "json",
1343
- "allowNo": false,
1344
- "type": "boolean"
1345
- },
1346
- "app": {
1347
- "description": "App ID (UUID)",
1348
- "name": "app",
1349
- "required": true,
1350
- "hasDynamicHelp": false,
1351
- "multiple": false,
1352
- "type": "option"
1353
- }
1354
- },
1355
- "hasDynamicHelp": false,
1356
- "hiddenAliases": [],
1357
- "id": "segments:get",
1358
- "pluginAlias": "adapty",
1359
- "pluginName": "adapty",
1360
- "pluginType": "core",
1361
- "strict": true,
1362
- "enableJsonFlag": true,
1363
- "isESM": true,
1364
- "relativePath": [
1365
- "dist",
1366
- "commands",
1367
- "segments",
1368
- "get.js"
1369
- ]
1370
- },
1371
- "segments:list": {
1372
- "aliases": [],
1373
- "args": {},
1374
- "description": "List segments for an app",
1375
- "examples": [
1376
- "<%= config.bin %> segments list --app 550e8400-..."
1377
- ],
1378
- "flags": {
1379
- "json": {
1380
- "description": "Format output as json.",
1381
- "helpGroup": "GLOBAL",
1382
- "name": "json",
1383
- "allowNo": false,
1384
- "type": "boolean"
1385
- },
1386
- "app": {
1387
- "description": "App ID (UUID)",
1388
- "name": "app",
1389
- "required": true,
1390
- "hasDynamicHelp": false,
1391
- "multiple": false,
1392
- "type": "option"
1393
- },
1394
- "page": {
1395
- "description": "Page number",
1396
- "name": "page",
1397
- "default": 1,
1398
- "hasDynamicHelp": false,
1399
- "multiple": false,
1400
- "type": "option"
1401
- },
1402
- "page-size": {
1403
- "description": "Items per page (max 100)",
1404
- "name": "page-size",
1405
- "default": 20,
1406
- "hasDynamicHelp": false,
1407
- "multiple": false,
1408
- "type": "option"
1409
- }
1410
- },
1411
- "hasDynamicHelp": false,
1412
- "hiddenAliases": [],
1413
- "id": "segments:list",
1414
- "pluginAlias": "adapty",
1415
- "pluginName": "adapty",
1416
- "pluginType": "core",
1417
- "strict": true,
1418
- "enableJsonFlag": true,
1419
- "isESM": true,
1420
- "relativePath": [
1421
- "dist",
1422
- "commands",
1423
- "segments",
1424
- "list.js"
1425
- ]
1426
- },
1427
- "products:create": {
1027
+ "products:create": {
1428
1028
  "aliases": [],
1429
1029
  "args": {},
1430
1030
  "description": "Create a product with vendor products per platform",
@@ -1708,13 +1308,12 @@
1708
1308
  "update.js"
1709
1309
  ]
1710
1310
  },
1711
- "asa:ad-groups:create": {
1311
+ "flows:create": {
1712
1312
  "aliases": [],
1713
1313
  "args": {},
1714
- "description": "Create an ad group inside a campaign",
1314
+ "description": "Create a flow (row only — write its config with `flows config update`)",
1715
1315
  "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"
1316
+ "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
1718
1317
  ],
1719
1318
  "flags": {
1720
1319
  "json": {
@@ -1724,106 +1323,26 @@
1724
1323
  "allowNo": false,
1725
1324
  "type": "boolean"
1726
1325
  },
1727
- "currency": {
1728
- "description": "Currency code for the amounts in this call",
1729
- "name": "currency",
1730
- "default": "USD",
1731
- "hasDynamicHelp": false,
1732
- "multiple": false,
1733
- "type": "option"
1734
- },
1735
- "end-time": {
1736
- "description": "Schedule end (YYYY-MM-DD)",
1737
- "name": "end-time",
1738
- "hasDynamicHelp": false,
1739
- "multiple": false,
1740
- "type": "option"
1741
- },
1742
- "start-time": {
1743
- "description": "Schedule start (YYYY-MM-DD), defaults to today",
1744
- "name": "start-time",
1745
- "hasDynamicHelp": false,
1746
- "multiple": false,
1747
- "type": "option"
1748
- },
1749
- "pricing-model": {
1750
- "description": "Pricing model; Apple requires one on every ad group",
1751
- "name": "pricing-model",
1752
- "default": "CPC",
1753
- "hasDynamicHelp": false,
1754
- "multiple": false,
1755
- "options": [
1756
- "CPC",
1757
- "CPM"
1758
- ],
1759
- "type": "option"
1760
- },
1761
- "yes": {
1762
- "char": "y",
1763
- "description": "Apply without asking; required when the output is piped or --json is used",
1764
- "name": "yes",
1765
- "allowNo": false,
1766
- "type": "boolean"
1767
- },
1768
- "idempotency-key": {
1769
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1770
- "name": "idempotency-key",
1771
- "hasDynamicHelp": false,
1772
- "multiple": false,
1773
- "type": "option"
1774
- },
1775
- "automated-keywords": {
1776
- "description": "Let Apple add keywords automatically",
1777
- "name": "automated-keywords",
1778
- "allowNo": true,
1779
- "type": "boolean"
1780
- },
1781
- "campaign": {
1782
- "description": "Campaign ID (UUID)",
1783
- "name": "campaign",
1784
- "required": true,
1785
- "hasDynamicHelp": false,
1786
- "multiple": false,
1787
- "type": "option"
1788
- },
1789
- "cpa-goal": {
1790
- "description": "CPA goal (amount, e.g. 50 or 12.50)",
1791
- "name": "cpa-goal",
1792
- "hasDynamicHelp": false,
1793
- "multiple": false,
1794
- "type": "option"
1795
- },
1796
- "default-bid": {
1797
- "description": "Default bid (amount, e.g. 50 or 12.50)",
1798
- "name": "default-bid",
1326
+ "app": {
1327
+ "description": "App ID (UUID)",
1328
+ "name": "app",
1799
1329
  "required": true,
1800
1330
  "hasDynamicHelp": false,
1801
1331
  "multiple": false,
1802
1332
  "type": "option"
1803
1333
  },
1804
1334
  "name": {
1805
- "description": "Ad group name",
1335
+ "description": "Flow name",
1806
1336
  "name": "name",
1807
1337
  "required": true,
1808
1338
  "hasDynamicHelp": false,
1809
1339
  "multiple": false,
1810
1340
  "type": "option"
1811
- },
1812
- "status": {
1813
- "description": "Initial status",
1814
- "name": "status",
1815
- "hasDynamicHelp": false,
1816
- "multiple": false,
1817
- "options": [
1818
- "ENABLED",
1819
- "PAUSED"
1820
- ],
1821
- "type": "option"
1822
1341
  }
1823
1342
  },
1824
1343
  "hasDynamicHelp": false,
1825
1344
  "hiddenAliases": [],
1826
- "id": "asa:ad-groups:create",
1345
+ "id": "flows:create",
1827
1346
  "pluginAlias": "adapty",
1828
1347
  "pluginName": "adapty",
1829
1348
  "pluginType": "core",
@@ -1833,23 +1352,22 @@
1833
1352
  "relativePath": [
1834
1353
  "dist",
1835
1354
  "commands",
1836
- "asa",
1837
- "ad-groups",
1355
+ "flows",
1838
1356
  "create.js"
1839
1357
  ]
1840
1358
  },
1841
- "asa:ad-groups:get": {
1359
+ "flows:get": {
1842
1360
  "aliases": [],
1843
1361
  "args": {
1844
- "ad_group_id": {
1845
- "description": "Ad group ID (UUID)",
1846
- "name": "ad_group_id",
1362
+ "flow_id": {
1363
+ "description": "Flow ID (UUID)",
1364
+ "name": "flow_id",
1847
1365
  "required": true
1848
1366
  }
1849
1367
  },
1850
- "description": "Show one ad group; read numbers with asa metrics",
1368
+ "description": "Get flow details",
1851
1369
  "examples": [
1852
- "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
1370
+ "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1853
1371
  ],
1854
1372
  "flags": {
1855
1373
  "json": {
@@ -1858,11 +1376,19 @@
1858
1376
  "name": "json",
1859
1377
  "allowNo": false,
1860
1378
  "type": "boolean"
1379
+ },
1380
+ "app": {
1381
+ "description": "App ID (UUID)",
1382
+ "name": "app",
1383
+ "required": true,
1384
+ "hasDynamicHelp": false,
1385
+ "multiple": false,
1386
+ "type": "option"
1861
1387
  }
1862
1388
  },
1863
1389
  "hasDynamicHelp": false,
1864
1390
  "hiddenAliases": [],
1865
- "id": "asa:ad-groups:get",
1391
+ "id": "flows:get",
1866
1392
  "pluginAlias": "adapty",
1867
1393
  "pluginName": "adapty",
1868
1394
  "pluginType": "core",
@@ -1872,18 +1398,16 @@
1872
1398
  "relativePath": [
1873
1399
  "dist",
1874
1400
  "commands",
1875
- "asa",
1876
- "ad-groups",
1401
+ "flows",
1877
1402
  "get.js"
1878
1403
  ]
1879
1404
  },
1880
- "asa:ad-groups:list": {
1405
+ "flows:list": {
1881
1406
  "aliases": [],
1882
1407
  "args": {},
1883
- "description": "List ad groups; read numbers with asa metrics",
1408
+ "description": "List flows for an app",
1884
1409
  "examples": [
1885
- "<%= config.bin %> asa ad-groups list",
1886
- "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
1410
+ "<%= config.bin %> flows list --app 550e8400-..."
1887
1411
  ],
1888
1412
  "flags": {
1889
1413
  "json": {
@@ -1893,6 +1417,14 @@
1893
1417
  "allowNo": false,
1894
1418
  "type": "boolean"
1895
1419
  },
1420
+ "app": {
1421
+ "description": "App ID (UUID)",
1422
+ "name": "app",
1423
+ "required": true,
1424
+ "hasDynamicHelp": false,
1425
+ "multiple": false,
1426
+ "type": "option"
1427
+ },
1896
1428
  "page": {
1897
1429
  "description": "Page number",
1898
1430
  "name": "page",
@@ -1902,56 +1434,88 @@
1902
1434
  "type": "option"
1903
1435
  },
1904
1436
  "page-size": {
1905
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
1437
+ "description": "Items per page (max 100)",
1906
1438
  "name": "page-size",
1907
- "default": 100,
1439
+ "default": 20,
1908
1440
  "hasDynamicHelp": false,
1909
1441
  "multiple": false,
1910
1442
  "type": "option"
1443
+ }
1444
+ },
1445
+ "hasDynamicHelp": false,
1446
+ "hiddenAliases": [],
1447
+ "id": "flows:list",
1448
+ "pluginAlias": "adapty",
1449
+ "pluginName": "adapty",
1450
+ "pluginType": "core",
1451
+ "strict": true,
1452
+ "enableJsonFlag": true,
1453
+ "isESM": true,
1454
+ "relativePath": [
1455
+ "dist",
1456
+ "commands",
1457
+ "flows",
1458
+ "list.js"
1459
+ ]
1460
+ },
1461
+ "placements:create": {
1462
+ "aliases": [],
1463
+ "args": {},
1464
+ "description": "Create a placement with a paywall",
1465
+ "examples": [
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"
1911
1476
  },
1912
1477
  "app": {
1913
- "description": "Keep only rows in this app; repeatable",
1478
+ "description": "App ID (UUID)",
1914
1479
  "name": "app",
1480
+ "required": true,
1915
1481
  "hasDynamicHelp": false,
1916
- "multiple": true,
1482
+ "multiple": false,
1917
1483
  "type": "option"
1918
1484
  },
1919
- "campaign-group": {
1920
- "description": "Keep only rows in this campaign group; repeatable",
1921
- "name": "campaign-group",
1485
+ "audiences": {
1486
+ "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1487
+ "name": "audiences",
1922
1488
  "hasDynamicHelp": false,
1923
- "multiple": true,
1489
+ "multiple": false,
1924
1490
  "type": "option"
1925
1491
  },
1926
- "search": {
1927
- "description": "Case-insensitive substring match on the name",
1928
- "name": "search",
1492
+ "developer-id": {
1493
+ "description": "Developer ID for the placement",
1494
+ "name": "developer-id",
1495
+ "required": true,
1929
1496
  "hasDynamicHelp": false,
1930
1497
  "multiple": false,
1931
1498
  "type": "option"
1932
1499
  },
1933
- "campaign": {
1934
- "description": "Keep only rows in this campaign; repeatable",
1935
- "name": "campaign",
1500
+ "paywall-id": {
1501
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1502
+ "name": "paywall-id",
1936
1503
  "hasDynamicHelp": false,
1937
- "multiple": true,
1504
+ "multiple": false,
1938
1505
  "type": "option"
1939
1506
  },
1940
- "status": {
1941
- "description": "Keep only rows in this state",
1942
- "name": "status",
1507
+ "title": {
1508
+ "description": "Placement title",
1509
+ "name": "title",
1510
+ "required": true,
1943
1511
  "hasDynamicHelp": false,
1944
1512
  "multiple": false,
1945
- "options": [
1946
- "ENABLED",
1947
- "PAUSED"
1948
- ],
1949
1513
  "type": "option"
1950
1514
  }
1951
1515
  },
1952
1516
  "hasDynamicHelp": false,
1953
1517
  "hiddenAliases": [],
1954
- "id": "asa:ad-groups:list",
1518
+ "id": "placements:create",
1955
1519
  "pluginAlias": "adapty",
1956
1520
  "pluginName": "adapty",
1957
1521
  "pluginType": "core",
@@ -1961,24 +1525,22 @@
1961
1525
  "relativePath": [
1962
1526
  "dist",
1963
1527
  "commands",
1964
- "asa",
1965
- "ad-groups",
1966
- "list.js"
1528
+ "placements",
1529
+ "create.js"
1967
1530
  ]
1968
1531
  },
1969
- "asa:ad-groups:update": {
1532
+ "placements:get": {
1970
1533
  "aliases": [],
1971
1534
  "args": {
1972
- "ad_group_id": {
1973
- "description": "Ad group ID (UUID)",
1974
- "name": "ad_group_id",
1535
+ "placement_id": {
1536
+ "description": "Placement ID (UUID)",
1537
+ "name": "placement_id",
1975
1538
  "required": true
1976
1539
  }
1977
1540
  },
1978
- "description": "Change an ad group: bid, CPA goal, status or schedule",
1541
+ "description": "Get placement details",
1979
1542
  "examples": [
1980
- "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
1981
- "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
1543
+ "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1982
1544
  ],
1983
1545
  "flags": {
1984
1546
  "json": {
@@ -1988,84 +1550,18 @@
1988
1550
  "allowNo": false,
1989
1551
  "type": "boolean"
1990
1552
  },
1991
- "currency": {
1992
- "description": "Currency code for the amounts in this call",
1993
- "name": "currency",
1994
- "default": "USD",
1995
- "hasDynamicHelp": false,
1996
- "multiple": false,
1997
- "type": "option"
1998
- },
1999
- "end-time": {
2000
- "description": "Schedule end (YYYY-MM-DD)",
2001
- "name": "end-time",
2002
- "hasDynamicHelp": false,
2003
- "multiple": false,
2004
- "type": "option"
2005
- },
2006
- "start-time": {
2007
- "description": "Schedule start (YYYY-MM-DD), defaults to today",
2008
- "name": "start-time",
2009
- "hasDynamicHelp": false,
2010
- "multiple": false,
2011
- "type": "option"
2012
- },
2013
- "yes": {
2014
- "char": "y",
2015
- "description": "Apply without asking; required when the output is piped or --json is used",
2016
- "name": "yes",
2017
- "allowNo": false,
2018
- "type": "boolean"
2019
- },
2020
- "idempotency-key": {
2021
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2022
- "name": "idempotency-key",
2023
- "hasDynamicHelp": false,
2024
- "multiple": false,
2025
- "type": "option"
2026
- },
2027
- "automated-keywords": {
2028
- "description": "Let Apple add keywords automatically",
2029
- "name": "automated-keywords",
2030
- "allowNo": true,
2031
- "type": "boolean"
2032
- },
2033
- "cpa-goal": {
2034
- "description": "CPA goal (amount, e.g. 50 or 12.50)",
2035
- "name": "cpa-goal",
2036
- "hasDynamicHelp": false,
2037
- "multiple": false,
2038
- "type": "option"
2039
- },
2040
- "default-bid": {
2041
- "description": "Default bid (amount, e.g. 50 or 12.50)",
2042
- "name": "default-bid",
2043
- "hasDynamicHelp": false,
2044
- "multiple": false,
2045
- "type": "option"
2046
- },
2047
- "name": {
2048
- "description": "Ad group name",
2049
- "name": "name",
2050
- "hasDynamicHelp": false,
2051
- "multiple": false,
2052
- "type": "option"
2053
- },
2054
- "status": {
2055
- "description": "Ad group status",
2056
- "name": "status",
1553
+ "app": {
1554
+ "description": "App ID (UUID)",
1555
+ "name": "app",
1556
+ "required": true,
2057
1557
  "hasDynamicHelp": false,
2058
1558
  "multiple": false,
2059
- "options": [
2060
- "ENABLED",
2061
- "PAUSED"
2062
- ],
2063
1559
  "type": "option"
2064
1560
  }
2065
1561
  },
2066
1562
  "hasDynamicHelp": false,
2067
1563
  "hiddenAliases": [],
2068
- "id": "asa:ad-groups:update",
1564
+ "id": "placements:get",
2069
1565
  "pluginAlias": "adapty",
2070
1566
  "pluginName": "adapty",
2071
1567
  "pluginType": "core",
@@ -2075,17 +1571,16 @@
2075
1571
  "relativePath": [
2076
1572
  "dist",
2077
1573
  "commands",
2078
- "asa",
2079
- "ad-groups",
2080
- "update.js"
1574
+ "placements",
1575
+ "get.js"
2081
1576
  ]
2082
1577
  },
2083
- "asa:ads:create": {
1578
+ "placements:list": {
2084
1579
  "aliases": [],
2085
1580
  "args": {},
2086
- "description": "Create an ad from a creative in an ad group",
1581
+ "description": "List placements for an app",
2087
1582
  "examples": [
2088
- "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
1583
+ "<%= config.bin %> placements list --app 550e8400-..."
2089
1584
  ],
2090
1585
  "flags": {
2091
1586
  "json": {
@@ -2095,59 +1590,34 @@
2095
1590
  "allowNo": false,
2096
1591
  "type": "boolean"
2097
1592
  },
2098
- "yes": {
2099
- "char": "y",
2100
- "description": "Apply without asking; required when the output is piped or --json is used",
2101
- "name": "yes",
2102
- "allowNo": false,
2103
- "type": "boolean"
2104
- },
2105
- "idempotency-key": {
2106
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2107
- "name": "idempotency-key",
1593
+ "app": {
1594
+ "description": "App ID (UUID)",
1595
+ "name": "app",
1596
+ "required": true,
2108
1597
  "hasDynamicHelp": false,
2109
1598
  "multiple": false,
2110
1599
  "type": "option"
2111
1600
  },
2112
- "ad-group": {
2113
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
2114
- "name": "ad-group",
2115
- "required": true,
2116
- "hasDynamicHelp": false,
2117
- "multiple": false,
2118
- "type": "option"
2119
- },
2120
- "creative-id": {
2121
- "description": "Apple creative ID from a product page or the default set",
2122
- "name": "creative-id",
2123
- "required": true,
2124
- "hasDynamicHelp": false,
2125
- "multiple": false,
2126
- "type": "option"
2127
- },
2128
- "name": {
2129
- "description": "Ad name",
2130
- "name": "name",
2131
- "required": true,
1601
+ "page": {
1602
+ "description": "Page number",
1603
+ "name": "page",
1604
+ "default": 1,
2132
1605
  "hasDynamicHelp": false,
2133
1606
  "multiple": false,
2134
1607
  "type": "option"
2135
1608
  },
2136
- "status": {
2137
- "description": "Initial status",
2138
- "name": "status",
1609
+ "page-size": {
1610
+ "description": "Items per page (max 100)",
1611
+ "name": "page-size",
1612
+ "default": 20,
2139
1613
  "hasDynamicHelp": false,
2140
1614
  "multiple": false,
2141
- "options": [
2142
- "ENABLED",
2143
- "PAUSED"
2144
- ],
2145
1615
  "type": "option"
2146
1616
  }
2147
1617
  },
2148
1618
  "hasDynamicHelp": false,
2149
1619
  "hiddenAliases": [],
2150
- "id": "asa:ads:create",
1620
+ "id": "placements:list",
2151
1621
  "pluginAlias": "adapty",
2152
1622
  "pluginName": "adapty",
2153
1623
  "pluginType": "core",
@@ -2157,23 +1627,23 @@
2157
1627
  "relativePath": [
2158
1628
  "dist",
2159
1629
  "commands",
2160
- "asa",
2161
- "ads",
2162
- "create.js"
1630
+ "placements",
1631
+ "list.js"
2163
1632
  ]
2164
1633
  },
2165
- "asa:ads:get": {
1634
+ "placements:update": {
2166
1635
  "aliases": [],
2167
1636
  "args": {
2168
- "ad_id": {
2169
- "description": "Ad ID (UUID)",
2170
- "name": "ad_id",
1637
+ "placement_id": {
1638
+ "description": "Placement ID (UUID)",
1639
+ "name": "placement_id",
2171
1640
  "required": true
2172
1641
  }
2173
1642
  },
2174
- "description": "Show one ad and its serving state",
1643
+ "description": "Update a placement",
2175
1644
  "examples": [
2176
- "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
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"
2177
1647
  ],
2178
1648
  "flags": {
2179
1649
  "json": {
@@ -2182,11 +1652,49 @@
2182
1652
  "name": "json",
2183
1653
  "allowNo": false,
2184
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"
2185
1693
  }
2186
1694
  },
2187
1695
  "hasDynamicHelp": false,
2188
1696
  "hiddenAliases": [],
2189
- "id": "asa:ads:get",
1697
+ "id": "placements:update",
2190
1698
  "pluginAlias": "adapty",
2191
1699
  "pluginName": "adapty",
2192
1700
  "pluginType": "core",
@@ -2196,18 +1704,17 @@
2196
1704
  "relativePath": [
2197
1705
  "dist",
2198
1706
  "commands",
2199
- "asa",
2200
- "ads",
2201
- "get.js"
1707
+ "placements",
1708
+ "update.js"
2202
1709
  ]
2203
1710
  },
2204
- "asa:ads:list": {
1711
+ "asa:ad-groups:create": {
2205
1712
  "aliases": [],
2206
1713
  "args": {},
2207
- "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
1714
+ "description": "Create an ad group inside a campaign",
2208
1715
  "examples": [
2209
- "<%= config.bin %> asa ads list",
2210
- "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
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"
2211
1718
  ],
2212
1719
  "flags": {
2213
1720
  "json": {
@@ -2217,52 +1724,93 @@
2217
1724
  "allowNo": false,
2218
1725
  "type": "boolean"
2219
1726
  },
2220
- "page": {
2221
- "description": "Page number",
2222
- "name": "page",
2223
- "default": 1,
1727
+ "currency": {
1728
+ "description": "Currency code for the amounts in this call",
1729
+ "name": "currency",
1730
+ "default": "USD",
2224
1731
  "hasDynamicHelp": false,
2225
1732
  "multiple": false,
2226
1733
  "type": "option"
2227
1734
  },
2228
- "page-size": {
2229
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2230
- "name": "page-size",
2231
- "default": 100,
1735
+ "end-time": {
1736
+ "description": "Schedule end (YYYY-MM-DD)",
1737
+ "name": "end-time",
2232
1738
  "hasDynamicHelp": false,
2233
1739
  "multiple": false,
2234
1740
  "type": "option"
2235
1741
  },
2236
- "ad-group": {
2237
- "description": "Keep only rows in this ad group; repeatable",
2238
- "name": "ad-group",
1742
+ "start-time": {
1743
+ "description": "Schedule start (YYYY-MM-DD), defaults to today",
1744
+ "name": "start-time",
2239
1745
  "hasDynamicHelp": false,
2240
- "multiple": true,
1746
+ "multiple": false,
2241
1747
  "type": "option"
2242
1748
  },
1749
+ "pricing-model": {
1750
+ "description": "Pricing model; Apple requires one on every ad group",
1751
+ "name": "pricing-model",
1752
+ "default": "CPC",
1753
+ "hasDynamicHelp": false,
1754
+ "multiple": false,
1755
+ "options": [
1756
+ "CPC",
1757
+ "CPM"
1758
+ ],
1759
+ "type": "option"
1760
+ },
1761
+ "yes": {
1762
+ "char": "y",
1763
+ "description": "Apply without asking; required when the output is piped or --json is used",
1764
+ "name": "yes",
1765
+ "allowNo": false,
1766
+ "type": "boolean"
1767
+ },
1768
+ "idempotency-key": {
1769
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1770
+ "name": "idempotency-key",
1771
+ "hasDynamicHelp": false,
1772
+ "multiple": false,
1773
+ "type": "option"
1774
+ },
1775
+ "automated-keywords": {
1776
+ "description": "Let Apple add keywords automatically",
1777
+ "name": "automated-keywords",
1778
+ "allowNo": true,
1779
+ "type": "boolean"
1780
+ },
2243
1781
  "campaign": {
2244
- "description": "Keep only rows in this campaign; repeatable",
1782
+ "description": "Campaign ID (UUID)",
2245
1783
  "name": "campaign",
1784
+ "required": true,
2246
1785
  "hasDynamicHelp": false,
2247
- "multiple": true,
1786
+ "multiple": false,
2248
1787
  "type": "option"
2249
1788
  },
2250
- "campaign-group": {
2251
- "description": "Keep only rows in this campaign group; repeatable",
2252
- "name": "campaign-group",
1789
+ "cpa-goal": {
1790
+ "description": "CPA goal (amount, e.g. 50 or 12.50)",
1791
+ "name": "cpa-goal",
2253
1792
  "hasDynamicHelp": false,
2254
- "multiple": true,
1793
+ "multiple": false,
2255
1794
  "type": "option"
2256
1795
  },
2257
- "search": {
2258
- "description": "Case-insensitive substring match on the name",
2259
- "name": "search",
1796
+ "default-bid": {
1797
+ "description": "Default bid (amount, e.g. 50 or 12.50)",
1798
+ "name": "default-bid",
1799
+ "required": true,
1800
+ "hasDynamicHelp": false,
1801
+ "multiple": false,
1802
+ "type": "option"
1803
+ },
1804
+ "name": {
1805
+ "description": "Ad group name",
1806
+ "name": "name",
1807
+ "required": true,
2260
1808
  "hasDynamicHelp": false,
2261
1809
  "multiple": false,
2262
1810
  "type": "option"
2263
1811
  },
2264
1812
  "status": {
2265
- "description": "Keep only rows in this state",
1813
+ "description": "Initial status",
2266
1814
  "name": "status",
2267
1815
  "hasDynamicHelp": false,
2268
1816
  "multiple": false,
@@ -2275,7 +1823,7 @@
2275
1823
  },
2276
1824
  "hasDynamicHelp": false,
2277
1825
  "hiddenAliases": [],
2278
- "id": "asa:ads:list",
1826
+ "id": "asa:ad-groups:create",
2279
1827
  "pluginAlias": "adapty",
2280
1828
  "pluginName": "adapty",
2281
1829
  "pluginType": "core",
@@ -2286,22 +1834,22 @@
2286
1834
  "dist",
2287
1835
  "commands",
2288
1836
  "asa",
2289
- "ads",
2290
- "list.js"
1837
+ "ad-groups",
1838
+ "create.js"
2291
1839
  ]
2292
1840
  },
2293
- "asa:ads:update": {
1841
+ "asa:ad-groups:get": {
2294
1842
  "aliases": [],
2295
1843
  "args": {
2296
- "ad_id": {
2297
- "description": "Ad ID (UUID)",
2298
- "name": "ad_id",
1844
+ "ad_group_id": {
1845
+ "description": "Ad group ID (UUID)",
1846
+ "name": "ad_group_id",
2299
1847
  "required": true
2300
1848
  }
2301
1849
  },
2302
- "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
1850
+ "description": "Show one ad group; read numbers with asa metrics",
2303
1851
  "examples": [
2304
- "<%= config.bin %> asa ads update UUID --status PAUSED"
1852
+ "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
2305
1853
  ],
2306
1854
  "flags": {
2307
1855
  "json": {
@@ -2310,43 +1858,11 @@
2310
1858
  "name": "json",
2311
1859
  "allowNo": false,
2312
1860
  "type": "boolean"
2313
- },
2314
- "yes": {
2315
- "char": "y",
2316
- "description": "Apply without asking; required when the output is piped or --json is used",
2317
- "name": "yes",
2318
- "allowNo": false,
2319
- "type": "boolean"
2320
- },
2321
- "idempotency-key": {
2322
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2323
- "name": "idempotency-key",
2324
- "hasDynamicHelp": false,
2325
- "multiple": false,
2326
- "type": "option"
2327
- },
2328
- "name": {
2329
- "description": "Ad name",
2330
- "name": "name",
2331
- "hasDynamicHelp": false,
2332
- "multiple": false,
2333
- "type": "option"
2334
- },
2335
- "status": {
2336
- "description": "Ad status",
2337
- "name": "status",
2338
- "hasDynamicHelp": false,
2339
- "multiple": false,
2340
- "options": [
2341
- "ENABLED",
2342
- "PAUSED"
2343
- ],
2344
- "type": "option"
2345
1861
  }
2346
1862
  },
2347
1863
  "hasDynamicHelp": false,
2348
1864
  "hiddenAliases": [],
2349
- "id": "asa:ads:update",
1865
+ "id": "asa:ad-groups:get",
2350
1866
  "pluginAlias": "adapty",
2351
1867
  "pluginName": "adapty",
2352
1868
  "pluginType": "core",
@@ -2357,17 +1873,17 @@
2357
1873
  "dist",
2358
1874
  "commands",
2359
1875
  "asa",
2360
- "ads",
2361
- "update.js"
1876
+ "ad-groups",
1877
+ "get.js"
2362
1878
  ]
2363
1879
  },
2364
- "asa:apps:list": {
1880
+ "asa:ad-groups:list": {
2365
1881
  "aliases": [],
2366
1882
  "args": {},
2367
- "description": "List the apps promoted by this company in Apple Search Ads",
1883
+ "description": "List ad groups; read numbers with asa metrics",
2368
1884
  "examples": [
2369
- "<%= config.bin %> asa apps list",
2370
- "<%= config.bin %> asa apps list --page 2 --page-size 50"
1885
+ "<%= config.bin %> asa ad-groups list",
1886
+ "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
2371
1887
  ],
2372
1888
  "flags": {
2373
1889
  "json": {
@@ -2392,11 +1908,50 @@
2392
1908
  "hasDynamicHelp": false,
2393
1909
  "multiple": false,
2394
1910
  "type": "option"
2395
- }
2396
- },
1911
+ },
1912
+ "app": {
1913
+ "description": "Keep only rows in this app; repeatable",
1914
+ "name": "app",
1915
+ "hasDynamicHelp": false,
1916
+ "multiple": true,
1917
+ "type": "option"
1918
+ },
1919
+ "campaign-group": {
1920
+ "description": "Keep only rows in this campaign group; repeatable",
1921
+ "name": "campaign-group",
1922
+ "hasDynamicHelp": false,
1923
+ "multiple": true,
1924
+ "type": "option"
1925
+ },
1926
+ "search": {
1927
+ "description": "Case-insensitive substring match on the name",
1928
+ "name": "search",
1929
+ "hasDynamicHelp": false,
1930
+ "multiple": false,
1931
+ "type": "option"
1932
+ },
1933
+ "campaign": {
1934
+ "description": "Keep only rows in this campaign; repeatable",
1935
+ "name": "campaign",
1936
+ "hasDynamicHelp": false,
1937
+ "multiple": true,
1938
+ "type": "option"
1939
+ },
1940
+ "status": {
1941
+ "description": "Keep only rows in this state",
1942
+ "name": "status",
1943
+ "hasDynamicHelp": false,
1944
+ "multiple": false,
1945
+ "options": [
1946
+ "ENABLED",
1947
+ "PAUSED"
1948
+ ],
1949
+ "type": "option"
1950
+ }
1951
+ },
2397
1952
  "hasDynamicHelp": false,
2398
1953
  "hiddenAliases": [],
2399
- "id": "asa:apps:list",
1954
+ "id": "asa:ad-groups:list",
2400
1955
  "pluginAlias": "adapty",
2401
1956
  "pluginName": "adapty",
2402
1957
  "pluginType": "core",
@@ -2407,17 +1962,23 @@
2407
1962
  "dist",
2408
1963
  "commands",
2409
1964
  "asa",
2410
- "apps",
1965
+ "ad-groups",
2411
1966
  "list.js"
2412
1967
  ]
2413
1968
  },
2414
- "asa:automations:create": {
1969
+ "asa:ad-groups:update": {
2415
1970
  "aliases": [],
2416
- "args": {},
2417
- "description": "Create an automation rule from a JSON rule file",
1971
+ "args": {
1972
+ "ad_group_id": {
1973
+ "description": "Ad group ID (UUID)",
1974
+ "name": "ad_group_id",
1975
+ "required": true
1976
+ }
1977
+ },
1978
+ "description": "Change an ad group: bid, CPA goal, status or schedule",
2418
1979
  "examples": [
2419
- "<%= config.bin %> asa automations create --file rule.json",
2420
- "<%= config.bin %> asa automations create --file rule.json --run-now"
1980
+ "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
1981
+ "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
2421
1982
  ],
2422
1983
  "flags": {
2423
1984
  "json": {
@@ -2427,6 +1988,28 @@
2427
1988
  "allowNo": false,
2428
1989
  "type": "boolean"
2429
1990
  },
1991
+ "currency": {
1992
+ "description": "Currency code for the amounts in this call",
1993
+ "name": "currency",
1994
+ "default": "USD",
1995
+ "hasDynamicHelp": false,
1996
+ "multiple": false,
1997
+ "type": "option"
1998
+ },
1999
+ "end-time": {
2000
+ "description": "Schedule end (YYYY-MM-DD)",
2001
+ "name": "end-time",
2002
+ "hasDynamicHelp": false,
2003
+ "multiple": false,
2004
+ "type": "option"
2005
+ },
2006
+ "start-time": {
2007
+ "description": "Schedule start (YYYY-MM-DD), defaults to today",
2008
+ "name": "start-time",
2009
+ "hasDynamicHelp": false,
2010
+ "multiple": false,
2011
+ "type": "option"
2012
+ },
2430
2013
  "yes": {
2431
2014
  "char": "y",
2432
2015
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2441,24 +2024,130 @@
2441
2024
  "multiple": false,
2442
2025
  "type": "option"
2443
2026
  },
2444
- "file": {
2445
- "description": "JSON file with the rule body, or - to read stdin",
2446
- "name": "file",
2447
- "required": true,
2027
+ "automated-keywords": {
2028
+ "description": "Let Apple add keywords automatically",
2029
+ "name": "automated-keywords",
2030
+ "allowNo": true,
2031
+ "type": "boolean"
2032
+ },
2033
+ "cpa-goal": {
2034
+ "description": "CPA goal (amount, e.g. 50 or 12.50)",
2035
+ "name": "cpa-goal",
2448
2036
  "hasDynamicHelp": false,
2449
2037
  "multiple": false,
2450
2038
  "type": "option"
2451
2039
  },
2452
- "run-now": {
2453
- "description": "Queue the first run right after the rule is stored",
2454
- "name": "run-now",
2040
+ "default-bid": {
2041
+ "description": "Default bid (amount, e.g. 50 or 12.50)",
2042
+ "name": "default-bid",
2043
+ "hasDynamicHelp": false,
2044
+ "multiple": false,
2045
+ "type": "option"
2046
+ },
2047
+ "name": {
2048
+ "description": "Ad group name",
2049
+ "name": "name",
2050
+ "hasDynamicHelp": false,
2051
+ "multiple": false,
2052
+ "type": "option"
2053
+ },
2054
+ "status": {
2055
+ "description": "Ad group status",
2056
+ "name": "status",
2057
+ "hasDynamicHelp": false,
2058
+ "multiple": false,
2059
+ "options": [
2060
+ "ENABLED",
2061
+ "PAUSED"
2062
+ ],
2063
+ "type": "option"
2064
+ }
2065
+ },
2066
+ "hasDynamicHelp": false,
2067
+ "hiddenAliases": [],
2068
+ "id": "asa:ad-groups:update",
2069
+ "pluginAlias": "adapty",
2070
+ "pluginName": "adapty",
2071
+ "pluginType": "core",
2072
+ "strict": true,
2073
+ "enableJsonFlag": true,
2074
+ "isESM": true,
2075
+ "relativePath": [
2076
+ "dist",
2077
+ "commands",
2078
+ "asa",
2079
+ "ad-groups",
2080
+ "update.js"
2081
+ ]
2082
+ },
2083
+ "asa:ads:create": {
2084
+ "aliases": [],
2085
+ "args": {},
2086
+ "description": "Create an ad from a creative in an ad group",
2087
+ "examples": [
2088
+ "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
2089
+ ],
2090
+ "flags": {
2091
+ "json": {
2092
+ "description": "Format output as json.",
2093
+ "helpGroup": "GLOBAL",
2094
+ "name": "json",
2095
+ "allowNo": false,
2096
+ "type": "boolean"
2097
+ },
2098
+ "yes": {
2099
+ "char": "y",
2100
+ "description": "Apply without asking; required when the output is piped or --json is used",
2101
+ "name": "yes",
2455
2102
  "allowNo": false,
2456
2103
  "type": "boolean"
2104
+ },
2105
+ "idempotency-key": {
2106
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2107
+ "name": "idempotency-key",
2108
+ "hasDynamicHelp": false,
2109
+ "multiple": false,
2110
+ "type": "option"
2111
+ },
2112
+ "ad-group": {
2113
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
2114
+ "name": "ad-group",
2115
+ "required": true,
2116
+ "hasDynamicHelp": false,
2117
+ "multiple": false,
2118
+ "type": "option"
2119
+ },
2120
+ "creative-id": {
2121
+ "description": "Apple creative ID from a product page or the default set",
2122
+ "name": "creative-id",
2123
+ "required": true,
2124
+ "hasDynamicHelp": false,
2125
+ "multiple": false,
2126
+ "type": "option"
2127
+ },
2128
+ "name": {
2129
+ "description": "Ad name",
2130
+ "name": "name",
2131
+ "required": true,
2132
+ "hasDynamicHelp": false,
2133
+ "multiple": false,
2134
+ "type": "option"
2135
+ },
2136
+ "status": {
2137
+ "description": "Initial status",
2138
+ "name": "status",
2139
+ "hasDynamicHelp": false,
2140
+ "multiple": false,
2141
+ "options": [
2142
+ "ENABLED",
2143
+ "PAUSED"
2144
+ ],
2145
+ "type": "option"
2457
2146
  }
2458
2147
  },
2459
2148
  "hasDynamicHelp": false,
2460
2149
  "hiddenAliases": [],
2461
- "id": "asa:automations:create",
2150
+ "id": "asa:ads:create",
2462
2151
  "pluginAlias": "adapty",
2463
2152
  "pluginName": "adapty",
2464
2153
  "pluginType": "core",
@@ -2469,22 +2158,22 @@
2469
2158
  "dist",
2470
2159
  "commands",
2471
2160
  "asa",
2472
- "automations",
2161
+ "ads",
2473
2162
  "create.js"
2474
2163
  ]
2475
2164
  },
2476
- "asa:automations:get": {
2165
+ "asa:ads:get": {
2477
2166
  "aliases": [],
2478
2167
  "args": {
2479
- "automation_id": {
2480
- "description": "Automation rule ID (UUID)",
2481
- "name": "automation_id",
2168
+ "ad_id": {
2169
+ "description": "Ad ID (UUID)",
2170
+ "name": "ad_id",
2482
2171
  "required": true
2483
2172
  }
2484
2173
  },
2485
- "description": "Show one automation rule with its conditions and actions",
2174
+ "description": "Show one ad and its serving state",
2486
2175
  "examples": [
2487
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2176
+ "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
2488
2177
  ],
2489
2178
  "flags": {
2490
2179
  "json": {
@@ -2497,7 +2186,7 @@
2497
2186
  },
2498
2187
  "hasDynamicHelp": false,
2499
2188
  "hiddenAliases": [],
2500
- "id": "asa:automations:get",
2189
+ "id": "asa:ads:get",
2501
2190
  "pluginAlias": "adapty",
2502
2191
  "pluginName": "adapty",
2503
2192
  "pluginType": "core",
@@ -2508,16 +2197,17 @@
2508
2197
  "dist",
2509
2198
  "commands",
2510
2199
  "asa",
2511
- "automations",
2200
+ "ads",
2512
2201
  "get.js"
2513
2202
  ]
2514
2203
  },
2515
- "asa:automations:list": {
2204
+ "asa:ads:list": {
2516
2205
  "aliases": [],
2517
2206
  "args": {},
2518
- "description": "List automation rules; status 1 is active, 0 is stopped",
2207
+ "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
2519
2208
  "examples": [
2520
- "<%= config.bin %> asa automations list"
2209
+ "<%= config.bin %> asa ads list",
2210
+ "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
2521
2211
  ],
2522
2212
  "flags": {
2523
2213
  "json": {
@@ -2535,10 +2225,575 @@
2535
2225
  "multiple": false,
2536
2226
  "type": "option"
2537
2227
  },
2538
- "page-size": {
2539
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2540
- "name": "page-size",
2541
- "default": 100,
2228
+ "page-size": {
2229
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2230
+ "name": "page-size",
2231
+ "default": 100,
2232
+ "hasDynamicHelp": false,
2233
+ "multiple": false,
2234
+ "type": "option"
2235
+ },
2236
+ "ad-group": {
2237
+ "description": "Keep only rows in this ad group; repeatable",
2238
+ "name": "ad-group",
2239
+ "hasDynamicHelp": false,
2240
+ "multiple": true,
2241
+ "type": "option"
2242
+ },
2243
+ "campaign": {
2244
+ "description": "Keep only rows in this campaign; repeatable",
2245
+ "name": "campaign",
2246
+ "hasDynamicHelp": false,
2247
+ "multiple": true,
2248
+ "type": "option"
2249
+ },
2250
+ "campaign-group": {
2251
+ "description": "Keep only rows in this campaign group; repeatable",
2252
+ "name": "campaign-group",
2253
+ "hasDynamicHelp": false,
2254
+ "multiple": true,
2255
+ "type": "option"
2256
+ },
2257
+ "search": {
2258
+ "description": "Case-insensitive substring match on the name",
2259
+ "name": "search",
2260
+ "hasDynamicHelp": false,
2261
+ "multiple": false,
2262
+ "type": "option"
2263
+ },
2264
+ "status": {
2265
+ "description": "Keep only rows in this state",
2266
+ "name": "status",
2267
+ "hasDynamicHelp": false,
2268
+ "multiple": false,
2269
+ "options": [
2270
+ "ENABLED",
2271
+ "PAUSED"
2272
+ ],
2273
+ "type": "option"
2274
+ }
2275
+ },
2276
+ "hasDynamicHelp": false,
2277
+ "hiddenAliases": [],
2278
+ "id": "asa:ads:list",
2279
+ "pluginAlias": "adapty",
2280
+ "pluginName": "adapty",
2281
+ "pluginType": "core",
2282
+ "strict": true,
2283
+ "enableJsonFlag": true,
2284
+ "isESM": true,
2285
+ "relativePath": [
2286
+ "dist",
2287
+ "commands",
2288
+ "asa",
2289
+ "ads",
2290
+ "list.js"
2291
+ ]
2292
+ },
2293
+ "asa:ads:update": {
2294
+ "aliases": [],
2295
+ "args": {
2296
+ "ad_id": {
2297
+ "description": "Ad ID (UUID)",
2298
+ "name": "ad_id",
2299
+ "required": true
2300
+ }
2301
+ },
2302
+ "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
2303
+ "examples": [
2304
+ "<%= config.bin %> asa ads update UUID --status PAUSED"
2305
+ ],
2306
+ "flags": {
2307
+ "json": {
2308
+ "description": "Format output as json.",
2309
+ "helpGroup": "GLOBAL",
2310
+ "name": "json",
2311
+ "allowNo": false,
2312
+ "type": "boolean"
2313
+ },
2314
+ "yes": {
2315
+ "char": "y",
2316
+ "description": "Apply without asking; required when the output is piped or --json is used",
2317
+ "name": "yes",
2318
+ "allowNo": false,
2319
+ "type": "boolean"
2320
+ },
2321
+ "idempotency-key": {
2322
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2323
+ "name": "idempotency-key",
2324
+ "hasDynamicHelp": false,
2325
+ "multiple": false,
2326
+ "type": "option"
2327
+ },
2328
+ "name": {
2329
+ "description": "Ad name",
2330
+ "name": "name",
2331
+ "hasDynamicHelp": false,
2332
+ "multiple": false,
2333
+ "type": "option"
2334
+ },
2335
+ "status": {
2336
+ "description": "Ad status",
2337
+ "name": "status",
2338
+ "hasDynamicHelp": false,
2339
+ "multiple": false,
2340
+ "options": [
2341
+ "ENABLED",
2342
+ "PAUSED"
2343
+ ],
2344
+ "type": "option"
2345
+ }
2346
+ },
2347
+ "hasDynamicHelp": false,
2348
+ "hiddenAliases": [],
2349
+ "id": "asa:ads:update",
2350
+ "pluginAlias": "adapty",
2351
+ "pluginName": "adapty",
2352
+ "pluginType": "core",
2353
+ "strict": true,
2354
+ "enableJsonFlag": true,
2355
+ "isESM": true,
2356
+ "relativePath": [
2357
+ "dist",
2358
+ "commands",
2359
+ "asa",
2360
+ "ads",
2361
+ "update.js"
2362
+ ]
2363
+ },
2364
+ "asa:apps:list": {
2365
+ "aliases": [],
2366
+ "args": {},
2367
+ "description": "List the apps promoted by this company in Apple Search Ads",
2368
+ "examples": [
2369
+ "<%= config.bin %> asa apps list",
2370
+ "<%= config.bin %> asa apps list --page 2 --page-size 50"
2371
+ ],
2372
+ "flags": {
2373
+ "json": {
2374
+ "description": "Format output as json.",
2375
+ "helpGroup": "GLOBAL",
2376
+ "name": "json",
2377
+ "allowNo": false,
2378
+ "type": "boolean"
2379
+ },
2380
+ "page": {
2381
+ "description": "Page number",
2382
+ "name": "page",
2383
+ "default": 1,
2384
+ "hasDynamicHelp": false,
2385
+ "multiple": false,
2386
+ "type": "option"
2387
+ },
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,
2392
+ "hasDynamicHelp": false,
2393
+ "multiple": false,
2394
+ "type": "option"
2395
+ }
2396
+ },
2397
+ "hasDynamicHelp": false,
2398
+ "hiddenAliases": [],
2399
+ "id": "asa:apps:list",
2400
+ "pluginAlias": "adapty",
2401
+ "pluginName": "adapty",
2402
+ "pluginType": "core",
2403
+ "strict": true,
2404
+ "enableJsonFlag": true,
2405
+ "isESM": true,
2406
+ "relativePath": [
2407
+ "dist",
2408
+ "commands",
2409
+ "asa",
2410
+ "apps",
2411
+ "list.js"
2412
+ ]
2413
+ },
2414
+ "asa:campaigns:bulk-create": {
2415
+ "aliases": [],
2416
+ "args": {},
2417
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2418
+ "examples": [
2419
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2420
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2421
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2422
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2423
+ ],
2424
+ "flags": {
2425
+ "json": {
2426
+ "description": "Format output as json.",
2427
+ "helpGroup": "GLOBAL",
2428
+ "name": "json",
2429
+ "allowNo": false,
2430
+ "type": "boolean"
2431
+ },
2432
+ "yes": {
2433
+ "char": "y",
2434
+ "description": "Apply without asking; required when the output is piped or --json is used",
2435
+ "name": "yes",
2436
+ "allowNo": false,
2437
+ "type": "boolean"
2438
+ },
2439
+ "idempotency-key": {
2440
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2441
+ "name": "idempotency-key",
2442
+ "hasDynamicHelp": false,
2443
+ "multiple": false,
2444
+ "type": "option"
2445
+ },
2446
+ "file": {
2447
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2448
+ "name": "file",
2449
+ "hasDynamicHelp": false,
2450
+ "multiple": false,
2451
+ "type": "option"
2452
+ },
2453
+ "from-file": {
2454
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2455
+ "name": "from-file",
2456
+ "hasDynamicHelp": false,
2457
+ "multiple": false,
2458
+ "type": "option"
2459
+ },
2460
+ "org-id": {
2461
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2462
+ "name": "org-id",
2463
+ "hasDynamicHelp": false,
2464
+ "multiple": false,
2465
+ "type": "option"
2466
+ },
2467
+ "poll-interval": {
2468
+ "description": "Seconds between progress polls",
2469
+ "name": "poll-interval",
2470
+ "default": 5,
2471
+ "hasDynamicHelp": false,
2472
+ "multiple": false,
2473
+ "type": "option"
2474
+ },
2475
+ "preview": {
2476
+ "description": "With --from-file: print the converted request and stop, nothing is created",
2477
+ "name": "preview",
2478
+ "allowNo": false,
2479
+ "type": "boolean"
2480
+ },
2481
+ "timeout": {
2482
+ "description": "Max seconds to wait for the operation to finish",
2483
+ "name": "timeout",
2484
+ "default": 900,
2485
+ "hasDynamicHelp": false,
2486
+ "multiple": false,
2487
+ "type": "option"
2488
+ },
2489
+ "wait": {
2490
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2491
+ "name": "wait",
2492
+ "allowNo": true,
2493
+ "type": "boolean"
2494
+ }
2495
+ },
2496
+ "hasDynamicHelp": false,
2497
+ "hiddenAliases": [],
2498
+ "id": "asa:campaigns:bulk-create",
2499
+ "pluginAlias": "adapty",
2500
+ "pluginName": "adapty",
2501
+ "pluginType": "core",
2502
+ "strict": true,
2503
+ "enableJsonFlag": true,
2504
+ "isESM": true,
2505
+ "relativePath": [
2506
+ "dist",
2507
+ "commands",
2508
+ "asa",
2509
+ "campaigns",
2510
+ "bulk-create.js"
2511
+ ]
2512
+ },
2513
+ "asa:campaigns:bulk-list": {
2514
+ "aliases": [],
2515
+ "args": {},
2516
+ "description": "This company's bulk operations, newest first; inspect one with bulk-status",
2517
+ "examples": [
2518
+ "<%= config.bin %> asa campaigns bulk-list",
2519
+ "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2520
+ "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
2521
+ ],
2522
+ "flags": {
2523
+ "json": {
2524
+ "description": "Format output as json.",
2525
+ "helpGroup": "GLOBAL",
2526
+ "name": "json",
2527
+ "allowNo": false,
2528
+ "type": "boolean"
2529
+ },
2530
+ "page": {
2531
+ "description": "Page number",
2532
+ "name": "page",
2533
+ "default": 1,
2534
+ "hasDynamicHelp": false,
2535
+ "multiple": false,
2536
+ "type": "option"
2537
+ },
2538
+ "page-size": {
2539
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2540
+ "name": "page-size",
2541
+ "default": 100,
2542
+ "hasDynamicHelp": false,
2543
+ "multiple": false,
2544
+ "type": "option"
2545
+ },
2546
+ "app": {
2547
+ "description": "Keep only operations of this app (UUID)",
2548
+ "name": "app",
2549
+ "hasDynamicHelp": false,
2550
+ "multiple": false,
2551
+ "type": "option"
2552
+ },
2553
+ "created-from": {
2554
+ "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
2555
+ "name": "created-from",
2556
+ "hasDynamicHelp": false,
2557
+ "multiple": false,
2558
+ "type": "option"
2559
+ },
2560
+ "created-to": {
2561
+ "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
2562
+ "name": "created-to",
2563
+ "hasDynamicHelp": false,
2564
+ "multiple": false,
2565
+ "type": "option"
2566
+ },
2567
+ "status": {
2568
+ "description": "Keep only operations in this state; repeatable",
2569
+ "name": "status",
2570
+ "hasDynamicHelp": false,
2571
+ "multiple": true,
2572
+ "options": [
2573
+ "failed",
2574
+ "partial",
2575
+ "pending",
2576
+ "running",
2577
+ "success"
2578
+ ],
2579
+ "type": "option"
2580
+ }
2581
+ },
2582
+ "hasDynamicHelp": false,
2583
+ "hiddenAliases": [],
2584
+ "id": "asa:campaigns:bulk-list",
2585
+ "pluginAlias": "adapty",
2586
+ "pluginName": "adapty",
2587
+ "pluginType": "core",
2588
+ "strict": true,
2589
+ "enableJsonFlag": true,
2590
+ "isESM": true,
2591
+ "relativePath": [
2592
+ "dist",
2593
+ "commands",
2594
+ "asa",
2595
+ "campaigns",
2596
+ "bulk-list.js"
2597
+ ]
2598
+ },
2599
+ "asa:campaigns:bulk-status": {
2600
+ "aliases": [],
2601
+ "args": {
2602
+ "operation-id": {
2603
+ "description": "Bulk operation ID returned by bulk-create",
2604
+ "name": "operation-id",
2605
+ "required": true
2606
+ }
2607
+ },
2608
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2609
+ "examples": [
2610
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2611
+ ],
2612
+ "flags": {
2613
+ "json": {
2614
+ "description": "Format output as json.",
2615
+ "helpGroup": "GLOBAL",
2616
+ "name": "json",
2617
+ "allowNo": false,
2618
+ "type": "boolean"
2619
+ },
2620
+ "page": {
2621
+ "description": "Page number",
2622
+ "name": "page",
2623
+ "default": 1,
2624
+ "hasDynamicHelp": false,
2625
+ "multiple": false,
2626
+ "type": "option"
2627
+ },
2628
+ "page-size": {
2629
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2630
+ "name": "page-size",
2631
+ "default": 100,
2632
+ "hasDynamicHelp": false,
2633
+ "multiple": false,
2634
+ "type": "option"
2635
+ }
2636
+ },
2637
+ "hasDynamicHelp": false,
2638
+ "hiddenAliases": [],
2639
+ "id": "asa:campaigns:bulk-status",
2640
+ "pluginAlias": "adapty",
2641
+ "pluginName": "adapty",
2642
+ "pluginType": "core",
2643
+ "strict": true,
2644
+ "enableJsonFlag": true,
2645
+ "isESM": true,
2646
+ "relativePath": [
2647
+ "dist",
2648
+ "commands",
2649
+ "asa",
2650
+ "campaigns",
2651
+ "bulk-status.js"
2652
+ ]
2653
+ },
2654
+ "asa:campaigns:create": {
2655
+ "aliases": [],
2656
+ "args": {},
2657
+ "description": "Create a campaign in Apple Search Ads",
2658
+ "examples": [
2659
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2660
+ ],
2661
+ "flags": {
2662
+ "json": {
2663
+ "description": "Format output as json.",
2664
+ "helpGroup": "GLOBAL",
2665
+ "name": "json",
2666
+ "allowNo": false,
2667
+ "type": "boolean"
2668
+ },
2669
+ "currency": {
2670
+ "description": "Currency code for the amounts in this call",
2671
+ "name": "currency",
2672
+ "default": "USD",
2673
+ "hasDynamicHelp": false,
2674
+ "multiple": false,
2675
+ "type": "option"
2676
+ },
2677
+ "yes": {
2678
+ "char": "y",
2679
+ "description": "Apply without asking; required when the output is piped or --json is used",
2680
+ "name": "yes",
2681
+ "allowNo": false,
2682
+ "type": "boolean"
2683
+ },
2684
+ "idempotency-key": {
2685
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2686
+ "name": "idempotency-key",
2687
+ "hasDynamicHelp": false,
2688
+ "multiple": false,
2689
+ "type": "option"
2690
+ },
2691
+ "ad-channel-type": {
2692
+ "description": "Ad channel type",
2693
+ "name": "ad-channel-type",
2694
+ "default": "SEARCH",
2695
+ "hasDynamicHelp": false,
2696
+ "multiple": false,
2697
+ "options": [
2698
+ "DISPLAY",
2699
+ "SEARCH"
2700
+ ],
2701
+ "type": "option"
2702
+ },
2703
+ "adam-id": {
2704
+ "description": "App Store app ID (adam_id)",
2705
+ "name": "adam-id",
2706
+ "required": true,
2707
+ "hasDynamicHelp": false,
2708
+ "multiple": false,
2709
+ "type": "option"
2710
+ },
2711
+ "bidding-strategy": {
2712
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2713
+ "name": "bidding-strategy",
2714
+ "hasDynamicHelp": false,
2715
+ "multiple": false,
2716
+ "options": [
2717
+ "MANUAL_CPT",
2718
+ "MAX_CONVERSIONS"
2719
+ ],
2720
+ "type": "option"
2721
+ },
2722
+ "billing-event": {
2723
+ "description": "Billing event",
2724
+ "name": "billing-event",
2725
+ "default": "TAPS",
2726
+ "hasDynamicHelp": false,
2727
+ "multiple": false,
2728
+ "options": [
2729
+ "IMPRESSIONS",
2730
+ "TAPS"
2731
+ ],
2732
+ "type": "option"
2733
+ },
2734
+ "budget": {
2735
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2736
+ "name": "budget",
2737
+ "hasDynamicHelp": false,
2738
+ "multiple": false,
2739
+ "type": "option"
2740
+ },
2741
+ "country": {
2742
+ "description": "Country or region code, repeatable",
2743
+ "name": "country",
2744
+ "required": true,
2745
+ "hasDynamicHelp": false,
2746
+ "multiple": true,
2747
+ "type": "option"
2748
+ },
2749
+ "daily-budget": {
2750
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
2751
+ "name": "daily-budget",
2752
+ "required": true,
2753
+ "hasDynamicHelp": false,
2754
+ "multiple": false,
2755
+ "type": "option"
2756
+ },
2757
+ "name": {
2758
+ "description": "Campaign name",
2759
+ "name": "name",
2760
+ "required": true,
2761
+ "hasDynamicHelp": false,
2762
+ "multiple": false,
2763
+ "type": "option"
2764
+ },
2765
+ "org": {
2766
+ "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2767
+ "name": "org",
2768
+ "required": true,
2769
+ "hasDynamicHelp": false,
2770
+ "multiple": false,
2771
+ "type": "option"
2772
+ },
2773
+ "status": {
2774
+ "description": "Initial status",
2775
+ "name": "status",
2776
+ "hasDynamicHelp": false,
2777
+ "multiple": false,
2778
+ "options": [
2779
+ "ENABLED",
2780
+ "PAUSED"
2781
+ ],
2782
+ "type": "option"
2783
+ },
2784
+ "supply-source": {
2785
+ "description": "Supply source, repeatable",
2786
+ "name": "supply-source",
2787
+ "default": [
2788
+ "APPSTORE_SEARCH_RESULTS"
2789
+ ],
2790
+ "hasDynamicHelp": false,
2791
+ "multiple": true,
2792
+ "type": "option"
2793
+ },
2794
+ "target-cpa": {
2795
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
2796
+ "name": "target-cpa",
2542
2797
  "hasDynamicHelp": false,
2543
2798
  "multiple": false,
2544
2799
  "type": "option"
@@ -2546,7 +2801,7 @@
2546
2801
  },
2547
2802
  "hasDynamicHelp": false,
2548
2803
  "hiddenAliases": [],
2549
- "id": "asa:automations:list",
2804
+ "id": "asa:campaigns:create",
2550
2805
  "pluginAlias": "adapty",
2551
2806
  "pluginName": "adapty",
2552
2807
  "pluginType": "core",
@@ -2557,23 +2812,22 @@
2557
2812
  "dist",
2558
2813
  "commands",
2559
2814
  "asa",
2560
- "automations",
2561
- "list.js"
2815
+ "campaigns",
2816
+ "create.js"
2562
2817
  ]
2563
2818
  },
2564
- "asa:automations:run": {
2819
+ "asa:campaigns:get": {
2565
2820
  "aliases": [],
2566
2821
  "args": {
2567
- "automation_id": {
2568
- "description": "Automation rule ID (UUID)",
2569
- "name": "automation_id",
2822
+ "campaign_id": {
2823
+ "description": "Campaign ID (UUID)",
2824
+ "name": "campaign_id",
2570
2825
  "required": true
2571
2826
  }
2572
2827
  },
2573
- "description": "Run an automation rule now; the run is queued, not awaited",
2828
+ "description": "Show one campaign; read numbers with asa metrics",
2574
2829
  "examples": [
2575
- "<%= config.bin %> asa automations run UUID",
2576
- "<%= config.bin %> asa automations run UUID --dry-run"
2830
+ "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
2577
2831
  ],
2578
2832
  "flags": {
2579
2833
  "json": {
@@ -2582,31 +2836,11 @@
2582
2836
  "name": "json",
2583
2837
  "allowNo": false,
2584
2838
  "type": "boolean"
2585
- },
2586
- "yes": {
2587
- "char": "y",
2588
- "description": "Apply without asking; required when the output is piped or --json is used",
2589
- "name": "yes",
2590
- "allowNo": false,
2591
- "type": "boolean"
2592
- },
2593
- "idempotency-key": {
2594
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2595
- "name": "idempotency-key",
2596
- "hasDynamicHelp": false,
2597
- "multiple": false,
2598
- "type": "option"
2599
- },
2600
- "dry-run": {
2601
- "description": "Evaluate and log the rule without touching Apple",
2602
- "name": "dry-run",
2603
- "allowNo": false,
2604
- "type": "boolean"
2605
2839
  }
2606
2840
  },
2607
2841
  "hasDynamicHelp": false,
2608
2842
  "hiddenAliases": [],
2609
- "id": "asa:automations:run",
2843
+ "id": "asa:campaigns:get",
2610
2844
  "pluginAlias": "adapty",
2611
2845
  "pluginName": "adapty",
2612
2846
  "pluginType": "core",
@@ -2617,22 +2851,17 @@
2617
2851
  "dist",
2618
2852
  "commands",
2619
2853
  "asa",
2620
- "automations",
2621
- "run.js"
2854
+ "campaigns",
2855
+ "get.js"
2622
2856
  ]
2623
2857
  },
2624
- "asa:automations:runs": {
2858
+ "asa:campaigns:list": {
2625
2859
  "aliases": [],
2626
- "args": {
2627
- "automation_id": {
2628
- "description": "Automation rule ID (UUID)",
2629
- "name": "automation_id",
2630
- "required": true
2631
- }
2632
- },
2633
- "description": "List past runs of an automation rule, including dry runs",
2860
+ "args": {},
2861
+ "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
2634
2862
  "examples": [
2635
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2863
+ "<%= config.bin %> asa campaigns list",
2864
+ "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
2636
2865
  ],
2637
2866
  "flags": {
2638
2867
  "json": {
@@ -2657,97 +2886,43 @@
2657
2886
  "hasDynamicHelp": false,
2658
2887
  "multiple": false,
2659
2888
  "type": "option"
2660
- }
2661
- },
2662
- "hasDynamicHelp": false,
2663
- "hiddenAliases": [],
2664
- "id": "asa:automations:runs",
2665
- "pluginAlias": "adapty",
2666
- "pluginName": "adapty",
2667
- "pluginType": "core",
2668
- "strict": true,
2669
- "enableJsonFlag": true,
2670
- "isESM": true,
2671
- "relativePath": [
2672
- "dist",
2673
- "commands",
2674
- "asa",
2675
- "automations",
2676
- "runs.js"
2677
- ]
2678
- },
2679
- "asa:automations:update": {
2680
- "aliases": [],
2681
- "args": {
2682
- "automation_id": {
2683
- "description": "Automation rule ID (UUID)",
2684
- "name": "automation_id",
2685
- "required": true
2686
- }
2687
- },
2688
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2689
- "examples": [
2690
- "<%= config.bin %> asa automations update UUID --stop",
2691
- "<%= config.bin %> asa automations update UUID --file rule.json"
2692
- ],
2693
- "flags": {
2694
- "json": {
2695
- "description": "Format output as json.",
2696
- "helpGroup": "GLOBAL",
2697
- "name": "json",
2698
- "allowNo": false,
2699
- "type": "boolean"
2700
- },
2701
- "yes": {
2702
- "char": "y",
2703
- "description": "Apply without asking; required when the output is piped or --json is used",
2704
- "name": "yes",
2705
- "allowNo": false,
2706
- "type": "boolean"
2707
2889
  },
2708
- "idempotency-key": {
2709
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2710
- "name": "idempotency-key",
2890
+ "app": {
2891
+ "description": "Keep only rows in this app; repeatable",
2892
+ "name": "app",
2711
2893
  "hasDynamicHelp": false,
2712
- "multiple": false,
2894
+ "multiple": true,
2713
2895
  "type": "option"
2714
2896
  },
2715
- "file": {
2716
- "description": "JSON file with the parts to change, or - to read stdin",
2717
- "name": "file",
2897
+ "campaign-group": {
2898
+ "description": "Keep only rows in this campaign group; repeatable",
2899
+ "name": "campaign-group",
2718
2900
  "hasDynamicHelp": false,
2719
- "multiple": false,
2901
+ "multiple": true,
2720
2902
  "type": "option"
2721
2903
  },
2722
- "name": {
2723
- "description": "Rule name",
2724
- "name": "name",
2904
+ "search": {
2905
+ "description": "Case-insensitive substring match on the name",
2906
+ "name": "search",
2725
2907
  "hasDynamicHelp": false,
2726
2908
  "multiple": false,
2727
2909
  "type": "option"
2728
2910
  },
2729
- "start": {
2730
- "description": "Activate the rule",
2731
- "exclusive": [
2732
- "stop"
2733
- ],
2734
- "name": "start",
2735
- "allowNo": false,
2736
- "type": "boolean"
2737
- },
2738
- "stop": {
2739
- "description": "Stop the rule and clear its next run",
2740
- "exclusive": [
2741
- "start"
2911
+ "status": {
2912
+ "description": "Keep only rows in this state",
2913
+ "name": "status",
2914
+ "hasDynamicHelp": false,
2915
+ "multiple": false,
2916
+ "options": [
2917
+ "ENABLED",
2918
+ "PAUSED"
2742
2919
  ],
2743
- "name": "stop",
2744
- "allowNo": false,
2745
- "type": "boolean"
2920
+ "type": "option"
2746
2921
  }
2747
2922
  },
2748
2923
  "hasDynamicHelp": false,
2749
2924
  "hiddenAliases": [],
2750
- "id": "asa:automations:update",
2925
+ "id": "asa:campaigns:list",
2751
2926
  "pluginAlias": "adapty",
2752
2927
  "pluginName": "adapty",
2753
2928
  "pluginType": "core",
@@ -2758,19 +2933,23 @@
2758
2933
  "dist",
2759
2934
  "commands",
2760
2935
  "asa",
2761
- "automations",
2762
- "update.js"
2936
+ "campaigns",
2937
+ "list.js"
2763
2938
  ]
2764
2939
  },
2765
- "asa:campaigns:bulk-create": {
2940
+ "asa:campaigns:update": {
2766
2941
  "aliases": [],
2767
- "args": {},
2768
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2942
+ "args": {
2943
+ "campaign_id": {
2944
+ "description": "Campaign ID (UUID)",
2945
+ "name": "campaign_id",
2946
+ "required": true
2947
+ }
2948
+ },
2949
+ "description": "Change a campaign: budgets, countries, status or schedule",
2769
2950
  "examples": [
2770
- "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2771
- "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2772
- "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2773
- "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2951
+ "<%= config.bin %> asa campaigns update UUID --status PAUSED",
2952
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
2774
2953
  ],
2775
2954
  "flags": {
2776
2955
  "json": {
@@ -2780,6 +2959,14 @@
2780
2959
  "allowNo": false,
2781
2960
  "type": "boolean"
2782
2961
  },
2962
+ "currency": {
2963
+ "description": "Currency code for the amounts in this call",
2964
+ "name": "currency",
2965
+ "default": "USD",
2966
+ "hasDynamicHelp": false,
2967
+ "multiple": false,
2968
+ "type": "option"
2969
+ },
2783
2970
  "yes": {
2784
2971
  "char": "y",
2785
2972
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2794,59 +2981,67 @@
2794
2981
  "multiple": false,
2795
2982
  "type": "option"
2796
2983
  },
2797
- "file": {
2798
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2799
- "name": "file",
2984
+ "bidding-strategy": {
2985
+ "description": "Bidding strategy",
2986
+ "name": "bidding-strategy",
2800
2987
  "hasDynamicHelp": false,
2801
2988
  "multiple": false,
2989
+ "options": [
2990
+ "MANUAL_CPT",
2991
+ "MAX_CONVERSIONS"
2992
+ ],
2802
2993
  "type": "option"
2803
2994
  },
2804
- "from-file": {
2805
- "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2806
- "name": "from-file",
2995
+ "budget": {
2996
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2997
+ "name": "budget",
2807
2998
  "hasDynamicHelp": false,
2808
2999
  "multiple": false,
2809
3000
  "type": "option"
2810
3001
  },
2811
- "org-id": {
2812
- "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2813
- "name": "org-id",
3002
+ "country": {
3003
+ "description": "Replace the country list, repeatable",
3004
+ "name": "country",
3005
+ "hasDynamicHelp": false,
3006
+ "multiple": true,
3007
+ "type": "option"
3008
+ },
3009
+ "daily-budget": {
3010
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
3011
+ "name": "daily-budget",
2814
3012
  "hasDynamicHelp": false,
2815
3013
  "multiple": false,
2816
3014
  "type": "option"
2817
3015
  },
2818
- "poll-interval": {
2819
- "description": "Seconds between progress polls",
2820
- "name": "poll-interval",
2821
- "default": 5,
3016
+ "name": {
3017
+ "description": "Campaign name",
3018
+ "name": "name",
3019
+ "hasDynamicHelp": false,
3020
+ "multiple": false,
3021
+ "type": "option"
3022
+ },
3023
+ "status": {
3024
+ "description": "Campaign status",
3025
+ "name": "status",
2822
3026
  "hasDynamicHelp": false,
2823
3027
  "multiple": false,
3028
+ "options": [
3029
+ "ENABLED",
3030
+ "PAUSED"
3031
+ ],
2824
3032
  "type": "option"
2825
3033
  },
2826
- "preview": {
2827
- "description": "With --from-file: print the converted request and stop, nothing is created",
2828
- "name": "preview",
2829
- "allowNo": false,
2830
- "type": "boolean"
2831
- },
2832
- "timeout": {
2833
- "description": "Max seconds to wait for the operation to finish",
2834
- "name": "timeout",
2835
- "default": 900,
3034
+ "target-cpa": {
3035
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
3036
+ "name": "target-cpa",
2836
3037
  "hasDynamicHelp": false,
2837
3038
  "multiple": false,
2838
3039
  "type": "option"
2839
- },
2840
- "wait": {
2841
- "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2842
- "name": "wait",
2843
- "allowNo": true,
2844
- "type": "boolean"
2845
3040
  }
2846
3041
  },
2847
3042
  "hasDynamicHelp": false,
2848
3043
  "hiddenAliases": [],
2849
- "id": "asa:campaigns:bulk-create",
3044
+ "id": "asa:campaigns:update",
2850
3045
  "pluginAlias": "adapty",
2851
3046
  "pluginName": "adapty",
2852
3047
  "pluginType": "core",
@@ -2858,17 +3053,16 @@
2858
3053
  "commands",
2859
3054
  "asa",
2860
3055
  "campaigns",
2861
- "bulk-create.js"
3056
+ "update.js"
2862
3057
  ]
2863
3058
  },
2864
- "asa:campaigns:bulk-list": {
3059
+ "asa:creatives:list": {
2865
3060
  "aliases": [],
2866
3061
  "args": {},
2867
- "description": "This company's bulk operations, newest first; inspect one with bulk-status",
3062
+ "description": "List creatives; creative_id is what `asa ads create` needs",
2868
3063
  "examples": [
2869
- "<%= config.bin %> asa campaigns bulk-list",
2870
- "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2871
- "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
3064
+ "<%= config.bin %> asa creatives list",
3065
+ "<%= config.bin %> asa creatives list --app APP_UUID"
2872
3066
  ],
2873
3067
  "flags": {
2874
3068
  "json": {
@@ -2895,44 +3089,23 @@
2895
3089
  "type": "option"
2896
3090
  },
2897
3091
  "app": {
2898
- "description": "Keep only operations of this app (UUID)",
3092
+ "description": "Keep only rows in this app; repeatable",
2899
3093
  "name": "app",
2900
3094
  "hasDynamicHelp": false,
2901
- "multiple": false,
2902
- "type": "option"
2903
- },
2904
- "created-from": {
2905
- "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
2906
- "name": "created-from",
2907
- "hasDynamicHelp": false,
2908
- "multiple": false,
2909
- "type": "option"
2910
- },
2911
- "created-to": {
2912
- "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
2913
- "name": "created-to",
2914
- "hasDynamicHelp": false,
2915
- "multiple": false,
3095
+ "multiple": true,
2916
3096
  "type": "option"
2917
3097
  },
2918
- "status": {
2919
- "description": "Keep only operations in this state; repeatable",
2920
- "name": "status",
3098
+ "campaign-group": {
3099
+ "description": "Keep only rows in this campaign group; repeatable",
3100
+ "name": "campaign-group",
2921
3101
  "hasDynamicHelp": false,
2922
3102
  "multiple": true,
2923
- "options": [
2924
- "failed",
2925
- "partial",
2926
- "pending",
2927
- "running",
2928
- "success"
2929
- ],
2930
3103
  "type": "option"
2931
3104
  }
2932
3105
  },
2933
3106
  "hasDynamicHelp": false,
2934
3107
  "hiddenAliases": [],
2935
- "id": "asa:campaigns:bulk-list",
3108
+ "id": "asa:creatives:list",
2936
3109
  "pluginAlias": "adapty",
2937
3110
  "pluginName": "adapty",
2938
3111
  "pluginType": "core",
@@ -2943,22 +3116,16 @@
2943
3116
  "dist",
2944
3117
  "commands",
2945
3118
  "asa",
2946
- "campaigns",
2947
- "bulk-list.js"
3119
+ "creatives",
3120
+ "list.js"
2948
3121
  ]
2949
3122
  },
2950
- "asa:campaigns:bulk-status": {
3123
+ "asa:competitors:summary": {
2951
3124
  "aliases": [],
2952
- "args": {
2953
- "operation-id": {
2954
- "description": "Bulk operation ID returned by bulk-create",
2955
- "name": "operation-id",
2956
- "required": true
2957
- }
2958
- },
2959
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
3125
+ "args": {},
3126
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2960
3127
  "examples": [
2961
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
3128
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2962
3129
  ],
2963
3130
  "flags": {
2964
3131
  "json": {
@@ -2968,18 +3135,10 @@
2968
3135
  "allowNo": false,
2969
3136
  "type": "boolean"
2970
3137
  },
2971
- "page": {
2972
- "description": "Page number",
2973
- "name": "page",
2974
- "default": 1,
2975
- "hasDynamicHelp": false,
2976
- "multiple": false,
2977
- "type": "option"
2978
- },
2979
- "page-size": {
2980
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2981
- "name": "page-size",
2982
- "default": 100,
3138
+ "app-ids": {
3139
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3140
+ "name": "app-ids",
3141
+ "required": true,
2983
3142
  "hasDynamicHelp": false,
2984
3143
  "multiple": false,
2985
3144
  "type": "option"
@@ -2987,7 +3146,7 @@
2987
3146
  },
2988
3147
  "hasDynamicHelp": false,
2989
3148
  "hiddenAliases": [],
2990
- "id": "asa:campaigns:bulk-status",
3149
+ "id": "asa:competitors:summary",
2991
3150
  "pluginAlias": "adapty",
2992
3151
  "pluginName": "adapty",
2993
3152
  "pluginType": "core",
@@ -2998,16 +3157,17 @@
2998
3157
  "dist",
2999
3158
  "commands",
3000
3159
  "asa",
3001
- "campaigns",
3002
- "bulk-status.js"
3160
+ "competitors",
3161
+ "summary.js"
3003
3162
  ]
3004
3163
  },
3005
- "asa:campaigns:create": {
3164
+ "asa:keywords:add": {
3006
3165
  "aliases": [],
3007
3166
  "args": {},
3008
- "description": "Create a campaign in Apple Search Ads",
3167
+ "description": "Add targeting keywords to an ad group",
3009
3168
  "examples": [
3010
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
3169
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3170
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3011
3171
  ],
3012
3172
  "flags": {
3013
3173
  "json": {
@@ -3039,159 +3199,63 @@
3039
3199
  "multiple": false,
3040
3200
  "type": "option"
3041
3201
  },
3042
- "ad-channel-type": {
3043
- "description": "Ad channel type",
3044
- "name": "ad-channel-type",
3045
- "default": "SEARCH",
3202
+ "ad-group": {
3203
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3204
+ "name": "ad-group",
3205
+ "required": true,
3046
3206
  "hasDynamicHelp": false,
3047
3207
  "multiple": false,
3048
- "options": [
3049
- "DISPLAY",
3050
- "SEARCH"
3051
- ],
3052
3208
  "type": "option"
3053
3209
  },
3054
- "adam-id": {
3055
- "description": "App Store app ID (adam_id)",
3056
- "name": "adam-id",
3057
- "required": true,
3210
+ "bid": {
3211
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3212
+ "name": "bid",
3058
3213
  "hasDynamicHelp": false,
3059
3214
  "multiple": false,
3060
3215
  "type": "option"
3061
3216
  },
3062
- "bidding-strategy": {
3063
- "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
3064
- "name": "bidding-strategy",
3217
+ "from-file": {
3218
+ "description": "File with one keyword per line, combined with any --text values",
3219
+ "name": "from-file",
3065
3220
  "hasDynamicHelp": false,
3066
3221
  "multiple": false,
3067
- "options": [
3068
- "MANUAL_CPT",
3069
- "MAX_CONVERSIONS"
3070
- ],
3071
3222
  "type": "option"
3072
3223
  },
3073
- "billing-event": {
3074
- "description": "Billing event",
3075
- "name": "billing-event",
3076
- "default": "TAPS",
3224
+ "match-type": {
3225
+ "description": "Match type",
3226
+ "name": "match-type",
3227
+ "default": "BROAD",
3077
3228
  "hasDynamicHelp": false,
3078
3229
  "multiple": false,
3079
3230
  "options": [
3080
- "IMPRESSIONS",
3081
- "TAPS"
3231
+ "BROAD",
3232
+ "EXACT"
3082
3233
  ],
3083
3234
  "type": "option"
3084
3235
  },
3085
- "budget": {
3086
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3087
- "name": "budget",
3088
- "hasDynamicHelp": false,
3089
- "multiple": false,
3090
- "type": "option"
3091
- },
3092
- "country": {
3093
- "description": "Country or region code, repeatable",
3094
- "name": "country",
3095
- "required": true,
3096
- "hasDynamicHelp": false,
3097
- "multiple": true,
3098
- "type": "option"
3099
- },
3100
- "daily-budget": {
3101
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3102
- "name": "daily-budget",
3103
- "required": true,
3104
- "hasDynamicHelp": false,
3105
- "multiple": false,
3106
- "type": "option"
3107
- },
3108
- "name": {
3109
- "description": "Campaign name",
3110
- "name": "name",
3111
- "required": true,
3112
- "hasDynamicHelp": false,
3113
- "multiple": false,
3114
- "type": "option"
3115
- },
3116
- "org": {
3117
- "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
3118
- "name": "org",
3119
- "required": true,
3120
- "hasDynamicHelp": false,
3121
- "multiple": false,
3122
- "type": "option"
3123
- },
3124
3236
  "status": {
3125
- "description": "Initial status",
3237
+ "description": "Keyword status",
3126
3238
  "name": "status",
3239
+ "default": "ACTIVE",
3127
3240
  "hasDynamicHelp": false,
3128
3241
  "multiple": false,
3129
3242
  "options": [
3130
- "ENABLED",
3243
+ "ACTIVE",
3131
3244
  "PAUSED"
3132
3245
  ],
3133
- "type": "option"
3134
- },
3135
- "supply-source": {
3136
- "description": "Supply source, repeatable",
3137
- "name": "supply-source",
3138
- "default": [
3139
- "APPSTORE_SEARCH_RESULTS"
3140
- ],
3141
- "hasDynamicHelp": false,
3142
- "multiple": true,
3143
- "type": "option"
3144
- },
3145
- "target-cpa": {
3146
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3147
- "name": "target-cpa",
3148
- "hasDynamicHelp": false,
3149
- "multiple": false,
3150
- "type": "option"
3151
- }
3152
- },
3153
- "hasDynamicHelp": false,
3154
- "hiddenAliases": [],
3155
- "id": "asa:campaigns:create",
3156
- "pluginAlias": "adapty",
3157
- "pluginName": "adapty",
3158
- "pluginType": "core",
3159
- "strict": true,
3160
- "enableJsonFlag": true,
3161
- "isESM": true,
3162
- "relativePath": [
3163
- "dist",
3164
- "commands",
3165
- "asa",
3166
- "campaigns",
3167
- "create.js"
3168
- ]
3169
- },
3170
- "asa:campaigns:get": {
3171
- "aliases": [],
3172
- "args": {
3173
- "campaign_id": {
3174
- "description": "Campaign ID (UUID)",
3175
- "name": "campaign_id",
3176
- "required": true
3177
- }
3178
- },
3179
- "description": "Show one campaign; read numbers with asa metrics",
3180
- "examples": [
3181
- "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
3182
- ],
3183
- "flags": {
3184
- "json": {
3185
- "description": "Format output as json.",
3186
- "helpGroup": "GLOBAL",
3187
- "name": "json",
3188
- "allowNo": false,
3189
- "type": "boolean"
3246
+ "type": "option"
3247
+ },
3248
+ "text": {
3249
+ "description": "Keyword text, repeatable",
3250
+ "name": "text",
3251
+ "hasDynamicHelp": false,
3252
+ "multiple": true,
3253
+ "type": "option"
3190
3254
  }
3191
3255
  },
3192
3256
  "hasDynamicHelp": false,
3193
3257
  "hiddenAliases": [],
3194
- "id": "asa:campaigns:get",
3258
+ "id": "asa:keywords:add",
3195
3259
  "pluginAlias": "adapty",
3196
3260
  "pluginName": "adapty",
3197
3261
  "pluginType": "core",
@@ -3202,17 +3266,17 @@
3202
3266
  "dist",
3203
3267
  "commands",
3204
3268
  "asa",
3205
- "campaigns",
3206
- "get.js"
3269
+ "keywords",
3270
+ "add.js"
3207
3271
  ]
3208
3272
  },
3209
- "asa:campaigns:list": {
3273
+ "asa:keywords:list": {
3210
3274
  "aliases": [],
3211
3275
  "args": {},
3212
- "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
3276
+ "description": "List targeting keywords; read numbers with asa metrics",
3213
3277
  "examples": [
3214
- "<%= config.bin %> asa campaigns list",
3215
- "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
3278
+ "<%= config.bin %> asa keywords list",
3279
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3216
3280
  ],
3217
3281
  "flags": {
3218
3282
  "json": {
@@ -3259,13 +3323,27 @@
3259
3323
  "multiple": false,
3260
3324
  "type": "option"
3261
3325
  },
3326
+ "campaign": {
3327
+ "description": "Keep only rows in this campaign; repeatable",
3328
+ "name": "campaign",
3329
+ "hasDynamicHelp": false,
3330
+ "multiple": true,
3331
+ "type": "option"
3332
+ },
3333
+ "ad-group": {
3334
+ "description": "Keep only rows in this ad group; repeatable",
3335
+ "name": "ad-group",
3336
+ "hasDynamicHelp": false,
3337
+ "multiple": true,
3338
+ "type": "option"
3339
+ },
3262
3340
  "status": {
3263
3341
  "description": "Keep only rows in this state",
3264
3342
  "name": "status",
3265
3343
  "hasDynamicHelp": false,
3266
3344
  "multiple": false,
3267
3345
  "options": [
3268
- "ENABLED",
3346
+ "ACTIVE",
3269
3347
  "PAUSED"
3270
3348
  ],
3271
3349
  "type": "option"
@@ -3273,7 +3351,7 @@
3273
3351
  },
3274
3352
  "hasDynamicHelp": false,
3275
3353
  "hiddenAliases": [],
3276
- "id": "asa:campaigns:list",
3354
+ "id": "asa:keywords:list",
3277
3355
  "pluginAlias": "adapty",
3278
3356
  "pluginName": "adapty",
3279
3357
  "pluginType": "core",
@@ -3284,23 +3362,23 @@
3284
3362
  "dist",
3285
3363
  "commands",
3286
3364
  "asa",
3287
- "campaigns",
3365
+ "keywords",
3288
3366
  "list.js"
3289
3367
  ]
3290
3368
  },
3291
- "asa:campaigns:update": {
3369
+ "asa:keywords:update": {
3292
3370
  "aliases": [],
3293
3371
  "args": {
3294
- "campaign_id": {
3295
- "description": "Campaign ID (UUID)",
3296
- "name": "campaign_id",
3372
+ "keyword_id": {
3373
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3374
+ "name": "keyword_id",
3297
3375
  "required": true
3298
3376
  }
3299
3377
  },
3300
- "description": "Change a campaign: budgets, countries, status or schedule",
3378
+ "description": "Change bid, status, text or match type of keywords",
3301
3379
  "examples": [
3302
- "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3303
- "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
3380
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3381
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3304
3382
  ],
3305
3383
  "flags": {
3306
3384
  "json": {
@@ -3332,59 +3410,38 @@
3332
3410
  "multiple": false,
3333
3411
  "type": "option"
3334
3412
  },
3335
- "bidding-strategy": {
3336
- "description": "Bidding strategy",
3337
- "name": "bidding-strategy",
3338
- "hasDynamicHelp": false,
3339
- "multiple": false,
3340
- "options": [
3341
- "MANUAL_CPT",
3342
- "MAX_CONVERSIONS"
3343
- ],
3344
- "type": "option"
3345
- },
3346
- "budget": {
3347
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3348
- "name": "budget",
3349
- "hasDynamicHelp": false,
3350
- "multiple": false,
3351
- "type": "option"
3352
- },
3353
- "country": {
3354
- "description": "Replace the country list, repeatable",
3355
- "name": "country",
3356
- "hasDynamicHelp": false,
3357
- "multiple": true,
3358
- "type": "option"
3359
- },
3360
- "daily-budget": {
3361
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3362
- "name": "daily-budget",
3413
+ "bid": {
3414
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3415
+ "name": "bid",
3363
3416
  "hasDynamicHelp": false,
3364
3417
  "multiple": false,
3365
3418
  "type": "option"
3366
3419
  },
3367
- "name": {
3368
- "description": "Campaign name",
3369
- "name": "name",
3420
+ "match-type": {
3421
+ "description": "Match type",
3422
+ "name": "match-type",
3370
3423
  "hasDynamicHelp": false,
3371
3424
  "multiple": false,
3425
+ "options": [
3426
+ "BROAD",
3427
+ "EXACT"
3428
+ ],
3372
3429
  "type": "option"
3373
3430
  },
3374
3431
  "status": {
3375
- "description": "Campaign status",
3432
+ "description": "Keyword status",
3376
3433
  "name": "status",
3377
3434
  "hasDynamicHelp": false,
3378
3435
  "multiple": false,
3379
3436
  "options": [
3380
- "ENABLED",
3437
+ "ACTIVE",
3381
3438
  "PAUSED"
3382
3439
  ],
3383
3440
  "type": "option"
3384
3441
  },
3385
- "target-cpa": {
3386
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3387
- "name": "target-cpa",
3442
+ "text": {
3443
+ "description": "Keyword text (only meaningful for a single keyword)",
3444
+ "name": "text",
3388
3445
  "hasDynamicHelp": false,
3389
3446
  "multiple": false,
3390
3447
  "type": "option"
@@ -3392,27 +3449,31 @@
3392
3449
  },
3393
3450
  "hasDynamicHelp": false,
3394
3451
  "hiddenAliases": [],
3395
- "id": "asa:campaigns:update",
3452
+ "id": "asa:keywords:update",
3396
3453
  "pluginAlias": "adapty",
3397
3454
  "pluginName": "adapty",
3398
3455
  "pluginType": "core",
3399
- "strict": true,
3456
+ "strict": false,
3400
3457
  "enableJsonFlag": true,
3401
3458
  "isESM": true,
3402
3459
  "relativePath": [
3403
3460
  "dist",
3404
3461
  "commands",
3405
3462
  "asa",
3406
- "campaigns",
3463
+ "keywords",
3407
3464
  "update.js"
3408
3465
  ]
3409
3466
  },
3410
- "asa:competitors:summary": {
3467
+ "asa:metrics": {
3411
3468
  "aliases": [],
3412
3469
  "args": {},
3413
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3470
+ "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.",
3414
3471
  "examples": [
3415
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3472
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3473
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3474
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3475
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3476
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3416
3477
  ],
3417
3478
  "flags": {
3418
3479
  "json": {
@@ -3422,18 +3483,111 @@
3422
3483
  "allowNo": false,
3423
3484
  "type": "boolean"
3424
3485
  },
3425
- "app-ids": {
3426
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3427
- "name": "app-ids",
3486
+ "page": {
3487
+ "description": "Page number",
3488
+ "name": "page",
3489
+ "default": 1,
3490
+ "hasDynamicHelp": false,
3491
+ "multiple": false,
3492
+ "type": "option"
3493
+ },
3494
+ "page-size": {
3495
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3496
+ "name": "page-size",
3497
+ "default": 100,
3498
+ "hasDynamicHelp": false,
3499
+ "multiple": false,
3500
+ "type": "option"
3501
+ },
3502
+ "by-days": {
3503
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3504
+ "name": "by-days",
3505
+ "hasDynamicHelp": false,
3506
+ "multiple": true,
3507
+ "type": "option"
3508
+ },
3509
+ "date-from": {
3510
+ "description": "Start of the period (YYYY-MM-DD)",
3511
+ "name": "date-from",
3512
+ "required": true,
3513
+ "hasDynamicHelp": false,
3514
+ "multiple": false,
3515
+ "type": "option"
3516
+ },
3517
+ "date-to": {
3518
+ "description": "End of the period (YYYY-MM-DD)",
3519
+ "name": "date-to",
3428
3520
  "required": true,
3429
3521
  "hasDynamicHelp": false,
3430
3522
  "multiple": false,
3431
3523
  "type": "option"
3524
+ },
3525
+ "entity": {
3526
+ "description": "What to report on",
3527
+ "name": "entity",
3528
+ "required": true,
3529
+ "hasDynamicHelp": false,
3530
+ "multiple": false,
3531
+ "options": [
3532
+ "ad",
3533
+ "ad-group",
3534
+ "campaign",
3535
+ "keyword"
3536
+ ],
3537
+ "type": "option"
3538
+ },
3539
+ "group-by": {
3540
+ "description": "Break the rows down by a dimension, repeatable",
3541
+ "name": "group-by",
3542
+ "hasDynamicHelp": false,
3543
+ "multiple": true,
3544
+ "options": [
3545
+ "country",
3546
+ "day",
3547
+ "month",
3548
+ "quarter",
3549
+ "week",
3550
+ "year"
3551
+ ],
3552
+ "type": "option"
3553
+ },
3554
+ "metric": {
3555
+ "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3556
+ "name": "metric",
3557
+ "hasDynamicHelp": false,
3558
+ "multiple": true,
3559
+ "type": "option"
3560
+ },
3561
+ "order": {
3562
+ "description": "Sort direction",
3563
+ "name": "order",
3564
+ "default": "desc",
3565
+ "hasDynamicHelp": false,
3566
+ "multiple": false,
3567
+ "options": [
3568
+ "asc",
3569
+ "desc"
3570
+ ],
3571
+ "type": "option"
3572
+ },
3573
+ "order-by": {
3574
+ "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3575
+ "name": "order-by",
3576
+ "hasDynamicHelp": false,
3577
+ "multiple": false,
3578
+ "type": "option"
3579
+ },
3580
+ "order-by-day": {
3581
+ "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3582
+ "name": "order-by-day",
3583
+ "hasDynamicHelp": false,
3584
+ "multiple": false,
3585
+ "type": "option"
3432
3586
  }
3433
3587
  },
3434
3588
  "hasDynamicHelp": false,
3435
3589
  "hiddenAliases": [],
3436
- "id": "asa:competitors:summary",
3590
+ "id": "asa:metrics",
3437
3591
  "pluginAlias": "adapty",
3438
3592
  "pluginName": "adapty",
3439
3593
  "pluginType": "core",
@@ -3444,17 +3598,17 @@
3444
3598
  "dist",
3445
3599
  "commands",
3446
3600
  "asa",
3447
- "competitors",
3448
- "summary.js"
3601
+ "metrics",
3602
+ "index.js"
3449
3603
  ]
3450
3604
  },
3451
- "asa:creatives:list": {
3605
+ "asa:metrics:overview": {
3452
3606
  "aliases": [],
3453
3607
  "args": {},
3454
- "description": "List creatives; creative_id is what `asa ads create` needs",
3608
+ "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.",
3455
3609
  "examples": [
3456
- "<%= config.bin %> asa creatives list",
3457
- "<%= config.bin %> asa creatives list --app APP_UUID"
3610
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3611
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3458
3612
  ],
3459
3613
  "flags": {
3460
3614
  "json": {
@@ -3464,40 +3618,69 @@
3464
3618
  "allowNo": false,
3465
3619
  "type": "boolean"
3466
3620
  },
3467
- "page": {
3468
- "description": "Page number",
3469
- "name": "page",
3470
- "default": 1,
3621
+ "by-days": {
3622
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3623
+ "name": "by-days",
3624
+ "hasDynamicHelp": false,
3625
+ "multiple": true,
3626
+ "type": "option"
3627
+ },
3628
+ "date-from": {
3629
+ "description": "Start of the period (YYYY-MM-DD)",
3630
+ "name": "date-from",
3631
+ "required": true,
3632
+ "hasDynamicHelp": false,
3633
+ "multiple": false,
3634
+ "type": "option"
3635
+ },
3636
+ "date-to": {
3637
+ "description": "End of the period (YYYY-MM-DD)",
3638
+ "name": "date-to",
3639
+ "required": true,
3471
3640
  "hasDynamicHelp": false,
3472
3641
  "multiple": false,
3473
3642
  "type": "option"
3474
3643
  },
3475
- "page-size": {
3476
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3477
- "name": "page-size",
3478
- "default": 100,
3644
+ "entity": {
3645
+ "description": "What to report on",
3646
+ "name": "entity",
3647
+ "required": true,
3479
3648
  "hasDynamicHelp": false,
3480
3649
  "multiple": false,
3650
+ "options": [
3651
+ "ad",
3652
+ "ad-group",
3653
+ "campaign",
3654
+ "keyword"
3655
+ ],
3481
3656
  "type": "option"
3482
3657
  },
3483
- "app": {
3484
- "description": "Keep only rows in this app; repeatable",
3485
- "name": "app",
3658
+ "metric": {
3659
+ "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3660
+ "name": "metric",
3486
3661
  "hasDynamicHelp": false,
3487
3662
  "multiple": true,
3488
3663
  "type": "option"
3489
3664
  },
3490
- "campaign-group": {
3491
- "description": "Keep only rows in this campaign group; repeatable",
3492
- "name": "campaign-group",
3665
+ "period-unit": {
3666
+ "description": "Bucket size",
3667
+ "name": "period-unit",
3668
+ "default": "day",
3493
3669
  "hasDynamicHelp": false,
3494
- "multiple": true,
3670
+ "multiple": false,
3671
+ "options": [
3672
+ "day",
3673
+ "month",
3674
+ "quarter",
3675
+ "week",
3676
+ "year"
3677
+ ],
3495
3678
  "type": "option"
3496
3679
  }
3497
3680
  },
3498
3681
  "hasDynamicHelp": false,
3499
3682
  "hiddenAliases": [],
3500
- "id": "asa:creatives:list",
3683
+ "id": "asa:metrics:overview",
3501
3684
  "pluginAlias": "adapty",
3502
3685
  "pluginName": "adapty",
3503
3686
  "pluginType": "core",
@@ -3508,17 +3691,18 @@
3508
3691
  "dist",
3509
3692
  "commands",
3510
3693
  "asa",
3511
- "creatives",
3512
- "list.js"
3694
+ "metrics",
3695
+ "overview.js"
3513
3696
  ]
3514
3697
  },
3515
- "asa:keywords:add": {
3698
+ "asa:negative-keywords:add": {
3516
3699
  "aliases": [],
3517
3700
  "args": {},
3518
- "description": "Add targeting keywords to an ad group",
3701
+ "description": "Add negative keywords to an ad group or across a campaign",
3519
3702
  "examples": [
3520
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3521
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3703
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3704
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3705
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3522
3706
  ],
3523
3707
  "flags": {
3524
3708
  "json": {
@@ -3528,14 +3712,6 @@
3528
3712
  "allowNo": false,
3529
3713
  "type": "boolean"
3530
3714
  },
3531
- "currency": {
3532
- "description": "Currency code for the amounts in this call",
3533
- "name": "currency",
3534
- "default": "USD",
3535
- "hasDynamicHelp": false,
3536
- "multiple": false,
3537
- "type": "option"
3538
- },
3539
3715
  "yes": {
3540
3716
  "char": "y",
3541
3717
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3552,22 +3728,29 @@
3552
3728
  },
3553
3729
  "ad-group": {
3554
3730
  "description": "Ad group ID (UUID) — the campaign is resolved from it",
3731
+ "exclusive": [
3732
+ "campaign"
3733
+ ],
3555
3734
  "name": "ad-group",
3556
- "required": true,
3557
3735
  "hasDynamicHelp": false,
3558
3736
  "multiple": false,
3559
3737
  "type": "option"
3560
3738
  },
3561
- "bid": {
3562
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3563
- "name": "bid",
3564
- "hasDynamicHelp": false,
3565
- "multiple": false,
3566
- "type": "option"
3739
+ "all-ad-groups": {
3740
+ "dependsOn": [
3741
+ "campaign"
3742
+ ],
3743
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
3744
+ "name": "all-ad-groups",
3745
+ "allowNo": false,
3746
+ "type": "boolean"
3567
3747
  },
3568
- "from-file": {
3569
- "description": "File with one keyword per line, combined with any --text values",
3570
- "name": "from-file",
3748
+ "campaign": {
3749
+ "description": "Campaign ID (UUID)",
3750
+ "exclusive": [
3751
+ "ad-group"
3752
+ ],
3753
+ "name": "campaign",
3571
3754
  "hasDynamicHelp": false,
3572
3755
  "multiple": false,
3573
3756
  "type": "option"
@@ -3575,7 +3758,7 @@
3575
3758
  "match-type": {
3576
3759
  "description": "Match type",
3577
3760
  "name": "match-type",
3578
- "default": "BROAD",
3761
+ "default": "EXACT",
3579
3762
  "hasDynamicHelp": false,
3580
3763
  "multiple": false,
3581
3764
  "options": [
@@ -3599,6 +3782,7 @@
3599
3782
  "text": {
3600
3783
  "description": "Keyword text, repeatable",
3601
3784
  "name": "text",
3785
+ "required": true,
3602
3786
  "hasDynamicHelp": false,
3603
3787
  "multiple": true,
3604
3788
  "type": "option"
@@ -3606,7 +3790,7 @@
3606
3790
  },
3607
3791
  "hasDynamicHelp": false,
3608
3792
  "hiddenAliases": [],
3609
- "id": "asa:keywords:add",
3793
+ "id": "asa:negative-keywords:add",
3610
3794
  "pluginAlias": "adapty",
3611
3795
  "pluginName": "adapty",
3612
3796
  "pluginType": "core",
@@ -3617,17 +3801,17 @@
3617
3801
  "dist",
3618
3802
  "commands",
3619
3803
  "asa",
3620
- "keywords",
3804
+ "negative-keywords",
3621
3805
  "add.js"
3622
3806
  ]
3623
3807
  },
3624
- "asa:keywords:list": {
3808
+ "asa:negative-keywords:list": {
3625
3809
  "aliases": [],
3626
3810
  "args": {},
3627
- "description": "List targeting keywords; read numbers with asa metrics",
3811
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3628
3812
  "examples": [
3629
- "<%= config.bin %> asa keywords list",
3630
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3813
+ "<%= config.bin %> asa negative-keywords list",
3814
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3631
3815
  ],
3632
3816
  "flags": {
3633
3817
  "json": {
@@ -3688,21 +3872,16 @@
3688
3872
  "multiple": true,
3689
3873
  "type": "option"
3690
3874
  },
3691
- "status": {
3692
- "description": "Keep only rows in this state",
3693
- "name": "status",
3694
- "hasDynamicHelp": false,
3695
- "multiple": false,
3696
- "options": [
3697
- "ACTIVE",
3698
- "PAUSED"
3699
- ],
3700
- "type": "option"
3875
+ "campaign-level-only": {
3876
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
3877
+ "name": "campaign-level-only",
3878
+ "allowNo": false,
3879
+ "type": "boolean"
3701
3880
  }
3702
3881
  },
3703
3882
  "hasDynamicHelp": false,
3704
3883
  "hiddenAliases": [],
3705
- "id": "asa:keywords:list",
3884
+ "id": "asa:negative-keywords:list",
3706
3885
  "pluginAlias": "adapty",
3707
3886
  "pluginName": "adapty",
3708
3887
  "pluginType": "core",
@@ -3713,23 +3892,16 @@
3713
3892
  "dist",
3714
3893
  "commands",
3715
3894
  "asa",
3716
- "keywords",
3895
+ "negative-keywords",
3717
3896
  "list.js"
3718
3897
  ]
3719
3898
  },
3720
- "asa:keywords:update": {
3899
+ "asa:orgs:list": {
3721
3900
  "aliases": [],
3722
- "args": {
3723
- "keyword_id": {
3724
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3725
- "name": "keyword_id",
3726
- "required": true
3727
- }
3728
- },
3729
- "description": "Change bid, status, text or match type of keywords",
3901
+ "args": {},
3902
+ "description": "List the Apple Search Ads organizations this company can spend from",
3730
3903
  "examples": [
3731
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3732
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3904
+ "<%= config.bin %> asa orgs list"
3733
3905
  ],
3734
3906
  "flags": {
3735
3907
  "json": {
@@ -3739,60 +3911,137 @@
3739
3911
  "allowNo": false,
3740
3912
  "type": "boolean"
3741
3913
  },
3742
- "currency": {
3743
- "description": "Currency code for the amounts in this call",
3744
- "name": "currency",
3745
- "default": "USD",
3914
+ "page": {
3915
+ "description": "Page number",
3916
+ "name": "page",
3917
+ "default": 1,
3746
3918
  "hasDynamicHelp": false,
3747
3919
  "multiple": false,
3748
3920
  "type": "option"
3749
3921
  },
3750
- "yes": {
3751
- "char": "y",
3752
- "description": "Apply without asking; required when the output is piped or --json is used",
3753
- "name": "yes",
3922
+ "page-size": {
3923
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3924
+ "name": "page-size",
3925
+ "default": 100,
3926
+ "hasDynamicHelp": false,
3927
+ "multiple": false,
3928
+ "type": "option"
3929
+ }
3930
+ },
3931
+ "hasDynamicHelp": false,
3932
+ "hiddenAliases": [],
3933
+ "id": "asa:orgs:list",
3934
+ "pluginAlias": "adapty",
3935
+ "pluginName": "adapty",
3936
+ "pluginType": "core",
3937
+ "strict": true,
3938
+ "enableJsonFlag": true,
3939
+ "isESM": true,
3940
+ "relativePath": [
3941
+ "dist",
3942
+ "commands",
3943
+ "asa",
3944
+ "orgs",
3945
+ "list.js"
3946
+ ]
3947
+ },
3948
+ "asa:product-pages:list": {
3949
+ "aliases": [],
3950
+ "args": {},
3951
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
3952
+ "examples": [
3953
+ "<%= config.bin %> asa product-pages list",
3954
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
3955
+ ],
3956
+ "flags": {
3957
+ "json": {
3958
+ "description": "Format output as json.",
3959
+ "helpGroup": "GLOBAL",
3960
+ "name": "json",
3754
3961
  "allowNo": false,
3755
3962
  "type": "boolean"
3756
3963
  },
3757
- "idempotency-key": {
3758
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3759
- "name": "idempotency-key",
3964
+ "page": {
3965
+ "description": "Page number",
3966
+ "name": "page",
3967
+ "default": 1,
3760
3968
  "hasDynamicHelp": false,
3761
3969
  "multiple": false,
3762
3970
  "type": "option"
3763
3971
  },
3764
- "bid": {
3765
- "description": "Bid (amount, e.g. 50 or 12.50)",
3766
- "name": "bid",
3972
+ "page-size": {
3973
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3974
+ "name": "page-size",
3975
+ "default": 100,
3767
3976
  "hasDynamicHelp": false,
3768
3977
  "multiple": false,
3769
3978
  "type": "option"
3770
3979
  },
3771
- "match-type": {
3772
- "description": "Match type",
3773
- "name": "match-type",
3980
+ "app": {
3981
+ "description": "Keep only rows in this app; repeatable",
3982
+ "name": "app",
3774
3983
  "hasDynamicHelp": false,
3775
- "multiple": false,
3776
- "options": [
3777
- "BROAD",
3778
- "EXACT"
3779
- ],
3984
+ "multiple": true,
3985
+ "type": "option"
3986
+ },
3987
+ "campaign-group": {
3988
+ "description": "Keep only rows in this campaign group; repeatable",
3989
+ "name": "campaign-group",
3990
+ "hasDynamicHelp": false,
3991
+ "multiple": true,
3780
3992
  "type": "option"
3993
+ }
3994
+ },
3995
+ "hasDynamicHelp": false,
3996
+ "hiddenAliases": [],
3997
+ "id": "asa:product-pages:list",
3998
+ "pluginAlias": "adapty",
3999
+ "pluginName": "adapty",
4000
+ "pluginType": "core",
4001
+ "strict": true,
4002
+ "enableJsonFlag": true,
4003
+ "isESM": true,
4004
+ "relativePath": [
4005
+ "dist",
4006
+ "commands",
4007
+ "asa",
4008
+ "product-pages",
4009
+ "list.js"
4010
+ ]
4011
+ },
4012
+ "asa:product-pages:sync": {
4013
+ "aliases": [],
4014
+ "args": {},
4015
+ "description": "Refresh custom product pages from Apple",
4016
+ "examples": [
4017
+ "<%= config.bin %> asa product-pages sync",
4018
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
4019
+ ],
4020
+ "flags": {
4021
+ "json": {
4022
+ "description": "Format output as json.",
4023
+ "helpGroup": "GLOBAL",
4024
+ "name": "json",
4025
+ "allowNo": false,
4026
+ "type": "boolean"
3781
4027
  },
3782
- "status": {
3783
- "description": "Keyword status",
3784
- "name": "status",
4028
+ "yes": {
4029
+ "char": "y",
4030
+ "description": "Apply without asking; required when the output is piped or --json is used",
4031
+ "name": "yes",
4032
+ "allowNo": false,
4033
+ "type": "boolean"
4034
+ },
4035
+ "idempotency-key": {
4036
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4037
+ "name": "idempotency-key",
3785
4038
  "hasDynamicHelp": false,
3786
4039
  "multiple": false,
3787
- "options": [
3788
- "ACTIVE",
3789
- "PAUSED"
3790
- ],
3791
4040
  "type": "option"
3792
4041
  },
3793
- "text": {
3794
- "description": "Keyword text (only meaningful for a single keyword)",
3795
- "name": "text",
4042
+ "adam-id": {
4043
+ "description": "Limit the refresh to one app; omit to cover every app",
4044
+ "name": "adam-id",
3796
4045
  "hasDynamicHelp": false,
3797
4046
  "multiple": false,
3798
4047
  "type": "option"
@@ -3800,31 +4049,28 @@
3800
4049
  },
3801
4050
  "hasDynamicHelp": false,
3802
4051
  "hiddenAliases": [],
3803
- "id": "asa:keywords:update",
4052
+ "id": "asa:product-pages:sync",
3804
4053
  "pluginAlias": "adapty",
3805
4054
  "pluginName": "adapty",
3806
4055
  "pluginType": "core",
3807
- "strict": false,
4056
+ "strict": true,
3808
4057
  "enableJsonFlag": true,
3809
4058
  "isESM": true,
3810
4059
  "relativePath": [
3811
4060
  "dist",
3812
4061
  "commands",
3813
4062
  "asa",
3814
- "keywords",
3815
- "update.js"
4063
+ "product-pages",
4064
+ "sync.js"
3816
4065
  ]
3817
4066
  },
3818
- "asa:metrics": {
4067
+ "asa:search-terms:list": {
3819
4068
  "aliases": [],
3820
4069
  "args": {},
3821
- "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.",
4070
+ "description": "List the search terms your ads matched, with their metrics",
3822
4071
  "examples": [
3823
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3824
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3825
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3826
- "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3827
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
4072
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4073
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
3828
4074
  ],
3829
4075
  "flags": {
3830
4076
  "json": {
@@ -3850,95 +4096,59 @@
3850
4096
  "multiple": false,
3851
4097
  "type": "option"
3852
4098
  },
3853
- "by-days": {
3854
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3855
- "name": "by-days",
3856
- "hasDynamicHelp": false,
3857
- "multiple": true,
3858
- "type": "option"
3859
- },
3860
4099
  "date-from": {
3861
- "description": "Start of the period (YYYY-MM-DD)",
4100
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
3862
4101
  "name": "date-from",
3863
- "required": true,
3864
4102
  "hasDynamicHelp": false,
3865
4103
  "multiple": false,
3866
4104
  "type": "option"
3867
4105
  },
3868
4106
  "date-to": {
3869
- "description": "End of the period (YYYY-MM-DD)",
4107
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
3870
4108
  "name": "date-to",
3871
- "required": true,
3872
- "hasDynamicHelp": false,
3873
- "multiple": false,
3874
- "type": "option"
3875
- },
3876
- "entity": {
3877
- "description": "What to report on",
3878
- "name": "entity",
3879
- "required": true,
3880
4109
  "hasDynamicHelp": false,
3881
4110
  "multiple": false,
3882
- "options": [
3883
- "ad",
3884
- "ad-group",
3885
- "campaign",
3886
- "keyword"
3887
- ],
3888
4111
  "type": "option"
3889
4112
  },
3890
- "group-by": {
3891
- "description": "Break the rows down by a dimension, repeatable",
3892
- "name": "group-by",
4113
+ "app": {
4114
+ "description": "Keep only rows in this app; repeatable",
4115
+ "name": "app",
3893
4116
  "hasDynamicHelp": false,
3894
4117
  "multiple": true,
3895
- "options": [
3896
- "country",
3897
- "day",
3898
- "month",
3899
- "quarter",
3900
- "week",
3901
- "year"
3902
- ],
3903
4118
  "type": "option"
3904
4119
  },
3905
- "metric": {
3906
- "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3907
- "name": "metric",
4120
+ "campaign-group": {
4121
+ "description": "Keep only rows in this campaign group; repeatable",
4122
+ "name": "campaign-group",
3908
4123
  "hasDynamicHelp": false,
3909
4124
  "multiple": true,
3910
4125
  "type": "option"
3911
4126
  },
3912
- "order": {
3913
- "description": "Sort direction",
3914
- "name": "order",
3915
- "default": "desc",
4127
+ "search": {
4128
+ "description": "Case-insensitive substring match on the name",
4129
+ "name": "search",
3916
4130
  "hasDynamicHelp": false,
3917
4131
  "multiple": false,
3918
- "options": [
3919
- "asc",
3920
- "desc"
3921
- ],
3922
4132
  "type": "option"
3923
4133
  },
3924
- "order-by": {
3925
- "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3926
- "name": "order-by",
4134
+ "campaign": {
4135
+ "description": "Keep only rows in this campaign; repeatable",
4136
+ "name": "campaign",
3927
4137
  "hasDynamicHelp": false,
3928
- "multiple": false,
4138
+ "multiple": true,
3929
4139
  "type": "option"
3930
4140
  },
3931
- "order-by-day": {
3932
- "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3933
- "name": "order-by-day",
4141
+ "ad-group": {
4142
+ "description": "Keep only rows in this ad group; repeatable",
4143
+ "name": "ad-group",
3934
4144
  "hasDynamicHelp": false,
3935
- "multiple": false,
4145
+ "multiple": true,
3936
4146
  "type": "option"
3937
4147
  }
3938
4148
  },
3939
4149
  "hasDynamicHelp": false,
3940
4150
  "hiddenAliases": [],
3941
- "id": "asa:metrics",
4151
+ "id": "asa:search-terms:list",
3942
4152
  "pluginAlias": "adapty",
3943
4153
  "pluginName": "adapty",
3944
4154
  "pluginType": "core",
@@ -3949,17 +4159,22 @@
3949
4159
  "dist",
3950
4160
  "commands",
3951
4161
  "asa",
3952
- "metrics",
3953
- "index.js"
4162
+ "search-terms",
4163
+ "list.js"
3954
4164
  ]
3955
4165
  },
3956
- "asa:metrics:overview": {
4166
+ "flows:config:get": {
3957
4167
  "aliases": [],
3958
- "args": {},
3959
- "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.",
4168
+ "args": {
4169
+ "flow_id": {
4170
+ "description": "Flow ID (UUID)",
4171
+ "name": "flow_id",
4172
+ "required": true
4173
+ }
4174
+ },
4175
+ "description": "Read the flow builder config (404 until the config has been written at least once)",
3960
4176
  "examples": [
3961
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3962
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
4177
+ "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
3963
4178
  ],
3964
4179
  "flags": {
3965
4180
  "json": {
@@ -3969,69 +4184,18 @@
3969
4184
  "allowNo": false,
3970
4185
  "type": "boolean"
3971
4186
  },
3972
- "by-days": {
3973
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3974
- "name": "by-days",
3975
- "hasDynamicHelp": false,
3976
- "multiple": true,
3977
- "type": "option"
3978
- },
3979
- "date-from": {
3980
- "description": "Start of the period (YYYY-MM-DD)",
3981
- "name": "date-from",
3982
- "required": true,
3983
- "hasDynamicHelp": false,
3984
- "multiple": false,
3985
- "type": "option"
3986
- },
3987
- "date-to": {
3988
- "description": "End of the period (YYYY-MM-DD)",
3989
- "name": "date-to",
3990
- "required": true,
3991
- "hasDynamicHelp": false,
3992
- "multiple": false,
3993
- "type": "option"
3994
- },
3995
- "entity": {
3996
- "description": "What to report on",
3997
- "name": "entity",
4187
+ "app": {
4188
+ "description": "App ID (UUID)",
4189
+ "name": "app",
3998
4190
  "required": true,
3999
4191
  "hasDynamicHelp": false,
4000
4192
  "multiple": false,
4001
- "options": [
4002
- "ad",
4003
- "ad-group",
4004
- "campaign",
4005
- "keyword"
4006
- ],
4007
- "type": "option"
4008
- },
4009
- "metric": {
4010
- "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
4011
- "name": "metric",
4012
- "hasDynamicHelp": false,
4013
- "multiple": true,
4014
- "type": "option"
4015
- },
4016
- "period-unit": {
4017
- "description": "Bucket size",
4018
- "name": "period-unit",
4019
- "default": "day",
4020
- "hasDynamicHelp": false,
4021
- "multiple": false,
4022
- "options": [
4023
- "day",
4024
- "month",
4025
- "quarter",
4026
- "week",
4027
- "year"
4028
- ],
4029
4193
  "type": "option"
4030
4194
  }
4031
4195
  },
4032
4196
  "hasDynamicHelp": false,
4033
4197
  "hiddenAliases": [],
4034
- "id": "asa:metrics:overview",
4198
+ "id": "flows:config:get",
4035
4199
  "pluginAlias": "adapty",
4036
4200
  "pluginName": "adapty",
4037
4201
  "pluginType": "core",
@@ -4041,107 +4205,66 @@
4041
4205
  "relativePath": [
4042
4206
  "dist",
4043
4207
  "commands",
4044
- "asa",
4045
- "metrics",
4046
- "overview.js"
4208
+ "flows",
4209
+ "config",
4210
+ "get.js"
4047
4211
  ]
4048
4212
  },
4049
- "asa:negative-keywords:add": {
4213
+ "flows:config:preview": {
4050
4214
  "aliases": [],
4051
- "args": {},
4052
- "description": "Add negative keywords to an ad group or across a campaign",
4215
+ "args": {
4216
+ "config_file": {
4217
+ "description": "Path to a local flow config JSON file",
4218
+ "name": "config_file",
4219
+ "required": true
4220
+ }
4221
+ },
4222
+ "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.",
4053
4223
  "examples": [
4054
- "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
4055
- "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
4056
- "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
4057
- ],
4058
- "flags": {
4059
- "json": {
4060
- "description": "Format output as json.",
4061
- "helpGroup": "GLOBAL",
4062
- "name": "json",
4063
- "allowNo": false,
4064
- "type": "boolean"
4065
- },
4066
- "yes": {
4067
- "char": "y",
4068
- "description": "Apply without asking; required when the output is piped or --json is used",
4069
- "name": "yes",
4070
- "allowNo": false,
4071
- "type": "boolean"
4072
- },
4073
- "idempotency-key": {
4074
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4075
- "name": "idempotency-key",
4076
- "hasDynamicHelp": false,
4077
- "multiple": false,
4078
- "type": "option"
4079
- },
4080
- "ad-group": {
4081
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
4082
- "exclusive": [
4083
- "campaign"
4084
- ],
4085
- "name": "ad-group",
4086
- "hasDynamicHelp": false,
4087
- "multiple": false,
4088
- "type": "option"
4089
- },
4090
- "all-ad-groups": {
4091
- "dependsOn": [
4092
- "campaign"
4093
- ],
4094
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
4095
- "name": "all-ad-groups",
4224
+ "<%= config.bin %> flows config preview ./config.json",
4225
+ "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4226
+ "# 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",
4227
+ "# 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"
4228
+ ],
4229
+ "flags": {
4230
+ "json": {
4231
+ "description": "Format output as json.",
4232
+ "helpGroup": "GLOBAL",
4233
+ "name": "json",
4096
4234
  "allowNo": false,
4097
4235
  "type": "boolean"
4098
4236
  },
4099
- "campaign": {
4100
- "description": "Campaign ID (UUID)",
4101
- "exclusive": [
4102
- "ad-group"
4103
- ],
4104
- "name": "campaign",
4237
+ "device": {
4238
+ "description": "Device frame to render in",
4239
+ "name": "device",
4240
+ "default": "iphone-14",
4105
4241
  "hasDynamicHelp": false,
4106
4242
  "multiple": false,
4107
4243
  "type": "option"
4108
4244
  },
4109
- "match-type": {
4110
- "description": "Match type",
4111
- "name": "match-type",
4112
- "default": "EXACT",
4245
+ "orientation": {
4246
+ "description": "Device orientation to render in",
4247
+ "name": "orientation",
4248
+ "default": "portrait",
4113
4249
  "hasDynamicHelp": false,
4114
4250
  "multiple": false,
4115
4251
  "options": [
4116
- "BROAD",
4117
- "EXACT"
4252
+ "landscape",
4253
+ "portrait"
4118
4254
  ],
4119
4255
  "type": "option"
4120
4256
  },
4121
- "status": {
4122
- "description": "Keyword status",
4123
- "name": "status",
4124
- "default": "ACTIVE",
4257
+ "screen": {
4258
+ "description": "Screen ID to render (default: the flow's first screen)",
4259
+ "name": "screen",
4125
4260
  "hasDynamicHelp": false,
4126
4261
  "multiple": false,
4127
- "options": [
4128
- "ACTIVE",
4129
- "PAUSED"
4130
- ],
4131
- "type": "option"
4132
- },
4133
- "text": {
4134
- "description": "Keyword text, repeatable",
4135
- "name": "text",
4136
- "required": true,
4137
- "hasDynamicHelp": false,
4138
- "multiple": true,
4139
4262
  "type": "option"
4140
4263
  }
4141
4264
  },
4142
4265
  "hasDynamicHelp": false,
4143
4266
  "hiddenAliases": [],
4144
- "id": "asa:negative-keywords:add",
4267
+ "id": "flows:config:preview",
4145
4268
  "pluginAlias": "adapty",
4146
4269
  "pluginName": "adapty",
4147
4270
  "pluginType": "core",
@@ -4151,18 +4274,25 @@
4151
4274
  "relativePath": [
4152
4275
  "dist",
4153
4276
  "commands",
4154
- "asa",
4155
- "negative-keywords",
4156
- "add.js"
4277
+ "flows",
4278
+ "config",
4279
+ "preview.js"
4157
4280
  ]
4158
4281
  },
4159
- "asa:negative-keywords:list": {
4282
+ "flows:config:update": {
4160
4283
  "aliases": [],
4161
- "args": {},
4162
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
4284
+ "args": {
4285
+ "flow_id": {
4286
+ "description": "Flow ID (UUID)",
4287
+ "name": "flow_id",
4288
+ "required": true
4289
+ }
4290
+ },
4291
+ "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4163
4292
  "examples": [
4164
- "<%= config.bin %> asa negative-keywords list",
4165
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
4293
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4294
+ "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4295
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4166
4296
  ],
4167
4297
  "flags": {
4168
4298
  "json": {
@@ -4172,67 +4302,46 @@
4172
4302
  "allowNo": false,
4173
4303
  "type": "boolean"
4174
4304
  },
4175
- "page": {
4176
- "description": "Page number",
4177
- "name": "page",
4178
- "default": 1,
4179
- "hasDynamicHelp": false,
4180
- "multiple": false,
4181
- "type": "option"
4182
- },
4183
- "page-size": {
4184
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4185
- "name": "page-size",
4186
- "default": 100,
4187
- "hasDynamicHelp": false,
4188
- "multiple": false,
4189
- "type": "option"
4190
- },
4191
4305
  "app": {
4192
- "description": "Keep only rows in this app; repeatable",
4306
+ "description": "App ID (UUID)",
4193
4307
  "name": "app",
4308
+ "required": true,
4194
4309
  "hasDynamicHelp": false,
4195
- "multiple": true,
4310
+ "multiple": false,
4196
4311
  "type": "option"
4197
4312
  },
4198
- "campaign-group": {
4199
- "description": "Keep only rows in this campaign group; repeatable",
4200
- "name": "campaign-group",
4313
+ "config": {
4314
+ "description": "Builder config as a JSON string",
4315
+ "name": "config",
4201
4316
  "hasDynamicHelp": false,
4202
- "multiple": true,
4317
+ "multiple": false,
4203
4318
  "type": "option"
4204
4319
  },
4205
- "search": {
4206
- "description": "Case-insensitive substring match on the name",
4207
- "name": "search",
4320
+ "config-file": {
4321
+ "description": "JSON file with the builder config, or - to read stdin",
4322
+ "name": "config-file",
4208
4323
  "hasDynamicHelp": false,
4209
4324
  "multiple": false,
4210
4325
  "type": "option"
4211
4326
  },
4212
- "campaign": {
4213
- "description": "Keep only rows in this campaign; repeatable",
4214
- "name": "campaign",
4327
+ "expected-updated-at": {
4328
+ "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4329
+ "name": "expected-updated-at",
4215
4330
  "hasDynamicHelp": false,
4216
- "multiple": true,
4331
+ "multiple": false,
4217
4332
  "type": "option"
4218
4333
  },
4219
- "ad-group": {
4220
- "description": "Keep only rows in this ad group; repeatable",
4221
- "name": "ad-group",
4334
+ "remote-configs": {
4335
+ "description": "JSON array of remote config entries: [{locale, data}]",
4336
+ "name": "remote-configs",
4222
4337
  "hasDynamicHelp": false,
4223
- "multiple": true,
4338
+ "multiple": false,
4224
4339
  "type": "option"
4225
- },
4226
- "campaign-level-only": {
4227
- "description": "Keep only campaign-level rows (ad_group_id is null)",
4228
- "name": "campaign-level-only",
4229
- "allowNo": false,
4230
- "type": "boolean"
4231
4340
  }
4232
4341
  },
4233
4342
  "hasDynamicHelp": false,
4234
4343
  "hiddenAliases": [],
4235
- "id": "asa:negative-keywords:list",
4344
+ "id": "flows:config:update",
4236
4345
  "pluginAlias": "adapty",
4237
4346
  "pluginName": "adapty",
4238
4347
  "pluginType": "core",
@@ -4242,18 +4351,25 @@
4242
4351
  "relativePath": [
4243
4352
  "dist",
4244
4353
  "commands",
4245
- "asa",
4246
- "negative-keywords",
4247
- "list.js"
4354
+ "flows",
4355
+ "config",
4356
+ "update.js"
4248
4357
  ]
4249
4358
  },
4250
- "asa:product-pages:list": {
4359
+ "flows:config:validate": {
4251
4360
  "aliases": [],
4252
- "args": {},
4253
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4361
+ "args": {
4362
+ "flow_id": {
4363
+ "description": "Flow ID (UUID)",
4364
+ "name": "flow_id",
4365
+ "required": true
4366
+ }
4367
+ },
4368
+ "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4254
4369
  "examples": [
4255
- "<%= config.bin %> asa product-pages list",
4256
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4370
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4371
+ "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4372
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4257
4373
  ],
4258
4374
  "flags": {
4259
4375
  "json": {
@@ -4263,40 +4379,32 @@
4263
4379
  "allowNo": false,
4264
4380
  "type": "boolean"
4265
4381
  },
4266
- "page": {
4267
- "description": "Page number",
4268
- "name": "page",
4269
- "default": 1,
4382
+ "app": {
4383
+ "description": "App ID (UUID)",
4384
+ "name": "app",
4385
+ "required": true,
4270
4386
  "hasDynamicHelp": false,
4271
4387
  "multiple": false,
4272
4388
  "type": "option"
4273
4389
  },
4274
- "page-size": {
4275
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4276
- "name": "page-size",
4277
- "default": 100,
4390
+ "config": {
4391
+ "description": "Builder config as a JSON string",
4392
+ "name": "config",
4278
4393
  "hasDynamicHelp": false,
4279
4394
  "multiple": false,
4280
4395
  "type": "option"
4281
4396
  },
4282
- "app": {
4283
- "description": "Keep only rows in this app; repeatable",
4284
- "name": "app",
4285
- "hasDynamicHelp": false,
4286
- "multiple": true,
4287
- "type": "option"
4288
- },
4289
- "campaign-group": {
4290
- "description": "Keep only rows in this campaign group; repeatable",
4291
- "name": "campaign-group",
4397
+ "config-file": {
4398
+ "description": "JSON file with the builder config, or - to read stdin",
4399
+ "name": "config-file",
4292
4400
  "hasDynamicHelp": false,
4293
- "multiple": true,
4401
+ "multiple": false,
4294
4402
  "type": "option"
4295
4403
  }
4296
4404
  },
4297
4405
  "hasDynamicHelp": false,
4298
4406
  "hiddenAliases": [],
4299
- "id": "asa:product-pages:list",
4407
+ "id": "flows:config:validate",
4300
4408
  "pluginAlias": "adapty",
4301
4409
  "pluginName": "adapty",
4302
4410
  "pluginType": "core",
@@ -4306,18 +4414,18 @@
4306
4414
  "relativePath": [
4307
4415
  "dist",
4308
4416
  "commands",
4309
- "asa",
4310
- "product-pages",
4311
- "list.js"
4417
+ "flows",
4418
+ "config",
4419
+ "validate.js"
4312
4420
  ]
4313
4421
  },
4314
- "asa:product-pages:sync": {
4422
+ "asa:automations:create": {
4315
4423
  "aliases": [],
4316
4424
  "args": {},
4317
- "description": "Refresh custom product pages from Apple",
4425
+ "description": "Create an automation rule from a JSON rule file",
4318
4426
  "examples": [
4319
- "<%= config.bin %> asa product-pages sync",
4320
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
4427
+ "<%= config.bin %> asa automations create --file rule.json",
4428
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
4321
4429
  ],
4322
4430
  "flags": {
4323
4431
  "json": {
@@ -4341,17 +4449,24 @@
4341
4449
  "multiple": false,
4342
4450
  "type": "option"
4343
4451
  },
4344
- "adam-id": {
4345
- "description": "Limit the refresh to one app; omit to cover every app",
4346
- "name": "adam-id",
4452
+ "file": {
4453
+ "description": "JSON file with the rule body, or - to read stdin",
4454
+ "name": "file",
4455
+ "required": true,
4347
4456
  "hasDynamicHelp": false,
4348
4457
  "multiple": false,
4349
4458
  "type": "option"
4459
+ },
4460
+ "run-now": {
4461
+ "description": "Queue the first run right after the rule is stored",
4462
+ "name": "run-now",
4463
+ "allowNo": false,
4464
+ "type": "boolean"
4350
4465
  }
4351
4466
  },
4352
4467
  "hasDynamicHelp": false,
4353
4468
  "hiddenAliases": [],
4354
- "id": "asa:product-pages:sync",
4469
+ "id": "asa:automations:create",
4355
4470
  "pluginAlias": "adapty",
4356
4471
  "pluginName": "adapty",
4357
4472
  "pluginType": "core",
@@ -4362,17 +4477,55 @@
4362
4477
  "dist",
4363
4478
  "commands",
4364
4479
  "asa",
4365
- "product-pages",
4366
- "sync.js"
4480
+ "automations",
4481
+ "create.js"
4367
4482
  ]
4368
4483
  },
4369
- "asa:search-terms:list": {
4484
+ "asa:automations:get": {
4485
+ "aliases": [],
4486
+ "args": {
4487
+ "automation_id": {
4488
+ "description": "Automation rule ID (UUID)",
4489
+ "name": "automation_id",
4490
+ "required": true
4491
+ }
4492
+ },
4493
+ "description": "Show one automation rule with its conditions and actions",
4494
+ "examples": [
4495
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
4496
+ ],
4497
+ "flags": {
4498
+ "json": {
4499
+ "description": "Format output as json.",
4500
+ "helpGroup": "GLOBAL",
4501
+ "name": "json",
4502
+ "allowNo": false,
4503
+ "type": "boolean"
4504
+ }
4505
+ },
4506
+ "hasDynamicHelp": false,
4507
+ "hiddenAliases": [],
4508
+ "id": "asa:automations:get",
4509
+ "pluginAlias": "adapty",
4510
+ "pluginName": "adapty",
4511
+ "pluginType": "core",
4512
+ "strict": true,
4513
+ "enableJsonFlag": true,
4514
+ "isESM": true,
4515
+ "relativePath": [
4516
+ "dist",
4517
+ "commands",
4518
+ "asa",
4519
+ "automations",
4520
+ "get.js"
4521
+ ]
4522
+ },
4523
+ "asa:automations:list": {
4370
4524
  "aliases": [],
4371
4525
  "args": {},
4372
- "description": "List the search terms your ads matched, with their metrics",
4526
+ "description": "List automation rules; status 1 is active, 0 is stopped",
4373
4527
  "examples": [
4374
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4375
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4528
+ "<%= config.bin %> asa automations list"
4376
4529
  ],
4377
4530
  "flags": {
4378
4531
  "json": {
@@ -4397,60 +4550,11 @@
4397
4550
  "hasDynamicHelp": false,
4398
4551
  "multiple": false,
4399
4552
  "type": "option"
4400
- },
4401
- "date-from": {
4402
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4403
- "name": "date-from",
4404
- "hasDynamicHelp": false,
4405
- "multiple": false,
4406
- "type": "option"
4407
- },
4408
- "date-to": {
4409
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4410
- "name": "date-to",
4411
- "hasDynamicHelp": false,
4412
- "multiple": false,
4413
- "type": "option"
4414
- },
4415
- "app": {
4416
- "description": "Keep only rows in this app; repeatable",
4417
- "name": "app",
4418
- "hasDynamicHelp": false,
4419
- "multiple": true,
4420
- "type": "option"
4421
- },
4422
- "campaign-group": {
4423
- "description": "Keep only rows in this campaign group; repeatable",
4424
- "name": "campaign-group",
4425
- "hasDynamicHelp": false,
4426
- "multiple": true,
4427
- "type": "option"
4428
- },
4429
- "search": {
4430
- "description": "Case-insensitive substring match on the name",
4431
- "name": "search",
4432
- "hasDynamicHelp": false,
4433
- "multiple": false,
4434
- "type": "option"
4435
- },
4436
- "campaign": {
4437
- "description": "Keep only rows in this campaign; repeatable",
4438
- "name": "campaign",
4439
- "hasDynamicHelp": false,
4440
- "multiple": true,
4441
- "type": "option"
4442
- },
4443
- "ad-group": {
4444
- "description": "Keep only rows in this ad group; repeatable",
4445
- "name": "ad-group",
4446
- "hasDynamicHelp": false,
4447
- "multiple": true,
4448
- "type": "option"
4449
4553
  }
4450
4554
  },
4451
4555
  "hasDynamicHelp": false,
4452
4556
  "hiddenAliases": [],
4453
- "id": "asa:search-terms:list",
4557
+ "id": "asa:automations:list",
4454
4558
  "pluginAlias": "adapty",
4455
4559
  "pluginName": "adapty",
4456
4560
  "pluginType": "core",
@@ -4461,16 +4565,23 @@
4461
4565
  "dist",
4462
4566
  "commands",
4463
4567
  "asa",
4464
- "search-terms",
4568
+ "automations",
4465
4569
  "list.js"
4466
4570
  ]
4467
4571
  },
4468
- "asa:orgs:list": {
4572
+ "asa:automations:run": {
4469
4573
  "aliases": [],
4470
- "args": {},
4471
- "description": "List the Apple Search Ads organizations this company can spend from",
4574
+ "args": {
4575
+ "automation_id": {
4576
+ "description": "Automation rule ID (UUID)",
4577
+ "name": "automation_id",
4578
+ "required": true
4579
+ }
4580
+ },
4581
+ "description": "Run an automation rule now; the run is queued, not awaited",
4472
4582
  "examples": [
4473
- "<%= config.bin %> asa orgs list"
4583
+ "<%= config.bin %> asa automations run UUID",
4584
+ "<%= config.bin %> asa automations run UUID --dry-run"
4474
4585
  ],
4475
4586
  "flags": {
4476
4587
  "json": {
@@ -4480,26 +4591,30 @@
4480
4591
  "allowNo": false,
4481
4592
  "type": "boolean"
4482
4593
  },
4483
- "page": {
4484
- "description": "Page number",
4485
- "name": "page",
4486
- "default": 1,
4487
- "hasDynamicHelp": false,
4488
- "multiple": false,
4489
- "type": "option"
4594
+ "yes": {
4595
+ "char": "y",
4596
+ "description": "Apply without asking; required when the output is piped or --json is used",
4597
+ "name": "yes",
4598
+ "allowNo": false,
4599
+ "type": "boolean"
4490
4600
  },
4491
- "page-size": {
4492
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4493
- "name": "page-size",
4494
- "default": 100,
4601
+ "idempotency-key": {
4602
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4603
+ "name": "idempotency-key",
4495
4604
  "hasDynamicHelp": false,
4496
4605
  "multiple": false,
4497
4606
  "type": "option"
4607
+ },
4608
+ "dry-run": {
4609
+ "description": "Evaluate and log the rule without touching Apple",
4610
+ "name": "dry-run",
4611
+ "allowNo": false,
4612
+ "type": "boolean"
4498
4613
  }
4499
4614
  },
4500
4615
  "hasDynamicHelp": false,
4501
4616
  "hiddenAliases": [],
4502
- "id": "asa:orgs:list",
4617
+ "id": "asa:automations:run",
4503
4618
  "pluginAlias": "adapty",
4504
4619
  "pluginName": "adapty",
4505
4620
  "pluginType": "core",
@@ -4510,22 +4625,22 @@
4510
4625
  "dist",
4511
4626
  "commands",
4512
4627
  "asa",
4513
- "orgs",
4514
- "list.js"
4628
+ "automations",
4629
+ "run.js"
4515
4630
  ]
4516
4631
  },
4517
- "flows:config:get": {
4632
+ "asa:automations:runs": {
4518
4633
  "aliases": [],
4519
4634
  "args": {
4520
- "flow_id": {
4521
- "description": "Flow ID (UUID)",
4522
- "name": "flow_id",
4635
+ "automation_id": {
4636
+ "description": "Automation rule ID (UUID)",
4637
+ "name": "automation_id",
4523
4638
  "required": true
4524
4639
  }
4525
4640
  },
4526
- "description": "Read the flow builder config (404 until the config has been written at least once)",
4641
+ "description": "List past runs of an automation rule, including dry runs",
4527
4642
  "examples": [
4528
- "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
4643
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
4529
4644
  ],
4530
4645
  "flags": {
4531
4646
  "json": {
@@ -4535,10 +4650,18 @@
4535
4650
  "allowNo": false,
4536
4651
  "type": "boolean"
4537
4652
  },
4538
- "app": {
4539
- "description": "App ID (UUID)",
4540
- "name": "app",
4541
- "required": true,
4653
+ "page": {
4654
+ "description": "Page number",
4655
+ "name": "page",
4656
+ "default": 1,
4657
+ "hasDynamicHelp": false,
4658
+ "multiple": false,
4659
+ "type": "option"
4660
+ },
4661
+ "page-size": {
4662
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4663
+ "name": "page-size",
4664
+ "default": 100,
4542
4665
  "hasDynamicHelp": false,
4543
4666
  "multiple": false,
4544
4667
  "type": "option"
@@ -4546,7 +4669,7 @@
4546
4669
  },
4547
4670
  "hasDynamicHelp": false,
4548
4671
  "hiddenAliases": [],
4549
- "id": "flows:config:get",
4672
+ "id": "asa:automations:runs",
4550
4673
  "pluginAlias": "adapty",
4551
4674
  "pluginName": "adapty",
4552
4675
  "pluginType": "core",
@@ -4556,26 +4679,24 @@
4556
4679
  "relativePath": [
4557
4680
  "dist",
4558
4681
  "commands",
4559
- "flows",
4560
- "config",
4561
- "get.js"
4682
+ "asa",
4683
+ "automations",
4684
+ "runs.js"
4562
4685
  ]
4563
4686
  },
4564
- "flows:config:preview": {
4687
+ "asa:automations:update": {
4565
4688
  "aliases": [],
4566
4689
  "args": {
4567
- "config_file": {
4568
- "description": "Path to a local flow config JSON file",
4569
- "name": "config_file",
4690
+ "automation_id": {
4691
+ "description": "Automation rule ID (UUID)",
4692
+ "name": "automation_id",
4570
4693
  "required": true
4571
4694
  }
4572
4695
  },
4573
- "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.",
4696
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
4574
4697
  "examples": [
4575
- "<%= config.bin %> flows config preview ./config.json",
4576
- "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4577
- "# 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",
4578
- "# 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"
4698
+ "<%= config.bin %> asa automations update UUID --stop",
4699
+ "<%= config.bin %> asa automations update UUID --file rule.json"
4579
4700
  ],
4580
4701
  "flags": {
4581
4702
  "json": {
@@ -4585,37 +4706,56 @@
4585
4706
  "allowNo": false,
4586
4707
  "type": "boolean"
4587
4708
  },
4588
- "device": {
4589
- "description": "Device frame to render in",
4590
- "name": "device",
4591
- "default": "iphone-14",
4709
+ "yes": {
4710
+ "char": "y",
4711
+ "description": "Apply without asking; required when the output is piped or --json is used",
4712
+ "name": "yes",
4713
+ "allowNo": false,
4714
+ "type": "boolean"
4715
+ },
4716
+ "idempotency-key": {
4717
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4718
+ "name": "idempotency-key",
4592
4719
  "hasDynamicHelp": false,
4593
4720
  "multiple": false,
4594
4721
  "type": "option"
4595
4722
  },
4596
- "orientation": {
4597
- "description": "Device orientation to render in",
4598
- "name": "orientation",
4599
- "default": "portrait",
4723
+ "file": {
4724
+ "description": "JSON file with the parts to change, or - to read stdin",
4725
+ "name": "file",
4600
4726
  "hasDynamicHelp": false,
4601
4727
  "multiple": false,
4602
- "options": [
4603
- "landscape",
4604
- "portrait"
4605
- ],
4606
4728
  "type": "option"
4607
4729
  },
4608
- "screen": {
4609
- "description": "Screen ID to render (default: the flow's first screen)",
4610
- "name": "screen",
4730
+ "name": {
4731
+ "description": "Rule name",
4732
+ "name": "name",
4611
4733
  "hasDynamicHelp": false,
4612
4734
  "multiple": false,
4613
4735
  "type": "option"
4736
+ },
4737
+ "start": {
4738
+ "description": "Activate the rule",
4739
+ "exclusive": [
4740
+ "stop"
4741
+ ],
4742
+ "name": "start",
4743
+ "allowNo": false,
4744
+ "type": "boolean"
4745
+ },
4746
+ "stop": {
4747
+ "description": "Stop the rule and clear its next run",
4748
+ "exclusive": [
4749
+ "start"
4750
+ ],
4751
+ "name": "stop",
4752
+ "allowNo": false,
4753
+ "type": "boolean"
4614
4754
  }
4615
4755
  },
4616
4756
  "hasDynamicHelp": false,
4617
4757
  "hiddenAliases": [],
4618
- "id": "flows:config:preview",
4758
+ "id": "asa:automations:update",
4619
4759
  "pluginAlias": "adapty",
4620
4760
  "pluginName": "adapty",
4621
4761
  "pluginType": "core",
@@ -4625,25 +4765,23 @@
4625
4765
  "relativePath": [
4626
4766
  "dist",
4627
4767
  "commands",
4628
- "flows",
4629
- "config",
4630
- "preview.js"
4768
+ "asa",
4769
+ "automations",
4770
+ "update.js"
4631
4771
  ]
4632
4772
  },
4633
- "flows:config:update": {
4773
+ "flows:media:upload": {
4634
4774
  "aliases": [],
4635
4775
  "args": {
4636
- "flow_id": {
4637
- "description": "Flow ID (UUID)",
4638
- "name": "flow_id",
4776
+ "file": {
4777
+ "description": "Path to the image file to upload",
4778
+ "name": "file",
4639
4779
  "required": true
4640
4780
  }
4641
4781
  },
4642
- "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4782
+ "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
4643
4783
  "examples": [
4644
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4645
- "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4646
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4784
+ "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
4647
4785
  ],
4648
4786
  "flags": {
4649
4787
  "json": {
@@ -4660,39 +4798,11 @@
4660
4798
  "hasDynamicHelp": false,
4661
4799
  "multiple": false,
4662
4800
  "type": "option"
4663
- },
4664
- "config": {
4665
- "description": "Builder config as a JSON string",
4666
- "name": "config",
4667
- "hasDynamicHelp": false,
4668
- "multiple": false,
4669
- "type": "option"
4670
- },
4671
- "config-file": {
4672
- "description": "JSON file with the builder config, or - to read stdin",
4673
- "name": "config-file",
4674
- "hasDynamicHelp": false,
4675
- "multiple": false,
4676
- "type": "option"
4677
- },
4678
- "expected-updated-at": {
4679
- "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4680
- "name": "expected-updated-at",
4681
- "hasDynamicHelp": false,
4682
- "multiple": false,
4683
- "type": "option"
4684
- },
4685
- "remote-configs": {
4686
- "description": "JSON array of remote config entries: [{locale, data}]",
4687
- "name": "remote-configs",
4688
- "hasDynamicHelp": false,
4689
- "multiple": false,
4690
- "type": "option"
4691
4801
  }
4692
4802
  },
4693
4803
  "hasDynamicHelp": false,
4694
4804
  "hiddenAliases": [],
4695
- "id": "flows:config:update",
4805
+ "id": "flows:media:upload",
4696
4806
  "pluginAlias": "adapty",
4697
4807
  "pluginName": "adapty",
4698
4808
  "pluginType": "core",
@@ -4703,10 +4813,10 @@
4703
4813
  "dist",
4704
4814
  "commands",
4705
4815
  "flows",
4706
- "config",
4707
- "update.js"
4816
+ "media",
4817
+ "upload.js"
4708
4818
  ]
4709
4819
  }
4710
4820
  },
4711
- "version": "0.7.0"
4821
+ "version": "0.8.0-beta.0"
4712
4822
  }