@astrale-os/sdk 0.6.0-beta.6 → 0.6.0-beta.61
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/README.md +220 -66
- package/dist/application/action/action.d.ts +6 -0
- package/dist/application/action/authoring.d.ts +3 -1
- package/dist/application/action/authoring.js +1 -0
- package/dist/application/action/context.d.ts +95 -34
- package/dist/application/action/define.d.ts +3 -3
- package/dist/application/action/index.d.ts +3 -1
- package/dist/application/action/index.js +1 -0
- package/dist/application/define.d.ts +8 -6
- package/dist/application/define.js +28 -14
- package/dist/application/dependency/index.d.ts +1 -1
- package/dist/application/dependency/invoker.d.ts +21 -10
- package/dist/application/domain.d.ts +30 -0
- package/dist/application/error/error.d.ts +16 -1
- package/dist/application/error/error.js +40 -6
- package/dist/application/error/index.d.ts +1 -1
- package/dist/application/error/index.js +1 -1
- package/dist/application/file/binary.d.ts +11 -0
- package/dist/application/file/binary.js +45 -0
- package/dist/application/file/file.d.ts +77 -0
- package/dist/application/file/file.js +111 -0
- package/dist/application/file/index.d.ts +4 -0
- package/dist/application/file/index.js +2 -0
- package/dist/application/file/input.d.ts +13 -0
- package/dist/application/file/input.js +57 -0
- package/dist/application/index.d.ts +6 -5
- package/dist/application/index.js +1 -1
- package/dist/application/integration/define.d.ts +8 -1
- package/dist/application/integration/index.d.ts +2 -2
- package/dist/application/integration/integration.d.ts +13 -1
- package/dist/application/integration/operation.d.ts +16 -3
- package/dist/application/mutation/authoring/builder.d.ts +81 -33
- package/dist/application/mutation/authoring/builder.js +100 -30
- package/dist/application/mutation/authoring/guard.d.ts +37 -0
- package/dist/application/mutation/authoring/guard.js +150 -0
- package/dist/application/mutation/authoring/index.d.ts +5 -2
- package/dist/application/mutation/authoring/index.js +2 -1
- package/dist/application/mutation/authoring/names.d.ts +19 -0
- package/dist/application/mutation/authoring/names.js +83 -0
- package/dist/application/mutation/authoring/properties.d.ts +17 -4
- package/dist/application/mutation/authoring/properties.js +38 -2
- package/dist/application/mutation/authoring/transition.d.ts +3 -2
- package/dist/application/mutation/authoring/transition.js +4 -1
- package/dist/application/mutation/define.d.ts +24 -10
- package/dist/application/mutation/define.js +49 -53
- package/dist/application/mutation/execution/execute.d.ts +2 -2
- package/dist/application/mutation/execution/execute.js +78 -7
- package/dist/application/mutation/execution/executor.d.ts +4 -1
- package/dist/application/mutation/execution/executor.js +6 -1
- package/dist/application/mutation/failure.d.ts +17 -1
- package/dist/application/mutation/failure.js +40 -19
- package/dist/application/mutation/index.d.ts +9 -5
- package/dist/application/mutation/index.js +5 -2
- package/dist/application/mutation/legacy/v6/builder.d.ts +84 -0
- package/dist/application/mutation/legacy/v6/define.d.ts +18 -0
- package/dist/application/mutation/legacy/v6/define.js +56 -0
- package/dist/application/mutation/legacy/v6/mutation.d.ts +28 -0
- package/dist/application/mutation/{authoring → legacy/v6}/precondition.d.ts +4 -0
- package/dist/application/mutation/mutation.d.ts +47 -19
- package/dist/application/query/answer/answer.d.ts +117 -0
- package/dist/application/query/answer/conformance.d.ts +4 -0
- package/dist/application/query/answer/conformance.js +27 -0
- package/dist/application/query/answer/facts.d.ts +17 -0
- package/dist/application/query/answer/facts.js +57 -0
- package/dist/application/query/composite/builder.d.ts +1 -1
- package/dist/application/query/composite/builder.js +2 -2
- package/dist/application/query/composite/plan.d.ts +1 -5
- package/dist/application/query/composite/plan.js +1 -3
- package/dist/application/query/composite/query.d.ts +1 -2
- package/dist/application/query/define.d.ts +3 -34
- package/dist/application/query/define.js +5 -131
- package/dist/application/query/defined/define.d.ts +45 -0
- package/dist/application/query/defined/define.js +96 -0
- package/dist/application/query/defined/query.d.ts +139 -0
- package/dist/application/query/definition.d.ts +12 -0
- package/dist/application/query/definition.js +47 -0
- package/dist/application/query/execution/bounds.d.ts +22 -0
- package/dist/application/query/execution/bounds.js +88 -0
- package/dist/application/query/execution/client.d.ts +21 -0
- package/dist/application/query/execution/crossings.d.ts +30 -0
- package/dist/application/query/execution/crossings.js +232 -0
- package/dist/application/query/execution/error.d.ts +71 -0
- package/dist/application/query/execution/error.js +50 -0
- package/dist/application/query/execution/execute.d.ts +4 -10
- package/dist/application/query/execution/execute.js +3 -45
- package/dist/application/query/execution/executor.d.ts +2 -2
- package/dist/application/query/execution/legacy/declared-classes.d.ts +10 -0
- package/dist/application/query/execution/legacy/declared-classes.js +9 -0
- package/dist/application/query/execution/refusal.d.ts +37 -0
- package/dist/application/query/execution/refusal.js +80 -0
- package/dist/application/query/execution/rows.d.ts +42 -0
- package/dist/application/query/execution/rows.js +326 -0
- package/dist/application/query/execution/run.d.ts +85 -0
- package/dist/application/query/execution/run.js +372 -0
- package/dist/application/query/execution/split.d.ts +24 -0
- package/dist/application/query/execution/split.js +190 -0
- package/dist/application/query/failure.d.ts +8 -0
- package/dist/application/query/failure.js +8 -0
- package/dist/application/query/handles/build.d.ts +10 -0
- package/dist/application/query/handles/build.js +53 -0
- package/dist/application/query/handles/conditions.d.ts +94 -0
- package/dist/application/query/handles/domain.d.ts +157 -0
- package/dist/application/query/handles/handles.d.ts +285 -0
- package/dist/application/query/handles/handles.js +1 -0
- package/dist/application/query/handles/model.d.ts +106 -0
- package/dist/application/query/handles/model.js +261 -0
- package/dist/application/query/handles/plan.d.ts +100 -0
- package/dist/application/query/handles/plan.js +37 -0
- package/dist/application/query/handles/reads.d.ts +106 -0
- package/dist/application/query/handles/reads.js +978 -0
- package/dist/application/query/handles/relations.d.ts +106 -0
- package/dist/application/query/handles/relations.js +1 -0
- package/dist/application/query/handles/rows.d.ts +94 -0
- package/dist/application/query/handles/rows.js +4 -0
- package/dist/application/query/handles/terms.d.ts +103 -0
- package/dist/application/query/handles/terms.js +282 -0
- package/dist/application/query/index.d.ts +14 -8
- package/dist/application/query/index.js +10 -5
- package/dist/application/query/language/index.d.ts +2 -0
- package/dist/application/query/language/index.js +2 -0
- package/dist/application/query/language/query.d.ts +323 -0
- package/dist/application/query/language/query.js +2 -0
- package/dist/application/query/{collection → legacy/v6/collection}/identity.d.ts +2 -2
- package/dist/application/query/{collection → legacy/v6/collection}/metadata.d.ts +1 -1
- package/dist/application/query/{collection → legacy/v6/collection}/union.d.ts +4 -4
- package/dist/application/query/{collection → legacy/v6/collection}/union.js +15 -8
- package/dist/application/query/legacy/v6/conformance.d.ts +15 -0
- package/dist/application/query/legacy/v6/conformance.js +46 -0
- package/dist/application/query/legacy/v6/define.d.ts +37 -0
- package/dist/application/query/legacy/v6/define.js +90 -0
- package/dist/application/query/legacy/v6/execution/execute.d.ts +18 -0
- package/dist/application/query/legacy/v6/execution/execute.js +50 -0
- package/dist/application/query/legacy/v6/index.d.ts +7 -0
- package/dist/application/query/legacy/v6/index.js +3 -0
- package/dist/application/query/legacy/v6/kernel.d.ts +6 -0
- package/dist/application/query/legacy/v6/kernel.js +5 -0
- package/dist/application/query/{single → legacy/v6/single}/pagination.js +1 -1
- package/dist/application/query/{single → legacy/v6/single}/query.d.ts +2 -14
- package/dist/application/query/legacy/v6/single/query.js +1 -0
- package/dist/application/query/query.d.ts +19 -4
- package/dist/application/requirements/canonical.d.ts +7 -0
- package/dist/application/requirements/canonical.js +16 -0
- package/dist/application/requirements/classes.d.ts +9 -7
- package/dist/application/requirements/classes.js +35 -42
- package/dist/application/requirements/functions.d.ts +3 -1
- package/dist/application/requirements/functions.js +12 -27
- package/dist/application/requirements/index.d.ts +34 -16
- package/dist/application/requirements/index.js +17 -20
- package/dist/application/requirements/legacy/authority.d.ts +21 -0
- package/dist/application/requirements/{authority.js → legacy/authority.js} +5 -2
- package/dist/application/requirements/legacy/classes.d.ts +22 -0
- package/dist/application/requirements/legacy/classes.js +24 -0
- package/dist/application/requirements/legacy/core.d.ts +30 -0
- package/dist/application/requirements/{core.js → legacy/core.js} +15 -13
- package/dist/application/requirements/legacy/functions.d.ts +7 -0
- package/dist/application/requirements/legacy/functions.js +15 -0
- package/dist/application/requirements/legacy/index.d.ts +43 -0
- package/dist/application/requirements/legacy/index.js +1 -0
- package/dist/application/requirements/legacy/requirements.d.ts +31 -0
- package/dist/application/requirements/legacy/requirements.js +31 -0
- package/dist/application/requirements/requirement.d.ts +30 -19
- package/dist/application/requirements/roles.d.ts +17 -0
- package/dist/application/requirements/roles.js +62 -0
- package/dist/application/requirements/scopes.d.ts +16 -0
- package/dist/application/requirements/scopes.js +34 -0
- package/dist/application/routes/admission.d.ts +3 -3
- package/dist/application/routes/admission.js +3 -3
- package/dist/application/routes/index.d.ts +3 -2
- package/dist/application/routes/route.d.ts +3 -3
- package/dist/application/runtime/actions.js +3 -0
- package/dist/application/runtime/declarations.d.ts +6 -6
- package/dist/application/runtime/define.d.ts +5 -5
- package/dist/application/runtime/runtime.js +12 -0
- package/dist/application/runtime/workflows.d.ts +3 -1
- package/dist/application/runtime/workflows.js +3 -4
- package/dist/application/view/define.js +4 -6
- package/dist/application/view/frontend.d.ts +2 -2
- package/dist/application/view/index.d.ts +1 -1
- package/dist/application/view/route.d.ts +0 -14
- package/dist/application/view/route.js +1 -64
- package/dist/application/workflow/authoring.d.ts +3 -2
- package/dist/application/workflow/context.d.ts +8 -2
- package/dist/application/workflow/define.d.ts +4 -4
- package/dist/application/workflow/define.js +14 -9
- package/dist/application/workflow/durable.d.ts +211 -0
- package/dist/application/workflow/durable.js +1 -0
- package/dist/application/workflow/index.d.ts +3 -2
- package/dist/application/workflow/runner/inline.js +1 -0
- package/dist/application/workflow/runner/runner.d.ts +2 -2
- package/dist/application/workflow/workflow.d.ts +5 -3
- package/dist/deployment/adapter/adapter.d.ts +55 -13
- package/dist/deployment/adapter/bundle/bundle.d.ts +36 -0
- package/dist/deployment/adapter/bundle/bundle.js +1 -0
- package/dist/deployment/adapter/bundle/file.d.ts +10 -0
- package/dist/deployment/adapter/bundle/file.js +1 -0
- package/dist/deployment/adapter/bundle/index.d.ts +2 -0
- package/dist/deployment/adapter/bundle/index.js +1 -0
- package/dist/deployment/adapter/define.d.ts +4 -3
- package/dist/deployment/adapter/define.js +107 -23
- package/dist/deployment/adapter/index.d.ts +4 -3
- package/dist/deployment/adapter/index.js +1 -0
- package/dist/deployment/adapter/release/command.d.ts +33 -0
- package/dist/deployment/adapter/release/command.js +1 -0
- package/dist/deployment/adapter/release/context.d.ts +94 -0
- package/dist/deployment/adapter/release/context.js +1 -0
- package/dist/deployment/adapter/release/index.d.ts +4 -0
- package/dist/deployment/adapter/release/index.js +1 -0
- package/dist/deployment/adapter/release/list.d.ts +53 -0
- package/dist/deployment/adapter/release/list.js +1 -0
- package/dist/deployment/adapter/release/refusal.d.ts +10 -0
- package/dist/deployment/adapter/release/refusal.js +14 -0
- package/dist/deployment/adapter/release/result.d.ts +56 -0
- package/dist/deployment/adapter/release/result.js +1 -0
- package/dist/deployment/address/configuration.d.ts +96 -0
- package/dist/deployment/address/configuration.js +274 -0
- package/dist/deployment/address/fingerprint.d.ts +5 -0
- package/dist/deployment/address/fingerprint.js +27 -0
- package/dist/deployment/address/index.d.ts +5 -0
- package/dist/deployment/address/index.js +4 -0
- package/dist/deployment/address/label.d.ts +42 -0
- package/dist/deployment/address/label.js +80 -0
- package/dist/deployment/address/line.d.ts +29 -0
- package/dist/deployment/address/line.js +53 -0
- package/dist/deployment/address/record.d.ts +73 -0
- package/dist/deployment/address/record.js +138 -0
- package/dist/deployment/address/summary.d.ts +30 -0
- package/dist/deployment/address/summary.js +1 -0
- package/dist/deployment/address/vectors.d.ts +60 -0
- package/dist/deployment/address/vectors.js +517 -0
- package/dist/deployment/authoring.d.ts +0 -2
- package/dist/deployment/authoring.js +0 -1
- package/dist/deployment/build/build.d.ts +13 -2
- package/dist/deployment/build/compile.d.ts +4 -4
- package/dist/deployment/build/compile.js +31 -81
- package/dist/deployment/build/frontend/compilation.d.ts +2 -4
- package/dist/deployment/build/frontend/compilation.js +0 -5
- package/dist/deployment/build/frontend/digest.js +1 -5
- package/dist/deployment/build/index.d.ts +1 -0
- package/dist/deployment/build/index.js +1 -0
- package/dist/deployment/build/legacy/requirements.d.ts +11 -0
- package/dist/deployment/build/legacy/requirements.js +79 -0
- package/dist/deployment/build/manifest.d.ts +59 -0
- package/dist/deployment/build/manifest.js +118 -0
- package/dist/deployment/build/material.d.ts +2 -2
- package/dist/deployment/build/material.js +28 -13
- package/dist/deployment/build/schema.d.ts +2 -2
- package/dist/deployment/deployment.d.ts +3 -2
- package/dist/deployment/environment.d.ts +6 -0
- package/dist/deployment/environment.js +6 -0
- package/dist/deployment/index.d.ts +4 -6
- package/dist/deployment/index.js +1 -2
- package/dist/deployment/release/addressing.d.ts +6 -5
- package/dist/deployment/release/addressing.js +2 -3
- package/dist/deployment/release/assemble.d.ts +6 -3
- package/dist/deployment/release/assemble.js +12 -10
- package/dist/deployment/release/release.d.ts +16 -5
- package/dist/deployment/release/seal.d.ts +14 -0
- package/dist/deployment/release/seal.js +22 -0
- package/dist/deployment/release/{publication → served}/callables.d.ts +2 -2
- package/dist/deployment/release/{publication → served}/callables.js +2 -2
- package/dist/deployment/release/served/index.d.ts +11 -0
- package/dist/deployment/release/served/index.js +26 -0
- package/dist/deployment/release/{publication → served}/views.d.ts +2 -2
- package/dist/deployment/release/{publication → served}/views.js +0 -1
- package/dist/deployment/runtime/admission.d.ts +2 -2
- package/dist/deployment/runtime/admission.js +5 -5
- package/dist/deployment/verify/index.d.ts +3 -4
- package/dist/deployment/verify/index.js +2 -3
- package/dist/deployment/verify/preflight/bundle.d.ts +18 -0
- package/dist/deployment/verify/preflight/bundle.js +71 -0
- package/dist/deployment/verify/preflight/index.d.ts +1 -12
- package/dist/deployment/verify/preflight/index.js +1 -12
- package/dist/deployment/verify/readiness/fetch.d.ts +13 -0
- package/dist/deployment/verify/readiness/fetch.js +26 -0
- package/dist/deployment/verify/readiness/identity.d.ts +3 -6
- package/dist/deployment/verify/readiness/identity.js +3 -3
- package/dist/deployment/verify/readiness/index.d.ts +15 -8
- package/dist/deployment/verify/readiness/index.js +25 -6
- package/dist/deployment/verify/readiness/release.d.ts +8 -0
- package/dist/deployment/verify/readiness/release.js +22 -0
- package/dist/deployment/worker/address.d.ts +26 -0
- package/dist/deployment/worker/address.js +43 -0
- package/dist/deployment/worker/build.d.ts +60 -0
- package/dist/deployment/worker/build.js +172 -0
- package/dist/deployment/worker/configuration.d.ts +73 -0
- package/dist/deployment/worker/configuration.js +165 -0
- package/dist/deployment/worker/content.d.ts +38 -0
- package/dist/deployment/worker/content.js +169 -0
- package/dist/deployment/worker/index.d.ts +29 -0
- package/dist/deployment/worker/index.js +29 -0
- package/dist/deployment/worker/limits.d.ts +30 -0
- package/dist/deployment/worker/limits.js +30 -0
- package/dist/deployment/worker/record.d.ts +29 -0
- package/dist/deployment/worker/record.js +69 -0
- package/dist/deployment/worker/request.d.ts +118 -0
- package/dist/deployment/worker/request.js +280 -0
- package/dist/deployment/worker/response.d.ts +101 -0
- package/dist/deployment/worker/response.js +207 -0
- package/dist/execution/cache/cache.d.ts +17 -0
- package/dist/execution/cache/cache.js +11 -0
- package/dist/execution/cache/index.d.ts +2 -0
- package/dist/execution/cache/index.js +2 -0
- package/dist/execution/cache/memory.d.ts +13 -0
- package/dist/execution/cache/memory.js +48 -0
- package/dist/execution/identity/authentication.d.ts +33 -3
- package/dist/execution/identity/authentication.js +95 -36
- package/dist/execution/identity/callback.d.ts +20 -20
- package/dist/execution/identity/callback.js +34 -26
- package/dist/execution/identity/delivery.d.ts +6 -4
- package/dist/execution/identity/delivery.js +25 -20
- package/dist/execution/identity/exchange.js +11 -1
- package/dist/execution/identity/identity.d.ts +17 -3
- package/dist/execution/identity/identity.js +12 -4
- package/dist/execution/identity/jwks.d.ts +5 -0
- package/dist/execution/identity/jwks.js +92 -102
- package/dist/execution/index.d.ts +6 -4
- package/dist/execution/index.js +4 -2
- package/dist/execution/invocation/admission/age.d.ts +57 -0
- package/dist/execution/invocation/admission/age.js +208 -0
- package/dist/execution/invocation/admission/authentication.d.ts +13 -13
- package/dist/execution/invocation/admission/authentication.js +52 -44
- package/dist/execution/invocation/admission/authority.d.ts +28 -6
- package/dist/execution/invocation/admission/authority.js +9 -2
- package/dist/execution/invocation/admission/index.d.ts +4 -3
- package/dist/execution/invocation/admission/index.js +3 -2
- package/dist/execution/invocation/admission/input.d.ts +2 -2
- package/dist/execution/invocation/admission/input.js +16 -2
- package/dist/execution/invocation/admission/target.d.ts +11 -0
- package/dist/execution/invocation/admission/target.js +22 -3
- package/dist/execution/invocation/capabilities/bind.d.ts +14 -0
- package/dist/execution/invocation/capabilities/bind.js +74 -0
- package/dist/execution/invocation/capabilities/index.d.ts +1 -0
- package/dist/execution/invocation/capabilities/index.js +1 -0
- package/dist/execution/invocation/dependency/bind.d.ts +3 -1
- package/dist/execution/invocation/dependency/bind.js +36 -16
- package/dist/execution/invocation/dispatch/action.js +4 -2
- package/dist/execution/invocation/dispatch/context.d.ts +8 -7
- package/dist/execution/invocation/dispatch/context.js +34 -45
- package/dist/execution/invocation/dispatch/workflow.js +4 -6
- package/dist/execution/invocation/handler.js +8 -2
- package/dist/execution/invocation/index.d.ts +2 -2
- package/dist/execution/invocation/index.js +1 -1
- package/dist/execution/invocation/integration/authentication.d.ts +3 -3
- package/dist/execution/invocation/integration/authentication.js +7 -7
- package/dist/execution/invocation/integration/call.d.ts +2 -1
- package/dist/execution/invocation/integration/call.js +3 -3
- package/dist/execution/invocation/integration/clients.d.ts +1 -1
- package/dist/execution/invocation/integration/index.d.ts +1 -0
- package/dist/execution/invocation/integration/index.js +1 -0
- package/dist/execution/invocation/invocation.d.ts +6 -0
- package/dist/execution/invocation/invocation.js +130 -22
- package/dist/execution/invocation/lifecycle/active.d.ts +8 -2
- package/dist/execution/invocation/lifecycle/active.js +3 -3
- package/dist/execution/invocation/lifecycle/index.d.ts +1 -1
- package/dist/execution/invocation/result/errors.d.ts +0 -10
- package/dist/execution/invocation/result/errors.js +12 -16
- package/dist/execution/invocation/result/index.d.ts +3 -2
- package/dist/execution/invocation/result/index.js +2 -1
- package/dist/execution/invocation/result/project.js +41 -1
- package/dist/execution/invocation/result/undeclared.d.ts +7 -0
- package/dist/execution/invocation/result/undeclared.js +18 -0
- package/dist/execution/node/serve.d.ts +2 -2
- package/dist/execution/node/serve.js +1 -1
- package/dist/execution/runtime/index.d.ts +1 -0
- package/dist/execution/runtime/index.js +1 -0
- package/dist/execution/runtime/load.d.ts +3 -3
- package/dist/execution/runtime/load.js +3 -2
- package/dist/execution/runtime/release.d.ts +17 -0
- package/dist/execution/runtime/release.js +7 -0
- package/dist/execution/serve.d.ts +18 -4
- package/dist/execution/serve.js +10 -0
- package/dist/execution/service/create.js +43 -7
- package/dist/execution/service/initialization.d.ts +4 -4
- package/dist/execution/service/initialization.js +23 -14
- package/dist/execution/service/release.d.ts +2 -2
- package/dist/execution/service/release.js +3 -2
- package/dist/execution/service/service.d.ts +20 -5
- package/dist/execution/service/serving/delivery.d.ts +5 -0
- package/dist/execution/service/{publication → serving}/delivery.js +4 -1
- package/dist/execution/service/{publication → serving}/index.d.ts +1 -1
- package/dist/execution/service/serving/installation.d.ts +4 -0
- package/dist/execution/service/serving/installation.js +9 -0
- package/dist/execution/service/serving/source.d.ts +11 -0
- package/dist/execution/service/serving/source.js +15 -0
- package/dist/execution/workflows/attempts.d.ts +87 -0
- package/dist/execution/workflows/attempts.js +205 -0
- package/dist/execution/workflows/discovery.d.ts +14 -0
- package/dist/execution/workflows/discovery.js +151 -0
- package/dist/execution/workflows/engine.d.ts +83 -0
- package/dist/execution/workflows/engine.js +1 -0
- package/dist/execution/workflows/envelope.d.ts +12 -0
- package/dist/execution/workflows/envelope.js +46 -0
- package/dist/execution/workflows/failure.d.ts +56 -0
- package/dist/execution/workflows/failure.js +204 -0
- package/dist/execution/workflows/index.d.ts +4 -0
- package/dist/execution/workflows/index.js +3 -0
- package/dist/execution/workflows/integrations.d.ts +13 -0
- package/dist/execution/workflows/integrations.js +25 -0
- package/dist/execution/workflows/options.d.ts +81 -0
- package/dist/execution/workflows/options.js +158 -0
- package/dist/execution/workflows/receiver.d.ts +24 -0
- package/dist/execution/workflows/receiver.js +99 -0
- package/dist/execution/workflows/route.d.ts +12 -0
- package/dist/execution/workflows/route.js +35 -0
- package/dist/execution/workflows/run.d.ts +23 -0
- package/dist/execution/workflows/run.js +369 -0
- package/dist/execution/workflows/steps.d.ts +48 -0
- package/dist/execution/workflows/steps.js +93 -0
- package/dist/index.d.ts +5 -5
- package/dist/index.js +2 -2
- package/dist/platform/graph/alias.d.ts +1 -5
- package/dist/platform/graph/alias.js +1 -5
- package/dist/platform/graph/document/index.d.ts +1 -1
- package/dist/platform/graph/document/index.js +1 -1
- package/dist/platform/graph/index.d.ts +1 -1
- package/dist/platform/graph/index.js +1 -1
- package/dist/platform/release/index.d.ts +2 -0
- package/dist/platform/release/index.js +2 -0
- package/dist/platform/schema/callable-authoring.d.ts +21 -0
- package/dist/platform/schema/callable-authoring.js +27 -0
- package/dist/platform/schema/class-authoring.d.ts +58 -12
- package/dist/platform/schema/class-authoring.js +38 -4
- package/dist/platform/schema/class-icon-svg.d.ts +9 -0
- package/dist/platform/schema/class-icon-svg.js +29 -0
- package/dist/platform/schema/class-icon.d.ts +3 -8
- package/dist/platform/schema/class-icon.js +2 -29
- package/dist/platform/schema/index.d.ts +11 -4
- package/dist/platform/schema/index.js +2 -1
- package/dist/platform/schema/kernel-compiled.d.ts +2 -0
- package/dist/platform/schema/kernel-compiled.js +2 -0
- package/dist/platform/schema/kernel.d.ts +4 -2
- package/dist/platform/schema/property.d.ts +5 -0
- package/dist/platform/schema/references/index.d.ts +6 -0
- package/dist/platform/schema/references/index.js +1 -0
- package/dist/platform/schema/schema-authoring.d.ts +14 -7
- package/dist/platform/schema/schema-authoring.js +5 -1
- package/dist/platform/versioning/dependents.d.ts +18 -0
- package/dist/platform/versioning/dependents.js +15 -0
- package/dist/platform/versioning/index.d.ts +5 -0
- package/dist/platform/versioning/index.js +5 -0
- package/dist/platform/versioning/name.d.ts +38 -0
- package/dist/platform/versioning/name.js +58 -0
- package/dist/platform/versioning/reference.d.ts +48 -0
- package/dist/platform/versioning/reference.js +95 -0
- package/dist/platform/versioning/version.d.ts +72 -0
- package/dist/platform/versioning/version.js +98 -0
- package/dist/project/admit.js +1 -5
- package/dist/project/define.d.ts +4 -4
- package/dist/project/define.js +55 -35
- package/dist/project/index.d.ts +1 -1
- package/dist/project/install-command.d.ts +6 -0
- package/dist/project/install-command.js +9 -0
- package/dist/project/project.d.ts +10 -8
- package/dist/testing/dataset/define.d.ts +1 -1
- package/dist/testing/durable/engine.d.ts +128 -0
- package/dist/testing/durable/engine.js +619 -0
- package/dist/testing/durable/index.d.ts +3 -0
- package/dist/testing/durable/index.js +1 -0
- package/dist/testing/durable/steps.d.ts +30 -0
- package/dist/testing/durable/steps.js +45 -0
- package/dist/testing/file.d.ts +20 -0
- package/dist/testing/file.js +49 -0
- package/dist/testing/index.d.ts +10 -1
- package/dist/testing/index.js +7 -1
- package/dist/testing/load.js +1 -1
- package/dist/testing/query.d.ts +22 -0
- package/dist/testing/query.js +36 -0
- package/dist/tooling/cli/adapter-command.d.ts +35 -0
- package/dist/tooling/cli/adapter-command.js +66 -0
- package/dist/tooling/cli/arguments.d.ts +17 -6
- package/dist/tooling/cli/arguments.js +175 -52
- package/dist/tooling/cli/build.d.ts +55 -0
- package/dist/tooling/cli/build.js +77 -0
- package/dist/tooling/cli/bun.d.ts +0 -1
- package/dist/tooling/cli/bun.js +0 -7
- package/dist/tooling/cli/commit.d.ts +35 -0
- package/dist/tooling/cli/commit.js +235 -0
- package/dist/tooling/cli/deploy-mode.d.ts +26 -0
- package/dist/tooling/cli/deploy-mode.js +59 -0
- package/dist/tooling/cli/deploy-result.d.ts +80 -0
- package/dist/tooling/cli/deploy-result.js +64 -0
- package/dist/tooling/cli/diff/declared.d.ts +7 -0
- package/dist/tooling/cli/diff/declared.js +27 -0
- package/dist/tooling/cli/diff/index.d.ts +30 -0
- package/dist/tooling/cli/diff/index.js +58 -0
- package/dist/tooling/cli/diff/render.d.ts +15 -0
- package/dist/tooling/cli/diff/render.js +131 -0
- package/dist/tooling/cli/diff/report.d.ts +88 -0
- package/dist/tooling/cli/diff/report.js +154 -0
- package/dist/tooling/cli/dotenv.d.ts +5 -5
- package/dist/tooling/cli/dotenv.js +6 -36
- package/dist/tooling/cli/help.js +173 -60
- package/dist/tooling/cli/immutable-deployment.d.ts +83 -0
- package/dist/tooling/cli/immutable-deployment.js +135 -0
- package/dist/tooling/cli/index.d.ts +12 -4
- package/dist/tooling/cli/index.js +6 -3
- package/dist/tooling/cli/installed-on.d.ts +83 -0
- package/dist/tooling/cli/installed-on.js +156 -0
- package/dist/tooling/cli/list.d.ts +152 -0
- package/dist/tooling/cli/list.js +331 -0
- package/dist/tooling/cli/log.d.ts +5 -2
- package/dist/tooling/cli/log.js +9 -2
- package/dist/tooling/cli/orchestrate.d.ts +0 -6
- package/dist/tooling/cli/orchestrate.js +252 -91
- package/dist/tooling/cli/project.d.ts +3 -3
- package/dist/tooling/cli/publish/index.d.ts +81 -0
- package/dist/tooling/cli/publish/index.js +383 -0
- package/dist/tooling/cli/publish/report.d.ts +49 -0
- package/dist/tooling/cli/publish/report.js +15 -0
- package/dist/tooling/cli/registry/client.d.ts +121 -0
- package/dist/tooling/cli/registry/client.js +354 -0
- package/dist/tooling/cli/registry/error.d.ts +11 -0
- package/dist/tooling/cli/registry/error.js +17 -0
- package/dist/tooling/cli/registry/executable.d.ts +35 -0
- package/dist/tooling/cli/registry/executable.js +96 -0
- package/dist/tooling/cli/registry/index.d.ts +9 -0
- package/dist/tooling/cli/registry/index.js +8 -0
- package/dist/tooling/cli/registry/installations.d.ts +67 -0
- package/dist/tooling/cli/registry/installations.js +108 -0
- package/dist/tooling/cli/registry/process.d.ts +36 -0
- package/dist/tooling/cli/registry/process.js +119 -0
- package/dist/tooling/cli/secrets.d.ts +9 -0
- package/dist/tooling/cli/secrets.js +19 -0
- package/dist/tooling/cli/yank.d.ts +34 -0
- package/dist/tooling/cli/yank.js +32 -0
- package/dist/tooling/linter/adapters/typescript/definition-calls.d.ts +34 -0
- package/dist/tooling/linter/adapters/typescript/definition-calls.js +88 -0
- package/dist/tooling/linter/adapters/typescript/discover.js +8 -2
- package/dist/tooling/linter/adapters/typescript/imports.d.ts +0 -1
- package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
- package/dist/tooling/linter/adapters/typescript/index.d.ts +9 -2
- package/dist/tooling/linter/adapters/typescript/index.js +4 -2
- package/dist/tooling/linter/adapters/typescript/legacy.d.ts +20 -0
- package/dist/tooling/linter/adapters/typescript/legacy.js +28 -0
- package/dist/tooling/linter/adapters/typescript/query-observation.js +37 -12
- package/dist/tooling/linter/adapters/typescript/syntax.d.ts +3 -3
- package/dist/tooling/linter/adapters/typescript/syntax.js +13 -25
- package/dist/tooling/linter/adapters/typescript/type-analysis.d.ts +2 -0
- package/dist/tooling/linter/adapters/typescript/type-analysis.js +10 -0
- package/dist/tooling/linter/implementations/source/callable-requirements.d.ts +2 -4
- package/dist/tooling/linter/implementations/source/callable-requirements.js +16 -58
- package/dist/tooling/linter/implementations/source/const-initializer.d.ts +3 -0
- package/dist/tooling/linter/implementations/source/const-initializer.js +31 -0
- package/dist/tooling/linter/implementations/source/definitions.d.ts +2 -0
- package/dist/tooling/linter/implementations/source/definitions.js +425 -0
- package/dist/tooling/linter/implementations/source/dependencies.js +13 -72
- package/dist/tooling/linter/implementations/source/domain-requirements.d.ts +8 -0
- package/dist/tooling/linter/implementations/source/domain-requirements.js +35 -0
- package/dist/tooling/linter/implementations/source/global.js +39 -19
- package/dist/tooling/linter/implementations/source/legacy/requirements.d.ts +10 -0
- package/dist/tooling/linter/implementations/source/legacy/requirements.js +40 -0
- package/dist/tooling/linter/implementations/source/legacy-folders.d.ts +3 -0
- package/dist/tooling/linter/implementations/source/legacy-folders.js +126 -0
- package/dist/tooling/linter/implementations/source/mutations.js +153 -70
- package/dist/tooling/linter/implementations/source/policy-edges.d.ts +2 -0
- package/dist/tooling/linter/implementations/source/policy-edges.js +113 -0
- package/dist/tooling/linter/implementations/source/providers.js +5 -5
- package/dist/tooling/linter/implementations/source/queries.js +1 -17
- package/dist/tooling/linter/implementations/source/requirement-entries.d.ts +24 -0
- package/dist/tooling/linter/implementations/source/requirement-entries.js +52 -0
- package/dist/tooling/linter/implementations/source/runtime-imports.d.ts +2 -0
- package/dist/tooling/linter/implementations/source/runtime-imports.js +119 -0
- package/dist/tooling/linter/implementations/source/schema.d.ts +3 -0
- package/dist/tooling/linter/implementations/source/schema.js +9 -5
- package/dist/tooling/linter/implementations/source/shared.d.ts +19 -5
- package/dist/tooling/linter/implementations/source/shared.js +131 -55
- package/dist/tooling/linter/implementations/source/tests.js +1 -1
- package/dist/tooling/linter/implementations/source/verifiers.js +8 -2
- package/dist/tooling/linter/implementations/source/views.js +2 -2
- package/dist/tooling/linter/implementations/source/workflows.js +499 -17
- package/dist/tooling/linter/policy/generated.js +18 -67
- package/dist/tooling/linter/requirements/registry.js +14 -9
- package/dist/tooling/packaging/declarations/ownership.js +1 -1
- package/dist/tooling/packaging/finalize.d.ts +1 -1
- package/dist/tooling/packaging/finalize.js +1 -1
- package/docs/accounts/scenarios.tsv +12 -0
- package/docs/admission-age.md +88 -0
- package/docs/auth-api-migration.md +57 -0
- package/docs/business-errors.md +42 -0
- package/docs/domain-definition-migration.md +44 -0
- package/docs/domain-schema-migration.md +36 -0
- package/docs/durable-workflows.md +530 -0
- package/docs/handler-dependencies.md +381 -0
- package/docs/legacy/query-v6.md +62 -0
- package/docs/legacy.md +113 -0
- package/docs/queries.md +493 -0
- package/docs/release.md +155 -0
- package/docs/requirements.md +143 -0
- package/docs/schema-cost.md +124 -0
- package/package.json +62 -26
- package/dist/application/application.d.ts +0 -28
- package/dist/application/query/execution/projection.d.ts +0 -3
- package/dist/application/query/execution/projection.js +0 -3
- package/dist/application/requirements/authority.d.ts +0 -7
- package/dist/application/requirements/core.d.ts +0 -14
- package/dist/deployment/adapter/deploy/context.d.ts +0 -15
- package/dist/deployment/adapter/deploy/index.d.ts +0 -2
- package/dist/deployment/adapter/deploy/result.d.ts +0 -50
- package/dist/deployment/adapter/prepare/artifact.d.ts +0 -33
- package/dist/deployment/adapter/prepare/context.d.ts +0 -23
- package/dist/deployment/adapter/prepare/index.d.ts +0 -2
- package/dist/deployment/deploy.d.ts +0 -20
- package/dist/deployment/deploy.js +0 -31
- package/dist/deployment/release/publication/index.d.ts +0 -6
- package/dist/deployment/release/publication/index.js +0 -6
- package/dist/deployment/release/publication/manifest.d.ts +0 -3
- package/dist/deployment/release/publication/manifest.js +0 -5
- package/dist/deployment/release/publication/requirements.d.ts +0 -3
- package/dist/deployment/release/publication/requirements.js +0 -3
- package/dist/deployment/release/publication/seal.d.ts +0 -10
- package/dist/deployment/release/publication/seal.js +0 -39
- package/dist/deployment/verify/preflight/artifact.d.ts +0 -6
- package/dist/deployment/verify/preflight/artifact.js +0 -122
- package/dist/deployment/verify/preflight/publication.d.ts +0 -4
- package/dist/deployment/verify/preflight/publication.js +0 -14
- package/dist/deployment/verify/readiness/deployment.d.ts +0 -3
- package/dist/deployment/verify/readiness/deployment.js +0 -151
- package/dist/deployment/verify/readiness/publication.d.ts +0 -11
- package/dist/deployment/verify/readiness/publication.js +0 -41
- package/dist/execution/service/errors.d.ts +0 -3
- package/dist/execution/service/errors.js +0 -3
- package/dist/execution/service/publication/delivery.d.ts +0 -2
- package/dist/execution/service/publication/installation.d.ts +0 -3
- package/dist/execution/service/publication/installation.js +0 -8
- package/dist/execution/service/publication/source.d.ts +0 -3
- package/dist/execution/service/publication/source.js +0 -11
- package/dist/platform/publication/index.d.ts +0 -2
- package/dist/platform/publication/index.js +0 -2
- package/dist/tooling/cli/astrale/authority.d.ts +0 -5
- package/dist/tooling/cli/astrale/authority.js +0 -11
- package/dist/tooling/cli/astrale/executable.d.ts +0 -2
- package/dist/tooling/cli/astrale/executable.js +0 -47
- package/dist/tooling/cli/astrale/failure.d.ts +0 -6
- package/dist/tooling/cli/astrale/failure.js +0 -48
- package/dist/tooling/cli/astrale/instance.d.ts +0 -11
- package/dist/tooling/cli/astrale/instance.js +0 -52
- package/dist/tooling/cli/astrale/process.d.ts +0 -13
- package/dist/tooling/cli/astrale/process.js +0 -94
- package/dist/tooling/cli/astrale/version.d.ts +0 -18
- package/dist/tooling/cli/astrale/version.js +0 -55
- package/dist/tooling/cli/credential.d.ts +0 -2
- package/dist/tooling/cli/credential.js +0 -57
- package/dist/tooling/cli/deprecations.d.ts +0 -9
- package/dist/tooling/cli/deprecations.js +0 -15
- package/dist/tooling/cli/development/candidate.d.ts +0 -25
- package/dist/tooling/cli/development/candidate.js +0 -176
- package/dist/tooling/cli/development/deployment.d.ts +0 -16
- package/dist/tooling/cli/development/deployment.js +0 -39
- package/dist/tooling/cli/development/develop.d.ts +0 -11
- package/dist/tooling/cli/development/develop.js +0 -243
- package/dist/tooling/cli/development/lease.d.ts +0 -18
- package/dist/tooling/cli/development/lease.js +0 -163
- package/dist/tooling/cli/development/lifecycle.d.ts +0 -9
- package/dist/tooling/cli/development/lifecycle.js +0 -43
- package/dist/tooling/cli/development/project-imports.d.ts +0 -22
- package/dist/tooling/cli/development/project-imports.js +0 -39
- package/dist/tooling/cli/development/project-lock.d.ts +0 -16
- package/dist/tooling/cli/development/project-lock.js +0 -41
- package/dist/tooling/cli/development/rebuild.d.ts +0 -13
- package/dist/tooling/cli/development/rebuild.js +0 -58
- package/dist/tooling/cli/development/release-evidence.d.ts +0 -4
- package/dist/tooling/cli/development/release-evidence.js +0 -10
- package/dist/tooling/cli/development/report.d.ts +0 -6
- package/dist/tooling/cli/development/report.js +0 -14
- package/dist/tooling/cli/development/session-file.d.ts +0 -53
- package/dist/tooling/cli/development/session-file.js +0 -337
- package/dist/tooling/cli/development/source-watch.d.ts +0 -14
- package/dist/tooling/cli/development/source-watch.js +0 -140
- package/dist/tooling/cli/development/sources.d.ts +0 -7
- package/dist/tooling/cli/development/sources.js +0 -48
- package/dist/tooling/cli/development/target-lock.d.ts +0 -16
- package/dist/tooling/cli/development/target-lock.js +0 -68
- package/dist/tooling/cli/development/view.d.ts +0 -28
- package/dist/tooling/cli/development/view.js +0 -151
- package/dist/tooling/cli/environment-release.d.ts +0 -21
- package/dist/tooling/cli/environment-release.js +0 -46
- package/dist/tooling/cli/evidence.d.ts +0 -11
- package/dist/tooling/cli/evidence.js +0 -53
- package/dist/tooling/cli/installation/index.d.ts +0 -2
- package/dist/tooling/cli/installation/index.js +0 -1
- package/dist/tooling/cli/installation/observation.d.ts +0 -10
- package/dist/tooling/cli/installation/observation.js +0 -44
- package/dist/tooling/cli/installation/reconcile.d.ts +0 -32
- package/dist/tooling/cli/installation/reconcile.js +0 -122
- package/dist/tooling/linter/implementations/source/migrations.d.ts +0 -2
- package/dist/tooling/linter/implementations/source/migrations.js +0 -113
- package/dist/tooling/linter/qualification/index.d.ts +0 -10
- package/dist/tooling/linter/qualification/index.js +0 -2
- package/dist/tooling/linter/qualification/query-fixtures.d.ts +0 -2
- package/dist/tooling/linter/qualification/query-fixtures.js +0 -68
- package/dist/tooling/linter/qualification/runner.d.ts +0 -3
- package/dist/tooling/linter/qualification/runner.js +0 -6
- /package/dist/application/{application.js → domain.js} +0 -0
- /package/dist/application/{query/single/query.js → mutation/legacy/v6/builder.js} +0 -0
- /package/dist/{deployment/adapter/deploy/context.js → application/mutation/legacy/v6/mutation.js} +0 -0
- /package/dist/application/mutation/{authoring → legacy/v6}/precondition.js +0 -0
- /package/dist/{deployment/adapter/deploy/index.js → application/query/answer/answer.js} +0 -0
- /package/dist/{deployment/adapter/deploy/result.js → application/query/defined/query.js} +0 -0
- /package/dist/{deployment/adapter/prepare/artifact.js → application/query/execution/client.js} +0 -0
- /package/dist/{deployment/adapter/prepare/context.js → application/query/handles/conditions.js} +0 -0
- /package/dist/{deployment/adapter/prepare/index.js → application/query/handles/domain.js} +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/identity.js +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/limits.d.ts +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/limits.js +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/metadata.js +0 -0
- /package/dist/application/query/{execution → legacy/v6/execution}/pages.d.ts +0 -0
- /package/dist/application/query/{execution → legacy/v6/execution}/pages.js +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/index.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/index.js +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/node.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/node.js +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/pagination.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/selection.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/selection.js +0 -0
- /package/dist/deployment/release/{publication → served}/routes.d.ts +0 -0
- /package/dist/deployment/release/{publication → served}/routes.js +0 -0
- /package/dist/execution/service/{publication → serving}/index.js +0 -0
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The name of a project environment, the target a deployment is made for (`staging`, `production`,
|
|
3
|
+
* `pr-42`), as `defineProject` admits it: lower-case letters, digits, `.`, `_` and `-`, starting and
|
|
4
|
+
* ending with a letter or a digit. It stays Worker-safe because a deployment name renders it.
|
|
5
|
+
*/
|
|
6
|
+
export const ENVIRONMENT_NAME = /^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/u;
|
|
@@ -1,14 +1,12 @@
|
|
|
1
1
|
export { defineAdapter, defineDeployment, isAdapter } from './adapter/index.js';
|
|
2
|
-
export type { Adapter, AdapterEnvironmentContext, AdapterInput,
|
|
2
|
+
export type { Adapter, AdapterCommand, AdapterCommandContext, AdapterCommandResult, AdapterEnvironmentContext, AdapterInput, ArtifactFile, Bundle, BundleContext, Bundler, BundleSource, ConfigureContext, DeploymentCallTarget, DeploymentSecretsState, FailedReleaseDeployResult, ListContext, ListedDeployment, MutationKnowledge, Placement, PlacementContext, PreparedArtifactFile, ReadyReleaseDeployResult, ReleaseDeployContext, ReleaseDeploymentPhase, ReleaseDeployResult, RetainContext, } from './adapter/index.js';
|
|
3
3
|
export { compile, isBuild } from './build/index.js';
|
|
4
|
-
export type { Build, BuildBundle, BuildSchema } from './build/index.js';
|
|
5
|
-
export { deploy } from './deploy.js';
|
|
6
|
-
export type { DeploymentInput, LegacyDeployment } from './deploy.js';
|
|
4
|
+
export type { Build, BuildBundle, BuildDigest, BuildManifestV1, BuildSchema, } from './build/index.js';
|
|
7
5
|
export { isDeployment } from './deployment.js';
|
|
8
6
|
export type { Deployment } from './deployment.js';
|
|
9
7
|
export { addressing, assemble, isAddressing, isRelease } from './release/index.js';
|
|
10
8
|
export type { Addressing, Release } from './release/index.js';
|
|
11
9
|
export { admit as admitRuntime, resolve as resolveRuntime, runtime } from './runtime/index.js';
|
|
12
10
|
export type { ResolvedRuntimeReference, RuntimeModuleLoader, RuntimeReference, } from './runtime/index.js';
|
|
13
|
-
export {
|
|
14
|
-
export type {
|
|
11
|
+
export { verifyBundle, verifyReadiness, verifyUploadedBuild } from './verify/index.js';
|
|
12
|
+
export type { BundleInput } from './verify/index.js';
|
package/dist/deployment/index.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
export { defineAdapter, defineDeployment, isAdapter } from './adapter/index.js';
|
|
2
2
|
export { compile, isBuild } from './build/index.js';
|
|
3
|
-
export { deploy } from './deploy.js';
|
|
4
3
|
export { isDeployment } from './deployment.js';
|
|
5
4
|
export { addressing, assemble, isAddressing, isRelease } from './release/index.js';
|
|
6
5
|
export { admit as admitRuntime, resolve as resolveRuntime, runtime } from './runtime/index.js';
|
|
7
|
-
export {
|
|
6
|
+
export { verifyBundle, verifyReadiness, verifyUploadedBuild } from './verify/index.js';
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
import type { IssuerId } from '../../platform/auth/index.js';
|
|
2
|
-
/**
|
|
2
|
+
/**
|
|
3
|
+
* Domain identity and public placement, independent of how a provider obtains them. A deployment's
|
|
4
|
+
* `addressing(url)` has `issuer === publicUrl`: its URL is its issuer.
|
|
5
|
+
*/
|
|
3
6
|
export interface Addressing {
|
|
4
7
|
readonly issuer: IssuerId;
|
|
5
|
-
/** Public origin serving this Release
|
|
8
|
+
/** Public origin serving this Release, identical to its issuer. */
|
|
6
9
|
readonly publicUrl: IssuerId;
|
|
7
10
|
}
|
|
8
|
-
export declare function addressing(input: string
|
|
9
|
-
readonly publicUrl?: string;
|
|
10
|
-
}): Addressing;
|
|
11
|
+
export declare function addressing(input: string): Addressing;
|
|
11
12
|
export declare function isAddressing(input: unknown): input is Addressing;
|
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
import { issuer } from '../../platform/auth/index.js';
|
|
2
2
|
const admittedAddressing = new WeakSet();
|
|
3
|
-
export function addressing(input
|
|
3
|
+
export function addressing(input) {
|
|
4
4
|
const admitted = origin(input);
|
|
5
|
-
const
|
|
6
|
-
const value = Object.freeze({ issuer: admitted, publicUrl });
|
|
5
|
+
const value = Object.freeze({ issuer: admitted, publicUrl: admitted });
|
|
7
6
|
admittedAddressing.add(value);
|
|
8
7
|
return value;
|
|
9
8
|
}
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
import type { Build } from '../build/build.js';
|
|
2
|
-
import type {
|
|
2
|
+
import type { BuildDigest } from '../build/manifest.js';
|
|
3
3
|
import type { Release } from './release.js';
|
|
4
|
-
/**
|
|
5
|
-
|
|
4
|
+
/**
|
|
5
|
+
* Purely assemble what one immutable deployment serves at its URL, which is also its issuer, from
|
|
6
|
+
* its Build and the build digest of the code it runs, without a provider effect.
|
|
7
|
+
*/
|
|
8
|
+
export declare function assemble<const BuildValue extends Build>(build: BuildValue, buildDigest: BuildDigest, url: string): Release<BuildValue>;
|
|
@@ -1,20 +1,22 @@
|
|
|
1
1
|
import { isBuild } from '../build/admission.js';
|
|
2
|
-
import {
|
|
2
|
+
import { addressing } from './addressing.js';
|
|
3
3
|
import { capture } from './admission.js';
|
|
4
|
-
import { seal } from './
|
|
5
|
-
/**
|
|
6
|
-
|
|
4
|
+
import { seal } from './seal.js';
|
|
5
|
+
/**
|
|
6
|
+
* Purely assemble what one immutable deployment serves at its URL, which is also its issuer, from
|
|
7
|
+
* its Build and the build digest of the code it runs, without a provider effect.
|
|
8
|
+
*/
|
|
9
|
+
export function assemble(build, buildDigest, url) {
|
|
7
10
|
if (!isBuild(build))
|
|
8
11
|
throw new TypeError('Release assembly requires an admitted Build.');
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
}
|
|
12
|
-
const sealed = seal(build, addressing);
|
|
12
|
+
const placed = addressing(url);
|
|
13
|
+
const sealed = seal(build, buildDigest, placed);
|
|
13
14
|
return capture(Object.freeze({
|
|
14
15
|
kind: 'release',
|
|
15
16
|
build,
|
|
16
|
-
|
|
17
|
-
|
|
17
|
+
url: placed.publicUrl,
|
|
18
|
+
document: sealed.document,
|
|
19
|
+
buildDigest: sealed.document.build.digest,
|
|
18
20
|
routes: sealed.routes,
|
|
19
21
|
}));
|
|
20
22
|
}
|
|
@@ -1,11 +1,22 @@
|
|
|
1
|
-
import type * as
|
|
1
|
+
import type * as release from '@astrale-os/kernel-protocol/release';
|
|
2
2
|
import type * as routes from '@astrale-os/kernel-protocol/routes';
|
|
3
|
-
import type {
|
|
4
|
-
import type {
|
|
3
|
+
import type { IssuerId } from '../../platform/auth/index.js';
|
|
4
|
+
import type { Build, BuildDigest } from '../build/index.js';
|
|
5
|
+
/**
|
|
6
|
+
* Everything one immutable deployment serves: the `DomainRelease` v4 it publishes at
|
|
7
|
+
* `release.json`, sealed from its Build, its URL and the build digest of its code, and the Route
|
|
8
|
+
* Table bound to that release.
|
|
9
|
+
*/
|
|
5
10
|
export interface Release<BuildValue extends Build = Build> {
|
|
6
11
|
readonly kind: 'release';
|
|
7
12
|
readonly build: BuildValue;
|
|
8
|
-
|
|
9
|
-
|
|
13
|
+
/**
|
|
14
|
+
* The deployment's URL: its origin, which is also its issuer (`document.identity.issuer`). A
|
|
15
|
+
* deployment binds both to the same immutable URL.
|
|
16
|
+
*/
|
|
17
|
+
readonly url: IssuerId;
|
|
18
|
+
readonly document: release.DomainRelease;
|
|
19
|
+
/** Digest of the exact bytes the deployment runs: `document.build.digest`. */
|
|
20
|
+
readonly buildDigest: BuildDigest;
|
|
10
21
|
readonly routes: routes.Table;
|
|
11
22
|
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
|
+
import * as protocolRoutes from '@astrale-os/kernel-protocol/routes';
|
|
3
|
+
import type { Build, BuildDigest } from '../build/index.js';
|
|
4
|
+
import type { Addressing } from './addressing.js';
|
|
5
|
+
export interface SealedRelease {
|
|
6
|
+
readonly document: release.DomainRelease;
|
|
7
|
+
readonly routes: protocolRoutes.Table;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Seal the `DomainRelease` v4 one deployment serves: the served content of the Build at its
|
|
11
|
+
* address, and the build digest of the exact code it runs. Its release digest therefore names the
|
|
12
|
+
* schema, the address and the code at once; the Route Table is bound to that release.
|
|
13
|
+
*/
|
|
14
|
+
export declare function seal(build: Build, buildDigest: BuildDigest, addressing: Addressing): SealedRelease;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
|
+
import * as protocolRoutes from '@astrale-os/kernel-protocol/routes';
|
|
3
|
+
import { evidenceOf } from '../build/admission.js';
|
|
4
|
+
import { served } from './served/index.js';
|
|
5
|
+
/**
|
|
6
|
+
* Seal the `DomainRelease` v4 one deployment serves: the served content of the Build at its
|
|
7
|
+
* address, and the build digest of the exact code it runs. Its release digest therefore names the
|
|
8
|
+
* schema, the address and the code at once; the Route Table is bound to that release.
|
|
9
|
+
*/
|
|
10
|
+
export function seal(build, buildDigest, addressing) {
|
|
11
|
+
const document = release.seal({
|
|
12
|
+
format: 'astrale.domain.release',
|
|
13
|
+
version: 4,
|
|
14
|
+
...served(build, addressing),
|
|
15
|
+
build: { digest: buildDigest },
|
|
16
|
+
});
|
|
17
|
+
const { domain } = evidenceOf(build);
|
|
18
|
+
return Object.freeze({
|
|
19
|
+
document,
|
|
20
|
+
routes: protocolRoutes.bind(build.routes, document, domain, addressing.publicUrl),
|
|
21
|
+
});
|
|
22
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
2
|
import type { Build } from '../../build/index.js';
|
|
3
3
|
import type { Addressing } from '../addressing.js';
|
|
4
|
-
export declare function callables(build: Build, addressing: Addressing): readonly
|
|
4
|
+
export declare function callables(build: Build, addressing: Addressing): readonly release.CallableBinding[];
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
2
|
import { invocationPath } from '../invocation.js';
|
|
3
3
|
export function callables(build, addressing) {
|
|
4
|
-
const endpoint =
|
|
4
|
+
const endpoint = release.acceptInvocationEndpoints({
|
|
5
5
|
http: new URL(invocationPath(), addressing.publicUrl).href,
|
|
6
6
|
});
|
|
7
7
|
return Object.freeze(build.callables.map((callable) => Object.freeze({ callable, endpoint })));
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
|
+
import type { Build } from '../../build/index.js';
|
|
3
|
+
import type { Addressing } from '../addressing.js';
|
|
4
|
+
export declare const DELIVERY_PATH: '/install';
|
|
5
|
+
/**
|
|
6
|
+
* What a deployment serves beneath its URL: identity, schema bundle, requirements, bindings, routes
|
|
7
|
+
* and delivery. A `DomainRelease` v4 adds the digest of its running build.
|
|
8
|
+
*/
|
|
9
|
+
export type Served = Omit<release.Content, 'format' | 'version' | 'build'>;
|
|
10
|
+
/** Derive the served content of one exact Build at one Addressing. */
|
|
11
|
+
export declare function served(build: Build, addressing: Addressing): Served;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
|
+
import { callables } from './callables.js';
|
|
3
|
+
import { routes } from './routes.js';
|
|
4
|
+
import { views } from './views.js';
|
|
5
|
+
export const DELIVERY_PATH = '/install';
|
|
6
|
+
/** Derive the served content of one exact Build at one Addressing. */
|
|
7
|
+
export function served(build, addressing) {
|
|
8
|
+
const root = build.schema.compiled.root;
|
|
9
|
+
const bundle = release.bundleUrl(addressing.publicUrl, build.schema.bundle.ref);
|
|
10
|
+
return {
|
|
11
|
+
origin: root.origin,
|
|
12
|
+
identity: { issuer: addressing.issuer, subject: root.origin },
|
|
13
|
+
schema: { revision: root.revision, bundle: { href: bundle, ref: build.schema.bundle.ref } },
|
|
14
|
+
requirements: build.requirements,
|
|
15
|
+
// The root schema declares the Domain name and entrypoint; a release authors neither.
|
|
16
|
+
...manifest(build),
|
|
17
|
+
bindings: { callables: callables(build, addressing), views: views(build, addressing) },
|
|
18
|
+
delivery: release.placeDelivery({ path: DELIVERY_PATH, authentication: { kind: 'public' } }, addressing.publicUrl, bundle),
|
|
19
|
+
routes: routes(build, addressing),
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
/** The release manifest carries the Domain icon as `logo`. Absent when the Build carries none. */
|
|
23
|
+
function manifest(build) {
|
|
24
|
+
const { icon } = build.presentation ?? {};
|
|
25
|
+
return icon === undefined ? {} : { manifest: Object.freeze({ logo: icon }) };
|
|
26
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type * as
|
|
1
|
+
import type * as release from '@astrale-os/kernel-protocol/release';
|
|
2
2
|
import type { Build } from '../../build/index.js';
|
|
3
3
|
import type { Addressing } from '../addressing.js';
|
|
4
|
-
export declare function views(build: Build, addressing: Addressing): readonly
|
|
4
|
+
export declare function views(build: Build, addressing: Addressing): readonly release.ViewBinding[];
|
|
@@ -8,7 +8,6 @@ export function views(build, addressing) {
|
|
|
8
8
|
view: route.view,
|
|
9
9
|
href: new URL(route.path.replace(/^\//u, ''), base).href,
|
|
10
10
|
handshake: route.handshake,
|
|
11
|
-
...(route.iframe === undefined ? {} : { iframe: route.iframe }),
|
|
12
11
|
...(route.host === undefined ? {} : { host: route.host }),
|
|
13
12
|
})));
|
|
14
13
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { ResolvedRuntimeReference } from './resolve.js';
|
|
2
|
-
/** Prove that a resolved module exports the exact Runtime captured by
|
|
3
|
-
export declare function admit<RuntimeValue extends object>(
|
|
2
|
+
/** Prove that a resolved module exports the exact Runtime captured by a Domain definition. */
|
|
3
|
+
export declare function admit<RuntimeValue extends object>(definition: {
|
|
4
4
|
readonly runtime: RuntimeValue;
|
|
5
5
|
}, resolved: ResolvedRuntimeReference): RuntimeValue;
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { isResolvedRuntimeReference } from './resolve.js';
|
|
2
|
-
/** Prove that a resolved module exports the exact Runtime captured by
|
|
3
|
-
export function admit(
|
|
2
|
+
/** Prove that a resolved module exports the exact Runtime captured by a Domain definition. */
|
|
3
|
+
export function admit(definition, resolved) {
|
|
4
4
|
if (!isResolvedRuntimeReference(resolved)) {
|
|
5
5
|
throw new TypeError('Resolved Runtime reference is not admitted.');
|
|
6
6
|
}
|
|
7
|
-
if (resolved.runtime !==
|
|
8
|
-
throw new TypeError('Runtime module default export differs from the
|
|
7
|
+
if (resolved.runtime !== definition.runtime) {
|
|
8
|
+
throw new TypeError('Runtime module default export differs from the Domain Runtime.');
|
|
9
9
|
}
|
|
10
|
-
return
|
|
10
|
+
return definition.runtime;
|
|
11
11
|
}
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
export {
|
|
2
|
-
export {
|
|
3
|
-
export
|
|
4
|
-
export { readiness as verifyReadiness, verifyDeployment } from './readiness/index.js';
|
|
1
|
+
export { bundle as verifyBundle, isBundle, uploadedBuild as verifyUploadedBuild, } from './preflight/index.js';
|
|
2
|
+
export type { BundleInput } from './preflight/index.js';
|
|
3
|
+
export { readiness as verifyReadiness, readinessPaths } from './readiness/index.js';
|
|
@@ -1,3 +1,2 @@
|
|
|
1
|
-
export {
|
|
2
|
-
export {
|
|
3
|
-
export { readiness as verifyReadiness, verifyDeployment } from './readiness/index.js';
|
|
1
|
+
export { bundle as verifyBundle, isBundle, uploadedBuild as verifyUploadedBuild, } from './preflight/index.js';
|
|
2
|
+
export { readiness as verifyReadiness, readinessPaths } from './readiness/index.js';
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { Bundle, Bundler, BundleSource } from '../../adapter/bundle/index.js';
|
|
2
|
+
import type { Build, BuildDigest } from '../../build/index.js';
|
|
3
|
+
import type { ResolvedRuntimeReference } from '../../runtime/index.js';
|
|
4
|
+
export interface BundleInput<BuildValue extends Build = Build> {
|
|
5
|
+
readonly build: BuildValue;
|
|
6
|
+
readonly runtime: ResolvedRuntimeReference;
|
|
7
|
+
readonly bundler: Pick<Bundler, 'id' | 'version'>;
|
|
8
|
+
readonly source: BundleSource;
|
|
9
|
+
}
|
|
10
|
+
/** Detach bundler output and identify it by the build digest of its exact bytes. */
|
|
11
|
+
export declare function bundle<const BuildValue extends Build>(input: BundleInput<BuildValue>): Bundle<BuildValue>;
|
|
12
|
+
export declare function isBundle(input: unknown): input is Bundle;
|
|
13
|
+
/**
|
|
14
|
+
* `deploy` rebuilds (there is no `deploy --from`), so the exact upload of an immutable deployment
|
|
15
|
+
* must carry the build digest `astrale-domain build` prints for the same tree. A different digest
|
|
16
|
+
* refuses the deployment.
|
|
17
|
+
*/
|
|
18
|
+
export declare function uploadedBuild(expected: Bundle, uploaded: BuildDigest): void;
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { buildDigest, buildManifest } from '../../build/index.js';
|
|
2
|
+
import { admit as admitRuntime } from '../../runtime/index.js';
|
|
3
|
+
import { build as verifyBuild } from './build.js';
|
|
4
|
+
const admittedBundles = new WeakSet();
|
|
5
|
+
/** Detach bundler output and identify it by the build digest of its exact bytes. */
|
|
6
|
+
export function bundle(input) {
|
|
7
|
+
verifyBuild(input.build);
|
|
8
|
+
admitRuntime({ runtime: input.build.runtime }, input.runtime);
|
|
9
|
+
const source = input.source;
|
|
10
|
+
if (source === null || typeof source !== 'object' || Array.isArray(source))
|
|
11
|
+
invalid();
|
|
12
|
+
if (Reflect.ownKeys(source).some((key) => key !== 'entrypoint' && key !== 'files'))
|
|
13
|
+
invalid();
|
|
14
|
+
if (!Array.isArray(source.files) || source.files.length === 0) {
|
|
15
|
+
throw new TypeError('Bundle files must be a non-empty array.');
|
|
16
|
+
}
|
|
17
|
+
const files = source.files.map((file) => {
|
|
18
|
+
if (file === null || typeof file !== 'object' || Array.isArray(file))
|
|
19
|
+
invalid();
|
|
20
|
+
if (Reflect.ownKeys(file).some((key) => key !== 'path' && key !== 'content') ||
|
|
21
|
+
!(file.content instanceof Uint8Array)) {
|
|
22
|
+
invalid();
|
|
23
|
+
}
|
|
24
|
+
return Object.freeze({ path: file.path, content: new Uint8Array(file.content) });
|
|
25
|
+
});
|
|
26
|
+
if (new Set(files.map((file) => file.path)).size !== files.length) {
|
|
27
|
+
throw new TypeError('Bundle files must have unique paths.');
|
|
28
|
+
}
|
|
29
|
+
const root = input.build.schema.compiled.root;
|
|
30
|
+
const manifest = buildManifest({
|
|
31
|
+
origin: root.origin,
|
|
32
|
+
revision: root.revision,
|
|
33
|
+
bundle: input.build.schema.bundle.ref.digest,
|
|
34
|
+
bundler: { id: input.bundler.id, version: input.bundler.version },
|
|
35
|
+
entrypoint: source.entrypoint,
|
|
36
|
+
files,
|
|
37
|
+
});
|
|
38
|
+
const contents = new Map(files.map((file) => [file.path, file.content]));
|
|
39
|
+
const admitted = Object.freeze({
|
|
40
|
+
kind: 'bundle',
|
|
41
|
+
build: input.build,
|
|
42
|
+
manifest,
|
|
43
|
+
digest: buildDigest(manifest),
|
|
44
|
+
entrypoint: manifest.entrypoint,
|
|
45
|
+
files: Object.freeze(manifest.files.map((file) => {
|
|
46
|
+
const content = contents.get(file.path);
|
|
47
|
+
return Object.freeze({ path: file.path, bytes: () => new Uint8Array(content) });
|
|
48
|
+
})),
|
|
49
|
+
});
|
|
50
|
+
admittedBundles.add(admitted);
|
|
51
|
+
return admitted;
|
|
52
|
+
}
|
|
53
|
+
export function isBundle(input) {
|
|
54
|
+
return input !== null && typeof input === 'object' && admittedBundles.has(input);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* `deploy` rebuilds (there is no `deploy --from`), so the exact upload of an immutable deployment
|
|
58
|
+
* must carry the build digest `astrale-domain build` prints for the same tree. A different digest
|
|
59
|
+
* refuses the deployment.
|
|
60
|
+
*/
|
|
61
|
+
export function uploadedBuild(expected, uploaded) {
|
|
62
|
+
if (!isBundle(expected))
|
|
63
|
+
throw new TypeError('Uploaded build check requires an admitted Bundle.');
|
|
64
|
+
if (uploaded === expected.digest)
|
|
65
|
+
return;
|
|
66
|
+
throw new TypeError(`The uploaded code has build digest ${uploaded}, not ${expected.digest} ` +
|
|
67
|
+
'as `astrale-domain build` gives for this tree.');
|
|
68
|
+
}
|
|
69
|
+
function invalid() {
|
|
70
|
+
throw new TypeError('Bundle source is invalid.');
|
|
71
|
+
}
|
|
@@ -1,13 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
import type { Build } from '../../build/index.js';
|
|
3
|
-
import type { ResolvedRuntimeReference } from '../../runtime/index.js';
|
|
4
|
-
export { artifact, isPreparedArtifact } from './artifact.js';
|
|
1
|
+
export { bundle, isBundle, uploadedBuild, type BundleInput } from './bundle.js';
|
|
5
2
|
export { build } from './build.js';
|
|
6
|
-
export { publication } from './publication.js';
|
|
7
|
-
export interface PreflightInput<BuildValue extends Build = Build> {
|
|
8
|
-
readonly build: BuildValue;
|
|
9
|
-
readonly runtime: ResolvedRuntimeReference;
|
|
10
|
-
readonly source: ArtifactSource;
|
|
11
|
-
}
|
|
12
|
-
/** Admit exact deployment material before any provider mutation. */
|
|
13
|
-
export declare function preflight<const BuildValue extends Build>(input: PreflightInput<BuildValue>): PreparedArtifact<BuildValue>;
|
|
@@ -1,13 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
import { build as verifyBuild } from './build.js';
|
|
3
|
-
import { publication as verifyPublication } from './publication.js';
|
|
4
|
-
export { artifact, isPreparedArtifact } from './artifact.js';
|
|
1
|
+
export { bundle, isBundle, uploadedBuild } from './bundle.js';
|
|
5
2
|
export { build } from './build.js';
|
|
6
|
-
export { publication } from './publication.js';
|
|
7
|
-
/** Admit exact deployment material before any provider mutation. */
|
|
8
|
-
export function preflight(input) {
|
|
9
|
-
verifyBuild(input.build);
|
|
10
|
-
const prepared = artifact(input.build, input.runtime, input.source);
|
|
11
|
-
verifyPublication(prepared);
|
|
12
|
-
return prepared;
|
|
13
|
-
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export type ReadinessFetch = (input: string, init: {
|
|
2
|
+
readonly redirect: 'error';
|
|
3
|
+
readonly signal?: AbortSignal;
|
|
4
|
+
}) => Promise<Response>;
|
|
5
|
+
export interface ReadinessOptions {
|
|
6
|
+
readonly fetch?: ReadinessFetch;
|
|
7
|
+
readonly signal?: AbortSignal;
|
|
8
|
+
}
|
|
9
|
+
export declare const MAXIMUM_DOCUMENT_BYTES: number;
|
|
10
|
+
export declare const MAXIMUM_BUNDLE_BYTES: number;
|
|
11
|
+
export declare function fetchRequired(fetcher: ReadinessFetch, url: string, signal: AbortSignal | undefined): Promise<Response>;
|
|
12
|
+
export declare function bounded(response: Response, url: string, maximum: number): Promise<ArrayBuffer>;
|
|
13
|
+
export declare function text(response: Response, url: string, maximum: number): Promise<string>;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export const MAXIMUM_DOCUMENT_BYTES = 1024 * 1024;
|
|
2
|
+
export const MAXIMUM_BUNDLE_BYTES = 16 * 1024 * 1024;
|
|
3
|
+
export async function fetchRequired(fetcher, url, signal) {
|
|
4
|
+
const response = await fetcher(url, {
|
|
5
|
+
redirect: 'error',
|
|
6
|
+
...(signal === undefined ? {} : { signal }),
|
|
7
|
+
});
|
|
8
|
+
if (!response.ok)
|
|
9
|
+
throw new Error(`GET ${url} returned ${response.status}.`);
|
|
10
|
+
return response;
|
|
11
|
+
}
|
|
12
|
+
export async function bounded(response, url, maximum) {
|
|
13
|
+
const bytes = await response.arrayBuffer();
|
|
14
|
+
if (bytes.byteLength > maximum)
|
|
15
|
+
throw new Error(`GET ${url} exceeded ${maximum} bytes.`);
|
|
16
|
+
return bytes;
|
|
17
|
+
}
|
|
18
|
+
export async function text(response, url, maximum) {
|
|
19
|
+
const bytes = await bounded(response, url, maximum);
|
|
20
|
+
try {
|
|
21
|
+
return new TextDecoder('utf-8', { fatal: true, ignoreBOM: false }).decode(bytes);
|
|
22
|
+
}
|
|
23
|
+
catch (cause) {
|
|
24
|
+
throw new Error(`GET ${url} returned invalid UTF-8.`, { cause });
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -1,7 +1,4 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import type {
|
|
1
|
+
import type { IssuerId } from '../../../platform/auth/index.js';
|
|
2
|
+
import type { ReadinessOptions } from './fetch.js';
|
|
3
3
|
/** Verify issuer discovery and at least one admitted signing key at the serving identity. */
|
|
4
|
-
export declare function verifyIdentity(
|
|
5
|
-
readonly fetch?: ReadinessFetch;
|
|
6
|
-
readonly signal?: AbortSignal;
|
|
7
|
-
}): Promise<void>;
|
|
4
|
+
export declare function verifyIdentity(serving: IssuerId, options?: ReadinessOptions): Promise<void>;
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { issuer } from '@astrale-os/kernel-protocol';
|
|
2
2
|
const MAXIMUM_IDENTITY_BYTES = 256 * 1024;
|
|
3
3
|
/** Verify issuer discovery and at least one admitted signing key at the serving identity. */
|
|
4
|
-
export async function verifyIdentity(
|
|
4
|
+
export async function verifyIdentity(serving, options = {}) {
|
|
5
5
|
const fetcher = options.fetch ?? globalThis.fetch;
|
|
6
|
-
const configurationUrl = new URL(issuer.paths(
|
|
7
|
-
const configuration = issuer.acceptConfiguration(await json(fetcher, configurationUrl.href, options.signal),
|
|
6
|
+
const configurationUrl = new URL(issuer.paths(serving).configuration, serving);
|
|
7
|
+
const configuration = issuer.acceptConfiguration(await json(fetcher, configurationUrl.href, options.signal), serving);
|
|
8
8
|
const keys = issuer.acceptKeySet(await json(fetcher, configuration.jwks_uri, options.signal), configuration.id_token_signing_alg_values_supported);
|
|
9
9
|
if (keys.keys.length === 0)
|
|
10
10
|
throw new Error('Serving issuer publishes no signing keys.');
|
|
@@ -1,10 +1,17 @@
|
|
|
1
1
|
import type { Release } from '../../release/index.js';
|
|
2
|
-
import type {
|
|
3
|
-
export { verifyDeployment } from './deployment.js';
|
|
2
|
+
import type { ReadinessOptions } from './fetch.js';
|
|
4
3
|
export { verifyIdentity } from './identity.js';
|
|
5
|
-
export {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
4
|
+
export type { ReadinessFetch, ReadinessOptions } from './fetch.js';
|
|
5
|
+
export { verifyRelease } from './release.js';
|
|
6
|
+
/**
|
|
7
|
+
* Read-only verification of one exact live Release and its serving identity: an immutable
|
|
8
|
+
* deployment's release.json (release digest and build digest).
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* The local paths `readiness` reads of one immutable deployment, each answering 200 once the
|
|
12
|
+
* deployment serves its release: its `release.json`, its Bundle and its issuer documents (the
|
|
13
|
+
* OpenID configuration and its key set). A host that probes paths before it activates a
|
|
14
|
+
* deployment probes these.
|
|
15
|
+
*/
|
|
16
|
+
export declare function readinessPaths(deployed: Release): readonly string[];
|
|
17
|
+
export declare function readiness(release: Release, options?: ReadinessOptions): Promise<void>;
|
|
@@ -1,10 +1,29 @@
|
|
|
1
|
+
import { issuer } from '@astrale-os/kernel-protocol';
|
|
2
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
1
3
|
import { verifyIdentity } from './identity.js';
|
|
2
|
-
import {
|
|
3
|
-
export { verifyDeployment } from './deployment.js';
|
|
4
|
+
import { verifyRelease } from './release.js';
|
|
4
5
|
export { verifyIdentity } from './identity.js';
|
|
5
|
-
export {
|
|
6
|
-
/**
|
|
6
|
+
export { verifyRelease } from './release.js';
|
|
7
|
+
/**
|
|
8
|
+
* Read-only verification of one exact live Release and its serving identity: an immutable
|
|
9
|
+
* deployment's release.json (release digest and build digest).
|
|
10
|
+
*/
|
|
11
|
+
/**
|
|
12
|
+
* The local paths `readiness` reads of one immutable deployment, each answering 200 once the
|
|
13
|
+
* deployment serves its release: its `release.json`, its Bundle and its issuer documents (the
|
|
14
|
+
* OpenID configuration and its key set). A host that probes paths before it activates a
|
|
15
|
+
* deployment probes these.
|
|
16
|
+
*/
|
|
17
|
+
export function readinessPaths(deployed) {
|
|
18
|
+
const { configuration, keys } = issuer.paths(deployed.url);
|
|
19
|
+
return Object.freeze([
|
|
20
|
+
new URL(release.url(deployed.url)).pathname,
|
|
21
|
+
new URL(deployed.document.schema.bundle.href).pathname,
|
|
22
|
+
configuration,
|
|
23
|
+
keys,
|
|
24
|
+
]);
|
|
25
|
+
}
|
|
7
26
|
export async function readiness(release, options = {}) {
|
|
8
|
-
await
|
|
9
|
-
await verifyIdentity(release.
|
|
27
|
+
await verifyRelease(release, options);
|
|
28
|
+
await verifyIdentity(release.url, options);
|
|
10
29
|
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
|
+
import type { Release } from '../../release/index.js';
|
|
3
|
+
import type { ReadinessOptions } from './fetch.js';
|
|
4
|
+
/**
|
|
5
|
+
* Fetch and verify the exact live release of one immutable deployment at its `release.json`: its
|
|
6
|
+
* release digest and the build digest of its code, then its Bundle.
|
|
7
|
+
*/
|
|
8
|
+
export declare function verifyRelease(expected: Release, options?: ReadinessOptions): Promise<release.DomainRelease>;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import * as release from '@astrale-os/kernel-protocol/release';
|
|
2
|
+
import { bounded, fetchRequired, MAXIMUM_BUNDLE_BYTES, MAXIMUM_DOCUMENT_BYTES, text, } from './fetch.js';
|
|
3
|
+
/**
|
|
4
|
+
* Fetch and verify the exact live release of one immutable deployment at its `release.json`: its
|
|
5
|
+
* release digest and the build digest of its code, then its Bundle.
|
|
6
|
+
*/
|
|
7
|
+
export async function verifyRelease(expected, options = {}) {
|
|
8
|
+
const fetcher = options.fetch ?? globalThis.fetch;
|
|
9
|
+
const releaseUrl = release.url(expected.url);
|
|
10
|
+
const response = await fetchRequired(fetcher, releaseUrl, options.signal);
|
|
11
|
+
const deployed = release.accept(JSON.parse(await text(response, releaseUrl, MAXIMUM_DOCUMENT_BYTES)));
|
|
12
|
+
if (!release.matchesReference(deployed, release.reference(expected.document))) {
|
|
13
|
+
throw new Error('Live release differs from the expected Release.');
|
|
14
|
+
}
|
|
15
|
+
if (deployed.build.digest !== expected.buildDigest) {
|
|
16
|
+
throw new Error('Live release build digest differs from the expected build.');
|
|
17
|
+
}
|
|
18
|
+
const bundleResponse = await fetchRequired(fetcher, deployed.schema.bundle.href, options.signal);
|
|
19
|
+
const bytes = new Uint8Array(await bounded(bundleResponse, deployed.schema.bundle.href, MAXIMUM_BUNDLE_BYTES));
|
|
20
|
+
release.decodeBundle(deployed, bytes);
|
|
21
|
+
return deployed;
|
|
22
|
+
}
|