@spine-event-engine/server 2.0.0-snapshot.11

package/dist/runtime/standalone-handler-runtime.js

@@ -0,0 +1,307 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+var _a;
+import { clone, create } from "@bufbuild/protobuf";
+import { AnyMessages, RejectionThrowable } from "@spine-event-engine/core";
+import { CommandContextSchema, CommandSchema, EventContextSchema, EventSchema, RejectionEventContextSchema, } from "@spine-event-engine/proto";
+import * as EntityLog from "@spine-event-engine/proto/generated/spine/system/server/entity_log_events_pb.js";
+import { EventDispatcherOriginSchemas } from "../bus/event-dispatcher-origin-schemas.js";
+import { DeclaredRejections } from "../handler/declared-rejections.js";
+import { EventHandlerFilters, } from "../handler/event-handler-filter.js";
+import { SignalMetadata } from "./signal-metadata.js";
+import { SignalPublisher } from "./signal-publisher.js";
+/**
+ * Materializes generated standalone receivers without treating them as Entities.
+ *
+ * @internal
+ */
+export class StandaloneHandlerRuntime {
+    #publisher;
+    #metadata = new SignalMetadata();
+    #bindings;
+    #eventFilters;
+    /**
+     * Creates runtime bindings for registered standalone receivers.
+     *
+     * @param receivers Generated receiver groups with their application instances and publisher.
+     */
+    constructor(receivers) {
+        this.#publisher = receivers[0]?.publisher ?? _a.missingPublisher();
+        this.#bindings = Object.freeze(receivers.flatMap(({ group, instance }) => group.handlers.map((handler) => _a.bind(group, instance, handler))));
+        this.#eventFilters = _a.eventFilters(this.#bindings);
+    }
+    /**
+     * Creates a dispatcher for standalone Command receptors.
+     *
+     * @returns The dispatcher, or `undefined` when no Command receptor is bound.
+     */
+    commandDispatcher() {
+        const bindings = this.#bindings.filter((binding) => binding.handler.kind === "command-assignment" ||
+            binding.handler.kind === "command-substitution");
+        if (bindings.length === 0)
+            return undefined;
+        return {
+            messageSchemas: () => Object.freeze(_a.schemas(bindings)),
+            dispatch: async (command) => this.#dispatchCommand(command, bindings),
+        };
+    }
+    /**
+     * Creates a dispatcher for standalone Event receptors.
+     *
+     * @returns The dispatcher, or `undefined` when no Event receptor is bound.
+     */
+    eventDispatcher() {
+        const bindings = this.#bindings.filter((binding) => binding.handler.kind === "command-reaction" ||
+            binding.handler.kind === "event-reaction" ||
+            binding.handler.kind === "event-subscription");
+        if (bindings.length === 0)
+            return undefined;
+        const dispatcher = {
+            messageSchemas: () => Object.freeze(_a.schemas(bindings)),
+            externalEventSchemas: () => Object.freeze(_a.schemas(bindings.filter(({ handler }) => handler.input.origin === "external"))),
+            dispatch: async (event) => this.#dispatchEvent(event, bindings),
+        };
+        return EventDispatcherOriginSchemas.define(dispatcher, _a.schemas(bindings.filter(({ handler }) => handler.input.origin === "domestic")), _a.schemas(bindings.filter(({ handler }) => handler.input.origin === "external")));
+    }
+    /**
+     * Creates a System Event Bus dispatcher for standalone state subscribers.
+     *
+     * @returns The dispatcher, or `undefined` when no state subscriber is bound.
+     */
+    stateDispatcher() {
+        const bindings = this.#bindings.filter(({ handler }) => handler.kind === "state-subscription");
+        if (bindings.length === 0)
+            return undefined;
+        return {
+            messageSchemas: () => Object.freeze([EntityLog.EntityStateChangedSchema]),
+            dispatch: async (event) => {
+                const changed = event.message === undefined
+                    ? undefined
+                    : AnyMessages.unpack(event.message, EntityLog.EntityStateChangedSchema);
+                if (changed?.newState === undefined)
+                    return;
+                for (const binding of bindings) {
+                    const state = AnyMessages.unpack(changed.newState, binding.handler.input.schema);
+                    if (state !== undefined) {
+                        const output = await binding.invoke(state, _a.eventContext(event));
+                        await this.#publish(binding, output, event);
+                    }
+                }
+            },
+        };
+    }
+    async #dispatchCommand(command, bindings) {
+        if (command.message === undefined)
+            throw new Error("Standalone command handler requires a message.");
+        for (const binding of bindings) {
+            const message = AnyMessages.unpack(command.message, binding.handler.input.schema);
+            if (message === undefined)
+                continue;
+            let output;
+            try {
+                output = await binding.invoke(message, _a.commandContext(command));
+            }
+            catch (error) {
+                if (!RejectionThrowable.is(error))
+                    throw error;
+                DeclaredRejections.require(binding.handler.methodName, binding.handler.outcomes.thrown, error);
+                await this.#publishRejection(command, error);
+                continue;
+            }
+            await this.#publish(binding, output, command);
+        }
+    }
+    async #dispatchEvent(event, bindings) {
+        if (event.message === undefined)
+            throw new Error("Standalone event handler requires a message.");
+        const origin = event.context?.external === true ? "external" : "domestic";
+        for (const [key, filter] of this.#eventFilters) {
+            const binding = bindings.find((candidate) => _a.eventFilterKey(candidate.handler.input.schema.typeName, origin) === key);
+            if (binding === undefined)
+                continue;
+            const message = AnyMessages.unpack(event.message, binding.handler.input.schema);
+            if (message === undefined)
+                continue;
+            for (const selected of filter.select(message)) {
+                const output = await selected.invoke(message, _a.eventContext(event));
+                await this.#publish(selected, output, event);
+            }
+        }
+    }
+    #publish(binding, output, source) {
+        const values = _a.#outputValues(output);
+        if (!this.#canPublish(binding, values))
+            return Promise.resolve();
+        for (const value of values)
+            this.#publishValue(binding, value, source);
+        return Promise.resolve();
+    }
+    #canPublish(binding, values) {
+        const subscriber = binding.handler.kind === "event-subscription" ||
+            binding.handler.kind === "state-subscription";
+        if (subscriber && values.length !== 0)
+            throw new Error(`Standalone subscriber "${binding.handler.methodName}" must not return signals.`);
+        if (!subscriber &&
+            (binding.handler.kind === "command-assignment" ||
+                binding.handler.kind === "command-substitution") &&
+            values.length === 0)
+            throw new Error(`Standalone ${binding.handler.kind} "${binding.handler.methodName}" must return a signal.`);
+        return !subscriber;
+    }
+    #publishValue(binding, value, source) {
+        const schema = binding.handler.outcomes.returned.find((candidate) => value.$typeName === candidate.typeName);
+        if (schema === undefined)
+            throw new Error(`Standalone handler "${binding.handler.methodName}" returned an undeclared signal.`);
+        if (binding.handler.kind === "command-substitution" ||
+            binding.handler.kind === "command-reaction") {
+            this.#publishCommand(schema, value, source);
+        }
+        else
+            this.#publishEvent(schema, value, source);
+    }
+    #publishCommand(schema, value, source) {
+        const metadata = "uuid" in (source.id ?? {})
+            ? this.#metadata.commandFromCommand(source)
+            : this.#metadata.commandFromEvent(source);
+        void this.#publisher.publishCommand(create(CommandSchema, {
+            id: metadata.id,
+            context: metadata.context,
+            message: AnyMessages.pack(schema, value),
+        }));
+    }
+    #publishEvent(schema, value, source) {
+        const metadata = "uuid" in (source.id ?? {})
+            ? this.#metadata.eventFromCommand(source, {})
+            : this.#metadata.eventFromEvent(source, {});
+        void this.#publisher.publishEvent(create(EventSchema, {
+            id: metadata.id,
+            context: metadata.context,
+            message: AnyMessages.pack(schema, value),
+        }));
+    }
+    async #publishRejection(command, rejection) {
+        const metadata = this.#metadata.eventFromCommand(command, {});
+        await this.#publisher.publishRejectionEvent(create(EventSchema, {
+            id: metadata.id,
+            message: AnyMessages.pack(rejection.schema, rejection.messageThrown()),
+            context: create(EventContextSchema, {
+                ...metadata.context,
+                rejection: create(RejectionEventContextSchema, {
+                    command: clone(CommandSchema, command),
+                    stacktrace: rejection.stack ?? "",
+                }),
+            }),
+        }));
+    }
+    /**
+     * Normalizes optional handler output into a list of values.
+     *
+     * @param output A handler result that may be absent, singular, or an array.
+     * @returns An empty list for nullish output; otherwise the array or a single-item list.
+     */
+    static #outputValues(output) {
+        return output === undefined || output === null ? [] : Array.isArray(output) ? output : [output];
+    }
+    /**
+     * Binds one generated handler declaration to its standalone application instance.
+     *
+     * @param group The generated receiver group.
+     * @param instance The registered application instance.
+     * @param handler The generated handler declaration.
+     * @returns The immutable runtime binding.
+     */
+    static bind(group, instance, handler) {
+        const method = instance[handler.methodName];
+        if (typeof method !== "function")
+            throw new TypeError(`Standalone receiver is missing method "${handler.methodName}".`);
+        return Object.freeze({
+            group,
+            handler,
+            invoke: (message, context) => Reflect.apply(method, instance, handler.parameterCount === 2 ? [message, context] : [message]),
+        });
+    }
+    /**
+     * Lists distinct signal schemas used by bindings.
+     *
+     * @param bindings The bindings to inspect.
+     * @returns Distinct signal schemas in binding order.
+     */
+    static schemas(bindings) {
+        return [
+            ...new Map(bindings.map(({ handler }) => [handler.input.schema.typeName, handler.input.schema])).values(),
+        ];
+    }
+    /**
+     * Builds Event filters for standalone Event receptors.
+     *
+     * @param bindings The bindings to organize.
+     * @returns Filter plans keyed by signal schema and origin.
+     */
+    static eventFilters(bindings) {
+        const eventBindings = bindings.filter(({ handler }) => handler.kind === "command-reaction" ||
+            handler.kind === "event-reaction" ||
+            handler.kind === "event-subscription");
+        const grouped = Map.groupBy(eventBindings, ({ handler }) => _a.eventFilterKey(handler.input.schema.typeName, handler.input.origin));
+        return new Map([...grouped].map(([typeName, candidates]) => [
+            typeName,
+            EventHandlerFilters.compile(candidates.map(({ handler, ...binding }) => ({
+                value: Object.freeze({ handler, ...binding }),
+                schema: handler.input.schema,
+                ...(handler.input.where === undefined ? {} : { where: handler.input.where }),
+            }))),
+        ]));
+    }
+    /**
+     * Copies a Command context or creates its generated default.
+     *
+     * @param command The Command that provides the context.
+     * @returns An independent Command context.
+     */
+    static commandContext(command) {
+        return command.context === undefined
+            ? create(CommandContextSchema)
+            : clone(CommandContextSchema, command.context);
+    }
+    /**
+     * Copies an Event context or creates its generated default.
+     *
+     * @param event The Event that provides the context.
+     * @returns An independent Event context.
+     */
+    static eventContext(event) {
+        return event.context === undefined
+            ? create(EventContextSchema)
+            : clone(EventContextSchema, event.context);
+    }
+    /**
+     * Creates a key for one Event schema and origin.
+     *
+     * @param typeName The Event schema type name.
+     * @param origin The required Event origin.
+     * @returns The filter-map key.
+     */
+    static eventFilterKey(typeName, origin) {
+        return `${typeName}\u0000${origin}`;
+    }
+    /**
+     * Throws for a missing publisher during invalid runtime construction.
+     *
+     * @returns This method never returns because it throws.
+     */
+    static missingPublisher() {
+        throw new Error("Standalone handler runtime requires a SignalPublisher.");
+    }
+}
+_a = StandaloneHandlerRuntime;
+//# sourceMappingURL=standalone-handler-runtime.js.map

