@heroku/plugin-compute 0.3.0 → 0.3.2

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 (79) hide show
  1. package/lib/commands/compute/create/telemetry-drain.d.ts +21 -0
  2. package/lib/commands/compute/create/telemetry-drain.js +82 -0
  3. package/lib/commands/compute/create/telemetry-drain.js.map +1 -0
  4. package/lib/commands/compute/delete/telemetry-drain.d.ts +20 -0
  5. package/lib/commands/compute/delete/telemetry-drain.js +60 -0
  6. package/lib/commands/compute/delete/telemetry-drain.js.map +1 -0
  7. package/lib/commands/compute/deploy.d.ts +5 -11
  8. package/lib/commands/compute/deploy.js +7 -65
  9. package/lib/commands/compute/deploy.js.map +1 -1
  10. package/lib/commands/compute/display/telemetry-drain.d.ts +1 -0
  11. package/lib/commands/compute/display/telemetry-drain.js +4 -3
  12. package/lib/commands/compute/display/telemetry-drain.js.map +1 -1
  13. package/lib/commands/compute/display.d.ts +1 -0
  14. package/lib/commands/compute/display.js +2 -1
  15. package/lib/commands/compute/display.js.map +1 -1
  16. package/lib/commands/compute/generate.d.ts +5 -0
  17. package/lib/commands/compute/generate.js +6 -0
  18. package/lib/commands/compute/generate.js.map +1 -1
  19. package/lib/commands/compute/get/build-log.d.ts +1 -0
  20. package/lib/commands/compute/get/build-log.js +2 -1
  21. package/lib/commands/compute/get/build-log.js.map +1 -1
  22. package/lib/commands/compute/get/config.d.ts +1 -0
  23. package/lib/commands/compute/get/config.js +2 -1
  24. package/lib/commands/compute/get/config.js.map +1 -1
  25. package/lib/commands/compute/get/runtime-log.d.ts +1 -0
  26. package/lib/commands/compute/get/runtime-log.js +14 -3
  27. package/lib/commands/compute/get/runtime-log.js.map +1 -1
  28. package/lib/commands/compute/list/config.d.ts +1 -0
  29. package/lib/commands/compute/list/config.js +2 -1
  30. package/lib/commands/compute/list/config.js.map +1 -1
  31. package/lib/commands/compute/list/telemetry-drain.d.ts +1 -0
  32. package/lib/commands/compute/list/telemetry-drain.js +2 -1
  33. package/lib/commands/compute/list/telemetry-drain.js.map +1 -1
  34. package/lib/commands/compute/list.d.ts +1 -0
  35. package/lib/commands/compute/list.js +2 -1
  36. package/lib/commands/compute/list.js.map +1 -1
  37. package/lib/commands/compute/scale.d.ts +1 -0
  38. package/lib/commands/compute/scale.js +2 -1
  39. package/lib/commands/compute/scale.js.map +1 -1
  40. package/lib/commands/compute/set/config.d.ts +1 -0
  41. package/lib/commands/compute/set/config.js +2 -1
  42. package/lib/commands/compute/set/config.js.map +1 -1
  43. package/lib/commands/compute/source/retrieve.d.ts +1 -0
  44. package/lib/commands/compute/source/retrieve.js +2 -1
  45. package/lib/commands/compute/source/retrieve.js.map +1 -1
  46. package/lib/commands/compute/tail/runtime-log.d.ts +1 -0
  47. package/lib/commands/compute/tail/runtime-log.js +22 -6
  48. package/lib/commands/compute/tail/runtime-log.js.map +1 -1
  49. package/lib/commands/compute/unset/config.d.ts +1 -0
  50. package/lib/commands/compute/unset/config.js +2 -1
  51. package/lib/commands/compute/unset/config.js.map +1 -1
  52. package/lib/commands/compute/update/telemetry-drain.d.ts +21 -0
  53. package/lib/commands/compute/update/telemetry-drain.js +70 -0
  54. package/lib/commands/compute/update/telemetry-drain.js.map +1 -0
  55. package/lib/shared/computeGenerateSkeletons.js +4 -2
  56. package/lib/shared/computeGenerateSkeletons.js.map +1 -1
  57. package/lib/shared/computeLogStream.d.ts +6 -1
  58. package/lib/shared/computeLogStream.js +30 -3
  59. package/lib/shared/computeLogStream.js.map +1 -1
  60. package/lib/shared/computeTelemetryDrain.d.ts +12 -0
  61. package/lib/shared/computeTelemetryDrain.js +33 -7
  62. package/lib/shared/computeTelemetryDrain.js.map +1 -1
  63. package/lib/shared/herokuProxyApi.js +2 -2
  64. package/messages/compute.create.telemetry-drain.md +53 -0
  65. package/messages/compute.delete.telemetry-drain.md +41 -0
  66. package/messages/compute.deploy.md +12 -70
  67. package/messages/compute.display.telemetry-drain.md +1 -0
  68. package/messages/compute.errors.md +23 -5
  69. package/messages/compute.generate.md +8 -0
  70. package/messages/compute.get.runtime-log.md +19 -0
  71. package/messages/compute.source.retrieve.md +1 -1
  72. package/messages/compute.update.telemetry-drain.md +57 -0
  73. package/npm-shrinkwrap.json +147 -504
  74. package/oclif.manifest.json +489 -100
  75. package/package.json +4 -4
  76. package/schemas/compute-create-telemetry__drain.json +44 -0
  77. package/schemas/compute-delete-telemetry__drain.json +22 -0
  78. package/schemas/compute-update-telemetry__drain.json +43 -0
  79. package/schemas/compute-deploy.json +0 -30
