adapty 0.6.0-beta.1 → 0.6.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 (2) hide show
  1. package/oclif.manifest.json +1263 -1263
  2. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -656,6 +656,156 @@
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
+ },
659
809
  "paywalls:create": {
660
810
  "aliases": [],
661
811
  "args": {},
@@ -922,12 +1072,13 @@
922
1072
  "update.js"
923
1073
  ]
924
1074
  },
925
- "products:create": {
1075
+ "placements:create": {
926
1076
  "aliases": [],
927
1077
  "args": {},
928
- "description": "Create a product with vendor products per platform",
1078
+ "description": "Create a placement with a paywall",
929
1079
  "examples": [
930
- "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
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"
931
1082
  ],
932
1083
  "flags": {
933
1084
  "json": {
@@ -945,80 +1096,30 @@
945
1096
  "multiple": false,
946
1097
  "type": "option"
947
1098
  },
948
- "access-level-id": {
949
- "description": "Access level ID (UUID)",
950
- "name": "access-level-id",
951
- "required": true,
952
- "hasDynamicHelp": false,
953
- "multiple": false,
954
- "type": "option"
955
- },
956
- "android-base-plan-id": {
957
- "description": "Android base plan ID",
958
- "helpGroup": "STORE BINDINGS",
959
- "name": "android-base-plan-id",
960
- "hasDynamicHelp": false,
961
- "multiple": false,
962
- "type": "option"
963
- },
964
- "android-product-id": {
965
- "description": "Android product ID",
966
- "helpGroup": "STORE BINDINGS",
967
- "name": "android-product-id",
968
- "hasDynamicHelp": false,
969
- "multiple": false,
970
- "type": "option"
971
- },
972
- "ios-product-id": {
973
- "description": "iOS product ID",
974
- "helpGroup": "STORE BINDINGS",
975
- "name": "ios-product-id",
976
- "hasDynamicHelp": false,
977
- "multiple": false,
978
- "type": "option"
979
- },
980
- "paddle-price-id": {
981
- "description": "Paddle price ID (requires --paddle-product-id)",
982
- "helpGroup": "STORE BINDINGS",
983
- "name": "paddle-price-id",
984
- "hasDynamicHelp": false,
985
- "multiple": false,
986
- "type": "option"
987
- },
988
- "paddle-product-id": {
989
- "description": "Paddle product ID (requires --paddle-price-id)",
990
- "helpGroup": "STORE BINDINGS",
991
- "name": "paddle-product-id",
1099
+ "audiences": {
1100
+ "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1101
+ "name": "audiences",
992
1102
  "hasDynamicHelp": false,
993
1103
  "multiple": false,
994
1104
  "type": "option"
995
1105
  },
996
- "period": {
997
- "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
998
- "name": "period",
1106
+ "developer-id": {
1107
+ "description": "Developer ID for the placement",
1108
+ "name": "developer-id",
999
1109
  "required": true,
1000
1110
  "hasDynamicHelp": false,
1001
1111
  "multiple": false,
1002
1112
  "type": "option"
1003
1113
  },
1004
- "stripe-price-id": {
1005
- "description": "Stripe price ID (requires --stripe-product-id)",
1006
- "helpGroup": "STORE BINDINGS",
1007
- "name": "stripe-price-id",
1008
- "hasDynamicHelp": false,
1009
- "multiple": false,
1010
- "type": "option"
1011
- },
1012
- "stripe-product-id": {
1013
- "description": "Stripe product ID (requires --stripe-price-id)",
1014
- "helpGroup": "STORE BINDINGS",
1015
- "name": "stripe-product-id",
1114
+ "paywall-id": {
1115
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1116
+ "name": "paywall-id",
1016
1117
  "hasDynamicHelp": false,
1017
1118
  "multiple": false,
1018
1119
  "type": "option"
1019
1120
  },
1020
1121
  "title": {
1021
- "description": "Product title",
1122
+ "description": "Placement title",
1022
1123
  "name": "title",
1023
1124
  "required": true,
1024
1125
  "hasDynamicHelp": false,
@@ -1028,7 +1129,7 @@
1028
1129
  },
1029
1130
  "hasDynamicHelp": false,
1030
1131
  "hiddenAliases": [],
1031
- "id": "products:create",
1132
+ "id": "placements:create",
1032
1133
  "pluginAlias": "adapty",
1033
1134
  "pluginName": "adapty",
1034
1135
  "pluginType": "core",
@@ -1038,22 +1139,22 @@
1038
1139
  "relativePath": [
1039
1140
  "dist",
1040
1141
  "commands",
1041
- "products",
1142
+ "placements",
1042
1143
  "create.js"
1043
1144
  ]
1044
1145
  },
1045
- "products:get": {
1146
+ "placements:get": {
1046
1147
  "aliases": [],
1047
1148
  "args": {
1048
- "product_id": {
1049
- "description": "Product ID (UUID)",
1050
- "name": "product_id",
1149
+ "placement_id": {
1150
+ "description": "Placement ID (UUID)",
1151
+ "name": "placement_id",
1051
1152
  "required": true
1052
1153
  }
1053
1154
  },
1054
- "description": "Get product details",
1155
+ "description": "Get placement details",
1055
1156
  "examples": [
1056
- "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1157
+ "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1057
1158
  ],
1058
1159
  "flags": {
1059
1160
  "json": {
@@ -1074,7 +1175,7 @@
1074
1175
  },
1075
1176
  "hasDynamicHelp": false,
1076
1177
  "hiddenAliases": [],
1077
- "id": "products:get",
1178
+ "id": "placements:get",
1078
1179
  "pluginAlias": "adapty",
1079
1180
  "pluginName": "adapty",
1080
1181
  "pluginType": "core",
@@ -1084,16 +1185,16 @@
1084
1185
  "relativePath": [
1085
1186
  "dist",
1086
1187
  "commands",
1087
- "products",
1188
+ "placements",
1088
1189
  "get.js"
1089
1190
  ]
1090
1191
  },
1091
- "products:list": {
1192
+ "placements:list": {
1092
1193
  "aliases": [],
1093
1194
  "args": {},
1094
- "description": "List products for an app",
1195
+ "description": "List placements for an app",
1095
1196
  "examples": [
1096
- "<%= config.bin %> products list --app 550e8400-..."
1197
+ "<%= config.bin %> placements list --app 550e8400-..."
1097
1198
  ],
1098
1199
  "flags": {
1099
1200
  "json": {
@@ -1130,7 +1231,7 @@
1130
1231
  },
1131
1232
  "hasDynamicHelp": false,
1132
1233
  "hiddenAliases": [],
1133
- "id": "products:list",
1234
+ "id": "placements:list",
1134
1235
  "pluginAlias": "adapty",
1135
1236
  "pluginName": "adapty",
1136
1237
  "pluginType": "core",
@@ -1140,22 +1241,93 @@
1140
1241
  "relativePath": [
1141
1242
  "dist",
1142
1243
  "commands",
1143
- "products",
1244
+ "placements",
1144
1245
  "list.js"
1145
1246
  ]
1146
1247
  },
1147
- "products:update": {
1248
+ "placements:update": {
1148
1249
  "aliases": [],
1149
1250
  "args": {
1150
- "product_id": {
1151
- "description": "Product ID (UUID)",
1152
- "name": "product_id",
1251
+ "placement_id": {
1252
+ "description": "Placement ID (UUID)",
1253
+ "name": "placement_id",
1153
1254
  "required": true
1154
1255
  }
1155
1256
  },
1156
- "description": "Update a product (title and access level only)",
1257
+ "description": "Update a placement",
1157
1258
  "examples": [
1158
- "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
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
+ "products:create": {
1326
+ "aliases": [],
1327
+ "args": {},
1328
+ "description": "Create a product with vendor products per platform",
1329
+ "examples": [
1330
+ "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
1159
1331
  ],
1160
1332
  "flags": {
1161
1333
  "json": {
@@ -1181,6 +1353,70 @@
1181
1353
  "multiple": false,
1182
1354
  "type": "option"
1183
1355
  },
1356
+ "android-base-plan-id": {
1357
+ "description": "Android base plan ID",
1358
+ "helpGroup": "STORE BINDINGS",
1359
+ "name": "android-base-plan-id",
1360
+ "hasDynamicHelp": false,
1361
+ "multiple": false,
1362
+ "type": "option"
1363
+ },
1364
+ "android-product-id": {
1365
+ "description": "Android product ID",
1366
+ "helpGroup": "STORE BINDINGS",
1367
+ "name": "android-product-id",
1368
+ "hasDynamicHelp": false,
1369
+ "multiple": false,
1370
+ "type": "option"
1371
+ },
1372
+ "ios-product-id": {
1373
+ "description": "iOS product ID",
1374
+ "helpGroup": "STORE BINDINGS",
1375
+ "name": "ios-product-id",
1376
+ "hasDynamicHelp": false,
1377
+ "multiple": false,
1378
+ "type": "option"
1379
+ },
1380
+ "paddle-price-id": {
1381
+ "description": "Paddle price ID (requires --paddle-product-id)",
1382
+ "helpGroup": "STORE BINDINGS",
1383
+ "name": "paddle-price-id",
1384
+ "hasDynamicHelp": false,
1385
+ "multiple": false,
1386
+ "type": "option"
1387
+ },
1388
+ "paddle-product-id": {
1389
+ "description": "Paddle product ID (requires --paddle-price-id)",
1390
+ "helpGroup": "STORE BINDINGS",
1391
+ "name": "paddle-product-id",
1392
+ "hasDynamicHelp": false,
1393
+ "multiple": false,
1394
+ "type": "option"
1395
+ },
1396
+ "period": {
1397
+ "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
1398
+ "name": "period",
1399
+ "required": true,
1400
+ "hasDynamicHelp": false,
1401
+ "multiple": false,
1402
+ "type": "option"
1403
+ },
1404
+ "stripe-price-id": {
1405
+ "description": "Stripe price ID (requires --stripe-product-id)",
1406
+ "helpGroup": "STORE BINDINGS",
1407
+ "name": "stripe-price-id",
1408
+ "hasDynamicHelp": false,
1409
+ "multiple": false,
1410
+ "type": "option"
1411
+ },
1412
+ "stripe-product-id": {
1413
+ "description": "Stripe product ID (requires --stripe-price-id)",
1414
+ "helpGroup": "STORE BINDINGS",
1415
+ "name": "stripe-product-id",
1416
+ "hasDynamicHelp": false,
1417
+ "multiple": false,
1418
+ "type": "option"
1419
+ },
1184
1420
  "title": {
1185
1421
  "description": "Product title",
1186
1422
  "name": "title",
@@ -1192,7 +1428,7 @@
1192
1428
  },
1193
1429
  "hasDynamicHelp": false,
1194
1430
  "hiddenAliases": [],
1195
- "id": "products:update",
1431
+ "id": "products:create",
1196
1432
  "pluginAlias": "adapty",
1197
1433
  "pluginName": "adapty",
1198
1434
  "pluginType": "core",
@@ -1203,21 +1439,21 @@
1203
1439
  "dist",
1204
1440
  "commands",
1205
1441
  "products",
1206
- "update.js"
1442
+ "create.js"
1207
1443
  ]
1208
1444
  },
1209
- "segments:get": {
1445
+ "products:get": {
1210
1446
  "aliases": [],
1211
1447
  "args": {
1212
- "segment_id": {
1213
- "description": "Segment ID (UUID)",
1214
- "name": "segment_id",
1448
+ "product_id": {
1449
+ "description": "Product ID (UUID)",
1450
+ "name": "product_id",
1215
1451
  "required": true
1216
1452
  }
1217
1453
  },
1218
- "description": "Get segment details",
1454
+ "description": "Get product details",
1219
1455
  "examples": [
1220
- "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1456
+ "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1221
1457
  ],
1222
1458
  "flags": {
1223
1459
  "json": {
@@ -1238,7 +1474,7 @@
1238
1474
  },
1239
1475
  "hasDynamicHelp": false,
1240
1476
  "hiddenAliases": [],
1241
- "id": "segments:get",
1477
+ "id": "products:get",
1242
1478
  "pluginAlias": "adapty",
1243
1479
  "pluginName": "adapty",
1244
1480
  "pluginType": "core",
@@ -1248,16 +1484,16 @@
1248
1484
  "relativePath": [
1249
1485
  "dist",
1250
1486
  "commands",
1251
- "segments",
1487
+ "products",
1252
1488
  "get.js"
1253
1489
  ]
1254
1490
  },
1255
- "segments:list": {
1491
+ "products:list": {
1256
1492
  "aliases": [],
1257
1493
  "args": {},
1258
- "description": "List segments for an app",
1494
+ "description": "List products for an app",
1259
1495
  "examples": [
1260
- "<%= config.bin %> segments list --app 550e8400-..."
1496
+ "<%= config.bin %> products list --app 550e8400-..."
1261
1497
  ],
1262
1498
  "flags": {
1263
1499
  "json": {
@@ -1294,7 +1530,7 @@
1294
1530
  },
1295
1531
  "hasDynamicHelp": false,
1296
1532
  "hiddenAliases": [],
1297
- "id": "segments:list",
1533
+ "id": "products:list",
1298
1534
  "pluginAlias": "adapty",
1299
1535
  "pluginName": "adapty",
1300
1536
  "pluginType": "core",
@@ -1304,16 +1540,22 @@
1304
1540
  "relativePath": [
1305
1541
  "dist",
1306
1542
  "commands",
1307
- "segments",
1543
+ "products",
1308
1544
  "list.js"
1309
1545
  ]
1310
1546
  },
1311
- "flows:create": {
1547
+ "products:update": {
1312
1548
  "aliases": [],
1313
- "args": {},
1314
- "description": "Create a flow (row only — write its config with `flows config update`)",
1549
+ "args": {
1550
+ "product_id": {
1551
+ "description": "Product ID (UUID)",
1552
+ "name": "product_id",
1553
+ "required": true
1554
+ }
1555
+ },
1556
+ "description": "Update a product (title and access level only)",
1315
1557
  "examples": [
1316
- "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
1558
+ "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
1317
1559
  ],
1318
1560
  "flags": {
1319
1561
  "json": {
@@ -1331,9 +1573,17 @@
1331
1573
  "multiple": false,
1332
1574
  "type": "option"
1333
1575
  },
1334
- "name": {
1335
- "description": "Flow name",
1336
- "name": "name",
1576
+ "access-level-id": {
1577
+ "description": "Access level ID (UUID)",
1578
+ "name": "access-level-id",
1579
+ "required": true,
1580
+ "hasDynamicHelp": false,
1581
+ "multiple": false,
1582
+ "type": "option"
1583
+ },
1584
+ "title": {
1585
+ "description": "Product title",
1586
+ "name": "title",
1337
1587
  "required": true,
1338
1588
  "hasDynamicHelp": false,
1339
1589
  "multiple": false,
@@ -1342,7 +1592,7 @@
1342
1592
  },
1343
1593
  "hasDynamicHelp": false,
1344
1594
  "hiddenAliases": [],
1345
- "id": "flows:create",
1595
+ "id": "products:update",
1346
1596
  "pluginAlias": "adapty",
1347
1597
  "pluginName": "adapty",
1348
1598
  "pluginType": "core",
@@ -1352,22 +1602,22 @@
1352
1602
  "relativePath": [
1353
1603
  "dist",
1354
1604
  "commands",
1355
- "flows",
1356
- "create.js"
1605
+ "products",
1606
+ "update.js"
1357
1607
  ]
1358
1608
  },
1359
- "flows:get": {
1609
+ "segments:get": {
1360
1610
  "aliases": [],
1361
1611
  "args": {
1362
- "flow_id": {
1363
- "description": "Flow ID (UUID)",
1364
- "name": "flow_id",
1612
+ "segment_id": {
1613
+ "description": "Segment ID (UUID)",
1614
+ "name": "segment_id",
1365
1615
  "required": true
1366
1616
  }
1367
1617
  },
1368
- "description": "Get flow details",
1618
+ "description": "Get segment details",
1369
1619
  "examples": [
1370
- "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1620
+ "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1371
1621
  ],
1372
1622
  "flags": {
1373
1623
  "json": {
@@ -1388,7 +1638,7 @@
1388
1638
  },
1389
1639
  "hasDynamicHelp": false,
1390
1640
  "hiddenAliases": [],
1391
- "id": "flows:get",
1641
+ "id": "segments:get",
1392
1642
  "pluginAlias": "adapty",
1393
1643
  "pluginName": "adapty",
1394
1644
  "pluginType": "core",
@@ -1398,16 +1648,16 @@
1398
1648
  "relativePath": [
1399
1649
  "dist",
1400
1650
  "commands",
1401
- "flows",
1651
+ "segments",
1402
1652
  "get.js"
1403
1653
  ]
1404
1654
  },
1405
- "flows:list": {
1655
+ "segments:list": {
1406
1656
  "aliases": [],
1407
1657
  "args": {},
1408
- "description": "List flows for an app",
1658
+ "description": "List segments for an app",
1409
1659
  "examples": [
1410
- "<%= config.bin %> flows list --app 550e8400-..."
1660
+ "<%= config.bin %> segments list --app 550e8400-..."
1411
1661
  ],
1412
1662
  "flags": {
1413
1663
  "json": {
@@ -1444,7 +1694,7 @@
1444
1694
  },
1445
1695
  "hasDynamicHelp": false,
1446
1696
  "hiddenAliases": [],
1447
- "id": "flows:list",
1697
+ "id": "segments:list",
1448
1698
  "pluginAlias": "adapty",
1449
1699
  "pluginName": "adapty",
1450
1700
  "pluginType": "core",
@@ -1454,17 +1704,17 @@
1454
1704
  "relativePath": [
1455
1705
  "dist",
1456
1706
  "commands",
1457
- "flows",
1707
+ "segments",
1458
1708
  "list.js"
1459
1709
  ]
1460
1710
  },
1461
- "placements:create": {
1711
+ "asa:ad-groups:create": {
1462
1712
  "aliases": [],
1463
1713
  "args": {},
1464
- "description": "Create a placement with a paywall",
1714
+ "description": "Create an ad group inside a campaign",
1465
1715
  "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"
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"
1468
1718
  ],
1469
1719
  "flags": {
1470
1720
  "json": {
@@ -1474,260 +1724,10 @@
1474
1724
  "allowNo": false,
1475
1725
  "type": "boolean"
1476
1726
  },
1477
- "app": {
1478
- "description": "App ID (UUID)",
1479
- "name": "app",
1480
- "required": true,
1481
- "hasDynamicHelp": false,
1482
- "multiple": false,
1483
- "type": "option"
1484
- },
1485
- "audiences": {
1486
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1487
- "name": "audiences",
1488
- "hasDynamicHelp": false,
1489
- "multiple": false,
1490
- "type": "option"
1491
- },
1492
- "developer-id": {
1493
- "description": "Developer ID for the placement",
1494
- "name": "developer-id",
1495
- "required": true,
1496
- "hasDynamicHelp": false,
1497
- "multiple": false,
1498
- "type": "option"
1499
- },
1500
- "paywall-id": {
1501
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1502
- "name": "paywall-id",
1503
- "hasDynamicHelp": false,
1504
- "multiple": false,
1505
- "type": "option"
1506
- },
1507
- "title": {
1508
- "description": "Placement title",
1509
- "name": "title",
1510
- "required": true,
1511
- "hasDynamicHelp": false,
1512
- "multiple": false,
1513
- "type": "option"
1514
- }
1515
- },
1516
- "hasDynamicHelp": false,
1517
- "hiddenAliases": [],
1518
- "id": "placements:create",
1519
- "pluginAlias": "adapty",
1520
- "pluginName": "adapty",
1521
- "pluginType": "core",
1522
- "strict": true,
1523
- "enableJsonFlag": true,
1524
- "isESM": true,
1525
- "relativePath": [
1526
- "dist",
1527
- "commands",
1528
- "placements",
1529
- "create.js"
1530
- ]
1531
- },
1532
- "placements:get": {
1533
- "aliases": [],
1534
- "args": {
1535
- "placement_id": {
1536
- "description": "Placement ID (UUID)",
1537
- "name": "placement_id",
1538
- "required": true
1539
- }
1540
- },
1541
- "description": "Get placement details",
1542
- "examples": [
1543
- "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1544
- ],
1545
- "flags": {
1546
- "json": {
1547
- "description": "Format output as json.",
1548
- "helpGroup": "GLOBAL",
1549
- "name": "json",
1550
- "allowNo": false,
1551
- "type": "boolean"
1552
- },
1553
- "app": {
1554
- "description": "App ID (UUID)",
1555
- "name": "app",
1556
- "required": true,
1557
- "hasDynamicHelp": false,
1558
- "multiple": false,
1559
- "type": "option"
1560
- }
1561
- },
1562
- "hasDynamicHelp": false,
1563
- "hiddenAliases": [],
1564
- "id": "placements:get",
1565
- "pluginAlias": "adapty",
1566
- "pluginName": "adapty",
1567
- "pluginType": "core",
1568
- "strict": true,
1569
- "enableJsonFlag": true,
1570
- "isESM": true,
1571
- "relativePath": [
1572
- "dist",
1573
- "commands",
1574
- "placements",
1575
- "get.js"
1576
- ]
1577
- },
1578
- "placements:list": {
1579
- "aliases": [],
1580
- "args": {},
1581
- "description": "List placements for an app",
1582
- "examples": [
1583
- "<%= config.bin %> placements list --app 550e8400-..."
1584
- ],
1585
- "flags": {
1586
- "json": {
1587
- "description": "Format output as json.",
1588
- "helpGroup": "GLOBAL",
1589
- "name": "json",
1590
- "allowNo": false,
1591
- "type": "boolean"
1592
- },
1593
- "app": {
1594
- "description": "App ID (UUID)",
1595
- "name": "app",
1596
- "required": true,
1597
- "hasDynamicHelp": false,
1598
- "multiple": false,
1599
- "type": "option"
1600
- },
1601
- "page": {
1602
- "description": "Page number",
1603
- "name": "page",
1604
- "default": 1,
1605
- "hasDynamicHelp": false,
1606
- "multiple": false,
1607
- "type": "option"
1608
- },
1609
- "page-size": {
1610
- "description": "Items per page (max 100)",
1611
- "name": "page-size",
1612
- "default": 20,
1613
- "hasDynamicHelp": false,
1614
- "multiple": false,
1615
- "type": "option"
1616
- }
1617
- },
1618
- "hasDynamicHelp": false,
1619
- "hiddenAliases": [],
1620
- "id": "placements:list",
1621
- "pluginAlias": "adapty",
1622
- "pluginName": "adapty",
1623
- "pluginType": "core",
1624
- "strict": true,
1625
- "enableJsonFlag": true,
1626
- "isESM": true,
1627
- "relativePath": [
1628
- "dist",
1629
- "commands",
1630
- "placements",
1631
- "list.js"
1632
- ]
1633
- },
1634
- "placements:update": {
1635
- "aliases": [],
1636
- "args": {
1637
- "placement_id": {
1638
- "description": "Placement ID (UUID)",
1639
- "name": "placement_id",
1640
- "required": true
1641
- }
1642
- },
1643
- "description": "Update a placement",
1644
- "examples": [
1645
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1646
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1647
- ],
1648
- "flags": {
1649
- "json": {
1650
- "description": "Format output as json.",
1651
- "helpGroup": "GLOBAL",
1652
- "name": "json",
1653
- "allowNo": false,
1654
- "type": "boolean"
1655
- },
1656
- "app": {
1657
- "description": "App ID (UUID)",
1658
- "name": "app",
1659
- "required": true,
1660
- "hasDynamicHelp": false,
1661
- "multiple": false,
1662
- "type": "option"
1663
- },
1664
- "audiences": {
1665
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1666
- "name": "audiences",
1667
- "hasDynamicHelp": false,
1668
- "multiple": false,
1669
- "type": "option"
1670
- },
1671
- "developer-id": {
1672
- "description": "Developer ID for the placement",
1673
- "name": "developer-id",
1674
- "required": true,
1675
- "hasDynamicHelp": false,
1676
- "multiple": false,
1677
- "type": "option"
1678
- },
1679
- "paywall-id": {
1680
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1681
- "name": "paywall-id",
1682
- "hasDynamicHelp": false,
1683
- "multiple": false,
1684
- "type": "option"
1685
- },
1686
- "title": {
1687
- "description": "Placement title",
1688
- "name": "title",
1689
- "required": true,
1690
- "hasDynamicHelp": false,
1691
- "multiple": false,
1692
- "type": "option"
1693
- }
1694
- },
1695
- "hasDynamicHelp": false,
1696
- "hiddenAliases": [],
1697
- "id": "placements:update",
1698
- "pluginAlias": "adapty",
1699
- "pluginName": "adapty",
1700
- "pluginType": "core",
1701
- "strict": true,
1702
- "enableJsonFlag": true,
1703
- "isESM": true,
1704
- "relativePath": [
1705
- "dist",
1706
- "commands",
1707
- "placements",
1708
- "update.js"
1709
- ]
1710
- },
1711
- "asa:ad-groups:create": {
1712
- "aliases": [],
1713
- "args": {},
1714
- "description": "Create an ad group inside a campaign",
1715
- "examples": [
1716
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1717
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM"
1718
- ],
1719
- "flags": {
1720
- "json": {
1721
- "description": "Format output as json.",
1722
- "helpGroup": "GLOBAL",
1723
- "name": "json",
1724
- "allowNo": false,
1725
- "type": "boolean"
1726
- },
1727
- "currency": {
1728
- "description": "Currency code for the amounts in this call",
1729
- "name": "currency",
1730
- "default": "USD",
1727
+ "currency": {
1728
+ "description": "Currency code for the amounts in this call",
1729
+ "name": "currency",
1730
+ "default": "USD",
1731
1731
  "hasDynamicHelp": false,
1732
1732
  "multiple": false,
1733
1733
  "type": "option"
@@ -2361,13 +2361,13 @@
2361
2361
  "update.js"
2362
2362
  ]
2363
2363
  },
2364
- "asa:apps:list": {
2364
+ "asa:automations:create": {
2365
2365
  "aliases": [],
2366
2366
  "args": {},
2367
- "description": "List the apps promoted by this company in Apple Search Ads",
2367
+ "description": "Create an automation rule from a JSON rule file",
2368
2368
  "examples": [
2369
- "<%= config.bin %> asa apps list",
2370
- "<%= config.bin %> asa apps list --page 2 --page-size 50"
2369
+ "<%= config.bin %> asa automations create --file rule.json",
2370
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
2371
2371
  ],
2372
2372
  "flags": {
2373
2373
  "json": {
@@ -2377,26 +2377,38 @@
2377
2377
  "allowNo": false,
2378
2378
  "type": "boolean"
2379
2379
  },
2380
- "page": {
2381
- "description": "Page number",
2382
- "name": "page",
2383
- "default": 1,
2380
+ "yes": {
2381
+ "char": "y",
2382
+ "description": "Apply without asking; required when the output is piped or --json is used",
2383
+ "name": "yes",
2384
+ "allowNo": false,
2385
+ "type": "boolean"
2386
+ },
2387
+ "idempotency-key": {
2388
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2389
+ "name": "idempotency-key",
2384
2390
  "hasDynamicHelp": false,
2385
2391
  "multiple": false,
2386
2392
  "type": "option"
2387
2393
  },
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,
2394
+ "file": {
2395
+ "description": "JSON file with the rule body, or - to read stdin",
2396
+ "name": "file",
2397
+ "required": true,
2392
2398
  "hasDynamicHelp": false,
2393
2399
  "multiple": false,
2394
2400
  "type": "option"
2401
+ },
2402
+ "run-now": {
2403
+ "description": "Queue the first run right after the rule is stored",
2404
+ "name": "run-now",
2405
+ "allowNo": false,
2406
+ "type": "boolean"
2395
2407
  }
2396
2408
  },
2397
2409
  "hasDynamicHelp": false,
2398
2410
  "hiddenAliases": [],
2399
- "id": "asa:apps:list",
2411
+ "id": "asa:automations:create",
2400
2412
  "pluginAlias": "adapty",
2401
2413
  "pluginName": "adapty",
2402
2414
  "pluginType": "core",
@@ -2407,17 +2419,22 @@
2407
2419
  "dist",
2408
2420
  "commands",
2409
2421
  "asa",
2410
- "apps",
2411
- "list.js"
2422
+ "automations",
2423
+ "create.js"
2412
2424
  ]
2413
2425
  },
2414
- "asa:creatives:list": {
2426
+ "asa:automations:get": {
2415
2427
  "aliases": [],
2416
- "args": {},
2417
- "description": "List creatives; creative_id is what `asa ads create` needs",
2428
+ "args": {
2429
+ "automation_id": {
2430
+ "description": "Automation rule ID (UUID)",
2431
+ "name": "automation_id",
2432
+ "required": true
2433
+ }
2434
+ },
2435
+ "description": "Show one automation rule with its conditions and actions",
2418
2436
  "examples": [
2419
- "<%= config.bin %> asa creatives list",
2420
- "<%= config.bin %> asa creatives list --app APP_UUID"
2437
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2421
2438
  ],
2422
2439
  "flags": {
2423
2440
  "json": {
@@ -2426,41 +2443,11 @@
2426
2443
  "name": "json",
2427
2444
  "allowNo": false,
2428
2445
  "type": "boolean"
2429
- },
2430
- "page": {
2431
- "description": "Page number",
2432
- "name": "page",
2433
- "default": 1,
2434
- "hasDynamicHelp": false,
2435
- "multiple": false,
2436
- "type": "option"
2437
- },
2438
- "page-size": {
2439
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2440
- "name": "page-size",
2441
- "default": 100,
2442
- "hasDynamicHelp": false,
2443
- "multiple": false,
2444
- "type": "option"
2445
- },
2446
- "app": {
2447
- "description": "Keep only rows in this app; repeatable",
2448
- "name": "app",
2449
- "hasDynamicHelp": false,
2450
- "multiple": true,
2451
- "type": "option"
2452
- },
2453
- "campaign-group": {
2454
- "description": "Keep only rows in this campaign group; repeatable",
2455
- "name": "campaign-group",
2456
- "hasDynamicHelp": false,
2457
- "multiple": true,
2458
- "type": "option"
2459
2446
  }
2460
2447
  },
2461
2448
  "hasDynamicHelp": false,
2462
2449
  "hiddenAliases": [],
2463
- "id": "asa:creatives:list",
2450
+ "id": "asa:automations:get",
2464
2451
  "pluginAlias": "adapty",
2465
2452
  "pluginName": "adapty",
2466
2453
  "pluginType": "core",
@@ -2471,16 +2458,16 @@
2471
2458
  "dist",
2472
2459
  "commands",
2473
2460
  "asa",
2474
- "creatives",
2475
- "list.js"
2461
+ "automations",
2462
+ "get.js"
2476
2463
  ]
2477
2464
  },
2478
- "asa:competitors:summary": {
2465
+ "asa:automations:list": {
2479
2466
  "aliases": [],
2480
2467
  "args": {},
2481
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2468
+ "description": "List automation rules; status 1 is active, 0 is stopped",
2482
2469
  "examples": [
2483
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2470
+ "<%= config.bin %> asa automations list"
2484
2471
  ],
2485
2472
  "flags": {
2486
2473
  "json": {
@@ -2490,10 +2477,18 @@
2490
2477
  "allowNo": false,
2491
2478
  "type": "boolean"
2492
2479
  },
2493
- "app-ids": {
2494
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2495
- "name": "app-ids",
2496
- "required": true,
2480
+ "page": {
2481
+ "description": "Page number",
2482
+ "name": "page",
2483
+ "default": 1,
2484
+ "hasDynamicHelp": false,
2485
+ "multiple": false,
2486
+ "type": "option"
2487
+ },
2488
+ "page-size": {
2489
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2490
+ "name": "page-size",
2491
+ "default": 100,
2497
2492
  "hasDynamicHelp": false,
2498
2493
  "multiple": false,
2499
2494
  "type": "option"
@@ -2501,7 +2496,7 @@
2501
2496
  },
2502
2497
  "hasDynamicHelp": false,
2503
2498
  "hiddenAliases": [],
2504
- "id": "asa:competitors:summary",
2499
+ "id": "asa:automations:list",
2505
2500
  "pluginAlias": "adapty",
2506
2501
  "pluginName": "adapty",
2507
2502
  "pluginType": "core",
@@ -2512,19 +2507,23 @@
2512
2507
  "dist",
2513
2508
  "commands",
2514
2509
  "asa",
2515
- "competitors",
2516
- "summary.js"
2510
+ "automations",
2511
+ "list.js"
2517
2512
  ]
2518
2513
  },
2519
- "asa:campaigns:bulk-create": {
2514
+ "asa:automations:run": {
2520
2515
  "aliases": [],
2521
- "args": {},
2522
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2516
+ "args": {
2517
+ "automation_id": {
2518
+ "description": "Automation rule ID (UUID)",
2519
+ "name": "automation_id",
2520
+ "required": true
2521
+ }
2522
+ },
2523
+ "description": "Run an automation rule now; the run is queued, not awaited",
2523
2524
  "examples": [
2524
- "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2525
- "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2526
- "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2527
- "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2525
+ "<%= config.bin %> asa automations run UUID",
2526
+ "<%= config.bin %> asa automations run UUID --dry-run"
2528
2527
  ],
2529
2528
  "flags": {
2530
2529
  "json": {
@@ -2548,59 +2547,16 @@
2548
2547
  "multiple": false,
2549
2548
  "type": "option"
2550
2549
  },
2551
- "file": {
2552
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2553
- "name": "file",
2554
- "hasDynamicHelp": false,
2555
- "multiple": false,
2556
- "type": "option"
2557
- },
2558
- "from-file": {
2559
- "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2560
- "name": "from-file",
2561
- "hasDynamicHelp": false,
2562
- "multiple": false,
2563
- "type": "option"
2564
- },
2565
- "org-id": {
2566
- "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2567
- "name": "org-id",
2568
- "hasDynamicHelp": false,
2569
- "multiple": false,
2570
- "type": "option"
2571
- },
2572
- "poll-interval": {
2573
- "description": "Seconds between progress polls",
2574
- "name": "poll-interval",
2575
- "default": 5,
2576
- "hasDynamicHelp": false,
2577
- "multiple": false,
2578
- "type": "option"
2579
- },
2580
- "preview": {
2581
- "description": "With --from-file: print the converted request and stop, nothing is created",
2582
- "name": "preview",
2550
+ "dry-run": {
2551
+ "description": "Evaluate and log the rule without touching Apple",
2552
+ "name": "dry-run",
2583
2553
  "allowNo": false,
2584
2554
  "type": "boolean"
2585
- },
2586
- "timeout": {
2587
- "description": "Max seconds to wait for the operation to finish",
2588
- "name": "timeout",
2589
- "default": 900,
2590
- "hasDynamicHelp": false,
2591
- "multiple": false,
2592
- "type": "option"
2593
- },
2594
- "wait": {
2595
- "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2596
- "name": "wait",
2597
- "allowNo": true,
2598
- "type": "boolean"
2599
2555
  }
2600
2556
  },
2601
2557
  "hasDynamicHelp": false,
2602
2558
  "hiddenAliases": [],
2603
- "id": "asa:campaigns:bulk-create",
2559
+ "id": "asa:automations:run",
2604
2560
  "pluginAlias": "adapty",
2605
2561
  "pluginName": "adapty",
2606
2562
  "pluginType": "core",
@@ -2611,22 +2567,22 @@
2611
2567
  "dist",
2612
2568
  "commands",
2613
2569
  "asa",
2614
- "campaigns",
2615
- "bulk-create.js"
2570
+ "automations",
2571
+ "run.js"
2616
2572
  ]
2617
2573
  },
2618
- "asa:campaigns:bulk-status": {
2574
+ "asa:automations:runs": {
2619
2575
  "aliases": [],
2620
2576
  "args": {
2621
- "operation-id": {
2622
- "description": "Bulk operation ID returned by bulk-create",
2623
- "name": "operation-id",
2577
+ "automation_id": {
2578
+ "description": "Automation rule ID (UUID)",
2579
+ "name": "automation_id",
2624
2580
  "required": true
2625
2581
  }
2626
2582
  },
2627
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2583
+ "description": "List past runs of an automation rule, including dry runs",
2628
2584
  "examples": [
2629
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2585
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2630
2586
  ],
2631
2587
  "flags": {
2632
2588
  "json": {
@@ -2655,7 +2611,7 @@
2655
2611
  },
2656
2612
  "hasDynamicHelp": false,
2657
2613
  "hiddenAliases": [],
2658
- "id": "asa:campaigns:bulk-status",
2614
+ "id": "asa:automations:runs",
2659
2615
  "pluginAlias": "adapty",
2660
2616
  "pluginName": "adapty",
2661
2617
  "pluginType": "core",
@@ -2666,16 +2622,23 @@
2666
2622
  "dist",
2667
2623
  "commands",
2668
2624
  "asa",
2669
- "campaigns",
2670
- "bulk-status.js"
2625
+ "automations",
2626
+ "runs.js"
2671
2627
  ]
2672
2628
  },
2673
- "asa:campaigns:create": {
2629
+ "asa:automations:update": {
2674
2630
  "aliases": [],
2675
- "args": {},
2676
- "description": "Create a campaign in Apple Search Ads",
2631
+ "args": {
2632
+ "automation_id": {
2633
+ "description": "Automation rule ID (UUID)",
2634
+ "name": "automation_id",
2635
+ "required": true
2636
+ }
2637
+ },
2638
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2677
2639
  "examples": [
2678
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2640
+ "<%= config.bin %> asa automations update UUID --stop",
2641
+ "<%= config.bin %> asa automations update UUID --file rule.json"
2679
2642
  ],
2680
2643
  "flags": {
2681
2644
  "json": {
@@ -2685,14 +2648,6 @@
2685
2648
  "allowNo": false,
2686
2649
  "type": "boolean"
2687
2650
  },
2688
- "currency": {
2689
- "description": "Currency code for the amounts in this call",
2690
- "name": "currency",
2691
- "default": "USD",
2692
- "hasDynamicHelp": false,
2693
- "multiple": false,
2694
- "type": "option"
2695
- },
2696
2651
  "yes": {
2697
2652
  "char": "y",
2698
2653
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2707,120 +2662,141 @@
2707
2662
  "multiple": false,
2708
2663
  "type": "option"
2709
2664
  },
2710
- "ad-channel-type": {
2711
- "description": "Ad channel type",
2712
- "name": "ad-channel-type",
2713
- "default": "SEARCH",
2714
- "hasDynamicHelp": false,
2715
- "multiple": false,
2716
- "options": [
2717
- "DISPLAY",
2718
- "SEARCH"
2719
- ],
2720
- "type": "option"
2721
- },
2722
- "adam-id": {
2723
- "description": "App Store app ID (adam_id)",
2724
- "name": "adam-id",
2725
- "required": true,
2665
+ "file": {
2666
+ "description": "JSON file with the parts to change, or - to read stdin",
2667
+ "name": "file",
2726
2668
  "hasDynamicHelp": false,
2727
2669
  "multiple": false,
2728
2670
  "type": "option"
2729
2671
  },
2730
- "bidding-strategy": {
2731
- "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2732
- "name": "bidding-strategy",
2672
+ "name": {
2673
+ "description": "Rule name",
2674
+ "name": "name",
2733
2675
  "hasDynamicHelp": false,
2734
2676
  "multiple": false,
2735
- "options": [
2736
- "MANUAL_CPT",
2737
- "MAX_CONVERSIONS"
2738
- ],
2739
2677
  "type": "option"
2740
2678
  },
2741
- "billing-event": {
2742
- "description": "Billing event",
2743
- "name": "billing-event",
2744
- "default": "TAPS",
2745
- "hasDynamicHelp": false,
2746
- "multiple": false,
2747
- "options": [
2748
- "IMPRESSIONS",
2749
- "TAPS"
2679
+ "start": {
2680
+ "description": "Activate the rule",
2681
+ "exclusive": [
2682
+ "stop"
2750
2683
  ],
2751
- "type": "option"
2684
+ "name": "start",
2685
+ "allowNo": false,
2686
+ "type": "boolean"
2752
2687
  },
2753
- "budget": {
2754
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2755
- "name": "budget",
2756
- "hasDynamicHelp": false,
2757
- "multiple": false,
2758
- "type": "option"
2688
+ "stop": {
2689
+ "description": "Stop the rule and clear its next run",
2690
+ "exclusive": [
2691
+ "start"
2692
+ ],
2693
+ "name": "stop",
2694
+ "allowNo": false,
2695
+ "type": "boolean"
2696
+ }
2697
+ },
2698
+ "hasDynamicHelp": false,
2699
+ "hiddenAliases": [],
2700
+ "id": "asa:automations:update",
2701
+ "pluginAlias": "adapty",
2702
+ "pluginName": "adapty",
2703
+ "pluginType": "core",
2704
+ "strict": true,
2705
+ "enableJsonFlag": true,
2706
+ "isESM": true,
2707
+ "relativePath": [
2708
+ "dist",
2709
+ "commands",
2710
+ "asa",
2711
+ "automations",
2712
+ "update.js"
2713
+ ]
2714
+ },
2715
+ "asa:campaigns:bulk-create": {
2716
+ "aliases": [],
2717
+ "args": {},
2718
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2719
+ "examples": [
2720
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2721
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2722
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2723
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2724
+ ],
2725
+ "flags": {
2726
+ "json": {
2727
+ "description": "Format output as json.",
2728
+ "helpGroup": "GLOBAL",
2729
+ "name": "json",
2730
+ "allowNo": false,
2731
+ "type": "boolean"
2759
2732
  },
2760
- "country": {
2761
- "description": "Country or region code, repeatable",
2762
- "name": "country",
2763
- "required": true,
2764
- "hasDynamicHelp": false,
2765
- "multiple": true,
2766
- "type": "option"
2733
+ "yes": {
2734
+ "char": "y",
2735
+ "description": "Apply without asking; required when the output is piped or --json is used",
2736
+ "name": "yes",
2737
+ "allowNo": false,
2738
+ "type": "boolean"
2767
2739
  },
2768
- "daily-budget": {
2769
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
2770
- "name": "daily-budget",
2771
- "required": true,
2740
+ "idempotency-key": {
2741
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2742
+ "name": "idempotency-key",
2772
2743
  "hasDynamicHelp": false,
2773
2744
  "multiple": false,
2774
2745
  "type": "option"
2775
2746
  },
2776
- "name": {
2777
- "description": "Campaign name",
2778
- "name": "name",
2779
- "required": true,
2747
+ "file": {
2748
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2749
+ "name": "file",
2780
2750
  "hasDynamicHelp": false,
2781
2751
  "multiple": false,
2782
2752
  "type": "option"
2783
2753
  },
2784
- "org": {
2785
- "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2786
- "name": "org",
2787
- "required": true,
2754
+ "from-file": {
2755
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2756
+ "name": "from-file",
2788
2757
  "hasDynamicHelp": false,
2789
2758
  "multiple": false,
2790
2759
  "type": "option"
2791
2760
  },
2792
- "status": {
2793
- "description": "Initial status",
2794
- "name": "status",
2761
+ "org-id": {
2762
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2763
+ "name": "org-id",
2795
2764
  "hasDynamicHelp": false,
2796
2765
  "multiple": false,
2797
- "options": [
2798
- "ENABLED",
2799
- "PAUSED"
2800
- ],
2801
2766
  "type": "option"
2802
2767
  },
2803
- "supply-source": {
2804
- "description": "Supply source, repeatable",
2805
- "name": "supply-source",
2806
- "default": [
2807
- "APPSTORE_SEARCH_RESULTS"
2808
- ],
2768
+ "poll-interval": {
2769
+ "description": "Seconds between progress polls",
2770
+ "name": "poll-interval",
2771
+ "default": 5,
2809
2772
  "hasDynamicHelp": false,
2810
- "multiple": true,
2773
+ "multiple": false,
2811
2774
  "type": "option"
2812
2775
  },
2813
- "target-cpa": {
2814
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
2815
- "name": "target-cpa",
2776
+ "preview": {
2777
+ "description": "With --from-file: print the converted request and stop, nothing is created",
2778
+ "name": "preview",
2779
+ "allowNo": false,
2780
+ "type": "boolean"
2781
+ },
2782
+ "timeout": {
2783
+ "description": "Max seconds to wait for the operation to finish",
2784
+ "name": "timeout",
2785
+ "default": 900,
2816
2786
  "hasDynamicHelp": false,
2817
2787
  "multiple": false,
2818
2788
  "type": "option"
2789
+ },
2790
+ "wait": {
2791
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2792
+ "name": "wait",
2793
+ "allowNo": true,
2794
+ "type": "boolean"
2819
2795
  }
2820
2796
  },
2821
2797
  "hasDynamicHelp": false,
2822
2798
  "hiddenAliases": [],
2823
- "id": "asa:campaigns:create",
2799
+ "id": "asa:campaigns:bulk-create",
2824
2800
  "pluginAlias": "adapty",
2825
2801
  "pluginName": "adapty",
2826
2802
  "pluginType": "core",
@@ -2832,55 +2808,21 @@
2832
2808
  "commands",
2833
2809
  "asa",
2834
2810
  "campaigns",
2835
- "create.js"
2811
+ "bulk-create.js"
2836
2812
  ]
2837
2813
  },
2838
- "asa:campaigns:get": {
2814
+ "asa:campaigns:bulk-status": {
2839
2815
  "aliases": [],
2840
2816
  "args": {
2841
- "campaign_id": {
2842
- "description": "Campaign ID (UUID)",
2843
- "name": "campaign_id",
2817
+ "operation-id": {
2818
+ "description": "Bulk operation ID returned by bulk-create",
2819
+ "name": "operation-id",
2844
2820
  "required": true
2845
2821
  }
2846
2822
  },
2847
- "description": "Show one campaign; read numbers with asa metrics",
2848
- "examples": [
2849
- "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
2850
- ],
2851
- "flags": {
2852
- "json": {
2853
- "description": "Format output as json.",
2854
- "helpGroup": "GLOBAL",
2855
- "name": "json",
2856
- "allowNo": false,
2857
- "type": "boolean"
2858
- }
2859
- },
2860
- "hasDynamicHelp": false,
2861
- "hiddenAliases": [],
2862
- "id": "asa:campaigns:get",
2863
- "pluginAlias": "adapty",
2864
- "pluginName": "adapty",
2865
- "pluginType": "core",
2866
- "strict": true,
2867
- "enableJsonFlag": true,
2868
- "isESM": true,
2869
- "relativePath": [
2870
- "dist",
2871
- "commands",
2872
- "asa",
2873
- "campaigns",
2874
- "get.js"
2875
- ]
2876
- },
2877
- "asa:campaigns:list": {
2878
- "aliases": [],
2879
- "args": {},
2880
- "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
2823
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2881
2824
  "examples": [
2882
- "<%= config.bin %> asa campaigns list",
2883
- "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
2825
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2884
2826
  ],
2885
2827
  "flags": {
2886
2828
  "json": {
@@ -2905,43 +2847,11 @@
2905
2847
  "hasDynamicHelp": false,
2906
2848
  "multiple": false,
2907
2849
  "type": "option"
2908
- },
2909
- "app": {
2910
- "description": "Keep only rows in this app; repeatable",
2911
- "name": "app",
2912
- "hasDynamicHelp": false,
2913
- "multiple": true,
2914
- "type": "option"
2915
- },
2916
- "campaign-group": {
2917
- "description": "Keep only rows in this campaign group; repeatable",
2918
- "name": "campaign-group",
2919
- "hasDynamicHelp": false,
2920
- "multiple": true,
2921
- "type": "option"
2922
- },
2923
- "search": {
2924
- "description": "Case-insensitive substring match on the name",
2925
- "name": "search",
2926
- "hasDynamicHelp": false,
2927
- "multiple": false,
2928
- "type": "option"
2929
- },
2930
- "status": {
2931
- "description": "Keep only rows in this state",
2932
- "name": "status",
2933
- "hasDynamicHelp": false,
2934
- "multiple": false,
2935
- "options": [
2936
- "ENABLED",
2937
- "PAUSED"
2938
- ],
2939
- "type": "option"
2940
2850
  }
2941
2851
  },
2942
2852
  "hasDynamicHelp": false,
2943
2853
  "hiddenAliases": [],
2944
- "id": "asa:campaigns:list",
2854
+ "id": "asa:campaigns:bulk-status",
2945
2855
  "pluginAlias": "adapty",
2946
2856
  "pluginName": "adapty",
2947
2857
  "pluginType": "core",
@@ -2953,22 +2863,15 @@
2953
2863
  "commands",
2954
2864
  "asa",
2955
2865
  "campaigns",
2956
- "list.js"
2866
+ "bulk-status.js"
2957
2867
  ]
2958
2868
  },
2959
- "asa:campaigns:update": {
2869
+ "asa:campaigns:create": {
2960
2870
  "aliases": [],
2961
- "args": {
2962
- "campaign_id": {
2963
- "description": "Campaign ID (UUID)",
2964
- "name": "campaign_id",
2965
- "required": true
2966
- }
2967
- },
2968
- "description": "Change a campaign: budgets, countries, status or schedule",
2871
+ "args": {},
2872
+ "description": "Create a campaign in Apple Search Ads",
2969
2873
  "examples": [
2970
- "<%= config.bin %> asa campaigns update UUID --status PAUSED",
2971
- "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
2874
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2972
2875
  ],
2973
2876
  "flags": {
2974
2877
  "json": {
@@ -3000,8 +2903,28 @@
3000
2903
  "multiple": false,
3001
2904
  "type": "option"
3002
2905
  },
2906
+ "ad-channel-type": {
2907
+ "description": "Ad channel type",
2908
+ "name": "ad-channel-type",
2909
+ "default": "SEARCH",
2910
+ "hasDynamicHelp": false,
2911
+ "multiple": false,
2912
+ "options": [
2913
+ "DISPLAY",
2914
+ "SEARCH"
2915
+ ],
2916
+ "type": "option"
2917
+ },
2918
+ "adam-id": {
2919
+ "description": "App Store app ID (adam_id)",
2920
+ "name": "adam-id",
2921
+ "required": true,
2922
+ "hasDynamicHelp": false,
2923
+ "multiple": false,
2924
+ "type": "option"
2925
+ },
3003
2926
  "bidding-strategy": {
3004
- "description": "Bidding strategy",
2927
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
3005
2928
  "name": "bidding-strategy",
3006
2929
  "hasDynamicHelp": false,
3007
2930
  "multiple": false,
@@ -3011,6 +2934,18 @@
3011
2934
  ],
3012
2935
  "type": "option"
3013
2936
  },
2937
+ "billing-event": {
2938
+ "description": "Billing event",
2939
+ "name": "billing-event",
2940
+ "default": "TAPS",
2941
+ "hasDynamicHelp": false,
2942
+ "multiple": false,
2943
+ "options": [
2944
+ "IMPRESSIONS",
2945
+ "TAPS"
2946
+ ],
2947
+ "type": "option"
2948
+ },
3014
2949
  "budget": {
3015
2950
  "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3016
2951
  "name": "budget",
@@ -3019,8 +2954,9 @@
3019
2954
  "type": "option"
3020
2955
  },
3021
2956
  "country": {
3022
- "description": "Replace the country list, repeatable",
2957
+ "description": "Country or region code, repeatable",
3023
2958
  "name": "country",
2959
+ "required": true,
3024
2960
  "hasDynamicHelp": false,
3025
2961
  "multiple": true,
3026
2962
  "type": "option"
@@ -3028,6 +2964,7 @@
3028
2964
  "daily-budget": {
3029
2965
  "description": "Daily budget (amount, e.g. 50 or 12.50)",
3030
2966
  "name": "daily-budget",
2967
+ "required": true,
3031
2968
  "hasDynamicHelp": false,
3032
2969
  "multiple": false,
3033
2970
  "type": "option"
@@ -3035,12 +2972,21 @@
3035
2972
  "name": {
3036
2973
  "description": "Campaign name",
3037
2974
  "name": "name",
2975
+ "required": true,
2976
+ "hasDynamicHelp": false,
2977
+ "multiple": false,
2978
+ "type": "option"
2979
+ },
2980
+ "org": {
2981
+ "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2982
+ "name": "org",
2983
+ "required": true,
3038
2984
  "hasDynamicHelp": false,
3039
2985
  "multiple": false,
3040
2986
  "type": "option"
3041
2987
  },
3042
2988
  "status": {
3043
- "description": "Campaign status",
2989
+ "description": "Initial status",
3044
2990
  "name": "status",
3045
2991
  "hasDynamicHelp": false,
3046
2992
  "multiple": false,
@@ -3050,6 +2996,16 @@
3050
2996
  ],
3051
2997
  "type": "option"
3052
2998
  },
2999
+ "supply-source": {
3000
+ "description": "Supply source, repeatable",
3001
+ "name": "supply-source",
3002
+ "default": [
3003
+ "APPSTORE_SEARCH_RESULTS"
3004
+ ],
3005
+ "hasDynamicHelp": false,
3006
+ "multiple": true,
3007
+ "type": "option"
3008
+ },
3053
3009
  "target-cpa": {
3054
3010
  "description": "Target CPA (amount, e.g. 50 or 12.50)",
3055
3011
  "name": "target-cpa",
@@ -3060,7 +3016,7 @@
3060
3016
  },
3061
3017
  "hasDynamicHelp": false,
3062
3018
  "hiddenAliases": [],
3063
- "id": "asa:campaigns:update",
3019
+ "id": "asa:campaigns:create",
3064
3020
  "pluginAlias": "adapty",
3065
3021
  "pluginName": "adapty",
3066
3022
  "pluginType": "core",
@@ -3072,16 +3028,21 @@
3072
3028
  "commands",
3073
3029
  "asa",
3074
3030
  "campaigns",
3075
- "update.js"
3031
+ "create.js"
3076
3032
  ]
3077
3033
  },
3078
- "asa:keywords:add": {
3034
+ "asa:campaigns:get": {
3079
3035
  "aliases": [],
3080
- "args": {},
3081
- "description": "Add targeting keywords to an ad group",
3036
+ "args": {
3037
+ "campaign_id": {
3038
+ "description": "Campaign ID (UUID)",
3039
+ "name": "campaign_id",
3040
+ "required": true
3041
+ }
3042
+ },
3043
+ "description": "Show one campaign; read numbers with asa metrics",
3082
3044
  "examples": [
3083
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3084
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3045
+ "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
3085
3046
  ],
3086
3047
  "flags": {
3087
3048
  "json": {
@@ -3090,86 +3051,11 @@
3090
3051
  "name": "json",
3091
3052
  "allowNo": false,
3092
3053
  "type": "boolean"
3093
- },
3094
- "currency": {
3095
- "description": "Currency code for the amounts in this call",
3096
- "name": "currency",
3097
- "default": "USD",
3098
- "hasDynamicHelp": false,
3099
- "multiple": false,
3100
- "type": "option"
3101
- },
3102
- "yes": {
3103
- "char": "y",
3104
- "description": "Apply without asking; required when the output is piped or --json is used",
3105
- "name": "yes",
3106
- "allowNo": false,
3107
- "type": "boolean"
3108
- },
3109
- "idempotency-key": {
3110
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3111
- "name": "idempotency-key",
3112
- "hasDynamicHelp": false,
3113
- "multiple": false,
3114
- "type": "option"
3115
- },
3116
- "ad-group": {
3117
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3118
- "name": "ad-group",
3119
- "required": true,
3120
- "hasDynamicHelp": false,
3121
- "multiple": false,
3122
- "type": "option"
3123
- },
3124
- "bid": {
3125
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3126
- "name": "bid",
3127
- "hasDynamicHelp": false,
3128
- "multiple": false,
3129
- "type": "option"
3130
- },
3131
- "from-file": {
3132
- "description": "File with one keyword per line, combined with any --text values",
3133
- "name": "from-file",
3134
- "hasDynamicHelp": false,
3135
- "multiple": false,
3136
- "type": "option"
3137
- },
3138
- "match-type": {
3139
- "description": "Match type",
3140
- "name": "match-type",
3141
- "default": "BROAD",
3142
- "hasDynamicHelp": false,
3143
- "multiple": false,
3144
- "options": [
3145
- "BROAD",
3146
- "EXACT"
3147
- ],
3148
- "type": "option"
3149
- },
3150
- "status": {
3151
- "description": "Keyword status",
3152
- "name": "status",
3153
- "default": "ACTIVE",
3154
- "hasDynamicHelp": false,
3155
- "multiple": false,
3156
- "options": [
3157
- "ACTIVE",
3158
- "PAUSED"
3159
- ],
3160
- "type": "option"
3161
- },
3162
- "text": {
3163
- "description": "Keyword text, repeatable",
3164
- "name": "text",
3165
- "hasDynamicHelp": false,
3166
- "multiple": true,
3167
- "type": "option"
3168
3054
  }
3169
3055
  },
3170
3056
  "hasDynamicHelp": false,
3171
3057
  "hiddenAliases": [],
3172
- "id": "asa:keywords:add",
3058
+ "id": "asa:campaigns:get",
3173
3059
  "pluginAlias": "adapty",
3174
3060
  "pluginName": "adapty",
3175
3061
  "pluginType": "core",
@@ -3180,17 +3066,17 @@
3180
3066
  "dist",
3181
3067
  "commands",
3182
3068
  "asa",
3183
- "keywords",
3184
- "add.js"
3069
+ "campaigns",
3070
+ "get.js"
3185
3071
  ]
3186
3072
  },
3187
- "asa:keywords:list": {
3073
+ "asa:campaigns:list": {
3188
3074
  "aliases": [],
3189
3075
  "args": {},
3190
- "description": "List targeting keywords; read numbers with asa metrics",
3076
+ "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
3191
3077
  "examples": [
3192
- "<%= config.bin %> asa keywords list",
3193
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3078
+ "<%= config.bin %> asa campaigns list",
3079
+ "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
3194
3080
  ],
3195
3081
  "flags": {
3196
3082
  "json": {
@@ -3237,27 +3123,13 @@
3237
3123
  "multiple": false,
3238
3124
  "type": "option"
3239
3125
  },
3240
- "campaign": {
3241
- "description": "Keep only rows in this campaign; repeatable",
3242
- "name": "campaign",
3243
- "hasDynamicHelp": false,
3244
- "multiple": true,
3245
- "type": "option"
3246
- },
3247
- "ad-group": {
3248
- "description": "Keep only rows in this ad group; repeatable",
3249
- "name": "ad-group",
3250
- "hasDynamicHelp": false,
3251
- "multiple": true,
3252
- "type": "option"
3253
- },
3254
3126
  "status": {
3255
3127
  "description": "Keep only rows in this state",
3256
3128
  "name": "status",
3257
3129
  "hasDynamicHelp": false,
3258
3130
  "multiple": false,
3259
3131
  "options": [
3260
- "ACTIVE",
3132
+ "ENABLED",
3261
3133
  "PAUSED"
3262
3134
  ],
3263
3135
  "type": "option"
@@ -3265,7 +3137,7 @@
3265
3137
  },
3266
3138
  "hasDynamicHelp": false,
3267
3139
  "hiddenAliases": [],
3268
- "id": "asa:keywords:list",
3140
+ "id": "asa:campaigns:list",
3269
3141
  "pluginAlias": "adapty",
3270
3142
  "pluginName": "adapty",
3271
3143
  "pluginType": "core",
@@ -3276,23 +3148,23 @@
3276
3148
  "dist",
3277
3149
  "commands",
3278
3150
  "asa",
3279
- "keywords",
3151
+ "campaigns",
3280
3152
  "list.js"
3281
3153
  ]
3282
3154
  },
3283
- "asa:keywords:update": {
3155
+ "asa:campaigns:update": {
3284
3156
  "aliases": [],
3285
3157
  "args": {
3286
- "keyword_id": {
3287
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3288
- "name": "keyword_id",
3158
+ "campaign_id": {
3159
+ "description": "Campaign ID (UUID)",
3160
+ "name": "campaign_id",
3289
3161
  "required": true
3290
3162
  }
3291
3163
  },
3292
- "description": "Change bid, status, text or match type of keywords",
3164
+ "description": "Change a campaign: budgets, countries, status or schedule",
3293
3165
  "examples": [
3294
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3295
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3166
+ "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3167
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
3296
3168
  ],
3297
3169
  "flags": {
3298
3170
  "json": {
@@ -3310,52 +3182,73 @@
3310
3182
  "multiple": false,
3311
3183
  "type": "option"
3312
3184
  },
3313
- "yes": {
3314
- "char": "y",
3315
- "description": "Apply without asking; required when the output is piped or --json is used",
3316
- "name": "yes",
3317
- "allowNo": false,
3318
- "type": "boolean"
3319
- },
3320
- "idempotency-key": {
3321
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3322
- "name": "idempotency-key",
3185
+ "yes": {
3186
+ "char": "y",
3187
+ "description": "Apply without asking; required when the output is piped or --json is used",
3188
+ "name": "yes",
3189
+ "allowNo": false,
3190
+ "type": "boolean"
3191
+ },
3192
+ "idempotency-key": {
3193
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3194
+ "name": "idempotency-key",
3195
+ "hasDynamicHelp": false,
3196
+ "multiple": false,
3197
+ "type": "option"
3198
+ },
3199
+ "bidding-strategy": {
3200
+ "description": "Bidding strategy",
3201
+ "name": "bidding-strategy",
3202
+ "hasDynamicHelp": false,
3203
+ "multiple": false,
3204
+ "options": [
3205
+ "MANUAL_CPT",
3206
+ "MAX_CONVERSIONS"
3207
+ ],
3208
+ "type": "option"
3209
+ },
3210
+ "budget": {
3211
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3212
+ "name": "budget",
3213
+ "hasDynamicHelp": false,
3214
+ "multiple": false,
3215
+ "type": "option"
3216
+ },
3217
+ "country": {
3218
+ "description": "Replace the country list, repeatable",
3219
+ "name": "country",
3323
3220
  "hasDynamicHelp": false,
3324
- "multiple": false,
3221
+ "multiple": true,
3325
3222
  "type": "option"
3326
3223
  },
3327
- "bid": {
3328
- "description": "Bid (amount, e.g. 50 or 12.50)",
3329
- "name": "bid",
3224
+ "daily-budget": {
3225
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
3226
+ "name": "daily-budget",
3330
3227
  "hasDynamicHelp": false,
3331
3228
  "multiple": false,
3332
3229
  "type": "option"
3333
3230
  },
3334
- "match-type": {
3335
- "description": "Match type",
3336
- "name": "match-type",
3231
+ "name": {
3232
+ "description": "Campaign name",
3233
+ "name": "name",
3337
3234
  "hasDynamicHelp": false,
3338
3235
  "multiple": false,
3339
- "options": [
3340
- "BROAD",
3341
- "EXACT"
3342
- ],
3343
3236
  "type": "option"
3344
3237
  },
3345
3238
  "status": {
3346
- "description": "Keyword status",
3239
+ "description": "Campaign status",
3347
3240
  "name": "status",
3348
3241
  "hasDynamicHelp": false,
3349
3242
  "multiple": false,
3350
3243
  "options": [
3351
- "ACTIVE",
3244
+ "ENABLED",
3352
3245
  "PAUSED"
3353
3246
  ],
3354
3247
  "type": "option"
3355
3248
  },
3356
- "text": {
3357
- "description": "Keyword text (only meaningful for a single keyword)",
3358
- "name": "text",
3249
+ "target-cpa": {
3250
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
3251
+ "name": "target-cpa",
3359
3252
  "hasDynamicHelp": false,
3360
3253
  "multiple": false,
3361
3254
  "type": "option"
@@ -3363,31 +3256,27 @@
3363
3256
  },
3364
3257
  "hasDynamicHelp": false,
3365
3258
  "hiddenAliases": [],
3366
- "id": "asa:keywords:update",
3259
+ "id": "asa:campaigns:update",
3367
3260
  "pluginAlias": "adapty",
3368
3261
  "pluginName": "adapty",
3369
3262
  "pluginType": "core",
3370
- "strict": false,
3263
+ "strict": true,
3371
3264
  "enableJsonFlag": true,
3372
3265
  "isESM": true,
3373
3266
  "relativePath": [
3374
3267
  "dist",
3375
3268
  "commands",
3376
3269
  "asa",
3377
- "keywords",
3270
+ "campaigns",
3378
3271
  "update.js"
3379
3272
  ]
3380
3273
  },
3381
- "asa:metrics": {
3274
+ "asa:competitors:summary": {
3382
3275
  "aliases": [],
3383
3276
  "args": {},
3384
- "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.",
3277
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3385
3278
  "examples": [
3386
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3387
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3388
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3389
- "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3390
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3279
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3391
3280
  ],
3392
3281
  "flags": {
3393
3282
  "json": {
@@ -3397,111 +3286,18 @@
3397
3286
  "allowNo": false,
3398
3287
  "type": "boolean"
3399
3288
  },
3400
- "page": {
3401
- "description": "Page number",
3402
- "name": "page",
3403
- "default": 1,
3404
- "hasDynamicHelp": false,
3405
- "multiple": false,
3406
- "type": "option"
3407
- },
3408
- "page-size": {
3409
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3410
- "name": "page-size",
3411
- "default": 100,
3412
- "hasDynamicHelp": false,
3413
- "multiple": false,
3414
- "type": "option"
3415
- },
3416
- "by-days": {
3417
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3418
- "name": "by-days",
3419
- "hasDynamicHelp": false,
3420
- "multiple": true,
3421
- "type": "option"
3422
- },
3423
- "date-from": {
3424
- "description": "Start of the period (YYYY-MM-DD)",
3425
- "name": "date-from",
3426
- "required": true,
3427
- "hasDynamicHelp": false,
3428
- "multiple": false,
3429
- "type": "option"
3430
- },
3431
- "date-to": {
3432
- "description": "End of the period (YYYY-MM-DD)",
3433
- "name": "date-to",
3434
- "required": true,
3435
- "hasDynamicHelp": false,
3436
- "multiple": false,
3437
- "type": "option"
3438
- },
3439
- "entity": {
3440
- "description": "What to report on",
3441
- "name": "entity",
3289
+ "app-ids": {
3290
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3291
+ "name": "app-ids",
3442
3292
  "required": true,
3443
3293
  "hasDynamicHelp": false,
3444
3294
  "multiple": false,
3445
- "options": [
3446
- "ad",
3447
- "ad-group",
3448
- "campaign",
3449
- "keyword"
3450
- ],
3451
- "type": "option"
3452
- },
3453
- "group-by": {
3454
- "description": "Break the rows down by a dimension, repeatable",
3455
- "name": "group-by",
3456
- "hasDynamicHelp": false,
3457
- "multiple": true,
3458
- "options": [
3459
- "country",
3460
- "day",
3461
- "month",
3462
- "quarter",
3463
- "week",
3464
- "year"
3465
- ],
3466
- "type": "option"
3467
- },
3468
- "metric": {
3469
- "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3470
- "name": "metric",
3471
- "hasDynamicHelp": false,
3472
- "multiple": true,
3473
- "type": "option"
3474
- },
3475
- "order": {
3476
- "description": "Sort direction",
3477
- "name": "order",
3478
- "default": "desc",
3479
- "hasDynamicHelp": false,
3480
- "multiple": false,
3481
- "options": [
3482
- "asc",
3483
- "desc"
3484
- ],
3485
- "type": "option"
3486
- },
3487
- "order-by": {
3488
- "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3489
- "name": "order-by",
3490
- "hasDynamicHelp": false,
3491
- "multiple": false,
3492
- "type": "option"
3493
- },
3494
- "order-by-day": {
3495
- "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3496
- "name": "order-by-day",
3497
- "hasDynamicHelp": false,
3498
- "multiple": false,
3499
3295
  "type": "option"
3500
3296
  }
3501
3297
  },
3502
3298
  "hasDynamicHelp": false,
3503
3299
  "hiddenAliases": [],
3504
- "id": "asa:metrics",
3300
+ "id": "asa:competitors:summary",
3505
3301
  "pluginAlias": "adapty",
3506
3302
  "pluginName": "adapty",
3507
3303
  "pluginType": "core",
@@ -3512,17 +3308,17 @@
3512
3308
  "dist",
3513
3309
  "commands",
3514
3310
  "asa",
3515
- "metrics",
3516
- "index.js"
3311
+ "competitors",
3312
+ "summary.js"
3517
3313
  ]
3518
3314
  },
3519
- "asa:metrics:overview": {
3315
+ "asa:creatives:list": {
3520
3316
  "aliases": [],
3521
3317
  "args": {},
3522
- "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.",
3318
+ "description": "List creatives; creative_id is what `asa ads create` needs",
3523
3319
  "examples": [
3524
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3525
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3320
+ "<%= config.bin %> asa creatives list",
3321
+ "<%= config.bin %> asa creatives list --app APP_UUID"
3526
3322
  ],
3527
3323
  "flags": {
3528
3324
  "json": {
@@ -3532,69 +3328,40 @@
3532
3328
  "allowNo": false,
3533
3329
  "type": "boolean"
3534
3330
  },
3535
- "by-days": {
3536
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3537
- "name": "by-days",
3538
- "hasDynamicHelp": false,
3539
- "multiple": true,
3540
- "type": "option"
3541
- },
3542
- "date-from": {
3543
- "description": "Start of the period (YYYY-MM-DD)",
3544
- "name": "date-from",
3545
- "required": true,
3546
- "hasDynamicHelp": false,
3547
- "multiple": false,
3548
- "type": "option"
3549
- },
3550
- "date-to": {
3551
- "description": "End of the period (YYYY-MM-DD)",
3552
- "name": "date-to",
3553
- "required": true,
3331
+ "page": {
3332
+ "description": "Page number",
3333
+ "name": "page",
3334
+ "default": 1,
3554
3335
  "hasDynamicHelp": false,
3555
3336
  "multiple": false,
3556
3337
  "type": "option"
3557
3338
  },
3558
- "entity": {
3559
- "description": "What to report on",
3560
- "name": "entity",
3561
- "required": true,
3339
+ "page-size": {
3340
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3341
+ "name": "page-size",
3342
+ "default": 100,
3562
3343
  "hasDynamicHelp": false,
3563
3344
  "multiple": false,
3564
- "options": [
3565
- "ad",
3566
- "ad-group",
3567
- "campaign",
3568
- "keyword"
3569
- ],
3570
3345
  "type": "option"
3571
3346
  },
3572
- "metric": {
3573
- "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3574
- "name": "metric",
3347
+ "app": {
3348
+ "description": "Keep only rows in this app; repeatable",
3349
+ "name": "app",
3575
3350
  "hasDynamicHelp": false,
3576
3351
  "multiple": true,
3577
3352
  "type": "option"
3578
3353
  },
3579
- "period-unit": {
3580
- "description": "Bucket size",
3581
- "name": "period-unit",
3582
- "default": "day",
3354
+ "campaign-group": {
3355
+ "description": "Keep only rows in this campaign group; repeatable",
3356
+ "name": "campaign-group",
3583
3357
  "hasDynamicHelp": false,
3584
- "multiple": false,
3585
- "options": [
3586
- "day",
3587
- "month",
3588
- "quarter",
3589
- "week",
3590
- "year"
3591
- ],
3358
+ "multiple": true,
3592
3359
  "type": "option"
3593
3360
  }
3594
3361
  },
3595
3362
  "hasDynamicHelp": false,
3596
3363
  "hiddenAliases": [],
3597
- "id": "asa:metrics:overview",
3364
+ "id": "asa:creatives:list",
3598
3365
  "pluginAlias": "adapty",
3599
3366
  "pluginName": "adapty",
3600
3367
  "pluginType": "core",
@@ -3605,18 +3372,17 @@
3605
3372
  "dist",
3606
3373
  "commands",
3607
3374
  "asa",
3608
- "metrics",
3609
- "overview.js"
3375
+ "creatives",
3376
+ "list.js"
3610
3377
  ]
3611
3378
  },
3612
- "asa:negative-keywords:add": {
3379
+ "asa:keywords:add": {
3613
3380
  "aliases": [],
3614
3381
  "args": {},
3615
- "description": "Add negative keywords to an ad group or across a campaign",
3382
+ "description": "Add targeting keywords to an ad group",
3616
3383
  "examples": [
3617
- "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3618
- "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3619
- "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3384
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3385
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3620
3386
  ],
3621
3387
  "flags": {
3622
3388
  "json": {
@@ -3626,6 +3392,14 @@
3626
3392
  "allowNo": false,
3627
3393
  "type": "boolean"
3628
3394
  },
3395
+ "currency": {
3396
+ "description": "Currency code for the amounts in this call",
3397
+ "name": "currency",
3398
+ "default": "USD",
3399
+ "hasDynamicHelp": false,
3400
+ "multiple": false,
3401
+ "type": "option"
3402
+ },
3629
3403
  "yes": {
3630
3404
  "char": "y",
3631
3405
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3641,30 +3415,23 @@
3641
3415
  "type": "option"
3642
3416
  },
3643
3417
  "ad-group": {
3644
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3645
- "exclusive": [
3646
- "campaign"
3647
- ],
3418
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3648
3419
  "name": "ad-group",
3420
+ "required": true,
3649
3421
  "hasDynamicHelp": false,
3650
3422
  "multiple": false,
3651
3423
  "type": "option"
3652
3424
  },
3653
- "all-ad-groups": {
3654
- "dependsOn": [
3655
- "campaign"
3656
- ],
3657
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
3658
- "name": "all-ad-groups",
3659
- "allowNo": false,
3660
- "type": "boolean"
3425
+ "bid": {
3426
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3427
+ "name": "bid",
3428
+ "hasDynamicHelp": false,
3429
+ "multiple": false,
3430
+ "type": "option"
3661
3431
  },
3662
- "campaign": {
3663
- "description": "Campaign ID (UUID)",
3664
- "exclusive": [
3665
- "ad-group"
3666
- ],
3667
- "name": "campaign",
3432
+ "from-file": {
3433
+ "description": "File with one keyword per line, combined with any --text values",
3434
+ "name": "from-file",
3668
3435
  "hasDynamicHelp": false,
3669
3436
  "multiple": false,
3670
3437
  "type": "option"
@@ -3672,7 +3439,7 @@
3672
3439
  "match-type": {
3673
3440
  "description": "Match type",
3674
3441
  "name": "match-type",
3675
- "default": "EXACT",
3442
+ "default": "BROAD",
3676
3443
  "hasDynamicHelp": false,
3677
3444
  "multiple": false,
3678
3445
  "options": [
@@ -3696,7 +3463,6 @@
3696
3463
  "text": {
3697
3464
  "description": "Keyword text, repeatable",
3698
3465
  "name": "text",
3699
- "required": true,
3700
3466
  "hasDynamicHelp": false,
3701
3467
  "multiple": true,
3702
3468
  "type": "option"
@@ -3704,7 +3470,7 @@
3704
3470
  },
3705
3471
  "hasDynamicHelp": false,
3706
3472
  "hiddenAliases": [],
3707
- "id": "asa:negative-keywords:add",
3473
+ "id": "asa:keywords:add",
3708
3474
  "pluginAlias": "adapty",
3709
3475
  "pluginName": "adapty",
3710
3476
  "pluginType": "core",
@@ -3715,17 +3481,17 @@
3715
3481
  "dist",
3716
3482
  "commands",
3717
3483
  "asa",
3718
- "negative-keywords",
3484
+ "keywords",
3719
3485
  "add.js"
3720
3486
  ]
3721
3487
  },
3722
- "asa:negative-keywords:list": {
3488
+ "asa:keywords:list": {
3723
3489
  "aliases": [],
3724
3490
  "args": {},
3725
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3491
+ "description": "List targeting keywords; read numbers with asa metrics",
3726
3492
  "examples": [
3727
- "<%= config.bin %> asa negative-keywords list",
3728
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3493
+ "<%= config.bin %> asa keywords list",
3494
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3729
3495
  ],
3730
3496
  "flags": {
3731
3497
  "json": {
@@ -3786,16 +3552,21 @@
3786
3552
  "multiple": true,
3787
3553
  "type": "option"
3788
3554
  },
3789
- "campaign-level-only": {
3790
- "description": "Keep only campaign-level rows (ad_group_id is null)",
3791
- "name": "campaign-level-only",
3792
- "allowNo": false,
3793
- "type": "boolean"
3555
+ "status": {
3556
+ "description": "Keep only rows in this state",
3557
+ "name": "status",
3558
+ "hasDynamicHelp": false,
3559
+ "multiple": false,
3560
+ "options": [
3561
+ "ACTIVE",
3562
+ "PAUSED"
3563
+ ],
3564
+ "type": "option"
3794
3565
  }
3795
3566
  },
3796
3567
  "hasDynamicHelp": false,
3797
3568
  "hiddenAliases": [],
3798
- "id": "asa:negative-keywords:list",
3569
+ "id": "asa:keywords:list",
3799
3570
  "pluginAlias": "adapty",
3800
3571
  "pluginName": "adapty",
3801
3572
  "pluginType": "core",
@@ -3806,16 +3577,118 @@
3806
3577
  "dist",
3807
3578
  "commands",
3808
3579
  "asa",
3809
- "negative-keywords",
3580
+ "keywords",
3810
3581
  "list.js"
3811
3582
  ]
3812
3583
  },
3813
- "asa:orgs:list": {
3584
+ "asa:keywords:update": {
3585
+ "aliases": [],
3586
+ "args": {
3587
+ "keyword_id": {
3588
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3589
+ "name": "keyword_id",
3590
+ "required": true
3591
+ }
3592
+ },
3593
+ "description": "Change bid, status, text or match type of keywords",
3594
+ "examples": [
3595
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3596
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3597
+ ],
3598
+ "flags": {
3599
+ "json": {
3600
+ "description": "Format output as json.",
3601
+ "helpGroup": "GLOBAL",
3602
+ "name": "json",
3603
+ "allowNo": false,
3604
+ "type": "boolean"
3605
+ },
3606
+ "currency": {
3607
+ "description": "Currency code for the amounts in this call",
3608
+ "name": "currency",
3609
+ "default": "USD",
3610
+ "hasDynamicHelp": false,
3611
+ "multiple": false,
3612
+ "type": "option"
3613
+ },
3614
+ "yes": {
3615
+ "char": "y",
3616
+ "description": "Apply without asking; required when the output is piped or --json is used",
3617
+ "name": "yes",
3618
+ "allowNo": false,
3619
+ "type": "boolean"
3620
+ },
3621
+ "idempotency-key": {
3622
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3623
+ "name": "idempotency-key",
3624
+ "hasDynamicHelp": false,
3625
+ "multiple": false,
3626
+ "type": "option"
3627
+ },
3628
+ "bid": {
3629
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3630
+ "name": "bid",
3631
+ "hasDynamicHelp": false,
3632
+ "multiple": false,
3633
+ "type": "option"
3634
+ },
3635
+ "match-type": {
3636
+ "description": "Match type",
3637
+ "name": "match-type",
3638
+ "hasDynamicHelp": false,
3639
+ "multiple": false,
3640
+ "options": [
3641
+ "BROAD",
3642
+ "EXACT"
3643
+ ],
3644
+ "type": "option"
3645
+ },
3646
+ "status": {
3647
+ "description": "Keyword status",
3648
+ "name": "status",
3649
+ "hasDynamicHelp": false,
3650
+ "multiple": false,
3651
+ "options": [
3652
+ "ACTIVE",
3653
+ "PAUSED"
3654
+ ],
3655
+ "type": "option"
3656
+ },
3657
+ "text": {
3658
+ "description": "Keyword text (only meaningful for a single keyword)",
3659
+ "name": "text",
3660
+ "hasDynamicHelp": false,
3661
+ "multiple": false,
3662
+ "type": "option"
3663
+ }
3664
+ },
3665
+ "hasDynamicHelp": false,
3666
+ "hiddenAliases": [],
3667
+ "id": "asa:keywords:update",
3668
+ "pluginAlias": "adapty",
3669
+ "pluginName": "adapty",
3670
+ "pluginType": "core",
3671
+ "strict": false,
3672
+ "enableJsonFlag": true,
3673
+ "isESM": true,
3674
+ "relativePath": [
3675
+ "dist",
3676
+ "commands",
3677
+ "asa",
3678
+ "keywords",
3679
+ "update.js"
3680
+ ]
3681
+ },
3682
+ "asa:metrics": {
3814
3683
  "aliases": [],
3815
3684
  "args": {},
3816
- "description": "List the Apple Search Ads organizations this company can spend from",
3685
+ "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3817
3686
  "examples": [
3818
- "<%= config.bin %> asa orgs list"
3687
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3688
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3689
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3690
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3691
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3819
3692
  ],
3820
3693
  "flags": {
3821
3694
  "json": {
@@ -3840,11 +3713,96 @@
3840
3713
  "hasDynamicHelp": false,
3841
3714
  "multiple": false,
3842
3715
  "type": "option"
3716
+ },
3717
+ "by-days": {
3718
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3719
+ "name": "by-days",
3720
+ "hasDynamicHelp": false,
3721
+ "multiple": true,
3722
+ "type": "option"
3723
+ },
3724
+ "date-from": {
3725
+ "description": "Start of the period (YYYY-MM-DD)",
3726
+ "name": "date-from",
3727
+ "required": true,
3728
+ "hasDynamicHelp": false,
3729
+ "multiple": false,
3730
+ "type": "option"
3731
+ },
3732
+ "date-to": {
3733
+ "description": "End of the period (YYYY-MM-DD)",
3734
+ "name": "date-to",
3735
+ "required": true,
3736
+ "hasDynamicHelp": false,
3737
+ "multiple": false,
3738
+ "type": "option"
3739
+ },
3740
+ "entity": {
3741
+ "description": "What to report on",
3742
+ "name": "entity",
3743
+ "required": true,
3744
+ "hasDynamicHelp": false,
3745
+ "multiple": false,
3746
+ "options": [
3747
+ "ad",
3748
+ "ad-group",
3749
+ "campaign",
3750
+ "keyword"
3751
+ ],
3752
+ "type": "option"
3753
+ },
3754
+ "group-by": {
3755
+ "description": "Break the rows down by a dimension, repeatable",
3756
+ "name": "group-by",
3757
+ "hasDynamicHelp": false,
3758
+ "multiple": true,
3759
+ "options": [
3760
+ "country",
3761
+ "day",
3762
+ "month",
3763
+ "quarter",
3764
+ "week",
3765
+ "year"
3766
+ ],
3767
+ "type": "option"
3768
+ },
3769
+ "metric": {
3770
+ "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3771
+ "name": "metric",
3772
+ "hasDynamicHelp": false,
3773
+ "multiple": true,
3774
+ "type": "option"
3775
+ },
3776
+ "order": {
3777
+ "description": "Sort direction",
3778
+ "name": "order",
3779
+ "default": "desc",
3780
+ "hasDynamicHelp": false,
3781
+ "multiple": false,
3782
+ "options": [
3783
+ "asc",
3784
+ "desc"
3785
+ ],
3786
+ "type": "option"
3787
+ },
3788
+ "order-by": {
3789
+ "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3790
+ "name": "order-by",
3791
+ "hasDynamicHelp": false,
3792
+ "multiple": false,
3793
+ "type": "option"
3794
+ },
3795
+ "order-by-day": {
3796
+ "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3797
+ "name": "order-by-day",
3798
+ "hasDynamicHelp": false,
3799
+ "multiple": false,
3800
+ "type": "option"
3843
3801
  }
3844
3802
  },
3845
3803
  "hasDynamicHelp": false,
3846
3804
  "hiddenAliases": [],
3847
- "id": "asa:orgs:list",
3805
+ "id": "asa:metrics",
3848
3806
  "pluginAlias": "adapty",
3849
3807
  "pluginName": "adapty",
3850
3808
  "pluginType": "core",
@@ -3855,17 +3813,17 @@
3855
3813
  "dist",
3856
3814
  "commands",
3857
3815
  "asa",
3858
- "orgs",
3859
- "list.js"
3816
+ "metrics",
3817
+ "index.js"
3860
3818
  ]
3861
3819
  },
3862
- "asa:product-pages:list": {
3820
+ "asa:metrics:overview": {
3863
3821
  "aliases": [],
3864
3822
  "args": {},
3865
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
3823
+ "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
3866
3824
  "examples": [
3867
- "<%= config.bin %> asa product-pages list",
3868
- "<%= config.bin %> asa product-pages list --app APP_UUID"
3825
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3826
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3869
3827
  ],
3870
3828
  "flags": {
3871
3829
  "json": {
@@ -3875,40 +3833,69 @@
3875
3833
  "allowNo": false,
3876
3834
  "type": "boolean"
3877
3835
  },
3878
- "page": {
3879
- "description": "Page number",
3880
- "name": "page",
3881
- "default": 1,
3836
+ "by-days": {
3837
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3838
+ "name": "by-days",
3839
+ "hasDynamicHelp": false,
3840
+ "multiple": true,
3841
+ "type": "option"
3842
+ },
3843
+ "date-from": {
3844
+ "description": "Start of the period (YYYY-MM-DD)",
3845
+ "name": "date-from",
3846
+ "required": true,
3882
3847
  "hasDynamicHelp": false,
3883
3848
  "multiple": false,
3884
3849
  "type": "option"
3885
3850
  },
3886
- "page-size": {
3887
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3888
- "name": "page-size",
3889
- "default": 100,
3851
+ "date-to": {
3852
+ "description": "End of the period (YYYY-MM-DD)",
3853
+ "name": "date-to",
3854
+ "required": true,
3890
3855
  "hasDynamicHelp": false,
3891
3856
  "multiple": false,
3892
3857
  "type": "option"
3893
3858
  },
3894
- "app": {
3895
- "description": "Keep only rows in this app; repeatable",
3896
- "name": "app",
3859
+ "entity": {
3860
+ "description": "What to report on",
3861
+ "name": "entity",
3862
+ "required": true,
3897
3863
  "hasDynamicHelp": false,
3898
- "multiple": true,
3864
+ "multiple": false,
3865
+ "options": [
3866
+ "ad",
3867
+ "ad-group",
3868
+ "campaign",
3869
+ "keyword"
3870
+ ],
3899
3871
  "type": "option"
3900
3872
  },
3901
- "campaign-group": {
3902
- "description": "Keep only rows in this campaign group; repeatable",
3903
- "name": "campaign-group",
3873
+ "metric": {
3874
+ "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3875
+ "name": "metric",
3904
3876
  "hasDynamicHelp": false,
3905
3877
  "multiple": true,
3906
3878
  "type": "option"
3879
+ },
3880
+ "period-unit": {
3881
+ "description": "Bucket size",
3882
+ "name": "period-unit",
3883
+ "default": "day",
3884
+ "hasDynamicHelp": false,
3885
+ "multiple": false,
3886
+ "options": [
3887
+ "day",
3888
+ "month",
3889
+ "quarter",
3890
+ "week",
3891
+ "year"
3892
+ ],
3893
+ "type": "option"
3907
3894
  }
3908
3895
  },
3909
3896
  "hasDynamicHelp": false,
3910
3897
  "hiddenAliases": [],
3911
- "id": "asa:product-pages:list",
3898
+ "id": "asa:metrics:overview",
3912
3899
  "pluginAlias": "adapty",
3913
3900
  "pluginName": "adapty",
3914
3901
  "pluginType": "core",
@@ -3919,17 +3906,18 @@
3919
3906
  "dist",
3920
3907
  "commands",
3921
3908
  "asa",
3922
- "product-pages",
3923
- "list.js"
3909
+ "metrics",
3910
+ "overview.js"
3924
3911
  ]
3925
3912
  },
3926
- "asa:product-pages:sync": {
3913
+ "asa:negative-keywords:add": {
3927
3914
  "aliases": [],
3928
3915
  "args": {},
3929
- "description": "Refresh custom product pages from Apple",
3916
+ "description": "Add negative keywords to an ad group or across a campaign",
3930
3917
  "examples": [
3931
- "<%= config.bin %> asa product-pages sync",
3932
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
3918
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3919
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3920
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3933
3921
  ],
3934
3922
  "flags": {
3935
3923
  "json": {
@@ -3953,17 +3941,71 @@
3953
3941
  "multiple": false,
3954
3942
  "type": "option"
3955
3943
  },
3956
- "adam-id": {
3957
- "description": "Limit the refresh to one app; omit to cover every app",
3958
- "name": "adam-id",
3944
+ "ad-group": {
3945
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3946
+ "exclusive": [
3947
+ "campaign"
3948
+ ],
3949
+ "name": "ad-group",
3950
+ "hasDynamicHelp": false,
3951
+ "multiple": false,
3952
+ "type": "option"
3953
+ },
3954
+ "all-ad-groups": {
3955
+ "dependsOn": [
3956
+ "campaign"
3957
+ ],
3958
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
3959
+ "name": "all-ad-groups",
3960
+ "allowNo": false,
3961
+ "type": "boolean"
3962
+ },
3963
+ "campaign": {
3964
+ "description": "Campaign ID (UUID)",
3965
+ "exclusive": [
3966
+ "ad-group"
3967
+ ],
3968
+ "name": "campaign",
3969
+ "hasDynamicHelp": false,
3970
+ "multiple": false,
3971
+ "type": "option"
3972
+ },
3973
+ "match-type": {
3974
+ "description": "Match type",
3975
+ "name": "match-type",
3976
+ "default": "EXACT",
3977
+ "hasDynamicHelp": false,
3978
+ "multiple": false,
3979
+ "options": [
3980
+ "BROAD",
3981
+ "EXACT"
3982
+ ],
3983
+ "type": "option"
3984
+ },
3985
+ "status": {
3986
+ "description": "Keyword status",
3987
+ "name": "status",
3988
+ "default": "ACTIVE",
3959
3989
  "hasDynamicHelp": false,
3960
3990
  "multiple": false,
3991
+ "options": [
3992
+ "ACTIVE",
3993
+ "PAUSED"
3994
+ ],
3995
+ "type": "option"
3996
+ },
3997
+ "text": {
3998
+ "description": "Keyword text, repeatable",
3999
+ "name": "text",
4000
+ "required": true,
4001
+ "hasDynamicHelp": false,
4002
+ "multiple": true,
3961
4003
  "type": "option"
3962
4004
  }
3963
4005
  },
3964
4006
  "hasDynamicHelp": false,
3965
4007
  "hiddenAliases": [],
3966
- "id": "asa:product-pages:sync",
4008
+ "id": "asa:negative-keywords:add",
3967
4009
  "pluginAlias": "adapty",
3968
4010
  "pluginName": "adapty",
3969
4011
  "pluginType": "core",
@@ -3974,17 +4016,17 @@
3974
4016
  "dist",
3975
4017
  "commands",
3976
4018
  "asa",
3977
- "product-pages",
3978
- "sync.js"
4019
+ "negative-keywords",
4020
+ "add.js"
3979
4021
  ]
3980
4022
  },
3981
- "asa:search-terms:list": {
4023
+ "asa:negative-keywords:list": {
3982
4024
  "aliases": [],
3983
4025
  "args": {},
3984
- "description": "List the search terms your ads matched, with their metrics",
4026
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3985
4027
  "examples": [
3986
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
3987
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4028
+ "<%= config.bin %> asa negative-keywords list",
4029
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3988
4030
  ],
3989
4031
  "flags": {
3990
4032
  "json": {
@@ -4010,20 +4052,6 @@
4010
4052
  "multiple": false,
4011
4053
  "type": "option"
4012
4054
  },
4013
- "date-from": {
4014
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4015
- "name": "date-from",
4016
- "hasDynamicHelp": false,
4017
- "multiple": false,
4018
- "type": "option"
4019
- },
4020
- "date-to": {
4021
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4022
- "name": "date-to",
4023
- "hasDynamicHelp": false,
4024
- "multiple": false,
4025
- "type": "option"
4026
- },
4027
4055
  "app": {
4028
4056
  "description": "Keep only rows in this app; repeatable",
4029
4057
  "name": "app",
@@ -4058,73 +4086,17 @@
4058
4086
  "hasDynamicHelp": false,
4059
4087
  "multiple": true,
4060
4088
  "type": "option"
4061
- }
4062
- },
4063
- "hasDynamicHelp": false,
4064
- "hiddenAliases": [],
4065
- "id": "asa:search-terms:list",
4066
- "pluginAlias": "adapty",
4067
- "pluginName": "adapty",
4068
- "pluginType": "core",
4069
- "strict": true,
4070
- "enableJsonFlag": true,
4071
- "isESM": true,
4072
- "relativePath": [
4073
- "dist",
4074
- "commands",
4075
- "asa",
4076
- "search-terms",
4077
- "list.js"
4078
- ]
4079
- },
4080
- "asa:automations:create": {
4081
- "aliases": [],
4082
- "args": {},
4083
- "description": "Create an automation rule from a JSON rule file",
4084
- "examples": [
4085
- "<%= config.bin %> asa automations create --file rule.json",
4086
- "<%= config.bin %> asa automations create --file rule.json --run-now"
4087
- ],
4088
- "flags": {
4089
- "json": {
4090
- "description": "Format output as json.",
4091
- "helpGroup": "GLOBAL",
4092
- "name": "json",
4093
- "allowNo": false,
4094
- "type": "boolean"
4095
- },
4096
- "yes": {
4097
- "char": "y",
4098
- "description": "Apply without asking; required when the output is piped or --json is used",
4099
- "name": "yes",
4100
- "allowNo": false,
4101
- "type": "boolean"
4102
- },
4103
- "idempotency-key": {
4104
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4105
- "name": "idempotency-key",
4106
- "hasDynamicHelp": false,
4107
- "multiple": false,
4108
- "type": "option"
4109
- },
4110
- "file": {
4111
- "description": "JSON file with the rule body, or - to read stdin",
4112
- "name": "file",
4113
- "required": true,
4114
- "hasDynamicHelp": false,
4115
- "multiple": false,
4116
- "type": "option"
4117
4089
  },
4118
- "run-now": {
4119
- "description": "Queue the first run right after the rule is stored",
4120
- "name": "run-now",
4090
+ "campaign-level-only": {
4091
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
4092
+ "name": "campaign-level-only",
4121
4093
  "allowNo": false,
4122
4094
  "type": "boolean"
4123
4095
  }
4124
4096
  },
4125
4097
  "hasDynamicHelp": false,
4126
4098
  "hiddenAliases": [],
4127
- "id": "asa:automations:create",
4099
+ "id": "asa:negative-keywords:list",
4128
4100
  "pluginAlias": "adapty",
4129
4101
  "pluginName": "adapty",
4130
4102
  "pluginType": "core",
@@ -4135,22 +4107,16 @@
4135
4107
  "dist",
4136
4108
  "commands",
4137
4109
  "asa",
4138
- "automations",
4139
- "create.js"
4110
+ "negative-keywords",
4111
+ "list.js"
4140
4112
  ]
4141
4113
  },
4142
- "asa:automations:get": {
4114
+ "asa:orgs:list": {
4143
4115
  "aliases": [],
4144
- "args": {
4145
- "automation_id": {
4146
- "description": "Automation rule ID (UUID)",
4147
- "name": "automation_id",
4148
- "required": true
4149
- }
4150
- },
4151
- "description": "Show one automation rule with its conditions and actions",
4116
+ "args": {},
4117
+ "description": "List the Apple Search Ads organizations this company can spend from",
4152
4118
  "examples": [
4153
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
4119
+ "<%= config.bin %> asa orgs list"
4154
4120
  ],
4155
4121
  "flags": {
4156
4122
  "json": {
@@ -4159,11 +4125,27 @@
4159
4125
  "name": "json",
4160
4126
  "allowNo": false,
4161
4127
  "type": "boolean"
4128
+ },
4129
+ "page": {
4130
+ "description": "Page number",
4131
+ "name": "page",
4132
+ "default": 1,
4133
+ "hasDynamicHelp": false,
4134
+ "multiple": false,
4135
+ "type": "option"
4136
+ },
4137
+ "page-size": {
4138
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4139
+ "name": "page-size",
4140
+ "default": 100,
4141
+ "hasDynamicHelp": false,
4142
+ "multiple": false,
4143
+ "type": "option"
4162
4144
  }
4163
4145
  },
4164
4146
  "hasDynamicHelp": false,
4165
4147
  "hiddenAliases": [],
4166
- "id": "asa:automations:get",
4148
+ "id": "asa:orgs:list",
4167
4149
  "pluginAlias": "adapty",
4168
4150
  "pluginName": "adapty",
4169
4151
  "pluginType": "core",
@@ -4174,16 +4156,17 @@
4174
4156
  "dist",
4175
4157
  "commands",
4176
4158
  "asa",
4177
- "automations",
4178
- "get.js"
4159
+ "orgs",
4160
+ "list.js"
4179
4161
  ]
4180
4162
  },
4181
- "asa:automations:list": {
4163
+ "asa:product-pages:list": {
4182
4164
  "aliases": [],
4183
4165
  "args": {},
4184
- "description": "List automation rules; status 1 is active, 0 is stopped",
4166
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4185
4167
  "examples": [
4186
- "<%= config.bin %> asa automations list"
4168
+ "<%= config.bin %> asa product-pages list",
4169
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
4187
4170
  ],
4188
4171
  "flags": {
4189
4172
  "json": {
@@ -4208,11 +4191,25 @@
4208
4191
  "hasDynamicHelp": false,
4209
4192
  "multiple": false,
4210
4193
  "type": "option"
4194
+ },
4195
+ "app": {
4196
+ "description": "Keep only rows in this app; repeatable",
4197
+ "name": "app",
4198
+ "hasDynamicHelp": false,
4199
+ "multiple": true,
4200
+ "type": "option"
4201
+ },
4202
+ "campaign-group": {
4203
+ "description": "Keep only rows in this campaign group; repeatable",
4204
+ "name": "campaign-group",
4205
+ "hasDynamicHelp": false,
4206
+ "multiple": true,
4207
+ "type": "option"
4211
4208
  }
4212
4209
  },
4213
4210
  "hasDynamicHelp": false,
4214
4211
  "hiddenAliases": [],
4215
- "id": "asa:automations:list",
4212
+ "id": "asa:product-pages:list",
4216
4213
  "pluginAlias": "adapty",
4217
4214
  "pluginName": "adapty",
4218
4215
  "pluginType": "core",
@@ -4223,23 +4220,17 @@
4223
4220
  "dist",
4224
4221
  "commands",
4225
4222
  "asa",
4226
- "automations",
4223
+ "product-pages",
4227
4224
  "list.js"
4228
4225
  ]
4229
4226
  },
4230
- "asa:automations:run": {
4227
+ "asa:product-pages:sync": {
4231
4228
  "aliases": [],
4232
- "args": {
4233
- "automation_id": {
4234
- "description": "Automation rule ID (UUID)",
4235
- "name": "automation_id",
4236
- "required": true
4237
- }
4238
- },
4239
- "description": "Run an automation rule now; the run is queued, not awaited",
4229
+ "args": {},
4230
+ "description": "Refresh custom product pages from Apple",
4240
4231
  "examples": [
4241
- "<%= config.bin %> asa automations run UUID",
4242
- "<%= config.bin %> asa automations run UUID --dry-run"
4232
+ "<%= config.bin %> asa product-pages sync",
4233
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
4243
4234
  ],
4244
4235
  "flags": {
4245
4236
  "json": {
@@ -4263,16 +4254,17 @@
4263
4254
  "multiple": false,
4264
4255
  "type": "option"
4265
4256
  },
4266
- "dry-run": {
4267
- "description": "Evaluate and log the rule without touching Apple",
4268
- "name": "dry-run",
4269
- "allowNo": false,
4270
- "type": "boolean"
4257
+ "adam-id": {
4258
+ "description": "Limit the refresh to one app; omit to cover every app",
4259
+ "name": "adam-id",
4260
+ "hasDynamicHelp": false,
4261
+ "multiple": false,
4262
+ "type": "option"
4271
4263
  }
4272
4264
  },
4273
4265
  "hasDynamicHelp": false,
4274
4266
  "hiddenAliases": [],
4275
- "id": "asa:automations:run",
4267
+ "id": "asa:product-pages:sync",
4276
4268
  "pluginAlias": "adapty",
4277
4269
  "pluginName": "adapty",
4278
4270
  "pluginType": "core",
@@ -4283,22 +4275,17 @@
4283
4275
  "dist",
4284
4276
  "commands",
4285
4277
  "asa",
4286
- "automations",
4287
- "run.js"
4278
+ "product-pages",
4279
+ "sync.js"
4288
4280
  ]
4289
4281
  },
4290
- "asa:automations:runs": {
4282
+ "asa:search-terms:list": {
4291
4283
  "aliases": [],
4292
- "args": {
4293
- "automation_id": {
4294
- "description": "Automation rule ID (UUID)",
4295
- "name": "automation_id",
4296
- "required": true
4297
- }
4298
- },
4299
- "description": "List past runs of an automation rule, including dry runs",
4284
+ "args": {},
4285
+ "description": "List the search terms your ads matched, with their metrics",
4300
4286
  "examples": [
4301
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
4287
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4288
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4302
4289
  ],
4303
4290
  "flags": {
4304
4291
  "json": {
@@ -4323,97 +4310,60 @@
4323
4310
  "hasDynamicHelp": false,
4324
4311
  "multiple": false,
4325
4312
  "type": "option"
4326
- }
4327
- },
4328
- "hasDynamicHelp": false,
4329
- "hiddenAliases": [],
4330
- "id": "asa:automations:runs",
4331
- "pluginAlias": "adapty",
4332
- "pluginName": "adapty",
4333
- "pluginType": "core",
4334
- "strict": true,
4335
- "enableJsonFlag": true,
4336
- "isESM": true,
4337
- "relativePath": [
4338
- "dist",
4339
- "commands",
4340
- "asa",
4341
- "automations",
4342
- "runs.js"
4343
- ]
4344
- },
4345
- "asa:automations:update": {
4346
- "aliases": [],
4347
- "args": {
4348
- "automation_id": {
4349
- "description": "Automation rule ID (UUID)",
4350
- "name": "automation_id",
4351
- "required": true
4352
- }
4353
- },
4354
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
4355
- "examples": [
4356
- "<%= config.bin %> asa automations update UUID --stop",
4357
- "<%= config.bin %> asa automations update UUID --file rule.json"
4358
- ],
4359
- "flags": {
4360
- "json": {
4361
- "description": "Format output as json.",
4362
- "helpGroup": "GLOBAL",
4363
- "name": "json",
4364
- "allowNo": false,
4365
- "type": "boolean"
4366
- },
4367
- "yes": {
4368
- "char": "y",
4369
- "description": "Apply without asking; required when the output is piped or --json is used",
4370
- "name": "yes",
4371
- "allowNo": false,
4372
- "type": "boolean"
4373
4313
  },
4374
- "idempotency-key": {
4375
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4376
- "name": "idempotency-key",
4314
+ "date-from": {
4315
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4316
+ "name": "date-from",
4377
4317
  "hasDynamicHelp": false,
4378
4318
  "multiple": false,
4379
4319
  "type": "option"
4380
4320
  },
4381
- "file": {
4382
- "description": "JSON file with the parts to change, or - to read stdin",
4383
- "name": "file",
4321
+ "date-to": {
4322
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4323
+ "name": "date-to",
4384
4324
  "hasDynamicHelp": false,
4385
4325
  "multiple": false,
4386
4326
  "type": "option"
4387
4327
  },
4388
- "name": {
4389
- "description": "Rule name",
4390
- "name": "name",
4328
+ "app": {
4329
+ "description": "Keep only rows in this app; repeatable",
4330
+ "name": "app",
4331
+ "hasDynamicHelp": false,
4332
+ "multiple": true,
4333
+ "type": "option"
4334
+ },
4335
+ "campaign-group": {
4336
+ "description": "Keep only rows in this campaign group; repeatable",
4337
+ "name": "campaign-group",
4338
+ "hasDynamicHelp": false,
4339
+ "multiple": true,
4340
+ "type": "option"
4341
+ },
4342
+ "search": {
4343
+ "description": "Case-insensitive substring match on the name",
4344
+ "name": "search",
4391
4345
  "hasDynamicHelp": false,
4392
4346
  "multiple": false,
4393
4347
  "type": "option"
4394
4348
  },
4395
- "start": {
4396
- "description": "Activate the rule",
4397
- "exclusive": [
4398
- "stop"
4399
- ],
4400
- "name": "start",
4401
- "allowNo": false,
4402
- "type": "boolean"
4349
+ "campaign": {
4350
+ "description": "Keep only rows in this campaign; repeatable",
4351
+ "name": "campaign",
4352
+ "hasDynamicHelp": false,
4353
+ "multiple": true,
4354
+ "type": "option"
4403
4355
  },
4404
- "stop": {
4405
- "description": "Stop the rule and clear its next run",
4406
- "exclusive": [
4407
- "start"
4408
- ],
4409
- "name": "stop",
4410
- "allowNo": false,
4411
- "type": "boolean"
4356
+ "ad-group": {
4357
+ "description": "Keep only rows in this ad group; repeatable",
4358
+ "name": "ad-group",
4359
+ "hasDynamicHelp": false,
4360
+ "multiple": true,
4361
+ "type": "option"
4412
4362
  }
4413
4363
  },
4414
4364
  "hasDynamicHelp": false,
4415
4365
  "hiddenAliases": [],
4416
- "id": "asa:automations:update",
4366
+ "id": "asa:search-terms:list",
4417
4367
  "pluginAlias": "adapty",
4418
4368
  "pluginName": "adapty",
4419
4369
  "pluginType": "core",
@@ -4424,8 +4374,8 @@
4424
4374
  "dist",
4425
4375
  "commands",
4426
4376
  "asa",
4427
- "automations",
4428
- "update.js"
4377
+ "search-terms",
4378
+ "list.js"
4429
4379
  ]
4430
4380
  },
4431
4381
  "flows:config:get": {
@@ -4551,7 +4501,57 @@
4551
4501
  "config",
4552
4502
  "update.js"
4553
4503
  ]
4504
+ },
4505
+ "asa:apps:list": {
4506
+ "aliases": [],
4507
+ "args": {},
4508
+ "description": "List the apps promoted by this company in Apple Search Ads",
4509
+ "examples": [
4510
+ "<%= config.bin %> asa apps list",
4511
+ "<%= config.bin %> asa apps list --page 2 --page-size 50"
4512
+ ],
4513
+ "flags": {
4514
+ "json": {
4515
+ "description": "Format output as json.",
4516
+ "helpGroup": "GLOBAL",
4517
+ "name": "json",
4518
+ "allowNo": false,
4519
+ "type": "boolean"
4520
+ },
4521
+ "page": {
4522
+ "description": "Page number",
4523
+ "name": "page",
4524
+ "default": 1,
4525
+ "hasDynamicHelp": false,
4526
+ "multiple": false,
4527
+ "type": "option"
4528
+ },
4529
+ "page-size": {
4530
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4531
+ "name": "page-size",
4532
+ "default": 100,
4533
+ "hasDynamicHelp": false,
4534
+ "multiple": false,
4535
+ "type": "option"
4536
+ }
4537
+ },
4538
+ "hasDynamicHelp": false,
4539
+ "hiddenAliases": [],
4540
+ "id": "asa:apps:list",
4541
+ "pluginAlias": "adapty",
4542
+ "pluginName": "adapty",
4543
+ "pluginType": "core",
4544
+ "strict": true,
4545
+ "enableJsonFlag": true,
4546
+ "isESM": true,
4547
+ "relativePath": [
4548
+ "dist",
4549
+ "commands",
4550
+ "asa",
4551
+ "apps",
4552
+ "list.js"
4553
+ ]
4554
4554
  }
4555
4555
  },
4556
- "version": "0.6.0-beta.1"
4556
+ "version": "0.6.0"
4557
4557
  }