package/dist/runtime/standalone-handler-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-handler-runtime.js","sourceRoot":"","sources":["../../src/runtime/standalone-handler-runtime.ts"],"names":[],"mappings":"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"}

package/dist/server/environment-attachment.d.ts

@@ -0,0 +1,356 @@
+import type { ContextDeliveryDescriptor } from "../context/bounded-context.js";
+import type { DeliveryReady } from "../context/local-inbox-handoff.js";
+import type { EnvironmentDeliveryPorts } from "../context/local-inbox-handoff.js";
+import { type DeliveryRunScope, type DeliveryRunSettlement } from "../delivery/delivery-run-coordinator.js";
+import { ParkedDeliveryObligations, type ParkedDeliveryObligationRecord } from "../delivery/parked-delivery-obligations.js";
+import { type EnvironmentGenerationWorker } from "./environment-delivery-worker.js";
+import type { ILogLayer } from "loglayer";
+export type { EnvironmentGenerationWorker } from "./environment-delivery-worker.js";
+/**
+ * Identifies whether a caller or server owns an environment registration.
+ *
+ * @internal
+ */
+export type EnvironmentOwnership = "caller" | "server";
+/**
+ * Represents one current, non-retired environment generation.
+ *
+ * @internal
+ */
+export interface EnvironmentGeneration {
+    /**
+     * Marks values that represent an environment generation.
+     */
+    readonly generation: true;
+}
+/**
+ * Represents one environment attachment reservation.
+ *
+ * @internal
+ */
+export interface EnvironmentRegistrationClaim {
+    /**
+     * Identifies the reservation within its generation.
+     */
+    readonly token: string;
+    /**
+     * Identifies the generation that owns the reservation.
+     */
+    readonly generation: EnvironmentGeneration;
+}
+/**
+ * Defines the ownership and descriptors needed to attach an environment.
+ *
+ * @internal
+ */
+export interface EnvironmentAttachOptions {
+    /**
+     * Selects caller or server ownership.
+     */
+    readonly ownership: EnvironmentOwnership;
+    /**
+     * Lists context delivery descriptors to attach.
+     */
+    readonly descriptors: readonly ContextDeliveryDescriptor[];
+}
+declare class AttachedEnvironmentRegistration implements EnvironmentRegistrationClaim {
+    #private;
+    readonly startup: DeliveryRunSettlement;
+    readonly token: string;
+    constructor(claim: EnvironmentRegistrationClaim, binding: RegistrationBinding, startup: DeliveryRunSettlement, records: () => readonly ParkedDeliveryObligationRecord[]);
+    get generation(): EnvironmentGeneration;
+    records(): readonly ParkedDeliveryObligationRecord[];
+}
+/**
+ * Identifies a successfully attached environment registration.
+ *
+ * @internal
+ */
+export type EnvironmentAttachmentHandle = AttachedEnvironmentRegistration;
+/**
+ * Defines construction seams for deterministic lifecycle tests.
+ *
+ * @internal
+ */
+export interface EnvironmentAttachmentsOptions {
+    /**
+     * Creates a generation worker when an attachment opens a generation.
+     *
+     * @returns The worker for the new generation.
+     */
+    readonly createWorker?: () => EnvironmentGenerationWorker;
+    /**
+     * Immutable environment logger child propagated to each delivery runtime.
+     */
+    readonly logger?: ILogLayer;
+    /**
+     * Resolves the environment-owned delivery ports after its facility opens.
+     *
+     * @returns The selected remote ports, or `undefined` for local delivery.
+     */
+    readonly deliveryPorts?: () => EnvironmentDeliveryPorts | undefined;
+    /**
+     * Calls the retained lifecycle failure reporter.
+     *
+     * @param causes Lists the failures to report.
+     * @returns A promise that settles after the failures are reported.
+     */
+    readonly report?: (causes: readonly unknown[]) => Promise<void>;
+    /**
+     * Injects transition faults used by lifecycle tests.
+     */
+    readonly transitionFaults?: {
+        readonly onRoutePrepare?: (descriptor: ContextDeliveryDescriptor) => void;
+        readonly onScopeTransfer?: (descriptor: ContextDeliveryDescriptor, sources: readonly TransitionScopeSource[]) => void;
+    };
+}
+/**
+ * Tracks registration ownership and generations for one server environment.
+ *
+ * @internal
+ */
+export declare class EnvironmentRegistrations {
+    #private;
+    /**
+     * Returns the number of active claims.
+     *
+     * @returns The active claim count.
+     */
+    get count(): number;
+    /**
+     * Returns the active generation, if any.
+     *
+     * @returns The current generation or `undefined`.
+     */
+    get generation(): EnvironmentGeneration | undefined;
+    /**
+     * Sets the current generation during a safe handoff.
+     *
+     * @param generation Supplies the replacement generation.
+     * @returns The retired generation.
+     */
+    replace(generation: EnvironmentGeneration): EnvironmentGeneration;
+    /**
+     * Creates a registration claim in the current generation.
+     *
+     * @param ownership Selects caller or server ownership.
+     * @returns The new opaque registration claim.
+     */
+    claim(ownership: EnvironmentOwnership): EnvironmentRegistrationClaim;
+    /**
+     * Removes one failed attachment without disturbing sibling claims.
+     *
+     * @internal
+     * @param token Identifies the claim.
+     * @returns The remaining claim count.
+     */
+    remove(token: string): number;
+    /**
+     * Clears an empty generation after its retirement is safe.
+     *
+     * @internal
+     * @param generation Identifies the generation to clear.
+     */
+    clear(generation: EnvironmentGeneration): void;
+}
+/**
+ * Coordinates generation attachment, detachment, recovery, and retirement for one environment.
+ *
+ * @internal
+ */
+export declare class EnvironmentAttachments {
+    #private;
+    /**
+     * Creates an attachment owner.
+     * @param options Optionally supplies lifecycle test seams.
+     */
+    constructor(options?: EnvironmentAttachmentsOptions);
+    /**
+     * Returns the number of bounded unresolved diagnostics.
+     *
+     * @internal
+     * @returns The unresolved count.
+     */
+    get unresolvedReportedDomainCount(): number;
+    /**
+     * Returns the number of live registrations.
+     *
+     * @internal
+     * @returns The active registration count.
+     */
+    get activeRegistrationCount(): number;
+    /**
+     * Returns the number of configured delivery owners.
+     *
+     * @internal
+     * @returns The configured owner count.
+     */
+    get configuredOwnerCount(): number;
+    /**
+     * Returns the number of configured delivery scopes.
+     *
+     * @internal
+     * @returns The configured scope count.
+     */
+    get configuredScopeCount(): number;
+    /**
+     * Checks whether a failed attachment owns unfinished rollback.
+     *
+     * @internal
+     * @returns Whether rollback remains.
+     */
+    get failedStartPending(): boolean;
+    /**
+     * Checks whether a rejection owns failed-start rollback retry.
+     *
+     * @internal
+     * @param error Supplies the rejection.
+     * @returns Whether retry is required.
+     */
+    failedStartRetryPending(error: unknown): boolean;
+    /**
+     * Checks whether detachment made an endpoint safe.
+     *
+     * @internal
+     * @param attachment Identifies the attachment.
+     * @returns Whether the endpoint is safe.
+     */
+    endpointSafe(attachment: EnvironmentAttachmentHandle): boolean;
+    /**
+     * Checks whether an attachment owns rejected detach work.
+     *
+     * @internal
+     * @param attachment Identifies the attachment.
+     * @returns Whether detach retry is pending.
+     */
+    detachRetryPending(attachment: EnvironmentAttachmentHandle): boolean;
+    /**
+     * Attaches configured descriptors to an environment generation.
+     *
+     * @param options Supplies ownership and descriptors.
+     * @returns The successful attachment handle.
+     */
+    attach(options: EnvironmentAttachOptions): Promise<EnvironmentAttachmentHandle>;
+    /**
+     * Stops delivery work while preserving a retryable failed stop.
+     *
+     * @returns A promise that settles after delivery work stops.
+     */
+    stopDelivery(): Promise<void>;
+    /**
+     * Retries a previously rejected delivery stop.
+     *
+     * @returns A promise that settles after the stop retry completes.
+     */
+    retryDeliveryStop(): Promise<void>;
+    /**
+     * Accepts permanent close after all active registrations retire.
+     *
+     * @internal
+     * @returns A promise that resolves after permanent close is admitted.
+     */
+    admitPermanentClose(): Promise<void>;
+    /**
+     * Removes one attached registration.
+     *
+     * @param attachment Identifies the attachment to detach.
+     * @returns A promise that settles after the attachment detaches.
+     */
+    detach(attachment: EnvironmentAttachmentHandle): Promise<void>;
+    /**
+     * Retries rejected detachment for one attachment.
+     *
+     * @param attachment Identifies the attachment to retry.
+     * @returns A promise that settles after the detach retry completes.
+     */
+    retryDetach(attachment: EnvironmentAttachmentHandle): Promise<void>;
+    /**
+     * Retries rollback following a rejected attachment start.
+     *
+     * @returns A promise that settles after failed-start rollback retries.
+     */
+    retryFailedStart(): Promise<void>;
+}
+interface RegistrationBinding {
+    generation: EnvironmentGeneration;
+}
+type TransitionScopeSource = "configured" | "startup" | "buffered" | "retained";
+/**
+ * Buffers descriptor readiness while one attachment transitions between generations.
+ *
+ * @internal
+ */
+export declare class RegistrationReadiness {
+    #private;
+    /**
+     * Creates readiness buffering for configured descriptors.
+     *
+     * @param descriptors Supplies descriptors and their initial scopes.
+     * @param onPrepare Converts a readiness notification into a scope.
+     * @param onNotify Delivers an opened scope to its generation.
+     */
+    constructor(descriptors: readonly {
+        readonly descriptor: ContextDeliveryDescriptor;
+        readonly scopes: readonly DeliveryRunScope[];
+    }[], onPrepare: (descriptor: ContextDeliveryDescriptor, ready: DeliveryReady) => DeliveryRunScope, onNotify: (scope: DeliveryRunScope) => void);
+    /**
+     * Records or forwards one endpoint readiness notification.
+     *
+     * @param descriptor Identifies the reporting descriptor.
+     * @param ready Supplies the ready endpoint.
+     */
+    notify(descriptor: ContextDeliveryDescriptor, ready: DeliveryReady): void;
+    /**
+     * Clears readiness and discards buffered notifications.
+     */
+    fail(): void;
+    /**
+     * Prepares notification buffering for a generation transition.
+     *
+     * @param onBuffered Receives notifications buffered during the transition.
+     */
+    prepareTransition(onBuffered: (descriptor: ContextDeliveryDescriptor, ready: DeliveryReady) => void): void;
+    /**
+     * Updates every descriptor for a replacement generation.
+     *
+     * @param onPrepare Converts readiness into replacement scopes.
+     * @param onNotify Delivers opened replacement scopes.
+     */
+    rebind(onPrepare: (descriptor: ContextDeliveryDescriptor, ready: DeliveryReady) => DeliveryRunScope, onNotify: (scope: DeliveryRunScope) => void): void;
+    /**
+     * Updates one descriptor for a replacement generation.
+     *
+     * @param descriptor Identifies the descriptor to rebind.
+     * @param onPrepare Converts readiness into replacement scopes.
+     * @param onNotify Delivers opened replacement scopes.
+     */
+    rebindDescriptor(descriptor: ContextDeliveryDescriptor, onPrepare: (descriptor: ContextDeliveryDescriptor, ready: DeliveryReady) => DeliveryRunScope, onNotify: (scope: DeliveryRunScope) => void): void;
+    /**
+     * Opens readiness and returns initial plus buffered scopes.
+     *
+     * @param startup Supplies scopes recovered during startup.
+     * @returns Immutable scopes to run or notify.
+     */
+    open(startup: readonly DeliveryRunScope[]): readonly DeliveryRunScope[];
+}
+/**
+ * Exposes the registration-assembly evidence seam used by direct server tests.
+ * @internal
+ */
+export interface EnvironmentAttachmentAccess {
+    /**
+     * Converts a finite startup settlement into registration-scoped parked evidence.
+     *
+     * @param token Identifies the registration.
+     * @param scopes Supplies configured startup scopes.
+     * @param settlement Supplies the finite recovery settlement.
+     * @returns Parked-obligation evidence for the registration.
+     */
+    startupObligations(token: string, scopes: readonly DeliveryRunScope[], settlement: DeliveryRunSettlement): ParkedDeliveryObligations;
+}
+/**
+ * Exposes owner-bound registration-assembly test operations.
+ * @internal
+ */
+export declare const EnvironmentAttachmentAccess: Readonly<EnvironmentAttachmentAccess>;
+//# sourceMappingURL=environment-attachment.d.ts.map