adapty 0.6.1-beta.0 → 0.8.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/dist/commands/asa/campaigns/bulk-list.d.ts +16 -0
  2. package/dist/commands/asa/campaigns/bulk-list.js +54 -0
  3. package/dist/commands/flows/config/validate.d.ts +0 -1
  4. package/dist/commands/flows/config/validate.js +1 -5
  5. package/dist/commands/flows/media/upload.d.ts +14 -0
  6. package/dist/commands/flows/media/upload.js +46 -0
  7. package/dist/lib/api-schemas.d.ts +8 -0
  8. package/dist/lib/asa-flags.d.ts +1 -0
  9. package/dist/lib/asa-flags.js +1 -1
  10. package/dist/lib/asa-schemas.d.ts +15 -0
  11. package/oclif.manifest.json +1114 -989
  12. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -656,12 +656,12 @@
656
656
  "whoami.js"
657
657
  ]
658
658
  },
659
- "flows:create": {
659
+ "paywalls:create": {
660
660
  "aliases": [],
661
661
  "args": {},
662
- "description": "Create a flow (row only — write its config with `flows config update`)",
662
+ "description": "Create a paywall with products",
663
663
  "examples": [
664
- "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
664
+ "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
665
665
  ],
666
666
  "flags": {
667
667
  "json": {
@@ -679,9 +679,17 @@
679
679
  "multiple": false,
680
680
  "type": "option"
681
681
  },
682
- "name": {
683
- "description": "Flow name",
684
- "name": "name",
682
+ "product-id": {
683
+ "description": "Product ID (UUID). Repeat for multiple.",
684
+ "name": "product-id",
685
+ "required": true,
686
+ "hasDynamicHelp": false,
687
+ "multiple": true,
688
+ "type": "option"
689
+ },
690
+ "title": {
691
+ "description": "Paywall title",
692
+ "name": "title",
685
693
  "required": true,
686
694
  "hasDynamicHelp": false,
687
695
  "multiple": false,
@@ -690,7 +698,7 @@
690
698
  },
691
699
  "hasDynamicHelp": false,
692
700
  "hiddenAliases": [],
693
- "id": "flows:create",
701
+ "id": "paywalls:create",
694
702
  "pluginAlias": "adapty",
695
703
  "pluginName": "adapty",
696
704
  "pluginType": "core",
@@ -700,22 +708,22 @@
700
708
  "relativePath": [
701
709
  "dist",
702
710
  "commands",
703
- "flows",
711
+ "paywalls",
704
712
  "create.js"
705
713
  ]
706
714
  },
707
- "flows:get": {
715
+ "paywalls:get": {
708
716
  "aliases": [],
709
717
  "args": {
710
- "flow_id": {
711
- "description": "Flow ID (UUID)",
712
- "name": "flow_id",
718
+ "paywall_id": {
719
+ "description": "Paywall ID (UUID)",
720
+ "name": "paywall_id",
713
721
  "required": true
714
722
  }
715
723
  },
716
- "description": "Get flow details",
724
+ "description": "Get paywall details",
717
725
  "examples": [
718
- "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
726
+ "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
719
727
  ],
720
728
  "flags": {
721
729
  "json": {
@@ -736,7 +744,7 @@
736
744
  },
737
745
  "hasDynamicHelp": false,
738
746
  "hiddenAliases": [],
739
- "id": "flows:get",
747
+ "id": "paywalls:get",
740
748
  "pluginAlias": "adapty",
741
749
  "pluginName": "adapty",
742
750
  "pluginType": "core",
@@ -746,16 +754,16 @@
746
754
  "relativePath": [
747
755
  "dist",
748
756
  "commands",
749
- "flows",
757
+ "paywalls",
750
758
  "get.js"
751
759
  ]
752
760
  },
753
- "flows:list": {
761
+ "paywalls:list": {
754
762
  "aliases": [],
755
763
  "args": {},
756
- "description": "List flows for an app",
764
+ "description": "List paywalls for an app",
757
765
  "examples": [
758
- "<%= config.bin %> flows list --app 550e8400-..."
766
+ "<%= config.bin %> paywalls list --app 550e8400-..."
759
767
  ],
760
768
  "flags": {
761
769
  "json": {
@@ -792,7 +800,7 @@
792
800
  },
793
801
  "hasDynamicHelp": false,
794
802
  "hiddenAliases": [],
795
- "id": "flows:list",
803
+ "id": "paywalls:list",
796
804
  "pluginAlias": "adapty",
797
805
  "pluginName": "adapty",
798
806
  "pluginType": "core",
@@ -802,16 +810,22 @@
802
810
  "relativePath": [
803
811
  "dist",
804
812
  "commands",
805
- "flows",
813
+ "paywalls",
806
814
  "list.js"
807
815
  ]
808
816
  },
809
- "paywalls:create": {
817
+ "paywalls:placements": {
810
818
  "aliases": [],
811
- "args": {},
812
- "description": "Create a paywall with products",
819
+ "args": {
820
+ "paywall_id": {
821
+ "description": "Paywall ID (UUID)",
822
+ "name": "paywall_id",
823
+ "required": true
824
+ }
825
+ },
826
+ "description": "List placements that currently use this paywall",
813
827
  "examples": [
814
- "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
828
+ "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
815
829
  ],
816
830
  "flags": {
817
831
  "json": {
@@ -828,27 +842,11 @@
828
842
  "hasDynamicHelp": false,
829
843
  "multiple": false,
830
844
  "type": "option"
831
- },
832
- "product-id": {
833
- "description": "Product ID (UUID). Repeat for multiple.",
834
- "name": "product-id",
835
- "required": true,
836
- "hasDynamicHelp": false,
837
- "multiple": true,
838
- "type": "option"
839
- },
840
- "title": {
841
- "description": "Paywall title",
842
- "name": "title",
843
- "required": true,
844
- "hasDynamicHelp": false,
845
- "multiple": false,
846
- "type": "option"
847
845
  }
848
846
  },
849
847
  "hasDynamicHelp": false,
850
848
  "hiddenAliases": [],
851
- "id": "paywalls:create",
849
+ "id": "paywalls:placements",
852
850
  "pluginAlias": "adapty",
853
851
  "pluginName": "adapty",
854
852
  "pluginType": "core",
@@ -859,10 +857,10 @@
859
857
  "dist",
860
858
  "commands",
861
859
  "paywalls",
862
- "create.js"
860
+ "placements.js"
863
861
  ]
864
862
  },
865
- "paywalls:get": {
863
+ "paywalls:update": {
866
864
  "aliases": [],
867
865
  "args": {
868
866
  "paywall_id": {
@@ -871,9 +869,9 @@
871
869
  "required": true
872
870
  }
873
871
  },
874
- "description": "Get paywall details",
872
+ "description": "Update a paywall",
875
873
  "examples": [
876
- "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
874
+ "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
877
875
  ],
878
876
  "flags": {
879
877
  "json": {
@@ -890,59 +888,19 @@
890
888
  "hasDynamicHelp": false,
891
889
  "multiple": false,
892
890
  "type": "option"
893
- }
894
- },
895
- "hasDynamicHelp": false,
896
- "hiddenAliases": [],
897
- "id": "paywalls:get",
898
- "pluginAlias": "adapty",
899
- "pluginName": "adapty",
900
- "pluginType": "core",
901
- "strict": true,
902
- "enableJsonFlag": true,
903
- "isESM": true,
904
- "relativePath": [
905
- "dist",
906
- "commands",
907
- "paywalls",
908
- "get.js"
909
- ]
910
- },
911
- "paywalls:list": {
912
- "aliases": [],
913
- "args": {},
914
- "description": "List paywalls for an app",
915
- "examples": [
916
- "<%= config.bin %> paywalls list --app 550e8400-..."
917
- ],
918
- "flags": {
919
- "json": {
920
- "description": "Format output as json.",
921
- "helpGroup": "GLOBAL",
922
- "name": "json",
923
- "allowNo": false,
924
- "type": "boolean"
925
891
  },
926
- "app": {
927
- "description": "App ID (UUID)",
928
- "name": "app",
892
+ "product-id": {
893
+ "description": "Product ID (UUID). Repeat for multiple.",
894
+ "name": "product-id",
929
895
  "required": true,
930
896
  "hasDynamicHelp": false,
931
- "multiple": false,
932
- "type": "option"
933
- },
934
- "page": {
935
- "description": "Page number",
936
- "name": "page",
937
- "default": 1,
938
- "hasDynamicHelp": false,
939
- "multiple": false,
897
+ "multiple": true,
940
898
  "type": "option"
941
899
  },
942
- "page-size": {
943
- "description": "Items per page (max 100)",
944
- "name": "page-size",
945
- "default": 20,
900
+ "title": {
901
+ "description": "Paywall title",
902
+ "name": "title",
903
+ "required": true,
946
904
  "hasDynamicHelp": false,
947
905
  "multiple": false,
948
906
  "type": "option"
@@ -950,7 +908,7 @@
950
908
  },
951
909
  "hasDynamicHelp": false,
952
910
  "hiddenAliases": [],
953
- "id": "paywalls:list",
911
+ "id": "paywalls:update",
954
912
  "pluginAlias": "adapty",
955
913
  "pluginName": "adapty",
956
914
  "pluginType": "core",
@@ -961,21 +919,21 @@
961
919
  "dist",
962
920
  "commands",
963
921
  "paywalls",
964
- "list.js"
922
+ "update.js"
965
923
  ]
966
924
  },
967
- "paywalls:placements": {
925
+ "segments:get": {
968
926
  "aliases": [],
969
927
  "args": {
970
- "paywall_id": {
971
- "description": "Paywall ID (UUID)",
972
- "name": "paywall_id",
928
+ "segment_id": {
929
+ "description": "Segment ID (UUID)",
930
+ "name": "segment_id",
973
931
  "required": true
974
932
  }
975
933
  },
976
- "description": "List placements that currently use this paywall",
934
+ "description": "Get segment details",
977
935
  "examples": [
978
- "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
936
+ "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
979
937
  ],
980
938
  "flags": {
981
939
  "json": {
@@ -996,7 +954,7 @@
996
954
  },
997
955
  "hasDynamicHelp": false,
998
956
  "hiddenAliases": [],
999
- "id": "paywalls:placements",
957
+ "id": "segments:get",
1000
958
  "pluginAlias": "adapty",
1001
959
  "pluginName": "adapty",
1002
960
  "pluginType": "core",
@@ -1006,22 +964,16 @@
1006
964
  "relativePath": [
1007
965
  "dist",
1008
966
  "commands",
1009
- "paywalls",
1010
- "placements.js"
967
+ "segments",
968
+ "get.js"
1011
969
  ]
1012
970
  },
1013
- "paywalls:update": {
971
+ "segments:list": {
1014
972
  "aliases": [],
1015
- "args": {
1016
- "paywall_id": {
1017
- "description": "Paywall ID (UUID)",
1018
- "name": "paywall_id",
1019
- "required": true
1020
- }
1021
- },
1022
- "description": "Update a paywall",
973
+ "args": {},
974
+ "description": "List segments for an app",
1023
975
  "examples": [
1024
- "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
976
+ "<%= config.bin %> segments list --app 550e8400-..."
1025
977
  ],
1026
978
  "flags": {
1027
979
  "json": {
@@ -1039,18 +991,18 @@
1039
991
  "multiple": false,
1040
992
  "type": "option"
1041
993
  },
1042
- "product-id": {
1043
- "description": "Product ID (UUID). Repeat for multiple.",
1044
- "name": "product-id",
1045
- "required": true,
994
+ "page": {
995
+ "description": "Page number",
996
+ "name": "page",
997
+ "default": 1,
1046
998
  "hasDynamicHelp": false,
1047
- "multiple": true,
999
+ "multiple": false,
1048
1000
  "type": "option"
1049
1001
  },
1050
- "title": {
1051
- "description": "Paywall title",
1052
- "name": "title",
1053
- "required": true,
1002
+ "page-size": {
1003
+ "description": "Items per page (max 100)",
1004
+ "name": "page-size",
1005
+ "default": 20,
1054
1006
  "hasDynamicHelp": false,
1055
1007
  "multiple": false,
1056
1008
  "type": "option"
@@ -1058,7 +1010,7 @@
1058
1010
  },
1059
1011
  "hasDynamicHelp": false,
1060
1012
  "hiddenAliases": [],
1061
- "id": "paywalls:update",
1013
+ "id": "segments:list",
1062
1014
  "pluginAlias": "adapty",
1063
1015
  "pluginName": "adapty",
1064
1016
  "pluginType": "core",
@@ -1068,8 +1020,8 @@
1068
1020
  "relativePath": [
1069
1021
  "dist",
1070
1022
  "commands",
1071
- "paywalls",
1072
- "update.js"
1023
+ "segments",
1024
+ "list.js"
1073
1025
  ]
1074
1026
  },
1075
1027
  "products:create": {
@@ -1356,18 +1308,12 @@
1356
1308
  "update.js"
1357
1309
  ]
1358
1310
  },
1359
- "segments:get": {
1311
+ "flows:create": {
1360
1312
  "aliases": [],
1361
- "args": {
1362
- "segment_id": {
1363
- "description": "Segment ID (UUID)",
1364
- "name": "segment_id",
1365
- "required": true
1366
- }
1367
- },
1368
- "description": "Get segment details",
1313
+ "args": {},
1314
+ "description": "Create a flow (row only — write its config with `flows config update`)",
1369
1315
  "examples": [
1370
- "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1316
+ "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
1371
1317
  ],
1372
1318
  "flags": {
1373
1319
  "json": {
@@ -1384,11 +1330,19 @@
1384
1330
  "hasDynamicHelp": false,
1385
1331
  "multiple": false,
1386
1332
  "type": "option"
1333
+ },
1334
+ "name": {
1335
+ "description": "Flow name",
1336
+ "name": "name",
1337
+ "required": true,
1338
+ "hasDynamicHelp": false,
1339
+ "multiple": false,
1340
+ "type": "option"
1387
1341
  }
1388
1342
  },
1389
1343
  "hasDynamicHelp": false,
1390
1344
  "hiddenAliases": [],
1391
- "id": "segments:get",
1345
+ "id": "flows:create",
1392
1346
  "pluginAlias": "adapty",
1393
1347
  "pluginName": "adapty",
1394
1348
  "pluginType": "core",
@@ -1398,16 +1352,22 @@
1398
1352
  "relativePath": [
1399
1353
  "dist",
1400
1354
  "commands",
1401
- "segments",
1402
- "get.js"
1355
+ "flows",
1356
+ "create.js"
1403
1357
  ]
1404
1358
  },
1405
- "segments:list": {
1359
+ "flows:get": {
1406
1360
  "aliases": [],
1407
- "args": {},
1408
- "description": "List segments for an app",
1361
+ "args": {
1362
+ "flow_id": {
1363
+ "description": "Flow ID (UUID)",
1364
+ "name": "flow_id",
1365
+ "required": true
1366
+ }
1367
+ },
1368
+ "description": "Get flow details",
1409
1369
  "examples": [
1410
- "<%= config.bin %> segments list --app 550e8400-..."
1370
+ "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1411
1371
  ],
1412
1372
  "flags": {
1413
1373
  "json": {
@@ -1424,15 +1384,55 @@
1424
1384
  "hasDynamicHelp": false,
1425
1385
  "multiple": false,
1426
1386
  "type": "option"
1387
+ }
1388
+ },
1389
+ "hasDynamicHelp": false,
1390
+ "hiddenAliases": [],
1391
+ "id": "flows:get",
1392
+ "pluginAlias": "adapty",
1393
+ "pluginName": "adapty",
1394
+ "pluginType": "core",
1395
+ "strict": true,
1396
+ "enableJsonFlag": true,
1397
+ "isESM": true,
1398
+ "relativePath": [
1399
+ "dist",
1400
+ "commands",
1401
+ "flows",
1402
+ "get.js"
1403
+ ]
1404
+ },
1405
+ "flows:list": {
1406
+ "aliases": [],
1407
+ "args": {},
1408
+ "description": "List flows for an app",
1409
+ "examples": [
1410
+ "<%= config.bin %> flows list --app 550e8400-..."
1411
+ ],
1412
+ "flags": {
1413
+ "json": {
1414
+ "description": "Format output as json.",
1415
+ "helpGroup": "GLOBAL",
1416
+ "name": "json",
1417
+ "allowNo": false,
1418
+ "type": "boolean"
1419
+ },
1420
+ "app": {
1421
+ "description": "App ID (UUID)",
1422
+ "name": "app",
1423
+ "required": true,
1424
+ "hasDynamicHelp": false,
1425
+ "multiple": false,
1426
+ "type": "option"
1427
+ },
1428
+ "page": {
1429
+ "description": "Page number",
1430
+ "name": "page",
1431
+ "default": 1,
1432
+ "hasDynamicHelp": false,
1433
+ "multiple": false,
1434
+ "type": "option"
1427
1435
  },
1428
- "page": {
1429
- "description": "Page number",
1430
- "name": "page",
1431
- "default": 1,
1432
- "hasDynamicHelp": false,
1433
- "multiple": false,
1434
- "type": "option"
1435
- },
1436
1436
  "page-size": {
1437
1437
  "description": "Items per page (max 100)",
1438
1438
  "name": "page-size",
@@ -1444,7 +1444,7 @@
1444
1444
  },
1445
1445
  "hasDynamicHelp": false,
1446
1446
  "hiddenAliases": [],
1447
- "id": "segments:list",
1447
+ "id": "flows:list",
1448
1448
  "pluginAlias": "adapty",
1449
1449
  "pluginName": "adapty",
1450
1450
  "pluginType": "core",
@@ -1454,7 +1454,7 @@
1454
1454
  "relativePath": [
1455
1455
  "dist",
1456
1456
  "commands",
1457
- "segments",
1457
+ "flows",
1458
1458
  "list.js"
1459
1459
  ]
1460
1460
  },
@@ -2411,111 +2411,6 @@
2411
2411
  "list.js"
2412
2412
  ]
2413
2413
  },
2414
- "asa:competitors:summary": {
2415
- "aliases": [],
2416
- "args": {},
2417
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2418
- "examples": [
2419
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2420
- ],
2421
- "flags": {
2422
- "json": {
2423
- "description": "Format output as json.",
2424
- "helpGroup": "GLOBAL",
2425
- "name": "json",
2426
- "allowNo": false,
2427
- "type": "boolean"
2428
- },
2429
- "app-ids": {
2430
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2431
- "name": "app-ids",
2432
- "required": true,
2433
- "hasDynamicHelp": false,
2434
- "multiple": false,
2435
- "type": "option"
2436
- }
2437
- },
2438
- "hasDynamicHelp": false,
2439
- "hiddenAliases": [],
2440
- "id": "asa:competitors:summary",
2441
- "pluginAlias": "adapty",
2442
- "pluginName": "adapty",
2443
- "pluginType": "core",
2444
- "strict": true,
2445
- "enableJsonFlag": true,
2446
- "isESM": true,
2447
- "relativePath": [
2448
- "dist",
2449
- "commands",
2450
- "asa",
2451
- "competitors",
2452
- "summary.js"
2453
- ]
2454
- },
2455
- "asa:creatives:list": {
2456
- "aliases": [],
2457
- "args": {},
2458
- "description": "List creatives; creative_id is what `asa ads create` needs",
2459
- "examples": [
2460
- "<%= config.bin %> asa creatives list",
2461
- "<%= config.bin %> asa creatives list --app APP_UUID"
2462
- ],
2463
- "flags": {
2464
- "json": {
2465
- "description": "Format output as json.",
2466
- "helpGroup": "GLOBAL",
2467
- "name": "json",
2468
- "allowNo": false,
2469
- "type": "boolean"
2470
- },
2471
- "page": {
2472
- "description": "Page number",
2473
- "name": "page",
2474
- "default": 1,
2475
- "hasDynamicHelp": false,
2476
- "multiple": false,
2477
- "type": "option"
2478
- },
2479
- "page-size": {
2480
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2481
- "name": "page-size",
2482
- "default": 100,
2483
- "hasDynamicHelp": false,
2484
- "multiple": false,
2485
- "type": "option"
2486
- },
2487
- "app": {
2488
- "description": "Keep only rows in this app; repeatable",
2489
- "name": "app",
2490
- "hasDynamicHelp": false,
2491
- "multiple": true,
2492
- "type": "option"
2493
- },
2494
- "campaign-group": {
2495
- "description": "Keep only rows in this campaign group; repeatable",
2496
- "name": "campaign-group",
2497
- "hasDynamicHelp": false,
2498
- "multiple": true,
2499
- "type": "option"
2500
- }
2501
- },
2502
- "hasDynamicHelp": false,
2503
- "hiddenAliases": [],
2504
- "id": "asa:creatives:list",
2505
- "pluginAlias": "adapty",
2506
- "pluginName": "adapty",
2507
- "pluginType": "core",
2508
- "strict": true,
2509
- "enableJsonFlag": true,
2510
- "isESM": true,
2511
- "relativePath": [
2512
- "dist",
2513
- "commands",
2514
- "asa",
2515
- "creatives",
2516
- "list.js"
2517
- ]
2518
- },
2519
2414
  "asa:campaigns:bulk-create": {
2520
2415
  "aliases": [],
2521
2416
  "args": {},
@@ -2615,6 +2510,92 @@
2615
2510
  "bulk-create.js"
2616
2511
  ]
2617
2512
  },
2513
+ "asa:campaigns:bulk-list": {
2514
+ "aliases": [],
2515
+ "args": {},
2516
+ "description": "This company's bulk operations, newest first; inspect one with bulk-status",
2517
+ "examples": [
2518
+ "<%= config.bin %> asa campaigns bulk-list",
2519
+ "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2520
+ "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
2521
+ ],
2522
+ "flags": {
2523
+ "json": {
2524
+ "description": "Format output as json.",
2525
+ "helpGroup": "GLOBAL",
2526
+ "name": "json",
2527
+ "allowNo": false,
2528
+ "type": "boolean"
2529
+ },
2530
+ "page": {
2531
+ "description": "Page number",
2532
+ "name": "page",
2533
+ "default": 1,
2534
+ "hasDynamicHelp": false,
2535
+ "multiple": false,
2536
+ "type": "option"
2537
+ },
2538
+ "page-size": {
2539
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2540
+ "name": "page-size",
2541
+ "default": 100,
2542
+ "hasDynamicHelp": false,
2543
+ "multiple": false,
2544
+ "type": "option"
2545
+ },
2546
+ "app": {
2547
+ "description": "Keep only operations of this app (UUID)",
2548
+ "name": "app",
2549
+ "hasDynamicHelp": false,
2550
+ "multiple": false,
2551
+ "type": "option"
2552
+ },
2553
+ "created-from": {
2554
+ "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
2555
+ "name": "created-from",
2556
+ "hasDynamicHelp": false,
2557
+ "multiple": false,
2558
+ "type": "option"
2559
+ },
2560
+ "created-to": {
2561
+ "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
2562
+ "name": "created-to",
2563
+ "hasDynamicHelp": false,
2564
+ "multiple": false,
2565
+ "type": "option"
2566
+ },
2567
+ "status": {
2568
+ "description": "Keep only operations in this state; repeatable",
2569
+ "name": "status",
2570
+ "hasDynamicHelp": false,
2571
+ "multiple": true,
2572
+ "options": [
2573
+ "failed",
2574
+ "partial",
2575
+ "pending",
2576
+ "running",
2577
+ "success"
2578
+ ],
2579
+ "type": "option"
2580
+ }
2581
+ },
2582
+ "hasDynamicHelp": false,
2583
+ "hiddenAliases": [],
2584
+ "id": "asa:campaigns:bulk-list",
2585
+ "pluginAlias": "adapty",
2586
+ "pluginName": "adapty",
2587
+ "pluginType": "core",
2588
+ "strict": true,
2589
+ "enableJsonFlag": true,
2590
+ "isESM": true,
2591
+ "relativePath": [
2592
+ "dist",
2593
+ "commands",
2594
+ "asa",
2595
+ "campaigns",
2596
+ "bulk-list.js"
2597
+ ]
2598
+ },
2618
2599
  "asa:campaigns:bulk-status": {
2619
2600
  "aliases": [],
2620
2601
  "args": {
@@ -3075,16 +3056,13 @@
3075
3056
  "update.js"
3076
3057
  ]
3077
3058
  },
3078
- "asa:metrics": {
3059
+ "asa:creatives:list": {
3079
3060
  "aliases": [],
3080
3061
  "args": {},
3081
- "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3062
+ "description": "List creatives; creative_id is what `asa ads create` needs",
3082
3063
  "examples": [
3083
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3084
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3085
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3086
- "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3087
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3064
+ "<%= config.bin %> asa creatives list",
3065
+ "<%= config.bin %> asa creatives list --app APP_UUID"
3088
3066
  ],
3089
3067
  "flags": {
3090
3068
  "json": {
@@ -3110,27 +3088,438 @@
3110
3088
  "multiple": false,
3111
3089
  "type": "option"
3112
3090
  },
3113
- "by-days": {
3114
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3115
- "name": "by-days",
3091
+ "app": {
3092
+ "description": "Keep only rows in this app; repeatable",
3093
+ "name": "app",
3116
3094
  "hasDynamicHelp": false,
3117
3095
  "multiple": true,
3118
3096
  "type": "option"
3119
3097
  },
3120
- "date-from": {
3121
- "description": "Start of the period (YYYY-MM-DD)",
3122
- "name": "date-from",
3123
- "required": true,
3098
+ "campaign-group": {
3099
+ "description": "Keep only rows in this campaign group; repeatable",
3100
+ "name": "campaign-group",
3124
3101
  "hasDynamicHelp": false,
3125
- "multiple": false,
3102
+ "multiple": true,
3126
3103
  "type": "option"
3127
- },
3128
- "date-to": {
3129
- "description": "End of the period (YYYY-MM-DD)",
3130
- "name": "date-to",
3131
- "required": true,
3132
- "hasDynamicHelp": false,
3133
- "multiple": false,
3104
+ }
3105
+ },
3106
+ "hasDynamicHelp": false,
3107
+ "hiddenAliases": [],
3108
+ "id": "asa:creatives:list",
3109
+ "pluginAlias": "adapty",
3110
+ "pluginName": "adapty",
3111
+ "pluginType": "core",
3112
+ "strict": true,
3113
+ "enableJsonFlag": true,
3114
+ "isESM": true,
3115
+ "relativePath": [
3116
+ "dist",
3117
+ "commands",
3118
+ "asa",
3119
+ "creatives",
3120
+ "list.js"
3121
+ ]
3122
+ },
3123
+ "asa:competitors:summary": {
3124
+ "aliases": [],
3125
+ "args": {},
3126
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3127
+ "examples": [
3128
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3129
+ ],
3130
+ "flags": {
3131
+ "json": {
3132
+ "description": "Format output as json.",
3133
+ "helpGroup": "GLOBAL",
3134
+ "name": "json",
3135
+ "allowNo": false,
3136
+ "type": "boolean"
3137
+ },
3138
+ "app-ids": {
3139
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3140
+ "name": "app-ids",
3141
+ "required": true,
3142
+ "hasDynamicHelp": false,
3143
+ "multiple": false,
3144
+ "type": "option"
3145
+ }
3146
+ },
3147
+ "hasDynamicHelp": false,
3148
+ "hiddenAliases": [],
3149
+ "id": "asa:competitors:summary",
3150
+ "pluginAlias": "adapty",
3151
+ "pluginName": "adapty",
3152
+ "pluginType": "core",
3153
+ "strict": true,
3154
+ "enableJsonFlag": true,
3155
+ "isESM": true,
3156
+ "relativePath": [
3157
+ "dist",
3158
+ "commands",
3159
+ "asa",
3160
+ "competitors",
3161
+ "summary.js"
3162
+ ]
3163
+ },
3164
+ "asa:keywords:add": {
3165
+ "aliases": [],
3166
+ "args": {},
3167
+ "description": "Add targeting keywords to an ad group",
3168
+ "examples": [
3169
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3170
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3171
+ ],
3172
+ "flags": {
3173
+ "json": {
3174
+ "description": "Format output as json.",
3175
+ "helpGroup": "GLOBAL",
3176
+ "name": "json",
3177
+ "allowNo": false,
3178
+ "type": "boolean"
3179
+ },
3180
+ "currency": {
3181
+ "description": "Currency code for the amounts in this call",
3182
+ "name": "currency",
3183
+ "default": "USD",
3184
+ "hasDynamicHelp": false,
3185
+ "multiple": false,
3186
+ "type": "option"
3187
+ },
3188
+ "yes": {
3189
+ "char": "y",
3190
+ "description": "Apply without asking; required when the output is piped or --json is used",
3191
+ "name": "yes",
3192
+ "allowNo": false,
3193
+ "type": "boolean"
3194
+ },
3195
+ "idempotency-key": {
3196
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3197
+ "name": "idempotency-key",
3198
+ "hasDynamicHelp": false,
3199
+ "multiple": false,
3200
+ "type": "option"
3201
+ },
3202
+ "ad-group": {
3203
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3204
+ "name": "ad-group",
3205
+ "required": true,
3206
+ "hasDynamicHelp": false,
3207
+ "multiple": false,
3208
+ "type": "option"
3209
+ },
3210
+ "bid": {
3211
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3212
+ "name": "bid",
3213
+ "hasDynamicHelp": false,
3214
+ "multiple": false,
3215
+ "type": "option"
3216
+ },
3217
+ "from-file": {
3218
+ "description": "File with one keyword per line, combined with any --text values",
3219
+ "name": "from-file",
3220
+ "hasDynamicHelp": false,
3221
+ "multiple": false,
3222
+ "type": "option"
3223
+ },
3224
+ "match-type": {
3225
+ "description": "Match type",
3226
+ "name": "match-type",
3227
+ "default": "BROAD",
3228
+ "hasDynamicHelp": false,
3229
+ "multiple": false,
3230
+ "options": [
3231
+ "BROAD",
3232
+ "EXACT"
3233
+ ],
3234
+ "type": "option"
3235
+ },
3236
+ "status": {
3237
+ "description": "Keyword status",
3238
+ "name": "status",
3239
+ "default": "ACTIVE",
3240
+ "hasDynamicHelp": false,
3241
+ "multiple": false,
3242
+ "options": [
3243
+ "ACTIVE",
3244
+ "PAUSED"
3245
+ ],
3246
+ "type": "option"
3247
+ },
3248
+ "text": {
3249
+ "description": "Keyword text, repeatable",
3250
+ "name": "text",
3251
+ "hasDynamicHelp": false,
3252
+ "multiple": true,
3253
+ "type": "option"
3254
+ }
3255
+ },
3256
+ "hasDynamicHelp": false,
3257
+ "hiddenAliases": [],
3258
+ "id": "asa:keywords:add",
3259
+ "pluginAlias": "adapty",
3260
+ "pluginName": "adapty",
3261
+ "pluginType": "core",
3262
+ "strict": true,
3263
+ "enableJsonFlag": true,
3264
+ "isESM": true,
3265
+ "relativePath": [
3266
+ "dist",
3267
+ "commands",
3268
+ "asa",
3269
+ "keywords",
3270
+ "add.js"
3271
+ ]
3272
+ },
3273
+ "asa:keywords:list": {
3274
+ "aliases": [],
3275
+ "args": {},
3276
+ "description": "List targeting keywords; read numbers with asa metrics",
3277
+ "examples": [
3278
+ "<%= config.bin %> asa keywords list",
3279
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3280
+ ],
3281
+ "flags": {
3282
+ "json": {
3283
+ "description": "Format output as json.",
3284
+ "helpGroup": "GLOBAL",
3285
+ "name": "json",
3286
+ "allowNo": false,
3287
+ "type": "boolean"
3288
+ },
3289
+ "page": {
3290
+ "description": "Page number",
3291
+ "name": "page",
3292
+ "default": 1,
3293
+ "hasDynamicHelp": false,
3294
+ "multiple": false,
3295
+ "type": "option"
3296
+ },
3297
+ "page-size": {
3298
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3299
+ "name": "page-size",
3300
+ "default": 100,
3301
+ "hasDynamicHelp": false,
3302
+ "multiple": false,
3303
+ "type": "option"
3304
+ },
3305
+ "app": {
3306
+ "description": "Keep only rows in this app; repeatable",
3307
+ "name": "app",
3308
+ "hasDynamicHelp": false,
3309
+ "multiple": true,
3310
+ "type": "option"
3311
+ },
3312
+ "campaign-group": {
3313
+ "description": "Keep only rows in this campaign group; repeatable",
3314
+ "name": "campaign-group",
3315
+ "hasDynamicHelp": false,
3316
+ "multiple": true,
3317
+ "type": "option"
3318
+ },
3319
+ "search": {
3320
+ "description": "Case-insensitive substring match on the name",
3321
+ "name": "search",
3322
+ "hasDynamicHelp": false,
3323
+ "multiple": false,
3324
+ "type": "option"
3325
+ },
3326
+ "campaign": {
3327
+ "description": "Keep only rows in this campaign; repeatable",
3328
+ "name": "campaign",
3329
+ "hasDynamicHelp": false,
3330
+ "multiple": true,
3331
+ "type": "option"
3332
+ },
3333
+ "ad-group": {
3334
+ "description": "Keep only rows in this ad group; repeatable",
3335
+ "name": "ad-group",
3336
+ "hasDynamicHelp": false,
3337
+ "multiple": true,
3338
+ "type": "option"
3339
+ },
3340
+ "status": {
3341
+ "description": "Keep only rows in this state",
3342
+ "name": "status",
3343
+ "hasDynamicHelp": false,
3344
+ "multiple": false,
3345
+ "options": [
3346
+ "ACTIVE",
3347
+ "PAUSED"
3348
+ ],
3349
+ "type": "option"
3350
+ }
3351
+ },
3352
+ "hasDynamicHelp": false,
3353
+ "hiddenAliases": [],
3354
+ "id": "asa:keywords:list",
3355
+ "pluginAlias": "adapty",
3356
+ "pluginName": "adapty",
3357
+ "pluginType": "core",
3358
+ "strict": true,
3359
+ "enableJsonFlag": true,
3360
+ "isESM": true,
3361
+ "relativePath": [
3362
+ "dist",
3363
+ "commands",
3364
+ "asa",
3365
+ "keywords",
3366
+ "list.js"
3367
+ ]
3368
+ },
3369
+ "asa:keywords:update": {
3370
+ "aliases": [],
3371
+ "args": {
3372
+ "keyword_id": {
3373
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3374
+ "name": "keyword_id",
3375
+ "required": true
3376
+ }
3377
+ },
3378
+ "description": "Change bid, status, text or match type of keywords",
3379
+ "examples": [
3380
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3381
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3382
+ ],
3383
+ "flags": {
3384
+ "json": {
3385
+ "description": "Format output as json.",
3386
+ "helpGroup": "GLOBAL",
3387
+ "name": "json",
3388
+ "allowNo": false,
3389
+ "type": "boolean"
3390
+ },
3391
+ "currency": {
3392
+ "description": "Currency code for the amounts in this call",
3393
+ "name": "currency",
3394
+ "default": "USD",
3395
+ "hasDynamicHelp": false,
3396
+ "multiple": false,
3397
+ "type": "option"
3398
+ },
3399
+ "yes": {
3400
+ "char": "y",
3401
+ "description": "Apply without asking; required when the output is piped or --json is used",
3402
+ "name": "yes",
3403
+ "allowNo": false,
3404
+ "type": "boolean"
3405
+ },
3406
+ "idempotency-key": {
3407
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3408
+ "name": "idempotency-key",
3409
+ "hasDynamicHelp": false,
3410
+ "multiple": false,
3411
+ "type": "option"
3412
+ },
3413
+ "bid": {
3414
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3415
+ "name": "bid",
3416
+ "hasDynamicHelp": false,
3417
+ "multiple": false,
3418
+ "type": "option"
3419
+ },
3420
+ "match-type": {
3421
+ "description": "Match type",
3422
+ "name": "match-type",
3423
+ "hasDynamicHelp": false,
3424
+ "multiple": false,
3425
+ "options": [
3426
+ "BROAD",
3427
+ "EXACT"
3428
+ ],
3429
+ "type": "option"
3430
+ },
3431
+ "status": {
3432
+ "description": "Keyword status",
3433
+ "name": "status",
3434
+ "hasDynamicHelp": false,
3435
+ "multiple": false,
3436
+ "options": [
3437
+ "ACTIVE",
3438
+ "PAUSED"
3439
+ ],
3440
+ "type": "option"
3441
+ },
3442
+ "text": {
3443
+ "description": "Keyword text (only meaningful for a single keyword)",
3444
+ "name": "text",
3445
+ "hasDynamicHelp": false,
3446
+ "multiple": false,
3447
+ "type": "option"
3448
+ }
3449
+ },
3450
+ "hasDynamicHelp": false,
3451
+ "hiddenAliases": [],
3452
+ "id": "asa:keywords:update",
3453
+ "pluginAlias": "adapty",
3454
+ "pluginName": "adapty",
3455
+ "pluginType": "core",
3456
+ "strict": false,
3457
+ "enableJsonFlag": true,
3458
+ "isESM": true,
3459
+ "relativePath": [
3460
+ "dist",
3461
+ "commands",
3462
+ "asa",
3463
+ "keywords",
3464
+ "update.js"
3465
+ ]
3466
+ },
3467
+ "asa:metrics": {
3468
+ "aliases": [],
3469
+ "args": {},
3470
+ "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3471
+ "examples": [
3472
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3473
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3474
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3475
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3476
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3477
+ ],
3478
+ "flags": {
3479
+ "json": {
3480
+ "description": "Format output as json.",
3481
+ "helpGroup": "GLOBAL",
3482
+ "name": "json",
3483
+ "allowNo": false,
3484
+ "type": "boolean"
3485
+ },
3486
+ "page": {
3487
+ "description": "Page number",
3488
+ "name": "page",
3489
+ "default": 1,
3490
+ "hasDynamicHelp": false,
3491
+ "multiple": false,
3492
+ "type": "option"
3493
+ },
3494
+ "page-size": {
3495
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3496
+ "name": "page-size",
3497
+ "default": 100,
3498
+ "hasDynamicHelp": false,
3499
+ "multiple": false,
3500
+ "type": "option"
3501
+ },
3502
+ "by-days": {
3503
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3504
+ "name": "by-days",
3505
+ "hasDynamicHelp": false,
3506
+ "multiple": true,
3507
+ "type": "option"
3508
+ },
3509
+ "date-from": {
3510
+ "description": "Start of the period (YYYY-MM-DD)",
3511
+ "name": "date-from",
3512
+ "required": true,
3513
+ "hasDynamicHelp": false,
3514
+ "multiple": false,
3515
+ "type": "option"
3516
+ },
3517
+ "date-to": {
3518
+ "description": "End of the period (YYYY-MM-DD)",
3519
+ "name": "date-to",
3520
+ "required": true,
3521
+ "hasDynamicHelp": false,
3522
+ "multiple": false,
3134
3523
  "type": "option"
3135
3524
  },
3136
3525
  "entity": {
@@ -3306,13 +3695,14 @@
3306
3695
  "overview.js"
3307
3696
  ]
3308
3697
  },
3309
- "asa:automations:create": {
3698
+ "asa:negative-keywords:add": {
3310
3699
  "aliases": [],
3311
3700
  "args": {},
3312
- "description": "Create an automation rule from a JSON rule file",
3701
+ "description": "Add negative keywords to an ad group or across a campaign",
3313
3702
  "examples": [
3314
- "<%= config.bin %> asa automations create --file rule.json",
3315
- "<%= config.bin %> asa automations create --file rule.json --run-now"
3703
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3704
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3705
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3316
3706
  ],
3317
3707
  "flags": {
3318
3708
  "json": {
@@ -3336,63 +3726,71 @@
3336
3726
  "multiple": false,
3337
3727
  "type": "option"
3338
3728
  },
3339
- "file": {
3340
- "description": "JSON file with the rule body, or - to read stdin",
3341
- "name": "file",
3342
- "required": true,
3729
+ "ad-group": {
3730
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3731
+ "exclusive": [
3732
+ "campaign"
3733
+ ],
3734
+ "name": "ad-group",
3343
3735
  "hasDynamicHelp": false,
3344
3736
  "multiple": false,
3345
3737
  "type": "option"
3346
3738
  },
3347
- "run-now": {
3348
- "description": "Queue the first run right after the rule is stored",
3349
- "name": "run-now",
3350
- "allowNo": false,
3351
- "type": "boolean"
3352
- }
3353
- },
3354
- "hasDynamicHelp": false,
3355
- "hiddenAliases": [],
3356
- "id": "asa:automations:create",
3357
- "pluginAlias": "adapty",
3358
- "pluginName": "adapty",
3359
- "pluginType": "core",
3360
- "strict": true,
3361
- "enableJsonFlag": true,
3362
- "isESM": true,
3363
- "relativePath": [
3364
- "dist",
3365
- "commands",
3366
- "asa",
3367
- "automations",
3368
- "create.js"
3369
- ]
3370
- },
3371
- "asa:automations:get": {
3372
- "aliases": [],
3373
- "args": {
3374
- "automation_id": {
3375
- "description": "Automation rule ID (UUID)",
3376
- "name": "automation_id",
3377
- "required": true
3378
- }
3379
- },
3380
- "description": "Show one automation rule with its conditions and actions",
3381
- "examples": [
3382
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
3383
- ],
3384
- "flags": {
3385
- "json": {
3386
- "description": "Format output as json.",
3387
- "helpGroup": "GLOBAL",
3388
- "name": "json",
3739
+ "all-ad-groups": {
3740
+ "dependsOn": [
3741
+ "campaign"
3742
+ ],
3743
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
3744
+ "name": "all-ad-groups",
3389
3745
  "allowNo": false,
3390
3746
  "type": "boolean"
3747
+ },
3748
+ "campaign": {
3749
+ "description": "Campaign ID (UUID)",
3750
+ "exclusive": [
3751
+ "ad-group"
3752
+ ],
3753
+ "name": "campaign",
3754
+ "hasDynamicHelp": false,
3755
+ "multiple": false,
3756
+ "type": "option"
3757
+ },
3758
+ "match-type": {
3759
+ "description": "Match type",
3760
+ "name": "match-type",
3761
+ "default": "EXACT",
3762
+ "hasDynamicHelp": false,
3763
+ "multiple": false,
3764
+ "options": [
3765
+ "BROAD",
3766
+ "EXACT"
3767
+ ],
3768
+ "type": "option"
3769
+ },
3770
+ "status": {
3771
+ "description": "Keyword status",
3772
+ "name": "status",
3773
+ "default": "ACTIVE",
3774
+ "hasDynamicHelp": false,
3775
+ "multiple": false,
3776
+ "options": [
3777
+ "ACTIVE",
3778
+ "PAUSED"
3779
+ ],
3780
+ "type": "option"
3781
+ },
3782
+ "text": {
3783
+ "description": "Keyword text, repeatable",
3784
+ "name": "text",
3785
+ "required": true,
3786
+ "hasDynamicHelp": false,
3787
+ "multiple": true,
3788
+ "type": "option"
3391
3789
  }
3392
3790
  },
3393
3791
  "hasDynamicHelp": false,
3394
3792
  "hiddenAliases": [],
3395
- "id": "asa:automations:get",
3793
+ "id": "asa:negative-keywords:add",
3396
3794
  "pluginAlias": "adapty",
3397
3795
  "pluginName": "adapty",
3398
3796
  "pluginType": "core",
@@ -3403,16 +3801,17 @@
3403
3801
  "dist",
3404
3802
  "commands",
3405
3803
  "asa",
3406
- "automations",
3407
- "get.js"
3804
+ "negative-keywords",
3805
+ "add.js"
3408
3806
  ]
3409
3807
  },
3410
- "asa:automations:list": {
3808
+ "asa:negative-keywords:list": {
3411
3809
  "aliases": [],
3412
3810
  "args": {},
3413
- "description": "List automation rules; status 1 is active, 0 is stopped",
3811
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3414
3812
  "examples": [
3415
- "<%= config.bin %> asa automations list"
3813
+ "<%= config.bin %> asa negative-keywords list",
3814
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3416
3815
  ],
3417
3816
  "flags": {
3418
3817
  "json": {
@@ -3437,71 +3836,52 @@
3437
3836
  "hasDynamicHelp": false,
3438
3837
  "multiple": false,
3439
3838
  "type": "option"
3440
- }
3441
- },
3442
- "hasDynamicHelp": false,
3443
- "hiddenAliases": [],
3444
- "id": "asa:automations:list",
3445
- "pluginAlias": "adapty",
3446
- "pluginName": "adapty",
3447
- "pluginType": "core",
3448
- "strict": true,
3449
- "enableJsonFlag": true,
3450
- "isESM": true,
3451
- "relativePath": [
3452
- "dist",
3453
- "commands",
3454
- "asa",
3455
- "automations",
3456
- "list.js"
3457
- ]
3458
- },
3459
- "asa:automations:run": {
3460
- "aliases": [],
3461
- "args": {
3462
- "automation_id": {
3463
- "description": "Automation rule ID (UUID)",
3464
- "name": "automation_id",
3465
- "required": true
3466
- }
3467
- },
3468
- "description": "Run an automation rule now; the run is queued, not awaited",
3469
- "examples": [
3470
- "<%= config.bin %> asa automations run UUID",
3471
- "<%= config.bin %> asa automations run UUID --dry-run"
3472
- ],
3473
- "flags": {
3474
- "json": {
3475
- "description": "Format output as json.",
3476
- "helpGroup": "GLOBAL",
3477
- "name": "json",
3478
- "allowNo": false,
3479
- "type": "boolean"
3480
3839
  },
3481
- "yes": {
3482
- "char": "y",
3483
- "description": "Apply without asking; required when the output is piped or --json is used",
3484
- "name": "yes",
3485
- "allowNo": false,
3486
- "type": "boolean"
3840
+ "app": {
3841
+ "description": "Keep only rows in this app; repeatable",
3842
+ "name": "app",
3843
+ "hasDynamicHelp": false,
3844
+ "multiple": true,
3845
+ "type": "option"
3487
3846
  },
3488
- "idempotency-key": {
3489
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3490
- "name": "idempotency-key",
3847
+ "campaign-group": {
3848
+ "description": "Keep only rows in this campaign group; repeatable",
3849
+ "name": "campaign-group",
3850
+ "hasDynamicHelp": false,
3851
+ "multiple": true,
3852
+ "type": "option"
3853
+ },
3854
+ "search": {
3855
+ "description": "Case-insensitive substring match on the name",
3856
+ "name": "search",
3491
3857
  "hasDynamicHelp": false,
3492
3858
  "multiple": false,
3493
3859
  "type": "option"
3494
3860
  },
3495
- "dry-run": {
3496
- "description": "Evaluate and log the rule without touching Apple",
3497
- "name": "dry-run",
3861
+ "campaign": {
3862
+ "description": "Keep only rows in this campaign; repeatable",
3863
+ "name": "campaign",
3864
+ "hasDynamicHelp": false,
3865
+ "multiple": true,
3866
+ "type": "option"
3867
+ },
3868
+ "ad-group": {
3869
+ "description": "Keep only rows in this ad group; repeatable",
3870
+ "name": "ad-group",
3871
+ "hasDynamicHelp": false,
3872
+ "multiple": true,
3873
+ "type": "option"
3874
+ },
3875
+ "campaign-level-only": {
3876
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
3877
+ "name": "campaign-level-only",
3498
3878
  "allowNo": false,
3499
3879
  "type": "boolean"
3500
3880
  }
3501
3881
  },
3502
3882
  "hasDynamicHelp": false,
3503
3883
  "hiddenAliases": [],
3504
- "id": "asa:automations:run",
3884
+ "id": "asa:negative-keywords:list",
3505
3885
  "pluginAlias": "adapty",
3506
3886
  "pluginName": "adapty",
3507
3887
  "pluginType": "core",
@@ -3512,22 +3892,16 @@
3512
3892
  "dist",
3513
3893
  "commands",
3514
3894
  "asa",
3515
- "automations",
3516
- "run.js"
3895
+ "negative-keywords",
3896
+ "list.js"
3517
3897
  ]
3518
3898
  },
3519
- "asa:automations:runs": {
3899
+ "asa:orgs:list": {
3520
3900
  "aliases": [],
3521
- "args": {
3522
- "automation_id": {
3523
- "description": "Automation rule ID (UUID)",
3524
- "name": "automation_id",
3525
- "required": true
3526
- }
3527
- },
3528
- "description": "List past runs of an automation rule, including dry runs",
3901
+ "args": {},
3902
+ "description": "List the Apple Search Ads organizations this company can spend from",
3529
3903
  "examples": [
3530
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
3904
+ "<%= config.bin %> asa orgs list"
3531
3905
  ],
3532
3906
  "flags": {
3533
3907
  "json": {
@@ -3556,7 +3930,7 @@
3556
3930
  },
3557
3931
  "hasDynamicHelp": false,
3558
3932
  "hiddenAliases": [],
3559
- "id": "asa:automations:runs",
3933
+ "id": "asa:orgs:list",
3560
3934
  "pluginAlias": "adapty",
3561
3935
  "pluginName": "adapty",
3562
3936
  "pluginType": "core",
@@ -3567,23 +3941,17 @@
3567
3941
  "dist",
3568
3942
  "commands",
3569
3943
  "asa",
3570
- "automations",
3571
- "runs.js"
3944
+ "orgs",
3945
+ "list.js"
3572
3946
  ]
3573
3947
  },
3574
- "asa:automations:update": {
3948
+ "asa:product-pages:list": {
3575
3949
  "aliases": [],
3576
- "args": {
3577
- "automation_id": {
3578
- "description": "Automation rule ID (UUID)",
3579
- "name": "automation_id",
3580
- "required": true
3581
- }
3582
- },
3583
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
3950
+ "args": {},
3951
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
3584
3952
  "examples": [
3585
- "<%= config.bin %> asa automations update UUID --stop",
3586
- "<%= config.bin %> asa automations update UUID --file rule.json"
3953
+ "<%= config.bin %> asa product-pages list",
3954
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
3587
3955
  ],
3588
3956
  "flags": {
3589
3957
  "json": {
@@ -3593,56 +3961,40 @@
3593
3961
  "allowNo": false,
3594
3962
  "type": "boolean"
3595
3963
  },
3596
- "yes": {
3597
- "char": "y",
3598
- "description": "Apply without asking; required when the output is piped or --json is used",
3599
- "name": "yes",
3600
- "allowNo": false,
3601
- "type": "boolean"
3602
- },
3603
- "idempotency-key": {
3604
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3605
- "name": "idempotency-key",
3964
+ "page": {
3965
+ "description": "Page number",
3966
+ "name": "page",
3967
+ "default": 1,
3606
3968
  "hasDynamicHelp": false,
3607
3969
  "multiple": false,
3608
3970
  "type": "option"
3609
3971
  },
3610
- "file": {
3611
- "description": "JSON file with the parts to change, or - to read stdin",
3612
- "name": "file",
3972
+ "page-size": {
3973
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3974
+ "name": "page-size",
3975
+ "default": 100,
3613
3976
  "hasDynamicHelp": false,
3614
3977
  "multiple": false,
3615
3978
  "type": "option"
3616
3979
  },
3617
- "name": {
3618
- "description": "Rule name",
3619
- "name": "name",
3980
+ "app": {
3981
+ "description": "Keep only rows in this app; repeatable",
3982
+ "name": "app",
3620
3983
  "hasDynamicHelp": false,
3621
- "multiple": false,
3984
+ "multiple": true,
3622
3985
  "type": "option"
3623
3986
  },
3624
- "start": {
3625
- "description": "Activate the rule",
3626
- "exclusive": [
3627
- "stop"
3628
- ],
3629
- "name": "start",
3630
- "allowNo": false,
3631
- "type": "boolean"
3632
- },
3633
- "stop": {
3634
- "description": "Stop the rule and clear its next run",
3635
- "exclusive": [
3636
- "start"
3637
- ],
3638
- "name": "stop",
3639
- "allowNo": false,
3640
- "type": "boolean"
3987
+ "campaign-group": {
3988
+ "description": "Keep only rows in this campaign group; repeatable",
3989
+ "name": "campaign-group",
3990
+ "hasDynamicHelp": false,
3991
+ "multiple": true,
3992
+ "type": "option"
3641
3993
  }
3642
3994
  },
3643
3995
  "hasDynamicHelp": false,
3644
3996
  "hiddenAliases": [],
3645
- "id": "asa:automations:update",
3997
+ "id": "asa:product-pages:list",
3646
3998
  "pluginAlias": "adapty",
3647
3999
  "pluginName": "adapty",
3648
4000
  "pluginType": "core",
@@ -3653,17 +4005,17 @@
3653
4005
  "dist",
3654
4006
  "commands",
3655
4007
  "asa",
3656
- "automations",
3657
- "update.js"
4008
+ "product-pages",
4009
+ "list.js"
3658
4010
  ]
3659
4011
  },
3660
- "asa:keywords:add": {
4012
+ "asa:product-pages:sync": {
3661
4013
  "aliases": [],
3662
4014
  "args": {},
3663
- "description": "Add targeting keywords to an ad group",
4015
+ "description": "Refresh custom product pages from Apple",
3664
4016
  "examples": [
3665
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3666
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
4017
+ "<%= config.bin %> asa product-pages sync",
4018
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
3667
4019
  ],
3668
4020
  "flags": {
3669
4021
  "json": {
@@ -3673,85 +4025,31 @@
3673
4025
  "allowNo": false,
3674
4026
  "type": "boolean"
3675
4027
  },
3676
- "currency": {
3677
- "description": "Currency code for the amounts in this call",
3678
- "name": "currency",
3679
- "default": "USD",
3680
- "hasDynamicHelp": false,
3681
- "multiple": false,
3682
- "type": "option"
3683
- },
3684
4028
  "yes": {
3685
4029
  "char": "y",
3686
4030
  "description": "Apply without asking; required when the output is piped or --json is used",
3687
4031
  "name": "yes",
3688
- "allowNo": false,
3689
- "type": "boolean"
3690
- },
3691
- "idempotency-key": {
3692
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3693
- "name": "idempotency-key",
3694
- "hasDynamicHelp": false,
3695
- "multiple": false,
3696
- "type": "option"
3697
- },
3698
- "ad-group": {
3699
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3700
- "name": "ad-group",
3701
- "required": true,
3702
- "hasDynamicHelp": false,
3703
- "multiple": false,
3704
- "type": "option"
3705
- },
3706
- "bid": {
3707
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3708
- "name": "bid",
3709
- "hasDynamicHelp": false,
3710
- "multiple": false,
3711
- "type": "option"
3712
- },
3713
- "from-file": {
3714
- "description": "File with one keyword per line, combined with any --text values",
3715
- "name": "from-file",
3716
- "hasDynamicHelp": false,
3717
- "multiple": false,
3718
- "type": "option"
3719
- },
3720
- "match-type": {
3721
- "description": "Match type",
3722
- "name": "match-type",
3723
- "default": "BROAD",
3724
- "hasDynamicHelp": false,
3725
- "multiple": false,
3726
- "options": [
3727
- "BROAD",
3728
- "EXACT"
3729
- ],
3730
- "type": "option"
3731
- },
3732
- "status": {
3733
- "description": "Keyword status",
3734
- "name": "status",
3735
- "default": "ACTIVE",
4032
+ "allowNo": false,
4033
+ "type": "boolean"
4034
+ },
4035
+ "idempotency-key": {
4036
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4037
+ "name": "idempotency-key",
3736
4038
  "hasDynamicHelp": false,
3737
4039
  "multiple": false,
3738
- "options": [
3739
- "ACTIVE",
3740
- "PAUSED"
3741
- ],
3742
4040
  "type": "option"
3743
4041
  },
3744
- "text": {
3745
- "description": "Keyword text, repeatable",
3746
- "name": "text",
4042
+ "adam-id": {
4043
+ "description": "Limit the refresh to one app; omit to cover every app",
4044
+ "name": "adam-id",
3747
4045
  "hasDynamicHelp": false,
3748
- "multiple": true,
4046
+ "multiple": false,
3749
4047
  "type": "option"
3750
4048
  }
3751
4049
  },
3752
4050
  "hasDynamicHelp": false,
3753
4051
  "hiddenAliases": [],
3754
- "id": "asa:keywords:add",
4052
+ "id": "asa:product-pages:sync",
3755
4053
  "pluginAlias": "adapty",
3756
4054
  "pluginName": "adapty",
3757
4055
  "pluginType": "core",
@@ -3762,17 +4060,17 @@
3762
4060
  "dist",
3763
4061
  "commands",
3764
4062
  "asa",
3765
- "keywords",
3766
- "add.js"
4063
+ "product-pages",
4064
+ "sync.js"
3767
4065
  ]
3768
4066
  },
3769
- "asa:keywords:list": {
4067
+ "asa:search-terms:list": {
3770
4068
  "aliases": [],
3771
4069
  "args": {},
3772
- "description": "List targeting keywords; read numbers with asa metrics",
4070
+ "description": "List the search terms your ads matched, with their metrics",
3773
4071
  "examples": [
3774
- "<%= config.bin %> asa keywords list",
3775
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
4072
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4073
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
3776
4074
  ],
3777
4075
  "flags": {
3778
4076
  "json": {
@@ -3798,6 +4096,20 @@
3798
4096
  "multiple": false,
3799
4097
  "type": "option"
3800
4098
  },
4099
+ "date-from": {
4100
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4101
+ "name": "date-from",
4102
+ "hasDynamicHelp": false,
4103
+ "multiple": false,
4104
+ "type": "option"
4105
+ },
4106
+ "date-to": {
4107
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4108
+ "name": "date-to",
4109
+ "hasDynamicHelp": false,
4110
+ "multiple": false,
4111
+ "type": "option"
4112
+ },
3801
4113
  "app": {
3802
4114
  "description": "Keep only rows in this app; repeatable",
3803
4115
  "name": "app",
@@ -3832,22 +4144,11 @@
3832
4144
  "hasDynamicHelp": false,
3833
4145
  "multiple": true,
3834
4146
  "type": "option"
3835
- },
3836
- "status": {
3837
- "description": "Keep only rows in this state",
3838
- "name": "status",
3839
- "hasDynamicHelp": false,
3840
- "multiple": false,
3841
- "options": [
3842
- "ACTIVE",
3843
- "PAUSED"
3844
- ],
3845
- "type": "option"
3846
4147
  }
3847
4148
  },
3848
4149
  "hasDynamicHelp": false,
3849
4150
  "hiddenAliases": [],
3850
- "id": "asa:keywords:list",
4151
+ "id": "asa:search-terms:list",
3851
4152
  "pluginAlias": "adapty",
3852
4153
  "pluginName": "adapty",
3853
4154
  "pluginType": "core",
@@ -3858,23 +4159,22 @@
3858
4159
  "dist",
3859
4160
  "commands",
3860
4161
  "asa",
3861
- "keywords",
4162
+ "search-terms",
3862
4163
  "list.js"
3863
4164
  ]
3864
4165
  },
3865
- "asa:keywords:update": {
4166
+ "flows:config:get": {
3866
4167
  "aliases": [],
3867
4168
  "args": {
3868
- "keyword_id": {
3869
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3870
- "name": "keyword_id",
4169
+ "flow_id": {
4170
+ "description": "Flow ID (UUID)",
4171
+ "name": "flow_id",
3871
4172
  "required": true
3872
4173
  }
3873
4174
  },
3874
- "description": "Change bid, status, text or match type of keywords",
4175
+ "description": "Read the flow builder config (404 until the config has been written at least once)",
3875
4176
  "examples": [
3876
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3877
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
4177
+ "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
3878
4178
  ],
3879
4179
  "flags": {
3880
4180
  "json": {
@@ -3884,60 +4184,10 @@
3884
4184
  "allowNo": false,
3885
4185
  "type": "boolean"
3886
4186
  },
3887
- "currency": {
3888
- "description": "Currency code for the amounts in this call",
3889
- "name": "currency",
3890
- "default": "USD",
3891
- "hasDynamicHelp": false,
3892
- "multiple": false,
3893
- "type": "option"
3894
- },
3895
- "yes": {
3896
- "char": "y",
3897
- "description": "Apply without asking; required when the output is piped or --json is used",
3898
- "name": "yes",
3899
- "allowNo": false,
3900
- "type": "boolean"
3901
- },
3902
- "idempotency-key": {
3903
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3904
- "name": "idempotency-key",
3905
- "hasDynamicHelp": false,
3906
- "multiple": false,
3907
- "type": "option"
3908
- },
3909
- "bid": {
3910
- "description": "Bid (amount, e.g. 50 or 12.50)",
3911
- "name": "bid",
3912
- "hasDynamicHelp": false,
3913
- "multiple": false,
3914
- "type": "option"
3915
- },
3916
- "match-type": {
3917
- "description": "Match type",
3918
- "name": "match-type",
3919
- "hasDynamicHelp": false,
3920
- "multiple": false,
3921
- "options": [
3922
- "BROAD",
3923
- "EXACT"
3924
- ],
3925
- "type": "option"
3926
- },
3927
- "status": {
3928
- "description": "Keyword status",
3929
- "name": "status",
3930
- "hasDynamicHelp": false,
3931
- "multiple": false,
3932
- "options": [
3933
- "ACTIVE",
3934
- "PAUSED"
3935
- ],
3936
- "type": "option"
3937
- },
3938
- "text": {
3939
- "description": "Keyword text (only meaningful for a single keyword)",
3940
- "name": "text",
4187
+ "app": {
4188
+ "description": "App ID (UUID)",
4189
+ "name": "app",
4190
+ "required": true,
3941
4191
  "hasDynamicHelp": false,
3942
4192
  "multiple": false,
3943
4193
  "type": "option"
@@ -3945,28 +4195,36 @@
3945
4195
  },
3946
4196
  "hasDynamicHelp": false,
3947
4197
  "hiddenAliases": [],
3948
- "id": "asa:keywords:update",
4198
+ "id": "flows:config:get",
3949
4199
  "pluginAlias": "adapty",
3950
4200
  "pluginName": "adapty",
3951
4201
  "pluginType": "core",
3952
- "strict": false,
4202
+ "strict": true,
3953
4203
  "enableJsonFlag": true,
3954
4204
  "isESM": true,
3955
4205
  "relativePath": [
3956
4206
  "dist",
3957
4207
  "commands",
3958
- "asa",
3959
- "keywords",
3960
- "update.js"
4208
+ "flows",
4209
+ "config",
4210
+ "get.js"
3961
4211
  ]
3962
4212
  },
3963
- "asa:product-pages:list": {
4213
+ "flows:config:preview": {
3964
4214
  "aliases": [],
3965
- "args": {},
3966
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4215
+ "args": {
4216
+ "config_file": {
4217
+ "description": "Path to a local flow config JSON file",
4218
+ "name": "config_file",
4219
+ "required": true
4220
+ }
4221
+ },
4222
+ "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
3967
4223
  "examples": [
3968
- "<%= config.bin %> asa product-pages list",
3969
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4224
+ "<%= config.bin %> flows config preview ./config.json",
4225
+ "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4226
+ "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
4227
+ "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
3970
4228
  ],
3971
4229
  "flags": {
3972
4230
  "json": {
@@ -3976,40 +4234,37 @@
3976
4234
  "allowNo": false,
3977
4235
  "type": "boolean"
3978
4236
  },
3979
- "page": {
3980
- "description": "Page number",
3981
- "name": "page",
3982
- "default": 1,
4237
+ "device": {
4238
+ "description": "Device frame to render in",
4239
+ "name": "device",
4240
+ "default": "iphone-14",
3983
4241
  "hasDynamicHelp": false,
3984
4242
  "multiple": false,
3985
4243
  "type": "option"
3986
4244
  },
3987
- "page-size": {
3988
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3989
- "name": "page-size",
3990
- "default": 100,
4245
+ "orientation": {
4246
+ "description": "Device orientation to render in",
4247
+ "name": "orientation",
4248
+ "default": "portrait",
3991
4249
  "hasDynamicHelp": false,
3992
4250
  "multiple": false,
4251
+ "options": [
4252
+ "landscape",
4253
+ "portrait"
4254
+ ],
3993
4255
  "type": "option"
3994
4256
  },
3995
- "app": {
3996
- "description": "Keep only rows in this app; repeatable",
3997
- "name": "app",
3998
- "hasDynamicHelp": false,
3999
- "multiple": true,
4000
- "type": "option"
4001
- },
4002
- "campaign-group": {
4003
- "description": "Keep only rows in this campaign group; repeatable",
4004
- "name": "campaign-group",
4257
+ "screen": {
4258
+ "description": "Screen ID to render (default: the flow's first screen)",
4259
+ "name": "screen",
4005
4260
  "hasDynamicHelp": false,
4006
- "multiple": true,
4261
+ "multiple": false,
4007
4262
  "type": "option"
4008
4263
  }
4009
4264
  },
4010
4265
  "hasDynamicHelp": false,
4011
4266
  "hiddenAliases": [],
4012
- "id": "asa:product-pages:list",
4267
+ "id": "flows:config:preview",
4013
4268
  "pluginAlias": "adapty",
4014
4269
  "pluginName": "adapty",
4015
4270
  "pluginType": "core",
@@ -4019,18 +4274,25 @@
4019
4274
  "relativePath": [
4020
4275
  "dist",
4021
4276
  "commands",
4022
- "asa",
4023
- "product-pages",
4024
- "list.js"
4277
+ "flows",
4278
+ "config",
4279
+ "preview.js"
4025
4280
  ]
4026
4281
  },
4027
- "asa:product-pages:sync": {
4282
+ "flows:config:update": {
4028
4283
  "aliases": [],
4029
- "args": {},
4030
- "description": "Refresh custom product pages from Apple",
4284
+ "args": {
4285
+ "flow_id": {
4286
+ "description": "Flow ID (UUID)",
4287
+ "name": "flow_id",
4288
+ "required": true
4289
+ }
4290
+ },
4291
+ "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4031
4292
  "examples": [
4032
- "<%= config.bin %> asa product-pages sync",
4033
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
4293
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4294
+ "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4295
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4034
4296
  ],
4035
4297
  "flags": {
4036
4298
  "json": {
@@ -4040,23 +4302,38 @@
4040
4302
  "allowNo": false,
4041
4303
  "type": "boolean"
4042
4304
  },
4043
- "yes": {
4044
- "char": "y",
4045
- "description": "Apply without asking; required when the output is piped or --json is used",
4046
- "name": "yes",
4047
- "allowNo": false,
4048
- "type": "boolean"
4305
+ "app": {
4306
+ "description": "App ID (UUID)",
4307
+ "name": "app",
4308
+ "required": true,
4309
+ "hasDynamicHelp": false,
4310
+ "multiple": false,
4311
+ "type": "option"
4049
4312
  },
4050
- "idempotency-key": {
4051
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4052
- "name": "idempotency-key",
4313
+ "config": {
4314
+ "description": "Builder config as a JSON string",
4315
+ "name": "config",
4053
4316
  "hasDynamicHelp": false,
4054
4317
  "multiple": false,
4055
4318
  "type": "option"
4056
4319
  },
4057
- "adam-id": {
4058
- "description": "Limit the refresh to one app; omit to cover every app",
4059
- "name": "adam-id",
4320
+ "config-file": {
4321
+ "description": "JSON file with the builder config, or - to read stdin",
4322
+ "name": "config-file",
4323
+ "hasDynamicHelp": false,
4324
+ "multiple": false,
4325
+ "type": "option"
4326
+ },
4327
+ "expected-updated-at": {
4328
+ "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4329
+ "name": "expected-updated-at",
4330
+ "hasDynamicHelp": false,
4331
+ "multiple": false,
4332
+ "type": "option"
4333
+ },
4334
+ "remote-configs": {
4335
+ "description": "JSON array of remote config entries: [{locale, data}]",
4336
+ "name": "remote-configs",
4060
4337
  "hasDynamicHelp": false,
4061
4338
  "multiple": false,
4062
4339
  "type": "option"
@@ -4064,7 +4341,7 @@
4064
4341
  },
4065
4342
  "hasDynamicHelp": false,
4066
4343
  "hiddenAliases": [],
4067
- "id": "asa:product-pages:sync",
4344
+ "id": "flows:config:update",
4068
4345
  "pluginAlias": "adapty",
4069
4346
  "pluginName": "adapty",
4070
4347
  "pluginType": "core",
@@ -4074,17 +4351,25 @@
4074
4351
  "relativePath": [
4075
4352
  "dist",
4076
4353
  "commands",
4077
- "asa",
4078
- "product-pages",
4079
- "sync.js"
4354
+ "flows",
4355
+ "config",
4356
+ "update.js"
4080
4357
  ]
4081
4358
  },
4082
- "asa:orgs:list": {
4359
+ "flows:config:validate": {
4083
4360
  "aliases": [],
4084
- "args": {},
4085
- "description": "List the Apple Search Ads organizations this company can spend from",
4361
+ "args": {
4362
+ "flow_id": {
4363
+ "description": "Flow ID (UUID)",
4364
+ "name": "flow_id",
4365
+ "required": true
4366
+ }
4367
+ },
4368
+ "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4086
4369
  "examples": [
4087
- "<%= config.bin %> asa orgs list"
4370
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4371
+ "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4372
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4088
4373
  ],
4089
4374
  "flags": {
4090
4375
  "json": {
@@ -4094,18 +4379,24 @@
4094
4379
  "allowNo": false,
4095
4380
  "type": "boolean"
4096
4381
  },
4097
- "page": {
4098
- "description": "Page number",
4099
- "name": "page",
4100
- "default": 1,
4382
+ "app": {
4383
+ "description": "App ID (UUID)",
4384
+ "name": "app",
4385
+ "required": true,
4101
4386
  "hasDynamicHelp": false,
4102
4387
  "multiple": false,
4103
4388
  "type": "option"
4104
4389
  },
4105
- "page-size": {
4106
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4107
- "name": "page-size",
4108
- "default": 100,
4390
+ "config": {
4391
+ "description": "Builder config as a JSON string",
4392
+ "name": "config",
4393
+ "hasDynamicHelp": false,
4394
+ "multiple": false,
4395
+ "type": "option"
4396
+ },
4397
+ "config-file": {
4398
+ "description": "JSON file with the builder config, or - to read stdin",
4399
+ "name": "config-file",
4109
4400
  "hasDynamicHelp": false,
4110
4401
  "multiple": false,
4111
4402
  "type": "option"
@@ -4113,7 +4404,7 @@
4113
4404
  },
4114
4405
  "hasDynamicHelp": false,
4115
4406
  "hiddenAliases": [],
4116
- "id": "asa:orgs:list",
4407
+ "id": "flows:config:validate",
4117
4408
  "pluginAlias": "adapty",
4118
4409
  "pluginName": "adapty",
4119
4410
  "pluginType": "core",
@@ -4123,19 +4414,18 @@
4123
4414
  "relativePath": [
4124
4415
  "dist",
4125
4416
  "commands",
4126
- "asa",
4127
- "orgs",
4128
- "list.js"
4417
+ "flows",
4418
+ "config",
4419
+ "validate.js"
4129
4420
  ]
4130
4421
  },
4131
- "asa:negative-keywords:add": {
4422
+ "asa:automations:create": {
4132
4423
  "aliases": [],
4133
4424
  "args": {},
4134
- "description": "Add negative keywords to an ad group or across a campaign",
4425
+ "description": "Create an automation rule from a JSON rule file",
4135
4426
  "examples": [
4136
- "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
4137
- "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
4138
- "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
4427
+ "<%= config.bin %> asa automations create --file rule.json",
4428
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
4139
4429
  ],
4140
4430
  "flags": {
4141
4431
  "json": {
@@ -4159,71 +4449,24 @@
4159
4449
  "multiple": false,
4160
4450
  "type": "option"
4161
4451
  },
4162
- "ad-group": {
4163
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
4164
- "exclusive": [
4165
- "campaign"
4166
- ],
4167
- "name": "ad-group",
4452
+ "file": {
4453
+ "description": "JSON file with the rule body, or - to read stdin",
4454
+ "name": "file",
4455
+ "required": true,
4168
4456
  "hasDynamicHelp": false,
4169
4457
  "multiple": false,
4170
4458
  "type": "option"
4171
4459
  },
4172
- "all-ad-groups": {
4173
- "dependsOn": [
4174
- "campaign"
4175
- ],
4176
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
4177
- "name": "all-ad-groups",
4460
+ "run-now": {
4461
+ "description": "Queue the first run right after the rule is stored",
4462
+ "name": "run-now",
4178
4463
  "allowNo": false,
4179
4464
  "type": "boolean"
4180
- },
4181
- "campaign": {
4182
- "description": "Campaign ID (UUID)",
4183
- "exclusive": [
4184
- "ad-group"
4185
- ],
4186
- "name": "campaign",
4187
- "hasDynamicHelp": false,
4188
- "multiple": false,
4189
- "type": "option"
4190
- },
4191
- "match-type": {
4192
- "description": "Match type",
4193
- "name": "match-type",
4194
- "default": "EXACT",
4195
- "hasDynamicHelp": false,
4196
- "multiple": false,
4197
- "options": [
4198
- "BROAD",
4199
- "EXACT"
4200
- ],
4201
- "type": "option"
4202
- },
4203
- "status": {
4204
- "description": "Keyword status",
4205
- "name": "status",
4206
- "default": "ACTIVE",
4207
- "hasDynamicHelp": false,
4208
- "multiple": false,
4209
- "options": [
4210
- "ACTIVE",
4211
- "PAUSED"
4212
- ],
4213
- "type": "option"
4214
- },
4215
- "text": {
4216
- "description": "Keyword text, repeatable",
4217
- "name": "text",
4218
- "required": true,
4219
- "hasDynamicHelp": false,
4220
- "multiple": true,
4221
- "type": "option"
4222
4465
  }
4223
4466
  },
4224
4467
  "hasDynamicHelp": false,
4225
4468
  "hiddenAliases": [],
4226
- "id": "asa:negative-keywords:add",
4469
+ "id": "asa:automations:create",
4227
4470
  "pluginAlias": "adapty",
4228
4471
  "pluginName": "adapty",
4229
4472
  "pluginType": "core",
@@ -4234,17 +4477,22 @@
4234
4477
  "dist",
4235
4478
  "commands",
4236
4479
  "asa",
4237
- "negative-keywords",
4238
- "add.js"
4480
+ "automations",
4481
+ "create.js"
4239
4482
  ]
4240
4483
  },
4241
- "asa:negative-keywords:list": {
4484
+ "asa:automations:get": {
4242
4485
  "aliases": [],
4243
- "args": {},
4244
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
4486
+ "args": {
4487
+ "automation_id": {
4488
+ "description": "Automation rule ID (UUID)",
4489
+ "name": "automation_id",
4490
+ "required": true
4491
+ }
4492
+ },
4493
+ "description": "Show one automation rule with its conditions and actions",
4245
4494
  "examples": [
4246
- "<%= config.bin %> asa negative-keywords list",
4247
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
4495
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
4248
4496
  ],
4249
4497
  "flags": {
4250
4498
  "json": {
@@ -4253,68 +4501,11 @@
4253
4501
  "name": "json",
4254
4502
  "allowNo": false,
4255
4503
  "type": "boolean"
4256
- },
4257
- "page": {
4258
- "description": "Page number",
4259
- "name": "page",
4260
- "default": 1,
4261
- "hasDynamicHelp": false,
4262
- "multiple": false,
4263
- "type": "option"
4264
- },
4265
- "page-size": {
4266
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4267
- "name": "page-size",
4268
- "default": 100,
4269
- "hasDynamicHelp": false,
4270
- "multiple": false,
4271
- "type": "option"
4272
- },
4273
- "app": {
4274
- "description": "Keep only rows in this app; repeatable",
4275
- "name": "app",
4276
- "hasDynamicHelp": false,
4277
- "multiple": true,
4278
- "type": "option"
4279
- },
4280
- "campaign-group": {
4281
- "description": "Keep only rows in this campaign group; repeatable",
4282
- "name": "campaign-group",
4283
- "hasDynamicHelp": false,
4284
- "multiple": true,
4285
- "type": "option"
4286
- },
4287
- "search": {
4288
- "description": "Case-insensitive substring match on the name",
4289
- "name": "search",
4290
- "hasDynamicHelp": false,
4291
- "multiple": false,
4292
- "type": "option"
4293
- },
4294
- "campaign": {
4295
- "description": "Keep only rows in this campaign; repeatable",
4296
- "name": "campaign",
4297
- "hasDynamicHelp": false,
4298
- "multiple": true,
4299
- "type": "option"
4300
- },
4301
- "ad-group": {
4302
- "description": "Keep only rows in this ad group; repeatable",
4303
- "name": "ad-group",
4304
- "hasDynamicHelp": false,
4305
- "multiple": true,
4306
- "type": "option"
4307
- },
4308
- "campaign-level-only": {
4309
- "description": "Keep only campaign-level rows (ad_group_id is null)",
4310
- "name": "campaign-level-only",
4311
- "allowNo": false,
4312
- "type": "boolean"
4313
4504
  }
4314
4505
  },
4315
4506
  "hasDynamicHelp": false,
4316
4507
  "hiddenAliases": [],
4317
- "id": "asa:negative-keywords:list",
4508
+ "id": "asa:automations:get",
4318
4509
  "pluginAlias": "adapty",
4319
4510
  "pluginName": "adapty",
4320
4511
  "pluginType": "core",
@@ -4325,22 +4516,16 @@
4325
4516
  "dist",
4326
4517
  "commands",
4327
4518
  "asa",
4328
- "negative-keywords",
4329
- "list.js"
4519
+ "automations",
4520
+ "get.js"
4330
4521
  ]
4331
4522
  },
4332
- "flows:config:get": {
4523
+ "asa:automations:list": {
4333
4524
  "aliases": [],
4334
- "args": {
4335
- "flow_id": {
4336
- "description": "Flow ID (UUID)",
4337
- "name": "flow_id",
4338
- "required": true
4339
- }
4340
- },
4341
- "description": "Read the flow builder config (404 until the config has been written at least once)",
4525
+ "args": {},
4526
+ "description": "List automation rules; status 1 is active, 0 is stopped",
4342
4527
  "examples": [
4343
- "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
4528
+ "<%= config.bin %> asa automations list"
4344
4529
  ],
4345
4530
  "flags": {
4346
4531
  "json": {
@@ -4350,10 +4535,18 @@
4350
4535
  "allowNo": false,
4351
4536
  "type": "boolean"
4352
4537
  },
4353
- "app": {
4354
- "description": "App ID (UUID)",
4355
- "name": "app",
4356
- "required": true,
4538
+ "page": {
4539
+ "description": "Page number",
4540
+ "name": "page",
4541
+ "default": 1,
4542
+ "hasDynamicHelp": false,
4543
+ "multiple": false,
4544
+ "type": "option"
4545
+ },
4546
+ "page-size": {
4547
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4548
+ "name": "page-size",
4549
+ "default": 100,
4357
4550
  "hasDynamicHelp": false,
4358
4551
  "multiple": false,
4359
4552
  "type": "option"
@@ -4361,7 +4554,7 @@
4361
4554
  },
4362
4555
  "hasDynamicHelp": false,
4363
4556
  "hiddenAliases": [],
4364
- "id": "flows:config:get",
4557
+ "id": "asa:automations:list",
4365
4558
  "pluginAlias": "adapty",
4366
4559
  "pluginName": "adapty",
4367
4560
  "pluginType": "core",
@@ -4371,26 +4564,24 @@
4371
4564
  "relativePath": [
4372
4565
  "dist",
4373
4566
  "commands",
4374
- "flows",
4375
- "config",
4376
- "get.js"
4567
+ "asa",
4568
+ "automations",
4569
+ "list.js"
4377
4570
  ]
4378
4571
  },
4379
- "flows:config:preview": {
4572
+ "asa:automations:run": {
4380
4573
  "aliases": [],
4381
4574
  "args": {
4382
- "config_file": {
4383
- "description": "Path to a local flow config JSON file",
4384
- "name": "config_file",
4575
+ "automation_id": {
4576
+ "description": "Automation rule ID (UUID)",
4577
+ "name": "automation_id",
4385
4578
  "required": true
4386
4579
  }
4387
4580
  },
4388
- "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
4581
+ "description": "Run an automation rule now; the run is queued, not awaited",
4389
4582
  "examples": [
4390
- "<%= config.bin %> flows config preview ./config.json",
4391
- "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4392
- "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
4393
- "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
4583
+ "<%= config.bin %> asa automations run UUID",
4584
+ "<%= config.bin %> asa automations run UUID --dry-run"
4394
4585
  ],
4395
4586
  "flags": {
4396
4587
  "json": {
@@ -4400,37 +4591,30 @@
4400
4591
  "allowNo": false,
4401
4592
  "type": "boolean"
4402
4593
  },
4403
- "device": {
4404
- "description": "Device frame to render in",
4405
- "name": "device",
4406
- "default": "iphone-14",
4407
- "hasDynamicHelp": false,
4408
- "multiple": false,
4409
- "type": "option"
4594
+ "yes": {
4595
+ "char": "y",
4596
+ "description": "Apply without asking; required when the output is piped or --json is used",
4597
+ "name": "yes",
4598
+ "allowNo": false,
4599
+ "type": "boolean"
4410
4600
  },
4411
- "orientation": {
4412
- "description": "Device orientation to render in",
4413
- "name": "orientation",
4414
- "default": "portrait",
4601
+ "idempotency-key": {
4602
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4603
+ "name": "idempotency-key",
4415
4604
  "hasDynamicHelp": false,
4416
4605
  "multiple": false,
4417
- "options": [
4418
- "landscape",
4419
- "portrait"
4420
- ],
4421
4606
  "type": "option"
4422
4607
  },
4423
- "screen": {
4424
- "description": "Screen ID to render (default: the flow's first screen)",
4425
- "name": "screen",
4426
- "hasDynamicHelp": false,
4427
- "multiple": false,
4428
- "type": "option"
4608
+ "dry-run": {
4609
+ "description": "Evaluate and log the rule without touching Apple",
4610
+ "name": "dry-run",
4611
+ "allowNo": false,
4612
+ "type": "boolean"
4429
4613
  }
4430
4614
  },
4431
4615
  "hasDynamicHelp": false,
4432
4616
  "hiddenAliases": [],
4433
- "id": "flows:config:preview",
4617
+ "id": "asa:automations:run",
4434
4618
  "pluginAlias": "adapty",
4435
4619
  "pluginName": "adapty",
4436
4620
  "pluginType": "core",
@@ -4440,25 +4624,23 @@
4440
4624
  "relativePath": [
4441
4625
  "dist",
4442
4626
  "commands",
4443
- "flows",
4444
- "config",
4445
- "preview.js"
4627
+ "asa",
4628
+ "automations",
4629
+ "run.js"
4446
4630
  ]
4447
4631
  },
4448
- "flows:config:update": {
4632
+ "asa:automations:runs": {
4449
4633
  "aliases": [],
4450
4634
  "args": {
4451
- "flow_id": {
4452
- "description": "Flow ID (UUID)",
4453
- "name": "flow_id",
4635
+ "automation_id": {
4636
+ "description": "Automation rule ID (UUID)",
4637
+ "name": "automation_id",
4454
4638
  "required": true
4455
4639
  }
4456
4640
  },
4457
- "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4641
+ "description": "List past runs of an automation rule, including dry runs",
4458
4642
  "examples": [
4459
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4460
- "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4461
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4643
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
4462
4644
  ],
4463
4645
  "flags": {
4464
4646
  "json": {
@@ -4468,38 +4650,18 @@
4468
4650
  "allowNo": false,
4469
4651
  "type": "boolean"
4470
4652
  },
4471
- "app": {
4472
- "description": "App ID (UUID)",
4473
- "name": "app",
4474
- "required": true,
4475
- "hasDynamicHelp": false,
4476
- "multiple": false,
4477
- "type": "option"
4478
- },
4479
- "config": {
4480
- "description": "Builder config as a JSON string",
4481
- "name": "config",
4482
- "hasDynamicHelp": false,
4483
- "multiple": false,
4484
- "type": "option"
4485
- },
4486
- "config-file": {
4487
- "description": "JSON file with the builder config, or - to read stdin",
4488
- "name": "config-file",
4489
- "hasDynamicHelp": false,
4490
- "multiple": false,
4491
- "type": "option"
4492
- },
4493
- "expected-updated-at": {
4494
- "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4495
- "name": "expected-updated-at",
4653
+ "page": {
4654
+ "description": "Page number",
4655
+ "name": "page",
4656
+ "default": 1,
4496
4657
  "hasDynamicHelp": false,
4497
4658
  "multiple": false,
4498
4659
  "type": "option"
4499
4660
  },
4500
- "remote-configs": {
4501
- "description": "JSON array of remote config entries: [{locale, data}]",
4502
- "name": "remote-configs",
4661
+ "page-size": {
4662
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4663
+ "name": "page-size",
4664
+ "default": 100,
4503
4665
  "hasDynamicHelp": false,
4504
4666
  "multiple": false,
4505
4667
  "type": "option"
@@ -4507,7 +4669,7 @@
4507
4669
  },
4508
4670
  "hasDynamicHelp": false,
4509
4671
  "hiddenAliases": [],
4510
- "id": "flows:config:update",
4672
+ "id": "asa:automations:runs",
4511
4673
  "pluginAlias": "adapty",
4512
4674
  "pluginName": "adapty",
4513
4675
  "pluginType": "core",
@@ -4517,25 +4679,24 @@
4517
4679
  "relativePath": [
4518
4680
  "dist",
4519
4681
  "commands",
4520
- "flows",
4521
- "config",
4522
- "update.js"
4682
+ "asa",
4683
+ "automations",
4684
+ "runs.js"
4523
4685
  ]
4524
4686
  },
4525
- "flows:config:validate": {
4687
+ "asa:automations:update": {
4526
4688
  "aliases": [],
4527
4689
  "args": {
4528
- "flow_id": {
4529
- "description": "Flow ID (UUID)",
4530
- "name": "flow_id",
4690
+ "automation_id": {
4691
+ "description": "Automation rule ID (UUID)",
4692
+ "name": "automation_id",
4531
4693
  "required": true
4532
4694
  }
4533
4695
  },
4534
- "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4696
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
4535
4697
  "examples": [
4536
- "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4537
- "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4538
- "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4698
+ "<%= config.bin %> asa automations update UUID --stop",
4699
+ "<%= config.bin %> asa automations update UUID --file rule.json"
4539
4700
  ],
4540
4701
  "flags": {
4541
4702
  "json": {
@@ -4545,40 +4706,56 @@
4545
4706
  "allowNo": false,
4546
4707
  "type": "boolean"
4547
4708
  },
4548
- "app": {
4549
- "description": "App ID (UUID)",
4550
- "name": "app",
4551
- "required": true,
4552
- "hasDynamicHelp": false,
4553
- "multiple": false,
4554
- "type": "option"
4709
+ "yes": {
4710
+ "char": "y",
4711
+ "description": "Apply without asking; required when the output is piped or --json is used",
4712
+ "name": "yes",
4713
+ "allowNo": false,
4714
+ "type": "boolean"
4555
4715
  },
4556
- "config": {
4557
- "description": "Builder config as a JSON string",
4558
- "name": "config",
4716
+ "idempotency-key": {
4717
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4718
+ "name": "idempotency-key",
4559
4719
  "hasDynamicHelp": false,
4560
4720
  "multiple": false,
4561
4721
  "type": "option"
4562
4722
  },
4563
- "config-file": {
4564
- "description": "JSON file with the builder config, or - to read stdin",
4565
- "name": "config-file",
4723
+ "file": {
4724
+ "description": "JSON file with the parts to change, or - to read stdin",
4725
+ "name": "file",
4566
4726
  "hasDynamicHelp": false,
4567
4727
  "multiple": false,
4568
4728
  "type": "option"
4569
4729
  },
4570
- "source": {
4571
- "description": "Caller attribution, sent as X-Adapty-Source (e.g. byo-cli)",
4572
- "name": "source",
4573
- "default": "adapty-cli",
4730
+ "name": {
4731
+ "description": "Rule name",
4732
+ "name": "name",
4574
4733
  "hasDynamicHelp": false,
4575
4734
  "multiple": false,
4576
4735
  "type": "option"
4736
+ },
4737
+ "start": {
4738
+ "description": "Activate the rule",
4739
+ "exclusive": [
4740
+ "stop"
4741
+ ],
4742
+ "name": "start",
4743
+ "allowNo": false,
4744
+ "type": "boolean"
4745
+ },
4746
+ "stop": {
4747
+ "description": "Stop the rule and clear its next run",
4748
+ "exclusive": [
4749
+ "start"
4750
+ ],
4751
+ "name": "stop",
4752
+ "allowNo": false,
4753
+ "type": "boolean"
4577
4754
  }
4578
4755
  },
4579
4756
  "hasDynamicHelp": false,
4580
4757
  "hiddenAliases": [],
4581
- "id": "flows:config:validate",
4758
+ "id": "asa:automations:update",
4582
4759
  "pluginAlias": "adapty",
4583
4760
  "pluginName": "adapty",
4584
4761
  "pluginType": "core",
@@ -4588,18 +4765,23 @@
4588
4765
  "relativePath": [
4589
4766
  "dist",
4590
4767
  "commands",
4591
- "flows",
4592
- "config",
4593
- "validate.js"
4768
+ "asa",
4769
+ "automations",
4770
+ "update.js"
4594
4771
  ]
4595
4772
  },
4596
- "asa:search-terms:list": {
4773
+ "flows:media:upload": {
4597
4774
  "aliases": [],
4598
- "args": {},
4599
- "description": "List the search terms your ads matched, with their metrics",
4775
+ "args": {
4776
+ "file": {
4777
+ "description": "Path to the image file to upload",
4778
+ "name": "file",
4779
+ "required": true
4780
+ }
4781
+ },
4782
+ "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
4600
4783
  "examples": [
4601
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4602
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4784
+ "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
4603
4785
  ],
4604
4786
  "flags": {
4605
4787
  "json": {
@@ -4609,75 +4791,18 @@
4609
4791
  "allowNo": false,
4610
4792
  "type": "boolean"
4611
4793
  },
4612
- "page": {
4613
- "description": "Page number",
4614
- "name": "page",
4615
- "default": 1,
4616
- "hasDynamicHelp": false,
4617
- "multiple": false,
4618
- "type": "option"
4619
- },
4620
- "page-size": {
4621
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4622
- "name": "page-size",
4623
- "default": 100,
4624
- "hasDynamicHelp": false,
4625
- "multiple": false,
4626
- "type": "option"
4627
- },
4628
- "date-from": {
4629
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4630
- "name": "date-from",
4631
- "hasDynamicHelp": false,
4632
- "multiple": false,
4633
- "type": "option"
4634
- },
4635
- "date-to": {
4636
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4637
- "name": "date-to",
4638
- "hasDynamicHelp": false,
4639
- "multiple": false,
4640
- "type": "option"
4641
- },
4642
4794
  "app": {
4643
- "description": "Keep only rows in this app; repeatable",
4795
+ "description": "App ID (UUID)",
4644
4796
  "name": "app",
4645
- "hasDynamicHelp": false,
4646
- "multiple": true,
4647
- "type": "option"
4648
- },
4649
- "campaign-group": {
4650
- "description": "Keep only rows in this campaign group; repeatable",
4651
- "name": "campaign-group",
4652
- "hasDynamicHelp": false,
4653
- "multiple": true,
4654
- "type": "option"
4655
- },
4656
- "search": {
4657
- "description": "Case-insensitive substring match on the name",
4658
- "name": "search",
4797
+ "required": true,
4659
4798
  "hasDynamicHelp": false,
4660
4799
  "multiple": false,
4661
4800
  "type": "option"
4662
- },
4663
- "campaign": {
4664
- "description": "Keep only rows in this campaign; repeatable",
4665
- "name": "campaign",
4666
- "hasDynamicHelp": false,
4667
- "multiple": true,
4668
- "type": "option"
4669
- },
4670
- "ad-group": {
4671
- "description": "Keep only rows in this ad group; repeatable",
4672
- "name": "ad-group",
4673
- "hasDynamicHelp": false,
4674
- "multiple": true,
4675
- "type": "option"
4676
4801
  }
4677
4802
  },
4678
4803
  "hasDynamicHelp": false,
4679
4804
  "hiddenAliases": [],
4680
- "id": "asa:search-terms:list",
4805
+ "id": "flows:media:upload",
4681
4806
  "pluginAlias": "adapty",
4682
4807
  "pluginName": "adapty",
4683
4808
  "pluginType": "core",
@@ -4687,11 +4812,11 @@
4687
4812
  "relativePath": [
4688
4813
  "dist",
4689
4814
  "commands",
4690
- "asa",
4691
- "search-terms",
4692
- "list.js"
4815
+ "flows",
4816
+ "media",
4817
+ "upload.js"
4693
4818
  ]
4694
4819
  }
4695
4820
  },
4696
- "version": "0.6.1-beta.0"
4821
+ "version": "0.8.0-beta.0"
4697
4822
  }