heroku 10.2.0 → 10.3.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/README.md +1 -1
  2. package/lib/commands/buildpacks/index.js +12 -3
  3. package/lib/commands/pg/outliers.js +21 -20
  4. package/lib/commands/pipelines/create.js +5 -3
  5. package/lib/commands/redis/credentials.js +1 -1
  6. package/lib/commands/redis/stats-reset.js +1 -1
  7. package/lib/commands/redis/wait.js +1 -1
  8. package/lib/commands/spaces/create.js +1 -1
  9. package/lib/commands/telemetry/index.js +1 -1
  10. package/lib/lib/api.d.ts +2 -1
  11. package/lib/lib/api.js +2 -2
  12. package/lib/lib/redis/api.d.ts +1 -1
  13. package/lib/lib/redis/api.js +2 -2
  14. package/oclif.manifest.json +1109 -1108
  15. package/package.json +6 -5
package/oclif.manifest.json CHANGED
@@ -337,21 +337,38 @@
337
337
  "status.js"
338
338
  ]
339
339
  },
340
- "access:add": {
340
+ "addons:attach": {
341
341
  "aliases": [],
342
342
  "args": {
343
- "email": {
344
- "description": "email address of the team member",
345
- "name": "email",
343
+ "addon_name": {
344
+ "description": "unique identifier or globally unique name of the add-on",
345
+ "name": "addon_name",
346
346
  "required": true
347
347
  }
348
348
  },
349
- "description": "add new users to your app",
350
- "examples": [
351
- "$ heroku access:add user@email.com --app APP # add a collaborator to your app",
352
- "$ heroku access:add user@email.com --app APP --permissions deploy,manage,operate # permissions must be comma separated"
353
- ],
349
+ "description": "attach an existing add-on resource to an app",
354
350
  "flags": {
351
+ "as": {
352
+ "description": "name for add-on attachment",
353
+ "name": "as",
354
+ "hasDynamicHelp": false,
355
+ "multiple": false,
356
+ "type": "option"
357
+ },
358
+ "credential": {
359
+ "description": "credential name for scoped access to Heroku Postgres",
360
+ "name": "credential",
361
+ "hasDynamicHelp": false,
362
+ "multiple": false,
363
+ "type": "option"
364
+ },
365
+ "confirm": {
366
+ "description": "overwrite existing add-on attachment with same name",
367
+ "name": "confirm",
368
+ "hasDynamicHelp": false,
369
+ "multiple": false,
370
+ "type": "option"
371
+ },
355
372
  "app": {
356
373
  "char": "a",
357
374
  "description": "app to run command against",
@@ -368,36 +385,63 @@
368
385
  "hasDynamicHelp": false,
369
386
  "multiple": false,
370
387
  "type": "option"
371
- },
372
- "permissions": {
373
- "char": "p",
374
- "description": "list of permissions comma separated",
375
- "name": "permissions",
376
- "hasDynamicHelp": false,
377
- "multiple": false,
378
- "type": "option"
379
388
  }
380
389
  },
381
390
  "hasDynamicHelp": false,
382
391
  "hiddenAliases": [],
383
- "id": "access:add",
392
+ "id": "addons:attach",
384
393
  "pluginAlias": "heroku",
385
394
  "pluginName": "heroku",
386
395
  "pluginType": "core",
387
396
  "strict": true,
397
+ "topic": "addons",
388
398
  "isESM": false,
389
399
  "relativePath": [
390
400
  "lib",
391
401
  "commands",
392
- "access",
393
- "add.js"
402
+ "addons",
403
+ "attach.js"
394
404
  ]
395
405
  },
396
- "access": {
406
+ "addons:create": {
397
407
  "aliases": [],
398
- "args": {},
399
- "description": "list who has access to an app",
408
+ "args": {
409
+ "service:plan": {
410
+ "description": "unique identifier or unique name of the add-on service plan",
411
+ "name": "service:plan",
412
+ "required": true
413
+ }
414
+ },
415
+ "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
416
+ "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
400
417
  "flags": {
418
+ "name": {
419
+ "description": "name for the add-on resource",
420
+ "name": "name",
421
+ "hasDynamicHelp": false,
422
+ "multiple": false,
423
+ "type": "option"
424
+ },
425
+ "as": {
426
+ "description": "name for the initial add-on attachment",
427
+ "name": "as",
428
+ "hasDynamicHelp": false,
429
+ "multiple": false,
430
+ "type": "option"
431
+ },
432
+ "confirm": {
433
+ "description": "overwrite existing config vars or existing add-on attachments",
434
+ "name": "confirm",
435
+ "hasDynamicHelp": false,
436
+ "multiple": false,
437
+ "type": "option"
438
+ },
439
+ "wait": {
440
+ "description": "watch add-on creation status and exit when complete",
441
+ "name": "wait",
442
+ "allowNo": false,
443
+ "type": "boolean"
444
+ },
401
445
  "app": {
402
446
  "char": "a",
403
447
  "description": "app to run command against",
@@ -414,41 +458,65 @@
414
458
  "hasDynamicHelp": false,
415
459
  "multiple": false,
416
460
  "type": "option"
417
- },
418
- "json": {
419
- "description": "output in json format",
420
- "name": "json",
421
- "allowNo": false,
422
- "type": "boolean"
423
461
  }
424
462
  },
425
463
  "hasDynamicHelp": false,
426
- "hiddenAliases": [],
427
- "id": "access",
464
+ "hiddenAliases": [
465
+ "addons:add"
466
+ ],
467
+ "id": "addons:create",
428
468
  "pluginAlias": "heroku",
429
469
  "pluginName": "heroku",
430
470
  "pluginType": "core",
431
- "strict": true,
432
- "topic": "access",
471
+ "strict": false,
472
+ "topic": "addons",
473
+ "example": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
433
474
  "isESM": false,
434
475
  "relativePath": [
435
476
  "lib",
436
477
  "commands",
437
- "access",
438
- "index.js"
478
+ "addons",
479
+ "create.js"
439
480
  ]
440
481
  },
441
- "access:remove": {
482
+ "addons:destroy": {
442
483
  "aliases": [],
443
- "args": {},
444
- "description": "remove users from a team app",
445
- "examples": "$ heroku access:remove user@email.com --app APP",
484
+ "args": {
485
+ "addonName": {
486
+ "description": "unique identifier or globally unique name of the add-on",
487
+ "name": "addonName",
488
+ "required": true
489
+ }
490
+ },
491
+ "description": "permanently destroy an add-on resource",
492
+ "examples": [
493
+ "addons:destroy [ADDON]... [flags]"
494
+ ],
446
495
  "flags": {
496
+ "force": {
497
+ "char": "f",
498
+ "description": "allow destruction even if connected to other apps",
499
+ "name": "force",
500
+ "allowNo": false,
501
+ "type": "boolean"
502
+ },
503
+ "confirm": {
504
+ "char": "c",
505
+ "name": "confirm",
506
+ "hasDynamicHelp": false,
507
+ "multiple": false,
508
+ "type": "option"
509
+ },
510
+ "wait": {
511
+ "description": "watch add-on destruction status and exit when complete",
512
+ "name": "wait",
513
+ "allowNo": false,
514
+ "type": "boolean"
515
+ },
447
516
  "app": {
448
517
  "char": "a",
449
518
  "description": "app to run command against",
450
519
  "name": "app",
451
- "required": true,
452
520
  "hasDynamicHelp": false,
453
521
  "multiple": false,
454
522
  "type": "option"
@@ -463,42 +531,34 @@
463
531
  }
464
532
  },
465
533
  "hasDynamicHelp": false,
466
- "hiddenAliases": [],
467
- "id": "access:remove",
534
+ "hiddenAliases": [
535
+ "addons:remove"
536
+ ],
537
+ "id": "addons:destroy",
468
538
  "pluginAlias": "heroku",
469
539
  "pluginName": "heroku",
470
540
  "pluginType": "core",
471
541
  "strict": false,
472
- "example": "$ heroku access:remove user@email.com --app APP",
473
- "topic": "access",
542
+ "topic": "addons",
474
543
  "isESM": false,
475
544
  "relativePath": [
476
545
  "lib",
477
546
  "commands",
478
- "access",
479
- "remove.js"
547
+ "addons",
548
+ "destroy.js"
480
549
  ]
481
550
  },
482
- "access:update": {
551
+ "addons:detach": {
483
552
  "aliases": [],
484
553
  "args": {
485
- "email": {
486
- "description": "email address of the team member",
487
- "name": "email",
554
+ "attachment_name": {
555
+ "description": "unique identifier of the add-on attachment",
556
+ "name": "attachment_name",
488
557
  "required": true
489
558
  }
490
559
  },
491
- "description": "update existing collaborators on an team app",
560
+ "description": "detach an existing add-on resource from an app",
492
561
  "flags": {
493
- "permissions": {
494
- "char": "p",
495
- "description": "comma-delimited list of permissions to update (deploy,manage,operate)",
496
- "name": "permissions",
497
- "required": true,
498
- "hasDynamicHelp": false,
499
- "multiple": false,
500
- "type": "option"
501
- },
502
562
  "app": {
503
563
  "char": "a",
504
564
  "description": "app to run command against",
@@ -519,171 +579,92 @@
519
579
  },
520
580
  "hasDynamicHelp": false,
521
581
  "hiddenAliases": [],
522
- "id": "access:update",
582
+ "id": "addons:detach",
523
583
  "pluginAlias": "heroku",
524
584
  "pluginName": "heroku",
525
585
  "pluginType": "core",
526
586
  "strict": true,
527
- "topic": "access",
587
+ "topic": "addons",
528
588
  "isESM": false,
529
589
  "relativePath": [
530
590
  "lib",
531
591
  "commands",
532
- "access",
533
- "update.js"
592
+ "addons",
593
+ "detach.js"
534
594
  ]
535
595
  },
536
- "apps:create": {
596
+ "addons:docs": {
537
597
  "aliases": [],
538
598
  "args": {
539
- "app": {
540
- "description": "name of app to create",
541
- "name": "app",
542
- "required": false
599
+ "addon": {
600
+ "description": "unique identifier or globally unique name of the add-on",
601
+ "name": "addon",
602
+ "required": true
543
603
  }
544
604
  },
545
- "description": "creates a new app",
546
- "examples": [
547
- "$ heroku apps:create\nCreating app... done, stack is heroku-24\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
548
- ],
605
+ "description": "open an add-on's Dev Center documentation in your browser",
549
606
  "flags": {
607
+ "show-url": {
608
+ "description": "show URL, do not open browser",
609
+ "name": "show-url",
610
+ "allowNo": false,
611
+ "type": "boolean"
612
+ },
550
613
  "app": {
551
- "hidden": true,
614
+ "char": "a",
615
+ "description": "app to run command against",
552
616
  "name": "app",
553
617
  "hasDynamicHelp": false,
554
618
  "multiple": false,
555
619
  "type": "option"
556
620
  },
557
- "addons": {
558
- "description": "comma-delimited list of addons to install",
559
- "name": "addons",
560
- "hasDynamicHelp": false,
561
- "multiple": false,
562
- "type": "option"
563
- },
564
- "buildpack": {
565
- "char": "b",
566
- "description": "buildpack url to use for this app",
567
- "name": "buildpack",
568
- "hasDynamicHelp": false,
569
- "multiple": false,
570
- "type": "option"
571
- },
572
- "manifest": {
573
- "char": "m",
574
- "description": "use heroku.yml settings for this app",
575
- "hidden": true,
576
- "name": "manifest",
577
- "allowNo": false,
578
- "type": "boolean"
579
- },
580
- "no-remote": {
581
- "char": "n",
582
- "description": "do not create a git remote",
583
- "name": "no-remote",
584
- "allowNo": false,
585
- "type": "boolean"
586
- },
587
621
  "remote": {
588
622
  "char": "r",
589
- "description": "the git remote to create, default \"heroku\"",
623
+ "description": "git remote of app to use",
590
624
  "name": "remote",
591
- "default": "heroku",
592
- "hasDynamicHelp": false,
593
- "multiple": false,
594
- "type": "option"
595
- },
596
- "stack": {
597
- "char": "s",
598
- "description": "the stack to create the app on",
599
- "name": "stack",
600
- "hasDynamicHelp": false,
601
- "multiple": false,
602
- "type": "option"
603
- },
604
- "space": {
605
- "description": "the private space to create the app in",
606
- "name": "space",
607
- "hasDynamicHelp": false,
608
- "multiple": false,
609
- "type": "option"
610
- },
611
- "region": {
612
- "description": "specify region for the app to run in",
613
- "name": "region",
614
- "hasDynamicHelp": false,
615
- "multiple": false,
616
- "type": "option"
617
- },
618
- "internal-routing": {
619
- "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
620
- "hidden": true,
621
- "name": "internal-routing",
622
- "allowNo": false,
623
- "type": "boolean"
624
- },
625
- "features": {
626
- "hidden": true,
627
- "name": "features",
628
- "hasDynamicHelp": false,
629
- "multiple": false,
630
- "type": "option"
631
- },
632
- "kernel": {
633
- "hidden": true,
634
- "name": "kernel",
635
- "hasDynamicHelp": false,
636
- "multiple": false,
637
- "type": "option"
638
- },
639
- "locked": {
640
- "hidden": true,
641
- "name": "locked",
642
- "allowNo": false,
643
- "type": "boolean"
644
- },
645
- "json": {
646
- "description": "output in json format",
647
- "name": "json",
648
- "allowNo": false,
649
- "type": "boolean"
650
- },
651
- "team": {
652
- "char": "t",
653
- "description": "team to use",
654
- "name": "team",
655
625
  "hasDynamicHelp": false,
656
626
  "multiple": false,
657
627
  "type": "option"
658
628
  }
659
629
  },
660
630
  "hasDynamicHelp": false,
661
- "hiddenAliases": [
662
- "create"
663
- ],
664
- "id": "apps:create",
631
+ "hiddenAliases": [],
632
+ "id": "addons:docs",
665
633
  "pluginAlias": "heroku",
666
634
  "pluginName": "heroku",
667
635
  "pluginType": "core",
668
636
  "strict": true,
637
+ "topic": "addons",
669
638
  "isESM": false,
670
639
  "relativePath": [
671
640
  "lib",
672
641
  "commands",
673
- "apps",
674
- "create.js"
642
+ "addons",
643
+ "docs.js"
675
644
  ]
676
645
  },
677
- "apps:destroy": {
646
+ "addons": {
678
647
  "aliases": [],
679
- "args": {
680
- "app": {
681
- "hidden": true,
682
- "name": "app"
683
- }
684
- },
685
- "description": "permanently destroy an app",
648
+ "args": {},
649
+ "description": "Lists your add-ons and attachments.\n\n The default filter applied depends on whether you are in a Heroku app\n directory. If so, the --app flag is implied. If not, the default of --all\n is implied. Explicitly providing either flag overrides the default\n behavior.\n ",
650
+ "examples": [
651
+ "$ heroku addons --all",
652
+ "$ heroku addons --app acme-inc-www"
653
+ ],
686
654
  "flags": {
655
+ "all": {
656
+ "char": "A",
657
+ "description": "show add-ons and attachments for all accessible apps",
658
+ "name": "all",
659
+ "allowNo": false,
660
+ "type": "boolean"
661
+ },
662
+ "json": {
663
+ "description": "return add-ons in json format",
664
+ "name": "json",
665
+ "allowNo": false,
666
+ "type": "boolean"
667
+ },
687
668
  "app": {
688
669
  "char": "a",
689
670
  "description": "app to run command against",
@@ -699,44 +680,40 @@
699
680
  "hasDynamicHelp": false,
700
681
  "multiple": false,
701
682
  "type": "option"
702
- },
703
- "confirm": {
704
- "char": "c",
705
- "name": "confirm",
706
- "hasDynamicHelp": false,
707
- "multiple": false,
708
- "type": "option"
709
683
  }
710
684
  },
711
685
  "hasDynamicHelp": false,
712
- "hiddenAliases": [
713
- "destroy",
714
- "apps:delete"
715
- ],
716
- "id": "apps:destroy",
686
+ "hiddenAliases": [],
687
+ "id": "addons",
717
688
  "pluginAlias": "heroku",
718
689
  "pluginName": "heroku",
719
690
  "pluginType": "core",
720
691
  "strict": true,
721
- "help": "This will also destroy all add-ons on the app.",
692
+ "usage": "addons [--all|--app APP]",
693
+ "topic": "addons",
722
694
  "isESM": false,
723
695
  "relativePath": [
724
696
  "lib",
725
697
  "commands",
726
- "apps",
727
- "destroy.js"
698
+ "addons",
699
+ "index.js"
728
700
  ]
729
701
  },
730
- "apps:errors": {
702
+ "addons:info": {
731
703
  "aliases": [],
732
- "args": {},
733
- "description": "view app errors",
704
+ "args": {
705
+ "addon": {
706
+ "description": "unique identifier or globally unique name of the add-on",
707
+ "name": "addon",
708
+ "required": true
709
+ }
710
+ },
711
+ "description": "show detailed add-on resource and attachment information",
734
712
  "flags": {
735
713
  "app": {
736
714
  "char": "a",
737
715
  "description": "app to run command against",
738
716
  "name": "app",
739
- "required": true,
740
717
  "hasDynamicHelp": false,
741
718
  "multiple": false,
742
719
  "type": "option"
@@ -748,168 +725,87 @@
748
725
  "hasDynamicHelp": false,
749
726
  "multiple": false,
750
727
  "type": "option"
751
- },
752
- "json": {
753
- "description": "output in json format",
754
- "name": "json",
755
- "allowNo": false,
756
- "type": "boolean"
757
- },
758
- "hours": {
759
- "description": "number of hours to look back (default 24)",
760
- "name": "hours",
761
- "default": "24",
762
- "hasDynamicHelp": false,
763
- "multiple": false,
764
- "type": "option"
765
- },
766
- "router": {
767
- "description": "show only router errors",
768
- "name": "router",
769
- "allowNo": false,
770
- "type": "boolean"
771
- },
772
- "dyno": {
773
- "description": "show only dyno errors",
774
- "name": "dyno",
775
- "allowNo": false,
776
- "type": "boolean"
777
728
  }
778
729
  },
779
730
  "hasDynamicHelp": false,
780
731
  "hiddenAliases": [],
781
- "id": "apps:errors",
732
+ "id": "addons:info",
782
733
  "pluginAlias": "heroku",
783
734
  "pluginName": "heroku",
784
735
  "pluginType": "core",
785
736
  "strict": true,
737
+ "usage": "addons:info ADDON",
738
+ "topic": "addons",
786
739
  "isESM": false,
787
740
  "relativePath": [
788
741
  "lib",
789
742
  "commands",
790
- "apps",
791
- "errors.js"
743
+ "addons",
744
+ "info.js"
792
745
  ]
793
746
  },
794
- "apps": {
747
+ "addons:open": {
795
748
  "aliases": [],
796
- "args": {},
797
- "description": "list your apps",
798
- "examples": [
799
- "$ heroku apps"
800
- ],
749
+ "args": {
750
+ "addon": {
751
+ "description": "unique identifier or globally unique name of the add-on",
752
+ "name": "addon",
753
+ "required": true
754
+ }
755
+ },
756
+ "description": "open an add-on's dashboard in your browser",
801
757
  "flags": {
802
- "all": {
803
- "char": "A",
804
- "description": "include apps in all teams",
805
- "name": "all",
806
- "allowNo": false,
807
- "type": "boolean"
808
- },
809
- "json": {
810
- "char": "j",
811
- "description": "output in json format",
812
- "name": "json",
758
+ "show-url": {
759
+ "description": "show URL, do not open browser",
760
+ "name": "show-url",
813
761
  "allowNo": false,
814
762
  "type": "boolean"
815
763
  },
816
- "space": {
817
- "char": "s",
818
- "description": "filter by space",
819
- "name": "space",
764
+ "app": {
765
+ "char": "a",
766
+ "description": "app to run command against",
767
+ "name": "app",
820
768
  "hasDynamicHelp": false,
821
769
  "multiple": false,
822
770
  "type": "option"
823
771
  },
824
- "personal": {
825
- "char": "p",
826
- "description": "list apps in personal account when a default team is set",
827
- "name": "personal",
828
- "allowNo": false,
829
- "type": "boolean"
830
- },
831
- "internal-routing": {
832
- "char": "i",
833
- "description": "filter to Internal Web Apps",
834
- "hidden": true,
835
- "name": "internal-routing",
836
- "allowNo": false,
837
- "type": "boolean"
838
- },
839
- "team": {
840
- "char": "t",
841
- "description": "team to use",
842
- "name": "team",
772
+ "remote": {
773
+ "char": "r",
774
+ "description": "git remote of app to use",
775
+ "name": "remote",
843
776
  "hasDynamicHelp": false,
844
777
  "multiple": false,
845
778
  "type": "option"
846
779
  }
847
780
  },
848
781
  "hasDynamicHelp": false,
849
- "hiddenAliases": [
850
- "list",
851
- "apps:list"
852
- ],
853
- "id": "apps",
782
+ "hiddenAliases": [],
783
+ "id": "addons:open",
854
784
  "pluginAlias": "heroku",
855
785
  "pluginName": "heroku",
856
786
  "pluginType": "core",
857
787
  "strict": true,
858
- "topic": "apps",
788
+ "topic": "addons",
859
789
  "isESM": false,
860
790
  "relativePath": [
861
791
  "lib",
862
792
  "commands",
863
- "apps",
864
- "index.js"
793
+ "addons",
794
+ "open.js"
865
795
  ]
866
796
  },
867
- "apps:info": {
797
+ "addons:plans": {
868
798
  "aliases": [],
869
799
  "args": {
870
- "app": {
871
- "hidden": true,
872
- "name": "app"
800
+ "service": {
801
+ "description": "unique identifier or globally unique name of the add-on",
802
+ "name": "service",
803
+ "required": true
873
804
  }
874
805
  },
875
- "description": "show detailed app information",
876
- "examples": [
877
- "$ heroku apps:info",
878
- "$ heroku apps:info --shell"
879
- ],
806
+ "description": "list all available plans for an add-on service",
880
807
  "flags": {
881
- "app": {
882
- "char": "a",
883
- "description": "app to run command against",
884
- "name": "app",
885
- "hasDynamicHelp": false,
886
- "multiple": false,
887
- "type": "option"
888
- },
889
- "remote": {
890
- "char": "r",
891
- "description": "git remote of app to use",
892
- "name": "remote",
893
- "hasDynamicHelp": false,
894
- "multiple": false,
895
- "type": "option"
896
- },
897
- "shell": {
898
- "char": "s",
899
- "description": "output more shell friendly key/value pairs",
900
- "name": "shell",
901
- "allowNo": false,
902
- "type": "boolean"
903
- },
904
- "extended": {
905
- "char": "x",
906
- "hidden": true,
907
- "name": "extended",
908
- "allowNo": false,
909
- "type": "boolean"
910
- },
911
808
  "json": {
912
- "char": "j",
913
809
  "description": "output in json format",
914
810
  "name": "json",
915
811
  "allowNo": false,
@@ -917,120 +813,105 @@
917
813
  }
918
814
  },
919
815
  "hasDynamicHelp": false,
920
- "hiddenAliases": [
921
- "info"
922
- ],
923
- "id": "apps:info",
816
+ "hiddenAliases": [],
817
+ "id": "addons:plans",
924
818
  "pluginAlias": "heroku",
925
819
  "pluginName": "heroku",
926
820
  "pluginType": "core",
927
821
  "strict": true,
928
- "topic": "apps",
929
- "help": "$ heroku apps:info\n=== example\nGit URL: https://git.heroku.com/example.git\nRepo Size: 5M\n...\n\n$ heroku apps:info --shell\ngit_url=https://git.heroku.com/example.git\nrepo_size=5000000\n...",
822
+ "topic": "addons",
930
823
  "isESM": false,
931
824
  "relativePath": [
932
825
  "lib",
933
826
  "commands",
934
- "apps",
935
- "info.js"
827
+ "addons",
828
+ "plans.js"
936
829
  ]
937
830
  },
938
- "apps:join": {
939
- "aliases": [
940
- "join"
941
- ],
942
- "args": {},
943
- "description": "add yourself to a team app",
944
- "flags": {
945
- "app": {
946
- "char": "a",
947
- "description": "app to run command against",
948
- "name": "app",
949
- "required": true,
950
- "hasDynamicHelp": false,
951
- "multiple": false,
952
- "type": "option"
831
+ "addons:rename": {
832
+ "aliases": [],
833
+ "args": {
834
+ "addon_name": {
835
+ "description": "unique identifier or globally unique name of the add-on",
836
+ "name": "addon_name",
837
+ "required": true
953
838
  },
954
- "remote": {
955
- "char": "r",
956
- "description": "git remote of app to use",
957
- "name": "remote",
958
- "hasDynamicHelp": false,
959
- "multiple": false,
960
- "type": "option"
839
+ "new_name": {
840
+ "description": "new globally unique name of the add-on",
841
+ "name": "new_name",
842
+ "required": true
961
843
  }
962
844
  },
845
+ "description": "rename an add-on",
846
+ "flags": {},
963
847
  "hasDynamicHelp": false,
964
848
  "hiddenAliases": [],
965
- "id": "apps:join",
849
+ "id": "addons:rename",
966
850
  "pluginAlias": "heroku",
967
851
  "pluginName": "heroku",
968
852
  "pluginType": "core",
969
853
  "strict": true,
970
- "topic": "apps",
854
+ "topic": "addons",
971
855
  "isESM": false,
972
856
  "relativePath": [
973
857
  "lib",
974
858
  "commands",
975
- "apps",
976
- "join.js"
859
+ "addons",
860
+ "rename.js"
977
861
  ]
978
862
  },
979
- "apps:leave": {
980
- "aliases": [
981
- "leave"
982
- ],
863
+ "addons:services": {
864
+ "aliases": [],
983
865
  "args": {},
984
- "description": "remove yourself from a team app",
985
- "examples": "heroku apps:leave -a APP",
866
+ "description": "list all available add-on services",
986
867
  "flags": {
987
- "app": {
988
- "char": "a",
989
- "description": "app to run command against",
990
- "name": "app",
991
- "required": true,
992
- "hasDynamicHelp": false,
993
- "multiple": false,
994
- "type": "option"
995
- },
996
- "remote": {
997
- "char": "r",
998
- "description": "git remote of app to use",
999
- "name": "remote",
1000
- "hasDynamicHelp": false,
1001
- "multiple": false,
1002
- "type": "option"
868
+ "json": {
869
+ "description": "output in json format",
870
+ "name": "json",
871
+ "allowNo": false,
872
+ "type": "boolean"
1003
873
  }
1004
874
  },
1005
875
  "hasDynamicHelp": false,
1006
876
  "hiddenAliases": [],
1007
- "id": "apps:leave",
877
+ "id": "addons:services",
1008
878
  "pluginAlias": "heroku",
1009
879
  "pluginName": "heroku",
1010
880
  "pluginType": "core",
1011
881
  "strict": true,
1012
- "topic": "apps",
1013
- "example": "heroku apps:leave -a APP",
882
+ "topic": "addons",
1014
883
  "isESM": false,
1015
884
  "relativePath": [
1016
885
  "lib",
1017
886
  "commands",
1018
- "apps",
1019
- "leave.js"
887
+ "addons",
888
+ "services.js"
1020
889
  ]
1021
890
  },
1022
- "apps:lock": {
891
+ "addons:upgrade": {
1023
892
  "aliases": [
1024
- "lock"
893
+ "addons:downgrade"
894
+ ],
895
+ "args": {
896
+ "addon": {
897
+ "description": "unique identifier or globally unique name of the add-on",
898
+ "name": "addon",
899
+ "required": true
900
+ },
901
+ "plan": {
902
+ "description": "unique identifier or name of the plan",
903
+ "name": "plan"
904
+ }
905
+ },
906
+ "description": "change add-on plan.\n See available plans with `heroku addons:plans SERVICE`.\n\n Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same. Either one can be used to change an add-on plan up or down.\n\n https://devcenter.heroku.com/articles/managing-add-ons\n ",
907
+ "examples": [
908
+ "Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2"
1025
909
  ],
1026
- "args": {},
1027
- "description": "prevent team members from joining an app",
1028
910
  "flags": {
1029
911
  "app": {
1030
912
  "char": "a",
1031
913
  "description": "app to run command against",
1032
914
  "name": "app",
1033
- "required": true,
1034
915
  "hasDynamicHelp": false,
1035
916
  "multiple": false,
1036
917
  "type": "option"
@@ -1046,40 +927,41 @@
1046
927
  },
1047
928
  "hasDynamicHelp": false,
1048
929
  "hiddenAliases": [],
1049
- "id": "apps:lock",
930
+ "id": "addons:upgrade",
1050
931
  "pluginAlias": "heroku",
1051
932
  "pluginName": "heroku",
1052
933
  "pluginType": "core",
1053
934
  "strict": true,
1054
- "topic": "apps",
935
+ "topic": "addons",
1055
936
  "isESM": false,
1056
937
  "relativePath": [
1057
938
  "lib",
1058
939
  "commands",
1059
- "apps",
1060
- "lock.js"
940
+ "addons",
941
+ "upgrade.js"
1061
942
  ]
1062
943
  },
1063
- "apps:open": {
944
+ "addons:wait": {
1064
945
  "aliases": [],
1065
946
  "args": {
1066
- "path": {
1067
- "description": "base URL path of app",
1068
- "name": "path",
1069
- "required": false
947
+ "addon": {
948
+ "description": "unique identifier or globally unique name of the add-on",
949
+ "name": "addon"
1070
950
  }
1071
951
  },
1072
- "description": "open the app in a web browser",
1073
- "examples": [
1074
- "$ heroku open -a myapp",
1075
- "$ heroku open -a myapp /foo"
1076
- ],
952
+ "description": "show provisioning status of the add-ons on the app",
1077
953
  "flags": {
954
+ "wait-interval": {
955
+ "description": "how frequently to poll in seconds",
956
+ "name": "wait-interval",
957
+ "hasDynamicHelp": false,
958
+ "multiple": false,
959
+ "type": "option"
960
+ },
1078
961
  "app": {
1079
962
  "char": "a",
1080
963
  "description": "app to run command against",
1081
964
  "name": "app",
1082
- "required": true,
1083
965
  "hasDynamicHelp": false,
1084
966
  "multiple": false,
1085
967
  "type": "option"
@@ -1094,50 +976,140 @@
1094
976
  }
1095
977
  },
1096
978
  "hasDynamicHelp": false,
1097
- "hiddenAliases": [
1098
- "open"
1099
- ],
1100
- "id": "apps:open",
979
+ "hiddenAliases": [],
980
+ "id": "addons:wait",
1101
981
  "pluginAlias": "heroku",
1102
982
  "pluginName": "heroku",
1103
983
  "pluginType": "core",
1104
984
  "strict": true,
1105
- "topic": "apps",
985
+ "topic": "addons",
1106
986
  "isESM": false,
1107
987
  "relativePath": [
1108
988
  "lib",
1109
989
  "commands",
1110
- "apps",
1111
- "open.js"
990
+ "addons",
991
+ "wait.js"
1112
992
  ]
1113
993
  },
1114
- "apps:rename": {
994
+ "apps:create": {
1115
995
  "aliases": [],
1116
996
  "args": {
1117
- "newname": {
1118
- "description": "new unique name of the app",
1119
- "name": "newname",
1120
- "required": true
997
+ "app": {
998
+ "description": "name of app to create",
999
+ "name": "app",
1000
+ "required": false
1121
1001
  }
1122
1002
  },
1123
- "description": "rename an app",
1003
+ "description": "creates a new app",
1124
1004
  "examples": [
1125
- "$ heroku apps:rename --app oldname newname"
1005
+ "$ heroku apps:create\nCreating app... done, stack is heroku-24\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
1126
1006
  ],
1127
1007
  "flags": {
1128
1008
  "app": {
1129
- "char": "a",
1130
- "description": "app to run command against",
1009
+ "hidden": true,
1131
1010
  "name": "app",
1132
- "required": true,
1133
1011
  "hasDynamicHelp": false,
1134
1012
  "multiple": false,
1135
1013
  "type": "option"
1136
1014
  },
1015
+ "addons": {
1016
+ "description": "comma-delimited list of addons to install",
1017
+ "name": "addons",
1018
+ "hasDynamicHelp": false,
1019
+ "multiple": false,
1020
+ "type": "option"
1021
+ },
1022
+ "buildpack": {
1023
+ "char": "b",
1024
+ "description": "buildpack url to use for this app",
1025
+ "name": "buildpack",
1026
+ "hasDynamicHelp": false,
1027
+ "multiple": false,
1028
+ "type": "option"
1029
+ },
1030
+ "manifest": {
1031
+ "char": "m",
1032
+ "description": "use heroku.yml settings for this app",
1033
+ "hidden": true,
1034
+ "name": "manifest",
1035
+ "allowNo": false,
1036
+ "type": "boolean"
1037
+ },
1038
+ "no-remote": {
1039
+ "char": "n",
1040
+ "description": "do not create a git remote",
1041
+ "name": "no-remote",
1042
+ "allowNo": false,
1043
+ "type": "boolean"
1044
+ },
1137
1045
  "remote": {
1138
1046
  "char": "r",
1139
- "description": "git remote of app to use",
1047
+ "description": "the git remote to create, default \"heroku\"",
1140
1048
  "name": "remote",
1049
+ "default": "heroku",
1050
+ "hasDynamicHelp": false,
1051
+ "multiple": false,
1052
+ "type": "option"
1053
+ },
1054
+ "stack": {
1055
+ "char": "s",
1056
+ "description": "the stack to create the app on",
1057
+ "name": "stack",
1058
+ "hasDynamicHelp": false,
1059
+ "multiple": false,
1060
+ "type": "option"
1061
+ },
1062
+ "space": {
1063
+ "description": "the private space to create the app in",
1064
+ "name": "space",
1065
+ "hasDynamicHelp": false,
1066
+ "multiple": false,
1067
+ "type": "option"
1068
+ },
1069
+ "region": {
1070
+ "description": "specify region for the app to run in",
1071
+ "name": "region",
1072
+ "hasDynamicHelp": false,
1073
+ "multiple": false,
1074
+ "type": "option"
1075
+ },
1076
+ "internal-routing": {
1077
+ "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
1078
+ "hidden": true,
1079
+ "name": "internal-routing",
1080
+ "allowNo": false,
1081
+ "type": "boolean"
1082
+ },
1083
+ "features": {
1084
+ "hidden": true,
1085
+ "name": "features",
1086
+ "hasDynamicHelp": false,
1087
+ "multiple": false,
1088
+ "type": "option"
1089
+ },
1090
+ "kernel": {
1091
+ "hidden": true,
1092
+ "name": "kernel",
1093
+ "hasDynamicHelp": false,
1094
+ "multiple": false,
1095
+ "type": "option"
1096
+ },
1097
+ "locked": {
1098
+ "hidden": true,
1099
+ "name": "locked",
1100
+ "allowNo": false,
1101
+ "type": "boolean"
1102
+ },
1103
+ "json": {
1104
+ "description": "output in json format",
1105
+ "name": "json",
1106
+ "allowNo": false,
1107
+ "type": "boolean"
1108
+ },
1109
+ "team": {
1110
+ "char": "t",
1111
+ "description": "team to use",
1112
+ "name": "team",
1141
1113
  "hasDynamicHelp": false,
1142
1114
  "multiple": false,
1143
1115
  "type": "option"
@@ -1145,52 +1117,31 @@
1145
1117
  },
1146
1118
  "hasDynamicHelp": false,
1147
1119
  "hiddenAliases": [
1148
- "rename"
1120
+ "create"
1149
1121
  ],
1150
- "id": "apps:rename",
1122
+ "id": "apps:create",
1151
1123
  "pluginAlias": "heroku",
1152
1124
  "pluginName": "heroku",
1153
1125
  "pluginType": "core",
1154
1126
  "strict": true,
1155
- "help": "This will locally update the git remote if it is set to the old app.",
1156
- "topic": "apps",
1157
1127
  "isESM": false,
1158
1128
  "relativePath": [
1159
1129
  "lib",
1160
1130
  "commands",
1161
1131
  "apps",
1162
- "rename.js"
1132
+ "create.js"
1163
1133
  ]
1164
1134
  },
1165
- "apps:transfer": {
1135
+ "apps:destroy": {
1166
1136
  "aliases": [],
1167
1137
  "args": {
1168
- "recipient": {
1169
- "description": "user or team to transfer applications to",
1170
- "name": "recipient",
1171
- "required": true
1138
+ "app": {
1139
+ "hidden": true,
1140
+ "name": "app"
1172
1141
  }
1173
1142
  },
1174
- "description": "transfer applications to another user or team",
1175
- "examples": [
1176
- "$ heroku apps:transfer collaborator@example.com\nTransferring example to collaborator@example.com... done\n\n$ heroku apps:transfer acme-widgets\nTransferring example to acme-widgets... done\n\n$ heroku apps:transfer --bulk acme-widgets\n..."
1177
- ],
1143
+ "description": "permanently destroy an app",
1178
1144
  "flags": {
1179
- "locked": {
1180
- "char": "l",
1181
- "description": "lock the app upon transfer",
1182
- "name": "locked",
1183
- "required": false,
1184
- "allowNo": false,
1185
- "type": "boolean"
1186
- },
1187
- "bulk": {
1188
- "description": "transfer applications in bulk",
1189
- "name": "bulk",
1190
- "required": false,
1191
- "allowNo": false,
1192
- "type": "boolean"
1193
- },
1194
1145
  "app": {
1195
1146
  "char": "a",
1196
1147
  "description": "app to run command against",
@@ -1209,7 +1160,6 @@
1209
1160
  },
1210
1161
  "confirm": {
1211
1162
  "char": "c",
1212
- "hidden": true,
1213
1163
  "name": "confirm",
1214
1164
  "hasDynamicHelp": false,
1215
1165
  "multiple": false,
@@ -1217,27 +1167,28 @@
1217
1167
  }
1218
1168
  },
1219
1169
  "hasDynamicHelp": false,
1220
- "hiddenAliases": [],
1221
- "id": "apps:transfer",
1170
+ "hiddenAliases": [
1171
+ "destroy",
1172
+ "apps:delete"
1173
+ ],
1174
+ "id": "apps:destroy",
1222
1175
  "pluginAlias": "heroku",
1223
1176
  "pluginName": "heroku",
1224
1177
  "pluginType": "core",
1225
1178
  "strict": true,
1226
- "topic": "apps",
1179
+ "help": "This will also destroy all add-ons on the app.",
1227
1180
  "isESM": false,
1228
1181
  "relativePath": [
1229
1182
  "lib",
1230
1183
  "commands",
1231
1184
  "apps",
1232
- "transfer.js"
1185
+ "destroy.js"
1233
1186
  ]
1234
1187
  },
1235
- "apps:unlock": {
1236
- "aliases": [
1237
- "unlock"
1238
- ],
1188
+ "apps:errors": {
1189
+ "aliases": [],
1239
1190
  "args": {},
1240
- "description": "unlock an app so any team member can join",
1191
+ "description": "view app errors",
1241
1192
  "flags": {
1242
1193
  "app": {
1243
1194
  "char": "a",
@@ -1255,134 +1206,140 @@
1255
1206
  "hasDynamicHelp": false,
1256
1207
  "multiple": false,
1257
1208
  "type": "option"
1209
+ },
1210
+ "json": {
1211
+ "description": "output in json format",
1212
+ "name": "json",
1213
+ "allowNo": false,
1214
+ "type": "boolean"
1215
+ },
1216
+ "hours": {
1217
+ "description": "number of hours to look back (default 24)",
1218
+ "name": "hours",
1219
+ "default": "24",
1220
+ "hasDynamicHelp": false,
1221
+ "multiple": false,
1222
+ "type": "option"
1223
+ },
1224
+ "router": {
1225
+ "description": "show only router errors",
1226
+ "name": "router",
1227
+ "allowNo": false,
1228
+ "type": "boolean"
1229
+ },
1230
+ "dyno": {
1231
+ "description": "show only dyno errors",
1232
+ "name": "dyno",
1233
+ "allowNo": false,
1234
+ "type": "boolean"
1258
1235
  }
1259
1236
  },
1260
1237
  "hasDynamicHelp": false,
1261
1238
  "hiddenAliases": [],
1262
- "id": "apps:unlock",
1239
+ "id": "apps:errors",
1263
1240
  "pluginAlias": "heroku",
1264
1241
  "pluginName": "heroku",
1265
1242
  "pluginType": "core",
1266
1243
  "strict": true,
1267
- "topic": "apps",
1268
1244
  "isESM": false,
1269
1245
  "relativePath": [
1270
1246
  "lib",
1271
1247
  "commands",
1272
1248
  "apps",
1273
- "unlock.js"
1249
+ "errors.js"
1274
1250
  ]
1275
1251
  },
1276
- "addons:attach": {
1252
+ "apps": {
1277
1253
  "aliases": [],
1278
- "args": {
1279
- "addon_name": {
1280
- "description": "unique identifier or globally unique name of the add-on",
1281
- "name": "addon_name",
1282
- "required": true
1283
- }
1284
- },
1285
- "description": "attach an existing add-on resource to an app",
1254
+ "args": {},
1255
+ "description": "list your apps",
1256
+ "examples": [
1257
+ "$ heroku apps"
1258
+ ],
1286
1259
  "flags": {
1287
- "as": {
1288
- "description": "name for add-on attachment",
1289
- "name": "as",
1290
- "hasDynamicHelp": false,
1291
- "multiple": false,
1292
- "type": "option"
1260
+ "all": {
1261
+ "char": "A",
1262
+ "description": "include apps in all teams",
1263
+ "name": "all",
1264
+ "allowNo": false,
1265
+ "type": "boolean"
1293
1266
  },
1294
- "credential": {
1295
- "description": "credential name for scoped access to Heroku Postgres",
1296
- "name": "credential",
1297
- "hasDynamicHelp": false,
1298
- "multiple": false,
1299
- "type": "option"
1267
+ "json": {
1268
+ "char": "j",
1269
+ "description": "output in json format",
1270
+ "name": "json",
1271
+ "allowNo": false,
1272
+ "type": "boolean"
1300
1273
  },
1301
- "confirm": {
1302
- "description": "overwrite existing add-on attachment with same name",
1303
- "name": "confirm",
1274
+ "space": {
1275
+ "char": "s",
1276
+ "description": "filter by space",
1277
+ "name": "space",
1304
1278
  "hasDynamicHelp": false,
1305
1279
  "multiple": false,
1306
1280
  "type": "option"
1307
1281
  },
1308
- "app": {
1309
- "char": "a",
1310
- "description": "app to run command against",
1311
- "name": "app",
1312
- "required": true,
1313
- "hasDynamicHelp": false,
1314
- "multiple": false,
1315
- "type": "option"
1282
+ "personal": {
1283
+ "char": "p",
1284
+ "description": "list apps in personal account when a default team is set",
1285
+ "name": "personal",
1286
+ "allowNo": false,
1287
+ "type": "boolean"
1316
1288
  },
1317
- "remote": {
1318
- "char": "r",
1319
- "description": "git remote of app to use",
1320
- "name": "remote",
1289
+ "internal-routing": {
1290
+ "char": "i",
1291
+ "description": "filter to Internal Web Apps",
1292
+ "hidden": true,
1293
+ "name": "internal-routing",
1294
+ "allowNo": false,
1295
+ "type": "boolean"
1296
+ },
1297
+ "team": {
1298
+ "char": "t",
1299
+ "description": "team to use",
1300
+ "name": "team",
1321
1301
  "hasDynamicHelp": false,
1322
1302
  "multiple": false,
1323
1303
  "type": "option"
1324
1304
  }
1325
1305
  },
1326
1306
  "hasDynamicHelp": false,
1327
- "hiddenAliases": [],
1328
- "id": "addons:attach",
1307
+ "hiddenAliases": [
1308
+ "list",
1309
+ "apps:list"
1310
+ ],
1311
+ "id": "apps",
1329
1312
  "pluginAlias": "heroku",
1330
1313
  "pluginName": "heroku",
1331
1314
  "pluginType": "core",
1332
1315
  "strict": true,
1333
- "topic": "addons",
1316
+ "topic": "apps",
1334
1317
  "isESM": false,
1335
1318
  "relativePath": [
1336
1319
  "lib",
1337
1320
  "commands",
1338
- "addons",
1339
- "attach.js"
1321
+ "apps",
1322
+ "index.js"
1340
1323
  ]
1341
1324
  },
1342
- "addons:create": {
1325
+ "apps:info": {
1343
1326
  "aliases": [],
1344
1327
  "args": {
1345
- "service:plan": {
1346
- "description": "unique identifier or unique name of the add-on service plan",
1347
- "name": "service:plan",
1348
- "required": true
1328
+ "app": {
1329
+ "hidden": true,
1330
+ "name": "app"
1349
1331
  }
1350
1332
  },
1351
- "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
1352
- "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
1333
+ "description": "show detailed app information",
1334
+ "examples": [
1335
+ "$ heroku apps:info",
1336
+ "$ heroku apps:info --shell"
1337
+ ],
1353
1338
  "flags": {
1354
- "name": {
1355
- "description": "name for the add-on resource",
1356
- "name": "name",
1357
- "hasDynamicHelp": false,
1358
- "multiple": false,
1359
- "type": "option"
1360
- },
1361
- "as": {
1362
- "description": "name for the initial add-on attachment",
1363
- "name": "as",
1364
- "hasDynamicHelp": false,
1365
- "multiple": false,
1366
- "type": "option"
1367
- },
1368
- "confirm": {
1369
- "description": "overwrite existing config vars or existing add-on attachments",
1370
- "name": "confirm",
1371
- "hasDynamicHelp": false,
1372
- "multiple": false,
1373
- "type": "option"
1374
- },
1375
- "wait": {
1376
- "description": "watch add-on creation status and exit when complete",
1377
- "name": "wait",
1378
- "allowNo": false,
1379
- "type": "boolean"
1380
- },
1381
1339
  "app": {
1382
1340
  "char": "a",
1383
1341
  "description": "app to run command against",
1384
1342
  "name": "app",
1385
- "required": true,
1386
1343
  "hasDynamicHelp": false,
1387
1344
  "multiple": false,
1388
1345
  "type": "option"
@@ -1394,65 +1351,60 @@
1394
1351
  "hasDynamicHelp": false,
1395
1352
  "multiple": false,
1396
1353
  "type": "option"
1354
+ },
1355
+ "shell": {
1356
+ "char": "s",
1357
+ "description": "output more shell friendly key/value pairs",
1358
+ "name": "shell",
1359
+ "allowNo": false,
1360
+ "type": "boolean"
1361
+ },
1362
+ "extended": {
1363
+ "char": "x",
1364
+ "hidden": true,
1365
+ "name": "extended",
1366
+ "allowNo": false,
1367
+ "type": "boolean"
1368
+ },
1369
+ "json": {
1370
+ "char": "j",
1371
+ "description": "output in json format",
1372
+ "name": "json",
1373
+ "allowNo": false,
1374
+ "type": "boolean"
1397
1375
  }
1398
1376
  },
1399
1377
  "hasDynamicHelp": false,
1400
1378
  "hiddenAliases": [
1401
- "addons:add"
1379
+ "info"
1402
1380
  ],
1403
- "id": "addons:create",
1381
+ "id": "apps:info",
1404
1382
  "pluginAlias": "heroku",
1405
1383
  "pluginName": "heroku",
1406
1384
  "pluginType": "core",
1407
- "strict": false,
1408
- "topic": "addons",
1409
- "example": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
1385
+ "strict": true,
1386
+ "topic": "apps",
1387
+ "help": "$ heroku apps:info\n=== example\nGit URL: https://git.heroku.com/example.git\nRepo Size: 5M\n...\n\n$ heroku apps:info --shell\ngit_url=https://git.heroku.com/example.git\nrepo_size=5000000\n...",
1410
1388
  "isESM": false,
1411
1389
  "relativePath": [
1412
1390
  "lib",
1413
1391
  "commands",
1414
- "addons",
1415
- "create.js"
1392
+ "apps",
1393
+ "info.js"
1416
1394
  ]
1417
1395
  },
1418
- "addons:destroy": {
1419
- "aliases": [],
1420
- "args": {
1421
- "addonName": {
1422
- "description": "unique identifier or globally unique name of the add-on",
1423
- "name": "addonName",
1424
- "required": true
1425
- }
1426
- },
1427
- "description": "permanently destroy an add-on resource",
1428
- "examples": [
1429
- "addons:destroy [ADDON]... [flags]"
1396
+ "apps:join": {
1397
+ "aliases": [
1398
+ "join"
1430
1399
  ],
1400
+ "args": {},
1401
+ "description": "add yourself to a team app",
1431
1402
  "flags": {
1432
- "force": {
1433
- "char": "f",
1434
- "description": "allow destruction even if connected to other apps",
1435
- "name": "force",
1436
- "allowNo": false,
1437
- "type": "boolean"
1438
- },
1439
- "confirm": {
1440
- "char": "c",
1441
- "name": "confirm",
1442
- "hasDynamicHelp": false,
1443
- "multiple": false,
1444
- "type": "option"
1445
- },
1446
- "wait": {
1447
- "description": "watch add-on destruction status and exit when complete",
1448
- "name": "wait",
1449
- "allowNo": false,
1450
- "type": "boolean"
1451
- },
1452
1403
  "app": {
1453
1404
  "char": "a",
1454
1405
  "description": "app to run command against",
1455
1406
  "name": "app",
1407
+ "required": true,
1456
1408
  "hasDynamicHelp": false,
1457
1409
  "multiple": false,
1458
1410
  "type": "option"
@@ -1467,33 +1419,28 @@
1467
1419
  }
1468
1420
  },
1469
1421
  "hasDynamicHelp": false,
1470
- "hiddenAliases": [
1471
- "addons:remove"
1472
- ],
1473
- "id": "addons:destroy",
1422
+ "hiddenAliases": [],
1423
+ "id": "apps:join",
1474
1424
  "pluginAlias": "heroku",
1475
1425
  "pluginName": "heroku",
1476
1426
  "pluginType": "core",
1477
- "strict": false,
1478
- "topic": "addons",
1427
+ "strict": true,
1428
+ "topic": "apps",
1479
1429
  "isESM": false,
1480
1430
  "relativePath": [
1481
1431
  "lib",
1482
1432
  "commands",
1483
- "addons",
1484
- "destroy.js"
1433
+ "apps",
1434
+ "join.js"
1485
1435
  ]
1486
1436
  },
1487
- "addons:detach": {
1488
- "aliases": [],
1489
- "args": {
1490
- "attachment_name": {
1491
- "description": "unique identifier of the add-on attachment",
1492
- "name": "attachment_name",
1493
- "required": true
1494
- }
1495
- },
1496
- "description": "detach an existing add-on resource from an app",
1437
+ "apps:leave": {
1438
+ "aliases": [
1439
+ "leave"
1440
+ ],
1441
+ "args": {},
1442
+ "description": "remove yourself from a team app",
1443
+ "examples": "heroku apps:leave -a APP",
1497
1444
  "flags": {
1498
1445
  "app": {
1499
1446
  "char": "a",
@@ -1515,41 +1462,33 @@
1515
1462
  },
1516
1463
  "hasDynamicHelp": false,
1517
1464
  "hiddenAliases": [],
1518
- "id": "addons:detach",
1465
+ "id": "apps:leave",
1519
1466
  "pluginAlias": "heroku",
1520
1467
  "pluginName": "heroku",
1521
1468
  "pluginType": "core",
1522
1469
  "strict": true,
1523
- "topic": "addons",
1470
+ "topic": "apps",
1471
+ "example": "heroku apps:leave -a APP",
1524
1472
  "isESM": false,
1525
1473
  "relativePath": [
1526
1474
  "lib",
1527
1475
  "commands",
1528
- "addons",
1529
- "detach.js"
1476
+ "apps",
1477
+ "leave.js"
1530
1478
  ]
1531
1479
  },
1532
- "addons:docs": {
1533
- "aliases": [],
1534
- "args": {
1535
- "addon": {
1536
- "description": "unique identifier or globally unique name of the add-on",
1537
- "name": "addon",
1538
- "required": true
1539
- }
1540
- },
1541
- "description": "open an add-on's Dev Center documentation in your browser",
1480
+ "apps:lock": {
1481
+ "aliases": [
1482
+ "lock"
1483
+ ],
1484
+ "args": {},
1485
+ "description": "prevent team members from joining an app",
1542
1486
  "flags": {
1543
- "show-url": {
1544
- "description": "show URL, do not open browser",
1545
- "name": "show-url",
1546
- "allowNo": false,
1547
- "type": "boolean"
1548
- },
1549
1487
  "app": {
1550
1488
  "char": "a",
1551
1489
  "description": "app to run command against",
1552
1490
  "name": "app",
1491
+ "required": true,
1553
1492
  "hasDynamicHelp": false,
1554
1493
  "multiple": false,
1555
1494
  "type": "option"
@@ -1565,46 +1504,40 @@
1565
1504
  },
1566
1505
  "hasDynamicHelp": false,
1567
1506
  "hiddenAliases": [],
1568
- "id": "addons:docs",
1507
+ "id": "apps:lock",
1569
1508
  "pluginAlias": "heroku",
1570
1509
  "pluginName": "heroku",
1571
1510
  "pluginType": "core",
1572
1511
  "strict": true,
1573
- "topic": "addons",
1512
+ "topic": "apps",
1574
1513
  "isESM": false,
1575
1514
  "relativePath": [
1576
1515
  "lib",
1577
1516
  "commands",
1578
- "addons",
1579
- "docs.js"
1517
+ "apps",
1518
+ "lock.js"
1580
1519
  ]
1581
1520
  },
1582
- "addons": {
1521
+ "apps:open": {
1583
1522
  "aliases": [],
1584
- "args": {},
1585
- "description": "Lists your add-ons and attachments.\n\n The default filter applied depends on whether you are in a Heroku app\n directory. If so, the --app flag is implied. If not, the default of --all\n is implied. Explicitly providing either flag overrides the default\n behavior.\n ",
1523
+ "args": {
1524
+ "path": {
1525
+ "description": "base URL path of app",
1526
+ "name": "path",
1527
+ "required": false
1528
+ }
1529
+ },
1530
+ "description": "open the app in a web browser",
1586
1531
  "examples": [
1587
- "$ heroku addons --all",
1588
- "$ heroku addons --app acme-inc-www"
1532
+ "$ heroku open -a myapp",
1533
+ "$ heroku open -a myapp /foo"
1589
1534
  ],
1590
1535
  "flags": {
1591
- "all": {
1592
- "char": "A",
1593
- "description": "show add-ons and attachments for all accessible apps",
1594
- "name": "all",
1595
- "allowNo": false,
1596
- "type": "boolean"
1597
- },
1598
- "json": {
1599
- "description": "return add-ons in json format",
1600
- "name": "json",
1601
- "allowNo": false,
1602
- "type": "boolean"
1603
- },
1604
1536
  "app": {
1605
1537
  "char": "a",
1606
1538
  "description": "app to run command against",
1607
1539
  "name": "app",
1540
+ "required": true,
1608
1541
  "hasDynamicHelp": false,
1609
1542
  "multiple": false,
1610
1543
  "type": "option"
@@ -1619,37 +1552,42 @@
1619
1552
  }
1620
1553
  },
1621
1554
  "hasDynamicHelp": false,
1622
- "hiddenAliases": [],
1623
- "id": "addons",
1555
+ "hiddenAliases": [
1556
+ "open"
1557
+ ],
1558
+ "id": "apps:open",
1624
1559
  "pluginAlias": "heroku",
1625
1560
  "pluginName": "heroku",
1626
1561
  "pluginType": "core",
1627
1562
  "strict": true,
1628
- "usage": "addons [--all|--app APP]",
1629
- "topic": "addons",
1563
+ "topic": "apps",
1630
1564
  "isESM": false,
1631
1565
  "relativePath": [
1632
1566
  "lib",
1633
1567
  "commands",
1634
- "addons",
1635
- "index.js"
1568
+ "apps",
1569
+ "open.js"
1636
1570
  ]
1637
1571
  },
1638
- "addons:info": {
1572
+ "apps:rename": {
1639
1573
  "aliases": [],
1640
1574
  "args": {
1641
- "addon": {
1642
- "description": "unique identifier or globally unique name of the add-on",
1643
- "name": "addon",
1575
+ "newname": {
1576
+ "description": "new unique name of the app",
1577
+ "name": "newname",
1644
1578
  "required": true
1645
1579
  }
1646
1580
  },
1647
- "description": "show detailed add-on resource and attachment information",
1581
+ "description": "rename an app",
1582
+ "examples": [
1583
+ "$ heroku apps:rename --app oldname newname"
1584
+ ],
1648
1585
  "flags": {
1649
1586
  "app": {
1650
1587
  "char": "a",
1651
1588
  "description": "app to run command against",
1652
1589
  "name": "app",
1590
+ "required": true,
1653
1591
  "hasDynamicHelp": false,
1654
1592
  "multiple": false,
1655
1593
  "type": "option"
@@ -1664,36 +1602,50 @@
1664
1602
  }
1665
1603
  },
1666
1604
  "hasDynamicHelp": false,
1667
- "hiddenAliases": [],
1668
- "id": "addons:info",
1605
+ "hiddenAliases": [
1606
+ "rename"
1607
+ ],
1608
+ "id": "apps:rename",
1669
1609
  "pluginAlias": "heroku",
1670
1610
  "pluginName": "heroku",
1671
1611
  "pluginType": "core",
1672
1612
  "strict": true,
1673
- "usage": "addons:info ADDON",
1674
- "topic": "addons",
1613
+ "help": "This will locally update the git remote if it is set to the old app.",
1614
+ "topic": "apps",
1675
1615
  "isESM": false,
1676
1616
  "relativePath": [
1677
1617
  "lib",
1678
1618
  "commands",
1679
- "addons",
1680
- "info.js"
1619
+ "apps",
1620
+ "rename.js"
1681
1621
  ]
1682
1622
  },
1683
- "addons:open": {
1623
+ "apps:transfer": {
1684
1624
  "aliases": [],
1685
1625
  "args": {
1686
- "addon": {
1687
- "description": "unique identifier or globally unique name of the add-on",
1688
- "name": "addon",
1626
+ "recipient": {
1627
+ "description": "user or team to transfer applications to",
1628
+ "name": "recipient",
1689
1629
  "required": true
1690
1630
  }
1691
1631
  },
1692
- "description": "open an add-on's dashboard in your browser",
1632
+ "description": "transfer applications to another user or team",
1633
+ "examples": [
1634
+ "$ heroku apps:transfer collaborator@example.com\nTransferring example to collaborator@example.com... done\n\n$ heroku apps:transfer acme-widgets\nTransferring example to acme-widgets... done\n\n$ heroku apps:transfer --bulk acme-widgets\n..."
1635
+ ],
1693
1636
  "flags": {
1694
- "show-url": {
1695
- "description": "show URL, do not open browser",
1696
- "name": "show-url",
1637
+ "locked": {
1638
+ "char": "l",
1639
+ "description": "lock the app upon transfer",
1640
+ "name": "locked",
1641
+ "required": false,
1642
+ "allowNo": false,
1643
+ "type": "boolean"
1644
+ },
1645
+ "bulk": {
1646
+ "description": "transfer applications in bulk",
1647
+ "name": "bulk",
1648
+ "required": false,
1697
1649
  "allowNo": false,
1698
1650
  "type": "boolean"
1699
1651
  },
@@ -1712,95 +1664,151 @@
1712
1664
  "hasDynamicHelp": false,
1713
1665
  "multiple": false,
1714
1666
  "type": "option"
1667
+ },
1668
+ "confirm": {
1669
+ "char": "c",
1670
+ "hidden": true,
1671
+ "name": "confirm",
1672
+ "hasDynamicHelp": false,
1673
+ "multiple": false,
1674
+ "type": "option"
1715
1675
  }
1716
1676
  },
1717
1677
  "hasDynamicHelp": false,
1718
1678
  "hiddenAliases": [],
1719
- "id": "addons:open",
1679
+ "id": "apps:transfer",
1720
1680
  "pluginAlias": "heroku",
1721
1681
  "pluginName": "heroku",
1722
1682
  "pluginType": "core",
1723
1683
  "strict": true,
1724
- "topic": "addons",
1684
+ "topic": "apps",
1725
1685
  "isESM": false,
1726
1686
  "relativePath": [
1727
1687
  "lib",
1728
1688
  "commands",
1729
- "addons",
1730
- "open.js"
1689
+ "apps",
1690
+ "transfer.js"
1731
1691
  ]
1732
1692
  },
1733
- "addons:plans": {
1734
- "aliases": [],
1735
- "args": {
1736
- "service": {
1737
- "description": "unique identifier or globally unique name of the add-on",
1738
- "name": "service",
1739
- "required": true
1740
- }
1741
- },
1742
- "description": "list all available plans for an add-on service",
1693
+ "apps:unlock": {
1694
+ "aliases": [
1695
+ "unlock"
1696
+ ],
1697
+ "args": {},
1698
+ "description": "unlock an app so any team member can join",
1743
1699
  "flags": {
1744
- "json": {
1745
- "description": "output in json format",
1746
- "name": "json",
1747
- "allowNo": false,
1748
- "type": "boolean"
1700
+ "app": {
1701
+ "char": "a",
1702
+ "description": "app to run command against",
1703
+ "name": "app",
1704
+ "required": true,
1705
+ "hasDynamicHelp": false,
1706
+ "multiple": false,
1707
+ "type": "option"
1708
+ },
1709
+ "remote": {
1710
+ "char": "r",
1711
+ "description": "git remote of app to use",
1712
+ "name": "remote",
1713
+ "hasDynamicHelp": false,
1714
+ "multiple": false,
1715
+ "type": "option"
1749
1716
  }
1750
1717
  },
1751
1718
  "hasDynamicHelp": false,
1752
1719
  "hiddenAliases": [],
1753
- "id": "addons:plans",
1720
+ "id": "apps:unlock",
1754
1721
  "pluginAlias": "heroku",
1755
1722
  "pluginName": "heroku",
1756
1723
  "pluginType": "core",
1757
1724
  "strict": true,
1758
- "topic": "addons",
1725
+ "topic": "apps",
1759
1726
  "isESM": false,
1760
1727
  "relativePath": [
1761
1728
  "lib",
1762
1729
  "commands",
1763
- "addons",
1764
- "plans.js"
1730
+ "apps",
1731
+ "unlock.js"
1765
1732
  ]
1766
1733
  },
1767
- "addons:rename": {
1734
+ "access:add": {
1768
1735
  "aliases": [],
1769
1736
  "args": {
1770
- "addon_name": {
1771
- "description": "unique identifier or globally unique name of the add-on",
1772
- "name": "addon_name",
1737
+ "email": {
1738
+ "description": "email address of the team member",
1739
+ "name": "email",
1773
1740
  "required": true
1741
+ }
1742
+ },
1743
+ "description": "add new users to your app",
1744
+ "examples": [
1745
+ "$ heroku access:add user@email.com --app APP # add a collaborator to your app",
1746
+ "$ heroku access:add user@email.com --app APP --permissions deploy,manage,operate # permissions must be comma separated"
1747
+ ],
1748
+ "flags": {
1749
+ "app": {
1750
+ "char": "a",
1751
+ "description": "app to run command against",
1752
+ "name": "app",
1753
+ "required": true,
1754
+ "hasDynamicHelp": false,
1755
+ "multiple": false,
1756
+ "type": "option"
1774
1757
  },
1775
- "new_name": {
1776
- "description": "new globally unique name of the add-on",
1777
- "name": "new_name",
1778
- "required": true
1758
+ "remote": {
1759
+ "char": "r",
1760
+ "description": "git remote of app to use",
1761
+ "name": "remote",
1762
+ "hasDynamicHelp": false,
1763
+ "multiple": false,
1764
+ "type": "option"
1765
+ },
1766
+ "permissions": {
1767
+ "char": "p",
1768
+ "description": "list of permissions comma separated",
1769
+ "name": "permissions",
1770
+ "hasDynamicHelp": false,
1771
+ "multiple": false,
1772
+ "type": "option"
1779
1773
  }
1780
1774
  },
1781
- "description": "rename an add-on",
1782
- "flags": {},
1783
1775
  "hasDynamicHelp": false,
1784
1776
  "hiddenAliases": [],
1785
- "id": "addons:rename",
1777
+ "id": "access:add",
1786
1778
  "pluginAlias": "heroku",
1787
1779
  "pluginName": "heroku",
1788
1780
  "pluginType": "core",
1789
1781
  "strict": true,
1790
- "topic": "addons",
1791
1782
  "isESM": false,
1792
1783
  "relativePath": [
1793
1784
  "lib",
1794
1785
  "commands",
1795
- "addons",
1796
- "rename.js"
1786
+ "access",
1787
+ "add.js"
1797
1788
  ]
1798
1789
  },
1799
- "addons:services": {
1790
+ "access": {
1800
1791
  "aliases": [],
1801
1792
  "args": {},
1802
- "description": "list all available add-on services",
1793
+ "description": "list who has access to an app",
1803
1794
  "flags": {
1795
+ "app": {
1796
+ "char": "a",
1797
+ "description": "app to run command against",
1798
+ "name": "app",
1799
+ "required": true,
1800
+ "hasDynamicHelp": false,
1801
+ "multiple": false,
1802
+ "type": "option"
1803
+ },
1804
+ "remote": {
1805
+ "char": "r",
1806
+ "description": "git remote of app to use",
1807
+ "name": "remote",
1808
+ "hasDynamicHelp": false,
1809
+ "multiple": false,
1810
+ "type": "option"
1811
+ },
1804
1812
  "json": {
1805
1813
  "description": "output in json format",
1806
1814
  "name": "json",
@@ -1810,44 +1818,31 @@
1810
1818
  },
1811
1819
  "hasDynamicHelp": false,
1812
1820
  "hiddenAliases": [],
1813
- "id": "addons:services",
1821
+ "id": "access",
1814
1822
  "pluginAlias": "heroku",
1815
1823
  "pluginName": "heroku",
1816
1824
  "pluginType": "core",
1817
1825
  "strict": true,
1818
- "topic": "addons",
1826
+ "topic": "access",
1819
1827
  "isESM": false,
1820
1828
  "relativePath": [
1821
1829
  "lib",
1822
1830
  "commands",
1823
- "addons",
1824
- "services.js"
1831
+ "access",
1832
+ "index.js"
1825
1833
  ]
1826
1834
  },
1827
- "addons:upgrade": {
1828
- "aliases": [
1829
- "addons:downgrade"
1830
- ],
1831
- "args": {
1832
- "addon": {
1833
- "description": "unique identifier or globally unique name of the add-on",
1834
- "name": "addon",
1835
- "required": true
1836
- },
1837
- "plan": {
1838
- "description": "unique identifier or name of the plan",
1839
- "name": "plan"
1840
- }
1841
- },
1842
- "description": "change add-on plan.\n See available plans with `heroku addons:plans SERVICE`.\n\n Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same. Either one can be used to change an add-on plan up or down.\n\n https://devcenter.heroku.com/articles/managing-add-ons\n ",
1843
- "examples": [
1844
- "Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2"
1845
- ],
1835
+ "access:remove": {
1836
+ "aliases": [],
1837
+ "args": {},
1838
+ "description": "remove users from a team app",
1839
+ "examples": "$ heroku access:remove user@email.com --app APP",
1846
1840
  "flags": {
1847
1841
  "app": {
1848
1842
  "char": "a",
1849
1843
  "description": "app to run command against",
1850
1844
  "name": "app",
1845
+ "required": true,
1851
1846
  "hasDynamicHelp": false,
1852
1847
  "multiple": false,
1853
1848
  "type": "option"
@@ -1863,33 +1858,37 @@
1863
1858
  },
1864
1859
  "hasDynamicHelp": false,
1865
1860
  "hiddenAliases": [],
1866
- "id": "addons:upgrade",
1861
+ "id": "access:remove",
1867
1862
  "pluginAlias": "heroku",
1868
1863
  "pluginName": "heroku",
1869
1864
  "pluginType": "core",
1870
- "strict": true,
1871
- "topic": "addons",
1865
+ "strict": false,
1866
+ "example": "$ heroku access:remove user@email.com --app APP",
1867
+ "topic": "access",
1872
1868
  "isESM": false,
1873
1869
  "relativePath": [
1874
1870
  "lib",
1875
1871
  "commands",
1876
- "addons",
1877
- "upgrade.js"
1872
+ "access",
1873
+ "remove.js"
1878
1874
  ]
1879
1875
  },
1880
- "addons:wait": {
1876
+ "access:update": {
1881
1877
  "aliases": [],
1882
1878
  "args": {
1883
- "addon": {
1884
- "description": "unique identifier or globally unique name of the add-on",
1885
- "name": "addon"
1879
+ "email": {
1880
+ "description": "email address of the team member",
1881
+ "name": "email",
1882
+ "required": true
1886
1883
  }
1887
1884
  },
1888
- "description": "show provisioning status of the add-ons on the app",
1885
+ "description": "update existing collaborators on an team app",
1889
1886
  "flags": {
1890
- "wait-interval": {
1891
- "description": "how frequently to poll in seconds",
1892
- "name": "wait-interval",
1887
+ "permissions": {
1888
+ "char": "p",
1889
+ "description": "comma-delimited list of permissions to update (deploy,manage,operate)",
1890
+ "name": "permissions",
1891
+ "required": true,
1893
1892
  "hasDynamicHelp": false,
1894
1893
  "multiple": false,
1895
1894
  "type": "option"
@@ -1898,6 +1897,7 @@
1898
1897
  "char": "a",
1899
1898
  "description": "app to run command against",
1900
1899
  "name": "app",
1900
+ "required": true,
1901
1901
  "hasDynamicHelp": false,
1902
1902
  "multiple": false,
1903
1903
  "type": "option"
@@ -1913,18 +1913,18 @@
1913
1913
  },
1914
1914
  "hasDynamicHelp": false,
1915
1915
  "hiddenAliases": [],
1916
- "id": "addons:wait",
1916
+ "id": "access:update",
1917
1917
  "pluginAlias": "heroku",
1918
1918
  "pluginName": "heroku",
1919
1919
  "pluginType": "core",
1920
1920
  "strict": true,
1921
- "topic": "addons",
1921
+ "topic": "access",
1922
1922
  "isESM": false,
1923
1923
  "relativePath": [
1924
1924
  "lib",
1925
1925
  "commands",
1926
- "addons",
1927
- "wait.js"
1926
+ "access",
1927
+ "update.js"
1928
1928
  ]
1929
1929
  },
1930
1930
  "auth:login": {
@@ -2543,7 +2543,7 @@
2543
2543
  "buildpacks": {
2544
2544
  "aliases": [],
2545
2545
  "args": {},
2546
- "description": "display the buildpacks for an app",
2546
+ "description": "list the buildpacks on an app",
2547
2547
  "flags": {
2548
2548
  "app": {
2549
2549
  "char": "a",
@@ -10078,6 +10078,7 @@
10078
10078
  "type": "option"
10079
10079
  },
10080
10080
  "app": {
10081
+ "char": "a",
10081
10082
  "description": "filter by app name",
10082
10083
  "name": "app",
10083
10084
  "hasDynamicHelp": false,
@@ -10771,61 +10772,271 @@
10771
10772
  }
10772
10773
  },
10773
10774
  "hasDynamicHelp": false,
10774
- "hiddenAliases": [
10775
- "stack:set"
10776
- ],
10777
- "id": "apps:stacks:set",
10778
- "pluginAlias": "heroku",
10779
- "pluginName": "heroku",
10780
- "pluginType": "core",
10781
- "strict": true,
10782
- "example": "$ heroku stack:set heroku-24 -a myapp\nSetting stack to heroku-24... done\nYou will need to redeploy myapp for the change to take effect.\nRun git push heroku main to trigger a new build on myapp.",
10783
- "isESM": false,
10784
- "relativePath": [
10785
- "lib",
10786
- "commands",
10787
- "apps",
10788
- "stacks",
10789
- "set.js"
10790
- ]
10791
- },
10792
- "auth:2fa:disable": {
10793
- "aliases": [
10794
- "twofactor:disable",
10795
- "2fa:disable"
10796
- ],
10797
- "args": {},
10798
- "description": "disables 2fa on account",
10799
- "examples": "$ heroku auth:2fa:disable",
10800
- "flags": {},
10801
- "hasDynamicHelp": false,
10775
+ "hiddenAliases": [
10776
+ "stack:set"
10777
+ ],
10778
+ "id": "apps:stacks:set",
10779
+ "pluginAlias": "heroku",
10780
+ "pluginName": "heroku",
10781
+ "pluginType": "core",
10782
+ "strict": true,
10783
+ "example": "$ heroku stack:set heroku-24 -a myapp\nSetting stack to heroku-24... done\nYou will need to redeploy myapp for the change to take effect.\nRun git push heroku main to trigger a new build on myapp.",
10784
+ "isESM": false,
10785
+ "relativePath": [
10786
+ "lib",
10787
+ "commands",
10788
+ "apps",
10789
+ "stacks",
10790
+ "set.js"
10791
+ ]
10792
+ },
10793
+ "auth:2fa:disable": {
10794
+ "aliases": [
10795
+ "twofactor:disable",
10796
+ "2fa:disable"
10797
+ ],
10798
+ "args": {},
10799
+ "description": "disables 2fa on account",
10800
+ "examples": "$ heroku auth:2fa:disable",
10801
+ "flags": {},
10802
+ "hasDynamicHelp": false,
10803
+ "hiddenAliases": [],
10804
+ "id": "auth:2fa:disable",
10805
+ "pluginAlias": "heroku",
10806
+ "pluginName": "heroku",
10807
+ "pluginType": "core",
10808
+ "strict": true,
10809
+ "example": "$ heroku auth:2fa:disable",
10810
+ "isESM": false,
10811
+ "relativePath": [
10812
+ "lib",
10813
+ "commands",
10814
+ "auth",
10815
+ "2fa",
10816
+ "disable.js"
10817
+ ]
10818
+ },
10819
+ "auth:2fa": {
10820
+ "aliases": [
10821
+ "2fa",
10822
+ "twofactor"
10823
+ ],
10824
+ "args": {},
10825
+ "description": "check 2fa status",
10826
+ "flags": {},
10827
+ "hasDynamicHelp": false,
10828
+ "hiddenAliases": [],
10829
+ "id": "auth:2fa",
10830
+ "pluginAlias": "heroku",
10831
+ "pluginName": "heroku",
10832
+ "pluginType": "core",
10833
+ "strict": true,
10834
+ "isESM": false,
10835
+ "relativePath": [
10836
+ "lib",
10837
+ "commands",
10838
+ "auth",
10839
+ "2fa",
10840
+ "index.js"
10841
+ ]
10842
+ },
10843
+ "certs:auto:disable": {
10844
+ "aliases": [],
10845
+ "args": {},
10846
+ "description": "disable ACM for an app",
10847
+ "flags": {
10848
+ "confirm": {
10849
+ "char": "c",
10850
+ "hidden": true,
10851
+ "name": "confirm",
10852
+ "hasDynamicHelp": false,
10853
+ "multiple": false,
10854
+ "type": "option"
10855
+ },
10856
+ "app": {
10857
+ "char": "a",
10858
+ "description": "app to run command against",
10859
+ "name": "app",
10860
+ "required": true,
10861
+ "hasDynamicHelp": false,
10862
+ "multiple": false,
10863
+ "type": "option"
10864
+ },
10865
+ "remote": {
10866
+ "char": "r",
10867
+ "description": "git remote of app to use",
10868
+ "name": "remote",
10869
+ "hasDynamicHelp": false,
10870
+ "multiple": false,
10871
+ "type": "option"
10872
+ }
10873
+ },
10874
+ "hasDynamicHelp": false,
10875
+ "hiddenAliases": [],
10876
+ "id": "certs:auto:disable",
10877
+ "pluginAlias": "heroku",
10878
+ "pluginName": "heroku",
10879
+ "pluginType": "core",
10880
+ "strict": true,
10881
+ "topic": "certs",
10882
+ "isESM": false,
10883
+ "relativePath": [
10884
+ "lib",
10885
+ "commands",
10886
+ "certs",
10887
+ "auto",
10888
+ "disable.js"
10889
+ ]
10890
+ },
10891
+ "certs:auto:enable": {
10892
+ "aliases": [],
10893
+ "args": {},
10894
+ "description": "enable ACM status for an app",
10895
+ "flags": {
10896
+ "wait": {
10897
+ "description": "watch ACM status and exit when complete",
10898
+ "name": "wait",
10899
+ "allowNo": false,
10900
+ "type": "boolean"
10901
+ },
10902
+ "app": {
10903
+ "char": "a",
10904
+ "description": "app to run command against",
10905
+ "name": "app",
10906
+ "required": true,
10907
+ "hasDynamicHelp": false,
10908
+ "multiple": false,
10909
+ "type": "option"
10910
+ },
10911
+ "remote": {
10912
+ "char": "r",
10913
+ "description": "git remote of app to use",
10914
+ "name": "remote",
10915
+ "hasDynamicHelp": false,
10916
+ "multiple": false,
10917
+ "type": "option"
10918
+ }
10919
+ },
10920
+ "hasDynamicHelp": false,
10921
+ "hiddenAliases": [],
10922
+ "id": "certs:auto:enable",
10923
+ "pluginAlias": "heroku",
10924
+ "pluginName": "heroku",
10925
+ "pluginType": "core",
10926
+ "strict": true,
10927
+ "topic": "certs",
10928
+ "isESM": false,
10929
+ "relativePath": [
10930
+ "lib",
10931
+ "commands",
10932
+ "certs",
10933
+ "auto",
10934
+ "enable.js"
10935
+ ]
10936
+ },
10937
+ "certs:auto": {
10938
+ "aliases": [],
10939
+ "args": {},
10940
+ "description": "show ACM status for an app",
10941
+ "flags": {
10942
+ "wait": {
10943
+ "description": "watch ACM status and display the status when complete",
10944
+ "name": "wait",
10945
+ "allowNo": false,
10946
+ "type": "boolean"
10947
+ },
10948
+ "app": {
10949
+ "char": "a",
10950
+ "description": "app to run command against",
10951
+ "name": "app",
10952
+ "required": true,
10953
+ "hasDynamicHelp": false,
10954
+ "multiple": false,
10955
+ "type": "option"
10956
+ },
10957
+ "remote": {
10958
+ "char": "r",
10959
+ "description": "git remote of app to use",
10960
+ "name": "remote",
10961
+ "hasDynamicHelp": false,
10962
+ "multiple": false,
10963
+ "type": "option"
10964
+ }
10965
+ },
10966
+ "hasDynamicHelp": false,
10967
+ "hiddenAliases": [],
10968
+ "id": "certs:auto",
10969
+ "pluginAlias": "heroku",
10970
+ "pluginName": "heroku",
10971
+ "pluginType": "core",
10972
+ "strict": true,
10973
+ "topic": "certs",
10974
+ "isESM": false,
10975
+ "relativePath": [
10976
+ "lib",
10977
+ "commands",
10978
+ "certs",
10979
+ "auto",
10980
+ "index.js"
10981
+ ]
10982
+ },
10983
+ "certs:auto:refresh": {
10984
+ "aliases": [],
10985
+ "args": {},
10986
+ "description": "refresh ACM for an app",
10987
+ "flags": {
10988
+ "app": {
10989
+ "char": "a",
10990
+ "description": "app to run command against",
10991
+ "name": "app",
10992
+ "required": true,
10993
+ "hasDynamicHelp": false,
10994
+ "multiple": false,
10995
+ "type": "option"
10996
+ },
10997
+ "remote": {
10998
+ "char": "r",
10999
+ "description": "git remote of app to use",
11000
+ "name": "remote",
11001
+ "hasDynamicHelp": false,
11002
+ "multiple": false,
11003
+ "type": "option"
11004
+ }
11005
+ },
11006
+ "hasDynamicHelp": false,
10802
11007
  "hiddenAliases": [],
10803
- "id": "auth:2fa:disable",
11008
+ "id": "certs:auto:refresh",
10804
11009
  "pluginAlias": "heroku",
10805
11010
  "pluginName": "heroku",
10806
11011
  "pluginType": "core",
10807
11012
  "strict": true,
10808
- "example": "$ heroku auth:2fa:disable",
11013
+ "topic": "certs",
10809
11014
  "isESM": false,
10810
11015
  "relativePath": [
10811
11016
  "lib",
10812
11017
  "commands",
10813
- "auth",
10814
- "2fa",
10815
- "disable.js"
11018
+ "certs",
11019
+ "auto",
11020
+ "refresh.js"
10816
11021
  ]
10817
11022
  },
10818
- "auth:2fa": {
10819
- "aliases": [
10820
- "2fa",
10821
- "twofactor"
10822
- ],
11023
+ "certs:auto:wait": {
11024
+ "aliases": [],
10823
11025
  "args": {},
10824
- "description": "check 2fa status",
10825
- "flags": {},
11026
+ "description": "waits for the certificate to be activated",
11027
+ "flags": {
11028
+ "help": {
11029
+ "char": "h",
11030
+ "description": "Show CLI help.",
11031
+ "name": "help",
11032
+ "allowNo": false,
11033
+ "type": "boolean"
11034
+ }
11035
+ },
10826
11036
  "hasDynamicHelp": false,
11037
+ "hidden": true,
10827
11038
  "hiddenAliases": [],
10828
- "id": "auth:2fa",
11039
+ "id": "certs:auto:wait",
10829
11040
  "pluginAlias": "heroku",
10830
11041
  "pluginName": "heroku",
10831
11042
  "pluginType": "core",
@@ -10834,9 +11045,9 @@
10834
11045
  "relativePath": [
10835
11046
  "lib",
10836
11047
  "commands",
10837
- "auth",
10838
- "2fa",
10839
- "index.js"
11048
+ "certs",
11049
+ "auto",
11050
+ "wait.js"
10840
11051
  ]
10841
11052
  },
10842
11053
  "ci:config:get": {
@@ -11056,229 +11267,19 @@
11056
11267
  },
11057
11268
  "hasDynamicHelp": false,
11058
11269
  "hiddenAliases": [],
11059
- "id": "ci:config:unset",
11060
- "pluginAlias": "heroku",
11061
- "pluginName": "heroku",
11062
- "pluginType": "core",
11063
- "strict": false,
11064
- "topic": "ci",
11065
- "isESM": false,
11066
- "relativePath": [
11067
- "lib",
11068
- "commands",
11069
- "ci",
11070
- "config",
11071
- "unset.js"
11072
- ]
11073
- },
11074
- "certs:auto:disable": {
11075
- "aliases": [],
11076
- "args": {},
11077
- "description": "disable ACM for an app",
11078
- "flags": {
11079
- "confirm": {
11080
- "char": "c",
11081
- "hidden": true,
11082
- "name": "confirm",
11083
- "hasDynamicHelp": false,
11084
- "multiple": false,
11085
- "type": "option"
11086
- },
11087
- "app": {
11088
- "char": "a",
11089
- "description": "app to run command against",
11090
- "name": "app",
11091
- "required": true,
11092
- "hasDynamicHelp": false,
11093
- "multiple": false,
11094
- "type": "option"
11095
- },
11096
- "remote": {
11097
- "char": "r",
11098
- "description": "git remote of app to use",
11099
- "name": "remote",
11100
- "hasDynamicHelp": false,
11101
- "multiple": false,
11102
- "type": "option"
11103
- }
11104
- },
11105
- "hasDynamicHelp": false,
11106
- "hiddenAliases": [],
11107
- "id": "certs:auto:disable",
11108
- "pluginAlias": "heroku",
11109
- "pluginName": "heroku",
11110
- "pluginType": "core",
11111
- "strict": true,
11112
- "topic": "certs",
11113
- "isESM": false,
11114
- "relativePath": [
11115
- "lib",
11116
- "commands",
11117
- "certs",
11118
- "auto",
11119
- "disable.js"
11120
- ]
11121
- },
11122
- "certs:auto:enable": {
11123
- "aliases": [],
11124
- "args": {},
11125
- "description": "enable ACM status for an app",
11126
- "flags": {
11127
- "wait": {
11128
- "description": "watch ACM status and exit when complete",
11129
- "name": "wait",
11130
- "allowNo": false,
11131
- "type": "boolean"
11132
- },
11133
- "app": {
11134
- "char": "a",
11135
- "description": "app to run command against",
11136
- "name": "app",
11137
- "required": true,
11138
- "hasDynamicHelp": false,
11139
- "multiple": false,
11140
- "type": "option"
11141
- },
11142
- "remote": {
11143
- "char": "r",
11144
- "description": "git remote of app to use",
11145
- "name": "remote",
11146
- "hasDynamicHelp": false,
11147
- "multiple": false,
11148
- "type": "option"
11149
- }
11150
- },
11151
- "hasDynamicHelp": false,
11152
- "hiddenAliases": [],
11153
- "id": "certs:auto:enable",
11154
- "pluginAlias": "heroku",
11155
- "pluginName": "heroku",
11156
- "pluginType": "core",
11157
- "strict": true,
11158
- "topic": "certs",
11159
- "isESM": false,
11160
- "relativePath": [
11161
- "lib",
11162
- "commands",
11163
- "certs",
11164
- "auto",
11165
- "enable.js"
11166
- ]
11167
- },
11168
- "certs:auto": {
11169
- "aliases": [],
11170
- "args": {},
11171
- "description": "show ACM status for an app",
11172
- "flags": {
11173
- "wait": {
11174
- "description": "watch ACM status and display the status when complete",
11175
- "name": "wait",
11176
- "allowNo": false,
11177
- "type": "boolean"
11178
- },
11179
- "app": {
11180
- "char": "a",
11181
- "description": "app to run command against",
11182
- "name": "app",
11183
- "required": true,
11184
- "hasDynamicHelp": false,
11185
- "multiple": false,
11186
- "type": "option"
11187
- },
11188
- "remote": {
11189
- "char": "r",
11190
- "description": "git remote of app to use",
11191
- "name": "remote",
11192
- "hasDynamicHelp": false,
11193
- "multiple": false,
11194
- "type": "option"
11195
- }
11196
- },
11197
- "hasDynamicHelp": false,
11198
- "hiddenAliases": [],
11199
- "id": "certs:auto",
11200
- "pluginAlias": "heroku",
11201
- "pluginName": "heroku",
11202
- "pluginType": "core",
11203
- "strict": true,
11204
- "topic": "certs",
11205
- "isESM": false,
11206
- "relativePath": [
11207
- "lib",
11208
- "commands",
11209
- "certs",
11210
- "auto",
11211
- "index.js"
11212
- ]
11213
- },
11214
- "certs:auto:refresh": {
11215
- "aliases": [],
11216
- "args": {},
11217
- "description": "refresh ACM for an app",
11218
- "flags": {
11219
- "app": {
11220
- "char": "a",
11221
- "description": "app to run command against",
11222
- "name": "app",
11223
- "required": true,
11224
- "hasDynamicHelp": false,
11225
- "multiple": false,
11226
- "type": "option"
11227
- },
11228
- "remote": {
11229
- "char": "r",
11230
- "description": "git remote of app to use",
11231
- "name": "remote",
11232
- "hasDynamicHelp": false,
11233
- "multiple": false,
11234
- "type": "option"
11235
- }
11236
- },
11237
- "hasDynamicHelp": false,
11238
- "hiddenAliases": [],
11239
- "id": "certs:auto:refresh",
11240
- "pluginAlias": "heroku",
11241
- "pluginName": "heroku",
11242
- "pluginType": "core",
11243
- "strict": true,
11244
- "topic": "certs",
11245
- "isESM": false,
11246
- "relativePath": [
11247
- "lib",
11248
- "commands",
11249
- "certs",
11250
- "auto",
11251
- "refresh.js"
11252
- ]
11253
- },
11254
- "certs:auto:wait": {
11255
- "aliases": [],
11256
- "args": {},
11257
- "description": "waits for the certificate to be activated",
11258
- "flags": {
11259
- "help": {
11260
- "char": "h",
11261
- "description": "Show CLI help.",
11262
- "name": "help",
11263
- "allowNo": false,
11264
- "type": "boolean"
11265
- }
11266
- },
11267
- "hasDynamicHelp": false,
11268
- "hidden": true,
11269
- "hiddenAliases": [],
11270
- "id": "certs:auto:wait",
11270
+ "id": "ci:config:unset",
11271
11271
  "pluginAlias": "heroku",
11272
11272
  "pluginName": "heroku",
11273
11273
  "pluginType": "core",
11274
- "strict": true,
11274
+ "strict": false,
11275
+ "topic": "ci",
11275
11276
  "isESM": false,
11276
11277
  "relativePath": [
11277
11278
  "lib",
11278
11279
  "commands",
11279
- "certs",
11280
- "auto",
11281
- "wait.js"
11280
+ "ci",
11281
+ "config",
11282
+ "unset.js"
11282
11283
  ]
11283
11284
  },
11284
11285
  "pg:backups:cancel": {
@@ -12407,15 +12408,19 @@
12407
12408
  "index.js"
12408
12409
  ]
12409
12410
  },
12410
- "pg:maintenance": {
12411
+ "pg:settings:auto-explain": {
12411
12412
  "aliases": [],
12412
12413
  "args": {
12413
12414
  "database": {
12414
12415
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12415
12416
  "name": "database"
12417
+ },
12418
+ "value": {
12419
+ "description": "boolean indicating if execution plans of queries will be logged for future connections",
12420
+ "name": "value"
12416
12421
  }
12417
12422
  },
12418
- "description": "show current maintenance information",
12423
+ "description": "Automatically log execution plans of queries without running EXPLAIN by hand.\nThe auto_explain module is loaded at session-time so existing connections will not be logged.\nRestart your Heroku app and/or restart existing connections for logging to start taking place.\n",
12419
12424
  "flags": {
12420
12425
  "app": {
12421
12426
  "char": "a",
@@ -12437,37 +12442,35 @@
12437
12442
  },
12438
12443
  "hasDynamicHelp": false,
12439
12444
  "hiddenAliases": [],
12440
- "id": "pg:maintenance",
12445
+ "id": "pg:settings:auto-explain",
12441
12446
  "pluginAlias": "heroku",
12442
12447
  "pluginName": "heroku",
12443
12448
  "pluginType": "core",
12444
- "strict": true,
12449
+ "strict": false,
12445
12450
  "topic": "pg",
12446
12451
  "isESM": false,
12447
12452
  "relativePath": [
12448
12453
  "lib",
12449
12454
  "commands",
12450
12455
  "pg",
12451
- "maintenance",
12452
- "index.js"
12456
+ "settings",
12457
+ "auto-explain.js"
12453
12458
  ]
12454
12459
  },
12455
- "pg:maintenance:run": {
12460
+ "pg:settings:explain-data-connector-details": {
12456
12461
  "aliases": [],
12457
12462
  "args": {
12458
12463
  "database": {
12459
12464
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12460
12465
  "name": "database"
12466
+ },
12467
+ "value": {
12468
+ "description": "boolean indicating if data replication slot details get logged",
12469
+ "name": "value"
12461
12470
  }
12462
12471
  },
12463
- "description": "start maintenance",
12472
+ "description": "displays stats on replication slots on your database, the default value is \"off\"\n",
12464
12473
  "flags": {
12465
- "force": {
12466
- "char": "f",
12467
- "name": "force",
12468
- "allowNo": false,
12469
- "type": "boolean"
12470
- },
12471
12474
  "app": {
12472
12475
  "char": "a",
12473
12476
  "description": "app to run command against",
@@ -12488,36 +12491,29 @@
12488
12491
  },
12489
12492
  "hasDynamicHelp": false,
12490
12493
  "hiddenAliases": [],
12491
- "id": "pg:maintenance:run",
12494
+ "id": "pg:settings:explain-data-connector-details",
12492
12495
  "pluginAlias": "heroku",
12493
12496
  "pluginName": "heroku",
12494
12497
  "pluginType": "core",
12495
- "strict": true,
12496
12498
  "topic": "pg",
12497
12499
  "isESM": false,
12498
12500
  "relativePath": [
12499
12501
  "lib",
12500
12502
  "commands",
12501
12503
  "pg",
12502
- "maintenance",
12503
- "run.js"
12504
+ "settings",
12505
+ "explain-data-connector-details.js"
12504
12506
  ]
12505
12507
  },
12506
- "pg:maintenance:window": {
12508
+ "pg:settings": {
12507
12509
  "aliases": [],
12508
12510
  "args": {
12509
- "window": {
12510
- "description": "timestamp of the maintenance window",
12511
- "name": "window",
12512
- "required": true
12513
- },
12514
12511
  "database": {
12515
12512
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12516
12513
  "name": "database"
12517
12514
  }
12518
12515
  },
12519
- "description": "Set weekly maintenance window.\nAll times are in UTC.\n",
12520
- "examples": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
12516
+ "description": "show your current database settings",
12521
12517
  "flags": {
12522
12518
  "app": {
12523
12519
  "char": "a",
@@ -12539,23 +12535,22 @@
12539
12535
  },
12540
12536
  "hasDynamicHelp": false,
12541
12537
  "hiddenAliases": [],
12542
- "id": "pg:maintenance:window",
12538
+ "id": "pg:settings",
12543
12539
  "pluginAlias": "heroku",
12544
12540
  "pluginName": "heroku",
12545
12541
  "pluginType": "core",
12546
12542
  "strict": true,
12547
12543
  "topic": "pg",
12548
- "example": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
12549
12544
  "isESM": false,
12550
12545
  "relativePath": [
12551
12546
  "lib",
12552
12547
  "commands",
12553
12548
  "pg",
12554
- "maintenance",
12555
- "window.js"
12549
+ "settings",
12550
+ "index.js"
12556
12551
  ]
12557
12552
  },
12558
- "pg:settings:auto-explain": {
12553
+ "pg:settings:log-connections": {
12559
12554
  "aliases": [],
12560
12555
  "args": {
12561
12556
  "database": {
@@ -12563,11 +12558,11 @@
12563
12558
  "name": "database"
12564
12559
  },
12565
12560
  "value": {
12566
- "description": "boolean indicating if execution plans of queries will be logged for future connections",
12561
+ "description": "boolean indicating if database login attempts get logged",
12567
12562
  "name": "value"
12568
12563
  }
12569
12564
  },
12570
- "description": "Automatically log execution plans of queries without running EXPLAIN by hand.\nThe auto_explain module is loaded at session-time so existing connections will not be logged.\nRestart your Heroku app and/or restart existing connections for logging to start taking place.\n",
12565
+ "description": "Controls whether a log message is produced when a login attempt is made. Default is true.\nSetting log_connections to false stops emitting log messages for all attempts to login to the database.",
12571
12566
  "flags": {
12572
12567
  "app": {
12573
12568
  "char": "a",
@@ -12589,11 +12584,10 @@
12589
12584
  },
12590
12585
  "hasDynamicHelp": false,
12591
12586
  "hiddenAliases": [],
12592
- "id": "pg:settings:auto-explain",
12587
+ "id": "pg:settings:log-connections",
12593
12588
  "pluginAlias": "heroku",
12594
12589
  "pluginName": "heroku",
12595
12590
  "pluginType": "core",
12596
- "strict": false,
12597
12591
  "topic": "pg",
12598
12592
  "isESM": false,
12599
12593
  "relativePath": [
@@ -12601,10 +12595,10 @@
12601
12595
  "commands",
12602
12596
  "pg",
12603
12597
  "settings",
12604
- "auto-explain.js"
12598
+ "log-connections.js"
12605
12599
  ]
12606
12600
  },
12607
- "pg:settings:explain-data-connector-details": {
12601
+ "pg:settings:log-lock-waits": {
12608
12602
  "aliases": [],
12609
12603
  "args": {
12610
12604
  "database": {
@@ -12612,11 +12606,11 @@
12612
12606
  "name": "database"
12613
12607
  },
12614
12608
  "value": {
12615
- "description": "boolean indicating if data replication slot details get logged",
12609
+ "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
12616
12610
  "name": "value"
12617
12611
  }
12618
12612
  },
12619
- "description": "displays stats on replication slots on your database, the default value is \"off\"\n",
12613
+ "description": "Controls whether a log message is produced when a session waits longer than the deadlock_timeout to acquire a lock. deadlock_timeout is set to 1 second\nDelays due to lock contention occur when multiple transactions are trying to access the same resource at the same time.\nApplications and their query patterns should try to avoid changes to many different tables within the same transaction.\n",
12620
12614
  "flags": {
12621
12615
  "app": {
12622
12616
  "char": "a",
@@ -12638,7 +12632,7 @@
12638
12632
  },
12639
12633
  "hasDynamicHelp": false,
12640
12634
  "hiddenAliases": [],
12641
- "id": "pg:settings:explain-data-connector-details",
12635
+ "id": "pg:settings:log-lock-waits",
12642
12636
  "pluginAlias": "heroku",
12643
12637
  "pluginName": "heroku",
12644
12638
  "pluginType": "core",
@@ -12649,18 +12643,22 @@
12649
12643
  "commands",
12650
12644
  "pg",
12651
12645
  "settings",
12652
- "explain-data-connector-details.js"
12646
+ "log-lock-waits.js"
12653
12647
  ]
12654
12648
  },
12655
- "pg:settings": {
12649
+ "pg:settings:log-min-duration-statement": {
12656
12650
  "aliases": [],
12657
12651
  "args": {
12658
12652
  "database": {
12659
12653
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12660
12654
  "name": "database"
12655
+ },
12656
+ "value": {
12657
+ "description": "milliseconds to wait for a statement to complete before logging it",
12658
+ "name": "value"
12661
12659
  }
12662
12660
  },
12663
- "description": "show your current database settings",
12661
+ "description": "The duration of each completed statement will be logged if the statement completes after the time specified by VALUE.\nVALUE needs to specified as a whole number, in milliseconds.\nSetting log_min_duration_statement to zero prints all statement durations and -1 will disable logging statement durations.\n",
12664
12662
  "flags": {
12665
12663
  "app": {
12666
12664
  "char": "a",
@@ -12682,11 +12680,10 @@
12682
12680
  },
12683
12681
  "hasDynamicHelp": false,
12684
12682
  "hiddenAliases": [],
12685
- "id": "pg:settings",
12683
+ "id": "pg:settings:log-min-duration-statement",
12686
12684
  "pluginAlias": "heroku",
12687
12685
  "pluginName": "heroku",
12688
12686
  "pluginType": "core",
12689
- "strict": true,
12690
12687
  "topic": "pg",
12691
12688
  "isESM": false,
12692
12689
  "relativePath": [
@@ -12694,10 +12691,10 @@
12694
12691
  "commands",
12695
12692
  "pg",
12696
12693
  "settings",
12697
- "index.js"
12694
+ "log-min-duration-statement.js"
12698
12695
  ]
12699
12696
  },
12700
- "pg:settings:log-connections": {
12697
+ "pg:settings:log-min-error-statement": {
12701
12698
  "aliases": [],
12702
12699
  "args": {
12703
12700
  "database": {
@@ -12705,11 +12702,16 @@
12705
12702
  "name": "database"
12706
12703
  },
12707
12704
  "value": {
12708
- "description": "boolean indicating if database login attempts get logged",
12709
- "name": "value"
12705
+ "name": "value",
12706
+ "options": [
12707
+ "error",
12708
+ "log",
12709
+ "fatal",
12710
+ "panic"
12711
+ ]
12710
12712
  }
12711
12713
  },
12712
- "description": "Controls whether a log message is produced when a login attempt is made. Default is true.\nSetting log_connections to false stops emitting log messages for all attempts to login to the database.",
12714
+ "description": "log-min-error-statement controls the logging of SQL statements that cause an error at a specified severity level.\nThis setting is useful to prevent logging SQL queries that might contain sensitive information.\nUse this setting to prevent logging SQL queries that contain sensitive information. Default is \"error\".\n",
12713
12715
  "flags": {
12714
12716
  "app": {
12715
12717
  "char": "a",
@@ -12731,7 +12733,7 @@
12731
12733
  },
12732
12734
  "hasDynamicHelp": false,
12733
12735
  "hiddenAliases": [],
12734
- "id": "pg:settings:log-connections",
12736
+ "id": "pg:settings:log-min-error-statement",
12735
12737
  "pluginAlias": "heroku",
12736
12738
  "pluginName": "heroku",
12737
12739
  "pluginType": "core",
@@ -12742,10 +12744,10 @@
12742
12744
  "commands",
12743
12745
  "pg",
12744
12746
  "settings",
12745
- "log-connections.js"
12747
+ "log-min-error-statement.js"
12746
12748
  ]
12747
12749
  },
12748
- "pg:settings:log-lock-waits": {
12750
+ "pg:settings:log-statement": {
12749
12751
  "aliases": [],
12750
12752
  "args": {
12751
12753
  "database": {
@@ -12753,11 +12755,17 @@
12753
12755
  "name": "database"
12754
12756
  },
12755
12757
  "value": {
12756
- "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
12757
- "name": "value"
12758
+ "description": "type of SQL statements to log\n<options: none|ddl|mod|all>",
12759
+ "name": "value",
12760
+ "options": [
12761
+ "none",
12762
+ "ddl",
12763
+ "mod",
12764
+ "all"
12765
+ ]
12758
12766
  }
12759
12767
  },
12760
- "description": "Controls whether a log message is produced when a session waits longer than the deadlock_timeout to acquire a lock. deadlock_timeout is set to 1 second\nDelays due to lock contention occur when multiple transactions are trying to access the same resource at the same time.\nApplications and their query patterns should try to avoid changes to many different tables within the same transaction.\n",
12768
+ "description": "log_statement controls which SQL statements are logged.\nValid values for VALUE:\nnone - No statements are logged\nddl - All data definition statements, such as CREATE, ALTER and DROP will be logged\nmod - Includes all statements from ddl as well as data-modifying statements such as INSERT, UPDATE, DELETE, TRUNCATE, COPY\nall - All statements are logged\n",
12761
12769
  "flags": {
12762
12770
  "app": {
12763
12771
  "char": "a",
@@ -12779,7 +12787,7 @@
12779
12787
  },
12780
12788
  "hasDynamicHelp": false,
12781
12789
  "hiddenAliases": [],
12782
- "id": "pg:settings:log-lock-waits",
12790
+ "id": "pg:settings:log-statement",
12783
12791
  "pluginAlias": "heroku",
12784
12792
  "pluginName": "heroku",
12785
12793
  "pluginType": "core",
@@ -12790,10 +12798,10 @@
12790
12798
  "commands",
12791
12799
  "pg",
12792
12800
  "settings",
12793
- "log-lock-waits.js"
12801
+ "log-statement.js"
12794
12802
  ]
12795
12803
  },
12796
- "pg:settings:log-min-duration-statement": {
12804
+ "pg:settings:track-functions": {
12797
12805
  "aliases": [],
12798
12806
  "args": {
12799
12807
  "database": {
@@ -12801,11 +12809,16 @@
12801
12809
  "name": "database"
12802
12810
  },
12803
12811
  "value": {
12804
- "description": "milliseconds to wait for a statement to complete before logging it",
12805
- "name": "value"
12812
+ "description": "function type to track\n<options: none|pl|all>",
12813
+ "name": "value",
12814
+ "options": [
12815
+ "none",
12816
+ "pl",
12817
+ "all"
12818
+ ]
12806
12819
  }
12807
12820
  },
12808
- "description": "The duration of each completed statement will be logged if the statement completes after the time specified by VALUE.\nVALUE needs to specified as a whole number, in milliseconds.\nSetting log_min_duration_statement to zero prints all statement durations and -1 will disable logging statement durations.\n",
12821
+ "description": "track_functions controls tracking of function call counts and time used. Default is none.\nValid values for VALUE:\nnone - No functions are tracked (default)\npl - Only procedural language functions are tracked\nall - All functions, including SQL and C language functions, are tracked. Simple SQL-language that are inlined are not tracked",
12809
12822
  "flags": {
12810
12823
  "app": {
12811
12824
  "char": "a",
@@ -12827,7 +12840,7 @@
12827
12840
  },
12828
12841
  "hasDynamicHelp": false,
12829
12842
  "hiddenAliases": [],
12830
- "id": "pg:settings:log-min-duration-statement",
12843
+ "id": "pg:settings:track-functions",
12831
12844
  "pluginAlias": "heroku",
12832
12845
  "pluginName": "heroku",
12833
12846
  "pluginType": "core",
@@ -12838,27 +12851,18 @@
12838
12851
  "commands",
12839
12852
  "pg",
12840
12853
  "settings",
12841
- "log-min-duration-statement.js"
12854
+ "track-functions.js"
12842
12855
  ]
12843
12856
  },
12844
- "pg:settings:log-min-error-statement": {
12857
+ "pg:maintenance": {
12845
12858
  "aliases": [],
12846
12859
  "args": {
12847
12860
  "database": {
12848
12861
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12849
12862
  "name": "database"
12850
- },
12851
- "value": {
12852
- "name": "value",
12853
- "options": [
12854
- "error",
12855
- "log",
12856
- "fatal",
12857
- "panic"
12858
- ]
12859
12863
  }
12860
12864
  },
12861
- "description": "log-min-error-statement controls the logging of SQL statements that cause an error at a specified severity level.\nThis setting is useful to prevent logging SQL queries that might contain sensitive information.\nUse this setting to prevent logging SQL queries that contain sensitive information. Default is \"error\".\n",
12865
+ "description": "show current maintenance information",
12862
12866
  "flags": {
12863
12867
  "app": {
12864
12868
  "char": "a",
@@ -12880,40 +12884,37 @@
12880
12884
  },
12881
12885
  "hasDynamicHelp": false,
12882
12886
  "hiddenAliases": [],
12883
- "id": "pg:settings:log-min-error-statement",
12887
+ "id": "pg:maintenance",
12884
12888
  "pluginAlias": "heroku",
12885
12889
  "pluginName": "heroku",
12886
12890
  "pluginType": "core",
12891
+ "strict": true,
12887
12892
  "topic": "pg",
12888
12893
  "isESM": false,
12889
12894
  "relativePath": [
12890
12895
  "lib",
12891
12896
  "commands",
12892
12897
  "pg",
12893
- "settings",
12894
- "log-min-error-statement.js"
12898
+ "maintenance",
12899
+ "index.js"
12895
12900
  ]
12896
12901
  },
12897
- "pg:settings:log-statement": {
12902
+ "pg:maintenance:run": {
12898
12903
  "aliases": [],
12899
12904
  "args": {
12900
12905
  "database": {
12901
12906
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12902
12907
  "name": "database"
12903
- },
12904
- "value": {
12905
- "description": "type of SQL statements to log\n<options: none|ddl|mod|all>",
12906
- "name": "value",
12907
- "options": [
12908
- "none",
12909
- "ddl",
12910
- "mod",
12911
- "all"
12912
- ]
12913
12908
  }
12914
12909
  },
12915
- "description": "log_statement controls which SQL statements are logged.\nValid values for VALUE:\nnone - No statements are logged\nddl - All data definition statements, such as CREATE, ALTER and DROP will be logged\nmod - Includes all statements from ddl as well as data-modifying statements such as INSERT, UPDATE, DELETE, TRUNCATE, COPY\nall - All statements are logged\n",
12910
+ "description": "start maintenance",
12916
12911
  "flags": {
12912
+ "force": {
12913
+ "char": "f",
12914
+ "name": "force",
12915
+ "allowNo": false,
12916
+ "type": "boolean"
12917
+ },
12917
12918
  "app": {
12918
12919
  "char": "a",
12919
12920
  "description": "app to run command against",
@@ -12934,38 +12935,36 @@
12934
12935
  },
12935
12936
  "hasDynamicHelp": false,
12936
12937
  "hiddenAliases": [],
12937
- "id": "pg:settings:log-statement",
12938
+ "id": "pg:maintenance:run",
12938
12939
  "pluginAlias": "heroku",
12939
12940
  "pluginName": "heroku",
12940
12941
  "pluginType": "core",
12942
+ "strict": true,
12941
12943
  "topic": "pg",
12942
12944
  "isESM": false,
12943
12945
  "relativePath": [
12944
12946
  "lib",
12945
12947
  "commands",
12946
12948
  "pg",
12947
- "settings",
12948
- "log-statement.js"
12949
+ "maintenance",
12950
+ "run.js"
12949
12951
  ]
12950
12952
  },
12951
- "pg:settings:track-functions": {
12953
+ "pg:maintenance:window": {
12952
12954
  "aliases": [],
12953
12955
  "args": {
12956
+ "window": {
12957
+ "description": "timestamp of the maintenance window",
12958
+ "name": "window",
12959
+ "required": true
12960
+ },
12954
12961
  "database": {
12955
12962
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
12956
12963
  "name": "database"
12957
- },
12958
- "value": {
12959
- "description": "function type to track\n<options: none|pl|all>",
12960
- "name": "value",
12961
- "options": [
12962
- "none",
12963
- "pl",
12964
- "all"
12965
- ]
12966
12964
  }
12967
12965
  },
12968
- "description": "track_functions controls tracking of function call counts and time used. Default is none.\nValid values for VALUE:\nnone - No functions are tracked (default)\npl - Only procedural language functions are tracked\nall - All functions, including SQL and C language functions, are tracked. Simple SQL-language that are inlined are not tracked",
12966
+ "description": "Set weekly maintenance window.\nAll times are in UTC.\n",
12967
+ "examples": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
12969
12968
  "flags": {
12970
12969
  "app": {
12971
12970
  "char": "a",
@@ -12987,18 +12986,20 @@
12987
12986
  },
12988
12987
  "hasDynamicHelp": false,
12989
12988
  "hiddenAliases": [],
12990
- "id": "pg:settings:track-functions",
12989
+ "id": "pg:maintenance:window",
12991
12990
  "pluginAlias": "heroku",
12992
12991
  "pluginName": "heroku",
12993
12992
  "pluginType": "core",
12993
+ "strict": true,
12994
12994
  "topic": "pg",
12995
+ "example": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
12995
12996
  "isESM": false,
12996
12997
  "relativePath": [
12997
12998
  "lib",
12998
12999
  "commands",
12999
13000
  "pg",
13000
- "settings",
13001
- "track-functions.js"
13001
+ "maintenance",
13002
+ "window.js"
13002
13003
  ]
13003
13004
  },
13004
13005
  "ps:autoscale:disable": {
@@ -14450,5 +14451,5 @@
14450
14451
  ]
14451
14452
  }
14452
14453
  },
14453
- "version": "10.2.0"
14454
+ "version": "10.3.0-beta.0"
14454
14455
  }