adapty 0.8.2 → 0.8.3-beta.1

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 (27) hide show
  1. package/dist/commands/asa/ad-groups/create.js +1 -1
  2. package/dist/commands/asa/ad-groups/update.js +1 -1
  3. package/dist/commands/asa/ads/create.js +1 -1
  4. package/dist/commands/asa/ads/update.js +1 -1
  5. package/dist/commands/asa/automations/create.js +1 -1
  6. package/dist/commands/asa/automations/run.js +1 -1
  7. package/dist/commands/asa/automations/update.js +1 -1
  8. package/dist/commands/asa/campaigns/bulk-create.js +1 -1
  9. package/dist/commands/asa/campaigns/create.js +1 -1
  10. package/dist/commands/asa/campaigns/update.js +1 -1
  11. package/dist/commands/asa/keywords/add.js +1 -1
  12. package/dist/commands/asa/keywords/update.js +1 -1
  13. package/dist/commands/asa/negative-keywords/add.js +1 -1
  14. package/dist/commands/asa/product-pages/sync.js +1 -1
  15. package/dist/commands/flows/publish.d.ts +15 -0
  16. package/dist/commands/flows/publish.js +47 -0
  17. package/dist/commands/flows/update.d.ts +15 -0
  18. package/dist/commands/flows/update.js +28 -0
  19. package/dist/commands/placements/create.js +18 -3
  20. package/dist/commands/placements/update.js +18 -3
  21. package/dist/lib/api-schemas.d.ts +10 -1
  22. package/dist/lib/placement-audiences.d.ts +6 -0
  23. package/dist/lib/placement-audiences.js +25 -0
  24. package/oclif.manifest.json +1459 -1350
  25. package/package.json +3 -2
  26. /package/dist/lib/{asa-confirm.d.ts → confirm.d.ts} +0 -0
  27. /package/dist/lib/{asa-confirm.js → confirm.js} +0 -0
package/oclif.manifest.json CHANGED
@@ -425,6 +425,85 @@
425
425
  "update.js"
426
426
  ]
427
427
  },
428
+ "asa:connect": {
429
+ "aliases": [],
430
+ "args": {},
431
+ "description": "Connect an Apple Search Ads account to this company",
432
+ "examples": [
433
+ "<%= config.bin %> asa connect",
434
+ "<%= config.bin %> asa connect --no-wait"
435
+ ],
436
+ "flags": {
437
+ "json": {
438
+ "description": "Format output as json.",
439
+ "helpGroup": "GLOBAL",
440
+ "name": "json",
441
+ "allowNo": false,
442
+ "type": "boolean"
443
+ },
444
+ "timeout": {
445
+ "description": "Seconds to wait for the browser step",
446
+ "name": "timeout",
447
+ "default": 300,
448
+ "hasDynamicHelp": false,
449
+ "multiple": false,
450
+ "type": "option"
451
+ },
452
+ "wait": {
453
+ "description": "Wait until Apple Ads reports as connected",
454
+ "name": "wait",
455
+ "allowNo": true,
456
+ "type": "boolean"
457
+ }
458
+ },
459
+ "hasDynamicHelp": false,
460
+ "hiddenAliases": [],
461
+ "id": "asa:connect",
462
+ "pluginAlias": "adapty",
463
+ "pluginName": "adapty",
464
+ "pluginType": "core",
465
+ "strict": true,
466
+ "enableJsonFlag": true,
467
+ "isESM": true,
468
+ "relativePath": [
469
+ "dist",
470
+ "commands",
471
+ "asa",
472
+ "connect.js"
473
+ ]
474
+ },
475
+ "asa:whoami": {
476
+ "aliases": [],
477
+ "args": {},
478
+ "description": "Show which company the token unlocks and whether Apple Ads is connected",
479
+ "examples": [
480
+ "<%= config.bin %> asa whoami"
481
+ ],
482
+ "flags": {
483
+ "json": {
484
+ "description": "Format output as json.",
485
+ "helpGroup": "GLOBAL",
486
+ "name": "json",
487
+ "allowNo": false,
488
+ "type": "boolean"
489
+ }
490
+ },
491
+ "hasDynamicHelp": false,
492
+ "hiddenAliases": [],
493
+ "id": "asa:whoami",
494
+ "pluginAlias": "adapty",
495
+ "pluginName": "adapty",
496
+ "pluginType": "core",
497
+ "strict": true,
498
+ "enableJsonFlag": true,
499
+ "isESM": true,
500
+ "relativePath": [
501
+ "dist",
502
+ "commands",
503
+ "asa",
504
+ "whoami.js"
505
+ ]
506
+ },
428
507
  "auth:login": {
429
508
  "aliases": [],
430
509
  "args": {},
@@ -577,13 +656,12 @@
577
656
  "whoami.js"
578
657
  ]
579
658
  },
