@cratis/chronicle 6.48.0 → 6.49.0

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"}

package/dist/eventSources/IEventSources.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=IEventSources.js.map

package/dist/eventSources/IEventSources.js.map

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

package/dist/eventSources/ResolvedEventRouting.d.ts

@@ -0,0 +1,37 @@
+import type { Constructor } from '@cratis/fundamentals';
+import type { ConcurrencyDimensionFlags } from './ConcurrencyDimensions.js';
+import type { EventSourceDefinition } from './EventSourceDefinition.js';
+import type { EventStreamDefinition } from './EventStreamDefinition.js';
+import type { IEventSources } from './IEventSources.js';
+/** The explicit routing a caller supplied next to a definition. */
+export interface ExplicitRouting {
+    /** Explicit event source type, if any. */
+    sourceType?: string;
+    /** Explicit event stream type, if any. */
+    streamType?: string;
+}
+/** The routing of an append resolved through an event source definition. */
+export declare class ResolvedEventRouting {
+    readonly definition: EventSourceDefinition;
+    readonly stream?: EventStreamDefinition | undefined;
+    private constructor();
+    /** The registered event source name written on the event. */
+    get eventSource(): string;
+    /** The event source type written on the event. */
+    get sourceType(): string;
+    /** The event stream type to write, or undefined to let the Kernel choose. */
+    get streamType(): string | undefined;
+    /** The concurrency dimensions that apply: the stream's when it declares any, otherwise the source's. */
+    get dimensions(): ConcurrencyDimensionFlags;
+    /**
+     * Resolves the routing of an append.
+     * @param eventSources - The event sources; undefined when the store has none.
+     * @param eventSource - The definition class or name; undefined for a legacy append.
+     * @param stream - The declared stream name, if any.
+     * @param explicit - Explicit routing that must not contradict the definition.
+     * @returns The routing, or undefined when no definition is involved.
+     * @throws UnknownEventSource, EventStreamDoesNotBelongToEventSource, EventRoutingContradictsEventSource, EventStreamRequiresEventSource.
+     */
+    static resolve(eventSources: IEventSources | undefined, eventSource: Constructor | string | undefined, stream: string | undefined, explicit?: ExplicitRouting): ResolvedEventRouting | undefined;
+}
+//# sourceMappingURL=ResolvedEventRouting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvedEventRouting.d.ts","sourceRoot":"","sources":["../../eventSources/ResolvedEventRouting.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;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,4EAA4E;AAC5E,qBAAa,oBAAoB;IACT,QAAQ,CAAC,UAAU,EAAE,qBAAqB;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB;IAAvG,OAAO,eAAoG;IAE3G,6DAA6D;IAC7D,IAAI,WAAW,IAAI,MAAM,CAAiC;IAE1D,kDAAkD;IAClD,IAAI,UAAU,IAAI,MAAM,CAAiC;IAEzD,6EAA6E;IAC7E,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAA8B;IAElE,wGAAwG;IACxG,IAAI,UAAU,IAAI,yBAAyB,CAE1C;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,CACV,YAAY,EAAE,aAAa,GAAG,SAAS,EACvC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EAC7C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,GAAE,eAAoB,GAC/B,oBAAoB,GAAG,SAAS,CAsBlC;CACJ"}

package/dist/eventSources/ResolvedEventRouting.js

@@ -0,0 +1,60 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { EventRoutingContradictsEventSource } from './EventRoutingContradictsEventSource.js';
+import { EventStreamDoesNotBelongToEventSource } from './EventStreamDoesNotBelongToEventSource.js';
+import { EventStreamRequiresEventSource } from './EventStreamRequiresEventSource.js';
+import { UnknownEventSource } from './UnknownEventSource.js';
+/** The routing of an append resolved through an event source definition. */
+export class ResolvedEventRouting {
+    definition;
+    stream;
+    constructor(definition, stream) {
+        this.definition = definition;
+        this.stream = stream;
+    }
+    /** The registered event source name written on the event. */
+    get eventSource() { return this.definition.name; }
+    /** The event source type written on the event. */
+    get sourceType() { return this.definition.name; }
+    /** The event stream type to write, or undefined to let the Kernel choose. */
+    get streamType() { return this.stream?.name; }
+    /** The concurrency dimensions that apply: the stream's when it declares any, otherwise the source's. */
+    get dimensions() {
+        return this.stream && this.stream.concurrency !== 0 ? this.stream.concurrency : this.definition.concurrency;
+    }
+    /**
+     * Resolves the routing of an append.
+     * @param eventSources - The event sources; undefined when the store has none.
+     * @param eventSource - The definition class or name; undefined for a legacy append.
+     * @param stream - The declared stream name, if any.
+     * @param explicit - Explicit routing that must not contradict the definition.
+     * @returns The routing, or undefined when no definition is involved.
+     * @throws UnknownEventSource, EventStreamDoesNotBelongToEventSource, EventRoutingContradictsEventSource, EventStreamRequiresEventSource.
+     */
+    static resolve(eventSources, eventSource, stream, explicit = {}) {
+        if (eventSource === undefined) {
+            if (stream !== undefined)
+                throw new EventStreamRequiresEventSource(stream);
+            return undefined;
+        }
+        if (!eventSources)
+            throw new UnknownEventSource(typeof eventSource === 'string' ? eventSource : eventSource.name);
+        const definition = eventSources.getFor(eventSource);
+        const isSet = (value, unspecified) => value !== undefined && value !== '' && !unspecified.includes(value);
+        if (isSet(explicit.sourceType, ['Default', 'Unspecified']) && explicit.sourceType !== definition.name) {
+            throw new EventRoutingContradictsEventSource(definition.name, 'event source type', definition.name, explicit.sourceType);
+        }
+        const explicitStream = isSet(explicit.streamType, ['All']) ? explicit.streamType : undefined;
+        if (stream !== undefined && explicitStream !== undefined && stream !== explicitStream) {
+            throw new EventRoutingContradictsEventSource(definition.name, 'event stream type', stream, explicitStream);
+        }
+        const name = stream ?? explicitStream;
+        if (name === undefined)
+            return new ResolvedEventRouting(definition);
+        const found = definition.streams.find(candidate => candidate.name === name);
+        if (!found)
+            throw new EventStreamDoesNotBelongToEventSource(definition.name, name);
+        return new ResolvedEventRouting(definition, found);
+    }
+}
+//# sourceMappingURL=ResolvedEventRouting.js.map