@@ -3,10 +3,9 @@
3
3
  "compute:deploy": {
4
4
  "aliases": [],
5
5
  "args": {},
6
- "description": "Packages the compute app's source (everything under its directory except the\ncompute metadata file and .forceignore) together with its api-spec.yaml into\na deployment bundle, uploads it to the org through the Connect API, then\ndeploys the app's <name>.compute-meta.xml through the\nMetadata API to trigger the build. The metadata deploy itself returns a job\nID that can be checked independently with \"sf project deploy report\n--job-id <id>\". Deploy is asynchronous: this command returns once the build\nhas been enqueued, it doesn't wait for the build to finish.\n\nFiles matching patterns in a .forceignore are excluded from the source\nbundle. Both the compute app's own .forceignore and the one at the project\nroot (next to sfdx-project.json) are applied, if present. api-spec.yaml and\nproject.toml are always included, since the build can't succeed without them.",
6
+ "description": "This command no longer deploys compute apps. Install the Compute variant of\nthe deploy-retrieve plugin and use project deploy start from your Salesforce\nDX project instead.",
7
7
  "examples": [
8
- "Deploy a compute app to an org, from inside the app's own directory:\ncd force-app/main/default/platformComputeApps/CreditRatingScorer\n<%= config.bin %> <%= command.id %> --target-org my-org",
9
- "Deploy a compute app to an org, from anywhere, by pointing --source-dir at it:\n<%= config.bin %> <%= command.id %> --source-dir force-app/main/default/platformComputeApps/CreditRatingScorer --target-org my-org"
8
+ "Install the plugin and deploy a compute app:\n<%= config.bin %> plugins install @salesforce/plugin-deploy-retrieve@compute\n<%= config.bin %> project deploy start --metadata PlatformComputeApp:my_app --target-org my-org"
10
9
  ],
11
10
  "flags": {
12
11
  "json": {
@@ -26,34 +25,31 @@
26
25
  },
27
26
  "source-dir": {
28
27
  "char": "d",
28
+ "hidden": true,
29
29
  "name": "source-dir",
30
- "summary": "Directory containing the compute app to deploy. Defaults to the current directory.",
31
- "default": "current directory",
32
- "hasDynamicHelp": true,
30
+ "hasDynamicHelp": false,
33
31
  "multiple": false,
34
32
  "type": "option"
35
33
  },
36
34
  "target-org": {
37
35
  "char": "o",
36
+ "hidden": true,
38
37
  "name": "target-org",
39
- "noCacheDefault": true,
40
- "required": true,
41
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
42
- "hasDynamicHelp": true,
38
+ "hasDynamicHelp": false,
43
39
  "multiple": false,
44
40
  "type": "option"
45
41
  }
46
42
  },
47
- "hasDynamicHelp": true,
43
+ "hasDynamicHelp": false,
48
44
  "hiddenAliases": [],
49
45
  "id": "compute:deploy",
50
46
  "pluginAlias": "@heroku/plugin-compute",
51
47
  "pluginName": "@heroku/plugin-compute",
52
48
  "pluginType": "core",
53
49
  "strict": true,
54
- "summary": "Deploy a compute app's source and metadata to an org.",
50
+ "summary": "Show how to deploy a compute app.",
55
51
  "enableJsonFlag": true,
56
- "requiresProject": true,
52
+ "requiresProject": false,
57
53
  "isESM": true,
58
54
  "relativePath": [
59
55
  "lib",
@@ -110,6 +106,13 @@
110
106
  "multiple": false,
111
107
  "type": "option"
112
108
  },
109
+ "api-version": {
110
+ "description": "Override the api version used for api requests made by this command",
111
+ "name": "api-version",
112
+ "hasDynamicHelp": false,
113
+ "multiple": false,
114
+ "type": "option"
115
+ },
113
116
  "verbose": {
114
117
  "char": "v",
115
118
  "name": "verbose",
@@ -144,7 +147,11 @@
144
147
  "compute:generate": {
145
148
  "aliases": [],
146
149
  "args": {},
147
- "description": "Creates the app directory under force-app/main/default/platformComputeApps/<name>/ (or\n--output-dir) with a compute metadata file, a Procfile, a project.toml, and\nstarter source in the language you choose with --language. No org is\ncontacted, but this command does fetch the starter source for the chosen\nlanguage from its Heroku AppLink reference app on GitHub, so it requires\noutbound network access.",
150
+ "deprecationOptions": {
151
+ "to": "template generate project",
152
+ "message": "This command will be available as sf template generate project --template compute in version 1.0.0 of plugin-compute."
153
+ },
154
+ "description": "Creates the app directory under force-app/main/default/platformComputeApps/<name>/ (or\n--output-dir) with a compute metadata file, a Procfile, a project.toml, and\nstarter source in the language you choose with --language. No org is\ncontacted, but this command does fetch the starter source for the chosen\nlanguage from its Heroku AppLink reference app on GitHub, so it requires\noutbound network access.\n\nThis command is deprecated but still works. When you move to sf template generate\nproject --template compute, note that --language no longer defaults to node: the\nreplacement's --compute-language flag makes the language an explicit choice.",
148
155
  "examples": [
149
156
  "Scaffold a Node.js compute app named CreditRatingScorer:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer",
150
157
  "Scaffold a Python compute app into a custom directory:\n<%= config.bin %> <%= command.id %> --name ReceiptOcr --language python --output-dir force-app/main/default/platformComputeApps/scorers"
@@ -205,6 +212,7 @@
205
212
  "pluginAlias": "@heroku/plugin-compute",
206
213
  "pluginName": "@heroku/plugin-compute",
207
214
  "pluginType": "core",
215
+ "state": "deprecated",
208
216
  "strict": true,
209
217
  "summary": "Scaffold a new compute app into your Salesforce DX project.",
210
218
  "enableJsonFlag": true,
@@ -254,6 +262,13 @@
254
262
  "hasDynamicHelp": true,
255
263
  "multiple": false,
256
264
  "type": "option"
265
+ },
266
+ "api-version": {
267
+ "description": "Override the api version used for api requests made by this command",
268
+ "name": "api-version",
269
+ "hasDynamicHelp": false,
270
+ "multiple": false,
271
+ "type": "option"
257
272
  }
258
273
  },
259
274
  "hasDynamicHelp": true,
@@ -324,6 +339,13 @@
324
339
  "multiple": false,
325
340
  "type": "option"
326
341
  },
342
+ "api-version": {
343
+ "description": "Override the api version used for api requests made by this command",
344
+ "name": "api-version",
345
+ "hasDynamicHelp": false,
346
+ "multiple": false,
347
+ "type": "option"
348
+ },
327
349
  "process-type": {
328
350
  "name": "process-type",
329
351
  "required": true,
@@ -370,6 +392,199 @@
370
392
  "scale:compute"
371
393
  ]
372
394
  },
