@spine-event-engine/server 2.0.0-snapshot.23 → 2.0.0-snapshot.25
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 +38 -11
- package/REFERENCE.md +278 -141
- package/dist/agent/agent-acceptance-receipts.d.ts +69 -0
- package/dist/agent/agent-acceptance-receipts.d.ts.map +1 -0
- package/dist/agent/agent-acceptance-receipts.js +198 -0
- package/dist/agent/agent-acceptance-receipts.js.map +1 -0
- package/dist/agent/agent-execution-capacity.d.ts +37 -9
- package/dist/agent/agent-execution-capacity.d.ts.map +1 -1
- package/dist/agent/agent-execution-capacity.js +73 -15
- package/dist/agent/agent-execution-capacity.js.map +1 -1
- package/dist/agent/agent-history.d.ts +15 -10
- package/dist/agent/agent-history.d.ts.map +1 -1
- package/dist/agent/agent-history.js +26 -14
- package/dist/agent/agent-history.js.map +1 -1
- package/dist/agent/agent-live-ai-audit.d.ts +95 -0
- package/dist/agent/agent-live-ai-audit.d.ts.map +1 -0
- package/dist/agent/agent-live-ai-audit.js +290 -0
- package/dist/agent/agent-live-ai-audit.js.map +1 -0
- package/dist/agent/agent-live-ai-runtime.d.ts +300 -0
- package/dist/agent/agent-live-ai-runtime.d.ts.map +1 -0
- package/dist/agent/agent-live-ai-runtime.js +611 -0
- package/dist/agent/agent-live-ai-runtime.js.map +1 -0
- package/dist/agent/agent-live-audit.d.ts +67 -0
- package/dist/agent/agent-live-audit.d.ts.map +1 -0
- package/dist/agent/agent-live-audit.js +121 -0
- package/dist/agent/agent-live-audit.js.map +1 -0
- package/dist/agent/agent-live-budget.d.ts +84 -0
- package/dist/agent/agent-live-budget.d.ts.map +1 -0
- package/dist/agent/agent-live-budget.js +161 -0
- package/dist/agent/agent-live-budget.js.map +1 -0
- package/dist/agent/agent-live-fault.d.ts +18 -0
- package/dist/agent/agent-live-fault.d.ts.map +1 -0
- package/dist/agent/{agent-execution-fault.js → agent-live-fault.js} +7 -7
- package/dist/agent/agent-live-fault.js.map +1 -0
- package/dist/agent/agent-live-inputs.d.ts +74 -0
- package/dist/agent/agent-live-inputs.d.ts.map +1 -0
- package/dist/agent/agent-live-inputs.js +15 -0
- package/dist/agent/agent-live-inputs.js.map +1 -0
- package/dist/agent/agent-live-interaction-events.d.ts +46 -0
- package/dist/agent/agent-live-interaction-events.d.ts.map +1 -0
- package/dist/agent/agent-live-interaction-events.js +104 -0
- package/dist/agent/agent-live-interaction-events.js.map +1 -0
- package/dist/agent/agent-live-mcp-controls.d.ts +129 -0
- package/dist/agent/agent-live-mcp-controls.d.ts.map +1 -0
- package/dist/agent/agent-live-mcp-controls.js +228 -0
- package/dist/agent/agent-live-mcp-controls.js.map +1 -0
- package/dist/agent/agent-live-mcp-host.d.ts +88 -0
- package/dist/agent/agent-live-mcp-host.d.ts.map +1 -0
- package/dist/agent/{agent-mcp-host.js → agent-live-mcp-host.js} +1 -1
- package/dist/agent/agent-live-mcp-host.js.map +1 -0
- package/dist/agent/{agent-mcp-runtime.d.ts → agent-live-mcp-runtime.d.ts} +6 -6
- package/dist/agent/agent-live-mcp-runtime.d.ts.map +1 -0
- package/dist/agent/{agent-mcp-runtime.js → agent-live-mcp-runtime.js} +13 -42
- package/dist/agent/agent-live-mcp-runtime.js.map +1 -0
- package/dist/agent/agent-live-read-runtime.d.ts +61 -0
- package/dist/agent/agent-live-read-runtime.d.ts.map +1 -0
- package/dist/agent/agent-live-read-runtime.js +121 -0
- package/dist/agent/agent-live-read-runtime.js.map +1 -0
- package/dist/agent/agent-model-selection.d.ts +21 -34
- package/dist/agent/agent-model-selection.d.ts.map +1 -1
- package/dist/agent/agent-model-selection.js +61 -78
- package/dist/agent/agent-model-selection.js.map +1 -1
- package/dist/bus/command-bus.d.ts +14 -18
- package/dist/bus/command-bus.d.ts.map +1 -1
- package/dist/bus/command-bus.js +31 -48
- package/dist/bus/command-bus.js.map +1 -1
- package/dist/bus/event-bus.d.ts +82 -104
- package/dist/bus/event-bus.d.ts.map +1 -1
- package/dist/bus/event-bus.js +87 -127
- package/dist/bus/event-bus.js.map +1 -1
- package/dist/context/bounded-context.d.ts +143 -91
- package/dist/context/bounded-context.d.ts.map +1 -1
- package/dist/context/bounded-context.js +753 -359
- package/dist/context/bounded-context.js.map +1 -1
- package/dist/context/entity-inbox.d.ts +7 -2
- package/dist/context/entity-inbox.d.ts.map +1 -1
- package/dist/context/entity-inbox.js +43 -20
- package/dist/context/entity-inbox.js.map +1 -1
- package/dist/context/local-inbox-handoff.d.ts +35 -34
- package/dist/context/local-inbox-handoff.d.ts.map +1 -1
- package/dist/context/local-inbox-handoff.js +123 -135
- package/dist/context/local-inbox-handoff.js.map +1 -1
- package/dist/context/projection-handoff.d.ts +2 -2
- package/dist/context/projection-handoff.d.ts.map +1 -1
- package/dist/context/projection-handoff.js +12 -8
- package/dist/context/projection-handoff.js.map +1 -1
- package/dist/context/tenant-index.d.ts +36 -31
- package/dist/context/tenant-index.d.ts.map +1 -1
- package/dist/context/tenant-index.js +123 -125
- package/dist/context/tenant-index.js.map +1 -1
- package/dist/context/tenant-unknown-error.d.ts +33 -0
- package/dist/context/tenant-unknown-error.d.ts.map +1 -0
- package/dist/context/tenant-unknown-error.js +75 -0
- package/dist/context/tenant-unknown-error.js.map +1 -0
- package/dist/delivery/agent-delivery-scope.d.ts +66 -0
- package/dist/delivery/agent-delivery-scope.d.ts.map +1 -0
- package/dist/delivery/agent-delivery-scope.js +44 -0
- package/dist/delivery/agent-delivery-scope.js.map +1 -0
- package/dist/delivery/delivery-builder.d.ts +25 -1
- package/dist/delivery/delivery-builder.d.ts.map +1 -1
- package/dist/delivery/delivery-builder.js +89 -0
- package/dist/delivery/delivery-builder.js.map +1 -1
- package/dist/delivery/delivery-monitor.d.ts +12 -9
- package/dist/delivery/delivery-monitor.d.ts.map +1 -1
- package/dist/delivery/delivery-monitor.js +15 -9
- package/dist/delivery/delivery-monitor.js.map +1 -1
- package/dist/delivery/delivery-ports.d.ts +6 -13
- package/dist/delivery/delivery-ports.d.ts.map +1 -1
- package/dist/delivery/delivery-run-control.d.ts +21 -0
- package/dist/delivery/delivery-run-control.d.ts.map +1 -1
- package/dist/delivery/delivery-run-control.js +10 -0
- package/dist/delivery/delivery-run-control.js.map +1 -1
- package/dist/delivery/delivery-supervisor.d.ts +33 -5
- package/dist/delivery/delivery-supervisor.d.ts.map +1 -1
- package/dist/delivery/delivery-supervisor.js +178 -26
- package/dist/delivery/delivery-supervisor.js.map +1 -1
- package/dist/delivery/delivery-tenant.d.ts +17 -0
- package/dist/delivery/delivery-tenant.d.ts.map +1 -0
- package/dist/delivery/delivery-tenant.js +50 -0
- package/dist/delivery/delivery-tenant.js.map +1 -0
- package/dist/delivery/delivery.d.ts +96 -2
- package/dist/delivery/delivery.d.ts.map +1 -1
- package/dist/delivery/delivery.js +803 -89
- package/dist/delivery/delivery.js.map +1 -1
- package/dist/delivery/inbox-records.d.ts.map +1 -1
- package/dist/delivery/inbox-records.js +9 -16
- package/dist/delivery/inbox-records.js.map +1 -1
- package/dist/delivery/inbox-storage.d.ts +14 -11
- package/dist/delivery/inbox-storage.d.ts.map +1 -1
- package/dist/delivery/inbox-storage.js +72 -78
- package/dist/delivery/inbox-storage.js.map +1 -1
- package/dist/delivery/inbox.d.ts +9 -12
- package/dist/delivery/inbox.d.ts.map +1 -1
- package/dist/delivery/inbox.js +13 -15
- package/dist/delivery/inbox.js.map +1 -1
- package/dist/delivery/reception-observation.d.ts +64 -0
- package/dist/delivery/reception-observation.d.ts.map +1 -0
- package/dist/delivery/reception-observation.js +78 -0
- package/dist/delivery/reception-observation.js.map +1 -0
- package/dist/delivery/sharded-work-registry.d.ts +6 -0
- package/dist/delivery/sharded-work-registry.d.ts.map +1 -1
- package/dist/delivery/sharded-work-registry.js +41 -4
- package/dist/delivery/sharded-work-registry.js.map +1 -1
- package/dist/entity/entity-storage-descriptor.d.ts.map +1 -1
- package/dist/entity/entity-storage-descriptor.js +7 -4
- package/dist/entity/entity-storage-descriptor.js.map +1 -1
- package/dist/index.d.ts +4 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/integration/external-messages.d.ts.map +1 -1
- package/dist/integration/external-messages.js +9 -15
- package/dist/integration/external-messages.js.map +1 -1
- package/dist/integration/integration-broker.d.ts.map +1 -1
- package/dist/integration/integration-broker.js +112 -6
- package/dist/integration/integration-broker.js.map +1 -1
- package/dist/integration/third-party-context.d.ts.map +1 -1
- package/dist/integration/third-party-context.js +7 -10
- package/dist/integration/third-party-context.js.map +1 -1
- package/dist/repository/primitive-id.js +26 -11
- package/dist/repository/primitive-id.js.map +1 -1
- package/dist/repository/repository.d.ts +33 -62
- package/dist/repository/repository.d.ts.map +1 -1
- package/dist/repository/repository.js +1475 -1827
- package/dist/repository/repository.js.map +1 -1
- package/dist/runtime/runtime.d.ts +24 -0
- package/dist/runtime/runtime.d.ts.map +1 -1
- package/dist/runtime/runtime.js +31 -0
- package/dist/runtime/runtime.js.map +1 -1
- package/dist/runtime/signal-metadata.d.ts.map +1 -1
- package/dist/runtime/signal-metadata.js +8 -15
- package/dist/runtime/signal-metadata.js.map +1 -1
- package/dist/runtime/signal-publisher.d.ts +8 -36
- package/dist/runtime/signal-publisher.d.ts.map +1 -1
- package/dist/runtime/signal-publisher.js +68 -61
- package/dist/runtime/signal-publisher.js.map +1 -1
- package/dist/runtime/standalone-handler-runtime.d.ts +0 -7
- package/dist/runtime/standalone-handler-runtime.d.ts.map +1 -1
- package/dist/runtime/standalone-handler-runtime.js +14 -130
- package/dist/runtime/standalone-handler-runtime.js.map +1 -1
- package/dist/server/managed-delivery-gate.d.ts +34 -0
- package/dist/server/managed-delivery-gate.d.ts.map +1 -0
- package/dist/server/managed-delivery-gate.js +70 -0
- package/dist/server/managed-delivery-gate.js.map +1 -0
- package/dist/server/managed-server-application.d.ts +2 -2
- package/dist/server/managed-server-application.d.ts.map +1 -1
- package/dist/server/managed-server-application.js +471 -178
- package/dist/server/managed-server-application.js.map +1 -1
- package/dist/server/node-coordinator.d.ts +14 -0
- package/dist/server/node-coordinator.d.ts.map +1 -1
- package/dist/server/node-coordinator.js +266 -45
- package/dist/server/node-coordinator.js.map +1 -1
- package/dist/server/server-environment.d.ts +203 -25
- package/dist/server/server-environment.d.ts.map +1 -1
- package/dist/server/server-environment.js +661 -133
- package/dist/server/server-environment.js.map +1 -1
- package/dist/server/server-log.d.ts +7 -0
- package/dist/server/server-log.d.ts.map +1 -1
- package/dist/server/server-log.js +18 -1
- package/dist/server/server-log.js.map +1 -1
- package/dist/server/server.d.ts +18 -32
- package/dist/server/server.d.ts.map +1 -1
- package/dist/server/server.js +62 -203
- package/dist/server/server.js.map +1 -1
- package/dist/services/spine-services.d.ts +1 -1
- package/dist/services/spine-services.d.ts.map +1 -1
- package/dist/services/spine-services.js +399 -370
- package/dist/services/spine-services.js.map +1 -1
- package/dist/stand/event-origin-filter.d.ts +16 -0
- package/dist/stand/event-origin-filter.d.ts.map +1 -0
- package/dist/stand/event-origin-filter.js +124 -0
- package/dist/stand/event-origin-filter.js.map +1 -0
- package/dist/stand/stand.d.ts +14 -0
- package/dist/stand/stand.d.ts.map +1 -1
- package/dist/stand/stand.js +53 -9
- package/dist/stand/stand.js.map +1 -1
- package/dist/stand/subscription-observer.d.ts.map +1 -1
- package/dist/stand/subscription-observer.js +61 -40
- package/dist/stand/subscription-observer.js.map +1 -1
- package/dist/stand/subscription-registry.d.ts +6 -2
- package/dist/stand/subscription-registry.d.ts.map +1 -1
- package/dist/stand/subscription-registry.js +15 -11
- package/dist/stand/subscription-registry.js.map +1 -1
- package/dist/stand/subscription-runtime.d.ts +23 -4
- package/dist/stand/subscription-runtime.d.ts.map +1 -1
- package/dist/stand/subscription-runtime.js +84 -13
- package/dist/stand/subscription-runtime.js.map +1 -1
- package/dist/testing/index.d.ts.map +1 -1
- package/dist/testing/index.js +3 -2
- package/dist/testing/index.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +15 -15
- package/dist/agent/agent-admission.d.ts +0 -80
- package/dist/agent/agent-admission.d.ts.map +0 -1
- package/dist/agent/agent-admission.js +0 -127
- package/dist/agent/agent-admission.js.map +0 -1
- package/dist/agent/agent-ai-runtime.d.ts +0 -76
- package/dist/agent/agent-ai-runtime.d.ts.map +0 -1
- package/dist/agent/agent-ai-runtime.js +0 -1269
- package/dist/agent/agent-ai-runtime.js.map +0 -1
- package/dist/agent/agent-execution-fault.d.ts +0 -18
- package/dist/agent/agent-execution-fault.d.ts.map +0 -1
- package/dist/agent/agent-execution-fault.js.map +0 -1
- package/dist/agent/agent-execution-session.d.ts +0 -103
- package/dist/agent/agent-execution-session.d.ts.map +0 -1
- package/dist/agent/agent-execution-session.js +0 -238
- package/dist/agent/agent-execution-session.js.map +0 -1
- package/dist/agent/agent-interaction-audit.d.ts +0 -58
- package/dist/agent/agent-interaction-audit.d.ts.map +0 -1
- package/dist/agent/agent-interaction-audit.js +0 -114
- package/dist/agent/agent-interaction-audit.js.map +0 -1
- package/dist/agent/agent-interaction-events.d.ts +0 -40
- package/dist/agent/agent-interaction-events.d.ts.map +0 -1
- package/dist/agent/agent-interaction-events.js +0 -129
- package/dist/agent/agent-interaction-events.js.map +0 -1
- package/dist/agent/agent-mcp-budget.d.ts +0 -125
- package/dist/agent/agent-mcp-budget.d.ts.map +0 -1
- package/dist/agent/agent-mcp-budget.js +0 -566
- package/dist/agent/agent-mcp-budget.js.map +0 -1
- package/dist/agent/agent-mcp-host.d.ts +0 -125
- package/dist/agent/agent-mcp-host.d.ts.map +0 -1
- package/dist/agent/agent-mcp-host.js.map +0 -1
- package/dist/agent/agent-mcp-runtime.d.ts.map +0 -1
- package/dist/agent/agent-mcp-runtime.js.map +0 -1
- package/dist/agent/agent-read-runtime.d.ts +0 -70
- package/dist/agent/agent-read-runtime.d.ts.map +0 -1
- package/dist/agent/agent-read-runtime.js +0 -320
- package/dist/agent/agent-read-runtime.js.map +0 -1
- package/dist/agent/agent-revisions.d.ts +0 -35
- package/dist/agent/agent-revisions.d.ts.map +0 -1
- package/dist/agent/agent-revisions.js +0 -133
- package/dist/agent/agent-revisions.js.map +0 -1
- package/dist/agent/agent-scheduler.d.ts +0 -99
- package/dist/agent/agent-scheduler.d.ts.map +0 -1
- package/dist/agent/agent-scheduler.js +0 -398
- package/dist/agent/agent-scheduler.js.map +0 -1
- package/dist/bus/saved-dispatcher-binding.d.ts +0 -96
- package/dist/bus/saved-dispatcher-binding.d.ts.map +0 -1
- package/dist/bus/saved-dispatcher-binding.js +0 -35
- package/dist/bus/saved-dispatcher-binding.js.map +0 -1
- package/dist/delivery/delivery-run-coordinator.d.ts +0 -218
- package/dist/delivery/delivery-run-coordinator.d.ts.map +0 -1
- package/dist/delivery/delivery-run-coordinator.js +0 -609
- package/dist/delivery/delivery-run-coordinator.js.map +0 -1
- package/dist/delivery/parked-delivery-obligations.d.ts +0 -182
- package/dist/delivery/parked-delivery-obligations.d.ts.map +0 -1
- package/dist/delivery/parked-delivery-obligations.js +0 -390
- package/dist/delivery/parked-delivery-obligations.js.map +0 -1
- package/dist/server/environment-attachment.d.ts +0 -356
- package/dist/server/environment-attachment.d.ts.map +0 -1
- package/dist/server/environment-attachment.js +0 -2062
- package/dist/server/environment-attachment.js.map +0 -1
- package/dist/server/environment-delivery-records.d.ts +0 -77
- package/dist/server/environment-delivery-records.d.ts.map +0 -1
- package/dist/server/environment-delivery-records.js +0 -282
- package/dist/server/environment-delivery-records.js.map +0 -1
- package/dist/server/environment-delivery-worker.d.ts +0 -161
- package/dist/server/environment-delivery-worker.d.ts.map +0 -1
- package/dist/server/environment-delivery-worker.js +0 -673
- package/dist/server/environment-delivery-worker.js.map +0 -1
|
@@ -1,11 +1,15 @@
|
|
|
1
1
|
import { type StorageFactory } from "@spine-event-engine/storage";
|
|
2
|
+
import type { TenantId } from "@spine-event-engine/proto";
|
|
2
3
|
import { type ILogLayer } from "loglayer";
|
|
3
4
|
import { type TransportFactory } from "@spine-event-engine/transport";
|
|
4
5
|
import { type TypeRegistryLookup } from "@spine-event-engine/core";
|
|
6
|
+
import type { AiRegistry } from "@spine-event-engine/ai";
|
|
7
|
+
import { Delivery as CoreDelivery } from "../delivery/delivery.js";
|
|
8
|
+
import type { Delivery as PublicDelivery, DeliveryStrategy } from "../delivery/delivery-builder.js";
|
|
5
9
|
import { type BoundedContext } from "../context/bounded-context.js";
|
|
10
|
+
import { type TenantIndex } from "../context/tenant-index.js";
|
|
6
11
|
import type { DeliveryInbox, DeliveryWorkRegistry } from "../delivery/delivery-ports.js";
|
|
7
12
|
import type { DeliverySource } from "../delivery/delivery-supervisor.js";
|
|
8
|
-
import { type EnvironmentAttachOptions, type EnvironmentAttachmentHandle, type EnvironmentGenerationWorker } from "./environment-attachment.js";
|
|
9
13
|
import { Environment, EnvironmentType } from "./environment.js";
|
|
10
14
|
/**
|
|
11
15
|
* Common closeable facility owned by a server environment.
|
|
@@ -19,21 +23,21 @@ export interface ServerEnvironmentCloseable {
|
|
|
19
23
|
close(): unknown;
|
|
20
24
|
}
|
|
21
25
|
/**
|
|
22
|
-
* A closeable environment facility that
|
|
26
|
+
* A closeable environment facility that opens before shared Delivery setup.
|
|
23
27
|
*/
|
|
24
28
|
export interface ServerEnvironmentDelivery extends ServerEnvironmentCloseable {
|
|
25
29
|
/**
|
|
26
|
-
* Opens the facility before the environment
|
|
30
|
+
* Opens the facility before the environment starts shared Delivery.
|
|
27
31
|
*
|
|
28
32
|
* @returns An optional asynchronous open operation.
|
|
29
33
|
*/
|
|
30
34
|
open(): unknown;
|
|
31
35
|
/**
|
|
32
|
-
* Supplies the
|
|
36
|
+
* Supplies the Inbox port used by shared environment Delivery.
|
|
33
37
|
*/
|
|
34
38
|
readonly inbox: DeliveryInbox;
|
|
35
39
|
/**
|
|
36
|
-
* Supplies the shard work-registry port used by environment
|
|
40
|
+
* Supplies the shard work-registry port used by shared environment Delivery.
|
|
37
41
|
*/
|
|
38
42
|
readonly workRegistry: DeliveryWorkRegistry;
|
|
39
43
|
/**
|
|
@@ -45,6 +49,14 @@ export interface ServerEnvironmentDelivery extends ServerEnvironmentCloseable {
|
|
|
45
49
|
* Facilities configured for one Node environment type.
|
|
46
50
|
*/
|
|
47
51
|
export interface ServerEnvironmentSettings {
|
|
52
|
+
/**
|
|
53
|
+
* Live default membership index for Bounded Contexts.
|
|
54
|
+
*/
|
|
55
|
+
readonly tenantIndex?: TenantIndex;
|
|
56
|
+
/**
|
|
57
|
+
* Default AI registry for Bounded Contexts without a local override.
|
|
58
|
+
*/
|
|
59
|
+
readonly ai?: AiRegistry;
|
|
48
60
|
/**
|
|
49
61
|
* Storage facility selected for server assembly, including server-added context builders.
|
|
50
62
|
*/
|
|
@@ -62,9 +74,15 @@ export interface ServerEnvironmentSettings {
|
|
|
62
74
|
*/
|
|
63
75
|
readonly typeRegistry?: TypeRegistryLookup;
|
|
64
76
|
/**
|
|
65
|
-
* Optional closeable
|
|
77
|
+
* Optional closeable Delivery port facility supplied during environment setup.
|
|
78
|
+
* A remote facility may also provide `open`, `inbox`, `workRegistry`, and `source`.
|
|
79
|
+
* The environment constructs its shared public Delivery separately.
|
|
66
80
|
*/
|
|
67
|
-
readonly delivery?: ServerEnvironmentCloseable;
|
|
81
|
+
readonly delivery?: ServerEnvironmentCloseable | ServerEnvironmentDelivery;
|
|
82
|
+
/**
|
|
83
|
+
* Maps targets to shards for every context in this environment.
|
|
84
|
+
*/
|
|
85
|
+
readonly deliveryStrategy?: DeliveryStrategy;
|
|
68
86
|
/**
|
|
69
87
|
* Optional tracing factory placeholder for later tracing adapters.
|
|
70
88
|
*/
|
|
@@ -99,6 +117,14 @@ export declare class ServerEnvironment implements ServerEnvironmentCloseable {
|
|
|
99
117
|
* Storage facility selected for server assembly, including server-added context builders.
|
|
100
118
|
*/
|
|
101
119
|
readonly storageFactory: StorageFactory;
|
|
120
|
+
/**
|
|
121
|
+
* Live default tenant membership index.
|
|
122
|
+
*/
|
|
123
|
+
readonly tenantIndex: TenantIndex;
|
|
124
|
+
/**
|
|
125
|
+
* Default AI registry selected for Bounded Context assembly, when configured.
|
|
126
|
+
*/
|
|
127
|
+
readonly ai: AiRegistry | undefined;
|
|
102
128
|
/**
|
|
103
129
|
* Message-channel factory selected for private bounded-context integration.
|
|
104
130
|
*
|
|
@@ -112,13 +138,20 @@ export declare class ServerEnvironment implements ServerEnvironmentCloseable {
|
|
|
112
138
|
*/
|
|
113
139
|
readonly typeRegistry: TypeRegistryLookup;
|
|
114
140
|
/**
|
|
115
|
-
*
|
|
141
|
+
* Returns the actual shared Delivery after explicit environment setup.
|
|
142
|
+
* @returns The one public Delivery facade for this environment.
|
|
116
143
|
*/
|
|
117
|
-
|
|
144
|
+
get delivery(): PublicDelivery;
|
|
118
145
|
/**
|
|
119
146
|
* Optional tracing factory selected for this environment.
|
|
120
147
|
*/
|
|
121
148
|
readonly tracerFactory: ServerEnvironmentCloseable | undefined;
|
|
149
|
+
/**
|
|
150
|
+
* Initializes resolved environment facilities.
|
|
151
|
+
*
|
|
152
|
+
* @param environment Selected process environment.
|
|
153
|
+
* @param settings Resolved facilities and settings.
|
|
154
|
+
*/
|
|
122
155
|
private constructor();
|
|
123
156
|
/**
|
|
124
157
|
* Sets facilities for an environment type before first resolution.
|
|
@@ -136,14 +169,39 @@ export declare class ServerEnvironment implements ServerEnvironmentCloseable {
|
|
|
136
169
|
*/
|
|
137
170
|
static instance(): ServerEnvironment;
|
|
138
171
|
/**
|
|
139
|
-
*
|
|
172
|
+
* Checks shared storage and initializes transport and Delivery before context startup.
|
|
140
173
|
*
|
|
141
|
-
*
|
|
142
|
-
|
|
143
|
-
|
|
174
|
+
* @returns The coalesced setup attempt for this environment lifetime.
|
|
175
|
+
*/
|
|
176
|
+
completeSetup(): Promise<void>;
|
|
177
|
+
/**
|
|
178
|
+
* Creates declared structures for the completed open contexts in this environment.
|
|
179
|
+
* Explicit IDs select matching multitenant contexts through their effective indexes.
|
|
180
|
+
* Database-backed providers require an existing database; this method does not
|
|
181
|
+
* provision one or register tenants.
|
|
182
|
+
* @param tenantIds Optional complete tenant identities; absence includes single-tenant
|
|
183
|
+
* contexts and pages current multitenant indexes.
|
|
184
|
+
* @returns Completion after participating contexts are prepared.
|
|
185
|
+
*/
|
|
186
|
+
createStorageStructures(...tenantIds: TenantId[]): Promise<void>;
|
|
187
|
+
/**
|
|
188
|
+
* Checks existing structures without authorizing creation.
|
|
189
|
+
* Explicit IDs select matching multitenant contexts through their effective indexes.
|
|
190
|
+
* The operation does not provision databases or register tenants.
|
|
191
|
+
* @param tenantIds Optional complete tenant identities; absence includes single-tenant
|
|
192
|
+
* contexts and pages current multitenant indexes.
|
|
193
|
+
* @returns Completion after participating contexts pass read-only checks.
|
|
194
|
+
*/
|
|
195
|
+
checkStructureCompatibility(...tenantIds: TenantId[]): Promise<void>;
|
|
196
|
+
/**
|
|
197
|
+
* Closes this environment after all Bounded Contexts close.
|
|
144
198
|
*
|
|
145
|
-
*
|
|
199
|
+
* A healthy environment with active contexts rejects without teardown. After
|
|
200
|
+
* required startup failure, this joins automatic cleanup and rejects with the
|
|
201
|
+
* original cause and any cleanup failures. Successful closure prevents reuse;
|
|
202
|
+
* failed facility closes during an ordinary close remain retryable.
|
|
146
203
|
*
|
|
204
|
+
* @returns Completion after facilities close or a rejection reporting failures.
|
|
147
205
|
*/
|
|
148
206
|
close(): Promise<void>;
|
|
149
207
|
}
|
|
@@ -156,18 +214,138 @@ export declare const ServerEnvironmentLifecycle: {
|
|
|
156
214
|
readonly resetForTest: () => Promise<void>;
|
|
157
215
|
};
|
|
158
216
|
interface ServerEnvironmentAccess {
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
217
|
+
/**
|
|
218
|
+
* Returns the retained runtime behind the public Delivery facade.
|
|
219
|
+
* @param environment Resolved environment after explicit setup.
|
|
220
|
+
* @returns The one shared Delivery core.
|
|
221
|
+
*/
|
|
222
|
+
coreDelivery(environment: ServerEnvironment): CoreDelivery;
|
|
223
|
+
/**
|
|
224
|
+
* Returns whether setup installed a remote Delivery supervisor.
|
|
225
|
+
* @param environment Resolved environment after setup.
|
|
226
|
+
* @returns True only for a supervised remote source.
|
|
227
|
+
*/
|
|
228
|
+
remoteSupervised(environment: ServerEnvironment): boolean;
|
|
229
|
+
/**
|
|
230
|
+
* Waits for admitted environment Delivery work without closing the facility.
|
|
231
|
+
* @param environment Resolved environment.
|
|
232
|
+
* @returns Completion after active shard runs settle.
|
|
233
|
+
*/
|
|
234
|
+
whenDeliveryIdle(environment: ServerEnvironment): Promise<void>;
|
|
235
|
+
/**
|
|
236
|
+
* Notifies the single environment Delivery about a newly eligible shard.
|
|
237
|
+
* @param environment Resolved environment.
|
|
238
|
+
* @param shard Physical shared shard.
|
|
239
|
+
*/
|
|
240
|
+
notifyDelivery(environment: ServerEnvironment, shard: import("../delivery/shard-index.js").ShardIndex): void;
|
|
241
|
+
/**
|
|
242
|
+
* Waits for explicitly started shared setup before a context assembles.
|
|
243
|
+
* @param environment Resolved environment.
|
|
244
|
+
* @returns Shared setup completion or a missing-setup error.
|
|
245
|
+
*/
|
|
246
|
+
awaitSetup(environment: ServerEnvironment): Promise<void>;
|
|
247
|
+
/**
|
|
248
|
+
* Records a build before asynchronous model discovery.
|
|
249
|
+
*
|
|
250
|
+
* @param environment Resolved environment.
|
|
251
|
+
* @returns Callback that marks this build settled.
|
|
252
|
+
*/
|
|
253
|
+
beginContextBuild(environment: ServerEnvironment): () => void;
|
|
254
|
+
/**
|
|
255
|
+
* Marks the environment unavailable after a required startup failure.
|
|
256
|
+
*
|
|
257
|
+
* @param environment Environment whose required phase failed.
|
|
258
|
+
* @param cause Original provider, monitor, or transport error.
|
|
259
|
+
*/
|
|
260
|
+
failStartup(environment: ServerEnvironment, cause: unknown): void;
|
|
261
|
+
/**
|
|
262
|
+
* Waits for the automatic cleanup and reports original and cleanup failures.
|
|
263
|
+
* @param environment Failed environment.
|
|
264
|
+
* @returns Rejection after cleanup settles.
|
|
265
|
+
*/
|
|
266
|
+
awaitStartupFailure(environment: ServerEnvironment): Promise<never>;
|
|
267
|
+
/**
|
|
268
|
+
* Checks whether a required startup phase already failed.
|
|
269
|
+
* @param environment Resolved environment.
|
|
270
|
+
* @returns Whether automatic fatal cleanup is active.
|
|
271
|
+
*/
|
|
272
|
+
hasStartupFailure(environment: ServerEnvironment): boolean;
|
|
273
|
+
/**
|
|
274
|
+
* Records a local rollback error without treating it as a new startup cause.
|
|
275
|
+
* @param environment Failed environment.
|
|
276
|
+
* @param error Local rollback failure.
|
|
277
|
+
*/
|
|
278
|
+
recordStartupCleanup(environment: ServerEnvironment, error: unknown): void;
|
|
279
|
+
/**
|
|
280
|
+
* Checks the synchronous startup admission fence.
|
|
281
|
+
* @param environment Resolved environment.
|
|
282
|
+
*/
|
|
283
|
+
requireAvailable(environment: ServerEnvironment): void;
|
|
284
|
+
/**
|
|
285
|
+
* Records a constructed context, including an empty one.
|
|
286
|
+
*
|
|
287
|
+
* @param environment Resolved environment.
|
|
288
|
+
* @param context Constructed context.
|
|
289
|
+
*/
|
|
290
|
+
addContext(environment: ServerEnvironment, context: BoundedContext): void;
|
|
291
|
+
/**
|
|
292
|
+
* Marks a constructed context ready after integration opens.
|
|
293
|
+
*
|
|
294
|
+
* @param environment Resolved environment.
|
|
295
|
+
* @param context Ready context.
|
|
296
|
+
* @returns Completion after recipient registration and supervisor start.
|
|
297
|
+
*/
|
|
298
|
+
completeContext(environment: ServerEnvironment, context: BoundedContext): Promise<void>;
|
|
299
|
+
/**
|
|
300
|
+
* Registers a state type and returns a conflicting domain context, if any.
|
|
301
|
+
*
|
|
302
|
+
* @param environment Resolved environment.
|
|
303
|
+
* @param context Context declaring the state.
|
|
304
|
+
* @param typeUrl Full Entity state type URL.
|
|
305
|
+
* @returns A conflicting context, if one exists.
|
|
306
|
+
*/
|
|
307
|
+
reserveState(environment: ServerEnvironment, context: BoundedContext, typeUrl: string): BoundedContext | undefined;
|
|
308
|
+
/**
|
|
309
|
+
* Stops only this context's fresh shared-recipient selection.
|
|
310
|
+
* @param environment Environment registering recipients.
|
|
311
|
+
* @param context Context entering close.
|
|
312
|
+
*/
|
|
313
|
+
stopRecipients(environment: ServerEnvironment, context: BoundedContext): void;
|
|
314
|
+
/**
|
|
315
|
+
* Removes a context after its recipients have stopped.
|
|
316
|
+
*
|
|
317
|
+
* @param environment Resolved environment.
|
|
318
|
+
* @param context Closed context.
|
|
319
|
+
*/
|
|
320
|
+
removeContext(environment: ServerEnvironment, context: BoundedContext): void;
|
|
321
|
+
/**
|
|
322
|
+
* Returns zero or one domain context names serving a state type.
|
|
323
|
+
*
|
|
324
|
+
* @param environment Resolved environment.
|
|
325
|
+
* @param typeUrl Full Entity state type URL.
|
|
326
|
+
* @returns Matching context names.
|
|
327
|
+
*/
|
|
328
|
+
contextsServing(environment: ServerEnvironment, typeUrl: string): readonly string[];
|
|
329
|
+
/**
|
|
330
|
+
* Lists actual open contexts for explicit test cleanup and internal inspection.
|
|
331
|
+
*
|
|
332
|
+
* @param environment Resolved environment.
|
|
333
|
+
* @returns Current context references.
|
|
334
|
+
*/
|
|
335
|
+
openContexts(environment: ServerEnvironment): readonly BoundedContext[];
|
|
336
|
+
/**
|
|
337
|
+
* Returns the environment logger.
|
|
338
|
+
*
|
|
339
|
+
* @param environment Resolved server environment.
|
|
340
|
+
* @returns Its configured logger.
|
|
341
|
+
*/
|
|
170
342
|
loggerFor(environment: ServerEnvironment): ILogLayer;
|
|
343
|
+
/**
|
|
344
|
+
* Records a warning when a production context uses a volatile registry.
|
|
345
|
+
*
|
|
346
|
+
* @param environment Resolved server environment.
|
|
347
|
+
* @param context Context whose registry is inspected.
|
|
348
|
+
*/
|
|
171
349
|
warnVolatileRegistry(environment: ServerEnvironment, context: BoundedContext): void;
|
|
172
350
|
}
|
|
173
351
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server-environment.d.ts","sourceRoot":"","sources":["../../src/server/server-environment.ts"],"names":[],"mappings":"AAcA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;
|
|
1
|
+
{"version":3,"file":"server-environment.d.ts","sourceRoot":"","sources":["../../src/server/server-environment.ts"],"names":[],"mappings":"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"}
|