@cratis/chronicle 6.48.0 → 6.50.0

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

package/dist/eventSources/index.d.ts

@@ -0,0 +1,17 @@
+export { ConcurrencyDimensions } from './ConcurrencyDimensions.js';
+export type { ConcurrencyDimensionFlags } from './ConcurrencyDimensions.js';
+export type { EventSourceDefinition } from './EventSourceDefinition.js';
+export type { EventStreamDefinition } from './EventStreamDefinition.js';
+export { eventSource, eventStream, getEventSourceMetadata, getEventStreamsFor } from './eventSource.js';
+export type { EventSourceOptions, EventStreamOptions, EventSourceMetadata, EventStreamMetadata } from './eventSource.js';
+export type { IEventSources } from './IEventSources.js';
+export { EventSources } from './EventSources.js';
+export { ResolvedEventRouting } from './ResolvedEventRouting.js';
+export type { ExplicitRouting } from './ResolvedEventRouting.js';
+export { UnknownEventSource } from './UnknownEventSource.js';
+export { DuplicateEventSourceName } from './DuplicateEventSourceName.js';
+export { DuplicateEventStreamName } from './DuplicateEventStreamName.js';
+export { EventStreamDoesNotBelongToEventSource } from './EventStreamDoesNotBelongToEventSource.js';
+export { EventRoutingContradictsEventSource } from './EventRoutingContradictsEventSource.js';
+export { EventStreamRequiresEventSource } from './EventStreamRequiresEventSource.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../eventSources/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxG,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzH,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AACnG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/eventSources/index.js

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { ConcurrencyDimensions } from './ConcurrencyDimensions.js';
+export { eventSource, eventStream, getEventSourceMetadata, getEventStreamsFor } from './eventSource.js';
+export { EventSources } from './EventSources.js';
+export { ResolvedEventRouting } from './ResolvedEventRouting.js';
+export { UnknownEventSource } from './UnknownEventSource.js';
+export { DuplicateEventSourceName } from './DuplicateEventSourceName.js';
+export { DuplicateEventStreamName } from './DuplicateEventStreamName.js';
+export { EventStreamDoesNotBelongToEventSource } from './EventStreamDoesNotBelongToEventSource.js';
+export { EventRoutingContradictsEventSource } from './EventRoutingContradictsEventSource.js';
+export { EventStreamRequiresEventSource } from './EventStreamRequiresEventSource.js';
+//# sourceMappingURL=index.js.map

package/dist/eventSources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../eventSources/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGxG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AACnG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/events/EventContext.d.ts

@@ -1,6 +1,7 @@
 import { EventType } from './EventType.js';
 import { CausationEntry } from './CausationEntry.js';
 import { Tag } from './Tag.js';
+import type { NamedTag } from './NamedTag.js';
 import type { Identity } from '../identity/Identity.js';
 /**
  * Represents contextual information about an appended event.
@@ -20,6 +21,11 @@ export interface EventContext {
     readonly eventStreamType?: string;
     /** The stream identifier returned by the kernel. */
     readonly eventStreamId?: string;
+    /**
+     * The registered event source definition the event was appended through.
+     * Undefined for events appended without a definition, including events stored before event sources existed.
+     */
+    readonly eventSource?: string;
     /** The compliance subject returned by the kernel. */
     readonly subject?: string;
     /** The persisted event hash. */
@@ -38,5 +44,11 @@ export interface EventContext {
     readonly causation: ReadonlyArray<CausationEntry>;
     /** The tags the event carries. */
     readonly tags: ReadonlyArray<Tag>;
+    /**
+     * The structured named tags the event carries, in the order the kernel stored them.
+     * Always present on events read from or delivered by the kernel (empty when the event has none);
+     * optional so that contexts constructed by hand remain valid.
+     */
+    readonly namedTags?: ReadonlyArray<NamedTag>;
 }
 //# sourceMappingURL=EventContext.d.ts.map