395
+ "compute:create:telemetry-drain": {
396
+ "aliases": [],
397
+ "args": {},
398
+ "description": "Creates an OpenTelemetry drain that forwards the compute app's logs, metrics,\nand traces to the endpoint you give with --url. Choose which signals to\nforward with --signals and the wire protocol with --transport. Use\nsf compute update telemetry-drain to change a drain later.",
399
+ "examples": [
400
+ "Forward all signals from a compute app to an OTLP/HTTP collector:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --url https://collector.example.com:4318 --target-org my-org",
401
+ "Forward only traces and logs over gRPC, with an auth header:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --url https://collector.example.com:4317 --transport grpc --signals traces,logs --header \"x-api-key=my-key\" --target-org my-org"
402
+ ],
403
+ "flags": {
404
+ "json": {
405
+ "description": "Format output as json.",
406
+ "helpGroup": "GLOBAL",
407
+ "name": "json",
408
+ "allowNo": false,
409
+ "type": "boolean"
410
+ },
411
+ "flags-dir": {
412
+ "helpGroup": "GLOBAL",
413
+ "name": "flags-dir",
414
+ "summary": "Import flag values from a directory.",
415
+ "hasDynamicHelp": false,
416
+ "multiple": false,
417
+ "type": "option"
418
+ },
419
+ "name": {
420
+ "char": "n",
421
+ "env": "COMPUTE_APP_NAME",
422
+ "name": "name",
423
+ "summary": "DeveloperName of the compute app to add the drain to (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.",
424
+ "hasDynamicHelp": false,
425
+ "multiple": false,
426
+ "type": "option"
427
+ },
428
+ "url": {
429
+ "name": "url",
430
+ "required": true,
431
+ "summary": "Endpoint to forward telemetry to.",
432
+ "hasDynamicHelp": false,
433
+ "multiple": false,
434
+ "type": "option"
435
+ },
436
+ "signals": {
437
+ "name": "signals",
438
+ "summary": "Comma-separated signals to forward: traces, metrics, logs, or all.",
439
+ "default": "all",
440
+ "hasDynamicHelp": false,
441
+ "multiple": false,
442
+ "type": "option"
443
+ },
444
+ "transport": {
445
+ "name": "transport",
446
+ "summary": "Wire protocol to use: http (OTLP over HTTP) or grpc (OTLP over gRPC).",
447
+ "default": "http",
448
+ "hasDynamicHelp": false,
449
+ "multiple": false,
450
+ "type": "option"
451
+ },
452
+ "header": {
453
+ "description": "Repeat the flag to send more than one header. Header values often carry\ncredentials; they are sent to the endpoint and are never printed to the\nterminal or --json output; header keys are preserved with redacted values.",
454
+ "name": "header",
455
+ "summary": "Header to send with each export, as key=value.",
456
+ "hasDynamicHelp": false,
457
+ "multiple": true,
458
+ "type": "option"
459
+ },
460
+ "target-org": {
461
+ "char": "o",
462
+ "name": "target-org",
463
+ "noCacheDefault": true,
464
+ "required": true,
465
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
466
+ "hasDynamicHelp": true,
467
+ "multiple": false,
468
+ "type": "option"
469
+ },
470
+ "api-version": {
471
+ "description": "Override the api version used for api requests made by this command",
472
+ "name": "api-version",
473
+ "hasDynamicHelp": false,
474
+ "multiple": false,
475
+ "type": "option"
476
+ }
477
+ },
478
+ "hasDynamicHelp": true,
479
+ "hiddenAliases": [],
480
+ "id": "compute:create:telemetry-drain",
481
+ "pluginAlias": "@heroku/plugin-compute",
482
+ "pluginName": "@heroku/plugin-compute",
483
+ "pluginType": "core",
484
+ "strict": true,
485
+ "summary": "Add a telemetry drain to a compute app.",
486
+ "enableJsonFlag": true,
487
+ "requiresProject": false,
488
+ "isESM": true,
489
+ "relativePath": [
490
+ "lib",
491
+ "commands",
492
+ "compute",
493
+ "create",
494
+ "telemetry-drain.js"
495
+ ],
496
+ "aliasPermutations": [],
497
+ "permutations": [
498
+ "compute:create:telemetry-drain",
499
+ "create:compute:telemetry-drain",
500
+ "create:telemetry-drain:compute",
501
+ "compute:telemetry-drain:create",
502
+ "telemetry-drain:compute:create",
503
+ "telemetry-drain:create:compute"
504
+ ]
505
+ },
506
+ "compute:delete:telemetry-drain": {
507
+ "aliases": [],
508
+ "args": {
509
+ "id": {
510
+ "name": "id",
511
+ "required": true
512
+ }
513
+ },
514
+ "description": "Removes a single OpenTelemetry drain by its ID, so its compute app stops\nforwarding logs, metrics, and traces to the drain's endpoint. This can't be\nundone; to forward telemetry again, create a new drain. You're asked to\nconfirm first unless you pass --no-prompt. Use sf compute list telemetry-drain\nto find a drain's ID.",
515
+ "examples": [
516
+ "Delete a telemetry drain, confirming first:\n<%= config.bin %> <%= command.id %> 01234567-89ab-cdef-0123-456789abcdef --target-org my-org",
517
+ "Delete a telemetry drain without the confirmation prompt, for scripts:\n<%= config.bin %> <%= command.id %> 01234567-89ab-cdef-0123-456789abcdef --target-org my-org --no-prompt"
518
+ ],
519
+ "flags": {
520
+ "json": {
521
+ "description": "Format output as json.",
522
+ "helpGroup": "GLOBAL",
523
+ "name": "json",
524
+ "allowNo": false,
525
+ "type": "boolean"
526
+ },
527
+ "flags-dir": {
528
+ "helpGroup": "GLOBAL",
529
+ "name": "flags-dir",
530
+ "summary": "Import flag values from a directory.",
531
+ "hasDynamicHelp": false,
532
+ "multiple": false,
533
+ "type": "option"
534
+ },
535
+ "no-prompt": {
536
+ "char": "p",
537
+ "name": "no-prompt",
538
+ "summary": "Don't ask for confirmation before deleting.",
539
+ "allowNo": false,
540
+ "type": "boolean"
541
+ },
542
+ "target-org": {
543
+ "char": "o",
544
+ "name": "target-org",
545
+ "noCacheDefault": true,
546
+ "required": true,
547
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
548
+ "hasDynamicHelp": true,
549
+ "multiple": false,
550
+ "type": "option"
551
+ },
552
+ "api-version": {
553
+ "description": "Override the api version used for api requests made by this command",
554
+ "name": "api-version",
555
+ "hasDynamicHelp": false,
556
+ "multiple": false,
557
+ "type": "option"
558
+ }
559
+ },
560
+ "hasDynamicHelp": true,
561
+ "hiddenAliases": [],
562
+ "id": "compute:delete:telemetry-drain",
563
+ "pluginAlias": "@heroku/plugin-compute",
564
+ "pluginName": "@heroku/plugin-compute",
565
+ "pluginType": "core",
566
+ "strict": true,
567
+ "summary": "Delete a compute telemetry drain.",
568
+ "enableJsonFlag": true,
569
+ "requiresProject": false,
570
+ "isESM": true,
571
+ "relativePath": [
572
+ "lib",
573
+ "commands",
574
+ "compute",
575
+ "delete",
576
+ "telemetry-drain.js"
577
+ ],
578
+ "aliasPermutations": [],
579
+ "permutations": [
580
+ "compute:delete:telemetry-drain",
581
+ "delete:compute:telemetry-drain",
582
+ "delete:telemetry-drain:compute",
583
+ "compute:telemetry-drain:delete",
584
+ "telemetry-drain:compute:delete",
585
+ "telemetry-drain:delete:compute"
586
+ ]
587
+ },
373
588
  "compute:display:telemetry-drain": {
374
589
  "aliases": [],
375
590
  "args": {
@@ -378,7 +593,7 @@
378
593
  "required": true
379
594
  }
380
595
  },
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.",
596
+ "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.\nHeader values are redacted in both human-readable and --json output; header keys are preserved.",
382
597
  "examples": [
383
598
  "Show the detail of a telemetry drain by its ID:\n<%= config.bin %> <%= command.id %> 01234567-89ab-cdef-0123-456789abcdef --target-org my-org"
384
599
  ],
