@heroku/plugin-compute 0.2.0 → 0.3.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 (49) hide show
  1. package/lib/commands/compute/display/telemetry-drain.d.ts +26 -0
  2. package/lib/commands/compute/display/telemetry-drain.js +77 -0
  3. package/lib/commands/compute/display/telemetry-drain.js.map +1 -0
  4. package/lib/commands/compute/{config/get.d.ts → get/config.d.ts} +2 -0
  5. package/lib/commands/compute/{config/get.js → get/config.js} +9 -2
  6. package/lib/commands/compute/get/config.js.map +1 -0
  7. package/lib/commands/compute/{config/list.d.ts → list/config.d.ts} +2 -0
  8. package/lib/commands/compute/{config/list.js → list/config.js} +9 -2
  9. package/lib/commands/compute/list/config.js.map +1 -0
  10. package/lib/commands/compute/list/telemetry-drain.d.ts +20 -0
  11. package/lib/commands/compute/list/telemetry-drain.js +89 -0
  12. package/lib/commands/compute/list/telemetry-drain.js.map +1 -0
  13. package/lib/commands/compute/{config/set.d.ts → set/config.d.ts} +2 -0
  14. package/lib/commands/compute/{config/set.js → set/config.js} +9 -2
  15. package/lib/commands/compute/set/config.js.map +1 -0
  16. package/lib/commands/compute/{config/unset.d.ts → unset/config.d.ts} +2 -0
  17. package/lib/commands/compute/{config/unset.js → unset/config.js} +9 -2
  18. package/lib/commands/compute/unset/config.js.map +1 -0
  19. package/lib/shared/computeConfig.js +2 -2
  20. package/lib/shared/computeConfig.js.map +1 -1
  21. package/lib/shared/computeQuery.d.ts +1 -0
  22. package/lib/shared/computeQuery.js +37 -42
  23. package/lib/shared/computeQuery.js.map +1 -1
  24. package/lib/shared/computeTelemetryDrain.d.ts +11 -0
  25. package/lib/shared/computeTelemetryDrain.js +86 -0
  26. package/lib/shared/computeTelemetryDrain.js.map +1 -0
  27. package/lib/shared/herokuProxyApi.d.ts +30 -0
  28. package/lib/shared/herokuProxyApi.js +102 -2
  29. package/lib/shared/herokuProxyApi.js.map +1 -1
  30. package/messages/compute.display.telemetry-drain.md +19 -0
  31. package/messages/compute.errors.md +35 -1
  32. package/messages/{compute.config.list.md → compute.list.config.md} +3 -3
  33. package/messages/compute.list.telemetry-drain.md +26 -0
  34. package/npm-shrinkwrap.json +258 -116
  35. package/oclif.manifest.json +289 -139
  36. package/package.json +10 -4
  37. package/schemas/compute-display-telemetry__drain.json +54 -0
  38. package/schemas/compute-list-telemetry__drain.json +43 -0
  39. package/lib/commands/compute/config/get.js.map +0 -1
  40. package/lib/commands/compute/config/list.js.map +0 -1
  41. package/lib/commands/compute/config/set.js.map +0 -1
  42. package/lib/commands/compute/config/unset.js.map +0 -1
  43. /package/messages/{compute.config.get.md → compute.get.config.md} +0 -0
  44. /package/messages/{compute.config.set.md → compute.set.config.md} +0 -0
  45. /package/messages/{compute.config.unset.md → compute.unset.config.md} +0 -0
  46. /package/schemas/{compute-config-get.json → compute-get-config.json} +0 -0
  47. /package/schemas/{compute-config-list.json → compute-list-config.json} +0 -0
  48. /package/schemas/{compute-config-set.json → compute-set-config.json} +0 -0
  49. /package/schemas/{compute-config-unset.json → compute-unset-config.json} +0 -0
@@ -370,18 +370,17 @@
370
370
  "scale:compute"
371
371
  ]
372
372
  },