package/dist/eventSources/ResolvedEventRouting.js.map

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

package/dist/eventSources/UnknownEventSource.d.ts

@@ -0,0 +1,6 @@
+/** Thrown when an append names an event source that is not a discovered definition. */
+export declare class UnknownEventSource extends Error {
+    readonly eventSource: string;
+    constructor(eventSource: string);
+}
+//# sourceMappingURL=UnknownEventSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownEventSource.d.ts","sourceRoot":"","sources":["../../eventSources/UnknownEventSource.ts"],"names":[],"mappings":"AAGA,uFAAuF;AACvF,qBAAa,kBAAmB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM;IAAxC,YAAqB,WAAW,EAAE,MAAM,EAGvC;CACJ"}

package/dist/eventSources/UnknownEventSource.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 an event source that is not a discovered definition. */
+export class UnknownEventSource extends Error {
+    eventSource;
+    constructor(eventSource) {
+        super(`The event source '${eventSource}' is not a discovered event source definition.`);
+        this.eventSource = eventSource;
+        this.name = 'UnknownEventSource';
+    }
+}
+//# sourceMappingURL=UnknownEventSource.js.map

package/dist/eventSources/UnknownEventSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownEventSource.js","sourceRoot":"","sources":["../../eventSources/UnknownEventSource.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,uFAAuF;AACvF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACpB,WAAW;IAAhC,YAAqB,WAAmB;QACpC,KAAK,CAAC,qBAAqB,WAAW,gDAAgD,CAAC,CAAC;2BADvE,WAAW;QAE5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ"}

package/dist/eventSources/eventSource.d.ts

@@ -0,0 +1,60 @@
+import 'reflect-metadata';
+import type { ChronicleClassDecorator } from '../types/standardDecoratorMetadata.js';
+import type { ConcurrencyDimensionFlags } from './ConcurrencyDimensions.js';
+/** Optional settings for {@link eventSource}. */
+export interface EventSourceOptions {
+    /** The stable name. Defaults to the class name without a trailing `EventSource`. */
+    name?: string;
+    /** The description of the event source. */
+    description?: string;
+    /** The default dimensions that take part in concurrency checks; combine {@link ConcurrencyDimensions} values with `|`. */
+    concurrency?: ConcurrencyDimensionFlags;
+}
+/** Optional settings for {@link eventStream}. */
+export interface EventStreamOptions {
+    /** The description of the stream. */
+    description?: string;
+    /** The dimensions that take part in concurrency checks for the stream. Falls back to the event source when omitted or none. */
+    concurrency?: ConcurrencyDimensionFlags;
+}
+/** Metadata recorded by {@link eventSource}. */
+export interface EventSourceMetadata {
+    readonly name: string;
+    readonly description: string;
+    readonly concurrency: ConcurrencyDimensionFlags;
+}
+/** Metadata recorded by {@link eventStream}. */
+export interface EventStreamMetadata {
+    readonly name: string;
+    readonly description: string;
+    readonly concurrency: ConcurrencyDimensionFlags;
+}
+/**
+ * Declares a class as an event source definition, discovered and registered with the Kernel at startup.
+ * The definition is not tied to event types; an append routes through it with `AppendOptions.eventSource`.
+ * Supports legacy and standard class decorators.
+ * @param options - Optional name (defaults to the class name without a trailing `EventSource`), description and concurrency.
+ * @returns A class decorator.
+ */
+export declare function eventSource(options?: EventSourceOptions): ChronicleClassDecorator;
+/**
+ * Declares a stream of an event source. Repeat the decorator for several streams.
+ * Only takes effect on a class that is also decorated with {@link eventSource}.
+ * @param name - The stable name of the stream, which is the event stream type of appended events.
+ * @param options - Optional description and concurrency dimensions.
+ * @returns A class decorator.
+ */
+export declare function eventStream(name: string, options?: EventStreamOptions): ChronicleClassDecorator;
+/**
+ * Gets the event source metadata declared on a class.
+ * @param target - The class constructor.
+ * @returns The metadata, or undefined when the class is not an event source.
+ */
+export declare function getEventSourceMetadata(target: Function): EventSourceMetadata | undefined;
+/**
+ * Gets the streams declared on a class, in declaration order (duplicates are preserved so they can be rejected).
+ * @param target - The class constructor.
+ * @returns The declared streams.
+ */
+export declare function getEventStreamsFor(target: Function): ReadonlyArray<EventStreamMetadata>;
+//# sourceMappingURL=eventSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventSource.d.ts","sourceRoot":"","sources":["../../eventSources/eventSource.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAM5E,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IAC/B,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0HAA0H;IAC1H,WAAW,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IAC/B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+HAA+H;IAC/H,WAAW,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;CACnD;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,uBAAuB,CAmBjF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,uBAAuB,CAS/F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,mBAAmB,GAAG,SAAS,CAExF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAEvF"}

