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

package/dist/integration/integration-broker.js

@@ -0,0 +1,444 @@
+/*
+ * 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.
+ */
+import { create, fromBinary } from "@bufbuild/protobuf";
+import { StringValueSchema } from "@bufbuild/protobuf/wkt";
+import { TypeUrls } from "@spine-event-engine/core";
+import { BoundedContextOnlineSchema, ChannelIdSchema, ExternalEventsWantedSchema, } from "@spine-event-engine/proto";
+import { eventBusAccess, EventBus } from "../bus/event-bus.js";
+import { emitServerError } from "../server/server-log.js";
+import { ServerEnvironment, serverEnvironmentAccess } from "../server/server-environment.js";
+import { unpackExternalEvent, toExternalEvent, wrapBoundedContextOnline, wrapExternalEvent, wrapExternalEventsWanted, } from "./external-messages.js";
+const onlineType = typeUrl(BoundedContextOnlineSchema);
+const wantedType = typeUrl(ExternalEventsWantedSchema);
+/**
+ * Coordinates private context-owned integration exchanges.
+ *
+ * @internal
+ */
+export class IntegrationBroker {
+    #input;
+    #wantedByOrigin = new Map();
+    #publishers = new Map();
+    #resources = [];
+    #retainedCloseables = [];
+    #externalSchemas;
+    #acceptedCallbacks = new Set();
+    #transition = Promise.resolve();
+    #open;
+    #close;
+    #closed = false;
+    #emptyWantedPublished = false;
+    /**
+     * Creates an exchange coordinator from context-owned integration resources.
+     *
+     * @param input Provides the context assembly inputs.
+     */
+    constructor(input) {
+        this.#input = input;
+        this.#externalSchemas = Object.freeze([...input.externalEventSchemas].filter((schema, index, schemas) => schemas.findIndex((candidate) => TypeUrls.derive(candidate) === TypeUrls.derive(schema)) === index));
+    }
+    /**
+     * Starts the three exchanges once; callers share the same readiness promise.
+     *
+     * @returns Completes when all exchanges are ready.
+     */
+    open() {
+        if (this.#closed)
+            return Promise.reject(new Error("IntegrationBroker is closed."));
+        this.#open ??= this.#openOnce();
+        return this.#open;
+    }
+    /**
+     * Stops intake, withdraws interests, drains accepted work, and attempts every cleanup.
+     *
+     * @returns Completes when all retained resources close.
+     */
+    close() {
+        this.#close ??= this.#closeOnce();
+        return this.#close;
+    }
+    /**
+     * Publishes a third-party imported event through this context's private broker.
+     *
+     * @param event Contains the original event envelope to publish.
+     * @returns Completes after publication is accepted or rejects when the broker is closed or the
+     * event has no message type URL.
+     * @internal
+     */
+    async publishImported(event) {
+        if (this.#closed)
+            throw new Error("IntegrationBroker is closed.");
+        const targetType = event.message?.typeUrl;
+        if (targetType === undefined || targetType.length === 0) {
+            throw new Error("Imported event requires event.message.typeUrl.");
+        }
+        if (![...this.#wantedByOrigin.values()].some((types) => types.has(targetType))) {
+            return;
+        }
+        const publisher = await this.#input.transportFactory.createPublisher(channel(targetType));
+        try {
+            const frame = wrapExternalEvent(event, this.#input.contextName);
+            await publisher.publish(frame.id, frame);
+        }
+        finally {
+            await this.#closeEphemeral(publisher);
+        }
+    }
+    async #openOnce() {
+        try {
+            const factory = this.#input.transportFactory;
+            const status = await this.#attach(factory, onlineType, (message) => this.#onOnline(message));
+            this.#resources.push(status);
+            const config = await this.#attach(factory, wantedType, (message) => this.#onWanted(message));
+            this.#resources.push(config);
+            for (const schema of this.#externalSchemas) {
+                const targetType = typeUrl(schema);
+                this.#resources.push(await this.#attach(factory, targetType, (message) => this.#onEvent(message)));
+            }
+            await this.#publishOnline();
+            await this.#publishWanted();
+        }
+        catch (error) {
+            const failures = await closeRetained(this.#resources);
+            this.#open = undefined;
+            if (failures.length)
+                throw new AggregateError([error, ...failures], "IntegrationBroker open failed.");
+            throw error;
+        }
+    }
+    async #attach(factory, targetType, consumer) {
+        const subscriber = await factory.createSubscriber(channel(targetType));
+        try {
+            const handle = await subscriber.addConsumer((message) => this.#acceptCallback(() => consumer(message)));
+            return new SubscriberResource(subscriber, handle);
+        }
+        catch (error) {
+            try {
+                await subscriber.close();
+            }
+            catch (closeError) {
+                throw new AggregateError([error, closeError], "Integration subscriber setup failed.");
+            }
+            throw error;
+        }
+    }
+    #acceptCallback(work) {
+        if (this.#closed)
+            return Promise.resolve();
+        const accepted = Promise.resolve().then(work);
+        this.#acceptedCallbacks.add(accepted);
+        void accepted.then(() => this.#acceptedCallbacks.delete(accepted), () => this.#acceptedCallbacks.delete(accepted));
+        return accepted;
+    }
+    async #onOnline(message) {
+        if (this.#closed)
+            return;
+        const online = unpackOnline(message);
+        if (online.context?.value !== message.boundedContextName?.value)
+            throw new Error("Malformed integration control message.");
+        if (!this.#accepts(online.context))
+            return;
+        await this.#publishWanted();
+    }
+    async #onWanted(message) {
+        if (this.#closed)
+            return;
+        if (!this.#accepts(message.boundedContextName))
+            return;
+        const wanted = unpackWanted(message);
+        const requested = new Set(wanted.type.map((entry) => entry.typeUrl).filter(Boolean));
+        const origin = message.boundedContextName.value;
+        await this.#enqueueTransition(async () => this.#replaceWanted(origin, requested));
+    }
+    async #onEvent(message) {
+        if (this.#closed)
+            return;
+        if (!this.#accepts(message.boundedContextName))
+            return;
+        let imported;
+        try {
+            const original = unpackExternalEvent(message);
+            const typeUrl = original.message?.typeUrl;
+            const schema = typeUrl === undefined
+                ? undefined
+                : (eventBusAccess.schema(this.#input.eventBus, typeUrl) ??
+                    (typeUrl === TypeUrls.derive(StringValueSchema) ? StringValueSchema : undefined));
+            if (schema === undefined || original.message === undefined)
+                throw new Error("External event message type is not accepted.");
+            fromBinary(schema, original.message.value);
+            imported = toExternalEvent(original);
+        }
+        catch {
+            emitServerError(serverEnvironmentAccess.loggerFor(ServerEnvironment.instance()), "Dropped corrupt external event.", {
+                contextName: message.boundedContextName.value,
+                eventType: message.originalMessage?.typeUrl ?? "unknown",
+                operation: "external-event-intake",
+                reasonCode: "corrupt_external_event",
+            });
+            return;
+        }
+        await this.#input.postImported(imported);
+    }
+    async #replaceWanted(origin, next) {
+        const previous = this.#wantedByOrigin.get(origin) ?? new Set();
+        const add = [...next].flatMap((type) => {
+            const schema = eventBusAccess.schema(this.#input.eventBus, type);
+            if (previous.has(type) || this.#wantedElsewhere(type, origin) || schema === undefined)
+                return [];
+            return [[type, schema]];
+        });
+        const removals = [...this.#publishers].filter(([type]) => previous.has(type) && !next.has(type) && !this.#wantedElsewhere(type, origin));
+        const acquired = [];
+        try {
+            for (const [targetType, schema] of add) {
+                const publisher = await DomesticPublisher.create(this.#input.eventBus, this.#input.transportFactory, targetType, this.#input.contextName, schema);
+                acquired.push(publisher);
+            }
+        }
+        catch (error) {
+            const failures = await this.#rollbackAcquired(acquired);
+            if (failures.length)
+                throw new AggregateError([error, ...failures], "Integration publisher acquisition failed.");
+            throw error;
+        }
+        const errors = [];
+        for (const [, publisher] of removals) {
+            await collect(() => publisher.close(), errors);
+        }
+        if (errors.length) {
+            const failures = await this.#rollbackAcquired(acquired);
+            throw new AggregateError([...errors, ...failures], "Failed to remove domestic publisher.");
+        }
+        this.#wantedByOrigin.set(origin, new Set(next));
+        for (const [targetType] of removals)
+            this.#publishers.delete(targetType);
+        for (const publisher of acquired)
+            this.#publishers.set(publisher.targetType, publisher);
+    }
+    #wantedElsewhere(targetType, exceptOrigin) {
+        return [...this.#wantedByOrigin.entries()].some(([origin, types]) => origin !== exceptOrigin && types.has(targetType));
+    }
+    async #rollbackAcquired(acquired) {
+        const settled = await Promise.all(acquired.map(async (publisher) => {
+            try {
+                await publisher.rollback();
+            }
+            catch (reason) {
+                return { publisher, reason };
+            }
+            return undefined;
+        }));
+        const failures = [];
+        for (const failure of settled) {
+            if (failure === undefined)
+                continue;
+            this.#retainedCloseables.push(failure.publisher);
+            failures.push(failure.reason);
+        }
+        return failures;
+    }
+    #enqueueTransition(work) {
+        const accepted = this.#transition.then(work);
+        this.#transition = accepted.catch(() => undefined);
+        return accepted;
+    }
+    async #publishOnline() {
+        const publisher = await this.#input.transportFactory.createPublisher(channel(onlineType));
+        try {
+            const frame = wrapBoundedContextOnline(create(BoundedContextOnlineSchema, { context: this.#input.contextName }));
+            await publisher.publish(frame.id, frame);
+        }
+        finally {
+            await this.#closeEphemeral(publisher);
+        }
+    }
+    async #publishWanted() {
+        const types = this.#externalSchemas.map(typeUrl).sort();
+        const publisher = await this.#input.transportFactory.createPublisher(channel(wantedType));
+        try {
+            const frame = wrapExternalEventsWanted(create(ExternalEventsWantedSchema, { type: types.map((typeUrl) => ({ typeUrl })) }), this.#input.contextName);
+            await publisher.publish(frame.id, frame);
+        }
+        finally {
+            await this.#closeEphemeral(publisher);
+        }
+    }
+    #accepts(origin) {
+        const value = origin?.value;
+        return Boolean(value &&
+            value !== this.#input.contextName.value &&
+            value !== this.#input.pairedContextName?.value);
+    }
+    async #closeOnce() {
+        this.#closed = true;
+        const errors = [];
+        const opening = this.#open;
+        if (opening !== undefined)
+            await collect(() => opening, errors);
+        await Promise.allSettled([...this.#acceptedCallbacks]);
+        await this.#transition;
+        await collect(() => this.#publishEmptyWanted(), errors);
+        const publisherFailures = await closeRetained(this.#retainedCloseables);
+        errors.push(...publisherFailures);
+        for (const [type, publisher] of this.#publishers) {
+            const failures = [];
+            await collect(() => publisher.close(), failures);
+            if (failures.length === 0)
+                this.#publishers.delete(type);
+            else
+                errors.push(...failures);
+        }
+        errors.push(...(await closeRetained(this.#resources)));
+        if (errors.length) {
+            this.#close = undefined;
+            throw new AggregateError(errors, "IntegrationBroker close failed.");
+        }
+    }
+    async #publishEmptyWanted() {
+        if (this.#emptyWantedPublished)
+            return;
+        const publisher = await this.#input.transportFactory.createPublisher(channel(wantedType));
+        try {
+            const frame = wrapExternalEventsWanted(create(ExternalEventsWantedSchema), this.#input.contextName);
+            await publisher.publish(frame.id, frame);
+            this.#emptyWantedPublished = true;
+        }
+        finally {
+            await this.#closeEphemeral(publisher);
+        }
+    }
+    async #closeEphemeral(publisher) {
+        try {
+            await publisher.close();
+        }
+        catch (error) {
+            this.#retainedCloseables.push(publisher);
+            throw error;
+        }
+    }
+}
+class DomesticPublisher {
+    targetType;
+    #eventBus;
+    #dispatcher;
+    #publisher;
+    #detached = false;
+    constructor(eventBus, publisher, targetType, origin, schema) {
+        this.#eventBus = eventBus;
+        this.#publisher = publisher;
+        this.targetType = targetType;
+        this.#dispatcher = {
+            messageSchemas: () => [schema],
+            dispatch: async (event) => {
+                const frame = wrapExternalEvent(event, origin);
+                await publisher.publish(frame.id, frame);
+            },
+        };
+    }
+    static async create(eventBus, factory, targetType, origin, schema) {
+        const publisher = await factory.createPublisher(channel(targetType));
+        const domestic = new DomesticPublisher(eventBus, publisher, targetType, origin, schema);
+        eventBus.register(domestic.#dispatcher);
+        return domestic;
+    }
+    async close() {
+        await this.#publisher.close();
+        this.#detach();
+    }
+    async rollback() {
+        this.#detach();
+        await this.#publisher.close();
+    }
+    #detach() {
+        if (this.#detached)
+            return;
+        this.#detached = true;
+        eventBusAccess.unregister(this.#eventBus, this.#dispatcher);
+    }
+}
+class SubscriberResource {
+    subscriber;
+    handle;
+    constructor(subscriber, handle) {
+        this.subscriber = subscriber;
+        this.handle = handle;
+    }
+    async close() {
+        const errors = [];
+        await collect(() => this.handle.close(), errors);
+        await collect(() => this.subscriber.close(), errors);
+        if (errors.length)
+            throw new AggregateError(errors, "Integration subscriber close failed.");
+    }
+}
+async function closeRetained(resources) {
+    const settled = await Promise.allSettled(resources.map((resource) => resource.close()));
+    const retained = resources.filter((_, index) => settled[index]?.status === "rejected");
+    resources.splice(0, resources.length, ...retained);
+    const failures = [];
+    for (const result of settled)
+        if (result.status === "rejected")
+            failures.push(result.reason);
+    return failures;
+}
+async function collect(work, errors) {
+    try {
+        await work();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+}
+function channel(targetType) {
+    return create(ChannelIdSchema, { targetType });
+}
+function typeUrl(schema) {
+    return TypeUrls.derive(schema);
+}
+function unpackOnline(message) {
+    const originalMessage = controlPayload(BoundedContextOnlineSchema, message);
+    try {
+        return fromBinary(BoundedContextOnlineSchema, originalMessage.value);
+    }
+    catch {
+        throw new Error("Malformed integration control message.");
+    }
+}
+function unpackWanted(message) {
+    try {
+        return fromBinary(ExternalEventsWantedSchema, controlPayload(ExternalEventsWantedSchema, message).value);
+    }
+    catch {
+        throw new Error("Malformed integration control message.");
+    }
+}
+function controlPayload(schema, message) {
+    const originalMessage = message.originalMessage;
+    if (!message.boundedContextName?.value ||
+        originalMessage?.typeUrl !== typeUrl(schema) ||
+        !isControlIdentity(message.id))
+        throw new Error("Malformed integration control message.");
+    return originalMessage;
+}
+function isControlIdentity(identity) {
+    if (identity?.typeUrl !== typeUrl(StringValueSchema))
+        return false;
+    try {
+        return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu.test(fromBinary(StringValueSchema, identity.value).value);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=integration-broker.js.map

package/dist/integration/integration-broker.js.map

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

package/dist/integration/third-party-context.d.ts

@@ -0,0 +1,56 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type ActorContext, type UserId } from "@spine-event-engine/proto";
+/**
+ * Represents a hidden bounded context that imports third-party events through its private broker.
+ *
+ * The JVM-owned integration lifecycle remains private: this facade only creates the context,
+ * publishes generated events, observes availability, and closes it.
+ */
+export declare class ThirdPartyContext {
+    #private;
+    private constructor();
+    /**
+     * Creates a third-party context that forbids actor tenants.
+     *
+     * @param name Identifies the hidden bounded context.
+     * @returns Resolves to an open single-tenant context.
+     */
+    static singleTenant(name: string): Promise<ThirdPartyContext>;
+    /**
+     * Creates a third-party context that requires actor tenants.
+     *
+     * @param name Identifies the hidden bounded context.
+     * @returns Resolves to an open multitenant context.
+     */
+    static multitenant(name: string): Promise<ThirdPartyContext>;
+    /**
+     * Publishes one generated event with its importing actor identity.
+     *
+     * @param event Supplies the generated event message to import unchanged.
+     * @param actor Supplies a user or actor context that satisfies this context's tenancy policy.
+     * @returns Completes when the private broker accepts the imported event, or rejects for a closed
+     * context, an unsupported message, or incompatible actor tenancy.
+     */
+    emittedEvent(event: Message, actor: ActorContext): Promise<void>;
+    /**
+     * Publishes one generated event with a user identity in a single-tenant context.
+     *
+     * @param event Supplies the generated event message to import unchanged.
+     * @param actor Supplies the importing user identity.
+     * @returns Completes when the private broker accepts the imported event.
+     */
+    emittedEvent(event: Message, actor: UserId): Promise<void>;
+    /**
+     * Returns whether the hidden bounded context remains available for imports.
+     *
+     * @returns `true` until a successful close; `false` after it closes.
+     */
+    isOpen(): boolean;
+    /**
+     * Closes the hidden bounded context and its private broker resources.
+     *
+     * @returns Completes after shutdown; repeated calls after a successful close do nothing.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=third-party-context.d.ts.map

package/dist/integration/third-party-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"third-party-context.d.ts","sourceRoot":"","sources":["../../src/integration/third-party-context.ts"],"names":[],"mappings":"AAcA,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AAKnC;;;;;GAKG;AACH,qBAAa,iBAAiB;;IAK5B,OAAO;IAKP;;;;;OAKG;WACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInE;;;;;OAKG;WACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQlE;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC1D;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC7B"}

package/dist/integration/third-party-context.js

@@ -0,0 +1,130 @@
+/*
+ * 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.
+ */
+import { create, toBinary } from "@bufbuild/protobuf";
+import { TimestampSchema } from "@bufbuild/protobuf/wkt";
+import { AnyMessages, TypeUrls } from "@spine-event-engine/core";
+import { ActorContextSchema, BoundedContextNameSchema, EventContextSchema, EventIdSchema, EventSchema, UserIdSchema, } from "@spine-event-engine/proto";
+import { BoundedContext, boundedContextIntegrationAccess } from "../context/bounded-context.js";
+import { ServerEnvironment } from "../server/server-environment.js";
+/**
+ * Represents a hidden bounded context that imports third-party events through its private broker.
+ *
+ * The JVM-owned integration lifecycle remains private: this facade only creates the context,
+ * publishes generated events, observes availability, and closes it.
+ */
+export class ThirdPartyContext {
+    #context;
+    #multitenant;
+    #closed = false;
+    constructor(context, multitenant) {
+        this.#context = context;
+        this.#multitenant = multitenant;
+    }
+    /**
+     * Creates a third-party context that forbids actor tenants.
+     *
+     * @param name Identifies the hidden bounded context.
+     * @returns Resolves to an open single-tenant context.
+     */
+    static async singleTenant(name) {
+        return new ThirdPartyContext(await BoundedContext.singleTenant(name).buildAsync(), false);
+    }
+    /**
+     * Creates a third-party context that requires actor tenants.
+     *
+     * @param name Identifies the hidden bounded context.
+     * @returns Resolves to an open multitenant context.
+     */
+    static async multitenant(name) {
+        return new ThirdPartyContext(await BoundedContext.multitenant(name).buildAsync(), true);
+    }
+    /**
+     * Publishes one generated event with its importing actor identity.
+     *
+     * @param event Supplies the generated event message to import unchanged.
+     * @param actor Supplies a user or actor context that satisfies this context's tenancy policy.
+     * @returns Completes when the private broker accepts the imported event.
+     */
+    async emittedEvent(event, actor) {
+        if (this.#closed)
+            throw new Error("ThirdPartyContext is closed.");
+        const actorContext = this.#actorContext(actor);
+        const typeName = event.$typeName;
+        if (typeof typeName !== "string" || typeName.length === 0) {
+            throw new TypeError("ThirdPartyContext requires a generated event message.");
+        }
+        const envelope = create(EventSchema, {
+            id: create(EventIdSchema, { value: crypto.randomUUID() }),
+            message: {
+                typeUrl: this.#schema(typeName).typeUrl,
+                value: toBinary(this.#schema(typeName).schema, event),
+            },
+            context: create(EventContextSchema, {
+                timestamp: actorContext.timestamp ?? create(TimestampSchema),
+                origin: { case: "importContext", value: actorContext },
+                producerId: AnyMessages.pack(BoundedContextNameSchema, create(BoundedContextNameSchema, { value: this.#context.name.value })),
+            }),
+        });
+        await boundedContextIntegrationAccess.publishImported(this.#context, envelope);
+    }
+    /* eslint-enable @typescript-eslint/unified-signatures */
+    /**
+     * Returns whether the hidden bounded context remains available for imports.
+     *
+     * @returns `true` until a successful close; `false` after it closes.
+     */
+    isOpen() {
+        return !this.#closed;
+    }
+    /**
+     * Closes the hidden bounded context and its private broker resources.
+     *
+     * @returns Completes after shutdown; repeated calls after a successful close do nothing.
+     */
+    async close() {
+        if (this.#closed)
+            return;
+        await this.#context.close();
+        this.#closed = true;
+    }
+    #actorContext(actor) {
+        const isUser = actor.$typeName === UserIdSchema.typeName;
+        if (isUser) {
+            if (this.#multitenant)
+                throw new Error("Multitenant ThirdPartyContext requires ActorContext.");
+            const now = Date.now();
+            return create(ActorContextSchema, {
+                actor,
+                timestamp: create(TimestampSchema, {
+                    seconds: BigInt(Math.floor(now / 1_000)),
+                    nanos: (now % 1_000) * 1_000_000,
+                }),
+            });
+        }
+        const hasTenant = actor.tenantId?.kind.case !== undefined;
+        if (this.#multitenant !== hasTenant) {
+            throw new Error(this.#multitenant
+                ? "Multitenant ThirdPartyContext requires actor tenantId."
+                : "Single-tenant ThirdPartyContext forbids actor tenantId.");
+        }
+        return actor;
+    }
+    #schema(typeName) {
+        const metadata = ServerEnvironment.instance().typeRegistry.findByFullName(typeName);
+        if (metadata === undefined)
+            throw new TypeError(`ThirdPartyContext does not know ${typeName}.`);
+        return { schema: metadata.schema, typeUrl: TypeUrls.derive(metadata.schema) };
+    }
+}
+//# sourceMappingURL=third-party-context.js.map

package/dist/integration/third-party-context.js.map

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