373
- "compute:config:get": {
373
+ "compute:display:telemetry-drain": {
374
374
  "aliases": [],
375
375
  "args": {
376
- "key": {
377
- "multiple": true,
378
- "name": "key"
376
+ "id": {
377
+ "name": "id",
378
+ "required": true
379
379
  }
380
380
  },
381
- "description": "Goes through the target org's Salesforce Connect API, which calls Heroku on\nyour behalf. Pass a single key to print its bare value, or more than one to\nprint each as key: value. Fails if any requested key isn't currently set.",
381
+ "description": "Shows a single OpenTelemetry drain in full: the compute app it belongs to,\nthe signals it forwards, and its exporter endpoint, transport, and headers.\nUse sf compute list telemetry-drain to find a drain's ID.",
382
382
  "examples": [
383
- "Print a single config var's value:\n<%= config.bin %> <%= command.id %> STRIPE_KEY --name CreditRatingScorer --target-org my-org",
384
- "Print more than one config var:\n<%= config.bin %> <%= command.id %> STRIPE_KEY LOG_LEVEL --name CreditRatingScorer --target-org my-org"
383
+ "Show the detail of a telemetry drain by its ID:\n<%= config.bin %> <%= command.id %> 01234567-89ab-cdef-0123-456789abcdef --target-org my-org"
385
384
  ],
386
385
  "flags": {
387
386
  "json": {
@@ -399,15 +398,6 @@
399
398
  "multiple": false,
400
399
  "type": "option"
401
400
  },
402
- "name": {
403
- "char": "n",
404
- "env": "COMPUTE_APP_NAME",
405
- "name": "name",
406
- "summary": "DeveloperName of the compute app to read config from (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
407
- "hasDynamicHelp": false,
408
- "multiple": false,
409
- "type": "option"
410
- },
411
401
  "target-org": {
412
402
  "char": "o",
413
403
  "name": "target-org",
@@ -421,12 +411,12 @@
421
411
  },
422
412
  "hasDynamicHelp": true,
423
413
  "hiddenAliases": [],
424
- "id": "compute:config:get",
414
+ "id": "compute:display:telemetry-drain",
425
415
  "pluginAlias": "@heroku/plugin-compute",
426
416
  "pluginName": "@heroku/plugin-compute",
427
417
  "pluginType": "core",
428
418
  "strict": true,
429
- "summary": "Print one or more of a compute app's config var values.",
419
+ "summary": "Show the full detail of a single compute telemetry drain.",
430
420
  "enableJsonFlag": true,
431
421
  "requiresProject": false,
432
422
  "isESM": true,
@@ -434,25 +424,25 @@
434
424
  "lib",
435
425
  "commands",
436
426
  "compute",
437
- "config",
438
- "get.js"
427
+ "display",
428
+ "telemetry-drain.js"
439
429
  ],
440
430
  "aliasPermutations": [],
441
431
  "permutations": [
442
- "compute:config:get",
443
- "config:compute:get",
444
- "config:get:compute",
445
- "compute:get:config",
446
- "get:compute:config",
447
- "get:config:compute"
432
+ "compute:display:telemetry-drain",
433
+ "display:compute:telemetry-drain",
434
+ "display:telemetry-drain:compute",
435
+ "compute:telemetry-drain:display",
436
+ "telemetry-drain:compute:display",
437
+ "telemetry-drain:display:compute"
448
438
  ]
449
439
  },
450
- "compute:config:list": {
440
+ "compute:get:build-log": {
451
441
  "aliases": [],
452
442
  "args": {},
453
- "description": "Shows every config var (environment variable) currently set for a deployed\ncompute app, sorted alphabetically. Goes through the target org's Salesforce\nConnect API, which calls Heroku on your behalf. Use sf compute config get to\nread a single var's value, sf compute config set to add or change vars, or\nsf compute config unset to remove them.",
443
+ "description": "Fetches the bounded build/compile log (dependency install, slug compile,\nrelease) for the most recent build of a compute app -- useful right after\ndeploy to confirm the build compiled. This is a one-shot fetch of a\nfinished-or-in-progress log, not a live stream; use compute tail runtime-log\nfor the ongoing runtime log.\n\nThis is a read-only, org-mediated lookup by --name (the app's DeveloperName)\n-- the org calls Heroku's Build Info API on your behalf. It doesn't read from\nor require a local Salesforce DX project.",
454
444
  "examples": [
455
- "List all config vars for a compute app:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
445
+ "Print the latest build's log:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
456
446
  ],
457
447
  "flags": {
458
448
  "json": {
@@ -474,7 +464,7 @@
474
464
  "char": "n",
475
465
  "env": "COMPUTE_APP_NAME",
476
466
  "name": "name",
477
- "summary": "DeveloperName of the compute app to list config vars for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
467
+ "summary": "DeveloperName of the compute app to fetch build output for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
478
468
  "hasDynamicHelp": false,
479
469
  "multiple": false,
480
470
  "type": "option"
@@ -492,12 +482,12 @@
492
482
  },
493
483
  "hasDynamicHelp": true,
494
484
  "hiddenAliases": [],
495
- "id": "compute:config:list",
485
+ "id": "compute:get:build-log",
496
486
  "pluginAlias": "@heroku/plugin-compute",
497
487
  "pluginName": "@heroku/plugin-compute",
498
488
  "pluginType": "core",
499
489
  "strict": true,
500
- "summary": "List a compute app's config vars.",
490
+ "summary": "Print the build/compile log for a compute app's latest build.",
501
491
  "enableJsonFlag": true,
502
492
  "requiresProject": false,
503
493
  "isESM": true,
@@ -505,31 +495,32 @@
505
495
  "lib",
506
496
  "commands",
507
497
  "compute",
508
- "config",
509
- "list.js"
498
+ "get",
499
+ "build-log.js"
510
500
  ],
511
501
  "aliasPermutations": [],
512
502
  "permutations": [
513
- "compute:config:list",
514
- "config:compute:list",
515
- "config:list:compute",
516
- "compute:list:config",
517
- "list:compute:config",
518
- "list:config:compute"
503
+ "compute:get:build-log",
504
+ "get:compute:build-log",
505
+ "get:build-log:compute",
506
+ "compute:build-log:get",
507
+ "build-log:compute:get",
508
+ "build-log:get:compute"
519
509
  ]
520
510
  },
521
- "compute:config:set": {
511
+ "compute:get:config": {
522
512
  "aliases": [],
523
513
  "args": {
524
- "pair": {
514
+ "key": {
525
515
  "multiple": true,
526
- "name": "pair"
516
+ "name": "key"
527
517
  }
528
518
  },
529
- "description": "Goes through the target org's Salesforce Connect API, which calls Heroku on\nyour behalf. Setting a config var restarts the app's dynos so the new value\ntakes effect. Pass one or more KEY=VALUE pairs; a key that doesn't already\nexist is created.",
519
+ "deprecateAliases": true,
520
+ "description": "Goes through the target org's Salesforce Connect API, which calls Heroku on\nyour behalf. Pass a single key to print its bare value, or more than one to\nprint each as key: value. Fails if any requested key isn't currently set.",
530
521
  "examples": [
531
- "Set a single config var:\n<%= config.bin %> <%= command.id %> STRIPE_KEY=sk_live_xyz789 --name CreditRatingScorer --target-org my-org",
532
- "Set more than one config var in one command:\n<%= config.bin %> <%= command.id %> STRIPE_KEY=sk_live_xyz789 LOG_LEVEL=debug --name CreditRatingScorer --target-org my-org"
522
+ "Print a single config var's value:\n<%= config.bin %> <%= command.id %> STRIPE_KEY --name CreditRatingScorer --target-org my-org",
523
+ "Print more than one config var:\n<%= config.bin %> <%= command.id %> STRIPE_KEY LOG_LEVEL --name CreditRatingScorer --target-org my-org"
533
524
  ],
534
525
  "flags": {
535
526
  "json": {
@@ -551,7 +542,7 @@
551
542
  "char": "n",
552
543
  "env": "COMPUTE_APP_NAME",
553
544
  "name": "name",
554
- "summary": "DeveloperName of the compute app to change config for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
545
+ "summary": "DeveloperName of the compute app to read config from (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
555
546
  "hasDynamicHelp": false,
556
547
  "multiple": false,
557
548
  "type": "option"
@@ -568,13 +559,15 @@
568
559
  }
569
560
  },
570
561
  "hasDynamicHelp": true,
571
- "hiddenAliases": [],
572
- "id": "compute:config:set",
562
+ "hiddenAliases": [
563
+ "compute:config:get"
564
+ ],
565
+ "id": "compute:get:config",
573
566
  "pluginAlias": "@heroku/plugin-compute",
574
567
  "pluginName": "@heroku/plugin-compute",
575
568
  "pluginType": "core",
576
569
  "strict": true,
577
- "summary": "Set one or more of a compute app's config vars.",
570
+ "summary": "Print one or more of a compute app's config var values.",
578
571
  "enableJsonFlag": true,
579
572
  "requiresProject": false,
580
573
  "isESM": true,
@@ -582,31 +575,26 @@
582
575
  "lib",
583
576
  "commands",
584
577
  "compute",
585
- "config",
586
- "set.js"
578
+ "get",
579
+ "config.js"
587
580
  ],
588
581
  "aliasPermutations": [],
589
582
  "permutations": [
590
- "compute:config:set",
591
- "config:compute:set",
592
- "config:set:compute",
593
- "compute:set:config",
594
- "set:compute:config",
595
- "set:config:compute"
583
+ "compute:get:config",
584
+ "get:compute:config",
585
+ "get:config:compute",
586
+ "compute:config:get",
587
+ "config:compute:get",
588
+ "config:get:compute"
596
589
  ]
597
590
  },
598
- "compute:config:unset": {
591
+ "compute:get:runtime-log": {
599
592
  "aliases": [],
600
- "args": {
601
- "key": {
602
- "multiple": true,
603
- "name": "key"
604
- }
605
- },
606
- "description": "Goes through the target org's Salesforce Connect API, which calls Heroku on\nyour behalf. Unsetting a config var restarts the app's dynos so the removal\ntakes effect. Fails if any requested key isn't currently set.",
593
+ "args": {},
594
+ "description": "Fetches a compute app's runtime log -- the app's ongoing output (request\nhandling, application logs), not the build/compile log; use compute get\nbuild-log for that.\n\nThis prints the most recent log lines and exits. To keep the session open and\nstream new lines as they arrive, use compute tail runtime-log.\n\nThis is an org-mediated operation by --name (the app's DeveloperName) -- the\norg creates a log session with Heroku on your behalf and hands back a\nshort-lived, pre-authorized URL that the CLI reads from directly. It doesn't\nread from or require a local Salesforce DX project.",
607
595
  "examples": [
608
- "Unset a single config var:\n<%= config.bin %> <%= command.id %> LOG_LEVEL --name CreditRatingScorer --target-org my-org",
609
- "Unset more than one config var in one command:\n<%= config.bin %> <%= command.id %> LOG_LEVEL DEBUG_MODE --name CreditRatingScorer --target-org my-org"
596
+ "Print the most recent log lines:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org",
597
+ "Print the most recent 500 log lines:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --num 500 --target-org my-org"
610
598
  ],
611
599
  "flags": {
612
600
  "json": {
@@ -628,7 +616,7 @@
628
616
  "char": "n",
629
617
  "env": "COMPUTE_APP_NAME",
630
618
  "name": "name",
631
- "summary": "DeveloperName of the compute app to change config for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
619
+ "summary": "DeveloperName of the compute app to fetch logs for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
632
620
  "hasDynamicHelp": false,
633
621
  "multiple": false,
634
622
  "type": "option"
@@ -642,16 +630,24 @@
642
630
  "hasDynamicHelp": true,
643
631
  "multiple": false,
644
632
  "type": "option"
633
+ },
634
+ "num": {
635
+ "name": "num",
636
+ "summary": "Number of recent log lines to print.",
637
+ "default": 100,
638
+ "hasDynamicHelp": false,
639
+ "multiple": false,
640
+ "type": "option"
645
641
  }
646
642
  },
647
643
  "hasDynamicHelp": true,
648
644
  "hiddenAliases": [],
649
- "id": "compute:config:unset",
645
+ "id": "compute:get:runtime-log",
650
646
  "pluginAlias": "@heroku/plugin-compute",
651
647
  "pluginName": "@heroku/plugin-compute",
652
648
  "pluginType": "core",
653
649
  "strict": true,
654
- "summary": "Unset one or more of a compute app's config vars.",
650
+ "summary": "Print the recent runtime log for a compute app.",
655
651
  "enableJsonFlag": true,
656
652
  "requiresProject": false,
657
653
  "isESM": true,
@@ -659,25 +655,32 @@
659
655
  "lib",
660
656
  "commands",
661
657
  "compute",
662
- "config",
663
- "unset.js"
658
+ "get",
659
+ "runtime-log.js"
664
660
  ],
665
661
  "aliasPermutations": [],
666
662
  "permutations": [
667
- "compute:config:unset",
668
- "config:compute:unset",
669
- "config:unset:compute",
670
- "compute:unset:config",
671
- "unset:compute:config",
672
- "unset:config:compute"
663
+ "compute:get:runtime-log",
664
+ "get:compute:runtime-log",
665
+ "get:runtime-log:compute",
666
+ "compute:runtime-log:get",
667
+ "runtime-log:compute:get",
668
+ "runtime-log:get:compute"
673
669
  ]
674
670
  },
675
- "compute:get:build-log": {
671
+ "compute:set:config": {
676
672
  "aliases": [],
677
- "args": {},
678
- "description": "Fetches the bounded build/compile log (dependency install, slug compile,\nrelease) for the most recent build of a compute app -- useful right after\ndeploy to confirm the build compiled. This is a one-shot fetch of a\nfinished-or-in-progress log, not a live stream; use compute tail runtime-log\nfor the ongoing runtime log.\n\nThis is a read-only, org-mediated lookup by --name (the app's DeveloperName)\n-- the org calls Heroku's Build Info API on your behalf. It doesn't read from\nor require a local Salesforce DX project.",
673
+ "args": {
674
+ "pair": {
675
+ "multiple": true,
676
+ "name": "pair"
677
+ }
678
+ },
679
+ "deprecateAliases": true,
680
+ "description": "Goes through the target org's Salesforce Connect API, which calls Heroku on\nyour behalf. Setting a config var restarts the app's dynos so the new value\ntakes effect. Pass one or more KEY=VALUE pairs; a key that doesn't already\nexist is created.",
679
681
  "examples": [
680
- "Print the latest build's log:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
682
+ "Set a single config var:\n<%= config.bin %> <%= command.id %> STRIPE_KEY=sk_live_xyz789 --name CreditRatingScorer --target-org my-org",
683
+ "Set more than one config var in one command:\n<%= config.bin %> <%= command.id %> STRIPE_KEY=sk_live_xyz789 LOG_LEVEL=debug --name CreditRatingScorer --target-org my-org"
681
684
  ],
682
685
  "flags": {
683
686
  "json": {
@@ -699,7 +702,7 @@
699
702
  "char": "n",
700
703
  "env": "COMPUTE_APP_NAME",
701
704
  "name": "name",
702
- "summary": "DeveloperName of the compute app to fetch build output for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
705
+ "summary": "DeveloperName of the compute app to change config for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
703
706
  "hasDynamicHelp": false,
704
707
  "multiple": false,
705
708
  "type": "option"
@@ -716,13 +719,15 @@
716
719
  }
717
720
  },
718
721
  "hasDynamicHelp": true,
719
- "hiddenAliases": [],
720
- "id": "compute:get:build-log",
722
+ "hiddenAliases": [
723
+ "compute:config:set"
724
+ ],
725
+ "id": "compute:set:config",
721
726
  "pluginAlias": "@heroku/plugin-compute",
722
727
  "pluginName": "@heroku/plugin-compute",
723
728
  "pluginType": "core",
724
729
  "strict": true,
725
- "summary": "Print the build/compile log for a compute app's latest build.",
730
+ "summary": "Set one or more of a compute app's config vars.",
726
731
  "enableJsonFlag": true,
727
732
  "requiresProject": false,
728
733
  "isESM": true,
@@ -730,26 +735,25 @@
730
735
  "lib",
731
736
  "commands",
732
737
  "compute",
733
- "get",
734
- "build-log.js"
738
+ "set",
739
+ "config.js"
735
740
  ],
736
741
  "aliasPermutations": [],
737
742
  "permutations": [
738
- "compute:get:build-log",
739
- "get:compute:build-log",
740
- "get:build-log:compute",
741
- "compute:build-log:get",
742
- "build-log:compute:get",
743
- "build-log:get:compute"
743
+ "compute:set:config",
744
+ "set:compute:config",
745
+ "set:config:compute",
746
+ "compute:config:set",
747
+ "config:compute:set",
748
+ "config:set:compute"
744
749
  ]
745
750
  },
746
- "compute:get:runtime-log": {
751
+ "compute:source:retrieve": {
747
752
  "aliases": [],
748
753
  "args": {},
749
- "description": "Fetches a compute app's runtime log -- the app's ongoing output (request\nhandling, application logs), not the build/compile log; use compute get\nbuild-log for that.\n\nThis prints the most recent log lines and exits. To keep the session open and\nstream new lines as they arrive, use compute tail runtime-log.\n\nThis is an org-mediated operation by --name (the app's DeveloperName) -- the\norg creates a log session with Heroku on your behalf and hands back a\nshort-lived, pre-authorized URL that the CLI reads from directly. It doesn't\nread from or require a local Salesforce DX project.",
754
+ "description": "Creates the compute app's directory under force-app/main/default/platformComputeApps/<name>/\n(or --output-dir), retrieves its <name>.compute-meta.xml through the Metadata\nAPI, then downloads its source code through the Connect API and extracts it\ninto that same directory. This is the inverse of sf compute deploy.",
750
755
  "examples": [
751
- "Print the most recent log lines:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org",
752
- "Print the most recent 500 log lines:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --num 500 --target-org my-org"
756
+ "Retrieve a compute app's source and metadata from an org:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
753
757
  ],
754
758
  "flags": {
755
759
  "json": {
@@ -769,9 +773,9 @@
769
773
  },
770
774
  "name": {
771
775
  "char": "n",
772
- "env": "COMPUTE_APP_NAME",
773
776
  "name": "name",
774
- "summary": "DeveloperName of the compute app to fetch logs for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
777
+ "required": true,
778
+ "summary": "DeveloperName of the compute app to retrieve (or <namespace>\\_\\_<developerName>\nif it was deployed under a namespace).",
775
779
  "hasDynamicHelp": false,
776
780
  "multiple": false,
777
781
  "type": "option"
@@ -786,10 +790,12 @@
786
790
  "multiple": false,
787
791
  "type": "option"
788
792
  },
789
- "num": {
790
- "name": "num",
791
- "summary": "Number of recent log lines to print.",
792
- "default": 100,
793
+ "output-dir": {
794
+ "char": "d",
795
+ "description": "Defaults to force-app/main/default/platformComputeApps. The app itself is created in a\nsubdirectory named after --name.",
796
+ "name": "output-dir",
797
+ "summary": "Directory to create the app in.",
798
+ "default": "force-app/main/default/platformComputeApps",
793
799
  "hasDynamicHelp": false,
794
800
  "multiple": false,
795
801
  "type": "option"
@@ -797,30 +803,30 @@
797
803
  },
798
804
  "hasDynamicHelp": true,
799
805
  "hiddenAliases": [],
800
- "id": "compute:get:runtime-log",
806
+ "id": "compute:source:retrieve",
801
807
  "pluginAlias": "@heroku/plugin-compute",
802
808
  "pluginName": "@heroku/plugin-compute",
803
809
  "pluginType": "core",
804
810
  "strict": true,
805
- "summary": "Print the recent runtime log for a compute app.",
811
+ "summary": "Retrieve a compute app's source and metadata from an org into your local Salesforce DX project.",
806
812
  "enableJsonFlag": true,
807
- "requiresProject": false,
813
+ "requiresProject": true,
808
814
  "isESM": true,
809
815
  "relativePath": [
810
816
  "lib",
811
817
  "commands",
812
818
  "compute",
813
- "get",
814
- "runtime-log.js"
819
+ "source",
820
+ "retrieve.js"
815
821
  ],
816
822
  "aliasPermutations": [],
817
823
  "permutations": [
818
- "compute:get:runtime-log",
819
- "get:compute:runtime-log",
820
- "get:runtime-log:compute",
821
- "compute:runtime-log:get",
822
- "runtime-log:compute:get",
823
- "runtime-log:get:compute"
824
+ "compute:source:retrieve",
825
+ "source:compute:retrieve",
826
+ "source:retrieve:compute",
827
+ "compute:retrieve:source",
828
+ "retrieve:compute:source",
829
+ "retrieve:source:compute"
824
830
  ]
825
831
  },
826
832
  "compute:tail:runtime-log": {
@@ -896,12 +902,19 @@
896
902
  "runtime-log:tail:compute"
897
903
  ]
898
904
  },
899
- "compute:source:retrieve": {
905
+ "compute:unset:config": {
900
906
  "aliases": [],
901
- "args": {},
902
- "description": "Creates the compute app's directory under force-app/main/default/platformComputeApps/<name>/\n(or --output-dir), retrieves its <name>.compute-meta.xml through the Metadata\nAPI, then downloads its source code through the Connect API and extracts it\ninto that same directory. This is the inverse of sf compute deploy.",
907
+ "args": {
908
+ "key": {
909
+ "multiple": true,
910
+ "name": "key"
911
+ }
912
+ },
913
+ "deprecateAliases": true,
914
+ "description": "Goes through the target org's Salesforce Connect API, which calls Heroku on\nyour behalf. Unsetting a config var restarts the app's dynos so the removal\ntakes effect. Fails if any requested key isn't currently set.",
903
915
  "examples": [
904
- "Retrieve a compute app's source and metadata from an org:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
916
+ "Unset a single config var:\n<%= config.bin %> <%= command.id %> LOG_LEVEL --name CreditRatingScorer --target-org my-org",
917
+ "Unset more than one config var in one command:\n<%= config.bin %> <%= command.id %> LOG_LEVEL DEBUG_MODE --name CreditRatingScorer --target-org my-org"
905
918
  ],
906
919
  "flags": {
907
920
  "json": {
@@ -921,9 +934,83 @@
921
934
  },
922
935
  "name": {
923
936
  "char": "n",
937
+ "env": "COMPUTE_APP_NAME",
924
938
  "name": "name",
939
+ "summary": "DeveloperName of the compute app to change config for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
940
+ "hasDynamicHelp": false,
941
+ "multiple": false,
942
+ "type": "option"
943
+ },
944
+ "target-org": {
945
+ "char": "o",
946
+ "name": "target-org",
947
+ "noCacheDefault": true,
925
948
  "required": true,
926
- "summary": "DeveloperName of the compute app to retrieve (or <namespace>\\_\\_<developerName>\nif it was deployed under a namespace).",
949
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
950
+ "hasDynamicHelp": true,
951
+ "multiple": false,
952
+ "type": "option"
953
+ }
954
+ },
955
+ "hasDynamicHelp": true,
956
+ "hiddenAliases": [
957
+ "compute:config:unset"
958
+ ],
959
+ "id": "compute:unset:config",
960
+ "pluginAlias": "@heroku/plugin-compute",
961
+ "pluginName": "@heroku/plugin-compute",
962
+ "pluginType": "core",
963
+ "strict": true,
964
+ "summary": "Unset one or more of a compute app's config vars.",
965
+ "enableJsonFlag": true,
966
+ "requiresProject": false,
967
+ "isESM": true,
968
+ "relativePath": [
969
+ "lib",
970
+ "commands",
971
+ "compute",
972
+ "unset",
973
+ "config.js"
974
+ ],
975
+ "aliasPermutations": [],
976
+ "permutations": [
977
+ "compute:unset:config",
978
+ "unset:compute:config",
979
+ "unset:config:compute",
980
+ "compute:config:unset",
981
+ "config:compute:unset",
982
+ "config:unset:compute"
983
+ ]
984
+ },
985
+ "compute:list:config": {
986
+ "aliases": [],
987
+ "args": {},
988
+ "deprecateAliases": true,
989
+ "description": "Shows every config var (environment variable) currently set for a deployed\ncompute app, sorted alphabetically. Goes through the target org's Salesforce\nConnect API, which calls Heroku on your behalf. Use sf compute get config to\nread a single var's value, sf compute set config to add or change vars, or\nsf compute unset config to remove them.",
990
+ "examples": [
991
+ "List all config vars for a compute app:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
992
+ ],
993
+ "flags": {
994
+ "json": {
995
+ "description": "Format output as json.",
996
+ "helpGroup": "GLOBAL",
997
+ "name": "json",
998
+ "allowNo": false,
999
+ "type": "boolean"
1000
+ },
1001
+ "flags-dir": {
1002
+ "helpGroup": "GLOBAL",
1003
+ "name": "flags-dir",
1004
+ "summary": "Import flag values from a directory.",
1005
+ "hasDynamicHelp": false,
1006
+ "multiple": false,
1007
+ "type": "option"
1008
+ },
1009
+ "name": {
1010
+ "char": "n",
1011
+ "env": "COMPUTE_APP_NAME",
1012
+ "name": "name",
1013
+ "summary": "DeveloperName of the compute app to list config vars for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
927
1014
  "hasDynamicHelp": false,
928
1015
  "multiple": false,
929
1016
  "type": "option"
@@ -937,46 +1024,109 @@
937
1024
  "hasDynamicHelp": true,
938
1025
  "multiple": false,
939
1026
  "type": "option"
1027
+ }
1028
+ },
1029
+ "hasDynamicHelp": true,
1030
+ "hiddenAliases": [
1031
+ "compute:config:list"
1032
+ ],
1033
+ "id": "compute:list:config",
1034
+ "pluginAlias": "@heroku/plugin-compute",
1035
+ "pluginName": "@heroku/plugin-compute",
1036
+ "pluginType": "core",
1037
+ "strict": true,
1038
+ "summary": "List a compute app's config vars.",
1039
+ "enableJsonFlag": true,
1040
+ "requiresProject": false,
1041
+ "isESM": true,
1042
+ "relativePath": [
1043
+ "lib",
1044
+ "commands",
1045
+ "compute",
1046
+ "list",
1047
+ "config.js"
1048
+ ],
1049
+ "aliasPermutations": [],
1050
+ "permutations": [
1051
+ "compute:list:config",
1052
+ "list:compute:config",
1053
+ "list:config:compute",
1054
+ "compute:config:list",
1055
+ "config:compute:list",
1056
+ "config:list:compute"
1057
+ ]
1058
+ },
1059
+ "compute:list:telemetry-drain": {
1060
+ "aliases": [],
1061
+ "args": {},
1062
+ "description": "Shows every OpenTelemetry drain forwarding the compute app's logs, metrics,\nand traces, with each drain's ID, signals, and endpoint. Use\nsf compute display telemetry-drain to see the full detail of a single drain.",
1063
+ "examples": [
1064
+ "List the telemetry drains for a compute app:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
1065
+ ],
1066
+ "flags": {
1067
+ "json": {
1068
+ "description": "Format output as json.",
1069
+ "helpGroup": "GLOBAL",
1070
+ "name": "json",
1071
+ "allowNo": false,
1072
+ "type": "boolean"
1073
+ },
1074
+ "flags-dir": {
1075
+ "helpGroup": "GLOBAL",
1076
+ "name": "flags-dir",
1077
+ "summary": "Import flag values from a directory.",
1078
+ "hasDynamicHelp": false,
1079
+ "multiple": false,
1080
+ "type": "option"
940
1081
  },
941
- "output-dir": {
942
- "char": "d",
943
- "description": "Defaults to force-app/main/default/platformComputeApps. The app itself is created in a\nsubdirectory named after --name.",
944
- "name": "output-dir",
945
- "summary": "Directory to create the app in.",
946
- "default": "force-app/main/default/platformComputeApps",
1082
+ "name": {
1083
+ "char": "n",
1084
+ "env": "COMPUTE_APP_NAME",
1085
+ "name": "name",
1086
+ "summary": "DeveloperName of the compute app to list telemetry drains for (or\n<namespace>\\_\\_<developerName> if it was deployed under a namespace).\nDefaults to the COMPUTE_APP_NAME environment variable, or the current\ndirectory's app name if that isn't set either.",
947
1087
  "hasDynamicHelp": false,
948
1088
  "multiple": false,
949
1089
  "type": "option"
1090
+ },
1091
+ "target-org": {
1092
+ "char": "o",
1093
+ "name": "target-org",
1094
+ "noCacheDefault": true,
1095
+ "required": true,
1096
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1097
+ "hasDynamicHelp": true,
1098
+ "multiple": false,
1099
+ "type": "option"
950
1100
  }
951
1101
  },
952
1102
  "hasDynamicHelp": true,
953
1103
  "hiddenAliases": [],
954
- "id": "compute:source:retrieve",
1104
+ "id": "compute:list:telemetry-drain",
955
1105
  "pluginAlias": "@heroku/plugin-compute",
956
1106
  "pluginName": "@heroku/plugin-compute",
957
1107
  "pluginType": "core",
958
1108
  "strict": true,
959
- "summary": "Retrieve a compute app's source and metadata from an org into your local Salesforce DX project.",
1109
+ "summary": "List the telemetry drains configured for a compute app.",
960
1110
  "enableJsonFlag": true,
961
- "requiresProject": true,
1111
+ "requiresProject": false,
962
1112
  "isESM": true,
963
1113
  "relativePath": [
964
1114
  "lib",
965
1115
  "commands",
966
1116
  "compute",
967
- "source",
968
- "retrieve.js"
1117
+ "list",
1118
+ "telemetry-drain.js"
969
1119
  ],
970
1120
  "aliasPermutations": [],
971
1121
  "permutations": [
972
- "compute:source:retrieve",
973
- "source:compute:retrieve",
974
- "source:retrieve:compute",
975
- "compute:retrieve:source",
976
- "retrieve:compute:source",
977
- "retrieve:source:compute"
1122
+ "compute:list:telemetry-drain",
1123
+ "list:compute:telemetry-drain",
1124
+ "list:telemetry-drain:compute",
1125
+ "compute:telemetry-drain:list",
1126
+ "telemetry-drain:compute:list",
1127
+ "telemetry-drain:list:compute"
978
1128
  ]
979
1129
  }
980
1130
  },
981
- "version": "0.2.0"
1131
+ "version": "0.3.0"
982
1132
  }