@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
|
@@ -1,24 +1,52 @@
|
|
|
1
1
|
import type { MutationResult } from '@astrale-os/kernel-core/graph/mutate';
|
|
2
|
-
import type {
|
|
3
|
-
import type {
|
|
2
|
+
import type { Errors, OutputContext } from '../query/defined/query.js';
|
|
3
|
+
import type { Handles } from '../query/handles/handles.js';
|
|
4
|
+
import type { DefinedMutationBuilder } from './authoring/builder.js';
|
|
4
5
|
import type { MutationFailure } from './failure.js';
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
6
|
+
import type { Mutation, MutationDefinition } from './legacy/v6/mutation.js';
|
|
7
|
+
export type { Mutation, MutationDefinition } from './legacy/v6/mutation.js';
|
|
8
|
+
/**
|
|
9
|
+
* A Mutation defined from a string id (D31): inert, its id and the errors its `reject` may raise
|
|
10
|
+
* are public, and what it writes is kept for the runtime. A call names its authority,
|
|
11
|
+
* `mutate(mutation, input, { as: 'executor' | 'caller' })`.
|
|
12
|
+
*/
|
|
13
|
+
export interface DefinedMutation<Id extends string = string, Input = unknown, Output = unknown, E extends Errors = Errors> {
|
|
10
14
|
readonly kind: 'mutation';
|
|
11
|
-
readonly
|
|
12
|
-
readonly
|
|
13
|
-
readonly
|
|
15
|
+
readonly id: Id;
|
|
16
|
+
readonly errors: E;
|
|
17
|
+
readonly '~input'?: Input;
|
|
18
|
+
readonly '~output'?: Output;
|
|
14
19
|
}
|
|
15
|
-
/**
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
20
|
+
/**
|
|
21
|
+
* `defineMutation<Schema>()` given a string id first. A Mutation without `output` and one with it
|
|
22
|
+
* take separate signatures: TypeScript checks a `reject` whose parameters are typed, such as a
|
|
23
|
+
* function declared elsewhere, before an `output` whose parameters are not typed gives the output
|
|
24
|
+
* its type, so a single signature would hold that `reject` to the committed result.
|
|
25
|
+
*/
|
|
26
|
+
export interface DefinedMutationFactory<S> {
|
|
27
|
+
/**
|
|
28
|
+
* `build` writes the Mutation with the builder, naming each Class by its handle, `d.<Class>`.
|
|
29
|
+
* Without `output`, the Mutation answers the committed result; `reject` may raise a declared
|
|
30
|
+
* error through `context.error`, which a Function that calls the Mutation re-declares.
|
|
31
|
+
*/
|
|
32
|
+
<const Id extends string, Input, E extends Errors = {}>(id: Id, spec: {
|
|
33
|
+
readonly build: (input: Input, d: Handles<S>, mutation: DefinedMutationBuilder<S>) => undefined;
|
|
34
|
+
readonly output?: undefined;
|
|
35
|
+
readonly reject?: (failure: MutationFailure, input: Input, context: OutputContext<S, E>) => MutationResult;
|
|
36
|
+
readonly errors?: E;
|
|
37
|
+
}): DefinedMutation<Id, Input, MutationResult, E>;
|
|
38
|
+
/**
|
|
39
|
+
* `build` writes the Mutation with the builder, naming each Class by its handle, `d.<Class>`;
|
|
40
|
+
* `output` maps the committed result, `reject` an expected refusal to the same type, and may
|
|
41
|
+
* raise a declared error through `context.error`, which a Function that calls the Mutation
|
|
42
|
+
* re-declares.
|
|
43
|
+
*/
|
|
44
|
+
<const Id extends string, Input, Output, E extends Errors = {}>(id: Id, spec: {
|
|
45
|
+
readonly build: (input: Input, d: Handles<S>, mutation: DefinedMutationBuilder<S>) => undefined;
|
|
46
|
+
readonly output: (result: MutationResult, input: Input) => Output;
|
|
47
|
+
readonly reject?: (failure: MutationFailure, input: Input, context: OutputContext<S, E>) => NoInfer<Output>;
|
|
48
|
+
readonly errors?: E;
|
|
49
|
+
}): DefinedMutation<Id, Input, Output, E>;
|
|
21
50
|
}
|
|
22
|
-
export type MutationInputOf<Value> = Value extends Mutation<infer _Domain, infer Input, infer _Output> ? Input : Value extends MutationDefinition<infer Input, infer _Output> ? Input : never;
|
|
23
|
-
export type MutationOutputOf<Value> = Value extends Mutation<infer _Domain, infer _Input, infer Output> ? Output : Value extends MutationDefinition<infer _Input, infer Output> ? Output : never;
|
|
24
|
-
export {};
|
|
51
|
+
export type MutationInputOf<Value> = Value extends DefinedMutation<string, infer Input, infer _Output, Errors> ? Input : Value extends Mutation<infer _Domain, infer Input, infer _Output> ? Input : Value extends MutationDefinition<infer Input, infer _Output> ? Input : never;
|
|
52
|
+
export type MutationOutputOf<Value> = Value extends DefinedMutation<string, infer _Input, infer Output, Errors> ? Output : Value extends Mutation<infer _Domain, infer _Input, infer Output> ? Output : Value extends MutationDefinition<infer _Input, infer Output> ? Output : never;
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What a v7 Query answers (page "Fondations Query v7", § Résultats), typed by its Query: the
|
|
3
|
+
* Kernel's answer as it arrives, never reshaped. A list answers a tree of references (its Page,
|
|
4
|
+
* each item's Branches) and one table of the facts it renders as values; an `exists` a boolean;
|
|
5
|
+
* a `count` a bounded number.
|
|
6
|
+
*
|
|
7
|
+
* The types read the Query's own JSON type: the Branch names, their modes and their nesting give
|
|
8
|
+
* the shape of every item; the Domain gives the type of every value by its Property key. A fact
|
|
9
|
+
* carries no Class, so a value is typed by its key alone; a Node item carries its Class (K-C),
|
|
10
|
+
* which a Kernel before K-C leaves out.
|
|
11
|
+
*/
|
|
12
|
+
import type { EdgeKey } from '../../../platform/graph/edge/index.js';
|
|
13
|
+
import type { NodeId } from '../../../platform/graph/node/index.js';
|
|
14
|
+
import type { QueryPropertyKey, QueryPropertyValues, QueryRendering } from '../language/query.js';
|
|
15
|
+
/** On request (W8): the roots the caller's view cannot decide, up to the fold's bound. */
|
|
16
|
+
export interface QueryUndecided {
|
|
17
|
+
readonly count: number;
|
|
18
|
+
readonly more: boolean;
|
|
19
|
+
}
|
|
20
|
+
/** One Page of a list: the exact prefix of its order, and the cursor that continues it (W3). */
|
|
21
|
+
export type QueryPageOf<Item> = {
|
|
22
|
+
readonly items: readonly Item[];
|
|
23
|
+
readonly undecided?: QueryUndecided;
|
|
24
|
+
} & ({
|
|
25
|
+
readonly complete: true;
|
|
26
|
+
} | {
|
|
27
|
+
readonly complete: false;
|
|
28
|
+
readonly cursor: string;
|
|
29
|
+
});
|
|
30
|
+
/** Bounded so a Query typed only by its constraint still resolves: 8 nested lists. */
|
|
31
|
+
type Depth = readonly unknown[];
|
|
32
|
+
type Deeper<D extends Depth> = readonly [...D, 0];
|
|
33
|
+
type Branches<W> = W extends readonly unknown[] ? W[number] : never;
|
|
34
|
+
/** The answer of one Branch: a `count`, or the Page of its list. */
|
|
35
|
+
export type QueryBranchAnswer<B, D extends Depth = []> = B extends {
|
|
36
|
+
readonly mode: 'count';
|
|
37
|
+
} ? {
|
|
38
|
+
readonly count: number;
|
|
39
|
+
readonly more: boolean;
|
|
40
|
+
readonly undecided?: QueryUndecided;
|
|
41
|
+
} : QueryPageOf<QueryBranchItem<B, D>>;
|
|
42
|
+
/** The Branches of an item, by name. */
|
|
43
|
+
export type QueryBranchesOf<W, D extends Depth = []> = D['length'] extends 8 ? {} : {
|
|
44
|
+
readonly [B in Branches<W> as B extends {
|
|
45
|
+
readonly name: infer N extends string;
|
|
46
|
+
} ? N : never]: QueryBranchAnswer<B, Deeper<D>>;
|
|
47
|
+
};
|
|
48
|
+
/** One item of a Branch list: the Node it reached, the Edge when the Branch selects it. */
|
|
49
|
+
export type QueryBranchItem<B, D extends Depth = []> = {
|
|
50
|
+
readonly fact: NodeId;
|
|
51
|
+
readonly class?: string;
|
|
52
|
+
readonly branches: QueryBranchesOf<B extends {
|
|
53
|
+
readonly with?: infer W;
|
|
54
|
+
} ? W : never, D>;
|
|
55
|
+
} & (B extends {
|
|
56
|
+
readonly selectEdge: QueryRendering;
|
|
57
|
+
} ? {
|
|
58
|
+
readonly edge: EdgeKey;
|
|
59
|
+
} : {
|
|
60
|
+
readonly edge?: never;
|
|
61
|
+
});
|
|
62
|
+
/** One item of the root list: a Node with its Branches, or an Edge with its rendered ends. */
|
|
63
|
+
export type QueryRootItem<R> = R extends {
|
|
64
|
+
readonly nodes: unknown;
|
|
65
|
+
} ? {
|
|
66
|
+
readonly fact: NodeId;
|
|
67
|
+
readonly class?: string;
|
|
68
|
+
readonly branches: QueryBranchesOf<R extends {
|
|
69
|
+
readonly with?: infer W;
|
|
70
|
+
} ? W : never>;
|
|
71
|
+
} : {
|
|
72
|
+
readonly fact: EdgeKey;
|
|
73
|
+
readonly source?: {
|
|
74
|
+
readonly fact: NodeId;
|
|
75
|
+
readonly class?: string;
|
|
76
|
+
readonly branches: {};
|
|
77
|
+
};
|
|
78
|
+
readonly target?: {
|
|
79
|
+
readonly fact: NodeId;
|
|
80
|
+
readonly class?: string;
|
|
81
|
+
readonly branches: {};
|
|
82
|
+
};
|
|
83
|
+
readonly branches: {};
|
|
84
|
+
};
|
|
85
|
+
/** One fact a list renders as values: its readable values and the keys it withholds (R9). */
|
|
86
|
+
export interface QueryFact<Source> {
|
|
87
|
+
readonly fact: NodeId | EdgeKey;
|
|
88
|
+
/** By Property key; a key the Domain does not define may appear (a newer Schema). */
|
|
89
|
+
readonly values: QueryPropertyValues<Source>;
|
|
90
|
+
readonly withheld: readonly QueryPropertyKey<Source>[];
|
|
91
|
+
}
|
|
92
|
+
/** The answer of a `list`: its Page, the facts it renders, the revision it read (W6). */
|
|
93
|
+
export interface QueryListAnswer<Source, Q> {
|
|
94
|
+
readonly list: QueryPageOf<QueryRootItem<Q extends {
|
|
95
|
+
readonly list: infer R;
|
|
96
|
+
} ? R : never>>;
|
|
97
|
+
readonly facts: readonly QueryFact<Source>[];
|
|
98
|
+
readonly revision: string;
|
|
99
|
+
/** A continuation crossed a revision: its Page reads a later snapshot than its first. */
|
|
100
|
+
readonly revised?: true;
|
|
101
|
+
}
|
|
102
|
+
export interface QueryExistsAnswer {
|
|
103
|
+
readonly exists: boolean;
|
|
104
|
+
readonly undecided?: boolean;
|
|
105
|
+
}
|
|
106
|
+
export interface QueryCountAnswer {
|
|
107
|
+
readonly count: number;
|
|
108
|
+
readonly more: boolean;
|
|
109
|
+
readonly undecided?: QueryUndecided;
|
|
110
|
+
}
|
|
111
|
+
/** What a Query answers, by its family (the name of its root fold). */
|
|
112
|
+
export type QueryAnswerOf<Source, Q> = Q extends {
|
|
113
|
+
readonly list: unknown;
|
|
114
|
+
} ? QueryListAnswer<Source, Q> : Q extends {
|
|
115
|
+
readonly exists: unknown;
|
|
116
|
+
} ? QueryExistsAnswer : QueryCountAnswer;
|
|
117
|
+
export {};
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Domain } from '../../../platform/schema/index.js';
|
|
2
|
+
import type { QueryListAnswer } from './answer.js';
|
|
3
|
+
/** Throw `QueryValueMismatchError` for the first value that does not match its Property. */
|
|
4
|
+
export declare function requireAnswerConformance(domain: Domain, answer: QueryListAnswer<unknown, unknown>): void;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { definedClass } from '@astrale-os/kernel-client/graph';
|
|
2
|
+
import { QueryValueMismatchError } from '../failure.js';
|
|
3
|
+
import { factKey } from './facts.js';
|
|
4
|
+
const PROPERTY = '.property.';
|
|
5
|
+
/** The Property a key names in `domain`, or `undefined` when `domain` does not define it. */
|
|
6
|
+
function propertyOf(domain, key) {
|
|
7
|
+
const at = key.lastIndexOf(PROPERTY);
|
|
8
|
+
if (at <= 0)
|
|
9
|
+
return undefined;
|
|
10
|
+
const owner = definedClass(domain, key.slice(0, at));
|
|
11
|
+
return owner?.properties.get(key);
|
|
12
|
+
}
|
|
13
|
+
/** Throw `QueryValueMismatchError` for the first value that does not match its Property. */
|
|
14
|
+
export function requireAnswerConformance(domain, answer) {
|
|
15
|
+
for (const fact of answer.facts) {
|
|
16
|
+
const values = fact.values;
|
|
17
|
+
for (const key of Object.keys(values)) {
|
|
18
|
+
const property = propertyOf(domain, key);
|
|
19
|
+
if (property === undefined)
|
|
20
|
+
continue;
|
|
21
|
+
const [diagnostic] = property.validate(values[key]);
|
|
22
|
+
if (diagnostic !== undefined) {
|
|
23
|
+
throw new QueryValueMismatchError(`The value of ${key} on ${factKey(fact.fact)} does not match its Property in this Domain: ${diagnostic.message}`);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The facts table of a list answer, by identity: one index per answer, and the Pages of a root
|
|
3
|
+
* list joined into one complete answer.
|
|
4
|
+
*/
|
|
5
|
+
import type { QueryFact, QueryListAnswer } from './answer.js';
|
|
6
|
+
type FactId = QueryFact<unknown>['fact'];
|
|
7
|
+
/** The text that names a fact: a NodeId as itself, an EdgeKey by its fields in key order. */
|
|
8
|
+
export declare function factKey(fact: FactId): string;
|
|
9
|
+
/** The facts of a list answer by identity, indexed once per answer. */
|
|
10
|
+
export declare function factsOf(answer: QueryListAnswer<unknown, unknown>): ReadonlyMap<string, QueryFact<unknown>>;
|
|
11
|
+
/**
|
|
12
|
+
* The Pages of one root list, joined: their items in order, their facts by identity (a later
|
|
13
|
+
* Page's row wins: it was read at a later revision), the last Page's revision, `revised` when a
|
|
14
|
+
* continuation crossed a revision. The last Page is complete; Branch lists stay as cut.
|
|
15
|
+
*/
|
|
16
|
+
export declare function joinPages<A extends QueryListAnswer<unknown, unknown>>(pages: readonly [A, ...A[]]): A;
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/** The text that names a fact: a NodeId as itself, an EdgeKey by its fields in key order. */
|
|
2
|
+
export function factKey(fact) {
|
|
3
|
+
if (typeof fact === 'string')
|
|
4
|
+
return fact;
|
|
5
|
+
const fields = fact;
|
|
6
|
+
return JSON.stringify(Object.keys(fields)
|
|
7
|
+
.sort()
|
|
8
|
+
.map((name) => [name, fields[name]]));
|
|
9
|
+
}
|
|
10
|
+
const indexes = new WeakMap();
|
|
11
|
+
/** The facts of a list answer by identity, indexed once per answer. */
|
|
12
|
+
export function factsOf(answer) {
|
|
13
|
+
const known = indexes.get(answer);
|
|
14
|
+
if (known !== undefined)
|
|
15
|
+
return known;
|
|
16
|
+
const index = new Map();
|
|
17
|
+
for (const fact of answer.facts)
|
|
18
|
+
index.set(factKey(fact.fact), fact);
|
|
19
|
+
indexes.set(answer, index);
|
|
20
|
+
return index;
|
|
21
|
+
}
|
|
22
|
+
function undecidedOf(pages) {
|
|
23
|
+
const reported = pages.flatMap((page) => page.list.undecided === undefined ? [] : [page.list.undecided]);
|
|
24
|
+
if (reported.length === 0)
|
|
25
|
+
return undefined;
|
|
26
|
+
return Object.freeze({
|
|
27
|
+
count: reported.reduce((total, undecided) => total + undecided.count, 0),
|
|
28
|
+
more: reported.some((undecided) => undecided.more),
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* The Pages of one root list, joined: their items in order, their facts by identity (a later
|
|
33
|
+
* Page's row wins: it was read at a later revision), the last Page's revision, `revised` when a
|
|
34
|
+
* continuation crossed a revision. The last Page is complete; Branch lists stay as cut.
|
|
35
|
+
*/
|
|
36
|
+
export function joinPages(pages) {
|
|
37
|
+
if (pages.length === 1)
|
|
38
|
+
return pages[0];
|
|
39
|
+
const last = pages[pages.length - 1];
|
|
40
|
+
const facts = new Map();
|
|
41
|
+
for (const page of pages)
|
|
42
|
+
for (const fact of page.facts)
|
|
43
|
+
facts.set(factKey(fact.fact), fact);
|
|
44
|
+
const undecided = undecidedOf(pages);
|
|
45
|
+
const revised = pages.some((page) => page.revised === true) ||
|
|
46
|
+
pages.some((page) => page.revision !== pages[0].revision);
|
|
47
|
+
return Object.freeze({
|
|
48
|
+
list: Object.freeze({
|
|
49
|
+
items: Object.freeze(pages.flatMap((page) => page.list.items)),
|
|
50
|
+
complete: true,
|
|
51
|
+
...(undecided === undefined ? {} : { undecided }),
|
|
52
|
+
}),
|
|
53
|
+
facts: Object.freeze([...facts.values()]),
|
|
54
|
+
revision: last.revision,
|
|
55
|
+
...(revised ? { revised: true } : {}),
|
|
56
|
+
});
|
|
57
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Domain } from '../../../platform/schema/index.js';
|
|
2
|
-
import type { CollectionDefinitionRecord } from '../collection/union.js';
|
|
2
|
+
import type { CollectionDefinitionRecord } from '../legacy/v6/collection/union.js';
|
|
3
3
|
import type { SingleQueryDefinition } from '../query.js';
|
|
4
4
|
import type { QueryComposition, QueryPlan } from './query.js';
|
|
5
5
|
declare const PLAN: unique symbol;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { admitCollectionDefinitions } from '../collection/union.js';
|
|
1
|
+
import { admitCollectionDefinitions } from '../legacy/v6/collection/union.js';
|
|
2
2
|
import { QueryCompositionError } from './errors.js';
|
|
3
3
|
const PLAN = Symbol('astrale.sdk.query.plan');
|
|
4
4
|
const REFERENCE = Symbol('astrale.sdk.query.reference');
|
|
@@ -12,7 +12,7 @@ export function createQueryComposition() {
|
|
|
12
12
|
requireOpen(open);
|
|
13
13
|
requireLocalId(id, ids);
|
|
14
14
|
if (definition?.kind !== 'query')
|
|
15
|
-
invalid('Composite leaves must be single
|
|
15
|
+
invalid('Composite leaves must be single Queries.');
|
|
16
16
|
requireLocalReferences(input, token);
|
|
17
17
|
return createPlan(token, Object.freeze({
|
|
18
18
|
kind: 'leaf',
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Domain } from '../../../platform/schema/index.js';
|
|
2
|
-
import type { CollectionDefinitionRecord } from '../collection/union.js';
|
|
2
|
+
import type { CollectionDefinitionRecord } from '../legacy/v6/collection/union.js';
|
|
3
3
|
import type { SingleQueryDefinition } from '../query.js';
|
|
4
4
|
import type { InternalPlan } from './builder.js';
|
|
5
5
|
export declare const QUERY_COMPOSITION_LIMITS: Readonly<{
|
|
@@ -7,10 +7,6 @@ export declare const QUERY_COMPOSITION_LIMITS: Readonly<{
|
|
|
7
7
|
maximumDependencyDepth: 8;
|
|
8
8
|
}>;
|
|
9
9
|
export interface QueryPlanAnalysis {
|
|
10
|
-
/** @deprecated Use physicalQueries. */
|
|
11
|
-
readonly queries: number;
|
|
12
|
-
/** @deprecated Use dependencyDepth. */
|
|
13
|
-
readonly depth: number;
|
|
14
10
|
readonly logicalQueries: number;
|
|
15
11
|
readonly physicalQueries: number;
|
|
16
12
|
readonly dependencyDepth: number;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { COLLECTION_QUERY_LIMITS } from '../collection/limits.js';
|
|
1
|
+
import { COLLECTION_QUERY_LIMITS } from '../legacy/v6/collection/limits.js';
|
|
2
2
|
import { inspectPlan, referencesIn, resolveInput } from './builder.js';
|
|
3
3
|
import { QueryCompositionError } from './errors.js';
|
|
4
4
|
export const QUERY_COMPOSITION_LIMITS = Object.freeze({
|
|
@@ -53,8 +53,6 @@ export function analyzeQueryPlan(plan) {
|
|
|
53
53
|
throw new QueryCompositionError('QUERY_COMPOSITION_LIMIT', `Composite Query exceeds ${QUERY_COMPOSITION_LIMITS.maximumPhysicalQueries} physical Queries or dependency depth ${QUERY_COMPOSITION_LIMITS.maximumDependencyDepth}.`);
|
|
54
54
|
}
|
|
55
55
|
return Object.freeze({
|
|
56
|
-
queries: physicalKeys.size,
|
|
57
|
-
depth: maximumDepth,
|
|
58
56
|
logicalQueries,
|
|
59
57
|
physicalQueries: physicalKeys.size,
|
|
60
58
|
dependencyDepth: maximumDepth,
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import type { ResolvedClass } from '@astrale-os/kernel-dsl/v1';
|
|
2
2
|
import type { Domain } from '../../../platform/schema/index.js';
|
|
3
|
-
import type { CollectionQueryDefinition, QueryOutputOf, SingleQueryDefinition } from '../query.js';
|
|
4
|
-
import type { QueryLifecycle } from '../single/index.js';
|
|
3
|
+
import type { CollectionQueryDefinition, QueryLifecycle, QueryOutputOf, SingleQueryDefinition } from '../query.js';
|
|
5
4
|
declare const QUERY_PLAN_OUTPUT: unique symbol;
|
|
6
5
|
declare const QUERY_PLAN_VALUE: unique symbol;
|
|
7
6
|
export type QueryPlanValue<Value> = Readonly<{
|
|
@@ -1,34 +1,7 @@
|
|
|
1
|
-
import type { QueryAST } from '@astrale-os/kernel-core/graph/query';
|
|
2
|
-
import type { AnyResolvedClass } from '@astrale-os/kernel-dsl/v1';
|
|
3
1
|
import type { Domain, schema } from '../../platform/schema/index.js';
|
|
4
2
|
import type { ProjectedCompositeQuery, QueryComposition, QueryPlan, QueryPlanOutput, RawCompositeQuery } from './composite/index.js';
|
|
5
|
-
import type {
|
|
6
|
-
import type {
|
|
7
|
-
import { type CollectionQuerySpec } from './collection/metadata.js';
|
|
8
|
-
type AuthoredRaw<Input, Ast extends QueryAST> = Omit<RawQuery<Input, Ast>, 'kind' | 'page'> & {
|
|
9
|
-
readonly page?: {
|
|
10
|
-
readonly size: number;
|
|
11
|
-
};
|
|
12
|
-
};
|
|
13
|
-
type AuthoredProjected<Input, Output, Ast extends QueryAST> = Omit<ProjectedQuery<Input, Output, Ast>, 'kind' | 'page'> & {
|
|
14
|
-
readonly page?: {
|
|
15
|
-
readonly size: number;
|
|
16
|
-
};
|
|
17
|
-
};
|
|
18
|
-
type AuthoredPaginated<Input, Output, Ast extends QueryAST> = Omit<PaginatedQuery<Input, Output, Ast>, 'kind' | 'page'> & {
|
|
19
|
-
readonly page?: {
|
|
20
|
-
readonly size: number;
|
|
21
|
-
};
|
|
22
|
-
};
|
|
23
|
-
type ResolvedDomainOf<Schema extends schema.DomainSchema> = Extract<schema.DomainOf<Schema>, Domain>;
|
|
24
|
-
interface SingleQueryProjector<Schema extends schema.DomainSchema> {
|
|
25
|
-
<Input, Ast extends QueryAST>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredRaw<Input, Ast>): SingleQueryDefinition<ResolvedDomainOf<Schema>, Input, RawQuery<Input, Ast> extends SingleQuery<Input, infer Output> ? Output : never>;
|
|
26
|
-
<Input, Output, Ast extends QueryAST>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredProjected<Input, Output, Ast>): SingleQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
|
|
27
|
-
<Input, Output, Ast extends QueryAST>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredPaginated<Input, Output, Ast>): SingleQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
|
|
28
|
-
}
|
|
29
|
-
interface CollectionQueryProjector<Schema extends schema.DomainSchema> {
|
|
30
|
-
<Class extends AnyResolvedClass>(project: (domain: ResolvedDomainOf<Schema>) => CollectionQuerySpec<Class>): CollectionQueryDefinition<ResolvedDomainOf<Schema>, Class>;
|
|
31
|
-
}
|
|
3
|
+
import type { ResolvedDomainOf } from './definition.js';
|
|
4
|
+
import type { CompositeQueryDefinition, QueryDefinition, RealizedQuery } from './query.js';
|
|
32
5
|
type AuthoredInferredComposite<Input, Composed, Plan extends QueryPlan<unknown>, Output, DomainValue extends Domain> = Omit<ProjectedCompositeQuery<Input, Composed, Output, DomainValue>, 'kind' | 'compose' | 'project'> & {
|
|
33
6
|
compose(builder: QueryComposition<DomainValue>, input: Input): Plan;
|
|
34
7
|
project(value: QueryPlanOutput<Plan>, input: Input): Output;
|
|
@@ -38,11 +11,7 @@ interface CompositeQueryProjector<Schema extends schema.DomainSchema> {
|
|
|
38
11
|
<Input, Output>(project: (domain: ResolvedDomainOf<Schema>) => Omit<RawCompositeQuery<Input, Output, ResolvedDomainOf<Schema>>, 'kind'>): CompositeQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
|
|
39
12
|
<Input, Composed, Output, Plan extends QueryPlan<Composed> = QueryPlan<Composed>>(project: (domain: ResolvedDomainOf<Schema>) => AuthoredInferredComposite<Input, Composed, Plan, Output, ResolvedDomainOf<Schema>>): CompositeQueryDefinition<ResolvedDomainOf<Schema>, Input, Output>;
|
|
40
13
|
}
|
|
41
|
-
/** Define one inert
|
|
42
|
-
export declare function defineQuery<Schema extends schema.DomainSchema>(): SingleQueryProjector<Schema>;
|
|
43
|
-
/** Define one reusable complete polymorphic Class-extent Query. */
|
|
44
|
-
export declare function defineCollectionQuery<Schema extends schema.DomainSchema>(): CollectionQueryProjector<Schema>;
|
|
45
|
-
/** Define one inert composite Query recipe projected from its exact loaded Domain. */
|
|
14
|
+
/** Define one inert composite Query projected from its exact loaded Domain. */
|
|
46
15
|
export declare function defineCompositeQuery<Schema extends schema.DomainSchema>(): CompositeQueryProjector<Schema>;
|
|
47
16
|
export declare function realizeQuery<DomainValue extends Domain, Input, Output>(query: QueryDefinition<DomainValue, Input, Output>, domain: DomainValue): RealizedQuery<Input, Output>;
|
|
48
17
|
export {};
|
|
@@ -1,61 +1,13 @@
|
|
|
1
|
-
import { Query } from '@astrale-os/kernel-core/graph/query';
|
|
2
1
|
import { isDomain } from '@astrale-os/kernel-dsl/v1/domain';
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import { realizeCollectionQuery, registerCollectionQuery, } from './collection/metadata.js';
|
|
6
|
-
import { queryResult } from './single/index.js';
|
|
7
|
-
const DEFAULT_PAGE_SIZE = 256;
|
|
8
|
-
const MAXIMUM_PAGES = 1_024;
|
|
9
|
-
const projectors = new WeakMap();
|
|
2
|
+
import { definitionBase, isPromiseLike, projectorOf, inertQuery } from './definition.js';
|
|
3
|
+
import { admitSingle } from './legacy/v6/define.js';
|
|
10
4
|
const realized = new WeakMap();
|
|
11
|
-
/** Define one inert
|
|
12
|
-
export function defineQuery() {
|
|
13
|
-
return ((project) => recipe('query', project));
|
|
14
|
-
}
|
|
15
|
-
/** Define one reusable complete polymorphic Class-extent Query. */
|
|
16
|
-
export function defineCollectionQuery() {
|
|
17
|
-
return ((project) => {
|
|
18
|
-
const definition = defineQuery()((domain) => {
|
|
19
|
-
const specification = realizeCollectionQuery(definition, domain);
|
|
20
|
-
const selected = specification.class;
|
|
21
|
-
if (selected.kind === 'node') {
|
|
22
|
-
return {
|
|
23
|
-
id: specification.id,
|
|
24
|
-
page: { size: COLLECTION_QUERY_LIMITS.pageSize },
|
|
25
|
-
pagination: { maximumPages: COLLECTION_QUERY_LIMITS.maximumPages },
|
|
26
|
-
build: () => Query.from({ nodes: [selected] }).select({
|
|
27
|
-
kind: 'nodes',
|
|
28
|
-
projection: { kind: 'value' },
|
|
29
|
-
}),
|
|
30
|
-
project: (pages) => requireUniqueCollectionValues(queryResult.completeNodeValues(pages, specification.id), `Collection Query ${specification.id}`),
|
|
31
|
-
};
|
|
32
|
-
}
|
|
33
|
-
return {
|
|
34
|
-
id: specification.id,
|
|
35
|
-
page: { size: COLLECTION_QUERY_LIMITS.pageSize },
|
|
36
|
-
pagination: { maximumPages: COLLECTION_QUERY_LIMITS.maximumPages },
|
|
37
|
-
build: () => Query.from({ edges: [selected] }).select({
|
|
38
|
-
kind: 'edges',
|
|
39
|
-
projection: { edge: 'value', source: 'reference', target: 'reference' },
|
|
40
|
-
}),
|
|
41
|
-
project: (pages) => requireUniqueCollectionValues(Object.freeze(pages.flatMap((page) => queryResult.edgeItems(page, specification.id).map((item) => {
|
|
42
|
-
if (item.edge.kind !== 'value') {
|
|
43
|
-
throw new TypeError(`Collection Query ${specification.id} must project Edge values.`);
|
|
44
|
-
}
|
|
45
|
-
return item.edge.value;
|
|
46
|
-
}))), `Collection Query ${specification.id}`),
|
|
47
|
-
};
|
|
48
|
-
});
|
|
49
|
-
registerCollectionQuery(definition, project);
|
|
50
|
-
return definition;
|
|
51
|
-
});
|
|
52
|
-
}
|
|
53
|
-
/** Define one inert composite Query recipe projected from its exact loaded Domain. */
|
|
5
|
+
/** Define one inert composite Query projected from its exact loaded Domain. */
|
|
54
6
|
export function defineCompositeQuery() {
|
|
55
|
-
return ((project) =>
|
|
7
|
+
return ((project) => inertQuery('composite-query', project));
|
|
56
8
|
}
|
|
57
9
|
export function realizeQuery(query, domain) {
|
|
58
|
-
const project =
|
|
10
|
+
const project = projectorOf(query);
|
|
59
11
|
if (project === undefined)
|
|
60
12
|
throw new TypeError('Query must be produced by defineQuery.');
|
|
61
13
|
if (!isDomain(domain))
|
|
@@ -75,37 +27,6 @@ export function realizeQuery(query, domain) {
|
|
|
75
27
|
byDomain.set(domain, admitted);
|
|
76
28
|
return admitted;
|
|
77
29
|
}
|
|
78
|
-
function recipe(kind, project) {
|
|
79
|
-
if (typeof project !== 'function')
|
|
80
|
-
throw new TypeError('Query projection must be a function.');
|
|
81
|
-
const definition = Object.freeze({ kind });
|
|
82
|
-
projectors.set(definition, project);
|
|
83
|
-
return definition;
|
|
84
|
-
}
|
|
85
|
-
function admitSingle(definition) {
|
|
86
|
-
definitionBase(definition, 'build');
|
|
87
|
-
const page = pageOf(definition.page);
|
|
88
|
-
const pagination = definition.pagination;
|
|
89
|
-
if (pagination !== undefined) {
|
|
90
|
-
if (typeof definition.project !== 'function') {
|
|
91
|
-
throw new TypeError('Paginated Query requires a project function.');
|
|
92
|
-
}
|
|
93
|
-
if (pagination === null ||
|
|
94
|
-
typeof pagination !== 'object' ||
|
|
95
|
-
Array.isArray(pagination) ||
|
|
96
|
-
Reflect.ownKeys(pagination).length !== 1 ||
|
|
97
|
-
!Object.hasOwn(pagination, 'maximumPages')) {
|
|
98
|
-
throw new TypeError('Query pagination is invalid.');
|
|
99
|
-
}
|
|
100
|
-
const maximumPages = Reflect.get(pagination, 'maximumPages');
|
|
101
|
-
if (!Number.isSafeInteger(maximumPages) ||
|
|
102
|
-
maximumPages < 1 ||
|
|
103
|
-
maximumPages > MAXIMUM_PAGES) {
|
|
104
|
-
throw new TypeError(`Query pagination must be bounded from 1 through ${MAXIMUM_PAGES}.`);
|
|
105
|
-
}
|
|
106
|
-
}
|
|
107
|
-
return Object.freeze({ ...definition, page, kind: 'single' });
|
|
108
|
-
}
|
|
109
30
|
function admitComposite(definition) {
|
|
110
31
|
definitionBase(definition, 'compose');
|
|
111
32
|
if (Object.hasOwn(definition, 'page') || Object.hasOwn(definition, 'pagination')) {
|
|
@@ -113,50 +34,3 @@ function admitComposite(definition) {
|
|
|
113
34
|
}
|
|
114
35
|
return Object.freeze({ ...definition, kind: 'composite' });
|
|
115
36
|
}
|
|
116
|
-
function definitionBase(definition, operation) {
|
|
117
|
-
if (definition === null || typeof definition !== 'object' || Array.isArray(definition))
|
|
118
|
-
invalid();
|
|
119
|
-
if (typeof definition.id !== 'string' ||
|
|
120
|
-
definition.id.length === 0 ||
|
|
121
|
-
definition.id.trim() !== definition.id ||
|
|
122
|
-
typeof definition[operation] !== 'function') {
|
|
123
|
-
invalid();
|
|
124
|
-
}
|
|
125
|
-
for (const optional of ['prepare', 'project', 'reject']) {
|
|
126
|
-
if (definition[optional] !== undefined && typeof definition[optional] !== 'function')
|
|
127
|
-
invalid();
|
|
128
|
-
}
|
|
129
|
-
const allowed = new Set([
|
|
130
|
-
'id',
|
|
131
|
-
operation,
|
|
132
|
-
'prepare',
|
|
133
|
-
'project',
|
|
134
|
-
'reject',
|
|
135
|
-
...(operation === 'build' ? ['page', 'pagination'] : []),
|
|
136
|
-
]);
|
|
137
|
-
if (Reflect.ownKeys(definition).some((key) => typeof key !== 'string' || !allowed.has(key))) {
|
|
138
|
-
invalid();
|
|
139
|
-
}
|
|
140
|
-
}
|
|
141
|
-
function pageOf(input) {
|
|
142
|
-
if (input === undefined)
|
|
143
|
-
return Object.freeze({ size: DEFAULT_PAGE_SIZE });
|
|
144
|
-
if (input === null ||
|
|
145
|
-
typeof input !== 'object' ||
|
|
146
|
-
Array.isArray(input) ||
|
|
147
|
-
Reflect.ownKeys(input).length !== 1 ||
|
|
148
|
-
!Object.hasOwn(input, 'size') ||
|
|
149
|
-
!Number.isSafeInteger(Reflect.get(input, 'size')) ||
|
|
150
|
-
Reflect.get(input, 'size') < 1) {
|
|
151
|
-
throw new TypeError('Query page size must be a positive safe integer.');
|
|
152
|
-
}
|
|
153
|
-
return Object.freeze({ size: Reflect.get(input, 'size') });
|
|
154
|
-
}
|
|
155
|
-
function invalid() {
|
|
156
|
-
throw new TypeError('Query definition is invalid.');
|
|
157
|
-
}
|
|
158
|
-
function isPromiseLike(input) {
|
|
159
|
-
return (input !== null &&
|
|
160
|
-
(typeof input === 'object' || typeof input === 'function') &&
|
|
161
|
-
typeof input.then === 'function');
|
|
162
|
-
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `defineQuery<Schema>()`: one name for both forms. A string id first defines a Query v7; a
|
|
3
|
+
* function first defines a V6 Query, which stays in `legacy/v6`. A Query v7 is inert: its id and
|
|
4
|
+
* the errors it declares are public, and what it reads is kept for the runtime (WP-S3).
|
|
5
|
+
*/
|
|
6
|
+
import type { schema } from '../../../platform/schema/index.js';
|
|
7
|
+
import type { SingleQueryProjector } from '../legacy/v6/define.js';
|
|
8
|
+
import type { DefinedQuery, DefinedQueryFactory } from './query.js';
|
|
9
|
+
/** A Query or Mutation id: lowercase segments of letters, digits and hyphens, joined by dots. */
|
|
10
|
+
export declare const DEFINITION_ID: RegExp;
|
|
11
|
+
export declare const MAXIMUM_DEFINITION_ID = 128;
|
|
12
|
+
type Callback = (...parameters: never[]) => unknown;
|
|
13
|
+
/** What a Query reads and answers: its `build`, of `(input, d, steps)`, and its `output`. */
|
|
14
|
+
export interface QuerySpec {
|
|
15
|
+
readonly build: Callback;
|
|
16
|
+
readonly output?: Callback;
|
|
17
|
+
}
|
|
18
|
+
/** The build and the output of a Query v7; `undefined` for anything else. */
|
|
19
|
+
export declare function querySpecOf(query: unknown): QuerySpec | undefined;
|
|
20
|
+
/** A definition of the Domain's namespace, a Query's or a Mutation's: its id, and its errors. */
|
|
21
|
+
export type NamedDefinition = Pick<DefinedQuery, 'id' | 'errors'>;
|
|
22
|
+
/**
|
|
23
|
+
* Keep the errors a definition declares, a Query's or a Mutation's, and collect it into the
|
|
24
|
+
* collections open: a defined Mutation shares its Domain's Query ids and error definitions.
|
|
25
|
+
*/
|
|
26
|
+
export declare function collectDefinition(query: NamedDefinition): void;
|
|
27
|
+
/**
|
|
28
|
+
* Collect into `queries` each Query or Mutation defined while `load` runs: a build collects the
|
|
29
|
+
* definitions that loading its Domain defines, and checks them with `admitDefinitions`. A module an
|
|
30
|
+
* earlier load of the same process evaluated defines nothing again, so its definitions were checked
|
|
31
|
+
* with that load.
|
|
32
|
+
*/
|
|
33
|
+
export declare function collectDefinitions<T>(queries: NamedDefinition[], load: () => Promise<T>): Promise<T>;
|
|
34
|
+
/**
|
|
35
|
+
* Refuse two definitions of one Domain under one id: a refusal and a call name a Query or Mutation
|
|
36
|
+
* by its id. Refuse two that declare one code with different definitions: a Function that spreads
|
|
37
|
+
* both errors keeps one of them, and would redact the other definition's error.
|
|
38
|
+
*/
|
|
39
|
+
export declare function admitDefinitions(queries: readonly NamedDefinition[]): void;
|
|
40
|
+
/**
|
|
41
|
+
* Define a Query: `defineQuery<Schema>()('services.service.owner', { build, output?, errors? })`.
|
|
42
|
+
* The V6 form, `defineQuery<Schema>()((domain) => ({ id, build, project? }))`, stays.
|
|
43
|
+
*/
|
|
44
|
+
export declare function defineQuery<Schema extends schema.DomainSchema>(): SingleQueryProjector<Schema> & DefinedQueryFactory<Schema>;
|
|
45
|
+
export {};
|