@@ -407,6 +622,13 @@
407
622
  "hasDynamicHelp": true,
408
623
  "multiple": false,
409
624
  "type": "option"
625
+ },
626
+ "api-version": {
627
+ "description": "Override the api version used for api requests made by this command",
628
+ "name": "api-version",
629
+ "hasDynamicHelp": false,
630
+ "multiple": false,
631
+ "type": "option"
410
632
  }
411
633
  },
412
634
  "hasDynamicHelp": true,
@@ -478,6 +700,13 @@
478
700
  "hasDynamicHelp": true,
479
701
  "multiple": false,
480
702
  "type": "option"
703
+ },
704
+ "api-version": {
705
+ "description": "Override the api version used for api requests made by this command",
706
+ "name": "api-version",
707
+ "hasDynamicHelp": false,
708
+ "multiple": false,
709
+ "type": "option"
481
710
  }
482
711
  },
483
712
  "hasDynamicHelp": true,
@@ -556,6 +785,13 @@
556
785
  "hasDynamicHelp": true,
557
786
  "multiple": false,
558
787
  "type": "option"
788
+ },
789
+ "api-version": {
790
+ "description": "Override the api version used for api requests made by this command",
791
+ "name": "api-version",
792
+ "hasDynamicHelp": false,
793
+ "multiple": false,
794
+ "type": "option"
559
795
  }
