@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export { isFrontend } from './admission.js';
|
|
2
2
|
export { defineFrontend } from './define.js';
|
|
3
3
|
export type { Frontend, FrontendInput, FrontendRouteInputs, FrontendRoutes, ViewName, } from './frontend.js';
|
|
4
|
-
export type { FrontendHandshake, FrontendRoute, FrontendRouteInput,
|
|
4
|
+
export type { FrontendHandshake, FrontendRoute, FrontendRouteInput, ViewHostRequirements, } from './route.js';
|
|
5
5
|
export { external, isFrontendSource, vite } from './source.js';
|
|
6
6
|
export type { ExternalSource, FrontendSource, ViteSource } from './source.js';
|
|
@@ -1,30 +1,16 @@
|
|
|
1
1
|
import { type ViewHostRequirements } from '@astrale-os/kernel-core/schema/kernel/syscalls/view-resolution';
|
|
2
2
|
export type { ViewHostRequirements } from '@astrale-os/kernel-core/schema/kernel/syscalls/view-resolution';
|
|
3
3
|
export type FrontendHandshake = 'shell' | 'none';
|
|
4
|
-
/**
|
|
5
|
-
* @deprecated Every trusted View receives the Shell's shared browser profile: requirements within
|
|
6
|
-
* it are redundant, and Astrale hosts refuse any beyond it. Declare none.
|
|
7
|
-
*/
|
|
8
|
-
export interface IframeRequirements {
|
|
9
|
-
readonly sandbox?: readonly string[];
|
|
10
|
-
readonly allow?: readonly string[];
|
|
11
|
-
}
|
|
12
4
|
export type FrontendRouteInput = string | {
|
|
13
5
|
readonly path?: string;
|
|
14
6
|
readonly document?: string;
|
|
15
7
|
readonly handshake?: FrontendHandshake;
|
|
16
|
-
/**
|
|
17
|
-
* @deprecated Every trusted View receives the Shell's shared browser profile: requirements
|
|
18
|
-
* within it are redundant, and Astrale hosts refuse any beyond it. Remove this field.
|
|
19
|
-
*/
|
|
20
|
-
readonly iframe?: IframeRequirements;
|
|
21
8
|
readonly host?: ViewHostRequirements;
|
|
22
9
|
};
|
|
23
10
|
export interface FrontendRoute {
|
|
24
11
|
readonly path: string;
|
|
25
12
|
readonly document: string;
|
|
26
13
|
readonly handshake: FrontendHandshake;
|
|
27
|
-
readonly iframe?: IframeRequirements;
|
|
28
14
|
readonly host?: ViewHostRequirements;
|
|
29
15
|
}
|
|
30
16
|
export declare function normalizeRoute(input: FrontendRouteInput | undefined, fallback: string): FrontendRoute;
|
|
@@ -1,16 +1,10 @@
|
|
|
1
1
|
import { acceptViewHostRequirements, } from '@astrale-os/kernel-core/schema/kernel/syscalls/view-resolution';
|
|
2
|
-
const TOKEN = /^[a-z][a-z0-9-]*$/u;
|
|
3
|
-
const BASELINES = Object.freeze({
|
|
4
|
-
none: iframeRequirements(['allow-scripts'], []),
|
|
5
|
-
shell: iframeRequirements(['allow-same-origin', 'allow-scripts'], ['clipboard-write']),
|
|
6
|
-
});
|
|
7
2
|
export function normalizeRoute(input, fallback) {
|
|
8
3
|
if (typeof input === 'string') {
|
|
9
4
|
return Object.freeze({ path: routePath(input), document: 'index.html', handshake: 'shell' });
|
|
10
5
|
}
|
|
11
6
|
const value = plainRecord(input ?? {});
|
|
12
|
-
if (Reflect.ownKeys(value).some((key) => typeof key !== 'string' ||
|
|
13
|
-
!['path', 'document', 'handshake', 'iframe', 'host'].includes(key))) {
|
|
7
|
+
if (Reflect.ownKeys(value).some((key) => typeof key !== 'string' || !['path', 'document', 'handshake', 'host'].includes(key))) {
|
|
14
8
|
invalid();
|
|
15
9
|
}
|
|
16
10
|
const authoredHandshake = dataValue(value, 'handshake');
|
|
@@ -20,59 +14,14 @@ export function normalizeRoute(input, fallback) {
|
|
|
20
14
|
invalid();
|
|
21
15
|
}
|
|
22
16
|
const handshake = authoredHandshake ?? 'shell';
|
|
23
|
-
const iframe = normalizeIframeRequirements(dataValue(value, 'iframe'), handshake);
|
|
24
17
|
const host = acceptViewHostRequirements(dataValue(value, 'host'), handshake, true);
|
|
25
18
|
return Object.freeze({
|
|
26
19
|
path: routePath(dataValue(value, 'path') ?? fallback),
|
|
27
20
|
document: filePath(dataValue(value, 'document') ?? 'index.html'),
|
|
28
21
|
handshake,
|
|
29
|
-
...(iframe === undefined ? {} : { iframe }),
|
|
30
22
|
...(host === undefined ? {} : { host }),
|
|
31
23
|
});
|
|
32
24
|
}
|
|
33
|
-
function normalizeIframeRequirements(input, handshake) {
|
|
34
|
-
if (input === undefined)
|
|
35
|
-
return undefined;
|
|
36
|
-
const value = plainRecord(input);
|
|
37
|
-
if (Reflect.ownKeys(value).some((key) => key !== 'sandbox' && key !== 'allow'))
|
|
38
|
-
invalid();
|
|
39
|
-
const authored = iframeRequirements(tokenArray(dataValue(value, 'sandbox')), tokenArray(dataValue(value, 'allow')));
|
|
40
|
-
assertSandboxRelationships(authored.sandbox);
|
|
41
|
-
const baseline = BASELINES[handshake];
|
|
42
|
-
const sandbox = authored.sandbox.filter((token) => !baseline.sandbox.includes(token));
|
|
43
|
-
const allow = authored.allow.filter((feature) => !baseline.allow.includes(feature));
|
|
44
|
-
return sandbox.length === 0 && allow.length === 0 ? undefined : iframeRequirements(sandbox, allow);
|
|
45
|
-
}
|
|
46
|
-
function iframeRequirements(sandbox, allow) {
|
|
47
|
-
return Object.freeze({
|
|
48
|
-
sandbox: Object.freeze([...new Set(sandbox)].sort()),
|
|
49
|
-
allow: Object.freeze([...new Set(allow)].sort()),
|
|
50
|
-
});
|
|
51
|
-
}
|
|
52
|
-
function tokenArray(input) {
|
|
53
|
-
if (input === undefined)
|
|
54
|
-
return [];
|
|
55
|
-
if (!Array.isArray(input))
|
|
56
|
-
invalid();
|
|
57
|
-
const descriptors = Object.getOwnPropertyDescriptors(input);
|
|
58
|
-
const result = [];
|
|
59
|
-
for (let index = 0; index < input.length; index += 1) {
|
|
60
|
-
const descriptor = descriptors[String(index)];
|
|
61
|
-
if (descriptor === undefined || !('value' in descriptor))
|
|
62
|
-
invalid();
|
|
63
|
-
if (typeof descriptor.value !== 'string' || !TOKEN.test(descriptor.value))
|
|
64
|
-
invalid();
|
|
65
|
-
result.push(descriptor.value);
|
|
66
|
-
}
|
|
67
|
-
for (const key of Reflect.ownKeys(descriptors)) {
|
|
68
|
-
if (key === 'length')
|
|
69
|
-
continue;
|
|
70
|
-
if (typeof key !== 'string' || !/^(0|[1-9][0-9]*)$/u.test(key) || Number(key) >= input.length) {
|
|
71
|
-
invalid();
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
return result;
|
|
75
|
-
}
|
|
76
25
|
function plainRecord(input) {
|
|
77
26
|
if (typeof input !== 'object' || input === null || Array.isArray(input))
|
|
78
27
|
invalid();
|
|
@@ -89,18 +38,6 @@ function dataValue(input, key) {
|
|
|
89
38
|
invalid();
|
|
90
39
|
return descriptor.value;
|
|
91
40
|
}
|
|
92
|
-
function assertSandboxRelationships(sandbox) {
|
|
93
|
-
const tokens = new Set(sandbox);
|
|
94
|
-
if (tokens.has('allow-popups-to-escape-sandbox') && !tokens.has('allow-popups'))
|
|
95
|
-
invalid();
|
|
96
|
-
if (tokens.has('allow-top-navigation') && tokens.has('allow-top-navigation-by-user-activation')) {
|
|
97
|
-
invalid();
|
|
98
|
-
}
|
|
99
|
-
if (tokens.has('allow-top-navigation-to-custom-protocols') &&
|
|
100
|
-
(tokens.has('allow-top-navigation') || tokens.has('allow-popups'))) {
|
|
101
|
-
invalid();
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
41
|
export function defaultRoute(name) {
|
|
105
42
|
return routePath(`/${name
|
|
106
43
|
.replace(/([a-z0-9])([A-Z])/gu, '$1-$2')
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { defineWorkflow } from './define.js';
|
|
2
|
-
export type { WorkflowContext } from './context.js';
|
|
3
|
-
export type {
|
|
2
|
+
export type { InlineWorkflowContext, WorkflowContext } from './context.js';
|
|
3
|
+
export type { DurableCallable, DurableExecution, DurableParallelOutputs, DurableParallelStep, DurableParallelSteps, DurableStep, DurableStepAuthority, DurableStepDeclaration, DurableStepId, DurableStepRetry, DurableWorkflowContext, SignalOutcome, } from './durable.js';
|
|
4
|
+
export type { Workflow, WorkflowAddress, WorkflowDefinition, WorkflowOptions } from './workflow.js';
|
|
4
5
|
export type { DeclaredErrorDefinition, DeclaredErrorFactory, DeclaredErrorFamily, DeclaredErrorOptions, DeclaredErrors, } from '../error/index.js';
|
|
@@ -2,8 +2,14 @@ import type { Domain } from '../../platform/schema/index.js';
|
|
|
2
2
|
import type { ActionContext, ResolvedCallable } from '../action/index.js';
|
|
3
3
|
import type { DeclaredErrors, NoDeclaredErrors } from '../error/index.js';
|
|
4
4
|
import type { Integrations } from '../integration/index.js';
|
|
5
|
+
import type { DurableCallable, DurableWorkflowContext } from './durable.js';
|
|
5
6
|
import type { WorkflowStep } from './step/index.js';
|
|
6
|
-
/**
|
|
7
|
-
export type
|
|
7
|
+
/** Multi-step context of one value-output callable run inside its invocation. */
|
|
8
|
+
export type InlineWorkflowContext<Callable extends ResolvedCallable, DomainValue extends Domain = Domain, Definitions extends Integrations = Readonly<Record<never, never>>, Errors extends DeclaredErrors = NoDeclaredErrors> = ActionContext<Callable, DomainValue, Definitions, Errors> & {
|
|
8
9
|
readonly step: WorkflowStep;
|
|
9
10
|
};
|
|
11
|
+
/**
|
|
12
|
+
* Exact Workflow context for one callable: engine-journaled when its Schema declares
|
|
13
|
+
* `execution: { durable: true }`, otherwise run inside its invocation.
|
|
14
|
+
*/
|
|
15
|
+
export type WorkflowContext<Callable extends ResolvedCallable, DomainValue extends Domain = Domain, Definitions extends Integrations = Readonly<Record<never, never>>, Errors extends DeclaredErrors = NoDeclaredErrors> = Callable extends DurableCallable ? DurableWorkflowContext<Callable, DomainValue, Definitions, Errors> : InlineWorkflowContext<Callable, DomainValue, Definitions, Errors>;
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import type { schema } from '../../platform/schema/index.js';
|
|
2
2
|
import type { ResolvedDomainOf } from '../action/index.js';
|
|
3
|
-
import type {
|
|
3
|
+
import type { DeclaredErrors, NoDeclaredErrors } from '../error/index.js';
|
|
4
4
|
import type { Integrations } from '../integration/index.js';
|
|
5
|
-
import type { CallableAtWorkflowAddress, Workflow, WorkflowAddress, WorkflowDefinition } from './workflow.js';
|
|
6
|
-
/** Define one
|
|
5
|
+
import type { CallableAtWorkflowAddress, Workflow, WorkflowAddress, WorkflowDefinition, WorkflowOptions } from './workflow.js';
|
|
6
|
+
/** Define one multi-step value-output implementation by its SDK Action address. */
|
|
7
7
|
export declare function defineWorkflow<Schema extends schema.DomainSchema, Definitions extends Integrations = Readonly<Record<never, never>>>(): {
|
|
8
8
|
<const Address extends WorkflowAddress<Schema>>(address: Address, run: Workflow<CallableAtWorkflowAddress<Schema, Address>, Definitions, ResolvedDomainOf<Schema>, NoDeclaredErrors>): WorkflowDefinition<Schema, Address, Definitions, NoDeclaredErrors>;
|
|
9
|
-
<const Address extends WorkflowAddress<Schema>, const Errors extends DeclaredErrors>(address: Address, options:
|
|
9
|
+
<const Address extends WorkflowAddress<Schema>, const Errors extends DeclaredErrors = NoDeclaredErrors>(address: Address, options: WorkflowOptions<Errors>, run: Workflow<CallableAtWorkflowAddress<Schema, Address>, Definitions, ResolvedDomainOf<Schema>, Errors>): WorkflowDefinition<Schema, Address, Definitions, Errors>;
|
|
10
10
|
};
|
|
11
11
|
export declare function isWorkflow(input: unknown): input is WorkflowDefinition;
|
|
@@ -1,25 +1,30 @@
|
|
|
1
1
|
import { patterns } from '@astrale-os/kernel-dsl/v1/addressing';
|
|
2
2
|
import { rememberDeclaredErrors } from '../error/index.js';
|
|
3
3
|
const admittedWorkflows = new WeakSet();
|
|
4
|
-
/** Define one
|
|
4
|
+
/** Define one multi-step value-output implementation by its SDK Action address. */
|
|
5
5
|
export function defineWorkflow() {
|
|
6
6
|
return function define(address, optionsOrRun, possibleRun) {
|
|
7
7
|
acceptWorkflowAddress(address);
|
|
8
|
-
const options = possibleRun === undefined ? undefined : optionsOrRun;
|
|
8
|
+
const options = possibleRun === undefined ? undefined : acceptOptions(optionsOrRun);
|
|
9
9
|
const run = possibleRun ?? optionsOrRun;
|
|
10
10
|
if (typeof run !== 'function')
|
|
11
11
|
throw new TypeError('Workflow run must be a function.');
|
|
12
|
-
const workflow = Object.freeze({
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
run,
|
|
16
|
-
});
|
|
17
|
-
if (options !== undefined)
|
|
18
|
-
rememberDeclaredErrors(workflow, options);
|
|
12
|
+
const workflow = Object.freeze({ kind: 'workflow', address, run });
|
|
13
|
+
if (options?.errors !== undefined)
|
|
14
|
+
rememberDeclaredErrors(workflow, { errors: options.errors });
|
|
19
15
|
admittedWorkflows.add(workflow);
|
|
20
16
|
return workflow;
|
|
21
17
|
};
|
|
22
18
|
}
|
|
19
|
+
function acceptOptions(input) {
|
|
20
|
+
if (input === null ||
|
|
21
|
+
typeof input !== 'object' ||
|
|
22
|
+
Array.isArray(input) ||
|
|
23
|
+
Reflect.ownKeys(input).some((key) => key !== 'errors')) {
|
|
24
|
+
throw new TypeError('Workflow options accept only errors.');
|
|
25
|
+
}
|
|
26
|
+
return input;
|
|
27
|
+
}
|
|
23
28
|
export function isWorkflow(input) {
|
|
24
29
|
return input !== null && typeof input === 'object' && admittedWorkflows.has(input);
|
|
25
30
|
}
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import type { IssuerId } from '../../platform/auth/index.js';
|
|
2
|
+
import type { NodeId } from '../../platform/graph/node/index.js';
|
|
3
|
+
import type { CallableInputOf, Domain, ResolvedMethod } from '../../platform/schema/index.js';
|
|
4
|
+
import type { Value } from '../../platform/value/index.js';
|
|
5
|
+
import type { DomainCapabilities, DomainKernelSessions, DomainMutate } from '../action/index.js';
|
|
6
|
+
import type { HandlerDependencies } from '../dependency/index.js';
|
|
7
|
+
import type { DeclaredErrorFactory, DeclaredErrors, NoDeclaredErrors } from '../error/index.js';
|
|
8
|
+
import type { Integrations, ReplayableIntegrationClients } from '../integration/index.js';
|
|
9
|
+
import type { Mutation, MutationInputOf, MutationOutputOf, DefinedMutation } from '../mutation/index.js';
|
|
10
|
+
import type { InputOf, OutputOf, QueryDefinition, DefinedQuery, QueryOptions } from '../query/index.js';
|
|
11
|
+
/** A callable whose Schema declares `execution: { durable: true }`. */
|
|
12
|
+
export interface DurableCallable {
|
|
13
|
+
readonly execution: {
|
|
14
|
+
readonly durable: true;
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
/** Attested facts of the running Execution. They are data, never authority. */
|
|
18
|
+
export interface DurableExecution {
|
|
19
|
+
/** The `K.Execution` node recording this call. */
|
|
20
|
+
readonly id: NodeId;
|
|
21
|
+
readonly function: {
|
|
22
|
+
readonly id: NodeId;
|
|
23
|
+
readonly version: `sha256:${string}`;
|
|
24
|
+
};
|
|
25
|
+
/** Kernel that recorded the Execution; every Step calls it back as the Domain. */
|
|
26
|
+
readonly kernel: IssuerId;
|
|
27
|
+
/** Who started the Execution. The Workflow never receives their credential. */
|
|
28
|
+
readonly initiator: {
|
|
29
|
+
readonly principal: NodeId;
|
|
30
|
+
readonly caller: NodeId;
|
|
31
|
+
};
|
|
32
|
+
/** Receiver of a durable instance Method. */
|
|
33
|
+
readonly receiver?: NodeId;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* What one Step holds: the capabilities of an Action, acting as the Domain alone. Kernel access
|
|
37
|
+
* exists only here, so every Kernel call belongs to a journaled Step and a replay never repeats it.
|
|
38
|
+
* Every key below comes from one sequence derived from the Execution, the Step and the position of
|
|
39
|
+
* the call, which restarts with each attempt: a retried Step sends the same keys again.
|
|
40
|
+
*/
|
|
41
|
+
export interface DurableStepAuthority<DomainValue extends Domain = Domain, Definitions extends Integrations = Readonly<Record<never, never>>> extends DomainCapabilities<DomainValue, 'self'> {
|
|
42
|
+
/**
|
|
43
|
+
* Kernel Session acting as the Domain. Each `invoke` of a durable callable without an explicit
|
|
44
|
+
* `idempotencyKey` carries the next derived key, so a retried Step reaches the same durable child
|
|
45
|
+
* Execution. An `invoke` of any other callable carries no key, which the Kernel would refuse, and
|
|
46
|
+
* runs again when the Step is retried.
|
|
47
|
+
*/
|
|
48
|
+
readonly kernel: DomainKernelSessions<'self'>;
|
|
49
|
+
/** Dependency invokers acting as the Domain, keyed like `kernel.invoke`. */
|
|
50
|
+
readonly dependencies: HandlerDependencies<DomainValue, 'self'>;
|
|
51
|
+
/**
|
|
52
|
+
* Each Mutation carries the next derived key. The Kernel commits a receipt with the write and
|
|
53
|
+
* answers a retried Step with its first result.
|
|
54
|
+
*/
|
|
55
|
+
readonly mutate: DomainMutate<DomainValue, 'executor'>;
|
|
56
|
+
/**
|
|
57
|
+
* Operations a retried Step may attempt again. A keyed operation of source `execution` receives
|
|
58
|
+
* the next derived key as its idempotency key. An operation whose decision may be `unsafe` is
|
|
59
|
+
* absent, and refused before its Provider runs if its decision is `unsafe` anyway.
|
|
60
|
+
*/
|
|
61
|
+
readonly integrations: ReplayableIntegrationClients<Definitions>;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* How long a failing Step is retried. Its limits, `maxAttempts` and `maxDurationMs`, go together: a
|
|
65
|
+
* Step that declares either replaces both limits of the deployment, and the one it omits does not
|
|
66
|
+
* bound it. The budget is spent at the first limit reached.
|
|
67
|
+
*
|
|
68
|
+
* Only a failure of the Step's own spends an attempt. A Kernel that refuses with a prescribed delay
|
|
69
|
+
* (capacity, draining, maintenance), or that does not answer a Query or a keyed call, is waited out
|
|
70
|
+
* without spending one; a request the Kernel can never accept fails the Step at once.
|
|
71
|
+
*/
|
|
72
|
+
export interface DurableStepRetry {
|
|
73
|
+
/**
|
|
74
|
+
* Attempts that may fail on the Step's own account, the first one included: 1 to 1,000. A wait for
|
|
75
|
+
* the platform spends none.
|
|
76
|
+
*/
|
|
77
|
+
readonly maxAttempts?: number;
|
|
78
|
+
/**
|
|
79
|
+
* Time from the first attempt after which a failed attempt is not retried, whatever it failed on,
|
|
80
|
+
* 1 ms to 365 days; an attempt already scheduled, such as after a long prescribed delay, still
|
|
81
|
+
* runs. The only bound on waiting for the platform.
|
|
82
|
+
*/
|
|
83
|
+
readonly maxDurationMs?: number;
|
|
84
|
+
/** Delay before the first retry, doubled on each failure: 1 ms to one hour. */
|
|
85
|
+
readonly initialIntervalMs?: number;
|
|
86
|
+
/**
|
|
87
|
+
* Longest backoff between two attempts: `initialIntervalMs` to one day. A longer delay the Kernel
|
|
88
|
+
* prescribes is still waited.
|
|
89
|
+
*/
|
|
90
|
+
readonly maxIntervalMs?: number;
|
|
91
|
+
}
|
|
92
|
+
/** A Step: its id, and the retry budget and timeout it declares instead of the deployment's. */
|
|
93
|
+
export interface DurableStepDeclaration {
|
|
94
|
+
readonly id: string;
|
|
95
|
+
readonly retry?: DurableStepRetry;
|
|
96
|
+
/** Deadline of one attempt, including its Kernel calls: one second to ten minutes. */
|
|
97
|
+
readonly timeoutMs?: number;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* A Step's id alone, under the deployment's retry budget and Step timeout, or a declaration of its
|
|
101
|
+
* own. A Step that spends its budget, or that the Kernel refuses for good, throws an error
|
|
102
|
+
* `exhausted` recognizes. A Step whose Query read fails throws its `QueryError`, not retried
|
|
103
|
+
* unless the Kernel refused the read; a Query that crosses a dependency's Class its Domain does
|
|
104
|
+
* not require throws its `TypeError`, not retried. Uncaught, each ends the Execution `failed`
|
|
105
|
+
* with code `STEP_EXHAUSTED`.
|
|
106
|
+
*/
|
|
107
|
+
export type DurableStepId = string | DurableStepDeclaration;
|
|
108
|
+
export interface DurableStep<DomainValue extends Domain = Domain, Definitions extends Integrations = Readonly<Record<never, never>>> {
|
|
109
|
+
/**
|
|
110
|
+
* Run `execute` once and journal its portable output; a replay returns the journaled output. A
|
|
111
|
+
* Step may run again when its outcome was not journaled: its Mutations, durable calls and keyed
|
|
112
|
+
* Integration operations are answered from their keys, and any other effect must be idempotent.
|
|
113
|
+
*/
|
|
114
|
+
run<Output>(step: DurableStepId, execute: (authority: DurableStepAuthority<DomainValue, Definitions>) => Output | Promise<Output>): Promise<Output>;
|
|
115
|
+
/**
|
|
116
|
+
* One journaled Query. A replay returns the result of its first run, so a later Step that depends
|
|
117
|
+
* on it resends the same request whenever it is retried. A Query v7 reads as the executor; its
|
|
118
|
+
* `QueryError`, or the `TypeError` of a dependency's Class its Domain does not require, is
|
|
119
|
+
* journaled as the Step's failure, is not retried, and a replay throws it again. A read the
|
|
120
|
+
* Kernel refused is a failed attempt instead, as any Kernel refusal.
|
|
121
|
+
*/
|
|
122
|
+
query<R extends DefinedQuery>(step: DurableStepId, query: R, input: InputOf<R>, options: QueryOptions<R, 'executor'>): Promise<OutputOf<R>>;
|
|
123
|
+
query<Output>(step: DurableStepId, query: QueryDefinition<DomainValue, void, Output>): Promise<Output>;
|
|
124
|
+
query<Input, Output>(step: DurableStepId, query: QueryDefinition<DomainValue, Input, Output>, input: Input): Promise<Output>;
|
|
125
|
+
/**
|
|
126
|
+
* One journaled Mutation, as the executor. A Step replayed after its commit receives the result
|
|
127
|
+
* of that commit from the Kernel's receipt instead of writing again.
|
|
128
|
+
*/
|
|
129
|
+
mutate<M extends DefinedMutation>(step: DurableStepId, mutation: M, input: MutationInputOf<M>, options: {
|
|
130
|
+
readonly as: 'executor';
|
|
131
|
+
}): Promise<MutationOutputOf<M>>;
|
|
132
|
+
mutate<Input, Output>(step: DurableStepId, mutation: Mutation<DomainValue, Input, Output>, input: Input): Promise<Output>;
|
|
133
|
+
/**
|
|
134
|
+
* Run the Steps `declare` declares together, in one round trip to the engine, the one way to await
|
|
135
|
+
* several Steps at once. Each keeps its id, retry budget, timeout and keys. Once every Step has
|
|
136
|
+
* settled, resolves with their outputs in declaration order, or throws the failure of the first
|
|
137
|
+
* failed Step in that order, as that Step alone would throw it; the other Steps' effects stand.
|
|
138
|
+
* An empty list resolves with `[]`.
|
|
139
|
+
*/
|
|
140
|
+
parallel<const Steps extends readonly [] | readonly DurableParallelStep<unknown>[]>(declare: (steps: DurableParallelSteps<DomainValue, Definitions>) => Steps): Promise<DurableParallelOutputs<Steps>>;
|
|
141
|
+
}
|
|
142
|
+
declare const PARALLEL_STEP: unique symbol;
|
|
143
|
+
/** A Step `step.parallel` starts with its siblings. It runs nothing on its own and is never awaited. */
|
|
144
|
+
export interface DurableParallelStep<out Output> {
|
|
145
|
+
readonly [PARALLEL_STEP]: Output;
|
|
146
|
+
}
|
|
147
|
+
/** The Steps one `step.parallel` declares, with the arguments of `step.run`, `query` and `mutate`. */
|
|
148
|
+
export interface DurableParallelSteps<DomainValue extends Domain = Domain, Definitions extends Integrations = Readonly<Record<never, never>>> {
|
|
149
|
+
run<Output>(step: DurableStepId, execute: (authority: DurableStepAuthority<DomainValue, Definitions>) => Output | Promise<Output>): DurableParallelStep<Output>;
|
|
150
|
+
query<R extends DefinedQuery>(step: DurableStepId, query: R, input: InputOf<R>, options: QueryOptions<R, 'executor'>): DurableParallelStep<OutputOf<R>>;
|
|
151
|
+
query<Output>(step: DurableStepId, query: QueryDefinition<DomainValue, void, Output>): DurableParallelStep<Output>;
|
|
152
|
+
query<Input, Output>(step: DurableStepId, query: QueryDefinition<DomainValue, Input, Output>, input: Input): DurableParallelStep<Output>;
|
|
153
|
+
mutate<M extends DefinedMutation>(step: DurableStepId, mutation: M, input: MutationInputOf<M>, options: {
|
|
154
|
+
readonly as: 'executor';
|
|
155
|
+
}): DurableParallelStep<MutationOutputOf<M>>;
|
|
156
|
+
mutate<Input, Output>(step: DurableStepId, mutation: Mutation<DomainValue, Input, Output>, input: Input): DurableParallelStep<Output>;
|
|
157
|
+
}
|
|
158
|
+
/** The outputs of parallel Steps, in their declaration order. */
|
|
159
|
+
export type DurableParallelOutputs<Steps extends readonly DurableParallelStep<unknown>[]> = {
|
|
160
|
+
-readonly [Index in keyof Steps]: Steps[Index] extends DurableParallelStep<infer Output> ? Output : never;
|
|
161
|
+
};
|
|
162
|
+
type DurableSelfOf<Callable> = Callable extends ResolvedMethod<unknown, unknown, false> ? {
|
|
163
|
+
readonly self: NodeId;
|
|
164
|
+
} : {
|
|
165
|
+
readonly self?: never;
|
|
166
|
+
};
|
|
167
|
+
/** What a bounded wait for a signal ended with: the signal's value, or its timeout. */
|
|
168
|
+
export type SignalOutcome<Signal extends Value = Value> = {
|
|
169
|
+
readonly kind: 'signal';
|
|
170
|
+
readonly value: Signal;
|
|
171
|
+
} | {
|
|
172
|
+
readonly kind: 'timeout';
|
|
173
|
+
};
|
|
174
|
+
/** Context of a durable Workflow: engine-journaled, acting as its Domain. */
|
|
175
|
+
export type DurableWorkflowContext<Callable, DomainValue extends Domain = Domain, Definitions extends Integrations = Readonly<Record<never, never>>, Errors extends DeclaredErrors = NoDeclaredErrors> = {
|
|
176
|
+
readonly domain: DomainValue;
|
|
177
|
+
readonly input: CallableInputOf<Callable>;
|
|
178
|
+
readonly execution: DurableExecution;
|
|
179
|
+
/** Construct one implementation-declared safe business error for `throw error(...)`. */
|
|
180
|
+
readonly error: DeclaredErrorFactory<Errors>;
|
|
181
|
+
readonly step: DurableStep<DomainValue, Definitions>;
|
|
182
|
+
/** Durable timer kept by the engine, even while the Domain is idle or down. */
|
|
183
|
+
sleep(durationMs: number): Promise<void>;
|
|
184
|
+
/**
|
|
185
|
+
* Wait for the value `Execution.signal({ name, value })` delivers once under `name`, whether it
|
|
186
|
+
* was sent before or during the wait.
|
|
187
|
+
*/
|
|
188
|
+
awaitSignal<Signal extends Value = Value>(name: string): Promise<Signal>;
|
|
189
|
+
/**
|
|
190
|
+
* Wait at most `timeoutMs` for the signal `name`. The engine journals which came first, so a
|
|
191
|
+
* replay answers the same. A signal sent after the timeout is kept for a later wait.
|
|
192
|
+
*/
|
|
193
|
+
awaitSignal<Signal extends Value = Value>(name: string, options: {
|
|
194
|
+
readonly timeoutMs: number;
|
|
195
|
+
}): Promise<SignalOutcome<Signal>>;
|
|
196
|
+
/** Whether `error` is the engine's cooperative cancellation, which the Workflow may compensate. */
|
|
197
|
+
cancelled(error: unknown): boolean;
|
|
198
|
+
/**
|
|
199
|
+
* Whether `error` is a Step that spent its retry budget, or that the Kernel refused for good,
|
|
200
|
+
* which the Workflow may handle.
|
|
201
|
+
*/
|
|
202
|
+
exhausted(error: unknown): boolean;
|
|
203
|
+
/**
|
|
204
|
+
* The failure of a Step attempt, to throw inside the Step, that the engine attempts again after
|
|
205
|
+
* exactly `delayMs` (at most one hour), as an HTTP `Retry-After` asks. The attempt spends the
|
|
206
|
+
* Step's budget, since only the Step knows whether its cause clears. A Kernel refusal that
|
|
207
|
+
* prescribes a delay is waited out already, without spending it.
|
|
208
|
+
*/
|
|
209
|
+
retryAfter(delayMs: number, cause?: unknown): Error;
|
|
210
|
+
} & DurableSelfOf<Callable>;
|
|
211
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export { defineWorkflow, isWorkflow } from './define.js';
|
|
2
|
-
export type { WorkflowContext } from './context.js';
|
|
3
|
-
export type {
|
|
2
|
+
export type { InlineWorkflowContext, WorkflowContext } from './context.js';
|
|
3
|
+
export type { DurableCallable, DurableExecution, DurableParallelOutputs, DurableParallelStep, DurableParallelSteps, DurableStep, DurableStepAuthority, DurableStepDeclaration, DurableStepId, DurableStepRetry, DurableWorkflowContext, SignalOutcome, } from './durable.js';
|
|
4
|
+
export type { CallableAtWorkflowAddress, Workflow, WorkflowAddress, WorkflowCallable, WorkflowDefinition, WorkflowOptions, } from './workflow.js';
|
|
4
5
|
export * as step from './step/index.js';
|
|
5
6
|
export * as runner from './runner/index.js';
|
|
6
7
|
export type { DeclaredErrorDefinition, DeclaredErrorFactory, DeclaredErrorFamily, DeclaredErrorOptions, DeclaredErrors, } from '../error/index.js';
|
|
@@ -6,6 +6,7 @@ export function createInlineWorkflowRunner() {
|
|
|
6
6
|
const execution = createInlineStep(context.execution.signal);
|
|
7
7
|
const complete = Object.freeze({ ...context, step: execution.step });
|
|
8
8
|
try {
|
|
9
|
+
// Runtime dispatches only non-durable Workflows inline; durable ones run on the engine.
|
|
9
10
|
return await workflow.run(complete);
|
|
10
11
|
}
|
|
11
12
|
finally {
|
|
@@ -2,9 +2,9 @@ import type { Domain, schema } from '../../../platform/schema/index.js';
|
|
|
2
2
|
import type { ActionOutputOf, ResolvedCallable, ResolvedDomainOf } from '../../action/index.js';
|
|
3
3
|
import type { DeclaredErrors, NoDeclaredErrors } from '../../error/index.js';
|
|
4
4
|
import type { Integrations } from '../../integration/index.js';
|
|
5
|
-
import type {
|
|
5
|
+
import type { InlineWorkflowContext } from '../context.js';
|
|
6
6
|
import type { CallableAtWorkflowAddress, WorkflowAddress, WorkflowDefinition } from '../workflow.js';
|
|
7
|
-
export type WorkflowExecutionContext<Callable extends ResolvedCallable, Definitions extends Integrations, DomainValue extends Domain = Domain, Errors extends DeclaredErrors = NoDeclaredErrors> = Omit<
|
|
7
|
+
export type WorkflowExecutionContext<Callable extends ResolvedCallable, Definitions extends Integrations, DomainValue extends Domain = Domain, Errors extends DeclaredErrors = NoDeclaredErrors> = Omit<InlineWorkflowContext<Callable, DomainValue, Definitions, Errors>, 'step'>;
|
|
8
8
|
export interface WorkflowRunner {
|
|
9
9
|
run<Schema extends schema.DomainSchema, Address extends WorkflowAddress<Schema>, Definitions extends Integrations, Errors extends DeclaredErrors, Callable extends CallableAtWorkflowAddress<Schema, Address> = CallableAtWorkflowAddress<Schema, Address>>(workflow: WorkflowDefinition<Schema, Address, Definitions, Errors>, context: WorkflowExecutionContext<Callable, Definitions, ResolvedDomainOf<Schema>, Errors>): Promise<ActionOutputOf<Callable>>;
|
|
10
10
|
}
|
|
@@ -3,15 +3,17 @@ import type { ActionAddressOf, ActionOutputOf, CallableAtAddress, LocalCallable,
|
|
|
3
3
|
import type { DeclaredErrors, NoDeclaredErrors } from '../error/index.js';
|
|
4
4
|
import type { Integrations } from '../integration/index.js';
|
|
5
5
|
import type { WorkflowContext } from './context.js';
|
|
6
|
-
export type WorkflowCallable<Callable> = Callable extends ResolvedCallable ? Callable extends {
|
|
7
|
-
readonly auth: 'anonymous';
|
|
8
|
-
} ? never : CallableOutputOf<Callable> extends {
|
|
6
|
+
export type WorkflowCallable<Callable> = Callable extends ResolvedCallable ? CallableOutputOf<Callable> extends {
|
|
9
7
|
readonly mode: 'value';
|
|
10
8
|
} ? Callable : never : never;
|
|
11
9
|
export type WorkflowAddress<Schema extends schema.DomainSchema> = ActionAddressOf<WorkflowCallable<LocalCallable<ResolvedDomainOf<Schema>>>>;
|
|
12
10
|
export type CallableAtWorkflowAddress<Schema extends schema.DomainSchema, Address extends WorkflowAddress<Schema>> = WorkflowCallable<Extract<CallableAtAddress<Schema, Address>, ResolvedCallable>>;
|
|
13
11
|
export type Workflow<Callable extends ResolvedCallable, Definitions extends Integrations = Readonly<Record<never, never>>, DomainValue extends Domain = Domain, Errors extends DeclaredErrors = NoDeclaredErrors> = (context: WorkflowContext<Callable, DomainValue, Definitions, Errors>) => Promise<ActionOutputOf<Callable>>;
|
|
14
12
|
declare const WORKFLOW_SCHEMA: unique symbol;
|
|
13
|
+
/** Options of one Workflow implementation. */
|
|
14
|
+
export interface WorkflowOptions<out Errors extends DeclaredErrors = DeclaredErrors> {
|
|
15
|
+
readonly errors?: Errors;
|
|
16
|
+
}
|
|
15
17
|
/** Sealed multi-step Workflow awaiting canonical callable association by Runtime admission. */
|
|
16
18
|
export interface WorkflowDefinition<Schema extends schema.DomainSchema = schema.DomainSchema, Address extends WorkflowAddress<Schema> = WorkflowAddress<Schema>, Definitions extends Integrations = Readonly<Record<never, never>>, Errors extends DeclaredErrors = NoDeclaredErrors> {
|
|
17
19
|
readonly kind: 'workflow';
|
|
@@ -1,27 +1,69 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import type {
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
readonly identity?: string;
|
|
6
|
-
}
|
|
1
|
+
import type { DeploymentConfiguration } from '../address/index.js';
|
|
2
|
+
import type { Bundler } from './bundle/index.js';
|
|
3
|
+
import type { AdapterCommand, ConfigureContext, ListContext, ListedDeployment, Placement, PlacementContext, ReleaseDeployContext, ReleaseDeployResult, RetainContext } from './release/index.js';
|
|
4
|
+
/** What `admit` receives when `defineProject` binds an adapter to one Environment. */
|
|
7
5
|
export interface AdapterEnvironmentContext {
|
|
8
6
|
readonly environment: string;
|
|
9
|
-
readonly installation?: InstallationTarget;
|
|
10
7
|
}
|
|
8
|
+
/**
|
|
9
|
+
* A provider adapter (adapter interface v2). It bundles a Build without any Environment, freezes
|
|
10
|
+
* an Environment's configuration, says where the host places that Environment's deployments, and
|
|
11
|
+
* deploys one sealed release as one immutable deployment, created or reused. It never installs:
|
|
12
|
+
* `astrale domain install <url>` installs a deployment by its URL.
|
|
13
|
+
*
|
|
14
|
+
*/
|
|
11
15
|
export interface Adapter<Parameters extends object = object> {
|
|
12
16
|
readonly kind: 'adapter';
|
|
13
17
|
readonly name: string;
|
|
14
18
|
readonly version: string;
|
|
19
|
+
/**
|
|
20
|
+
* Produces the environment-free bytes `astrale-domain build` identifies by their build digest
|
|
21
|
+
* and `deployRelease` receives as its Bundle. Adapters that share one bundler share one build.
|
|
22
|
+
*/
|
|
23
|
+
readonly bundler: Bundler;
|
|
24
|
+
/** Refuse parameters that cannot serve this Environment, before any effect. */
|
|
15
25
|
admit?(parameters: Parameters, context: AdapterEnvironmentContext): void;
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
26
|
+
/**
|
|
27
|
+
* Freeze what a deployment of this Environment binds beside its build: a `FrozenConfigurationV1`
|
|
28
|
+
* for a host that binds a generated Worker's settings itself, a `WorkerConfigurationV1` for a
|
|
29
|
+
* Worker host that binds only what it is asked (Admin's Services). Pure.
|
|
30
|
+
*/
|
|
31
|
+
configure(parameters: Parameters, context: ConfigureContext): DeploymentConfiguration;
|
|
32
|
+
/** Where the host places this Environment's deployments. No effect at the host. */
|
|
33
|
+
placement(parameters: Parameters, context: PlacementContext): Promise<Placement>;
|
|
34
|
+
/** Create, or reuse, the immutable deployment of one sealed release. */
|
|
35
|
+
deployRelease(parameters: Parameters, context: ReleaseDeployContext): Promise<ReleaseDeployResult>;
|
|
36
|
+
/**
|
|
37
|
+
* The deployments of one Environment of one origin the host keeps for the caller, each with
|
|
38
|
+
* where it is called. No effect at the host.
|
|
39
|
+
*/
|
|
40
|
+
list?(parameters: Parameters, context: ListContext): Promise<readonly ListedDeployment[]>;
|
|
41
|
+
/**
|
|
42
|
+
* Keep one published deployment where the host has no registry principal to mark it (a platform
|
|
43
|
+
* namespace). Called only after its registry publication commits. Rejects with a `RetainRefusal` when the
|
|
44
|
+
* host can no longer keep it (absent or retired), which no rerun changes; any other rejection is
|
|
45
|
+
* transient. Absent: the registry marks it (Admin's Services).
|
|
46
|
+
*/
|
|
47
|
+
retain?(parameters: Parameters, context: RetainContext): Promise<void>;
|
|
48
|
+
/**
|
|
49
|
+
* Provider commands, by name: `astrale-domain <adapter name> <command> <environment>` runs one
|
|
50
|
+
* on an Environment this adapter deploys (adapter-cloudflare's `plan` and `init` provision the
|
|
51
|
+
* host on the operator's own account). Every effect is the adapter's; the CLI only routes.
|
|
52
|
+
*/
|
|
53
|
+
readonly commands?: Readonly<Record<string, AdapterCommand<Parameters>>>;
|
|
54
|
+
secretsFile?(parameters: Parameters): string | undefined;
|
|
19
55
|
}
|
|
56
|
+
/** What `defineAdapter` admits for an `Adapter` (adapter interface v2). */
|
|
20
57
|
export interface AdapterInput<Parameters extends object> {
|
|
21
58
|
readonly name: string;
|
|
22
59
|
readonly version: string;
|
|
60
|
+
readonly bundler: Bundler;
|
|
23
61
|
admit?(parameters: Parameters, context: AdapterEnvironmentContext): void;
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
62
|
+
configure(parameters: Parameters, context: ConfigureContext): DeploymentConfiguration;
|
|
63
|
+
placement(parameters: Parameters, context: PlacementContext): Promise<Placement>;
|
|
64
|
+
deployRelease(parameters: Parameters, context: ReleaseDeployContext): Promise<ReleaseDeployResult>;
|
|
65
|
+
list?(parameters: Parameters, context: ListContext): Promise<readonly ListedDeployment[]>;
|
|
66
|
+
retain?(parameters: Parameters, context: RetainContext): Promise<void>;
|
|
67
|
+
readonly commands?: Readonly<Record<string, AdapterCommand<Parameters>>>;
|
|
68
|
+
secretsFile?(parameters: Parameters): string | undefined;
|
|
27
69
|
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { Build, BuildDigest, BuildManifestV1 } from '../../build/index.js';
|
|
2
|
+
import type { ResolvedRuntimeReference } from '../../runtime/index.js';
|
|
3
|
+
import type { ArtifactFile, PreparedArtifactFile } from './file.js';
|
|
4
|
+
/**
|
|
5
|
+
* Produces the environment-free bytes of one Build. It takes no Environment, address, key or
|
|
6
|
+
* secret, which is what makes its build digest identical in every Environment. Adapters that share
|
|
7
|
+
* a bundler share their build.
|
|
8
|
+
*/
|
|
9
|
+
export interface Bundler {
|
|
10
|
+
readonly id: string;
|
|
11
|
+
readonly version: string;
|
|
12
|
+
bundle(context: BundleContext): Promise<BundleSource>;
|
|
13
|
+
}
|
|
14
|
+
export interface BundleContext<BuildValue extends Build = Build> {
|
|
15
|
+
readonly projectDir: string;
|
|
16
|
+
readonly build: BuildValue;
|
|
17
|
+
readonly runtime: ResolvedRuntimeReference;
|
|
18
|
+
/** Parent-owned lifecycle cancellation shared by every bundling process. */
|
|
19
|
+
readonly signal: AbortSignal;
|
|
20
|
+
/** Optional observer of authored paths read outside the Domain/Runtime module graph. */
|
|
21
|
+
readonly recordSource?: (path: string) => void;
|
|
22
|
+
}
|
|
23
|
+
/** Untrusted bundler output admitted by verify/preflight. */
|
|
24
|
+
export interface BundleSource {
|
|
25
|
+
readonly entrypoint: string;
|
|
26
|
+
readonly files: readonly ArtifactFile[];
|
|
27
|
+
}
|
|
28
|
+
/** Exact environment-free bytes of one Build, identified by their build digest. */
|
|
29
|
+
export interface Bundle<BuildValue extends Build = Build> {
|
|
30
|
+
readonly kind: 'bundle';
|
|
31
|
+
readonly build: BuildValue;
|
|
32
|
+
readonly manifest: BuildManifestV1;
|
|
33
|
+
readonly digest: BuildDigest;
|
|
34
|
+
readonly entrypoint: string;
|
|
35
|
+
readonly files: readonly PreparedArtifactFile[];
|
|
36
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/** One file a bundler produced, before admission. */
|
|
2
|
+
export interface ArtifactFile {
|
|
3
|
+
readonly path: string;
|
|
4
|
+
readonly content: Uint8Array;
|
|
5
|
+
}
|
|
6
|
+
/** One admitted file: a detached copy of its bytes on every read. */
|
|
7
|
+
export interface PreparedArtifactFile {
|
|
8
|
+
readonly path: string;
|
|
9
|
+
bytes(): Uint8Array;
|
|
10
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|