package/dist/eventSources/eventSource.js

@@ -0,0 +1,72 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import 'reflect-metadata';
+import { DecoratorType, TypeDiscoverer } from '../types/index.js';
+const EVENT_SOURCE_METADATA_KEY = 'chronicle:eventSource';
+const EVENT_STREAMS_METADATA_KEY = 'chronicle:eventSource:streams';
+let registrationCounter = 0;
+/**
+ * Declares a class as an event source definition, discovered and registered with the Kernel at startup.
+ * The definition is not tied to event types; an append routes through it with `AppendOptions.eventSource`.
+ * Supports legacy and standard class decorators.
+ * @param options - Optional name (defaults to the class name without a trailing `EventSource`), description and concurrency.
+ * @returns A class decorator.
+ */
+export function eventSource(options) {
+    return ((target, context) => {
+        let constructor = target;
+        const metadata = {
+            name: options?.name ?? defaultNameFor(constructor),
+            description: options?.description ?? '',
+            concurrency: options?.concurrency ?? 0
+        };
+        Reflect.defineMetadata(EVENT_SOURCE_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.EventSource, constructor, `${metadata.name}#${registrationCounter++}`);
+        context?.addInitializer(function () {
+            if (this !== constructor) {
+                constructor = this;
+                Reflect.defineMetadata(EVENT_SOURCE_METADATA_KEY, metadata, constructor);
+                Reflect.defineMetadata(EVENT_STREAMS_METADATA_KEY, Reflect.getOwnMetadata(EVENT_STREAMS_METADATA_KEY, target), constructor);
+                TypeDiscoverer.default.register(DecoratorType.EventSource, constructor, `${metadata.name}#${registrationCounter++}`);
+            }
+        });
+    });
+}
+/**
+ * Declares a stream of an event source. Repeat the decorator for several streams.
+ * Only takes effect on a class that is also decorated with {@link eventSource}.
+ * @param name - The stable name of the stream, which is the event stream type of appended events.
+ * @param options - Optional description and concurrency dimensions.
+ * @returns A class decorator.
+ */
+export function eventStream(name, options) {
+    return ((target) => {
+        const existing = Reflect.getOwnMetadata(EVENT_STREAMS_METADATA_KEY, target) ?? [];
+        // Decorators evaluate bottom-up; unshift keeps declaration order.
+        Reflect.defineMetadata(EVENT_STREAMS_METADATA_KEY, [
+            { name, description: options?.description ?? '', concurrency: options?.concurrency ?? 0 },
+            ...existing
+        ], target);
+    });
+}
+/**
+ * Gets the event source metadata declared on a class.
+ * @param target - The class constructor.
+ * @returns The metadata, or undefined when the class is not an event source.
+ */
+export function getEventSourceMetadata(target) {
+    return Reflect.getOwnMetadata(EVENT_SOURCE_METADATA_KEY, target);
+}
+/**
+ * Gets the streams declared on a class, in declaration order (duplicates are preserved so they can be rejected).
+ * @param target - The class constructor.
+ * @returns The declared streams.
+ */
+export function getEventStreamsFor(target) {
+    return Reflect.getOwnMetadata(EVENT_STREAMS_METADATA_KEY, target) ?? [];
+}
+function defaultNameFor(type) {
+    const suffix = 'EventSource';
+    return type.name.length > suffix.length && type.name.endsWith(suffix) ? type.name.slice(0, -suffix.length) : type.name;
+}
+//# sourceMappingURL=eventSource.js.map

package/dist/eventSources/eventSource.js.map

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