560
796
  },
561
797
  "hasDynamicHelp": true,
@@ -591,7 +827,7 @@
591
827
  "compute:get:runtime-log": {
592
828
  "aliases": [],
593
829
  "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.",
830
+ "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\nThe recent lines come from the Cedar log buffer (about 1500 lines at most), so\n--num can't return more than that. Fir apps keep no log history, so this\ncommand isn't supported for them; use compute tail runtime-log instead. The\ncommand stops waiting after 30 seconds and prints whatever log lines it has\nreceived by then; if none arrived, it fails with a timeout error.\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.",
595
831
  "examples": [
596
832
  "Print the most recent log lines:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org",
597
833
  "Print the most recent 500 log lines:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --num 500 --target-org my-org"
@@ -631,6 +867,13 @@
631
867
  "multiple": false,
632
868
  "type": "option"
633
869
  },
870
+ "api-version": {
871
+ "description": "Override the api version used for api requests made by this command",
872
+ "name": "api-version",
873
+ "hasDynamicHelp": false,
874
+ "multiple": false,
875
+ "type": "option"
876
+ },
634
877
  "num": {
635
878
  "name": "num",
636
879
  "summary": "Number of recent log lines to print.",
@@ -668,6 +911,165 @@
668
911
  "runtime-log:get:compute"
669
912
  ]
670
913
  },
