@astrale-os/sdk 0.6.0-beta.5 → 0.6.0-beta.50
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 +213 -60
- package/dist/application/action/action.d.ts +6 -0
- package/dist/application/action/authoring.d.ts +1 -1
- package/dist/application/action/context.d.ts +81 -33
- package/dist/application/action/define.d.ts +3 -3
- package/dist/application/action/index.d.ts +1 -1
- 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/index.d.ts +4 -4
- 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 +5 -3
- package/dist/application/mutation/authoring/properties.js +35 -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 +25 -0
- package/dist/application/query/execution/crossings.js +192 -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/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 +320 -0
- package/dist/application/query/execution/run.d.ts +75 -0
- package/dist/application/query/execution/run.js +328 -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 +271 -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 +971 -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/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/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 +3 -4
- package/dist/application/workflow/runner/runner.d.ts +2 -2
- package/dist/application/workflow/step/output.d.ts +2 -0
- package/dist/application/workflow/step/output.js +73 -0
- 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 +15 -2
- package/dist/deployment/build/compile.d.ts +4 -4
- package/dist/deployment/build/compile.js +19 -17
- 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/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 +31 -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 +90 -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/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 +13 -0
- package/dist/execution/invocation/capabilities/bind.js +61 -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 +7 -6
- package/dist/execution/invocation/dispatch/context.js +11 -44
- 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 +129 -21
- 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 +4 -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 +44 -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 +27 -0
- package/dist/execution/workflows/receiver.js +100 -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 +51 -0
- package/dist/execution/workflows/steps.js +93 -0
- package/dist/index.d.ts +4 -4
- 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 +56 -12
- package/dist/platform/schema/class-authoring.js +37 -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 +6 -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/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/index.d.ts +8 -1
- package/dist/testing/index.js +6 -1
- package/dist/testing/load.js +1 -1
- package/dist/testing/query.d.ts +17 -0
- package/dist/testing/query.js +34 -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/imports.d.ts +0 -1
- package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
- package/dist/tooling/linter/adapters/typescript/index.d.ts +3 -2
- package/dist/tooling/linter/adapters/typescript/index.js +3 -2
- 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 +1 -2
- package/dist/tooling/linter/implementations/source/callable-requirements.js +11 -16
- 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/global.js +18 -11
- package/dist/tooling/linter/implementations/source/mutations.js +146 -48
- 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/shared.d.ts +19 -5
- package/dist/tooling/linter/implementations/source/shared.js +131 -55
- package/dist/tooling/linter/implementations/source/verifiers.js +4 -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 +15 -64
- package/dist/tooling/linter/requirements/registry.js +11 -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/admission-age.md +88 -0
- package/docs/auth-api-migration.md +55 -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 +473 -0
- package/docs/handler-dependencies.md +285 -0
- package/docs/legacy/query-v6.md +62 -0
- package/docs/queries.md +475 -0
- package/docs/release.md +155 -0
- package/docs/schema-cost.md +124 -0
- package/package.json +49 -17
- 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/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,40 +1,54 @@
|
|
|
1
|
+
import { admitClassIconSvg } from '../platform/schema/class-icon-svg.js';
|
|
1
2
|
import { isRequirements } from './requirements/index.js';
|
|
2
3
|
import { isRoutes } from './routes/index.js';
|
|
3
4
|
import { isRuntime } from './runtime/index.js';
|
|
4
5
|
import { isFrontend } from './view/index.js';
|
|
5
|
-
const
|
|
6
|
-
/** Capture one inert authored
|
|
7
|
-
export function
|
|
6
|
+
const admittedDomainDefinitions = new WeakSet();
|
|
7
|
+
/** Capture one inert authored Domain without resolving, compiling, loading, or deploying it. */
|
|
8
|
+
export function defineDomain(input) {
|
|
8
9
|
if (input === null || typeof input !== 'object' || Array.isArray(input))
|
|
9
10
|
invalid();
|
|
10
|
-
const allowed = new Set([
|
|
11
|
+
const allowed = new Set([
|
|
12
|
+
'schema',
|
|
13
|
+
'runtime',
|
|
14
|
+
'frontend',
|
|
15
|
+
'routes',
|
|
16
|
+
'requirements',
|
|
17
|
+
'icon',
|
|
18
|
+
]);
|
|
11
19
|
if (Reflect.ownKeys(input).some((key) => !allowed.has(key)))
|
|
12
20
|
invalid();
|
|
21
|
+
if (typeof input.schema?.name !== 'string') {
|
|
22
|
+
throw new TypeError(`Domain Schema ${String(input.schema?.origin)} must declare its name: defineSchema(origin, { name, ... }).`);
|
|
23
|
+
}
|
|
13
24
|
if (!isRuntime(input.runtime))
|
|
14
|
-
throw new TypeError('
|
|
25
|
+
throw new TypeError('Domain Runtime is not admitted.');
|
|
15
26
|
if (input.frontend !== undefined &&
|
|
16
27
|
(!isFrontend(input.frontend) || input.frontend.schema !== input.schema)) {
|
|
17
|
-
throw new TypeError('
|
|
28
|
+
throw new TypeError('Domain Frontend is not admitted for its exact Schema.');
|
|
18
29
|
}
|
|
19
30
|
if (input.routes !== undefined && !isRoutes(input.routes)) {
|
|
20
|
-
throw new TypeError('
|
|
31
|
+
throw new TypeError('Domain routes are not admitted.');
|
|
21
32
|
}
|
|
22
33
|
if (input.requirements !== undefined && !isRequirements(input.requirements)) {
|
|
23
|
-
throw new TypeError('
|
|
34
|
+
throw new TypeError('Domain requirements are not admitted.');
|
|
24
35
|
}
|
|
25
|
-
|
|
36
|
+
// The same admission as a Node Class icon: one self-contained inline SVG.
|
|
37
|
+
const icon = input.icon === undefined ? undefined : admitClassIconSvg(input.icon);
|
|
38
|
+
const domain = Object.freeze({
|
|
26
39
|
schema: input.schema,
|
|
27
40
|
runtime: input.runtime,
|
|
28
41
|
...(input.frontend === undefined ? {} : { frontend: input.frontend }),
|
|
29
42
|
...(input.routes === undefined ? {} : { routes: input.routes }),
|
|
30
43
|
...(input.requirements === undefined ? {} : { requirements: input.requirements }),
|
|
44
|
+
...(icon === undefined ? {} : { icon }),
|
|
31
45
|
});
|
|
32
|
-
|
|
33
|
-
return
|
|
46
|
+
admittedDomainDefinitions.add(domain);
|
|
47
|
+
return domain;
|
|
34
48
|
}
|
|
35
|
-
export function
|
|
36
|
-
return input !== null && typeof input === 'object' &&
|
|
49
|
+
export function isDomainDefinition(input) {
|
|
50
|
+
return input !== null && typeof input === 'object' && admittedDomainDefinitions.has(input);
|
|
37
51
|
}
|
|
38
52
|
function invalid() {
|
|
39
|
-
throw new TypeError('
|
|
53
|
+
throw new TypeError('Domain definition may contain only schema, runtime, frontend, routes, requirements, and icon.');
|
|
40
54
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export type { DependencyCallOptions, DependencyInvoker, HandlerDependencies } from './invoker.js';
|
|
1
|
+
export type { DependencyBinaryCallOptions, DependencyCallOptions, DependencyInvoker, HandlerDependencies, } from './invoker.js';
|
|
@@ -1,26 +1,37 @@
|
|
|
1
1
|
import type { Binary, Input } from '../../platform/client/index.js';
|
|
2
|
-
import type { SessionRequestOptions } from '../../platform/client/session/index.js';
|
|
2
|
+
import type { ExecutionRef, SessionRequestOptions, SessionRequestOptionsWithBody } from '../../platform/client/session/index.js';
|
|
3
3
|
import type { NodeId } from '../../platform/graph/node/index.js';
|
|
4
|
-
import type { CallableInputOf, CallableOutputOf, CallableResultOf, Domain, ResolvedMethod, KernelSchema, schema } from '../../platform/schema/index.js';
|
|
5
|
-
import type { LocalCallable } from '../action/index.js';
|
|
6
|
-
export type DependencyCallOptions = Pick<SessionRequestOptions, 'timeoutMs' | 'idempotencyKey'>;
|
|
4
|
+
import type { CallableInputOf, CallableInputModeOf, CallableOutputOf, CallableResultOf, Domain, ResolvedFunction, ResolvedMethod, KernelSchema, schema } from '../../platform/schema/index.js';
|
|
5
|
+
import type { AuthorityMode, AuthoritySelection, LocalCallable } from '../action/index.js';
|
|
6
|
+
export type DependencyCallOptions = Pick<SessionRequestOptions, 'timeoutMs' | 'idempotencyKey' | 'body'>;
|
|
7
|
+
export type DependencyBinaryCallOptions = Pick<SessionRequestOptionsWithBody, 'timeoutMs' | 'idempotencyKey' | 'body'>;
|
|
7
8
|
type InstanceMethodOf<D extends Domain> = Extract<LocalCallable<D>, ResolvedMethod<unknown, unknown, false>>;
|
|
8
9
|
type FunctionOrStaticMethodOf<D extends Domain> = Exclude<LocalCallable<D>, ResolvedMethod<unknown, unknown, false>>;
|
|
10
|
+
type WithInputMode<C, Mode extends 'value' | 'binary'> = C extends unknown ? CallableInputModeOf<C> extends Mode ? C : never : never;
|
|
11
|
+
type ValueFunctionOrStaticMethodOf<D extends Domain> = WithInputMode<FunctionOrStaticMethodOf<D>, 'value'>;
|
|
12
|
+
type BinaryFunctionOf<D extends Domain> = WithInputMode<Extract<LocalCallable<D>, ResolvedFunction>, 'binary'>;
|
|
9
13
|
type DependencyInputOf<C> = C extends unknown ? unknown extends CallableInputOf<C> ? Input : [CallableInputOf<C>] extends [void] ? undefined : CallableInputOf<C> : never;
|
|
10
|
-
type
|
|
14
|
+
type HandlerResultOf<C> = unknown extends CallableOutputOf<C> ? unknown : CallableResultOf<C, Binary>;
|
|
15
|
+
/** A durable callable answers with its Execution, as the Kernel Client's typed reference does. */
|
|
16
|
+
type DependencyResultOf<C> = C extends {
|
|
17
|
+
readonly execution: {
|
|
18
|
+
readonly durable: true;
|
|
19
|
+
};
|
|
20
|
+
} ? ExecutionRef<HandlerResultOf<C>> : HandlerResultOf<C>;
|
|
11
21
|
/** One declared dependency, bound to one explicitly selected invocation authority. */
|
|
12
22
|
export interface DependencyInvoker<D extends Domain> {
|
|
13
23
|
readonly invoke: {
|
|
14
|
-
<const C extends
|
|
24
|
+
<const C extends ValueFunctionOrStaticMethodOf<D>>(select: (domain: D) => C, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
|
|
15
25
|
<const C extends InstanceMethodOf<D>>(select: (domain: D) => C, instance: NodeId, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
|
|
26
|
+
<const C extends BinaryFunctionOf<D>>(select: (domain: D) => C, metadata: NoInfer<DependencyInputOf<C>>, options: DependencyBinaryCallOptions): Promise<DependencyResultOf<C>>;
|
|
16
27
|
};
|
|
17
28
|
}
|
|
18
29
|
/**
|
|
19
30
|
* Direct Schema aliases with explicit authority selection and no default invoke.
|
|
20
|
-
* self is the executing Domain; caller forwards the incoming
|
|
21
|
-
* The canonical Kernel is exposed through context.kernel.
|
|
31
|
+
* self is the executing Domain; caller forwards the incoming caller Identity, and is absent from a
|
|
32
|
+
* call that carried no credential. The canonical Kernel is exposed through context.kernel.
|
|
22
33
|
*/
|
|
23
|
-
export type HandlerDependencies<D extends Domain> = Readonly<{
|
|
24
|
-
[Alias in keyof D['dependencies'] as D['dependencies'][Alias] extends schema.DomainOf<KernelSchema> ? never : Alias]:
|
|
34
|
+
export type HandlerDependencies<D extends Domain, Authority extends AuthorityMode = AuthorityMode> = Readonly<{
|
|
35
|
+
[Alias in keyof D['dependencies'] as D['dependencies'][Alias] extends schema.DomainOf<KernelSchema> ? never : Alias]: AuthoritySelection<DependencyInvoker<Extract<D['dependencies'][Alias], Domain>>, Authority>;
|
|
25
36
|
}>;
|
|
26
37
|
export {};
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { ClassIcon, schema } from '../platform/schema/index.js';
|
|
2
|
+
import type { Requirements } from './requirements/index.js';
|
|
3
|
+
import type { Routes } from './routes/index.js';
|
|
4
|
+
import type { Runtime, SchemaOfRuntime as RuntimeSchemaOf } from './runtime/index.js';
|
|
5
|
+
import type { Frontend } from './view/index.js';
|
|
6
|
+
declare const DOMAIN_DEFINITION_IDENTITY: unique symbol;
|
|
7
|
+
declare const DOMAIN_DEFINITION_SCHEMA: unique symbol;
|
|
8
|
+
/** Schema-independent type witness shared by every admitted Domain definition. */
|
|
9
|
+
export interface DomainDefinitionIdentity {
|
|
10
|
+
readonly [DOMAIN_DEFINITION_IDENTITY]: true;
|
|
11
|
+
}
|
|
12
|
+
/** Inert source/build composition of one Domain: its exact Schema and authored Runtime. */
|
|
13
|
+
export interface DomainDefinition<Schema extends schema.DomainSchema = schema.DomainSchema, RuntimeValue extends Runtime<Schema> = Runtime<Schema>, FrontendValue extends Frontend<Schema> | undefined = undefined, RoutesValue extends Routes | undefined = undefined, RequirementsValue extends Requirements | undefined = undefined> extends DomainDefinitionIdentity {
|
|
14
|
+
readonly schema: Schema;
|
|
15
|
+
readonly runtime: RuntimeValue;
|
|
16
|
+
readonly frontend?: FrontendValue;
|
|
17
|
+
readonly routes?: RoutesValue;
|
|
18
|
+
readonly requirements?: RequirementsValue;
|
|
19
|
+
/** The application's icon. */
|
|
20
|
+
readonly icon?: ClassIcon;
|
|
21
|
+
readonly [DOMAIN_DEFINITION_SCHEMA]: (schema: Schema) => Schema;
|
|
22
|
+
}
|
|
23
|
+
export type SchemaOfDomainDefinition<Value> = Value extends {
|
|
24
|
+
readonly schema: infer Schema;
|
|
25
|
+
} ? Extract<Schema, schema.DomainSchema> : never;
|
|
26
|
+
export type RuntimeOfDomainDefinition<Value> = Value extends {
|
|
27
|
+
readonly runtime: infer RuntimeValue;
|
|
28
|
+
} ? Extract<RuntimeValue, Runtime> : never;
|
|
29
|
+
export type SchemaOfRuntime<Value> = RuntimeSchemaOf<Value>;
|
|
30
|
+
export {};
|
|
@@ -10,6 +10,8 @@ export interface DeclaredErrorOptions<out Errors extends DeclaredErrors = Declar
|
|
|
10
10
|
export type DeclaredErrorFactory<Errors extends DeclaredErrors> = <Code extends Extract<keyof Errors, string>>(code: Code, details: z.input<Errors[Code]['details']>) => Error;
|
|
11
11
|
interface DeclaredErrorRecord {
|
|
12
12
|
readonly definition: object;
|
|
13
|
+
/** The declaration as written: the object a Function re-declares a Query or Mutation error with. */
|
|
14
|
+
readonly declaration: object;
|
|
13
15
|
readonly code: string;
|
|
14
16
|
readonly family: DeclaredErrorDefinition['family'];
|
|
15
17
|
readonly message: string;
|
|
@@ -17,7 +19,20 @@ interface DeclaredErrorRecord {
|
|
|
17
19
|
}
|
|
18
20
|
/** Retain one implementation-local expected-error contract without publishing it in the Schema. */
|
|
19
21
|
export declare function rememberDeclaredErrors(definition: object, input: unknown): void;
|
|
22
|
+
/**
|
|
23
|
+
* Retain a Query or Mutation's declared errors, as an implementation's are. A Function that declares one of
|
|
24
|
+
* its codes with the same definition object exposes that error to its own caller.
|
|
25
|
+
*/
|
|
26
|
+
export declare function rememberDefinedErrors(defined: object, id: string, input: unknown): void;
|
|
20
27
|
/** Create a receiver-free factory closed over one admitted Action or Workflow definition. */
|
|
21
28
|
export declare function declaredErrorFactory<Errors extends DeclaredErrors>(definition: object): DeclaredErrorFactory<Errors>;
|
|
22
|
-
/**
|
|
29
|
+
/**
|
|
30
|
+
* Return admitted evidence only when the error belongs to the active implementation: raised by it,
|
|
31
|
+
* or by a Query or Mutation whose code it declares with the same definition object.
|
|
32
|
+
*/
|
|
23
33
|
export declare function declaredErrorOf(input: unknown, definition: object): DeclaredErrorRecord | undefined;
|
|
34
|
+
/** The code and the id of a Query or Mutation's declared error, whichever Function it reaches. */
|
|
35
|
+
export declare function definedErrorOf(input: unknown): {
|
|
36
|
+
readonly code: string;
|
|
37
|
+
readonly id: string;
|
|
38
|
+
} | undefined;
|
|
@@ -5,6 +5,8 @@ const MAXIMUM_DETAILS_BYTES = 16 * 1024;
|
|
|
5
5
|
const CODE_PATTERN = /^[A-Z][A-Z0-9_]{0,127}$/u;
|
|
6
6
|
const declarations = new WeakMap();
|
|
7
7
|
const errors = new WeakMap();
|
|
8
|
+
/** The id of each Query or Mutation: their errors cross into a Function that re-declares them. */
|
|
9
|
+
const definedIds = new WeakMap();
|
|
8
10
|
class BusinessError extends Error {
|
|
9
11
|
name = 'BusinessError';
|
|
10
12
|
constructor(code) {
|
|
@@ -25,17 +27,29 @@ export function rememberDeclaredErrors(definition, input) {
|
|
|
25
27
|
for (const [code, candidate] of entries) {
|
|
26
28
|
if (!CODE_PATTERN.test(code))
|
|
27
29
|
throw new TypeError(`Declared error code ${JSON.stringify(code)} is invalid.`);
|
|
28
|
-
accepted.set(code,
|
|
30
|
+
accepted.set(code, {
|
|
31
|
+
accepted: acceptErrorDefinition(candidate, `Declared error ${JSON.stringify(code)}`),
|
|
32
|
+
declaration: candidate,
|
|
33
|
+
});
|
|
29
34
|
}
|
|
30
35
|
declarations.set(definition, accepted);
|
|
31
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* Retain a Query or Mutation's declared errors, as an implementation's are. A Function that declares one of
|
|
39
|
+
* its codes with the same definition object exposes that error to its own caller.
|
|
40
|
+
*/
|
|
41
|
+
export function rememberDefinedErrors(defined, id, input) {
|
|
42
|
+
rememberDeclaredErrors(defined, { errors: input });
|
|
43
|
+
definedIds.set(defined, id);
|
|
44
|
+
}
|
|
32
45
|
/** Create a receiver-free factory closed over one admitted Action or Workflow definition. */
|
|
33
46
|
export function declaredErrorFactory(definition) {
|
|
34
47
|
return ((code, input) => {
|
|
35
|
-
const
|
|
36
|
-
if (
|
|
48
|
+
const declared = declarations.get(definition)?.get(code);
|
|
49
|
+
if (declared === undefined) {
|
|
37
50
|
throw new TypeError(`Business error ${JSON.stringify(code)} is not declared by this implementation.`);
|
|
38
51
|
}
|
|
52
|
+
const { accepted: declaration } = declared;
|
|
39
53
|
const parsed = declaration.details.safeParse(input);
|
|
40
54
|
if (!parsed.success) {
|
|
41
55
|
throw new TypeError(`Business error ${code} details are invalid.`, { cause: parsed.error });
|
|
@@ -56,6 +70,7 @@ export function declaredErrorFactory(definition) {
|
|
|
56
70
|
const error = new BusinessError(code);
|
|
57
71
|
errors.set(error, Object.freeze({
|
|
58
72
|
definition,
|
|
73
|
+
declaration: declared.declaration,
|
|
59
74
|
code,
|
|
60
75
|
family: declaration.family,
|
|
61
76
|
message: declaration.message,
|
|
@@ -64,12 +79,31 @@ export function declaredErrorFactory(definition) {
|
|
|
64
79
|
return error;
|
|
65
80
|
});
|
|
66
81
|
}
|
|
67
|
-
/**
|
|
82
|
+
/**
|
|
83
|
+
* Return admitted evidence only when the error belongs to the active implementation: raised by it,
|
|
84
|
+
* or by a Query or Mutation whose code it declares with the same definition object.
|
|
85
|
+
*/
|
|
68
86
|
export function declaredErrorOf(input, definition) {
|
|
69
87
|
if (!(input instanceof Error))
|
|
70
88
|
return undefined;
|
|
71
89
|
const record = errors.get(input);
|
|
72
|
-
|
|
90
|
+
if (record === undefined)
|
|
91
|
+
return undefined;
|
|
92
|
+
if (record.definition === definition)
|
|
93
|
+
return record;
|
|
94
|
+
if (!definedIds.has(record.definition))
|
|
95
|
+
return undefined;
|
|
96
|
+
return declarations.get(definition)?.get(record.code)?.declaration === record.declaration
|
|
97
|
+
? record
|
|
98
|
+
: undefined;
|
|
99
|
+
}
|
|
100
|
+
/** The code and the id of a Query or Mutation's declared error, whichever Function it reaches. */
|
|
101
|
+
export function definedErrorOf(input) {
|
|
102
|
+
const record = input instanceof Error ? errors.get(input) : undefined;
|
|
103
|
+
if (record === undefined)
|
|
104
|
+
return undefined;
|
|
105
|
+
const id = definedIds.get(record.definition);
|
|
106
|
+
return id === undefined ? undefined : { code: record.code, id };
|
|
73
107
|
}
|
|
74
108
|
function isRecord(input) {
|
|
75
109
|
return input !== null && typeof input === 'object' && !Array.isArray(input);
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export type { DeclaredErrorDefinition, DeclaredErrorFactory, DeclaredErrorFamily, DeclaredErrorOptions, DeclaredErrors, NoDeclaredErrors, } from './error.js';
|
|
2
|
-
export { declaredErrorFactory, declaredErrorOf, rememberDeclaredErrors } from './error.js';
|
|
2
|
+
export { declaredErrorFactory, declaredErrorOf, definedErrorOf, rememberDeclaredErrors, rememberDefinedErrors, } from './error.js';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export { declaredErrorFactory, declaredErrorOf, rememberDeclaredErrors } from './error.js';
|
|
1
|
+
export { declaredErrorFactory, declaredErrorOf, definedErrorOf, rememberDeclaredErrors, rememberDefinedErrors, } from './error.js';
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
export {
|
|
2
|
-
export type {
|
|
1
|
+
export { defineDomain, isDomainDefinition } from './define.js';
|
|
2
|
+
export type { DomainDefinitionInput } from './define.js';
|
|
3
3
|
export { requirements } from './requirements/index.js';
|
|
4
4
|
export type { AuthorityRequirements, AuthorityRequirementsInput, ClassOperation, ClassRequirement, ClassRequirementInput, CoreRequirement, CoreRequirementInput, FunctionRequirementTarget, Requirements, RequirementsInput, } from './requirements/index.js';
|
|
5
5
|
export { route, routes } from './routes/index.js';
|
|
6
6
|
export type { Route, RouteInput, RouteTarget, Routes } from './routes/index.js';
|
|
7
7
|
export { defineFrontend, external, vite } from './view/index.js';
|
|
8
|
-
export type { Frontend, FrontendInput, FrontendSource,
|
|
9
|
-
export type {
|
|
8
|
+
export type { Frontend, FrontendInput, FrontendSource, ViewHostRequirements } from './view/index.js';
|
|
9
|
+
export type { DomainDefinition, DomainDefinitionIdentity, RuntimeOfDomainDefinition, SchemaOfDomainDefinition, SchemaOfRuntime, } from './domain.js';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { defineDomain, isDomainDefinition } from './define.js';
|
|
2
2
|
export { requirements } from './requirements/index.js';
|
|
3
3
|
export { route, routes } from './routes/index.js';
|
|
4
4
|
export { defineFrontend, external, vite } from './view/index.js';
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { IntegrationDefinition, Integrations } from './integration.js';
|
|
2
|
-
import type { IntegrationOperation, IntegrationOperations, IntegrationReplay } from './operation.js';
|
|
2
|
+
import type { IntegrationOperation, IntegrationOperations, IntegrationReplay, ReplayableIntegrationDecision } from './operation.js';
|
|
3
3
|
import type { Provider, ProviderImplementation } from './provider.js';
|
|
4
4
|
type RuntimeDefinition = IntegrationDefinition<string, IntegrationOperations>;
|
|
5
5
|
type ProviderOperations = Readonly<Record<string, (...input: readonly unknown[]) => unknown>>;
|
|
@@ -12,6 +12,13 @@ export interface DefineIntegration {
|
|
|
12
12
|
readonly id: Id;
|
|
13
13
|
readonly operations: Operations;
|
|
14
14
|
}): IntegrationDefinition<Id, Operations>;
|
|
15
|
+
/**
|
|
16
|
+
* One operation and what another attempt of it may do. A decision that is never `unsafe` keeps
|
|
17
|
+
* the operation available to code that may run more than once, such as a durable Step.
|
|
18
|
+
*/
|
|
19
|
+
operation<Input = void, Output = void>(input: {
|
|
20
|
+
readonly replay: ReplayableIntegrationDecision | ((input: Input) => ReplayableIntegrationDecision);
|
|
21
|
+
}): IntegrationOperation<Input, Output, ReplayableIntegrationDecision['kind']>;
|
|
15
22
|
operation<Input = void, Output = void>(input: {
|
|
16
23
|
readonly replay: IntegrationReplay<Input>;
|
|
17
24
|
}): IntegrationOperation<Input, Output>;
|
|
@@ -2,7 +2,7 @@ export { createIntegrationClients, bindProviders } from './client.js';
|
|
|
2
2
|
export type { IntegrationAttempt, IntegrationCallCoordinates, IntegrationClientFactory, IntegrationInvocationOwner, } from './client.js';
|
|
3
3
|
export { admitIntegrations, defineIntegration, defineProvider, requireIntegration, requireProvider, } from './define.js';
|
|
4
4
|
export type { DefineIntegration, ProviderBinding } from './define.js';
|
|
5
|
-
export type { IntegrationClient, IntegrationClients, IntegrationDefinition, Integrations, } from './integration.js';
|
|
6
|
-
export type { IntegrationExecution, IntegrationInput, IntegrationOperation, IntegrationOperations, IntegrationOutput, IntegrationReplay, IntegrationReplayDecision, } from './operation.js';
|
|
5
|
+
export type { IntegrationClient, IntegrationClients, IntegrationDefinition, Integrations, ReplayableIntegrationClient, ReplayableIntegrationClients, } from './integration.js';
|
|
6
|
+
export type { IntegrationExecution, IntegrationInput, IntegrationOperation, IntegrationOperations, IntegrationOutput, IntegrationReplay, IntegrationReplayDecision, IntegrationReplayKind, IntegrationReplayOf, ReplayableIntegrationDecision, } from './operation.js';
|
|
7
7
|
export type { Provider, ProviderImplementation, Providers } from './provider.js';
|
|
8
8
|
export type { IntegrationAuthentication, IntegrationMintInput } from './authentication.js';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { IntegrationOperation, IntegrationOperations } from './operation.js';
|
|
1
|
+
import type { IntegrationOperation, IntegrationOperations, IntegrationReplayOf } from './operation.js';
|
|
2
2
|
declare const INTEGRATION_DEFINITION: unique symbol;
|
|
3
3
|
export interface IntegrationDefinition<Id extends string = string, Operations extends IntegrationOperations = IntegrationOperations> {
|
|
4
4
|
readonly kind: 'integration';
|
|
@@ -16,4 +16,16 @@ export type IntegrationClient<Definition extends IntegrationDefinition> = Readon
|
|
|
16
16
|
export type IntegrationClients<Definitions extends Integrations> = Readonly<{
|
|
17
17
|
[Name in keyof Definitions]: IntegrationClient<Definitions[Name]>;
|
|
18
18
|
}>;
|
|
19
|
+
type ReplayableOperationName<Definition extends IntegrationDefinition> = {
|
|
20
|
+
[Name in keyof Definition['operations']]: 'unsafe' extends IntegrationReplayOf<Definition['operations'][Name]> ? never : Name;
|
|
21
|
+
}[keyof Definition['operations']];
|
|
22
|
+
/** The operations of one Integration that may be attempted again: each is `safe` or keyed. */
|
|
23
|
+
export type ReplayableIntegrationClient<Definition extends IntegrationDefinition> = Pick<IntegrationClient<Definition>, ReplayableOperationName<Definition>>;
|
|
24
|
+
/**
|
|
25
|
+
* Integration clients of code that may run more than once, such as a durable Step. An operation
|
|
26
|
+
* whose replay decision may be `unsafe` is absent: another attempt could repeat its effect.
|
|
27
|
+
*/
|
|
28
|
+
export type ReplayableIntegrationClients<Definitions extends Integrations> = Readonly<{
|
|
29
|
+
[Name in keyof Definitions]: ReplayableIntegrationClient<Definitions[Name]>;
|
|
30
|
+
}>;
|
|
19
31
|
export {};
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { BoundClientSession } from '../../platform/client/session/index.js';
|
|
2
2
|
import type { IntegrationAuthentication } from './authentication.js';
|
|
3
3
|
declare const INTEGRATION_OPERATION: unique symbol;
|
|
4
|
+
declare const INTEGRATION_REPLAY: unique symbol;
|
|
4
5
|
export type IntegrationReplayDecision = {
|
|
5
6
|
readonly kind: 'safe';
|
|
6
7
|
} | {
|
|
@@ -13,20 +14,28 @@ export type IntegrationReplayDecision = {
|
|
|
13
14
|
} | {
|
|
14
15
|
readonly kind: 'unsafe';
|
|
15
16
|
};
|
|
17
|
+
/** What another attempt of an operation may do: anything, once per key, or nothing. */
|
|
18
|
+
export type IntegrationReplayKind = IntegrationReplayDecision['kind'];
|
|
19
|
+
/** A decision that allows another attempt of the operation. */
|
|
20
|
+
export type ReplayableIntegrationDecision = Exclude<IntegrationReplayDecision, {
|
|
21
|
+
readonly kind: 'unsafe';
|
|
22
|
+
}>;
|
|
16
23
|
export type IntegrationReplay<Input> = IntegrationReplayDecision | ((input: Input) => IntegrationReplayDecision);
|
|
17
24
|
export interface IntegrationExecution {
|
|
18
25
|
readonly callId: string;
|
|
19
26
|
readonly signal: AbortSignal;
|
|
20
27
|
readonly deadline: number;
|
|
21
28
|
readonly idempotencyKey?: string;
|
|
22
|
-
/** Exact caller-bound invocation capability; absent
|
|
29
|
+
/** Exact caller-bound invocation capability; absent when the call carried no credential. */
|
|
23
30
|
readonly invoke?: BoundClientSession['invoke'];
|
|
24
|
-
/** Domain-self transport authentication; absent
|
|
31
|
+
/** Domain-self transport authentication; absent only outside a Kernel invocation. */
|
|
25
32
|
readonly auth?: IntegrationAuthentication;
|
|
26
33
|
}
|
|
27
|
-
export interface IntegrationOperation<Input = unknown, Output = unknown> {
|
|
34
|
+
export interface IntegrationOperation<Input = unknown, Output = unknown, Replay extends IntegrationReplayKind = IntegrationReplayKind> {
|
|
28
35
|
readonly replay: IntegrationReplay<Input>;
|
|
29
36
|
readonly [INTEGRATION_OPERATION]: (input: Input) => Output;
|
|
37
|
+
/** Every kind its replay decision may take, as its definition proves them. */
|
|
38
|
+
readonly [INTEGRATION_REPLAY]: Replay;
|
|
30
39
|
}
|
|
31
40
|
export type IntegrationOperations = Readonly<Record<string, IntegrationOperation<never, unknown>>>;
|
|
32
41
|
export type IntegrationInput<Operation> = Operation extends {
|
|
@@ -35,4 +44,8 @@ export type IntegrationInput<Operation> = Operation extends {
|
|
|
35
44
|
export type IntegrationOutput<Operation> = Operation extends {
|
|
36
45
|
readonly [INTEGRATION_OPERATION]: (input: never) => infer Output;
|
|
37
46
|
} ? Output : never;
|
|
47
|
+
/** The replay kinds an operation's definition proves; every kind when it proves none. */
|
|
48
|
+
export type IntegrationReplayOf<Operation> = Operation extends {
|
|
49
|
+
readonly [INTEGRATION_REPLAY]: infer Replay;
|
|
50
|
+
} ? Replay : IntegrationReplayKind;
|
|
38
51
|
export {};
|
|
@@ -1,55 +1,103 @@
|
|
|
1
1
|
import type { EdgeSlug } from '@astrale-os/kernel-core/graph/edge';
|
|
2
2
|
import type { MutationBuilder } from '@astrale-os/kernel-core/graph/mutate';
|
|
3
|
-
import type { QueryEdgeAST, QueryNodeAST } from '@astrale-os/kernel-core/graph/query';
|
|
4
3
|
import type { ResolvedClass } from '@astrale-os/kernel-dsl/v1';
|
|
4
|
+
import type { Cls } from '../../query/handles/domain.js';
|
|
5
|
+
import type { EdgeSet, NodeSet } from '../../query/handles/handles.js';
|
|
6
|
+
import type { ClosureMutationBuilder } from '../legacy/v6/builder.js';
|
|
5
7
|
import type { CreatedNode, ExistingEndpoint, MutationEndpoint } from './endpoint.js';
|
|
6
|
-
import type {
|
|
8
|
+
import type { CountBounds, GuardIdentity, GuardRange, PreconditionOptions } from './guard.js';
|
|
7
9
|
import type { RichPropertyConditions, RichPropertyDelta, RichPropertyInput } from './properties.js';
|
|
10
|
+
import { type PreconditionNames } from './names.js';
|
|
8
11
|
import { type EventOfTopology, type StatePropertyName, type StatePropertyTopology, type StateOfTopology, type StateTransitionInput } from './transition.js';
|
|
9
|
-
|
|
12
|
+
/**
|
|
13
|
+
* The builder a Mutation's `build` receives: of a defined Mutation over `Schema`
|
|
14
|
+
* (`RichMutationBuilder<Schema>`), or of the deprecated closure form (`RichMutationBuilder`).
|
|
15
|
+
*/
|
|
16
|
+
export type RichMutationBuilder<Schema = never> = [Schema] extends [never] ? ClosureMutationBuilder : DefinedMutationBuilder<Schema>;
|
|
17
|
+
/** A write names one Class: the handle of a union, `d.A.union(d.B)`, names none. */
|
|
18
|
+
type OneClass<K, All = K> = K extends unknown ? [All] extends [K] ? unknown : '✗ a write names one Class, not a union' : never;
|
|
19
|
+
/** A Node Class handle, `d.<Class>`, on which no method was called. */
|
|
20
|
+
type NodeClassHandle<S, K extends string> = NodeSet<S, K, {}, 'value', false> & OneClass<K>;
|
|
21
|
+
/** An Edge Class handle, `d.<Edge>`, on which no method was called. */
|
|
22
|
+
type EdgeClassHandle<S, E extends string> = EdgeSet<S, E, 'value', false>;
|
|
23
|
+
type NodeClassOf<S, K extends string> = Extract<Cls<S, K>, ResolvedClass<'node'>>;
|
|
24
|
+
interface HandleEdgeSelector<S, E extends string> {
|
|
25
|
+
readonly source: ExistingEndpoint;
|
|
26
|
+
readonly target: ExistingEndpoint;
|
|
27
|
+
readonly class: EdgeClassHandle<S, E>;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* The builder a defined Mutation's `build` receives (D31): each verb names its Class by its handle,
|
|
31
|
+
* `d.<Class>`, and each guard takes a range. Each precondition verb (`expect.*`) takes `{ name }`
|
|
32
|
+
* last: a refusal of the Mutation because that precondition fails carries the name as
|
|
33
|
+
* `failure.precondition`. A name is unique in its Mutation.
|
|
34
|
+
*/
|
|
35
|
+
export interface DefinedMutationBuilder<S> {
|
|
10
36
|
readonly expect: {
|
|
11
|
-
|
|
37
|
+
/** The Node exists, of this Class, and its Properties meet `props`. */
|
|
38
|
+
node<K extends string>(input: {
|
|
12
39
|
readonly node: ExistingEndpoint;
|
|
13
|
-
readonly class:
|
|
14
|
-
readonly props?: RichPropertyConditions<
|
|
15
|
-
}):
|
|
16
|
-
|
|
40
|
+
readonly class: NodeClassHandle<S, K>;
|
|
41
|
+
readonly props?: RichPropertyConditions<Cls<S, K>>;
|
|
42
|
+
}, options?: PreconditionOptions): DefinedMutationBuilder<S>;
|
|
43
|
+
/** The Edge exists, its slug is `slug`, and its Properties meet `props`. */
|
|
44
|
+
edge<E extends string>(input: HandleEdgeSelector<S, E> & {
|
|
17
45
|
readonly slug?: EdgeSlug | null;
|
|
18
|
-
readonly props?: RichPropertyConditions<
|
|
19
|
-
}):
|
|
20
|
-
|
|
46
|
+
readonly props?: RichPropertyConditions<Cls<S, E>>;
|
|
47
|
+
}, options?: PreconditionOptions): DefinedMutationBuilder<S>;
|
|
48
|
+
/**
|
|
49
|
+
* A guard (Mutation v4): no root of the range matches. A range is a Class handle after
|
|
50
|
+
* `where`, `union` and `orderBy`, `d.<Class>.where(…)`, or a canonical v7 Query.
|
|
51
|
+
*/
|
|
52
|
+
none<K extends string>(range: GuardRange<S, K>, options?: PreconditionOptions): DefinedMutationBuilder<S>;
|
|
53
|
+
/** A guard (Mutation v4): a root of the range matches. */
|
|
54
|
+
exists<K extends string>(range: GuardRange<S, K>, options?: PreconditionOptions): DefinedMutationBuilder<S>;
|
|
55
|
+
/**
|
|
56
|
+
* A guard (Mutation v4): the number of the range's roots is `bounds`, or lies within
|
|
57
|
+
* `{ atLeast?, atMost? }`, bounded at least once.
|
|
58
|
+
*/
|
|
59
|
+
count<K extends string>(range: GuardRange<S, K>, bounds: CountBounds, options?: PreconditionOptions): DefinedMutationBuilder<S>;
|
|
60
|
+
/**
|
|
61
|
+
* A guard (Mutation v4): the range's roots, in its `orderBy`, are exactly these identities, in
|
|
62
|
+
* the order a read of them returned them: a `NodeId` per Node, an `EdgeKey` per Edge.
|
|
63
|
+
*/
|
|
64
|
+
unchanged<K extends string>(range: GuardRange<S, K>, ids: readonly GuardIdentity[], options?: PreconditionOptions): DefinedMutationBuilder<S>;
|
|
21
65
|
};
|
|
22
|
-
createNode<
|
|
66
|
+
createNode<K extends string>(input: {
|
|
23
67
|
readonly as: string;
|
|
24
|
-
readonly class:
|
|
25
|
-
readonly props?: RichPropertyInput<
|
|
26
|
-
}): CreatedNode<
|
|
27
|
-
updateNode<
|
|
68
|
+
readonly class: NodeClassHandle<S, K>;
|
|
69
|
+
readonly props?: RichPropertyInput<Cls<S, K>>;
|
|
70
|
+
}): CreatedNode<NodeClassOf<S, K>>;
|
|
71
|
+
updateNode<K extends string>(input: {
|
|
28
72
|
readonly node: ExistingEndpoint;
|
|
29
|
-
readonly class:
|
|
30
|
-
readonly props: RichPropertyDelta<
|
|
73
|
+
readonly class: NodeClassHandle<S, K>;
|
|
74
|
+
readonly props: RichPropertyDelta<Cls<S, K>>;
|
|
31
75
|
}): this;
|
|
32
|
-
transition<
|
|
33
|
-
deleteNode<
|
|
76
|
+
transition<K extends string, Property extends StatePropertyName<NodeClassOf<S, K>>, From extends StateOfTopology<StatePropertyTopology<NodeClassOf<S, K>, Property>>, Event extends EventOfTopology<StatePropertyTopology<NodeClassOf<S, K>, Property>, From>>(input: StateTransitionInput<NodeClassOf<S, K>, Property, From, Event, NodeClassHandle<S, K>>): this;
|
|
77
|
+
deleteNode<K extends string>(input: {
|
|
34
78
|
readonly node: ExistingEndpoint;
|
|
35
|
-
readonly class:
|
|
79
|
+
readonly class: NodeClassHandle<S, K>;
|
|
36
80
|
}): this;
|
|
37
|
-
createEdge<
|
|
38
|
-
readonly class:
|
|
81
|
+
createEdge<E extends string>(input: {
|
|
82
|
+
readonly class: EdgeClassHandle<S, E>;
|
|
39
83
|
readonly source: MutationEndpoint;
|
|
40
84
|
readonly target: MutationEndpoint;
|
|
41
85
|
readonly slug?: EdgeSlug;
|
|
42
|
-
readonly props?: RichPropertyInput<
|
|
86
|
+
readonly props?: RichPropertyInput<Cls<S, E>>;
|
|
43
87
|
}): this;
|
|
44
|
-
updateEdge<
|
|
88
|
+
updateEdge<E extends string>(input: HandleEdgeSelector<S, E> & {
|
|
45
89
|
readonly slug?: EdgeSlug | null;
|
|
46
|
-
readonly props?: RichPropertyDelta<
|
|
90
|
+
readonly props?: RichPropertyDelta<Cls<S, E>>;
|
|
47
91
|
}): this;
|
|
48
|
-
deleteEdge<
|
|
49
|
-
}
|
|
50
|
-
export interface EdgeSelector<Class extends ResolvedClass<'edge'>> {
|
|
51
|
-
readonly source: ExistingEndpoint;
|
|
52
|
-
readonly target: ExistingEndpoint;
|
|
53
|
-
readonly class: Class;
|
|
92
|
+
deleteEdge<E extends string>(input: HandleEdgeSelector<S, E>): this;
|
|
54
93
|
}
|
|
55
|
-
|
|
94
|
+
/** The form of the Mutation a builder writes: a defined Mutation's, or the deprecated closure form's. */
|
|
95
|
+
export type BuilderForm = 'defined' | 'closure';
|
|
96
|
+
/**
|
|
97
|
+
* The SDK's builder over the core one, for both forms: a verb's Class is a Class handle
|
|
98
|
+
* (`d.<Class>`) or, in the closure form only, the resolved Class, and only the closure form has a
|
|
99
|
+
* V6 Query precondition (`expect.query`). `names` keeps the names of its preconditions, so that
|
|
100
|
+
* the Mutation's execution can name the one a refusal points at.
|
|
101
|
+
*/
|
|
102
|
+
export declare function richMutationBuilder(portable: MutationBuilder, names?: PreconditionNames, form?: BuilderForm): ClosureMutationBuilder;
|
|
103
|
+
export {};
|