@intentius/chant 0.124.52 → 0.124.55
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.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/audit/discover.d.ts.map +1 -1
- package/dist/audit/discover.js +3 -1
- package/dist/behaviour.d.ts +1 -1
- package/dist/behaviour.d.ts.map +1 -1
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts +65 -0
- package/dist/capabilities/templates.d.ts.map +1 -0
- package/dist/capabilities/templates.js +192 -0
- package/dist/capabilities/templates.json +145 -0
- package/dist/change-set-graph.d.ts +35 -3
- package/dist/change-set-graph.d.ts.map +1 -1
- package/dist/change-set-graph.js +60 -9
- package/dist/change-set.d.ts +65 -7
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +22 -12
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +833 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +42 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +68 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +83 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +89 -9
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +91 -16
- package/dist/ci-product-words.d.ts +290 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +373 -0
- package/dist/ci-product.d.ts +82 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +78 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/import-index.d.ts +52 -0
- package/dist/cli/commands/import-index.d.ts.map +1 -0
- package/dist/cli/commands/import-index.js +226 -0
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/commands/lint.d.ts.map +1 -1
- package/dist/cli/commands/lint.js +4 -2
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +43 -1
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +34 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/components.d.ts.map +1 -1
- package/dist/cli/handlers/components.js +11 -2
- package/dist/cli/handlers/fan-out.d.ts.map +1 -1
- package/dist/cli/handlers/fan-out.js +20 -3
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/graph.d.ts.map +1 -1
- package/dist/cli/handlers/graph.js +22 -4
- package/dist/cli/handlers/index-cloud.d.ts +14 -0
- package/dist/cli/handlers/index-cloud.d.ts.map +1 -0
- package/dist/cli/handlers/index-cloud.js +22 -0
- package/dist/cli/handlers/index-diff.d.ts +18 -0
- package/dist/cli/handlers/index-diff.d.ts.map +1 -0
- package/dist/cli/handlers/index-diff.js +142 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +29 -0
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -0
- package/dist/cli/handlers/lifecycle-drift.js +69 -0
- package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle.js +188 -28
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/misc.d.ts +9 -0
- package/dist/cli/handlers/misc.d.ts.map +1 -1
- package/dist/cli/handlers/misc.js +77 -0
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +38 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +668 -207
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +110 -17
- package/dist/cli/handlers/query.d.ts.map +1 -1
- package/dist/cli/handlers/query.js +28 -4
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +71 -1
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/scenario.d.ts.map +1 -1
- package/dist/cli/handlers/scenario.js +8 -7
- package/dist/cli/handlers/search.d.ts +34 -4
- package/dist/cli/handlers/search.d.ts.map +1 -1
- package/dist/cli/handlers/search.js +216 -36
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +179 -14
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/lifecycle-tools.d.ts.map +1 -1
- package/dist/cli/mcp/lifecycle-tools.js +3 -2
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/resource-handlers.d.ts.map +1 -1
- package/dist/cli/mcp/resource-handlers.js +4 -3
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp/workspace-tools.js +1 -1
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +112 -5
- package/dist/cli/registry.d.ts +54 -1
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/aws.d.ts +35 -0
- package/dist/cloud-lister/aws.d.ts.map +1 -0
- package/dist/cloud-lister/aws.js +203 -0
- package/dist/cloud-lister/azure.d.ts +34 -0
- package/dist/cloud-lister/azure.d.ts.map +1 -0
- package/dist/cloud-lister/azure.js +129 -0
- package/dist/cloud-lister/common.d.ts +40 -0
- package/dist/cloud-lister/common.d.ts.map +1 -0
- package/dist/cloud-lister/common.js +83 -0
- package/dist/cloud-lister/credentials.d.ts +50 -0
- package/dist/cloud-lister/credentials.d.ts.map +1 -0
- package/dist/cloud-lister/credentials.js +86 -0
- package/dist/cloud-lister/fakes.d.ts +27 -0
- package/dist/cloud-lister/fakes.d.ts.map +1 -0
- package/dist/cloud-lister/fakes.js +50 -0
- package/dist/cloud-lister/gcp.d.ts +42 -0
- package/dist/cloud-lister/gcp.d.ts.map +1 -0
- package/dist/cloud-lister/gcp.js +143 -0
- package/dist/cloud-lister/guard.d.ts +49 -0
- package/dist/cloud-lister/guard.d.ts.map +1 -0
- package/dist/cloud-lister/guard.js +103 -0
- package/dist/cloud-lister/ids.d.ts +23 -0
- package/dist/cloud-lister/ids.d.ts.map +1 -0
- package/dist/cloud-lister/ids.js +42 -0
- package/dist/cloud-lister/index.d.ts +67 -0
- package/dist/cloud-lister/index.d.ts.map +1 -0
- package/dist/cloud-lister/index.js +102 -0
- package/dist/cloud-lister/kubernetes.d.ts +64 -0
- package/dist/cloud-lister/kubernetes.d.ts.map +1 -0
- package/dist/cloud-lister/kubernetes.js +276 -0
- package/dist/cloud-lister/markers.d.ts +31 -0
- package/dist/cloud-lister/markers.d.ts.map +1 -0
- package/dist/cloud-lister/markers.js +73 -0
- package/dist/cloud-lister/mask.d.ts +31 -0
- package/dist/cloud-lister/mask.d.ts.map +1 -0
- package/dist/cloud-lister/mask.js +74 -0
- package/dist/cloud-lister/sigv4.d.ts +64 -0
- package/dist/cloud-lister/sigv4.d.ts.map +1 -0
- package/dist/cloud-lister/sigv4.js +104 -0
- package/dist/cloud-lister/transport.d.ts +55 -0
- package/dist/cloud-lister/transport.d.ts.map +1 -0
- package/dist/cloud-lister/transport.js +86 -0
- package/dist/cloud-lister/types.d.ts +121 -0
- package/dist/cloud-lister/types.d.ts.map +1 -0
- package/dist/cloud-lister/types.js +24 -0
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +93 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability-plugin-loader.d.ts.map +1 -1
- package/dist/components/capability-plugin-loader.js +6 -0
- package/dist/components/capability-plugin.d.ts +9 -0
- package/dist/components/capability-plugin.d.ts.map +1 -1
- package/dist/components/capability.d.ts +337 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +14 -6
- package/dist/components/check-hooks.d.ts +113 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +61 -0
- package/dist/components/cli-support.d.ts +34 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +67 -15
- package/dist/components/declared-reads.d.ts +38 -0
- package/dist/components/declared-reads.d.ts.map +1 -0
- package/dist/components/declared-reads.js +131 -0
- package/dist/components/deploy-units.d.ts.map +1 -1
- package/dist/components/deploy-units.js +4 -0
- package/dist/components/driver.d.ts +54 -4
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +90 -7
- package/dist/components/fan-out-run.d.ts +35 -1
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +138 -30
- package/dist/components/fan-out-support.d.ts +6 -0
- package/dist/components/fan-out-support.d.ts.map +1 -1
- package/dist/components/fan-out-support.js +4 -1
- package/dist/components/fan-out.d.ts +28 -0
- package/dist/components/fan-out.d.ts.map +1 -1
- package/dist/components/groups.d.ts +229 -0
- package/dist/components/groups.d.ts.map +1 -0
- package/dist/components/groups.js +777 -0
- package/dist/components/index.d.ts +6 -2
- package/dist/components/index.d.ts.map +1 -1
- package/dist/components/index.js +4 -0
- package/dist/components/plan-shape-conformance.d.ts +48 -0
- package/dist/components/plan-shape-conformance.d.ts.map +1 -0
- package/dist/components/plan-shape-conformance.js +122 -0
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +39 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +31 -3
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +25 -7
- package/dist/components/pr-pipeline.d.ts +169 -3
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +184 -9
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +104 -4
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +290 -41
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +217 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +193 -0
- package/dist/components/promote-rounds.d.ts +9 -0
- package/dist/components/promote-rounds.d.ts.map +1 -1
- package/dist/components/promote-rounds.js +23 -2
- package/dist/components/promote.d.ts +23 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +39 -6
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-gate.d.ts +23 -1
- package/dist/components/release-gate.d.ts.map +1 -1
- package/dist/components/release-gate.js +97 -33
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/run-groups.d.ts +58 -0
- package/dist/components/run-groups.d.ts.map +1 -0
- package/dist/components/run-groups.js +78 -0
- package/dist/components/starter-plugin.d.ts +1 -0
- package/dist/components/starter-plugin.d.ts.map +1 -1
- package/dist/components/starter-plugin.js +6 -1
- package/dist/components/verbs/index.d.ts +1 -0
- package/dist/components/verbs/index.d.ts.map +1 -1
- package/dist/components/verbs/index.js +1 -0
- package/dist/components/verbs/member-outputs.d.ts +187 -0
- package/dist/components/verbs/member-outputs.d.ts.map +1 -0
- package/dist/components/verbs/member-outputs.js +218 -0
- package/dist/components/wave-plan.d.ts +34 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +54 -2
- package/dist/config.d.ts +60 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +27 -0
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/deep-observation.d.ts +1 -13
- package/dist/deep-observation.d.ts.map +1 -1
- package/dist/deep-observation.js +5 -22
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/drift-record.d.ts +542 -0
- package/dist/drift-record.d.ts.map +1 -0
- package/dist/drift-record.js +886 -0
- package/dist/engine-facts.d.ts +144 -0
- package/dist/engine-facts.d.ts.map +1 -0
- package/dist/engine-facts.js +13 -0
- package/dist/exit-codes.d.ts +48 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +49 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/graph-ir.d.ts +153 -2
- package/dist/graph-ir.d.ts.map +1 -1
- package/dist/graph-ir.js +224 -6
- package/dist/graph-refs.d.ts +145 -0
- package/dist/graph-refs.d.ts.map +1 -1
- package/dist/graph-refs.js +305 -0
- package/dist/graph-schema/fixtures/adopt.json +15 -0
- package/dist/graph-schema/fixtures/choudoufu.engine-graph.json +169 -0
- package/dist/graph-schema/fixtures/index.json +68 -0
- package/dist/graph-schema/fixtures/plunge.engine-graph.json +158 -0
- package/dist/graph-schema/fixtures.d.ts +23 -0
- package/dist/graph-schema/fixtures.d.ts.map +1 -0
- package/dist/graph-schema/fixtures.js +246 -0
- package/dist/graph-schema/generate.d.ts +15 -0
- package/dist/graph-schema/generate.d.ts.map +1 -0
- package/dist/graph-schema/generate.js +267 -0
- package/dist/graph-schema/graph.schema.json +1387 -0
- package/dist/health.schema.json +2 -1
- package/dist/identity.d.ts.map +1 -1
- package/dist/identity.js +2 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -0
- package/dist/instance-nodes.d.ts +159 -0
- package/dist/instance-nodes.d.ts.map +1 -0
- package/dist/instance-nodes.js +231 -0
- package/dist/lexicon.d.ts +178 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +80 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -0
- package/dist/lifecycle/adoption-file.js +122 -0
- package/dist/lifecycle/cloud-index.d.ts +186 -0
- package/dist/lifecycle/cloud-index.d.ts.map +1 -0
- package/dist/lifecycle/cloud-index.js +617 -0
- package/dist/lifecycle/derive-edges.d.ts +59 -0
- package/dist/lifecycle/derive-edges.d.ts.map +1 -0
- package/dist/lifecycle/derive-edges.js +126 -0
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +11 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +205 -0
- package/dist/lifecycle/git.d.ts +10 -9
- package/dist/lifecycle/git.d.ts.map +1 -1
- package/dist/lifecycle/git.js +7 -1
- package/dist/lifecycle/identity-match.d.ts +148 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -0
- package/dist/lifecycle/identity-match.js +152 -0
- package/dist/lifecycle/index-diff.d.ts +264 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -0
- package/dist/lifecycle/index-diff.js +326 -0
- package/dist/lifecycle/index-document.d.ts +130 -0
- package/dist/lifecycle/index-document.d.ts.map +1 -0
- package/dist/lifecycle/index-document.js +188 -0
- package/dist/lifecycle/index-drift.d.ts +121 -0
- package/dist/lifecycle/index-drift.d.ts.map +1 -0
- package/dist/lifecycle/index-drift.js +178 -0
- package/dist/lifecycle/index-import.d.ts +171 -0
- package/dist/lifecycle/index-import.d.ts.map +1 -0
- package/dist/lifecycle/index-import.js +512 -0
- package/dist/lifecycle/index-join.d.ts +129 -0
- package/dist/lifecycle/index-join.d.ts.map +1 -0
- package/dist/lifecycle/index-join.js +248 -0
- package/dist/lifecycle/index.d.ts +4 -0
- package/dist/lifecycle/index.d.ts.map +1 -1
- package/dist/lifecycle/index.js +4 -0
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/observation-baseline.d.ts +61 -21
- package/dist/lifecycle/observation-baseline.d.ts.map +1 -1
- package/dist/lifecycle/observation-baseline.js +144 -19
- package/dist/lifecycle/observe.d.ts.map +1 -1
- package/dist/lifecycle/observe.js +6 -1
- package/dist/lifecycle/query.d.ts +94 -6
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +182 -9
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +10 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +86 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +136 -0
- package/dist/lifecycle/replay.d.ts +10 -3
- package/dist/lifecycle/replay.d.ts.map +1 -1
- package/dist/lifecycle/replay.js +10 -6
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/scenario.d.ts +4 -3
- package/dist/lifecycle/scenario.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-fake.d.ts +9 -0
- package/dist/lifecycle/snapshot-store-fake.d.ts.map +1 -0
- package/dist/lifecycle/snapshot-store-fake.js +21 -0
- package/dist/lifecycle/snapshot-store-s3.d.ts +135 -0
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -0
- package/dist/lifecycle/snapshot-store-s3.js +219 -0
- package/dist/lifecycle/snapshot-store.d.ts +170 -0
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -0
- package/dist/lifecycle/snapshot-store.js +831 -0
- package/dist/lifecycle/snapshot.d.ts +11 -0
- package/dist/lifecycle/snapshot.d.ts.map +1 -1
- package/dist/lifecycle/snapshot.js +18 -5
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/lifecycle/type-listing.d.ts +148 -0
- package/dist/lifecycle/type-listing.d.ts.map +1 -0
- package/dist/lifecycle/type-listing.js +166 -0
- package/dist/lint/component-checks.d.ts +15 -1
- package/dist/lint/component-checks.d.ts.map +1 -1
- package/dist/lint/component-checks.js +1 -0
- package/dist/lint/presets/relaxed.json +2 -1
- package/dist/lint/presets/strict.json +2 -1
- package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.d.ts +4 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.d.ts.map +1 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.js +13 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.d.ts +4 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.d.ts.map +1 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.js +8 -0
- package/dist/lint/rules/comp/comp008-applies-signal-only-root.d.ts +33 -0
- package/dist/lint/rules/comp/comp008-applies-signal-only-root.d.ts.map +1 -0
- package/dist/lint/rules/comp/comp008-applies-signal-only-root.js +123 -0
- package/dist/lint/rules/comp/index.d.ts +2 -1
- package/dist/lint/rules/comp/index.d.ts.map +1 -1
- package/dist/lint/rules/comp/index.js +4 -1
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/observation.d.ts +19 -2
- package/dist/observation.d.ts.map +1 -1
- package/dist/observation.js +18 -1
- package/dist/op/activities/activity-contracts.d.ts +1 -1
- package/dist/op/activities/activity-contracts.js +1 -1
- package/dist/op/activities/change-set.d.ts +6 -4
- package/dist/op/activities/change-set.d.ts.map +1 -1
- package/dist/op/activities/change-set.js +4 -2
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/activity-failure.d.ts +27 -0
- package/dist/op/activity-failure.d.ts.map +1 -1
- package/dist/op/activity-failure.js +31 -0
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +14 -2
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +8 -2
- package/dist/op/local-executor.d.ts +5 -1
- package/dist/op/local-executor.d.ts.map +1 -1
- package/dist/op/local-executor.js +22 -8
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +55 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +94 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +97 -0
- package/dist/op/op-waves-run.d.ts +175 -4
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +981 -41
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +97 -0
- package/dist/op/op-waves.d.ts +152 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +161 -17
- package/dist/op/runtime.d.ts +91 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +19 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +426 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +103 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +92 -0
- package/dist/pr-loop.d.ts +205 -12
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +330 -41
- package/dist/pr-post.d.ts +16 -0
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +26 -1
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +46 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/pulumi-urn.d.ts +101 -0
- package/dist/pulumi-urn.d.ts.map +1 -0
- package/dist/pulumi-urn.js +131 -0
- package/dist/release-floors.d.ts +23 -0
- package/dist/release-floors.d.ts.map +1 -0
- package/dist/release-floors.js +22 -0
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +4 -1
- package/dist/sensitive-key.d.ts +23 -0
- package/dist/sensitive-key.d.ts.map +1 -0
- package/dist/sensitive-key.js +31 -0
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +390 -285
- package/dist/workspace/adoption-report.d.ts +53 -0
- package/dist/workspace/adoption-report.d.ts.map +1 -0
- package/dist/workspace/adoption-report.js +76 -0
- package/dist/workspace/capabilities-contract.d.ts +7 -0
- package/dist/workspace/capabilities-contract.d.ts.map +1 -1
- package/dist/workspace/capabilities-contract.js +2 -1
- package/dist/workspace/capabilities.schema.json +98 -0
- package/dist/workspace/change-set.schema.json +42 -3
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-cloud-identity.d.ts +13 -1
- package/dist/workspace/ci-cloud-identity.d.ts.map +1 -1
- package/dist/workspace/ci-cloud-identity.js +30 -1
- package/dist/workspace/ci-lock-grain.d.ts +12 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +27 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +6 -3
- package/dist/workspace/compose-graph.d.ts +10 -1
- package/dist/workspace/compose-graph.d.ts.map +1 -1
- package/dist/workspace/compose-graph.js +6 -1
- package/dist/workspace/conformance/index.d.ts +1 -1
- package/dist/workspace/conformance/index.d.ts.map +1 -1
- package/dist/workspace/conformance/index.js +6 -1
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts +81 -0
- package/dist/workspace/drift-cli.d.ts.map +1 -0
- package/dist/workspace/drift-cli.js +322 -0
- package/dist/workspace/drift.schema.json +672 -0
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/graph-cli.d.ts +2 -0
- package/dist/workspace/graph-cli.d.ts.map +1 -1
- package/dist/workspace/graph-cli.js +3 -0
- package/dist/workspace/graph.schema.json +72 -0
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/init.d.ts +5 -1
- package/dist/workspace/init.d.ts.map +1 -1
- package/dist/workspace/init.js +55 -9
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/nested-graph.d.ts.map +1 -1
- package/dist/workspace/nested-graph.js +2 -0
- package/dist/workspace/pr-report.schema.json +125 -5
- package/dist/workspace/promote-waves.d.ts +112 -0
- package/dist/workspace/promote-waves.d.ts.map +1 -0
- package/dist/workspace/promote-waves.js +290 -0
- package/dist/workspace/promote.d.ts +85 -3
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +349 -62
- package/dist/workspace/reason-codes.d.ts +12 -0
- package/dist/workspace/reason-codes.d.ts.map +1 -1
- package/dist/workspace/reason-codes.js +14 -0
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/search-contract.d.ts +3 -3
- package/dist/workspace/search-contract.d.ts.map +1 -1
- package/dist/workspace/search-contract.js +2 -0
- package/dist/workspace/search.schema.json +103 -5
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +34 -1
- package/src/__fixtures__/drift-record/README.md +58 -0
- package/src/__fixtures__/drift-record/choudoufu-cone.ndjson +4 -0
- package/src/__fixtures__/drift-record/choudoufu-resource.ndjson +3 -0
- package/src/__fixtures__/drift-record/component-status-ledger.json +65 -0
- package/src/__fixtures__/drift-record/component-status.json +91 -0
- package/src/__fixtures__/drift-record/deep-diff.json +259 -0
- package/src/__fixtures__/drift-record/lifecycle-diff-live.json +825 -0
- package/src/__fixtures__/drift-record/live-diff.json +125 -0
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/audit/discover.e2e.test.ts +14 -0
- package/src/audit/discover.ts +3 -1
- package/src/behaviour.ts +1 -1
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.json +145 -0
- package/src/capabilities/templates.test.ts +211 -0
- package/src/capabilities/templates.ts +203 -0
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +82 -0
- package/src/change-set-graph.ts +80 -9
- package/src/change-set.test.ts +24 -0
- package/src/change-set.ts +76 -14
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1026 -0
- package/src/ci-control.ts +174 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +176 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +55 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +29 -2
- package/src/ci-identity.ts +134 -26
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +536 -0
- package/src/ci-product.ts +174 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/import-index.test.ts +117 -0
- package/src/cli/commands/import-index.ts +265 -0
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/commands/lint.ts +4 -2
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +44 -1
- package/src/cli/handlers/ci-check.ts +33 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/components.test.ts +9 -0
- package/src/cli/handlers/components.ts +12 -2
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +22 -3
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/graph.test.ts +42 -0
- package/src/cli/handlers/graph.ts +26 -4
- package/src/cli/handlers/index-cloud.ts +32 -0
- package/src/cli/handlers/index-diff.test.ts +68 -0
- package/src/cli/handlers/index-diff.ts +146 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger-root-member.test.ts +161 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +73 -0
- package/src/cli/handlers/lifecycle.test.ts +33 -11
- package/src/cli/handlers/lifecycle.ts +205 -30
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/misc.ts +73 -0
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +42 -2
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +669 -207
- package/src/cli/handlers/promote.test.ts +69 -5
- package/src/cli/handlers/promote.ts +103 -8
- package/src/cli/handlers/query.ts +27 -4
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-declared-reads-cli.test.ts +187 -0
- package/src/cli/handlers/run-groups-cli.test.ts +229 -0
- package/src/cli/handlers/run-wave.ts +65 -1
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/scenario.test.ts +13 -0
- package/src/cli/handlers/scenario.ts +8 -7
- package/src/cli/handlers/search-index.test.ts +255 -0
- package/src/cli/handlers/search-json.test.ts +1 -1
- package/src/cli/handlers/search-ownership.test.ts +194 -0
- package/src/cli/handlers/search.ts +271 -38
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +7 -0
- package/src/cli/main.ts +182 -14
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/lifecycle-tools.ts +3 -2
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/resource-handlers.ts +4 -3
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp/workspace-tools.ts +1 -1
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +82 -4
- package/src/cli/registry.ts +54 -1
- package/src/cloud-lister/aws.test.ts +202 -0
- package/src/cloud-lister/aws.ts +226 -0
- package/src/cloud-lister/azure.test.ts +132 -0
- package/src/cloud-lister/azure.ts +142 -0
- package/src/cloud-lister/common.ts +115 -0
- package/src/cloud-lister/credentials.ts +110 -0
- package/src/cloud-lister/fakes.ts +66 -0
- package/src/cloud-lister/gcp.test.ts +121 -0
- package/src/cloud-lister/gcp.ts +159 -0
- package/src/cloud-lister/guard.test.ts +198 -0
- package/src/cloud-lister/guard.ts +111 -0
- package/src/cloud-lister/ids.ts +54 -0
- package/src/cloud-lister/index.ts +134 -0
- package/src/cloud-lister/kubernetes.test.ts +160 -0
- package/src/cloud-lister/kubernetes.ts +284 -0
- package/src/cloud-lister/markers.ts +74 -0
- package/src/cloud-lister/mask.ts +77 -0
- package/src/cloud-lister/shape.test.ts +81 -0
- package/src/cloud-lister/sigv4.ts +127 -0
- package/src/cloud-lister/transport.ts +118 -0
- package/src/cloud-lister/types.ts +135 -0
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +141 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability-plugin-loader.ts +4 -0
- package/src/components/capability-plugin.ts +10 -0
- package/src/components/capability.ts +359 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +252 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +83 -0
- package/src/components/cli-support.ts +92 -15
- package/src/components/declared-reads.test.ts +103 -0
- package/src/components/declared-reads.ts +134 -0
- package/src/components/deploy-units.ts +4 -0
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +127 -9
- package/src/components/fan-out-run.ts +163 -33
- package/src/components/fan-out-support.ts +10 -1
- package/src/components/fan-out.ts +30 -0
- package/src/components/groups.test.ts +320 -0
- package/src/components/groups.ts +895 -0
- package/src/components/index.ts +42 -0
- package/src/components/plan-shape-conformance.ts +130 -0
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +43 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +10 -0
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +39 -7
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +274 -9
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +516 -3
- package/src/components/pr-run.ts +350 -44
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +341 -0
- package/src/components/promote-rounds.ts +25 -2
- package/src/components/promote.ts +64 -5
- package/src/components/registry.test.ts +1 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-gate.ts +115 -30
- package/src/components/release-groups.test.ts +362 -0
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/run-groups.ts +113 -0
- package/src/components/starter-plugin.ts +6 -0
- package/src/components/verbs/index.ts +1 -0
- package/src/components/verbs/member-outputs.test.ts +205 -0
- package/src/components/verbs/member-outputs.ts +308 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +78 -4
- package/src/config.ts +44 -0
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/deep-observation.ts +5 -23
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/drift-record.test.ts +596 -0
- package/src/drift-record.ts +1206 -0
- package/src/engine-facts.guard.test.ts +111 -0
- package/src/engine-facts.test.ts +177 -0
- package/src/engine-facts.ts +153 -0
- package/src/exit-codes.test.ts +31 -0
- package/src/exit-codes.ts +55 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +13 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +1 -0
- package/src/graph-ir-live.test.ts +92 -0
- package/src/graph-ir.ts +317 -7
- package/src/graph-refs.ts +416 -0
- package/src/graph-schema/fixtures/adopt.json +15 -0
- package/src/graph-schema/fixtures/choudoufu.engine-graph.json +169 -0
- package/src/graph-schema/fixtures/index.json +68 -0
- package/src/graph-schema/fixtures/plunge.engine-graph.json +158 -0
- package/src/graph-schema/fixtures.ts +267 -0
- package/src/graph-schema/generate.ts +263 -0
- package/src/graph-schema/graph-schema.test.ts +153 -0
- package/src/graph-schema/graph.schema.json +1387 -0
- package/src/health.schema.json +2 -1
- package/src/identity.ts +2 -0
- package/src/index.ts +4 -0
- package/src/instance-nodes.ts +288 -0
- package/src/lexicon.ts +171 -6
- package/src/lifecycle/__fixtures__/index-diff/20261026T120000Z-aaaaaaaaaaaa.json +149 -0
- package/src/lifecycle/__fixtures__/index-diff/20261026T130000Z-bbbbbbbbbbbb.json +127 -0
- package/src/lifecycle/adoption-file.test.ts +100 -0
- package/src/lifecycle/adoption-file.ts +153 -0
- package/src/lifecycle/cloud-index.test.ts +516 -0
- package/src/lifecycle/cloud-index.ts +735 -0
- package/src/lifecycle/control-entries-ledger.test.ts +70 -0
- package/src/lifecycle/derive-edges.test.ts +193 -0
- package/src/lifecycle/derive-edges.ts +182 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +36 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +280 -0
- package/src/lifecycle/git.ts +10 -4
- package/src/lifecycle/identity-match.test.ts +308 -0
- package/src/lifecycle/identity-match.ts +276 -0
- package/src/lifecycle/index-diff.test.ts +198 -0
- package/src/lifecycle/index-diff.ts +475 -0
- package/src/lifecycle/index-document.test.ts +64 -0
- package/src/lifecycle/index-document.ts +298 -0
- package/src/lifecycle/index-drift.test.ts +191 -0
- package/src/lifecycle/index-drift.ts +304 -0
- package/src/lifecycle/index-import.test.ts +269 -0
- package/src/lifecycle/index-import.ts +654 -0
- package/src/lifecycle/index-join.test.ts +250 -0
- package/src/lifecycle/index-join.ts +304 -0
- package/src/lifecycle/index-store-load-bearing.test.ts +187 -0
- package/src/lifecycle/index.ts +4 -0
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/member-ledger.test.ts +25 -7
- package/src/lifecycle/observation-baseline.test.ts +72 -1
- package/src/lifecycle/observation-baseline.ts +190 -27
- package/src/lifecycle/observe.ts +6 -1
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +68 -1
- package/src/lifecycle/query.ts +208 -13
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +193 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +20 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +186 -0
- package/src/lifecycle/release-status.ts +176 -0
- package/src/lifecycle/replay.test.ts +9 -5
- package/src/lifecycle/replay.ts +9 -5
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/scenario.ts +4 -3
- package/src/lifecycle/snapshot-store-fake.ts +29 -0
- package/src/lifecycle/snapshot-store-s3.ts +280 -0
- package/src/lifecycle/snapshot-store.test.ts +385 -0
- package/src/lifecycle/snapshot-store.ts +980 -0
- package/src/lifecycle/snapshot.test.ts +13 -0
- package/src/lifecycle/snapshot.ts +23 -6
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/type-listing.test.ts +166 -0
- package/src/lifecycle/type-listing.ts +309 -0
- package/src/lint/component-checks.ts +17 -1
- package/src/lint/config.test.ts +3 -0
- package/src/lint/presets/relaxed.json +2 -1
- package/src/lint/presets/strict.json +2 -1
- package/src/lint/rules/__fixtures__/comp/comp008/fail/dns.component.ts +15 -0
- package/src/lint/rules/__fixtures__/comp/comp008/pass/dns.component.ts +10 -0
- package/src/lint/rules/comp/comp.test.ts +2 -1
- package/src/lint/rules/comp/comp008-applies-signal-only-root.ts +121 -0
- package/src/lint/rules/comp/comp008.test.ts +77 -0
- package/src/lint/rules/comp/index.ts +4 -1
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/observation-edges.test.ts +33 -0
- package/src/observation.ts +36 -1
- package/src/op/activities/activity-contracts.ts +1 -1
- package/src/op/activities/change-set.ts +8 -5
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/activity-failure.ts +36 -0
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -1
- package/src/op/local-executor.test.ts +80 -0
- package/src/op/local-executor.ts +27 -9
- package/src/op/op-waves-after-plan.test.ts +276 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +113 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-pull-request.test.ts +142 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +133 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1142 -49
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +108 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +261 -20
- package/src/op/runtime.ts +104 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +544 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +112 -0
- package/src/pr-forge.ts +123 -0
- package/src/pr-loop-bundle.test.ts +9 -2
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.test.ts +43 -0
- package/src/pr-loop.ts +478 -50
- package/src/pr-post.ts +32 -1
- package/src/pr-report-url.ts +62 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
- package/src/pulumi-urn.ts +151 -0
- package/src/release-floors.ts +22 -0
- package/src/run-event.ts +29 -1
- package/src/sensitive-key.ts +34 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +8 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/adoption-report.test.ts +61 -0
- package/src/workspace/adoption-report.ts +103 -0
- package/src/workspace/capabilities-contract.test.ts +4 -0
- package/src/workspace/capabilities-contract.ts +9 -1
- package/src/workspace/capabilities.schema.json +98 -0
- package/src/workspace/change-set.schema.json +42 -3
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-cloud-identity.ts +31 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +30 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +6 -3
- package/src/workspace/compose-graph.test.ts +12 -0
- package/src/workspace/compose-graph.ts +12 -1
- package/src/workspace/conformance/conformance.e2e.test.ts +2 -1
- package/src/workspace/conformance/index.ts +6 -1
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.test.ts +65 -0
- package/src/workspace/drift-cli.ts +370 -0
- package/src/workspace/drift.schema.json +672 -0
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/graph-cli.ts +5 -0
- package/src/workspace/graph.schema.json +72 -0
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/init.test.ts +38 -1
- package/src/workspace/init.ts +50 -8
- package/src/workspace/intent-gaps.test.ts +18 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/nested-graph.ts +1 -0
- package/src/workspace/pr-report.schema.json +125 -5
- package/src/workspace/promote-waves.test.ts +296 -0
- package/src/workspace/promote-waves.ts +340 -0
- package/src/workspace/promote.test.ts +158 -4
- package/src/workspace/promote.ts +400 -58
- package/src/workspace/reason-codes.test.ts +4 -1
- package/src/workspace/reason-codes.ts +14 -0
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/search-contract.ts +2 -0
- package/src/workspace/search.schema.json +103 -5
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,374 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Azure Blob Storage for reports, products and an azurerm backend's state,
|
|
3
|
+
* over its REST API with `fetch` and `node:crypto`: put a block blob, get
|
|
4
|
+
* one, and a SAS link to one; for a state, a blob's properties and
|
|
5
|
+
* metadata, one version or snapshot of it, a snapshot, and the blob lease
|
|
6
|
+
* the backend locks a state with.
|
|
7
|
+
*
|
|
8
|
+
* With the job's Azure OIDC identity (the ARM_* variables a job's OIDC
|
|
9
|
+
* setup sets), the token in ARM_OIDC_TOKEN_FILE_PATH is traded at
|
|
10
|
+
* Entra ID for a storage token (a client assertion, the way the azurerm
|
|
11
|
+
* backend does it), and a link is a user delegation SAS signed with a key
|
|
12
|
+
* the identity asks the account for. With an account key
|
|
13
|
+
* (AZURE_STORAGE_KEY), requests are signed with Shared Key and a link is a
|
|
14
|
+
* service SAS. Both SAS kinds read one blob and nothing else. An azurerm
|
|
15
|
+
* backend's `sas_token` (ARM_SAS_TOKEN) rides on each request as it is.
|
|
16
|
+
*
|
|
17
|
+
* Writes are conditional the way S3's are: If-Match the ETag read, or
|
|
18
|
+
* If-None-Match `*` when there was none. Azure answers a lost write with 412
|
|
19
|
+
* (the ETag moved) or 409 (the blob appeared).
|
|
20
|
+
*/
|
|
21
|
+
import { createHmac } from "node:crypto";
|
|
22
|
+
import { readFileSync } from "node:fs";
|
|
23
|
+
import { defaultFetch, encodePath, isoSeconds, PRESIGN_MAX_SECONDS, StoreConflict, StoreError, xmlBlocks, xmlText, type ObjectStore, type ObjectVersion, type StoreCondition, type StoreFetch, type StoreHints } from "./common";
|
|
24
|
+
|
|
25
|
+
/** The REST version every request names, and the SAS version: the 2020-12-06 string-to-sign layouts. */
|
|
26
|
+
export const AZURE_VERSION = "2021-08-06";
|
|
27
|
+
|
|
28
|
+
/** Entra ID's public cloud; AZURE_AUTHORITY_HOST names a sovereign cloud's. */
|
|
29
|
+
export const AZURE_AUTHORITY = "https://login.microsoftonline.com";
|
|
30
|
+
|
|
31
|
+
const STORAGE_SCOPE = "https://storage.azure.com/.default";
|
|
32
|
+
|
|
33
|
+
export interface AzureLocation {
|
|
34
|
+
account: string;
|
|
35
|
+
container: string;
|
|
36
|
+
/** The account's blob endpoint, no trailing slash: https://<account>.blob.core.windows.net, or an emulator's http://host:10000/<account>. */
|
|
37
|
+
endpoint: string;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** The job's federated identity: an Entra app or managed identity that trusts the forge's token. */
|
|
41
|
+
export interface AzureOidc {
|
|
42
|
+
tenantId: string;
|
|
43
|
+
clientId: string;
|
|
44
|
+
tokenFile: string;
|
|
45
|
+
/** Entra ID's address, https://host, no path. */
|
|
46
|
+
authority: string;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export type AzureTarget = AzureLocation & ({ accountKey: string } | { oidc: AzureOidc } | { sas: string });
|
|
50
|
+
|
|
51
|
+
/** A blob's properties, as a HEAD answers them: never its body. */
|
|
52
|
+
export interface BlobHead {
|
|
53
|
+
exists: boolean;
|
|
54
|
+
etag?: string;
|
|
55
|
+
/** x-ms-version-id: the account keeps each version of the blob. */
|
|
56
|
+
versionId?: string;
|
|
57
|
+
/** x-ms-lease-state: `leased` while a lease holds it. */
|
|
58
|
+
leaseState?: string;
|
|
59
|
+
/** Its metadata, by name without the x-ms-meta- prefix. */
|
|
60
|
+
metadata: Record<string, string>;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** Which earlier state of a blob: a version (blob versioning) or a snapshot. */
|
|
64
|
+
export type BlobAt = { versionid: string } | { snapshot: string };
|
|
65
|
+
|
|
66
|
+
/** The target from where the store is and the job's environment. An account key wins over the job's OIDC identity. `setting` names the container in messages, such as `reports.bucket`. */
|
|
67
|
+
export function azureFromEnv(where: { account: string; container: string; endpoint?: string; setting?: string; hints?: StoreHints }, env: NodeJS.ProcessEnv = process.env): AzureTarget {
|
|
68
|
+
const at: AzureLocation = { account: where.account, container: where.container, endpoint: (where.endpoint ?? `https://${where.account}.blob.core.windows.net`).replace(/\/+$/, "") };
|
|
69
|
+
if (env.AZURE_STORAGE_KEY) return { ...at, accountKey: env.AZURE_STORAGE_KEY };
|
|
70
|
+
const tenantId = env.ARM_TENANT_ID;
|
|
71
|
+
const clientId = env.ARM_CLIENT_ID;
|
|
72
|
+
const tokenFile = env.ARM_OIDC_TOKEN_FILE_PATH;
|
|
73
|
+
if (tenantId && clientId && tokenFile) return { ...at, oidc: { tenantId, clientId, tokenFile, authority: (env.AZURE_AUTHORITY_HOST || AZURE_AUTHORITY).replace(/\/+$/, "") } };
|
|
74
|
+
throw new StoreError(`${where.setting ?? "the container"} is az://${where.account}/${where.container}, but the job has no credentials for it: ${where.hints?.azure ? `give the job ${where.hints.azure} (it sets ARM_TENANT_ID, ARM_CLIENT_ID and ARM_OIDC_TOKEN_FILE_PATH), or set AZURE_STORAGE_KEY` : "set ARM_TENANT_ID, ARM_CLIENT_ID and ARM_OIDC_TOKEN_FILE_PATH (a job's OIDC setup sets them), or AZURE_STORAGE_KEY"}`);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
const hmac64 = (key: string, s: string): string => createHmac("sha256", Buffer.from(key, "base64")).update(s, "utf8").digest("base64");
|
|
78
|
+
|
|
79
|
+
/** The headers whose values Shared Key signs by position, in order. */
|
|
80
|
+
const SIGNED = ["content-encoding", "content-language", "content-length", "content-md5", "content-type", "date", "if-modified-since", "if-match", "if-none-match", "if-unmodified-since", "range"];
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* The Shared Key Authorization header for a request. The resource is the
|
|
84
|
+
* account and the URL's path (an emulator's path, which starts with the
|
|
85
|
+
* account, too), then each query parameter on its own line.
|
|
86
|
+
*/
|
|
87
|
+
export function sharedKey(account: string, accountKey: string, method: string, rawUrl: string, headers: Record<string, string>): string {
|
|
88
|
+
const url = new URL(rawUrl);
|
|
89
|
+
const h = Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v]));
|
|
90
|
+
const fixed = SIGNED.map((n) => (n === "content-length" && h[n] === "0" ? "" : (h[n] ?? "")));
|
|
91
|
+
const ms = Object.keys(h).filter((n) => n.startsWith("x-ms-")).sort().map((n) => `${n}:${h[n].trim()}\n`).join("");
|
|
92
|
+
const params = new Map<string, string[]>();
|
|
93
|
+
for (const [k, v] of url.searchParams) params.set(k.toLowerCase(), [...(params.get(k.toLowerCase()) ?? []), v]);
|
|
94
|
+
const query = [...params.keys()].sort().map((k) => `\n${k}:${params.get(k)!.sort().join(",")}`).join("");
|
|
95
|
+
const toSign = [method, ...fixed].join("\n") + "\n" + ms + `/${account}${url.pathname}` + query;
|
|
96
|
+
return `SharedKey ${account}:${hmac64(accountKey, toSign)}`;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** A user delegation key, as Get User Delegation Key answers it. */
|
|
100
|
+
export interface DelegationKey {
|
|
101
|
+
oid: string;
|
|
102
|
+
tid: string;
|
|
103
|
+
start: string;
|
|
104
|
+
expiry: string;
|
|
105
|
+
service: string;
|
|
106
|
+
version: string;
|
|
107
|
+
value: string;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/** The query of a read-only SAS for one blob: a user delegation SAS with `key`, else a service SAS signed with the account key. */
|
|
111
|
+
export function blobSas(t: AzureLocation, blob: string, expiry: Date, sign: { accountKey: string } | { key: DelegationKey }): string {
|
|
112
|
+
const se = isoSeconds(expiry);
|
|
113
|
+
const spr = t.endpoint.startsWith("https:") ? "https" : "";
|
|
114
|
+
const resource = `/blob/${t.account}/${t.container}/${blob}`;
|
|
115
|
+
const tail = [spr, AZURE_VERSION, "b", "", "", "", "", "", "", ""];
|
|
116
|
+
let toSign: string;
|
|
117
|
+
let params: [string, string][];
|
|
118
|
+
if ("key" in sign) {
|
|
119
|
+
const k = sign.key;
|
|
120
|
+
toSign = ["r", "", se, resource, k.oid, k.tid, k.start, k.expiry, k.service, k.version, "", "", "", "", ...tail].join("\n");
|
|
121
|
+
params = [["skoid", k.oid], ["sktid", k.tid], ["skt", k.start], ["ske", k.expiry], ["sks", k.service], ["skv", k.version]];
|
|
122
|
+
} else {
|
|
123
|
+
toSign = ["r", "", se, resource, "", "", ...tail].join("\n");
|
|
124
|
+
params = [];
|
|
125
|
+
}
|
|
126
|
+
const sig = hmac64("key" in sign ? sign.key.value : sign.accountKey, toSign);
|
|
127
|
+
const q = new URLSearchParams([["sv", AZURE_VERSION], ["sr", "b"], ["sp", "r"], ["se", se], ...(spr ? [["spr", spr] as [string, string]] : []), ...params, ["sig", sig]]);
|
|
128
|
+
return q.toString();
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/** Entra ID's error, or the start of the body. */
|
|
132
|
+
const why = (text: string): string => {
|
|
133
|
+
try {
|
|
134
|
+
const j = JSON.parse(text) as { error?: string; error_description?: string };
|
|
135
|
+
if (j.error) return [j.error, j.error_description?.split("\r\n")[0]].filter(Boolean).join(": ");
|
|
136
|
+
} catch {
|
|
137
|
+
// Not JSON: Blob Storage answers in XML.
|
|
138
|
+
}
|
|
139
|
+
return [xmlText(text, "Code"), xmlText(text, "Message")?.split("\n")[0]].filter(Boolean).join(": ") || text.slice(0, 300);
|
|
140
|
+
};
|
|
141
|
+
|
|
142
|
+
export class AzureBlobClient implements ObjectStore {
|
|
143
|
+
private token?: Promise<{ token: string; expires: number }>;
|
|
144
|
+
private keys = new Map<string, Promise<DelegationKey>>();
|
|
145
|
+
|
|
146
|
+
constructor(readonly target: AzureTarget, private readonly fetchFn: StoreFetch = defaultFetch, private readonly readToken: (file: string) => string = (f) => readFileSync(f, "utf-8")) {}
|
|
147
|
+
|
|
148
|
+
get location(): string {
|
|
149
|
+
return `az://${this.target.account}/${this.target.container}`;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
private blobUrl(key: string, query = ""): string {
|
|
153
|
+
const t = this.target;
|
|
154
|
+
const q = [query, "sas" in t ? t.sas.replace(/^\?/, "") : ""].filter(Boolean).join("&");
|
|
155
|
+
return `${t.endpoint}/${t.container}/${encodePath(key)}${q ? `?${q}` : ""}`;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/** The storage token for the OIDC identity: once per client, again a minute before it expires. */
|
|
159
|
+
private async bearer(o: AzureOidc): Promise<string> {
|
|
160
|
+
const fetchToken = async (): Promise<{ token: string; expires: number }> => {
|
|
161
|
+
let assertion: string;
|
|
162
|
+
try {
|
|
163
|
+
assertion = this.readToken(o.tokenFile).trim();
|
|
164
|
+
} catch (e) {
|
|
165
|
+
throw new StoreError(`cannot read the OIDC token in ${o.tokenFile}: ${(e as Error).message}`);
|
|
166
|
+
}
|
|
167
|
+
if (!assertion) throw new StoreError(`the OIDC token file ${o.tokenFile} is empty`);
|
|
168
|
+
const body = new URLSearchParams({
|
|
169
|
+
client_id: o.clientId,
|
|
170
|
+
scope: STORAGE_SCOPE,
|
|
171
|
+
grant_type: "client_credentials",
|
|
172
|
+
client_assertion_type: "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
|
|
173
|
+
client_assertion: assertion,
|
|
174
|
+
}).toString();
|
|
175
|
+
const res = await this.fetchFn(`${o.authority}/${o.tenantId}/oauth2/v2.0/token`, { method: "POST", headers: { "content-type": "application/x-www-form-urlencoded" }, body });
|
|
176
|
+
const text = await res.text();
|
|
177
|
+
if (!res.ok) throw new StoreError(`Entra ID refused the OIDC token for client ${o.clientId}: ${res.status} ${why(text)}`);
|
|
178
|
+
let j: { access_token?: string; expires_in?: number | string } = {};
|
|
179
|
+
try {
|
|
180
|
+
j = JSON.parse(text) as typeof j;
|
|
181
|
+
} catch {
|
|
182
|
+
// Reported below as no token.
|
|
183
|
+
}
|
|
184
|
+
if (!j.access_token) throw new StoreError(`Entra ID answered client ${o.clientId} without a token`);
|
|
185
|
+
return { token: j.access_token, expires: Date.now() + Number(j.expires_in ?? 3600) * 1000 };
|
|
186
|
+
};
|
|
187
|
+
const again = (): Promise<{ token: string; expires: number }> =>
|
|
188
|
+
(this.token = fetchToken().catch((e: unknown) => {
|
|
189
|
+
this.token = undefined;
|
|
190
|
+
throw e;
|
|
191
|
+
}));
|
|
192
|
+
let held = await (this.token ?? again());
|
|
193
|
+
if (held.expires - Date.now() < 60_000) held = await again();
|
|
194
|
+
return held.token;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
/** The headers for one request, signed or with the bearer token. */
|
|
198
|
+
private async headers(method: string, url: string, extra: Record<string, string>): Promise<Record<string, string>> {
|
|
199
|
+
const h: Record<string, string> = { "x-ms-date": new Date().toUTCString(), "x-ms-version": AZURE_VERSION, ...extra };
|
|
200
|
+
const t = this.target;
|
|
201
|
+
if ("accountKey" in t) return { ...h, authorization: sharedKey(t.account, t.accountKey, method, url, h) };
|
|
202
|
+
if ("sas" in t) return h;
|
|
203
|
+
return { ...h, authorization: `Bearer ${await this.bearer(t.oidc)}` };
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
async put(key: string, body: string | Uint8Array, contentType: string, when?: StoreCondition): Promise<{ etag?: string }> {
|
|
207
|
+
const url = this.blobUrl(key);
|
|
208
|
+
const cond: Record<string, string> = !when ? {} : "ifMatch" in when ? { "if-match": when.ifMatch } : { "if-none-match": "*" };
|
|
209
|
+
const length = typeof body === "string" ? Buffer.byteLength(body) : body.byteLength;
|
|
210
|
+
const headers = await this.headers("PUT", url, { "x-ms-blob-type": "BlockBlob", "content-type": contentType, "content-length": String(length), ...cond });
|
|
211
|
+
const res = await this.fetchFn(url, { method: "PUT", headers, body });
|
|
212
|
+
if (res.status === 412 || (res.status === 409 && when)) throw new StoreConflict(`PUT ${this.location}/${key}: ${res.status}, it changed since it was read`);
|
|
213
|
+
if (!res.ok) throw new StoreError(`PUT ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
214
|
+
const etag = res.headers?.get("etag") ?? undefined;
|
|
215
|
+
return etag ? { etag } : {};
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
async read(key: string): Promise<{ body?: string; etag?: string }> {
|
|
219
|
+
const url = this.blobUrl(key);
|
|
220
|
+
const res = await this.fetchFn(url, { method: "GET", headers: await this.headers("GET", url, {}) });
|
|
221
|
+
if (res.status === 404) return {};
|
|
222
|
+
if (!res.ok) throw new StoreError(`GET ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
223
|
+
const etag = res.headers?.get("etag") ?? undefined;
|
|
224
|
+
return { body: await res.text(), ...(etag ? { etag } : {}) };
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
async get(key: string): Promise<string | undefined> {
|
|
228
|
+
return (await this.read(key)).body;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/** A blob's properties and metadata, from a HEAD: of the blob, or of one version or snapshot of it. */
|
|
232
|
+
async head(key: string, at?: BlobAt): Promise<BlobHead> {
|
|
233
|
+
const url = this.blobUrl(key, at ? new URLSearchParams(at as Record<string, string>).toString() : "");
|
|
234
|
+
const res = await this.fetchFn(url, { method: "HEAD", headers: await this.headers("HEAD", url, {}) });
|
|
235
|
+
// A HEAD has no body to say why: an id Azure never issued is a 400.
|
|
236
|
+
if (res.status === 404 || (at && res.status === 400)) return { exists: false, metadata: {} };
|
|
237
|
+
if (!res.ok) throw new StoreError(`HEAD ${this.location}/${key}: ${res.status}`);
|
|
238
|
+
const get = (n: string): string | undefined => res.headers?.get(n) ?? undefined;
|
|
239
|
+
const metadata: Record<string, string> = {};
|
|
240
|
+
const all = res.headers as unknown as { forEach?: (fn: (v: string, k: string) => void) => void } | undefined;
|
|
241
|
+
all?.forEach?.((v, k) => {
|
|
242
|
+
if (k.toLowerCase().startsWith("x-ms-meta-")) metadata[k.toLowerCase().slice("x-ms-meta-".length)] = v;
|
|
243
|
+
});
|
|
244
|
+
const etag = get("etag");
|
|
245
|
+
const versionId = get("x-ms-version-id");
|
|
246
|
+
const leaseState = get("x-ms-lease-state");
|
|
247
|
+
return { exists: true, ...(etag ? { etag } : {}), ...(versionId ? { versionId } : {}), ...(leaseState ? { leaseState } : {}), metadata };
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
/** One version or snapshot of a blob's text; undefined when there is none such. */
|
|
251
|
+
async readAt(key: string, at: BlobAt): Promise<string | undefined> {
|
|
252
|
+
const url = this.blobUrl(key, new URLSearchParams(at as Record<string, string>).toString());
|
|
253
|
+
const res = await this.fetchFn(url, { method: "GET", headers: await this.headers("GET", url, {}) });
|
|
254
|
+
if (res.status === 404 || res.status === 400) return undefined;
|
|
255
|
+
if (!res.ok) throw new StoreError(`GET ${this.location}/${key} ${JSON.stringify(at)}: ${res.status} ${why(await res.text())}`);
|
|
256
|
+
return res.text();
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
/**
|
|
260
|
+
* Every version the account keeps of one blob, from List Blobs with
|
|
261
|
+
* `include=versions`: each one's version id, its Last-Modified and whether
|
|
262
|
+
* it is the current version. A blob with no version id (blob versioning
|
|
263
|
+
* off) lists nothing. Metadata only; it needs the container's list
|
|
264
|
+
* permission.
|
|
265
|
+
*/
|
|
266
|
+
async listVersions(key: string): Promise<ObjectVersion[]> {
|
|
267
|
+
const t = this.target;
|
|
268
|
+
const out: ObjectVersion[] = [];
|
|
269
|
+
let marker: string | undefined;
|
|
270
|
+
for (let page = 0; page < 1000; page++) {
|
|
271
|
+
const q = ["restype=container", "comp=list", "include=versions", `prefix=${encodeURIComponent(key)}`, ...(marker ? [`marker=${encodeURIComponent(marker)}`] : []), ...("sas" in t ? [t.sas.replace(/^\?/, "")] : [])].join("&");
|
|
272
|
+
const url = `${t.endpoint}/${t.container}?${q}`;
|
|
273
|
+
const res = await this.fetchFn(url, { method: "GET", headers: await this.headers("GET", url, {}) });
|
|
274
|
+
const xml = await res.text();
|
|
275
|
+
if (!res.ok) throw new StoreError(`list the versions of ${this.location}/${key}: ${res.status} ${why(xml)}`);
|
|
276
|
+
for (const b of xmlBlocks(xml, "Blob")) {
|
|
277
|
+
const id = xmlText(b, "VersionId");
|
|
278
|
+
const when = xmlText(b, "Last-Modified");
|
|
279
|
+
// The prefix lists any blob whose name starts with this one: only the blob itself counts.
|
|
280
|
+
if (xmlText(b, "Name") !== key || !id || !when) continue;
|
|
281
|
+
out.push({ version_id: id, written_at: new Date(when).toISOString(), latest: xmlText(b, "IsCurrentVersion") === "true" });
|
|
282
|
+
}
|
|
283
|
+
marker = xmlText(xml, "NextMarker") || undefined;
|
|
284
|
+
if (!marker) break;
|
|
285
|
+
}
|
|
286
|
+
return out.sort((a, b) => Date.parse(b.written_at) - Date.parse(a.written_at));
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
/** Take a snapshot of a blob: its id, the time Azure gives it. */
|
|
290
|
+
async snapshot(key: string): Promise<string> {
|
|
291
|
+
const url = this.blobUrl(key, "comp=snapshot");
|
|
292
|
+
const res = await this.fetchFn(url, { method: "PUT", headers: await this.headers("PUT", url, { "content-length": "0" }) });
|
|
293
|
+
if (!res.ok) throw new StoreError(`snapshot of ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
294
|
+
const id = res.headers?.get("x-ms-snapshot");
|
|
295
|
+
if (!id) throw new StoreError(`snapshot of ${this.location}/${key}: Azure answered without x-ms-snapshot`);
|
|
296
|
+
return id;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/** Write a block blob with metadata, under a lease when one holds it. */
|
|
300
|
+
async putBlob(key: string, body: string, contentType: string, options: { leaseId?: string; metadata?: Record<string, string>; ifNoneMatch?: boolean } = {}): Promise<boolean> {
|
|
301
|
+
const url = this.blobUrl(key);
|
|
302
|
+
const meta = Object.fromEntries(Object.entries(options.metadata ?? {}).map(([k, v]) => [`x-ms-meta-${k}`, v]));
|
|
303
|
+
const extra: Record<string, string> = {
|
|
304
|
+
"x-ms-blob-type": "BlockBlob",
|
|
305
|
+
"content-type": contentType,
|
|
306
|
+
"content-length": String(Buffer.byteLength(body)),
|
|
307
|
+
...meta,
|
|
308
|
+
...(options.leaseId ? { "x-ms-lease-id": options.leaseId } : {}),
|
|
309
|
+
...(options.ifNoneMatch ? { "if-none-match": "*" } : {}),
|
|
310
|
+
};
|
|
311
|
+
const res = await this.fetchFn(url, { method: "PUT", headers: await this.headers("PUT", url, extra), body });
|
|
312
|
+
if (options.ifNoneMatch && (res.status === 409 || res.status === 412)) return false;
|
|
313
|
+
if (!res.ok) throw new StoreError(`PUT ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
314
|
+
return true;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/** A blob lease: acquire one that never expires with the id given (false when one holds it), or release it. */
|
|
318
|
+
async lease(key: string, action: "acquire" | "release", id: string): Promise<boolean> {
|
|
319
|
+
const url = this.blobUrl(key, "comp=lease");
|
|
320
|
+
const extra: Record<string, string> = { "x-ms-lease-action": action, "content-length": "0", ...(action === "acquire" ? { "x-ms-lease-duration": "-1", "x-ms-proposed-lease-id": id } : { "x-ms-lease-id": id }) };
|
|
321
|
+
const res = await this.fetchFn(url, { method: "PUT", headers: await this.headers("PUT", url, extra) });
|
|
322
|
+
if (action === "acquire" && res.status === 409) return false;
|
|
323
|
+
if (!res.ok) throw new StoreError(`${action} the lease of ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
324
|
+
return true;
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
/** Set a blob's metadata, all of it, under its lease when one holds it. */
|
|
328
|
+
async setMetadata(key: string, metadata: Record<string, string>, leaseId?: string): Promise<void> {
|
|
329
|
+
const url = this.blobUrl(key, "comp=metadata");
|
|
330
|
+
const extra = { "content-length": "0", ...Object.fromEntries(Object.entries(metadata).map(([k, v]) => [`x-ms-meta-${k}`, v])), ...(leaseId ? { "x-ms-lease-id": leaseId } : {}) };
|
|
331
|
+
const res = await this.fetchFn(url, { method: "PUT", headers: await this.headers("PUT", url, extra) });
|
|
332
|
+
if (!res.ok) throw new StoreError(`set the metadata of ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
/** Get User Delegation Key, valid from now until `expiry`: one per expiry, so the estate's one link asks once. */
|
|
336
|
+
private delegationKey(now: Date, expiry: Date): Promise<DelegationKey> {
|
|
337
|
+
const id = isoSeconds(expiry);
|
|
338
|
+
let k = this.keys.get(id);
|
|
339
|
+
if (!k) {
|
|
340
|
+
k = (async () => {
|
|
341
|
+
const url = `${this.target.endpoint}/?restype=service&comp=userdelegationkey`;
|
|
342
|
+
const body = `<?xml version="1.0" encoding="utf-8"?><KeyInfo><Start>${isoSeconds(now)}</Start><Expiry>${id}</Expiry></KeyInfo>`;
|
|
343
|
+
const res = await this.fetchFn(url, { method: "POST", headers: await this.headers("POST", url, { "content-type": "application/xml" }), body });
|
|
344
|
+
const xml = await res.text();
|
|
345
|
+
if (!res.ok) throw new StoreError(`Get User Delegation Key on ${this.target.account}: ${res.status} ${why(xml)}`);
|
|
346
|
+
const f = (tag: string): string => {
|
|
347
|
+
const v = xmlText(xml, tag);
|
|
348
|
+
if (!v) throw new StoreError(`Get User Delegation Key on ${this.target.account} answered without ${tag}`);
|
|
349
|
+
return v;
|
|
350
|
+
};
|
|
351
|
+
return { oid: f("SignedOid"), tid: f("SignedTid"), start: f("SignedStart"), expiry: f("SignedExpiry"), service: f("SignedService"), version: f("SignedVersion"), value: f("Value") };
|
|
352
|
+
})();
|
|
353
|
+
k.catch(() => this.keys.delete(id));
|
|
354
|
+
this.keys.set(id, k);
|
|
355
|
+
}
|
|
356
|
+
return k;
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
/** Delete a blob. One that is not there is deleted already. */
|
|
360
|
+
async remove(key: string): Promise<void> {
|
|
361
|
+
const url = this.blobUrl(key);
|
|
362
|
+
const res = await this.fetchFn(url, { method: "DELETE", headers: await this.headers("DELETE", url, {}) });
|
|
363
|
+
if (!res.ok && res.status !== 404) throw new StoreError(`DELETE ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
/** A read-only SAS link to `key` for `seconds`. */
|
|
367
|
+
async presign(key: string, seconds: number, now = new Date()): Promise<{ url: string; expires: Date }> {
|
|
368
|
+
if (!Number.isInteger(seconds) || seconds < 1 || seconds > PRESIGN_MAX_SECONDS) throw new StoreError(`a SAS link lives 1 to ${PRESIGN_MAX_SECONDS} seconds, not ${seconds}`);
|
|
369
|
+
const expires = new Date(Math.floor(now.getTime() / 1000) * 1000 + seconds * 1000);
|
|
370
|
+
const t = this.target;
|
|
371
|
+
const sas = blobSas(t, key, expires, "accountKey" in t ? { accountKey: t.accountKey } : { key: await this.delegationKey(now, expires) });
|
|
372
|
+
return { url: `${this.blobUrl(key)}?${sas}`, expires };
|
|
373
|
+
}
|
|
374
|
+
}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Object stores in chant core (#4554): one client per cloud for S3 (and
|
|
3
|
+
* S3-compatible stores, ./s3.ts), Google Cloud Storage's JSON API (./gcs.ts)
|
|
4
|
+
* and Azure Blob Storage (./azure-blob.ts), shared by the products, the
|
|
5
|
+
* report URLs (../pr-report-url.ts) and the terraform lexicon's state
|
|
6
|
+
* clients. A bucket URL names the store by its scheme, and ./from-env.ts
|
|
7
|
+
* makes the client from it and the job's environment.
|
|
8
|
+
*
|
|
9
|
+
* Lifted from terragucci's report/object-store.ts, s3.ts, gcs.ts,
|
|
10
|
+
* azure-blob.ts and bucket.ts (INTENTIUS/terragucci e962b2c), so terragucci
|
|
11
|
+
* deletes its copies (terragucci#1282). The S3 client signs through chant's
|
|
12
|
+
* one AWS signer (../cloud-lister/sigv4.ts).
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { CLOUD_TARGETS_ENV, readTargetsFile, type IdentityCloud } from "../ci-identity";
|
|
16
|
+
|
|
17
|
+
export type StoreFetch = (url: string, init: { method: string; headers: Record<string, string>; body?: string | Uint8Array }) => Promise<{
|
|
18
|
+
ok: boolean;
|
|
19
|
+
status: number;
|
|
20
|
+
text(): Promise<string>;
|
|
21
|
+
/** A store that sends no headers (or a test's fake) gets no conditional writes. */
|
|
22
|
+
headers?: { get(name: string): string | null };
|
|
23
|
+
}>;
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* The product keys that fix a setup error (#4584), for a product that has
|
|
27
|
+
* them: terragucci passes `{ oidc: "oidc", gcp: "oidc.gcp", azure: "oidc.azure" }`.
|
|
28
|
+
* Each key a message can name is left out of chant's own wording when unset.
|
|
29
|
+
*/
|
|
30
|
+
export interface StoreHints {
|
|
31
|
+
/** The key that gives the job an OIDC identity for AWS, such as `oidc`. */
|
|
32
|
+
oidc?: string;
|
|
33
|
+
/** The key that gives the job a Google credentials file, such as `oidc.gcp`. */
|
|
34
|
+
gcp?: string;
|
|
35
|
+
/** The key that gives the job an Azure federated identity, such as `oidc.azure`. */
|
|
36
|
+
azure?: string;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// The errors and write conditions live in ./errors.ts, which imports nothing (chant#4589).
|
|
40
|
+
export { StoreError, StoreConflict, isStoreConflict, type StoreCondition } from "./errors";
|
|
41
|
+
import { StoreError, type StoreCondition } from "./errors";
|
|
42
|
+
|
|
43
|
+
export interface ObjectStore {
|
|
44
|
+
/** `s3://<bucket>`, `gs://<bucket>` or `az://<account>/<container>`, for messages. */
|
|
45
|
+
readonly location: string;
|
|
46
|
+
/** Write an object; with `when`, only if it still holds, else StoreConflict. The answer carries the new version when the store sends one. */
|
|
47
|
+
put(key: string, body: string | Uint8Array, contentType: string, when?: StoreCondition): Promise<{ etag?: string }>;
|
|
48
|
+
/** The object's text and version, or no text when there is none. */
|
|
49
|
+
read(key: string): Promise<{ body?: string; etag?: string }>;
|
|
50
|
+
get(key: string): Promise<string | undefined>;
|
|
51
|
+
/** A link that reads `key` for `seconds` (a presigned URL, a signed URL, a SAS), and when it stops working. */
|
|
52
|
+
presign(key: string, seconds: number, now?: Date): Promise<{ url: string; expires: Date }>;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** The longest a link lives: seven days, the limit of S3, GCS and a user delegation SAS alike. */
|
|
56
|
+
export const PRESIGN_MAX_SECONDS = 7 * 24 * 3600;
|
|
57
|
+
|
|
58
|
+
export type BucketRef = { kind: "s3"; bucket: string } | { kind: "gcs"; bucket: string } | { kind: "azure"; account: string; container: string };
|
|
59
|
+
|
|
60
|
+
/** `s3://<bucket>` or a bare bucket name, `gs://<bucket>`, or `az://<account>/<container>`. `setting` names the value in the error. */
|
|
61
|
+
export function parseBucketUrl(url: string, setting = "the bucket"): BucketRef {
|
|
62
|
+
const u = url.trim().replace(/\/+$/, "");
|
|
63
|
+
let m = /^gs:\/\/([a-z0-9][a-z0-9._-]{1,221}[a-z0-9])$/.exec(u);
|
|
64
|
+
if (m) return { kind: "gcs", bucket: m[1] };
|
|
65
|
+
m = /^az:\/\/([a-z0-9]{3,24})\/([a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){2,62})$/.exec(u);
|
|
66
|
+
if (m) return { kind: "azure", account: m[1], container: m[2] };
|
|
67
|
+
m = /^(?:s3:\/\/)?([^/:\s]+)$/.exec(u);
|
|
68
|
+
if (m) return { kind: "s3", bucket: m[1] };
|
|
69
|
+
throw new StoreError(`${setting} must be s3://<bucket>, gs://<bucket> or az://<account>/<container>, not ${url}`);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
export const bucketUrl = (b: BucketRef): string => (b.kind === "azure" ? `az://${b.account}/${b.container}` : `${b.kind === "gcs" ? "gs" : "s3"}://${b.bucket}`);
|
|
73
|
+
|
|
74
|
+
/** A key as a URL path: each segment percent-encoded the strict way (RFC 3986), the slashes kept. */
|
|
75
|
+
export const encodePath = (key: string): string => key.split("/").map(encodeStrict).join("/");
|
|
76
|
+
|
|
77
|
+
export const encodeStrict = (v: string): string => encodeURIComponent(v).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
|
|
78
|
+
|
|
79
|
+
/** The first value of an XML element, unescaped. Enough for the small answers these stores send. */
|
|
80
|
+
export const xmlText = (xml: string, tag: string): string | undefined => {
|
|
81
|
+
const m = new RegExp(`<${tag}>([^<]*)</${tag}>`).exec(xml);
|
|
82
|
+
return m?.[1]!.replace(/</g, "<").replace(/>/g, ">").replace(/"/g, '"').replace(/'/g, "'").replace(/&/g, "&").trim();
|
|
83
|
+
};
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* One version of an object, as the store's list of the object's versions
|
|
87
|
+
* names it: its id, when it was written, whether it is the one the store
|
|
88
|
+
* serves now, and, on S3, whether it is a delete marker. Metadata only.
|
|
89
|
+
*/
|
|
90
|
+
export interface ObjectVersion {
|
|
91
|
+
version_id: string;
|
|
92
|
+
written_at: string;
|
|
93
|
+
latest: boolean;
|
|
94
|
+
deleted?: boolean;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/** Each block of an XML element in a list answer, such as every `<Version>` in a ListObjectVersions page. */
|
|
98
|
+
export const xmlBlocks = (xml: string, tag: string): string[] => [...xml.matchAll(new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`, "g"))].map((m) => m[1]!);
|
|
99
|
+
|
|
100
|
+
/** A time as the stores write it in a query: `2026-10-07T12:00:00Z`, no milliseconds. */
|
|
101
|
+
export const isoSeconds = (d: Date): string => d.toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
102
|
+
|
|
103
|
+
/** The global fetch, as a StoreFetch. */
|
|
104
|
+
export const defaultFetch: StoreFetch = (url, init) => fetch(url, init as RequestInit);
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* The variables the job's OIDC trade left for identity `id` of `cloud` in
|
|
108
|
+
* the {@link CLOUD_TARGETS_ENV} file (../ci-identity.ts), or undefined when
|
|
109
|
+
* the job has no such file. Refused when the file has none for `id`.
|
|
110
|
+
*/
|
|
111
|
+
export function tradedVars(env: NodeJS.ProcessEnv, cloud: IdentityCloud, id: string): Record<string, string> | undefined {
|
|
112
|
+
const path = env[CLOUD_TARGETS_ENV];
|
|
113
|
+
if (!path) return undefined;
|
|
114
|
+
let vars: Record<string, string> | undefined;
|
|
115
|
+
try {
|
|
116
|
+
vars = readTargetsFile(path).clouds[cloud]?.vars[id];
|
|
117
|
+
} catch (e) {
|
|
118
|
+
throw new StoreError((e as Error).message);
|
|
119
|
+
}
|
|
120
|
+
if (!vars) throw new StoreError(`the job's trade left no credentials for ${id}`);
|
|
121
|
+
return vars;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** Every identity of `cloud` the job's trade left credentials for, with them; empty when the job traded none. */
|
|
125
|
+
export function tradedIdentities(env: NodeJS.ProcessEnv, cloud: IdentityCloud): Record<string, Record<string, string>> {
|
|
126
|
+
const path = env[CLOUD_TARGETS_ENV];
|
|
127
|
+
if (!path) return {};
|
|
128
|
+
try {
|
|
129
|
+
return readTargetsFile(path).clouds[cloud]?.vars ?? {};
|
|
130
|
+
} catch (e) {
|
|
131
|
+
throw new StoreError((e as Error).message);
|
|
132
|
+
}
|
|
133
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The object-store errors and write conditions, apart from the clients
|
|
3
|
+
* (chant#4589): `@intentius/chant/object-store/errors`. This module imports
|
|
4
|
+
* nothing, so code bound for an edge runtime (the terraform lexicon's
|
|
5
|
+
* registry/edge, a Cloudflare Worker without nodejs_compat) can name a store
|
|
6
|
+
* conflict without pulling the S3, GCS and Azure clients and their Node
|
|
7
|
+
* built-ins into its bundle. ./common.ts re-exports all of it, so the class a
|
|
8
|
+
* client throws is the class a caller of either path catches.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
export class StoreError extends Error {}
|
|
12
|
+
|
|
13
|
+
/** A conditional write that lost: the object changed (412) or another write to it was in flight (409). */
|
|
14
|
+
export class StoreConflict extends StoreError {}
|
|
15
|
+
|
|
16
|
+
/** A condition on a write: the version the object must still have (an ETag, a generation), or `*` for "there is no object yet". */
|
|
17
|
+
export type StoreCondition = { ifMatch: string } | { ifNoneMatch: "*" };
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* Whether `e` is a lost conditional write: chant's `StoreConflict`, or any
|
|
21
|
+
* error named `StoreConflict` (a caller's own store, or a copy of chant
|
|
22
|
+
* loaded twice). The class check comes first, since a minified bundle
|
|
23
|
+
* renames constructors.
|
|
24
|
+
*/
|
|
25
|
+
export const isStoreConflict = (e: unknown): boolean =>
|
|
26
|
+
e instanceof StoreConflict || (e instanceof Error && (e.name === "StoreConflict" || e.constructor.name === "StoreConflict"));
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The client for a bucket URL (#4554): its scheme picks the store, and the
|
|
3
|
+
* job's environment gives the identity (./s3.ts, ./gcs.ts and
|
|
4
|
+
* ./azure-blob.ts say which variables each reads). terragucci's
|
|
5
|
+
* `storeFromEnv` (report/bucket.ts).
|
|
6
|
+
*/
|
|
7
|
+
import { AzureBlobClient, azureFromEnv } from "./azure-blob";
|
|
8
|
+
import { parseBucketUrl, StoreError, type ObjectStore, type StoreFetch, type StoreHints } from "./common";
|
|
9
|
+
import { GcsClient, gcsFromEnv } from "./gcs";
|
|
10
|
+
import { S3Client, s3FromEnv } from "./s3";
|
|
11
|
+
|
|
12
|
+
/** Where the store is: `bucket` is `s3://<bucket>` (or a bare name), `gs://<bucket>` or `az://<account>/<container>`. */
|
|
13
|
+
export interface StoreWhere {
|
|
14
|
+
bucket: string;
|
|
15
|
+
endpoint?: string;
|
|
16
|
+
/** An AWS role to assume with the job's OIDC token; S3 only. */
|
|
17
|
+
role?: string;
|
|
18
|
+
/** The STS session name for `role`. */
|
|
19
|
+
sessionName?: string;
|
|
20
|
+
/** What the bucket is called in messages, such as `reports.bucket`. Default `the bucket`. */
|
|
21
|
+
setting?: string;
|
|
22
|
+
/** What the role is called in messages, such as `reports.role`. Default `the role`. */
|
|
23
|
+
roleSetting?: string;
|
|
24
|
+
/** Product keys that fix a setup error, named in its message (#4584). Left out, the messages use chant's wording. */
|
|
25
|
+
hints?: StoreHints;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function storeFromEnv(where: StoreWhere, env: NodeJS.ProcessEnv = process.env, fetchFn?: StoreFetch): ObjectStore {
|
|
29
|
+
const setting = where.setting ?? "the bucket";
|
|
30
|
+
const b = parseBucketUrl(where.bucket, setting);
|
|
31
|
+
if (b.kind !== "s3" && where.role) throw new StoreError(`${where.roleSetting ?? "the role"} is an AWS role, and ${where.bucket} is not an S3 bucket: the job writes it with its own ${where.hints?.oidc ?? "OIDC"} identity`);
|
|
32
|
+
const endpoint = where.endpoint?.replace(/\/+$/, "");
|
|
33
|
+
if (b.kind === "gcs") return new GcsClient(gcsFromEnv({ bucket: b.bucket, setting, ...(where.hints ? { hints: where.hints } : {}), ...(endpoint ? { endpoint } : {}) }, env), fetchFn);
|
|
34
|
+
if (b.kind === "azure") return new AzureBlobClient(azureFromEnv({ account: b.account, container: b.container, setting, ...(where.hints ? { hints: where.hints } : {}), ...(endpoint ? { endpoint } : {}) }, env), fetchFn);
|
|
35
|
+
return new S3Client(s3FromEnv({ ...where, setting }, env), fetchFn);
|
|
36
|
+
}
|