580
- "asa:connect": {
659
+ "flows:create": {
581
660
  "aliases": [],
582
661
  "args": {},
583
- "description": "Connect an Apple Search Ads account to this company",
662
+ "description": "Create a flow (row only — write its config with `flows config update`)",
584
663
  "examples": [
585
- "<%= config.bin %> asa connect",
586
- "<%= config.bin %> asa connect --no-wait"
664
+ "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
587
665
  ],
588
666
  "flags": {
589
667
  "json": {
@@ -593,24 +671,26 @@
593
671
  "allowNo": false,
594
672
  "type": "boolean"
595
673
  },
596
- "timeout": {
597
- "description": "Seconds to wait for the browser step",
598
- "name": "timeout",
599
- "default": 300,
674
+ "app": {
675
+ "description": "App ID (UUID)",
676
+ "name": "app",
677
+ "required": true,
600
678
  "hasDynamicHelp": false,
601
679
  "multiple": false,
602
680
  "type": "option"
603
681
  },
604
- "wait": {
605
- "description": "Wait until Apple Ads reports as connected",
606
- "name": "wait",
607
- "allowNo": true,
608
- "type": "boolean"
682
+ "name": {
683
+ "description": "Flow name",
684
+ "name": "name",
685
+ "required": true,
686
+ "hasDynamicHelp": false,
687
+ "multiple": false,
688
+ "type": "option"
609
689
  }
610
690
  },
611
691
  "hasDynamicHelp": false,
612
692
  "hiddenAliases": [],
613
- "id": "asa:connect",
693
+ "id": "flows:create",
614
694
  "pluginAlias": "adapty",
615
695
  "pluginName": "adapty",
616
696
  "pluginType": "core",
@@ -620,16 +700,22 @@
620
700
  "relativePath": [
621
701
  "dist",
622
702
  "commands",
623
- "asa",
624
- "connect.js"
703
+ "flows",
704
+ "create.js"
625
705
  ]
626
706
  },
627
- "asa:whoami": {
707
+ "flows:get": {
628
708
  "aliases": [],
629
- "args": {},
630
- "description": "Show which company the token unlocks and whether Apple Ads is connected",
709
+ "args": {
710
+ "flow_id": {
711
+ "description": "Flow ID (UUID)",
712
+ "name": "flow_id",
713
+ "required": true
714
+ }
715
+ },
716
+ "description": "Get flow details",
631
717
  "examples": [
632
- "<%= config.bin %> asa whoami"
718
+ "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
633
719
  ],
634
720
  "flags": {
635
721
  "json": {
@@ -638,11 +724,19 @@
638
724
  "name": "json",
639
725
  "allowNo": false,
640
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"
641
735
  }
642
736
  },
643
737
  "hasDynamicHelp": false,
644
738
  "hiddenAliases": [],
645
- "id": "asa:whoami",
739
+ "id": "flows:get",
646
740
  "pluginAlias": "adapty",
647
741
  "pluginName": "adapty",
648
742
  "pluginType": "core",
@@ -652,16 +746,16 @@
652
746
  "relativePath": [
653
747
  "dist",
654
748
  "commands",
655
- "asa",
656
- "whoami.js"
749
+ "flows",
750
+ "get.js"
657
751
  ]
658
752
  },
659
- "flows:create": {
753
+ "flows:list": {
660
754
  "aliases": [],
661
755
  "args": {},
662
- "description": "Create a flow (row only — write its config with `flows config update`)",
756
+ "description": "List flows for an app",
663
757
  "examples": [
664
- "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
758
+ "<%= config.bin %> flows list --app 550e8400-..."
665
759
  ],
666
760
  "flags": {
667
761
  "json": {
@@ -679,10 +773,18 @@
679
773
  "multiple": false,
680
774
  "type": "option"
681
775
  },
682
- "name": {
683
- "description": "Flow name",
684
- "name": "name",
685
- "required": true,
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,
686
788
  "hasDynamicHelp": false,
687
789
  "multiple": false,
688
790
  "type": "option"
@@ -690,7 +792,7 @@
690
792
  },
691
793
  "hasDynamicHelp": false,
692
794
  "hiddenAliases": [],
693
- "id": "flows:create",
795
+ "id": "flows:list",
694
796
  "pluginAlias": "adapty",
695
797
  "pluginName": "adapty",
696
798
  "pluginType": "core",
@@ -701,10 +803,10 @@
701
803
  "dist",
702
804
  "commands",
703
805
  "flows",
704
- "create.js"
806
+ "list.js"
705
807
  ]
706
808
  },
707
- "flows:get": {
809
+ "flows:publish": {
708
810
  "aliases": [],
709
811
  "args": {
710
812
  "flow_id": {
@@ -713,9 +815,9 @@
713
815
  "required": true
714
816
  }
715
817
  },
716
- "description": "Get flow details",
818
+ "description": "Publish a flow (async — publication completes in the background)",
717
819
  "examples": [
718
- "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
820
+ "<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000"
719
821
  ],
720
822
  "flags": {
721
823
  "json": {
@@ -732,11 +834,18 @@
732
834
  "hasDynamicHelp": false,
733
835
  "multiple": false,
734
836
  "type": "option"
837
+ },
838
+ "yes": {
839
+ "char": "y",
840
+ "description": "Apply without asking; required when the output is piped or --json is used",
841
+ "name": "yes",
842
+ "allowNo": false,
843
+ "type": "boolean"
735
844
  }
736
845
  },
737
846
  "hasDynamicHelp": false,
738
847
  "hiddenAliases": [],
739
- "id": "flows:get",
848
+ "id": "flows:publish",
740
849
  "pluginAlias": "adapty",
741
850
  "pluginName": "adapty",
742
851
  "pluginType": "core",
@@ -747,15 +856,21 @@
747
856
  "dist",
748
857
  "commands",
749
858
  "flows",
750
- "get.js"
859
+ "publish.js"
751
860
  ]
752
861
  },
753
- "flows:list": {
862
+ "flows:update": {
754
863
  "aliases": [],
755
- "args": {},
756
- "description": "List flows for an app",
864
+ "args": {
865
+ "flow_id": {
866
+ "description": "Flow ID (UUID)",
867
+ "name": "flow_id",
868
+ "required": true
869
+ }
870
+ },
871
+ "description": "Rename a flow",
757
872
  "examples": [
758
- "<%= config.bin %> flows list --app 550e8400-..."
873
+ "<%= config.bin %> flows update --app UUID 550e8400-e29b-41d4-a716-446655440000 --name \"Onboarding v2\""
759
874
  ],
760
875
  "flags": {
761
876
  "json": {
@@ -773,18 +888,10 @@
773
888
  "multiple": false,
774
889
  "type": "option"
775
890
  },
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,
891
+ "name": {
892
+ "description": "New flow name",
893
+ "name": "name",
894
+ "required": true,
788
895
  "hasDynamicHelp": false,
789
896
  "multiple": false,
790
897
  "type": "option"
@@ -792,7 +899,7 @@
792
899
  },
793
900
  "hasDynamicHelp": false,
794
901
  "hiddenAliases": [],
795
- "id": "flows:list",
902
+ "id": "flows:update",
796
903
  "pluginAlias": "adapty",
797
904
  "pluginName": "adapty",
798
905
  "pluginType": "core",
@@ -803,7 +910,7 @@
803
910
  "dist",
804
911
  "commands",
805
912
  "flows",
806
- "list.js"
913
+ "update.js"
807
914
  ]
808
915
  },
809
916
  "paywalls:create": {
@@ -1077,7 +1184,8 @@
1077
1184
  "args": {},
1078
1185
  "description": "Create a placement with a paywall",
1079
1186
  "examples": [
1080
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1187
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1188
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
1081
1189
  "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1082
1190
  ],
1083
1191
  "flags": {
@@ -1097,7 +1205,7 @@
1097
1205
  "type": "option"
1098
1206
  },
1099
1207
  "audiences": {
1100
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1208
+ "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
1101
1209
  "name": "audiences",
1102
1210
  "hasDynamicHelp": false,
1103
1211
  "multiple": false,
@@ -1256,7 +1364,8 @@
1256
1364
  },
1257
1365
  "description": "Update a placement",
1258
1366
  "examples": [
1259
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1367
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1368
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
1260
1369
  "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1261
1370
  ],
1262
1371
  "flags": {
@@ -1276,7 +1385,7 @@
1276
1385
  "type": "option"
1277
1386
  },
1278
1387
  "audiences": {
1279
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1388
+ "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
1280
1389
  "name": "audiences",
1281
1390
  "hasDynamicHelp": false,
1282
1391
  "multiple": false,
@@ -1708,12 +1817,14 @@
1708
1817
  "list.js"
1709
1818
  ]
1710
1819
  },
1711
- "asa:ads:create": {
1820
+ "asa:ad-groups:create": {
1712
1821
  "aliases": [],
1713
1822
  "args": {},
1714
- "description": "Create an ad from a creative in an ad group",
1823
+ "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
1715
1824
  "examples": [
1716
- "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
1825
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1826
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
1827
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
1717
1828
  ],
1718
1829
  "flags": {
1719
1830
  "json": {
@@ -1723,45 +1834,100 @@
1723
1834
  "allowNo": false,
1724
1835
  "type": "boolean"
1725
1836
  },
1726
- "yes": {
1727
- "char": "y",
1728
- "description": "Apply without asking; required when the output is piped or --json is used",
1729
- "name": "yes",
1730
- "allowNo": false,
1731
- "type": "boolean"
1732
- },
1733
- "idempotency-key": {
1734
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1735
- "name": "idempotency-key",
1837
+ "currency": {
1838
+ "description": "Currency code for the amounts in this call",
1839
+ "name": "currency",
1840
+ "default": "USD",
1736
1841
  "hasDynamicHelp": false,
1737
1842
  "multiple": false,
1738
1843
  "type": "option"
1739
1844
  },
1740
- "ad-group": {
1741
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
1742
- "name": "ad-group",
1743
- "required": true,
1845
+ "end-time": {
1846
+ "description": "Schedule end (YYYY-MM-DD)",
1847
+ "name": "end-time",
1744
1848
  "hasDynamicHelp": false,
1745
1849
  "multiple": false,
1746
1850
  "type": "option"
1747
1851
  },
1748
- "creative-id": {
1749
- "description": "Apple creative ID from a product page or the default set",
1750
- "name": "creative-id",
1751
- "required": true,
1852
+ "start-time": {
1853
+ "description": "Schedule start (YYYY-MM-DD), defaults to today",
1854
+ "name": "start-time",
1752
1855
  "hasDynamicHelp": false,
1753
1856
  "multiple": false,
1754
1857
  "type": "option"
1755
1858
  },
1756
- "name": {
1757
- "description": "Ad name",
1758
- "name": "name",
1759
- "required": true,
1859
+ "pricing-model": {
1860
+ "description": "Pricing model; Apple requires one on every ad group",
1861
+ "name": "pricing-model",
1862
+ "default": "CPC",
1760
1863
  "hasDynamicHelp": false,
1761
1864
  "multiple": false,
1865
+ "options": [
1866
+ "CPC",
1867
+ "CPM"
1868
+ ],
1762
1869
  "type": "option"
1763
1870
  },
1764
- "status": {
1871
+ "yes": {
1872
+ "char": "y",
1873
+ "description": "Apply without asking; required when the output is piped or --json is used",
1874
+ "name": "yes",
1875
+ "allowNo": false,
1876
+ "type": "boolean"
1877
+ },
1878
+ "idempotency-key": {
1879
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1880
+ "name": "idempotency-key",
1881
+ "hasDynamicHelp": false,
1882
+ "multiple": false,
1883
+ "type": "option"
1884
+ },
1885
+ "automated": {
1886
+ "description": "Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)",
1887
+ "exclusive": [
1888
+ "automated-keywords"
1889
+ ],
1890
+ "name": "automated",
1891
+ "allowNo": false,
1892
+ "type": "boolean"
1893
+ },
1894
+ "automated-keywords": {
1895
+ "description": "Let Apple add keywords automatically",
1896
+ "name": "automated-keywords",
1897
+ "allowNo": true,
1898
+ "type": "boolean"
1899
+ },
1900
+ "campaign": {
1901
+ "description": "Campaign ID (UUID)",
1902
+ "name": "campaign",
1903
+ "required": true,
1904
+ "hasDynamicHelp": false,
1905
+ "multiple": false,
1906
+ "type": "option"
1907
+ },
1908
+ "cpa-goal": {
1909
+ "description": "CPA goal (amount, e.g. 50 or 12.50)",
1910
+ "name": "cpa-goal",
1911
+ "hasDynamicHelp": false,
1912
+ "multiple": false,
1913
+ "type": "option"
1914
+ },
1915
+ "default-bid": {
1916
+ "description": "Default bid; required unless --automated is set (amount, e.g. 50 or 12.50)",
1917
+ "name": "default-bid",
1918
+ "hasDynamicHelp": false,
1919
+ "multiple": false,
1920
+ "type": "option"
1921
+ },
1922
+ "name": {
1923
+ "description": "Ad group name",
1924
+ "name": "name",
1925
+ "required": true,
1926
+ "hasDynamicHelp": false,
1927
+ "multiple": false,
1928
+ "type": "option"
1929
+ },
1930
+ "status": {
1765
1931
  "description": "Initial status",
1766
1932
  "name": "status",
1767
1933
  "hasDynamicHelp": false,
@@ -1775,7 +1941,7 @@
1775
1941
  },
1776
1942
  "hasDynamicHelp": false,
1777
1943
  "hiddenAliases": [],
1778
- "id": "asa:ads:create",
1944
+ "id": "asa:ad-groups:create",
1779
1945
  "pluginAlias": "adapty",
1780
1946
  "pluginName": "adapty",
1781
1947
  "pluginType": "core",
@@ -1786,22 +1952,22 @@
1786
1952
  "dist",
1787
1953
  "commands",
1788
1954
  "asa",
1789
- "ads",
1955
+ "ad-groups",
1790
1956
  "create.js"
1791
1957
  ]
1792
1958
  },
1793
- "asa:ads:get": {
1959
+ "asa:ad-groups:get": {
1794
1960
  "aliases": [],
1795
1961
  "args": {
1796
- "ad_id": {
1797
- "description": "Ad ID (UUID)",
1798
- "name": "ad_id",
1962
+ "ad_group_id": {
1963
+ "description": "Ad group ID (UUID)",
1964
+ "name": "ad_group_id",
1799
1965
  "required": true
1800
1966
  }
1801
1967
  },
1802
- "description": "Show one ad and its serving state",
1968
+ "description": "Show one ad group; read numbers with asa metrics",
1803
1969
  "examples": [
1804
- "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
1970
+ "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
1805
1971
  ],
1806
1972
  "flags": {
1807
1973
  "json": {
@@ -1814,7 +1980,7 @@
1814
1980
  },
1815
1981
  "hasDynamicHelp": false,
1816
1982
  "hiddenAliases": [],
1817
- "id": "asa:ads:get",
1983
+ "id": "asa:ad-groups:get",
1818
1984
  "pluginAlias": "adapty",
1819
1985
  "pluginName": "adapty",
1820
1986
  "pluginType": "core",
@@ -1825,17 +1991,17 @@
1825
1991
  "dist",
1826
1992
  "commands",
1827
1993
  "asa",
1828
- "ads",
1994
+ "ad-groups",
1829
1995
  "get.js"
1830
1996
  ]
1831
1997
  },
1832
- "asa:ads:list": {
1998
+ "asa:ad-groups:list": {
1833
1999
  "aliases": [],
1834
2000
  "args": {},
1835
- "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
2001
+ "description": "List ad groups; read numbers with asa metrics",
1836
2002
  "examples": [
1837
- "<%= config.bin %> asa ads list",
1838
- "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
2003
+ "<%= config.bin %> asa ad-groups list",
2004
+ "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
1839
2005
  ],
1840
2006
  "flags": {
1841
2007
  "json": {
@@ -1861,16 +2027,9 @@
1861
2027
  "multiple": false,
1862
2028
  "type": "option"
1863
2029
  },
1864
- "ad-group": {
1865
- "description": "Keep only rows in this ad group; repeatable",
1866
- "name": "ad-group",
1867
- "hasDynamicHelp": false,
1868
- "multiple": true,
1869
- "type": "option"
1870
- },
1871
- "campaign": {
1872
- "description": "Keep only rows in this campaign; repeatable",
1873
- "name": "campaign",
2030
+ "app": {
2031
+ "description": "Keep only rows in this app; repeatable",
2032
+ "name": "app",
1874
2033
  "hasDynamicHelp": false,
1875
2034
  "multiple": true,
1876
2035
  "type": "option"
@@ -1889,6 +2048,13 @@
1889
2048
  "multiple": false,
1890
2049
  "type": "option"
1891
2050
  },
2051
+ "campaign": {
2052
+ "description": "Keep only rows in this campaign; repeatable",
2053
+ "name": "campaign",
2054
+ "hasDynamicHelp": false,
2055
+ "multiple": true,
2056
+ "type": "option"
2057
+ },
1892
2058
  "status": {
1893
2059
  "description": "Keep only rows in this state",
1894
2060
  "name": "status",
@@ -1903,7 +2069,7 @@
1903
2069
  },
1904
2070
  "hasDynamicHelp": false,
1905
2071
  "hiddenAliases": [],
1906
- "id": "asa:ads:list",
2072
+ "id": "asa:ad-groups:list",
1907
2073
  "pluginAlias": "adapty",
1908
2074
  "pluginName": "adapty",
1909
2075
  "pluginType": "core",
@@ -1914,89 +2080,23 @@
1914
2080
  "dist",
1915
2081
  "commands",
1916
2082
  "asa",
1917
- "ads",
2083
+ "ad-groups",
1918
2084
  "list.js"
1919
2085
  ]
1920
2086
  },
1921
- "asa:ads:update": {
2087
+ "asa:ad-groups:update": {
1922
2088
  "aliases": [],
1923
2089
  "args": {
1924
- "ad_id": {
1925
- "description": "Ad ID (UUID)",
1926
- "name": "ad_id",
2090
+ "ad_group_id": {
2091
+ "description": "Ad group ID (UUID)",
2092
+ "name": "ad_group_id",
1927
2093
  "required": true
1928
2094
  }
1929
2095
  },
1930
- "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
1931
- "examples": [
1932
- "<%= config.bin %> asa ads update UUID --status PAUSED"
1933
- ],
1934
- "flags": {
1935
- "json": {
1936
- "description": "Format output as json.",
1937
- "helpGroup": "GLOBAL",
1938
- "name": "json",
1939
- "allowNo": false,
1940
- "type": "boolean"
1941
- },
1942
- "yes": {
1943
- "char": "y",
1944
- "description": "Apply without asking; required when the output is piped or --json is used",
1945
- "name": "yes",
1946
- "allowNo": false,
1947
- "type": "boolean"
1948
- },
1949
- "idempotency-key": {
1950
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1951
- "name": "idempotency-key",
1952
- "hasDynamicHelp": false,
1953
- "multiple": false,
1954
- "type": "option"
1955
- },
1956
- "name": {
1957
- "description": "Ad name",
1958
- "name": "name",
1959
- "hasDynamicHelp": false,
1960
- "multiple": false,
1961
- "type": "option"
1962
- },
1963
- "status": {
1964
- "description": "Ad status",
1965
- "name": "status",
1966
- "hasDynamicHelp": false,
1967
- "multiple": false,
1968
- "options": [
1969
- "ENABLED",
1970
- "PAUSED"
1971
- ],
1972
- "type": "option"
1973
- }
1974
- },
1975
- "hasDynamicHelp": false,
1976
- "hiddenAliases": [],
1977
- "id": "asa:ads:update",
1978
- "pluginAlias": "adapty",
1979
- "pluginName": "adapty",
1980
- "pluginType": "core",
1981
- "strict": true,
1982
- "enableJsonFlag": true,
1983
- "isESM": true,
1984
- "relativePath": [
1985
- "dist",
1986
- "commands",
1987
- "asa",
1988
- "ads",
1989
- "update.js"
1990
- ]
1991
- },
1992
- "asa:ad-groups:create": {
1993
- "aliases": [],
1994
- "args": {},
1995
- "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
2096
+ "description": "Change an ad group: bid, CPA goal, status or schedule",
1996
2097
  "examples": [
1997
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1998
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
1999
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
2098
+ "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
2099
+ "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
2000
2100
  ],
2001
2101
  "flags": {
2002
2102
  "json": {
@@ -2028,18 +2128,6 @@
2028
2128
  "multiple": false,
2029
2129
  "type": "option"
2030
2130
  },
2031
- "pricing-model": {
2032
- "description": "Pricing model; Apple requires one on every ad group",
2033
- "name": "pricing-model",
2034
- "default": "CPC",
2035
- "hasDynamicHelp": false,
2036
- "multiple": false,
2037
- "options": [
2038
- "CPC",
2039
- "CPM"
2040
- ],
2041
- "type": "option"
2042
- },
2043
2131
  "yes": {
2044
2132
  "char": "y",
2045
2133
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2054,29 +2142,12 @@
2054
2142
  "multiple": false,
2055
2143
  "type": "option"
2056
2144
  },
2057
- "automated": {
2058
- "description": "Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)",
2059
- "exclusive": [
2060
- "automated-keywords"
2061
- ],
2062
- "name": "automated",
2063
- "allowNo": false,
2064
- "type": "boolean"
2065
- },
2066
2145
  "automated-keywords": {
2067
2146
  "description": "Let Apple add keywords automatically",
2068
2147
  "name": "automated-keywords",
2069
2148
  "allowNo": true,
2070
2149
  "type": "boolean"
2071
2150
  },
2072
- "campaign": {
2073
- "description": "Campaign ID (UUID)",
2074
- "name": "campaign",
2075
- "required": true,
2076
- "hasDynamicHelp": false,
2077
- "multiple": false,
2078
- "type": "option"
2079
- },
2080
2151
  "cpa-goal": {
2081
2152
  "description": "CPA goal (amount, e.g. 50 or 12.50)",
2082
2153
  "name": "cpa-goal",
@@ -2085,7 +2156,7 @@
2085
2156
  "type": "option"
2086
2157
  },
2087
2158
  "default-bid": {
2088
- "description": "Default bid; required unless --automated is set (amount, e.g. 50 or 12.50)",
2159
+ "description": "Default bid (amount, e.g. 50 or 12.50)",
2089
2160
  "name": "default-bid",
2090
2161
  "hasDynamicHelp": false,
2091
2162
  "multiple": false,
@@ -2094,13 +2165,12 @@
2094
2165
  "name": {
2095
2166
  "description": "Ad group name",
2096
2167
  "name": "name",
2097
- "required": true,
2098
2168
  "hasDynamicHelp": false,
2099
2169
  "multiple": false,
2100
2170
  "type": "option"
2101
2171
  },
2102
2172
  "status": {
2103
- "description": "Initial status",
2173
+ "description": "Ad group status",
2104
2174
  "name": "status",
2105
2175
  "hasDynamicHelp": false,
2106
2176
  "multiple": false,
@@ -2113,7 +2183,7 @@
2113
2183
  },
2114
2184
  "hasDynamicHelp": false,
2115
2185
  "hiddenAliases": [],
2116
- "id": "asa:ad-groups:create",
2186
+ "id": "asa:ad-groups:update",
2117
2187
  "pluginAlias": "adapty",
2118
2188
  "pluginName": "adapty",
2119
2189
  "pluginType": "core",
@@ -2125,55 +2195,16 @@
2125
2195
  "commands",
2126
2196
  "asa",
2127
2197
  "ad-groups",
2128
- "create.js"
2198
+ "update.js"
2129
2199
  ]
2130
2200
  },
2131
- "asa:ad-groups:get": {
2201
+ "asa:apps:list": {
2132
2202
  "aliases": [],
2133
- "args": {
2134
- "ad_group_id": {
2135
- "description": "Ad group ID (UUID)",
2136
- "name": "ad_group_id",
2137
- "required": true
2138
- }
2139
- },
2140
- "description": "Show one ad group; read numbers with asa metrics",
2203
+ "args": {},
2204
+ "description": "List the apps promoted by this company in Apple Search Ads",
2141
2205
  "examples": [
2142
- "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
2143
- ],
2144
- "flags": {
2145
- "json": {
2146
- "description": "Format output as json.",
2147
- "helpGroup": "GLOBAL",
2148
- "name": "json",
2149
- "allowNo": false,
2150
- "type": "boolean"
2151
- }
2152
- },
2153
- "hasDynamicHelp": false,
2154
- "hiddenAliases": [],
2155
- "id": "asa:ad-groups:get",
2156
- "pluginAlias": "adapty",
2157
- "pluginName": "adapty",
2158
- "pluginType": "core",
2159
- "strict": true,
2160
- "enableJsonFlag": true,
2161
- "isESM": true,
2162
- "relativePath": [
2163
- "dist",
2164
- "commands",
2165
- "asa",
2166
- "ad-groups",
2167
- "get.js"
2168
- ]
2169
- },
2170
- "asa:ad-groups:list": {
2171
- "aliases": [],
2172
- "args": {},
2173
- "description": "List ad groups; read numbers with asa metrics",
2174
- "examples": [
2175
- "<%= config.bin %> asa ad-groups list",
2176
- "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
2206
+ "<%= config.bin %> asa apps list",
2207
+ "<%= config.bin %> asa apps list --page 2 --page-size 50"
2177
2208
  ],
2178
2209
  "flags": {
2179
2210
  "json": {
@@ -2198,50 +2229,11 @@
2198
2229
  "hasDynamicHelp": false,
2199
2230
  "multiple": false,
2200
2231
  "type": "option"
2201
- },
2202
- "app": {
2203
- "description": "Keep only rows in this app; repeatable",
2204
- "name": "app",
2205
- "hasDynamicHelp": false,
2206
- "multiple": true,
2207
- "type": "option"
2208
- },
2209
- "campaign-group": {
2210
- "description": "Keep only rows in this campaign group; repeatable",
2211
- "name": "campaign-group",
2212
- "hasDynamicHelp": false,
2213
- "multiple": true,
2214
- "type": "option"
2215
- },
2216
- "search": {
2217
- "description": "Case-insensitive substring match on the name",
2218
- "name": "search",
2219
- "hasDynamicHelp": false,
2220
- "multiple": false,
2221
- "type": "option"
2222
- },
2223
- "campaign": {
2224
- "description": "Keep only rows in this campaign; repeatable",
2225
- "name": "campaign",
2226
- "hasDynamicHelp": false,
2227
- "multiple": true,
2228
- "type": "option"
2229
- },
2230
- "status": {
2231
- "description": "Keep only rows in this state",
2232
- "name": "status",
2233
- "hasDynamicHelp": false,
2234
- "multiple": false,
2235
- "options": [
2236
- "ENABLED",
2237
- "PAUSED"
2238
- ],
2239
- "type": "option"
2240
2232
  }
2241
2233
  },
2242
2234
  "hasDynamicHelp": false,
2243
2235
  "hiddenAliases": [],
2244
- "id": "asa:ad-groups:list",
2236
+ "id": "asa:apps:list",
2245
2237
  "pluginAlias": "adapty",
2246
2238
  "pluginName": "adapty",
2247
2239
  "pluginType": "core",
@@ -2252,23 +2244,16 @@
2252
2244
  "dist",
2253
2245
  "commands",
2254
2246
  "asa",
2255
- "ad-groups",
2247
+ "apps",
2256
2248
  "list.js"
2257
2249
  ]
2258
2250
  },
2259
- "asa:ad-groups:update": {
2251
+ "asa:ads:create": {
2260
2252
  "aliases": [],
2261
- "args": {
2262
- "ad_group_id": {
2263
- "description": "Ad group ID (UUID)",
2264
- "name": "ad_group_id",
2265
- "required": true
2266
- }
2267
- },
2268
- "description": "Change an ad group: bid, CPA goal, status or schedule",
2253
+ "args": {},
2254
+ "description": "Create an ad from a creative in an ad group",
2269
2255
  "examples": [
2270
- "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
2271
- "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
2256
+ "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
2272
2257
  ],
2273
2258
  "flags": {
2274
2259
  "json": {
@@ -2278,28 +2263,6 @@
2278
2263
  "allowNo": false,
2279
2264
  "type": "boolean"
2280
2265
  },
2281
- "currency": {
2282
- "description": "Currency code for the amounts in this call",
2283
- "name": "currency",
2284
- "default": "USD",
2285
- "hasDynamicHelp": false,
2286
- "multiple": false,
2287
- "type": "option"
2288
- },
2289
- "end-time": {
2290
- "description": "Schedule end (YYYY-MM-DD)",
2291
- "name": "end-time",
2292
- "hasDynamicHelp": false,
2293
- "multiple": false,
2294
- "type": "option"
2295
- },
2296
- "start-time": {
2297
- "description": "Schedule start (YYYY-MM-DD), defaults to today",
2298
- "name": "start-time",
2299
- "hasDynamicHelp": false,
2300
- "multiple": false,
2301
- "type": "option"
2302
- },
2303
2266
  "yes": {
2304
2267
  "char": "y",
2305
2268
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2314,35 +2277,32 @@
2314
2277
  "multiple": false,
2315
2278
  "type": "option"
2316
2279
  },
2317
- "automated-keywords": {
2318
- "description": "Let Apple add keywords automatically",
2319
- "name": "automated-keywords",
2320
- "allowNo": true,
2321
- "type": "boolean"
2322
- },
2323
- "cpa-goal": {
2324
- "description": "CPA goal (amount, e.g. 50 or 12.50)",
2325
- "name": "cpa-goal",
2280
+ "ad-group": {
2281
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
2282
+ "name": "ad-group",
2283
+ "required": true,
2326
2284
  "hasDynamicHelp": false,
2327
2285
  "multiple": false,
2328
2286
  "type": "option"
2329
2287
  },
2330
- "default-bid": {
2331
- "description": "Default bid (amount, e.g. 50 or 12.50)",
2332
- "name": "default-bid",
2288
+ "creative-id": {
2289
+ "description": "Apple creative ID from a product page or the default set",
2290
+ "name": "creative-id",
2291
+ "required": true,
2333
2292
  "hasDynamicHelp": false,
2334
2293
  "multiple": false,
2335
2294
  "type": "option"
2336
2295
  },
2337
2296
  "name": {
2338
- "description": "Ad group name",
2297
+ "description": "Ad name",
2339
2298
  "name": "name",
2299
+ "required": true,
2340
2300
  "hasDynamicHelp": false,
2341
2301
  "multiple": false,
2342
2302
  "type": "option"
2343
2303
  },
2344
2304
  "status": {
2345
- "description": "Ad group status",
2305
+ "description": "Initial status",
2346
2306
  "name": "status",
2347
2307
  "hasDynamicHelp": false,
2348
2308
  "multiple": false,
@@ -2355,7 +2315,7 @@
2355
2315
  },
2356
2316
  "hasDynamicHelp": false,
2357
2317
  "hiddenAliases": [],
2358
- "id": "asa:ad-groups:update",
2318
+ "id": "asa:ads:create",
2359
2319
  "pluginAlias": "adapty",
2360
2320
  "pluginName": "adapty",
2361
2321
  "pluginType": "core",
@@ -2366,17 +2326,56 @@
2366
2326
  "dist",
2367
2327
  "commands",
2368
2328
  "asa",
2369
- "ad-groups",
2370
- "update.js"
2329
+ "ads",
2330
+ "create.js"
2371
2331
  ]
2372
2332
  },
2373
- "asa:apps:list": {
2333
+ "asa:ads:get": {
2334
+ "aliases": [],
2335
+ "args": {
2336
+ "ad_id": {
2337
+ "description": "Ad ID (UUID)",
2338
+ "name": "ad_id",
2339
+ "required": true
2340
+ }
2341
+ },
2342
+ "description": "Show one ad and its serving state",
2343
+ "examples": [
2344
+ "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
2345
+ ],
2346
+ "flags": {
2347
+ "json": {
2348
+ "description": "Format output as json.",
2349
+ "helpGroup": "GLOBAL",
2350
+ "name": "json",
2351
+ "allowNo": false,
2352
+ "type": "boolean"
2353
+ }
2354
+ },
2355
+ "hasDynamicHelp": false,
2356
+ "hiddenAliases": [],
2357
+ "id": "asa:ads:get",
2358
+ "pluginAlias": "adapty",
2359
+ "pluginName": "adapty",
2360
+ "pluginType": "core",
2361
+ "strict": true,
2362
+ "enableJsonFlag": true,
2363
+ "isESM": true,
2364
+ "relativePath": [
2365
+ "dist",
2366
+ "commands",
2367
+ "asa",
2368
+ "ads",
2369
+ "get.js"
2370
+ ]
2371
+ },
2372
+ "asa:ads:list": {
2374
2373
  "aliases": [],
2375
2374
  "args": {},
2376
- "description": "List the apps promoted by this company in Apple Search Ads",
2375
+ "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
2377
2376
  "examples": [
2378
- "<%= config.bin %> asa apps list",
2379
- "<%= config.bin %> asa apps list --page 2 --page-size 50"
2377
+ "<%= config.bin %> asa ads list",
2378
+ "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
2380
2379
  ],
2381
2380
  "flags": {
2382
2381
  "json": {
@@ -2401,11 +2400,50 @@
2401
2400
  "hasDynamicHelp": false,
2402
2401
  "multiple": false,
2403
2402
  "type": "option"
2403
+ },
2404
+ "ad-group": {
2405
+ "description": "Keep only rows in this ad group; repeatable",
2406
+ "name": "ad-group",
2407
+ "hasDynamicHelp": false,
2408
+ "multiple": true,
2409
+ "type": "option"
2410
+ },
2411
+ "campaign": {
2412
+ "description": "Keep only rows in this campaign; repeatable",
2413
+ "name": "campaign",
2414
+ "hasDynamicHelp": false,
2415
+ "multiple": true,
2416
+ "type": "option"
2417
+ },
2418
+ "campaign-group": {
2419
+ "description": "Keep only rows in this campaign group; repeatable",
2420
+ "name": "campaign-group",
2421
+ "hasDynamicHelp": false,
2422
+ "multiple": true,
2423
+ "type": "option"
2424
+ },
2425
+ "search": {
2426
+ "description": "Case-insensitive substring match on the name",
2427
+ "name": "search",
2428
+ "hasDynamicHelp": false,
2429
+ "multiple": false,
2430
+ "type": "option"
2431
+ },
2432
+ "status": {
2433
+ "description": "Keep only rows in this state",
2434
+ "name": "status",
2435
+ "hasDynamicHelp": false,
2436
+ "multiple": false,
2437
+ "options": [
2438
+ "ENABLED",
2439
+ "PAUSED"
2440
+ ],
2441
+ "type": "option"
2404
2442
  }
2405
2443
  },
2406
2444
  "hasDynamicHelp": false,
2407
2445
  "hiddenAliases": [],
2408
- "id": "asa:apps:list",
2446
+ "id": "asa:ads:list",
2409
2447
  "pluginAlias": "adapty",
2410
2448
  "pluginName": "adapty",
2411
2449
  "pluginType": "core",
@@ -2416,17 +2454,22 @@
2416
2454
  "dist",
2417
2455
  "commands",
2418
2456
  "asa",
2419
- "apps",
2457
+ "ads",
2420
2458
  "list.js"
2421
2459
  ]
2422
2460
  },
2423
- "asa:automations:create": {
2461
+ "asa:ads:update": {
2424
2462
  "aliases": [],
2425
- "args": {},
2426
- "description": "Create an automation rule from a JSON rule file",
2463
+ "args": {
2464
+ "ad_id": {
2465
+ "description": "Ad ID (UUID)",
2466
+ "name": "ad_id",
2467
+ "required": true
2468
+ }
2469
+ },
2470
+ "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
2427
2471
  "examples": [
2428
- "<%= config.bin %> asa automations create --file rule.json",
2429
- "<%= config.bin %> asa automations create --file rule.json --run-now"
2472
+ "<%= config.bin %> asa ads update UUID --status PAUSED"
2430
2473
  ],
2431
2474
  "flags": {
2432
2475
  "json": {
@@ -2450,24 +2493,28 @@
2450
2493
  "multiple": false,
2451
2494
  "type": "option"
2452
2495
  },
2453
- "file": {
2454
- "description": "JSON file with the rule body, or - to read stdin",
2455
- "name": "file",
2456
- "required": true,
2496
+ "name": {
2497
+ "description": "Ad name",
2498
+ "name": "name",
2457
2499
  "hasDynamicHelp": false,
2458
2500
  "multiple": false,
2459
2501
  "type": "option"
2460
2502
  },
2461
- "run-now": {
2462
- "description": "Queue the first run right after the rule is stored",
2463
- "name": "run-now",
2464
- "allowNo": false,
2465
- "type": "boolean"
2466
- }
2467
- },
2468
- "hasDynamicHelp": false,
2469
- "hiddenAliases": [],
2470
- "id": "asa:automations:create",
2503
+ "status": {
2504
+ "description": "Ad status",
2505
+ "name": "status",
2506
+ "hasDynamicHelp": false,
2507
+ "multiple": false,
2508
+ "options": [
2509
+ "ENABLED",
2510
+ "PAUSED"
2511
+ ],
2512
+ "type": "option"
2513
+ }
2514
+ },
2515
+ "hasDynamicHelp": false,
2516
+ "hiddenAliases": [],
2517
+ "id": "asa:ads:update",
2471
2518
  "pluginAlias": "adapty",
2472
2519
  "pluginName": "adapty",
2473
2520
  "pluginType": "core",
@@ -2478,22 +2525,19 @@
2478
2525
  "dist",
2479
2526
  "commands",
2480
2527
  "asa",
2481
- "automations",
2482
- "create.js"
2528
+ "ads",
2529
+ "update.js"
2483
2530
  ]
2484
2531
  },
2485
- "asa:automations:get": {
2532
+ "asa:campaigns:bulk-create": {
2486
2533
  "aliases": [],
2487
- "args": {
2488
- "automation_id": {
2489
- "description": "Automation rule ID (UUID)",
2490
- "name": "automation_id",
2491
- "required": true
2492
- }
2493
- },
2494
- "description": "Show one automation rule with its conditions and actions",
2534
+ "args": {},
2535
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2495
2536
  "examples": [
2496
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2537
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2538
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2539
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2540
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2497
2541
  ],
2498
2542
  "flags": {
2499
2543
  "json": {
@@ -2502,11 +2546,74 @@
2502
2546
  "name": "json",
2503
2547
  "allowNo": false,
2504
2548
  "type": "boolean"
2549
+ },
2550
+ "yes": {
2551
+ "char": "y",
2552
+ "description": "Apply without asking; required when the output is piped or --json is used",
2553
+ "name": "yes",
2554
+ "allowNo": false,
2555
+ "type": "boolean"
2556
+ },
2557
+ "idempotency-key": {
2558
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2559
+ "name": "idempotency-key",
2560
+ "hasDynamicHelp": false,
2561
+ "multiple": false,
2562
+ "type": "option"
2563
+ },
2564
+ "file": {
2565
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2566
+ "name": "file",
2567
+ "hasDynamicHelp": false,
2568
+ "multiple": false,
2569
+ "type": "option"
2570
+ },
2571
+ "from-file": {
2572
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2573
+ "name": "from-file",
2574
+ "hasDynamicHelp": false,
2575
+ "multiple": false,
2576
+ "type": "option"
2577
+ },
2578
+ "org-id": {
2579
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2580
+ "name": "org-id",
2581
+ "hasDynamicHelp": false,
2582
+ "multiple": false,
2583
+ "type": "option"
2584
+ },
2585
+ "poll-interval": {
2586
+ "description": "Seconds between progress polls",
2587
+ "name": "poll-interval",
2588
+ "default": 5,
2589
+ "hasDynamicHelp": false,
2590
+ "multiple": false,
2591
+ "type": "option"
2592
+ },
2593
+ "preview": {
2594
+ "description": "With --from-file: print the converted request and stop, nothing is created",
2595
+ "name": "preview",
2596
+ "allowNo": false,
2597
+ "type": "boolean"
2598
+ },
2599
+ "timeout": {
2600
+ "description": "Max seconds to wait for the operation to finish",
2601
+ "name": "timeout",
2602
+ "default": 900,
2603
+ "hasDynamicHelp": false,
2604
+ "multiple": false,
2605
+ "type": "option"
2606
+ },
2607
+ "wait": {
2608
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2609
+ "name": "wait",
2610
+ "allowNo": true,
2611
+ "type": "boolean"
2505
2612
  }
2506
2613
  },
2507
2614
  "hasDynamicHelp": false,
2508
2615
  "hiddenAliases": [],
2509
- "id": "asa:automations:get",
2616
+ "id": "asa:campaigns:bulk-create",
2510
2617
  "pluginAlias": "adapty",
2511
2618
  "pluginName": "adapty",
2512
2619
  "pluginType": "core",
@@ -2517,16 +2624,18 @@
2517
2624
  "dist",
2518
2625
  "commands",
2519
2626
  "asa",
2520
- "automations",
2521
- "get.js"
2627
+ "campaigns",
2628
+ "bulk-create.js"
2522
2629
  ]
2523
2630
  },
2524
- "asa:automations:list": {
2631
+ "asa:campaigns:bulk-list": {
2525
2632
  "aliases": [],
2526
2633
  "args": {},
2527
- "description": "List automation rules; status 1 is active, 0 is stopped",
2634
+ "description": "This company's bulk operations, newest first; inspect one with bulk-status",
2528
2635
  "examples": [
2529
- "<%= config.bin %> asa automations list"
2636
+ "<%= config.bin %> asa campaigns bulk-list",
2637
+ "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2638
+ "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
2530
2639
  ],
2531
2640
  "flags": {
2532
2641
  "json": {
@@ -2551,71 +2660,46 @@
2551
2660
  "hasDynamicHelp": false,
2552
2661
  "multiple": false,
2553
2662
  "type": "option"
2554
- }
2555
- },
2556
- "hasDynamicHelp": false,
2557
- "hiddenAliases": [],
2558
- "id": "asa:automations:list",
2559
- "pluginAlias": "adapty",
2560
- "pluginName": "adapty",
2561
- "pluginType": "core",
2562
- "strict": true,
2563
- "enableJsonFlag": true,
2564
- "isESM": true,
2565
- "relativePath": [
2566
- "dist",
2567
- "commands",
2568
- "asa",
2569
- "automations",
2570
- "list.js"
2571
- ]
2572
- },
2573
- "asa:automations:run": {
2574
- "aliases": [],
2575
- "args": {
2576
- "automation_id": {
2577
- "description": "Automation rule ID (UUID)",
2578
- "name": "automation_id",
2579
- "required": true
2580
- }
2581
- },
2582
- "description": "Run an automation rule now; the run is queued, not awaited",
2583
- "examples": [
2584
- "<%= config.bin %> asa automations run UUID",
2585
- "<%= config.bin %> asa automations run UUID --dry-run"
2586
- ],
2587
- "flags": {
2588
- "json": {
2589
- "description": "Format output as json.",
2590
- "helpGroup": "GLOBAL",
2591
- "name": "json",
2592
- "allowNo": false,
2593
- "type": "boolean"
2594
2663
  },
2595
- "yes": {
2596
- "char": "y",
2597
- "description": "Apply without asking; required when the output is piped or --json is used",
2598
- "name": "yes",
2599
- "allowNo": false,
2600
- "type": "boolean"
2664
+ "app": {
2665
+ "description": "Keep only operations of this app (UUID)",
2666
+ "name": "app",
2667
+ "hasDynamicHelp": false,
2668
+ "multiple": false,
2669
+ "type": "option"
2601
2670
  },
2602
- "idempotency-key": {
2603
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2604
- "name": "idempotency-key",
2671
+ "created-from": {
2672
+ "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
2673
+ "name": "created-from",
2605
2674
  "hasDynamicHelp": false,
2606
2675
  "multiple": false,
2607
2676
  "type": "option"
2608
2677
  },
2609
- "dry-run": {
2610
- "description": "Evaluate and log the rule without touching Apple",
2611
- "name": "dry-run",
2612
- "allowNo": false,
2613
- "type": "boolean"
2678
+ "created-to": {
2679
+ "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
2680
+ "name": "created-to",
2681
+ "hasDynamicHelp": false,
2682
+ "multiple": false,
2683
+ "type": "option"
2684
+ },
2685
+ "status": {
2686
+ "description": "Keep only operations in this state; repeatable",
2687
+ "name": "status",
2688
+ "hasDynamicHelp": false,
2689
+ "multiple": true,
2690
+ "options": [
2691
+ "failed",
2692
+ "partial",
2693
+ "pending",
2694
+ "running",
2695
+ "success"
2696
+ ],
2697
+ "type": "option"
2614
2698
  }
2615
2699
  },
2616
2700
  "hasDynamicHelp": false,
2617
2701
  "hiddenAliases": [],
2618
- "id": "asa:automations:run",
2702
+ "id": "asa:campaigns:bulk-list",
2619
2703
  "pluginAlias": "adapty",
2620
2704
  "pluginName": "adapty",
2621
2705
  "pluginType": "core",
@@ -2626,22 +2710,22 @@
2626
2710
  "dist",
2627
2711
  "commands",
2628
2712
  "asa",
2629
- "automations",
2630
- "run.js"
2713
+ "campaigns",
2714
+ "bulk-list.js"
2631
2715
  ]
2632
2716
  },
2633
- "asa:automations:runs": {
2717
+ "asa:campaigns:bulk-status": {
2634
2718
  "aliases": [],
2635
2719
  "args": {
2636
- "automation_id": {
2637
- "description": "Automation rule ID (UUID)",
2638
- "name": "automation_id",
2720
+ "operation-id": {
2721
+ "description": "Bulk operation ID returned by bulk-create",
2722
+ "name": "operation-id",
2639
2723
  "required": true
2640
2724
  }
2641
2725
  },
2642
- "description": "List past runs of an automation rule, including dry runs",
2726
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2643
2727
  "examples": [
2644
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2728
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2645
2729
  ],
2646
2730
  "flags": {
2647
2731
  "json": {
@@ -2670,7 +2754,7 @@
2670
2754
  },
2671
2755
  "hasDynamicHelp": false,
2672
2756
  "hiddenAliases": [],
2673
- "id": "asa:automations:runs",
2757
+ "id": "asa:campaigns:bulk-status",
2674
2758
  "pluginAlias": "adapty",
2675
2759
  "pluginName": "adapty",
2676
2760
  "pluginType": "core",
@@ -2681,23 +2765,18 @@
2681
2765
  "dist",
2682
2766
  "commands",
2683
2767
  "asa",
2684
- "automations",
2685
- "runs.js"
2768
+ "campaigns",
2769
+ "bulk-status.js"
2686
2770
  ]
2687
2771
  },
2688
- "asa:automations:update": {
2772
+ "asa:campaigns:create": {
2689
2773
  "aliases": [],
2690
- "args": {
2691
- "automation_id": {
2692
- "description": "Automation rule ID (UUID)",
2693
- "name": "automation_id",
2694
- "required": true
2695
- }
2696
- },
2697
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2774
+ "args": {},
2775
+ "description": "Create a campaign in Apple Search Ads. A Max Conversions campaign also needs an automated ad group (`asa ad-groups create --automated`); line-of-credit organizations must pass all five --invoice-* flags",
2698
2776
  "examples": [
2699
- "<%= config.bin %> asa automations update UUID --stop",
2700
- "<%= config.bin %> asa automations update UUID --file rule.json"
2777
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50",
2778
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Max Conv\" --adam-id 123456 --country US --daily-budget 50 --bidding-strategy MAX_CONVERSIONS",
2779
+ "<%= config.bin %> asa campaigns create --org UUID --name \"LOC push\" --adam-id 123456 --country US --daily-budget 50 --invoice-advertiser \"Acme Inc\" --invoice-order-number PO-42 --invoice-contact-name \"Jane Doe\" --invoice-contact-email jane@acme.com --invoice-billing-email billing@acme.com"
2701
2780
  ],
2702
2781
  "flags": {
2703
2782
  "json": {
@@ -2707,6 +2786,14 @@
2707
2786
  "allowNo": false,
2708
2787
  "type": "boolean"
2709
2788
  },
2789
+ "currency": {
2790
+ "description": "Currency code for the amounts in this call",
2791
+ "name": "currency",
2792
+ "default": "USD",
2793
+ "hasDynamicHelp": false,
2794
+ "multiple": false,
2795
+ "type": "option"
2796
+ },
2710
2797
  "yes": {
2711
2798
  "char": "y",
2712
2799
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2721,42 +2808,155 @@
2721
2808
  "multiple": false,
2722
2809
  "type": "option"
2723
2810
  },
2724
- "file": {
2725
- "description": "JSON file with the parts to change, or - to read stdin",
2726
- "name": "file",
2811
+ "invoice-advertiser": {
2812
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
2813
+ "name": "invoice-advertiser",
2727
2814
  "hasDynamicHelp": false,
2728
2815
  "multiple": false,
2729
2816
  "type": "option"
2730
2817
  },
2731
- "name": {
2732
- "description": "Rule name",
2733
- "name": "name",
2734
- "hasDynamicHelp": false,
2735
- "multiple": false,
2818
+ "invoice-billing-email": {
2819
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
2820
+ "name": "invoice-billing-email",
2821
+ "hasDynamicHelp": false,
2822
+ "multiple": false,
2736
2823
  "type": "option"
2737
2824
  },
2738
- "start": {
2739
- "description": "Activate the rule",
2740
- "exclusive": [
2741
- "stop"
2825
+ "invoice-contact-email": {
2826
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
2827
+ "name": "invoice-contact-email",
2828
+ "hasDynamicHelp": false,
2829
+ "multiple": false,
2830
+ "type": "option"
2831
+ },
2832
+ "invoice-contact-name": {
2833
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
2834
+ "name": "invoice-contact-name",
2835
+ "hasDynamicHelp": false,
2836
+ "multiple": false,
2837
+ "type": "option"
2838
+ },
2839
+ "invoice-order-number": {
2840
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
2841
+ "name": "invoice-order-number",
2842
+ "hasDynamicHelp": false,
2843
+ "multiple": false,
2844
+ "type": "option"
2845
+ },
2846
+ "ad-channel-type": {
2847
+ "description": "Ad channel type",
2848
+ "name": "ad-channel-type",
2849
+ "default": "SEARCH",
2850
+ "hasDynamicHelp": false,
2851
+ "multiple": false,
2852
+ "options": [
2853
+ "DISPLAY",
2854
+ "SEARCH"
2742
2855
  ],
2743
- "name": "start",
2744
- "allowNo": false,
2745
- "type": "boolean"
2856
+ "type": "option"
2746
2857
  },
2747
- "stop": {
2748
- "description": "Stop the rule and clear its next run",
2749
- "exclusive": [
2750
- "start"
2858
+ "adam-id": {
2859
+ "description": "App Store app ID (adam_id)",
2860
+ "name": "adam-id",
2861
+ "required": true,
2862
+ "hasDynamicHelp": false,
2863
+ "multiple": false,
2864
+ "type": "option"
2865
+ },
2866
+ "bidding-strategy": {
2867
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2868
+ "name": "bidding-strategy",
2869
+ "hasDynamicHelp": false,
2870
+ "multiple": false,
2871
+ "options": [
2872
+ "MANUAL_CPT",
2873
+ "MAX_CONVERSIONS"
2751
2874
  ],
2752
- "name": "stop",
2753
- "allowNo": false,
2754
- "type": "boolean"
2875
+ "type": "option"
2876
+ },
2877
+ "billing-event": {
2878
+ "description": "Billing event",
2879
+ "name": "billing-event",
2880
+ "default": "TAPS",
2881
+ "hasDynamicHelp": false,
2882
+ "multiple": false,
2883
+ "options": [
2884
+ "IMPRESSIONS",
2885
+ "TAPS"
2886
+ ],
2887
+ "type": "option"
2888
+ },
2889
+ "budget": {
2890
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2891
+ "name": "budget",
2892
+ "hasDynamicHelp": false,
2893
+ "multiple": false,
2894
+ "type": "option"
2895
+ },
2896
+ "country": {
2897
+ "description": "Country or region code, repeatable",
2898
+ "name": "country",
2899
+ "required": true,
2900
+ "hasDynamicHelp": false,
2901
+ "multiple": true,
2902
+ "type": "option"
2903
+ },
2904
+ "daily-budget": {
2905
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
2906
+ "name": "daily-budget",
2907
+ "required": true,
2908
+ "hasDynamicHelp": false,
2909
+ "multiple": false,
2910
+ "type": "option"
2911
+ },
2912
+ "name": {
2913
+ "description": "Campaign name",
2914
+ "name": "name",
2915
+ "required": true,
2916
+ "hasDynamicHelp": false,
2917
+ "multiple": false,
2918
+ "type": "option"
2919
+ },
2920
+ "org": {
2921
+ "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2922
+ "name": "org",
2923
+ "required": true,
2924
+ "hasDynamicHelp": false,
2925
+ "multiple": false,
2926
+ "type": "option"
2927
+ },
2928
+ "status": {
2929
+ "description": "Initial status",
2930
+ "name": "status",
2931
+ "hasDynamicHelp": false,
2932
+ "multiple": false,
2933
+ "options": [
2934
+ "ENABLED",
2935
+ "PAUSED"
2936
+ ],
2937
+ "type": "option"
2938
+ },
2939
+ "supply-source": {
2940
+ "description": "Supply source, repeatable",
2941
+ "name": "supply-source",
2942
+ "default": [
2943
+ "APPSTORE_SEARCH_RESULTS"
2944
+ ],
2945
+ "hasDynamicHelp": false,
2946
+ "multiple": true,
2947
+ "type": "option"
2948
+ },
2949
+ "target-cpa": {
2950
+ "description": "Target CPA; must be lower than --daily-budget (amount, e.g. 50 or 12.50)",
2951
+ "name": "target-cpa",
2952
+ "hasDynamicHelp": false,
2953
+ "multiple": false,
2954
+ "type": "option"
2755
2955
  }
2756
2956
  },
2757
2957
  "hasDynamicHelp": false,
2758
2958
  "hiddenAliases": [],
2759
- "id": "asa:automations:update",
2959
+ "id": "asa:campaigns:create",
2760
2960
  "pluginAlias": "adapty",
2761
2961
  "pluginName": "adapty",
2762
2962
  "pluginType": "core",
@@ -2767,16 +2967,22 @@
2767
2967
  "dist",
2768
2968
  "commands",
2769
2969
  "asa",
2770
- "automations",
2771
- "update.js"
2970
+ "campaigns",
2971
+ "create.js"
2772
2972
  ]
2773
2973
  },
2774
- "asa:competitors:summary": {
2974
+ "asa:campaigns:get": {
2775
2975
  "aliases": [],
2776
- "args": {},
2777
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2976
+ "args": {
2977
+ "campaign_id": {
2978
+ "description": "Campaign ID (UUID)",
2979
+ "name": "campaign_id",
2980
+ "required": true
2981
+ }
2982
+ },
2983
+ "description": "Show one campaign; read numbers with asa metrics",
2778
2984
  "examples": [
2779
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2985
+ "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
2780
2986
  ],
2781
2987
  "flags": {
2782
2988
  "json": {
@@ -2785,19 +2991,11 @@
2785
2991
  "name": "json",
2786
2992
  "allowNo": false,
2787
2993
  "type": "boolean"
2788
- },
2789
- "app-ids": {
2790
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2791
- "name": "app-ids",
2792
- "required": true,
2793
- "hasDynamicHelp": false,
2794
- "multiple": false,
2795
- "type": "option"
2796
2994
  }
2797
2995
  },
2798
2996
  "hasDynamicHelp": false,
2799
2997
  "hiddenAliases": [],
2800
- "id": "asa:competitors:summary",
2998
+ "id": "asa:campaigns:get",
2801
2999
  "pluginAlias": "adapty",
2802
3000
  "pluginName": "adapty",
2803
3001
  "pluginType": "core",
@@ -2808,17 +3006,17 @@
2808
3006
  "dist",
2809
3007
  "commands",
2810
3008
  "asa",
2811
- "competitors",
2812
- "summary.js"
3009
+ "campaigns",
3010
+ "get.js"
2813
3011
  ]
2814
3012
  },
2815
- "asa:creatives:list": {
3013
+ "asa:campaigns:list": {
2816
3014
  "aliases": [],
2817
3015
  "args": {},
2818
- "description": "List creatives; creative_id is what `asa ads create` needs",
3016
+ "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
2819
3017
  "examples": [
2820
- "<%= config.bin %> asa creatives list",
2821
- "<%= config.bin %> asa creatives list --app APP_UUID"
3018
+ "<%= config.bin %> asa campaigns list",
3019
+ "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
2822
3020
  ],
2823
3021
  "flags": {
2824
3022
  "json": {
@@ -2857,11 +3055,29 @@
2857
3055
  "hasDynamicHelp": false,
2858
3056
  "multiple": true,
2859
3057
  "type": "option"
3058
+ },
3059
+ "search": {
3060
+ "description": "Case-insensitive substring match on the name",
3061
+ "name": "search",
3062
+ "hasDynamicHelp": false,
3063
+ "multiple": false,
3064
+ "type": "option"
3065
+ },
3066
+ "status": {
3067
+ "description": "Keep only rows in this state",
3068
+ "name": "status",
3069
+ "hasDynamicHelp": false,
3070
+ "multiple": false,
3071
+ "options": [
3072
+ "ENABLED",
3073
+ "PAUSED"
3074
+ ],
3075
+ "type": "option"
2860
3076
  }
2861
3077
  },
2862
3078
  "hasDynamicHelp": false,
2863
3079
  "hiddenAliases": [],
2864
- "id": "asa:creatives:list",
3080
+ "id": "asa:campaigns:list",
2865
3081
  "pluginAlias": "adapty",
2866
3082
  "pluginName": "adapty",
2867
3083
  "pluginType": "core",
@@ -2872,19 +3088,24 @@
2872
3088
  "dist",
2873
3089
  "commands",
2874
3090
  "asa",
2875
- "creatives",
3091
+ "campaigns",
2876
3092
  "list.js"
2877
3093
  ]
2878
3094
  },
2879
- "asa:campaigns:bulk-create": {
3095
+ "asa:campaigns:update": {
2880
3096
  "aliases": [],
2881
- "args": {},
2882
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
3097
+ "args": {
3098
+ "campaign_id": {
3099
+ "description": "Campaign ID (UUID)",
3100
+ "name": "campaign_id",
3101
+ "required": true
3102
+ }
3103
+ },
3104
+ "description": "Change a campaign: budgets, countries, status, schedule or Invoicing Options (all five --invoice-* flags together; they replace the stored set)",
2883
3105
  "examples": [
2884
- "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2885
- "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2886
- "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2887
- "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
3106
+ "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3107
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80",
3108
+ "<%= config.bin %> asa campaigns update UUID --invoice-advertiser \"Acme Inc\" --invoice-order-number PO-42 --invoice-contact-name \"Jane Doe\" --invoice-contact-email jane@acme.com --invoice-billing-email billing@acme.com"
2888
3109
  ],
2889
3110
  "flags": {
2890
3111
  "json": {
@@ -2894,6 +3115,14 @@
2894
3115
  "allowNo": false,
2895
3116
  "type": "boolean"
2896
3117
  },
3118
+ "currency": {
3119
+ "description": "Currency code for the amounts in this call",
3120
+ "name": "currency",
3121
+ "default": "USD",
3122
+ "hasDynamicHelp": false,
3123
+ "multiple": false,
3124
+ "type": "option"
3125
+ },
2897
3126
  "yes": {
2898
3127
  "char": "y",
2899
3128
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2908,59 +3137,102 @@
2908
3137
  "multiple": false,
2909
3138
  "type": "option"
2910
3139
  },
2911
- "file": {
2912
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2913
- "name": "file",
3140
+ "invoice-advertiser": {
3141
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
3142
+ "name": "invoice-advertiser",
2914
3143
  "hasDynamicHelp": false,
2915
3144
  "multiple": false,
2916
3145
  "type": "option"
2917
3146
  },
2918
- "from-file": {
2919
- "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2920
- "name": "from-file",
3147
+ "invoice-billing-email": {
3148
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
3149
+ "name": "invoice-billing-email",
2921
3150
  "hasDynamicHelp": false,
2922
3151
  "multiple": false,
2923
3152
  "type": "option"
2924
3153
  },
2925
- "org-id": {
2926
- "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2927
- "name": "org-id",
3154
+ "invoice-contact-email": {
3155
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
3156
+ "name": "invoice-contact-email",
2928
3157
  "hasDynamicHelp": false,
2929
3158
  "multiple": false,
2930
3159
  "type": "option"
2931
3160
  },
2932
- "poll-interval": {
2933
- "description": "Seconds between progress polls",
2934
- "name": "poll-interval",
2935
- "default": 5,
3161
+ "invoice-contact-name": {
3162
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
3163
+ "name": "invoice-contact-name",
2936
3164
  "hasDynamicHelp": false,
2937
3165
  "multiple": false,
2938
3166
  "type": "option"
2939
3167
  },
2940
- "preview": {
2941
- "description": "With --from-file: print the converted request and stop, nothing is created",
2942
- "name": "preview",
2943
- "allowNo": false,
2944
- "type": "boolean"
3168
+ "invoice-order-number": {
3169
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
3170
+ "name": "invoice-order-number",
3171
+ "hasDynamicHelp": false,
3172
+ "multiple": false,
3173
+ "type": "option"
2945
3174
  },
2946
- "timeout": {
2947
- "description": "Max seconds to wait for the operation to finish",
2948
- "name": "timeout",
2949
- "default": 900,
3175
+ "bidding-strategy": {
3176
+ "description": "Bidding strategy",
3177
+ "name": "bidding-strategy",
2950
3178
  "hasDynamicHelp": false,
2951
3179
  "multiple": false,
3180
+ "options": [
3181
+ "MANUAL_CPT",
3182
+ "MAX_CONVERSIONS"
3183
+ ],
2952
3184
  "type": "option"
2953
3185
  },
2954
- "wait": {
2955
- "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2956
- "name": "wait",
2957
- "allowNo": true,
2958
- "type": "boolean"
3186
+ "budget": {
3187
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3188
+ "name": "budget",
3189
+ "hasDynamicHelp": false,
3190
+ "multiple": false,
3191
+ "type": "option"
3192
+ },
3193
+ "country": {
3194
+ "description": "Replace the country list, repeatable",
3195
+ "name": "country",
3196
+ "hasDynamicHelp": false,
3197
+ "multiple": true,
3198
+ "type": "option"
3199
+ },
3200
+ "daily-budget": {
3201
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
3202
+ "name": "daily-budget",
3203
+ "hasDynamicHelp": false,
3204
+ "multiple": false,
3205
+ "type": "option"
3206
+ },
3207
+ "name": {
3208
+ "description": "Campaign name",
3209
+ "name": "name",
3210
+ "hasDynamicHelp": false,
3211
+ "multiple": false,
3212
+ "type": "option"
3213
+ },
3214
+ "status": {
3215
+ "description": "Campaign status",
3216
+ "name": "status",
3217
+ "hasDynamicHelp": false,
3218
+ "multiple": false,
3219
+ "options": [
3220
+ "ENABLED",
3221
+ "PAUSED"
3222
+ ],
3223
+ "type": "option"
3224
+ },
3225
+ "target-cpa": {
3226
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
3227
+ "name": "target-cpa",
3228
+ "hasDynamicHelp": false,
3229
+ "multiple": false,
3230
+ "type": "option"
2959
3231
  }
2960
3232
  },
2961
3233
  "hasDynamicHelp": false,
2962
3234
  "hiddenAliases": [],
2963
- "id": "asa:campaigns:bulk-create",
3235
+ "id": "asa:campaigns:update",
2964
3236
  "pluginAlias": "adapty",
2965
3237
  "pluginName": "adapty",
2966
3238
  "pluginType": "core",
@@ -2972,17 +3244,15 @@
2972
3244
  "commands",
2973
3245
  "asa",
2974
3246
  "campaigns",
2975
- "bulk-create.js"
3247
+ "update.js"
2976
3248
  ]
2977
3249
  },
2978
- "asa:campaigns:bulk-list": {
3250
+ "asa:competitors:summary": {
2979
3251
  "aliases": [],
2980
3252
  "args": {},
2981
- "description": "This company's bulk operations, newest first; inspect one with bulk-status",
3253
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2982
3254
  "examples": [
2983
- "<%= config.bin %> asa campaigns bulk-list",
2984
- "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2985
- "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
3255
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2986
3256
  ],
2987
3257
  "flags": {
2988
3258
  "json": {
@@ -2992,61 +3262,18 @@
2992
3262
  "allowNo": false,
2993
3263
  "type": "boolean"
2994
3264
  },
2995
- "page": {
2996
- "description": "Page number",
2997
- "name": "page",
2998
- "default": 1,
2999
- "hasDynamicHelp": false,
3000
- "multiple": false,
3001
- "type": "option"
3002
- },
3003
- "page-size": {
3004
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3005
- "name": "page-size",
3006
- "default": 100,
3007
- "hasDynamicHelp": false,
3008
- "multiple": false,
3009
- "type": "option"
3010
- },
3011
- "app": {
3012
- "description": "Keep only operations of this app (UUID)",
3013
- "name": "app",
3014
- "hasDynamicHelp": false,
3015
- "multiple": false,
3016
- "type": "option"
3017
- },
3018
- "created-from": {
3019
- "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
3020
- "name": "created-from",
3021
- "hasDynamicHelp": false,
3022
- "multiple": false,
3023
- "type": "option"
3024
- },
3025
- "created-to": {
3026
- "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
3027
- "name": "created-to",
3265
+ "app-ids": {
3266
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3267
+ "name": "app-ids",
3268
+ "required": true,
3028
3269
  "hasDynamicHelp": false,
3029
3270
  "multiple": false,
3030
3271
  "type": "option"
3031
- },
3032
- "status": {
3033
- "description": "Keep only operations in this state; repeatable",
3034
- "name": "status",
3035
- "hasDynamicHelp": false,
3036
- "multiple": true,
3037
- "options": [
3038
- "failed",
3039
- "partial",
3040
- "pending",
3041
- "running",
3042
- "success"
3043
- ],
3044
- "type": "option"
3045
3272
  }
3046
3273
  },
3047
3274
  "hasDynamicHelp": false,
3048
3275
  "hiddenAliases": [],
3049
- "id": "asa:campaigns:bulk-list",
3276
+ "id": "asa:competitors:summary",
3050
3277
  "pluginAlias": "adapty",
3051
3278
  "pluginName": "adapty",
3052
3279
  "pluginType": "core",
@@ -3057,22 +3284,17 @@
3057
3284
  "dist",
3058
3285
  "commands",
3059
3286
  "asa",
3060
- "campaigns",
3061
- "bulk-list.js"
3287
+ "competitors",
3288
+ "summary.js"
3062
3289
  ]
3063
3290
  },
3064
- "asa:campaigns:bulk-status": {
3291
+ "asa:creatives:list": {
3065
3292
  "aliases": [],
3066
- "args": {
3067
- "operation-id": {
3068
- "description": "Bulk operation ID returned by bulk-create",
3069
- "name": "operation-id",
3070
- "required": true
3071
- }
3072
- },
3073
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
3293
+ "args": {},
3294
+ "description": "List creatives; creative_id is what `asa ads create` needs",
3074
3295
  "examples": [
3075
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
3296
+ "<%= config.bin %> asa creatives list",
3297
+ "<%= config.bin %> asa creatives list --app APP_UUID"
3076
3298
  ],
3077
3299
  "flags": {
3078
3300
  "json": {
@@ -3097,11 +3319,25 @@
3097
3319
  "hasDynamicHelp": false,
3098
3320
  "multiple": false,
3099
3321
  "type": "option"
3322
+ },
3323
+ "app": {
3324
+ "description": "Keep only rows in this app; repeatable",
3325
+ "name": "app",
3326
+ "hasDynamicHelp": false,
3327
+ "multiple": true,
3328
+ "type": "option"
3329
+ },
3330
+ "campaign-group": {
3331
+ "description": "Keep only rows in this campaign group; repeatable",
3332
+ "name": "campaign-group",
3333
+ "hasDynamicHelp": false,
3334
+ "multiple": true,
3335
+ "type": "option"
3100
3336
  }
3101
3337
  },
3102
3338
  "hasDynamicHelp": false,
3103
3339
  "hiddenAliases": [],
3104
- "id": "asa:campaigns:bulk-status",
3340
+ "id": "asa:creatives:list",
3105
3341
  "pluginAlias": "adapty",
3106
3342
  "pluginName": "adapty",
3107
3343
  "pluginType": "core",
@@ -3112,18 +3348,17 @@
3112
3348
  "dist",
3113
3349
  "commands",
3114
3350
  "asa",
3115
- "campaigns",
3116
- "bulk-status.js"
3351
+ "creatives",
3352
+ "list.js"
3117
3353
  ]
3118
3354
  },
3119
- "asa:campaigns:create": {
3355
+ "asa:keywords:add": {
3120
3356
  "aliases": [],
3121
3357
  "args": {},
3122
- "description": "Create a campaign in Apple Search Ads. A Max Conversions campaign also needs an automated ad group (`asa ad-groups create --automated`); line-of-credit organizations must pass all five --invoice-* flags",
3358
+ "description": "Add targeting keywords to an ad group",
3123
3359
  "examples": [
3124
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50",
3125
- "<%= config.bin %> asa campaigns create --org UUID --name \"Max Conv\" --adam-id 123456 --country US --daily-budget 50 --bidding-strategy MAX_CONVERSIONS",
3126
- "<%= config.bin %> asa campaigns create --org UUID --name \"LOC push\" --adam-id 123456 --country US --daily-budget 50 --invoice-advertiser \"Acme Inc\" --invoice-order-number PO-42 --invoice-contact-name \"Jane Doe\" --invoice-contact-email jane@acme.com --invoice-billing-email billing@acme.com"
3360
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3361
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3127
3362
  ],
3128
3363
  "flags": {
3129
3364
  "json": {
@@ -3155,194 +3390,63 @@
3155
3390
  "multiple": false,
3156
3391
  "type": "option"
3157
3392
  },
3158
- "invoice-advertiser": {
3159
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
3160
- "name": "invoice-advertiser",
3161
- "hasDynamicHelp": false,
3162
- "multiple": false,
3163
- "type": "option"
3164
- },
3165
- "invoice-billing-email": {
3166
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
3167
- "name": "invoice-billing-email",
3168
- "hasDynamicHelp": false,
3169
- "multiple": false,
3170
- "type": "option"
3171
- },
3172
- "invoice-contact-email": {
3173
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
3174
- "name": "invoice-contact-email",
3393
+ "ad-group": {
3394
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3395
+ "name": "ad-group",
3396
+ "required": true,
3175
3397
  "hasDynamicHelp": false,
3176
3398
  "multiple": false,
3177
3399
  "type": "option"
3178
3400
  },
3179
- "invoice-contact-name": {
3180
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
3181
- "name": "invoice-contact-name",
3401
+ "bid": {
3402
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3403
+ "name": "bid",
3182
3404
  "hasDynamicHelp": false,
3183
3405
  "multiple": false,
3184
3406
  "type": "option"
3185
3407
  },
3186
- "invoice-order-number": {
3187
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
3188
- "name": "invoice-order-number",
3408
+ "from-file": {
3409
+ "description": "File with one keyword per line, combined with any --text values",
3410
+ "name": "from-file",
3189
3411
  "hasDynamicHelp": false,
3190
3412
  "multiple": false,
3191
3413
  "type": "option"
3192
3414
  },
3193
- "ad-channel-type": {
3194
- "description": "Ad channel type",
3195
- "name": "ad-channel-type",
3196
- "default": "SEARCH",
3415
+ "match-type": {
3416
+ "description": "Match type",
3417
+ "name": "match-type",
3418
+ "default": "BROAD",
3197
3419
  "hasDynamicHelp": false,
3198
3420
  "multiple": false,
3199
3421
  "options": [
3200
- "DISPLAY",
3201
- "SEARCH"
3422
+ "BROAD",
3423
+ "EXACT"
3202
3424
  ],
3203
3425
  "type": "option"
3204
3426
  },
3205
- "adam-id": {
3206
- "description": "App Store app ID (adam_id)",
3207
- "name": "adam-id",
3208
- "required": true,
3209
- "hasDynamicHelp": false,
3210
- "multiple": false,
3211
- "type": "option"
3212
- },
3213
- "bidding-strategy": {
3214
- "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
3215
- "name": "bidding-strategy",
3427
+ "status": {
3428
+ "description": "Keyword status",
3429
+ "name": "status",
3430
+ "default": "ACTIVE",
3216
3431
  "hasDynamicHelp": false,
3217
3432
  "multiple": false,
3218
3433
  "options": [
3219
- "MANUAL_CPT",
3220
- "MAX_CONVERSIONS"
3434
+ "ACTIVE",
3435
+ "PAUSED"
3221
3436
  ],
3222
3437
  "type": "option"
3223
3438
  },
3224
- "billing-event": {
3225
- "description": "Billing event",
3226
- "name": "billing-event",
3227
- "default": "TAPS",
3228
- "hasDynamicHelp": false,
3229
- "multiple": false,
3230
- "options": [
3231
- "IMPRESSIONS",
3232
- "TAPS"
3233
- ],
3234
- "type": "option"
3235
- },
3236
- "budget": {
3237
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3238
- "name": "budget",
3239
- "hasDynamicHelp": false,
3240
- "multiple": false,
3241
- "type": "option"
3242
- },
3243
- "country": {
3244
- "description": "Country or region code, repeatable",
3245
- "name": "country",
3246
- "required": true,
3247
- "hasDynamicHelp": false,
3248
- "multiple": true,
3249
- "type": "option"
3250
- },
3251
- "daily-budget": {
3252
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3253
- "name": "daily-budget",
3254
- "required": true,
3255
- "hasDynamicHelp": false,
3256
- "multiple": false,
3257
- "type": "option"
3258
- },
3259
- "name": {
3260
- "description": "Campaign name",
3261
- "name": "name",
3262
- "required": true,
3263
- "hasDynamicHelp": false,
3264
- "multiple": false,
3265
- "type": "option"
3266
- },
3267
- "org": {
3268
- "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
3269
- "name": "org",
3270
- "required": true,
3271
- "hasDynamicHelp": false,
3272
- "multiple": false,
3273
- "type": "option"
3274
- },
3275
- "status": {
3276
- "description": "Initial status",
3277
- "name": "status",
3278
- "hasDynamicHelp": false,
3279
- "multiple": false,
3280
- "options": [
3281
- "ENABLED",
3282
- "PAUSED"
3283
- ],
3284
- "type": "option"
3285
- },
3286
- "supply-source": {
3287
- "description": "Supply source, repeatable",
3288
- "name": "supply-source",
3289
- "default": [
3290
- "APPSTORE_SEARCH_RESULTS"
3291
- ],
3439
+ "text": {
3440
+ "description": "Keyword text, repeatable",
3441
+ "name": "text",
3292
3442
  "hasDynamicHelp": false,
3293
3443
  "multiple": true,
3294
3444
  "type": "option"
3295
- },
3296
- "target-cpa": {
3297
- "description": "Target CPA; must be lower than --daily-budget (amount, e.g. 50 or 12.50)",
3298
- "name": "target-cpa",
3299
- "hasDynamicHelp": false,
3300
- "multiple": false,
3301
- "type": "option"
3302
- }
3303
- },
3304
- "hasDynamicHelp": false,
3305
- "hiddenAliases": [],
3306
- "id": "asa:campaigns:create",
3307
- "pluginAlias": "adapty",
3308
- "pluginName": "adapty",
3309
- "pluginType": "core",
3310
- "strict": true,
3311
- "enableJsonFlag": true,
3312
- "isESM": true,
3313
- "relativePath": [
3314
- "dist",
3315
- "commands",
3316
- "asa",
3317
- "campaigns",
3318
- "create.js"
3319
- ]
3320
- },
3321
- "asa:campaigns:get": {
3322
- "aliases": [],
3323
- "args": {
3324
- "campaign_id": {
3325
- "description": "Campaign ID (UUID)",
3326
- "name": "campaign_id",
3327
- "required": true
3328
- }
3329
- },
3330
- "description": "Show one campaign; read numbers with asa metrics",
3331
- "examples": [
3332
- "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
3333
- ],
3334
- "flags": {
3335
- "json": {
3336
- "description": "Format output as json.",
3337
- "helpGroup": "GLOBAL",
3338
- "name": "json",
3339
- "allowNo": false,
3340
- "type": "boolean"
3341
3445
  }
3342
3446
  },
3343
3447
  "hasDynamicHelp": false,
3344
3448
  "hiddenAliases": [],
3345
- "id": "asa:campaigns:get",
3449
+ "id": "asa:keywords:add",
3346
3450
  "pluginAlias": "adapty",
3347
3451
  "pluginName": "adapty",
3348
3452
  "pluginType": "core",
@@ -3353,17 +3457,17 @@
3353
3457
  "dist",
3354
3458
  "commands",
3355
3459
  "asa",
3356
- "campaigns",
3357
- "get.js"
3460
+ "keywords",
3461
+ "add.js"
3358
3462
  ]
3359
3463
  },
3360
- "asa:campaigns:list": {
3464
+ "asa:keywords:list": {
3361
3465
  "aliases": [],
3362
3466
  "args": {},
3363
- "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
3467
+ "description": "List targeting keywords; read numbers with asa metrics",
3364
3468
  "examples": [
3365
- "<%= config.bin %> asa campaigns list",
3366
- "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
3469
+ "<%= config.bin %> asa keywords list",
3470
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3367
3471
  ],
3368
3472
  "flags": {
3369
3473
  "json": {
@@ -3410,13 +3514,27 @@
3410
3514
  "multiple": false,
3411
3515
  "type": "option"
3412
3516
  },
3517
+ "campaign": {
3518
+ "description": "Keep only rows in this campaign; repeatable",
3519
+ "name": "campaign",
3520
+ "hasDynamicHelp": false,
3521
+ "multiple": true,
3522
+ "type": "option"
3523
+ },
3524
+ "ad-group": {
3525
+ "description": "Keep only rows in this ad group; repeatable",
3526
+ "name": "ad-group",
3527
+ "hasDynamicHelp": false,
3528
+ "multiple": true,
3529
+ "type": "option"
3530
+ },
3413
3531
  "status": {
3414
3532
  "description": "Keep only rows in this state",
3415
3533
  "name": "status",
3416
3534
  "hasDynamicHelp": false,
3417
3535
  "multiple": false,
3418
3536
  "options": [
3419
- "ENABLED",
3537
+ "ACTIVE",
3420
3538
  "PAUSED"
3421
3539
  ],
3422
3540
  "type": "option"
@@ -3424,7 +3542,7 @@
3424
3542
  },
3425
3543
  "hasDynamicHelp": false,
3426
3544
  "hiddenAliases": [],
3427
- "id": "asa:campaigns:list",
3545
+ "id": "asa:keywords:list",
3428
3546
  "pluginAlias": "adapty",
3429
3547
  "pluginName": "adapty",
3430
3548
  "pluginType": "core",
@@ -3435,24 +3553,23 @@
3435
3553
  "dist",
3436
3554
  "commands",
3437
3555
  "asa",
3438
- "campaigns",
3556
+ "keywords",
3439
3557
  "list.js"
3440
3558
  ]
3441
3559
  },
3442
- "asa:campaigns:update": {
3560
+ "asa:keywords:update": {
3443
3561
  "aliases": [],
3444
3562
  "args": {
3445
- "campaign_id": {
3446
- "description": "Campaign ID (UUID)",
3447
- "name": "campaign_id",
3563
+ "keyword_id": {
3564
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3565
+ "name": "keyword_id",
3448
3566
  "required": true
3449
3567
  }
3450
3568
  },
3451
- "description": "Change a campaign: budgets, countries, status, schedule or Invoicing Options (all five --invoice-* flags together; they replace the stored set)",
3569
+ "description": "Change bid, status, text or match type of keywords",
3452
3570
  "examples": [
3453
- "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3454
- "<%= config.bin %> asa campaigns update UUID --daily-budget 80",
3455
- "<%= config.bin %> asa campaigns update UUID --invoice-advertiser \"Acme Inc\" --invoice-order-number PO-42 --invoice-contact-name \"Jane Doe\" --invoice-contact-email jane@acme.com --invoice-billing-email billing@acme.com"
3571
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3572
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3456
3573
  ],
3457
3574
  "flags": {
3458
3575
  "json": {
@@ -3484,94 +3601,38 @@
3484
3601
  "multiple": false,
3485
3602
  "type": "option"
3486
3603
  },
3487
- "invoice-advertiser": {
3488
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
3489
- "name": "invoice-advertiser",
3490
- "hasDynamicHelp": false,
3491
- "multiple": false,
3492
- "type": "option"
3493
- },
3494
- "invoice-billing-email": {
3495
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
3496
- "name": "invoice-billing-email",
3497
- "hasDynamicHelp": false,
3498
- "multiple": false,
3499
- "type": "option"
3500
- },
3501
- "invoice-contact-email": {
3502
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
3503
- "name": "invoice-contact-email",
3504
- "hasDynamicHelp": false,
3505
- "multiple": false,
3506
- "type": "option"
3507
- },
3508
- "invoice-contact-name": {
3509
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
3510
- "name": "invoice-contact-name",
3511
- "hasDynamicHelp": false,
3512
- "multiple": false,
3513
- "type": "option"
3514
- },
3515
- "invoice-order-number": {
3516
- "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
3517
- "name": "invoice-order-number",
3604
+ "bid": {
3605
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3606
+ "name": "bid",
3518
3607
  "hasDynamicHelp": false,
3519
3608
  "multiple": false,
3520
3609
  "type": "option"
3521
3610
  },
3522
- "bidding-strategy": {
3523
- "description": "Bidding strategy",
3524
- "name": "bidding-strategy",
3611
+ "match-type": {
3612
+ "description": "Match type",
3613
+ "name": "match-type",
3525
3614
  "hasDynamicHelp": false,
3526
3615
  "multiple": false,
3527
3616
  "options": [
3528
- "MANUAL_CPT",
3529
- "MAX_CONVERSIONS"
3617
+ "BROAD",
3618
+ "EXACT"
3530
3619
  ],
3531
3620
  "type": "option"
3532
3621
  },
3533
- "budget": {
3534
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3535
- "name": "budget",
3536
- "hasDynamicHelp": false,
3537
- "multiple": false,
3538
- "type": "option"
3539
- },
3540
- "country": {
3541
- "description": "Replace the country list, repeatable",
3542
- "name": "country",
3543
- "hasDynamicHelp": false,
3544
- "multiple": true,
3545
- "type": "option"
3546
- },
3547
- "daily-budget": {
3548
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3549
- "name": "daily-budget",
3550
- "hasDynamicHelp": false,
3551
- "multiple": false,
3552
- "type": "option"
3553
- },
3554
- "name": {
3555
- "description": "Campaign name",
3556
- "name": "name",
3557
- "hasDynamicHelp": false,
3558
- "multiple": false,
3559
- "type": "option"
3560
- },
3561
3622
  "status": {
3562
- "description": "Campaign status",
3623
+ "description": "Keyword status",
3563
3624
  "name": "status",
3564
3625
  "hasDynamicHelp": false,
3565
3626
  "multiple": false,
3566
3627
  "options": [
3567
- "ENABLED",
3628
+ "ACTIVE",
3568
3629
  "PAUSED"
3569
3630
  ],
3570
3631
  "type": "option"
3571
3632
  },
3572
- "target-cpa": {
3573
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3574
- "name": "target-cpa",
3633
+ "text": {
3634
+ "description": "Keyword text (only meaningful for a single keyword)",
3635
+ "name": "text",
3575
3636
  "hasDynamicHelp": false,
3576
3637
  "multiple": false,
3577
3638
  "type": "option"
@@ -3579,28 +3640,29 @@
3579
3640
  },
3580
3641
  "hasDynamicHelp": false,
3581
3642
  "hiddenAliases": [],
3582
- "id": "asa:campaigns:update",
3643
+ "id": "asa:keywords:update",
3583
3644
  "pluginAlias": "adapty",
3584
3645
  "pluginName": "adapty",
3585
3646
  "pluginType": "core",
3586
- "strict": true,
3647
+ "strict": false,
3587
3648
  "enableJsonFlag": true,
3588
3649
  "isESM": true,
3589
3650
  "relativePath": [
3590
3651
  "dist",
3591
3652
  "commands",
3592
3653
  "asa",
3593
- "campaigns",
3654
+ "keywords",
3594
3655
  "update.js"
3595
3656
  ]
3596
3657
  },
3597
- "asa:keywords:add": {
3658
+ "asa:negative-keywords:add": {
3598
3659
  "aliases": [],
3599
3660
  "args": {},
3600
- "description": "Add targeting keywords to an ad group",
3661
+ "description": "Add negative keywords to an ad group or across a campaign",
3601
3662
  "examples": [
3602
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3603
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3663
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3664
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3665
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3604
3666
  ],
3605
3667
  "flags": {
3606
3668
  "json": {
@@ -3610,14 +3672,6 @@
3610
3672
  "allowNo": false,
3611
3673
  "type": "boolean"
3612
3674
  },
3613
- "currency": {
3614
- "description": "Currency code for the amounts in this call",
3615
- "name": "currency",
3616
- "default": "USD",
3617
- "hasDynamicHelp": false,
3618
- "multiple": false,
3619
- "type": "option"
3620
- },
3621
3675
  "yes": {
3622
3676
  "char": "y",
3623
3677
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3634,22 +3688,29 @@
3634
3688
  },
3635
3689
  "ad-group": {
3636
3690
  "description": "Ad group ID (UUID) — the campaign is resolved from it",
3691
+ "exclusive": [
3692
+ "campaign"
3693
+ ],
3637
3694
  "name": "ad-group",
3638
- "required": true,
3639
3695
  "hasDynamicHelp": false,
3640
3696
  "multiple": false,
3641
3697
  "type": "option"
3642
3698
  },
3643
- "bid": {
3644
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3645
- "name": "bid",
3646
- "hasDynamicHelp": false,
3647
- "multiple": false,
3648
- "type": "option"
3699
+ "all-ad-groups": {
3700
+ "dependsOn": [
3701
+ "campaign"
3702
+ ],
3703
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
3704
+ "name": "all-ad-groups",
3705
+ "allowNo": false,
3706
+ "type": "boolean"
3649
3707
  },
3650
- "from-file": {
3651
- "description": "File with one keyword per line, combined with any --text values",
3652
- "name": "from-file",
3708
+ "campaign": {
3709
+ "description": "Campaign ID (UUID)",
3710
+ "exclusive": [
3711
+ "ad-group"
3712
+ ],
3713
+ "name": "campaign",
3653
3714
  "hasDynamicHelp": false,
3654
3715
  "multiple": false,
3655
3716
  "type": "option"
@@ -3657,7 +3718,7 @@
3657
3718
  "match-type": {
3658
3719
  "description": "Match type",
3659
3720
  "name": "match-type",
3660
- "default": "BROAD",
3721
+ "default": "EXACT",
3661
3722
  "hasDynamicHelp": false,
3662
3723
  "multiple": false,
3663
3724
  "options": [
@@ -3681,6 +3742,7 @@
3681
3742
  "text": {
3682
3743
  "description": "Keyword text, repeatable",
3683
3744
  "name": "text",
3745
+ "required": true,
3684
3746
  "hasDynamicHelp": false,
3685
3747
  "multiple": true,
3686
3748
  "type": "option"
@@ -3688,7 +3750,7 @@
3688
3750
  },
3689
3751
  "hasDynamicHelp": false,
3690
3752
  "hiddenAliases": [],
3691
- "id": "asa:keywords:add",
3753
+ "id": "asa:negative-keywords:add",
3692
3754
  "pluginAlias": "adapty",
3693
3755
  "pluginName": "adapty",
3694
3756
  "pluginType": "core",
@@ -3699,17 +3761,17 @@
3699
3761
  "dist",
3700
3762
  "commands",
3701
3763
  "asa",
3702
- "keywords",
3764
+ "negative-keywords",
3703
3765
  "add.js"
3704
3766
  ]
3705
3767
  },
3706
- "asa:keywords:list": {
3768
+ "asa:negative-keywords:list": {
3707
3769
  "aliases": [],
3708
3770
  "args": {},
3709
- "description": "List targeting keywords; read numbers with asa metrics",
3771
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3710
3772
  "examples": [
3711
- "<%= config.bin %> asa keywords list",
3712
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3773
+ "<%= config.bin %> asa negative-keywords list",
3774
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3713
3775
  ],
3714
3776
  "flags": {
3715
3777
  "json": {
@@ -3770,131 +3832,28 @@
3770
3832
  "multiple": true,
3771
3833
  "type": "option"
3772
3834
  },
3773
- "status": {
3774
- "description": "Keep only rows in this state",
3775
- "name": "status",
3776
- "hasDynamicHelp": false,
3777
- "multiple": false,
3778
- "options": [
3779
- "ACTIVE",
3780
- "PAUSED"
3781
- ],
3782
- "type": "option"
3783
- }
3784
- },
3785
- "hasDynamicHelp": false,
3786
- "hiddenAliases": [],
3787
- "id": "asa:keywords:list",
3788
- "pluginAlias": "adapty",
3789
- "pluginName": "adapty",
3790
- "pluginType": "core",
3791
- "strict": true,
3792
- "enableJsonFlag": true,
3793
- "isESM": true,
3794
- "relativePath": [
3795
- "dist",
3796
- "commands",
3797
- "asa",
3798
- "keywords",
3799
- "list.js"
3800
- ]
3801
- },
3802
- "asa:keywords:update": {
3803
- "aliases": [],
3804
- "args": {
3805
- "keyword_id": {
3806
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3807
- "name": "keyword_id",
3808
- "required": true
3809
- }
3810
- },
3811
- "description": "Change bid, status, text or match type of keywords",
3812
- "examples": [
3813
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3814
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3815
- ],
3816
- "flags": {
3817
- "json": {
3818
- "description": "Format output as json.",
3819
- "helpGroup": "GLOBAL",
3820
- "name": "json",
3821
- "allowNo": false,
3822
- "type": "boolean"
3823
- },
3824
- "currency": {
3825
- "description": "Currency code for the amounts in this call",
3826
- "name": "currency",
3827
- "default": "USD",
3828
- "hasDynamicHelp": false,
3829
- "multiple": false,
3830
- "type": "option"
3831
- },
3832
- "yes": {
3833
- "char": "y",
3834
- "description": "Apply without asking; required when the output is piped or --json is used",
3835
- "name": "yes",
3835
+ "campaign-level-only": {
3836
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
3837
+ "name": "campaign-level-only",
3836
3838
  "allowNo": false,
3837
3839
  "type": "boolean"
3838
- },
3839
- "idempotency-key": {
3840
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3841
- "name": "idempotency-key",
3842
- "hasDynamicHelp": false,
3843
- "multiple": false,
3844
- "type": "option"
3845
- },
3846
- "bid": {
3847
- "description": "Bid (amount, e.g. 50 or 12.50)",
3848
- "name": "bid",
3849
- "hasDynamicHelp": false,
3850
- "multiple": false,
3851
- "type": "option"
3852
- },
3853
- "match-type": {
3854
- "description": "Match type",
3855
- "name": "match-type",
3856
- "hasDynamicHelp": false,
3857
- "multiple": false,
3858
- "options": [
3859
- "BROAD",
3860
- "EXACT"
3861
- ],
3862
- "type": "option"
3863
- },
3864
- "status": {
3865
- "description": "Keyword status",
3866
- "name": "status",
3867
- "hasDynamicHelp": false,
3868
- "multiple": false,
3869
- "options": [
3870
- "ACTIVE",
3871
- "PAUSED"
3872
- ],
3873
- "type": "option"
3874
- },
3875
- "text": {
3876
- "description": "Keyword text (only meaningful for a single keyword)",
3877
- "name": "text",
3878
- "hasDynamicHelp": false,
3879
- "multiple": false,
3880
- "type": "option"
3881
3840
  }
3882
3841
  },
3883
3842
  "hasDynamicHelp": false,
3884
3843
  "hiddenAliases": [],
3885
- "id": "asa:keywords:update",
3844
+ "id": "asa:negative-keywords:list",
3886
3845
  "pluginAlias": "adapty",
3887
3846
  "pluginName": "adapty",
3888
3847
  "pluginType": "core",
3889
- "strict": false,
3848
+ "strict": true,
3890
3849
  "enableJsonFlag": true,
3891
3850
  "isESM": true,
3892
3851
  "relativePath": [
3893
3852
  "dist",
3894
3853
  "commands",
3895
3854
  "asa",
3896
- "keywords",
3897
- "update.js"
3855
+ "negative-keywords",
3856
+ "list.js"
3898
3857
  ]
3899
3858
  },
3900
3859
  "asa:metrics": {
@@ -4128,14 +4087,12 @@
4128
4087
  "overview.js"
4129
4088
  ]
4130
4089
  },
4131
- "asa:negative-keywords:add": {
4090
+ "asa:orgs:list": {
4132
4091
  "aliases": [],
4133
4092
  "args": {},
4134
- "description": "Add negative keywords to an ad group or across a campaign",
4093
+ "description": "List the Apple Search Ads organizations this company can spend from",
4135
4094
  "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\""
4095
+ "<%= config.bin %> asa orgs list"
4139
4096
  ],
4140
4097
  "flags": {
4141
4098
  "json": {
@@ -4145,77 +4102,82 @@
4145
4102
  "allowNo": false,
4146
4103
  "type": "boolean"
4147
4104
  },
4148
- "yes": {
4149
- "char": "y",
4150
- "description": "Apply without asking; required when the output is piped or --json is used",
4151
- "name": "yes",
4152
- "allowNo": false,
4153
- "type": "boolean"
4154
- },
4155
- "idempotency-key": {
4156
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4157
- "name": "idempotency-key",
4105
+ "page": {
4106
+ "description": "Page number",
4107
+ "name": "page",
4108
+ "default": 1,
4158
4109
  "hasDynamicHelp": false,
4159
4110
  "multiple": false,
4160
4111
  "type": "option"
4161
4112
  },
4162
- "ad-group": {
4163
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
4164
- "exclusive": [
4165
- "campaign"
4166
- ],
4167
- "name": "ad-group",
4113
+ "page-size": {
4114
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4115
+ "name": "page-size",
4116
+ "default": 100,
4168
4117
  "hasDynamicHelp": false,
4169
4118
  "multiple": false,
4170
4119
  "type": "option"
4171
- },
4172
- "all-ad-groups": {
4173
- "dependsOn": [
4174
- "campaign"
4175
- ],
4176
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
4177
- "name": "all-ad-groups",
4120
+ }
4121
+ },
4122
+ "hasDynamicHelp": false,
4123
+ "hiddenAliases": [],
4124
+ "id": "asa:orgs:list",
4125
+ "pluginAlias": "adapty",
4126
+ "pluginName": "adapty",
4127
+ "pluginType": "core",
4128
+ "strict": true,
4129
+ "enableJsonFlag": true,
4130
+ "isESM": true,
4131
+ "relativePath": [
4132
+ "dist",
4133
+ "commands",
4134
+ "asa",
4135
+ "orgs",
4136
+ "list.js"
4137
+ ]
4138
+ },
4139
+ "asa:product-pages:list": {
4140
+ "aliases": [],
4141
+ "args": {},
4142
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4143
+ "examples": [
4144
+ "<%= config.bin %> asa product-pages list",
4145
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
4146
+ ],
4147
+ "flags": {
4148
+ "json": {
4149
+ "description": "Format output as json.",
4150
+ "helpGroup": "GLOBAL",
4151
+ "name": "json",
4178
4152
  "allowNo": false,
4179
4153
  "type": "boolean"
4180
4154
  },
4181
- "campaign": {
4182
- "description": "Campaign ID (UUID)",
4183
- "exclusive": [
4184
- "ad-group"
4185
- ],
4186
- "name": "campaign",
4155
+ "page": {
4156
+ "description": "Page number",
4157
+ "name": "page",
4158
+ "default": 1,
4187
4159
  "hasDynamicHelp": false,
4188
4160
  "multiple": false,
4189
4161
  "type": "option"
4190
4162
  },
4191
- "match-type": {
4192
- "description": "Match type",
4193
- "name": "match-type",
4194
- "default": "EXACT",
4163
+ "page-size": {
4164
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4165
+ "name": "page-size",
4166
+ "default": 100,
4195
4167
  "hasDynamicHelp": false,
4196
4168
  "multiple": false,
4197
- "options": [
4198
- "BROAD",
4199
- "EXACT"
4200
- ],
4201
4169
  "type": "option"
4202
4170
  },
4203
- "status": {
4204
- "description": "Keyword status",
4205
- "name": "status",
4206
- "default": "ACTIVE",
4171
+ "app": {
4172
+ "description": "Keep only rows in this app; repeatable",
4173
+ "name": "app",
4207
4174
  "hasDynamicHelp": false,
4208
- "multiple": false,
4209
- "options": [
4210
- "ACTIVE",
4211
- "PAUSED"
4212
- ],
4175
+ "multiple": true,
4213
4176
  "type": "option"
4214
4177
  },
4215
- "text": {
4216
- "description": "Keyword text, repeatable",
4217
- "name": "text",
4218
- "required": true,
4178
+ "campaign-group": {
4179
+ "description": "Keep only rows in this campaign group; repeatable",
4180
+ "name": "campaign-group",
4219
4181
  "hasDynamicHelp": false,
4220
4182
  "multiple": true,
4221
4183
  "type": "option"
@@ -4223,7 +4185,7 @@
4223
4185
  },
4224
4186
  "hasDynamicHelp": false,
4225
4187
  "hiddenAliases": [],
4226
- "id": "asa:negative-keywords:add",
4188
+ "id": "asa:product-pages:list",
4227
4189
  "pluginAlias": "adapty",
4228
4190
  "pluginName": "adapty",
4229
4191
  "pluginType": "core",
@@ -4234,17 +4196,72 @@
4234
4196
  "dist",
4235
4197
  "commands",
4236
4198
  "asa",
4237
- "negative-keywords",
4238
- "add.js"
4199
+ "product-pages",
4200
+ "list.js"
4239
4201
  ]
4240
4202
  },
4241
- "asa:negative-keywords:list": {
4203
+ "asa:product-pages:sync": {
4242
4204
  "aliases": [],
4243
4205
  "args": {},
4244
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
4206
+ "description": "Refresh custom product pages from Apple",
4245
4207
  "examples": [
4246
- "<%= config.bin %> asa negative-keywords list",
4247
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
4208
+ "<%= config.bin %> asa product-pages sync",
4209
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
4210
+ ],
4211
+ "flags": {
4212
+ "json": {
4213
+ "description": "Format output as json.",
4214
+ "helpGroup": "GLOBAL",
4215
+ "name": "json",
4216
+ "allowNo": false,
4217
+ "type": "boolean"
4218
+ },
4219
+ "yes": {
4220
+ "char": "y",
4221
+ "description": "Apply without asking; required when the output is piped or --json is used",
4222
+ "name": "yes",
4223
+ "allowNo": false,
4224
+ "type": "boolean"
4225
+ },
4226
+ "idempotency-key": {
4227
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4228
+ "name": "idempotency-key",
4229
+ "hasDynamicHelp": false,
4230
+ "multiple": false,
4231
+ "type": "option"
4232
+ },
4233
+ "adam-id": {
4234
+ "description": "Limit the refresh to one app; omit to cover every app",
4235
+ "name": "adam-id",
4236
+ "hasDynamicHelp": false,
4237
+ "multiple": false,
4238
+ "type": "option"
4239
+ }
4240
+ },
4241
+ "hasDynamicHelp": false,
4242
+ "hiddenAliases": [],
4243
+ "id": "asa:product-pages:sync",
4244
+ "pluginAlias": "adapty",
4245
+ "pluginName": "adapty",
4246
+ "pluginType": "core",
4247
+ "strict": true,
4248
+ "enableJsonFlag": true,
4249
+ "isESM": true,
4250
+ "relativePath": [
4251
+ "dist",
4252
+ "commands",
4253
+ "asa",
4254
+ "product-pages",
4255
+ "sync.js"
4256
+ ]
4257
+ },
4258
+ "asa:search-terms:list": {
4259
+ "aliases": [],
4260
+ "args": {},
4261
+ "description": "List the search terms your ads matched, with their metrics",
4262
+ "examples": [
4263
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4264
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4248
4265
  ],
4249
4266
  "flags": {
4250
4267
  "json": {
@@ -4270,6 +4287,20 @@
4270
4287
  "multiple": false,
4271
4288
  "type": "option"
4272
4289
  },
4290
+ "date-from": {
4291
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4292
+ "name": "date-from",
4293
+ "hasDynamicHelp": false,
4294
+ "multiple": false,
4295
+ "type": "option"
4296
+ },
4297
+ "date-to": {
4298
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4299
+ "name": "date-to",
4300
+ "hasDynamicHelp": false,
4301
+ "multiple": false,
4302
+ "type": "option"
4303
+ },
4273
4304
  "app": {
4274
4305
  "description": "Keep only rows in this app; repeatable",
4275
4306
  "name": "app",
@@ -4302,19 +4333,129 @@
4302
4333
  "description": "Keep only rows in this ad group; repeatable",
4303
4334
  "name": "ad-group",
4304
4335
  "hasDynamicHelp": false,
4305
- "multiple": true,
4336
+ "multiple": true,
4337
+ "type": "option"
4338
+ }
4339
+ },
4340
+ "hasDynamicHelp": false,
4341
+ "hiddenAliases": [],
4342
+ "id": "asa:search-terms:list",
4343
+ "pluginAlias": "adapty",
4344
+ "pluginName": "adapty",
4345
+ "pluginType": "core",
4346
+ "strict": true,
4347
+ "enableJsonFlag": true,
4348
+ "isESM": true,
4349
+ "relativePath": [
4350
+ "dist",
4351
+ "commands",
4352
+ "asa",
4353
+ "search-terms",
4354
+ "list.js"
4355
+ ]
4356
+ },
4357
+ "flows:config:get": {
4358
+ "aliases": [],
4359
+ "args": {
4360
+ "flow_id": {
4361
+ "description": "Flow ID (UUID)",
4362
+ "name": "flow_id",
4363
+ "required": true
4364
+ }
4365
+ },
4366
+ "description": "Read the flow builder config (404 until the config has been written at least once)",
4367
+ "examples": [
4368
+ "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
4369
+ ],
4370
+ "flags": {
4371
+ "json": {
4372
+ "description": "Format output as json.",
4373
+ "helpGroup": "GLOBAL",
4374
+ "name": "json",
4375
+ "allowNo": false,
4376
+ "type": "boolean"
4377
+ },
4378
+ "app": {
4379
+ "description": "App ID (UUID)",
4380
+ "name": "app",
4381
+ "required": true,
4382
+ "hasDynamicHelp": false,
4383
+ "multiple": false,
4384
+ "type": "option"
4385
+ }
4386
+ },
4387
+ "hasDynamicHelp": false,
4388
+ "hiddenAliases": [],
4389
+ "id": "flows:config:get",
4390
+ "pluginAlias": "adapty",
4391
+ "pluginName": "adapty",
4392
+ "pluginType": "core",
4393
+ "strict": true,
4394
+ "enableJsonFlag": true,
4395
+ "isESM": true,
4396
+ "relativePath": [
4397
+ "dist",
4398
+ "commands",
4399
+ "flows",
4400
+ "config",
4401
+ "get.js"
4402
+ ]
4403
+ },
4404
+ "flows:config:preview": {
4405
+ "aliases": [],
4406
+ "args": {
4407
+ "config_file": {
4408
+ "description": "Path to a local flow config JSON file",
4409
+ "name": "config_file",
4410
+ "required": true
4411
+ }
4412
+ },
4413
+ "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.",
4414
+ "examples": [
4415
+ "<%= config.bin %> flows config preview ./config.json",
4416
+ "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4417
+ "# 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",
4418
+ "# 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"
4419
+ ],
4420
+ "flags": {
4421
+ "json": {
4422
+ "description": "Format output as json.",
4423
+ "helpGroup": "GLOBAL",
4424
+ "name": "json",
4425
+ "allowNo": false,
4426
+ "type": "boolean"
4427
+ },
4428
+ "device": {
4429
+ "description": "Device frame to render in",
4430
+ "name": "device",
4431
+ "default": "iphone-14",
4432
+ "hasDynamicHelp": false,
4433
+ "multiple": false,
4434
+ "type": "option"
4435
+ },
4436
+ "orientation": {
4437
+ "description": "Device orientation to render in",
4438
+ "name": "orientation",
4439
+ "default": "portrait",
4440
+ "hasDynamicHelp": false,
4441
+ "multiple": false,
4442
+ "options": [
4443
+ "landscape",
4444
+ "portrait"
4445
+ ],
4446
+ "type": "option"
4447
+ },
4448
+ "screen": {
4449
+ "description": "Screen ID to render (default: the flow's first screen)",
4450
+ "name": "screen",
4451
+ "hasDynamicHelp": false,
4452
+ "multiple": false,
4306
4453
  "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
4454
  }
4314
4455
  },
4315
4456
  "hasDynamicHelp": false,
4316
4457
  "hiddenAliases": [],
4317
- "id": "asa:negative-keywords:list",
4458
+ "id": "flows:config:preview",
4318
4459
  "pluginAlias": "adapty",
4319
4460
  "pluginName": "adapty",
4320
4461
  "pluginType": "core",
@@ -4324,18 +4465,25 @@
4324
4465
  "relativePath": [
4325
4466
  "dist",
4326
4467
  "commands",
4327
- "asa",
4328
- "negative-keywords",
4329
- "list.js"
4468
+ "flows",
4469
+ "config",
4470
+ "preview.js"
4330
4471
  ]
4331
4472
  },
4332
- "asa:product-pages:list": {
4473
+ "flows:config:update": {
4333
4474
  "aliases": [],
4334
- "args": {},
4335
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4475
+ "args": {
4476
+ "flow_id": {
4477
+ "description": "Flow ID (UUID)",
4478
+ "name": "flow_id",
4479
+ "required": true
4480
+ }
4481
+ },
4482
+ "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4336
4483
  "examples": [
4337
- "<%= config.bin %> asa product-pages list",
4338
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4484
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4485
+ "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4486
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4339
4487
  ],
4340
4488
  "flags": {
4341
4489
  "json": {
@@ -4345,40 +4493,46 @@
4345
4493
  "allowNo": false,
4346
4494
  "type": "boolean"
4347
4495
  },
4348
- "page": {
4349
- "description": "Page number",
4350
- "name": "page",
4351
- "default": 1,
4496
+ "app": {
4497
+ "description": "App ID (UUID)",
4498
+ "name": "app",
4499
+ "required": true,
4352
4500
  "hasDynamicHelp": false,
4353
4501
  "multiple": false,
4354
4502
  "type": "option"
4355
4503
  },
4356
- "page-size": {
4357
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4358
- "name": "page-size",
4359
- "default": 100,
4504
+ "config": {
4505
+ "description": "Builder config as a JSON string",
4506
+ "name": "config",
4360
4507
  "hasDynamicHelp": false,
4361
4508
  "multiple": false,
4362
4509
  "type": "option"
4363
4510
  },
4364
- "app": {
4365
- "description": "Keep only rows in this app; repeatable",
4366
- "name": "app",
4511
+ "config-file": {
4512
+ "description": "JSON file with the builder config, or - to read stdin",
4513
+ "name": "config-file",
4367
4514
  "hasDynamicHelp": false,
4368
- "multiple": true,
4515
+ "multiple": false,
4369
4516
  "type": "option"
4370
4517
  },
4371
- "campaign-group": {
4372
- "description": "Keep only rows in this campaign group; repeatable",
4373
- "name": "campaign-group",
4518
+ "expected-updated-at": {
4519
+ "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4520
+ "name": "expected-updated-at",
4374
4521
  "hasDynamicHelp": false,
4375
- "multiple": true,
4522
+ "multiple": false,
4523
+ "type": "option"
4524
+ },
4525
+ "remote-configs": {
4526
+ "description": "JSON array of remote config entries: [{locale, data}]",
4527
+ "name": "remote-configs",
4528
+ "hasDynamicHelp": false,
4529
+ "multiple": false,
4376
4530
  "type": "option"
4377
4531
  }
4378
4532
  },
4379
4533
  "hasDynamicHelp": false,
4380
4534
  "hiddenAliases": [],
4381
- "id": "asa:product-pages:list",
4535
+ "id": "flows:config:update",
4382
4536
  "pluginAlias": "adapty",
4383
4537
  "pluginName": "adapty",
4384
4538
  "pluginType": "core",
@@ -4388,18 +4542,25 @@
4388
4542
  "relativePath": [
4389
4543
  "dist",
4390
4544
  "commands",
4391
- "asa",
4392
- "product-pages",
4393
- "list.js"
4545
+ "flows",
4546
+ "config",
4547
+ "update.js"
4394
4548
  ]
4395
4549
  },
4396
- "asa:product-pages:sync": {
4550
+ "flows:config:validate": {
4397
4551
  "aliases": [],
4398
- "args": {},
4399
- "description": "Refresh custom product pages from Apple",
4552
+ "args": {
4553
+ "flow_id": {
4554
+ "description": "Flow ID (UUID)",
4555
+ "name": "flow_id",
4556
+ "required": true
4557
+ }
4558
+ },
4559
+ "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4400
4560
  "examples": [
4401
- "<%= config.bin %> asa product-pages sync",
4402
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
4561
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4562
+ "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4563
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4403
4564
  ],
4404
4565
  "flags": {
4405
4566
  "json": {
@@ -4409,23 +4570,24 @@
4409
4570
  "allowNo": false,
4410
4571
  "type": "boolean"
4411
4572
  },
4412
- "yes": {
4413
- "char": "y",
4414
- "description": "Apply without asking; required when the output is piped or --json is used",
4415
- "name": "yes",
4416
- "allowNo": false,
4417
- "type": "boolean"
4573
+ "app": {
4574
+ "description": "App ID (UUID)",
4575
+ "name": "app",
4576
+ "required": true,
4577
+ "hasDynamicHelp": false,
4578
+ "multiple": false,
4579
+ "type": "option"
4418
4580
  },
4419
- "idempotency-key": {
4420
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4421
- "name": "idempotency-key",
4581
+ "config": {
4582
+ "description": "Builder config as a JSON string",
4583
+ "name": "config",
4422
4584
  "hasDynamicHelp": false,
4423
4585
  "multiple": false,
4424
4586
  "type": "option"
4425
4587
  },
4426
- "adam-id": {
4427
- "description": "Limit the refresh to one app; omit to cover every app",
4428
- "name": "adam-id",
4588
+ "config-file": {
4589
+ "description": "JSON file with the builder config, or - to read stdin",
4590
+ "name": "config-file",
4429
4591
  "hasDynamicHelp": false,
4430
4592
  "multiple": false,
4431
4593
  "type": "option"
@@ -4433,7 +4595,7 @@
4433
4595
  },
4434
4596
  "hasDynamicHelp": false,
4435
4597
  "hiddenAliases": [],
4436
- "id": "asa:product-pages:sync",
4598
+ "id": "flows:config:validate",
4437
4599
  "pluginAlias": "adapty",
4438
4600
  "pluginName": "adapty",
4439
4601
  "pluginType": "core",
@@ -4443,18 +4605,23 @@
4443
4605
  "relativePath": [
4444
4606
  "dist",
4445
4607
  "commands",
4446
- "asa",
4447
- "product-pages",
4448
- "sync.js"
4608
+ "flows",
4609
+ "config",
4610
+ "validate.js"
4449
4611
  ]
4450
4612
  },
4451
- "asa:search-terms:list": {
4613
+ "flows:media:upload": {
4452
4614
  "aliases": [],
4453
- "args": {},
4454
- "description": "List the search terms your ads matched, with their metrics",
4615
+ "args": {
4616
+ "file": {
4617
+ "description": "Path to the image file to upload",
4618
+ "name": "file",
4619
+ "required": true
4620
+ }
4621
+ },
4622
+ "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
4455
4623
  "examples": [
4456
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4457
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4624
+ "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
4458
4625
  ],
4459
4626
  "flags": {
4460
4627
  "json": {
@@ -4464,75 +4631,18 @@
4464
4631
  "allowNo": false,
4465
4632
  "type": "boolean"
4466
4633
  },
4467
- "page": {
4468
- "description": "Page number",
4469
- "name": "page",
4470
- "default": 1,
4471
- "hasDynamicHelp": false,
4472
- "multiple": false,
4473
- "type": "option"
4474
- },
4475
- "page-size": {
4476
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4477
- "name": "page-size",
4478
- "default": 100,
4479
- "hasDynamicHelp": false,
4480
- "multiple": false,
4481
- "type": "option"
4482
- },
4483
- "date-from": {
4484
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4485
- "name": "date-from",
4486
- "hasDynamicHelp": false,
4487
- "multiple": false,
4488
- "type": "option"
4489
- },
4490
- "date-to": {
4491
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4492
- "name": "date-to",
4493
- "hasDynamicHelp": false,
4494
- "multiple": false,
4495
- "type": "option"
4496
- },
4497
4634
  "app": {
4498
- "description": "Keep only rows in this app; repeatable",
4635
+ "description": "App ID (UUID)",
4499
4636
  "name": "app",
4500
- "hasDynamicHelp": false,
4501
- "multiple": true,
4502
- "type": "option"
4503
- },
4504
- "campaign-group": {
4505
- "description": "Keep only rows in this campaign group; repeatable",
4506
- "name": "campaign-group",
4507
- "hasDynamicHelp": false,
4508
- "multiple": true,
4509
- "type": "option"
4510
- },
4511
- "search": {
4512
- "description": "Case-insensitive substring match on the name",
4513
- "name": "search",
4637
+ "required": true,
4514
4638
  "hasDynamicHelp": false,
4515
4639
  "multiple": false,
4516
4640
  "type": "option"
4517
- },
4518
- "campaign": {
4519
- "description": "Keep only rows in this campaign; repeatable",
4520
- "name": "campaign",
4521
- "hasDynamicHelp": false,
4522
- "multiple": true,
4523
- "type": "option"
4524
- },
4525
- "ad-group": {
4526
- "description": "Keep only rows in this ad group; repeatable",
4527
- "name": "ad-group",
4528
- "hasDynamicHelp": false,
4529
- "multiple": true,
4530
- "type": "option"
4531
4641
  }
4532
4642
  },
4533
4643
  "hasDynamicHelp": false,
4534
4644
  "hiddenAliases": [],
4535
- "id": "asa:search-terms:list",
4645
+ "id": "flows:media:upload",
4536
4646
  "pluginAlias": "adapty",
4537
4647
  "pluginName": "adapty",
4538
4648
  "pluginType": "core",
@@ -4542,17 +4652,18 @@
4542
4652
  "relativePath": [
4543
4653
  "dist",
4544
4654
  "commands",
4545
- "asa",
4546
- "search-terms",
4547
- "list.js"
4655
+ "flows",
4656
+ "media",
4657
+ "upload.js"
4548
4658
  ]
4549
4659
  },
4550
- "asa:orgs:list": {
4660
+ "asa:automations:create": {
4551
4661
  "aliases": [],
4552
4662
  "args": {},
4553
- "description": "List the Apple Search Ads organizations this company can spend from",
4663
+ "description": "Create an automation rule from a JSON rule file",
4554
4664
  "examples": [
4555
- "<%= config.bin %> asa orgs list"
4665
+ "<%= config.bin %> asa automations create --file rule.json",
4666
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
4556
4667
  ],
4557
4668
  "flags": {
4558
4669
  "json": {
@@ -4562,26 +4673,38 @@
4562
4673
  "allowNo": false,
4563
4674
  "type": "boolean"
4564
4675
  },
4565
- "page": {
4566
- "description": "Page number",
4567
- "name": "page",
4568
- "default": 1,
4676
+ "yes": {
4677
+ "char": "y",
4678
+ "description": "Apply without asking; required when the output is piped or --json is used",
4679
+ "name": "yes",
4680
+ "allowNo": false,
4681
+ "type": "boolean"
4682
+ },
4683
+ "idempotency-key": {
4684
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4685
+ "name": "idempotency-key",
4569
4686
  "hasDynamicHelp": false,
4570
4687
  "multiple": false,
4571
4688
  "type": "option"
4572
4689
  },
4573
- "page-size": {
4574
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4575
- "name": "page-size",
4576
- "default": 100,
4690
+ "file": {
4691
+ "description": "JSON file with the rule body, or - to read stdin",
4692
+ "name": "file",
4693
+ "required": true,
4577
4694
  "hasDynamicHelp": false,
4578
4695
  "multiple": false,
4579
4696
  "type": "option"
4697
+ },
4698
+ "run-now": {
4699
+ "description": "Queue the first run right after the rule is stored",
4700
+ "name": "run-now",
4701
+ "allowNo": false,
4702
+ "type": "boolean"
4580
4703
  }
4581
4704
  },
4582
4705
  "hasDynamicHelp": false,
4583
4706
  "hiddenAliases": [],
4584
- "id": "asa:orgs:list",
4707
+ "id": "asa:automations:create",
4585
4708
  "pluginAlias": "adapty",
4586
4709
  "pluginName": "adapty",
4587
4710
  "pluginType": "core",
@@ -4592,22 +4715,22 @@
4592
4715
  "dist",
4593
4716
  "commands",
4594
4717
  "asa",
4595
- "orgs",
4596
- "list.js"
4718
+ "automations",
4719
+ "create.js"
4597
4720
  ]
4598
4721
  },
4599
- "flows:config:get": {
4722
+ "asa:automations:get": {
4600
4723
  "aliases": [],
4601
4724
  "args": {
4602
- "flow_id": {
4603
- "description": "Flow ID (UUID)",
4604
- "name": "flow_id",
4725
+ "automation_id": {
4726
+ "description": "Automation rule ID (UUID)",
4727
+ "name": "automation_id",
4605
4728
  "required": true
4606
4729
  }
4607
4730
  },
4608
- "description": "Read the flow builder config (404 until the config has been written at least once)",
4731
+ "description": "Show one automation rule with its conditions and actions",
4609
4732
  "examples": [
4610
- "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
4733
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
4611
4734
  ],
4612
4735
  "flags": {
4613
4736
  "json": {
@@ -4616,19 +4739,11 @@
4616
4739
  "name": "json",
4617
4740
  "allowNo": false,
4618
4741
  "type": "boolean"
4619
- },
4620
- "app": {
4621
- "description": "App ID (UUID)",
4622
- "name": "app",
4623
- "required": true,
4624
- "hasDynamicHelp": false,
4625
- "multiple": false,
4626
- "type": "option"
4627
4742
  }
4628
4743
  },
4629
4744
  "hasDynamicHelp": false,
4630
4745
  "hiddenAliases": [],
4631
- "id": "flows:config:get",
4746
+ "id": "asa:automations:get",
4632
4747
  "pluginAlias": "adapty",
4633
4748
  "pluginName": "adapty",
4634
4749
  "pluginType": "core",
@@ -4638,26 +4753,17 @@
4638
4753
  "relativePath": [
4639
4754
  "dist",
4640
4755
  "commands",
4641
- "flows",
4642
- "config",
4756
+ "asa",
4757
+ "automations",
4643
4758
  "get.js"
4644
4759
  ]
4645
4760
  },
4646
- "flows:config:preview": {
4761
+ "asa:automations:list": {
4647
4762
  "aliases": [],
4648
- "args": {
4649
- "config_file": {
4650
- "description": "Path to a local flow config JSON file",
4651
- "name": "config_file",
4652
- "required": true
4653
- }
4654
- },
4655
- "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.",
4763
+ "args": {},
4764
+ "description": "List automation rules; status 1 is active, 0 is stopped",
4656
4765
  "examples": [
4657
- "<%= config.bin %> flows config preview ./config.json",
4658
- "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4659
- "# 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",
4660
- "# 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"
4766
+ "<%= config.bin %> asa automations list"
4661
4767
  ],
4662
4768
  "flags": {
4663
4769
  "json": {
@@ -4667,29 +4773,18 @@
4667
4773
  "allowNo": false,
4668
4774
  "type": "boolean"
4669
4775
  },
4670
- "device": {
4671
- "description": "Device frame to render in",
4672
- "name": "device",
4673
- "default": "iphone-14",
4674
- "hasDynamicHelp": false,
4675
- "multiple": false,
4676
- "type": "option"
4677
- },
4678
- "orientation": {
4679
- "description": "Device orientation to render in",
4680
- "name": "orientation",
4681
- "default": "portrait",
4776
+ "page": {
4777
+ "description": "Page number",
4778
+ "name": "page",
4779
+ "default": 1,
4682
4780
  "hasDynamicHelp": false,
4683
4781
  "multiple": false,
4684
- "options": [
4685
- "landscape",
4686
- "portrait"
4687
- ],
4688
4782
  "type": "option"
4689
4783
  },
4690
- "screen": {
4691
- "description": "Screen ID to render (default: the flow's first screen)",
4692
- "name": "screen",
4784
+ "page-size": {
4785
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4786
+ "name": "page-size",
4787
+ "default": 100,
4693
4788
  "hasDynamicHelp": false,
4694
4789
  "multiple": false,
4695
4790
  "type": "option"
@@ -4697,7 +4792,7 @@
4697
4792
  },
4698
4793
  "hasDynamicHelp": false,
4699
4794
  "hiddenAliases": [],
4700
- "id": "flows:config:preview",
4795
+ "id": "asa:automations:list",
4701
4796
  "pluginAlias": "adapty",
4702
4797
  "pluginName": "adapty",
4703
4798
  "pluginType": "core",
@@ -4707,25 +4802,24 @@
4707
4802
  "relativePath": [
4708
4803
  "dist",
4709
4804
  "commands",
4710
- "flows",
4711
- "config",
4712
- "preview.js"
4805
+ "asa",
4806
+ "automations",
4807
+ "list.js"
4713
4808
  ]
4714
4809
  },
4715
- "flows:config:update": {
4810
+ "asa:automations:run": {
4716
4811
  "aliases": [],
4717
4812
  "args": {
4718
- "flow_id": {
4719
- "description": "Flow ID (UUID)",
4720
- "name": "flow_id",
4813
+ "automation_id": {
4814
+ "description": "Automation rule ID (UUID)",
4815
+ "name": "automation_id",
4721
4816
  "required": true
4722
4817
  }
4723
4818
  },
4724
- "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4819
+ "description": "Run an automation rule now; the run is queued, not awaited",
4725
4820
  "examples": [
4726
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4727
- "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4728
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4821
+ "<%= config.bin %> asa automations run UUID",
4822
+ "<%= config.bin %> asa automations run UUID --dry-run"
4729
4823
  ],
4730
4824
  "flags": {
4731
4825
  "json": {
@@ -4735,46 +4829,30 @@
4735
4829
  "allowNo": false,
4736
4830
  "type": "boolean"
4737
4831
  },
4738
- "app": {
4739
- "description": "App ID (UUID)",
4740
- "name": "app",
4741
- "required": true,
4742
- "hasDynamicHelp": false,
4743
- "multiple": false,
4744
- "type": "option"
4745
- },
4746
- "config": {
4747
- "description": "Builder config as a JSON string",
4748
- "name": "config",
4749
- "hasDynamicHelp": false,
4750
- "multiple": false,
4751
- "type": "option"
4752
- },
4753
- "config-file": {
4754
- "description": "JSON file with the builder config, or - to read stdin",
4755
- "name": "config-file",
4756
- "hasDynamicHelp": false,
4757
- "multiple": false,
4758
- "type": "option"
4832
+ "yes": {
4833
+ "char": "y",
4834
+ "description": "Apply without asking; required when the output is piped or --json is used",
4835
+ "name": "yes",
4836
+ "allowNo": false,
4837
+ "type": "boolean"
4759
4838
  },
4760
- "expected-updated-at": {
4761
- "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4762
- "name": "expected-updated-at",
4839
+ "idempotency-key": {
4840
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4841
+ "name": "idempotency-key",
4763
4842
  "hasDynamicHelp": false,
4764
4843
  "multiple": false,
4765
4844
  "type": "option"
4766
4845
  },
4767
- "remote-configs": {
4768
- "description": "JSON array of remote config entries: [{locale, data}]",
4769
- "name": "remote-configs",
4770
- "hasDynamicHelp": false,
4771
- "multiple": false,
4772
- "type": "option"
4846
+ "dry-run": {
4847
+ "description": "Evaluate and log the rule without touching Apple",
4848
+ "name": "dry-run",
4849
+ "allowNo": false,
4850
+ "type": "boolean"
4773
4851
  }
4774
4852
  },
4775
4853
  "hasDynamicHelp": false,
4776
4854
  "hiddenAliases": [],
4777
- "id": "flows:config:update",
4855
+ "id": "asa:automations:run",
4778
4856
  "pluginAlias": "adapty",
4779
4857
  "pluginName": "adapty",
4780
4858
  "pluginType": "core",
@@ -4784,25 +4862,23 @@
4784
4862
  "relativePath": [
4785
4863
  "dist",
4786
4864
  "commands",
4787
- "flows",
4788
- "config",
4789
- "update.js"
4865
+ "asa",
4866
+ "automations",
4867
+ "run.js"
4790
4868
  ]
4791
4869
  },
4792
- "flows:config:validate": {
4870
+ "asa:automations:runs": {
4793
4871
  "aliases": [],
4794
4872
  "args": {
4795
- "flow_id": {
4796
- "description": "Flow ID (UUID)",
4797
- "name": "flow_id",
4873
+ "automation_id": {
4874
+ "description": "Automation rule ID (UUID)",
4875
+ "name": "automation_id",
4798
4876
  "required": true
4799
4877
  }
4800
4878
  },
4801
- "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4879
+ "description": "List past runs of an automation rule, including dry runs",
4802
4880
  "examples": [
4803
- "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4804
- "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4805
- "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4881
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
4806
4882
  ],
4807
4883
  "flags": {
4808
4884
  "json": {
@@ -4812,24 +4888,18 @@
4812
4888
  "allowNo": false,
4813
4889
  "type": "boolean"
4814
4890
  },
4815
- "app": {
4816
- "description": "App ID (UUID)",
4817
- "name": "app",
4818
- "required": true,
4819
- "hasDynamicHelp": false,
4820
- "multiple": false,
4821
- "type": "option"
4822
- },
4823
- "config": {
4824
- "description": "Builder config as a JSON string",
4825
- "name": "config",
4891
+ "page": {
4892
+ "description": "Page number",
4893
+ "name": "page",
4894
+ "default": 1,
4826
4895
  "hasDynamicHelp": false,
4827
4896
  "multiple": false,
4828
4897
  "type": "option"
4829
4898
  },
4830
- "config-file": {
4831
- "description": "JSON file with the builder config, or - to read stdin",
4832
- "name": "config-file",
4899
+ "page-size": {
4900
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4901
+ "name": "page-size",
4902
+ "default": 100,
4833
4903
  "hasDynamicHelp": false,
4834
4904
  "multiple": false,
4835
4905
  "type": "option"
@@ -4837,7 +4907,7 @@
4837
4907
  },
4838
4908
  "hasDynamicHelp": false,
4839
4909
  "hiddenAliases": [],
4840
- "id": "flows:config:validate",
4910
+ "id": "asa:automations:runs",
4841
4911
  "pluginAlias": "adapty",
4842
4912
  "pluginName": "adapty",
4843
4913
  "pluginType": "core",
@@ -4847,23 +4917,24 @@
4847
4917
  "relativePath": [
4848
4918
  "dist",
4849
4919
  "commands",
4850
- "flows",
4851
- "config",
4852
- "validate.js"
4920
+ "asa",
4921
+ "automations",
4922
+ "runs.js"
4853
4923
  ]
4854
4924
  },
4855
- "flows:media:upload": {
4925
+ "asa:automations:update": {
4856
4926
  "aliases": [],
4857
4927
  "args": {
4858
- "file": {
4859
- "description": "Path to the image file to upload",
4860
- "name": "file",
4928
+ "automation_id": {
4929
+ "description": "Automation rule ID (UUID)",
4930
+ "name": "automation_id",
4861
4931
  "required": true
4862
4932
  }
4863
4933
  },
4864
- "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
4934
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
4865
4935
  "examples": [
4866
- "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
4936
+ "<%= config.bin %> asa automations update UUID --stop",
4937
+ "<%= config.bin %> asa automations update UUID --file rule.json"
4867
4938
  ],
4868
4939
  "flags": {
4869
4940
  "json": {
@@ -4873,18 +4944,56 @@
4873
4944
  "allowNo": false,
4874
4945
  "type": "boolean"
4875
4946
  },
4876
- "app": {
4877
- "description": "App ID (UUID)",
4878
- "name": "app",
4879
- "required": true,
4947
+ "yes": {
4948
+ "char": "y",
4949
+ "description": "Apply without asking; required when the output is piped or --json is used",
4950
+ "name": "yes",
4951
+ "allowNo": false,
4952
+ "type": "boolean"
4953
+ },
4954
+ "idempotency-key": {
4955
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4956
+ "name": "idempotency-key",
4957
+ "hasDynamicHelp": false,
4958
+ "multiple": false,
4959
+ "type": "option"
4960
+ },
4961
+ "file": {
4962
+ "description": "JSON file with the parts to change, or - to read stdin",
4963
+ "name": "file",
4964
+ "hasDynamicHelp": false,
4965
+ "multiple": false,
4966
+ "type": "option"
4967
+ },
4968
+ "name": {
4969
+ "description": "Rule name",
4970
+ "name": "name",
4880
4971
  "hasDynamicHelp": false,
4881
4972
  "multiple": false,
4882
4973
  "type": "option"
4974
+ },
4975
+ "start": {
4976
+ "description": "Activate the rule",
4977
+ "exclusive": [
4978
+ "stop"
4979
+ ],
4980
+ "name": "start",
4981
+ "allowNo": false,
4982
+ "type": "boolean"
4983
+ },
4984
+ "stop": {
4985
+ "description": "Stop the rule and clear its next run",
4986
+ "exclusive": [
4987
+ "start"
4988
+ ],
4989
+ "name": "stop",
4990
+ "allowNo": false,
4991
+ "type": "boolean"
4883
4992
  }
4884
4993
  },
4885
4994
  "hasDynamicHelp": false,
4886
4995
  "hiddenAliases": [],
4887
- "id": "flows:media:upload",
4996
+ "id": "asa:automations:update",
4888
4997
  "pluginAlias": "adapty",
4889
4998
  "pluginName": "adapty",
4890
4999
  "pluginType": "core",
@@ -4894,11 +5003,11 @@
4894
5003
  "relativePath": [
4895
5004
  "dist",
4896
5005
  "commands",
4897
- "flows",
4898
- "media",
4899
- "upload.js"
5006
+ "asa",
5007
+ "automations",
5008
+ "update.js"
4900
5009
  ]
4901
5010
  }
4902
5011
  },
4903
- "version": "0.8.2"
5012
+ "version": "0.8.3-beta.1"
4904
5013
  }