@astrale-os/sdk 0.6.0-beta.6 → 0.6.0-beta.60
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +220 -66
- package/dist/application/action/action.d.ts +6 -0
- package/dist/application/action/authoring.d.ts +3 -1
- package/dist/application/action/authoring.js +1 -0
- package/dist/application/action/context.d.ts +95 -34
- package/dist/application/action/define.d.ts +3 -3
- package/dist/application/action/index.d.ts +3 -1
- package/dist/application/action/index.js +1 -0
- package/dist/application/define.d.ts +8 -6
- package/dist/application/define.js +28 -14
- package/dist/application/dependency/index.d.ts +1 -1
- package/dist/application/dependency/invoker.d.ts +21 -10
- package/dist/application/domain.d.ts +30 -0
- package/dist/application/error/error.d.ts +16 -1
- package/dist/application/error/error.js +39 -5
- package/dist/application/error/index.d.ts +1 -1
- package/dist/application/error/index.js +1 -1
- package/dist/application/file/binary.d.ts +11 -0
- package/dist/application/file/binary.js +45 -0
- package/dist/application/file/file.d.ts +77 -0
- package/dist/application/file/file.js +111 -0
- package/dist/application/file/index.d.ts +4 -0
- package/dist/application/file/index.js +2 -0
- package/dist/application/file/input.d.ts +13 -0
- package/dist/application/file/input.js +57 -0
- package/dist/application/index.d.ts +6 -5
- package/dist/application/index.js +1 -1
- package/dist/application/integration/define.d.ts +8 -1
- package/dist/application/integration/index.d.ts +2 -2
- package/dist/application/integration/integration.d.ts +13 -1
- package/dist/application/integration/operation.d.ts +16 -3
- package/dist/application/mutation/authoring/builder.d.ts +81 -33
- package/dist/application/mutation/authoring/builder.js +100 -30
- package/dist/application/mutation/authoring/guard.d.ts +37 -0
- package/dist/application/mutation/authoring/guard.js +150 -0
- package/dist/application/mutation/authoring/index.d.ts +5 -2
- package/dist/application/mutation/authoring/index.js +2 -1
- package/dist/application/mutation/authoring/names.d.ts +19 -0
- package/dist/application/mutation/authoring/names.js +83 -0
- package/dist/application/mutation/authoring/properties.d.ts +17 -4
- package/dist/application/mutation/authoring/properties.js +38 -2
- package/dist/application/mutation/authoring/transition.d.ts +3 -2
- package/dist/application/mutation/authoring/transition.js +4 -1
- package/dist/application/mutation/define.d.ts +24 -10
- package/dist/application/mutation/define.js +49 -53
- package/dist/application/mutation/execution/execute.d.ts +2 -2
- package/dist/application/mutation/execution/execute.js +78 -7
- package/dist/application/mutation/execution/executor.d.ts +4 -1
- package/dist/application/mutation/execution/executor.js +6 -1
- package/dist/application/mutation/failure.d.ts +17 -1
- package/dist/application/mutation/failure.js +40 -19
- package/dist/application/mutation/index.d.ts +9 -5
- package/dist/application/mutation/index.js +5 -2
- package/dist/application/mutation/legacy/v6/builder.d.ts +84 -0
- package/dist/application/mutation/legacy/v6/define.d.ts +18 -0
- package/dist/application/mutation/legacy/v6/define.js +56 -0
- package/dist/application/mutation/legacy/v6/mutation.d.ts +28 -0
- package/dist/application/mutation/{authoring → legacy/v6}/precondition.d.ts +4 -0
- package/dist/application/mutation/mutation.d.ts +47 -19
- package/dist/application/query/answer/answer.d.ts +117 -0
- package/dist/application/query/answer/conformance.d.ts +4 -0
- package/dist/application/query/answer/conformance.js +27 -0
- package/dist/application/query/answer/facts.d.ts +17 -0
- package/dist/application/query/answer/facts.js +57 -0
- package/dist/application/query/composite/builder.d.ts +1 -1
- package/dist/application/query/composite/builder.js +2 -2
- package/dist/application/query/composite/plan.d.ts +1 -5
- package/dist/application/query/composite/plan.js +1 -3
- package/dist/application/query/composite/query.d.ts +1 -2
- package/dist/application/query/define.d.ts +3 -34
- package/dist/application/query/define.js +5 -131
- package/dist/application/query/defined/define.d.ts +45 -0
- package/dist/application/query/defined/define.js +96 -0
- package/dist/application/query/defined/query.d.ts +139 -0
- package/dist/application/query/definition.d.ts +12 -0
- package/dist/application/query/definition.js +47 -0
- package/dist/application/query/execution/bounds.d.ts +22 -0
- package/dist/application/query/execution/bounds.js +88 -0
- package/dist/application/query/execution/client.d.ts +21 -0
- package/dist/application/query/execution/crossings.d.ts +30 -0
- package/dist/application/query/execution/crossings.js +232 -0
- package/dist/application/query/execution/error.d.ts +71 -0
- package/dist/application/query/execution/error.js +50 -0
- package/dist/application/query/execution/execute.d.ts +4 -10
- package/dist/application/query/execution/execute.js +3 -45
- package/dist/application/query/execution/executor.d.ts +2 -2
- package/dist/application/query/execution/legacy/declared-classes.d.ts +10 -0
- package/dist/application/query/execution/legacy/declared-classes.js +9 -0
- package/dist/application/query/execution/refusal.d.ts +37 -0
- package/dist/application/query/execution/refusal.js +80 -0
- package/dist/application/query/execution/rows.d.ts +42 -0
- package/dist/application/query/execution/rows.js +326 -0
- package/dist/application/query/execution/run.d.ts +85 -0
- package/dist/application/query/execution/run.js +372 -0
- package/dist/application/query/execution/split.d.ts +24 -0
- package/dist/application/query/execution/split.js +190 -0
- package/dist/application/query/failure.d.ts +8 -0
- package/dist/application/query/failure.js +8 -0
- package/dist/application/query/handles/build.d.ts +10 -0
- package/dist/application/query/handles/build.js +53 -0
- package/dist/application/query/handles/conditions.d.ts +94 -0
- package/dist/application/query/handles/domain.d.ts +157 -0
- package/dist/application/query/handles/handles.d.ts +285 -0
- package/dist/application/query/handles/handles.js +1 -0
- package/dist/application/query/handles/model.d.ts +106 -0
- package/dist/application/query/handles/model.js +261 -0
- package/dist/application/query/handles/plan.d.ts +100 -0
- package/dist/application/query/handles/plan.js +37 -0
- package/dist/application/query/handles/reads.d.ts +106 -0
- package/dist/application/query/handles/reads.js +978 -0
- package/dist/application/query/handles/relations.d.ts +106 -0
- package/dist/application/query/handles/relations.js +1 -0
- package/dist/application/query/handles/rows.d.ts +94 -0
- package/dist/application/query/handles/rows.js +4 -0
- package/dist/application/query/handles/terms.d.ts +103 -0
- package/dist/application/query/handles/terms.js +282 -0
- package/dist/application/query/index.d.ts +14 -8
- package/dist/application/query/index.js +10 -5
- package/dist/application/query/language/index.d.ts +2 -0
- package/dist/application/query/language/index.js +2 -0
- package/dist/application/query/language/query.d.ts +323 -0
- package/dist/application/query/language/query.js +2 -0
- package/dist/application/query/{collection → legacy/v6/collection}/identity.d.ts +2 -2
- package/dist/application/query/{collection → legacy/v6/collection}/metadata.d.ts +1 -1
- package/dist/application/query/{collection → legacy/v6/collection}/union.d.ts +4 -4
- package/dist/application/query/{collection → legacy/v6/collection}/union.js +15 -8
- package/dist/application/query/legacy/v6/conformance.d.ts +15 -0
- package/dist/application/query/legacy/v6/conformance.js +46 -0
- package/dist/application/query/legacy/v6/define.d.ts +37 -0
- package/dist/application/query/legacy/v6/define.js +90 -0
- package/dist/application/query/legacy/v6/execution/execute.d.ts +18 -0
- package/dist/application/query/legacy/v6/execution/execute.js +50 -0
- package/dist/application/query/legacy/v6/index.d.ts +7 -0
- package/dist/application/query/legacy/v6/index.js +3 -0
- package/dist/application/query/legacy/v6/kernel.d.ts +6 -0
- package/dist/application/query/legacy/v6/kernel.js +5 -0
- package/dist/application/query/{single → legacy/v6/single}/pagination.js +1 -1
- package/dist/application/query/{single → legacy/v6/single}/query.d.ts +2 -14
- package/dist/application/query/legacy/v6/single/query.js +1 -0
- package/dist/application/query/query.d.ts +19 -4
- package/dist/application/requirements/canonical.d.ts +7 -0
- package/dist/application/requirements/canonical.js +16 -0
- package/dist/application/requirements/classes.d.ts +9 -7
- package/dist/application/requirements/classes.js +35 -42
- package/dist/application/requirements/functions.d.ts +3 -1
- package/dist/application/requirements/functions.js +12 -27
- package/dist/application/requirements/index.d.ts +34 -16
- package/dist/application/requirements/index.js +17 -20
- package/dist/application/requirements/legacy/authority.d.ts +21 -0
- package/dist/application/requirements/{authority.js → legacy/authority.js} +5 -2
- package/dist/application/requirements/legacy/classes.d.ts +22 -0
- package/dist/application/requirements/legacy/classes.js +24 -0
- package/dist/application/requirements/legacy/core.d.ts +30 -0
- package/dist/application/requirements/{core.js → legacy/core.js} +15 -13
- package/dist/application/requirements/legacy/functions.d.ts +7 -0
- package/dist/application/requirements/legacy/functions.js +15 -0
- package/dist/application/requirements/legacy/index.d.ts +43 -0
- package/dist/application/requirements/legacy/index.js +1 -0
- package/dist/application/requirements/legacy/requirements.d.ts +31 -0
- package/dist/application/requirements/legacy/requirements.js +31 -0
- package/dist/application/requirements/requirement.d.ts +30 -19
- package/dist/application/requirements/roles.d.ts +17 -0
- package/dist/application/requirements/roles.js +62 -0
- package/dist/application/requirements/scopes.d.ts +16 -0
- package/dist/application/requirements/scopes.js +34 -0
- package/dist/application/routes/admission.d.ts +3 -3
- package/dist/application/routes/admission.js +3 -3
- package/dist/application/routes/index.d.ts +3 -2
- package/dist/application/routes/route.d.ts +3 -3
- package/dist/application/runtime/actions.js +3 -0
- package/dist/application/runtime/declarations.d.ts +6 -6
- package/dist/application/runtime/define.d.ts +5 -5
- package/dist/application/runtime/runtime.js +12 -0
- package/dist/application/runtime/workflows.d.ts +3 -1
- package/dist/application/runtime/workflows.js +3 -4
- package/dist/application/view/define.js +4 -6
- package/dist/application/view/frontend.d.ts +2 -2
- package/dist/application/view/index.d.ts +1 -1
- package/dist/application/view/route.d.ts +0 -14
- package/dist/application/view/route.js +1 -64
- package/dist/application/workflow/authoring.d.ts +3 -2
- package/dist/application/workflow/context.d.ts +8 -2
- package/dist/application/workflow/define.d.ts +4 -4
- package/dist/application/workflow/define.js +14 -9
- package/dist/application/workflow/durable.d.ts +211 -0
- package/dist/application/workflow/durable.js +1 -0
- package/dist/application/workflow/index.d.ts +3 -2
- package/dist/application/workflow/runner/inline.js +1 -0
- package/dist/application/workflow/runner/runner.d.ts +2 -2
- package/dist/application/workflow/workflow.d.ts +5 -3
- package/dist/deployment/adapter/adapter.d.ts +55 -13
- package/dist/deployment/adapter/bundle/bundle.d.ts +36 -0
- package/dist/deployment/adapter/bundle/bundle.js +1 -0
- package/dist/deployment/adapter/bundle/file.d.ts +10 -0
- package/dist/deployment/adapter/bundle/file.js +1 -0
- package/dist/deployment/adapter/bundle/index.d.ts +2 -0
- package/dist/deployment/adapter/bundle/index.js +1 -0
- package/dist/deployment/adapter/define.d.ts +4 -3
- package/dist/deployment/adapter/define.js +107 -23
- package/dist/deployment/adapter/index.d.ts +4 -3
- package/dist/deployment/adapter/index.js +1 -0
- package/dist/deployment/adapter/release/command.d.ts +33 -0
- package/dist/deployment/adapter/release/command.js +1 -0
- package/dist/deployment/adapter/release/context.d.ts +94 -0
- package/dist/deployment/adapter/release/context.js +1 -0
- package/dist/deployment/adapter/release/index.d.ts +4 -0
- package/dist/deployment/adapter/release/index.js +1 -0
- package/dist/deployment/adapter/release/list.d.ts +53 -0
- package/dist/deployment/adapter/release/list.js +1 -0
- package/dist/deployment/adapter/release/refusal.d.ts +10 -0
- package/dist/deployment/adapter/release/refusal.js +14 -0
- package/dist/deployment/adapter/release/result.d.ts +56 -0
- package/dist/deployment/adapter/release/result.js +1 -0
- package/dist/deployment/address/configuration.d.ts +96 -0
- package/dist/deployment/address/configuration.js +274 -0
- package/dist/deployment/address/fingerprint.d.ts +5 -0
- package/dist/deployment/address/fingerprint.js +27 -0
- package/dist/deployment/address/index.d.ts +5 -0
- package/dist/deployment/address/index.js +4 -0
- package/dist/deployment/address/label.d.ts +42 -0
- package/dist/deployment/address/label.js +80 -0
- package/dist/deployment/address/line.d.ts +29 -0
- package/dist/deployment/address/line.js +53 -0
- package/dist/deployment/address/record.d.ts +73 -0
- package/dist/deployment/address/record.js +138 -0
- package/dist/deployment/address/summary.d.ts +30 -0
- package/dist/deployment/address/summary.js +1 -0
- package/dist/deployment/address/vectors.d.ts +60 -0
- package/dist/deployment/address/vectors.js +517 -0
- package/dist/deployment/authoring.d.ts +0 -2
- package/dist/deployment/authoring.js +0 -1
- package/dist/deployment/build/build.d.ts +13 -2
- package/dist/deployment/build/compile.d.ts +4 -4
- package/dist/deployment/build/compile.js +31 -81
- package/dist/deployment/build/frontend/compilation.d.ts +2 -4
- package/dist/deployment/build/frontend/compilation.js +0 -5
- package/dist/deployment/build/frontend/digest.js +1 -5
- package/dist/deployment/build/index.d.ts +1 -0
- package/dist/deployment/build/index.js +1 -0
- package/dist/deployment/build/legacy/requirements.d.ts +11 -0
- package/dist/deployment/build/legacy/requirements.js +79 -0
- package/dist/deployment/build/manifest.d.ts +59 -0
- package/dist/deployment/build/manifest.js +118 -0
- package/dist/deployment/build/material.d.ts +2 -2
- package/dist/deployment/build/material.js +28 -13
- package/dist/deployment/build/schema.d.ts +2 -2
- package/dist/deployment/deployment.d.ts +3 -2
- package/dist/deployment/environment.d.ts +6 -0
- package/dist/deployment/environment.js +6 -0
- package/dist/deployment/index.d.ts +4 -6
- package/dist/deployment/index.js +1 -2
- package/dist/deployment/release/addressing.d.ts +6 -5
- package/dist/deployment/release/addressing.js +2 -3
- package/dist/deployment/release/assemble.d.ts +6 -3
- package/dist/deployment/release/assemble.js +12 -10
- package/dist/deployment/release/release.d.ts +16 -5
- package/dist/deployment/release/seal.d.ts +14 -0
- package/dist/deployment/release/seal.js +22 -0
- package/dist/deployment/release/{publication → served}/callables.d.ts +2 -2
- package/dist/deployment/release/{publication → served}/callables.js +2 -2
- package/dist/deployment/release/served/index.d.ts +11 -0
- package/dist/deployment/release/served/index.js +26 -0
- package/dist/deployment/release/{publication → served}/views.d.ts +2 -2
- package/dist/deployment/release/{publication → served}/views.js +0 -1
- package/dist/deployment/runtime/admission.d.ts +2 -2
- package/dist/deployment/runtime/admission.js +5 -5
- package/dist/deployment/verify/index.d.ts +3 -4
- package/dist/deployment/verify/index.js +2 -3
- package/dist/deployment/verify/preflight/bundle.d.ts +18 -0
- package/dist/deployment/verify/preflight/bundle.js +71 -0
- package/dist/deployment/verify/preflight/index.d.ts +1 -12
- package/dist/deployment/verify/preflight/index.js +1 -12
- package/dist/deployment/verify/readiness/fetch.d.ts +13 -0
- package/dist/deployment/verify/readiness/fetch.js +26 -0
- package/dist/deployment/verify/readiness/identity.d.ts +3 -6
- package/dist/deployment/verify/readiness/identity.js +3 -3
- package/dist/deployment/verify/readiness/index.d.ts +15 -8
- package/dist/deployment/verify/readiness/index.js +25 -6
- package/dist/deployment/verify/readiness/release.d.ts +8 -0
- package/dist/deployment/verify/readiness/release.js +22 -0
- package/dist/deployment/worker/address.d.ts +26 -0
- package/dist/deployment/worker/address.js +43 -0
- package/dist/deployment/worker/build.d.ts +60 -0
- package/dist/deployment/worker/build.js +172 -0
- package/dist/deployment/worker/configuration.d.ts +73 -0
- package/dist/deployment/worker/configuration.js +165 -0
- package/dist/deployment/worker/content.d.ts +38 -0
- package/dist/deployment/worker/content.js +169 -0
- package/dist/deployment/worker/index.d.ts +29 -0
- package/dist/deployment/worker/index.js +29 -0
- package/dist/deployment/worker/limits.d.ts +30 -0
- package/dist/deployment/worker/limits.js +30 -0
- package/dist/deployment/worker/record.d.ts +29 -0
- package/dist/deployment/worker/record.js +69 -0
- package/dist/deployment/worker/request.d.ts +118 -0
- package/dist/deployment/worker/request.js +280 -0
- package/dist/deployment/worker/response.d.ts +101 -0
- package/dist/deployment/worker/response.js +207 -0
- package/dist/execution/cache/cache.d.ts +17 -0
- package/dist/execution/cache/cache.js +11 -0
- package/dist/execution/cache/index.d.ts +2 -0
- package/dist/execution/cache/index.js +2 -0
- package/dist/execution/cache/memory.d.ts +13 -0
- package/dist/execution/cache/memory.js +48 -0
- package/dist/execution/identity/authentication.d.ts +33 -3
- package/dist/execution/identity/authentication.js +95 -36
- package/dist/execution/identity/callback.d.ts +20 -20
- package/dist/execution/identity/callback.js +34 -26
- package/dist/execution/identity/delivery.d.ts +6 -4
- package/dist/execution/identity/delivery.js +25 -20
- package/dist/execution/identity/exchange.js +11 -1
- package/dist/execution/identity/identity.d.ts +17 -3
- package/dist/execution/identity/identity.js +12 -4
- package/dist/execution/identity/jwks.d.ts +5 -0
- package/dist/execution/identity/jwks.js +92 -102
- package/dist/execution/index.d.ts +6 -4
- package/dist/execution/index.js +4 -2
- package/dist/execution/invocation/admission/age.d.ts +57 -0
- package/dist/execution/invocation/admission/age.js +208 -0
- package/dist/execution/invocation/admission/authentication.d.ts +13 -13
- package/dist/execution/invocation/admission/authentication.js +52 -44
- package/dist/execution/invocation/admission/authority.d.ts +28 -6
- package/dist/execution/invocation/admission/authority.js +9 -2
- package/dist/execution/invocation/admission/index.d.ts +4 -3
- package/dist/execution/invocation/admission/index.js +3 -2
- package/dist/execution/invocation/admission/input.d.ts +2 -2
- package/dist/execution/invocation/admission/input.js +16 -2
- package/dist/execution/invocation/admission/target.d.ts +11 -0
- package/dist/execution/invocation/admission/target.js +22 -3
- package/dist/execution/invocation/capabilities/bind.d.ts +14 -0
- package/dist/execution/invocation/capabilities/bind.js +74 -0
- package/dist/execution/invocation/capabilities/index.d.ts +1 -0
- package/dist/execution/invocation/capabilities/index.js +1 -0
- package/dist/execution/invocation/dependency/bind.d.ts +3 -1
- package/dist/execution/invocation/dependency/bind.js +36 -16
- package/dist/execution/invocation/dispatch/action.js +4 -2
- package/dist/execution/invocation/dispatch/context.d.ts +8 -7
- package/dist/execution/invocation/dispatch/context.js +34 -45
- package/dist/execution/invocation/dispatch/workflow.js +4 -6
- package/dist/execution/invocation/handler.js +8 -2
- package/dist/execution/invocation/index.d.ts +2 -2
- package/dist/execution/invocation/index.js +1 -1
- package/dist/execution/invocation/integration/authentication.d.ts +3 -3
- package/dist/execution/invocation/integration/authentication.js +7 -7
- package/dist/execution/invocation/integration/call.d.ts +2 -1
- package/dist/execution/invocation/integration/call.js +3 -3
- package/dist/execution/invocation/integration/clients.d.ts +1 -1
- package/dist/execution/invocation/integration/index.d.ts +1 -0
- package/dist/execution/invocation/integration/index.js +1 -0
- package/dist/execution/invocation/invocation.d.ts +6 -0
- package/dist/execution/invocation/invocation.js +130 -22
- package/dist/execution/invocation/lifecycle/active.d.ts +8 -2
- package/dist/execution/invocation/lifecycle/active.js +3 -3
- package/dist/execution/invocation/lifecycle/index.d.ts +1 -1
- package/dist/execution/invocation/result/errors.d.ts +0 -10
- package/dist/execution/invocation/result/errors.js +12 -16
- package/dist/execution/invocation/result/index.d.ts +3 -2
- package/dist/execution/invocation/result/index.js +2 -1
- package/dist/execution/invocation/result/project.js +41 -1
- package/dist/execution/invocation/result/undeclared.d.ts +7 -0
- package/dist/execution/invocation/result/undeclared.js +18 -0
- package/dist/execution/node/serve.d.ts +2 -2
- package/dist/execution/node/serve.js +1 -1
- package/dist/execution/runtime/index.d.ts +1 -0
- package/dist/execution/runtime/index.js +1 -0
- package/dist/execution/runtime/load.d.ts +3 -3
- package/dist/execution/runtime/load.js +3 -2
- package/dist/execution/runtime/release.d.ts +17 -0
- package/dist/execution/runtime/release.js +7 -0
- package/dist/execution/serve.d.ts +18 -4
- package/dist/execution/serve.js +10 -0
- package/dist/execution/service/create.js +43 -7
- package/dist/execution/service/initialization.d.ts +4 -4
- package/dist/execution/service/initialization.js +23 -14
- package/dist/execution/service/release.d.ts +2 -2
- package/dist/execution/service/release.js +3 -2
- package/dist/execution/service/service.d.ts +20 -5
- package/dist/execution/service/serving/delivery.d.ts +5 -0
- package/dist/execution/service/{publication → serving}/delivery.js +4 -1
- package/dist/execution/service/{publication → serving}/index.d.ts +1 -1
- package/dist/execution/service/serving/installation.d.ts +4 -0
- package/dist/execution/service/serving/installation.js +9 -0
- package/dist/execution/service/serving/source.d.ts +11 -0
- package/dist/execution/service/serving/source.js +15 -0
- package/dist/execution/workflows/attempts.d.ts +87 -0
- package/dist/execution/workflows/attempts.js +205 -0
- package/dist/execution/workflows/discovery.d.ts +14 -0
- package/dist/execution/workflows/discovery.js +151 -0
- package/dist/execution/workflows/engine.d.ts +83 -0
- package/dist/execution/workflows/engine.js +1 -0
- package/dist/execution/workflows/envelope.d.ts +12 -0
- package/dist/execution/workflows/envelope.js +46 -0
- package/dist/execution/workflows/failure.d.ts +56 -0
- package/dist/execution/workflows/failure.js +204 -0
- package/dist/execution/workflows/index.d.ts +4 -0
- package/dist/execution/workflows/index.js +3 -0
- package/dist/execution/workflows/integrations.d.ts +13 -0
- package/dist/execution/workflows/integrations.js +25 -0
- package/dist/execution/workflows/options.d.ts +81 -0
- package/dist/execution/workflows/options.js +158 -0
- package/dist/execution/workflows/receiver.d.ts +24 -0
- package/dist/execution/workflows/receiver.js +99 -0
- package/dist/execution/workflows/route.d.ts +12 -0
- package/dist/execution/workflows/route.js +35 -0
- package/dist/execution/workflows/run.d.ts +23 -0
- package/dist/execution/workflows/run.js +369 -0
- package/dist/execution/workflows/steps.d.ts +48 -0
- package/dist/execution/workflows/steps.js +93 -0
- package/dist/index.d.ts +5 -5
- package/dist/index.js +2 -2
- package/dist/platform/graph/alias.d.ts +1 -5
- package/dist/platform/graph/alias.js +1 -5
- package/dist/platform/graph/document/index.d.ts +1 -1
- package/dist/platform/graph/document/index.js +1 -1
- package/dist/platform/graph/index.d.ts +1 -1
- package/dist/platform/graph/index.js +1 -1
- package/dist/platform/release/index.d.ts +2 -0
- package/dist/platform/release/index.js +2 -0
- package/dist/platform/schema/callable-authoring.d.ts +21 -0
- package/dist/platform/schema/callable-authoring.js +27 -0
- package/dist/platform/schema/class-authoring.d.ts +58 -12
- package/dist/platform/schema/class-authoring.js +38 -4
- package/dist/platform/schema/class-icon-svg.d.ts +9 -0
- package/dist/platform/schema/class-icon-svg.js +29 -0
- package/dist/platform/schema/class-icon.d.ts +3 -8
- package/dist/platform/schema/class-icon.js +2 -29
- package/dist/platform/schema/index.d.ts +11 -4
- package/dist/platform/schema/index.js +2 -1
- package/dist/platform/schema/kernel-compiled.d.ts +2 -0
- package/dist/platform/schema/kernel-compiled.js +2 -0
- package/dist/platform/schema/kernel.d.ts +4 -2
- package/dist/platform/schema/property.d.ts +5 -0
- package/dist/platform/schema/references/index.d.ts +6 -0
- package/dist/platform/schema/references/index.js +1 -0
- package/dist/platform/schema/schema-authoring.d.ts +14 -7
- package/dist/platform/schema/schema-authoring.js +5 -1
- package/dist/platform/versioning/dependents.d.ts +18 -0
- package/dist/platform/versioning/dependents.js +15 -0
- package/dist/platform/versioning/index.d.ts +5 -0
- package/dist/platform/versioning/index.js +5 -0
- package/dist/platform/versioning/name.d.ts +38 -0
- package/dist/platform/versioning/name.js +58 -0
- package/dist/platform/versioning/reference.d.ts +48 -0
- package/dist/platform/versioning/reference.js +95 -0
- package/dist/platform/versioning/version.d.ts +72 -0
- package/dist/platform/versioning/version.js +98 -0
- package/dist/project/admit.js +1 -5
- package/dist/project/define.d.ts +4 -4
- package/dist/project/define.js +55 -35
- package/dist/project/index.d.ts +1 -1
- package/dist/project/install-command.d.ts +6 -0
- package/dist/project/install-command.js +9 -0
- package/dist/project/project.d.ts +10 -8
- package/dist/testing/dataset/define.d.ts +1 -1
- package/dist/testing/durable/engine.d.ts +128 -0
- package/dist/testing/durable/engine.js +619 -0
- package/dist/testing/durable/index.d.ts +3 -0
- package/dist/testing/durable/index.js +1 -0
- package/dist/testing/durable/steps.d.ts +30 -0
- package/dist/testing/durable/steps.js +45 -0
- package/dist/testing/file.d.ts +20 -0
- package/dist/testing/file.js +49 -0
- package/dist/testing/index.d.ts +10 -1
- package/dist/testing/index.js +7 -1
- package/dist/testing/load.js +1 -1
- package/dist/testing/query.d.ts +22 -0
- package/dist/testing/query.js +36 -0
- package/dist/tooling/cli/adapter-command.d.ts +35 -0
- package/dist/tooling/cli/adapter-command.js +66 -0
- package/dist/tooling/cli/arguments.d.ts +17 -6
- package/dist/tooling/cli/arguments.js +175 -52
- package/dist/tooling/cli/build.d.ts +55 -0
- package/dist/tooling/cli/build.js +77 -0
- package/dist/tooling/cli/bun.d.ts +0 -1
- package/dist/tooling/cli/bun.js +0 -7
- package/dist/tooling/cli/commit.d.ts +35 -0
- package/dist/tooling/cli/commit.js +235 -0
- package/dist/tooling/cli/deploy-mode.d.ts +26 -0
- package/dist/tooling/cli/deploy-mode.js +59 -0
- package/dist/tooling/cli/deploy-result.d.ts +80 -0
- package/dist/tooling/cli/deploy-result.js +64 -0
- package/dist/tooling/cli/diff/declared.d.ts +7 -0
- package/dist/tooling/cli/diff/declared.js +27 -0
- package/dist/tooling/cli/diff/index.d.ts +30 -0
- package/dist/tooling/cli/diff/index.js +58 -0
- package/dist/tooling/cli/diff/render.d.ts +15 -0
- package/dist/tooling/cli/diff/render.js +131 -0
- package/dist/tooling/cli/diff/report.d.ts +88 -0
- package/dist/tooling/cli/diff/report.js +154 -0
- package/dist/tooling/cli/dotenv.d.ts +5 -5
- package/dist/tooling/cli/dotenv.js +6 -36
- package/dist/tooling/cli/help.js +173 -60
- package/dist/tooling/cli/immutable-deployment.d.ts +83 -0
- package/dist/tooling/cli/immutable-deployment.js +135 -0
- package/dist/tooling/cli/index.d.ts +12 -4
- package/dist/tooling/cli/index.js +6 -3
- package/dist/tooling/cli/installed-on.d.ts +83 -0
- package/dist/tooling/cli/installed-on.js +156 -0
- package/dist/tooling/cli/list.d.ts +152 -0
- package/dist/tooling/cli/list.js +331 -0
- package/dist/tooling/cli/log.d.ts +5 -2
- package/dist/tooling/cli/log.js +9 -2
- package/dist/tooling/cli/orchestrate.d.ts +0 -6
- package/dist/tooling/cli/orchestrate.js +252 -91
- package/dist/tooling/cli/project.d.ts +3 -3
- package/dist/tooling/cli/publish/index.d.ts +81 -0
- package/dist/tooling/cli/publish/index.js +383 -0
- package/dist/tooling/cli/publish/report.d.ts +49 -0
- package/dist/tooling/cli/publish/report.js +15 -0
- package/dist/tooling/cli/registry/client.d.ts +121 -0
- package/dist/tooling/cli/registry/client.js +354 -0
- package/dist/tooling/cli/registry/error.d.ts +11 -0
- package/dist/tooling/cli/registry/error.js +17 -0
- package/dist/tooling/cli/registry/executable.d.ts +35 -0
- package/dist/tooling/cli/registry/executable.js +96 -0
- package/dist/tooling/cli/registry/index.d.ts +9 -0
- package/dist/tooling/cli/registry/index.js +8 -0
- package/dist/tooling/cli/registry/installations.d.ts +67 -0
- package/dist/tooling/cli/registry/installations.js +108 -0
- package/dist/tooling/cli/registry/process.d.ts +36 -0
- package/dist/tooling/cli/registry/process.js +119 -0
- package/dist/tooling/cli/secrets.d.ts +9 -0
- package/dist/tooling/cli/secrets.js +19 -0
- package/dist/tooling/cli/yank.d.ts +34 -0
- package/dist/tooling/cli/yank.js +32 -0
- package/dist/tooling/linter/adapters/typescript/definition-calls.d.ts +34 -0
- package/dist/tooling/linter/adapters/typescript/definition-calls.js +88 -0
- package/dist/tooling/linter/adapters/typescript/discover.js +8 -2
- package/dist/tooling/linter/adapters/typescript/imports.d.ts +0 -1
- package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
- package/dist/tooling/linter/adapters/typescript/index.d.ts +9 -2
- package/dist/tooling/linter/adapters/typescript/index.js +4 -2
- package/dist/tooling/linter/adapters/typescript/legacy.d.ts +20 -0
- package/dist/tooling/linter/adapters/typescript/legacy.js +28 -0
- package/dist/tooling/linter/adapters/typescript/query-observation.js +37 -12
- package/dist/tooling/linter/adapters/typescript/syntax.d.ts +3 -3
- package/dist/tooling/linter/adapters/typescript/syntax.js +13 -25
- package/dist/tooling/linter/adapters/typescript/type-analysis.d.ts +2 -0
- package/dist/tooling/linter/adapters/typescript/type-analysis.js +10 -0
- package/dist/tooling/linter/implementations/source/callable-requirements.d.ts +2 -4
- package/dist/tooling/linter/implementations/source/callable-requirements.js +16 -58
- package/dist/tooling/linter/implementations/source/const-initializer.d.ts +3 -0
- package/dist/tooling/linter/implementations/source/const-initializer.js +31 -0
- package/dist/tooling/linter/implementations/source/definitions.d.ts +2 -0
- package/dist/tooling/linter/implementations/source/definitions.js +425 -0
- package/dist/tooling/linter/implementations/source/dependencies.js +13 -72
- package/dist/tooling/linter/implementations/source/domain-requirements.d.ts +8 -0
- package/dist/tooling/linter/implementations/source/domain-requirements.js +35 -0
- package/dist/tooling/linter/implementations/source/global.js +39 -19
- package/dist/tooling/linter/implementations/source/legacy/requirements.d.ts +10 -0
- package/dist/tooling/linter/implementations/source/legacy/requirements.js +40 -0
- package/dist/tooling/linter/implementations/source/legacy-folders.d.ts +3 -0
- package/dist/tooling/linter/implementations/source/legacy-folders.js +126 -0
- package/dist/tooling/linter/implementations/source/mutations.js +153 -70
- package/dist/tooling/linter/implementations/source/policy-edges.d.ts +2 -0
- package/dist/tooling/linter/implementations/source/policy-edges.js +113 -0
- package/dist/tooling/linter/implementations/source/providers.js +5 -5
- package/dist/tooling/linter/implementations/source/queries.js +1 -17
- package/dist/tooling/linter/implementations/source/requirement-entries.d.ts +24 -0
- package/dist/tooling/linter/implementations/source/requirement-entries.js +52 -0
- package/dist/tooling/linter/implementations/source/runtime-imports.d.ts +2 -0
- package/dist/tooling/linter/implementations/source/runtime-imports.js +119 -0
- package/dist/tooling/linter/implementations/source/schema.d.ts +3 -0
- package/dist/tooling/linter/implementations/source/schema.js +9 -5
- package/dist/tooling/linter/implementations/source/shared.d.ts +19 -5
- package/dist/tooling/linter/implementations/source/shared.js +131 -55
- package/dist/tooling/linter/implementations/source/tests.js +1 -1
- package/dist/tooling/linter/implementations/source/verifiers.js +8 -2
- package/dist/tooling/linter/implementations/source/views.js +2 -2
- package/dist/tooling/linter/implementations/source/workflows.js +499 -17
- package/dist/tooling/linter/policy/generated.js +18 -67
- package/dist/tooling/linter/requirements/registry.js +14 -9
- package/dist/tooling/packaging/declarations/ownership.js +1 -1
- package/dist/tooling/packaging/finalize.d.ts +1 -1
- package/dist/tooling/packaging/finalize.js +1 -1
- package/docs/accounts/scenarios.tsv +12 -0
- package/docs/admission-age.md +88 -0
- package/docs/auth-api-migration.md +57 -0
- package/docs/business-errors.md +42 -0
- package/docs/domain-definition-migration.md +44 -0
- package/docs/domain-schema-migration.md +36 -0
- package/docs/durable-workflows.md +530 -0
- package/docs/handler-dependencies.md +381 -0
- package/docs/legacy/query-v6.md +62 -0
- package/docs/legacy.md +113 -0
- package/docs/queries.md +493 -0
- package/docs/release.md +155 -0
- package/docs/requirements.md +143 -0
- package/docs/schema-cost.md +124 -0
- package/package.json +62 -26
- package/dist/application/application.d.ts +0 -28
- package/dist/application/query/execution/projection.d.ts +0 -3
- package/dist/application/query/execution/projection.js +0 -3
- package/dist/application/requirements/authority.d.ts +0 -7
- package/dist/application/requirements/core.d.ts +0 -14
- package/dist/deployment/adapter/deploy/context.d.ts +0 -15
- package/dist/deployment/adapter/deploy/index.d.ts +0 -2
- package/dist/deployment/adapter/deploy/result.d.ts +0 -50
- package/dist/deployment/adapter/prepare/artifact.d.ts +0 -33
- package/dist/deployment/adapter/prepare/context.d.ts +0 -23
- package/dist/deployment/adapter/prepare/index.d.ts +0 -2
- package/dist/deployment/deploy.d.ts +0 -20
- package/dist/deployment/deploy.js +0 -31
- package/dist/deployment/release/publication/index.d.ts +0 -6
- package/dist/deployment/release/publication/index.js +0 -6
- package/dist/deployment/release/publication/manifest.d.ts +0 -3
- package/dist/deployment/release/publication/manifest.js +0 -5
- package/dist/deployment/release/publication/requirements.d.ts +0 -3
- package/dist/deployment/release/publication/requirements.js +0 -3
- package/dist/deployment/release/publication/seal.d.ts +0 -10
- package/dist/deployment/release/publication/seal.js +0 -39
- package/dist/deployment/verify/preflight/artifact.d.ts +0 -6
- package/dist/deployment/verify/preflight/artifact.js +0 -122
- package/dist/deployment/verify/preflight/publication.d.ts +0 -4
- package/dist/deployment/verify/preflight/publication.js +0 -14
- package/dist/deployment/verify/readiness/deployment.d.ts +0 -3
- package/dist/deployment/verify/readiness/deployment.js +0 -151
- package/dist/deployment/verify/readiness/publication.d.ts +0 -11
- package/dist/deployment/verify/readiness/publication.js +0 -41
- package/dist/execution/service/errors.d.ts +0 -3
- package/dist/execution/service/errors.js +0 -3
- package/dist/execution/service/publication/delivery.d.ts +0 -2
- package/dist/execution/service/publication/installation.d.ts +0 -3
- package/dist/execution/service/publication/installation.js +0 -8
- package/dist/execution/service/publication/source.d.ts +0 -3
- package/dist/execution/service/publication/source.js +0 -11
- package/dist/platform/publication/index.d.ts +0 -2
- package/dist/platform/publication/index.js +0 -2
- package/dist/tooling/cli/astrale/authority.d.ts +0 -5
- package/dist/tooling/cli/astrale/authority.js +0 -11
- package/dist/tooling/cli/astrale/executable.d.ts +0 -2
- package/dist/tooling/cli/astrale/executable.js +0 -47
- package/dist/tooling/cli/astrale/failure.d.ts +0 -6
- package/dist/tooling/cli/astrale/failure.js +0 -48
- package/dist/tooling/cli/astrale/instance.d.ts +0 -11
- package/dist/tooling/cli/astrale/instance.js +0 -52
- package/dist/tooling/cli/astrale/process.d.ts +0 -13
- package/dist/tooling/cli/astrale/process.js +0 -94
- package/dist/tooling/cli/astrale/version.d.ts +0 -18
- package/dist/tooling/cli/astrale/version.js +0 -55
- package/dist/tooling/cli/credential.d.ts +0 -2
- package/dist/tooling/cli/credential.js +0 -57
- package/dist/tooling/cli/deprecations.d.ts +0 -9
- package/dist/tooling/cli/deprecations.js +0 -15
- package/dist/tooling/cli/development/candidate.d.ts +0 -25
- package/dist/tooling/cli/development/candidate.js +0 -176
- package/dist/tooling/cli/development/deployment.d.ts +0 -16
- package/dist/tooling/cli/development/deployment.js +0 -39
- package/dist/tooling/cli/development/develop.d.ts +0 -11
- package/dist/tooling/cli/development/develop.js +0 -243
- package/dist/tooling/cli/development/lease.d.ts +0 -18
- package/dist/tooling/cli/development/lease.js +0 -163
- package/dist/tooling/cli/development/lifecycle.d.ts +0 -9
- package/dist/tooling/cli/development/lifecycle.js +0 -43
- package/dist/tooling/cli/development/project-imports.d.ts +0 -22
- package/dist/tooling/cli/development/project-imports.js +0 -39
- package/dist/tooling/cli/development/project-lock.d.ts +0 -16
- package/dist/tooling/cli/development/project-lock.js +0 -41
- package/dist/tooling/cli/development/rebuild.d.ts +0 -13
- package/dist/tooling/cli/development/rebuild.js +0 -58
- package/dist/tooling/cli/development/release-evidence.d.ts +0 -4
- package/dist/tooling/cli/development/release-evidence.js +0 -10
- package/dist/tooling/cli/development/report.d.ts +0 -6
- package/dist/tooling/cli/development/report.js +0 -14
- package/dist/tooling/cli/development/session-file.d.ts +0 -53
- package/dist/tooling/cli/development/session-file.js +0 -337
- package/dist/tooling/cli/development/source-watch.d.ts +0 -14
- package/dist/tooling/cli/development/source-watch.js +0 -140
- package/dist/tooling/cli/development/sources.d.ts +0 -7
- package/dist/tooling/cli/development/sources.js +0 -48
- package/dist/tooling/cli/development/target-lock.d.ts +0 -16
- package/dist/tooling/cli/development/target-lock.js +0 -68
- package/dist/tooling/cli/development/view.d.ts +0 -28
- package/dist/tooling/cli/development/view.js +0 -151
- package/dist/tooling/cli/environment-release.d.ts +0 -21
- package/dist/tooling/cli/environment-release.js +0 -46
- package/dist/tooling/cli/evidence.d.ts +0 -11
- package/dist/tooling/cli/evidence.js +0 -53
- package/dist/tooling/cli/installation/index.d.ts +0 -2
- package/dist/tooling/cli/installation/index.js +0 -1
- package/dist/tooling/cli/installation/observation.d.ts +0 -10
- package/dist/tooling/cli/installation/observation.js +0 -44
- package/dist/tooling/cli/installation/reconcile.d.ts +0 -32
- package/dist/tooling/cli/installation/reconcile.js +0 -122
- package/dist/tooling/linter/implementations/source/migrations.d.ts +0 -2
- package/dist/tooling/linter/implementations/source/migrations.js +0 -113
- package/dist/tooling/linter/qualification/index.d.ts +0 -10
- package/dist/tooling/linter/qualification/index.js +0 -2
- package/dist/tooling/linter/qualification/query-fixtures.d.ts +0 -2
- package/dist/tooling/linter/qualification/query-fixtures.js +0 -68
- package/dist/tooling/linter/qualification/runner.d.ts +0 -3
- package/dist/tooling/linter/qualification/runner.js +0 -6
- /package/dist/application/{application.js → domain.js} +0 -0
- /package/dist/application/{query/single/query.js → mutation/legacy/v6/builder.js} +0 -0
- /package/dist/{deployment/adapter/deploy/context.js → application/mutation/legacy/v6/mutation.js} +0 -0
- /package/dist/application/mutation/{authoring → legacy/v6}/precondition.js +0 -0
- /package/dist/{deployment/adapter/deploy/index.js → application/query/answer/answer.js} +0 -0
- /package/dist/{deployment/adapter/deploy/result.js → application/query/defined/query.js} +0 -0
- /package/dist/{deployment/adapter/prepare/artifact.js → application/query/execution/client.js} +0 -0
- /package/dist/{deployment/adapter/prepare/context.js → application/query/handles/conditions.js} +0 -0
- /package/dist/{deployment/adapter/prepare/index.js → application/query/handles/domain.js} +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/identity.js +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/limits.d.ts +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/limits.js +0 -0
- /package/dist/application/query/{collection → legacy/v6/collection}/metadata.js +0 -0
- /package/dist/application/query/{execution → legacy/v6/execution}/pages.d.ts +0 -0
- /package/dist/application/query/{execution → legacy/v6/execution}/pages.js +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/index.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/index.js +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/node.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/node.js +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/pagination.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/selection.d.ts +0 -0
- /package/dist/application/query/{single → legacy/v6/single}/selection.js +0 -0
- /package/dist/deployment/release/{publication → served}/routes.d.ts +0 -0
- /package/dist/deployment/release/{publication → served}/routes.js +0 -0
- /package/dist/execution/service/{publication → serving}/index.js +0 -0
|
@@ -1,16 +1,18 @@
|
|
|
1
|
-
import type { schema } from '../platform/schema/index.js';
|
|
2
|
-
import type {
|
|
1
|
+
import type { ClassIcon, schema } from '../platform/schema/index.js';
|
|
2
|
+
import type { DomainDefinition } from './domain.js';
|
|
3
3
|
import type { Requirements } from './requirements/index.js';
|
|
4
4
|
import type { Routes } from './routes/index.js';
|
|
5
5
|
import type { Runtime } from './runtime/index.js';
|
|
6
6
|
import type { Frontend } from './view/index.js';
|
|
7
|
-
export interface
|
|
7
|
+
export interface DomainDefinitionInput<Schema extends schema.DomainSchema, RuntimeValue extends Runtime<Schema>, FrontendValue extends Frontend<Schema> | undefined, RoutesValue extends Routes | undefined, RequirementsValue extends Requirements | undefined> {
|
|
8
8
|
readonly schema: Schema;
|
|
9
9
|
readonly runtime: RuntimeValue;
|
|
10
10
|
readonly frontend?: FrontendValue;
|
|
11
11
|
readonly routes?: RoutesValue;
|
|
12
12
|
readonly requirements?: RequirementsValue;
|
|
13
|
+
/** The application's icon, made with `classIcon.svg(...)` or `classIcon.lucide(...)`. */
|
|
14
|
+
readonly icon?: ClassIcon;
|
|
13
15
|
}
|
|
14
|
-
/** Capture one inert authored
|
|
15
|
-
export declare function
|
|
16
|
-
export declare function
|
|
16
|
+
/** Capture one inert authored Domain without resolving, compiling, loading, or deploying it. */
|
|
17
|
+
export declare function defineDomain<const Schema extends schema.DomainSchema, const RuntimeValue extends Runtime<Schema>, const FrontendValue extends Frontend<Schema> | undefined = undefined, const RoutesValue extends Routes | undefined = undefined, const RequirementsValue extends Requirements | undefined = undefined>(input: DomainDefinitionInput<Schema, RuntimeValue, FrontendValue, RoutesValue, RequirementsValue>): DomainDefinition<Schema, RuntimeValue, FrontendValue, RoutesValue, RequirementsValue>;
|
|
18
|
+
export declare function isDomainDefinition(input: unknown): input is DomainDefinition;
|
|
@@ -1,40 +1,54 @@
|
|
|
1
|
+
import { admitClassIconSvg } from '../platform/schema/class-icon-svg.js';
|
|
1
2
|
import { isRequirements } from './requirements/index.js';
|
|
2
3
|
import { isRoutes } from './routes/index.js';
|
|
3
4
|
import { isRuntime } from './runtime/index.js';
|
|
4
5
|
import { isFrontend } from './view/index.js';
|
|
5
|
-
const
|
|
6
|
-
/** Capture one inert authored
|
|
7
|
-
export function
|
|
6
|
+
const admittedDomainDefinitions = new WeakSet();
|
|
7
|
+
/** Capture one inert authored Domain without resolving, compiling, loading, or deploying it. */
|
|
8
|
+
export function defineDomain(input) {
|
|
8
9
|
if (input === null || typeof input !== 'object' || Array.isArray(input))
|
|
9
10
|
invalid();
|
|
10
|
-
const allowed = new Set([
|
|
11
|
+
const allowed = new Set([
|
|
12
|
+
'schema',
|
|
13
|
+
'runtime',
|
|
14
|
+
'frontend',
|
|
15
|
+
'routes',
|
|
16
|
+
'requirements',
|
|
17
|
+
'icon',
|
|
18
|
+
]);
|
|
11
19
|
if (Reflect.ownKeys(input).some((key) => !allowed.has(key)))
|
|
12
20
|
invalid();
|
|
21
|
+
if (typeof input.schema?.name !== 'string') {
|
|
22
|
+
throw new TypeError(`Domain Schema ${String(input.schema?.origin)} must declare its name: defineSchema(origin, { name, ... }).`);
|
|
23
|
+
}
|
|
13
24
|
if (!isRuntime(input.runtime))
|
|
14
|
-
throw new TypeError('
|
|
25
|
+
throw new TypeError('Domain Runtime is not admitted.');
|
|
15
26
|
if (input.frontend !== undefined &&
|
|
16
27
|
(!isFrontend(input.frontend) || input.frontend.schema !== input.schema)) {
|
|
17
|
-
throw new TypeError('
|
|
28
|
+
throw new TypeError('Domain Frontend is not admitted for its exact Schema.');
|
|
18
29
|
}
|
|
19
30
|
if (input.routes !== undefined && !isRoutes(input.routes)) {
|
|
20
|
-
throw new TypeError('
|
|
31
|
+
throw new TypeError('Domain routes are not admitted.');
|
|
21
32
|
}
|
|
22
33
|
if (input.requirements !== undefined && !isRequirements(input.requirements)) {
|
|
23
|
-
throw new TypeError('
|
|
34
|
+
throw new TypeError('Domain requirements are not admitted.');
|
|
24
35
|
}
|
|
25
|
-
|
|
36
|
+
// The same admission as a Node Class icon: one self-contained inline SVG.
|
|
37
|
+
const icon = input.icon === undefined ? undefined : admitClassIconSvg(input.icon);
|
|
38
|
+
const domain = Object.freeze({
|
|
26
39
|
schema: input.schema,
|
|
27
40
|
runtime: input.runtime,
|
|
28
41
|
...(input.frontend === undefined ? {} : { frontend: input.frontend }),
|
|
29
42
|
...(input.routes === undefined ? {} : { routes: input.routes }),
|
|
30
43
|
...(input.requirements === undefined ? {} : { requirements: input.requirements }),
|
|
44
|
+
...(icon === undefined ? {} : { icon }),
|
|
31
45
|
});
|
|
32
|
-
|
|
33
|
-
return
|
|
46
|
+
admittedDomainDefinitions.add(domain);
|
|
47
|
+
return domain;
|
|
34
48
|
}
|
|
35
|
-
export function
|
|
36
|
-
return input !== null && typeof input === 'object' &&
|
|
49
|
+
export function isDomainDefinition(input) {
|
|
50
|
+
return input !== null && typeof input === 'object' && admittedDomainDefinitions.has(input);
|
|
37
51
|
}
|
|
38
52
|
function invalid() {
|
|
39
|
-
throw new TypeError('
|
|
53
|
+
throw new TypeError('Domain definition may contain only schema, runtime, frontend, routes, requirements, and icon.');
|
|
40
54
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export type { DependencyCallOptions, DependencyInvoker, HandlerDependencies } from './invoker.js';
|
|
1
|
+
export type { DependencyBinaryCallOptions, DependencyCallOptions, DependencyInvoker, HandlerDependencies, } from './invoker.js';
|
|
@@ -1,26 +1,37 @@
|
|
|
1
1
|
import type { Binary, Input } from '../../platform/client/index.js';
|
|
2
|
-
import type { SessionRequestOptions } from '../../platform/client/session/index.js';
|
|
2
|
+
import type { ExecutionRef, SessionRequestOptions, SessionRequestOptionsWithBody } from '../../platform/client/session/index.js';
|
|
3
3
|
import type { NodeId } from '../../platform/graph/node/index.js';
|
|
4
|
-
import type { CallableInputOf, CallableOutputOf, CallableResultOf, Domain, ResolvedMethod, KernelSchema, schema } from '../../platform/schema/index.js';
|
|
5
|
-
import type { LocalCallable } from '../action/index.js';
|
|
6
|
-
export type DependencyCallOptions = Pick<SessionRequestOptions, 'timeoutMs' | 'idempotencyKey'>;
|
|
4
|
+
import type { CallableInputOf, CallableInputModeOf, CallableOutputOf, CallableResultOf, Domain, ResolvedFunction, ResolvedMethod, KernelSchema, schema } from '../../platform/schema/index.js';
|
|
5
|
+
import type { AuthorityMode, AuthoritySelection, LocalCallable } from '../action/index.js';
|
|
6
|
+
export type DependencyCallOptions = Pick<SessionRequestOptions, 'timeoutMs' | 'idempotencyKey' | 'body'>;
|
|
7
|
+
export type DependencyBinaryCallOptions = Pick<SessionRequestOptionsWithBody, 'timeoutMs' | 'idempotencyKey' | 'body'>;
|
|
7
8
|
type InstanceMethodOf<D extends Domain> = Extract<LocalCallable<D>, ResolvedMethod<unknown, unknown, false>>;
|
|
8
9
|
type FunctionOrStaticMethodOf<D extends Domain> = Exclude<LocalCallable<D>, ResolvedMethod<unknown, unknown, false>>;
|
|
10
|
+
type WithInputMode<C, Mode extends 'value' | 'binary'> = C extends unknown ? CallableInputModeOf<C> extends Mode ? C : never : never;
|
|
11
|
+
type ValueFunctionOrStaticMethodOf<D extends Domain> = WithInputMode<FunctionOrStaticMethodOf<D>, 'value'>;
|
|
12
|
+
type BinaryFunctionOf<D extends Domain> = WithInputMode<Extract<LocalCallable<D>, ResolvedFunction>, 'binary'>;
|
|
9
13
|
type DependencyInputOf<C> = C extends unknown ? unknown extends CallableInputOf<C> ? Input : [CallableInputOf<C>] extends [void] ? undefined : CallableInputOf<C> : never;
|
|
10
|
-
type
|
|
14
|
+
type HandlerResultOf<C> = unknown extends CallableOutputOf<C> ? unknown : CallableResultOf<C, Binary>;
|
|
15
|
+
/** A durable callable answers with its Execution, as the Kernel Client's typed reference does. */
|
|
16
|
+
type DependencyResultOf<C> = C extends {
|
|
17
|
+
readonly execution: {
|
|
18
|
+
readonly durable: true;
|
|
19
|
+
};
|
|
20
|
+
} ? ExecutionRef<HandlerResultOf<C>> : HandlerResultOf<C>;
|
|
11
21
|
/** One declared dependency, bound to one explicitly selected invocation authority. */
|
|
12
22
|
export interface DependencyInvoker<D extends Domain> {
|
|
13
23
|
readonly invoke: {
|
|
14
|
-
<const C extends
|
|
24
|
+
<const C extends ValueFunctionOrStaticMethodOf<D>>(select: (domain: D) => C, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
|
|
15
25
|
<const C extends InstanceMethodOf<D>>(select: (domain: D) => C, instance: NodeId, input: NoInfer<DependencyInputOf<C>>, options?: DependencyCallOptions): Promise<DependencyResultOf<C>>;
|
|
26
|
+
<const C extends BinaryFunctionOf<D>>(select: (domain: D) => C, metadata: NoInfer<DependencyInputOf<C>>, options: DependencyBinaryCallOptions): Promise<DependencyResultOf<C>>;
|
|
16
27
|
};
|
|
17
28
|
}
|
|
18
29
|
/**
|
|
19
30
|
* Direct Schema aliases with explicit authority selection and no default invoke.
|
|
20
|
-
* self is the executing Domain; caller forwards the incoming
|
|
21
|
-
* The canonical Kernel is exposed through context.kernel.
|
|
31
|
+
* self is the executing Domain; caller forwards the incoming caller Identity, and is absent from a
|
|
32
|
+
* call that carried no credential. The canonical Kernel is exposed through context.kernel.
|
|
22
33
|
*/
|
|
23
|
-
export type HandlerDependencies<D extends Domain> = Readonly<{
|
|
24
|
-
[Alias in keyof D['dependencies'] as D['dependencies'][Alias] extends schema.DomainOf<KernelSchema> ? never : Alias]:
|
|
34
|
+
export type HandlerDependencies<D extends Domain, Authority extends AuthorityMode = AuthorityMode> = Readonly<{
|
|
35
|
+
[Alias in keyof D['dependencies'] as D['dependencies'][Alias] extends schema.DomainOf<KernelSchema> ? never : Alias]: AuthoritySelection<DependencyInvoker<Extract<D['dependencies'][Alias], Domain>>, Authority>;
|
|
25
36
|
}>;
|
|
26
37
|
export {};
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { ClassIcon, schema } from '../platform/schema/index.js';
|
|
2
|
+
import type { Requirements } from './requirements/index.js';
|
|
3
|
+
import type { Routes } from './routes/index.js';
|
|
4
|
+
import type { Runtime, SchemaOfRuntime as RuntimeSchemaOf } from './runtime/index.js';
|
|
5
|
+
import type { Frontend } from './view/index.js';
|
|
6
|
+
declare const DOMAIN_DEFINITION_IDENTITY: unique symbol;
|
|
7
|
+
declare const DOMAIN_DEFINITION_SCHEMA: unique symbol;
|
|
8
|
+
/** Schema-independent type witness shared by every admitted Domain definition. */
|
|
9
|
+
export interface DomainDefinitionIdentity {
|
|
10
|
+
readonly [DOMAIN_DEFINITION_IDENTITY]: true;
|
|
11
|
+
}
|
|
12
|
+
/** Inert source/build composition of one Domain: its exact Schema and authored Runtime. */
|
|
13
|
+
export interface DomainDefinition<Schema extends schema.DomainSchema = schema.DomainSchema, RuntimeValue extends Runtime<Schema> = Runtime<Schema>, FrontendValue extends Frontend<Schema> | undefined = undefined, RoutesValue extends Routes | undefined = undefined, RequirementsValue extends Requirements | undefined = undefined> extends DomainDefinitionIdentity {
|
|
14
|
+
readonly schema: Schema;
|
|
15
|
+
readonly runtime: RuntimeValue;
|
|
16
|
+
readonly frontend?: FrontendValue;
|
|
17
|
+
readonly routes?: RoutesValue;
|
|
18
|
+
readonly requirements?: RequirementsValue;
|
|
19
|
+
/** The application's icon. */
|
|
20
|
+
readonly icon?: ClassIcon;
|
|
21
|
+
readonly [DOMAIN_DEFINITION_SCHEMA]: (schema: Schema) => Schema;
|
|
22
|
+
}
|
|
23
|
+
export type SchemaOfDomainDefinition<Value> = Value extends {
|
|
24
|
+
readonly schema: infer Schema;
|
|
25
|
+
} ? Extract<Schema, schema.DomainSchema> : never;
|
|
26
|
+
export type RuntimeOfDomainDefinition<Value> = Value extends {
|
|
27
|
+
readonly runtime: infer RuntimeValue;
|
|
28
|
+
} ? Extract<RuntimeValue, Runtime> : never;
|
|
29
|
+
export type SchemaOfRuntime<Value> = RuntimeSchemaOf<Value>;
|
|
30
|
+
export {};
|
|
@@ -10,6 +10,8 @@ export interface DeclaredErrorOptions<out Errors extends DeclaredErrors = Declar
|
|
|
10
10
|
export type DeclaredErrorFactory<Errors extends DeclaredErrors> = <Code extends Extract<keyof Errors, string>>(code: Code, details: z.input<Errors[Code]['details']>) => Error;
|
|
11
11
|
interface DeclaredErrorRecord {
|
|
12
12
|
readonly definition: object;
|
|
13
|
+
/** The declaration as written: the object a Function re-declares a Query or Mutation error with. */
|
|
14
|
+
readonly declaration: object;
|
|
13
15
|
readonly code: string;
|
|
14
16
|
readonly family: DeclaredErrorDefinition['family'];
|
|
15
17
|
readonly message: string;
|
|
@@ -17,7 +19,20 @@ interface DeclaredErrorRecord {
|
|
|
17
19
|
}
|
|
18
20
|
/** Retain one implementation-local expected-error contract without publishing it in the Schema. */
|
|
19
21
|
export declare function rememberDeclaredErrors(definition: object, input: unknown): void;
|
|
22
|
+
/**
|
|
23
|
+
* Retain a Query or Mutation's declared errors, as an implementation's are. A Function that declares one of
|
|
24
|
+
* its codes with the same definition object exposes that error to its own caller.
|
|
25
|
+
*/
|
|
26
|
+
export declare function rememberDefinedErrors(defined: object, id: string, input: unknown): void;
|
|
20
27
|
/** Create a receiver-free factory closed over one admitted Action or Workflow definition. */
|
|
21
28
|
export declare function declaredErrorFactory<Errors extends DeclaredErrors>(definition: object): DeclaredErrorFactory<Errors>;
|
|
22
|
-
/**
|
|
29
|
+
/**
|
|
30
|
+
* Return admitted evidence only when the error belongs to the active implementation: raised by it,
|
|
31
|
+
* or by a Query or Mutation whose code it declares with the same definition object.
|
|
32
|
+
*/
|
|
23
33
|
export declare function declaredErrorOf(input: unknown, definition: object): DeclaredErrorRecord | undefined;
|
|
34
|
+
/** The code and the id of a Query or Mutation's declared error, whichever Function it reaches. */
|
|
35
|
+
export declare function definedErrorOf(input: unknown): {
|
|
36
|
+
readonly code: string;
|
|
37
|
+
readonly id: string;
|
|
38
|
+
} | undefined;
|
|
@@ -5,6 +5,8 @@ const MAXIMUM_DETAILS_BYTES = 16 * 1024;
|
|
|
5
5
|
const CODE_PATTERN = /^[A-Z][A-Z0-9_]{0,127}$/u;
|
|
6
6
|
const declarations = new WeakMap();
|
|
7
7
|
const errors = new WeakMap();
|
|
8
|
+
/** The id of each Query or Mutation: their errors cross into a Function that re-declares them. */
|
|
9
|
+
const definedIds = new WeakMap();
|
|
8
10
|
class BusinessError extends Error {
|
|
9
11
|
name = 'BusinessError';
|
|
10
12
|
constructor(code) {
|
|
@@ -25,17 +27,29 @@ export function rememberDeclaredErrors(definition, input) {
|
|
|
25
27
|
for (const [code, candidate] of entries) {
|
|
26
28
|
if (!CODE_PATTERN.test(code))
|
|
27
29
|
throw new TypeError(`Declared error code ${JSON.stringify(code)} is invalid.`);
|
|
28
|
-
accepted.set(code,
|
|
30
|
+
accepted.set(code, {
|
|
31
|
+
accepted: acceptErrorDefinition(candidate, `Declared error ${JSON.stringify(code)}`),
|
|
32
|
+
declaration: candidate,
|
|
33
|
+
});
|
|
29
34
|
}
|
|
30
35
|
declarations.set(definition, accepted);
|
|
31
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* Retain a Query or Mutation's declared errors, as an implementation's are. A Function that declares one of
|
|
39
|
+
* its codes with the same definition object exposes that error to its own caller.
|
|
40
|
+
*/
|
|
41
|
+
export function rememberDefinedErrors(defined, id, input) {
|
|
42
|
+
rememberDeclaredErrors(defined, { errors: input });
|
|
43
|
+
definedIds.set(defined, id);
|
|
44
|
+
}
|
|
32
45
|
/** Create a receiver-free factory closed over one admitted Action or Workflow definition. */
|
|
33
46
|
export function declaredErrorFactory(definition) {
|
|
34
47
|
return ((code, input) => {
|
|
35
|
-
const
|
|
36
|
-
if (
|
|
48
|
+
const declared = declarations.get(definition)?.get(code);
|
|
49
|
+
if (declared === undefined) {
|
|
37
50
|
throw new TypeError(`Business error ${JSON.stringify(code)} is not declared by this implementation.`);
|
|
38
51
|
}
|
|
52
|
+
const { accepted: declaration } = declared;
|
|
39
53
|
const parsed = declaration.details.safeParse(input);
|
|
40
54
|
if (!parsed.success) {
|
|
41
55
|
throw new TypeError(`Business error ${code} details are invalid.`, { cause: parsed.error });
|
|
@@ -56,6 +70,7 @@ export function declaredErrorFactory(definition) {
|
|
|
56
70
|
const error = new BusinessError(code);
|
|
57
71
|
errors.set(error, Object.freeze({
|
|
58
72
|
definition,
|
|
73
|
+
declaration: declared.declaration,
|
|
59
74
|
code,
|
|
60
75
|
family: declaration.family,
|
|
61
76
|
message: declaration.message,
|
|
@@ -64,12 +79,31 @@ export function declaredErrorFactory(definition) {
|
|
|
64
79
|
return error;
|
|
65
80
|
});
|
|
66
81
|
}
|
|
67
|
-
/**
|
|
82
|
+
/**
|
|
83
|
+
* Return admitted evidence only when the error belongs to the active implementation: raised by it,
|
|
84
|
+
* or by a Query or Mutation whose code it declares with the same definition object.
|
|
85
|
+
*/
|
|
68
86
|
export function declaredErrorOf(input, definition) {
|
|
69
87
|
if (!(input instanceof Error))
|
|
70
88
|
return undefined;
|
|
71
89
|
const record = errors.get(input);
|
|
72
|
-
|
|
90
|
+
if (record === undefined)
|
|
91
|
+
return undefined;
|
|
92
|
+
if (record.definition === definition)
|
|
93
|
+
return record;
|
|
94
|
+
if (!definedIds.has(record.definition))
|
|
95
|
+
return undefined;
|
|
96
|
+
return declarations.get(definition)?.get(record.code)?.declaration === record.declaration
|
|
97
|
+
? record
|
|
98
|
+
: undefined;
|
|
99
|
+
}
|
|
100
|
+
/** The code and the id of a Query or Mutation's declared error, whichever Function it reaches. */
|
|
101
|
+
export function definedErrorOf(input) {
|
|
102
|
+
const record = input instanceof Error ? errors.get(input) : undefined;
|
|
103
|
+
if (record === undefined)
|
|
104
|
+
return undefined;
|
|
105
|
+
const id = definedIds.get(record.definition);
|
|
106
|
+
return id === undefined ? undefined : { code: record.code, id };
|
|
73
107
|
}
|
|
74
108
|
function isRecord(input) {
|
|
75
109
|
return input !== null && typeof input === 'object' && !Array.isArray(input);
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export type { DeclaredErrorDefinition, DeclaredErrorFactory, DeclaredErrorFamily, DeclaredErrorOptions, DeclaredErrors, NoDeclaredErrors, } from './error.js';
|
|
2
|
-
export { declaredErrorFactory, declaredErrorOf, rememberDeclaredErrors } from './error.js';
|
|
2
|
+
export { declaredErrorFactory, declaredErrorOf, definedErrorOf, rememberDeclaredErrors, rememberDefinedErrors, } from './error.js';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export { declaredErrorFactory, declaredErrorOf, rememberDeclaredErrors } from './error.js';
|
|
1
|
+
export { declaredErrorFactory, declaredErrorOf, definedErrorOf, rememberDeclaredErrors, rememberDefinedErrors, } from './error.js';
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { Binary } from '../../platform/client/index.js';
|
|
2
|
+
/** The chunks of one downloaded body, and how to give it up unread. */
|
|
3
|
+
export declare function chunksOf(body: Binary['body']): {
|
|
4
|
+
readonly iterable: AsyncIterable<Uint8Array>;
|
|
5
|
+
cancel(): Promise<void>;
|
|
6
|
+
};
|
|
7
|
+
/**
|
|
8
|
+
* A pull-driven web stream over chunks opened on its first read: nothing is downloaded until the
|
|
9
|
+
* consumer reads, and cancelling the stream cancels the download.
|
|
10
|
+
*/
|
|
11
|
+
export declare function readableOf(open: () => Promise<AsyncIterable<Uint8Array>>): ReadableStream<Uint8Array>;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/** The chunks of one downloaded body, and how to give it up unread. */
|
|
2
|
+
export function chunksOf(body) {
|
|
3
|
+
if (body instanceof Uint8Array) {
|
|
4
|
+
return {
|
|
5
|
+
iterable: (async function* () {
|
|
6
|
+
if (body.byteLength > 0)
|
|
7
|
+
yield body;
|
|
8
|
+
})(),
|
|
9
|
+
cancel: async () => { },
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
return {
|
|
13
|
+
iterable: body,
|
|
14
|
+
cancel: async () => {
|
|
15
|
+
// An unread body is given up by asking its iterator to return, as the Client does: the
|
|
16
|
+
// response it reads is then cancelled. The refusal that gave it up is what the reader sees.
|
|
17
|
+
try {
|
|
18
|
+
await body[Symbol.asyncIterator]().return?.();
|
|
19
|
+
}
|
|
20
|
+
catch {
|
|
21
|
+
// Already closed.
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* A pull-driven web stream over chunks opened on its first read: nothing is downloaded until the
|
|
28
|
+
* consumer reads, and cancelling the stream cancels the download.
|
|
29
|
+
*/
|
|
30
|
+
export function readableOf(open) {
|
|
31
|
+
let iterator;
|
|
32
|
+
return new ReadableStream({
|
|
33
|
+
async pull(controller) {
|
|
34
|
+
iterator ??= (await open())[Symbol.asyncIterator]();
|
|
35
|
+
const next = await iterator.next();
|
|
36
|
+
if (next.done === true)
|
|
37
|
+
controller.close();
|
|
38
|
+
else
|
|
39
|
+
controller.enqueue(next.value);
|
|
40
|
+
},
|
|
41
|
+
async cancel() {
|
|
42
|
+
await iterator?.return?.();
|
|
43
|
+
},
|
|
44
|
+
}, { highWaterMark: 0 });
|
|
45
|
+
}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import type { Binary } from '../../platform/client/index.js';
|
|
2
|
+
import type { schema } from '../../platform/schema/index.js';
|
|
3
|
+
/**
|
|
4
|
+
* The most `text()` and `bytes()` hold in memory: 10 MiB (10,485,760 bytes). A larger file is read
|
|
5
|
+
* with `stream()`.
|
|
6
|
+
*/
|
|
7
|
+
export declare const FILE_MEMORY_LIMIT: number;
|
|
8
|
+
/**
|
|
9
|
+
* A file the caller sent in a `file()` input field: the upload receipt it named, and the file's
|
|
10
|
+
* bytes, read on demand from the Kernel with the caller's authority. Each read downloads the file
|
|
11
|
+
* again; nothing is kept between reads.
|
|
12
|
+
*/
|
|
13
|
+
export interface ReceivedFile {
|
|
14
|
+
/**
|
|
15
|
+
* The upload receipt the caller sent. It names the user who uploaded the file and expires one
|
|
16
|
+
* hour after the upload. Until then it serves whoever presents it to the Kernel: this Domain may
|
|
17
|
+
* read or attach it as itself or for its caller.
|
|
18
|
+
*/
|
|
19
|
+
readonly receipt: schema.values.BlobReceipt;
|
|
20
|
+
/**
|
|
21
|
+
* The file's bytes as they arrive, for a file of any size. The Kernel verifies the file's digest
|
|
22
|
+
* when the last chunk arrives, so the stream fails at its end if the bytes differ from what was
|
|
23
|
+
* uploaded: write nothing derived from it anywhere lasting before it ends.
|
|
24
|
+
*/
|
|
25
|
+
stream(): ReadableStream<Uint8Array>;
|
|
26
|
+
/** The file decoded as UTF-8, once all of it arrived and was verified. At most `FILE_MEMORY_LIMIT`. */
|
|
27
|
+
text(): Promise<string>;
|
|
28
|
+
/** The file's bytes, once all of them arrived and were verified. At most `FILE_MEMORY_LIMIT`. */
|
|
29
|
+
bytes(): Promise<Uint8Array>;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* A callable input as its handler receives it: a file object in place of the receipt at each
|
|
33
|
+
* `file()` field.
|
|
34
|
+
*
|
|
35
|
+
* A receipt is a branded string, so it is matched before any other primitive. Every other
|
|
36
|
+
* primitive, branded ids such as `NodeId` included, is left as is: a branded string is also an
|
|
37
|
+
* object type, and mapping over it would map over the string's methods.
|
|
38
|
+
*/
|
|
39
|
+
export type WithFiles<Input> = 0 extends 1 & Input ? Input : Input extends schema.values.BlobReceipt ? ReceivedFile : Input extends string | number | bigint | boolean | symbol | null | undefined ? Input : Input extends object ? {
|
|
40
|
+
[Key in keyof Input]: WithFiles<Input[Key]>;
|
|
41
|
+
} : Input;
|
|
42
|
+
/** What a `file()` field admits, checked when the handler reads the file. */
|
|
43
|
+
export interface FileConstraints {
|
|
44
|
+
readonly maxBytes?: number;
|
|
45
|
+
readonly mediaTypes?: readonly string[];
|
|
46
|
+
}
|
|
47
|
+
/** Why the SDK refused to read a received file. */
|
|
48
|
+
export type FileReadErrorCode =
|
|
49
|
+
/** The file is larger than `FILE_MEMORY_LIMIT`, the most `text()` and `bytes()` hold. */
|
|
50
|
+
'FILE_MEMORY_LIMIT'
|
|
51
|
+
/** The file is larger than its `file()` field's `maxBytes`. */
|
|
52
|
+
| 'FILE_TOO_LARGE'
|
|
53
|
+
/** The file's media type is not one of its `file()` field's `mediaTypes`. */
|
|
54
|
+
| 'FILE_MEDIA_TYPE';
|
|
55
|
+
/**
|
|
56
|
+
* A received file the SDK refused to read. Uncaught by the handler, it reaches the caller as
|
|
57
|
+
* `LIMIT_EXCEEDED` (size) or `VALIDATION_ERROR` (media type), with this code as its reason.
|
|
58
|
+
*/
|
|
59
|
+
export declare class FileReadError extends Error {
|
|
60
|
+
readonly code: FileReadErrorCode;
|
|
61
|
+
/** The JSON Pointer of the field in the callable input, when the file came from one. */
|
|
62
|
+
readonly pointer?: string | undefined;
|
|
63
|
+
readonly name = "FileReadError";
|
|
64
|
+
constructor(code: FileReadErrorCode, message: string,
|
|
65
|
+
/** The JSON Pointer of the field in the callable input, when the file came from one. */
|
|
66
|
+
pointer?: string | undefined);
|
|
67
|
+
}
|
|
68
|
+
/** Where a received file's bytes come from: one download per read. */
|
|
69
|
+
export type FileSource = () => Promise<Binary>;
|
|
70
|
+
export interface ReceivedFileOptions {
|
|
71
|
+
readonly constraints?: FileConstraints;
|
|
72
|
+
readonly pointer?: string;
|
|
73
|
+
}
|
|
74
|
+
/** One file object over a receipt; `source` downloads its bytes, once per read. */
|
|
75
|
+
export declare function receivedFile(receipt: schema.values.BlobReceipt, source: FileSource, options?: ReceivedFileOptions): ReceivedFile;
|
|
76
|
+
/** Whether `value` is a file object the SDK made. */
|
|
77
|
+
export declare function isReceivedFile(value: unknown): value is ReceivedFile;
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import { chunksOf, readableOf } from './binary.js';
|
|
2
|
+
/**
|
|
3
|
+
* The most `text()` and `bytes()` hold in memory: 10 MiB (10,485,760 bytes). A larger file is read
|
|
4
|
+
* with `stream()`.
|
|
5
|
+
*/
|
|
6
|
+
export const FILE_MEMORY_LIMIT = 10 * 1024 * 1024;
|
|
7
|
+
/**
|
|
8
|
+
* A received file the SDK refused to read. Uncaught by the handler, it reaches the caller as
|
|
9
|
+
* `LIMIT_EXCEEDED` (size) or `VALIDATION_ERROR` (media type), with this code as its reason.
|
|
10
|
+
*/
|
|
11
|
+
export class FileReadError extends Error {
|
|
12
|
+
code;
|
|
13
|
+
pointer;
|
|
14
|
+
name = 'FileReadError';
|
|
15
|
+
constructor(code, message,
|
|
16
|
+
/** The JSON Pointer of the field in the callable input, when the file came from one. */
|
|
17
|
+
pointer) {
|
|
18
|
+
super(message);
|
|
19
|
+
this.code = code;
|
|
20
|
+
this.pointer = pointer;
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
const files = new WeakSet();
|
|
24
|
+
/** One file object over a receipt; `source` downloads its bytes, once per read. */
|
|
25
|
+
export function receivedFile(receipt, source, options = {}) {
|
|
26
|
+
if (typeof receipt !== 'string' || receipt.length === 0) {
|
|
27
|
+
throw new TypeError('A received file requires its upload receipt.');
|
|
28
|
+
}
|
|
29
|
+
const { constraints, pointer } = options;
|
|
30
|
+
const open = async (memory) => {
|
|
31
|
+
const binary = await source();
|
|
32
|
+
const opened = openedOf(binary);
|
|
33
|
+
try {
|
|
34
|
+
admitMediaType(binary.mediaType, constraints, pointer);
|
|
35
|
+
if (opened.length !== undefined)
|
|
36
|
+
admitLength(opened.length, constraints, memory, pointer);
|
|
37
|
+
}
|
|
38
|
+
catch (cause) {
|
|
39
|
+
await opened.cancel();
|
|
40
|
+
throw cause;
|
|
41
|
+
}
|
|
42
|
+
return opened;
|
|
43
|
+
};
|
|
44
|
+
const bytes = async () => {
|
|
45
|
+
const opened = await open(FILE_MEMORY_LIMIT);
|
|
46
|
+
const parts = [];
|
|
47
|
+
let total = 0;
|
|
48
|
+
for await (const chunk of bounded(opened.chunks, constraints, FILE_MEMORY_LIMIT, pointer)) {
|
|
49
|
+
parts.push(chunk);
|
|
50
|
+
total += chunk.byteLength;
|
|
51
|
+
}
|
|
52
|
+
if (parts.length === 1)
|
|
53
|
+
return parts[0];
|
|
54
|
+
const joined = new Uint8Array(total);
|
|
55
|
+
let offset = 0;
|
|
56
|
+
for (const part of parts) {
|
|
57
|
+
joined.set(part, offset);
|
|
58
|
+
offset += part.byteLength;
|
|
59
|
+
}
|
|
60
|
+
return joined;
|
|
61
|
+
};
|
|
62
|
+
const value = Object.freeze({
|
|
63
|
+
receipt,
|
|
64
|
+
stream: () => readableOf(async () => {
|
|
65
|
+
const opened = await open();
|
|
66
|
+
return bounded(opened.chunks, constraints, undefined, pointer);
|
|
67
|
+
}),
|
|
68
|
+
bytes,
|
|
69
|
+
text: async () => new TextDecoder().decode(await bytes()),
|
|
70
|
+
});
|
|
71
|
+
files.add(value);
|
|
72
|
+
return value;
|
|
73
|
+
}
|
|
74
|
+
/** Whether `value` is a file object the SDK made. */
|
|
75
|
+
export function isReceivedFile(value) {
|
|
76
|
+
return typeof value === 'object' && value !== null && files.has(value);
|
|
77
|
+
}
|
|
78
|
+
function openedOf(binary) {
|
|
79
|
+
const length = binary.body instanceof Uint8Array ? binary.body.byteLength : streamedLength(binary);
|
|
80
|
+
const chunks = chunksOf(binary.body);
|
|
81
|
+
return {
|
|
82
|
+
...(length === undefined ? {} : { length }),
|
|
83
|
+
chunks: chunks.iterable,
|
|
84
|
+
cancel: chunks.cancel,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
function streamedLength(binary) {
|
|
88
|
+
return 'length' in binary ? binary.length : undefined;
|
|
89
|
+
}
|
|
90
|
+
function admitMediaType(mediaType, constraints, pointer) {
|
|
91
|
+
if (constraints?.mediaTypes === undefined || constraints.mediaTypes.includes(mediaType))
|
|
92
|
+
return;
|
|
93
|
+
throw new FileReadError('FILE_MEDIA_TYPE', `The file's media type ${mediaType} is not one its field admits (${constraints.mediaTypes.join(', ')}).`, pointer);
|
|
94
|
+
}
|
|
95
|
+
function admitLength(length, constraints, memory, pointer) {
|
|
96
|
+
if (constraints?.maxBytes !== undefined && length > constraints.maxBytes) {
|
|
97
|
+
throw new FileReadError('FILE_TOO_LARGE', `The file is larger than the ${constraints.maxBytes} bytes its field admits.`, pointer);
|
|
98
|
+
}
|
|
99
|
+
if (memory !== undefined && length > memory) {
|
|
100
|
+
throw new FileReadError('FILE_MEMORY_LIMIT', `The file is larger than the ${memory} bytes text() and bytes() hold in memory: read it with stream().`, pointer);
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
/** The chunks of `source`, refused as soon as they run past a bound whatever length was declared. */
|
|
104
|
+
async function* bounded(source, constraints, memory, pointer) {
|
|
105
|
+
let total = 0;
|
|
106
|
+
for await (const chunk of source) {
|
|
107
|
+
total += chunk.byteLength;
|
|
108
|
+
admitLength(total, constraints, memory, pointer);
|
|
109
|
+
yield chunk;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export { FILE_MEMORY_LIMIT, FileReadError, isReceivedFile, receivedFile } from './file.js';
|
|
2
|
+
export type { FileConstraints, FileReadErrorCode, FileSource, ReceivedFile, ReceivedFileOptions, WithFiles, } from './file.js';
|
|
3
|
+
export { filePositionsOf, withFiles } from './input.js';
|
|
4
|
+
export type { FilePosition } from './input.js';
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import * as values from '@astrale-os/kernel-dsl/v1/schema/values';
|
|
2
|
+
import type { schema } from '../../platform/schema/index.js';
|
|
3
|
+
import type { ResolvedCallable } from '../action/context.js';
|
|
4
|
+
import type { ReceivedFile } from './file.js';
|
|
5
|
+
/** Where a callable's input holds a `file()` field, and what the field states about its file. */
|
|
6
|
+
export type FilePosition = values.FilePosition;
|
|
7
|
+
/** Every position of a `file()` field in the input of `callable`, binary metadata included. */
|
|
8
|
+
export declare function filePositionsOf(callable: ResolvedCallable): readonly FilePosition[];
|
|
9
|
+
/**
|
|
10
|
+
* `input` with a file object, made by `fileOf`, in place of the receipt at each `file()` field.
|
|
11
|
+
* Nothing else is copied: only the objects and arrays on the way to a file are new.
|
|
12
|
+
*/
|
|
13
|
+
export declare function withFiles(positions: readonly FilePosition[], input: unknown, fileOf: (receipt: schema.values.BlobReceipt, located: values.LocatedFile) => ReceivedFile): unknown;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { isBinaryInput } from '@astrale-os/kernel-dsl/v1/language';
|
|
2
|
+
import * as values from '@astrale-os/kernel-dsl/v1/schema/values';
|
|
3
|
+
const positionsByCallable = new WeakMap();
|
|
4
|
+
/** Every position of a `file()` field in the input of `callable`, binary metadata included. */
|
|
5
|
+
export function filePositionsOf(callable) {
|
|
6
|
+
const known = positionsByCallable.get(callable);
|
|
7
|
+
if (known !== undefined)
|
|
8
|
+
return known;
|
|
9
|
+
const contract = isBinaryInput(callable.input) ? callable.input.metadata : callable.input;
|
|
10
|
+
const positions = values.filePositions(contract);
|
|
11
|
+
positionsByCallable.set(callable, positions);
|
|
12
|
+
return positions;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* `input` with a file object, made by `fileOf`, in place of the receipt at each `file()` field.
|
|
16
|
+
* Nothing else is copied: only the objects and arrays on the way to a file are new.
|
|
17
|
+
*/
|
|
18
|
+
export function withFiles(positions, input, fileOf) {
|
|
19
|
+
if (positions.length === 0)
|
|
20
|
+
return input;
|
|
21
|
+
let result = input;
|
|
22
|
+
for (const located of values.locateFiles(positions, input)) {
|
|
23
|
+
if (typeof located.value !== 'string')
|
|
24
|
+
continue;
|
|
25
|
+
const file = fileOf(located.value, located);
|
|
26
|
+
result = replaceAt(result, input, tokensOf(located.pointer), file);
|
|
27
|
+
}
|
|
28
|
+
return result;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* `target` with `value` at `tokens`. A container still shared with `original` is copied before it
|
|
32
|
+
* changes, so the admitted input is never written.
|
|
33
|
+
*/
|
|
34
|
+
function replaceAt(target, original, tokens, value) {
|
|
35
|
+
if (tokens.length === 0)
|
|
36
|
+
return value;
|
|
37
|
+
const [token, ...rest] = tokens;
|
|
38
|
+
if (Array.isArray(target)) {
|
|
39
|
+
const index = Number(token);
|
|
40
|
+
const copy = target === original ? [...target] : target;
|
|
41
|
+
copy[index] = replaceAt(target[index], original[index], rest, value);
|
|
42
|
+
return copy;
|
|
43
|
+
}
|
|
44
|
+
const source = target;
|
|
45
|
+
const copy = target === original ? { ...source } : source;
|
|
46
|
+
copy[token] = replaceAt(source[token], original?.[token], rest, value);
|
|
47
|
+
return copy;
|
|
48
|
+
}
|
|
49
|
+
/** The reference tokens of an RFC 6901 JSON Pointer. */
|
|
50
|
+
function tokensOf(pointer) {
|
|
51
|
+
if (pointer === '')
|
|
52
|
+
return [];
|
|
53
|
+
return pointer
|
|
54
|
+
.slice(1)
|
|
55
|
+
.split('/')
|
|
56
|
+
.map((token) => token.replaceAll('~1', '/').replaceAll('~0', '~'));
|
|
57
|
+
}
|