package/dist/events/EventContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventContext.d.ts","sourceRoot":"","sources":["../../events/EventContext.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE7B,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAExB,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAElD,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACrC"}
+{"version":3,"file":"EventContext.d.ts","sourceRoot":"","sources":["../../events/EventContext.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE7B,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAExB,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAElD,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAChD"}

package/dist/events/InvalidNamedTag.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The error that is thrown when a named tag has a blank name or a non-string value, or a named tag
+ * collection contains an entry that is not a named tag. Mirrors the .NET client's `InvalidNamedTag`.
+ */
+export declare class InvalidNamedTag extends Error {
+    constructor();
+}
+//# sourceMappingURL=InvalidNamedTag.d.ts.map

package/dist/events/InvalidNamedTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidNamedTag.d.ts","sourceRoot":"","sources":["../../events/InvalidNamedTag.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACtC,cAGC;CACJ"}

package/dist/events/InvalidNamedTag.js

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The error that is thrown when a named tag has a blank name or a non-string value, or a named tag
+ * collection contains an entry that is not a named tag. Mirrors the .NET client's `InvalidNamedTag`.
+ */
+export class InvalidNamedTag extends Error {
+    constructor() {
+        super('Named tags require a nonblank name and a non-null value; named tag collections cannot contain null elements.');
+        this.name = 'InvalidNamedTag';
+    }
+}
+//# sourceMappingURL=InvalidNamedTag.js.map

package/dist/events/InvalidNamedTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidNamedTag.js","sourceRoot":"","sources":["../../events/InvalidNamedTag.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACtC;QACI,KAAK,CAAC,8GAA8G,CAAC,CAAC;QACtH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ"}

package/dist/events/NamedTag.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Associates a name with an exact, opaque event tag value. Names and values are compared exactly
+ * (ordinal and case-sensitive); one name may carry several values on the same event.
+ * Mirrors the .NET client's `NamedTag`.
+ */
+export declare class NamedTag {
+    /** The name of the tag. Never blank. */
+    readonly name: string;
+    /** The exact, opaque value of the tag. May be empty. */
+    readonly value: string;
+    /**
+     * Initializes a new instance of {@link NamedTag}.
+     * @param name - The name. Must be a nonblank string.
+     * @param value - The opaque value. Must be a string; the empty string is allowed.
+     * @throws {@link InvalidNamedTag} when the name is blank or not a string, or the value is not a string.
+     */
+    constructor(name: string, value: string);
+    /**
+     * Determines whether this tag has the same name and value as another, compared exactly.
+     * @param other - The tag to compare with.
+     * @returns True when both name and value are equal.
+     */
+    equals(other: NamedTag): boolean;
+}
+//# sourceMappingURL=NamedTag.d.ts.map

package/dist/events/NamedTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamedTag.d.ts","sourceRoot":"","sources":["../../events/NamedTag.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,qBAAa,QAAQ;IACjB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,YAAY,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAOtC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAE/B;CACJ"}

package/dist/events/NamedTag.js

@@ -0,0 +1,39 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { InvalidNamedTag } from './InvalidNamedTag.js';
+// Matches .NET string.IsNullOrWhiteSpace, which also treats U+0085 and other Unicode white space as blank.
+const blank = /^\p{White_Space}*$/u;
+/**
+ * Associates a name with an exact, opaque event tag value. Names and values are compared exactly
+ * (ordinal and case-sensitive); one name may carry several values on the same event.
+ * Mirrors the .NET client's `NamedTag`.
+ */
+export class NamedTag {
+    /** The name of the tag. Never blank. */
+    name;
+    /** The exact, opaque value of the tag. May be empty. */
+    value;
+    /**
+     * Initializes a new instance of {@link NamedTag}.
+     * @param name - The name. Must be a nonblank string.
+     * @param value - The opaque value. Must be a string; the empty string is allowed.
+     * @throws {@link InvalidNamedTag} when the name is blank or not a string, or the value is not a string.
+     */
+    constructor(name, value) {
+        if (typeof name !== 'string' || blank.test(name) || typeof value !== 'string') {
+            throw new InvalidNamedTag();
+        }
+        this.name = name;
+        this.value = value;
+        Object.freeze(this);
+    }
+    /**
+     * Determines whether this tag has the same name and value as another, compared exactly.
+     * @param other - The tag to compare with.
+     * @returns True when both name and value are equal.
+     */
+    equals(other) {
+        return other instanceof NamedTag && other.name === this.name && other.value === this.value;
+    }
+}
+//# sourceMappingURL=NamedTag.js.map

package/dist/events/NamedTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamedTag.js","sourceRoot":"","sources":["../../events/NamedTag.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,2GAA2G;AAC3G,MAAM,KAAK,GAAG,qBAAqB,CAAC;AAEpC;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACjB,wCAAwC;IAC/B,IAAI,CAAS;IAEtB,wDAAwD;IAC/C,KAAK,CAAS;IAEvB;;;;;OAKG;IACH,YAAY,IAAY,EAAE,KAAa;QACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5E,MAAM,IAAI,eAAe,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAe;QAClB,OAAO,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC;IAC/F,CAAC;CACJ"}

package/dist/events/WireEventContext.d.ts

@@ -3,6 +3,8 @@ import type { AppendedEventResponse } from '@cratis/chronicle.contracts';
 export type WireEventContext = Omit<NonNullable<AppendedEventResponse['Context']>, 'ObservationState'> & {
     /** Numeric wire value shared by the generated observation-state enums. */
     ObservationState: number;
+    /** The registered event source name; empty or absent when the event was not appended through a definition. */
+    EventSource?: string;
     /** Store metadata is carried by observer deliveries, but not every read response. */
     EventStore?: string;
     /** Namespace metadata is carried by observer deliveries, but not every read response. */

package/dist/events/WireEventContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WireEventContext.d.ts","sourceRoot":"","sources":["../../events/WireEventContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,CAAC,GAAG;IACrG,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"WireEventContext.d.ts","sourceRoot":"","sources":["../../events/WireEventContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,CAAC,GAAG;IACrG,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/events/index.d.ts

@@ -17,6 +17,9 @@ export { filterEventsByTag, getFilterTagsFor } from './filterEventsByTagDecorato
 export { eventSourceType, getEventSourceTypeFor } from './eventSourceTypeDecorator.js';
 export { eventStreamType, getEventStreamTypeFor } from './eventStreamTypeDecorator.js';
 export { mergeTags } from './mergeTags.js';
+export { NamedTag } from './NamedTag.js';
+export { InvalidNamedTag } from './InvalidNamedTag.js';
+export { mergeNamedTags } from './mergeNamedTags.js';
 export * from './constraints/index.js';
 export * from './migrations/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../events/index.ts"],"names":[],"mappings":"AAGA,OAAO,uCAAuC,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpI,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../events/index.ts"],"names":[],"mappings":"AAGA,OAAO,uCAAuC,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpI,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/events/index.js

@@ -14,6 +14,9 @@ export { filterEventsByTag, getFilterTagsFor } from './filterEventsByTagDecorato
 export { eventSourceType, getEventSourceTypeFor } from './eventSourceTypeDecorator.js';
 export { eventStreamType, getEventStreamTypeFor } from './eventStreamTypeDecorator.js';
 export { mergeTags } from './mergeTags.js';
+export { NamedTag } from './NamedTag.js';
+export { InvalidNamedTag } from './InvalidNamedTag.js';
+export { mergeNamedTags } from './mergeNamedTags.js';
 export * from './constraints/index.js';
 export * from './migrations/index.js';
 //# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../events/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,uCAAuC,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAMpI,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../events/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,uCAAuC,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAMpI,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}