914
+ "compute:list:config": {
915
+ "aliases": [],
916
+ "args": {},
917
+ "deprecateAliases": true,
918
+ "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.",
919
+ "examples": [
920
+ "List all config vars for a compute app:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
921
+ ],
922
+ "flags": {
923
+ "json": {
924
+ "description": "Format output as json.",
925
+ "helpGroup": "GLOBAL",
926
+ "name": "json",
927
+ "allowNo": false,
928
+ "type": "boolean"
929
+ },
930
+ "flags-dir": {
931
+ "helpGroup": "GLOBAL",
932
+ "name": "flags-dir",
933
+ "summary": "Import flag values from a directory.",
934
+ "hasDynamicHelp": false,
935
+ "multiple": false,
936
+ "type": "option"
937
+ },
938
+ "name": {
939
+ "char": "n",
940
+ "env": "COMPUTE_APP_NAME",
941
+ "name": "name",
942
+ "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.",
943
+ "hasDynamicHelp": false,
944
+ "multiple": false,
945
+ "type": "option"
946
+ },
947
+ "target-org": {
948
+ "char": "o",
949
+ "name": "target-org",
950
+ "noCacheDefault": true,
951
+ "required": true,
952
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
953
+ "hasDynamicHelp": true,
954
+ "multiple": false,
955
+ "type": "option"
956
+ },
957
+ "api-version": {
958
+ "description": "Override the api version used for api requests made by this command",
959
+ "name": "api-version",
960
+ "hasDynamicHelp": false,
961
+ "multiple": false,
962
+ "type": "option"
963
+ }
964
+ },
965
+ "hasDynamicHelp": true,
966
+ "hiddenAliases": [
967
+ "compute:config:list"
968
+ ],
969
+ "id": "compute:list:config",
970
+ "pluginAlias": "@heroku/plugin-compute",
971
+ "pluginName": "@heroku/plugin-compute",
972
+ "pluginType": "core",
973
+ "strict": true,
974
+ "summary": "List a compute app's config vars.",
975
+ "enableJsonFlag": true,
976
+ "requiresProject": false,
977
+ "isESM": true,
978
+ "relativePath": [
979
+ "lib",
980
+ "commands",
981
+ "compute",
982
+ "list",
983
+ "config.js"
984
+ ],
985
+ "aliasPermutations": [],
986
+ "permutations": [
987
+ "compute:list:config",
988
+ "list:compute:config",
989
+ "list:config:compute",
990
+ "compute:config:list",
991
+ "config:compute:list",
992
+ "config:list:compute"
993
+ ]
994
+ },
995
+ "compute:list:telemetry-drain": {
996
+ "aliases": [],
997
+ "args": {},
998
+ "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.",
999
+ "examples": [
1000
+ "List the telemetry drains for a compute app:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
1001
+ ],
1002
+ "flags": {
1003
+ "json": {
1004
+ "description": "Format output as json.",
1005
+ "helpGroup": "GLOBAL",
1006
+ "name": "json",
1007
+ "allowNo": false,
1008
+ "type": "boolean"
1009
+ },
1010
+ "flags-dir": {
1011
+ "helpGroup": "GLOBAL",
1012
+ "name": "flags-dir",
1013
+ "summary": "Import flag values from a directory.",
1014
+ "hasDynamicHelp": false,
1015
+ "multiple": false,
1016
+ "type": "option"
1017
+ },
1018
+ "name": {
1019
+ "char": "n",
1020
+ "env": "COMPUTE_APP_NAME",
1021
+ "name": "name",
1022
+ "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.",
1023
+ "hasDynamicHelp": false,
1024
+ "multiple": false,
1025
+ "type": "option"
1026
+ },
1027
+ "target-org": {
1028
+ "char": "o",
1029
+ "name": "target-org",
1030
+ "noCacheDefault": true,
1031
+ "required": true,
1032
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1033
+ "hasDynamicHelp": true,
1034
+ "multiple": false,
1035
+ "type": "option"
1036
+ },
1037
+ "api-version": {
1038
+ "description": "Override the api version used for api requests made by this command",
1039
+ "name": "api-version",
1040
+ "hasDynamicHelp": false,
1041
+ "multiple": false,
1042
+ "type": "option"
1043
+ }
1044
+ },
1045
+ "hasDynamicHelp": true,
1046
+ "hiddenAliases": [],
1047
+ "id": "compute:list:telemetry-drain",
1048
+ "pluginAlias": "@heroku/plugin-compute",
1049
+ "pluginName": "@heroku/plugin-compute",
1050
+ "pluginType": "core",
1051
+ "strict": true,
1052
+ "summary": "List the telemetry drains configured for a compute app.",
1053
+ "enableJsonFlag": true,
1054
+ "requiresProject": false,
1055
+ "isESM": true,
1056
+ "relativePath": [
1057
+ "lib",
1058
+ "commands",
1059
+ "compute",
1060
+ "list",
1061
+ "telemetry-drain.js"
1062
+ ],
1063
+ "aliasPermutations": [],
1064
+ "permutations": [
1065
+ "compute:list:telemetry-drain",
1066
+ "list:compute:telemetry-drain",
1067
+ "list:telemetry-drain:compute",
1068
+ "compute:telemetry-drain:list",
1069
+ "telemetry-drain:compute:list",
1070
+ "telemetry-drain:list:compute"
1071
+ ]
1072
+ },
671
1073
  "compute:set:config": {
672
1074
  "aliases": [],
673
1075
  "args": {
@@ -716,6 +1118,13 @@
716
1118
  "hasDynamicHelp": true,
717
1119
  "multiple": false,
718
1120
  "type": "option"
1121
+ },
1122
+ "api-version": {
1123
+ "description": "Override the api version used for api requests made by this command",
1124
+ "name": "api-version",
1125
+ "hasDynamicHelp": false,
1126
+ "multiple": false,
1127
+ "type": "option"
719
1128
  }
720
1129
  },
