@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,280 @@
|
|
|
1
|
+
import { serviceName, workerDeploymentLabel } from './address.js';
|
|
2
|
+
import { acceptWorkerCode, workerBuildDigest } from './build.js';
|
|
3
|
+
import { acceptWorkerConfiguration, workerConfigurationDigest } from './configuration.js';
|
|
4
|
+
import { decodeWorkerContent, encodeWorkerContent } from './content.js';
|
|
5
|
+
import { WORKER_DEPLOYMENT_LIMITS } from './limits.js';
|
|
6
|
+
import { acceptWorkerRecord, decodeWorkerRecord, encodeWorkerRecord } from './record.js';
|
|
7
|
+
export const WORKER_DEPLOYMENT_REQUEST_FORMAT = 'astrale.worker.deployment-request';
|
|
8
|
+
export const WORKER_DEPLOYMENT_REQUEST_VERSION = 1;
|
|
9
|
+
/** Why a host refuses a Worker deployment request before reading or writing anything. */
|
|
10
|
+
export class WorkerDeploymentRefusal extends Error {
|
|
11
|
+
reason;
|
|
12
|
+
name = 'WorkerDeploymentRefusal';
|
|
13
|
+
constructor(reason, message, options) {
|
|
14
|
+
super(message, options);
|
|
15
|
+
this.reason = reason;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
/** The address one Worker deployment gets: its Service's name, its two digests and its label. */
|
|
19
|
+
export function workerDeploymentAddress(input) {
|
|
20
|
+
const service = serviceName(input.project, input.environment);
|
|
21
|
+
const buildDigest = workerBuildDigest(input.worker);
|
|
22
|
+
const configurationDigest = workerConfigurationDigest(input.configuration);
|
|
23
|
+
return Object.freeze({
|
|
24
|
+
service,
|
|
25
|
+
buildDigest,
|
|
26
|
+
configurationDigest,
|
|
27
|
+
label: workerDeploymentLabel({ service, buildDigest, configurationDigest }),
|
|
28
|
+
});
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Encode one Worker deployment as its request: its address derived, every file in its content
|
|
32
|
+
* envelope. A deployment its host would refuse as invalid is refused here, before any call.
|
|
33
|
+
*/
|
|
34
|
+
export async function encodeWorkerDeploymentRequest(input) {
|
|
35
|
+
const deployment = admitDeployment(input);
|
|
36
|
+
const { worker } = deployment;
|
|
37
|
+
const modules = await Promise.all(worker.modules.map(async (module) => Object.freeze({
|
|
38
|
+
name: module.name,
|
|
39
|
+
kind: module.kind,
|
|
40
|
+
content: await encodeWorkerContent(module.bytes),
|
|
41
|
+
})));
|
|
42
|
+
const assets = await Promise.all((worker.assets ?? []).map(async (asset) => Object.freeze({
|
|
43
|
+
path: asset.path,
|
|
44
|
+
...(asset.contentType === undefined ? {} : { contentType: asset.contentType }),
|
|
45
|
+
content: await encodeWorkerContent(asset.bytes),
|
|
46
|
+
})));
|
|
47
|
+
return Object.freeze({
|
|
48
|
+
format: WORKER_DEPLOYMENT_REQUEST_FORMAT,
|
|
49
|
+
version: WORKER_DEPLOYMENT_REQUEST_VERSION,
|
|
50
|
+
...(deployment.owner === undefined ? {} : { owner: deployment.owner }),
|
|
51
|
+
project: deployment.project,
|
|
52
|
+
environment: deployment.environment,
|
|
53
|
+
label: deployment.label,
|
|
54
|
+
buildDigest: deployment.buildDigest,
|
|
55
|
+
configuration: deployment.configuration,
|
|
56
|
+
worker: Object.freeze({
|
|
57
|
+
manifest: worker.manifest,
|
|
58
|
+
mainModule: worker.mainModule,
|
|
59
|
+
modules: Object.freeze(modules),
|
|
60
|
+
...(assets.length === 0 ? {} : { assets: Object.freeze(assets) }),
|
|
61
|
+
}),
|
|
62
|
+
...(deployment.record === undefined ? {} : { record: encodeWorkerRecord(deployment.record) }),
|
|
63
|
+
...(deployment.readiness.length === 0 ? {} : { readiness: deployment.readiness }),
|
|
64
|
+
secrets: deployment.secrets,
|
|
65
|
+
...(input.promote === undefined ? {} : { promote: input.promote }),
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Decode and admit one Worker deployment request, as a host does before any graph or provider
|
|
70
|
+
* effect: exactly this request shape, every file decoded within its bounds and the Worker's, the
|
|
71
|
+
* configuration canonical, the record exactly when the configuration asks for one, the secrets
|
|
72
|
+
* exactly the names it declares. Then the build digest is recomputed from the decoded bytes
|
|
73
|
+
* (`build-mismatch` when the request states another) and the label from the Service name, that
|
|
74
|
+
* digest and the configuration (`address-mismatch`). Every refusal is a `WorkerDeploymentRefusal`.
|
|
75
|
+
*/
|
|
76
|
+
export async function decodeWorkerDeploymentRequest(input) {
|
|
77
|
+
let deployment;
|
|
78
|
+
let stated;
|
|
79
|
+
try {
|
|
80
|
+
const value = exact(input, [
|
|
81
|
+
'format',
|
|
82
|
+
'version',
|
|
83
|
+
'project',
|
|
84
|
+
'environment',
|
|
85
|
+
'label',
|
|
86
|
+
'buildDigest',
|
|
87
|
+
'configuration',
|
|
88
|
+
'worker',
|
|
89
|
+
'secrets',
|
|
90
|
+
], ['owner', 'record', 'readiness', 'promote'], 'request');
|
|
91
|
+
if (value.format !== WORKER_DEPLOYMENT_REQUEST_FORMAT ||
|
|
92
|
+
value.version !== WORKER_DEPLOYMENT_REQUEST_VERSION) {
|
|
93
|
+
throw new TypeError('The request is not a WorkerDeploymentRequestV1.');
|
|
94
|
+
}
|
|
95
|
+
stated = { buildDigest: value.buildDigest, label: value.label };
|
|
96
|
+
deployment = admitDeployment({
|
|
97
|
+
...(value.owner === undefined ? {} : { owner: value.owner }),
|
|
98
|
+
project: value.project,
|
|
99
|
+
environment: value.environment,
|
|
100
|
+
worker: await decodeCode(value.worker),
|
|
101
|
+
configuration: value.configuration,
|
|
102
|
+
...(value.record === undefined ? {} : { record: decodeWorkerRecord(value.record) }),
|
|
103
|
+
...(value.readiness === undefined ? {} : { readiness: value.readiness }),
|
|
104
|
+
secrets: value.secrets,
|
|
105
|
+
...(value.promote === undefined ? {} : { promote: value.promote }),
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
catch (cause) {
|
|
109
|
+
if (!(cause instanceof TypeError))
|
|
110
|
+
throw cause;
|
|
111
|
+
throw new WorkerDeploymentRefusal('invalid-deployment', cause.message, { cause });
|
|
112
|
+
}
|
|
113
|
+
if (stated.buildDigest !== deployment.buildDigest) {
|
|
114
|
+
throw new WorkerDeploymentRefusal('build-mismatch', `The uploaded Worker has build digest ${deployment.buildDigest}, not ${quoted(stated.buildDigest)}.`);
|
|
115
|
+
}
|
|
116
|
+
if (stated.label !== deployment.label) {
|
|
117
|
+
throw new WorkerDeploymentRefusal('address-mismatch', `This release of this Service is deployed at ${deployment.label}, not ${quoted(stated.label)}.`);
|
|
118
|
+
}
|
|
119
|
+
return deployment;
|
|
120
|
+
}
|
|
121
|
+
/** A stated value as a refusal names it: short printable text as written, anything else not. */
|
|
122
|
+
function quoted(value) {
|
|
123
|
+
return typeof value === 'string' && value.length <= 80 && !/[\p{Cc}]/u.test(value)
|
|
124
|
+
? value
|
|
125
|
+
: 'the one stated';
|
|
126
|
+
}
|
|
127
|
+
/** Admit the decoded parts of one deployment and derive its address. */
|
|
128
|
+
function admitDeployment(input) {
|
|
129
|
+
if (input === null || typeof input !== 'object')
|
|
130
|
+
invalid('it is not an object');
|
|
131
|
+
const configuration = acceptWorkerConfiguration(input.configuration);
|
|
132
|
+
const worker = acceptWorkerCode(input.worker);
|
|
133
|
+
const secrets = acceptSecrets(input.secrets ?? {}, configuration.secrets);
|
|
134
|
+
if ((input.record !== undefined) !== configuration.record) {
|
|
135
|
+
invalid(configuration.record
|
|
136
|
+
? 'its configuration serves a record it does not carry'
|
|
137
|
+
: 'it carries a record its configuration does not serve');
|
|
138
|
+
}
|
|
139
|
+
const record = input.record === undefined ? undefined : acceptWorkerRecord(input.record);
|
|
140
|
+
const readiness = acceptReadiness(input.readiness ?? []);
|
|
141
|
+
if (input.owner !== undefined && !isText(input.owner, 256))
|
|
142
|
+
invalid('its owner is invalid');
|
|
143
|
+
if (input.promote !== undefined && typeof input.promote !== 'boolean') {
|
|
144
|
+
invalid('its promote option is not a boolean');
|
|
145
|
+
}
|
|
146
|
+
const address = workerDeploymentAddress({
|
|
147
|
+
project: input.project,
|
|
148
|
+
environment: input.environment,
|
|
149
|
+
worker,
|
|
150
|
+
configuration,
|
|
151
|
+
});
|
|
152
|
+
return Object.freeze({
|
|
153
|
+
...address,
|
|
154
|
+
...(input.owner === undefined ? {} : { owner: input.owner }),
|
|
155
|
+
project: input.project,
|
|
156
|
+
environment: input.environment,
|
|
157
|
+
worker,
|
|
158
|
+
configuration,
|
|
159
|
+
...(record === undefined ? {} : { record }),
|
|
160
|
+
readiness,
|
|
161
|
+
secrets,
|
|
162
|
+
promote: input.promote ?? true,
|
|
163
|
+
});
|
|
164
|
+
}
|
|
165
|
+
/** Exactly the declared secret names, each value bounded text. */
|
|
166
|
+
function acceptSecrets(input, declared) {
|
|
167
|
+
if (input === null || typeof input !== 'object' || Array.isArray(input)) {
|
|
168
|
+
invalid('its secrets are not an object');
|
|
169
|
+
}
|
|
170
|
+
const names = Reflect.ownKeys(input);
|
|
171
|
+
if (names.length !== declared.length ||
|
|
172
|
+
names.some((name) => typeof name !== 'string' || !declared.includes(name))) {
|
|
173
|
+
invalid('its secrets are not exactly the names its configuration declares');
|
|
174
|
+
}
|
|
175
|
+
for (const name of declared) {
|
|
176
|
+
if (typeof input[name] !== 'string' ||
|
|
177
|
+
input[name].length > WORKER_DEPLOYMENT_LIMITS.valueLength) {
|
|
178
|
+
invalid(`secret ${name} is not text within its size limit`);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
return Object.freeze(Object.fromEntries(declared.map((name) => [name, input[name]])));
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Readiness paths: at most `readinessPaths` distinct canonical local paths, never a host, a query,
|
|
185
|
+
* credentials or a redirect destination.
|
|
186
|
+
*/
|
|
187
|
+
function acceptReadiness(input) {
|
|
188
|
+
if (!Array.isArray(input) ||
|
|
189
|
+
input.length > WORKER_DEPLOYMENT_LIMITS.readinessPaths ||
|
|
190
|
+
new Set(input).size !== input.length) {
|
|
191
|
+
invalid('its readiness paths are invalid');
|
|
192
|
+
}
|
|
193
|
+
for (const path of input) {
|
|
194
|
+
if (typeof path !== 'string' ||
|
|
195
|
+
path.length > 1_024 ||
|
|
196
|
+
!/^\/(?:[A-Za-z0-9._~-]+\/)*[A-Za-z0-9._~-]*$/u.test(path) ||
|
|
197
|
+
path.split('/').some((part) => part === '.' || part === '..')) {
|
|
198
|
+
invalid('its readiness paths are not canonical local paths');
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
return Object.freeze([...input]);
|
|
202
|
+
}
|
|
203
|
+
/** Decode the code of one Worker, each file within its bounds and all within the Worker's. */
|
|
204
|
+
async function decodeCode(input) {
|
|
205
|
+
const value = exact(input, ['manifest', 'mainModule', 'modules'], ['assets'], 'worker');
|
|
206
|
+
const limits = WORKER_DEPLOYMENT_LIMITS;
|
|
207
|
+
if (!Array.isArray(value.modules) || value.modules.length > limits.modules) {
|
|
208
|
+
invalid('its modules are invalid');
|
|
209
|
+
}
|
|
210
|
+
if (value.assets !== undefined &&
|
|
211
|
+
(!Array.isArray(value.assets) || value.assets.length > limits.assets)) {
|
|
212
|
+
invalid('its assets are invalid');
|
|
213
|
+
}
|
|
214
|
+
let remaining = limits.workerSize;
|
|
215
|
+
const decode = async (content, size, base64Size) => {
|
|
216
|
+
const bytes = await decodeWorkerContent(content, {
|
|
217
|
+
size: Math.min(size, remaining),
|
|
218
|
+
base64Size,
|
|
219
|
+
});
|
|
220
|
+
remaining -= bytes.byteLength;
|
|
221
|
+
return bytes;
|
|
222
|
+
};
|
|
223
|
+
const modules = [];
|
|
224
|
+
for (const entry of value.modules) {
|
|
225
|
+
const module = exact(entry, ['name', 'kind', 'content'], [], 'module');
|
|
226
|
+
modules.push({
|
|
227
|
+
name: module.name,
|
|
228
|
+
kind: module.kind,
|
|
229
|
+
bytes: await decode(module.content, limits.moduleSize, limits.moduleBase64Size),
|
|
230
|
+
});
|
|
231
|
+
}
|
|
232
|
+
const assets = [];
|
|
233
|
+
for (const entry of (value.assets ?? [])) {
|
|
234
|
+
const asset = exact(entry, ['path', 'content'], ['contentType'], 'asset');
|
|
235
|
+
if (asset.contentType !== undefined && !isText(asset.contentType, 256)) {
|
|
236
|
+
invalid('an asset content type is invalid');
|
|
237
|
+
}
|
|
238
|
+
assets.push({
|
|
239
|
+
path: asset.path,
|
|
240
|
+
bytes: await decode(asset.content, limits.assetSize, limits.assetBase64Size),
|
|
241
|
+
...(asset.contentType === undefined ? {} : { contentType: asset.contentType }),
|
|
242
|
+
});
|
|
243
|
+
}
|
|
244
|
+
return {
|
|
245
|
+
manifest: value.manifest,
|
|
246
|
+
mainModule: value.mainModule,
|
|
247
|
+
modules,
|
|
248
|
+
...(assets.length === 0 ? {} : { assets }),
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
function isText(value, maximum) {
|
|
252
|
+
return (typeof value === 'string' &&
|
|
253
|
+
value.length > 0 &&
|
|
254
|
+
value.length <= maximum &&
|
|
255
|
+
!/[\p{Cc}]/u.test(value));
|
|
256
|
+
}
|
|
257
|
+
function exact(input, required, optional, label) {
|
|
258
|
+
if (input === null || typeof input !== 'object' || Array.isArray(input)) {
|
|
259
|
+
invalid(`its ${label} is not an object`);
|
|
260
|
+
}
|
|
261
|
+
for (const key of Reflect.ownKeys(input)) {
|
|
262
|
+
if (typeof key !== 'string' || (!required.includes(key) && !optional.includes(key))) {
|
|
263
|
+
invalid(`its ${label} has an unknown member ${String(key)}`);
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
const value = input;
|
|
267
|
+
for (const key of required) {
|
|
268
|
+
if (!Object.hasOwn(value, key))
|
|
269
|
+
invalid(`its ${label} has no ${key}`);
|
|
270
|
+
}
|
|
271
|
+
for (const key of optional) {
|
|
272
|
+
if (Object.hasOwn(value, key) && value[key] === undefined) {
|
|
273
|
+
invalid(`its ${label} has an undefined ${key}`);
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
return value;
|
|
277
|
+
}
|
|
278
|
+
function invalid(reason) {
|
|
279
|
+
throw new TypeError(`Worker deployment is invalid: ${reason}.`);
|
|
280
|
+
}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import type { WorkerRecord, WorkerRecordWireV1 } from './record.js';
|
|
2
|
+
/** Where a Worker host addresses Services and deployments. */
|
|
3
|
+
export interface WorkerHostingV1 {
|
|
4
|
+
/**
|
|
5
|
+
* The DNS name every URL ends with: `https://<service>.<routingDomain>` serves a Service's
|
|
6
|
+
* current deployment, `https://<label>.<routingDomain>` one deployment.
|
|
7
|
+
*/
|
|
8
|
+
readonly routingDomain: string;
|
|
9
|
+
}
|
|
10
|
+
/** What a host lists: the deployments of the caller's Services, optionally of one project or environment. */
|
|
11
|
+
export interface WorkerDeploymentListRequestV1 {
|
|
12
|
+
readonly project?: string;
|
|
13
|
+
readonly environment?: string;
|
|
14
|
+
}
|
|
15
|
+
/** The lifecycle of one deployment at its host. */
|
|
16
|
+
export type WorkerDeploymentState = 'deploying' | 'active' | 'retiring' | 'retired' | 'failed';
|
|
17
|
+
/**
|
|
18
|
+
* What a host knows of one deployment. It names a deployment by its label and URL, never by a
|
|
19
|
+
* provider version. A host keeps every deployment until it is retired: it has no preview, expiry or
|
|
20
|
+
* last call.
|
|
21
|
+
*/
|
|
22
|
+
export interface WorkerDeploymentSummaryV1 {
|
|
23
|
+
/** The host's id of the deployment (a node id on Admin's Services). */
|
|
24
|
+
readonly id: string;
|
|
25
|
+
readonly url: string;
|
|
26
|
+
readonly label: string;
|
|
27
|
+
/** The host's id of the Service this deployment is a version of. */
|
|
28
|
+
readonly serviceId: string;
|
|
29
|
+
/** The name of that Service: the first part of the label. */
|
|
30
|
+
readonly service: string;
|
|
31
|
+
readonly project: string;
|
|
32
|
+
readonly environment: string;
|
|
33
|
+
/** Who owns the Service (an Identity node path on Admin's Services). */
|
|
34
|
+
readonly owner: string;
|
|
35
|
+
readonly state: WorkerDeploymentState;
|
|
36
|
+
/** Whether the Service's stable URL serves this deployment. */
|
|
37
|
+
readonly current: boolean;
|
|
38
|
+
readonly createdAt: string;
|
|
39
|
+
/** When its retirement began; present once it is `retiring`. */
|
|
40
|
+
readonly retiredAt?: string;
|
|
41
|
+
readonly buildDigest: string;
|
|
42
|
+
/** The digest of its `WorkerConfigurationV1`. */
|
|
43
|
+
readonly configuration: string;
|
|
44
|
+
/** The RFC 7638 thumbprint of its key, when its configuration asked for a signing identity. */
|
|
45
|
+
readonly signingKeyId?: string;
|
|
46
|
+
/** The record it serves, when its configuration asked for one. */
|
|
47
|
+
readonly record?: WorkerRecordWireV1;
|
|
48
|
+
}
|
|
49
|
+
/** One summary with its record decoded. */
|
|
50
|
+
export type WorkerDeploymentSummary = Omit<WorkerDeploymentSummaryV1, 'record'> & {
|
|
51
|
+
readonly record?: WorkerRecord;
|
|
52
|
+
};
|
|
53
|
+
/** Why a host refused to host one Worker release. A refusal changed nothing (see each reason). */
|
|
54
|
+
export type WorkerDeploymentRejectionReason = 'invalid-deployment' | 'address-mismatch' | 'build-mismatch' | 'service-owned-elsewhere' | 'deployment-conflict' | 'deployment-retired' | 'hosting-unavailable' | 'service-unavailable';
|
|
55
|
+
export declare const WORKER_DEPLOYMENT_REJECTIONS: readonly WorkerDeploymentRejectionReason[];
|
|
56
|
+
/**
|
|
57
|
+
* `WorkerDeploymentResponseV1`: a deployment `created` with the request's secrets `bound` to it,
|
|
58
|
+
* or `reused` with its declared secrets rewritten in place (`updated`) or left `unchanged`, or a
|
|
59
|
+
* refusal. A refusal changed nothing, except that a `service-unavailable` may follow effects (a
|
|
60
|
+
* creation that lost its lease after uploading, an in-place rewrite that wrote part of the
|
|
61
|
+
* values): rerunning the same deploy converges.
|
|
62
|
+
*/
|
|
63
|
+
export type WorkerDeploymentResponseV1 = {
|
|
64
|
+
readonly kind: 'deployed';
|
|
65
|
+
readonly state: 'created' | 'reused';
|
|
66
|
+
readonly secrets: {
|
|
67
|
+
readonly state: 'bound' | 'updated' | 'unchanged';
|
|
68
|
+
};
|
|
69
|
+
readonly deployment: WorkerDeploymentSummaryV1;
|
|
70
|
+
} | WorkerDeploymentRejection;
|
|
71
|
+
export interface WorkerDeploymentRejection {
|
|
72
|
+
readonly kind: 'rejected';
|
|
73
|
+
readonly reason: WorkerDeploymentRejectionReason;
|
|
74
|
+
readonly message: string;
|
|
75
|
+
/** When a retry may succeed, for a refusal that only waits on another operation. */
|
|
76
|
+
readonly retryAfter?: string;
|
|
77
|
+
}
|
|
78
|
+
/** One decoded answer of a deploy. */
|
|
79
|
+
export type WorkerDeploymentResult = {
|
|
80
|
+
readonly kind: 'deployed';
|
|
81
|
+
readonly state: 'created' | 'reused';
|
|
82
|
+
readonly secrets: {
|
|
83
|
+
readonly state: 'bound' | 'updated' | 'unchanged';
|
|
84
|
+
};
|
|
85
|
+
readonly deployment: WorkerDeploymentSummary;
|
|
86
|
+
} | WorkerDeploymentRejection;
|
|
87
|
+
/** Admit the answer of a host's `hosting`: exactly its routing domain. */
|
|
88
|
+
export declare function decodeWorkerHosting(input: unknown): WorkerHostingV1;
|
|
89
|
+
/**
|
|
90
|
+
* Admit the answer of a deploy exactly: a deployment whose state reports the secret state it
|
|
91
|
+
* pairs with, or a refusal a host can give.
|
|
92
|
+
*/
|
|
93
|
+
export declare function decodeWorkerDeploymentResponse(input: unknown): WorkerDeploymentResult;
|
|
94
|
+
/** Admit the answer of a host's `list`: the summaries of the caller's deployments, in its order. */
|
|
95
|
+
export declare function decodeWorkerDeploymentList(input: unknown): readonly WorkerDeploymentSummary[];
|
|
96
|
+
/**
|
|
97
|
+
* Admit one summary exactly: node ids and names a person can read, a label whose first part is
|
|
98
|
+
* the Service's name, the URL of that label, a known state, instants, digests, and a record that
|
|
99
|
+
* decodes.
|
|
100
|
+
*/
|
|
101
|
+
export declare function decodeWorkerDeploymentSummary(input: unknown): WorkerDeploymentSummary;
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
import { parseDeploymentLabel } from '../address/label.js';
|
|
2
|
+
import { serviceName } from './address.js';
|
|
3
|
+
import { decodeWorkerRecord } from './record.js';
|
|
4
|
+
export const WORKER_DEPLOYMENT_REJECTIONS = Object.freeze([
|
|
5
|
+
'invalid-deployment',
|
|
6
|
+
'address-mismatch',
|
|
7
|
+
'build-mismatch',
|
|
8
|
+
'service-owned-elsewhere',
|
|
9
|
+
'deployment-conflict',
|
|
10
|
+
'deployment-retired',
|
|
11
|
+
'hosting-unavailable',
|
|
12
|
+
'service-unavailable',
|
|
13
|
+
]);
|
|
14
|
+
const STATES = Object.freeze([
|
|
15
|
+
'deploying',
|
|
16
|
+
'active',
|
|
17
|
+
'retiring',
|
|
18
|
+
'retired',
|
|
19
|
+
'failed',
|
|
20
|
+
]);
|
|
21
|
+
/** Which secret states each deployment state reports. */
|
|
22
|
+
const SECRETS_BY_STATE = Object.freeze({
|
|
23
|
+
created: Object.freeze(['bound']),
|
|
24
|
+
reused: Object.freeze(['updated', 'unchanged']),
|
|
25
|
+
});
|
|
26
|
+
/** Admit the answer of a host's `hosting`: exactly its routing domain. */
|
|
27
|
+
export function decodeWorkerHosting(input) {
|
|
28
|
+
const value = exact(input, ['routingDomain'], [], 'hosting');
|
|
29
|
+
if (typeof value.routingDomain !== 'string' || !isDnsName(value.routingDomain)) {
|
|
30
|
+
invalid('hosting', 'routingDomain');
|
|
31
|
+
}
|
|
32
|
+
return Object.freeze({ routingDomain: value.routingDomain });
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Admit the answer of a deploy exactly: a deployment whose state reports the secret state it
|
|
36
|
+
* pairs with, or a refusal a host can give.
|
|
37
|
+
*/
|
|
38
|
+
export function decodeWorkerDeploymentResponse(input) {
|
|
39
|
+
const value = exact(input, ['kind'], ['state', 'secrets', 'deployment', 'reason', 'message', 'retryAfter'], 'deploy');
|
|
40
|
+
if (value.kind === 'rejected') {
|
|
41
|
+
exact(value, ['kind', 'reason', 'message'], ['retryAfter'], 'refusal');
|
|
42
|
+
if (!WORKER_DEPLOYMENT_REJECTIONS.includes(value.reason)) {
|
|
43
|
+
invalid('refusal', 'reason');
|
|
44
|
+
}
|
|
45
|
+
if (typeof value.message !== 'string' ||
|
|
46
|
+
value.message.length < 1 ||
|
|
47
|
+
value.message.length > 500) {
|
|
48
|
+
invalid('refusal', 'message');
|
|
49
|
+
}
|
|
50
|
+
if (value.retryAfter !== undefined && !isInstant(value.retryAfter)) {
|
|
51
|
+
invalid('refusal', 'retryAfter');
|
|
52
|
+
}
|
|
53
|
+
return Object.freeze({
|
|
54
|
+
kind: 'rejected',
|
|
55
|
+
reason: value.reason,
|
|
56
|
+
message: value.message,
|
|
57
|
+
...(value.retryAfter === undefined ? {} : { retryAfter: value.retryAfter }),
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
exact(value, ['kind', 'state', 'secrets', 'deployment'], [], 'deploy');
|
|
61
|
+
if (value.kind !== 'deployed')
|
|
62
|
+
invalid('deploy', 'kind');
|
|
63
|
+
if (value.state !== 'created' && value.state !== 'reused')
|
|
64
|
+
invalid('deploy', 'state');
|
|
65
|
+
const secrets = exact(value.secrets, ['state'], [], 'secrets');
|
|
66
|
+
const allowed = SECRETS_BY_STATE[value.state];
|
|
67
|
+
if (typeof secrets.state !== 'string' || !allowed.includes(secrets.state)) {
|
|
68
|
+
invalid('deploy', 'secrets.state');
|
|
69
|
+
}
|
|
70
|
+
return Object.freeze({
|
|
71
|
+
kind: 'deployed',
|
|
72
|
+
state: value.state,
|
|
73
|
+
secrets: Object.freeze({ state: secrets.state }),
|
|
74
|
+
deployment: decodeWorkerDeploymentSummary(value.deployment),
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
/** Admit the answer of a host's `list`: the summaries of the caller's deployments, in its order. */
|
|
78
|
+
export function decodeWorkerDeploymentList(input) {
|
|
79
|
+
const value = exact(input, ['deployments'], [], 'list');
|
|
80
|
+
if (!Array.isArray(value.deployments))
|
|
81
|
+
invalid('list', 'deployments');
|
|
82
|
+
return Object.freeze(value.deployments.map((deployment) => decodeWorkerDeploymentSummary(deployment)));
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Admit one summary exactly: node ids and names a person can read, a label whose first part is
|
|
86
|
+
* the Service's name, the URL of that label, a known state, instants, digests, and a record that
|
|
87
|
+
* decodes.
|
|
88
|
+
*/
|
|
89
|
+
export function decodeWorkerDeploymentSummary(input) {
|
|
90
|
+
const value = exact(input, [
|
|
91
|
+
'id',
|
|
92
|
+
'url',
|
|
93
|
+
'label',
|
|
94
|
+
'serviceId',
|
|
95
|
+
'service',
|
|
96
|
+
'project',
|
|
97
|
+
'environment',
|
|
98
|
+
'owner',
|
|
99
|
+
'state',
|
|
100
|
+
'current',
|
|
101
|
+
'createdAt',
|
|
102
|
+
'buildDigest',
|
|
103
|
+
'configuration',
|
|
104
|
+
], ['retiredAt', 'signingKeyId', 'record'], 'deployment');
|
|
105
|
+
for (const key of [
|
|
106
|
+
'id',
|
|
107
|
+
'url',
|
|
108
|
+
'label',
|
|
109
|
+
'serviceId',
|
|
110
|
+
'service',
|
|
111
|
+
'project',
|
|
112
|
+
'environment',
|
|
113
|
+
'owner',
|
|
114
|
+
]) {
|
|
115
|
+
if (typeof value[key] !== 'string' || !isPrintable(value[key]))
|
|
116
|
+
invalid('deployment', key);
|
|
117
|
+
}
|
|
118
|
+
if (value.signingKeyId !== undefined) {
|
|
119
|
+
if (typeof value.signingKeyId !== 'string' || !isPrintable(value.signingKeyId)) {
|
|
120
|
+
invalid('deployment', 'signingKeyId');
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
let line;
|
|
124
|
+
try {
|
|
125
|
+
line = parseDeploymentLabel(value.label).line;
|
|
126
|
+
}
|
|
127
|
+
catch {
|
|
128
|
+
invalid('deployment', 'label');
|
|
129
|
+
}
|
|
130
|
+
if (value.service !== line)
|
|
131
|
+
invalid('deployment', 'service');
|
|
132
|
+
let named;
|
|
133
|
+
try {
|
|
134
|
+
named = serviceName(value.project, value.environment);
|
|
135
|
+
}
|
|
136
|
+
catch {
|
|
137
|
+
invalid('deployment', 'project');
|
|
138
|
+
}
|
|
139
|
+
if (named !== line)
|
|
140
|
+
invalid('deployment', 'service');
|
|
141
|
+
if (!isDeploymentUrl(value.url, value.label))
|
|
142
|
+
invalid('deployment', 'url');
|
|
143
|
+
if (!STATES.includes(value.state))
|
|
144
|
+
invalid('deployment', 'state');
|
|
145
|
+
if (typeof value.current !== 'boolean')
|
|
146
|
+
invalid('deployment', 'current');
|
|
147
|
+
if (!isInstant(value.createdAt))
|
|
148
|
+
invalid('deployment', 'createdAt');
|
|
149
|
+
if (value.retiredAt !== undefined && !isInstant(value.retiredAt))
|
|
150
|
+
invalid('deployment', 'retiredAt');
|
|
151
|
+
for (const key of ['buildDigest', 'configuration']) {
|
|
152
|
+
if (typeof value[key] !== 'string' || !/^sha256:[0-9a-f]{64}$/u.test(value[key])) {
|
|
153
|
+
invalid('deployment', key);
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
let record;
|
|
157
|
+
if (value.record !== undefined) {
|
|
158
|
+
try {
|
|
159
|
+
record = decodeWorkerRecord(value.record);
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
invalid('deployment', 'record');
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
const summary = { ...value };
|
|
166
|
+
delete summary.record;
|
|
167
|
+
return Object.freeze({
|
|
168
|
+
...summary,
|
|
169
|
+
...(record === undefined ? {} : { record }),
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
/** `https://<label>.<routing domain>`, nothing more. */
|
|
173
|
+
function isDeploymentUrl(url, label) {
|
|
174
|
+
const prefix = `https://${label}.`;
|
|
175
|
+
return url.startsWith(prefix) && isDnsName(url.slice(prefix.length));
|
|
176
|
+
}
|
|
177
|
+
/** Text a person can read in a listing: at most 512 characters, none of them a control character. */
|
|
178
|
+
function isPrintable(value) {
|
|
179
|
+
return value.length > 0 && value.length <= 512 && !/[\p{Cc}]/u.test(value);
|
|
180
|
+
}
|
|
181
|
+
function isInstant(value) {
|
|
182
|
+
return (typeof value === 'string' &&
|
|
183
|
+
value.length > 0 &&
|
|
184
|
+
value.length <= 64 &&
|
|
185
|
+
!Number.isNaN(Date.parse(value)));
|
|
186
|
+
}
|
|
187
|
+
function isDnsName(value) {
|
|
188
|
+
return (value.length <= 253 &&
|
|
189
|
+
value.split('.').every((label) => /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u.test(label)));
|
|
190
|
+
}
|
|
191
|
+
function exact(input, required, optional, label) {
|
|
192
|
+
if (input === null || typeof input !== 'object' || Array.isArray(input))
|
|
193
|
+
invalid(label);
|
|
194
|
+
const value = input;
|
|
195
|
+
for (const key of Reflect.ownKeys(value)) {
|
|
196
|
+
if (typeof key !== 'string' || (!required.includes(key) && !optional.includes(key))) {
|
|
197
|
+
invalid(label, String(key));
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
for (const key of required)
|
|
201
|
+
if (!Object.hasOwn(value, key))
|
|
202
|
+
invalid(label, key);
|
|
203
|
+
return value;
|
|
204
|
+
}
|
|
205
|
+
function invalid(label, member) {
|
|
206
|
+
throw new TypeError(`The Worker host returned an invalid ${label} answer${member === undefined ? '' : ` (${member})`}.`);
|
|
207
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Disposable entries one deployment keeps across its requests, and across its isolates where the
|
|
3
|
+
* platform shares them. An entry may vanish at any time and never outlives its expiry. A reader
|
|
4
|
+
* treats a failed or late read as a miss, so nothing that must persist or be coordinated belongs
|
|
5
|
+
* here: every consumer stays correct when the cache keeps nothing.
|
|
6
|
+
*/
|
|
7
|
+
export interface DeploymentCache {
|
|
8
|
+
/** The value kept under `key`, or undefined when it expired, vanished or was never kept. */
|
|
9
|
+
get(key: string): Promise<string | undefined>;
|
|
10
|
+
/**
|
|
11
|
+
* Keep `value` under `key` until `expiresAt` (Unix milliseconds) at the latest. The cache may
|
|
12
|
+
* drop it sooner, or not keep it at all.
|
|
13
|
+
*/
|
|
14
|
+
put(key: string, value: string, expiresAt: number): Promise<void>;
|
|
15
|
+
}
|
|
16
|
+
/** Capture a caller-supplied cache, receiver-bound, after checking its shape. */
|
|
17
|
+
export declare function deploymentCache(input: DeploymentCache): DeploymentCache;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** Capture a caller-supplied cache, receiver-bound, after checking its shape. */
|
|
2
|
+
export function deploymentCache(input) {
|
|
3
|
+
if (input === null ||
|
|
4
|
+
typeof input !== 'object' ||
|
|
5
|
+
Array.isArray(input) ||
|
|
6
|
+
typeof input.get !== 'function' ||
|
|
7
|
+
typeof input.put !== 'function') {
|
|
8
|
+
throw new TypeError('Deployment cache is invalid.');
|
|
9
|
+
}
|
|
10
|
+
return Object.freeze({ get: input.get.bind(input), put: input.put.bind(input) });
|
|
11
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { DeploymentCache } from './cache.js';
|
|
2
|
+
/** Entries one memory cache keeps by default before it evicts the least recently used. */
|
|
3
|
+
export declare const DEFAULT_MEMORY_CACHE_ENTRIES = 1024;
|
|
4
|
+
export interface MemoryCacheOptions {
|
|
5
|
+
/** Most entries kept at once; the least recently used is evicted first. */
|
|
6
|
+
readonly maximumEntries?: number;
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* A deployment cache held in this process or isolate: bounded, least recently used first out, and
|
|
10
|
+
* an entry is gone at its expiry. It keeps values only, never a pending operation, so no request
|
|
11
|
+
* waits on another's I/O.
|
|
12
|
+
*/
|
|
13
|
+
export declare function memoryCache(options?: MemoryCacheOptions, now?: () => number): DeploymentCache;
|