@intentius/chant 0.124.54 → 0.124.56
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/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.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -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 +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -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 +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -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/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/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/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- 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 +63 -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/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- 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/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 +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- 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 +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- 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 +160 -2
- 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/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 +178 -13
- 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/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/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-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 +164 -3
- package/dist/cli/registry.d.ts +73 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +92 -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.d.ts +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -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 +60 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +23 -5
- 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 +38 -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 +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- 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 +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- 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 +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- 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-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/wave-plan.d.ts +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- 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/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -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/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +152 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- 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 +10 -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 +204 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- 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/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -7
- 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 +9 -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 +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -0
- 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/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- 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/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- 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/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/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -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 +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- 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 +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -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 +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- 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 +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -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 +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -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 +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- 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 +45 -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/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -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 +405 -287
- 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-lock-grain.d.ts +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -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 +10 -3
- 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.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- 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/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/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/pr-report.schema.json +79 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- 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/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 +21 -1
- 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/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.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -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 +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -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/init.ts +3 -1
- 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/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- 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-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- 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 +879 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +144 -2
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +180 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- 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/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -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 +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- 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 +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- 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 +383 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- 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/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +96 -6
- 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/discovery/sandbox/bundle.ts +25 -1
- package/src/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -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 +11 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +143 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -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 +279 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- 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/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -8
- 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 +192 -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 +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -0
- 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/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/wave-plans.ts +33 -5
- 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/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/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -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-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -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 +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -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 +320 -22
- package/src/op/runtime.ts +107 -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 +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -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 +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -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/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +29 -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 +10 -3
- 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.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +79 -3
- package/src/workspace/promote.ts +2 -1
- 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/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,436 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Google Cloud Storage for reports, products and a gcs backend's state, over
|
|
3
|
+
* its JSON API with `fetch` and `node:crypto`: upload an object, download
|
|
4
|
+
* one, and a V4 signed URL to one; for a state, an object's generation, one
|
|
5
|
+
* generation's text, and a lock object written only when there is none.
|
|
6
|
+
*
|
|
7
|
+
* The identity is the file GOOGLE_APPLICATION_CREDENTIALS names, as Google's
|
|
8
|
+
* own libraries read it:
|
|
9
|
+
*
|
|
10
|
+
* external_account the job's OIDC token (what a job's OIDC setup writes,
|
|
11
|
+
* or google-github-actions/auth), traded at Google's STS,
|
|
12
|
+
* then the service account it impersonates. A link is
|
|
13
|
+
* signed by that service account through IAM's signBlob.
|
|
14
|
+
* service_account a key: requests carry a self-signed JWT and a link is
|
|
15
|
+
* signed with the key itself.
|
|
16
|
+
*
|
|
17
|
+
* A gcs backend's own credentials stand in for that file when its
|
|
18
|
+
* configuration names them: `access_token` (or GOOGLE_OAUTH_ACCESS_TOKEN), a
|
|
19
|
+
* bearer token used as it is, or `credentials`, a file or its JSON. With
|
|
20
|
+
* `impersonate_service_account`, every request carries that service
|
|
21
|
+
* account's token, which the identity asks IAM for.
|
|
22
|
+
*
|
|
23
|
+
* Writes are conditional on the generation read (`ifGenerationMatch`, `0` when
|
|
24
|
+
* there was no object), and a lost write is a 412.
|
|
25
|
+
*/
|
|
26
|
+
import { createHash, createSign } from "node:crypto";
|
|
27
|
+
import { readFileSync } from "node:fs";
|
|
28
|
+
import { defaultFetch, encodePath, encodeStrict, PRESIGN_MAX_SECONDS, StoreConflict, StoreError, tradedIdentities, type ObjectStore, type ObjectVersion, type StoreCondition, type StoreFetch, type StoreHints } from "./common";
|
|
29
|
+
import { CLOUD_TARGETS_ENV } from "../ci-identity";
|
|
30
|
+
|
|
31
|
+
export const GCS_ENDPOINT = "https://storage.googleapis.com";
|
|
32
|
+
/** IAM Credentials, where a token for an impersonated service account comes from. */
|
|
33
|
+
export const IAM_CREDENTIALS = "https://iamcredentials.googleapis.com";
|
|
34
|
+
const CLOUD_PLATFORM = "https://www.googleapis.com/auth/cloud-platform";
|
|
35
|
+
const READ_WRITE = "https://www.googleapis.com/auth/devstorage.read_write";
|
|
36
|
+
|
|
37
|
+
export interface GcsTarget {
|
|
38
|
+
bucket: string;
|
|
39
|
+
/** The JSON API's and the links' address, no trailing slash. Default https://storage.googleapis.com. */
|
|
40
|
+
endpoint: string;
|
|
41
|
+
/** The credentials file, read at the first request. */
|
|
42
|
+
credentialsFile?: string;
|
|
43
|
+
/** The credentials as JSON: a gcs backend's `credentials` given inline. */
|
|
44
|
+
credentialsJson?: string;
|
|
45
|
+
/** A bearer token used as it is: a gcs backend's `access_token`, or GOOGLE_OAUTH_ACCESS_TOKEN. */
|
|
46
|
+
accessToken?: string;
|
|
47
|
+
/** The service account every request acts as, through IAM's generateAccessToken: a gcs backend's `impersonate_service_account`. */
|
|
48
|
+
impersonate?: string;
|
|
49
|
+
/** IAM Credentials' address, no trailing slash. Default https://iamcredentials.googleapis.com. */
|
|
50
|
+
iamEndpoint?: string;
|
|
51
|
+
/** With `accessToken`: the service account the token is, which signs a link through IAM's signBlob. A job's traded token (../ci-identity.ts). */
|
|
52
|
+
signAs?: string;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** The target from where the store is and the job's environment. `setting` names the bucket in messages, such as `reports.bucket`. */
|
|
56
|
+
export function gcsFromEnv(where: { bucket: string; endpoint?: string; setting?: string; hints?: StoreHints }, env: NodeJS.ProcessEnv = process.env): GcsTarget {
|
|
57
|
+
const file = env.GOOGLE_APPLICATION_CREDENTIALS;
|
|
58
|
+
// A job that traded its OIDC token holds none: the trade step left the job's service account's token, and the file of every traded one.
|
|
59
|
+
if (!file && env.GOOGLE_OAUTH_ACCESS_TOKEN && env[CLOUD_TARGETS_ENV]) {
|
|
60
|
+
const signAs = Object.entries(tradedIdentities(env, "gcp")).find(([, v]) => v.GOOGLE_OAUTH_ACCESS_TOKEN === env.GOOGLE_OAUTH_ACCESS_TOKEN)?.[0];
|
|
61
|
+
return { bucket: where.bucket, endpoint: (where.endpoint ?? GCS_ENDPOINT).replace(/\/+$/, ""), accessToken: env.GOOGLE_OAUTH_ACCESS_TOKEN, ...(signAs ? { signAs } : {}) };
|
|
62
|
+
}
|
|
63
|
+
if (!file) throw new StoreError(`${where.setting ?? "the bucket"} is gs://${where.bucket}, but the job has no credentials for it: ${where.hints?.gcp ? `give the job ${where.hints.gcp} (it sets GOOGLE_APPLICATION_CREDENTIALS), or set` : "set"} GOOGLE_APPLICATION_CREDENTIALS to a credentials file${where.hints?.gcp ? "" : " (a job's OIDC setup writes one)"}`);
|
|
64
|
+
return { bucket: where.bucket, endpoint: (where.endpoint ?? GCS_ENDPOINT).replace(/\/+$/, ""), credentialsFile: file };
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
interface ExternalAccount {
|
|
68
|
+
type: "external_account";
|
|
69
|
+
audience: string;
|
|
70
|
+
subject_token_type: string;
|
|
71
|
+
token_url: string;
|
|
72
|
+
service_account_impersonation_url?: string;
|
|
73
|
+
credential_source: { file?: string; url?: string; headers?: Record<string, string>; format?: { type?: string; subject_token_field_name?: string } };
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
interface ServiceAccountKey {
|
|
77
|
+
type: "service_account";
|
|
78
|
+
client_email: string;
|
|
79
|
+
private_key: string;
|
|
80
|
+
private_key_id?: string;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
type Credentials = ExternalAccount | ServiceAccountKey;
|
|
84
|
+
|
|
85
|
+
const b64url = (b: string | Buffer): string => Buffer.from(b).toString("base64url");
|
|
86
|
+
|
|
87
|
+
/** A JWT the key signs for itself, which Google's APIs take as an access token for the scope it names. */
|
|
88
|
+
export function selfSignedJwt(key: ServiceAccountKey, now: Date): string {
|
|
89
|
+
const iat = Math.floor(now.getTime() / 1000);
|
|
90
|
+
const head = b64url(JSON.stringify({ alg: "RS256", typ: "JWT", ...(key.private_key_id ? { kid: key.private_key_id } : {}) }));
|
|
91
|
+
const body = b64url(JSON.stringify({ iss: key.client_email, sub: key.client_email, scope: READ_WRITE, iat, exp: iat + 3600 }));
|
|
92
|
+
return `${head}.${body}.${createSign("RSA-SHA256").update(`${head}.${body}`).sign(key.private_key).toString("base64url")}`;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** The service account an impersonation URL names: `.../serviceAccounts/<email>:generateAccessToken`. */
|
|
96
|
+
const impersonated = (url: string): string | undefined => {
|
|
97
|
+
const m = /\/serviceAccounts\/([^/:]+):generateAccessToken$/.exec(url);
|
|
98
|
+
return m ? decodeURIComponent(m[1]!) : undefined;
|
|
99
|
+
};
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* A V4 signed URL (GOOG4-RSA-SHA256): whoever holds it reads that one object,
|
|
103
|
+
* and nothing else, for `seconds`. `sign` signs the string-to-sign with the
|
|
104
|
+
* service account's key and answers the signature.
|
|
105
|
+
*/
|
|
106
|
+
export async function signedUrl(endpoint: string, bucket: string, key: string, email: string, seconds: number, now: Date, sign: (toSign: string) => Promise<Buffer>): Promise<string> {
|
|
107
|
+
const url = new URL(`${endpoint}/${bucket}/${encodePath(key)}`);
|
|
108
|
+
const stamp = now.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}/, "");
|
|
109
|
+
const scope = `${stamp.slice(0, 8)}/auto/storage/goog4_request`;
|
|
110
|
+
const params: Record<string, string> = {
|
|
111
|
+
"X-Goog-Algorithm": "GOOG4-RSA-SHA256",
|
|
112
|
+
"X-Goog-Credential": `${email}/${scope}`,
|
|
113
|
+
"X-Goog-Date": stamp,
|
|
114
|
+
"X-Goog-Expires": String(seconds),
|
|
115
|
+
"X-Goog-SignedHeaders": "host",
|
|
116
|
+
};
|
|
117
|
+
const query = Object.keys(params).sort().map((k) => `${encodeStrict(k)}=${encodeStrict(params[k])}`).join("&");
|
|
118
|
+
const canonical = ["GET", url.pathname, query, `host:${url.host}`, "", "host", "UNSIGNED-PAYLOAD"].join("\n");
|
|
119
|
+
const toSign = ["GOOG4-RSA-SHA256", stamp, scope, createHash("sha256").update(canonical).digest("hex")].join("\n");
|
|
120
|
+
return `${url.origin}${url.pathname}?${query}&X-Goog-Signature=${(await sign(toSign)).toString("hex")}`;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** Google's error message, or the start of the body. */
|
|
124
|
+
const why = (text: string): string => {
|
|
125
|
+
try {
|
|
126
|
+
const j = JSON.parse(text) as { error?: string | { message?: string }; error_description?: string };
|
|
127
|
+
if (typeof j.error === "object" && j.error?.message) return j.error.message;
|
|
128
|
+
if (typeof j.error === "string") return [j.error, j.error_description].filter(Boolean).join(": ");
|
|
129
|
+
} catch {
|
|
130
|
+
// Not JSON.
|
|
131
|
+
}
|
|
132
|
+
return text.slice(0, 300);
|
|
133
|
+
};
|
|
134
|
+
|
|
135
|
+
export class GcsClient implements ObjectStore {
|
|
136
|
+
private creds?: Credentials;
|
|
137
|
+
private token?: Promise<{ token: string; expires: number }>;
|
|
138
|
+
|
|
139
|
+
constructor(readonly target: GcsTarget, private readonly fetchFn: StoreFetch = defaultFetch, private readonly readFile: (file: string) => string = (f) => readFileSync(f, "utf-8")) {}
|
|
140
|
+
|
|
141
|
+
get location(): string {
|
|
142
|
+
return `gs://${this.target.bucket}`;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/** Where the credentials come from, for messages. */
|
|
146
|
+
private get source(): string {
|
|
147
|
+
return this.target.credentialsFile ?? "the backend's credentials";
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
private credentials(): Credentials {
|
|
151
|
+
if (this.creds) return this.creds;
|
|
152
|
+
const file = this.source;
|
|
153
|
+
let c: Partial<Credentials>;
|
|
154
|
+
try {
|
|
155
|
+
c = JSON.parse(this.target.credentialsJson ?? this.readFile(this.target.credentialsFile ?? "")) as Partial<Credentials>;
|
|
156
|
+
} catch (e) {
|
|
157
|
+
throw new StoreError(`cannot read the credentials in ${file}: ${(e as Error).message}`);
|
|
158
|
+
}
|
|
159
|
+
if (c.type === "external_account" && c.token_url && c.audience && c.credential_source && (c.credential_source.file || c.credential_source.url)) return (this.creds = c as ExternalAccount);
|
|
160
|
+
if (c.type === "service_account" && c.client_email && c.private_key) return (this.creds = c as ServiceAccountKey);
|
|
161
|
+
throw new StoreError(`${file} is not an external_account file with a credential_source file or url, nor a service_account key`);
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
private async post(url: string, headers: Record<string, string>, body: string, what: string): Promise<Record<string, unknown>> {
|
|
165
|
+
const res = await this.fetchFn(url, { method: "POST", headers, body });
|
|
166
|
+
const text = await res.text();
|
|
167
|
+
if (!res.ok) throw new StoreError(`${what}: ${res.status} ${why(text)}`);
|
|
168
|
+
try {
|
|
169
|
+
return JSON.parse(text) as Record<string, unknown>;
|
|
170
|
+
} catch {
|
|
171
|
+
throw new StoreError(`${what}: the answer is not JSON`);
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
/** The job's OIDC token, from the file or URL the credentials name. */
|
|
176
|
+
private async subjectToken(c: ExternalAccount): Promise<string> {
|
|
177
|
+
const src = c.credential_source;
|
|
178
|
+
let text: string;
|
|
179
|
+
if (src.file) {
|
|
180
|
+
try {
|
|
181
|
+
text = this.readFile(src.file);
|
|
182
|
+
} catch (e) {
|
|
183
|
+
throw new StoreError(`cannot read the OIDC token in ${src.file}: ${(e as Error).message}`);
|
|
184
|
+
}
|
|
185
|
+
} else {
|
|
186
|
+
const res = await this.fetchFn(src.url!, { method: "GET", headers: src.headers ?? {} });
|
|
187
|
+
text = await res.text();
|
|
188
|
+
if (!res.ok) throw new StoreError(`the OIDC token at ${src.url!.split("?")[0]}: ${res.status} ${why(text)}`);
|
|
189
|
+
}
|
|
190
|
+
const field = src.format?.type === "json" ? src.format.subject_token_field_name : undefined;
|
|
191
|
+
let token = text.trim();
|
|
192
|
+
if (field) {
|
|
193
|
+
try {
|
|
194
|
+
token = String((JSON.parse(text) as Record<string, unknown>)[field] ?? "");
|
|
195
|
+
} catch {
|
|
196
|
+
throw new StoreError(`the job's OIDC token is not JSON with ${field}`);
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
if (!token) throw new StoreError(`the job's OIDC token is empty`);
|
|
200
|
+
return token;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/** STS's federated token, then the impersonated service account's, when the credentials name one. */
|
|
204
|
+
private async exchange(c: ExternalAccount): Promise<{ token: string; expires: number }> {
|
|
205
|
+
const sts = await this.post(
|
|
206
|
+
c.token_url,
|
|
207
|
+
{ "content-type": "application/x-www-form-urlencoded" },
|
|
208
|
+
new URLSearchParams({
|
|
209
|
+
grant_type: "urn:ietf:params:oauth:grant-type:token-exchange",
|
|
210
|
+
audience: c.audience,
|
|
211
|
+
scope: CLOUD_PLATFORM,
|
|
212
|
+
requested_token_type: "urn:ietf:params:oauth:token-type:access_token",
|
|
213
|
+
subject_token: await this.subjectToken(c),
|
|
214
|
+
subject_token_type: c.subject_token_type,
|
|
215
|
+
}).toString(),
|
|
216
|
+
`Google STS refused the OIDC token for ${c.audience}`,
|
|
217
|
+
);
|
|
218
|
+
if (typeof sts.access_token !== "string") throw new StoreError(`Google STS answered without a token`);
|
|
219
|
+
const fed = { token: sts.access_token, expires: Date.now() + Number(sts.expires_in ?? 3600) * 1000 };
|
|
220
|
+
if (!c.service_account_impersonation_url) return fed;
|
|
221
|
+
const sa = await this.post(
|
|
222
|
+
c.service_account_impersonation_url,
|
|
223
|
+
{ "content-type": "application/json", authorization: `Bearer ${fed.token}` },
|
|
224
|
+
JSON.stringify({ scope: [CLOUD_PLATFORM], lifetime: "3600s" }),
|
|
225
|
+
`impersonating ${impersonated(c.service_account_impersonation_url) ?? "the service account"}`,
|
|
226
|
+
);
|
|
227
|
+
if (typeof sa.accessToken !== "string") throw new StoreError(`IAM answered the impersonation without a token`);
|
|
228
|
+
const at = typeof sa.expireTime === "string" ? Date.parse(sa.expireTime) : NaN;
|
|
229
|
+
return { token: sa.accessToken, expires: Number.isNaN(at) ? Date.now() + 3600_000 : at };
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/** The identity's own token: the one the target gives, a key's self-signed JWT, or STS's for the OIDC token. */
|
|
233
|
+
private async own(): Promise<{ token: string; expires: number }> {
|
|
234
|
+
if (this.target.accessToken) return { token: this.target.accessToken, expires: Date.now() + 3600_000 };
|
|
235
|
+
const c = this.credentials();
|
|
236
|
+
return c.type === "service_account" ? { token: selfSignedJwt(c, new Date()), expires: Date.now() + 3600_000 } : this.exchange(c);
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
/** The token of the service account the target impersonates, asked for with the identity's own. */
|
|
240
|
+
private async impersonating(sa: string): Promise<{ token: string; expires: number }> {
|
|
241
|
+
const base = await this.own();
|
|
242
|
+
const r = await this.post(
|
|
243
|
+
`${(this.target.iamEndpoint ?? IAM_CREDENTIALS).replace(/\/+$/, "")}/v1/projects/-/serviceAccounts/${encodeURIComponent(sa)}:generateAccessToken`,
|
|
244
|
+
{ "content-type": "application/json", authorization: `Bearer ${base.token}` },
|
|
245
|
+
JSON.stringify({ scope: [CLOUD_PLATFORM], lifetime: "3600s" }),
|
|
246
|
+
`impersonating ${sa}, which needs Service Account Token Creator for the identity`,
|
|
247
|
+
);
|
|
248
|
+
if (typeof r.accessToken !== "string") throw new StoreError(`IAM answered the impersonation of ${sa} without a token`);
|
|
249
|
+
const at = typeof r.expireTime === "string" ? Date.parse(r.expireTime) : NaN;
|
|
250
|
+
return { token: r.accessToken, expires: Number.isNaN(at) ? Date.now() + 3600_000 : at };
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
/** An access token: once per client, again a minute before it expires. */
|
|
254
|
+
private async bearer(): Promise<string> {
|
|
255
|
+
const sa = this.target.impersonate;
|
|
256
|
+
const fresh = (): Promise<{ token: string; expires: number }> => (sa ? this.impersonating(sa) : this.own());
|
|
257
|
+
const again = (): Promise<{ token: string; expires: number }> =>
|
|
258
|
+
(this.token = fresh().catch((e: unknown) => {
|
|
259
|
+
this.token = undefined;
|
|
260
|
+
throw e;
|
|
261
|
+
}));
|
|
262
|
+
let held = await (this.token ?? again());
|
|
263
|
+
if (held.expires - Date.now() < 60_000) held = await again();
|
|
264
|
+
return held.token;
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
/** The identity's access token and when it expires, for a re-plan's trade (../oidc-trade.ts). */
|
|
268
|
+
async identityToken(): Promise<{ token: string; expires: number }> {
|
|
269
|
+
return this.target.impersonate ? this.impersonating(this.target.impersonate) : this.own();
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
async put(key: string, body: string | Uint8Array, contentType: string, when?: StoreCondition): Promise<{ etag?: string }> {
|
|
273
|
+
const t = this.target;
|
|
274
|
+
const gen = !when ? "" : "ifMatch" in when ? when.ifMatch : "0";
|
|
275
|
+
const url = `${t.endpoint}/upload/storage/v1/b/${encodeURIComponent(t.bucket)}/o?uploadType=media&name=${encodeStrict(key)}${gen ? `&ifGenerationMatch=${encodeStrict(gen)}` : ""}`;
|
|
276
|
+
const res = await this.fetchFn(url, { method: "POST", headers: { "content-type": contentType, authorization: `Bearer ${await this.bearer()}` }, body });
|
|
277
|
+
if (res.status === 412) throw new StoreConflict(`PUT ${this.location}/${key}: 412, it changed since it was read`);
|
|
278
|
+
const text = await res.text();
|
|
279
|
+
if (!res.ok) throw new StoreError(`PUT ${this.location}/${key}: ${res.status} ${why(text)}`);
|
|
280
|
+
let generation: unknown;
|
|
281
|
+
try {
|
|
282
|
+
generation = (JSON.parse(text) as { generation?: unknown }).generation;
|
|
283
|
+
} catch {
|
|
284
|
+
// An answer without the object's metadata: no version to write on.
|
|
285
|
+
}
|
|
286
|
+
return generation !== undefined ? { etag: String(generation) } : {};
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
async read(key: string): Promise<{ body?: string; etag?: string }> {
|
|
290
|
+
const t = this.target;
|
|
291
|
+
const url = `${t.endpoint}/storage/v1/b/${encodeURIComponent(t.bucket)}/o/${encodeStrict(key)}?alt=media`;
|
|
292
|
+
const res = await this.fetchFn(url, { method: "GET", headers: { authorization: `Bearer ${await this.bearer()}` } });
|
|
293
|
+
if (res.status === 404) return {};
|
|
294
|
+
if (!res.ok) throw new StoreError(`GET ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
295
|
+
const generation = res.headers?.get("x-goog-generation") ?? undefined;
|
|
296
|
+
return { body: await res.text(), ...(generation ? { etag: generation } : {}) };
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
async get(key: string): Promise<string | undefined> {
|
|
300
|
+
return (await this.read(key)).body;
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
private objectUrl(key: string): string {
|
|
304
|
+
return `${this.target.endpoint}/storage/v1/b/${encodeURIComponent(this.target.bucket)}/o/${encodeStrict(key)}`;
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
/** An object's metadata and never its body: whether it is there, and its generation. */
|
|
308
|
+
async head(key: string, generation?: string): Promise<{ exists: boolean; generation?: string }> {
|
|
309
|
+
const url = `${this.objectUrl(key)}${generation ? `?generation=${encodeStrict(generation)}` : ""}`;
|
|
310
|
+
const res = await this.fetchFn(url, { method: "GET", headers: { authorization: `Bearer ${await this.bearer()}` } });
|
|
311
|
+
const text = await res.text();
|
|
312
|
+
// GCS answers 400 for a generation that is not a number.
|
|
313
|
+
if (res.status === 404 || (generation && res.status === 400)) return { exists: false };
|
|
314
|
+
if (!res.ok) throw new StoreError(`GET ${this.location}/${key} metadata: ${res.status} ${why(text)}`);
|
|
315
|
+
let g: unknown;
|
|
316
|
+
try {
|
|
317
|
+
g = (JSON.parse(text) as { generation?: unknown }).generation;
|
|
318
|
+
} catch {
|
|
319
|
+
// Metadata that is not JSON: no generation.
|
|
320
|
+
}
|
|
321
|
+
return { exists: true, ...(g !== undefined && g !== null && g !== "" ? { generation: String(g) } : {}) };
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
/** One generation of an object's text; undefined when the bucket holds no such generation. */
|
|
325
|
+
async readGeneration(key: string, generation: string): Promise<string | undefined> {
|
|
326
|
+
const url = `${this.objectUrl(key)}?alt=media&generation=${encodeStrict(generation)}`;
|
|
327
|
+
const res = await this.fetchFn(url, { method: "GET", headers: { authorization: `Bearer ${await this.bearer()}` } });
|
|
328
|
+
if (res.status === 404 || res.status === 400) return undefined;
|
|
329
|
+
if (!res.ok) throw new StoreError(`GET ${this.location}/${key}#${generation}: ${res.status} ${why(await res.text())}`);
|
|
330
|
+
return res.text();
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
/** Whether the bucket keeps each generation of an object (object versioning); undefined when the identity may not read the bucket's settings. */
|
|
334
|
+
async versioning(): Promise<boolean | undefined> {
|
|
335
|
+
const url = `${this.target.endpoint}/storage/v1/b/${encodeURIComponent(this.target.bucket)}?fields=versioning`;
|
|
336
|
+
const res = await this.fetchFn(url, { method: "GET", headers: { authorization: `Bearer ${await this.bearer()}` } });
|
|
337
|
+
const text = await res.text();
|
|
338
|
+
if (res.status === 403 || res.status === 401) return undefined;
|
|
339
|
+
if (!res.ok) throw new StoreError(`GET ${this.location} settings: ${res.status} ${why(text)}`);
|
|
340
|
+
try {
|
|
341
|
+
return (JSON.parse(text) as { versioning?: { enabled?: boolean } }).versioning?.enabled === true;
|
|
342
|
+
} catch {
|
|
343
|
+
return undefined;
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
/**
|
|
348
|
+
* Every generation the bucket keeps of one object, from an object listing
|
|
349
|
+
* with `versions=true`: each one's generation, when it was written
|
|
350
|
+
* (`timeCreated`) and whether it is live (no `timeDeleted`). Metadata only;
|
|
351
|
+
* it needs storage.objects.list on the bucket.
|
|
352
|
+
*/
|
|
353
|
+
async listVersions(key: string): Promise<ObjectVersion[]> {
|
|
354
|
+
const out: ObjectVersion[] = [];
|
|
355
|
+
let token: string | undefined;
|
|
356
|
+
for (let page = 0; page < 1000; page++) {
|
|
357
|
+
const url = `${this.target.endpoint}/storage/v1/b/${encodeURIComponent(this.target.bucket)}/o?prefix=${encodeStrict(key)}&versions=true&fields=${encodeStrict("items(name,generation,timeCreated,timeDeleted),nextPageToken")}${token ? `&pageToken=${encodeStrict(token)}` : ""}`;
|
|
358
|
+
const res = await this.fetchFn(url, { method: "GET", headers: { authorization: `Bearer ${await this.bearer()}` } });
|
|
359
|
+
const text = await res.text();
|
|
360
|
+
if (!res.ok) throw new StoreError(`list the generations of ${this.location}/${key}: ${res.status} ${why(text)}`);
|
|
361
|
+
let doc: { items?: { name?: unknown; generation?: unknown; timeCreated?: unknown; timeDeleted?: unknown }[]; nextPageToken?: unknown };
|
|
362
|
+
try {
|
|
363
|
+
doc = JSON.parse(text) as typeof doc;
|
|
364
|
+
} catch {
|
|
365
|
+
throw new StoreError(`list the generations of ${this.location}/${key}: the answer is not JSON`);
|
|
366
|
+
}
|
|
367
|
+
for (const i of doc.items ?? []) {
|
|
368
|
+
// The prefix lists the lock object and any name that starts with this one: only the object itself counts.
|
|
369
|
+
if (i.name !== key || i.generation === undefined || typeof i.timeCreated !== "string") continue;
|
|
370
|
+
out.push({ version_id: String(i.generation), written_at: new Date(i.timeCreated).toISOString(), latest: i.timeDeleted === undefined });
|
|
371
|
+
}
|
|
372
|
+
token = typeof doc.nextPageToken === "string" && doc.nextPageToken !== "" ? doc.nextPageToken : undefined;
|
|
373
|
+
if (!token) break;
|
|
374
|
+
}
|
|
375
|
+
return out.sort((a, b) => Date.parse(b.written_at) - Date.parse(a.written_at));
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
/** Write an object only when there is none (ifGenerationMatch=0): true when this write made it, false when one was there. */
|
|
379
|
+
async putIfAbsent(key: string, body: string, contentType: string): Promise<boolean> {
|
|
380
|
+
try {
|
|
381
|
+
await this.put(key, body, contentType, { ifNoneMatch: "*" });
|
|
382
|
+
return true;
|
|
383
|
+
} catch (e) {
|
|
384
|
+
if (e instanceof StoreConflict) return false;
|
|
385
|
+
throw e;
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
|
|
389
|
+
/** Delete an object's live generation. One that is not there is deleted already. */
|
|
390
|
+
async remove(key: string): Promise<void> {
|
|
391
|
+
const res = await this.fetchFn(this.objectUrl(key), { method: "DELETE", headers: { authorization: `Bearer ${await this.bearer()}` } });
|
|
392
|
+
if (!res.ok && res.status !== 404) throw new StoreError(`DELETE ${this.location}/${key}: ${res.status} ${why(await res.text())}`);
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
/** A signed URL to `key` for `seconds`, signed by the key or by the impersonated service account through IAM. */
|
|
396
|
+
async presign(key: string, seconds: number, now = new Date()): Promise<{ url: string; expires: Date }> {
|
|
397
|
+
if (!Number.isInteger(seconds) || seconds < 1 || seconds > PRESIGN_MAX_SECONDS) throw new StoreError(`a signed URL lives 1 to ${PRESIGN_MAX_SECONDS} seconds, not ${seconds}`);
|
|
398
|
+
let email: string;
|
|
399
|
+
let sign: (s: string) => Promise<Buffer>;
|
|
400
|
+
const c = this.target.accessToken && this.target.signAs ? undefined : this.credentials();
|
|
401
|
+
if (!c) {
|
|
402
|
+
const sa = this.target.signAs!;
|
|
403
|
+
email = sa;
|
|
404
|
+
sign = async (s) => {
|
|
405
|
+
const r = await this.post(
|
|
406
|
+
`${(this.target.iamEndpoint ?? IAM_CREDENTIALS).replace(/\/+$/, "")}/v1/projects/-/serviceAccounts/${encodeURIComponent(sa)}:signBlob`,
|
|
407
|
+
{ "content-type": "application/json", authorization: `Bearer ${await this.bearer()}` },
|
|
408
|
+
JSON.stringify({ payload: Buffer.from(s).toString("base64") }),
|
|
409
|
+
`signBlob as ${sa}, which needs Service Account Token Creator on itself`,
|
|
410
|
+
);
|
|
411
|
+
if (typeof r.signedBlob !== "string") throw new StoreError(`signBlob as ${sa} answered without a signature`);
|
|
412
|
+
return Buffer.from(r.signedBlob, "base64");
|
|
413
|
+
};
|
|
414
|
+
} else if (c.type === "service_account") {
|
|
415
|
+
email = c.client_email;
|
|
416
|
+
sign = async (s) => createSign("RSA-SHA256").update(s).sign(c.private_key);
|
|
417
|
+
} else {
|
|
418
|
+
const sa = c.service_account_impersonation_url ? impersonated(c.service_account_impersonation_url) : undefined;
|
|
419
|
+
if (!sa) throw new StoreError(`a signed URL needs a service account to sign it, and ${this.source} impersonates none: give it a service account to impersonate`);
|
|
420
|
+
email = sa;
|
|
421
|
+
const iam = new URL(c.service_account_impersonation_url!).origin;
|
|
422
|
+
sign = async (s) => {
|
|
423
|
+
const r = await this.post(
|
|
424
|
+
`${iam}/v1/projects/-/serviceAccounts/${encodeURIComponent(sa)}:signBlob`,
|
|
425
|
+
{ "content-type": "application/json", authorization: `Bearer ${await this.bearer()}` },
|
|
426
|
+
JSON.stringify({ payload: Buffer.from(s).toString("base64") }),
|
|
427
|
+
`signBlob as ${sa}, which needs Service Account Token Creator on itself`,
|
|
428
|
+
);
|
|
429
|
+
if (typeof r.signedBlob !== "string") throw new StoreError(`signBlob as ${sa} answered without a signature`);
|
|
430
|
+
return Buffer.from(r.signedBlob, "base64");
|
|
431
|
+
};
|
|
432
|
+
}
|
|
433
|
+
const url = await signedUrl(this.target.endpoint, this.target.bucket, key, email, seconds, now, sign);
|
|
434
|
+
return { url, expires: new Date(now.getTime() + seconds * 1000) };
|
|
435
|
+
}
|
|
436
|
+
}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* #4554: chant core's object-store clients. The S3 signing is checked
|
|
3
|
+
* against AWS's published Signature Version 4 examples for S3, so the one
|
|
4
|
+
* signer (../cloud-lister/sigv4.ts) the clients, the snapshot store and the
|
|
5
|
+
* terraform lexicon share signs as S3 expects. The clients run against
|
|
6
|
+
* in-memory fakes; nothing leaves the process.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import { describe, expect, test } from "vitest";
|
|
10
|
+
import { presign, S3Client, sign, s3FromEnv, type S3Target } from "./s3";
|
|
11
|
+
import { parseBucketUrl, StoreConflict, StoreError, type StoreFetch } from "./common";
|
|
12
|
+
import { storeFromEnv } from "./from-env";
|
|
13
|
+
import { AzureBlobClient } from "./azure-blob";
|
|
14
|
+
import { GcsClient } from "./gcs";
|
|
15
|
+
import { EMPTY_PAYLOAD_SHA256 } from "../cloud-lister/sigv4";
|
|
16
|
+
import { signS3Request } from "../lifecycle/snapshot-store-s3";
|
|
17
|
+
|
|
18
|
+
// AWS's example keys and request (Signature Version 4 for S3, "GET Object" and "Presigned URL" examples).
|
|
19
|
+
const KEYS = { accessKeyId: "AKIAIOSFODNN7EXAMPLE", secretAccessKey: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" };
|
|
20
|
+
const WHEN = new Date("2013-05-24T00:00:00Z");
|
|
21
|
+
|
|
22
|
+
describe("one AWS signer signs S3 as AWS's examples do (#4554)", () => {
|
|
23
|
+
test("a GET with a Range header", () => {
|
|
24
|
+
const h = sign({ region: "us-east-1", ...KEYS }, "GET", "https://examplebucket.s3.amazonaws.com/test.txt", { range: "bytes=0-9" }, EMPTY_PAYLOAD_SHA256, WHEN);
|
|
25
|
+
expect(h.authorization).toBe(
|
|
26
|
+
"AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20130524/us-east-1/s3/aws4_request, SignedHeaders=host;range;x-amz-content-sha256;x-amz-date, Signature=f0e8bdb87c964420e857bd35b5d6ed310bd44f0170aba48dd91039c6036bdb41",
|
|
27
|
+
);
|
|
28
|
+
expect(h.host).toBeUndefined();
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
test("the snapshot store's medium signs the same way", () => {
|
|
32
|
+
const h = signS3Request({ method: "GET", url: "https://examplebucket.s3.amazonaws.com/test.txt", headers: { range: "bytes=0-9" }, body: "", region: "us-east-1", credentials: KEYS, now: WHEN });
|
|
33
|
+
expect(h.authorization).toContain("Signature=f0e8bdb87c964420e857bd35b5d6ed310bd44f0170aba48dd91039c6036bdb41");
|
|
34
|
+
});
|
|
35
|
+
|
|
36
|
+
test("a presigned GET for a day", () => {
|
|
37
|
+
const url = presign({ region: "us-east-1", ...KEYS }, "https://examplebucket.s3.amazonaws.com/test.txt", 86400, WHEN);
|
|
38
|
+
expect(url).toMatch(/&X-Amz-Signature=aeeed9bbccd4d02ee5c0109b86d86835f995330da4c265957d157751f604d404$/);
|
|
39
|
+
});
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
/** An S3 bucket in memory: objects with ETags, If-None-Match and If-Match honoured. */
|
|
43
|
+
function fakeS3(): { fetch: StoreFetch; objects: Map<string, { body: string; etag: string }> } {
|
|
44
|
+
const objects = new Map<string, { body: string; etag: string }>();
|
|
45
|
+
let n = 0;
|
|
46
|
+
const reply = (status: number, body = "", headers: Record<string, string> = {}) => ({ ok: status < 300, status, text: async () => body, headers: { get: (k: string) => headers[k.toLowerCase()] ?? null } });
|
|
47
|
+
const fetch: StoreFetch = async (url, init) => {
|
|
48
|
+
expect(init.headers.authorization).toMatch(/^AWS4-HMAC-SHA256 /);
|
|
49
|
+
const key = decodeURIComponent(new URL(url).pathname.replace(/^\/bucket\//, ""));
|
|
50
|
+
const had = objects.get(key);
|
|
51
|
+
if (init.method === "GET") return had ? reply(200, had.body, { etag: had.etag }) : reply(404);
|
|
52
|
+
if (init.method === "HEAD") return had ? reply(200, "", { etag: had.etag }) : reply(404);
|
|
53
|
+
if (init.method === "DELETE") return objects.delete(key), reply(204);
|
|
54
|
+
if (init.headers["if-none-match"] === "*" && had) return reply(412);
|
|
55
|
+
if (init.headers["if-match"] !== undefined && init.headers["if-match"] !== had?.etag) return reply(412);
|
|
56
|
+
const etag = `"e${++n}"`;
|
|
57
|
+
objects.set(key, { body: String(init.body), etag });
|
|
58
|
+
return reply(200, "", { etag });
|
|
59
|
+
};
|
|
60
|
+
return { fetch, objects };
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
describe("the S3 client against a fake bucket (#4554)", () => {
|
|
64
|
+
const target: S3Target = { bucket: "bucket", endpoint: "http://s3.test", region: "us-east-1", ...KEYS };
|
|
65
|
+
|
|
66
|
+
test("a put returns its ETag, a conditional put over a stale one conflicts, and putIfAbsent takes a lock once", async () => {
|
|
67
|
+
const s3 = fakeS3();
|
|
68
|
+
const c = new S3Client(target, s3.fetch);
|
|
69
|
+
const first = await c.put("runs/index.json", "{}", "application/json");
|
|
70
|
+
expect(first.etag).toBe('"e1"');
|
|
71
|
+
await c.put("runs/index.json", "{\"a\":1}", "application/json", { ifMatch: first.etag! });
|
|
72
|
+
await expect(c.put("runs/index.json", "{}", "application/json", { ifMatch: first.etag! })).rejects.toBeInstanceOf(StoreConflict);
|
|
73
|
+
expect(await c.putIfAbsent("k.tflock", "{}", "application/json")).toBe(true);
|
|
74
|
+
expect(await c.putIfAbsent("k.tflock", "{}", "application/json")).toBe(false);
|
|
75
|
+
expect(await c.get("runs/index.json")).toBe("{\"a\":1}");
|
|
76
|
+
await c.remove("k.tflock");
|
|
77
|
+
expect((await c.head("k.tflock")).exists).toBe(false);
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
test("s3FromEnv names the setting a product gave in its refusal, and takes a role's traded keys", () => {
|
|
81
|
+
expect(() => s3FromEnv({ bucket: "b", setting: "reports.bucket", roleSetting: "reports.role" }, {})).toThrow(/^reports\.bucket is set, .* or reports\.role$/);
|
|
82
|
+
expect(s3FromEnv({ bucket: "s3://b" }, { AWS_ACCESS_KEY_ID: "id", AWS_SECRET_ACCESS_KEY: "secret" })).toMatchObject({ bucket: "b", accessKeyId: "id" });
|
|
83
|
+
const web = s3FromEnv({ bucket: "b", sessionName: "chant-state" }, { AWS_ROLE_ARN: "arn:aws:iam::1:role/r", AWS_WEB_IDENTITY_TOKEN_FILE: "/t" });
|
|
84
|
+
expect(web).toMatchObject({ webIdentity: { roleArn: "arn:aws:iam::1:role/r", sessionName: "chant-state" } });
|
|
85
|
+
});
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
describe("a bucket URL picks the store (#4554)", () => {
|
|
89
|
+
test("s3, gs and az URLs", () => {
|
|
90
|
+
expect(parseBucketUrl("s3://b")).toEqual({ kind: "s3", bucket: "b" });
|
|
91
|
+
expect(parseBucketUrl("gs://my-bucket")).toEqual({ kind: "gcs", bucket: "my-bucket" });
|
|
92
|
+
expect(parseBucketUrl("az://account1/reports")).toEqual({ kind: "azure", account: "account1", container: "reports" });
|
|
93
|
+
expect(() => parseBucketUrl("https://x", "reports.bucket")).toThrow(/^reports\.bucket must be/);
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
test("storeFromEnv makes the client for the scheme, and refuses an AWS role for another cloud", () => {
|
|
97
|
+
expect(storeFromEnv({ bucket: "gs://my-bucket" }, { GOOGLE_APPLICATION_CREDENTIALS: "/creds.json" })).toBeInstanceOf(GcsClient);
|
|
98
|
+
expect(storeFromEnv({ bucket: "az://account1/reports" }, { AZURE_STORAGE_KEY: Buffer.from("k").toString("base64") })).toBeInstanceOf(AzureBlobClient);
|
|
99
|
+
expect(storeFromEnv({ bucket: "b" }, { AWS_ACCESS_KEY_ID: "id", AWS_SECRET_ACCESS_KEY: "s" })).toBeInstanceOf(S3Client);
|
|
100
|
+
expect(() => storeFromEnv({ bucket: "gs://my-bucket", role: "arn:aws:iam::1:role/r" }, {})).toThrow(StoreError);
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
test("storeFromEnv without hints words its errors as chant does (#4584)", () => {
|
|
104
|
+
expect(() => storeFromEnv({ bucket: "gs://bkt" }, {})).toThrow("set GOOGLE_APPLICATION_CREDENTIALS to a credentials file (a job's OIDC setup writes one)");
|
|
105
|
+
expect(() => storeFromEnv({ bucket: "az://acct1/reports" }, {})).toThrow("(a job's OIDC setup sets them), or AZURE_STORAGE_KEY");
|
|
106
|
+
expect(() => storeFromEnv({ bucket: "b" }, {})).toThrow("AWS_WEB_IDENTITY_TOKEN_FILE, or the role");
|
|
107
|
+
expect(() => storeFromEnv({ bucket: "b", role: "arn:aws:iam::1:role/r" }, {})).toThrow("to assume arn:aws:iam::1:role/r");
|
|
108
|
+
expect(() => storeFromEnv({ bucket: "gs://bkt", role: "arn:aws:iam::1:role/r" }, {})).toThrow("its own OIDC identity");
|
|
109
|
+
});
|
|
110
|
+
|
|
111
|
+
test("storeFromEnv names the product key in each setup error when given hints (#4584)", () => {
|
|
112
|
+
const hints = { oidc: "oidc", gcp: "oidc.gcp", azure: "oidc.azure" };
|
|
113
|
+
const base = { setting: "reports.bucket", roleSetting: "reports.role", hints };
|
|
114
|
+
expect(() => storeFromEnv({ ...base, bucket: "gs://bkt" }, {})).toThrow(
|
|
115
|
+
"reports.bucket is gs://bkt, but the job has no credentials for it: give the job oidc.gcp (it sets GOOGLE_APPLICATION_CREDENTIALS), or set GOOGLE_APPLICATION_CREDENTIALS to a credentials file",
|
|
116
|
+
);
|
|
117
|
+
expect(() => storeFromEnv({ ...base, bucket: "az://acct1/reports" }, {})).toThrow(
|
|
118
|
+
"reports.bucket is az://acct1/reports, but the job has no credentials for it: give the job oidc.azure (it sets ARM_TENANT_ID, ARM_CLIENT_ID and ARM_OIDC_TOKEN_FILE_PATH), or set AZURE_STORAGE_KEY",
|
|
119
|
+
);
|
|
120
|
+
expect(() => storeFromEnv({ ...base, bucket: "b" }, {})).toThrow(
|
|
121
|
+
"reports.bucket is set, but the job has no credentials for it: set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY, or AWS_ROLE_ARN and AWS_WEB_IDENTITY_TOKEN_FILE (a job with oidc sets both), or reports.role",
|
|
122
|
+
);
|
|
123
|
+
expect(() => storeFromEnv({ ...base, bucket: "b", role: "arn:aws:iam::1:role/r" }, {})).toThrow(
|
|
124
|
+
"reports.role is set, but AWS_WEB_IDENTITY_TOKEN_FILE is not: the job needs an OIDC token to assume arn:aws:iam::1:role/r, which a job with oidc gets",
|
|
125
|
+
);
|
|
126
|
+
expect(() => storeFromEnv({ ...base, bucket: "gs://bkt", role: "arn:aws:iam::1:role/r" }, {})).toThrow(
|
|
127
|
+
"reports.role is an AWS role, and gs://bkt is not an S3 bucket: the job writes it with its own oidc identity",
|
|
128
|
+
);
|
|
129
|
+
});
|
|
130
|
+
});
|