721
1130
  "hasDynamicHelp": true,
@@ -751,7 +1160,7 @@
751
1160
  "compute:source:retrieve": {
752
1161
  "aliases": [],
753
1162
  "args": {},
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.",
1163
+ "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. Deploy it with project deploy start.",
755
1164
  "examples": [
756
1165
  "Retrieve a compute app's source and metadata from an org:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
757
1166
  ],
@@ -790,6 +1199,13 @@
790
1199
  "multiple": false,
791
1200
  "type": "option"
792
1201
  },
1202
+ "api-version": {
1203
+ "description": "Override the api version used for api requests made by this command",
1204
+ "name": "api-version",
1205
+ "hasDynamicHelp": false,
1206
+ "multiple": false,
1207
+ "type": "option"
1208
+ },
793
1209
  "output-dir": {
794
1210
  "char": "d",
795
1211
  "description": "Defaults to force-app/main/default/platformComputeApps. The app itself is created in a\nsubdirectory named after --name.",
@@ -865,6 +1281,13 @@
865
1281
  "multiple": false,
866
1282
  "type": "option"
867
1283
  },
1284
+ "api-version": {
1285
+ "description": "Override the api version used for api requests made by this command",
1286
+ "name": "api-version",
1287
+ "hasDynamicHelp": false,
1288
+ "multiple": false,
1289
+ "type": "option"
1290
+ },
868
1291
  "num": {
869
1292
  "name": "num",
870
1293
  "summary": "Number of recent log lines to print before streaming new output.",
@@ -950,6 +1373,13 @@
950
1373
  "hasDynamicHelp": true,
951
1374
  "multiple": false,
952
1375
  "type": "option"
1376
+ },
1377
+ "api-version": {
1378
+ "description": "Override the api version used for api requests made by this command",
1379
+ "name": "api-version",
1380
+ "hasDynamicHelp": false,
1381
+ "multiple": false,
1382
+ "type": "option"
953
1383
  }
954
1384
  },
955
1385
  "hasDynamicHelp": true,
@@ -982,13 +1412,18 @@
982
1412
  "config:unset:compute"
983
1413
  ]
984
1414
  },
