@cratis/chronicle 6.47.0 → 6.49.0

package/dist/eventSequences/TransactionalEventSequence.js

@@ -15,13 +15,13 @@ export class TransactionalEventSequence {
         return this._unitOfWorkManager.current;
     }
     /** @inheritdoc */
-    async append(eventSourceId, event) {
-        this.unitOfWork.addEvent(this._eventSequence.id, eventSourceId, event);
+    async append(eventSourceId, event, routing) {
+        this.unitOfWork.addEvent(this._eventSequence.id, eventSourceId, event, routing);
     }
     /** @inheritdoc */
-    async appendMany(eventSourceId, events) {
+    async appendMany(eventSourceId, events, routing) {
         for (const event of events) {
-            this.unitOfWork.addEvent(this._eventSequence.id, eventSourceId, event);
+            this.unitOfWork.addEvent(this._eventSequence.id, eventSourceId, event, routing);
         }
     }
 }

package/dist/eventSequences/TransactionalEventSequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionalEventSequence.js","sourceRoot":"","sources":["../../eventSequences/TransactionalEventSequence.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAOrG;;GAEG;AACH,MAAM,OAAO,0BAA0B;IAEd,cAAc;IACd,kBAAkB;IAFvC,YACqB,cAA8B,EAC9B,kBAAsC;8BADtC,cAAc;kCACd,kBAAkB;IACpC,CAAC;IAEJ,kBAAkB;IAClB,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,MAAM,CAAC,aAAqB,EAAE,KAAa;QAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,UAAU,CAAC,aAAqB,EAAE,MAAgB;QACpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"TransactionalEventSequence.js","sourceRoot":"","sources":["../../eventSequences/TransactionalEventSequence.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAQrG;;GAEG;AACH,MAAM,OAAO,0BAA0B;IAEd,cAAc;IACd,kBAAkB;IAFvC,YACqB,cAA8B,EAC9B,kBAAsC;8BADtC,cAAc;kCACd,kBAAkB;IACpC,CAAC;IAEJ,kBAAkB;IAClB,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,MAAM,CAAC,aAAqB,EAAE,KAAa,EAAE,OAAmC;QAClF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,UAAU,CAAC,aAAqB,EAAE,MAAgB,EAAE,OAAmC;QACzF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACpF,CAAC;IACL,CAAC;CACJ"}

package/dist/eventSequences/resolveEventSourceRouting.d.ts

@@ -0,0 +1,39 @@
+import { ResolvedEventRouting } from '../eventSources/ResolvedEventRouting.js';
+import type { IEventSources } from '../eventSources/IEventSources.js';
+import type { AppendOptions } from './AppendOptions.js';
+import type { ConcurrencyScope } from './ConcurrencyScope.js';
+import type { EventForEventSourceId } from './EventForEventSourceId.js';
+import { EventSequenceNumber } from './EventSequenceNumber.js';
+/** Resolves the definition routing of a single append, or undefined for a legacy append. */
+export declare function resolveSingleRouting(eventSources: IEventSources | undefined, options?: AppendOptions): ResolvedEventRouting | undefined;
+/** Resolves the definition routing of one event of a batch; per-event values win over the shared options. */
+export declare function resolveBatchRouting(eventSources: IEventSources | undefined, event: EventForEventSourceId, options?: AppendOptions): ResolvedEventRouting | undefined;
+/** A derived guard required by a registered-definition event of a batch. */
+export interface RequiredGuard {
+    /** The routing whose dimensions produce the guard. */
+    readonly routing: ResolvedEventRouting;
+    /** The stream id the guard's stream-id dimension (if any) applies to. */
+    readonly streamId: string | undefined;
+}
+/**
+ * Determines the single derived guard every event source id of a batch needs.
+ * The Kernel accepts one concurrency scope per event source id, so equivalent predicates share one
+ * scope (an unguarded event never suppresses a guarded one) and differing predicates are rejected
+ * before anything is written.
+ * @param routings - The resolved routing per event, aligned with {@link events}.
+ * @param events - The batch events.
+ * @param sharedStreamId - The shared stream id from the append options.
+ * @param explicitIds - Event source ids that carry an explicit scope; they are never derived.
+ * @returns The guard to derive per event source id.
+ * @throws Error when one event source id needs differing guards.
+ */
+export declare function planDerivedGuards(routings: Array<ResolvedEventRouting | undefined>, events: EventForEventSourceId[], sharedStreamId: string | undefined, explicitIds?: ReadonlySet<string>): Map<string, RequiredGuard>;
+/** The tail reader a derived concurrency scope needs. */
+export type TailReader = (eventSourceId?: string, sourceType?: string, streamType?: string, streamId?: string) => Promise<EventSequenceNumber>;
+/**
+ * Derives an optimistic concurrency scope from the dimensions a definition declares.
+ * Only call this when no explicit scope exists; explicit scopes always win.
+ * @returns The scope, or undefined when the definition declares no dimensions.
+ */
+export declare function deriveConcurrencyScope(routing: ResolvedEventRouting, eventSourceId: string, streamId: string | undefined, readTail: TailReader): Promise<ConcurrencyScope | undefined>;
+//# sourceMappingURL=resolveEventSourceRouting.d.ts.map

package/dist/eventSequences/resolveEventSourceRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEventSourceRouting.d.ts","sourceRoot":"","sources":["../../eventSequences/resolveEventSourceRouting.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,aAAa,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,oBAAoB,GAAG,SAAS,CAGvI;AAED,6GAA6G;AAC7G,wBAAgB,mBAAmB,CAC/B,YAAY,EAAE,aAAa,GAAG,SAAS,EACvC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,aAAa,GACxB,oBAAoB,GAAG,SAAS,CASlC;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAeD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,KAAK,CAAC,oBAAoB,GAAG,SAAS,CAAC,EACjD,MAAM,EAAE,qBAAqB,EAAE,EAC/B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa,GAC7C,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAmB5B;AAED,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE/I;;;;GAIG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,UAAU,GACrB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAmBvC"}

package/dist/eventSequences/resolveEventSourceRouting.js

@@ -0,0 +1,92 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { ConcurrencyDimensions } from '../eventSources/ConcurrencyDimensions.js';
+import { ResolvedEventRouting } from '../eventSources/ResolvedEventRouting.js';
+import { EventSequenceNumber } from './EventSequenceNumber.js';
+/** Resolves the definition routing of a single append, or undefined for a legacy append. */
+export function resolveSingleRouting(eventSources, options) {
+    return ResolvedEventRouting.resolve(eventSources, options?.eventSource, options?.eventStream, { sourceType: options?.sourceType, streamType: options?.streamType });
+}
+/** Resolves the definition routing of one event of a batch; per-event values win over the shared options. */
+export function resolveBatchRouting(eventSources, event, options) {
+    const ownSource = event.eventSource !== undefined;
+    const source = event.eventSource ?? options?.eventSource;
+    // A stream belongs to its event source: never inherit the shared stream into a different source.
+    const stream = event.eventStream ?? (ownSource ? undefined : options?.eventStream);
+    return ResolvedEventRouting.resolve(eventSources, source, stream, {
+        sourceType: event.eventSourceType ?? options?.sourceType,
+        streamType: event.eventStreamType ?? options?.streamType
+    });
+}
+/** The predicate a guard evaluates: only the values of the dimensions the routing selects. */
+function guardPredicate(routing, eventSourceId, streamId) {
+    const dimensions = routing.dimensions;
+    if (dimensions === ConcurrencyDimensions.none)
+        return undefined;
+    const has = (flag) => (dimensions & flag) !== 0;
+    return JSON.stringify([
+        has(ConcurrencyDimensions.eventSourceId) ? eventSourceId : null,
+        has(ConcurrencyDimensions.eventSourceType) ? routing.sourceType : null,
+        has(ConcurrencyDimensions.eventStreamType) ? routing.streamType ?? null : null,
+        has(ConcurrencyDimensions.eventStreamId) ? streamId ?? null : null
+    ]);
+}
+/**
+ * Determines the single derived guard every event source id of a batch needs.
+ * The Kernel accepts one concurrency scope per event source id, so equivalent predicates share one
+ * scope (an unguarded event never suppresses a guarded one) and differing predicates are rejected
+ * before anything is written.
+ * @param routings - The resolved routing per event, aligned with {@link events}.
+ * @param events - The batch events.
+ * @param sharedStreamId - The shared stream id from the append options.
+ * @param explicitIds - Event source ids that carry an explicit scope; they are never derived.
+ * @returns The guard to derive per event source id.
+ * @throws Error when one event source id needs differing guards.
+ */
+export function planDerivedGuards(routings, events, sharedStreamId, explicitIds = new Set()) {
+    const guards = new Map();
+    routings.forEach((routing, index) => {
+        const { eventSourceId, eventStreamId } = events[index];
+        if (!routing || explicitIds.has(eventSourceId))
+            return;
+        const streamId = eventStreamId ?? sharedStreamId;
+        const predicate = guardPredicate(routing, eventSourceId, streamId);
+        if (predicate === undefined)
+            return;
+        const existing = guards.get(eventSourceId);
+        if (!existing) {
+            guards.set(eventSourceId, { guard: { routing, streamId }, predicate });
+        }
+        else if (existing.predicate !== predicate) {
+            throw new Error(`Event source id '${eventSourceId}' needs differing concurrency guards within one batch ` +
+                `('${existing.guard.routing.eventSource}' and '${routing.eventSource}'), but Chronicle accepts one concurrency scope per event source id. ` +
+                'Pass an explicit shared concurrencyScopes entry for the id, or append the events in separate batches.');
+        }
+    });
+    return new Map([...guards].map(([id, { guard }]) => [id, guard]));
+}
+/**
+ * Derives an optimistic concurrency scope from the dimensions a definition declares.
+ * Only call this when no explicit scope exists; explicit scopes always win.
+ * @returns The scope, or undefined when the definition declares no dimensions.
+ */
+export async function deriveConcurrencyScope(routing, eventSourceId, streamId, readTail) {
+    const dimensions = routing.dimensions;
+    if (dimensions === ConcurrencyDimensions.none)
+        return undefined;
+    const has = (flag) => (dimensions & flag) !== 0;
+    const scopedSource = has(ConcurrencyDimensions.eventSourceId) ? eventSourceId : undefined;
+    const scopedSourceType = has(ConcurrencyDimensions.eventSourceType) ? routing.sourceType : undefined;
+    const scopedStreamType = has(ConcurrencyDimensions.eventStreamType) ? routing.streamType : undefined;
+    const scopedStreamId = has(ConcurrencyDimensions.eventStreamId) ? streamId : undefined;
+    const tail = await readTail(scopedSource, scopedSourceType, scopedStreamType, scopedStreamId);
+    return {
+        // An empty scope is checked against "no matching event", like an explicit first append.
+        sequenceNumber: tail.value === EventSequenceNumber.unset.value ? EventSequenceNumber.beforeFirst.value : tail.value,
+        eventSourceId: scopedSource !== undefined,
+        eventSourceType: scopedSourceType,
+        eventStreamType: scopedStreamType,
+        eventStreamId: scopedStreamId
+    };
+}
+//# sourceMappingURL=resolveEventSourceRouting.js.map

package/dist/eventSequences/resolveEventSourceRouting.js.map

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

package/dist/eventSources/ConcurrencyDimensions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Flags describing which dimensions of an append take part in a concurrency check.
+ * Values match the wire contract and can be combined with bitwise OR.
+ */
+export declare const ConcurrencyDimensions: {
+    /** No dimensions declared; the append keeps its existing concurrency behavior. */
+    readonly none: 0;
+    /** The event source identifier. */
+    readonly eventSourceId: 1;
+    /** The event source type. */
+    readonly eventSourceType: 2;
+    /** The event stream type. */
+    readonly eventStreamType: 4;
+    /** The event stream identifier. */
+    readonly eventStreamId: 8;
+};
+/** A bitwise combination of {@link ConcurrencyDimensions} values. */
+export type ConcurrencyDimensionFlags = number;
+//# sourceMappingURL=ConcurrencyDimensions.d.ts.map

package/dist/eventSources/ConcurrencyDimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyDimensions.d.ts","sourceRoot":"","sources":["../../eventSources/ConcurrencyDimensions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAC9B,kFAAkF;aAClF,IAAI,EAAE,CAAC;IAEP,mCAAmC;aACnC,aAAa,EAAE,CAAC;IAEhB,6BAA6B;aAC7B,eAAe,EAAE,CAAC;IAElB,6BAA6B;aAC7B,eAAe,EAAE,CAAC;IAElB,mCAAmC;aACnC,aAAa,EAAE,CAAC;CACV,CAAC;AAEX,qEAAqE;AACrE,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC"}

package/dist/eventSources/ConcurrencyDimensions.js

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Flags describing which dimensions of an append take part in a concurrency check.
+ * Values match the wire contract and can be combined with bitwise OR.
+ */
+export const ConcurrencyDimensions = {
+    /** No dimensions declared; the append keeps its existing concurrency behavior. */
+    none: 0,
+    /** The event source identifier. */
+    eventSourceId: 1,
+    /** The event source type. */
+    eventSourceType: 2,
+    /** The event stream type. */
+    eventStreamType: 4,
+    /** The event stream identifier. */
+    eventStreamId: 8
+};
+//# sourceMappingURL=ConcurrencyDimensions.js.map

package/dist/eventSources/ConcurrencyDimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyDimensions.js","sourceRoot":"","sources":["../../eventSources/ConcurrencyDimensions.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,kFAAkF;IAClF,IAAI,EAAE,CAAC;IAEP,mCAAmC;IACnC,aAAa,EAAE,CAAC;IAEhB,6BAA6B;IAC7B,eAAe,EAAE,CAAC;IAElB,6BAA6B;IAC7B,eAAe,EAAE,CAAC;IAElB,mCAAmC;IACnC,aAAa,EAAE,CAAC;CACV,CAAC"}

package/dist/eventSources/DuplicateEventSourceName.d.ts

@@ -0,0 +1,6 @@
+/** Thrown when two discovered event source definitions share a name. */
+export declare class DuplicateEventSourceName extends Error {
+    readonly eventSource: string;
+    constructor(eventSource: string);
+}
+//# sourceMappingURL=DuplicateEventSourceName.d.ts.map

package/dist/eventSources/DuplicateEventSourceName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateEventSourceName.d.ts","sourceRoot":"","sources":["../../eventSources/DuplicateEventSourceName.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,qBAAa,wBAAyB,SAAQ,KAAK;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAxC,YAAqB,WAAW,EAAE,MAAM,EAGvC;CACJ"}

package/dist/eventSources/DuplicateEventSourceName.js

@@ -0,0 +1,12 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Thrown when two discovered event source definitions share a name. */
+export class DuplicateEventSourceName extends Error {
+    eventSource;
+    constructor(eventSource) {
+        super(`More than one event source definition is named '${eventSource}'.`);
+        this.eventSource = eventSource;
+        this.name = 'DuplicateEventSourceName';
+    }
+}
+//# sourceMappingURL=DuplicateEventSourceName.js.map

package/dist/eventSources/DuplicateEventSourceName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateEventSourceName.js","sourceRoot":"","sources":["../../eventSources/DuplicateEventSourceName.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,wEAAwE;AACxE,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC1B,WAAW;IAAhC,YAAqB,WAAmB;QACpC,KAAK,CAAC,mDAAmD,WAAW,IAAI,CAAC,CAAC;2BADzD,WAAW;QAE5B,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ"}

package/dist/eventSources/DuplicateEventStreamName.d.ts

@@ -0,0 +1,7 @@
+/** Thrown when an event source definition declares the same stream name twice. */
+export declare class DuplicateEventStreamName extends Error {
+    readonly eventSource: string;
+    readonly stream: string;
+    constructor(eventSource: string, stream: string);
+}
+//# sourceMappingURL=DuplicateEventStreamName.d.ts.map

package/dist/eventSources/DuplicateEventStreamName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateEventStreamName.d.ts","sourceRoot":"","sources":["../../eventSources/DuplicateEventStreamName.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,qBAAa,wBAAyB,SAAQ,KAAK;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAjE,YAAqB,WAAW,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM,EAGhE;CACJ"}

package/dist/eventSources/DuplicateEventStreamName.js

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Thrown when an event source definition declares the same stream name twice. */
+export class DuplicateEventStreamName extends Error {
+    eventSource;
+    stream;
+    constructor(eventSource, stream) {
+        super(`The event source '${eventSource}' declares the event stream '${stream}' more than once.`);
+        this.eventSource = eventSource;
+        this.stream = stream;
+        this.name = 'DuplicateEventStreamName';
+    }
+}
+//# sourceMappingURL=DuplicateEventStreamName.js.map

package/dist/eventSources/DuplicateEventStreamName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateEventStreamName.js","sourceRoot":"","sources":["../../eventSources/DuplicateEventStreamName.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,kFAAkF;AAClF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC1B,WAAW;IAAmB,MAAM;IAAzD,YAAqB,WAAmB,EAAW,MAAc;QAC7D,KAAK,CAAC,qBAAqB,WAAW,gCAAgC,MAAM,mBAAmB,CAAC,CAAC;2BADhF,WAAW;sBAAmB,MAAM;QAErD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ"}

package/dist/eventSources/EventRoutingContradictsEventSource.d.ts

@@ -0,0 +1,9 @@
+/** Thrown when explicit routing values contradict the event source definition. */
+export declare class EventRoutingContradictsEventSource extends Error {
+    readonly eventSource: string;
+    readonly dimension: string;
+    readonly expected: string;
+    readonly actual: string;
+    constructor(eventSource: string, dimension: string, expected: string, actual: string);
+}
+//# sourceMappingURL=EventRoutingContradictsEventSource.d.ts.map

package/dist/eventSources/EventRoutingContradictsEventSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRoutingContradictsEventSource.d.ts","sourceRoot":"","sources":["../../eventSources/EventRoutingContradictsEventSource.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,qBAAa,kCAAmC,SAAQ,KAAK;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAxH,YAAqB,WAAW,EAAE,MAAM,EAAW,SAAS,EAAE,MAAM,EAAW,QAAQ,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM,EAGvH;CACJ"}

package/dist/eventSources/EventRoutingContradictsEventSource.js

@@ -0,0 +1,18 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Thrown when explicit routing values contradict the event source definition. */
+export class EventRoutingContradictsEventSource extends Error {
+    eventSource;
+    dimension;
+    expected;
+    actual;
+    constructor(eventSource, dimension, expected, actual) {
+        super(`The explicit ${dimension} '${actual}' contradicts the event source '${eventSource}', which requires '${expected}'.`);
+        this.eventSource = eventSource;
+        this.dimension = dimension;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'EventRoutingContradictsEventSource';
+    }
+}
+//# sourceMappingURL=EventRoutingContradictsEventSource.js.map

package/dist/eventSources/EventRoutingContradictsEventSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRoutingContradictsEventSource.js","sourceRoot":"","sources":["../../eventSources/EventRoutingContradictsEventSource.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,kFAAkF;AAClF,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IACpC,WAAW;IAAmB,SAAS;IAAmB,QAAQ;IAAmB,MAAM;IAAhH,YAAqB,WAAmB,EAAW,SAAiB,EAAW,QAAgB,EAAW,MAAc;QACpH,KAAK,CAAC,gBAAgB,SAAS,KAAK,MAAM,mCAAmC,WAAW,sBAAsB,QAAQ,IAAI,CAAC,CAAC;2BAD3G,WAAW;yBAAmB,SAAS;wBAAmB,QAAQ;sBAAmB,MAAM;QAE5G,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACrD,CAAC;CACJ"}

package/dist/eventSources/EventSourceDefinition.d.ts

@@ -0,0 +1,20 @@
+import type { Constructor } from '@cratis/fundamentals';
+import type { ConcurrencyDimensionFlags } from './ConcurrencyDimensions.js';
+import type { EventStreamDefinition } from './EventStreamDefinition.js';
+/**
+ * Describes a registered event source: a stable name, its default concurrency dimensions and its streams.
+ * Routing belongs to the append, not to event types.
+ */
+export interface EventSourceDefinition {
+    /** The class carrying the definition. */
+    readonly type: Constructor;
+    /** The stable name of the event source; this is the event source type of appended events. */
+    readonly name: string;
+    /** The description of the event source. */
+    readonly description: string;
+    /** The default dimensions that take part in concurrency checks. */
+    readonly concurrency: ConcurrencyDimensionFlags;
+    /** The streams declared by the event source. */
+    readonly streams: ReadonlyArray<EventStreamDefinition>;
+}
+//# sourceMappingURL=EventSourceDefinition.d.ts.map

package/dist/eventSources/EventSourceDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSourceDefinition.d.ts","sourceRoot":"","sources":["../../eventSources/EventSourceDefinition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAEhD,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;CAC1D"}

package/dist/eventSources/EventSourceDefinition.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=EventSourceDefinition.js.map

package/dist/eventSources/EventSourceDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSourceDefinition.js","sourceRoot":"","sources":["../../eventSources/EventSourceDefinition.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/eventSources/EventSources.d.ts

@@ -0,0 +1,31 @@
+import type { Constructor } from '@cratis/fundamentals';
+import type { IClientArtifactsProvider } from '../artifacts/index.js';
+import type { ChronicleConnection } from '../connection/index.js';
+import type { EventSourceDefinition } from './EventSourceDefinition.js';
+import type { IEventSources } from './IEventSources.js';
+/**
+ * Implements {@link IEventSources}, discovering `@eventSource` classes and registering them with the Kernel.
+ */
+export declare class EventSources implements IEventSources {
+    private readonly _eventStore;
+    private readonly _connection;
+    private readonly _clientArtifacts;
+    private _byType;
+    private _byName;
+    /**
+     * Creates a new {@link EventSources}.
+     * @param _eventStore - The name of the event store the definitions belong to.
+     * @param _connection - The connection used to communicate with the Kernel.
+     * @param _clientArtifacts - Provider for discovered client artifact types.
+     */
+    constructor(_eventStore: string, _connection: ChronicleConnection, _clientArtifacts: IClientArtifactsProvider);
+    /** @inheritdoc */
+    get all(): ReadonlyArray<EventSourceDefinition>;
+    /** @inheritdoc */
+    discover(): Promise<void>;
+    /** @inheritdoc */
+    register(): Promise<void>;
+    /** @inheritdoc */
+    getFor(eventSource: Constructor | string): EventSourceDefinition;
+}
+//# sourceMappingURL=EventSources.d.ts.map

package/dist/eventSources/EventSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSources.d.ts","sourceRoot":"","sources":["../../eventSources/EventSources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAKxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,qBAAa,YAAa,YAAW,aAAa;IAW1C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAZrC,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,OAAO,CAA4C;IAE3D;;;;;OAKG;IACH,YACqB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,mBAAmB,EAChC,gBAAgB,EAAE,wBAAwB,EAC3D;IAEJ,kBAAkB;IAClB,IAAI,GAAG,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAE9C;IAED,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB9B;IAED,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB9B;IAED,kBAAkB;IAClB,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,qBAAqB,CAI/D;CACJ"}

package/dist/eventSources/EventSources.js

@@ -0,0 +1,90 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { EventSourceOwner } from '@cratis/chronicle.contracts';
+import { ensureCommandSuccess } from '../connection/callResults.js';
+import { getEventSourceMetadata, getEventStreamsFor } from './eventSource.js';
+import { DuplicateEventSourceName } from './DuplicateEventSourceName.js';
+import { DuplicateEventStreamName } from './DuplicateEventStreamName.js';
+import { UnknownEventSource } from './UnknownEventSource.js';
+/**
+ * Implements {@link IEventSources}, discovering `@eventSource` classes and registering them with the Kernel.
+ */
+export class EventSources {
+    _eventStore;
+    _connection;
+    _clientArtifacts;
+    _byType = new Map();
+    _byName = new Map();
+    /**
+     * Creates a new {@link EventSources}.
+     * @param _eventStore - The name of the event store the definitions belong to.
+     * @param _connection - The connection used to communicate with the Kernel.
+     * @param _clientArtifacts - Provider for discovered client artifact types.
+     */
+    constructor(_eventStore, _connection, _clientArtifacts) {
+        this._eventStore = _eventStore;
+        this._connection = _connection;
+        this._clientArtifacts = _clientArtifacts;
+    }
+    /** @inheritdoc */
+    get all() {
+        return [...this._byType.values()];
+    }
+    /** @inheritdoc */
+    async discover() {
+        const byType = new Map();
+        const byName = new Map();
+        for (const type of this._clientArtifacts.eventSources ?? []) {
+            const metadata = getEventSourceMetadata(type);
+            if (!metadata)
+                continue;
+            if (byName.has(metadata.name))
+                throw new DuplicateEventSourceName(metadata.name);
+            const streams = getEventStreamsFor(type);
+            const seen = new Set();
+            for (const stream of streams) {
+                if (seen.has(stream.name))
+                    throw new DuplicateEventStreamName(metadata.name, stream.name);
+                seen.add(stream.name);
+            }
+            const definition = {
+                type,
+                name: metadata.name,
+                description: metadata.description,
+                concurrency: metadata.concurrency,
+                streams: streams.map(stream => ({ ...stream }))
+            };
+            byType.set(type, definition);
+            byName.set(definition.name, definition);
+        }
+        this._byType = byType;
+        this._byName = byName;
+    }
+    /** @inheritdoc */
+    async register() {
+        if (this._byType.size === 0)
+            return;
+        ensureCommandSuccess('register event sources', await this._connection.eventSources.registerEventSources({
+            EventStore: this._eventStore,
+            Sources: this.all.map(definition => ({
+                Name: definition.name,
+                Description: definition.description,
+                Owner: EventSourceOwner.Client,
+                Concurrency: definition.concurrency,
+                Streams: definition.streams.map(stream => ({
+                    Name: stream.name,
+                    Description: stream.description,
+                    Concurrency: stream.concurrency
+                }))
+            }))
+        }));
+    }
+    /** @inheritdoc */
+    getFor(eventSource) {
+        const definition = typeof eventSource === 'string' ? this._byName.get(eventSource) : this._byType.get(eventSource);
+        if (!definition)
+            throw new UnknownEventSource(typeof eventSource === 'string' ? eventSource : eventSource.name);
+        return definition;
+    }
+}
+//# sourceMappingURL=EventSources.js.map

package/dist/eventSources/EventSources.js.map

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

package/dist/eventSources/EventStreamDefinition.d.ts

@@ -0,0 +1,13 @@
+import type { ConcurrencyDimensionFlags } from './ConcurrencyDimensions.js';
+/**
+ * Describes an event stream declared by an event source definition.
+ */
+export interface EventStreamDefinition {
+    /** The stable name of the stream; this is the event stream type of appended events. */
+    readonly name: string;
+    /** The description of the stream. */
+    readonly description: string;
+    /** The dimensions that take part in concurrency checks for the stream. Falls back to the event source when none. */
+    readonly concurrency: ConcurrencyDimensionFlags;
+}
+//# sourceMappingURL=EventStreamDefinition.d.ts.map

package/dist/eventSources/EventStreamDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamDefinition.d.ts","sourceRoot":"","sources":["../../eventSources/EventStreamDefinition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oHAAoH;IACpH,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;CACnD"}

package/dist/eventSources/EventStreamDefinition.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=EventStreamDefinition.js.map

package/dist/eventSources/EventStreamDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamDefinition.js","sourceRoot":"","sources":["../../eventSources/EventStreamDefinition.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/eventSources/EventStreamDoesNotBelongToEventSource.d.ts

@@ -0,0 +1,7 @@
+/** Thrown when an append names a stream the event source does not declare. */
+export declare class EventStreamDoesNotBelongToEventSource extends Error {
+    readonly eventSource: string;
+    readonly stream: string;
+    constructor(eventSource: string, stream: string);
+}
+//# sourceMappingURL=EventStreamDoesNotBelongToEventSource.d.ts.map

package/dist/eventSources/EventStreamDoesNotBelongToEventSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamDoesNotBelongToEventSource.d.ts","sourceRoot":"","sources":["../../eventSources/EventStreamDoesNotBelongToEventSource.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,qBAAa,qCAAsC,SAAQ,KAAK;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAjE,YAAqB,WAAW,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM,EAGhE;CACJ"}

package/dist/eventSources/EventStreamDoesNotBelongToEventSource.js

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Thrown when an append names a stream the event source does not declare. */
+export class EventStreamDoesNotBelongToEventSource extends Error {
+    eventSource;
+    stream;
+    constructor(eventSource, stream) {
+        super(`The event stream '${stream}' is not declared by the event source '${eventSource}'.`);
+        this.eventSource = eventSource;
+        this.stream = stream;
+        this.name = 'EventStreamDoesNotBelongToEventSource';
+    }
+}
+//# sourceMappingURL=EventStreamDoesNotBelongToEventSource.js.map

package/dist/eventSources/EventStreamDoesNotBelongToEventSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamDoesNotBelongToEventSource.js","sourceRoot":"","sources":["../../eventSources/EventStreamDoesNotBelongToEventSource.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,8EAA8E;AAC9E,MAAM,OAAO,qCAAsC,SAAQ,KAAK;IACvC,WAAW;IAAmB,MAAM;IAAzD,YAAqB,WAAmB,EAAW,MAAc;QAC7D,KAAK,CAAC,qBAAqB,MAAM,0CAA0C,WAAW,IAAI,CAAC,CAAC;2BAD3E,WAAW;sBAAmB,MAAM;QAErD,IAAI,CAAC,IAAI,GAAG,uCAAuC,CAAC;IACxD,CAAC;CACJ"}

package/dist/eventSources/EventStreamRequiresEventSource.d.ts

@@ -0,0 +1,6 @@
+/** Thrown when an append names a stream without naming the event source that declares it. */
+export declare class EventStreamRequiresEventSource extends Error {
+    readonly stream: string;
+    constructor(stream: string);
+}
+//# sourceMappingURL=EventStreamRequiresEventSource.d.ts.map

package/dist/eventSources/EventStreamRequiresEventSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamRequiresEventSource.d.ts","sourceRoot":"","sources":["../../eventSources/EventStreamRequiresEventSource.ts"],"names":[],"mappings":"AAGA,6FAA6F;AAC7F,qBAAa,8BAA+B,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAnC,YAAqB,MAAM,EAAE,MAAM,EAGlC;CACJ"}

package/dist/eventSources/EventStreamRequiresEventSource.js

@@ -0,0 +1,12 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Thrown when an append names a stream without naming the event source that declares it. */
+export class EventStreamRequiresEventSource extends Error {
+    stream;
+    constructor(stream) {
+        super(`The event stream '${stream}' can only be used together with an event source.`);
+        this.stream = stream;
+        this.name = 'EventStreamRequiresEventSource';
+    }
+}
+//# sourceMappingURL=EventStreamRequiresEventSource.js.map

package/dist/eventSources/EventStreamRequiresEventSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStreamRequiresEventSource.js","sourceRoot":"","sources":["../../eventSources/EventStreamRequiresEventSource.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,6FAA6F;AAC7F,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAChC,MAAM;IAA3B,YAAqB,MAAc;QAC/B,KAAK,CAAC,qBAAqB,MAAM,mDAAmD,CAAC,CAAC;sBADrE,MAAM;QAEvB,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IACjD,CAAC;CACJ"}

package/dist/eventSources/IEventSources.d.ts

@@ -0,0 +1,27 @@
+import type { Constructor } from '@cratis/fundamentals';
+import type { EventSourceDefinition } from './EventSourceDefinition.js';
+/**
+ * Defines the discovery and registration of event source definitions.
+ */
+export interface IEventSources {
+    /** Gets all discovered event source definitions. */
+    readonly all: ReadonlyArray<EventSourceDefinition>;
+    /**
+     * Discovers the event source definitions from the client artifacts.
+     * @throws DuplicateEventSourceName when two definitions share a name.
+     * @throws DuplicateEventStreamName when a definition declares the same stream twice.
+     */
+    discover(): Promise<void>;
+    /**
+     * Registers the discovered definitions with the Kernel. Registration is an upsert; the Kernel retains
+     * historical definitions that are no longer registered. Does nothing when there are no definitions.
+     */
+    register(): Promise<void>;
+    /**
+     * Gets the definition by class or name.
+     * @param eventSource - The class decorated with `@eventSource`, or the definition name.
+     * @throws UnknownEventSource when there is no such definition.
+     */
+    getFor(eventSource: Constructor | string): EventSourceDefinition;
+}
+//# sourceMappingURL=IEventSources.d.ts.map

package/dist/eventSources/IEventSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEventSources.d.ts","sourceRoot":"","sources":["../../eventSources/IEventSources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAEnD;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,qBAAqB,CAAC;CACpE"}