@astrale-os/sdk 0.6.0-beta.6 → 0.6.0-beta.60
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 +39 -5
- 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,381 @@
|
|
|
1
|
+
# Handler authority and dependency calls
|
|
2
|
+
|
|
3
|
+
Actions and Workflows receive `kernel`, `graph`, `query`, `mutate`, and `dependencies`.
|
|
4
|
+
Local capabilities default to the executing Domain's self authority. Direct dependency calls
|
|
5
|
+
select `caller` or `self` explicitly.
|
|
6
|
+
|
|
7
|
+
| Surface | Default authority | Explicit selection |
|
|
8
|
+
| --- | --- | --- |
|
|
9
|
+
| `kernel` | Executing Domain | `.caller`, `.self` |
|
|
10
|
+
| `graph` | Executing Domain | `.caller`, `.self` |
|
|
11
|
+
| `query`, `mutate` | None for a Query v7 or a defined Mutation; executing Domain for a V6 Query, and for a Mutation without `as` | `{ as: 'executor' }`, `{ as: 'caller' }`; a V6 Query through `graph` |
|
|
12
|
+
| `dependencies.alias` | Explicit selection required | `.caller.invoke`, `.self.invoke` |
|
|
13
|
+
|
|
14
|
+
`self` executes as the Domain. `caller` executes with the Domain as principal on behalf of the one
|
|
15
|
+
incoming caller Identity. These defaults belong to the API surface. A foreign target does not
|
|
16
|
+
silently change the authority selected by `kernel.invoke`.
|
|
17
|
+
|
|
18
|
+
## The caller
|
|
19
|
+
|
|
20
|
+
An authenticated handler receives `caller.identity` and `caller.principal`. `identity` is the one
|
|
21
|
+
Identity whose authority the invocation exercises: use it for ownership, attribution, and
|
|
22
|
+
per-user lookups. `principal` is the Identity whose credential authenticated the call, never
|
|
23
|
+
the user once a Domain acts for them: after token exchange it is the Domain that exchanged the
|
|
24
|
+
token (with the Session `exchange` option, this Domain), and after a `caller` dependency call it is
|
|
25
|
+
the calling Domain. A caller is always exactly one Identity.
|
|
26
|
+
|
|
27
|
+
## Public callables
|
|
28
|
+
|
|
29
|
+
A callable declared `auth: 'anonymous'` admits a call that carries no credential. Such a call has
|
|
30
|
+
no caller, so its handler acts as the installed Domain alone:
|
|
31
|
+
|
|
32
|
+
```ts
|
|
33
|
+
export const submitLead = defineAction<typeof schema>()('submitLead', ({ input, mutate }) =>
|
|
34
|
+
mutate(createLead, input, { as: 'executor' }),
|
|
35
|
+
)
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
- `caller` is `{ kind: 'anonymous' }`: there is no Identity to attribute the call to.
|
|
39
|
+
- `kernel`, `graph`, `query`, `mutate`, and `dependencies.alias.self` are the same Domain self
|
|
40
|
+
authority an authenticated handler receives. Installation requirements and ownership bound it;
|
|
41
|
+
nothing is granted to whoever sent the call.
|
|
42
|
+
- `kernel.caller`, `graph.caller`, `dependencies.alias.caller`, and a Provider's `execution.invoke`
|
|
43
|
+
are absent, and typed as possibly absent in an `anonymous` callable. Reach them through the
|
|
44
|
+
selection itself: `graph.caller?.query(...)`, or test `graph.caller !== undefined` first. A check
|
|
45
|
+
on `caller.kind` does not narrow them.
|
|
46
|
+
- The same callable called with a credential is authenticated as usual and receives its caller. An
|
|
47
|
+
invalid credential is refused; it never falls back to an anonymous call.
|
|
48
|
+
|
|
49
|
+
The Kernel admits a public call without asking who sent it, and the handler then runs with the
|
|
50
|
+
Domain's authority. The callable's input contract and its handler are therefore the only gate:
|
|
51
|
+
admit only what the public may submit, and return only what the public may read.
|
|
52
|
+
|
|
53
|
+
## Declaring and invoking a dependency
|
|
54
|
+
|
|
55
|
+
Declare the exact remote Schema and each consumed callable requirement in Domain composition:
|
|
56
|
+
|
|
57
|
+
```ts
|
|
58
|
+
import { DirectorySchema } from '@example/directory-domain'
|
|
59
|
+
import { defineDomain, requirements } from '@astrale-os/sdk/domain'
|
|
60
|
+
import { defineSchema, schema as language } from '@astrale-os/sdk/schema'
|
|
61
|
+
|
|
62
|
+
const schema = defineSchema('consumer.example', {
|
|
63
|
+
name: 'Consumer',
|
|
64
|
+
dependencies: { directory: DirectorySchema },
|
|
65
|
+
// Compose local callable declarations here.
|
|
66
|
+
})
|
|
67
|
+
const directory = language.resolve(DirectorySchema)
|
|
68
|
+
export const domain = defineDomain({
|
|
69
|
+
schema,
|
|
70
|
+
runtime,
|
|
71
|
+
requirements: requirements({
|
|
72
|
+
scopes: [{ on: directory.functions.lookup, operations: ['call'] }],
|
|
73
|
+
}),
|
|
74
|
+
})
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
The handler uses the declared alias without importing the remote Domain:
|
|
78
|
+
|
|
79
|
+
```ts
|
|
80
|
+
export const lookup = defineAction<typeof schema>()('lookup', ({ dependencies, input }) =>
|
|
81
|
+
dependencies.directory.caller.invoke(d => d.functions.lookup, input),
|
|
82
|
+
)
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Other callable shapes use the same invoker and require their own exact `call` scope:
|
|
86
|
+
|
|
87
|
+
```ts
|
|
88
|
+
await dependencies.directory.caller.invoke(d => d.classes.Employee.static.methods.create, input)
|
|
89
|
+
await dependencies.directory.self.invoke(d => d.classes.Employee.methods.rename, instance, input)
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
`instance` is a canonical `NodeId`. Input is always explicit, including `null` for a null-input
|
|
93
|
+
contract. The selector runs once against the loaded dependency and must return its exact owned,
|
|
94
|
+
concrete callable object. Copied, stale, foreign, abstract, or asynchronous selections fail before
|
|
95
|
+
transport. Current published Class resolution may expose an inherited alias to the same owning
|
|
96
|
+
Method object; invocation still uses that exact owner. It never invents a new inherited target.
|
|
97
|
+
|
|
98
|
+
The invoker preserves Function and Method input/output inference, including value streams and binary
|
|
99
|
+
responses. A durable callable answers with the Execution it starts, so its call types as
|
|
100
|
+
`ExecutionRef<Output>`. For value input, its optional third argument (fourth for instance Methods) accepts only
|
|
101
|
+
`timeoutMs` and `idempotencyKey`, using the canonical Client session types. The Kernel accepts an
|
|
102
|
+
`idempotencyKey` only for a durable callable, where it names the Execution the call starts, and
|
|
103
|
+
refuses it for any other. Cancellation and the parent deadline are inherited. A timeout can shorten
|
|
104
|
+
the deadline; a child does not inherit the parent's idempotency key. Detached
|
|
105
|
+
`const { invoke } = dependencies.directory.caller` keeps its types and authority binding.
|
|
106
|
+
|
|
107
|
+
## Receiving a file
|
|
108
|
+
|
|
109
|
+
A file never travels inside a call. The client uploads its bytes to the Kernel first, and the call
|
|
110
|
+
carries the receipt the upload returned: a signed string that names the user who uploaded the
|
|
111
|
+
file, valid for one hour, and that serves whoever presents it to the Kernel until then. A callable
|
|
112
|
+
declares where it takes a file with a `file()` input field; the Kernel checks the receipt and the
|
|
113
|
+
field's `maxBytes` and `mediaTypes` when it admits the call. Its handler receives a file object
|
|
114
|
+
there, reads the file if it needs to, and attaches it to a blob Property of the Domain as the
|
|
115
|
+
Domain itself.
|
|
116
|
+
|
|
117
|
+
```ts
|
|
118
|
+
import { defineAction, type ReceivedFile } from '@astrale-os/sdk/action'
|
|
119
|
+
import { defineMutation } from '@astrale-os/sdk/mutation'
|
|
120
|
+
import { classIcon, defineSchema, file, func, nodeClass, property, schema } from '@astrale-os/sdk/schema'
|
|
121
|
+
import { z } from 'zod'
|
|
122
|
+
|
|
123
|
+
const source = property(schema.values.blob({ maxBytes: 20_000_000, mediaTypes: ['text/csv'] }))
|
|
124
|
+
const TrialBalance = nodeClass({
|
|
125
|
+
icon: classIcon.neutral,
|
|
126
|
+
properties: { fiscalYear: z.string(), source },
|
|
127
|
+
policies: { read: true },
|
|
128
|
+
})
|
|
129
|
+
const Schema = defineSchema('ledger.example', {
|
|
130
|
+
name: 'Ledger',
|
|
131
|
+
classes: { TrialBalance },
|
|
132
|
+
functions: {
|
|
133
|
+
importBalance: func({
|
|
134
|
+
auth: 'authenticated',
|
|
135
|
+
input: z.strictObject({
|
|
136
|
+
fiscalYear: z.string(),
|
|
137
|
+
balance: file(source), // the field states the Property's constraints
|
|
138
|
+
attachments: z.array(file({ maxBytes: 5_000_000 })).max(10),
|
|
139
|
+
}),
|
|
140
|
+
output: z.string(),
|
|
141
|
+
}),
|
|
142
|
+
},
|
|
143
|
+
})
|
|
144
|
+
|
|
145
|
+
const recordBalance = defineMutation<typeof Schema>()('trialBalance.record', {
|
|
146
|
+
build(input: { fiscalYear: string; balance: ReceivedFile }, { TrialBalance }, mutation) {
|
|
147
|
+
mutation.createNode({
|
|
148
|
+
as: 'balance',
|
|
149
|
+
class: TrialBalance,
|
|
150
|
+
props: { fiscalYear: input.fiscalYear, source: input.balance }, // attached as it is
|
|
151
|
+
})
|
|
152
|
+
},
|
|
153
|
+
})
|
|
154
|
+
|
|
155
|
+
export const importBalance = defineAction<typeof Schema>()(
|
|
156
|
+
'importBalance',
|
|
157
|
+
async ({ input, mutate }) => {
|
|
158
|
+
const csv = await input.balance.text() // whole file, in memory: 10 MiB at most
|
|
159
|
+
if (!csv.startsWith('account,')) throw new Error('Not a trial balance.')
|
|
160
|
+
await mutate(recordBalance, input, { as: 'executor' }) // the Domain writes its own record
|
|
161
|
+
return csv.split('\n').length.toString()
|
|
162
|
+
},
|
|
163
|
+
)
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
`ReceivedFile` is exported by `@astrale-os/sdk/action`. A client sends the file in two steps,
|
|
167
|
+
upload then call, or lets the typed `invoke` of a Client Session upload a `Blob` or `File` found at
|
|
168
|
+
a `file()` field before it calls:
|
|
169
|
+
|
|
170
|
+
```ts
|
|
171
|
+
const { receipt } = await session.content.upload(csv, { mediaType: 'text/csv' })
|
|
172
|
+
await session.invoke(reference(ledger, ledger.functions.importBalance), {
|
|
173
|
+
fiscalYear: '2026',
|
|
174
|
+
balance: receipt,
|
|
175
|
+
attachments: [],
|
|
176
|
+
})
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### Reading the file
|
|
180
|
+
|
|
181
|
+
| Member | Returns |
|
|
182
|
+
| --- | --- |
|
|
183
|
+
| `receipt` | The receipt the caller sent. |
|
|
184
|
+
| `stream()` | A `ReadableStream<Uint8Array>` of the file, for a file of any size. |
|
|
185
|
+
| `text()` | The whole file decoded as UTF-8. |
|
|
186
|
+
| `bytes()` | The whole file as a `Uint8Array`. |
|
|
187
|
+
|
|
188
|
+
- **As the caller.** Each read downloads the file again with `kernel.caller.content.download({
|
|
189
|
+
receipt })`. The receipt serves whoever presents it until it expires, this Domain's own authority
|
|
190
|
+
included; past its hour the Kernel refuses it with `BLOB_RECEIPT_INVALID`. Nothing is kept between
|
|
191
|
+
reads; a file read twice is downloaded twice.
|
|
192
|
+
- **In memory up to `FILE_MEMORY_LIMIT`.** `text()` and `bytes()` hold the whole file, so they
|
|
193
|
+
refuse a file larger than `FILE_MEMORY_LIMIT` (10 MiB, exported by `@astrale-os/sdk/action`) with
|
|
194
|
+
`FileReadError` `FILE_MEMORY_LIMIT`, before reading it when its size is known. Read a larger file
|
|
195
|
+
with `stream()`.
|
|
196
|
+
- **Complete or failed.** `text()` and `bytes()` resolve only once the whole file arrived with the
|
|
197
|
+
size the Kernel declared and passed its integrity check. `stream()` hands chunks over as they
|
|
198
|
+
arrive and fails at its end if the file does not: write nothing derived from it anywhere lasting
|
|
199
|
+
before the stream ends. Cancelling the stream cancels the download.
|
|
200
|
+
- **The field's constraints.** The SDK checks a field's `maxBytes` and `mediaTypes` on each read
|
|
201
|
+
and refuses a file outside them with `FileReadError` (`FILE_TOO_LARGE`, `FILE_MEDIA_TYPE`). The
|
|
202
|
+
Kernel never checks them against a receipt; clients check them before they upload. A file
|
|
203
|
+
attached without being read is checked by the Kernel against the Property's own constraints only,
|
|
204
|
+
so a field that feeds a Property should state them: `file(source)` copies them, and
|
|
205
|
+
`file(source, { maxBytes })` may narrow them.
|
|
206
|
+
- **Refusals reach the caller.** A `FileReadError` the handler does not catch reaches the caller as
|
|
207
|
+
`LIMIT_EXCEEDED` (size) or `VALIDATION_ERROR` (media type) with its code as the reason, and the
|
|
208
|
+
Kernel's refusal of a receipt reaches it as the Kernel sent it.
|
|
209
|
+
|
|
210
|
+
### Attaching the file
|
|
211
|
+
|
|
212
|
+
A blob Property value takes the file object as it is in every Mutation the SDK authors (`mutate`,
|
|
213
|
+
`graph.mutate`, a defined Mutation's `build`, `createNode`, `updateNode`) and writes its receipt.
|
|
214
|
+
Attach the file to the Domain's own records as the Domain, `mutate(definition, input, { as:
|
|
215
|
+
'executor' })`: the Domain decides the write, and the Kernel applies the Property's constraints to
|
|
216
|
+
the file. A write `{ as: 'caller' }` also takes the receipt, under the caller's permissions. The raw
|
|
217
|
+
Kernel builder of `kernel.mutate((m) => ...)` takes `file.receipt`. Attaching never reads the file.
|
|
218
|
+
|
|
219
|
+
- **Within the hour.** A receipt expires one hour after its upload. Read and attach the file in
|
|
220
|
+
the invocation that received it; keep the attached Node, never the receipt.
|
|
221
|
+
- **Authenticated callables only.** A received file is read as the caller, and a call to an
|
|
222
|
+
`anonymous` callable may carry no caller. The runtime refuses a `file()` field in the input of an
|
|
223
|
+
`anonymous` callable when it is built or served.
|
|
224
|
+
- **Passing it on.** To hand the file to a dependency that takes it in a `file()` field, send its
|
|
225
|
+
receipt, as the caller or as the Domain: `dependencies.files.caller.invoke(d => d.functions.scan, { file:
|
|
226
|
+
input.balance.receipt })`.
|
|
227
|
+
- **Durable Workflows.** A durable Workflow's input holds the receipt itself at each `file()`
|
|
228
|
+
field, not a file object. Its Steps use it as the Domain (`kernel.content.download({ receipt })`,
|
|
229
|
+
a blob Property value) only until it expires, one hour after the upload: attach the file to a
|
|
230
|
+
Node in the run's first Steps. See
|
|
231
|
+
[Files in a durable Workflow](durable-workflows.md#files-in-a-durable-workflow).
|
|
232
|
+
|
|
233
|
+
### Testing a handler
|
|
234
|
+
|
|
235
|
+
`testing.file(content, { type })` from `@astrale-os/sdk/testing` makes a file object over bytes
|
|
236
|
+
held in memory: a handler unit test passes it in its input without a Kernel. It reads the same bytes
|
|
237
|
+
on every read, under the same limits, and a Mutation attaches it as its `receipt`.
|
|
238
|
+
|
|
239
|
+
```ts
|
|
240
|
+
import * as testing from '@astrale-os/sdk/testing'
|
|
241
|
+
|
|
242
|
+
const balance = testing.file('account,amount\n512,10', { type: 'text/csv' })
|
|
243
|
+
await expect(balance.text()).resolves.toBe('account,amount\n512,10')
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
## Binary Function input
|
|
247
|
+
|
|
248
|
+
A binary input carries a stream the Function processes as it arrives and does not store, such as a
|
|
249
|
+
payload it forwards, transforms, or measures. To receive a file the Domain stores, use a `file()`
|
|
250
|
+
field (see [Receiving a file](#receiving-a-file)).
|
|
251
|
+
|
|
252
|
+
A Function can declare `input.binary(metadataSchema, { maximumBytes })`. The handler receives
|
|
253
|
+
validated JSON metadata in `ctx.input` and a single-consumer `ReadableStream<Uint8Array>` plus its
|
|
254
|
+
declared byte `length` in `ctx.body`. Consume the stream through EOF before returning a successful
|
|
255
|
+
result. The bytes stay outside `Call.input` and are sent as the HTTP request body.
|
|
256
|
+
|
|
257
|
+
```ts
|
|
258
|
+
const digest = await dependencies.hasher.caller.invoke(
|
|
259
|
+
d => d.functions.digest,
|
|
260
|
+
{ mediaType: file.type },
|
|
261
|
+
{ body: file },
|
|
262
|
+
)
|
|
263
|
+
await kernel.invoke(digestReference, { mediaType: file.type }, { body: file })
|
|
264
|
+
await kernel.call({ target: digestReference.target, input: { mediaType: file.type } }, { body: file })
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
The typed `invoke` overload requires `body` for a binary Function and forbids it for a value-input
|
|
268
|
+
Function. Raw `call` and `dispatch` also accept `{ body }`; the Server checks the resolved Function
|
|
269
|
+
contract. A binary input cannot use `idempotencyKey`.
|
|
270
|
+
|
|
271
|
+
- **One reader.** `ctx.body` is the Kernel's own binary request body, `{ body:
|
|
272
|
+
ReadableStream<Uint8Array>, length }`. It is read once: do not `tee()` it or read it from a
|
|
273
|
+
durable Workflow, whose Steps are retried. `kernel.content.upload` still accepts it unread, and
|
|
274
|
+
streams it to the Kernel as it arrives in one attempt that is never retried, but a file the Domain
|
|
275
|
+
stores belongs in a `file()` field.
|
|
276
|
+
- **The declared length is exact.** The Server admits the body against the length its caller
|
|
277
|
+
declared; a body that ends early or runs over fails.
|
|
278
|
+
- **Declare `maximumBytes` on each binary Function.** It bounds what that Function accepts, and is
|
|
279
|
+
checked against the declared length before the handler runs.
|
|
280
|
+
- **The deployment follows the Domain.** The Server also caps every streamed request, before any
|
|
281
|
+
Function is chosen, with its `maximumBinaryRequestBytes`. A Worker built by the Cloudflare
|
|
282
|
+
adapter sets it to the largest `maximumBytes` among its Domain's binary Functions, so its
|
|
283
|
+
`maximumRequestBytes` (1 MiB by default, 16 MiB at most) bounds only the bodies it buffers. A
|
|
284
|
+
larger body is refused with `413` and `LIMIT_EXCEEDED` before the handler runs. A binary request
|
|
285
|
+
lives up to 30 minutes, or the deployment's `invocationTimeoutMs` when that is longer, and is
|
|
286
|
+
cancelled after 60 seconds without a new chunk while the handler reads it. A Domain without a
|
|
287
|
+
binary Function keeps the Server defaults. A host that composes `serve()` itself states these in
|
|
288
|
+
its `server.limits` (`maximumBinaryRequestBytes`, `binaryRequestTimeoutMs`,
|
|
289
|
+
`binaryRequestIdleTimeoutMs`). Cloudflare refuses a request body past its plan's limit before the
|
|
290
|
+
Worker runs: 100 MB on Free and Pro, 200 MB on Business, more on Enterprise.
|
|
291
|
+
- **Methods cannot take a binary input.** Declare a Function that names its target Node in the
|
|
292
|
+
metadata.
|
|
293
|
+
|
|
294
|
+
`domain.dependencies` remains immutable loaded Schema metadata. `dependencies` is a separate frozen
|
|
295
|
+
map containing only direct non-Kernel aliases. Each alias exposes exactly `.caller` and `.self`,
|
|
296
|
+
each with its own `invoke`. Selectors do not nest, and there is no default `invoke` on the alias.
|
|
297
|
+
|
|
298
|
+
## Explicit authority
|
|
299
|
+
|
|
300
|
+
```ts
|
|
301
|
+
import { reference } from '@astrale-os/sdk/client/session'
|
|
302
|
+
import { Path } from '@astrale-os/sdk/graph/path'
|
|
303
|
+
|
|
304
|
+
const directory = domain.dependencies.directory
|
|
305
|
+
const lookup = reference(directory, directory.functions.lookup)
|
|
306
|
+
await kernel.invoke(lookup, input) // executing Domain
|
|
307
|
+
await kernel.caller.invoke(lookup, input) // incoming caller Identity
|
|
308
|
+
await kernel.self.invoke(lookup, input) // executing Domain
|
|
309
|
+
|
|
310
|
+
const rename = reference(directory, directory.classes.Employee.methods.rename)(Path.id(instance))
|
|
311
|
+
await kernel.self.invoke(rename, input)
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
`graph.query` and `graph.mutate` execute named SDK definitions. `kernel.graph` is the canonical raw
|
|
315
|
+
Kernel graph capability. Explicit named graph operations use `graph.caller.query` or
|
|
316
|
+
`graph.self.mutate`. Bare `query` and `mutate` are ordinary functions.
|
|
317
|
+
|
|
318
|
+
For U → A → B, a `caller` dependency call carries the incoming caller U and identifies A as the
|
|
319
|
+
outbound principal. Inside B, local defaults use B's self authority; B's next `caller` dependency
|
|
320
|
+
call forwards the same caller U with principal B. A caller is always one Identity. Existing
|
|
321
|
+
Kernel authentication, delegation, callable capability, and Policy gates still apply. This wrapper
|
|
322
|
+
neither grants permission nor retries denials under stronger authority.
|
|
323
|
+
|
|
324
|
+
## Workflow and lifecycle
|
|
325
|
+
|
|
326
|
+
A direct dependency invocation is one semantic effect. Workflows place it in one named step:
|
|
327
|
+
|
|
328
|
+
```ts
|
|
329
|
+
const employee = await step.run('lookup-employee', () =>
|
|
330
|
+
dependencies.directory.caller.invoke(d => d.functions.lookup, input),
|
|
331
|
+
)
|
|
332
|
+
await step.mutate('record-employee', recordEmployee, employee, { as: 'executor' })
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
In a durable Workflow, the Step callback receives `dependencies` with the rest of its capabilities,
|
|
336
|
+
acting as the Domain alone: only `self` exists. A call to a durable callable carries the Step's
|
|
337
|
+
derived key, so a retried Step reaches the same child Execution; see
|
|
338
|
+
[Durable Workflows](durable-workflows.md).
|
|
339
|
+
|
|
340
|
+
```ts
|
|
341
|
+
const shipment = await step.run('ship', ({ dependencies }) =>
|
|
342
|
+
dependencies.shipping.self.invoke(d => d.functions.ship, { parcel }),
|
|
343
|
+
)
|
|
344
|
+
```
|
|
345
|
+
|
|
346
|
+
Inline Steps do not imply a distributed transaction, durable replay, or remote deduplication. Stream,
|
|
347
|
+
binary, and received file objects cannot become portable step results; a native streaming response belongs in an
|
|
348
|
+
Action. Invocation sessions remain open until a returned stream or binary body settles.
|
|
349
|
+
|
|
350
|
+
Integrations remain useful for consumer-owned substitution, replay metadata, or failure translation.
|
|
351
|
+
They are optional for direct declared Domain calls. Provider `execution.invoke` remains caller-bound,
|
|
352
|
+
and Provider auth minting retains its existing self binding.
|
|
353
|
+
|
|
354
|
+
## Migration
|
|
355
|
+
|
|
356
|
+
The handler `client` alias is removed. Replace former `client` use with `kernel.caller` to preserve
|
|
357
|
+
caller authority, or choose the new self default deliberately. Custom `InvocationAuthority`
|
|
358
|
+
implementations now return `{ caller, graph, close }` with
|
|
359
|
+
`caller: { kind, principal, identity, authentication }` and `graph: { caller, self }`; remove the
|
|
360
|
+
redundant `client` member and the former `caller.authority` Grant. Replace `caller.authority` reads
|
|
361
|
+
with `caller.identity`. The standalone ClientSession remains the canonical invocation surface,
|
|
362
|
+
including the binary-input `invoke`, `dispatch`, and `call` overloads described above.
|
|
363
|
+
|
|
364
|
+
The `union` authority mode is removed from `kernel`, `graph`, and `dependencies`. Replace
|
|
365
|
+
`kernel.union`, `graph.union`, and `dependencies.alias.union` with `self` to act as the executing
|
|
366
|
+
Domain, or with `caller` when the call must be authorized as the incoming caller. Admission rejects
|
|
367
|
+
an `InvocationAuthority` whose `graph` still carries a `union` session.
|
|
368
|
+
|
|
369
|
+
A call to an `anonymous` callable that carries no credential acts as the executing Domain: it
|
|
370
|
+
receives `kernel`, `graph`, `query`, `mutate`, and `dependencies.alias.self`, and no `caller`
|
|
371
|
+
selection (see [Public callables](#public-callables)). Before, `kernel`, `graph`, and `dependencies`
|
|
372
|
+
were `null` there, `query` and `mutate` were absent, and a Provider's `execution.auth` was absent.
|
|
373
|
+
A handler or Provider that used that absence to refuse calls without a credential still compiles and
|
|
374
|
+
no longer refuses them. Replace such a test (`kernel === null`, `graph === null`,
|
|
375
|
+
`dependencies === null`, `query === undefined`) with `caller.kind === 'anonymous'`, and a Provider's
|
|
376
|
+
`execution.auth === undefined` with `execution.invoke === undefined`. Custom `InvocationAuthority`
|
|
377
|
+
implementations add `self({ via, domain, context })`, which resolves to `{ graph: { self }, close }`.
|
|
378
|
+
|
|
379
|
+
The linter accepts direct declared dependencies and canonical Kernel references. It checks exact
|
|
380
|
+
`call` scopes, rejects foreign handler imports, and reports opaque selectors as
|
|
381
|
+
indeterminate. Requirement analysis never executes selectors during compilation.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Query V6 (legacy)
|
|
2
|
+
|
|
3
|
+
Query V6 is the Query form that builds a `QueryAST` with `Query.from(…)` inside a definition
|
|
4
|
+
projected from the Domain. Its definitions keep their names, types and behaviour, and are
|
|
5
|
+
deprecated in favour of [Query v7](../queries.md). Two places read with V6 only:
|
|
6
|
+
|
|
7
|
+
- a maintenance or repair session, where Query v7 is not served, so a migration reads with V6;
|
|
8
|
+
- a Host whose Kernel does not serve Query v7 and the Class of each row; [the Query
|
|
9
|
+
guide](../queries.md) says what a Query v7 raises there.
|
|
10
|
+
|
|
11
|
+
## What V6 looks like
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import { defineQuery, Property, Query } from '@astrale-os/sdk/query'
|
|
15
|
+
|
|
16
|
+
export const openTasks = defineQuery<TasksSchema>()((domain) => ({
|
|
17
|
+
id: 'tasks.open',
|
|
18
|
+
page: { size: 50 },
|
|
19
|
+
build: () =>
|
|
20
|
+
Query.from({ nodes: [domain.classes.Task], binding: 'task' })
|
|
21
|
+
.filter({ predicate: Property(domain.classes.Task.properties.status.key).equals('open') })
|
|
22
|
+
.select({ kind: 'nodes', projection: { kind: 'value' } }),
|
|
23
|
+
project: (result) => result,
|
|
24
|
+
}))
|
|
25
|
+
|
|
26
|
+
const tasks = await query(openTasks)
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
- `defineQuery<Schema>()` applied to one projector from the Domain makes a V6 definition. Applied
|
|
30
|
+
to an id and a spec, it makes a Query v7.
|
|
31
|
+
- `query(definition, input?)` reads as the installed Domain; a V6 call takes no `as`.
|
|
32
|
+
- `page.size` is 256 when omitted. `pagination: { maximumPages }` follows every page and runs
|
|
33
|
+
`project` over the completed chain.
|
|
34
|
+
- `defineCompositeQuery` combines several definitions in one `QueryPlan`.
|
|
35
|
+
`defineCollectionQuery` and `query.union` compile complete-Class reads into one `QueryAST`.
|
|
36
|
+
- `queryResult` reads a V6 result.
|
|
37
|
+
- `mutation.expect.query({ query, equals })` is a V6 precondition (Mutation v3). A Mutation holds
|
|
38
|
+
V6 preconditions or v7 guards, never both.
|
|
39
|
+
|
|
40
|
+
## From V6 to v7
|
|
41
|
+
|
|
42
|
+
| V6 | v7 |
|
|
43
|
+
| --- | --- |
|
|
44
|
+
| `defineQuery<S>()((domain) => ({ id, build, project }))` | `defineQuery<S>()(id, { build: (input, d) => …, output })` |
|
|
45
|
+
| `Query.from({ nodes: [domain.classes.Task] })` | `d.Task` |
|
|
46
|
+
| `Query.from({ nodes: [taskId] })` | `d.Task.get(taskId)` |
|
|
47
|
+
| `Query.from({ edges: [assigned_to] })` | `d.assigned_to` |
|
|
48
|
+
| `.filter({ predicate: Property(key).equals(v) })` | `.where((t) => t.status.eq(v))` |
|
|
49
|
+
| `.expand({ via, direction })` | `.via(edge, { direction })`, or a named to-one relation: `t.assignee` |
|
|
50
|
+
| `.select({ kind: 'nodes', projection: { kind: 'reference' } })` | `.pick()` |
|
|
51
|
+
| `page: { size }` | `.page({ max })`, called with `{ size, after }` |
|
|
52
|
+
| `pagination: { maximumPages }` | `.all({ max })` |
|
|
53
|
+
| `project(result)` | `output(results, input, { error, is })` |
|
|
54
|
+
| `defineCompositeQuery` and dependent leaves | A record of facets, or `steps(first, (earlier) => next, …)` |
|
|
55
|
+
| `defineCollectionQuery`, `query.union` | `.all({ max })`, `d.A.union(d.B)` |
|
|
56
|
+
| `query(definition, input)` | `query(query, input, { as: 'executor' \| 'caller' })` |
|
|
57
|
+
| `step.query(step, definition, input)` | `step.query(step, query, input, { as: 'executor' })` |
|
|
58
|
+
| `expect.query({ query, equals })` | `expect.none`, `expect.exists`, `expect.count`, `expect.unchanged` |
|
|
59
|
+
|
|
60
|
+
A V6 read that v7 cannot express is bridged inside the Query v7; see
|
|
61
|
+
[Beyond v7](../queries.md#beyond-v7). A V6 definition moves to v7 once every Host it runs against
|
|
62
|
+
serves Query v7 and the Class of each row.
|
package/docs/legacy.md
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# Legacy: keeping old behaviour without letting it spread
|
|
2
|
+
|
|
3
|
+
A change of design rarely lands everywhere at once: releases already installed, callers on older
|
|
4
|
+
versions and stored data keep the previous shape. This method keeps that previous behaviour
|
|
5
|
+
working, in one place, named, tested and ready to delete, while every other file reads as the new
|
|
6
|
+
design. It is shared by the Astrale repositories; this page is the reference they mirror.
|
|
7
|
+
|
|
8
|
+
The aim is that removing the old behaviour later is a deletion: delete each `legacy/` folder, its
|
|
9
|
+
seam's one call and its ledger row, replace each named relaxation by its target value, and nothing
|
|
10
|
+
else changes.
|
|
11
|
+
|
|
12
|
+
## The rules
|
|
13
|
+
|
|
14
|
+
1. **Target code is the only code outside `legacy/`.** Every file outside a `legacy/` folder reads
|
|
15
|
+
as the target design. Old names, old shapes, migration helpers and bridges live in a `legacy/`
|
|
16
|
+
folder next to the owner they serve (`src/application/requirements/legacy/`,
|
|
17
|
+
`domain/schema/modules/user/legacy/`), never in a repository-wide dumping ground. A file in it is
|
|
18
|
+
named for what it keeps (`legacy/member-of-group.ts`), never `compat.ts`.
|
|
19
|
+
2. **Legacy is named.** Every exported legacy symbol starts with `legacy` (`legacyRequirements`,
|
|
20
|
+
`LEGACY_USER_INHERITANCE`) or, for a type or class, `Legacy` (`LegacyRequirementsInput`). The one
|
|
21
|
+
exception is a public name a release already exported, kept as a deprecated alias so no import
|
|
22
|
+
breaks; the ledger row lists it.
|
|
23
|
+
3. **Legacy is tagged.** Every legacy export carries
|
|
24
|
+
`@deprecated <what it keeps> (<ledger id>). Replaced by <target symbol>. Removal: <condition>.`
|
|
25
|
+
4. **One seam per owner.** Target code reaches legacy code through one explicit, named call per
|
|
26
|
+
owner, and the seam is target code:
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
// The one seam to the legacy shape: a key only that shape declares selects it.
|
|
30
|
+
if (isLegacyCapabilities(input)) return legacyRequirements(input)
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
When the test that selects legacy belongs to legacy, the legacy function makes it and answers
|
|
34
|
+
`undefined` otherwise, so the seam stays one call:
|
|
35
|
+
`const legacy = legacyRequirementEntries(definition); if (legacy !== undefined) return legacy`.
|
|
36
|
+
No `if (legacy)` is scattered through target modules.
|
|
37
|
+
5. **Relaxations are named constants.** When the target must be relaxed for existing data (a
|
|
38
|
+
property that will become required, a Class that will become final), the target declaration
|
|
39
|
+
imports a named relaxation instead of writing the relaxed value inline:
|
|
40
|
+
`inheritance: LEGACY_USER_INHERITANCE` (`'open'`, target `'final'`). Removal replaces each
|
|
41
|
+
import by its target value.
|
|
42
|
+
6. **Ledger.** Each repository keeps `legacy/LEDGER.md` at its package root (one per package when
|
|
43
|
+
packages are published separately) with one row per item:
|
|
44
|
+
|
|
45
|
+
`| id | legacy item (file) | replaced by | seam | removal condition | evidence (test) |`
|
|
46
|
+
|
|
47
|
+
Ids are `L-<REPO>-<n>` (`L-SDK-1`, `L-SHELL-3`) and are never reused. A repository with several
|
|
48
|
+
ledgers gives each package's ledger a one-letter prefix (`L-SHELL-C1` for the client SDK,
|
|
49
|
+
`L-SHELL-U2` for the screens) so ids stay unique across them. The seam column names the
|
|
50
|
+
seam's file in backticks: the boundary test reads it.
|
|
51
|
+
7. **Evidence.** Each item has a test under `legacy/__tests__/` proving the old input or behaviour
|
|
52
|
+
still works (byte for byte where the old output is persisted or signed), and the target path has
|
|
53
|
+
its own tests that never import `legacy/`. A boundary test (`legacy-boundary.test.*`) fails when
|
|
54
|
+
a file outside a `legacy/` folder imports one without being a seam the ledger lists, when a
|
|
55
|
+
`legacy/` folder has no row, or when a legacy export is not named and tagged.
|
|
56
|
+
8. **No new legacy consumers.** Docs, examples and scaffolds show only the target API. Legacy
|
|
57
|
+
documentation, when kept, moves to `docs/legacy/`. Remaining consumers that cannot move yet are
|
|
58
|
+
listed under the ledger table, with the reason.
|
|
59
|
+
|
|
60
|
+
## In a Domain project
|
|
61
|
+
|
|
62
|
+
`astrale-domain lint` applies the method to Domain source:
|
|
63
|
+
|
|
64
|
+
- **Where.** A `legacy/` folder sits beside one owner: the Domain root (`legacy/`), a semantic
|
|
65
|
+
submodule (`functions/user/legacy/`), the Schema root (`schema/legacy/`), a Schema module
|
|
66
|
+
(`schema/modules/user/legacy/`) or a declaration-kind directory (`schema/policies/legacy/`).
|
|
67
|
+
`legacy` is therefore a reserved directory name, and folders do not nest.
|
|
68
|
+
- **Transparent.** Every rule reads a file in the folder as its owner's, with `legacy/` removed:
|
|
69
|
+
`schema/policies/legacy/is-self.ts` is a Policy leaf and declares one Policy,
|
|
70
|
+
`schema/modules/user/legacy/policies/owns-user.ts` is a Policy leaf of the module,
|
|
71
|
+
`schema/legacy/schema.ts` is a Schema facade, and `functions/user/legacy/__tests__/` is the
|
|
72
|
+
owner's focused evidence.
|
|
73
|
+
- **Keeper files.** Where the owner admits only its facade (the Domain root, the Schema root, a
|
|
74
|
+
Schema module), the folder may also hold flat files named for what they keep, such as
|
|
75
|
+
`relaxations.ts`; they construct no Schema declaration, which goes in its kind directory under
|
|
76
|
+
the folder.
|
|
77
|
+
- **Seam.** The folder exposes an `index.ts` facade (`#functions/user/legacy`,
|
|
78
|
+
`../legacy/index.js`). Only files of its owner (its seam) and other legacy code import it; no
|
|
79
|
+
file outside the folder imports past it. A layer that composes an owner's legacy, such as
|
|
80
|
+
`runtime.ts` registering legacy Actions, reaches it through the owner's own facade.
|
|
81
|
+
- **Tags.** Every declaration a legacy folder exports is named `legacy…`, `Legacy…` or `LEGACY_…`
|
|
82
|
+
and carries the `@deprecated … (L-<REPO>-<n>). Replaced by … Removal: …` tag.
|
|
83
|
+
|
|
84
|
+
`MOD-LEGACY` checks the placement, keepers and seams, and `QLT-LEGACY-TAG` the names and tags;
|
|
85
|
+
both are errors.
|
|
86
|
+
|
|
87
|
+
## Adding a legacy item
|
|
88
|
+
|
|
89
|
+
1. Write the target code first, with its own tests, as if the old shape never existed.
|
|
90
|
+
2. Move what keeps the old behaviour into `legacy/` next to its owner; rename its exports with the
|
|
91
|
+
`legacy`/`Legacy` prefix and tag each one.
|
|
92
|
+
3. Add the seam: one call from the owner's target entry point. If the old behaviour must be
|
|
93
|
+
recognized, prefer the guard the upstream owner already publishes (here the Kernel's
|
|
94
|
+
`isLegacyCapabilities`) over a new heuristic.
|
|
95
|
+
4. Move or write the evidence under `legacy/__tests__/`. Where old output is persisted, signed or
|
|
96
|
+
hashed, record its exact bytes before the move and assert them after.
|
|
97
|
+
5. Add the ledger row. Run the boundary test.
|
|
98
|
+
|
|
99
|
+
## Removing a legacy item
|
|
100
|
+
|
|
101
|
+
When its removal condition holds, in a release that may break: delete the `legacy/` folder, the
|
|
102
|
+
seam's call (the target branch stays), the row and the consumers listed under the table; replace
|
|
103
|
+
named relaxations by their target values. If anything else has to change, the item was not fully
|
|
104
|
+
isolated: record that in the ledger before the next one.
|
|
105
|
+
|
|
106
|
+
## In this repository
|
|
107
|
+
|
|
108
|
+
[`legacy/LEDGER.md`](../legacy/LEDGER.md) lists the items. The pre-Roles capability shape
|
|
109
|
+
(`functions`, `classes`, `authority`, `core`) is kept through four seams, one per owner it touches:
|
|
110
|
+
authoring (`requirements()`, L-SDK-1), Build compilation (L-SDK-2), the Query crossing check
|
|
111
|
+
(L-SDK-3) and the source rules of `astrale-domain lint` (L-SDK-4). Query V6 and the Mutation closure
|
|
112
|
+
form predate this method; their rows list their several importers until they are removed.
|
|
113
|
+
`__tests__/unit/legacy-boundary.test.ts` enforces the rules above.
|