985
- "compute:list:config": {
1415
+ "compute:update:telemetry-drain": {
986
1416
  "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.",
1417
+ "args": {
1418
+ "id": {
1419
+ "name": "id",
1420
+ "required": true
1421
+ }
1422
+ },
1423
+ "description": "Updates only the attributes you pass and leaves the rest of the drain as it\nis. Passing --header adds or overwrites the headers you give and keeps the\ndrain's other headers. Use sf compute list telemetry-drain to find a drain's ID.",
990
1424
  "examples": [
991
- "List all config vars for a compute app:\n<%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org"
1425
+ "Point a drain at a new endpoint:\n<%= config.bin %> <%= command.id %> 01234567-89ab-cdef-0123-456789abcdef --url https://collector.example.com:4318 --target-org my-org",
1426
+ "Forward only logs over gRPC:\n<%= config.bin %> <%= command.id %> 01234567-89ab-cdef-0123-456789abcdef --signals logs --transport grpc --target-org my-org"
992
1427
  ],
993
1428
  "flags": {
994
1429
  "json": {
@@ -1006,86 +1441,33 @@
1006
1441
  "multiple": false,
1007
1442
  "type": "option"
1008
1443
  },
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.",
1444
+ "url": {
1445
+ "name": "url",
1446
+ "summary": "New endpoint to forward telemetry to.",
1014
1447
  "hasDynamicHelp": false,
1015
1448
  "multiple": false,
1016
1449
  "type": "option"
1017
1450
  },
1018
- "target-org": {
1019
- "char": "o",
1020
- "name": "target-org",
1021
- "noCacheDefault": true,
1022
- "required": true,
1023
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
1024
- "hasDynamicHelp": true,
1451
+ "signals": {
1452
+ "name": "signals",
1453
+ "summary": "New comma-separated signals to forward: traces, metrics, logs, or all.",
1454
+ "hasDynamicHelp": false,
1025
1455
  "multiple": false,
1026
1456
  "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
1457
  },
1074
- "flags-dir": {
1075
- "helpGroup": "GLOBAL",
1076
- "name": "flags-dir",
1077
- "summary": "Import flag values from a directory.",
1458
+ "transport": {
1459
+ "name": "transport",
1460
+ "summary": "New wire protocol: http (OTLP over HTTP) or grpc (OTLP over gRPC).",
1078
1461
  "hasDynamicHelp": false,
1079
1462
  "multiple": false,
1080
1463
  "type": "option"
1081
1464
  },
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.",
1465
+ "header": {
1466
+ "description": "Repeat the flag to send more than one header. A header you pass adds\nor overwrites the one with the same name; the drain's other headers are kept. Header values often carry credentials; they are\nnever printed to the terminal or --json output; header keys are preserved with redacted values.",
1467
+ "name": "header",
1468
+ "summary": "Header to send with each export, as key=value.",
1087
1469
  "hasDynamicHelp": false,
1088
- "multiple": false,
1470
+ "multiple": true,
1089
1471
  "type": "option"
1090
1472
  },
1091
1473
  "target-org": {
@@ -1097,16 +1479,23 @@
1097
1479
  "hasDynamicHelp": true,
1098
1480
  "multiple": false,
1099
1481
  "type": "option"
1482
+ },
1483
+ "api-version": {
1484
+ "description": "Override the api version used for api requests made by this command",
1485
+ "name": "api-version",
1486
+ "hasDynamicHelp": false,
1487
+ "multiple": false,
1488
+ "type": "option"
1100
1489
  }
1101
1490
  },
1102
1491
  "hasDynamicHelp": true,
1103
1492
  "hiddenAliases": [],
1104
- "id": "compute:list:telemetry-drain",
1493
+ "id": "compute:update:telemetry-drain",
1105
1494
  "pluginAlias": "@heroku/plugin-compute",
1106
1495
  "pluginName": "@heroku/plugin-compute",
1107
1496
  "pluginType": "core",
1108
1497
  "strict": true,
1109
- "summary": "List the telemetry drains configured for a compute app.",
1498
+ "summary": "Change the configuration of a compute telemetry drain.",
1110
1499
  "enableJsonFlag": true,
1111
1500
  "requiresProject": false,
1112
1501
  "isESM": true,
@@ -1114,19 +1503,19 @@
1114
1503
  "lib",
1115
1504
  "commands",
1116
1505
  "compute",
1117
- "list",
1506
+ "update",
1118
1507
  "telemetry-drain.js"
1119
1508
  ],
1120
1509
  "aliasPermutations": [],
1121
1510
  "permutations": [
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"
1511
+ "compute:update:telemetry-drain",
1512
+ "update:compute:telemetry-drain",
1513
+ "update:telemetry-drain:compute",
1514
+ "compute:telemetry-drain:update",
1515
+ "telemetry-drain:compute:update",
1516
+ "telemetry-drain:update:compute"
1128
1517
  ]
1129
1518
  }
1130
1519
  },
1131
- "version": "0.3.0"
1520
+ "version": "0.3.2"
1132
1521
  }