@astrale-os/sdk 0.6.0-beta.5 → 0.6.0-beta.51
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 +89 -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 +218 -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 +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/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 +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 +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 +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 +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 +22 -0
- package/dist/testing/query.js +35 -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 +492 -0
- package/docs/release.md +155 -0
- package/docs/schema-cost.md +124 -0
- package/package.json +53 -21
- 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
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { rememberDefinedErrors } from '../../error/error.js';
|
|
2
|
+
import { describe } from '../handles/terms.js';
|
|
3
|
+
import { defineQuery as defineV6Query } from '../legacy/v6/define.js';
|
|
4
|
+
/** A Query or Mutation id: lowercase segments of letters, digits and hyphens, joined by dots. */
|
|
5
|
+
export const DEFINITION_ID = /^[a-z0-9-]+(?:\.[a-z0-9-]+)*$/u;
|
|
6
|
+
export const MAXIMUM_DEFINITION_ID = 128;
|
|
7
|
+
const FIELDS = new Set(['build', 'output', 'errors']);
|
|
8
|
+
const specs = new WeakMap();
|
|
9
|
+
/** The collections open while a build loads a Domain; no definition is kept outside one. */
|
|
10
|
+
const collections = new Set();
|
|
11
|
+
/** The build and the output of a Query v7; `undefined` for anything else. */
|
|
12
|
+
export function querySpecOf(query) {
|
|
13
|
+
return typeof query === 'object' && query !== null ? specs.get(query) : undefined;
|
|
14
|
+
}
|
|
15
|
+
function defineV7Query(id, spec) {
|
|
16
|
+
if (typeof id !== 'string' || id.length > MAXIMUM_DEFINITION_ID || !DEFINITION_ID.test(id))
|
|
17
|
+
throw new TypeError(`A Query id is lowercase segments of letters, digits and hyphens joined by dots, at most ${MAXIMUM_DEFINITION_ID} characters ('services.service.owner'); got ${describe(id)}.`);
|
|
18
|
+
if (typeof spec !== 'object' || spec === null || Array.isArray(spec))
|
|
19
|
+
throw new TypeError(`Query ${id} takes { build, output?, errors? }; got ${describe(spec)}.`);
|
|
20
|
+
const fields = spec;
|
|
21
|
+
const unknown = Reflect.ownKeys(fields).filter((key) => typeof key !== 'string' || !FIELDS.has(key));
|
|
22
|
+
if (unknown.length > 0)
|
|
23
|
+
throw new TypeError(`Query ${id} takes build, output and errors only; got ${unknown.map(String).join(', ')}: do that work in build or output.`);
|
|
24
|
+
const { build, output } = fields;
|
|
25
|
+
if (typeof build !== 'function')
|
|
26
|
+
throw new TypeError(`Query ${id}'s build is a function of (input, d, steps) that returns a read, a record of facets, or steps(first, (earlier) => next, …); got ${describe(build)}.`);
|
|
27
|
+
if (output !== undefined && typeof output !== 'function')
|
|
28
|
+
throw new TypeError(`Query ${id}'s output is a function of (results, input, context); got ${describe(output)}.`);
|
|
29
|
+
const errors = fields.errors ?? {};
|
|
30
|
+
if (typeof errors !== 'object' || errors === null || Array.isArray(errors))
|
|
31
|
+
throw new TypeError(`Query ${id}'s errors is a record of declared errors by UPPER_SNAKE code; got ${describe(errors)}.`);
|
|
32
|
+
const query = Object.freeze({ id, errors: Object.freeze({ ...errors }) });
|
|
33
|
+
collectDefinition(query);
|
|
34
|
+
specs.set(query, Object.freeze({
|
|
35
|
+
build: build,
|
|
36
|
+
...(output !== undefined ? { output: output } : {}),
|
|
37
|
+
}));
|
|
38
|
+
return query;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Keep the errors a definition declares, a Query's or a Mutation's, and collect it into the
|
|
42
|
+
* collections open: a defined Mutation shares its Domain's Query ids and error definitions.
|
|
43
|
+
*/
|
|
44
|
+
export function collectDefinition(query) {
|
|
45
|
+
rememberDefinedErrors(query, query.id, query.errors);
|
|
46
|
+
for (const collection of collections)
|
|
47
|
+
collection.push(query);
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Collect into `queries` each Query or Mutation defined while `load` runs: a build collects the
|
|
51
|
+
* definitions that loading its Domain defines, and checks them with `admitDefinitions`. A module an
|
|
52
|
+
* earlier load of the same process evaluated defines nothing again, so its definitions were checked
|
|
53
|
+
* with that load.
|
|
54
|
+
*/
|
|
55
|
+
export async function collectDefinitions(queries, load) {
|
|
56
|
+
collections.add(queries);
|
|
57
|
+
try {
|
|
58
|
+
return await load();
|
|
59
|
+
}
|
|
60
|
+
finally {
|
|
61
|
+
collections.delete(queries);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Refuse two definitions of one Domain under one id: a refusal and a call name a Query or Mutation
|
|
66
|
+
* by its id. Refuse two that declare one code with different definitions: a Function that spreads
|
|
67
|
+
* both errors keeps one of them, and would redact the other definition's error.
|
|
68
|
+
*/
|
|
69
|
+
export function admitDefinitions(queries) {
|
|
70
|
+
const ids = new Set();
|
|
71
|
+
for (const { id } of queries) {
|
|
72
|
+
if (ids.has(id))
|
|
73
|
+
throw new TypeError(`Two Queries or Mutations of the Domain are named ${id}: an id is unique in its Domain.`);
|
|
74
|
+
ids.add(id);
|
|
75
|
+
}
|
|
76
|
+
const first = new Map();
|
|
77
|
+
for (const query of queries) {
|
|
78
|
+
for (const [code, declaration] of Object.entries(query.errors)) {
|
|
79
|
+
const seen = first.get(code);
|
|
80
|
+
if (seen === undefined)
|
|
81
|
+
first.set(code, { query: query.id, declaration });
|
|
82
|
+
else if (seen.declaration !== declaration)
|
|
83
|
+
throw new TypeError(`${seen.query} and ${query.id} declare ${code} with different definitions: declare it once and share that object, so a Function that re-declares both keeps each.`);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Define a Query: `defineQuery<Schema>()('services.service.owner', { build, output?, errors? })`.
|
|
89
|
+
* The V6 form, `defineQuery<Schema>()((domain) => ({ id, build, project? }))`, stays.
|
|
90
|
+
*/
|
|
91
|
+
export function defineQuery() {
|
|
92
|
+
const v6 = defineV6Query();
|
|
93
|
+
return ((first, spec) => typeof first === 'string'
|
|
94
|
+
? defineV7Query(first, spec)
|
|
95
|
+
: v6(first));
|
|
96
|
+
}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A Query (spec § Queries: the contract): an id, a `build` over the Domain's handles, an optional
|
|
3
|
+
* `output` and the errors it declares. `build` returns one read, a record of facets read together,
|
|
4
|
+
* or, when reads wait for others, `steps(first, (earlier) => next, …)`: two to eight records of
|
|
5
|
+
* facets, each function receiving the merged results of the steps before it.
|
|
6
|
+
*/
|
|
7
|
+
import type { z } from 'zod';
|
|
8
|
+
import type { DeclaredErrorDefinition } from '../../../platform/schema/error.js';
|
|
9
|
+
import type { ClassOf, Index, KeyOf, Values } from '../handles/domain.js';
|
|
10
|
+
import type { Handles, PageRead, Read } from '../handles/handles.js';
|
|
11
|
+
import type { Page } from '../handles/rows.js';
|
|
12
|
+
/** One facet: a read, a list of reads (`items.map(…)`), or nothing (a read that is optional). */
|
|
13
|
+
export type Facet = Read<unknown> | readonly Read<unknown>[] | undefined;
|
|
14
|
+
/** Facets read together, by name. */
|
|
15
|
+
export type Facets = {
|
|
16
|
+
readonly [facet: string]: Facet;
|
|
17
|
+
};
|
|
18
|
+
/** What `build` returns without steps, and the first step: one read, or a record of facets. */
|
|
19
|
+
export type Built = Read<unknown> | Facets;
|
|
20
|
+
/** A read gives its answer; a list of reads a list of answers; nothing gives `undefined`. */
|
|
21
|
+
export type FacetResult<F> = F extends Read<infer T> ? T : F extends readonly Read<infer T>[] ? readonly T[] : F extends undefined ? undefined : never;
|
|
22
|
+
/** The results of one step; a page read, a Query's single read, gives its `Page`. */
|
|
23
|
+
export type Results<B> = B extends Read<infer T> ? T : B extends PageRead<infer T> ? Page<T> : {
|
|
24
|
+
readonly [K in keyof B]: FacetResult<B[K]>;
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* What a page Query's `output` keeps: the page shape. It bounds the output type, not `output`'s
|
|
28
|
+
* return type: inferred from an intersection, a branded value (`NodeId`, `NodePath`) loses its
|
|
29
|
+
* name, and a Domain's exported declaration would spell its brand out, which no package exports.
|
|
30
|
+
*/
|
|
31
|
+
type PageShape<B> = B extends PageRead<unknown> ? Page<unknown> : unknown;
|
|
32
|
+
/** One object type: a Domain's exported declarations spell it out, naming no SDK internal. */
|
|
33
|
+
type Flat<T> = T extends unknown ? {
|
|
34
|
+
readonly [K in keyof T]: T[K];
|
|
35
|
+
} : never;
|
|
36
|
+
/**
|
|
37
|
+
* A later step's facets: none takes a name an earlier step read, whose result the merge would
|
|
38
|
+
* replace. An index signature (its `string` and `number` keys) names no facet in particular, so it
|
|
39
|
+
* refuses none.
|
|
40
|
+
*/
|
|
41
|
+
type Later<Earlier> = Facets & {
|
|
42
|
+
readonly [K in keyof Earlier as string extends K ? never : number extends K ? never : K]?: '✗ an earlier step read this facet: name it otherwise';
|
|
43
|
+
};
|
|
44
|
+
/** The results of the steps so far, merged. */
|
|
45
|
+
export type Merged<B1, B2, B3 = {}, B4 = {}, B5 = {}, B6 = {}, B7 = {}, B8 = {}> = Flat<Results<B1> & Results<B2> & Results<B3> & Results<B4> & Results<B5> & Results<B6> & Results<B7> & Results<B8>>;
|
|
46
|
+
/** The errors a Query or Mutation declares, by UPPER_SNAKE code: at most 32. */
|
|
47
|
+
export type Errors = {
|
|
48
|
+
readonly [code: string]: DeclaredErrorDefinition;
|
|
49
|
+
};
|
|
50
|
+
/** The key of any Class of the Domain, its dependencies' or the Kernel's. */
|
|
51
|
+
export type ClassKeyOf<S> = KeyOf<Values<Index<S>>>;
|
|
52
|
+
/** A declared error of a Query, for `output` to throw. */
|
|
53
|
+
export interface DeclaredError<out C extends string> extends Error {
|
|
54
|
+
readonly '~code'?: C;
|
|
55
|
+
}
|
|
56
|
+
/** A row narrowed to a Class or any of its subclasses: the union members it may be, and `$class`. */
|
|
57
|
+
export type Narrowed<S, R extends {
|
|
58
|
+
readonly $class: string;
|
|
59
|
+
}, K> = R extends unknown ? [Extract<R['$class'], ClassOf<S, K>>] extends [never] ? never : R & {
|
|
60
|
+
readonly $class: Extract<R['$class'], ClassOf<S, K>>;
|
|
61
|
+
} : never;
|
|
62
|
+
/** What `output` receives besides the results and the input. */
|
|
63
|
+
export interface OutputContext<S, E extends Errors> {
|
|
64
|
+
/** A declared error, for `output` to throw: `throw error('SERVICE_NOT_FOUND', { service })`. */
|
|
65
|
+
error<C extends keyof E & string>(code: C, details: z.input<E[C]['details']>): DeclaredError<C>;
|
|
66
|
+
/** Narrows a row to a Class or any of its subclasses, by Class key. */
|
|
67
|
+
is<R extends {
|
|
68
|
+
readonly $class: string;
|
|
69
|
+
}, K extends ClassKeyOf<S>>(row: R, cls: K): row is Narrowed<S, R, K>;
|
|
70
|
+
}
|
|
71
|
+
/** A Query v7: its id, and the errors it declares, to spread into a Function's errors. */
|
|
72
|
+
export interface DefinedQuery<Id extends string = string, Input = unknown, Output = unknown, E extends Errors = Errors> {
|
|
73
|
+
readonly id: Id;
|
|
74
|
+
readonly errors: E;
|
|
75
|
+
/** A defined Mutation, `kind: 'mutation'`, writes: no read takes one. */
|
|
76
|
+
readonly kind?: never;
|
|
77
|
+
readonly '~input'?: Input;
|
|
78
|
+
readonly '~output'?: Output;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* A Query whose single read is a page: the call sets its size and continues it. A `DefinedQuery`
|
|
82
|
+
* with its row type, not an interface of its own: a Domain's exported declaration names only
|
|
83
|
+
* `DefinedQuery`.
|
|
84
|
+
*/
|
|
85
|
+
export type PageQuery<Id extends string = string, Input = unknown, Output = unknown, E extends Errors = Errors, Row = unknown> = DefinedQuery<Id, Input, Output, E> & {
|
|
86
|
+
readonly '~page'?: Row;
|
|
87
|
+
};
|
|
88
|
+
/** The input a Query is called with; a Query with no input is called with `undefined`. */
|
|
89
|
+
export type InputOf<R> = R extends DefinedQuery<string, infer I, unknown, Errors> ? I : never;
|
|
90
|
+
/** The output a Query answers. */
|
|
91
|
+
export type OutputOf<R> = R extends DefinedQuery<string, unknown, infer O, Errors> ? O : never;
|
|
92
|
+
type Output<S, Results, I, O, E extends Errors> = (results: Results, input: I, context: OutputContext<S, E>) => O;
|
|
93
|
+
/**
|
|
94
|
+
* Whether a type is portable JSON as far as its type can tell: a function, or an object that
|
|
95
|
+
* carries one (a Promise, a Date, a Map, a class with methods), is not. A value typed `unknown`
|
|
96
|
+
* may be JSON, so it passes, as does anything past eight levels.
|
|
97
|
+
*/
|
|
98
|
+
type Portable<T, Depth extends readonly unknown[] = []> = unknown extends T ? true : Depth['length'] extends 8 ? true : T extends string | number | boolean | null | undefined ? true : T extends bigint | symbol | ((...args: never) => unknown) ? false : T extends readonly (infer Item)[] ? Portable<Item, [...Depth, unknown]> : {
|
|
99
|
+
[K in keyof T]-?: Portable<T[K], [...Depth, unknown]>;
|
|
100
|
+
}[keyof T] extends true ? true : false;
|
|
101
|
+
/** `output` returns portable JSON, checked by type (spec § API reference: Queries). */
|
|
102
|
+
type PortableOutput<O> = [Portable<O>] extends [true] ? unknown : '✗ output returns portable JSON: no function, Promise, Date, Map or other object with methods';
|
|
103
|
+
/** What `steps(…)` returns: the merged results of its steps, for `output`. */
|
|
104
|
+
export interface Stepped<out R> {
|
|
105
|
+
readonly '~stepped': R;
|
|
106
|
+
}
|
|
107
|
+
/** The results of what `build` returns: a read's, a page's, a record of facets', or the steps'. */
|
|
108
|
+
export type BuiltResults<B> = B extends Stepped<infer R> ? R : Results<B>;
|
|
109
|
+
/**
|
|
110
|
+
* `build`'s third parameter: reads that wait for others. The first step is a record of facets;
|
|
111
|
+
* each next one a function of the merged results of the steps before it, returning a record of
|
|
112
|
+
* facets none of them read. Two to eight steps, one overload per count, so a call's error is its
|
|
113
|
+
* own count's.
|
|
114
|
+
*/
|
|
115
|
+
export interface Steps {
|
|
116
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>>(first: B1, second: (earlier: Results<B1>) => B2): Stepped<Merged<B1, B2>>;
|
|
117
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3): Stepped<Merged<B1, B2, B3>>;
|
|
118
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4): Stepped<Merged<B1, B2, B3, B4>>;
|
|
119
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5): Stepped<Merged<B1, B2, B3, B4, B5>>;
|
|
120
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>, B6 extends Later<Merged<B1, B2, B3, B4, B5>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5, sixth: (earlier: Merged<B1, B2, B3, B4, B5>) => B6): Stepped<Merged<B1, B2, B3, B4, B5, B6>>;
|
|
121
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>, B6 extends Later<Merged<B1, B2, B3, B4, B5>>, B7 extends Later<Merged<B1, B2, B3, B4, B5, B6>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5, sixth: (earlier: Merged<B1, B2, B3, B4, B5>) => B6, seventh: (earlier: Merged<B1, B2, B3, B4, B5, B6>) => B7): Stepped<Merged<B1, B2, B3, B4, B5, B6, B7>>;
|
|
122
|
+
<B1 extends Facets, B2 extends Later<Results<B1>>, B3 extends Later<Merged<B1, B2>>, B4 extends Later<Merged<B1, B2, B3>>, B5 extends Later<Merged<B1, B2, B3, B4>>, B6 extends Later<Merged<B1, B2, B3, B4, B5>>, B7 extends Later<Merged<B1, B2, B3, B4, B5, B6>>, B8 extends Later<Merged<B1, B2, B3, B4, B5, B6, B7>>>(first: B1, second: (earlier: Results<B1>) => B2, third: (earlier: Merged<B1, B2>) => B3, fourth: (earlier: Merged<B1, B2, B3>) => B4, fifth: (earlier: Merged<B1, B2, B3, B4>) => B5, sixth: (earlier: Merged<B1, B2, B3, B4, B5>) => B6, seventh: (earlier: Merged<B1, B2, B3, B4, B5, B6>) => B7, eighth: (earlier: Merged<B1, B2, B3, B4, B5, B6, B7>) => B8): Stepped<Merged<B1, B2, B3, B4, B5, B6, B7, B8>>;
|
|
123
|
+
}
|
|
124
|
+
/** `defineQuery<Schema>()`'s v7 form: a string id first. */
|
|
125
|
+
export interface DefinedQueryFactory<S> {
|
|
126
|
+
/**
|
|
127
|
+
* `build` returns one read, a record of facets, `steps(…)`, or a page as its single read, whose
|
|
128
|
+
* `output` keeps the page shape (the cursor stays the Kernel's). Its type is spelled out, not
|
|
129
|
+
* `PageQuery`: a Domain's exported declarations then name only `DefinedQuery`.
|
|
130
|
+
*/
|
|
131
|
+
<const Id extends string, I, B extends Built | PageRead<unknown> | Stepped<unknown>, O extends PageShape<B> = BuiltResults<B> extends PageShape<B> ? BuiltResults<B> : never, E extends Errors = {}>(id: Id, spec: {
|
|
132
|
+
readonly build: (input: I, d: Handles<S>, steps: Steps) => B;
|
|
133
|
+
readonly output?: Output<S, BuiltResults<B>, I, O, E> & PortableOutput<O>;
|
|
134
|
+
readonly errors?: E;
|
|
135
|
+
}): B extends PageRead<infer T> ? DefinedQuery<Id, I, O, E> & {
|
|
136
|
+
readonly '~page'?: T;
|
|
137
|
+
} : DefinedQuery<Id, I, O, E>;
|
|
138
|
+
}
|
|
139
|
+
export {};
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Domain, schema } from '../../platform/schema/index.js';
|
|
2
|
+
import type { QueryDefinition } from './query.js';
|
|
3
|
+
/** The private projection of one Query definition from its exact loaded Domain. */
|
|
4
|
+
export type QueryProjector = (domain: Domain) => Readonly<Record<string, unknown>>;
|
|
5
|
+
export type ResolvedDomainOf<Schema extends schema.DomainSchema> = Extract<schema.DomainOf<Schema>, Domain>;
|
|
6
|
+
/** One inert Query definition of `kind`; its projector is retained privately. */
|
|
7
|
+
export declare function inertQuery(kind: QueryDefinition['kind'], project: QueryProjector): QueryDefinition;
|
|
8
|
+
/** The projector a Query definition was registered with, if it was. */
|
|
9
|
+
export declare function projectorOf(definition: object): QueryProjector | undefined;
|
|
10
|
+
/** The fields every authored Query definition shares: `id`, its operation, `prepare`, `project`, `reject`. */
|
|
11
|
+
export declare function definitionBase(definition: Readonly<Record<string, unknown>>, operation: 'build' | 'compose'): void;
|
|
12
|
+
export declare function isPromiseLike(input: unknown): input is PromiseLike<unknown>;
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
const projectors = new WeakMap();
|
|
2
|
+
/** One inert Query definition of `kind`; its projector is retained privately. */
|
|
3
|
+
export function inertQuery(kind, project) {
|
|
4
|
+
if (typeof project !== 'function')
|
|
5
|
+
throw new TypeError('Query projection must be a function.');
|
|
6
|
+
const definition = Object.freeze({ kind });
|
|
7
|
+
projectors.set(definition, project);
|
|
8
|
+
return definition;
|
|
9
|
+
}
|
|
10
|
+
/** The projector a Query definition was registered with, if it was. */
|
|
11
|
+
export function projectorOf(definition) {
|
|
12
|
+
return projectors.get(definition);
|
|
13
|
+
}
|
|
14
|
+
/** The fields every authored Query definition shares: `id`, its operation, `prepare`, `project`, `reject`. */
|
|
15
|
+
export function definitionBase(definition, operation) {
|
|
16
|
+
if (definition === null || typeof definition !== 'object' || Array.isArray(definition))
|
|
17
|
+
invalid();
|
|
18
|
+
if (typeof definition.id !== 'string' ||
|
|
19
|
+
definition.id.length === 0 ||
|
|
20
|
+
definition.id.trim() !== definition.id ||
|
|
21
|
+
typeof definition[operation] !== 'function') {
|
|
22
|
+
invalid();
|
|
23
|
+
}
|
|
24
|
+
for (const optional of ['prepare', 'project', 'reject']) {
|
|
25
|
+
if (definition[optional] !== undefined && typeof definition[optional] !== 'function')
|
|
26
|
+
invalid();
|
|
27
|
+
}
|
|
28
|
+
const allowed = new Set([
|
|
29
|
+
'id',
|
|
30
|
+
operation,
|
|
31
|
+
'prepare',
|
|
32
|
+
'project',
|
|
33
|
+
'reject',
|
|
34
|
+
...(operation === 'build' ? ['page', 'pagination'] : []),
|
|
35
|
+
]);
|
|
36
|
+
if (Reflect.ownKeys(definition).some((key) => typeof key !== 'string' || !allowed.has(key))) {
|
|
37
|
+
invalid();
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
function invalid() {
|
|
41
|
+
throw new TypeError('Query definition is invalid.');
|
|
42
|
+
}
|
|
43
|
+
export function isPromiseLike(input) {
|
|
44
|
+
return (input !== null &&
|
|
45
|
+
(typeof input === 'object' || typeof input === 'function') &&
|
|
46
|
+
typeof input.then === 'function');
|
|
47
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The bounds a Query keeps before anything is sent (S11, spec § Queries: the contract): its
|
|
3
|
+
* reads, its rows, each verb's bound, and the values of a property's `in`.
|
|
4
|
+
*/
|
|
5
|
+
import type { ReadPlan } from '../handles/plan.js';
|
|
6
|
+
import type { QueryDocument } from '../language/query.js';
|
|
7
|
+
/** Each read of each step, and each element of an `items.map`. */
|
|
8
|
+
export declare const MAXIMUM_READS = 32;
|
|
9
|
+
/** Steps of one Query: `steps(first, (earlier) => next, …)` takes two to this many. */
|
|
10
|
+
export declare const MAXIMUM_STEPS = 8;
|
|
11
|
+
/** Across a Query's nested lists. */
|
|
12
|
+
export declare const MAXIMUM_ROWS = 100000;
|
|
13
|
+
/** A verb's bound: its list, plus one for `all` and `first(n, { more })`, fits a Kernel page. */
|
|
14
|
+
export declare const MAXIMUM_BOUND = 83332;
|
|
15
|
+
/** Values of a property's `in`, until it is index-backed. */
|
|
16
|
+
export declare const MAXIMUM_IN = 16;
|
|
17
|
+
/** Whether a list verb of the read, at its root or in a relation, is bound past a Kernel page. */
|
|
18
|
+
export declare function pastPage(plan: ReadPlan): boolean;
|
|
19
|
+
/** The rows a read may answer, counted as the product of its verbs' bounds. */
|
|
20
|
+
export declare function rowsOf(plan: ReadPlan): number;
|
|
21
|
+
/** The first property `in` past its values, as a pointer into the document. */
|
|
22
|
+
export declare function wideIn(document: QueryDocument): string | undefined;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/** Each read of each step, and each element of an `items.map`. */
|
|
2
|
+
export const MAXIMUM_READS = 32;
|
|
3
|
+
/** Steps of one Query: `steps(first, (earlier) => next, …)` takes two to this many. */
|
|
4
|
+
export const MAXIMUM_STEPS = 8;
|
|
5
|
+
/** Across a Query's nested lists. */
|
|
6
|
+
export const MAXIMUM_ROWS = 100_000;
|
|
7
|
+
/** A verb's bound: its list, plus one for `all` and `first(n, { more })`, fits a Kernel page. */
|
|
8
|
+
export const MAXIMUM_BOUND = 83_332;
|
|
9
|
+
/** Values of a property's `in`, until it is index-backed. */
|
|
10
|
+
export const MAXIMUM_IN = 16;
|
|
11
|
+
/** The rows one verb reads: `get` and `find` 2, `first(n)` n, `page` and `all` max + 1. */
|
|
12
|
+
function verbRows(verb, bound = 0) {
|
|
13
|
+
switch (verb) {
|
|
14
|
+
case 'get':
|
|
15
|
+
case 'find':
|
|
16
|
+
return 2;
|
|
17
|
+
case 'first':
|
|
18
|
+
return 1;
|
|
19
|
+
case 'firstN':
|
|
20
|
+
return bound;
|
|
21
|
+
case 'firstMore':
|
|
22
|
+
case 'page':
|
|
23
|
+
case 'all':
|
|
24
|
+
return bound + 1;
|
|
25
|
+
default:
|
|
26
|
+
return 0;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
/** The rows of one parent's relations, each row counting itself and what it carries. */
|
|
30
|
+
function carried(branches) {
|
|
31
|
+
return branches.reduce((total, b) => total + (b.empty ? 0 : verbRows(b.verb, b.bound) * (1 + carried(b.branches))), 0);
|
|
32
|
+
}
|
|
33
|
+
/** The rows of a document read from its own limits: a list's `limit`, its Branches'. */
|
|
34
|
+
function documentRows(document) {
|
|
35
|
+
const list = document.list;
|
|
36
|
+
if (list === undefined)
|
|
37
|
+
return 0;
|
|
38
|
+
const rows = (pattern) => {
|
|
39
|
+
const branches = (pattern.with ?? []);
|
|
40
|
+
return branches.reduce((total, b) => total + (b.mode === 'count' ? 0 : (b.limit ?? 0) * (1 + rows(b))), 0);
|
|
41
|
+
};
|
|
42
|
+
return (list.limit ?? 0) * (1 + rows(list));
|
|
43
|
+
}
|
|
44
|
+
const LISTS = new Set(['firstN', 'firstMore', 'page', 'all']);
|
|
45
|
+
const pastBound = (verb, bound = 0) => LISTS.has(verb) && bound > MAXIMUM_BOUND;
|
|
46
|
+
const branchPastBound = (branches) => branches.some((b) => pastBound(b.verb, b.bound) || branchPastBound(b.branches ?? []));
|
|
47
|
+
/** Whether a list verb of the read, at its root or in a relation, is bound past a Kernel page. */
|
|
48
|
+
export function pastPage(plan) {
|
|
49
|
+
const branches = plan.root?.kind === 'nodes' ? plan.root.branches : [];
|
|
50
|
+
return pastBound(plan.verb, plan.bound) || branchPastBound(branches);
|
|
51
|
+
}
|
|
52
|
+
/** The rows a read may answer, counted as the product of its verbs' bounds. */
|
|
53
|
+
export function rowsOf(plan) {
|
|
54
|
+
if (plan.empty)
|
|
55
|
+
return 0;
|
|
56
|
+
if (plan.verb === 'document')
|
|
57
|
+
return documentRows(plan.document);
|
|
58
|
+
const branches = plan.root?.kind === 'nodes' ? plan.root.branches : [];
|
|
59
|
+
return verbRows(plan.verb, plan.bound) * (1 + carried(branches));
|
|
60
|
+
}
|
|
61
|
+
/** The first property `in` past its values, as a pointer into the document. */
|
|
62
|
+
export function wideIn(document) {
|
|
63
|
+
const visit = (value, path) => {
|
|
64
|
+
if (Array.isArray(value)) {
|
|
65
|
+
for (const [index, entry] of value.entries()) {
|
|
66
|
+
const found = visit(entry, `${path}/${index}`);
|
|
67
|
+
if (found !== undefined)
|
|
68
|
+
return found;
|
|
69
|
+
}
|
|
70
|
+
return undefined;
|
|
71
|
+
}
|
|
72
|
+
if (value === null || typeof value !== 'object')
|
|
73
|
+
return undefined;
|
|
74
|
+
const record = value;
|
|
75
|
+
if (record.op === 'in')
|
|
76
|
+
return record.values.length > MAXIMUM_IN ? path : undefined;
|
|
77
|
+
// A value written in a condition is data: it is never read as a condition.
|
|
78
|
+
if (record.op === 'eq' || record.op === 'range' || record.op === 'id')
|
|
79
|
+
return undefined;
|
|
80
|
+
for (const [name, entry] of Object.entries(record)) {
|
|
81
|
+
const found = visit(entry, `${path}/${name.replaceAll('~', '~0').replaceAll('/', '~1')}`);
|
|
82
|
+
if (found !== undefined)
|
|
83
|
+
return found;
|
|
84
|
+
}
|
|
85
|
+
return undefined;
|
|
86
|
+
};
|
|
87
|
+
return visit(document, '');
|
|
88
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { QueryPageRequest, QueryResponse } from '@astrale-os/kernel-client/graph';
|
|
2
|
+
import type { QueryAST, QueryResultFor } from '@astrale-os/kernel-core/graph/query';
|
|
3
|
+
import type { QueryDocument } from '../language/query.js';
|
|
4
|
+
/** What a Query v7 read is sent with: the cursor of the page it continues. */
|
|
5
|
+
export interface QueryRequestOptions {
|
|
6
|
+
readonly paging?: {
|
|
7
|
+
readonly after: string;
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* The client a Query reads through, as a Kernel Client session serves it: a v7 document per
|
|
12
|
+
* request, or a V6 Query's AST page by page. A client that serves V6 Queries only implements
|
|
13
|
+
* `QueryV6Client`.
|
|
14
|
+
*/
|
|
15
|
+
export interface QueryClient {
|
|
16
|
+
query<Query extends QueryDocument>(query: Query, options: QueryRequestOptions): Promise<unknown>;
|
|
17
|
+
/** A V6 Query's read. It stays the last overload, which `Parameters` and `ReturnType` read. */
|
|
18
|
+
query<Ast extends QueryAST>(ast: Ast, options: {
|
|
19
|
+
readonly page: QueryPageRequest;
|
|
20
|
+
}): Promise<QueryResponse<QueryResultFor<Ast>>>;
|
|
21
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { ClassRef, Domain } from '../../../platform/schema/index.js';
|
|
2
|
+
import type { Model } from '../handles/model.js';
|
|
3
|
+
import type { ReadPlan } from '../handles/plan.js';
|
|
4
|
+
/** A Class requirement as a build compiles it: an entry of `requirements.capabilities.classes`. */
|
|
5
|
+
export interface DeclaredClass {
|
|
6
|
+
readonly class: ClassRef;
|
|
7
|
+
readonly operations: readonly string[];
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* The S12 refusal: a `TypeError`, the same for every input and every attempt, so a durable Step
|
|
11
|
+
* fails at once on it.
|
|
12
|
+
*/
|
|
13
|
+
export declare class UndeclaredCrossing extends TypeError {
|
|
14
|
+
#private;
|
|
15
|
+
constructor(query: string, message: string);
|
|
16
|
+
get query(): string;
|
|
17
|
+
}
|
|
18
|
+
/** The S12 check of one Domain: its dependencies, and the operations it declares on their Classes. */
|
|
19
|
+
export declare class Crossings {
|
|
20
|
+
#private;
|
|
21
|
+
readonly model: Model;
|
|
22
|
+
constructor(model: Model, domain: Domain, declared: readonly DeclaredClass[]);
|
|
23
|
+
/** Throw when a relation of the read crosses a foreign Class its Domain does not declare. */
|
|
24
|
+
check(query: string, plan: ReadPlan): void;
|
|
25
|
+
}
|